@tagadapay/headless-sdk 1.14.1 → 1.17.0

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

@@ -0,0 +1,203 @@
+import type { Source, IdKind, SessionOrigin, EventClass, SdkName, TrafficClass, BotCategory, UnitType } from './unions.js';
+import type { EventName } from './registry.js';
+export type JsonScalar = string | number | boolean | null;
+/** props values: scalars, arrays of scalars, or one level of nested objects of scalars. Depth ≤ 3. */
+export type JsonValue = JsonScalar | JsonScalar[] | {
+    [k: string]: JsonScalar | JsonScalar[] | {
+        [k: string]: JsonScalar;
+    };
+};
+/** Browser ids and click ids read at send time (A33). Every key optional, every value a string ≤ 512 chars. */
+export interface TgdBrowserIds {
+    fbp?: string;
+    fbc?: string;
+    fbclid?: string;
+    ttp?: string;
+    ttclid?: string;
+    scid?: string;
+    sccid?: string;
+    ga_client_id?: string;
+    gcl_aw?: string;
+    gclid?: string;
+    gbraid?: string;
+    wbraid?: string;
+    epik?: string;
+    rdt_uuid?: string;
+    rdt_cid?: string;
+    msclkid?: string;
+    li_fat_id?: string;
+    twclid?: string;
+}
+/**
+ * One event. The same type is used on the wire (client -> collector), by emitFact (server facts)
+ * and in golden fixtures. Fields marked "server-set" are deleted by the collector from client input
+ * (SERVER_SET_FIELDS) and filled by the writer.
+ */
+export interface TgdEventV1 {
+    event_id: string;
+    event_name: EventName;
+    class?: EventClass;
+    custom_name?: string;
+    source: Source;
+    created_at: number;
+    store_id: string;
+    account_id?: string;
+    visitor_id?: string;
+    id_kind?: IdKind;
+    session_id: string;
+    session_origin?: SessionOrigin;
+    page_view_id?: string;
+    funnel_session_id?: string;
+    customer_id?: string;
+    external_id?: string;
+    funnel_id?: string;
+    step_id?: string;
+    step_type?: string;
+    url?: string;
+    title?: string;
+    referrer?: string;
+    screen_width?: number;
+    screen_height?: number;
+    language?: string;
+    checkout_session_id?: string;
+    order_id?: string;
+    payment_id?: string;
+    subscription_id?: string;
+    value_minor?: number;
+    currency?: string;
+    exp_id?: string;
+    exp_phase?: number;
+    arm?: string;
+    unit_type?: UnitType;
+    unit_id?: string;
+    exp_forced?: 0 | 1;
+    props?: Record<string, JsonValue>;
+    sdk_name?: SdkName;
+    sdk_version?: string;
+    sent_at?: number;
+    received_at?: number;
+    ts?: number;
+    is_late?: 0 | 1;
+    is_test?: 0 | 1;
+    hostname?: string;
+    path?: string;
+    referrer_domain?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_term?: string;
+    gad_source?: string;
+    click_ids?: Record<string, string>;
+    channel?: string;
+    user_agent?: string;
+    browser?: string;
+    browser_version?: string;
+    os?: string;
+    os_version?: string;
+    device?: 'desktop' | 'mobile' | 'tablet' | '';
+    in_app?: string;
+    country?: string;
+    region?: string;
+    city?: string;
+    ip_hash?: string;
+    traffic_class?: TrafficClass;
+    bot_category?: BotCategory;
+    batch_id?: string;
+}
+/** Keys the collector deletes from every client event before enrichment. */
+export declare const SERVER_SET_FIELDS: readonly ["class", "account_id", "visitor_id", "id_kind", "session_origin", "customer_id", "step_type", "checkout_session_id", "order_id", "payment_id", "subscription_id", "value_minor", "currency", "unit_id", "exp_forced", "sdk_name", "sdk_version", "sent_at", "received_at", "ts", "is_late", "is_test", "hostname", "path", "referrer_domain", "utm_source", "utm_medium", "utm_campaign", "utm_content", "utm_term", "gad_source", "click_ids", "channel", "user_agent", "browser", "browser_version", "os", "os_version", "device", "in_app", "country", "region", "city", "ip_hash", "traffic_class", "bot_category", "batch_id"];
+/** One batch on the wire. Immutable once built: a retry changes sent_at only. */
+export interface TgdBatchV1 {
+    v: 1;
+    batch_id: string;
+    sent_at: number;
+    store_id: string;
+    sdk: {
+        name: 'tgd' | 'headless' | 'node' | 'loadgen';
+        version: string;
+    };
+    vid?: string;
+    cid?: string;
+    events: TgdEventV1[];
+}
+/** The insert row of av2_events. Every key is a column, in the column order of clickhouse-ddl.md §4.1 (70 keys). Built by toEventRow(). */
+export interface Av2EventRow {
+    account_id: string;
+    store_id: string;
+    event_id: string;
+    batch_id: string;
+    event_name: string;
+    event_class: EventClass;
+    custom_name: string;
+    source: Source;
+    sdk_name: string;
+    sdk_version: string;
+    ts: string;
+    created_at: string;
+    sent_at: string;
+    received_at: string;
+    is_late: 0 | 1;
+    is_test: 0 | 1;
+    visitor_id: string;
+    id_kind: IdKind;
+    session_id: string;
+    session_origin: SessionOrigin;
+    page_view_id: string;
+    funnel_session_id: string;
+    customer_id: string;
+    external_id: string;
+    funnel_id: string;
+    step_id: string;
+    step_type: string;
+    url: string;
+    hostname: string;
+    path: string;
+    title: string;
+    referrer: string;
+    referrer_domain: string;
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_content: string;
+    utm_term: string;
+    gad_source: string;
+    click_ids: Record<string, string>;
+    channel: string;
+    user_agent: string;
+    browser: string;
+    browser_version: string;
+    os: string;
+    os_version: string;
+    device: string;
+    in_app: string;
+    screen_width: number;
+    screen_height: number;
+    language: string;
+    country: string;
+    region: string;
+    city: string;
+    ip_hash: string;
+    traffic_class: TrafficClass;
+    bot_category: BotCategory;
+    checkout_session_id: string;
+    order_id: string;
+    payment_id: string;
+    subscription_id: string;
+    value_minor: number;
+    currency: string;
+    exp_id: string;
+    exp_phase: number;
+    arm: string;
+    unit_type: UnitType | '';
+    unit_id: string;
+    exp_forced: 0 | 1;
+    props: string;
+}
+/** The 70 keys of Av2EventRow in declaration order (= the column order of clickhouse-ddl.md §4.1). toEventRow builds its object in this order. */
+export declare const AV2_EVENT_ROW_KEYS: readonly ["account_id", "store_id", "event_id", "batch_id", "event_name", "event_class", "custom_name", "source", "sdk_name", "sdk_version", "ts", "created_at", "sent_at", "received_at", "is_late", "is_test", "visitor_id", "id_kind", "session_id", "session_origin", "page_view_id", "funnel_session_id", "customer_id", "external_id", "funnel_id", "step_id", "step_type", "url", "hostname", "path", "title", "referrer", "referrer_domain", "utm_source", "utm_medium", "utm_campaign", "utm_content", "utm_term", "gad_source", "click_ids", "channel", "user_agent", "browser", "browser_version", "os", "os_version", "device", "in_app", "screen_width", "screen_height", "language", "country", "region", "city", "ip_hash", "traffic_class", "bot_category", "checkout_session_id", "order_id", "payment_id", "subscription_id", "value_minor", "currency", "exp_id", "exp_phase", "arm", "unit_type", "unit_id", "exp_forced", "props"];
+/** Pure mapping, no default guessing: absent optional -> '' / 0 / NIL_UUID / '{}' / {}. */
+export declare function toEventRow(ev: Required<Pick<TgdEventV1, 'account_id' | 'class' | 'sdk_name' | 'sdk_version' | 'sent_at' | 'received_at' | 'ts' | 'is_late' | 'is_test' | 'visitor_id' | 'id_kind' | 'session_origin' | 'batch_id' | 'traffic_class' | 'bot_category'>> & TgdEventV1): Av2EventRow;
+/** 'YYYY-MM-DD hh:mm:ss.SSS' UTC. Byte-identical to toClickHouseDateTime64 (src/lib/analytics-reports/scope.ts:14-16). */
+export declare function toChDateTime64(ms: number): string;
+//# sourceMappingURL=envelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EACxF,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC1D,sGAAsG;AACtG,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7H,+GAA+G;AAC/G,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAEzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAGlC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7E,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,+mBAQoB,CAAC;AAEnD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,CAAC,CAAC;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,2IAA2I;AAC3I,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IACjF,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IACrE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,aAAa,CAAC;IACvF,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAC1F,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IACtG,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IACpG,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAC7F,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAC/D,aAAa,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,WAAW,CAAC;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAC3F,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7G,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kJAAkJ;AAClJ,eAAO,MAAM,kBAAkB,y5BAUoB,CAAC;AAEpD,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EACrD,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,GAClG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,UAAU,GAAG,eAAe,GAAG,cAAc,CAAC,CAAC,GACzG,UAAU,GAAG,WAAW,CAyEzB;AAED,0HAA0H;AAC1H,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/tgd/contract/envelope.js

