@nommos/core 0.0.40 → 0.0.43

package/src/lib/popup-inbox.js

@@ -0,0 +1,397 @@
+import { POPUP_AUTO_OPEN_KEY, POPUP_INTERRUPTIVE_PRIORITIES, POPUP_PUSH_OPEN_COOLDOWN_MS, resolveEndpoints, POPUP_INBOX_CACHE_KEY, POPUP_LAUNCHER_HIDDEN_KEY, POPUP_MAX_ITEMS, POPUP_TOPIC_PREFIX, } from './constants';
+import { ANALYTICS_ACTION_STATE } from './enums';
+import { PopupViewer } from './popup-viewer';
+const EVENT_STATE = {
+    // Not engagement at all — a push landed while the viewer was closed.
+    arrival_nudge: ANALYTICS_ACTION_STATE.INIT,
+    // Span opens, and everything that happens while it is open.
+    auto_open: ANALYTICS_ACTION_STATE.SELECT,
+    manual_open: ANALYTICS_ACTION_STATE.SELECT,
+    viewed: ANALYTICS_ACTION_STATE.SELECT,
+    carousel_next: ANALYTICS_ACTION_STATE.SELECT,
+    carousel_prev: ANALYTICS_ACTION_STATE.SELECT,
+    link_click: ANALYTICS_ACTION_STATE.SELECT,
+    // The conversion. SUBMIT leaves the span open, which is correct — a CTA opens in a new tab.
+    cta_click: ANALYTICS_ACTION_STATE.SUBMIT,
+    // Span closes. `dismissed` is terminal, `abandoned` means they left with it still open.
+    closed: ANALYTICS_ACTION_STATE.UNSELECT,
+    dismissed: ANALYTICS_ACTION_STATE.UNSELECT,
+    abandoned: ANALYTICS_ACTION_STATE.UNSELECT,
+    render_failed: ANALYTICS_ACTION_STATE.FAILURE,
+};
+/**
+ * The visitor-facing half of CRM web popups: fetches the inbox, decides what to show, and reports
+ * what happened.
+ *
+ * <p>Implements {@link ConsentAwareModule} with `id: 'marketing'`, so the consent manager starts
+ * and stops it exactly as it does ad tracking. Nothing here runs — no fetch, no subscription, no
+ * DOM — until marketing consent is granted.
+ */
+export class PopupInbox {
+    constructor(deps) {
+        this.deps = deps;
+        this.id = 'marketing';
+        this.supportsRuntimeShutdown = true;
+        this.initialized = false;
+        this.items = [];
+        this.etag = null;
+        /** In-memory only: popup bodies are large and stale ones must not outlive the page. */
+        this.contentCache = new Map();
+        this.topic = null;
+        /** Ids the visitor has already been shown a launcher for, so an arrival can be told from a re-read. */
+        this.knownIds = new Set();
+        /** False until the first inbox read of this page load has landed — see {@link refresh}. */
+        this.settled = false;
+        /** Epoch ms of the last push that opened itself; 0 means none this page. */
+        this.lastPushOpenAt = 0;
+        this.popupEndpoint = resolveEndpoints(deps.cfg.mode, deps.cfg.baseUrl).popup;
+        this.viewer = new PopupViewer({
+            loadContent: (id) => this.content(id),
+            onOpened: (item, trigger) => this.handleOpened(item, trigger),
+            onClosed: (item) => this.emit('closed', this.meta(item)),
+            onAbandoned: (item) => this.emit('abandoned', this.meta(item)),
+            onDismissed: (item) => void this.dismiss(item),
+            onCtaClick: (item, buttonIndex, url) => this.handleCtaClick(item, buttonIndex, url),
+            onLinkClick: (item, url) => this.emit('link_click', { ...this.meta(item), url }),
+            onCarouselMove: (item, direction) => this.emit(direction === 'next' ? 'carousel_next' : 'carousel_prev', this.meta(item)),
+            onRenderFailed: (item, reason) => this.emit('render_failed', { ...this.meta(item), reason }),
+        });
+    }
+    // ── ConsentAwareModule ─────────────────────────────────────────────────────
+    async initialize() {
+        if (this.initialized || typeof window === 'undefined')
+            return;
+        if (!this.deps.hasMarketingConsent())
+            return;
+        this.initialized = true;
+        this.restoreCache();
+        this.listen();
+        await this.refresh();
+        await this.autoOpen();
+    }
+    /** Revocation must leave nothing behind: no viewer, no cache, no subscription. */
+    async shutdown() {
+        if (!this.initialized)
+            return;
+        this.initialized = false;
+        if (this.topic) {
+            this.deps.unsubscribeTopic(this.topic);
+            this.topic = null;
+        }
+        this.viewer.teardown();
+        await this.purge();
+    }
+    async purge() {
+        this.items = [];
+        this.etag = null;
+        this.knownIds.clear();
+        this.settled = false;
+        this.lastPushOpenAt = 0;
+        this.contentCache.clear();
+        try {
+            sessionStorage.removeItem(POPUP_INBOX_CACHE_KEY);
+            sessionStorage.removeItem(POPUP_AUTO_OPEN_KEY);
+            sessionStorage.removeItem(POPUP_LAUNCHER_HIDDEN_KEY);
+        }
+        catch {
+            /* storage unavailable — nothing cached to clear */
+        }
+    }
+    isInitialized() {
+        return this.initialized;
+    }
+    // ── Public surface ─────────────────────────────────────────────────────────
+    getInbox() {
+        return {
+            items: [...this.items],
+            unreadCount: this.items.filter((item) => item.status !== 'VIEWED').length,
+        };
+    }
+    async openViewer(id) {
+        if (!this.initialized)
+            return;
+        await this.viewer.open(id, 'manual');
+    }
+    // ── Inbox ──────────────────────────────────────────────────────────────────
+    /**
+     * Revalidates against the server with `If-None-Match`. A 304 keeps whatever is already cached,
+     * which is what stops a long-lived tab from sitting on a popup that was dismissed elsewhere
+     * while still avoiding a full payload on every SPA route change.
+     */
+    async refresh() {
+        if (!this.initialized)
+            return;
+        try {
+            const response = await fetch(`${this.popupEndpoint}/inbox`, { headers: this.headers() });
+            if (response.status === 304)
+                return;
+            if (!response.ok) {
+                this.warn(`inbox fetch failed: ${response.status}`);
+                return;
+            }
+            this.etag = response.headers.get('ETag');
+            const payload = await response.json();
+            this.items = Array.isArray(payload?.popups) ? payload.popups.slice(0, POPUP_MAX_ITEMS) : [];
+            this.persistCache();
+            this.viewer.setItems(this.items);
+            this.nudgeIfArrived();
+            // Prefetch only the one that is about to open. Fetching all three would put the whole
+            // payload back on the critical path, which is the reason /inbox is metadata-only.
+            if (this.items.length > 0)
+                void this.content(this.items[0].id);
+        }
+        catch (error) {
+            this.warn(`inbox fetch failed: ${String(error)}`);
+        }
+    }
+    /**
+     * Reacts to popups that landed mid-session — by opening one if it is urgent enough, otherwise
+     * by shaking the launcher and chiming.
+     *
+     * <p>Deliberately silent on the first read of a page load and on the cache restore: those are
+     * the same inbox the visitor already has, and buzzing on every page view — or every SPA route
+     * change — would train them to ignore it. It also stays quiet while the viewer is open, since
+     * the popup on screen is already the notification. In practice that leaves the WebSocket push,
+     * which is exactly the case this exists for.
+     *
+     * <p><b>Whether an arrival takes over the screen is the author's call, not ours.</b> Seizing the
+     * screen of someone mid-task on the tenant's own site is expensive, so only HIGH and CRITICAL do
+     * it; everything else waits behind the launcher. The per-page-visit cap that governs
+     * {@link autoOpen} does not apply here — a push is a new event, not a replay of an inbox the
+     * visitor already had — so {@link POPUP_PUSH_OPEN_COOLDOWN_MS} is what stops a burst of sends
+     * from repeatedly taking over.
+     */
+    nudgeIfArrived() {
+        const incoming = new Set(this.items.map((item) => item.id));
+        const arrived = this.items.filter((item) => !this.knownIds.has(item.id));
+        const firstRead = !this.settled;
+        this.knownIds = incoming;
+        this.settled = true;
+        if (firstRead || arrived.length === 0 || this.viewer.isVisible())
+            return;
+        const urgent = arrived.find((item) => POPUP_INTERRUPTIVE_PRIORITIES.includes((item.priority ?? '').toUpperCase()));
+        if (urgent && this.pushOpenAllowed()) {
+            this.lastPushOpenAt = Date.now();
+            // No arrival_nudge here: the popup opening in front of the visitor *is* the notification,
+            // and reporting both would double-count one arrival. The open reports itself as `auto_open`.
+            void this.viewer.open(urgent.id, 'auto');
+            return;
+        }
+        // Carry the top-ranked arrival's identity, not just a bare marker: a nudge you cannot join to
+        // a popup answers "how often do we buzz" but not "did buzzing get it opened", which is the
+        // only reason to measure it.
+        this.emit('arrival_nudge', { ...this.meta(arrived[0]), arrived_count: arrived.length });
+        this.viewer.notifyArrival();
+    }
+    pushOpenAllowed() {
+        return Date.now() - this.lastPushOpenAt >= POPUP_PUSH_OPEN_COOLDOWN_MS;
+    }
+    async content(id) {
+        const cached = this.contentCache.get(id);
+        if (cached)
+            return cached;
+        try {
+            const response = await fetch(`${this.popupEndpoint}/${id}/content`, { headers: this.headers() });
+            if (response.status === 404) {
+                // Listed in the inbox but no longer showable — the inbox we are working from is stale.
+                this.dropItem(id);
+                return null;
+            }
+            if (!response.ok)
+                return null;
+            const content = (await response.json());
+            this.contentCache.set(id, content);
+            return content;
+        }
+        catch (error) {
+            this.warn(`content fetch failed: ${String(error)}`);
+            return null;
+        }
+    }
+    /** Exactly one popup opens by itself per page visit; the rest wait behind the launcher. */
+    async autoOpen() {
+        if (this.items.length === 0 || this.alreadyAutoOpened())
+            return;
+        this.markAutoOpened();
+        await this.viewer.open(this.items[0].id, 'auto');
+    }
+    // ── Lifecycle reporting ────────────────────────────────────────────────────
+    handleOpened(item, trigger) {
+        this.emit(trigger === 'auto' ? 'auto_open' : 'manual_open', this.meta(item));
+        if (item.status === 'VIEWED')
+            return;
+        this.emit('viewed', this.meta(item));
+        // Optimistic: the badge should drop the moment it is opened, not a round trip later.
+        const previous = item.status;
+        item.status = 'VIEWED';
+        this.persistCache();
+        this.viewer.setItems(this.items);
+        // ...but optimism has to be revocable, and the two ways it can fail need opposite answers.
+        // A 404 means the popup is gone for this visitor, so restoring "unread" would strand a phantom
+        // nothing can ever clear. Anything else is transient, so put the status back and let the next
+        // open retry it.
+        void this.post(`${item.id}/view`).then((status) => {
+            if (status === 404) {
+                this.dropItem(item.id);
+                return;
+            }
+            if (status >= 200 && status < 300)
+                return;
+            if (item.status !== 'VIEWED')
+                return;
+            item.status = previous;
+            this.persistCache();
+            this.viewer.setItems(this.items);
+        });
+    }
+    handleCtaClick(item, buttonIndex, url) {
+        this.emit('cta_click', { ...this.meta(item), button_index: buttonIndex, url });
+        void this.post(`${item.id}/cta-click`, { buttonIndex });
+    }
+    async dismiss(item) {
+        this.emit('dismissed', this.meta(item));
+        await this.post(`${item.id}/dismiss`);
+        this.items = this.items.filter((candidate) => candidate.id !== item.id);
+        this.contentCache.delete(item.id);
+        this.persistCache();
+        this.viewer.setItems(this.items);
+        if (this.items.length === 0)
+            this.viewer.teardown();
+    }
+    /**
+     * @returns whether the server accepted the transition.
+     *
+     * <p>The status is checked, not just the absence of a throw. `fetch` rejects only on a network
+     * failure — a 401 or a 404 resolves normally — so a bare try/catch here reported every rejected
+     * lifecycle call as a success. Since these calls are made optimistically, that turned a server
+     * refusal into a local state that quietly disagreed with the server until the next reload put it
+     * back: the visitor marks everything read, reloads, and the unread badge returns.
+     */
+    async post(path, body) {
+        try {
+            const response = await fetch(`${this.popupEndpoint}/${path}`, {
+                method: 'POST',
+                headers: { ...this.headers(), 'Content-Type': 'application/json' },
+                body: JSON.stringify(body ?? {}),
+                // A CTA that navigates in the current tab unloads the page, and the browser cancels
+                // in-flight requests when it does — losing exactly the click being recorded. `keepalive`
+                // lets the request outlive the document.
+                keepalive: true,
+            });
+            if (!response.ok) {
+                this.warn(`lifecycle call ${path} rejected: ${response.status}`);
+            }
+            return response.status;
+        }
+        catch (error) {
+            this.warn(`lifecycle call ${path} failed: ${String(error)}`);
+            return 0; // network failure, not a verdict from the server
+        }
+    }
+    /**
+     * Forgets a popup the server will no longer serve.
+     *
+     * <p>A 404 from a lifecycle or content call is a verdict, not a hiccup: the entry is gone,
+     * expired, or dismissed elsewhere, and every future call for it will fail the same way. Holding
+     * on to it strands a phantom in the inbox that can never be read — it cannot be marked viewed,
+     * because the call that would mark it is the one returning 404 — so the unread badge survives
+     * every reload with no way for the visitor to clear it.
+     */
+    dropItem(id) {
+        if (!this.items.some((item) => item.id === id))
+            return;
+        this.warn(`dropping popup ${id}: the server no longer serves it`);
+        this.items = this.items.filter((item) => item.id !== id);
+        this.knownIds.delete(id);
+        this.contentCache.delete(id);
+        this.persistCache();
+        this.viewer.setItems(this.items);
+    }
+    // ── Push ───────────────────────────────────────────────────────────────────
+    listen() {
+        if (!this.deps.cfg.brand_id || !this.deps.browserId)
+            return;
+        this.topic = `${POPUP_TOPIC_PREFIX}.${this.deps.cfg.brand_id}.${this.deps.browserId}`;
+        this.deps.subscribeTopic(this.topic, () => {
+            // The push is a nudge, not a payload: it says "your inbox changed", and the fetch that
+            // follows re-applies the server's ordering and cap rather than trusting the message.
+            void this.refresh();
+        });
+    }
+    // ── Plumbing ───────────────────────────────────────────────────────────────
+    headers() {
+        const headers = {};
+        if (this.deps.cfg.wsToken)
+            headers['Authorization'] = `Bearer ${this.deps.cfg.wsToken}`;
+        if (this.deps.cfg.consentRef)
+            headers['x-nommos-consent-ref'] = this.deps.cfg.consentRef;
+        if (this.deps.cfg.consentReceiptId)
+            headers['x-nommos-consent-receipt-id'] = this.deps.cfg.consentReceiptId;
+        if (this.etag)
+            headers['If-None-Match'] = this.etag;
+        return headers;
+    }
+    /** Single exit for analytics, so no call site can forget the state that goes with its event. */
+    emit(event, data) {
+        this.deps.emit(event, data, EVENT_STATE[event]);
+    }
+    meta(item) {
+        return {
+            notification_type: 'WEB_POPUP',
+            popup_id: item.id,
+            template_id: item.templateId,
+            // Attribution: without these the dashboard can say a popup was opened but not which
+            // broadcast or journey sent it.
+            campaign_id: item.sourceCampaignId,
+            popup_source: item.source,
+            priority: item.priority,
+        };
+    }
+    restoreCache() {
+        try {
+            const raw = sessionStorage.getItem(POPUP_INBOX_CACHE_KEY);
+            if (!raw)
+                return;
+            const cached = JSON.parse(raw);
+            this.items = Array.isArray(cached.items) ? cached.items : [];
+            this.etag = cached.etag ?? null;
+            this.knownIds = new Set(this.items.map((item) => item.id));
+            if (this.items.length > 0)
+                this.viewer.setItems(this.items);
+        }
+        catch {
+            /* unreadable cache — a fresh fetch replaces it */
+        }
+    }
+    persistCache() {
+        try {
+            const payload = { etag: this.etag, items: this.items };
+            sessionStorage.setItem(POPUP_INBOX_CACHE_KEY, JSON.stringify(payload));
+        }
+        catch {
+            /* storage full or blocked — the cache is an optimisation, not a requirement */
+        }
+    }
+    alreadyAutoOpened() {
+        try {
+            return sessionStorage.getItem(POPUP_AUTO_OPEN_KEY) === '1';
+        }
+        catch {
+            return false;
+        }
+    }
+    markAutoOpened() {
+        try {
+            sessionStorage.setItem(POPUP_AUTO_OPEN_KEY, '1');
+        }
+        catch {
+            /* storage unavailable — worst case the popup auto-opens again next navigation */
+        }
+    }
+    warn(message) {
+        if (this.deps.cfg.mode === 'dev') {
+            console.warn('[Nommos Tracker] popup', message);
+        }
+    }
+}
+//# sourceMappingURL=popup-inbox.js.map

