@active-reach/web-sdk 1.4.0 → 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/name-governor.d.ts

@@ -37,6 +37,14 @@ export interface EventGovernanceHint {
     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 {
@@ -50,6 +58,7 @@ export interface DropReport {
 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
@@ -83,6 +92,7 @@ export declare class NameGovernor {
         hasBloom: boolean;
         remaining: number;
         localNovel: number;
+        graceActive: boolean;
     };
 }
 //# sourceMappingURL=name-governor.d.ts.map

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

@@ -1 +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,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;IAE7C;;;;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;IA0BlD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAiCtC;;;;OAIG;IACH,eAAe,IAAI,UAAU,GAAG,IAAI;IAkBpC,gBAAgB;IAChB,WAAW,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAO5E"}
+{"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;
@@ -84,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"}

package/dist/inbox/AegisInbox.d.ts

@@ -0,0 +1,103 @@
+/**
+ * AegisInbox — client-side App Inbox (Message Center).
+ *
+ * Backs the notification drawer on actii.me WebView and every tenant
+ * storefront that embeds the Web SDK. Operates against cell-plane's
+ * /v1/in-app/inbox family of endpoints (list, unread-count, read,
+ * dismiss, read-all).
+ *
+ * Design choices:
+ *  • Hydrate from the prefetch bundle at init — no extra HTTP on first
+ *    paint. PrefetchBundleClient seeds us; we then own the live copy.
+ *  • Mutations are optimistic + beacon-backed. Read / dismiss writes to
+ *    local state immediately, then POSTs with `keepalive: true` so an
+ *    in-flight dismiss survives page unload.
+ *  • Badge polling uses the tiny `/unread-count` endpoint on a 60-second
+ *    cadence — matches the `inbox_poll_interval_ms` from sdk_config's
+ *    TransportConfig.hybrid mode.
+ *  • No external dependencies; IndexedDB is optional (we gracefully fall
+ *    back to in-memory when unavailable, e.g., in private browsing).
+ */
+import type { PrefetchBundleClient } from '../core/prefetch-bundle-client';
+export interface AegisInboxEntry {
+    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;
+    dismissed_at?: string | null;
+    created_at: string | null;
+    expires_at: string | null;
+}
+export interface AegisInboxConfig {
+    apiHost: string;
+    writeKey: string;
+    organizationId?: string;
+    contactId?: string;
+    propertyId?: string;
+    bundleClient?: PrefetchBundleClient;
+    unreadPollIntervalMs?: number;
+}
+export type InboxListener = (state: {
+    entries: AegisInboxEntry[];
+    unreadCount: number;
+}) => void;
+export declare class AegisInbox {
+    private apiHost;
+    private writeKey;
+    private organizationId?;
+    private contactId?;
+    private propertyId?;
+    private bundleClient?;
+    private unreadPollIntervalMs;
+    private entries;
+    private unreadCount;
+    private cursor;
+    private listeners;
+    private pollTimer;
+    private bundleUnsub;
+    constructor(config: AegisInboxConfig);
+    /** Hydrate from bundle (if available), restore the IDB cache (if any),
+     *  then start the background unread-count poll. */
+    initialize(): Promise<void>;
+    stop(): void;
+    /** Update identity after login / property switch. Clears the local
+     *  inbox since it's intrinsically contact+property scoped. */
+    setIdentity(partial: {
+        contactId?: string;
+        propertyId?: string;
+        organizationId?: string;
+    }): void;
+    getEntries(): AegisInboxEntry[];
+    getUnreadCount(): number;
+    /** Pagination cursor (ISO-8601 timestamp of the oldest entry currently
+     *  held). Pass it back via `loadMore()` to fetch older history. */
+    getCursor(): string | null;
+    /** Append one more page of older entries using the current cursor. */
+    loadMore(): Promise<void>;
+    onChange(l: InboxListener): () => void;
+    refreshList(): Promise<void>;
+    refreshUnreadCount(): Promise<void>;
+    markRead(messageId: string): Promise<void>;
+    dismiss(messageId: string): Promise<void>;
+    markAllRead(): Promise<void>;
+    private seedFromBundle;
+    private recomputeUnread;
+    private emit;
+    private headers;
+    /** Best-effort beacon-style POST. Uses `keepalive: true` so it survives
+     *  a navigation away from the current page (e.g., user taps the CTA
+     *  which takes them to another URL right after dismiss). */
+    private postBeacon;
+    private openDb;
+    private cacheKey;
+    private writeCache;
+    private readCache;
+    private clearCache;
+}
+//# sourceMappingURL=AegisInbox.d.ts.map

package/dist/inbox/AegisInbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AegisInbox.d.ts","sourceRoot":"","sources":["../../src/inbox/AegisInbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAUjG,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAuB;IAC5C,OAAO,CAAC,oBAAoB,CAAS;IAErC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,WAAW,CAA6B;gBAEpC,MAAM,EAAE,gBAAgB;IAUpC;uDACmD;IAC7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCjC,IAAI,IAAI,IAAI;IAWZ;kEAC8D;IAC9D,WAAW,CAAC,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA0BhG,UAAU,IAAI,eAAe,EAAE;IAI/B,cAAc,IAAI,MAAM;IAIxB;uEACmE;IACnE,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,sEAAsE;IAChE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,IAAI;IAQhC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBlC,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,OAAO;IAWf;;gEAE4D;YAC9C,UAAU;YAiBV,MAAM;IAmBpB,OAAO,CAAC,QAAQ;YAKF,UAAU;YAmBV,SAAS;YAmBT,UAAU;CAkBzB"}

package/dist/inbox/index.d.ts

@@ -0,0 +1,3 @@
+export { AegisInbox } from './AegisInbox';
+export type { AegisInboxConfig, AegisInboxEntry, InboxListener } from './AegisInbox';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -18,6 +18,10 @@ export { TriggerEngine } from './triggers';
 export type { TriggerRule, ScrollDepthConfig, TimeOnPageConfig, ExitIntentConfig, InactivityConfig, TriggerEvent, } from './triggers';
 export { SdkConfigPoller } from './core/sdk-config-poller';
 export type { SdkConfig, SdkConfigPollerOptions, ConfigChangeCallback } from './core/sdk-config-poller';
+export { PrefetchBundleClient } from './core/prefetch-bundle-client';
+export type { PrefetchBundle, PrefetchBundleCampaign, PrefetchBundleInbox, PrefetchBundleInboxEntry, PrefetchBundleClientOptions, PrefetchBundleContext, PrefetchBundleListener, } from './core/prefetch-bundle-client';
+export { AegisInbox } from './inbox';
+export type { AegisInboxConfig, AegisInboxEntry, InboxListener } from './inbox';
 export { AegisWebPush } from './push/AegisWebPush';
 export type { AegisWebPushConfig, AegisAPIClient, ContactIdentity, PushEventTracker, } from './push/AegisWebPush';
 export { bootstrap, readFirstPartyCookie, writeFirstPartyCookie, deriveDeviceFingerprint, BootstrapError, } from './core/bootstrap';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B,eAAe,KAAK,CAAC;AAErB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAExG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAK9D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAQvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}