@@ -0,0 +1,103 @@
+import { NIL_UUID } from './limits.js';
+/** Keys the collector deletes from every client event before enrichment. */
+export const SERVER_SET_FIELDS = [
+    'class', 'account_id', 'visitor_id', 'id_kind', 'session_origin', 'customer_id', 'step_type',
+    'checkout_session_id', 'order_id', 'payment_id', 'subscription_id', 'value_minor', 'currency',
+    'unit_id', 'exp_forced', 'sdk_name', 'sdk_version', 'sent_at', 'received_at', 'ts', 'is_late',
+    'is_test', 'hostname', 'path', 'referrer_domain', 'utm_source', 'utm_medium', 'utm_campaign',
+    'utm_content', 'utm_term', 'gad_source', 'click_ids', 'channel', 'user_agent', 'browser',
+    'browser_version', 'os', 'os_version', 'device', 'in_app', 'country', 'region', 'city', 'ip_hash',
+    'traffic_class', 'bot_category', 'batch_id',
+];
+/** The 70 keys of Av2EventRow in declaration order (= the column order of clickhouse-ddl.md §4.1). toEventRow builds its object in this order. */
+export const AV2_EVENT_ROW_KEYS = [
+    'account_id', 'store_id', 'event_id', 'batch_id', 'event_name', 'event_class', 'custom_name', 'source',
+    'sdk_name', 'sdk_version', 'ts', 'created_at', 'sent_at', 'received_at', 'is_late', 'is_test',
+    'visitor_id', 'id_kind', 'session_id', 'session_origin', 'page_view_id', 'funnel_session_id', 'customer_id',
+    'external_id', 'funnel_id', 'step_id', 'step_type', 'url', 'hostname', 'path', 'title', 'referrer',
+    'referrer_domain', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term', 'gad_source',
+    'click_ids', 'channel', 'user_agent', 'browser', 'browser_version', 'os', 'os_version', 'device', 'in_app',
+    'screen_width', 'screen_height', 'language', 'country', 'region', 'city', 'ip_hash', 'traffic_class',
+    'bot_category', 'checkout_session_id', 'order_id', 'payment_id', 'subscription_id', 'value_minor', 'currency',
+    'exp_id', 'exp_phase', 'arm', 'unit_type', 'unit_id', 'exp_forced', 'props',
+];
+/** Pure mapping, no default guessing: absent optional -> '' / 0 / NIL_UUID / '{}' / {}. */
+export function toEventRow(ev) {
+    return {
+        account_id: ev.account_id,
+        store_id: ev.store_id,
+        event_id: ev.event_id,
+        batch_id: ev.batch_id,
+        event_name: ev.event_name,
+        event_class: ev.class,
+        custom_name: ev.custom_name ?? '',
+        source: ev.source,
+        sdk_name: ev.sdk_name,
+        sdk_version: ev.sdk_version,
+        ts: toChDateTime64(ev.ts),
+        created_at: toChDateTime64(ev.created_at),
+        sent_at: toChDateTime64(ev.sent_at),
+        received_at: toChDateTime64(ev.received_at),
+        is_late: ev.is_late,
+        is_test: ev.is_test,
+        visitor_id: ev.visitor_id,
+        id_kind: ev.id_kind,
+        session_id: ev.session_id ?? NIL_UUID,
+        session_origin: ev.session_origin,
+        page_view_id: ev.page_view_id ?? NIL_UUID,
+        funnel_session_id: ev.funnel_session_id ?? '',
+        customer_id: ev.customer_id ?? '',
+        external_id: ev.external_id ?? '',
+        funnel_id: ev.funnel_id ?? '',
+        step_id: ev.step_id ?? '',
+        step_type: ev.step_type ?? '',
+        url: ev.url ?? '',
+        hostname: ev.hostname ?? '',
+        path: ev.path ?? '',
+        title: ev.title ?? '',
+        referrer: ev.referrer ?? '',
+        referrer_domain: ev.referrer_domain ?? '$direct',
+        utm_source: ev.utm_source ?? '',
+        utm_medium: ev.utm_medium ?? '',
+        utm_campaign: ev.utm_campaign ?? '',
+        utm_content: ev.utm_content ?? '',
+        utm_term: ev.utm_term ?? '',
+        gad_source: ev.gad_source ?? '',
+        click_ids: ev.click_ids ?? {},
+        channel: ev.channel ?? '',
+        user_agent: ev.user_agent ?? '',
+        browser: ev.browser ?? '',
+        browser_version: ev.browser_version ?? '',
+        os: ev.os ?? '',
+        os_version: ev.os_version ?? '',
+        device: ev.device ?? '',
+        in_app: ev.in_app ?? '',
+        screen_width: ev.screen_width ?? 0,
+        screen_height: ev.screen_height ?? 0,
+        language: ev.language ?? '',
+        country: ev.country ?? '',
+        region: ev.region ?? '',
+        city: ev.city ?? '',
+        ip_hash: ev.ip_hash ?? '',
+        traffic_class: ev.traffic_class,
+        bot_category: ev.bot_category,
+        checkout_session_id: ev.checkout_session_id ?? '',
+        order_id: ev.order_id ?? '',
+        payment_id: ev.payment_id ?? '',
+        subscription_id: ev.subscription_id ?? '',
+        value_minor: ev.value_minor ?? 0,
+        currency: ev.currency ?? '',
+        exp_id: ev.exp_id ?? '',
+        exp_phase: ev.exp_phase ?? 0,
+        arm: ev.arm ?? '',
+        unit_type: ev.unit_type ?? '',
+        unit_id: ev.unit_id ?? '',
+        exp_forced: ev.exp_forced ?? 0,
+        props: JSON.stringify(ev.props ?? {}),
+    };
+}
+/** 'YYYY-MM-DD hh:mm:ss.SSS' UTC. Byte-identical to toClickHouseDateTime64 (src/lib/analytics-reports/scope.ts:14-16). */
+export function toChDateTime64(ms) {
+    return new Date(ms).toISOString().slice(0, 23).replace('T', ' ');
+}
+//# sourceMappingURL=envelope.js.map

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

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

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

