@adtrackify/at-service-common 4.0.13 → 4.0.15

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

@@ -0,0 +1,222 @@
+import { createService, createServiceWithSqs, createCachedIdentity, mockGetIdentity, mockBuildAndSendMessage, mockedDynamoDbClient, resetAllMocks, TEST_PIXEL_ID, IDENTITY_CACHE_WITH_CACHING_OUTCOME, } from './identity-gateway-test-setup.js';
+describe('IdentityGatewayService stale cache scenarios', () => {
+    const pixelId = TEST_PIXEL_ID;
+    beforeEach(() => {
+        resetAllMocks();
+    });
+    describe('identity-defining trait changes → Neptune', () => {
+        it('should call Neptune when new emails are added', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'staleness-compute', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'staleness-compute',
+                traits: { emails: ['old@email.com', 'new@email.com'] },
+            });
+            const incomingIdentity = {
+                identityId: 'staleness-compute',
+                traits: {
+                    emails: ['old@email.com', 'new@email.com'],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.didCallNeptune).toBe(true);
+            expect(result.stalenessResult?.staleTraits).toContain('emails');
+        });
+        it('should not skip Neptune for IDENTITY_STALE tier', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'call-neptune', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'call-neptune',
+                traits: { emails: ['old@email.com', 'new@email.com'] },
+            });
+            const incomingIdentity = {
+                identityId: 'call-neptune',
+                traits: {
+                    emails: ['old@email.com', 'new@email.com'],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.didSkipNeptune).toBe(false);
+            expect(result.didCallNeptune).toBe(true);
+            expect(mockGetIdentity).toHaveBeenCalled();
+        });
+    });
+    describe('Neptune resolution success', () => {
+        it('should return NEPTUNE_RESOLVED outcome', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'stale-reason', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'stale-reason',
+                traits: { emails: ['old@email.com', 'new@email.com'] },
+            });
+            const incomingIdentity = {
+                identityId: 'stale-reason',
+                traits: {
+                    emails: ['old@email.com', 'new@email.com'],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, incomingIdentity);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+        });
+        it('should compute traitChanges between cached and Neptune identity', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'trait-changes', {
+                emails: ['old@email.com'],
+                phones: ['555-old'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'trait-changes',
+                traits: {
+                    emails: ['old@email.com', 'new@email.com'],
+                    phones: ['555-old', '555-new'],
+                },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'trait-changes', traits: { emails: ['old@email.com', 'new@email.com'] } });
+            expect(result.traitChanges).toBeDefined();
+            expect(result.traitChanges?.emails).toBeDefined();
+        });
+        it('should not write to cache (identity service handles writes)', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'neptune-write', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'neptune-write',
+                traits: {
+                    emails: ['old@email.com', 'new@email.com'],
+                    phones: ['555-neptune'],
+                },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'neptune-write', traits: { emails: ['old@email.com', 'new@email.com'] } });
+            expect(result.didWriteCache).toBe(false);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+            expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+        });
+        it('should still return Neptune identity when it matches cached', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'no-changes', {
+                emails: ['same@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'no-changes',
+                traits: { emails: ['same@email.com'] },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'no-changes', traits: { emails: ['same@email.com', 'thought-new@email.com'] } });
+            expect(result.didCallNeptune).toBe(true);
+            expect(result.didWriteCache).toBe(false);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+        });
+        it('should strip address timestamps when comparing Neptune result', async () => {
+            const service = createService();
+            const now = Date.now();
+            const cachedResponse = {
+                pk: `identity#${pixelId}#addr-timestamp`,
+                pixelId,
+                identityId: 'addr-timestamp',
+                response: {
+                    identityId: 'addr-timestamp',
+                    traits: {
+                        emails: ['test@email.com'],
+                        addresses: [{ city: 'NYC', cra: now - 1000, upa: now - 500 }],
+                    },
+                },
+                updatedAt: new Date().toISOString(),
+            };
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockResolvedValueOnce({
+                identityId: 'addr-timestamp',
+                traits: {
+                    emails: ['test@email.com'],
+                    addresses: [{ city: 'NYC', cra: now, upa: now }],
+                },
+            });
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'addr-timestamp', traits: { emails: ['test@email.com', 'new@email.com'] } });
+            expect(result.didWriteCache).toBe(false);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLVED);
+        });
+    });
+    describe('Neptune resolution failure', () => {
+        it('should return NEPTUNE_RESOLUTION_FAILED outcome', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'neptune-throws', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockRejectedValueOnce(new Error('Neptune invocation failed'));
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'neptune-throws', traits: { emails: ['old@email.com', 'new@email.com'] } });
+            expect(result.didCallNeptune).toBe(true);
+            expect(result.didWriteCache).toBe(false);
+            expect(result.outcome).toBe(IDENTITY_CACHE_WITH_CACHING_OUTCOME.NEPTUNE_RESOLUTION_FAILED);
+        });
+        it('should return merged identity on Neptune failure (fail-open)', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'neptune-throws', {
+                emails: ['old@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockRejectedValueOnce(new Error('Neptune invocation failed'));
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'neptune-throws', traits: { emails: ['old@email.com', 'new@email.com'] } });
+            expect(result.identity).toBeDefined();
+            expect(result.identity?.identityId).toBe('neptune-throws');
+            expect(result.identity?.traits?.emails).toEqual(['old@email.com', 'new@email.com']);
+        });
+        it('should not write to cache when Neptune fails', async () => {
+            const service = createService();
+            const cachedResponse = createCachedIdentity(pixelId, 'no-write-fail', {
+                emails: ['test@email.com'],
+            });
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            mockGetIdentity.mockRejectedValueOnce(new Error('Network error'));
+            const result = await service.resolveIdentityWithCaching(pixelId, { identityId: 'no-write-fail', traits: { emails: ['test@email.com', 'extra@email.com'] } });
+            expect(result.didWriteCache).toBe(false);
+            expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+        });
+    });
+    describe('address update path', () => {
+        it('should enqueue async update on address changes', async () => {
+            const service = createServiceWithSqs();
+            mockBuildAndSendMessage.mockResolvedValueOnce({ MessageId: 'test-msg-id' });
+            const cachedResponse = {
+                pk: `identity#${pixelId}#identity456`,
+                pixelId,
+                identityId: 'identity456',
+                response: {
+                    identityId: 'identity456',
+                    traits: {
+                        emails: ['test@email.com'],
+                        addresses: [{ city: 'Old City', upa: 1704067200000 }],
+                    },
+                },
+                updatedAt: new Date().toISOString(),
+            };
+            mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
+            const identityWithNewAddress = {
+                identityId: 'identity456',
+                traits: {
+                    emails: ['test@email.com'],
+                    addresses: [{ city: 'New City', upa: 1717200000000 }],
+                },
+            };
+            const result = await service.resolveIdentityWithCaching(pixelId, identityWithNewAddress);
+            if (result.outcome === IDENTITY_CACHE_WITH_CACHING_OUTCOME.ADDRESS_UPDATE_ASYNC) {
+                expect(result.didWriteCache).toBe(false);
+                expect(result.didEnqueueAsync).toBe(true);
+                expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
+                expect(mockBuildAndSendMessage).toHaveBeenCalled();
+            }
+        });
+    });
+});
+//# sourceMappingURL=identity-gateway-stale-cache.spec.js.map

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

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

