@tagadapay/headless-sdk 1.16.0 → 1.18.0

package/dist/tgd/contract/attribution.d.ts

@@ -0,0 +1,28 @@
+/** The 12 channels a merchant sees. Order = display order. */
+export declare const VISIBLE_CHANNELS: readonly ["direct", "organic_search", "paid_search", "organic_social", "paid_social", "email", "sms", "affiliate", "referral", "ai", "display", "other"];
+export type VisibleChannel = (typeof VISIBLE_CHANNELS)[number];
+/** Channels whose touches can carry ad spend and count as "paid" for the last-paid-touch shortcut. */
+export declare const PAID_CHANNELS: readonly VisibleChannel[];
+export declare const ATTRIBUTION_MODELS: readonly ["first_touch", "last_touch", "last_non_direct", "linear", "position_based", "time_decay"];
+export type AttributionModel = (typeof ATTRIBUTION_MODELS)[number];
+export declare const DEFAULT_ATTRIBUTION_MODEL: AttributionModel;
+/** Lookback values offered in the UI and accepted by `v3.analyticsV2Settings.set` for `lookback_days`. */
+export declare const ATTRIBUTION_LOOKBACK_DAYS: readonly [7, 14, 30, 90];
+export type AttributionLookbackDays = (typeof ATTRIBUTION_LOOKBACK_DAYS)[number];
+export declare const DEFAULT_ATTRIBUTION_LOOKBACK_DAYS: AttributionLookbackDays;
+/** The freeze stores touches of this many days before the conversion. Equals the largest lookback. */
+export declare const ATTRIBUTION_MAX_LOOKBACK_DAYS = 90;
+/** Keep at most this many touches per order: the first one plus the latest 49. */
+export declare const ATTRIBUTION_MAX_TOUCHES = 50;
+/** Keep at most this many resolved visitors per order. */
+export declare const ATTRIBUTION_MAX_VISITORS = 20;
+/** The attribution-rate bar (Hyros and Polar use 85 %; research/attribution-hyros.md:7,13). */
+export declare const ATTRIBUTION_RATE_BAR = 0.85;
+/**
+ * Ad-account providers: the values of av2_ad_spend.provider and of analytics_v2_destinations.provider
+ * when kind = 'ad_account'. Underscores only: the Postgres CHECK is ^[a-z0-9_]{1,40}$ (postgres-schema.md).
+ * destinations.md §2-§3 reads this constant from here.
+ */
+export declare const AD_SPEND_PROVIDERS: readonly ["meta", "google_ads", "tiktok"];
+export type AdSpendProvider = (typeof AD_SPEND_PROVIDERS)[number];
+//# sourceMappingURL=attribution.d.ts.map

package/dist/tgd/contract/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/attribution.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,0JAanB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,sGAAsG;AACtG,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAA8C,CAAC;AAElG,eAAO,MAAM,kBAAkB,qGAOrB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,eAAO,MAAM,yBAAyB,EAAE,gBAAoC,CAAC;AAE7E,0GAA0G;AAC1G,eAAO,MAAM,yBAAyB,0BAA2B,CAAC;AAClE,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjF,eAAO,MAAM,iCAAiC,EAAE,uBAA4B,CAAC;AAC7E,sGAAsG;AACtG,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,2CAA4C,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tgd/contract/attribution.js

