@adtrackify/at-service-common 4.0.9 → 4.0.10

package/dist/cjs/helpers/identity-cache-helper.js

@@ -1,307 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mergeAndComputeIdentityStaleness = exports.extractStaleTraitNames = exports.isClickInfosStale = exports.isIdentityCacheStale = exports.IDENTITY_CACHE_STALENESS_TIER = void 0;
-const at_shared_utils_1 = require("@adtrackify/at-shared-utils");
-const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
-const logging_helper_1 = require("./logging-helper");
-var IDENTITY_CACHE_STALENESS_TIER;
-(function (IDENTITY_CACHE_STALENESS_TIER) {
-    IDENTITY_CACHE_STALENESS_TIER["NONE"] = "none";
-    IDENTITY_CACHE_STALENESS_TIER["VOLATILE_ONLY"] = "volatile_only";
-    IDENTITY_CACHE_STALENESS_TIER["ADDRESS_UPDATE"] = "address_update";
-    IDENTITY_CACHE_STALENESS_TIER["IDENTITY_STALE"] = "identity_stale";
-})(IDENTITY_CACHE_STALENESS_TIER = exports.IDENTITY_CACHE_STALENESS_TIER || (exports.IDENTITY_CACHE_STALENESS_TIER = {}));
-const createInitialTracker = (cachedTraits, incomingTraits) => ({
-    cachedTraits,
-    incomingTraits,
-    isIdentityIdStale: false,
-    isUserIdsStale: false,
-    isIdsStale: false,
-    isEmailsStale: false,
-    isPhonesStale: false,
-    isShopifyYIdsStale: false,
-    isGendersStale: false,
-    isDobsStale: false,
-    isAddressesStale: false,
-    isIpAddressesStale: false,
-    isNonIpAddressesStale: false,
-    isClickInfosStale: false,
-    isIpAddressStale: false,
-    isUserAgentStale: false,
-    isThirdPartyContactsStale: false,
-    isCacheStale: false,
-    staleTier: IDENTITY_CACHE_STALENESS_TIER.NONE,
-});
-const markStaleTraitOnly = (tracker, trackerKey, logMessage) => {
-    logging_helper_1.Logger.debug(`IdentityCache - identity cache check - ${logMessage}`, {
-        cachedTraits: tracker.cachedTraits,
-        incomingTraits: tracker.incomingTraits,
-    });
-    tracker[trackerKey] = true;
-};
-const isAddressIpSourced = (addr) => {
-    if (addr?.s !== undefined) {
-        return addr.s === at_tracking_event_types_1.ADDRESS_INFO_SOURCE.IP_ADDRESS;
-    }
-    const hasPii = Boolean(addr?.firstName || addr?.lastName || addr?.email || addr?.phone);
-    return !hasPii;
-};
-const filterAddressesBySource = (addresses, isIpSource) => {
-    return addresses.filter((addr) => {
-        const addressIsIp = isAddressIpSourced(addr);
-        return isIpSource ? addressIsIp : !addressIsIp;
-    });
-};
-const hasNewNonIpAddress = (cachedAddresses, incomingAddresses) => {
-    const cachedNonIp = filterAddressesBySource(cachedAddresses, false);
-    const incomingNonIp = filterAddressesBySource(incomingAddresses, false);
-    return (0, at_shared_utils_1.hasNewAddress)(cachedNonIp, incomingNonIp);
-};
-const hasNewIpAddress = (cachedAddresses, incomingAddresses) => {
-    const cachedIp = filterAddressesBySource(cachedAddresses, true);
-    const incomingIp = filterAddressesBySource(incomingAddresses, true);
-    return (0, at_shared_utils_1.hasNewAddress)(cachedIp, incomingIp);
-};
-const checkScalarTraitChanged = (cachedValue, incomingValue) => Boolean(incomingValue && cachedValue !== incomingValue);
-const computeStaleTier = (tracker) => {
-    const hasIdentityStale = tracker.isIdentityIdStale ||
-        tracker.isUserIdsStale ||
-        tracker.isIdsStale ||
-        tracker.isEmailsStale ||
-        tracker.isPhonesStale ||
-        tracker.isShopifyYIdsStale ||
-        tracker.isGendersStale ||
-        tracker.isDobsStale ||
-        tracker.isClickInfosStale ||
-        tracker.isThirdPartyContactsStale;
-    if (hasIdentityStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE;
-    }
-    if (tracker.isNonIpAddressesStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
-    }
-    const hasVolatileStale = tracker.isIpAddressStale || tracker.isUserAgentStale || tracker.isIpAddressesStale;
-    if (hasVolatileStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
-    }
-    return IDENTITY_CACHE_STALENESS_TIER.NONE;
-};
-const isIdentityCacheStale = (identityCache, incomingIdentity) => {
-    try {
-        const cachedTraits = identityCache?.traits ?? {};
-        const incomingTraits = incomingIdentity?.traits ?? {};
-        const tracker = createInitialTracker(cachedTraits, incomingTraits);
-        const cachedAddresses = cachedTraits?.addresses ?? [];
-        const incomingAddresses = incomingTraits?.addresses ?? [];
-        const identityChecks = [
-            {
-                trackerKey: 'isIdentityIdStale',
-                logMessage: 'identityId changed',
-                isStale: () => identityCache?.identityId !== incomingIdentity?.identityId,
-            },
-            {
-                trackerKey: 'isUserIdsStale',
-                logMessage: 'userIds changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.userIds ?? [], incomingTraits?.userIds ?? []),
-            },
-            {
-                trackerKey: 'isIdsStale',
-                logMessage: 'ids changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.ids ?? [], incomingTraits?.ids ?? []),
-            },
-            {
-                trackerKey: 'isEmailsStale',
-                logMessage: 'emails changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.emails ?? [], incomingTraits?.emails ?? []),
-            },
-            {
-                trackerKey: 'isPhonesStale',
-                logMessage: 'phones changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.phones ?? [], incomingTraits?.phones ?? []),
-            },
-            {
-                trackerKey: 'isShopifyYIdsStale',
-                logMessage: 'shopify Y ids changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.shopifyYIds ?? [], incomingTraits?.shopifyYIds ?? []),
-            },
-            {
-                trackerKey: 'isGendersStale',
-                logMessage: 'genders changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.genders ?? [], incomingTraits?.genders ?? []),
-            },
-            {
-                trackerKey: 'isDobsStale',
-                logMessage: 'dobs changed',
-                isStale: () => (0, at_shared_utils_1.hasNewTrait)(cachedTraits?.dobs ?? [], incomingTraits?.dobs ?? []),
-            },
-            {
-                trackerKey: 'isClickInfosStale',
-                logMessage: 'clickInfos changed',
-                isStale: () => (0, exports.isClickInfosStale)(cachedTraits?.click ?? {}, incomingTraits?.click ?? {}),
-            },
-            {
-                trackerKey: 'isThirdPartyContactsStale',
-                logMessage: 'thirdPartyContacts changed',
-                isStale: () => (0, at_shared_utils_1.hasNewThirdPartyContact)(cachedTraits?.tpc ?? [], incomingTraits?.tpc ?? []),
-            },
-        ];
-        const addressChecks = [
-            {
-                trackerKey: 'isNonIpAddressesStale',
-                logMessage: 'non-IP address changed',
-                isStale: () => hasNewNonIpAddress(cachedAddresses, incomingAddresses),
-                isAddressUpdate: true,
-            },
-            {
-                trackerKey: 'isIpAddressesStale',
-                logMessage: 'IP-sourced address changed',
-                isStale: () => hasNewIpAddress(cachedAddresses, incomingAddresses),
-                isVolatile: true,
-            },
-        ];
-        const volatileChecks = [
-            {
-                trackerKey: 'isIpAddressStale',
-                logMessage: 'ipAddress changed',
-                isStale: () => checkScalarTraitChanged(cachedTraits?.ipAddress, incomingTraits?.ipAddress),
-                isVolatile: true,
-            },
-            {
-                trackerKey: 'isUserAgentStale',
-                logMessage: 'userAgent changed',
-                isStale: () => checkScalarTraitChanged(cachedTraits?.userAgent, incomingTraits?.userAgent),
-                isVolatile: true,
-            },
-        ];
-        const allChecks = [...identityChecks, ...addressChecks, ...volatileChecks];
-        for (const check of allChecks) {
-            if (check.isStale()) {
-                markStaleTraitOnly(tracker, check.trackerKey, check.logMessage);
-            }
-        }
-        tracker.isAddressesStale = tracker.isIpAddressesStale || tracker.isNonIpAddressesStale;
-        tracker.staleTier = computeStaleTier(tracker);
-        tracker.isCacheStale =
-            tracker.staleTier === IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE ||
-                tracker.staleTier === IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
-        if (tracker.staleTier !== IDENTITY_CACHE_STALENESS_TIER.NONE) {
-            logging_helper_1.Logger.debug('IdentityCache - identity cache staleness check complete', {
-                staleTier: tracker.staleTier,
-                isCacheStale: tracker.isCacheStale,
-                identityCacheStaleTracker: tracker,
-            });
-        }
-        return tracker;
-    }
-    catch (error) {
-        logging_helper_1.Logger.error('IdentityCache - error checking if identity cache is stale', {
-            error,
-            errorMessage: error instanceof Error ? error.message : String(error),
-        });
-        const errorTracker = createInitialTracker({}, {});
-        errorTracker.isCacheStale = true;
-        errorTracker.staleTier = IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE;
-        return errorTracker;
-    }
-};
-exports.isIdentityCacheStale = isIdentityCacheStale;
-const shouldSkipClickKey = (key) => key === 'googleClientInfos' || key.includes('CollectedAt');
-const extractFbclid = (fbc) => fbc?.split('.')?.[3];
-const isFbcStale = (cachedFbc, incomingFbc) => {
-    if (incomingFbc && !cachedFbc) {
-        return true;
-    }
-    if (!incomingFbc || !cachedFbc || incomingFbc === cachedFbc) {
-        return false;
-    }
-    const incomingFbclid = extractFbclid(incomingFbc);
-    const cachedFbclid = extractFbclid(cachedFbc);
-    return !incomingFbclid || !cachedFbclid || incomingFbclid !== cachedFbclid;
-};
-const isGenericClickKeyStale = (cachedValue, incomingValue) => (Boolean(incomingValue) && !cachedValue) || incomingValue !== cachedValue;
-const isClickInfosStale = (cachedClick, incomingClick) => {
-    try {
-        const cleanedCachedClick = (0, at_shared_utils_1.removeEmptyFields)(cachedClick);
-        const cleanedIncomingClick = (0, at_shared_utils_1.removeEmptyFields)(incomingClick);
-        const incomingKeys = Object.keys(cleanedIncomingClick);
-        const staleKeys = [];
-        for (const key of incomingKeys) {
-            if (shouldSkipClickKey(key)) {
-                continue;
-            }
-            const cachedValue = cleanedCachedClick?.[key];
-            const incomingValue = cleanedIncomingClick?.[key];
-            const isStale = key === 'fbc'
-                ? isFbcStale(cachedValue, incomingValue)
-                : isGenericClickKeyStale(cachedValue, incomingValue);
-            if (isStale) {
-                staleKeys.push(key);
-            }
-        }
-        if (staleKeys.length > 0) {
-            logging_helper_1.Logger.debug('IdentityCache - identity cache miss - clickInfos changed', {
-                cleanedCachedClick,
-                cleanedIncomingClick,
-                staleKeys,
-            });
-        }
-        return staleKeys.length > 0;
-    }
-    catch (error) {
-        logging_helper_1.Logger.error('IdentityCache - error checking if click infos are stale - assuming stale', {
-            error,
-            errorMessage: error instanceof Error ? error.message : String(error),
-        });
-        return true;
-    }
-};
-exports.isClickInfosStale = isClickInfosStale;
-function 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;
-}
-exports.extractStaleTraitNames = extractStaleTraitNames;
-function mergeAndComputeIdentityStaleness(incomingIdentity, cachedOrResolvedIdentity) {
-    const mergedTraits = (0, at_shared_utils_1.mergeIdentityTraits)(incomingIdentity.traits, cachedOrResolvedIdentity.traits);
-    const mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
-    const staleTracker = (0, exports.isIdentityCacheStale)(cachedOrResolvedIdentity, incomingIdentity);
-    const staleTier = staleTracker.staleTier;
-    const isCacheStale = staleTier !== IDENTITY_CACHE_STALENESS_TIER.NONE &&
-        staleTier !== IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
-    const staleTraits = extractStaleTraitNames(staleTracker);
-    return {
-        mergedIdentity,
-        staleTracker,
-        staleTier,
-        isCacheStale,
-        staleTraits,
-    };
-}
-exports.mergeAndComputeIdentityStaleness = mergeAndComputeIdentityStaleness;
-//# sourceMappingURL=identity-cache-helper.js.map

