@active-reach/web-sdk 1.3.1 → 1.5.0

package/dist/core/prefetch-bundle-client.d.ts

@@ -0,0 +1,150 @@
+/**
+ * PrefetchBundleClient — unified init-time resolver for in-app state.
+ *
+ * Fetches /v1/sdk/prefetch-bundle at SDK init and on a 5-minute ETag
+ * refresh cadence. The bundle payload carries:
+ *   • `campaigns[]`  — eligible, property-scoped, A/B-assigned campaigns
+ *                      armed for this contact. EVERY in-app type is in
+ *                      here (modal, banner, spin_wheel, carousel_cards,
+ *                      sticky_bar, progress_bar, coachmark_tour, etc.).
+ *   • `inbox`        — first page + unread count for the notification
+ *                      drawer; lets AegisInbox hydrate without a second
+ *                      round-trip.
+ *   • `etag`         — content-hashed, stable when state is unchanged;
+ *                      304 responses cost ~50ms and consume no body.
+ *   • `invalidation_topic` — SSE channel name the cell-plane publishes
+ *                      to when a playbook arms a campaign mid-session.
+ *                      The SDK does NOT open SSE on that topic today —
+ *                      we rely on the 5-minute poll + an explicit
+ *                      `refresh()` hook that app code (AegisInAppManager,
+ *                      AegisInbox) call on relevant user actions.
+ *
+ * This is the cornerstone of the preload-first contract from
+ * docs/architecture/IN_APP_MESSAGES_EXPANSION_PLAN.md §1. The render
+ * path must NEVER hit the network at trigger time — the bundle is
+ * populated at init, and everything renders from memory.
+ */
+export interface PrefetchBundleCampaign {
+    id: string;
+    type: string;
+    sub_type?: string;
+    title: string;
+    body: string;
+    image_url?: string;
+    action_url?: string;
+    button_text?: string;
+    background_color?: string;
+    text_color?: string;
+    priority: number;
+    expires_at?: string | null;
+    frequency?: {
+        max_impressions?: number;
+        max_impressions_per_day?: number;
+        cooldown_seconds?: number;
+    };
+    interactive_config?: Record<string, unknown>;
+    client_trigger?: {
+        type: string;
+        config?: Record<string, unknown>;
+    };
+    assigned_variant_id?: string;
+    inbox_enabled?: boolean;
+}
+export interface PrefetchBundleInboxEntry {
+    id: string;
+    source: string;
+    campaign_id: string | null;
+    title: string;
+    body: string;
+    media_url: string | null;
+    cta_url: string | null;
+    metadata: Record<string, unknown> | null;
+    read: boolean;
+    read_at: string | null;
+    created_at: string | null;
+    expires_at: string | null;
+}
+export interface PrefetchBundleInbox {
+    unread_count: number;
+    page: PrefetchBundleInboxEntry[];
+    cursor: string | null;
+}
+export interface PrefetchBundle {
+    etag: string;
+    generated_at: string;
+    ttl_seconds: number;
+    invalidation_topic: string;
+    campaigns: PrefetchBundleCampaign[];
+    inbox: PrefetchBundleInbox;
+}
+export interface PrefetchBundleContext {
+    device_type?: string;
+    page_url?: string;
+    geo?: string;
+    is_new_user?: boolean;
+}
+export interface PrefetchBundleClientOptions {
+    apiHost: string;
+    writeKey: string;
+    organizationId?: string;
+    contactId?: string;
+    userId?: string;
+    propertyId?: string;
+    /** Cached AB assignments from localStorage, base64-json. */
+    abAssignments?: Record<string, string>;
+    /** Polling cadence; defaults to the bundle's own `ttl_seconds` (300s). */
+    pollIntervalMs?: number;
+    /** Factory for client context — re-evaluated on each fetch so device/page
+     *  state stays fresh without forcing callers to re-instantiate the client. */
+    contextProvider?: () => PrefetchBundleContext;
+}
+export type PrefetchBundleListener = (bundle: PrefetchBundle) => void;
+export declare class PrefetchBundleClient {
+    private apiHost;
+    private writeKey;
+    private organizationId?;
+    private contactId?;
+    private userId?;
+    private propertyId?;
+    private abAssignments;
+    private pollIntervalMs;
+    private contextProvider;
+    private currentETag;
+    private currentBundle;
+    private pollTimer;
+    private listeners;
+    private inflightRefetch;
+    constructor(options: PrefetchBundleClientOptions);
+    /**
+     * Initial fetch + start the background ETag poll. Resolves to the bundle
+     * (or `null` if the first fetch failed — callers should fall back to an
+     * empty campaign list, not abort SDK init).
+     */
+    start(): Promise<PrefetchBundle | null>;
+    stop(): void;
+    getBundle(): PrefetchBundle | null;
+    getCampaigns(): PrefetchBundleCampaign[];
+    getInbox(): PrefetchBundleInbox;
+    /** Force a refresh (dedupes concurrent calls). Exposed so inbox mutations
+     *  and campaign-activation SSE messages can trigger a refetch on demand. */
+    refresh(): Promise<PrefetchBundle | null>;
+    /** Subscribe to bundle changes (emits on first fetch + on any content
+     *  change — ETag 304 does NOT fire the listener). Returns an unsubscribe. */
+    onChange(listener: PrefetchBundleListener): () => void;
+    /**
+     * Update the identity tuple — called by AegisInAppManager when the host
+     * app resolves a contactId post-init (e.g., after login). Triggers an
+     * immediate refresh since the eligible campaigns + inbox will differ.
+     */
+    updateIdentity(partial: {
+        contactId?: string;
+        userId?: string;
+        organizationId?: string;
+        propertyId?: string;
+    }): void;
+    /** Update cached AB assignments. Called by downstream renderers after
+     *  they display a variant. Persisted to localStorage by higher layers. */
+    setAbAssignments(assignments: Record<string, string>): void;
+    private fetch;
+}
+//# sourceMappingURL=prefetch-bundle-client.d.ts.map