@@ -0,0 +1,44 @@
+/** The 12 channels a merchant sees. Order = display order. */
+export const VISIBLE_CHANNELS = [
+    'direct',
+    'organic_search',
+    'paid_search',
+    'organic_social',
+    'paid_social',
+    'email',
+    'sms',
+    'affiliate',
+    'referral',
+    'ai',
+    'display',
+    'other',
+];
+/** Channels whose touches can carry ad spend and count as "paid" for the last-paid-touch shortcut. */
+export const PAID_CHANNELS = ['paid_search', 'paid_social', 'display'];
+export const ATTRIBUTION_MODELS = [
+    'first_touch',
+    'last_touch',
+    'last_non_direct',
+    'linear',
+    'position_based',
+    'time_decay',
+];
+export const DEFAULT_ATTRIBUTION_MODEL = 'last_non_direct';
+/** Lookback values offered in the UI and accepted by `v3.analyticsV2Settings.set` for `lookback_days`. */
+export const ATTRIBUTION_LOOKBACK_DAYS = [7, 14, 30, 90];
+export const DEFAULT_ATTRIBUTION_LOOKBACK_DAYS = 30;
+/** The freeze stores touches of this many days before the conversion. Equals the largest lookback. */
+export const ATTRIBUTION_MAX_LOOKBACK_DAYS = 90;
+/** Keep at most this many touches per order: the first one plus the latest 49. */
+export const ATTRIBUTION_MAX_TOUCHES = 50;
+/** Keep at most this many resolved visitors per order. */
+export const ATTRIBUTION_MAX_VISITORS = 20;
+/** The attribution-rate bar (Hyros and Polar use 85 %; research/attribution-hyros.md:7,13). */
+export const ATTRIBUTION_RATE_BAR = 0.85;
+/**
+ * Ad-account providers: the values of av2_ad_spend.provider and of analytics_v2_destinations.provider
+ * when kind = 'ad_account'. Underscores only: the Postgres CHECK is ^[a-z0-9_]{1,40}$ (postgres-schema.md).
+ * destinations.md §2-§3 reads this constant from here.
+ */
+export const AD_SPEND_PROVIDERS = ['meta', 'google_ads', 'tiktok'];
+//# sourceMappingURL=attribution.js.map

package/dist/tgd/contract/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../../src/tgd/contract/attribution.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,OAAO;IACP,KAAK;IACL,WAAW;IACX,UAAU;IACV,IAAI;IACJ,SAAS;IACT,OAAO;CACC,CAAC;AAGX,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAA8B,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,QAAQ;IACR,gBAAgB;IAChB,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAqB,iBAAiB,CAAC;AAE7E,0GAA0G;AAC1G,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AAElE,MAAM,CAAC,MAAM,iCAAiC,GAA4B,EAAE,CAAC;AAC7E,sGAAsG;AACtG,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAChD,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,+FAA+F;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC"}

package/dist/tgd/contract/browser-api.d.ts

@@ -0,0 +1,57 @@
+import type { JsonValue, TgdBrowserIds } from './envelope.js';
+import type { TargetingAttributes } from './experiments.js';
+import type { AssignResponse } from './wire.js';
+export interface TgdInitOptions {
+    storeId?: string;
+    /** Absolute origin of the API, e.g. 'https://api.tagada.io'. Overrides section 2.1. */
+    apiHost?: string;
+    /** Variants decided before load (node-sdk getBootstrap(), section 6.4). */
+    bootstrap?: TgdBootstrap;
+    /** Targeting attributes the merchant knows (custom.*). country/device are never read in the browser. */
+    attributes?: Pick<TargetingAttributes, 'custom'>;
+    debug?: boolean;
+    /** @internal headless-sdk only */ _source?: 'browser' | 'headless';
+    /** @internal headless-sdk only: no automatic page_view; page views come from page() */ _manualPages?: boolean;
+}
+export interface TgdBootstrap {
+    v: 1;
+    /** The node-sdk distinctId the variants were computed for. Exposures of bootstrap keys use unit_type 'external'. */
+    distinctId: string;
+    experiments: AssignResponse['experiments'];
+    flags: AssignResponse['flags'];
+}
+export interface TgdIds {
+    visitorId: string | null;
+    clientId: string | null;
+    sessionId: string;
+    pageViewId: string | null;
+    funnelSessionId: string | null;
+    externalId: string | null;
+    browser: TgdBrowserIds;
+}
+export interface TgdPublicApi {
+    init(options?: TgdInitOptions): void;
+    page(props?: Record<string, JsonValue>): void;
+    track(name: string, props?: Record<string, JsonValue>): void;
+    identify(externalId: string | null, traits?: {
+        email?: string;
+        phone?: string;
+        customerId?: string;
+        [k: string]: string | number | boolean | undefined;
+    }): void;
+    ids(): TgdIds;
+    getVariant(key: string): string | null;
+    getPayload(key: string): JsonValue | null;
+    onVariant(key: string, cb: (variant: string | null) => void): () => void;
+    isEnabled(flagKey: string): boolean;
+    ready(): Promise<void>;
+    /** @internal headless-sdk only */ _link(funnelSessionId: string): void;
+}
+/** Value of cookie tgd_xb = base64url(JSON.stringify(XbCookieV1)), no padding. */
+export interface XbCookieV1 {
+    v: 1;
+    u: string;
+    e: Record<string, [arm: string | null, expId: string, phase: number, inExperiment: 0 | 1, unitType: 'visitor' | 'external']>;
+    f: Record<string, [variant: string | null, flagId: string, enabled: 0 | 1]>;
+}
+//# sourceMappingURL=browser-api.d.ts.map