package/dist/cjs/helpers/identity-cache-helper.js.map

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

package/dist/esm/helpers/identity-cache-helper.d.ts

@@ -1,39 +0,0 @@
-import { AdClickInfo, EventIdentity, EventIdentityTraits } from '@adtrackify/at-tracking-event-types';
-export declare enum IDENTITY_CACHE_STALENESS_TIER {
-    NONE = "none",
-    VOLATILE_ONLY = "volatile_only",
-    ADDRESS_UPDATE = "address_update",
-    IDENTITY_STALE = "identity_stale"
-}
-export interface IdentityCacheStaleTracker {
-    cachedTraits: EventIdentityTraits;
-    incomingTraits: EventIdentityTraits;
-    isIdentityIdStale: boolean;
-    isUserIdsStale: boolean;
-    isIdsStale: boolean;
-    isEmailsStale: boolean;
-    isPhonesStale: boolean;
-    isShopifyYIdsStale: boolean;
-    isGendersStale: boolean;
-    isDobsStale: boolean;
-    isAddressesStale: boolean;
-    isIpAddressesStale: boolean;
-    isNonIpAddressesStale: boolean;
-    isClickInfosStale: boolean;
-    isIpAddressStale: boolean;
-    isUserAgentStale: boolean;
-    isThirdPartyContactsStale: boolean;
-    isCacheStale: boolean;
-    staleTier: IDENTITY_CACHE_STALENESS_TIER;
-}
-export declare const isIdentityCacheStale: (identityCache: EventIdentity, incomingIdentity: EventIdentity) => IdentityCacheStaleTracker;
-export declare const isClickInfosStale: (cachedClick: AdClickInfo, incomingClick: AdClickInfo) => boolean;
-export declare function extractStaleTraitNames(tracker: IdentityCacheStaleTracker): string[];
-export interface MergeAndComputeIdentityStalenessResult {
-    mergedIdentity: EventIdentity;
-    staleTracker: IdentityCacheStaleTracker;
-    staleTier: IDENTITY_CACHE_STALENESS_TIER;
-    isCacheStale: boolean;
-    staleTraits: string[];
-}
-export declare function mergeAndComputeIdentityStaleness(incomingIdentity: EventIdentity, cachedOrResolvedIdentity: EventIdentity): MergeAndComputeIdentityStalenessResult;