package/src/lib/popup-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-inbox.js","sourceRoot":"","sources":["../../../../../nommos/core/src/lib/popup-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiD7C,MAAM,WAAW,GAAwC;IACvD,qEAAqE;IACrE,aAAa,EAAE,sBAAsB,CAAC,IAAI;IAE1C,4DAA4D;IAC5D,SAAS,EAAE,sBAAsB,CAAC,MAAM;IACxC,WAAW,EAAE,sBAAsB,CAAC,MAAM;IAC1C,MAAM,EAAE,sBAAsB,CAAC,MAAM;IACrC,aAAa,EAAE,sBAAsB,CAAC,MAAM;IAC5C,aAAa,EAAE,sBAAsB,CAAC,MAAM;IAC5C,UAAU,EAAE,sBAAsB,CAAC,MAAM;IAEzC,4FAA4F;IAC5F,SAAS,EAAE,sBAAsB,CAAC,MAAM;IAExC,wFAAwF;IACxF,MAAM,EAAE,sBAAsB,CAAC,QAAQ;IACvC,SAAS,EAAE,sBAAsB,CAAC,QAAQ;IAC1C,SAAS,EAAE,sBAAsB,CAAC,QAAQ;IAE1C,aAAa,EAAE,sBAAsB,CAAC,OAAO;CAC9C,CAAC;AA+BF;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IAoBrB,YAA6B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;QAnBxC,OAAE,GAAG,WAAoB,CAAC;QAC1B,4BAAuB,GAAG,IAAI,CAAC;QAEhC,gBAAW,GAAG,KAAK,CAAC;QACpB,UAAK,GAAmB,EAAE,CAAC;QAC3B,SAAI,GAAkB,IAAI,CAAC;QACnC,uFAAuF;QACtE,iBAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;QAE3D,UAAK,GAAkB,IAAI,CAAC;QACpC,uGAAuG;QAC/F,aAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,2FAA2F;QACnF,YAAO,GAAG,KAAK,CAAC;QACxB,4EAA4E;QACpE,mBAAc,GAAG,CAAC,CAAC;QAKzB,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;QAC7E,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC;YAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;YAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC;YACnF,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YAChF,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAClC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtF,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;SAC7F,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAE9E,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAAE,OAAO;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,cAAc,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACjD,cAAc,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC/C,cAAc,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,8EAA8E;IAE9E,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YACtB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;SAC1E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAW;QAC1B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,8EAA8E;IAE9E;;;;OAIG;IACK,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO;YACpC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,sFAAsF;YACtF,kFAAkF;YAClF,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACK,cAAc;QACpB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YAAE,OAAO;QAEzE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACnC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAC5E,CAAC;QACF,IAAI,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,0FAA0F;YAC1F,6FAA6F;YAC7F,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,8FAA8F;QAC9F,2FAA2F;QAC3F,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAC9B,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,IAAI,2BAA2B,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,EAAU;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACjG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,uFAAuF;gBACvF,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC9B,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,2FAA2F;IACnF,KAAK,CAAC,QAAQ;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE;YAAE,OAAO;QAChE,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,8EAA8E;IAEtE,YAAY,CAAC,IAAkB,EAAE,OAA0B;QACjE,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QAErC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,qFAAqF;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,2FAA2F;QAC3F,+FAA+F;QAC/F,8FAA8F;QAC9F,iBAAiB;QACjB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAChD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;gBAAE,OAAO;YAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO;YACrC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YACvB,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,IAAkB,EAAE,WAAmB,EAAE,GAAW;QACzE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAkB;QACtC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAA8B;QAC7D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAClE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;gBAChC,oFAAoF;gBACpF,yFAAyF;gBACzF,yCAAyC;gBACzC,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,CAAC,CAAC,iDAAiD;QAC7D,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,QAAQ,CAAC,EAAU;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YAAE,OAAO;QACvD,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,kCAAkC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,8EAA8E;IAEtE,MAAM;QACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5D,IAAI,CAAC,KAAK,GAAG,GAAG,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtF,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE;YACxC,uFAAuF;YACvF,qFAAqF;YACrF,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAEtE,OAAO;QACb,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxF,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QACzF,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,OAAO,CAAC,6BAA6B,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC5G,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gGAAgG;IACxF,IAAI,CAAC,KAAiB,EAAE,IAA6B;QAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAEO,IAAI,CAAC,IAAkB;QAC7B,OAAO;YACL,iBAAiB,EAAE,WAAW;YAC9B,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,oFAAoF;YACpF,gCAAgC;YAChC,WAAW,EAAE,IAAI,CAAC,gBAAgB;YAClC,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;YAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC;YACH,MAAM,OAAO,GAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACpE,cAAc,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,+EAA+E;QACjF,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC;YACH,OAAO,cAAc,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,GAAG,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC;YACH,cAAc,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,iFAAiF;QACnF,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,OAAe;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF"}