package/dist/tgd/contract/browser-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-api.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/browser-api.ts"],"names":[],"mappings":"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"}

package/dist/tgd/contract/browser-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-api.js.map

package/dist/tgd/contract/browser-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-api.js","sourceRoot":"","sources":["../../../src/tgd/contract/browser-api.ts"],"names":[],"mappings":""}

package/dist/tgd/contract/canvas.d.ts

@@ -0,0 +1,120 @@
+import type { ExperimentStatus, Goal, Guardrail, TargetingCondition } from './experiments.js';
+/** `node.metadata.canvasSplit`, `node.metadata.canvasPageTest`, `node.metadata.canvasPageVariantOf`,
+ *  `edge.metadata.splitArm`, `edge.metadata.pageVariantEdgeOf` (A11). The canvas compile is their only writer. */
+export declare const CANVAS_SPLIT_KEY: "canvasSplit";
+export declare const CANVAS_PAGE_TEST_KEY: "canvasPageTest";
+export declare const CANVAS_PAGE_VARIANT_OF_KEY: "canvasPageVariantOf";
+export declare const SPLIT_ARM_KEY: "splitArm";
+export declare const PAGE_VARIANT_EDGE_OF_KEY: "pageVariantEdgeOf";
+/** Arm keys the canvas mints, in order. The first one is always the control. */
+export declare const CANVAS_ARM_KEYS: readonly ["control", "b", "c", "d", "e"];
+export declare const ARM_KEY_PATTERN: RegExp;
+export declare const MAX_ARMS = 5;
+export interface CompiledExperimentCore {
+    experimentId: string;
+    status: ExperimentStatus;
+    phase: number;
+    seed: string;
+    controlArm: string;
+    shippedArm: string | null;
+    holdoutBp: number;
+    targeting: TargetingCondition[];
+    namespace: {
+        name: string;
+        startBp: number;
+        endBp: number;
+    } | null;
+    goals: Goal[];
+    guardrails: Guardrail[];
+    conversionWindowHours: number;
+}
+export interface CompiledSplitArm {
+    key: string;
+    label: string;
+    weightBp: number;
+}
+export interface CompiledSplitMeta extends CompiledExperimentCore {
+    arms: CompiledSplitArm[];
+}
+export interface CompiledPageTestArm {
+    key: string;
+    nodeId: string;
+    weightBp: number;
+}
+export interface CompiledPageTestMeta extends CompiledExperimentCore {
+    arms: CompiledPageTestArm[];
+}
+export interface CompiledPageVariantOf {
+    controlNodeId: string;
+    armKey: string;
+}
+/**
+ * The patch of `set { split }` and `set { pageTest }` (section 5.2). Same name as ab-engine.md §18.1.
+ * `phase` is an optional CHECK: the compile derives the phase (section 6.5) and refuses with `stale`
+ * when the caller's value differs. `arms` carries weights (both kinds) and labels (split only).
+ */
+export interface CanvasExperimentLifecyclePatch {
+    status?: Exclude<ExperimentStatus, 'draft'>;
+    phase?: number;
+    arms?: Array<{
+        key: string;
+        weightBp?: number;
+        label?: string;
+    }>;
+    shippedArm?: string | null;
+    holdoutBp?: number;
+    targeting?: TargetingCondition[];
+    namespace?: {
+        name: string;
+        startBp: number;
+        endBp: number;
+    } | null;
+    goals?: Goal[];
+    guardrails?: Guardrail[];
+    conversionWindowHours?: number;
+    name?: string;
+}
+/** Every command of this doc, in the input form (`experimentId` may be omitted: the server mints it). */
+export type CanvasExperimentCommand = {
+    type: 'add';
+    kind: 'split';
+    after?: {
+        node: string;
+        exit: string;
+    };
+    props: {
+        name: string;
+        experimentId?: string;
+    };
+} | {
+    type: 'add';
+    kind: 'page.checkout' | 'page.offer' | 'page.landing' | 'page.thankyou' | 'page.custom';
+    variantOf: {
+        node: string;
+        experimentId?: string;
+    };
+    props: {
+        name: string;
+        template?: string;
+        path?: string;
+    };
+} | {
+    type: 'set';
+    id: string;
+    target?: 'node';
+    patch: {
+        split: CanvasExperimentLifecyclePatch;
+    };
+} | {
+    type: 'set';
+    id: string;
+    target?: 'node';
+    patch: {
+        pageTest: CanvasExperimentLifecyclePatch;
+    };
+} | {
+    type: 'remove';
+    id: string;
+    target?: 'node';
+};
+//# sourceMappingURL=canvas.d.ts.map

