@adtrackify/at-service-common 4.0.5 → 4.0.6

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

@@ -0,0 +1,205 @@
+import { EventContext, EventIdentity, EventIdentityTraits, IdentityDynamoDbCache, IdentityMapDynamoDbCache, ForcePurgeDynamoDbCache, IdentityPointerRecord } from '@adtrackify/at-tracking-event-types';
+import { IDENTITY_CACHE_STALENESS_TIER, IdentityCacheStaleTracker } from '../../../helpers/identity-cache-helper.js';
+export type { IdentityDynamoDbCache, IdentityMapDynamoDbCache, ForcePurgeDynamoDbCache, IdentityPointerRecord };
+export declare enum CACHE_WRITE_REASON {
+    CACHE_MISS = "cache_miss",
+    STALE_TRAITS = "stale_traits",
+    EMAIL_POINTER_DISCOVERY = "email_pointer_discovery",
+    ADDRESS_UPDATE = "address_update"
+}
+export interface IdentityCacheResult {
+    resolvedIdentity?: EventIdentity;
+    isCacheStale: boolean;
+    cachedIdentity?: EventIdentity;
+    staleTracker?: IdentityCacheStaleTracker;
+    writeReason?: CACHE_WRITE_REASON;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    skipNeptune?: boolean;
+}
+export declare enum IDENTITY_CACHE_LOOKUP_OUTCOME {
+    INVALID_INPUT = "invalid_input",
+    PRIMARY_CACHE_MISS = "primary_cache_miss",
+    PRIMARY_CACHE_MISS_NO_RESPONSE = "primary_cache_miss_no_response",
+    PRIMARY_CACHE_HIT = "primary_cache_hit",
+    PRIMARY_CACHE_STALE = "primary_cache_stale",
+    EMAIL_POINTER_DISCOVERY = "email_pointer_discovery",
+    EMAIL_POINTER_MISS = "email_pointer_miss",
+    FAILED = "failed"
+}
+export interface IdentityCacheLookupSummary {
+    outcome: IDENTITY_CACHE_LOOKUP_OUTCOME;
+    pixelId: string;
+    identityId?: string;
+    didLookupByIdentityId: boolean;
+    didLookupByEmail: boolean;
+    isDeepEqual?: boolean;
+    isCacheStale: boolean;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    staleTraits: string[];
+    writeReason?: CACHE_WRITE_REASON;
+    skipNeptune?: boolean;
+    cachedIdentity?: EventIdentity;
+    incomingIdentity?: EventIdentity;
+    mergedIdentity?: EventIdentity;
+    resolvedIdentity?: EventIdentity;
+    discoveredIdentityId?: string;
+    incomingClick?: EventIdentityTraits['click'] | null;
+    cachedClick?: EventIdentityTraits['click'] | null;
+    mergedClick?: EventIdentityTraits['click'] | null;
+    errorMessage?: string;
+}
+export interface IdentityCacheLookupResult {
+    cacheResult: IdentityCacheResult;
+    summary: IdentityCacheLookupSummary;
+}
+export interface IdentityCacheLookupSummaryInput {
+    outcome: IDENTITY_CACHE_LOOKUP_OUTCOME;
+    pixelId: string;
+    identityId?: string;
+    didLookupByIdentityId?: boolean;
+    didLookupByEmail?: boolean;
+    isDeepEqual?: boolean;
+    isCacheStale?: boolean;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    staleTraits?: string[];
+    writeReason?: CACHE_WRITE_REASON;
+    skipNeptune?: boolean;
+    cachedIdentity?: EventIdentity;
+    incomingIdentity?: EventIdentity;
+    mergedIdentity?: EventIdentity;
+    resolvedIdentity?: EventIdentity;
+    discoveredIdentityId?: string;
+    errorMessage?: string;
+}
+export interface IdentityCacheLookupState {
+    pixelId: string;
+    incomingIdentity: EventIdentity;
+    cachedIdentityResponse?: IdentityDynamoDbCache;
+    cachedIdentity?: EventIdentity;
+    mergedIdentity?: EventIdentity;
+    resolvedIdentity?: EventIdentity;
+    identityStaleCacheTracker?: IdentityCacheStaleTracker;
+    discoveredIdentityId?: string;
+    didLookupByIdentityId: boolean;
+    didLookupByEmail: boolean;
+    isDeepEqual?: boolean;
+    isCacheStale: boolean;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    writeReason?: CACHE_WRITE_REASON;
+    skipNeptune?: boolean;
+    staleTraits: string[];
+}
+export interface IdentityCacheLookupStateSummaryInput extends Partial<IdentityCacheLookupSummaryInput> {
+    outcome: IDENTITY_CACHE_LOOKUP_OUTCOME;
+}
+export declare enum IDENTITY_CACHE_WITH_CACHING_OUTCOME {
+    INVALID_INPUT = "invalid_input",
+    FRESH_CACHE_HIT = "fresh_cache_hit",
+    VOLATILE_ONLY_CACHE_HIT = "volatile_only_cache_hit",
+    ADDRESS_UPDATE_WRITE = "address_update_write",
+    NEPTUNE_FETCH = "neptune_fetch",
+    NEPTUNE_WRITE_BACK = "neptune_write_back",
+    NEPTUNE_SKIP_WRITE = "neptune_skip_write",
+    NEPTUNE_RESOLUTION_FAILED = "neptune_resolution_failed",
+    FALLBACK_INCOMING = "fallback_incoming",
+    FAILED = "failed"
+}
+export interface IdentityCacheTraitChange {
+    cached?: unknown;
+    resolved?: unknown;
+}
+export interface IdentityCacheTraitChanges {
+    [traitName: string]: IdentityCacheTraitChange;
+}
+export interface IdentityCacheWithCachingSummary {
+    outcome: IDENTITY_CACHE_WITH_CACHING_OUTCOME;
+    pixelId: string;
+    identityId?: string;
+    writeReason?: CACHE_WRITE_REASON;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    staleTraits: string[];
+    didReadCache: boolean;
+    didCallNeptune: boolean;
+    didWriteCache: boolean;
+    didSkipNeptune: boolean;
+    didFallbackToIncoming: boolean;
+    cachedIdentity?: EventIdentity;
+    incomingIdentity?: EventIdentity;
+    identityForNeptune?: EventIdentity;
+    resolvedIdentity?: EventIdentity;
+    neptuneIdentity?: EventIdentity;
+    incomingClick?: EventIdentityTraits['click'] | null;
+    cachedClick?: EventIdentityTraits['click'] | null;
+    resolvedClick?: EventIdentityTraits['click'] | null;
+    neptuneClick?: EventIdentityTraits['click'] | null;
+    traitChanges?: IdentityCacheTraitChanges;
+    hasDiscoveredIdentityId?: boolean;
+    lookupSummary?: IdentityCacheLookupSummary;
+    errorMessage?: string;
+}
+export interface IdentityCacheWithCachingResult {
+    identity?: EventIdentity;
+    summary: IdentityCacheWithCachingSummary;
+}
+export interface IdentityCacheWithCachingSummaryInput {
+    outcome: IDENTITY_CACHE_WITH_CACHING_OUTCOME;
+    pixelId: string;
+    identityId?: string;
+    writeReason?: CACHE_WRITE_REASON;
+    staleTier?: IDENTITY_CACHE_STALENESS_TIER;
+    staleTraits?: string[];
+    didReadCache?: boolean;
+    didCallNeptune?: boolean;
+    didWriteCache?: boolean;
+    didSkipNeptune?: boolean;
+    didFallbackToIncoming?: boolean;
+    cachedIdentity?: EventIdentity;
+    incomingIdentity?: EventIdentity;
+    identityForNeptune?: EventIdentity;
+    resolvedIdentity?: EventIdentity;
+    neptuneIdentity?: EventIdentity;
+    traitChanges?: IdentityCacheTraitChanges;
+    hasDiscoveredIdentityId?: boolean;
+    lookupSummary?: IdentityCacheLookupSummary;
+    errorMessage?: string;
+}
+export interface IdentityCacheWithCachingState {
+    pixelId: string;
+    incomingIdentity?: EventIdentity;
+    identifyPrivateLambdaArn: string;
+    cacheResponse?: IdentityCacheResult;
+    lookupSummary?: IdentityCacheLookupSummary;
+    resolvedIdentity?: EventIdentity;
+    cachedIdentity?: EventIdentity;
+    identityForNeptune?: EventIdentity;
+    neptuneIdentity?: EventIdentity;
+    staleTraits: string[];
+    didReadCache: boolean;
+    didCallNeptune: boolean;
+    didWriteCache: boolean;
+    didSkipNeptune: boolean;
+    didFallbackToIncoming: boolean;
+}
+export interface IdentityCacheWithCachingStateSummaryInput extends Partial<IdentityCacheWithCachingSummaryInput> {
+    outcome: IDENTITY_CACHE_WITH_CACHING_OUTCOME;
+}
+export interface IdentityWithCachingOptions {
+    skipCacheWrite?: boolean;
+}
+export interface EnqueueAsyncIdentityUpdateRequest {
+    pixelId: string;
+    identity: EventIdentity;
+    context: EventContext;
+    reason: string;
+    eventId?: string;
+}
+export interface IdentifyAsyncUpdateMessage {
+    pixelId: string;
+    incomingIdentityId: string;
+    context: EventContext;
+}
+export interface EnqueueAsyncIdentityUpdateResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}

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

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDENTITY_CACHE_WITH_CACHING_OUTCOME = exports.IDENTITY_CACHE_LOOKUP_OUTCOME = exports.CACHE_WRITE_REASON = void 0;
+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 = {}));
+var IDENTITY_CACHE_LOOKUP_OUTCOME;
+(function (IDENTITY_CACHE_LOOKUP_OUTCOME) {
+    IDENTITY_CACHE_LOOKUP_OUTCOME["INVALID_INPUT"] = "invalid_input";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["PRIMARY_CACHE_MISS"] = "primary_cache_miss";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["PRIMARY_CACHE_MISS_NO_RESPONSE"] = "primary_cache_miss_no_response";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["PRIMARY_CACHE_HIT"] = "primary_cache_hit";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["PRIMARY_CACHE_STALE"] = "primary_cache_stale";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["EMAIL_POINTER_DISCOVERY"] = "email_pointer_discovery";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["EMAIL_POINTER_MISS"] = "email_pointer_miss";
+    IDENTITY_CACHE_LOOKUP_OUTCOME["FAILED"] = "failed";
+})(IDENTITY_CACHE_LOOKUP_OUTCOME = exports.IDENTITY_CACHE_LOOKUP_OUTCOME || (exports.IDENTITY_CACHE_LOOKUP_OUTCOME = {}));
+var IDENTITY_CACHE_WITH_CACHING_OUTCOME;
+(function (IDENTITY_CACHE_WITH_CACHING_OUTCOME) {
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["INVALID_INPUT"] = "invalid_input";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["FRESH_CACHE_HIT"] = "fresh_cache_hit";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["VOLATILE_ONLY_CACHE_HIT"] = "volatile_only_cache_hit";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["ADDRESS_UPDATE_WRITE"] = "address_update_write";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["NEPTUNE_FETCH"] = "neptune_fetch";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["NEPTUNE_WRITE_BACK"] = "neptune_write_back";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["NEPTUNE_SKIP_WRITE"] = "neptune_skip_write";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["NEPTUNE_RESOLUTION_FAILED"] = "neptune_resolution_failed";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["FALLBACK_INCOMING"] = "fallback_incoming";
+    IDENTITY_CACHE_WITH_CACHING_OUTCOME["FAILED"] = "failed";
+})(IDENTITY_CACHE_WITH_CACHING_OUTCOME = exports.IDENTITY_CACHE_WITH_CACHING_OUTCOME || (exports.IDENTITY_CACHE_WITH_CACHING_OUTCOME = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/services/db/identity-cache-dynamodb-service/types.ts"],"names":[],"mappings":";;;AAaA,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,mDAA6B,CAAA;IAC7B,yEAAmD,CAAA;IACnD,uDAAiC,CAAA;AACnC,CAAC,EALW,kBAAkB,GAAlB,0BAAkB,KAAlB,0BAAkB,QAK7B;AAYD,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC,gEAA+B,CAAA;IAC/B,0EAAyC,CAAA;IACzC,kGAAiE,CAAA;IACjE,wEAAuC,CAAA;IACvC,4EAA2C,CAAA;IAC3C,oFAAmD,CAAA;IACnD,0EAAyC,CAAA;IACzC,kDAAiB,CAAA;AACnB,CAAC,EATW,6BAA6B,GAA7B,qCAA6B,KAA7B,qCAA6B,QASxC;AAyED,IAAY,mCAWX;AAXD,WAAY,mCAAmC;IAC7C,sEAA+B,CAAA;IAC/B,0EAAmC,CAAA;IACnC,0FAAmD,CAAA;IACnD,oFAA6C,CAAA;IAC7C,sEAA+B,CAAA;IAC/B,gFAAyC,CAAA;IACzC,gFAAyC,CAAA;IACzC,8FAAuD,CAAA;IACvD,8EAAuC,CAAA;IACvC,wDAAiB,CAAA;AACnB,CAAC,EAXW,mCAAmC,GAAnC,2CAAmC,KAAnC,2CAAmC,QAW9C"}

package/dist/cjs/services/db/index.d.ts

@@ -8,7 +8,10 @@ export * from './tracking-events-db-service.js';
 export * from './shopify-products-cache-db-service.js';
 export * from './shopify-app-installs-db-service.js';
 export * from './identity-cache-db-service.js';
-export * from './identity-cache-dynamodb-service.js';
+export * from './identity-cache-dynamodb-service/types.js';
+export * from './identity-cache-dynamodb-service/key-builders.js';
+export * from './identity-cache-dynamodb-service/identity-cache-dynamodb-db-service.js';
+export * from './identity-cache-dynamodb-service/identity-gateway-service.js';
 export * from './currency-exchange-rates-db-service.js';
 export * from './accounts-db-service.js';
 export * from './subscriptions-db-service.js';

package/dist/cjs/services/db/index.js

@@ -24,7 +24,10 @@ __exportStar(require("./tracking-events-db-service.js"), exports);
 __exportStar(require("./shopify-products-cache-db-service.js"), exports);
 __exportStar(require("./shopify-app-installs-db-service.js"), exports);
 __exportStar(require("./identity-cache-db-service.js"), exports);
-__exportStar(require("./identity-cache-dynamodb-service.js"), exports);
+__exportStar(require("./identity-cache-dynamodb-service/types.js"), exports);
+__exportStar(require("./identity-cache-dynamodb-service/key-builders.js"), exports);
+__exportStar(require("./identity-cache-dynamodb-service/identity-cache-dynamodb-db-service.js"), exports);
+__exportStar(require("./identity-cache-dynamodb-service/identity-gateway-service.js"), exports);
 __exportStar(require("./currency-exchange-rates-db-service.js"), exports);
 __exportStar(require("./accounts-db-service.js"), exports);
 __exportStar(require("./subscriptions-db-service.js"), exports);

package/dist/cjs/services/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,6DAA2C;AAC3C,yDAAuC;AACvC,uEAAqD;AACrD,gEAA8C;AAC9C,sEAAoD;AACpD,kEAAgD;AAChD,yEAAuD;AACvD,uEAAqD;AACrD,iEAA+C;AAC/C,uEAAqD;AACrD,0EAAwD;AACxD,2DAAyC;AACzC,gEAA8C;AAC9C,gEAA8C;AAC9C,2DAAyC;AACzC,kEAAgD;AAChD,2DAAyC;AACzC,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,6DAA2C;AAC3C,yDAAuC;AACvC,uEAAqD;AACrD,gEAA8C;AAC9C,sEAAoD;AACpD,kEAAgD;AAChD,yEAAuD;AACvD,uEAAqD;AACrD,iEAA+C;AAC/C,6EAA2D;AAC3D,oFAAkE;AAClE,0GAAwF;AACxF,gGAA8E;AAC9E,0EAAwD;AACxD,2DAAyC;AACzC,gEAA8C;AAC9C,gEAA8C;AAC9C,2DAAyC;AACzC,kEAAgD;AAChD,2DAAyC;AACzC,iEAA+C"}

package/dist/esm/__tests__/identity-cache/identity-cache-dynamodb-db-service-v2-comparison.spec.d.ts

@@ -0,0 +1 @@
+export {};