@adtrackify/at-service-common 4.0.5 → 4.0.7

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

@@ -3,175 +3,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdentityCacheDynamoDbService = exports.CACHE_WRITE_REASON = void 0;
-const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
+exports.IdentityCacheDynamoDbDbService = void 0;
 const at_shared_utils_1 = require("@adtrackify/at-shared-utils");
 const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
 const luxon_1 = require("luxon");
-const index_js_1 = require("../../clients/index.js");
-const index_js_2 = require("../../helpers/index.js");
-const identity_cache_helper_js_1 = require("../../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;
-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 = exports.CACHE_WRITE_REASON || (exports.CACHE_WRITE_REASON = {}));
-class IdentityCacheDynamoDbService {
-    static lambdaInvokeClient;
-    static getLambdaInvokeClient() {
-        if (!this.lambdaInvokeClient) {
-            this.lambdaInvokeClient = new index_js_1.LambdaInvokeClient();
-        }
-        return this.lambdaInvokeClient;
-    }
-    static getIdentityWithCaching = async (pixelId, incomingIdentity, identifyPrivateLambdaArn) => {
-        try {
-            if (!pixelId || !incomingIdentity) {
-                index_js_2.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_helper_js_1.IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY ? 'volatile_traits_only' : 'fresh';
-                index_js_2.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) : [];
-                index_js_2.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;
-            index_js_2.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 || !(0, fast_deep_equal_1.default)(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';
-                    index_js_2.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 {
-                    index_js_2.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 {
-                index_js_2.Logger.error('IdentityCache - Neptune resolution failed', {
-                    pixelId,
-                    staleTier,
-                    writeReason,
-                    cachedIdentity: cachedIdentity ?? null,
-                    incomingIdentity,
-                    identityForNeptune,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                });
-            }
-            if (!resolvedIdentity) {
-                index_js_2.Logger.error('IdentityCache - no identity found, using incoming', {
-                    pixelId,
-                    incomingIdentity,
-                    incomingClick: incomingIdentity?.traits?.click ?? null,
-                });
-                resolvedIdentity = incomingIdentity;
-            }
-            return resolvedIdentity;
-        }
-        catch (error) {
-            index_js_2.Logger.error('IdentityCache - getIdentityWithCaching failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                incomingIdentity,
-                incomingClick: incomingIdentity?.traits?.click ?? null,
-            });
-            return undefined;
-        }
-    };
+const index_js_1 = require("../../../clients/index.js");
+const index_js_2 = require("../../../helpers/index.js");
+const identity_cache_helper_js_1 = require("../../../helpers/identity-cache-helper.js");
+const constants_js_1 = require("./constants.js");
+const key_builders_js_1 = require("./key-builders.js");
+const types_js_1 = require("./types.js");
+const helpers_js_1 = require("./helpers.js");
+const types_js_2 = require("./types.js");
+class IdentityCacheDynamoDbDbService {
     static getIdentityFromCache = async (pixelId, incomingIdentity) => {
         try {
             if (!pixelId || !incomingIdentity) {
-                return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
+                return { resolvedIdentity: undefined, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.CACHE_MISS };
             }
             if (incomingIdentity.identityId) {
-                const pk = (0, at_tracking_event_types_1.buildIdentityPk)(pixelId, incomingIdentity.identityId);
+                const pk = (0, key_builders_js_1.buildIdentityPk)(pixelId, incomingIdentity.identityId);
                 index_js_2.Logger.debug('IdentityCache - lookup by identityId', { pixelId, pk, incomingIdentity });
                 const cachedIdentityResponse = await this.getItemByPk(pk);
                 if (!cachedIdentityResponse) {
@@ -181,7 +32,16 @@ class IdentityCacheDynamoDbService {
                         incomingIdentity,
                         incomingClick: incomingIdentity?.traits?.click ?? null,
                     });
-                    return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
+                    return { resolvedIdentity: undefined, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.CACHE_MISS };
+                }
+                if (!cachedIdentityResponse?.response) {
+                    index_js_2.Logger.debug('IdentityCache - found cached identity but no response', {
+                        pixelId,
+                        identityId: incomingIdentity.identityId,
+                        incomingIdentity,
+                        cachedIdentityResponse,
+                    });
+                    return { resolvedIdentity: undefined, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.CACHE_MISS };
                 }
                 index_js_2.Logger.debug('IdentityCache - found cached identity', {
                     pixelId,
@@ -192,8 +52,8 @@ class IdentityCacheDynamoDbService {
                 const mergedTraits = (0, at_shared_utils_1.mergeIdentityTraits)(incomingIdentity.traits, cachedIdentityResponse.response.traits);
                 const mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
                 const identityStaleCacheTracker = (0, identity_cache_helper_js_1.isIdentityCacheStale)(cachedIdentityResponse.response, mergedIdentity);
-                const cachedForComparison = this.stripAddressTimestamps(cachedIdentityResponse.response);
-                const mergedForComparison = this.stripAddressTimestamps(mergedIdentity);
+                const cachedForComparison = (0, helpers_js_1.stripAddressTimestamps)(cachedIdentityResponse.response);
+                const mergedForComparison = (0, helpers_js_1.stripAddressTimestamps)(mergedIdentity);
                 const isDeepEqual = (0, fast_deep_equal_1.default)(cachedForComparison, mergedForComparison);
                 const staleTier = identityStaleCacheTracker.staleTier;
                 let isCacheStale = identityStaleCacheTracker.isCacheStale;
@@ -230,10 +90,10 @@ class IdentityCacheDynamoDbService {
                 let writeReason;
                 if (isCacheStale) {
                     if (isAddressUpdateOnly) {
-                        writeReason = CACHE_WRITE_REASON.ADDRESS_UPDATE;
+                        writeReason = types_js_1.CACHE_WRITE_REASON.ADDRESS_UPDATE;
                     }
                     else {
-                        writeReason = CACHE_WRITE_REASON.STALE_TRAITS;
+                        writeReason = types_js_1.CACHE_WRITE_REASON.STALE_TRAITS;
                     }
                 }
                 if (isCacheStale) {
@@ -272,9 +132,33 @@ class IdentityCacheDynamoDbService {
                     ...incomingIdentity,
                     identityId: discoveredIdentityId,
                 };
-                return { resolvedIdentity: identityWithDiscoveredId, isCacheStale: true, writeReason: CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY };
+                return { resolvedIdentity: identityWithDiscoveredId, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY };
+            }
+            return { resolvedIdentity: undefined, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.CACHE_MISS };
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - getIdentityFromCache failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                incomingIdentity,
+                incomingClick: incomingIdentity?.traits?.click ?? null,
+            });
+            return { resolvedIdentity: undefined, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.CACHE_MISS };
+        }
+    };
+    static getIdentityFromCacheV2 = async (pixelId, incomingIdentity) => {
+        const state = (0, helpers_js_1.createIdentityCacheLookupState)(pixelId, incomingIdentity);
+        try {
+            if (!pixelId || !incomingIdentity) {
+                state.isCacheStale = true;
+                state.writeReason = types_js_1.CACHE_WRITE_REASON.CACHE_MISS;
+                return (0, helpers_js_1.createCacheMissLookupResult)(state, types_js_2.IDENTITY_CACHE_LOOKUP_OUTCOME.INVALID_INPUT);
+            }
+            if (incomingIdentity.identityId) {
+                return await this.resolveCacheByIdentityIdV2(state);
             }
-            return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
+            return await this.resolveCacheByEmailPointerV2(state);
         }
         catch (error) {
             index_js_2.Logger.error('IdentityCache - getIdentityFromCache failed', {
@@ -284,16 +168,159 @@ class IdentityCacheDynamoDbService {
                 incomingIdentity,
                 incomingClick: incomingIdentity?.traits?.click ?? null,
             });
-            return { resolvedIdentity: undefined, isCacheStale: true, writeReason: CACHE_WRITE_REASON.CACHE_MISS };
+            state.isCacheStale = true;
+            state.writeReason = types_js_1.CACHE_WRITE_REASON.CACHE_MISS;
+            return (0, helpers_js_1.createCacheMissLookupResult)(state, types_js_2.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 = (0, key_builders_js_1.buildIdentityPk)(state.pixelId, identityId);
+        index_js_2.Logger.debug('IdentityCache - lookup by identityId', { pixelId: state.pixelId, pk, incomingIdentity });
+        const cachedIdentityResponse = await this.getItemByPk(pk);
+        if (!cachedIdentityResponse) {
+            index_js_2.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 = types_js_1.CACHE_WRITE_REASON.CACHE_MISS;
+            return (0, helpers_js_1.createCacheMissLookupResult)(state, types_js_2.IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_MISS);
+        }
+        state.cachedIdentityResponse = cachedIdentityResponse;
+        if (!cachedIdentityResponse?.response) {
+            index_js_2.Logger.debug('IdentityCache - found cached identity but no response', {
+                pixelId: state.pixelId,
+                identityId,
+                incomingIdentity,
+                cachedIdentityResponse,
+            });
+            state.isCacheStale = true;
+            state.writeReason = types_js_1.CACHE_WRITE_REASON.CACHE_MISS;
+            return (0, helpers_js_1.createCacheMissLookupResult)(state, types_js_2.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;
+        index_js_2.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 = (0, at_shared_utils_1.mergeIdentityTraits)(incomingIdentity.traits, cachedIdentityResponse.response.traits);
+        state.mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
+        state.resolvedIdentity = state.mergedIdentity;
+        state.identityStaleCacheTracker = (0, identity_cache_helper_js_1.isIdentityCacheStale)(cachedIdentityResponse.response, state.mergedIdentity);
+        const cachedForComparison = (0, helpers_js_1.stripAddressTimestamps)(cachedIdentityResponse.response);
+        const mergedForComparison = (0, helpers_js_1.stripAddressTimestamps)(state.mergedIdentity);
+        state.isDeepEqual = (0, fast_deep_equal_1.default)(cachedForComparison, mergedForComparison);
+        state.staleTier = state.identityStaleCacheTracker.staleTier;
+        state.isCacheStale = state.identityStaleCacheTracker.isCacheStale;
+        if (state.isDeepEqual) {
+            index_js_2.Logger.debug('IdentityCache - deep equal (after stripping timestamps)', {
+                pixelId: state.pixelId,
+                identityId,
+                staleTier: state.staleTier,
+            });
+            state.isCacheStale = false;
+        }
+        else {
+            index_js_2.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_helper_js_1.IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
+        const isAddressUpdateOnly = state.staleTier === identity_cache_helper_js_1.IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
+        const skipNeptune = isVolatileOnly || isAddressUpdateOnly;
+        if (isVolatileOnly && !state.isDeepEqual) {
+            index_js_2.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 ? types_js_1.CACHE_WRITE_REASON.ADDRESS_UPDATE : types_js_1.CACHE_WRITE_REASON.STALE_TRAITS;
+            state.skipNeptune = skipNeptune;
+            state.staleTraits = (0, helpers_js_1.extractStaleTraitNames)(state.identityStaleCacheTracker);
+            index_js_2.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 (0, helpers_js_1.createIdentityCacheLookupResultFromState)(state, cacheResult, {
+            outcome: state.isCacheStale ? types_js_2.IDENTITY_CACHE_LOOKUP_OUTCOME.PRIMARY_CACHE_STALE : types_js_2.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) {
+            index_js_2.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 = types_js_1.CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY;
+            return (0, helpers_js_1.createIdentityCacheLookupResultFromState)(state, { resolvedIdentity: identityWithDiscoveredId, isCacheStale: true, writeReason: types_js_1.CACHE_WRITE_REASON.EMAIL_POINTER_DISCOVERY }, { outcome: types_js_2.IDENTITY_CACHE_LOOKUP_OUTCOME.EMAIL_POINTER_DISCOVERY });
+        }
+        state.isCacheStale = true;
+        state.writeReason = types_js_1.CACHE_WRITE_REASON.CACHE_MISS;
+        return (0, helpers_js_1.createCacheMissLookupResult)(state, types_js_2.IDENTITY_CACHE_LOOKUP_OUTCOME.EMAIL_POINTER_MISS);
     };
     static getIdentityMap = async (pixelId, identityId) => {
         try {
             if (!pixelId || !identityId) {
                 return undefined;
             }
-            const pk = (0, at_tracking_event_types_1.buildIdentityMapPk)(pixelId, identityId);
-            const result = (await index_js_1.DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const pk = (0, key_builders_js_1.buildIdentityMapPk)(pixelId, identityId);
+            const result = (await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             return result ?? undefined;
         }
         catch (error) {
@@ -311,8 +338,8 @@ class IdentityCacheDynamoDbService {
             if (!pixelId || !identityId) {
                 return false;
             }
-            const pk = (0, at_tracking_event_types_1.buildForcePurgePk)(pixelId, identityId);
-            const result = await index_js_1.DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk);
+            const pk = (0, key_builders_js_1.buildForcePurgePk)(pixelId, identityId);
+            const result = await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             return result !== null;
         }
         catch (error) {
@@ -333,7 +360,7 @@ class IdentityCacheDynamoDbService {
             const items = [];
             const now = new Date().toISOString();
             items.push({
-                pk: (0, at_tracking_event_types_1.buildIdentityPk)(pixelId, response.identityId),
+                pk: (0, key_builders_js_1.buildIdentityPk)(pixelId, response.identityId),
                 response,
                 updatedAt: now,
                 pixelId,
@@ -344,7 +371,7 @@ class IdentityCacheDynamoDbService {
             for (const email of emails) {
                 if (email) {
                     const pointerRecord = {
-                        pk: (0, at_tracking_event_types_1.buildEmailPk)(pixelId, email),
+                        pk: (0, key_builders_js_1.buildEmailPk)(pixelId, email),
                         updatedAt: now,
                         pixelId,
                         identityId: response.identityId,
@@ -353,7 +380,7 @@ class IdentityCacheDynamoDbService {
                     items.push(pointerRecord);
                 }
             }
-            await index_js_1.DynamoDbClient.safeBatchWrite(TABLE_NAME, items);
+            await index_js_1.DynamoDbClient.safeBatchWrite(constants_js_1.IDENTITY_CACHE_TABLE_NAME, items);
             index_js_2.Logger.debug('IdentityCache - cache written', { pixelId, identityId: response.identityId, itemCount: items.length });
         }
         catch (error) {
@@ -370,13 +397,13 @@ class IdentityCacheDynamoDbService {
                 return;
             }
             const item = {
-                pk: (0, at_tracking_event_types_1.buildIdentityMapPk)(pixelId, identityId),
+                pk: (0, key_builders_js_1.buildIdentityMapPk)(pixelId, identityId),
                 pixelId,
                 identityId,
                 linkedIdentities,
                 updatedAt: new Date().toISOString(),
             };
-            await index_js_1.DynamoDbClient.safePut(TABLE_NAME, item);
+            await index_js_1.DynamoDbClient.safePut(constants_js_1.IDENTITY_CACHE_TABLE_NAME, item);
             index_js_2.Logger.debug('IdentityCache - identity map written', { pixelId, identityId, linkedIdentities });
         }
         catch (error) {
@@ -388,7 +415,7 @@ class IdentityCacheDynamoDbService {
             });
         }
     };
-    static setForcePurgeFlag = async (pixelId, identityId, ttlSeconds = FORCE_PURGE_TTL_SECONDS) => {
+    static setForcePurgeFlag = async (pixelId, identityId, ttlSeconds = constants_js_1.FORCE_PURGE_TTL_SECONDS) => {
         try {
             if (!pixelId || !identityId) {
                 return;
@@ -396,13 +423,13 @@ class IdentityCacheDynamoDbService {
             const now = new Date().toISOString();
             const ttl = luxon_1.DateTime.utc().plus({ seconds: ttlSeconds }).toSeconds();
             const item = {
-                pk: (0, at_tracking_event_types_1.buildForcePurgePk)(pixelId, identityId),
+                pk: (0, key_builders_js_1.buildForcePurgePk)(pixelId, identityId),
                 pixelId,
                 identityId,
                 createdAt: now,
                 ttl: Math.floor(ttl),
             };
-            await index_js_1.DynamoDbClient.safePut(TABLE_NAME, item);
+            await index_js_1.DynamoDbClient.safePut(constants_js_1.IDENTITY_CACHE_TABLE_NAME, item);
             index_js_2.Logger.debug('IdentityCache - force purge flag set', { pixelId, identityId, ttlSeconds });
         }
         catch (error) {
@@ -437,12 +464,12 @@ class IdentityCacheDynamoDbService {
             }
             if (incomingIdentity?.traits?.emails) {
                 for (const email of incomingIdentity.traits.emails) {
-                    deleteKeys.push({ pk: (0, at_tracking_event_types_1.buildEmailPk)(pixelId, email) });
+                    deleteKeys.push({ pk: (0, key_builders_js_1.buildEmailPk)(pixelId, email) });
                 }
             }
             if (resolvedIdentity?.traits?.emails) {
                 for (const email of resolvedIdentity.traits.emails) {
-                    deleteKeys.push({ pk: (0, at_tracking_event_types_1.buildEmailPk)(pixelId, email) });
+                    deleteKeys.push({ pk: (0, key_builders_js_1.buildEmailPk)(pixelId, email) });
                 }
             }
             const uniqueKeys = Array.from(new Set(deleteKeys.map((k) => k.pk))).map((pk) => ({ pk }));
@@ -464,8 +491,8 @@ class IdentityCacheDynamoDbService {
             if (!pixelId || !identityId) {
                 return;
             }
-            const pk = (0, at_tracking_event_types_1.buildIdentityMapPk)(pixelId, identityId);
-            await index_js_1.DynamoDbClient.safeDelete(TABLE_NAME, 'pk', pk);
+            const pk = (0, key_builders_js_1.buildIdentityMapPk)(pixelId, identityId);
+            await index_js_1.DynamoDbClient.safeDelete(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             index_js_2.Logger.debug('IdentityCache - identity map deleted', { pixelId, identityId });
         }
         catch (error) {
@@ -482,8 +509,8 @@ class IdentityCacheDynamoDbService {
             if (!pixelId || !identityId) {
                 return;
             }
-            const pk = (0, at_tracking_event_types_1.buildForcePurgePk)(pixelId, identityId);
-            await index_js_1.DynamoDbClient.safeDelete(TABLE_NAME, 'pk', pk);
+            const pk = (0, key_builders_js_1.buildForcePurgePk)(pixelId, identityId);
+            await index_js_1.DynamoDbClient.safeDelete(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk);
             index_js_2.Logger.debug('IdentityCache - force purge flag deleted', { pixelId, identityId });
         }
         catch (error) {
@@ -495,50 +522,6 @@ 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) {
-            index_js_2.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) {
-            index_js_2.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) {
@@ -548,9 +531,9 @@ class IdentityCacheDynamoDbService {
             if (!firstEmail) {
                 return undefined;
             }
-            const pk = (0, at_tracking_event_types_1.buildEmailPk)(pixelId, firstEmail);
+            const pk = (0, key_builders_js_1.buildEmailPk)(pixelId, firstEmail);
             index_js_2.Logger.debug('IdentityCache - email secondary lookup', { pixelId, pk, email: firstEmail });
-            const result = (await index_js_1.DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const result = (await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             if (!result) {
                 return undefined;
             }
@@ -569,7 +552,7 @@ class IdentityCacheDynamoDbService {
     };
     static getItemByPk = async (pk) => {
         try {
-            const result = (await index_js_1.DynamoDbClient.safeGet(TABLE_NAME, 'pk', pk));
+            const result = (await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
             return result ?? undefined;
         }
         catch (error) {
@@ -583,7 +566,7 @@ class IdentityCacheDynamoDbService {
     };
     static queryByGsi1 = async (identityId) => {
         try {
-            const results = await index_js_1.DynamoDbClient.safeQueryByGSI(TABLE_NAME, GSI1_NAME, 'gsi1pk', identityId);
+            const results = await index_js_1.DynamoDbClient.safeQueryByGSI(constants_js_1.IDENTITY_CACHE_TABLE_NAME, constants_js_1.IDENTITY_CACHE_GSI1_NAME, 'gsi1pk', identityId);
             return (results ?? []);
         }
         catch (error) {
@@ -606,7 +589,7 @@ class IdentityCacheDynamoDbService {
                     DeleteRequest: { Key: { pk: key.pk } },
                 }));
                 await index_js_1.DynamoDbClient.batchWrite({
-                    RequestItems: { [TABLE_NAME]: deleteRequests },
+                    RequestItems: { [constants_js_1.IDENTITY_CACHE_TABLE_NAME]: deleteRequests },
                 });
             }
             catch (error) {
@@ -625,111 +608,6 @@ 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 (!(0, fast_deep_equal_1.default)(cachedValue, resolvedValue)) {
-                changes[trait] = {
-                    cached: cachedValue ?? [],
-                    resolved: resolvedValue ?? [],
-                };
-            }
-        }
-        if (!(0, fast_deep_equal_1.default)(cachedTraits.addresses, resolvedTraits.addresses)) {
-            changes.addresses = {
-                cached: cachedTraits.addresses ?? [],
-                resolved: resolvedTraits.addresses ?? [],
-            };
-        }
-        if (!(0, fast_deep_equal_1.default)(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;
-    }
 }
-exports.IdentityCacheDynamoDbService = IdentityCacheDynamoDbService;
-//# sourceMappingURL=identity-cache-dynamodb-service.js.map
+exports.IdentityCacheDynamoDbDbService = IdentityCacheDynamoDbDbService;
+//# sourceMappingURL=identity-cache-dynamodb-db-service.js.map