package/dist/tgd/contract/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/canvas.ts"],"names":[],"mappings":"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"}

package/dist/tgd/contract/canvas.js

@@ -0,0 +1,12 @@
+/** `node.metadata.canvasSplit`, `node.metadata.canvasPageTest`, `node.metadata.canvasPageVariantOf`,
+ *  `edge.metadata.splitArm`, `edge.metadata.pageVariantEdgeOf` (A11). The canvas compile is their only writer. */
+export const CANVAS_SPLIT_KEY = 'canvasSplit';
+export const CANVAS_PAGE_TEST_KEY = 'canvasPageTest';
+export const CANVAS_PAGE_VARIANT_OF_KEY = 'canvasPageVariantOf';
+export const SPLIT_ARM_KEY = 'splitArm';
+export const PAGE_VARIANT_EDGE_OF_KEY = 'pageVariantEdgeOf';
+/** Arm keys the canvas mints, in order. The first one is always the control. */
+export const CANVAS_ARM_KEYS = ['control', 'b', 'c', 'd', 'e'];
+export const ARM_KEY_PATTERN = /^[a-z0-9_-]{1,32}$/;
+export const MAX_ARMS = 5;
+//# sourceMappingURL=canvas.js.map

package/dist/tgd/contract/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../src/tgd/contract/canvas.ts"],"names":[],"mappings":"AAGA;kHACkH;AAClH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAyB,CAAC;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAA8B,CAAC;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAA4B,CAAC;AAErE,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC"}

package/dist/tgd/contract/dedup-keys.d.ts

@@ -0,0 +1,24 @@
+import type { UnitType } from './unions.js';
+export declare const dkFsStarted: (fsid: string) => string;
+export declare const dkStepViewed: (fsid: string, stepId: string, tsMs: number) => string;
+export declare const dkStepEntered: (fsid: string, stepId: string, navMs: number) => string;
+export declare const dkCheckoutStarted: (csid: string) => string;
+export declare const dkCheckoutEmail: (csid: string, emailSha256: string) => string;
+export declare const dkAttempt: (paymentId: string) => string;
+export declare const dkOrder: (orderId: string) => string;
+export declare const dkSubCreated: (subscriptionId: string) => string;
+export declare const dkSubCanceled: (subscriptionId: string) => string;
+export declare const dkSubRebilled: (paymentId: string) => string;
+export declare const dkExposure: (expId: string, phase: number, unitType: UnitType, unitId: string) => string;
+export declare const dkExternal: (storeId: string, idempotencyKey: string) => string;
+export declare const dkLegacy: (appEventsRawId: string) => string;
+export declare const dkEmailSent: (m: string) => string;
+export declare const dkEmailDelivered: (m: string) => string;
+export declare const dkEmailBounced: (m: string) => string;
+export declare const dkEmailComplained: (m: string) => string;
+export declare const dkEmailOpened: (m: string, svixId: string) => string;
+export declare const dkEmailClicked: (m: string, linkIndex: number, tsMs: number) => string;
+export declare const dkEmailUnsubscribed: (m: string) => string;
+/** Conversion-key prefixes owned by conversions-ledger.md. Listed so no event key reuses them. */
+export declare const CONVERSION_KEY_PREFIXES: readonly ["payment:", "refund:", "chargeback:"];
+//# sourceMappingURL=dedup-keys.d.ts.map

