feat(pixel): add identityType parameter to identify() (#2840)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: bkbooth

packages/audience/pixel/src/bootstrap.test.ts

@@ -65,14 +65,14 @@ describe('bootstrap', () => {
     (window as Record<string, unknown>).__imtbl = [
       ['init', { key: 'pk_test' }],
       ['consent', 'full'],
-      ['identify', 'user-1', { email: 'a@b.com' }],
+      ['identify', 'user-1', 'passport', { email: 'a@b.com' }],
     ];
 
     require('./bootstrap');
 
     expect(mockInit).toHaveBeenCalledWith({ key: 'pk_test' });
     expect(mockSetConsent).toHaveBeenCalledWith('full');
-    expect(mockIdentify).toHaveBeenCalledWith('user-1', { email: 'a@b.com' });
+    expect(mockIdentify).toHaveBeenCalledWith('user-1', 'passport', { email: 'a@b.com' });
   });
 
   it('installs loader and handles new commands after load', () => {

packages/audience/pixel/src/bootstrap.ts

@@ -27,6 +27,7 @@ function handleCommand(command: Command): void {
       pixel.identify(
         args[0] as string,
         args[1] as Parameters<Pixel['identify']>[1],
+        args[2] as Parameters<Pixel['identify']>[2],
       );
       break;
     case 'consent':

packages/audience/pixel/src/pixel.test.ts

@@ -226,20 +226,21 @@ describe('Pixel', () => {
   });
 
   describe('identify', () => {
-    it('enqueues identify message at full consent', () => {
+    it('enqueues identify message with identityType at full consent', () => {
       mockGetOrCreateSession.mockReturnValue({ sessionId: 'session-abc', isNew: false });
 
       const pixel = new Pixel();
       activePixel = pixel;
       pixel.init({ key: 'pk_test', environment: 'dev', consent: 'full' });
       mockEnqueue.mockClear();
 
-      pixel.identify('user-1', { email: 'test@example.com' });
+      pixel.identify('user-1', 'passport', { email: 'test@example.com' });
 
       expect(mockEnqueue).toHaveBeenCalledWith(
         expect.objectContaining({
           type: 'identify',
           userId: 'user-1',
+          identityType: 'passport',
           surface: 'pixel',
           traits: expect.objectContaining({
             email: 'test@example.com',
@@ -249,12 +250,31 @@ describe('Pixel', () => {
       );
     });
 
+    it('enqueues identify message without traits', () => {
+      mockGetOrCreateSession.mockReturnValue({ sessionId: 'session-abc', isNew: false });
+
+      const pixel = new Pixel();
+      activePixel = pixel;
+      pixel.init({ key: 'pk_test', environment: 'dev', consent: 'full' });
+      mockEnqueue.mockClear();
+
+      pixel.identify('steam-id-123', 'steam');
+
+      expect(mockEnqueue).toHaveBeenCalledWith(
+        expect.objectContaining({
+          type: 'identify',
+          userId: 'steam-id-123',
+          identityType: 'steam',
+        }),
+      );
+    });
+
     it('does not enqueue identify at anonymous consent', () => {
       const pixel = new Pixel();
       activePixel = pixel;
       pixel.init({ key: 'pk_test', environment: 'dev', consent: 'anonymous' });
 
-      pixel.identify('user-1');
+      pixel.identify('user-1', 'passport');
       // Only the auto page view + session_start, no identify
       const calls = mockEnqueue.mock.calls.map((c: unknown[]) => (c[0] as Record<string, unknown>));
       expect(calls.find((c) => c.type === 'identify')).toBeUndefined();

packages/audience/pixel/src/pixel.ts

@@ -6,6 +6,7 @@ import type {
   IdentifyMessage,
   UserTraits,
   ConsentManager,
+  IdentityType,
 } from '@imtbl/audience-core';
 import {
   MessageQueue,
@@ -148,7 +149,7 @@ export class Pixel {
     this.queue!.enqueue(message);
   }
 
-  identify(userId: string, traits?: UserTraits): void {
+  identify(userId: string, identityType: IdentityType, traits?: UserTraits): void {
     if (!this.isReady() || this.consent!.level !== 'full') return;
 
     this.userId = userId;
@@ -159,6 +160,7 @@ export class Pixel {
       ...this.buildBase(),
       type: 'identify',
       userId,
+      identityType,
       traits: {
         ...traits,
         sessionId,