@scalebun/web 1.0.0

package/dist/features/inbox/InboxFeature.js

@@ -0,0 +1,225 @@
+import { now, getReplayCoord } from '../../core';
+const INITIAL_STATE = { unreadCount: 0, total: 0, syncStatus: 'idle' };
+export class InboxFeature {
+    constructor() {
+        this.name = 'inbox';
+        this.ctx = null;
+        this.active = false;
+        // Eager subscription hub — sync subscribe() must work before the runtime chunk loads.
+        this.stateSubs = new Set();
+        this.unreadSubs = new Set();
+        this.pendingCta = new Set();
+        this.lastState = INITIAL_STATE;
+        this.controllerRef = null;
+        this.pushState = (s) => {
+            const prevUnread = this.lastState.unreadCount;
+            this.lastState = s;
+            for (const cb of this.stateSubs) {
+                try {
+                    cb(s);
+                }
+                catch { /* host cb threw */ }
+            }
+            if (s.unreadCount !== prevUnread) {
+                for (const cb of this.unreadSubs) {
+                    try {
+                        cb(s.unreadCount);
+                    }
+                    catch { /* host cb threw */ }
+                }
+            }
+        };
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined')
+            return;
+        this.active = true;
+        // Consent is enforced upstream — the bootstrap defers setup() until consent is granted, so the
+        // inbox does zero sync/persistence before consent by construction.
+        // A1.4 — refresh when the tab regains attention or the network reconnects. These only sync once the
+        // runtime is loaded (first inbox() use); no eager work, so an unused inbox stays lazy.
+        this.onVisible = () => { if (document.visibilityState === 'visible')
+            this.triggerSync(); };
+        this.onAttention = () => this.triggerSync();
+        document.addEventListener('visibilitychange', this.onVisible);
+        window.addEventListener('focus', this.onAttention);
+        window.addEventListener('online', this.onAttention);
+        // A3 — silent-push sync poke: the push SW postMessages `scalebun-inbox-sync` when a campaign is
+        // delivered to both push + inbox, so an open tab pulls the new message LIVE (not on next focus).
+        // Unlike the passive triggers above, a real delivery poke DOES load the runtime + sync — a push
+        // means content exists, so surfacing it immediately is the point.
+        if ('serviceWorker' in navigator) {
+            this.onSwMessage = (e) => {
+                const msg = e.data;
+                if (msg?.type === 'scalebun-inbox-sync') {
+                    void this.refreshNow();
+                    return;
+                }
+                // Opening a push whose campaign also landed in the inbox reads that inbox copy (correlation).
+                if (msg?.type === 'scalebun-push-click' && msg.data?.scalebunCampaignId) {
+                    const cid = msg.data.scalebunCampaignId;
+                    void this.ensureRuntime().then((rt) => rt?.markReadByCampaign(cid));
+                }
+            };
+            navigator.serviceWorker.addEventListener('message', this.onSwMessage);
+        }
+    }
+    /** Sync only if the runtime is already loaded (a passive trigger never forces the lazy chunk). */
+    triggerSync() {
+        if (this.active && this.syncEngine)
+            void this.syncEngine.sync();
+    }
+    /**
+     * Apply a dashboard-authored theme that arrived on a sync.
+     *
+     * ⚠️ Remounts only when the theme ACTUALLY CHANGED. `sync()` runs on every focus and reconnect and
+     * the response carries the theme each time, so remounting unconditionally would tear down and
+     * rebuild the panel — closing it under the user's cursor — several times a session.
+     *
+     * ⚠️ A remount reuses the ORIGINAL `mount()` options, so the host's placement survives. Losing
+     * `trigger` here would silently detach the host's own bell.
+     */
+    applyTheme(theme) {
+        const next = JSON.stringify(theme);
+        if (next === JSON.stringify(this.remoteTheme ?? null))
+            return;
+        this.remoteTheme = theme;
+        if (!this.widget)
+            return; // headless host, or not mounted yet — mount() will pick it up
+        void import('./widget/InboxWidget').then(({ mountInbox }) => {
+            this.widget?.destroy();
+            this.widget = mountInbox(this.controller(), this.mountOpts ?? {}, this.remoteTheme);
+        });
+    }
+    /** Force a pull now, loading the runtime if needed (used by the live push→inbox delivery poke). */
+    refreshNow() {
+        if (!this.active)
+            return Promise.resolve();
+        return this.ensureRuntime().then(() => { void this.syncEngine?.sync(); });
+    }
+    ensureRuntime() {
+        if (this.runtime)
+            return Promise.resolve(this.runtime);
+        if (!this.ctx)
+            return Promise.resolve(undefined);
+        if (this.loading)
+            return this.loading;
+        this.loading = (async () => {
+            const [{ InboxRuntime }, { InboxStore }] = await Promise.all([import('./runtime'), import('./store')]);
+            const store = new InboxStore(this.ctx?.deviceId || 'anon'); // per-identity (A1.4 re-scopes on identify)
+            const rt = new InboxRuntime({
+                trackEvent: (n, p) => this.ctx?.trackEvent(n, p),
+                replayCoord: getReplayCoord,
+                now,
+                onState: this.pushState,
+                store,
+            });
+            this.runtime = rt;
+            for (const cb of this.pendingCta)
+                rt.onCtaAction(cb);
+            this.pendingCta.clear();
+            await rt.hydrate(); // A1.2 — restore the persisted snapshot, then emit the real initial state
+            // A1.3 — build the delta-sync engine (shares the one store) + kick an initial pull (best-effort).
+            const { InboxSync, InboxTransport } = await import('./sync');
+            const transport = new InboxTransport(this.ctx?.apiBaseUrl ?? '', this.ctx?.clientKey ?? '', this.ctx?.deviceId ?? 'anon');
+            this.syncEngine = new InboxSync({
+                transport, store, runtime: rt,
+                onStatus: (s) => rt.setSyncStatus(s),
+                onTheme: (t) => this.applyTheme(t),
+            });
+            void this.syncEngine.sync();
+            return rt;
+        })();
+        return this.loading;
+    }
+    /** Forward a runtime method by name once the lazy chunk resolves (compact — keeps the eager shell
+     *  small against the core gate). `void`-returning methods tolerate an undefined result pre-load. */
+    call(m, ...args) {
+        return this.ensureRuntime().then((rt) => { rt?.[m]?.(...args); });
+    }
+    /** Stable headless controller (cached). Returned by the facade's `ScaleBun.inbox()`. */
+    controller() {
+        if (this.controllerRef)
+            return this.controllerRef;
+        this.controllerRef = {
+            subscribe: (cb) => {
+                this.stateSubs.add(cb);
+                cb(this.lastState);
+                void this.ensureRuntime();
+                return () => this.stateSubs.delete(cb);
+            },
+            onUnreadChange: (cb) => {
+                this.unreadSubs.add(cb);
+                cb(this.lastState.unreadCount);
+                void this.ensureRuntime();
+                return () => this.unreadSubs.delete(cb);
+            },
+            getState: () => this.lastState,
+            query: (opts) => this.ensureRuntime().then((rt) => rt ? rt.query(opts) : { messages: [], cursor: null, hasMore: false }),
+            get: (id) => this.ensureRuntime().then((rt) => rt?.get(id)),
+            markRead: (id) => this.call('markRead', id),
+            markUnread: (id) => this.call('markUnread', id),
+            markAllRead: (category) => this.call('markAllRead', category),
+            archive: (id) => this.call('archive', id),
+            unarchive: (id) => this.call('unarchive', id),
+            pin: (id, pinned) => this.call('pin', id, pinned),
+            remove: (id) => this.call('remove', id),
+            ingest: (messages) => this.call('ingest', messages),
+            act: (id, ctaKey) => { void this.call('act', id, ctaKey); },
+            mount: (opts) => {
+                if (typeof document === 'undefined')
+                    return;
+                void this.ensureRuntime().then(async () => {
+                    const { mountInbox } = await import('./widget/InboxWidget');
+                    this.widget?.destroy();
+                    this.mountOpts = opts ?? {};
+                    this.widget = mountInbox(this.controller(), this.mountOpts, this.remoteTheme);
+                });
+            },
+            open: () => this.widget?.open(),
+            close: () => this.widget?.close(),
+            // (applyTheme lives on the class — see below.)
+            unmount: () => { this.widget?.destroy(); this.widget = undefined; },
+            onCtaAction: (cb) => {
+                if (this.runtime)
+                    return this.runtime.onCtaAction(cb);
+                this.pendingCta.add(cb);
+                void this.ensureRuntime();
+                return () => { this.pendingCta.delete(cb); };
+            },
+            refresh: () => this.ensureRuntime().then(() => this.syncEngine?.sync()),
+        };
+        return this.controllerRef;
+    }
+    teardown() {
+        if (typeof window !== 'undefined') {
+            if (this.onVisible)
+                document.removeEventListener('visibilitychange', this.onVisible);
+            if (this.onAttention) {
+                window.removeEventListener('focus', this.onAttention);
+                window.removeEventListener('online', this.onAttention);
+            }
+            if (this.onSwMessage && 'serviceWorker' in navigator)
+                navigator.serviceWorker.removeEventListener('message', this.onSwMessage);
+        }
+        this.onVisible = undefined;
+        this.onAttention = undefined;
+        this.onSwMessage = undefined;
+        this.widget?.destroy();
+        this.widget = undefined;
+        this.runtime?.dispose();
+        this.runtime = undefined;
+        this.syncEngine = undefined;
+        this.loading = undefined;
+        this.stateSubs.clear();
+        this.unreadSubs.clear();
+        this.pendingCta.clear();
+        this.lastState = INITIAL_STATE;
+        this.active = false;
+    }
+}
+//# sourceMappingURL=InboxFeature.js.map