package/dist/tgd/contract/dedup-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-keys.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/dedup-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,WAAyB,CAAC;AAClE,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,MAAM,MAAM,WAA+D,CAAC;AACvI,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,WAA8C,CAAC;AACxH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,WAA+B,CAAC;AAC9E,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,WAA4C,CAAC;AAC9G,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,WAA2B,CAAC;AACvE,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,WAAuB,CAAC;AAC/D,eAAO,MAAM,YAAY,GAAI,gBAAgB,MAAM,WAAoC,CAAC;AACxF,eAAO,MAAM,aAAa,GAAI,gBAAgB,MAAM,WAAqC,CAAC;AAC1F,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,WAAgC,CAAC;AAChF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,UAAU,QAAQ,EAAE,QAAQ,MAAM,WAAkD,CAAC;AAC9I,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,gBAAgB,MAAM,WAAuC,CAAC;AAC1G,eAAO,MAAM,QAAQ,GAAI,gBAAgB,MAAM,WAA+B,CAAC;AAC/E,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,WAAsB,CAAC;AAC5D,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,WAA2B,CAAC;AACtE,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,WAAyB,CAAC;AAClE,eAAO,MAAM,iBAAiB,GAAI,GAAG,MAAM,WAA4B,CAAC;AACxE,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,EAAE,QAAQ,MAAM,WAAkC,CAAC;AAC1F,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,WAAW,MAAM,EAAE,MAAM,MAAM,WAAiE,CAAC;AAC3I,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,WAA8B,CAAC;AAC5E,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,iDAAkD,CAAC"}

package/dist/tgd/contract/dedup-keys.js

@@ -0,0 +1,23 @@
+export const dkFsStarted = (fsid) => `fs_started:${fsid}`;
+export const dkStepViewed = (fsid, stepId, tsMs) => `step_viewed:${fsid}:${stepId}:${Math.floor(tsMs / 1000)}`;
+export const dkStepEntered = (fsid, stepId, navMs) => `step_entered:${fsid}:${stepId}:${navMs}`;
+export const dkCheckoutStarted = (csid) => `checkout_started:${csid}`;
+export const dkCheckoutEmail = (csid, emailSha256) => `checkout_email:${csid}:${emailSha256}`;
+export const dkAttempt = (paymentId) => `attempt:${paymentId}`;
+export const dkOrder = (orderId) => `order:${orderId}`;
+export const dkSubCreated = (subscriptionId) => `sub_created:${subscriptionId}`;
+export const dkSubCanceled = (subscriptionId) => `sub_canceled:${subscriptionId}`;
+export const dkSubRebilled = (paymentId) => `sub_rebilled:${paymentId}`;
+export const dkExposure = (expId, phase, unitType, unitId) => `exp:${expId}:${phase}:${unitType}:${unitId}`;
+export const dkExternal = (storeId, idempotencyKey) => `ext:${storeId}:${idempotencyKey}`;
+export const dkLegacy = (appEventsRawId) => `legacy:${appEventsRawId}`;
+export const dkEmailSent = (m) => `email_sent:${m}`;
+export const dkEmailDelivered = (m) => `email_delivered:${m}`;
+export const dkEmailBounced = (m) => `email_bounced:${m}`;
+export const dkEmailComplained = (m) => `email_complained:${m}`;
+export const dkEmailOpened = (m, svixId) => `email_opened:${m}:${svixId}`;
+export const dkEmailClicked = (m, linkIndex, tsMs) => `email_clicked:${m}:${linkIndex}:${Math.floor(tsMs / 1000)}`;
+export const dkEmailUnsubscribed = (m) => `email_unsubscribed:${m}`;
+/** Conversion-key prefixes owned by conversions-ledger.md. Listed so no event key reuses them. */
+export const CONVERSION_KEY_PREFIXES = ['payment:', 'refund:', 'chargeback:']; // (new name, this lane)
+//# sourceMappingURL=dedup-keys.js.map

package/dist/tgd/contract/dedup-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-keys.js","sourceRoot":"","sources":["../../../src/tgd/contract/dedup-keys.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,eAAe,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;AACvI,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa,EAAE,EAAE,CAAC,gBAAgB,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;AACxH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,oBAAoB,IAAI,EAAE,CAAC;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,EAAE,CAAC,kBAAkB,IAAI,IAAI,WAAW,EAAE,CAAC;AAC9G,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,WAAW,SAAS,EAAE,CAAC;AACvE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,cAAsB,EAAE,EAAE,CAAC,eAAe,cAAc,EAAE,CAAC;AACxF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,cAAsB,EAAE,EAAE,CAAC,gBAAgB,cAAc,EAAE,CAAC;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,gBAAgB,SAAS,EAAE,CAAC;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,QAAkB,EAAE,MAAc,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,KAAK,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;AAC9I,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,cAAsB,EAAE,EAAE,CAAC,OAAO,OAAO,IAAI,cAAc,EAAE,CAAC;AAC1G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,cAAsB,EAAE,EAAE,CAAC,UAAU,cAAc,EAAE,CAAC;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,MAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,MAAM,EAAE,CAAC;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,SAAiB,EAAE,IAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;AAC3I,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;AAC5E,kGAAkG;AAClG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,CAAU,CAAC,CAAG,wBAAwB"}