package/dist/core/prefetch-bundle-client.d.ts.map

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

package/dist/governance/bloom-filter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Bloom filter — wire-compatible with the Python builder in
+ * apps/control-plane/app/services/event_governance_bloom.py
+ *
+ * This SDK-side variant is QUERY-ONLY. The filter is built server-side
+ * from the org's registered event-name set, base64-encoded, and shipped
+ * to the browser on `/v1/sdk/bootstrap`. The SDK reads it once, uses it
+ * to gate `track()` calls, and discards it on the next bootstrap.
+ *
+ * Wire format:
+ *   • `m` bits of storage, represented as m/8 bytes, base64-encoded.
+ *   • Bit `i` is at byte `i >> 3`, bitmask `1 << (i & 7)` — LSB-first.
+ *   • `m` MUST be a power of two — allows `idx & (m-1)` modulo.
+ *   • `k` hash functions synthesized via Kirsch-Mitzenmacher from two
+ *     MurmurHash3 x86-32 hashes with seeds (seedA, seedB):
+ *         h_i(x) = (h1(x) + i * h2(x)) mod m
+ *   • Input strings are UTF-8 encoded (handled inside murmurhash3_x86_32).
+ */
+export interface BloomFilterParams {
+    /** Bits in the filter (must be power of 2). */
+    m: number;
+    /** Number of hash functions (Kirsch-Mitzenmacher synthesized). */
+    k: number;
+    /** Seed for the first MurmurHash3 call. */
+    seedA: number;
+    /** Seed for the second MurmurHash3 call. */
+    seedB: number;
+}
+export declare class BloomFilter {
+    private readonly params;
+    private readonly buf;
+    private readonly mask;
+    constructor(buf: Uint8Array, params: BloomFilterParams);
+    /** Build from the wire format (base64 bytes + explicit params). */
+    static fromBase64(bloomB64: string, params: BloomFilterParams): BloomFilter;
+    /**
+     * Returns true if `name` is probably in the set — possibly with the
+     * filter's configured false-positive rate. FALSE is always authoritative.
+     *
+     * FP here means: SDK thinks a name is already registered when it isn't.
+     * That costs one wasted server round-trip (gateway does the exact check
+     * and catches it) — strictly safer than a false-negative, which could
+     * leak a novel name past the SDK.
+     */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=bloom-filter.d.ts.map

package/dist/governance/bloom-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-filter.d.ts","sourceRoot":"","sources":["../../src/governance/bloom-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAuBH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;IACV,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IAIO,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,GAAG,EAAE,UAAU,EAAmB,MAAM,EAAE,iBAAiB;IAavE,mEAAmE;IACnE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW;IAK3E;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAe3B"}

package/dist/governance/index.d.ts

@@ -0,0 +1,6 @@
+export { murmurhash3_x86_32, murmurhash3_bytes } from './murmur3';
+export { BloomFilter } from './bloom-filter';
+export type { BloomFilterParams } from './bloom-filter';
+export { NameGovernor } from './name-governor';
+export type { EventGovernanceHint, DropReport } from './name-governor';
+//# sourceMappingURL=index.d.ts.map

package/dist/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/governance/murmur3.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MurmurHash3 x86-32 — deterministic, byte-identical with Python `mmh3.hash`.
+ *
+ * We hand-roll rather than pull a dep because (a) our bundle-budget is
+ * aggressive for storefront first-paint, and (b) this is the authoritative
+ * cross-language hash for the event-governance bloom filter — any behavior
+ * drift between Python and JS produces silent FP-rate spikes in prod.
+ *
+ * Contract:
+ *   • Input is a JS string. It is UTF-8 encoded via TextEncoder before hashing.
+ *   • Output is an unsigned 32-bit integer (0 .. 2^32-1).
+ *   • Matches `mmh3.hash(s.encode('utf-8'), seed=seed, signed=False)` in
+ *     Python exactly — verified by libs/shared-types/bloom-test-vectors.json
+ *     in CI.
+ *
+ * Reference: Austin Appleby, MurmurHash3 (public domain).
+ *   https://github.com/aappleby/smhasher/blob/master/src/MurmurHash3.cpp
+ *
+ * Implementation notes:
+ *   • All arithmetic on 32-bit ints. JS does bitwise ops on 32-bit ints natively;
+ *     `Math.imul` gives us correct 32-bit multiplication without overflow.
+ *   • We use `>>> 0` to coerce to unsigned after every step that could produce
+ *     a negative or >32-bit value.
+ *   • UTF-8 encoding matters — a naive `charCodeAt` loop would mis-hash any
+ *     string with non-ASCII characters (e.g. emoji, accented chars) and the
+ *     Python side would disagree. We always encode via TextEncoder first.
+ */
+/**
+ * Compute MurmurHash3 x86-32 of a UTF-8 encoded string.
+ *
+ * @param input  The string to hash.
+ * @param seed   32-bit unsigned seed.
+ * @returns      Unsigned 32-bit integer hash.
+ */
+export declare function murmurhash3_x86_32(input: string, seed?: number): number;
+/**
+ * Compute MurmurHash3 x86-32 over a byte buffer directly.
+ *
+ * Exposed for callers that already have UTF-8 bytes and want to skip the
+ * encode step (e.g., internal bloom-hash paths).
+ */
+export declare function murmurhash3_bytes(bytes: Uint8Array, seed?: number): number;
+//# sourceMappingURL=murmur3.d.ts.map

package/dist/governance/murmur3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"murmur3.d.ts","sourceRoot":"","sources":["../../src/governance/murmur3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CA+C7E"}

package/dist/governance/name-governor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * NameGovernor — client-side event-name cap enforcement.
+ *
+ * The governor consumes an `EventGovernanceHint` from the bootstrap response
+ * and decides whether to let a `track()` call proceed to the network or drop
+ * it locally.
+ *
+ * Why this exists:
+ *   Without it, a page that calls `track('new_btn_' + Date.now())` in a
+ *   render loop would (a) pass the local rate-limiter if within burst, (b)
+ *   force the gateway to ask control-plane for a verdict on every unique
+ *   name, and (c) amplify the CP `/event-governance/check` load quadratically
+ *   in the number of tabs firing the same bug. The bloom filter gives the
+ *   SDK enough information to drop novel names locally once the org hits
+ *   its cap, collapsing the amplification to zero.
+ *
+ * Design constraints:
+ *   • FAIL-OPEN — missing hint (Enterprise org, Redis outage) lets every
+ *     name through. The gateway is still the authoritative cap.
+ *   • FALSE-POSITIVE-SAFE — if the bloom says "known" for a name that isn't
+ *     actually registered, we send to gateway and the gateway's exact check
+ *     catches it. FPs cost one round trip, not a cap bypass.
+ *   • LOCAL-MEMO — a novel name that has already charged `remainingNewNames`
+ *     in this tab must NOT charge again on subsequent calls within the same
+ *     hint TTL. Without this, `track('new_btn_click')` fired 50 times would
+ *     drain 50 from the counter and block every OTHER legitimate novel name.
+ *     See `localNovelNames`.
+ *
+ * See docs/architecture/RFC_2026_04_SDK_GOVERNANCE_HINTS.md §3.3.
+ */
+/** Shape of the hint delivered by `/v1/sdk/bootstrap`. */
+export interface EventGovernanceHint {
+    bloom_algo: string;
+    seed_a: number;
+    seed_b: number;
+    k: number;
+    m: number;
+    bloom_b64: string;
+    remaining_new_names: number | null;
+    /**
+     * When true, the server is in its 7-day soft-cap grace window: it accepts
+     * novel event names past the cap. SDK must NOT drop locally in this mode —
+     * doing so would enforce harder than the server. See
+     * apps/control-plane/app/schemas/event_governance_hint.py for the canonical
+     * contract.
+     */
+    grace_active?: boolean;
+    ttl_seconds: number;
+}
+export interface DropReport {
+    /** Map of event_name → count of local drops since last drain. */
+    events: Record<string, number>;
+    /** Total events dropped across all names (sum of values). */
+    total: number;
+    /** When the report window started (ms since epoch). */
+    since: number;
+}
+export declare class NameGovernor {
+    private bloom;
+    private remainingNewNames;
+    private graceActive;
+    /**
+     * Names this SDK instance has seen AS NOVEL and already charged against
+     * `remainingNewNames`. Reset on every `ingestHint()` so we don't leak
+     * accounting across hint refreshes.
+     */
+    private localNovelNames;
+    /** Coalesced telemetry — flushed to the transport via drainDropReport(). */
+    private droppedSinceLastReport;
+    private reportWindowStart;
+    private hasWarnedThisSession;
+    /**
+     * Ingest a freshly-bootstrapped hint. Call on every successful bootstrap.
+     * Passing `null` disables governance (fail-open).
+     */
+    ingestHint(hint: EventGovernanceHint | null): void;
+    /**
+     * Decide whether a `track()` call should proceed.
+     *
+     * Returns true  = send to network (rate-limiter still runs after).
+     * Returns false = drop locally; caller should return early.
+     */
+    shouldSend(eventName: string): boolean;
+    /**
+     * Snapshot + reset the dropped-names counter. Called by the telemetry
+     * beacon on batch flush so the gateway gets visibility into client-side
+     * drops for ops dashboards.
+     */
+    drainDropReport(): DropReport | null;
+    /** @internal */
+    _debugState(): {
+        hasBloom: boolean;
+        remaining: number;
+        localNovel: number;
+        graceActive: boolean;
+    };
+}
+//# sourceMappingURL=name-governor.d.ts.map

package/dist/governance/name-governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-governor.d.ts","sourceRoot":"","sources":["../../src/governance/name-governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAeD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAkB;IAErC;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAA0B;IAEjD,4EAA4E;IAC5E,OAAO,CAAC,sBAAsB,CAAkC;IAChE,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,oBAAoB,CAAS;IAErC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI;IA4BlD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAqCtC;;;;OAIG;IACH,eAAe,IAAI,UAAU,GAAG,IAAI;IAkBpC,gBAAgB;IAChB,WAAW,IAAI;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;KACtB;CAQF"}

package/dist/inapp/AegisInAppManager.d.ts

@@ -21,7 +21,7 @@
  */
 export interface InAppCampaign {
     id: string;
-    type: 'modal' | 'banner' | 'tooltip' | 'full_screen' | 'half_interstitial' | 'alert' | 'pip';
+    type: 'modal' | 'banner' | 'tooltip' | 'full_screen' | 'half_interstitial' | 'alert' | 'pip' | 'carousel_cards' | 'sticky_bar' | 'progress_bar' | 'coachmark_tour' | 'product_recommendation';
     sub_type?: string;
     title: string;
     body: string;
@@ -51,6 +51,7 @@ export interface AegisInAppConfig {
     userId?: string;
     contactId?: string;
     organizationId?: string;
+    propertyId?: string;
     debugMode?: boolean;
     enableSSE?: boolean;
 }
@@ -60,6 +61,7 @@ export declare class AegisInAppManager {
     private userId?;
     private contactId?;
     private organizationId?;
+    private propertyId?;
     private debugMode;
     private enableSSE;
     private campaigns;
@@ -82,7 +84,32 @@ export declare class AegisInAppManager {
     private processABAssignments;
     private getVariantId;
     private tryDisplayNextCampaign;
+    /**
+     * Evaluate the currently armed campaigns against a client-side event
+     * and render any that match their `client_trigger`.
+     *
+     * Called by the host app (e.g., the EcommerceTracker on product_viewed),
+     * or by future TriggerEngine bridges. Safe to call repeatedly for the
+     * same event — dedup happens via `displayedCampaigns`.
+     *
+     * Supported trigger types (align with the cell-plane server-side
+     * `display_rules.trigger_type`):
+     *   - `custom_event`  : fire when eventName matches config.event
+     *   - `product_match` : fire on `product_viewed` when eventData.product_id
+     *                       matches config.product_id (string or string[])
+     *   - `delay`         : client-side setTimeout — evaluated at armeng
+     *                       time (kicked off from `displayCampaign`), not here.
+     */
+    onClientEvent(eventName: string, eventData?: Record<string, unknown>): void;
+    private matchesClientTrigger;
     private displayCampaign;
+    /**
+     * Build the shared context passed into the preload-first renderers.
+     * Matches the interface in `./renderers/types.ts`. Kept as a private
+     * method (rather than inlined at each call-site) so future renderer
+     * additions stay consistent and easy to audit.
+     */
+    private buildRenderContext;
     /**
      * Renders interactive sub-type campaigns (spin wheel, NPS, quiz, etc.)
      * using DOM-safe rendering. These sub-types use the campaign's

package/dist/inapp/AegisInAppManager.d.ts.map

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

package/dist/inapp/renderers/carousel-cards.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CarouselCards renderer — a swipeable / autoplaying sequence of product
+ * cards. Used for post-purchase upsells, cross-sell, and "recently viewed"
+ * surfaces. The entire card list is pre-bundled — no network call on
+ * trigger; slide advance is pure client state.
+ *
+ * Data shape (interactive_config, populated at campaign create time and
+ * validated server-side):
+ *   cards: Array<{ image_url?, title, body?, cta_text?, cta_url? }>
+ *   autoplay_ms?: number   // 0 = manual advance only
+ *   loop?: boolean         // wrap to card 0 on last-next
+ */
+import type { RenderContext } from './types';
+export declare function renderCarouselCards(ctx: RenderContext): void;
+//# sourceMappingURL=carousel-cards.d.ts.map

package/dist/inapp/renderers/carousel-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousel-cards.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/carousel-cards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAY7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA4L5D"}

package/dist/inapp/renderers/coachmark-tour.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CoachmarkTour renderer — a guided, multi-step walkthrough anchored to
+ * DOM elements via CSS selectors. One tooltip appears at a time with
+ * next/back navigation; completion + skip are persisted per contact via
+ * localStorage under the `resume_key`, so an abandoned tour resumes on
+ * the next visit instead of restarting or re-bothering the user.
+ *
+ * interactive_config:
+ *   steps: Array<{
+ *     anchor_web?: string,       // CSS selector for THIS platform
+ *     anchor_android?: string,   // ignored on web
+ *     anchor_ios?: string,       // ignored on web
+ *     title: string,
+ *     body: string,
+ *     placement?: 'top' | 'bottom' | 'left' | 'right',
+ *     cta_text?: string,
+ *   }>
+ *   resume_key: string,
+ *   allow_skip?: boolean,
+ *   show_progress_dots?: boolean,
+ */
+import type { RenderContext } from './types';
+export declare function renderCoachmarkTour(ctx: RenderContext): void;
+//# sourceMappingURL=coachmark-tour.d.ts.map

package/dist/inapp/renderers/coachmark-tour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coachmark-tour.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/coachmark-tour.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA6C7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA0M5D"}

package/dist/inapp/renderers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Barrel for the 5 preload-first renderers. These are pure DOM-mutation
+ * functions that operate on a shared `RenderContext` — they never do
+ * network I/O at render time, consistent with the preload-first contract.
+ */
+export type { RenderContext, Renderer } from './types';
+export { renderCarouselCards } from './carousel-cards';
+export { renderStickyBar } from './sticky-bar';
+export { renderProgressBar } from './progress-bar';
+export { renderCoachmarkTour } from './coachmark-tour';
+export { renderProductRecommendation } from './product-recommendation';
+//# sourceMappingURL=index.d.ts.map

package/dist/inapp/renderers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/inapp/renderers/product-recommendation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ProductRecommendation renderer — personalized product grid/row rendered
+ * from `interactive_config.cards[]` that the cell-plane populated at
+ * bundle-assembly time. The SDK never calls a product-API at render
+ * time — the preload contract is that the recommended products are
+ * already in the bundle.
+ *
+ * The layout is narrower than the generic carousel because product recs
+ * should feel like a first-class product grid, not a marketing slider.
+ * Three layouts: grid (2-col / 3-col responsive), row (horizontal-scroll),
+ * carousel (same as carousel_cards but different framing copy).
+ *
+ * interactive_config:
+ *   rec_source?: 'viewed' | 'abandoned' | 'cross_sell' | 'trending' | 'personalized'
+ *                (metadata only — the actual product list is in `cards[]`)
+ *   rec_count?: number       (display hint; rendering is driven by cards.length)
+ *   rec_layout?: 'grid' | 'row' | 'carousel'   default 'grid'
+ *   rec_cta_text?: string    default 'Shop now'
+ *   cards: Array<{ image_url?, title?, body?, cta_url?, metadata? }>
+ */
+import type { RenderContext } from './types';
+export declare function renderProductRecommendation(ctx: RenderContext): void;
+//# sourceMappingURL=product-recommendation.d.ts.map

package/dist/inapp/renderers/product-recommendation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-recommendation.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/product-recommendation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa7C,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyKpE"}

package/dist/inapp/renderers/progress-bar.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ProgressBar renderer — a persistent bar that shows the user's progress
+ * toward a reward threshold (free shipping, loyalty tier, referral bonus).
+ *
+ * Two sources of the current value:
+ *   'client' — cheap: read from window.Shopify / WooCommerce / Magento
+ *              cart globals. Untrusted; fine for visual-only hints.
+ *   'sse'    — trusted: cell-plane pushes current_value via SSE to the
+ *              already-shipped realtime server. For cart-gated rewards
+ *              (must agree with server-side checkout guard), prefer SSE.
+ *
+ * For Phase 1 we implement CLIENT mode end-to-end. SSE mode reads
+ * `window.__aegisProgressSSE[campaign.id]` if populated by a parent app
+ * — higher-level integration (the SSE bridge) can push values there.
+ *
+ * interactive_config:
+ *   progress_goal_type: 'cart_total' | 'items_in_cart' | 'loyalty_points' | 'referrals'
+ *   progress_threshold: number
+ *   progress_reward_text?: string
+ *   progress_source?: 'client' | 'sse'   default 'client'
+ */
+import type { RenderContext } from './types';
+export declare function renderProgressBar(ctx: RenderContext): void;
+//# sourceMappingURL=progress-bar.d.ts.map

package/dist/inapp/renderers/progress-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/progress-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAgJ1D"}

package/dist/inapp/renderers/sticky-bar.d.ts

@@ -0,0 +1,14 @@
+/**
+ * StickyBar renderer — a pinned notification strip at the top or bottom
+ * of the viewport. Used for free-shipping hints, flash-sale banners,
+ * cart-reminder strips. Dismissible, optionally auto-hiding.
+ *
+ * interactive_config:
+ *   sticky_position: 'top' | 'bottom'   (required)
+ *   sticky_bg_color?: string
+ *   sticky_dismissible?: boolean         default true
+ *   sticky_auto_hide_ms?: number         0 = never
+ */
+import type { RenderContext } from './types';
+export declare function renderStickyBar(ctx: RenderContext): void;
+//# sourceMappingURL=sticky-bar.d.ts.map

package/dist/inapp/renderers/sticky-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticky-bar.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/sticky-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7C,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA2GxD"}

package/dist/inapp/renderers/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Preload-first renderer types — the 5 display types added in Phase 0
+ * of the In-App Messages Expansion Plan (carousel_cards, sticky_bar,
+ * progress_bar, coachmark_tour, product_recommendation).
+ *
+ * Each renderer is a pure function over a `RenderContext` so that the
+ * main `AegisInAppManager` class does not grow unbounded. Render paths
+ * never do network I/O — everything they need is already in the
+ * campaign payload from the prefetch bundle.
+ */
+import type { InAppCampaign } from '../AegisInAppManager';
+export interface RenderContext {
+    campaign: InAppCampaign;
+    /** Track impression/click/dismiss via navigator.sendBeacon-capable writer. */
+    trackEvent: (campaignId: string, eventType: 'impression' | 'clicked' | 'dismissed') => void;
+    /** Null-safe URL hardener — rejects javascript:/data: */
+    sanitizeUrl: (url: string) => string | null;
+    /** Only accept #hex / rgb() / rgba() / named tokens — everything else returns the default. */
+    sanitizeColor: (color: string) => string;
+    /** Debug logger — forwarded to the manager's logger. */
+    log: (msg: string, level?: 'log' | 'warn' | 'error') => void;
+    /** Lazily inject the shared keyframes. */
+    addAnimationStyles: () => void;
+}
+/** Renderer signature — side-effectful DOM mutation, no return. */
+export type Renderer = (ctx: RenderContext) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/inapp/renderers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/inapp/renderers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,CACV,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,KAC9C,IAAI,CAAC;IACV,yDAAyD;IACzD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,8FAA8F;IAC9F,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,wDAAwD;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;IAC7D,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC"}