@@ -0,0 +1,87 @@
+import type { JsonValue } from './envelope.js';
+export type AssignReason = 'assigned' | 'not_running' | 'shipped' | 'no_unit' | 'invalid_config' | 'targeting_miss' | 'namespace_miss' | 'holdout';
+export type AssignResult = {
+    inExperiment: true;
+    arm: string;
+    armIndex: number;
+    reason: 'assigned';
+} | {
+    inExperiment: false;
+    arm: string | null;
+    reason: Exclude<AssignReason, 'assigned'>;
+};
+export type TargetingAttribute = 'country' | 'device' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'utm_content' | 'utm_term' | 'url' | 'path' | 'property';
+export type TargetingOperator = 'eq' | 'neq' | 'in' | 'nin' | 'contains' | 'regex';
+export interface TargetingCondition {
+    attribute: TargetingAttribute;
+    property: string | null;
+    operator: TargetingOperator;
+    value: string | number | boolean | string[];
+}
+export interface TargetingAttributes {
+    country?: string;
+    device?: 'desktop' | 'mobile' | 'tablet';
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_term?: string;
+    url?: string;
+    path?: string;
+    custom?: Record<string, string | number | boolean>;
+}
+export type Goal = {
+    kind: 'paid_order';
+} | {
+    kind: 'next_step_reached';
+} | {
+    kind: 'step_reached';
+    stepId: string;
+} | {
+    kind: 'revenue';
+} | {
+    kind: 'upsell_accepted';
+} | {
+    kind: 'event_count';
+    eventName: string;
+    measure: 'count' | 'conversion';
+    propertyFilter: {
+        property: string;
+        operator: 'is' | 'is_not' | 'contains' | 'not_contains';
+        value: string;
+    } | null;
+} | {
+    kind: 'event_value_sum';
+    eventName: string;
+    property: string;
+};
+export type Guardrail = 'payment_failure_rate' | 'refund_rate' | 'dispute_rate' | 'bounce_rate' | 'complaint_rate' | 'unsubscribe_rate';
+export type ExperimentKind = 'sdk' | 'split' | 'page_test' | 'email';
+export type ExperimentStatus = 'draft' | 'running' | 'paused' | 'stopped' | 'shipped';
+export interface ExperimentArm {
+    key: string;
+    label: string;
+    weightBp: number;
+    nodeId: string | null;
+    payload: JsonValue | null;
+}
+export interface AssignableExperiment {
+    id: string;
+    seed: string;
+    status: ExperimentStatus;
+    phase: number;
+    controlArm: string;
+    shippedArm: string | null;
+    arms: {
+        key: string;
+        weightBp: number;
+    }[];
+    holdoutBp: number;
+    targeting: TargetingCondition[];
+    namespace: {
+        name: string;
+        startBp: number;
+        endBp: number;
+    } | null;
+}
+//# sourceMappingURL=experiments.d.ts.map

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

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