package/dist/tgd/contract/destination-names.d.ts

@@ -0,0 +1,4 @@
+import type { TgdEventV1 } from './envelope.js';
+export declare const DESTINATION_EVENT_NAMES: Readonly<Record<'meta' | 'ga4' | 'tiktok' | 'snap' | 'pinterest_tag' | 'pinterest_capi', Partial<Record<'page_view' | 'checkout_started' | 'checkout_email_entered' | 'order_completed' | 'subscription_created' | 'lead' | 'product_viewed' | 'added_to_cart', string>>>>;
+export declare function destinationDedupId(ev: TgdEventV1): string | null;
+//# sourceMappingURL=destination-names.d.ts.map

package/dist/tgd/contract/destination-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-names.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/destination-names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,GAAG,kBAAkB,GAAG,wBAAwB,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,MAAM,GAAG,gBAAgB,GAAG,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,CAsD9S,CAAC;AAGF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAQhE"}

package/dist/tgd/contract/destination-names.js

@@ -0,0 +1,66 @@
+export const DESTINATION_EVENT_NAMES = {
+    "meta": {
+        "page_view": "PageView",
+        "checkout_started": "InitiateCheckout",
+        "checkout_email_entered": "CheckoutEmailValidated",
+        "order_completed": "Purchase",
+        "subscription_created": "Subscribe",
+        "lead": "Lead",
+        "product_viewed": "ViewContent",
+        "added_to_cart": "AddToCart"
+    },
+    "ga4": {
+        "page_view": "page_view",
+        "checkout_started": "begin_checkout",
+        "order_completed": "purchase",
+        "lead": "generate_lead",
+        "product_viewed": "view_item",
+        "added_to_cart": "add_to_cart"
+    },
+    "tiktok": {
+        "page_view": "Pageview",
+        "checkout_started": "InitiateCheckout",
+        "order_completed": "Purchase",
+        "subscription_created": "Subscribe",
+        "lead": "SubmitForm",
+        "product_viewed": "ViewContent",
+        "added_to_cart": "AddToCart"
+    },
+    "snap": {
+        "page_view": "PAGE_VIEW",
+        "checkout_started": "START_CHECKOUT",
+        "order_completed": "PURCHASE",
+        "subscription_created": "SUBSCRIBE",
+        "lead": "LEAD",
+        "product_viewed": "VIEW_CONTENT",
+        "added_to_cart": "ADD_CART"
+    },
+    "pinterest_tag": {
+        "page_view": "pagevisit",
+        "checkout_started": "initiatecheckout",
+        "order_completed": "checkout",
+        "lead": "lead",
+        "product_viewed": "viewcontent",
+        "added_to_cart": "addtocart"
+    },
+    "pinterest_capi": {
+        "page_view": "page_visit",
+        "checkout_started": "initiate_checkout",
+        "order_completed": "checkout",
+        "subscription_created": "subscribe",
+        "lead": "lead",
+        "product_viewed": "view_content",
+        "added_to_cart": "add_to_cart"
+    }
+};
+const makeMetaEventId = (name, id) => `${name}_${id}`;
+export function destinationDedupId(ev) {
+    switch (ev.event_name) {
+        case 'checkout_started': return ev.checkout_session_id ? makeMetaEventId('InitiateCheckout', ev.checkout_session_id) : null;
+        case 'checkout_email_entered': return ev.checkout_session_id ? makeMetaEventId('CheckoutEmailValidated', ev.checkout_session_id) : null;
+        case 'order_completed': return ev.order_id ? makeMetaEventId('Purchase', ev.order_id) : null;
+        case 'subscription_created': return ev.subscription_id ? makeMetaEventId('Subscribe', ev.subscription_id) : null;
+        default: return null;
+    }
+}
+//# sourceMappingURL=destination-names.js.map

