@active-reach/web-sdk 1.5.0 → 1.6.0

package/dist/runtime/AegisMessageRuntime.d.ts

@@ -0,0 +1,88 @@
+/**
+ * AegisMessageRuntime — unified facade for in-app messaging.
+ *
+ * Before Phase 7b, tenants using spin_wheel or scratch_card went through
+ * `AegisWidgetManager`, while every other in-app type went through
+ * `AegisInAppManager`. Two managers, two prefetch endpoints, two render
+ * pipelines — all for what is conceptually one product surface.
+ *
+ * This facade is the single entry point going forward. It holds BOTH
+ * underlying managers internally and routes by type, so existing code
+ * that talks to them still works during the deprecation window.
+ *
+ * Public API (shape intentionally kept tiny):
+ *   new AegisMessageRuntime({ writeKey, apiHost, ... })
+ *   await runtime.initialize()
+ *   runtime.updateContactId(id)
+ *   runtime.onClientEvent(eventName, data)
+ *   runtime.destroy()
+ *
+ * Internal wiring: spin_wheel + scratch_card campaigns that flow through
+ * the InAppManager trigger a `CustomEvent('aegis:render-widget')` that
+ * the runtime's internal WidgetManager picks up (this bridge already
+ * exists in AegisInAppManager). No code movement needed — just a single
+ * facade over the existing two-manager split.
+ *
+ * When Phase 7c ports WidgetManager's render paths into InAppManager,
+ * this facade becomes a thin delegate over a single manager and the
+ * WidgetManager instance can be deleted. For now, one import to rule
+ * them all.
+ */
+import { AegisInAppManager, type AegisInAppConfig, type InAppCampaign } from '../inapp';
+import { AegisWidgetManager, type AegisWidgetConfig } from '../widgets';
+export interface AegisMessageRuntimeConfig extends AegisInAppConfig {
+    /** If set, a `TriggerEngine` from the SDK is wired to the WidgetManager
+     *  for its exit-intent / scroll-velocity / inactivity handlers. Leave
+     *  undefined to have the runtime construct one internally. */
+    triggerEngine?: AegisWidgetConfig['triggerEngine'];
+    /** WidgetManager prefetch toggle. Defaults to true — matches the
+     *  existing behaviour where spin_wheel / scratch_card prefetch their
+     *  configs from `/v1/widgets/config/prefetch`. */
+    enableWidgetPrefetch?: boolean;
+    /** Source platform for gamification attribution (shopify / woocommerce
+     *  / magento / mobile_sdk / web). Passed through to WidgetManager. */
+    sourcePlatform?: AegisWidgetConfig['sourcePlatform'];
+}
+/**
+ * One runtime, all in-app types. Consumers should prefer this over
+ * importing AegisInAppManager / AegisWidgetManager directly. Those two
+ * classes remain exported for a deprecation window — see `./deprecated.ts`.
+ */
+export declare class AegisMessageRuntime {
+    readonly inApp: AegisInAppManager;
+    readonly widgets: AegisWidgetManager;
+    private initialized;
+    constructor(config: AegisMessageRuntimeConfig);
+    /**
+     * Boots both managers in parallel. Safe to call multiple times — the
+     * second + subsequent calls are no-ops.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Both managers carry contactId. Update both so the server-side
+     * targeting pipeline sees the identity for campaign eligibility AND
+     * the widget prefetch includes per-contact segment configs.
+     */
+    updateContactId(contactId: string): void;
+    /**
+     * Forward a client-side event (product_viewed, cart_idle_90s, etc.)
+     * to the in-app manager's client-trigger evaluator. The WidgetManager
+     * has its own TriggerEngine wiring (exit-intent, scroll-velocity) so
+     * we don't forward there — events it cares about arrive through that
+     * channel already.
+     */
+    onClientEvent(eventName: string, eventData?: Record<string, unknown>): void;
+    /**
+     * Tear down both managers. Used by React component unmounts + during
+     * identity switches where we want a full reset.
+     */
+    destroy(): void;
+    /**
+     * Current armed campaigns visible to the InAppManager. Accessible for
+     * the Prefetch Inspector and for debugging. WidgetManager's prefetched
+     * spin_wheel / scratch_card configs are NOT in this list — they live
+     * in `this.widgets` and have their own lifecycle.
+     */
+    getCampaigns(): InAppCampaign[];
+}
+//# sourceMappingURL=AegisMessageRuntime.d.ts.map

package/dist/runtime/AegisMessageRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AegisMessageRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/AegisMessageRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE;;kEAE8D;IAC9D,aAAa,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACnD;;sDAEkD;IAClD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;0EACsE;IACtE,cAAc,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,yBAAyB;IAyB7C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAYxC;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAI/E;;;OAGG;IACH,OAAO,IAAI,IAAI;IAUf;;;;;OAKG;IACH,YAAY,IAAI,aAAa,EAAE;CAMhC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { AegisMessageRuntime } from './AegisMessageRuntime';
+export type { AegisMessageRuntimeConfig } from './AegisMessageRuntime';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@active-reach/web-sdk",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Web SDK for Active Reach Intelligence — event tracking, identity resolution, in-app messaging, web push, and placements",
   "main": "./dist/index.js",
   "module": "./dist/index.js",