package/dist/esm/__tests__/identity-cache/identity-gateway-test-setup.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="jest" />
+import { EventContext, EventIdentity, IdentityDynamoDbCache } from '@adtrackify/at-tracking-event-types';
+export declare const mockLambdaInvokeFunction: jest.Mock<any, any>;
+export declare const mockBuildAndSendMessage: jest.Mock<any, any>;
+export declare const mockSQSClientConstructor: jest.Mock<any, any>;
+export declare const mockGetIdentity: jest.Mock<any, any>;
+import { IdentityGatewayService, IdentityGatewayServiceOptions } from '../../services/db/identity-cache-dynamodb-service/identity-gateway-service.js';
+import { IDENTITY_CACHE_WITH_CACHING_OUTCOME } from '../../services/db/identity-cache-dynamodb-service/types.js';
+import { DynamoDbClient, SQSClient } from '../../clients/index.js';
+export declare const mockedDynamoDbClient: jest.Mocked<typeof DynamoDbClient>;
+export declare const mockedLogger: jest.Mocked<{
+    log: (logLevel: string, msg: string | Error, meta?: object | undefined, tags?: string[] | undefined) => void;
+    debug: (msg: string, meta?: object | undefined, tags?: string[] | undefined) => void;
+    info: (msg: string, meta?: object | undefined, tags?: string[] | undefined) => void;
+    warn: (msg: string, meta?: object | undefined, tags?: string[] | undefined) => void;
+    error: (msg: string | Error, meta?: object | undefined, tags?: string[] | undefined) => void;
+}>;
+export declare const mockedSQSClient: jest.MockedClass<typeof SQSClient>;
+export { IdentityGatewayService };
+export { IDENTITY_CACHE_WITH_CACHING_OUTCOME };
+export type { IdentityGatewayServiceOptions };
+export type { EventContext, EventIdentity, IdentityDynamoDbCache };
+export declare const TEST_PIXEL_ID = "pixel123";
+export declare const TEST_LAMBDA_ARN = "arn:aws:lambda:us-east-1:123456789:function:identity-private";
+export declare const createService: (options?: IdentityGatewayServiceOptions) => IdentityGatewayService;
+export declare const createServiceWithSqs: (overrides?: Partial<IdentityGatewayServiceOptions>) => IdentityGatewayService;
+export declare const resetAllMocks: () => void;
+export declare const createCachedIdentity: (pixelId: string, identityId: string, traits: EventIdentity['traits'], updatedAt?: string) => IdentityDynamoDbCache;