package/dist/tgd/contract/destination-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-names.js","sourceRoot":"","sources":["../../../src/tgd/contract/destination-names.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAA+Q;IACjT,MAAM,EAAE;QACN,WAAW,EAAE,UAAU;QACvB,kBAAkB,EAAE,kBAAkB;QACtC,wBAAwB,EAAE,wBAAwB;QAClD,iBAAiB,EAAE,UAAU;QAC7B,sBAAsB,EAAE,WAAW;QACnC,MAAM,EAAE,MAAM;QACd,gBAAgB,EAAE,aAAa;QAC/B,eAAe,EAAE,WAAW;KAC7B;IACD,KAAK,EAAE;QACL,WAAW,EAAE,WAAW;QACxB,kBAAkB,EAAE,gBAAgB;QACpC,iBAAiB,EAAE,UAAU;QAC7B,MAAM,EAAE,eAAe;QACvB,gBAAgB,EAAE,WAAW;QAC7B,eAAe,EAAE,aAAa;KAC/B;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,UAAU;QACvB,kBAAkB,EAAE,kBAAkB;QACtC,iBAAiB,EAAE,UAAU;QAC7B,sBAAsB,EAAE,WAAW;QACnC,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,aAAa;QAC/B,eAAe,EAAE,WAAW;KAC7B;IACD,MAAM,EAAE;QACN,WAAW,EAAE,WAAW;QACxB,kBAAkB,EAAE,gBAAgB;QACpC,iBAAiB,EAAE,UAAU;QAC7B,sBAAsB,EAAE,WAAW;QACnC,MAAM,EAAE,MAAM;QACd,gBAAgB,EAAE,cAAc;QAChC,eAAe,EAAE,UAAU;KAC5B;IACD,eAAe,EAAE;QACf,WAAW,EAAE,WAAW;QACxB,kBAAkB,EAAE,kBAAkB;QACtC,iBAAiB,EAAE,UAAU;QAC7B,MAAM,EAAE,MAAM;QACd,gBAAgB,EAAE,aAAa;QAC/B,eAAe,EAAE,WAAW;KAC7B;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,YAAY;QACzB,kBAAkB,EAAE,mBAAmB;QACvC,iBAAiB,EAAE,UAAU;QAC7B,sBAAsB,EAAE,WAAW;QACnC,MAAM,EAAE,MAAM;QACd,gBAAgB,EAAE,cAAc;QAChC,eAAe,EAAE,aAAa;KAC/B;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;AACtE,MAAM,UAAU,kBAAkB,CAAC,EAAc;IAC/C,QAAQ,EAAE,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,kBAAkB,CAAC,CAAC,OAAO,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC,kBAAkB,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5H,KAAK,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC,wBAAwB,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxI,KAAK,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,KAAK,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjH,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/tgd/contract/destinations.d.ts