package/dist/tgd/contract/experiments.js

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

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

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

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

@@ -0,0 +1,20 @@
+export * from './unions.js';
+export * from './limits.js';
+export * from './envelope.js';
+export * from './registry.js';
+export * from './time.js';
+export * from './dedup-keys.js';
+export * from './signed-ids.js';
+export * from './names.js';
+export * from './destination-names.js';
+export * from './is-test.js';
+export * from './junk-ids.js';
+export * from './unit.js';
+export * from './experiments.js';
+export * from './canvas.js';
+export * from './snapshots.js';
+export * from './wire.js';
+export * from './browser-api.js';
+export * from './destinations.js';
+export * from './attribution.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/tgd/contract/index.js

@@ -0,0 +1,20 @@
+export * from './unions.js';
+export * from './limits.js';
+export * from './envelope.js';
+export * from './registry.js';
+export * from './time.js';
+export * from './dedup-keys.js';
+export * from './signed-ids.js';
+export * from './names.js';
+export * from './destination-names.js';
+export * from './is-test.js';
+export * from './junk-ids.js';
+export * from './unit.js';
+export * from './experiments.js';
+export * from './canvas.js';
+export * from './snapshots.js';
+export * from './wire.js';
+export * from './browser-api.js';
+export * from './destinations.js';
+export * from './attribution.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tgd/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/tgd/contract/is-test.d.ts