package/dist/esm/__tests__/identity-cache/identity-gateway-test-setup.js

@@ -0,0 +1,83 @@
+export const mockLambdaInvokeFunction = jest.fn();
+export const mockBuildAndSendMessage = jest.fn();
+export const mockSQSClientConstructor = jest.fn();
+export const mockGetIdentity = jest.fn();
+jest.mock('../../clients/index.js', () => ({
+    DynamoDbClient: {
+        safeGet: jest.fn(),
+        safePut: jest.fn(),
+        safeDelete: jest.fn(),
+        safeBatchGet: jest.fn(),
+        safeBatchWrite: jest.fn(),
+        safeQueryByGSI: jest.fn(),
+        batchWrite: jest.fn(),
+    },
+    LambdaInvokeClient: jest.fn().mockImplementation(() => ({
+        invokeFunction: mockLambdaInvokeFunction,
+    })),
+    SQSClient: jest.fn().mockImplementation((_region, _accountId, _queueName) => {
+        mockSQSClientConstructor(_region, _accountId, _queueName);
+        return {
+            buildAndSendMessage: mockBuildAndSendMessage,
+            queueUrl: `https://sqs.${_region}.amazonaws.com/${_accountId}/${_queueName}`,
+        };
+    }),
+}));
+jest.mock('../../helpers/index.js', () => ({
+    Logger: {
+        debug: jest.fn(),
+        info: jest.fn(),
+        warn: jest.fn(),
+        error: jest.fn(),
+    },
+}));
+jest.mock('../../clients/internal-api/identity-client.js', () => ({
+    IdentityClient: jest.fn().mockImplementation(() => ({
+        getIdentity: mockGetIdentity,
+    })),
+}));
+import { IdentityGatewayService, } from '../../services/db/identity-cache-dynamodb-service/identity-gateway-service.js';
+import { IDENTITY_CACHE_WITH_CACHING_OUTCOME, } from '../../services/db/identity-cache-dynamodb-service/types.js';
+import { DynamoDbClient, SQSClient } from '../../clients/index.js';
+import { Logger } from '../../helpers/index.js';
+export const mockedDynamoDbClient = DynamoDbClient;
+export const mockedLogger = Logger;
+export const mockedSQSClient = SQSClient;
+export { IdentityGatewayService };
+export { IDENTITY_CACHE_WITH_CACHING_OUTCOME };
+export const TEST_PIXEL_ID = 'pixel123';
+export const TEST_LAMBDA_ARN = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
+export const createService = (options = { identifyPrivateLambdaArn: TEST_LAMBDA_ARN }) => {
+    return new IdentityGatewayService(options);
+};
+export const createServiceWithSqs = (overrides = {}) => {
+    return new IdentityGatewayService({
+        identifyPrivateLambdaArn: TEST_LAMBDA_ARN,
+        awsRegion: 'us-east-1',
+        awsAccountId: '123456789',
+        asyncUpdateQueueName: 'test-queue',
+        ...overrides,
+    });
+};
+export const resetAllMocks = () => {
+    jest.clearAllMocks();
+    mockedDynamoDbClient.safeGet.mockReset();
+    mockedDynamoDbClient.safePut.mockReset();
+    mockedDynamoDbClient.safeDelete.mockReset();
+    mockedDynamoDbClient.safeBatchGet.mockReset();
+    mockedDynamoDbClient.safeBatchWrite.mockReset();
+    mockedDynamoDbClient.safeQueryByGSI.mockReset();
+    mockedDynamoDbClient.batchWrite.mockReset();
+    mockGetIdentity.mockReset();
+    mockBuildAndSendMessage.mockReset();
+    mockSQSClientConstructor.mockReset();
+    mockedSQSClient.mockClear();
+};
+export const createCachedIdentity = (pixelId, identityId, traits, updatedAt = new Date().toISOString()) => ({
+    pk: `identity#${pixelId}#${identityId}`,
+    pixelId,
+    identityId,
+    response: { identityId, traits },
+    updatedAt,
+});
+//# sourceMappingURL=identity-gateway-test-setup.js.map