package/src/lib/popup-viewer.d.ts

@@ -0,0 +1,180 @@
+import { WebPopupContent, WebPopupItem } from './types';
+export interface PopupViewerCallbacks {
+    /** Content for a popup, fetched lazily. Resolves null when it can no longer be shown. */
+    loadContent: (id: number) => Promise<WebPopupContent | null>;
+    onOpened: (item: WebPopupItem, trigger: 'auto' | 'manual') => void;
+    /** The viewer was closed. Not a dismissal — the popup stays in the inbox. */
+    onClosed: (item: WebPopupItem) => void;
+    /**
+     * The visitor left the page with the popup still open. Distinct from `onClosed` — "walked away"
+     * and "deliberately shut it" are different engagement signals — and it is what stops an
+     * engagement span from running forever when the tab simply goes away.
+     */
+    onAbandoned: (item: WebPopupItem) => void;
+    onDismissed: (item: WebPopupItem) => void;
+    onCtaClick: (item: WebPopupItem, buttonIndex: number, url: string) => void;
+    onLinkClick: (item: WebPopupItem, url: string) => void;
+    onCarouselMove: (item: WebPopupItem, direction: 'next' | 'prev') => void;
+    onRenderFailed: (item: WebPopupItem, reason: string) => void;
+}
+export declare class PopupViewer {
+    private readonly callbacks;
+    private host;
+    private root;
+    private state;
+    private launcherHost;
+    private launcherRoot;
+    /** The element the launcher is currently mounted into. `null` means the floating fallback. */
+    private anchor;
+    private domObserver;
+    private remountQueued;
+    /** Resolved once per viewer: the visitor's language does not change mid-page. */
+    private readonly copy;
+    private items;
+    /** What is on screen. Only moves once the next popup's content is in hand. */
+    private index;
+    /**
+     * Where the visitor has navigated to, which runs ahead of {@link index} while a load is in
+     * flight. Without it, two quick taps on `›` both step from the same rendered index and the
+     * second is swallowed.
+     */
+    private pendingIndex;
+    /** Guards against a slow content load landing after a later move and rewinding the carousel. */
+    private swapToken;
+    private lastFocused;
+    private touchStartX;
+    private audio;
+    private readonly onKeyDown;
+    private readonly onViewportChange;
+    private readonly onPageHide;
+    constructor(callbacks: PopupViewerCallbacks);
+    setItems(items: WebPopupItem[]): void;
+    /** Removes every trace of the viewer. Called on consent revocation and on an empty inbox. */
+    teardown(): void;
+    isVisible(): boolean;
+    open(id: number | undefined, trigger: 'auto' | 'manual'): Promise<void>;
+    close(): void;
+    private ensureHost;
+    private handlePageHide;
+    /**
+     * The launcher gets a host of its own rather than sharing the modal's.
+     *
+     * <p>It has to, because the two have opposite placement needs. The modal is `position: fixed` and
+     * must resolve against the viewport, but `fixed` resolves against the nearest ancestor carrying a
+     * `transform`, `filter` or `contain` — which sticky headers routinely do. Mounting one shared host
+     * inside a tenant's header would therefore drag the modal in with it and clip it to the header.
+     */
+    private ensureLauncherHost;
+    /**
+     * @returns the integrator's chosen mount point, or null for the floating fallback.
+     */
+    private resolveAnchor;
+    /** Places the launcher host under the current anchor, or under `body` when there is none. */
+    private mountLauncher;
+    /**
+     * Follows the anchor for the life of the page. A one-shot query at init would almost always miss
+     * it: the SDK boots from a script tag, while an Angular or React tenant renders its header
+     * afterwards. This also covers the anchor being removed or swapped on an SPA route change.
+     *
+     * <p>The callback fires on every DOM change the tenant's app makes, so it must stay cheap — it
+     * only re-resolves and compares, and a burst of mutations collapses into one remount per frame.
+     */
+    private observeDom;
+    /**
+     * Whether the launcher shows at all depends on where it lives — the two placements have opposite
+     * defaults, and that is deliberate.
+     *
+     * <p><b>Floating</b> shows only while something is unread. A permanent button parked over
+     * someone else's page with nothing behind it is clutter, so once the visitor has seen everything
+     * it disappears. The cost is real: a read-but-undismissed popup then has no way back for the rest
+     * of the session, short of the host app calling {@link PopupInbox.openViewer}.
+     *
+     * <p><b>Anchored</b> always shows. The tenant deliberately reserved a slot in their own header,
+     * so vacating it leaves a hole their layout collapses around — a flex or grid {@code gap} still
+     * applies to a zero-width item — and a header bell that vanishes reads as broken chrome rather
+     * than as tidiness. Persisting also restores the way back, so a popup closed by accident can be
+     * reopened.
+     */
+    private renderLauncher;
+    /**
+     * Hiding is per page session and deliberately weaker than dismissing: it silences the launcher
+     * for a visitor who does not want it in the corner right now, but a genuinely new popup clears
+     * it again (see {@link notifyArrival}) because that is a new reason to be shown.
+     */
+    private launcherHidden;
+    private setLauncherHidden;
+    /**
+     * A popup arrived while the visitor was already on the page. Without this the only signal is a
+     * small badge appearing in a corner nobody is looking at, so shake the launcher and play a short
+     * chime. Callers suppress it for first load, cache restore and the auto-open path — see
+     * `PopupInbox.refresh`.
+     */
+    notifyArrival(): void;
+    /**
+     * Synthesised rather than loaded from a file: a popup renders on the *tenant's* origin, so any
+     * asset URL is one more thing that can 404 or trip CORS on someone else's domain.
+     *
+     * <p>Autoplay policy blocks audio until the page has had a user gesture. If the context is
+     * suspended we skip silently instead of calling `resume()` — the shake already carries the
+     * signal, and a warning in the tenant's console would be noise they cannot act on.
+     */
+    private chime;
+    static soundEnabled(): boolean;
+    static setSoundEnabled(enabled: boolean): void;
+    /** @returns false when there is nothing renderable, so the caller can abort the open. */
+    private renderCurrent;
+    private renderBodyIfVisible;
+    /**
+     * Picks the variant by viewport width, falling back to whichever one exists — a template with
+     * only a desktop variant should still show on a phone rather than showing nothing.
+     */
+    private bodyFor;
+    private applyVariantCss;
+    private shell;
+    private ctaMarkup;
+    private dotsMarkup;
+    private isMobileViewport;
+    /**
+     * One delegated listener covers the chrome and the authored body alike, which is what lets an
+     * ordinary `<a href>` inside a template be attributed without any script in the popup.
+     */
+    private handleClick;
+    /**
+     * Closes the viewer after a link has been followed, without dismissing.
+     *
+     * <p>Closing rather than dismissing is deliberate and matches the backend, where
+     * {@code recordCtaClick} only marks the popup viewed: a visitor who clicks through has engaged,
+     * not refused, and can reopen the message from the launcher.
+     *
+     * <p>{@link close} hides the overlay rather than detaching it, which is what makes this safe to
+     * call from inside the click. Removing the anchor from the document mid-dispatch can cancel the
+     * navigation it was about to perform; hiding an ancestor cannot.
+     */
+    private closeAfterFollowing;
+    /**
+     * Moves the carousel by one, keeping the current popup on screen until the next one is ready.
+     *
+     * <p>This used to re-render the whole modal through {@link renderCurrent}, which tore the shell
+     * down to a loading placeholder before awaiting the content. Content is cached after its first
+     * fetch, so the await almost always resolved on the next microtask — but "almost always" still
+     * paints one frame of collapsed spinner, which is what read as a flicker. Loading first and
+     * swapping second means the visitor never sees an intermediate state.
+     */
+    private move;
+    /**
+     * Cross-slides the authored body, leaving the chrome untouched.
+     *
+     * <p>Only `.np-stage`'s children change, so the underbar, the chips and the dialog itself never
+     * re-render — the frame stays put while the content moves through it.
+     */
+    private swapBody;
+    /** Repoints the dots without rebuilding them, so the underbar never repaints mid-swipe. */
+    private syncDots;
+    private prefersReducedMotion;
+    private handleKeyDown;
+    /** Keeps keyboard focus inside the dialog while it is open. */
+    private trapFocus;
+    private focusDialog;
+    private handleTouchStart;
+    private handleTouchEnd;
+}