package/dist/esm/helpers/identity-cache-helper.js

@@ -1,300 +0,0 @@
-import { hasNewTrait, hasNewAddress, removeEmptyFields, mergeIdentityTraits, hasNewThirdPartyContact } from '@adtrackify/at-shared-utils';
-import { ADDRESS_INFO_SOURCE, } from '@adtrackify/at-tracking-event-types';
-import { Logger } from './logging-helper';
-export var IDENTITY_CACHE_STALENESS_TIER;
-(function (IDENTITY_CACHE_STALENESS_TIER) {
-    IDENTITY_CACHE_STALENESS_TIER["NONE"] = "none";
-    IDENTITY_CACHE_STALENESS_TIER["VOLATILE_ONLY"] = "volatile_only";
-    IDENTITY_CACHE_STALENESS_TIER["ADDRESS_UPDATE"] = "address_update";
-    IDENTITY_CACHE_STALENESS_TIER["IDENTITY_STALE"] = "identity_stale";
-})(IDENTITY_CACHE_STALENESS_TIER || (IDENTITY_CACHE_STALENESS_TIER = {}));
-const createInitialTracker = (cachedTraits, incomingTraits) => ({
-    cachedTraits,
-    incomingTraits,
-    isIdentityIdStale: false,
-    isUserIdsStale: false,
-    isIdsStale: false,
-    isEmailsStale: false,
-    isPhonesStale: false,
-    isShopifyYIdsStale: false,
-    isGendersStale: false,
-    isDobsStale: false,
-    isAddressesStale: false,
-    isIpAddressesStale: false,
-    isNonIpAddressesStale: false,
-    isClickInfosStale: false,
-    isIpAddressStale: false,
-    isUserAgentStale: false,
-    isThirdPartyContactsStale: false,
-    isCacheStale: false,
-    staleTier: IDENTITY_CACHE_STALENESS_TIER.NONE,
-});
-const markStaleTraitOnly = (tracker, trackerKey, logMessage) => {
-    Logger.debug(`IdentityCache - identity cache check - ${logMessage}`, {
-        cachedTraits: tracker.cachedTraits,
-        incomingTraits: tracker.incomingTraits,
-    });
-    tracker[trackerKey] = true;
-};
-const isAddressIpSourced = (addr) => {
-    if (addr?.s !== undefined) {
-        return addr.s === ADDRESS_INFO_SOURCE.IP_ADDRESS;
-    }
-    const hasPii = Boolean(addr?.firstName || addr?.lastName || addr?.email || addr?.phone);
-    return !hasPii;
-};
-const filterAddressesBySource = (addresses, isIpSource) => {
-    return addresses.filter((addr) => {
-        const addressIsIp = isAddressIpSourced(addr);
-        return isIpSource ? addressIsIp : !addressIsIp;
-    });
-};
-const hasNewNonIpAddress = (cachedAddresses, incomingAddresses) => {
-    const cachedNonIp = filterAddressesBySource(cachedAddresses, false);
-    const incomingNonIp = filterAddressesBySource(incomingAddresses, false);
-    return hasNewAddress(cachedNonIp, incomingNonIp);
-};
-const hasNewIpAddress = (cachedAddresses, incomingAddresses) => {
-    const cachedIp = filterAddressesBySource(cachedAddresses, true);
-    const incomingIp = filterAddressesBySource(incomingAddresses, true);
-    return hasNewAddress(cachedIp, incomingIp);
-};
-const checkScalarTraitChanged = (cachedValue, incomingValue) => Boolean(incomingValue && cachedValue !== incomingValue);
-const computeStaleTier = (tracker) => {
-    const hasIdentityStale = tracker.isIdentityIdStale ||
-        tracker.isUserIdsStale ||
-        tracker.isIdsStale ||
-        tracker.isEmailsStale ||
-        tracker.isPhonesStale ||
-        tracker.isShopifyYIdsStale ||
-        tracker.isGendersStale ||
-        tracker.isDobsStale ||
-        tracker.isClickInfosStale ||
-        tracker.isThirdPartyContactsStale;
-    if (hasIdentityStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE;
-    }
-    if (tracker.isNonIpAddressesStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
-    }
-    const hasVolatileStale = tracker.isIpAddressStale || tracker.isUserAgentStale || tracker.isIpAddressesStale;
-    if (hasVolatileStale) {
-        return IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
-    }
-    return IDENTITY_CACHE_STALENESS_TIER.NONE;
-};
-export const isIdentityCacheStale = (identityCache, incomingIdentity) => {
-    try {
-        const cachedTraits = identityCache?.traits ?? {};
-        const incomingTraits = incomingIdentity?.traits ?? {};
-        const tracker = createInitialTracker(cachedTraits, incomingTraits);
-        const cachedAddresses = cachedTraits?.addresses ?? [];
-        const incomingAddresses = incomingTraits?.addresses ?? [];
-        const identityChecks = [
-            {
-                trackerKey: 'isIdentityIdStale',
-                logMessage: 'identityId changed',
-                isStale: () => identityCache?.identityId !== incomingIdentity?.identityId,
-            },
-            {
-                trackerKey: 'isUserIdsStale',
-                logMessage: 'userIds changed',
-                isStale: () => hasNewTrait(cachedTraits?.userIds ?? [], incomingTraits?.userIds ?? []),
-            },
-            {
-                trackerKey: 'isIdsStale',
-                logMessage: 'ids changed',
-                isStale: () => hasNewTrait(cachedTraits?.ids ?? [], incomingTraits?.ids ?? []),
-            },
-            {
-                trackerKey: 'isEmailsStale',
-                logMessage: 'emails changed',
-                isStale: () => hasNewTrait(cachedTraits?.emails ?? [], incomingTraits?.emails ?? []),
-            },
-            {
-                trackerKey: 'isPhonesStale',
-                logMessage: 'phones changed',
-                isStale: () => hasNewTrait(cachedTraits?.phones ?? [], incomingTraits?.phones ?? []),
-            },
-            {
-                trackerKey: 'isShopifyYIdsStale',
-                logMessage: 'shopify Y ids changed',
-                isStale: () => hasNewTrait(cachedTraits?.shopifyYIds ?? [], incomingTraits?.shopifyYIds ?? []),
-            },
-            {
-                trackerKey: 'isGendersStale',
-                logMessage: 'genders changed',
-                isStale: () => hasNewTrait(cachedTraits?.genders ?? [], incomingTraits?.genders ?? []),
-            },
-            {
-                trackerKey: 'isDobsStale',
-                logMessage: 'dobs changed',
-                isStale: () => hasNewTrait(cachedTraits?.dobs ?? [], incomingTraits?.dobs ?? []),
-            },
-            {
-                trackerKey: 'isClickInfosStale',
-                logMessage: 'clickInfos changed',
-                isStale: () => isClickInfosStale(cachedTraits?.click ?? {}, incomingTraits?.click ?? {}),
-            },
-            {
-                trackerKey: 'isThirdPartyContactsStale',
-                logMessage: 'thirdPartyContacts changed',
-                isStale: () => hasNewThirdPartyContact(cachedTraits?.tpc ?? [], incomingTraits?.tpc ?? []),
-            },
-        ];
-        const addressChecks = [
-            {
-                trackerKey: 'isNonIpAddressesStale',
-                logMessage: 'non-IP address changed',
-                isStale: () => hasNewNonIpAddress(cachedAddresses, incomingAddresses),
-                isAddressUpdate: true,
-            },
-            {
-                trackerKey: 'isIpAddressesStale',
-                logMessage: 'IP-sourced address changed',
-                isStale: () => hasNewIpAddress(cachedAddresses, incomingAddresses),
-                isVolatile: true,
-            },
-        ];
-        const volatileChecks = [
-            {
-                trackerKey: 'isIpAddressStale',
-                logMessage: 'ipAddress changed',
-                isStale: () => checkScalarTraitChanged(cachedTraits?.ipAddress, incomingTraits?.ipAddress),
-                isVolatile: true,
-            },
-            {
-                trackerKey: 'isUserAgentStale',
-                logMessage: 'userAgent changed',
-                isStale: () => checkScalarTraitChanged(cachedTraits?.userAgent, incomingTraits?.userAgent),
-                isVolatile: true,
-            },
-        ];
-        const allChecks = [...identityChecks, ...addressChecks, ...volatileChecks];
-        for (const check of allChecks) {
-            if (check.isStale()) {
-                markStaleTraitOnly(tracker, check.trackerKey, check.logMessage);
-            }
-        }
-        tracker.isAddressesStale = tracker.isIpAddressesStale || tracker.isNonIpAddressesStale;
-        tracker.staleTier = computeStaleTier(tracker);
-        tracker.isCacheStale =
-            tracker.staleTier === IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE ||
-                tracker.staleTier === IDENTITY_CACHE_STALENESS_TIER.ADDRESS_UPDATE;
-        if (tracker.staleTier !== IDENTITY_CACHE_STALENESS_TIER.NONE) {
-            Logger.debug('IdentityCache - identity cache staleness check complete', {
-                staleTier: tracker.staleTier,
-                isCacheStale: tracker.isCacheStale,
-                identityCacheStaleTracker: tracker,
-            });
-        }
-        return tracker;
-    }
-    catch (error) {
-        Logger.error('IdentityCache - error checking if identity cache is stale', {
-            error,
-            errorMessage: error instanceof Error ? error.message : String(error),
-        });
-        const errorTracker = createInitialTracker({}, {});
-        errorTracker.isCacheStale = true;
-        errorTracker.staleTier = IDENTITY_CACHE_STALENESS_TIER.IDENTITY_STALE;
-        return errorTracker;
-    }
-};
-const shouldSkipClickKey = (key) => key === 'googleClientInfos' || key.includes('CollectedAt');
-const extractFbclid = (fbc) => fbc?.split('.')?.[3];
-const isFbcStale = (cachedFbc, incomingFbc) => {
-    if (incomingFbc && !cachedFbc) {
-        return true;
-    }
-    if (!incomingFbc || !cachedFbc || incomingFbc === cachedFbc) {
-        return false;
-    }
-    const incomingFbclid = extractFbclid(incomingFbc);
-    const cachedFbclid = extractFbclid(cachedFbc);
-    return !incomingFbclid || !cachedFbclid || incomingFbclid !== cachedFbclid;
-};
-const isGenericClickKeyStale = (cachedValue, incomingValue) => (Boolean(incomingValue) && !cachedValue) || incomingValue !== cachedValue;
-export const isClickInfosStale = (cachedClick, incomingClick) => {
-    try {
-        const cleanedCachedClick = removeEmptyFields(cachedClick);
-        const cleanedIncomingClick = removeEmptyFields(incomingClick);
-        const incomingKeys = Object.keys(cleanedIncomingClick);
-        const staleKeys = [];
-        for (const key of incomingKeys) {
-            if (shouldSkipClickKey(key)) {
-                continue;
-            }
-            const cachedValue = cleanedCachedClick?.[key];
-            const incomingValue = cleanedIncomingClick?.[key];
-            const isStale = key === 'fbc'
-                ? isFbcStale(cachedValue, incomingValue)
-                : isGenericClickKeyStale(cachedValue, incomingValue);
-            if (isStale) {
-                staleKeys.push(key);
-            }
-        }
-        if (staleKeys.length > 0) {
-            Logger.debug('IdentityCache - identity cache miss - clickInfos changed', {
-                cleanedCachedClick,
-                cleanedIncomingClick,
-                staleKeys,
-            });
-        }
-        return staleKeys.length > 0;
-    }
-    catch (error) {
-        Logger.error('IdentityCache - error checking if click infos are stale - assuming stale', {
-            error,
-            errorMessage: error instanceof Error ? error.message : String(error),
-        });
-        return true;
-    }
-};
-export function 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;
-}
-export function mergeAndComputeIdentityStaleness(incomingIdentity, cachedOrResolvedIdentity) {
-    const mergedTraits = mergeIdentityTraits(incomingIdentity.traits, cachedOrResolvedIdentity.traits);
-    const mergedIdentity = { ...incomingIdentity, traits: mergedTraits };
-    const staleTracker = isIdentityCacheStale(cachedOrResolvedIdentity, incomingIdentity);
-    const staleTier = staleTracker.staleTier;
-    const isCacheStale = staleTier !== IDENTITY_CACHE_STALENESS_TIER.NONE &&
-        staleTier !== IDENTITY_CACHE_STALENESS_TIER.VOLATILE_ONLY;
-    const staleTraits = extractStaleTraitNames(staleTracker);
-    return {
-        mergedIdentity,
-        staleTracker,
-        staleTier,
-        isCacheStale,
-        staleTraits,
-    };
-}
-//# sourceMappingURL=identity-cache-helper.js.map