@adtrackify/at-service-common 4.0.14 → 4.0.16

package/dist/esm/__tests__/identity-cache/identity-gateway-cache-hit.spec.js

@@ -0,0 +1,136 @@
+import { createService, createCachedIdentity, mockGetIdentity, mockedDynamoDbClient, resetAllMocks, TEST_PIXEL_ID, IDENTITY_CACHE_WITH_CACHING_OUTCOME, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService cache hit scenarios', () => {
+    const pixelId = TEST_PIXEL_ID;
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    describe('fresh cache hit', () => {
+        it('should return cached identity without calling Neptune', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'identity456', {
+                emails: ['test@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'identity456',
+                traits: { emails: ['test@email.com'] },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.FRESH_CACHE_HIT);
+            expect(result.didCallNeptune).toBe(false);
+            expect(result.didWriteCache).toBe(false);
+            expect(mockGetIdentity).not.toHaveBeenCalled();
+            expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+        });
+        it('should treat as cache hit when merged identity is deep equal to cached', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'deep-equal', {
+                emails: ['same@email.com'],
+                phones: ['555-1234'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'deep-equal',
+                traits: {
+                    emails: ['same@email.com'],
+                    phones: ['555-1234'],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.FRESH_CACHE_HIT);
+            expect(result.didCallNeptune).toBe(false);
+            expect(mockGetIdentity).not.toHaveBeenCalled();
+        });
+    });
+    describe('address timestamp stripping', () => {
+        it('should strip address timestamps before deep equality comparison', async () => {
+            const service = createService();
+            const now = Date.now();
+            const cachedResponse = {
+                pk: `identity#${pixelId}#timestamp-strip`,
+                pixelId,
+                identityId: 'timestamp-strip',
+                response: {
+                    identityId: 'timestamp-strip',
+                    traits: {
+                        emails: ['test@email.com'],
+                        addresses: [{ city: 'NYC', cra: now - 10000, upa: now - 5000 }],
+                    },
+                },
+                updatedAt: new Date().toISOString(),
+            };
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'timestamp-strip',
+                traits: {
+                    emails: ['test@email.com'],
+                    addresses: [{ city: 'NYC', cra: now, upa: now }],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.FRESH_CACHE_HIT);
+            expect(result.didCallNeptune).toBe(false);
+        });
+    });
+    describe('volatile-only cache hit', () => {
+        it('should treat VOLATILE_ONLY changes as cache hit', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'volatile-override', {
+                emails: ['same@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'volatile-override',
+                traits: {
+                    emails: ['same@email.com'],
+                    ipAddress: '10.0.0.1',
+                    userAgent: 'Mozilla/5.0 (New)',
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.VOLATILE_ONLY_CACHE_HIT);
+            expect(result.didCallNeptune).toBe(false);
+            expect(result.didWriteCache).toBe(false);
+        });
+        it('should return merged identity for VOLATILE_ONLY tier', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'volatile-merged', {
+                emails: ['test@email.com'],
+                phones: ['555-cached'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'volatile-merged',
+                traits: {
+                    emails: ['test@email.com'],
+                    ipAddress: '10.0.0.1',
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.VOLATILE_ONLY_CACHE_HIT);
+            expect(result.identity?.traits?.emails).toContain('test@email.com');
+            expect(result.identity?.traits?.phones).toContain('555-cached');
+            expect(result.identity?.traits?.ipAddress).toBe('10.0.0.1');
+        });
+    });
+    describe('trait merging', () => {
+        it('should merge incoming traits with cached traits on cache hit', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'merge-test', {
+                emails: ['cached@email.com'],
+                phones: ['555-cached'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const incomingIdentity = {
+                identityId: 'merge-test',
+                traits: {
+                    emails: ['cached@email.com'],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.identity?.traits?.emails).toContain('cached@email.com');
+            expect(result.identity?.traits?.phones).toContain('555-cached');
+        });
+    });
+});
+//# sourceMappingURL=identity-gateway-cache-hit.spec.js.map

package/dist/esm/__tests__/identity-cache/identity-gateway-cache-hit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-gateway-cache-hit.spec.js","sourceRoot":"","sources":["../../../../src/__tests__/identity-cache/identity-gateway-cache-hit.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/identity-cache/identity-gateway-cache-miss.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/identity-cache/identity-gateway-cache-miss.spec.js

@@ -0,0 +1,151 @@
+import { createService, mockGetIdentity, mockedDynamoDbClient, resetAllMocks, TEST_PIXEL_ID, IDENTITY_CACHE_WITH_CACHING_OUTCOME, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService cache miss scenarios', () => {
+    const pixelId = TEST_PIXEL_ID;
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    describe('Neptune resolution on cache miss', () => {
+        it('should call Neptune with incoming identity when no cached identity', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'neptune-resolved-id',
+                traits: { emails: ['test@email.com'] },
+            });
+            const incomingIdentity = {
+                identityId: 'incoming-id',
+                traits: { emails: ['test@email.com'] },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(mockGetIdentity).toHaveBeenCalledWith(pixelId, expect.objectContaining({
+                identity: expect.objectContaining({
+                    identityId: 'incoming-id',
+                }),
+            }));
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+            expect(result.didReadCache).toBe(true);
+            expect(result.didCallNeptune).toBe(true);
+        });
+        it('should return Neptune identity on successful resolution', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'from-neptune',
+                traits: { emails: ['neptune@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'original', traits: { emails: ['original@email.com'] } });
+            expect(result.identity?.identityId).toBe('from-neptune');
+            expect(result.identity?.traits?.emails).toContain('neptune@email.com');
+        });
+        it('should include traitChanges with "no cached identity" reason', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'new-identity',
+                traits: { emails: ['new@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'incoming', traits: { emails: ['incoming@email.com'] } });
+            expect(result.traitChanges).toEqual({
+                reason: { resolved: 'no cached identity' },
+            });
+        });
+        it('should not write to cache (identity service handles writes)', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'neptune-success',
+                traits: { emails: ['test@email.com'], phones: ['555-1234'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'incoming', traits: { emails: ['test@email.com'] } });
+            expect(result.didWriteCache).toBe(false);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+            expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+        });
+    });
+    describe('email pointer discovery', () => {
+        it('should discover identity ID from email lookup when incoming has no ID', async () => {
+            const service = createService();
+            const incomingNoId = {
+                traits: { emails: ['discovered@email.com'] },
+            };
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce({
+                pk: `email#${pixelId}#discovered@email.com`,
+                identityId: 'discovered-identity-id',
+            });
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'discovered-identity-id',
+                traits: { emails: ['discovered@email.com', 'other@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingNoId);
+            expect(result.identity?.identityId).toBe('discovered-identity-id');
+        });
+        it('should use incoming identity traits in Neptune call', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce({
+                pk: `email#${pixelId}#test@email.com`,
+                identityId: 'discovered-from-email',
+            });
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'neptune-resolved',
+                traits: { emails: ['test@email.com'] },
+            });
+            await service.resolveIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } });
+            expect(mockGetIdentity).toHaveBeenCalledWith(pixelId, expect.objectContaining({
+                identity: expect.objectContaining({
+                    traits: expect.objectContaining({ emails: ['test@email.com'] }),
+                }),
+            }));
+        });
+    });
+    describe('Neptune resolution failure', () => {
+        it('should fallback to incoming identity when Neptune fails', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockRejectedValueOnce(new Error('Neptune unavailable'));
+            const incomingIdentity = {
+                identityId: 'fallback-incoming',
+                traits: { emails: ['fallback@email.com'] },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLUTION_FAILED);
+            expect(result.didFallbackToIncoming).toBe(true);
+            expect(result.identity?.identityId).toBe('fallback-incoming');
+        });
+        it('should not write to cache when Neptune fails', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockRejectedValueOnce(new Error('Lambda timeout'));
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'test', traits: {} });
+            expect(result.didWriteCache).toBe(false);
+            expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+        });
+        it('should use discovered identity ID as fallback when available', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce({
+                pk: `email#${pixelId}#test@email.com`,
+                identityId: 'discovered-id',
+            });
+            mockGetIdentity.mockRejectedValueOnce(new Error('Neptune error'));
+            const result = await service.resolveIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } });
+            expect(result.didFallbackToIncoming).toBe(true);
+            expect(result.identity?.identityId).toBe('discovered-id');
+            expect(result.identity?.traits?.emails).toContain('test@email.com');
+        });
+    });
+    describe('cache read failure', () => {
+        it('should continue to Neptune when cache read fails (fail-open)', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'neptune-resolved',
+                traits: { emails: ['test@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'test-id', traits: { emails: ['test@email.com'] } });
+            expect(result.identity).toBeDefined();
+            expect(result.identity?.identityId).toBe('neptune-resolved');
+            expect(result.didReadCache).toBe(true);
+            expect(result.didCallNeptune).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=identity-gateway-cache-miss.spec.js.map

package/dist/esm/__tests__/identity-cache/identity-gateway-cache-miss.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-gateway-cache-miss.spec.js","sourceRoot":"","sources":["../../../../src/__tests__/identity-cache/identity-gateway-cache-miss.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/identity-cache/identity-gateway-constructor.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/identity-cache/identity-gateway-constructor.spec.js

@@ -0,0 +1,70 @@
+import { IdentityGatewayService, mockSQSClientConstructor, resetAllMocks, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService constructor()', () => {
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    it('should configure with direct queue URL', () => {
+        const options = {
+            asyncUpdateQueueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/test-queue',
+        };
+        const service = new IdentityGatewayService(options);
+        expect(service.sqsClient).toBeDefined();
+    });
+    it('should configure with region/accountId/queueName', () => {
+        const options = {
+            awsRegion: 'us-east-1',
+            awsAccountId: '123456789',
+            asyncUpdateQueueName: 'identity-async-queue',
+        };
+        const service = new IdentityGatewayService(options);
+        expect(mockSQSClientConstructor).toHaveBeenCalledWith('us-east-1', '123456789', 'identity-async-queue');
+        expect(service.sqsClient).toBeDefined();
+    });
+    it('should fallback to environment variable for queue name', () => {
+        const originalEnv = process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME;
+        process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME = 'env-queue-name';
+        try {
+            const options = {
+                awsRegion: 'us-west-2',
+                awsAccountId: '987654321',
+            };
+            new IdentityGatewayService(options);
+            expect(mockSQSClientConstructor).toHaveBeenCalledWith('us-west-2', '987654321', 'env-queue-name');
+        }
+        finally {
+            if (originalEnv !== undefined) {
+                process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME = originalEnv;
+            }
+            else {
+                delete process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME;
+            }
+        }
+    });
+    it('should not configure SQS when region/accountId provided but no queue name', () => {
+        const originalEnv = process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME;
+        delete process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME;
+        try {
+            const options = {
+                awsRegion: 'us-east-1',
+                awsAccountId: '123456789',
+            };
+            const service = new IdentityGatewayService(options);
+            expect(mockSQSClientConstructor).not.toHaveBeenCalled();
+            expect(service.sqsClient).toBeUndefined();
+        }
+        finally {
+            if (originalEnv !== undefined) {
+                process.env.IDENTIFY_ASYNC_UPDATE_QUEUE_NAME = originalEnv;
+            }
+        }
+    });
+    it('should not configure SQS when only region provided', () => {
+        const options = {
+            awsRegion: 'us-east-1',
+        };
+        const service = new IdentityGatewayService(options);
+        expect(mockSQSClientConstructor).not.toHaveBeenCalled();
+        expect(service.sqsClient).toBeUndefined();
+    });
+});
+//# sourceMappingURL=identity-gateway-constructor.spec.js.map

package/dist/esm/__tests__/identity-cache/identity-gateway-constructor.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-gateway-constructor.spec.js","sourceRoot":"","sources":["../../../../src/__tests__/identity-cache/identity-gateway-constructor.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/identity-cache/identity-gateway-edge-cases.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/identity-cache/identity-gateway-edge-cases.spec.js

@@ -0,0 +1,87 @@
+import { createService, createServiceWithSqs, createCachedIdentity, mockGetIdentity, mockBuildAndSendMessage, mockedDynamoDbClient, mockedLogger, resetAllMocks, TEST_PIXEL_ID, IDENTITY_CACHE_WITH_CACHING_OUTCOME, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService edge cases', () => {
+    const pixelId = TEST_PIXEL_ID;
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    describe('invalid input handling', () => {
+        it('should return invalid input when pixelId is undefined', async () => {
+            const service = createService();
+            const result = await service.resolveIdentityWithCaching(undefined, { identityId: 'test' });
+            expect(result.identity).toBeUndefined();
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.INVALID_INPUT);
+            expect(result.didReadCache).toBe(false);
+            expect(result.didWriteCache).toBe(false);
+        });
+        it('should return invalid input when incomingIdentity is null', async () => {
+            const service = createService();
+            const result = await service.resolveIdentityWithCaching(pixelId, null);
+            expect(result.identity).toBeUndefined();
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.INVALID_INPUT);
+        });
+        it('should return invalid input when both pixelId and identity are missing', async () => {
+            const service = createService();
+            const result = await service.resolveIdentityWithCaching('', undefined);
+            expect(result.identity).toBeUndefined();
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.INVALID_INPUT);
+        });
+    });
+    describe('enqueue validation', () => {
+        it('should reject identity with undefined identityId', async () => {
+            const service = createServiceWithSqs();
+            const identity = { traits: { emails: ['test@email.com'] } };
+            const context = { identity };
+            const result = await service.enqueueAsyncIdentityUpdate({
+                pixelId,
+                identity,
+                context,
+                reason: 'anonymous user',
+            });
+            expect(result.success).toBe(false);
+            expect(result.error).toBe('Missing required pixelId or identityId');
+            expect(mockBuildAndSendMessage).not.toHaveBeenCalled();
+            expect(mockedLogger.warn).toHaveBeenCalledWith('IdentityGateway - enqueueAsyncIdentityUpdate: missing required params', expect.objectContaining({
+                pixelId,
+                identityId: undefined,
+            }));
+        });
+    });
+    describe('result fields consistency', () => {
+        it('should include all required fields in result', async () => {
+            const service = createService();
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'resolved-id',
+                traits: { emails: ['test@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'incoming-id', traits: { emails: ['test@email.com'] } });
+            expect(result).toEqual(expect.objectContaining({
+                outcome: expect.any(String),
+                pixelId,
+                identityId: 'resolved-id',
+                didReadCache: true,
+                didCallNeptune: true,
+                didWriteCache: false,
+                didSkipNeptune: false,
+                didFallbackToIncoming: false,
+                didEnqueueAsync: false,
+            }));
+        });
+        it('should include traitChanges when identity changes via Neptune', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'identity456', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'identity456',
+                traits: { emails: ['old@email.com', 'new@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'identity456', traits: { emails: ['old@email.com', 'new@email.com'] } });
+            if (result.outcome === IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED) {
+                expect(result.traitChanges).toBeDefined();
+            }
+        });
+    });
+});
+//# sourceMappingURL=identity-gateway-edge-cases.spec.js.map

package/dist/esm/__tests__/identity-cache/identity-gateway-edge-cases.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-gateway-edge-cases.spec.js","sourceRoot":"","sources":["../../../../src/__tests__/identity-cache/identity-gateway-edge-cases.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/identity-cache/identity-gateway-enqueue-async.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/identity-cache/identity-gateway-enqueue-async.spec.js

@@ -0,0 +1,134 @@
+import { createService, createServiceWithSqs, mockBuildAndSendMessage, mockedLogger, resetAllMocks, TEST_PIXEL_ID, TEST_LAMBDA_ARN, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService enqueueAsyncIdentityUpdate()', () => {
+    const pixelId = TEST_PIXEL_ID;
+    const testIdentity = {
+        identityId: 'identity456',
+        traits: { emails: ['test@email.com'] },
+    };
+    const testContext = {
+        identity: testIdentity,
+    };
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    it('should return error result when SQS client is not configured', async () => {
+        const service = createService({ identifyPrivateLambdaArn: TEST_LAMBDA_ARN });
+        const result = await service.enqueueAsyncIdentityUpdate({
+            pixelId,
+            identity: testIdentity,
+            context: testContext,
+            reason: 'test reason',
+            eventId: 'event123',
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('SQS client not configured');
+        expect(result.messageId).toBeUndefined();
+        expect(mockedLogger.warn).toHaveBeenCalledWith('IdentityGateway - enqueueAsyncIdentityUpdate: SQS client not configured', expect.objectContaining({
+            pixelId,
+            identityId: testIdentity.identityId,
+            reason: 'test reason',
+            eventId: 'event123',
+        }));
+    });
+    it('should successfully enqueue message when SQS client is configured', async () => {
+        const service = createServiceWithSqs();
+        mockBuildAndSendMessage.mockResolvedValueOnce({
+            MessageId: 'sqs-message-id-123',
+        });
+        const result = await service.enqueueAsyncIdentityUpdate({
+            pixelId,
+            identity: testIdentity,
+            context: testContext,
+            reason: 'stale cache traits',
+            eventId: 'event456',
+        });
+        expect(result.success).toBe(true);
+        expect(result.messageId).toBe('sqs-message-id-123');
+        expect(result.error).toBeUndefined();
+        expect(mockBuildAndSendMessage).toHaveBeenCalledWith('identify.updateAsync', expect.objectContaining({
+            pixelId,
+            incomingIdentityId: testIdentity.identityId,
+            context: testContext,
+        }));
+        expect(mockedLogger.debug).toHaveBeenCalledWith('IdentityGateway - enqueueAsyncIdentityUpdate: message sent', expect.objectContaining({
+            pixelId,
+            identityId: testIdentity.identityId,
+            reason: 'stale cache traits',
+            eventId: 'event456',
+            sqsMessageId: 'sqs-message-id-123',
+        }));
+    });
+    it('should fail open with logging when SQS send fails', async () => {
+        const service = createServiceWithSqs();
+        mockBuildAndSendMessage.mockRejectedValueOnce(new Error('SQS send failed'));
+        const result = await service.enqueueAsyncIdentityUpdate({
+            pixelId,
+            identity: testIdentity,
+            context: testContext,
+            reason: 'test reason',
+            eventId: 'event789',
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('SQS send failed');
+        expect(result.messageId).toBeUndefined();
+        expect(mockedLogger.warn).toHaveBeenCalledWith('IdentityGateway - enqueueAsyncIdentityUpdate: failed to enqueue (failing open)', expect.objectContaining({
+            error: expect.any(Error),
+            errorMessage: 'SQS send failed',
+            pixelId,
+            identityId: testIdentity.identityId,
+            reason: 'test reason',
+            eventId: 'event789',
+        }));
+    });
+    it('should build message shape matching IdentifyAsyncUpdateMessage interface', async () => {
+        const service = createServiceWithSqs();
+        mockBuildAndSendMessage.mockResolvedValueOnce({ MessageId: 'test-id' });
+        const identity = {
+            identityId: 'id-xyz',
+            traits: { emails: ['user@example.com'], userIds: ['user-1'] },
+        };
+        const context = { identity };
+        await service.enqueueAsyncIdentityUpdate({
+            pixelId: 'pixel-abc',
+            identity,
+            context,
+            reason: 'test',
+        });
+        const messageArg = mockBuildAndSendMessage.mock.calls[0][1];
+        expect(messageArg).toEqual({
+            pixelId: 'pixel-abc',
+            incomingIdentityId: 'id-xyz',
+            context,
+        });
+    });
+    it('should return error when identity has no identityId', async () => {
+        const service = createServiceWithSqs();
+        const identityWithoutId = {
+            traits: { emails: ['anon@example.com'] },
+        };
+        const context = { identity: identityWithoutId };
+        const result = await service.enqueueAsyncIdentityUpdate({
+            pixelId,
+            identity: identityWithoutId,
+            context,
+            reason: 'anonymous identity',
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Missing required pixelId or identityId');
+        expect(mockBuildAndSendMessage).not.toHaveBeenCalled();
+    });
+    it('should handle optional eventId parameter', async () => {
+        const service = createServiceWithSqs();
+        mockBuildAndSendMessage.mockResolvedValueOnce({ MessageId: 'test-id' });
+        await service.enqueueAsyncIdentityUpdate({
+            pixelId,
+            identity: testIdentity,
+            context: testContext,
+            reason: 'test',
+        });
+        expect(mockedLogger.debug).toHaveBeenCalledWith('IdentityGateway - enqueueAsyncIdentityUpdate: message sent', expect.objectContaining({
+            eventId: undefined,
+        }));
+    });
+});
+//# sourceMappingURL=identity-gateway-enqueue-async.spec.js.map