@adtrackify/at-service-common 4.0.18 → 4.0.20

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

@@ -1,363 +1,452 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdentityCacheDynamoDbDbService = void 0;
-const luxon_1 = require("luxon");
-const index_js_1 = require("../../../clients/index.js");
-const index_js_2 = require("../../../helpers/index.js");
-const constants_js_1 = require("./constants.js");
-const key_builders_js_1 = require("./key-builders.js");
-const types_js_1 = require("./types.js");
-class IdentityCacheDynamoDbDbService {
-    static getIdentityFromCachePure = async (pixelId, incomingIdentity) => {
-        try {
-            if (!pixelId || !incomingIdentity) {
-                return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
-            }
-            if (incomingIdentity.identityId) {
-                return await this.resolveCacheByIdentityIdPure(pixelId, incomingIdentity.identityId);
-            }
-            return await this.resolveCacheByEmailPointerPure(pixelId, incomingIdentity);
-        }
-        catch (error) {
-            index_js_2.Logger.error('IdentityCache - getIdentityFromCachePure failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                incomingIdentity,
-            });
-            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
-        }
-    };
-    static resolveCacheByIdentityIdPure = async (pixelId, identityId) => {
-        const pk = (0, key_builders_js_1.buildIdentityPk)(pixelId, identityId);
-        index_js_2.Logger.debug('IdentityCache - pure lookup by identityId', { pixelId, pk, identityId });
-        const cachedIdentityResponse = await this.getItemByPk(pk);
-        if (!cachedIdentityResponse?.response) {
-            index_js_2.Logger.debug('IdentityCache - pure lookup miss', { pixelId, identityId });
-            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.IDENTITY_ID, cacheHit: false };
-        }
-        index_js_2.Logger.debug('IdentityCache - pure lookup hit', {
-            pixelId,
-            identityId,
-            cachedIdentity: cachedIdentityResponse.response,
-        });
-        return {
-            cachedIdentity: cachedIdentityResponse.response,
-            lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.IDENTITY_ID,
-            cacheHit: true,
-        };
-    };
-    static resolveCacheByEmailPointerPure = async (pixelId, incomingIdentity) => {
-        const discoveredIdentityId = await this.getIdentityIdFromEmailLookup(pixelId, incomingIdentity);
-        if (!discoveredIdentityId) {
-            index_js_2.Logger.debug('IdentityCache - pure email pointer miss', { pixelId, incomingIdentity });
-            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
-        }
-        index_js_2.Logger.debug('IdentityCache - pure email pointer discovery', {
-            pixelId,
-            discoveredIdentityId,
-            incomingIdentity,
-        });
-        return {
-            lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.EMAIL_POINTER,
-            discoveredIdentityId,
-            cacheHit: true,
-        };
-    };
-    static getIdentityMap = async (pixelId, identityId) => {
-        try {
-            if (!pixelId || !identityId) {
-                return undefined;
-            }
-            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) {
-            index_js_2.Logger.error('IdentityCache - getIdentityMap failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-            return undefined;
-        }
-    };
-    static getForcePurgeFlag = async (pixelId, identityId) => {
-        try {
-            if (!pixelId || !identityId) {
-                return false;
-            }
-            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) {
-            index_js_2.Logger.error('IdentityCache - getForcePurgeFlag failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-            return false;
-        }
-    };
-    static updateIdentityCache = async (pixelId, response) => {
-        try {
-            if (!response?.identityId || !pixelId) {
-                return;
-            }
-            const items = [];
-            const now = new Date().toISOString();
-            items.push({
-                pk: (0, key_builders_js_1.buildIdentityPk)(pixelId, response.identityId),
-                response,
-                updatedAt: now,
-                pixelId,
-                identityId: response.identityId,
-                gsi1pk: response.identityId,
-            });
-            const emails = response.traits?.emails ?? [];
-            for (const email of emails) {
-                if (email) {
-                    const pointerRecord = {
-                        pk: (0, key_builders_js_1.buildEmailPk)(pixelId, email),
-                        updatedAt: now,
-                        pixelId,
-                        identityId: response.identityId,
-                        gsi1pk: response.identityId,
-                    };
-                    items.push(pointerRecord);
-                }
-            }
-            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) {
-            index_js_2.Logger.error('IdentityCache - updateIdentityCache failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-            });
-        }
-    };
-    static putIdentityMap = async (pixelId, identityId, linkedIdentities) => {
-        try {
-            if (!pixelId || !identityId) {
-                return;
-            }
-            const item = {
-                pk: (0, key_builders_js_1.buildIdentityMapPk)(pixelId, identityId),
-                pixelId,
-                identityId,
-                linkedIdentities,
-                updatedAt: new Date().toISOString(),
-            };
-            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) {
-            index_js_2.Logger.error('IdentityCache - putIdentityMap failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-        }
-    };
-    static setForcePurgeFlag = async (pixelId, identityId, ttlSeconds = constants_js_1.FORCE_PURGE_TTL_SECONDS) => {
-        try {
-            if (!pixelId || !identityId) {
-                return;
-            }
-            const now = new Date().toISOString();
-            const ttl = luxon_1.DateTime.utc().plus({ seconds: ttlSeconds }).toSeconds();
-            const item = {
-                pk: (0, key_builders_js_1.buildForcePurgePk)(pixelId, identityId),
-                pixelId,
-                identityId,
-                createdAt: now,
-                ttl: Math.floor(ttl),
-            };
-            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) {
-            index_js_2.Logger.error('IdentityCache - setForcePurgeFlag failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-        }
-    };
-    static deleteIdentityCache = async (pixelId, incomingIdentity, resolvedIdentity) => {
-        try {
-            if (!pixelId) {
-                return;
-            }
-            const deleteKeys = [];
-            const identityIdsToDelete = new Set();
-            if (incomingIdentity?.identityId) {
-                identityIdsToDelete.add(incomingIdentity.identityId);
-            }
-            if (resolvedIdentity?.identityId) {
-                identityIdsToDelete.add(resolvedIdentity.identityId);
-            }
-            for (const identityId of identityIdsToDelete) {
-                const relatedItems = await this.queryByGsi1(identityId);
-                for (const item of relatedItems) {
-                    if (item.pk && item.pixelId === pixelId) {
-                        deleteKeys.push({ pk: item.pk });
-                    }
-                }
-            }
-            if (incomingIdentity?.traits?.emails) {
-                for (const email of incomingIdentity.traits.emails) {
-                    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, key_builders_js_1.buildEmailPk)(pixelId, email) });
-                }
-            }
-            const uniqueKeys = Array.from(new Set(deleteKeys.map((k) => k.pk))).map((pk) => ({ pk }));
-            if (uniqueKeys.length > 0) {
-                await this.safeBatchDelete(uniqueKeys);
-                index_js_2.Logger.debug('IdentityCache - cache items deleted', { pixelId, deletedCount: uniqueKeys.length });
-            }
-        }
-        catch (error) {
-            index_js_2.Logger.error('IdentityCache - deleteIdentityCache failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-            });
-        }
-    };
-    static deleteIdentityMap = async (pixelId, identityId) => {
-        try {
-            if (!pixelId || !identityId) {
-                return;
-            }
-            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) {
-            index_js_2.Logger.error('IdentityCache - deleteIdentityMap failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-        }
-    };
-    static deleteForcePurgeFlag = async (pixelId, identityId) => {
-        try {
-            if (!pixelId || !identityId) {
-                return;
-            }
-            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) {
-            index_js_2.Logger.error('IdentityCache - deleteForcePurgeFlag failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                identityId,
-            });
-        }
-    };
-    static getIdentityIdFromEmailLookup = async (pixelId, incomingIdentity) => {
-        try {
-            if (!pixelId || !incomingIdentity) {
-                return undefined;
-            }
-            const firstEmail = incomingIdentity.traits?.emails?.[0];
-            if (!firstEmail) {
-                return undefined;
-            }
-            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(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
-            if (!result) {
-                return undefined;
-            }
-            index_js_2.Logger.debug('IdentityCache - identityId from email lookup', { pixelId, identityId: result.identityId, email: firstEmail });
-            return result.identityId;
-        }
-        catch (error) {
-            index_js_2.Logger.error('IdentityCache - email lookup failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pixelId,
-                incomingIdentity,
-            });
-            return undefined;
-        }
-    };
-    static getItemByPk = async (pk) => {
-        try {
-            const result = (await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
-            return result ?? undefined;
-        }
-        catch (error) {
-            index_js_2.Logger.error('IdentityCache - getItemByPk failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                pk,
-            });
-            return undefined;
-        }
-    };
-    static queryByGsi1 = async (identityId) => {
-        try {
-            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) {
-            index_js_2.Logger.error('IdentityCache - queryByGsi1 failed', {
-                error,
-                errorMessage: error instanceof Error ? error.message : String(error),
-                identityId,
-            });
-            return [];
-        }
-    };
-    static safeBatchDelete = async (keys) => {
-        if (keys.length === 0) {
-            return;
-        }
-        const chunks = this.chunkArray(keys, 25);
-        for (const chunk of chunks) {
-            try {
-                const deleteRequests = chunk.map((key) => ({
-                    DeleteRequest: { Key: { pk: key.pk } },
-                }));
-                await index_js_1.DynamoDbClient.batchWrite({
-                    RequestItems: { [constants_js_1.IDENTITY_CACHE_TABLE_NAME]: deleteRequests },
-                });
-            }
-            catch (error) {
-                index_js_2.Logger.error('IdentityCache - batch delete failed', {
-                    error,
-                    errorMessage: error instanceof Error ? error.message : String(error),
-                    chunkSize: chunk.length,
-                });
-            }
-        }
-    };
-    static chunkArray(items, size) {
-        const chunks = [];
-        for (let i = 0; i < items.length; i += size) {
-            chunks.push(items.slice(i, i + size));
-        }
-        return chunks;
-    }
-}
-exports.IdentityCacheDynamoDbDbService = IdentityCacheDynamoDbDbService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityCacheDynamoDbDbService = void 0;
+const at_shared_utils_1 = require("@adtrackify/at-shared-utils");
+const luxon_1 = require("luxon");
+const index_js_1 = require("../../../clients/index.js");
+const index_js_2 = require("../../../helpers/index.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 MERGE_MAX_ATTEMPTS = 3;
+var TRAIT_MERGE_WRITE_STATUS;
+(function (TRAIT_MERGE_WRITE_STATUS) {
+    TRAIT_MERGE_WRITE_STATUS["WRITTEN"] = "written";
+    TRAIT_MERGE_WRITE_STATUS["CONFLICT"] = "conflict";
+    TRAIT_MERGE_WRITE_STATUS["ERROR"] = "error";
+})(TRAIT_MERGE_WRITE_STATUS || (TRAIT_MERGE_WRITE_STATUS = {}));
+class IdentityCacheDynamoDbDbService {
+    static getIdentityFromCachePure = async (pixelId, incomingIdentity) => {
+        try {
+            if (!pixelId || !incomingIdentity) {
+                return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
+            }
+            if (incomingIdentity.identityId) {
+                return await this.resolveCacheByIdentityIdPure(pixelId, incomingIdentity.identityId);
+            }
+            return await this.resolveCacheByEmailPointerPure(pixelId, incomingIdentity);
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - getIdentityFromCachePure failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                incomingIdentity,
+            });
+            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
+        }
+    };
+    static resolveCacheByIdentityIdPure = async (pixelId, identityId) => {
+        const pk = (0, key_builders_js_1.buildIdentityPk)(pixelId, identityId);
+        index_js_2.Logger.debug('IdentityCache - pure lookup by identityId', { pixelId, pk, identityId });
+        const cachedIdentityResponse = await this.getItemByPk(pk);
+        if (!cachedIdentityResponse?.response) {
+            index_js_2.Logger.debug('IdentityCache - pure lookup miss', { pixelId, identityId });
+            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.IDENTITY_ID, cacheHit: false };
+        }
+        index_js_2.Logger.debug('IdentityCache - pure lookup hit', {
+            pixelId,
+            identityId,
+            cachedIdentity: cachedIdentityResponse.response,
+        });
+        return {
+            cachedIdentity: cachedIdentityResponse.response,
+            lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.IDENTITY_ID,
+            cacheHit: true,
+        };
+    };
+    static resolveCacheByEmailPointerPure = async (pixelId, incomingIdentity) => {
+        const discoveredIdentityId = await this.getIdentityIdFromEmailLookup(pixelId, incomingIdentity);
+        if (!discoveredIdentityId) {
+            index_js_2.Logger.debug('IdentityCache - pure email pointer miss', { pixelId, incomingIdentity });
+            return { lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.MISS, cacheHit: false };
+        }
+        index_js_2.Logger.debug('IdentityCache - pure email pointer discovery', {
+            pixelId,
+            discoveredIdentityId,
+            incomingIdentity,
+        });
+        return {
+            lookupPath: types_js_1.PURE_CACHE_LOOKUP_PATH.EMAIL_POINTER,
+            discoveredIdentityId,
+            cacheHit: true,
+        };
+    };
+    static getIdentityMap = async (pixelId, identityId) => {
+        try {
+            if (!pixelId || !identityId) {
+                return undefined;
+            }
+            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) {
+            index_js_2.Logger.error('IdentityCache - getIdentityMap failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+            return undefined;
+        }
+    };
+    static getForcePurgeFlag = async (pixelId, identityId) => {
+        try {
+            if (!pixelId || !identityId) {
+                return false;
+            }
+            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) {
+            index_js_2.Logger.error('IdentityCache - getForcePurgeFlag failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+            return false;
+        }
+    };
+    static updateIdentityCache = async (pixelId, response) => {
+        try {
+            if (!response?.identityId || !pixelId) {
+                return;
+            }
+            const now = new Date().toISOString();
+            const { identityItem, pointerItems } = this.buildIdentityCacheItems(pixelId, response, now);
+            const items = [identityItem, ...pointerItems];
+            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) {
+            index_js_2.Logger.error('IdentityCache - updateIdentityCache failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+            });
+        }
+    };
+    static getTraitsByIdentityId = async (pixelId, identityId) => {
+        try {
+            if (!pixelId || !identityId) {
+                return undefined;
+            }
+            const record = await this.getItemByPk((0, key_builders_js_1.buildIdentityPk)(pixelId, identityId));
+            return record?.response?.traits;
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - getTraitsByIdentityId failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+            return undefined;
+        }
+    };
+    static mergeTraitsIntoIdentityCache = async (pixelId, identityId, incomingTraits) => {
+        try {
+            if (!pixelId || !identityId) {
+                return undefined;
+            }
+            for (let attempt = 1; attempt <= MERGE_MAX_ATTEMPTS; attempt++) {
+                const result = await this.attemptTraitMergeWrite(pixelId, identityId, incomingTraits);
+                if (result.status === TRAIT_MERGE_WRITE_STATUS.WRITTEN) {
+                    index_js_2.Logger.debug('IdentityCache - traits merged into cache', { pixelId, identityId, attempt });
+                    return result.identity;
+                }
+                if (result.status === TRAIT_MERGE_WRITE_STATUS.ERROR) {
+                    return undefined;
+                }
+                index_js_2.Logger.debug('IdentityCache - merge write conflict, retrying', { pixelId, identityId, attempt });
+            }
+            index_js_2.Logger.warn('IdentityCache - mergeTraitsIntoIdentityCache exhausted retries', { pixelId, identityId });
+            return undefined;
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - mergeTraitsIntoIdentityCache failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+            return undefined;
+        }
+    };
+    static attemptTraitMergeWrite = async (pixelId, identityId, incomingTraits) => {
+        try {
+            const current = await this.getItemByPk((0, key_builders_js_1.buildIdentityPk)(pixelId, identityId));
+            const currentResponse = current?.response ?? { identityId };
+            const mergedTraits = (0, at_shared_utils_1.mergeIdentityTraits)(incomingTraits, currentResponse.traits);
+            const mergedResponse = { ...currentResponse, identityId, traits: mergedTraits };
+            const now = new Date().toISOString();
+            const { identityItem, pointerItems } = this.buildIdentityCacheItems(pixelId, mergedResponse, now);
+            const conditionExpression = current?.updatedAt ? 'updatedAt = :expectedUpdatedAt' : 'attribute_not_exists(pk)';
+            const expressionAttributeValues = current?.updatedAt ? { ':expectedUpdatedAt': current.updatedAt } : undefined;
+            const writeResult = await index_js_1.DynamoDbClient.conditionalPut(constants_js_1.IDENTITY_CACHE_TABLE_NAME, identityItem, conditionExpression, expressionAttributeValues);
+            if (!writeResult.success) {
+                return { status: writeResult.conditionFailed ? TRAIT_MERGE_WRITE_STATUS.CONFLICT : TRAIT_MERGE_WRITE_STATUS.ERROR };
+            }
+            if (pointerItems.length > 0) {
+                await index_js_1.DynamoDbClient.safeBatchWrite(constants_js_1.IDENTITY_CACHE_TABLE_NAME, pointerItems);
+            }
+            return { status: TRAIT_MERGE_WRITE_STATUS.WRITTEN, identity: mergedResponse };
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - attemptTraitMergeWrite failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+            return { status: TRAIT_MERGE_WRITE_STATUS.ERROR };
+        }
+    };
+    static buildIdentityCacheItems = (pixelId, response, now) => {
+        const identityId = response.identityId;
+        const identityItem = {
+            pk: (0, key_builders_js_1.buildIdentityPk)(pixelId, identityId),
+            response,
+            updatedAt: now,
+            pixelId,
+            identityId,
+            gsi1pk: identityId,
+        };
+        const pointerItems = [];
+        const emails = response.traits?.emails ?? [];
+        for (const email of emails) {
+            if (email) {
+                pointerItems.push({
+                    pk: (0, key_builders_js_1.buildEmailPk)(pixelId, email),
+                    updatedAt: now,
+                    pixelId,
+                    identityId,
+                    gsi1pk: identityId,
+                });
+            }
+        }
+        return { identityItem, pointerItems };
+    };
+    static putIdentityMap = async (pixelId, identityId, linkedIdentities) => {
+        try {
+            if (!pixelId || !identityId) {
+                return;
+            }
+            const item = {
+                pk: (0, key_builders_js_1.buildIdentityMapPk)(pixelId, identityId),
+                pixelId,
+                identityId,
+                linkedIdentities,
+                updatedAt: new Date().toISOString(),
+            };
+            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) {
+            index_js_2.Logger.error('IdentityCache - putIdentityMap failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+        }
+    };
+    static setForcePurgeFlag = async (pixelId, identityId, ttlSeconds = constants_js_1.FORCE_PURGE_TTL_SECONDS) => {
+        try {
+            if (!pixelId || !identityId) {
+                return;
+            }
+            const now = new Date().toISOString();
+            const ttl = luxon_1.DateTime.utc().plus({ seconds: ttlSeconds }).toSeconds();
+            const item = {
+                pk: (0, key_builders_js_1.buildForcePurgePk)(pixelId, identityId),
+                pixelId,
+                identityId,
+                createdAt: now,
+                ttl: Math.floor(ttl),
+            };
+            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) {
+            index_js_2.Logger.error('IdentityCache - setForcePurgeFlag failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+        }
+    };
+    static deleteIdentityCache = async (pixelId, incomingIdentity, resolvedIdentity) => {
+        try {
+            if (!pixelId) {
+                return;
+            }
+            const deleteKeys = [];
+            const identityIdsToDelete = new Set();
+            if (incomingIdentity?.identityId) {
+                identityIdsToDelete.add(incomingIdentity.identityId);
+            }
+            if (resolvedIdentity?.identityId) {
+                identityIdsToDelete.add(resolvedIdentity.identityId);
+            }
+            for (const identityId of identityIdsToDelete) {
+                const relatedItems = await this.queryByGsi1(identityId);
+                for (const item of relatedItems) {
+                    if (item.pk && item.pixelId === pixelId) {
+                        deleteKeys.push({ pk: item.pk });
+                    }
+                }
+            }
+            if (incomingIdentity?.traits?.emails) {
+                for (const email of incomingIdentity.traits.emails) {
+                    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, key_builders_js_1.buildEmailPk)(pixelId, email) });
+                }
+            }
+            const uniqueKeys = Array.from(new Set(deleteKeys.map((k) => k.pk))).map((pk) => ({ pk }));
+            if (uniqueKeys.length > 0) {
+                await this.safeBatchDelete(uniqueKeys);
+                index_js_2.Logger.debug('IdentityCache - cache items deleted', { pixelId, deletedCount: uniqueKeys.length });
+            }
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - deleteIdentityCache failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+            });
+        }
+    };
+    static deleteIdentityMap = async (pixelId, identityId) => {
+        try {
+            if (!pixelId || !identityId) {
+                return;
+            }
+            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) {
+            index_js_2.Logger.error('IdentityCache - deleteIdentityMap failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+        }
+    };
+    static deleteForcePurgeFlag = async (pixelId, identityId) => {
+        try {
+            if (!pixelId || !identityId) {
+                return;
+            }
+            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) {
+            index_js_2.Logger.error('IdentityCache - deleteForcePurgeFlag failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                identityId,
+            });
+        }
+    };
+    static getIdentityIdFromEmailLookup = async (pixelId, incomingIdentity) => {
+        try {
+            if (!pixelId || !incomingIdentity) {
+                return undefined;
+            }
+            const firstEmail = incomingIdentity.traits?.emails?.[0];
+            if (!firstEmail) {
+                return undefined;
+            }
+            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(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
+            if (!result) {
+                return undefined;
+            }
+            index_js_2.Logger.debug('IdentityCache - identityId from email lookup', { pixelId, identityId: result.identityId, email: firstEmail });
+            return result.identityId;
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - email lookup failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pixelId,
+                incomingIdentity,
+            });
+            return undefined;
+        }
+    };
+    static getItemByPk = async (pk) => {
+        try {
+            const result = (await index_js_1.DynamoDbClient.safeGet(constants_js_1.IDENTITY_CACHE_TABLE_NAME, 'pk', pk));
+            return result ?? undefined;
+        }
+        catch (error) {
+            index_js_2.Logger.error('IdentityCache - getItemByPk failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                pk,
+            });
+            return undefined;
+        }
+    };
+    static queryByGsi1 = async (identityId) => {
+        try {
+            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) {
+            index_js_2.Logger.error('IdentityCache - queryByGsi1 failed', {
+                error,
+                errorMessage: error instanceof Error ? error.message : String(error),
+                identityId,
+            });
+            return [];
+        }
+    };
+    static safeBatchDelete = async (keys) => {
+        if (keys.length === 0) {
+            return;
+        }
+        const chunks = this.chunkArray(keys, 25);
+        for (const chunk of chunks) {
+            try {
+                const deleteRequests = chunk.map((key) => ({
+                    DeleteRequest: { Key: { pk: key.pk } },
+                }));
+                await index_js_1.DynamoDbClient.batchWrite({
+                    RequestItems: { [constants_js_1.IDENTITY_CACHE_TABLE_NAME]: deleteRequests },
+                });
+            }
+            catch (error) {
+                index_js_2.Logger.error('IdentityCache - batch delete failed', {
+                    error,
+                    errorMessage: error instanceof Error ? error.message : String(error),
+                    chunkSize: chunk.length,
+                });
+            }
+        }
+    };
+    static chunkArray(items, size) {
+        const chunks = [];
+        for (let i = 0; i < items.length; i += size) {
+            chunks.push(items.slice(i, i + size));
+        }
+        return chunks;
+    }
+}
+exports.IdentityCacheDynamoDbDbService = IdentityCacheDynamoDbDbService;
 //# sourceMappingURL=identity-cache-dynamodb-db-service.js.map