support sending json attributes

Author: jumpingGrendel

packages/destination-actions/src/destinations/airship/__tests__/utilities.test.ts

@@ -155,6 +155,63 @@ describe('Testing _build_attribute_object', () => {
   })
 })
 
+describe('Testing _build_attribute_object with JSON (array/object) values', () => {
+  it('should append #default to array attribute keys without an instance ID', () => {
+    const payload: AttributesPayload = {
+      named_user_id: 'test-user',
+      occurred: occurred.toISOString(),
+      attributes: {
+        favourite_teams: ['Team A', 'Team B', 'Team C']
+      }
+    }
+    const result = _private._build_attributes_object(payload)
+    const attr = result.find((a: any) => a.key === 'favourite_teams#default')
+    expect(attr?.action).toBe('set')
+    expect(attr?.value).toEqual(['Team A', 'Team B', 'Team C'])
+  })
+
+  it('should append #default to object attribute keys without an instance ID', () => {
+    const payload: AttributesPayload = {
+      named_user_id: 'test-user',
+      occurred: occurred.toISOString(),
+      attributes: {
+        preferences: { theme: 'dark', language: 'en' }
+      }
+    }
+    const result = _private._build_attributes_object(payload)
+    const attr = result.find((a: any) => a.key === 'preferences#default')
+    expect(attr?.action).toBe('set')
+    expect(attr?.value).toEqual({ theme: 'dark', language: 'en' })
+  })
+
+  it('should preserve a user-supplied instance ID in the key', () => {
+    const payload: AttributesPayload = {
+      named_user_id: 'test-user',
+      occurred: occurred.toISOString(),
+      attributes: {
+        'reservation#a001': { flight: 'UA123', seat: '12A' }
+      }
+    }
+    const result = _private._build_attributes_object(payload)
+    const attr = result.find((a: any) => a.key === 'reservation#a001')
+    expect(attr?.action).toBe('set')
+    expect(attr?.value).toEqual({ flight: 'UA123', seat: '12A' })
+  })
+
+  it('should set action to remove for null value', () => {
+    const payload: AttributesPayload = {
+      named_user_id: 'test-user',
+      occurred: occurred.toISOString(),
+      attributes: {
+        favourite_teams: null
+      }
+    }
+    const result = _private._build_attributes_object(payload)
+    const attr = result.find((a: any) => a.key === 'favourite_teams')
+    expect(attr?.action).toBe('remove')
+  })
+})
+
 describe('Testing _build_tags_object', () => {
   it('should correctly format a tag', () => {
     expect(_private._build_tags_object(valid_tags_payload)).toEqual(airship_tags_payload)

packages/destination-actions/src/destinations/airship/utilities.ts

@@ -279,6 +279,16 @@ function _build_attribute(attribute_key: string, attribute_value: any, occurred:
   /*
   This function builds a single attribute from a key/value.
   */
+  // JSON attributes (object/array values) require a key in the format attribute_name#instance_id.
+  // If the user hasn't included an instance ID, append '#default'.
+  if (
+    attribute_value !== null &&
+    typeof attribute_value === 'object' &&
+    !attribute_key.includes('#')
+  ) {
+    attribute_key = `${attribute_key}#default`
+  }
+
   let adjustedDate = null
   if (typeof attribute_value == 'string') {
     adjustedDate = _parse_date(attribute_value)
@@ -291,7 +301,7 @@ function _build_attribute(attribute_key: string, attribute_value: any, occurred:
   const attribute: {
     action: string
     key: string
-    value?: string | number | boolean
+    value?: unknown
     timestamp: string | boolean
   } = {
     action: 'set',