@@ -0,0 +1,2 @@
+export declare const KNOWN_TEST_STORES: readonly ["store_0adebb0034a7"];
+//# sourceMappingURL=is-test.d.ts.map

package/dist/tgd/contract/is-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-test.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/is-test.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,iCAAkC,CAAC"}

package/dist/tgd/contract/is-test.js

@@ -0,0 +1,3 @@
+// packages/tgd-core/src/contract/is-test.ts
+export const KNOWN_TEST_STORES = ['store_0adebb0034a7'];
+//# sourceMappingURL=is-test.js.map

package/dist/tgd/contract/is-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-test.js","sourceRoot":"","sources":["../../../src/tgd/contract/is-test.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,oBAAoB,CAAU,CAAC"}

package/dist/tgd/contract/junk-ids.d.ts

@@ -0,0 +1,4 @@
+export declare const JUNK_IDS: readonly ["", "null", "undefined", "guest", "anonymous", "anon_placeholder"];
+/** true for '', whitespace, and any JUNK_IDS value after trim + lowercase. */
+export declare function isJunkId(v: string | null | undefined): boolean;
+//# sourceMappingURL=junk-ids.d.ts.map

package/dist/tgd/contract/junk-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"junk-ids.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/junk-ids.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,QAAQ,8EAA+E,CAAC;AACrG,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE9D"}