@@ -0,0 +1,124 @@
+export declare const DESTINATION_ADAPTER_IDS: readonly ["meta", "klaviyo", "triplewhale", "hyros", "awin", "converge", "clickflare", "voluum", "binom", "redtrack", "clickmagick", "tiktok", "snap", "pinterest", "reddit", "x", "google_ads", "ga4", "microsoft_ads", "linkedin"];
+export type DestinationAdapterId = (typeof DESTINATION_ADAPTER_IDS)[number];
+/** Values of analytics_v2_destinations.provider when kind = 'ad_account', and of av2_ad_spend.provider (A36, §18).
+ *  Underscore, never '-': analytics_v2_destinations has CHECK provider ~ '^[a-z0-9_]{1,40}$' (postgres-schema.md §3).
+ *  Declared once, in attribution.ts (attribution.md §2.2: AD_SPEND_PROVIDERS = ['meta', 'google_ads', 'tiktok']);
+ *  this file re-exports it under the name this doc uses (P1-L1 kernel decision K2). Test: same array reference. */
+export { AD_SPEND_PROVIDERS as AD_ACCOUNT_PROVIDERS } from './attribution.js';
+export type { AdSpendProvider as AdAccountProvider } from './attribution.js';
+export declare const DESTINATION_TOPICS: readonly ["order/paid", "order/refunded", "checkout/initiated", "checkout/emailValidated", "checkout/abandonedCart", "subscription/created", "subscription/canceled", "subscription/pastDue", "subscription/paused", "subscription/resumed", "subscription/rebillUpcoming", "subscription/rebillSucceeded", "club/membershipActivated"];
+export type DestinationTopic = (typeof DESTINATION_TOPICS)[number];
+/** A zod 3 schema satisfies this. tgd-core never imports zod (A26). */
+export interface ConfigParser<Cfg> {
+    parse(input: unknown): Cfg;
+}
+/** What `configSchema.parse` receives. Kind 'integration': integrations.credentials / .settings.
+ *  Kind 'destination': getDestinationCredentials() / analytics_v2_destinations.config / .provider_account_id. */
+export interface DestinationConfigSource {
+    readonly credentials: Readonly<Record<string, unknown>>;
+    readonly settings: Readonly<Record<string, unknown>>;
+    readonly providerAccountId: string | null;
+}
+/** One HTTP call. It never contains a secret: secrets are added by `authorize` after logging (§8.3). */
+export interface DestinationRequest {
+    readonly method: 'GET' | 'POST';
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    readonly eventName: string;
+}
+export declare const SKIP_REASONS: readonly ["not_found", "no_customer", "no_identifier", "no_click_id", "cart_not_priced", "event_disabled", "returning_customer", "order_open", "no_amount", "not_configured", "invalid_config", "already_sent", "unsupported_topic"];
+export type SkipReason = (typeof SKIP_REASONS)[number];
+export type MapResult = {
+    readonly kind: 'send';
+    readonly requests: readonly DestinationRequest[];
+} | {
+    readonly kind: 'skip';
+    readonly reason: SkipReason;
+};
+export interface ProviderResponse {
+    readonly kind: 'response';
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: unknown;
+}
+export interface NetworkFailure {
+    readonly kind: 'network';
+    readonly code: string;
+    readonly message: string;
+}
+export type Verdict = {
+    readonly kind: 'success';
+    readonly providerRequestId?: string;
+} | {
+    readonly kind: 'retry';
+    readonly reason: 'throttled' | 'server' | 'network' | 'timeout';
+    readonly retryAfterMs?: number;
+    readonly message?: string;
+} | {
+    readonly kind: 'abort';
+    readonly reason: 'auth' | 'payload' | 'too_old' | 'not_found' | 'unknown_4xx';
+    readonly message?: string;
+};
+export interface AuthPatch {
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly query?: Readonly<Record<string, string>>;
+}
+export type ValidationStatus = 'validated' | 'skipped:no-test-key' | 'invalid';
+export interface ValidationResult {
+    readonly status: ValidationStatus;
+    readonly reason?: string;
+}
+export type FetchLike = (url: string, init: {
+    method: 'GET' | 'POST';
+    headers: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}>;
+export interface MapContext {
+    readonly mode: 'shadow' | 'live';
+    readonly attempt: number;
+    readonly nowMs: number;
+}
+export interface DestinationAdapter<Cfg = unknown, In = unknown> {
+    readonly id: DestinationAdapterId;
+    readonly kind: 'integration' | 'destination';
+    readonly integrationProvider: string | null;
+    readonly integrationType: string | null;
+    readonly logService: string | null;
+    readonly topics: readonly DestinationTopic[];
+    readonly configSchema: ConfigParser<Cfg>;
+    /** Pure and synchronous. No I/O, no Date.now(), no Math.random(). */
+    map(input: In, config: Cfg, ctx: MapContext): MapResult;
+    /** Adds secrets at send time (tokens, api keys, OAuth access token). Called only in live mode and by validate. */
+    authorize?(config: Cfg, fetchImpl: FetchLike): Promise<AuthPatch>;
+    /** Owns all provider knowledge about responses. Never throws. */
+    classify(result: ProviderResponse | NetworkFailure, request: DestinationRequest): Verdict;
+    /** A35: calls the provider's test/validation endpoint with `sample`. Never touches production data of the merchant. */
+    validate(sample: In, config: Cfg, fetchImpl: FetchLike): Promise<ValidationResult>;
+    readonly batch: {
+        readonly maxItems: 1;
+    };
+    readonly verified: 'replay' | 'validated' | 'unverified';
+    readonly maxEventAgeSec: number;
+    readonly timeoutMs: number;
+}
+export declare const DISPATCH_EVENT_NAME: "analytics-v2/destinations.dispatch";
+export declare function destinationIdempotencyKey(p: {
+    provider: DestinationAdapterId;
+    targetId: string;
+    topic: DestinationTopic;
+    entityKey: string;
+}): string;
+/** §6.3. Returns null when the topic data lacks the id the key needs (the observer then skips). */
+export declare function destinationEntityKey(topic: DestinationTopic, data: Readonly<Record<string, unknown>>, event: {
+    readonly id: string;
+    readonly timestamp: string;
+}): string | null;
+//# sourceMappingURL=destinations.d.ts.map

package/dist/tgd/contract/destinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/destinations.ts"],"names":[],"mappings":"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"}