STRATCONN-6462 - [Altertable] - Update destination ahead of public beta (#3683)

* Update Altertable's destination ahead of public beta

 - Add batch support
 - Add Alias handling
 - Fix `anonymous_id`
 - Fix `$screen` event

* joe's feedback

Author: redox

packages/destination-actions/src/destinations/altertable/__tests__/__snapshots__/snapshot.test.ts.snap

@@ -1,7 +1,27 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`Testing snapshot for actions-altertable destination: alias action - all fields 1`] = `
+Object {
+  "device_id": "ggO&g",
+  "distinct_id": "ggO&g",
+  "environment": "ggO&g",
+  "new_user_id": "ggO&g",
+  "timestamp": "2024-06-01T12:00:00.000Z",
+}
+`;
+
+exports[`Testing snapshot for actions-altertable destination: alias action - required fields 1`] = `
+Object {
+  "distinct_id": "ggO&g",
+  "environment": "ggO&g",
+  "new_user_id": "ggO&g",
+  "timestamp": "2024-06-01T12:00:00.000Z",
+}
+`;
+
 exports[`Testing snapshot for actions-altertable destination: event action - all fields 1`] = `
 Object {
+  "anonymous_id": "UM[e12E",
   "device_id": "UM[e12E",
   "distinct_id": "UM[e12E",
   "environment": "UM[e12E",

packages/destination-actions/src/destinations/altertable/alias/__tests__/index.test.ts

@@ -0,0 +1,49 @@
+import nock from 'nock'
+import { createTestEvent, createTestIntegration } from '@segment/actions-core'
+import Destination from '../../index'
+
+const testDestination = createTestIntegration(Destination)
+
+describe('Altertable.alias', () => {
+  const endpoint = 'https://api.altertable.ai'
+  const apiKey = 'test-api-key'
+  const environment = 'test-environment'
+
+  beforeEach(() => nock.cleanAll())
+
+  it('should send alias to Altertable', async () => {
+    const event = createTestEvent({
+      previousId: 'prev-anon-id',
+      userId: 'new-user-id',
+      timestamp: '2026-01-05T09:35:42.275Z',
+      context: {
+        device: {
+          id: 'device-xyz'
+        }
+      }
+    })
+
+    nock(endpoint).post('/alias').reply(200, {})
+
+    const responses = await testDestination.testAction('alias', {
+      event,
+      useDefaultMappings: true,
+      settings: {
+        apiKey,
+        endpoint,
+        environment
+      }
+    })
+
+    expect(responses.length).toBe(1)
+    expect(responses[0].status).toBe(200)
+    const payload = JSON.parse(responses[0].options.body as string)
+    expect(payload).toEqual({
+      distinct_id: 'prev-anon-id',
+      device_id: 'device-xyz',
+      environment: 'test-environment',
+      new_user_id: 'new-user-id',
+      timestamp: '2026-01-05T09:35:42.275Z'
+    })
+  })
+})

packages/destination-actions/src/destinations/altertable/alias/generated-types.ts

@@ -0,0 +1,55 @@
+import type { ActionDefinition } from '@segment/actions-core'
+import type { Settings } from '../generated-types'
+import type { Payload } from './generated-types'
+import { commonFields } from '../fields'
+import { sendAlias, sendAliasBatch } from '../utils'
+
+const action: ActionDefinition<Settings, Payload> = {
+  title: 'Alias',
+  description: 'Link a previous anonymous or temporary ID to a user ID in Altertable.',
+  defaultSubscription: 'type = "alias"',
+  fields: {
+    previousId: {
+      label: 'Previous ID',
+      description: 'The previous user identifier (maps to distinct_id in the Altertable API).',
+      type: 'string',
+      required: true,
+      default: {
+        '@path': '$.previousId'
+      }
+    },
+    ...commonFields,
+    enable_batching: {
+      label: 'Enable Batching',
+      type: 'boolean',
+      required: true,
+      default: true,
+      unsafe_hidden: true,
+      description: 'When enabled, events are sent in batches to Altertable.'
+    },
+    batch_size: {
+      label: 'Batch Size',
+      type: 'number',
+      required: false,
+      default: 1000,
+      unsafe_hidden: true,
+      description: 'Maximum number of events per batch request.'
+    },
+    batch_bytes: {
+      label: 'Batch Bytes',
+      type: 'number',
+      required: false,
+      default: 4000000,
+      unsafe_hidden: true,
+      description: 'Maximum batch payload size in bytes.'
+    }
+  },
+  perform: (request, { settings, payload }) => {
+    return sendAlias(request, settings, payload)
+  },
+  performBatch: (request, { settings, payload }) => {
+    return sendAliasBatch(request, settings, payload)
+  }
+}
+
+export default action

packages/destination-actions/src/destinations/altertable/alias/index.ts

@@ -2,6 +2,7 @@
 
 exports[`Testing snapshot for Altertable's event destination action: all fields 1`] = `
 Object {
+  "anonymous_id": "CHXbRcxq]U",
   "device_id": "CHXbRcxq]U",
   "distinct_id": "CHXbRcxq]U",
   "environment": "CHXbRcxq]U",

packages/destination-actions/src/destinations/altertable/event/__tests__/__snapshots__/snapshot.test.ts.snap

@@ -2,50 +2,21 @@ import type { ActionDefinition } from '@segment/actions-core'
 import type { Settings } from '../generated-types'
 import type { Payload } from './generated-types'
 import { commonFields } from '../fields'
-import { send } from '../utils'
+import { sendTrack, sendTrackBatch } from '../utils'
 
 const action: ActionDefinition<Settings, Payload> = {
   title: 'Track Event',
   description: 'Track a single event in Altertable.',
   defaultSubscription: 'type = "track"',
   fields: {
-    type: {
-      label: 'Segment Event Type',
-      description: 'The Segment event type',
-      type: 'string',
-      choices: [
-        { label: 'track', value: 'track' },
-        { label: 'page', value: 'page' },
-        { label: 'screen', value: 'screen' }
-      ],
-      required: true,
-      default: 'track'
-    },
     event: {
       label: 'Event Name',
-      description: 'The name of the event to track. Only required for `track` event type.',
+      description: 'The name of the event to track.',
       type: 'string',
       default: {
         '@path': '$.event'
       },
-      required: {
-        conditions: [
-          {
-            fieldKey: 'eventType',
-            operator: 'is',
-            value: 'track'
-          }
-        ]
-      },
-      depends_on: {
-        conditions: [
-          {
-            fieldKey: 'eventType',
-            operator: 'is',
-            value: 'track'
-          }
-        ]
-      }
+      required: true
     },
     properties: {
       label: 'Properties',
@@ -56,12 +27,38 @@ const action: ActionDefinition<Settings, Payload> = {
         '@path': '$.properties'
       }
     },
-    ...commonFields
+    ...commonFields,
+    enable_batching: {
+      label: 'Enable Batching',
+      type: 'boolean',
+      required: true,
+      default: true,
+      unsafe_hidden: true,
+      description: 'When enabled, events are sent in batches to Altertable.'
+    },
+    batch_size: {
+      label: 'Batch Size',
+      type: 'number',
+      required: false,
+      default: 1000,
+      unsafe_hidden: true,
+      description: 'Maximum number of events per batch request.'
+    },
+    batch_bytes: {
+      label: 'Batch Bytes',
+      type: 'number',
+      required: false,
+      default: 4000000,
+      unsafe_hidden: true,
+      description: 'Maximum batch payload size in bytes.'
+    }
   },
   perform: (request, { settings, payload }) => {
-    return send(request, settings, payload)
+    return sendTrack(request, settings, payload)
+  },
+  performBatch: (request, { settings, payload }) => {
+    return sendTrackBatch(request, settings, payload)
   }
 }
 
-
 export default action