package/dist/tgd/contract/junk-ids.js

@@ -0,0 +1,7 @@
+// packages/tgd-core/src/contract/junk-ids.ts  (new — P1-L1 kernel)
+export const JUNK_IDS = ['', 'null', 'undefined', 'guest', 'anonymous', 'anon_placeholder'];
+/** true for '', whitespace, and any JUNK_IDS value after trim + lowercase. */
+export function isJunkId(v) {
+    return v == null || JUNK_IDS.includes(v.trim().toLowerCase());
+}
+//# sourceMappingURL=junk-ids.js.map

package/dist/tgd/contract/junk-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"junk-ids.js","sourceRoot":"","sources":["../../../src/tgd/contract/junk-ids.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,CAAU,CAAC;AACrG,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,CAA4B;IACnD,OAAO,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAW,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,19 @@
+export declare const CONTRACT_VERSION: 1;
+export declare const COLLECT_PATH: "/api/public/v2/e";
+export declare const MAX_BATCH_EVENTS = 50;
+export declare const MAX_CLIENT_BATCH_BYTES: number;
+export declare const MAX_SERVER_BODY_BYTES: number;
+export declare const MAX_PROPS_BYTES = 8192;
+export declare const MAX_PROPS_KEYS = 64;
+export declare const MAX_PROP_KEY_CHARS = 64;
+export declare const MAX_PROP_STRING_CHARS = 1024;
+export declare const MAX_URL_CHARS = 2048;
+export declare const MAX_TITLE_CHARS = 512;
+export declare const MAX_CUSTOM_NAME_CHARS = 120;
+export declare const MAX_EXTERNAL_ID_CHARS = 200;
+export declare const MAX_ID_VALUE_CHARS = 512;
+export declare const LATE_AFTER_MS: number;
+export declare const SKEW_DEADBAND_MS = 5000;
+export declare const FUTURE_ID_TOLERANCE_MS = 60000;
+export declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+//# sourceMappingURL=limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/limits.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,eAAO,MAAM,YAAY,EAAG,kBAA2B,CAAC;AACxD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAChD,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAC/C,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,aAAa,QAAmB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,QAAQ,yCAAyC,CAAC"}

package/dist/tgd/contract/limits.js

@@ -0,0 +1,20 @@
+// packages/tgd-core/src/contract/limits.ts
+export const CONTRACT_VERSION = 1;
+export const COLLECT_PATH = '/api/public/v2/e';
+export const MAX_BATCH_EVENTS = 50;
+export const MAX_CLIENT_BATCH_BYTES = 48 * 1024; // tgd.js splits a batch before it reaches this size
+export const MAX_SERVER_BODY_BYTES = 64 * 1024; // collector answers 413 above this, before JSON.parse
+export const MAX_PROPS_BYTES = 8192; // JSON.stringify(props) in UTF-8 bytes
+export const MAX_PROPS_KEYS = 64; // top-level keys
+export const MAX_PROP_KEY_CHARS = 64;
+export const MAX_PROP_STRING_CHARS = 1024;
+export const MAX_URL_CHARS = 2048;
+export const MAX_TITLE_CHARS = 512;
+export const MAX_CUSTOM_NAME_CHARS = 120;
+export const MAX_EXTERNAL_ID_CHARS = 200;
+export const MAX_ID_VALUE_CHARS = 512; // each TgdBrowserIds value
+export const LATE_AFTER_MS = 72 * 3600 * 1000;
+export const SKEW_DEADBAND_MS = 5000;
+export const FUTURE_ID_TOLERANCE_MS = 60000; // a UUIDv7 id may be at most 60 s in the future
+export const NIL_UUID = '00000000-0000-0000-0000-000000000000';
+//# sourceMappingURL=limits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/tgd/contract/limits.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,kBAA2B,CAAC;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAG,oDAAoD;AACvG,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAI,sDAAsD;AACzG,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,CAAe,uCAAuC;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC,CAAkB,iBAAiB;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC,CAAa,2BAA2B;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAM,CAAC,CAAM,gDAAgD;AACnG,MAAM,CAAC,MAAM,QAAQ,GAAG,sCAAsC,CAAC"}

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

@@ -0,0 +1,13 @@
+export declare const COOKIE_VID = "tgd_vid";
+export declare const COOKIE_VID_REFRESH = "tgd_vr";
+export declare const COOKIE_SDK_BOOTSTRAP = "tgd_xb";
+export declare const STORAGE_CID = "tgd_cid";
+export declare const QUERY_ENTRY_TEST = "_tgx";
+export declare const QUERY_VID_HANDOFF = "_tgv";
+export declare const QUERY_DEBUG = "tgd_debug";
+export declare const FUNNEL_SESSION_COOKIE = "tgd-funnel-session-id";
+export declare const ptSnapshotKey: (funnelId: string, stepId: string) => string;
+export declare const sdkSnapshotKey: (storeId: string) => string;
+export declare const fsVidKey: (funnelSessionId: string) => string;
+export declare const kvFsVid: (funnelSessionId: string) => string;
+//# sourceMappingURL=names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/tgd/contract/names.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAC7C,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,QAAQ,MAAM,WAAuC,CAAC;AACtG,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,WAA6B,CAAC;AAC5E,eAAO,MAAM,QAAQ,GAAI,iBAAiB,MAAM,WAAmC,CAAC;AACpF,eAAO,MAAM,OAAO,oBADsB,MAAM,WACjB,CAAC"}

package/dist/tgd/contract/names.js

@@ -0,0 +1,15 @@
+// packages/tgd-core/src/contract/names.ts
+export const COOKIE_VID = 'tgd_vid'; // host-only, 400 days, set by the edge only (A9)
+export const COOKIE_VID_REFRESH = 'tgd_vr'; // daily re-issue marker
+export const COOKIE_SDK_BOOTSTRAP = 'tgd_xb'; // base64url(JSON) of XbCookieV1 (sdk-api.md §4.3, A17)
+export const STORAGE_CID = 'tgd_cid'; // localStorage UUIDv7 on hosts Tagada does not serve
+export const QUERY_ENTRY_TEST = '_tgx';
+export const QUERY_VID_HANDOFF = '_tgv';
+export const QUERY_DEBUG = 'tgd_debug';
+export const FUNNEL_SESSION_COOKIE = 'tgd-funnel-session-id'; // plugin-sdk cookie, read-only
+// (packages/plugin-sdk/src/v2/core/utils/sessionStorage.ts:6)
+export const ptSnapshotKey = (funnelId, stepId) => `av2:exp:pt:${funnelId}:${stepId}`; // ab-engine.md §1.5
+export const sdkSnapshotKey = (storeId) => `av2:exp:sdk:${storeId}`; // ab-engine.md §1.5, sdk-api.md
+export const fsVidKey = (funnelSessionId) => `av2:fsvid:${funnelSessionId}`; // identity-sessions.md §10.3
+export const kvFsVid = fsVidKey; // spelling of identity-sessions.md §1.1; code imports fsVidKey
+//# sourceMappingURL=names.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/tgd/contract/names.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,CAAY,iDAAiD;AACjG,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,CAAK,wBAAwB;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,CAAG,uDAAuD;AACvG,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAW,qDAAqD;AACrG,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,CAAC,+BAA+B;AAC9B,8DAA8D;AAC7H,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAE,EAAE,CAAC,cAAc,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC,oBAAoB;AAC3H,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,eAAe,OAAO,EAAE,CAAC,CAA8B,gCAAgC;AAC1I,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,eAAuB,EAAE,EAAE,CAAC,aAAa,eAAe,EAAE,CAAC,CAAqB,6BAA6B;AACtI,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,+DAA+D"}