package/dist/features/inbox/InboxFeature.js.map

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

package/dist/features/inbox/runtime.d.ts

@@ -0,0 +1,67 @@
+import { type InboxStorePort } from './store';
+import type { InboxMessage, InboxQueryOptions, InboxPage, InboxState, InboxCta, InboxSyncStatus, InboxDirtyOp } from './types';
+export interface InboxRuntimeDeps {
+    trackEvent: (name: string, props?: Record<string, unknown>) => void;
+    replayCoord: () => {
+        sessionId?: string;
+        seq?: number;
+        t?: number;
+    } | undefined;
+    now: () => number;
+    /** Called on every state change so the eager shell can fan out to host subscribers. */
+    onState: (state: InboxState) => void;
+    /** Durable-tier scope (identity/device) — a per-identity IndexedDB store is opened from it. */
+    scope?: string;
+    /** Explicit durable tier — overrides `scope` (tests inject a fake; SSR gets NOOP_STORE). */
+    store?: InboxStorePort;
+}
+export declare class InboxRuntime {
+    private readonly deps;
+    private readonly mem;
+    private readonly store;
+    private unread;
+    private ctaSubs;
+    private syncStatus;
+    constructor(deps: InboxRuntimeDeps);
+    /** Load the persisted snapshot into the in-memory view, recompute unread, and emit. Idempotent —
+     *  hydrating twice merges (a message already in memory wins on a fresh session). */
+    hydrate(): Promise<void>;
+    getState(): InboxState;
+    private emitState;
+    setSyncStatus(s: InboxSyncStatus): void;
+    private stamp;
+    ingest(messages: InboxMessage[]): Promise<void>;
+    private emitUnreadAnd;
+    private transition;
+    markRead(id: string): Promise<void>;
+    markUnread(id: string): Promise<void>;
+    /** A3 push↔inbox correlation — opening the push for a campaign reads its inbox copy (so the badge
+     *  doesn't keep counting a message the user already acted on). No-op if not found / already read. */
+    markReadByCampaign(campaignId: string): Promise<void>;
+    markAllRead(category?: string): Promise<void>;
+    archive(id: string): Promise<void>;
+    unarchive(id: string): Promise<void>;
+    pin(id: string, pinned?: boolean): Promise<void>;
+    remove(id: string): Promise<void>;
+    onCtaAction(cb: (id: string, cta: InboxCta) => void): () => void;
+    act(id: string, ctaKey: string): void;
+    get(id: string): Promise<InboxMessage | undefined>;
+    query(opts?: InboxQueryOptions): Promise<InboxPage>;
+    /** Mark messages as seen (impression) — called by a UI when rows enter the viewport. */
+    markSeen(ids: string[]): Promise<void>;
+    /** Sweep expired messages (called on sync/open). priority:3 is never auto-swept. */
+    sweepExpired(): Promise<void>;
+    private recountUnread;
+    /** The outbox = every dirty (unsynced local) message, projected to a wire op. */
+    collectDirtyOps(): InboxDirtyOp[];
+    /** Merge a server pull into the model (content by revision, state by delete-wins→LWW), apply tombstones,
+     *  reconcile the unread count against the server's, persist, and emit. Preserves `_dirty` (push acks it). */
+    applyServerDelta(messages: InboxMessage[], tombstones: string[], serverUnread?: number): void;
+    /** Clear `_dirty` for pushed ops the user hasn't re-touched during the sync (stateAt/pinnedAt unchanged). */
+    ackDirty(sent: Map<string, {
+        stateAt: number;
+        pinnedAt?: number;
+    }>): void;
+    dispose(): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/features/inbox/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/features/inbox/runtime.ts"],"names":[],"mappings":"AAWA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtE,OAAO,KAAK,EACV,YAAY,EAAqB,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EACnH,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,WAAW,EAAE,MAAM;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,uFAAuF;IACvF,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AASD,qBAAa,YAAY;IAOX,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAkD;IACjE,OAAO,CAAC,UAAU,CAA2B;gBAEhB,IAAI,EAAE,gBAAgB;IAInD;wFACoF;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,QAAQ,IAAI,UAAU;IAKtB,OAAO,CAAC,SAAS;IAGjB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI;IAMvC,OAAO,CAAC,KAAK;IAMP,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BrD,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAqBZ,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C;yGACqG;IAC/F,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAIhE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAc/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIlD,KAAK,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IA4B7D,wFAAwF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,oFAAoF;IAC9E,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC,OAAO,CAAC,aAAa;IAMrB,iFAAiF;IACjF,eAAe,IAAI,YAAY,EAAE;IAQjC;iHAC6G;IAC7G,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IA6B7F,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAYzE,OAAO,IAAI,IAAI;CAKhB"}