@tagadapay/headless-sdk 1.14.1 → 1.17.0

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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"}

package/dist/tgd/contract/destinations.js

@@ -0,0 +1,63 @@
+// packages/tgd-core/src/contract/destinations.ts  (new — P1-L1 kernel)
+export const DESTINATION_ADAPTER_IDS = [
+    'meta', 'klaviyo', 'triplewhale', 'hyros', 'awin', 'converge',
+    'clickflare', 'voluum', 'binom', 'redtrack', 'clickmagick',
+    'tiktok', 'snap', 'pinterest', 'reddit', 'x',
+    'google_ads', 'ga4', 'microsoft_ads', 'linkedin',
+];
+/** 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 const DESTINATION_TOPICS = [
+    '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 const SKIP_REASONS = [
+    'not_found', // entity row missing
+    'no_customer', // entity has no customer
+    'no_identifier', // nothing the provider can match on (no email/phone/click id/ip+ua)
+    'no_click_id', // click-id-only provider (Awin, postbacks) and none found
+    'cart_not_priced', // checkout/initiated before the cart is priced (§6.3)
+    'event_disabled', // merchant config turns this event off (TW allowedEvents, v2 destination settings.events, Meta sendSubscribe=false)
+    'returning_customer', // newCustomersOnly / publishPurchaseIfNewCustomerOnly
+    'order_open', // TW: order.status = 'open'
+    'no_amount', // missing paid amount or currency
+    'not_configured', // optional event with no conversion id configured (X, LinkedIn)
+    'invalid_config', // configSchema.parse threw on the stored credentials/settings
+    'already_sent', // live send-guard found an 'ok' row with the same idempotency key (§6.5)
+    'unsupported_topic', // adapter does not map this topic (defensive; the observer should not send it)
+];
+export const DISPATCH_EVENT_NAME = 'analytics-v2/destinations.dispatch';
+export function destinationIdempotencyKey(p) {
+    return `${p.provider}:${p.targetId}:${p.topic}:${p.entityKey}`; // A25, verbatim
+}
+/** §6.3. Returns null when the topic data lacks the id the key needs (the observer then skips). */
+export function destinationEntityKey(topic, data, event) {
+    const id = (key) => typeof data[key] === 'string' && data[key] !== '' ? data[key] : null;
+    if (topic === 'club/membershipActivated') {
+        const club = id('clubId'), customer = id('customerId');
+        return club && customer ? `${club}:${customer}` : null;
+    }
+    const entity = id(topic.startsWith('order/') ? 'orderId' : topic.startsWith('checkout/') ? 'checkoutSessionId' : 'subscriptionId');
+    if (!entity)
+        return null;
+    switch (topic) {
+        case 'order/refunded':
+        case 'checkout/initiated':
+        case 'subscription/pastDue':
+        case 'subscription/paused':
+        case 'subscription/resumed':
+            return `${entity}:${event.id}`;
+        case 'subscription/rebillUpcoming':
+        case 'subscription/rebillSucceeded':
+            return `${entity}:${new Date(event.timestamp).toISOString().slice(0, 10)}`;
+        default: return entity;
+    }
+}
+//# sourceMappingURL=destinations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.js","sourceRoot":"","sources":["../../../src/tgd/contract/destinations.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU;IAC7D,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa;IAC1D,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG;IAC5C,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU;CACxC,CAAC;AAGX;;;mHAGmH;AACnH,OAAO,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,gBAAgB;IAC9B,oBAAoB,EAAE,yBAAyB,EAAE,wBAAwB;IACzE,sBAAsB,EAAE,uBAAuB,EAAE,sBAAsB;IACvE,qBAAqB,EAAE,sBAAsB;IAC7C,6BAA6B,EAAE,8BAA8B;IAC7D,0BAA0B;CAClB,CAAC;AA0BX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAe,qBAAqB;IAC/C,aAAa,EAAa,yBAAyB;IACnD,eAAe,EAAW,oEAAoE;IAC9F,aAAa,EAAa,0DAA0D;IACpF,iBAAiB,EAAS,sDAAsD;IAChF,gBAAgB,EAAU,oHAAoH;IAC9I,oBAAoB,EAAM,sDAAsD;IAChF,YAAY,EAAc,4BAA4B;IACtD,WAAW,EAAe,kCAAkC;IAC5D,gBAAgB,EAAU,gEAAgE;IAC1F,gBAAgB,EAAU,8DAA8D;IACxF,cAAc,EAAY,yEAAyE;IACnG,mBAAmB,EAAO,+EAA+E;CACjG,CAAC;AAyDX,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAA6C,CAAC;AAEjF,MAAM,UAAU,yBAAyB,CAAC,CAEzC;IACC,OAAO,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAG,gBAAgB;AACpF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,oBAAoB,CAClC,KAAuB,EACvB,IAAuC,EACvC,KAA0D;IAE1D,MAAM,EAAE,GAAG,CAAC,GAAW,EAAiB,EAAE,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1H,IAAI,KAAK,KAAK,0BAA0B,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QACvD,OAAO,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACnI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,gBAAgB,CAAC;QAAC,KAAK,oBAAoB,CAAC;QAAC,KAAK,sBAAsB,CAAC;QAAC,KAAK,qBAAqB,CAAC;QAAC,KAAK,sBAAsB;YACpI,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACjC,KAAK,6BAA6B,CAAC;QAAC,KAAK,8BAA8B;YACrE,OAAO,GAAG,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7E,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC;IACzB,CAAC;AACH,CAAC"}