@adtrackify/at-service-common 4.0.5 → 4.0.6

package/dist/esm/services/db/{identity-cache-dynamodb-service.js → identity-cache-dynamodb-service/identity-cache-dynamodb-db-service.js}

@@ -1,164 +1,15 @@
-import { buildIdentityPk, buildEmailPk, buildIdentityMapPk, buildForcePurgePk, } from '@adtrackify/at-tracking-event-types';
 import { mergeIdentityTraits } from '@adtrackify/at-shared-utils';
 import fastDeepEqual from 'fast-deep-equal';
 import { DateTime } from 'luxon';
-import { DynamoDbClient, LambdaInvokeClient } from '../../clients/index.js';
-import { Logger } from '../../helpers/index.js';
-import { isIdentityCacheStale, IDENTITY_CACHE_STALENESS_TIER, } from '../../helpers/identity-cache-helper.js';
-const TABLE_NAME = process.env.IDENTITY_CACHE_TABLE_V2 ?? '';
-const GSI1_NAME = process.env.IDENTITY_CACHE_GSI1 ?? 'gsi1pk-index';
-const FORCE_PURGE_TTL_SECONDS = 60 * 60 * 24 * 30;
-export var CACHE_WRITE_REASON;
-(function (CACHE_WRITE_REASON) {
-    CACHE_WRITE_REASON["CACHE_MISS"] = "cache_miss";
-    CACHE_WRITE_REASON["STALE_TRAITS"] = "stale_traits";
-    CACHE_WRITE_REASON["EMAIL_POINTER_DISCOVERY"] = "email_pointer_discovery";
-    CACHE_WRITE_REASON["ADDRESS_UPDATE"] = "address_update";
-})(CACHE_WRITE_REASON || (CACHE_WRITE_REASON = {}));
-export class IdentityCacheDynamoDbService {
-    static lambdaInvokeClient;
-    static getLambdaInvokeClient() {
-        if (!this.lambdaInvokeClient) {
-            this.lambdaInvokeClient = new LambdaInvokeClient();
-        }
-        return this.lambdaInvokeClient;
-    }
-    static getIdentityWithCaching = async (pixelId, incomingIdentity, identifyPrivateLambdaArn) => {
-        try {
-            if (!pixelId || !incomingIdentity) {
-                Logger.error('IdentityCache - missing required params', { pixelId, incomingIdentity });
-                return undefined;
-            }
-            const cacheResponse = await this.readFromCache(pixelId, incomingIdentity);
-            let resolvedIdentity = cacheResponse.resolvedIdentity;
-            const isCacheStale = cacheResponse.isCacheStale;
-            const cachedIdentity = cacheResponse.cachedIdentity;
-            const staleTracker = cacheResponse.staleTracker;
-            const writeReason = cacheResponse.writeReason;
-            const staleTier = cacheResponse.staleTier;
-            const skipNeptune = cacheResponse.skipNeptune;
-            if (resolvedIdentity && !isCacheStale) {
-                const tierLabel = staleTier === IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY ? 'volatile_traits_only' : 'fresh';
-                Logger.debug(`IdentityCache - identity cache hit - ${tierLabel}`, {
-                    pixelId,
-                    identityId: resolvedIdentity.identityId,
-                    staleTier,
-                    cachedIdentity: cachedIdentity ?? null,
-                    incomingIdentity,
-                    resolvedIdentity,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                    cachedClick: cachedIdentity?.traits?.click ?? null,
-                    resolvedClick: resolvedIdentity?.traits?.click ?? null,
-                });
-                return resolvedIdentity;
-            }
-            if (resolvedIdentity && skipNeptune && writeReason === CACHE_WRITE_REASON.ADDRESS_UPDATE) {
-                const staleTraits = staleTracker ? this.extractStaleTraitNames(staleTracker) : [];
-                Logger.info('IdentityCache - identity cache write: address update only (skipping Neptune)', {
-                    pixelId,
-                    identityId: resolvedIdentity.identityId,
-                    writeReason,
-                    staleTier,
-                    staleTraits,
-                    cachedIdentity: cachedIdentity ?? null,
-                    incomingIdentity,
-                    resolvedIdentity,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                    cachedClick: cachedIdentity?.traits?.click ?? null,
-                    resolvedClick: resolvedIdentity?.traits?.click ?? null,
-                    traitChanges: cachedIdentity ? this.computeTraitChanges(cachedIdentity, resolvedIdentity) : { reason: 'no cached identity' },
-                });
-                await this.safeWriteBackToCache(pixelId, resolvedIdentity, 'address update');
-                return resolvedIdentity;
-            }
-            const identityForNeptune = resolvedIdentity ?? incomingIdentity;
-            Logger.info('IdentityCache - identity cache stale - fetching from Neptune', {
-                pixelId,
-                identityId: identityForNeptune?.identityId,
-                staleTier,
-                writeReason,
-                staleTraits: staleTracker ? this.extractStaleTraitNames(staleTracker) : [],
-                cachedIdentity: cachedIdentity ?? null,
-                incomingIdentity,
-                identityForNeptune,
-                incomingClick: incomingIdentity?.traits?.click ?? null,
-                cachedClick: cachedIdentity?.traits?.click ?? null,
-                hasDiscoveredIdentityId: !!resolvedIdentity?.identityId,
-            });
-            const neptuneIdentity = await this.resolveFromNeptune(pixelId, identityForNeptune, identifyPrivateLambdaArn);
-            if (neptuneIdentity) {
-                resolvedIdentity = neptuneIdentity;
-                const cachedForComparison = cachedIdentity ? this.stripAddressTimestamps(cachedIdentity) : undefined;
-                const neptuneForComparison = this.stripAddressTimestamps(neptuneIdentity);
-                const shouldWrite = !cachedForComparison || !fastDeepEqual(cachedForComparison, neptuneForComparison);
-                if (shouldWrite) {
-                    const staleTraits = staleTracker ? this.extractStaleTraitNames(staleTracker) : [];
-                    const isNewIdentity = writeReason === CACHE_WRITE_REASON.CACHE_MISS || writeReason === CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY;
-                    const writeType = isNewIdentity ? 'new_identity' : 'stale_traits_update';
-                    Logger.info(`IdentityCache - identity cache write: ${writeType}`, {
-                        pixelId,
-                        identityId: neptuneIdentity.identityId,
-                        writeReason,
-                        staleTier,
-                        staleTraits,
-                        cachedIdentity: cachedIdentity ?? null,
-                        incomingIdentity,
-                        neptuneIdentity,
-                        incomingClick: incomingIdentity?.traits?.click ?? null,
-                        cachedClick: cachedIdentity?.traits?.click ?? null,
-                        neptuneClick: neptuneIdentity?.traits?.click ?? null,
-                        traitChanges: cachedIdentity
-                            ? this.computeTraitChanges(cachedIdentity, neptuneIdentity)
-                            : { reason: 'no cached identity' },
-                    });
-                    await this.safeWriteBackToCache(pixelId, resolvedIdentity, 'neptune write-back');
-                }
-                else {
-                    Logger.info('IdentityCache - identity cache skip write - Neptune matches cached', {
-                        pixelId,
-                        identityId: neptuneIdentity.identityId,
-                        staleTier,
-                        cachedIdentity: cachedIdentity ?? null,
-                        incomingIdentity,
-                        neptuneIdentity,
-                        incomingClick: incomingIdentity?.traits?.click ?? null,
-                        cachedClick: cachedIdentity?.traits?.click ?? null,
-                        neptuneClick: neptuneIdentity?.traits?.click ?? null,
-                    });
-                }
-            }
-            else {
-                Logger.error('IdentityCache - Neptune resolution failed', {
-                    pixelId,
-                    staleTier,
-                    writeReason,
-                    cachedIdentity: cachedIdentity ?? null,
-                    incomingIdentity,
-                    identityForNeptune,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                });
-            }
-            if (!resolvedIdentity) {
-                Logger.error('IdentityCache - no identity found, using incoming', {
-                    pixelId,
-                    incomingIdentity,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                });
-                resolvedIdentity = incomingIdentity;
-            }
-            return resolvedIdentity;
-        }
-        catch (error) {
-            Logger.error('IdentityCache - getIdentityWithCaching failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                incomingIdentity,
-                incomingClick: incomingIdentity?.traits?.click ?? null,
-            });
-            return undefined;
-        }
-    };
+import { DynamoDbClient } from '../../../clients/index.js';
+import { Logger } from '../../../helpers/index.js';
+import { isIdentityCacheStale, IDENTITY_CACHE_STALENESS_TIER, } from '../../../helpers/identity-cache-helper.js';
+import { FORCE_PURGE_TTL_SECONDS, IDENTITY_CACHE_GSI1_NAME, IDENTITY_CACHE_TABLE_NAME } from './constants.js';
+import { buildEmailPk, buildForcePurgePk, buildIdentityMapPk, buildIdentityPk, } from './key-builders.js';
+import { CACHE_WRITE_REASON } from './types.js';
+import { createCacheMissLookupResult, createIdentityCacheLookupResultFromState, createIdentityCacheLookupState, extractStaleTraitNames, stripAddressTimestamps, } from './helpers.js';
+import { IDENTITY_CACHE_LOOKUP_OUTCOME, } from './types.js';
+export class IdentityCacheDynamoDbDbService {
     static getIdentityFromCache = async (pixelId, incomingIdentity) => {
         try {
             if (!pixelId || !incomingIdentity) {
@@ -177,6 +28,15 @@ export class IdentityCacheDynamoDbService {
                     });
                     return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
                 }
+                if (!cachedIdentityResponse?.response) {
+                    Logger.debug('IdentityCache - found cached identity but no response', {
+                        pixelId,
+                        identityId: incomingIdentity.identityId,
+                        incomingIdentity,
+                        cachedIdentityResponse,
+                    });
+                    return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
+                }
                 Logger.debug('IdentityCache - found cached identity', {
                     pixelId,
                     identityId: incomingIdentity.identityId,
@@ -186,8 +46,8 @@ export class IdentityCacheDynamoDbService {
                 const mergedTraits = mergeIdentityTraits(incomingIdentity.traits, cachedIdentityResponse.response.traits);
                 const mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
                 const identityStaleCacheTracker = isIdentityCacheStale(cachedIdentityResponse.response, mergedIdentity);
-                const cachedForComparison = this.stripAddressTimestamps(cachedIdentityResponse.response);
-                const mergedForComparison = this.stripAddressTimestamps(mergedIdentity);
+                const cachedForComparison = stripAddressTimestamps(cachedIdentityResponse.response);
+                const mergedForComparison = stripAddressTimestamps(mergedIdentity);
                 const isDeepEqual = fastDeepEqual(cachedForComparison, mergedForComparison);
                 const staleTier = identityStaleCacheTracker.staleTier;
                 let isCacheStale = identityStaleCacheTracker.isCacheStale;
@@ -281,13 +141,180 @@ export class IdentityCacheDynamoDbService {
             return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
         }
     };
+    static getIdentityFromCacheV2 = async (pixelId, incomingIdentity) => {
+        const state = createIdentityCacheLookupState(pixelId, incomingIdentity);
+        try {
+            if (!pixelId || !incomingIdentity) {
+                state.isCacheStale = true;
+                state.writeReason = CACHE_WRITE_REASON.CACHE_MISS;
+                return createCacheMissLookupResult(state, IDENTITY_CACHE_LOOKUP_OUTCOME.INVALID_INPUT);
+            }
+            if (incomingIdentity.identityId) {
+                return await this.resolveCacheByIdentityIdV2(state);
+            }
+            return await this.resolveCacheByEmailPointerV2(state);
+        }
+        catch (error) {
+            Logger.error('IdentityCache - getIdentityFromCache failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                incomingIdentity,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+            });
+            state.isCacheStale = true;
+            state.writeReason = CACHE_WRITE_REASON.CACHE_MISS;
+            return createCacheMissLookupResult(state, IDENTITY_CACHE_LOOKUP_OUTCOME.FAILED, {
+                errorMessage: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+    static resolveCacheByIdentityIdV2 = async (state) => {
+        const incomingIdentity = state.incomingIdentity;
+        const identityId = incomingIdentity.identityId;
+        state.didLookupByIdentityId = true;
+        const pk = buildIdentityPk(state.pixelId, identityId);
+        Logger.debug('IdentityCache - lookup by identityId', { pixelId: state.pixelId, pk, incomingIdentity });
+        const cachedIdentityResponse = await this.getItemByPk(pk);
+        if (!cachedIdentityResponse) {
+            Logger.debug('IdentityCache - identity cache miss - no cached identity found', {
+                pixelId: state.pixelId,
+                identityId,
+                incomingIdentity,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+            });
+            state.isCacheStale = true;
+            state.writeReason = CACHE_WRITE_REASON.CACHE_MISS;
+            return createCacheMissLookupResult(state, IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_MISS);
+        }
+        state.cachedIdentityResponse = cachedIdentityResponse;
+        if (!cachedIdentityResponse?.response) {
+            Logger.debug('IdentityCache - found cached identity but no response', {
+                pixelId: state.pixelId,
+                identityId,
+                incomingIdentity,
+                cachedIdentityResponse,
+            });
+            state.isCacheStale = true;
+            state.writeReason = CACHE_WRITE_REASON.CACHE_MISS;
+            return createCacheMissLookupResult(state, IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_MISS_NO_RESPONSE);
+        }
+        this.applyPrimaryCacheHitState(state, cachedIdentityResponse);
+        return this.createPrimaryCacheLookupResult(state);
+    };
+    static applyPrimaryCacheHitState(state, cachedIdentityResponse) {
+        const incomingIdentity = state.incomingIdentity;
+        const identityId = incomingIdentity.identityId;
+        Logger.debug('IdentityCache - found cached identity', {
+            pixelId: state.pixelId,
+            identityId,
+            cachedIdentity: cachedIdentityResponse.response,
+            cachedClick: cachedIdentityResponse.response?.traits?.click ?? null,
+        });
+        state.cachedIdentity = cachedIdentityResponse.response;
+        const mergedTraits = mergeIdentityTraits(incomingIdentity.traits, cachedIdentityResponse.response.traits);
+        state.mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
+        state.resolvedIdentity = state.mergedIdentity;
+        state.identityStaleCacheTracker = isIdentityCacheStale(cachedIdentityResponse.response, state.mergedIdentity);
+        const cachedForComparison = stripAddressTimestamps(cachedIdentityResponse.response);
+        const mergedForComparison = stripAddressTimestamps(state.mergedIdentity);
+        state.isDeepEqual = fastDeepEqual(cachedForComparison, mergedForComparison);
+        state.staleTier = state.identityStaleCacheTracker.staleTier;
+        state.isCacheStale = state.identityStaleCacheTracker.isCacheStale;
+        if (state.isDeepEqual) {
+            Logger.debug('IdentityCache - deep equal (after stripping timestamps)', {
+                pixelId: state.pixelId,
+                identityId,
+                staleTier: state.staleTier,
+            });
+            state.isCacheStale = false;
+        }
+        else {
+            Logger.debug('IdentityCache - not deep equal', {
+                pixelId: state.pixelId,
+                identityId,
+                staleTier: state.staleTier,
+                identityStaleCacheTracker: state.identityStaleCacheTracker,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+                cachedClick: cachedIdentityResponse.response?.traits?.click ?? null,
+                mergedClick: state.mergedIdentity?.traits?.click ?? null,
+            });
+        }
+        const isVolatileOnly = state.staleTier === IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
+        const isAddressUpdateOnly = state.staleTier === IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
+        const skipNeptune = isVolatileOnly || isAddressUpdateOnly;
+        if (isVolatileOnly && !state.isDeepEqual) {
+            Logger.debug('IdentityCache - volatile only - treating as cache hit', {
+                pixelId: state.pixelId,
+                identityId,
+                staleTier: state.staleTier,
+            });
+            state.isCacheStale = false;
+        }
+        if (state.isCacheStale) {
+            state.writeReason = isAddressUpdateOnly ? CACHE_WRITE_REASON.ADDRESS_UPDATE : CACHE_WRITE_REASON.STALE_TRAITS;
+            state.skipNeptune = skipNeptune;
+            state.staleTraits = extractStaleTraitNames(state.identityStaleCacheTracker);
+            Logger.debug('IdentityCache - stale detected', {
+                pixelId: state.pixelId,
+                identityId,
+                isCacheStale: state.isCacheStale,
+                isDeepEqual: state.isDeepEqual,
+                staleTier: state.staleTier,
+                skipNeptune: state.skipNeptune,
+                writeReason: state.writeReason,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+                cachedClick: cachedIdentityResponse.response?.traits?.click ?? null,
+                mergedClick: state.mergedIdentity?.traits?.click ?? null,
+            });
+        }
+    }
+    static createPrimaryCacheLookupResult(state) {
+        const cacheResult = {
+            resolvedIdentity: state.mergedIdentity,
+            isCacheStale: state.isCacheStale,
+            cachedIdentity: state.cachedIdentity,
+            staleTracker: state.isCacheStale ? state.identityStaleCacheTracker : undefined,
+            writeReason: state.writeReason,
+            staleTier: state.staleTier,
+            skipNeptune: state.isCacheStale ? state.skipNeptune : undefined,
+        };
+        return createIdentityCacheLookupResultFromState(state, cacheResult, {
+            outcome: state.isCacheStale ? IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_STALE : IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_HIT,
+            skipNeptune: state.isCacheStale ? state.skipNeptune : undefined,
+        });
+    }
+    static resolveCacheByEmailPointerV2 = async (state) => {
+        const incomingIdentity = state.incomingIdentity;
+        state.didLookupByEmail = !!incomingIdentity.traits?.emails?.[0];
+        state.discoveredIdentityId = await this.getIdentityIdFromEmailLookup(state.pixelId, incomingIdentity);
+        if (state.discoveredIdentityId) {
+            Logger.debug('IdentityCache - identityId from email pointer', {
+                pixelId: state.pixelId,
+                discoveredIdentityId: state.discoveredIdentityId,
+                incomingIdentity,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+            });
+            const identityWithDiscoveredId = {
+                ...incomingIdentity,
+                identityId: state.discoveredIdentityId,
+            };
+            state.resolvedIdentity = identityWithDiscoveredId;
+            state.isCacheStale = true;
+            state.writeReason = CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY;
+            return createIdentityCacheLookupResultFromState(state, { resolvedIdentity: identityWithDiscoveredId, isCacheStale: true, writeReason: CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY }, { outcome: IDENTITY_CACHE_LOOKUP_OUTCOME.EMAIL_POINTER_DISCOVERY });
+        }
+        state.isCacheStale = true;
+        state.writeReason = CACHE_WRITE_REASON.CACHE_MISS;
+        return createCacheMissLookupResult(state, IDENTITY_CACHE_LOOKUP_OUTCOME.EMAIL_POINTER_MISS);
+    };
     static getIdentityMap = async (pixelId, identityId) => {
         try {
             if (!pixelId || !identityId) {
                 return undefined;
             }
             const pk = buildIdentityMapPk(pixelId, identityId);
-            const result = (await DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const result = (await DynamoDbClient.safeGet(IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             return result ?? undefined;
         }
         catch (error) {
@@ -306,7 +333,7 @@ export class IdentityCacheDynamoDbService {
                 return false;
             }
             const pk = buildForcePurgePk(pixelId, identityId);
-            const result = await DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk);
+            const result = await DynamoDbClient.safeGet(IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             return result !== null;
         }
         catch (error) {
@@ -347,7 +374,7 @@ export class IdentityCacheDynamoDbService {
                     items.push(pointerRecord);
                 }
             }
-            await DynamoDbClient.safeBatchWrite(TABLE_NAME, items);
+            await DynamoDbClient.safeBatchWrite(IDENTITY_CACHE_TABLE_NAME, items);
             Logger.debug('IdentityCache - cache written', { pixelId, identityId: response.identityId, itemCount: items.length });
         }
         catch (error) {
@@ -370,7 +397,7 @@ export class IdentityCacheDynamoDbService {
                 linkedIdentities,
                 updatedAt: new Date().toISOString(),
             };
-            await DynamoDbClient.safePut(TABLE_NAME, item);
+            await DynamoDbClient.safePut(IDENTITY_CACHE_TABLE_NAME, item);
             Logger.debug('IdentityCache - identity map written', { pixelId, identityId, linkedIdentities });
         }
         catch (error) {
@@ -396,7 +423,7 @@ export class IdentityCacheDynamoDbService {
                 createdAt: now,
                 ttl: Math.floor(ttl),
             };
-            await DynamoDbClient.safePut(TABLE_NAME, item);
+            await DynamoDbClient.safePut(IDENTITY_CACHE_TABLE_NAME, item);
             Logger.debug('IdentityCache - force purge flag set', { pixelId, identityId, ttlSeconds });
         }
         catch (error) {
@@ -459,7 +486,7 @@ export class IdentityCacheDynamoDbService {
                 return;
             }
             const pk = buildIdentityMapPk(pixelId, identityId);
-            await DynamoDbClient.safeDelete(TABLE_NAME, 'pk', pk);
+            await DynamoDbClient.safeDelete(IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             Logger.debug('IdentityCache - identity map deleted', { pixelId, identityId });
         }
         catch (error) {
@@ -477,7 +504,7 @@ export class IdentityCacheDynamoDbService {
                 return;
             }
             const pk = buildForcePurgePk(pixelId, identityId);
-            await DynamoDbClient.safeDelete(TABLE_NAME, 'pk', pk);
+            await DynamoDbClient.safeDelete(IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             Logger.debug('IdentityCache - force purge flag deleted', { pixelId, identityId });
         }
         catch (error) {
@@ -489,50 +516,6 @@ export class IdentityCacheDynamoDbService {
             });
         }
     };
-    static readFromCache = async (pixelId, incomingIdentity) => {
-        return await this.getIdentityFromCache(pixelId, incomingIdentity);
-    };
-    static resolveFromNeptune = async (pixelId, incomingIdentity, identifyPrivateLambdaArn) => {
-        try {
-            const client = this.getLambdaInvokeClient();
-            const response = await client.invokeFunction(identifyPrivateLambdaArn, {
-                pixelId,
-                context: { identity: incomingIdentity },
-            });
-            if (response?.statusCode === 200 && response?.body) {
-                const identifyResponse = JSON.parse(response.body);
-                return identifyResponse?.identity;
-            }
-            return incomingIdentity;
-        }
-        catch (error) {
-            Logger.error('IdentityCache - Neptune resolution failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                incomingIdentity,
-                incomingClick: incomingIdentity?.traits?.click ?? null,
-            });
-            return undefined;
-        }
-    };
-    static writeBackToCache = async (pixelId, resolvedIdentity) => {
-        await this.updateIdentityCache(pixelId, resolvedIdentity);
-    };
-    static safeWriteBackToCache = async (pixelId, resolvedIdentity, context) => {
-        try {
-            await this.writeBackToCache(pixelId, resolvedIdentity);
-        }
-        catch (writeError) {
-            Logger.error(`IdentityCache - write back failed (${context})`, {
-                error: writeError,
-                errorMessage: writeError instanceof Error ? writeError.message : String(writeError),
-                pixelId,
-                identityId: resolvedIdentity?.identityId,
-                resolvedClick: resolvedIdentity?.traits?.click ?? null,
-            });
-        }
-    };
     static getIdentityIdFromEmailLookup = async (pixelId, incomingIdentity) => {
         try {
             if (!pixelId || !incomingIdentity) {
@@ -544,7 +527,7 @@ export class IdentityCacheDynamoDbService {
             }
             const pk = buildEmailPk(pixelId, firstEmail);
             Logger.debug('IdentityCache - email secondary lookup', { pixelId, pk, email: firstEmail });
-            const result = (await DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const result = (await DynamoDbClient.safeGet(IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             if (!result) {
                 return undefined;
             }
@@ -563,7 +546,7 @@ export class IdentityCacheDynamoDbService {
     };
     static getItemByPk = async (pk) => {
         try {
-            const result = (await DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const result = (await DynamoDbClient.safeGet(IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             return result ?? undefined;
         }
         catch (error) {
@@ -577,7 +560,7 @@ export class IdentityCacheDynamoDbService {
     };
     static queryByGsi1 = async (identityId) => {
         try {
-            const results = await DynamoDbClient.safeQueryByGSI(TABLE_NAME, GSI1_NAME, 'gsi1pk', identityId);
+            const results = await DynamoDbClient.safeQueryByGSI(IDENTITY_CACHE_TABLE_NAME, IDENTITY_CACHE_GSI1_NAME, 'gsi1pk', identityId);
             return (results ?? []);
         }
         catch (error) {
@@ -600,7 +583,7 @@ export class IdentityCacheDynamoDbService {
                     DeleteRequest: { Key: { pk: key.pk } },
                 }));
                 await DynamoDbClient.batchWrite({
-                    RequestItems: { [TABLE_NAME]: deleteRequests },
+                    RequestItems: { [IDENTITY_CACHE_TABLE_NAME]: deleteRequests },
                 });
             }
             catch (error) {
@@ -619,110 +602,5 @@ export class IdentityCacheDynamoDbService {
         }
         return chunks;
     }
-    static stripAddressTimestamps(identity) {
-        if (!identity?.traits?.addresses?.length) {
-            return identity;
-        }
-        const strippedAddresses = identity.traits.addresses.map((addr) => {
-            if (!addr)
-                return addr;
-            const { cra, upa, ...rest } = addr;
-            return rest;
-        });
-        return {
-            ...identity,
-            traits: {
-                ...identity.traits,
-                addresses: strippedAddresses,
-            },
-        };
-    }
-    static extractStaleTraitNames(tracker) {
-        const staleTraits = [];
-        if (tracker.isIdentityIdStale)
-            staleTraits.push('identityId');
-        if (tracker.isUserIdsStale)
-            staleTraits.push('userIds');
-        if (tracker.isIdsStale)
-            staleTraits.push('ids');
-        if (tracker.isEmailsStale)
-            staleTraits.push('emails');
-        if (tracker.isPhonesStale)
-            staleTraits.push('phones');
-        if (tracker.isShopifyYIdsStale)
-            staleTraits.push('shopifyYIds');
-        if (tracker.isGendersStale)
-            staleTraits.push('genders');
-        if (tracker.isDobsStale)
-            staleTraits.push('dobs');
-        if (tracker.isAddressesStale)
-            staleTraits.push('addresses');
-        if (tracker.isClickInfosStale)
-            staleTraits.push('clickInfos');
-        if (tracker.isIpAddressStale)
-            staleTraits.push('ipAddress');
-        if (tracker.isUserAgentStale)
-            staleTraits.push('userAgent');
-        if (tracker.isThirdPartyContactsStale)
-            staleTraits.push('thirdPartyContacts');
-        return staleTraits;
-    }
-    static computeTraitChanges(cachedIdentity, resolvedIdentity) {
-        const changes = {};
-        const cachedTraits = cachedIdentity.traits ?? {};
-        const resolvedTraits = resolvedIdentity.traits ?? {};
-        const arrayTraits = [
-            'emails',
-            'phones',
-            'userIds',
-            'shopifyYIds',
-            'shopifyCustomerIds',
-            'klaviyoIds',
-            'genders',
-            'dobs',
-            'ids',
-        ];
-        for (const trait of arrayTraits) {
-            const cachedValue = cachedTraits[trait];
-            const resolvedValue = resolvedTraits[trait];
-            if (!fastDeepEqual(cachedValue, resolvedValue)) {
-                changes[trait] = {
-                    cached: cachedValue ?? [],
-                    resolved: resolvedValue ?? [],
-                };
-            }
-        }
-        if (!fastDeepEqual(cachedTraits.addresses, resolvedTraits.addresses)) {
-            changes.addresses = {
-                cached: cachedTraits.addresses ?? [],
-                resolved: resolvedTraits.addresses ?? [],
-            };
-        }
-        if (!fastDeepEqual(cachedTraits.click, resolvedTraits.click)) {
-            changes.click = {
-                cached: cachedTraits.click ?? {},
-                resolved: resolvedTraits.click ?? {},
-            };
-        }
-        if (cachedTraits.ipAddress !== resolvedTraits.ipAddress) {
-            changes.ipAddress = {
-                cached: cachedTraits.ipAddress,
-                resolved: resolvedTraits.ipAddress,
-            };
-        }
-        if (cachedTraits.userAgent !== resolvedTraits.userAgent) {
-            changes.userAgent = {
-                cached: cachedTraits.userAgent,
-                resolved: resolvedTraits.userAgent,
-            };
-        }
-        if (cachedIdentity.identityId !== resolvedIdentity.identityId) {
-            changes.identityId = {
-                cached: cachedIdentity.identityId,
-                resolved: resolvedIdentity.identityId,
-            };
-        }
-        return changes;
-    }
 }
-//# sourceMappingURL=identity-cache-dynamodb-service.js.map
+//# sourceMappingURL=identity-cache-dynamodb-db-service.js.map