package/dist/esm/__tests__/identity-cache/identity-gateway-test-setup.js.map

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

package/dist/esm/clients/internal-api/identity-client.d.ts

@@ -14,18 +14,28 @@ export interface MergeIdentityResponse {
 export interface IdentityLookupByEmailResponse {
     identities: EventIdentity[];
 }
+export interface IdentityClientOptions {
+    baseApiUrl: string;
+    identityApiKey?: string;
+    identifyPrivateLambdaArn?: string;
+}
 export declare class IdentityClient {
     BASE_API_URL: string;
     SERVICE_API_ROOT_URL: string;
     IDENTITY_API_KEY?: string;
     client: GenericHttpClient;
-    constructor(baseApiUrl: string, identityApiKey?: string);
+    private identifyPrivateLambdaArn?;
+    private lambdaInvokeClient?;
+    constructor(baseApiUrlOrOptions: string | IdentityClientOptions, identityApiKey?: string);
+    private getLambdaInvokeClient;
     getHeaders: () => {
         'x-api-key': string;
     } | {
         'x-api-key'?: undefined;
     };
-    getIdentity: (pixelId: string, eventContext: EventContext | undefined, excludeThirdPartyContacts?: boolean) => Promise<any>;
+    getIdentity: (pixelId: string, eventContext: EventContext | undefined, excludeThirdPartyContacts?: boolean) => Promise<EventIdentity | null>;
+    private getIdentityViaLambda;
+    private getIdentityViaHttp;
     mergeIdentity: (pixelId: string, primaryIdentityId: string, secondaryIdentityId: string) => Promise<MergeIdentityResponse | null>;
     getIdentitiesByEmail: (email: string, pixelId?: string) => Promise<IdentityLookupByEmailResponse | null>;
 }

package/dist/esm/clients/internal-api/identity-client.js

@@ -1,5 +1,5 @@
 import { HttpStatusCodes } from '../../libs';
-import { axiosHttpService } from '../generic';
+import { axiosHttpService, LambdaInvokeClient } from '../generic';
 import { Logger } from '../../helpers';
 const client = axiosHttpService({
     headers: {
@@ -11,13 +11,28 @@ export class IdentityClient {
     SERVICE_API_ROOT_URL;
     IDENTITY_API_KEY;
     client;
-    constructor(baseApiUrl, identityApiKey) {
-        this.BASE_API_URL = baseApiUrl;
-        this.IDENTITY_API_KEY = identityApiKey;
+    identifyPrivateLambdaArn;
+    lambdaInvokeClient;
+    constructor(baseApiUrlOrOptions, identityApiKey) {
+        if (typeof baseApiUrlOrOptions === 'string') {
+            this.BASE_API_URL = baseApiUrlOrOptions;
+            this.IDENTITY_API_KEY = identityApiKey;
+        }
+        else {
+            this.BASE_API_URL = baseApiUrlOrOptions.baseApiUrl;
+            this.IDENTITY_API_KEY = baseApiUrlOrOptions.identityApiKey;
+            this.identifyPrivateLambdaArn = baseApiUrlOrOptions.identifyPrivateLambdaArn;
+        }
         this.SERVICE_API_ROOT_URL = `${this.BASE_API_URL}/identities`;
         this.client = client;
         this.client.setBaseUrl(this.SERVICE_API_ROOT_URL);
     }
+    getLambdaInvokeClient() {
+        if (!this.lambdaInvokeClient) {
+            this.lambdaInvokeClient = new LambdaInvokeClient();
+        }
+        return this.lambdaInvokeClient;
+    }
     getHeaders = () => {
         if (this.IDENTITY_API_KEY) {
             return {
@@ -27,20 +42,51 @@ export class IdentityClient {
         return {};
     };
     getIdentity = async (pixelId, eventContext, excludeThirdPartyContacts = false) => {
+        if (this.identifyPrivateLambdaArn) {
+            return this.getIdentityViaLambda(pixelId, eventContext);
+        }
+        return this.getIdentityViaHttp(pixelId, eventContext, excludeThirdPartyContacts);
+    };
+    getIdentityViaLambda = async (pixelId, eventContext) => {
         try {
-            const identityResponse = await this.client.post('/', { pixelId, context: eventContext || {}, excludeThirdPartyContacts }, { headers: this.getHeaders() });
-            if (identityResponse.status != HttpStatusCodes.OK) {
-                const msg = 'HTTP Status Code Failed while retrieving identity data';
-                Logger.error(msg, { identityResponse });
-                return null;
-            }
-            if (identityResponse.status === HttpStatusCodes.OK) {
-                return identityResponse?.data?.identity;
+            const lambdaClient = this.getLambdaInvokeClient();
+            const response = await lambdaClient.invokeFunction(this.identifyPrivateLambdaArn, {
+                pixelId,
+                context: eventContext ?? { identity: {} },
+            });
+            if (response?.statusCode === 200 && response?.body) {
+                const identifyResponse = JSON.parse(response.body);
+                return identifyResponse?.identity ?? null;
             }
+            return eventContext?.identity ?? null;
+        }
+        catch (error) {
+            Logger.error('IdentityClient - Lambda invoke failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+            });
             return null;
         }
-        catch (e) {
-            Logger.error('Error while retrieving identity', { error: e });
+    };
+    getIdentityViaHttp = async (pixelId, eventContext, excludeThirdPartyContacts) => {
+        try {
+            const identityResponse = await this.client.post('/', { pixelId, context: eventContext ?? {}, excludeThirdPartyContacts }, { headers: this.getHeaders() });
+            if (identityResponse.status !== HttpStatusCodes.OK) {
+                Logger.error('IdentityClient - HTTP status code failed while retrieving identity', {
+                    pixelId,
+                    statusCode: identityResponse.status,
+                });
+                return null;
+            }
+            return identityResponse?.data?.identity ?? null;
+        }
+        catch (error) {
+            Logger.error('IdentityClient - HTTP request failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+            });
             return null;
         }
     };

package/dist/esm/clients/internal-api/identity-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity-client.js","sourceRoot":"","sources":["../../../../src/clients/internal-api/identity-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"identity-client.js","sourceRoot":"","sources":["../../../../src/clients/internal-api/identity-client.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/db/identity-cache-dynamodb-service/identity-cache-dynamodb-db-service.d.ts

@@ -1,15 +1,9 @@
 import { EventIdentity, IdentityMapDynamoDbCache } from '@adtrackify/at-tracking-event-types';
-import { IdentityCacheResult, IdentityCacheLookupResult, PureCacheLookupResult } from './types.js';
+import { PureCacheLookupResult } from './types.js';
 export declare class IdentityCacheDynamoDbDbService {
-    static getIdentityFromCache: (pixelId: string, incomingIdentity: EventIdentity) => Promise<IdentityCacheResult>;
-    static getIdentityFromCacheV2: (pixelId: string, incomingIdentity: EventIdentity) => Promise<IdentityCacheLookupResult>;
     static getIdentityFromCachePure: (pixelId: string, incomingIdentity: EventIdentity) => Promise<PureCacheLookupResult>;
     private static resolveCacheByIdentityIdPure;
     private static resolveCacheByEmailPointerPure;
-    private static resolveCacheByIdentityIdV2;
-    private static applyPrimaryCacheHitState;
-    private static createPrimaryCacheLookupResult;
-    private static resolveCacheByEmailPointerV2;
     static getIdentityMap: (pixelId: string, identityId: string) => Promise<IdentityMapDynamoDbCache | undefined>;
     static getForcePurgeFlag: (pixelId: string, identityId: string) => Promise<boolean>;
     static updateIdentityCache: (pixelId: string, response: EventIdentity) => Promise<void>;