asyar-sdk 1.16.2 → 2.0.0

package/dist/services/ExtensionRpc.js

@@ -0,0 +1,277 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { BaseServiceProxy } from './BaseServiceProxy';
+import { emitRpcLog } from '../ipc/devInspectorBridge';
+const DEFAULT_TIMEOUT_MS = 5000;
+export class ExtensionRpc extends BaseServiceProxy {
+    constructor() {
+        super(...arguments);
+        // ── view-side state ─────────────────────────────────────────────────────
+        this.pending = new Map();
+        this.viewListenerInstalled = false;
+        this.pagehideInstalled = false;
+        // ── worker-side state ───────────────────────────────────────────────────
+        this.handlers = new Map();
+        this.inFlight = new Map();
+    }
+    // ── view-side: request / abort ──────────────────────────────────────────
+    /**
+     * Send a request to this extension's worker. Resolves with the worker's
+     * return value; rejects on worker-side throw, on host RPC error, or on
+     * timeout (default 5000 ms, overridable via `opts.timeoutMs`).
+     *
+     * Generates a correlation id, enqueues via `state:rpcRequest`, stores a
+     * pending-reply entry keyed by the id, starts a timer. Reply arrival
+     * (via `asyar:event:state:rpc-reply:push`) resolves/rejects the entry
+     * and cancels the timer. Timeout rejects, fires `state:rpcAbort` so the
+     * worker handler's AbortSignal trips, and removes the entry so a stale
+     * reply is silently dropped.
+     */
+    request(id, payload, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            this.ensureViewListener();
+            const timeoutMs = (_a = opts === null || opts === void 0 ? void 0 : opts.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MS;
+            const correlationId = this.generateCorrelationId();
+            const startedAt = Date.now();
+            emitRpcLog({
+                phase: 'request',
+                id,
+                correlationId,
+                payload,
+                timeoutMs,
+                timestamp: startedAt,
+                extensionId: this.extensionId || undefined,
+            });
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    const entry = this.pending.get(correlationId);
+                    if (!entry || entry.settled)
+                        return;
+                    entry.settled = true;
+                    this.pending.delete(correlationId);
+                    emitRpcLog({
+                        phase: 'timeout',
+                        id: entry.id,
+                        correlationId,
+                        elapsedMs: Date.now() - entry.startedAt,
+                        timestamp: Date.now(),
+                        extensionId: this.extensionId || undefined,
+                    });
+                    // Best-effort abort notification to the worker.
+                    this.broker
+                        .invoke('state:rpcAbort', { correlationId })
+                        .catch(() => { });
+                    reject(new Error(`RPC timeout after ${timeoutMs}ms for id=${id}`));
+                }, timeoutMs);
+                this.pending.set(correlationId, {
+                    resolve,
+                    reject,
+                    timer,
+                    settled: false,
+                    startedAt,
+                    id,
+                    timeoutMs,
+                });
+                // Fire-and-forget the enqueue; the reply comes back through the
+                // push listener, not this invoke's resolution.
+                this.broker
+                    .invoke('state:rpcRequest', { id, correlationId, payload })
+                    .catch((err) => {
+                    const entry = this.pending.get(correlationId);
+                    if (!entry || entry.settled)
+                        return;
+                    entry.settled = true;
+                    clearTimeout(entry.timer);
+                    this.pending.delete(correlationId);
+                    const msg = err instanceof Error ? err.message : String(err);
+                    emitRpcLog({
+                        phase: 'rejected',
+                        id: entry.id,
+                        correlationId,
+                        error: msg,
+                        elapsedMs: Date.now() - entry.startedAt,
+                        timestamp: Date.now(),
+                        extensionId: this.extensionId || undefined,
+                    });
+                    reject(err instanceof Error ? err : new Error(String(err)));
+                });
+            });
+        });
+    }
+    /**
+     * Install the view-side `asyar:event:state:rpc-reply:push` listener.
+     * Idempotent. Callers: the view-entry factory.
+     */
+    installViewMessageListener() {
+        this.ensureViewListener();
+    }
+    /**
+     * Install a `pagehide` listener that drops every pending reply so the
+     * next view mount sees no zombie state. Stale replies arriving post-
+     * pagehide are dropped silently.
+     */
+    installViewAutoCleanup() {
+        if (this.pagehideInstalled)
+            return;
+        this.pagehideInstalled = true;
+        if (typeof window === 'undefined')
+            return;
+        window.addEventListener('pagehide', () => this.disposeAllPending());
+    }
+    /**
+     * Clear every pending-reply entry. Exposed (not private) so tests can
+     * trigger the same cleanup pagehide would run.
+     */
+    disposeAllPending() {
+        for (const entry of this.pending.values()) {
+            entry.settled = true;
+            clearTimeout(entry.timer);
+        }
+        this.pending.clear();
+    }
+    ensureViewListener() {
+        if (this.viewListenerInstalled)
+            return;
+        this.viewListenerInstalled = true;
+        this.broker.on('asyar:event:state:rpc-reply:push', (payload) => {
+            if (!payload || typeof payload !== 'object')
+                return;
+            const p = payload;
+            if (typeof p.correlationId !== 'string')
+                return;
+            const entry = this.pending.get(p.correlationId);
+            if (!entry || entry.settled)
+                return;
+            entry.settled = true;
+            clearTimeout(entry.timer);
+            this.pending.delete(p.correlationId);
+            const elapsedMs = Date.now() - entry.startedAt;
+            if (typeof p.error === 'string') {
+                emitRpcLog({
+                    phase: 'rejected',
+                    id: entry.id,
+                    correlationId: p.correlationId,
+                    error: p.error,
+                    elapsedMs,
+                    timestamp: Date.now(),
+                    extensionId: this.extensionId || undefined,
+                });
+                entry.reject(new Error(p.error));
+            }
+            else {
+                emitRpcLog({
+                    phase: 'resolved',
+                    id: entry.id,
+                    correlationId: p.correlationId,
+                    result: p.result,
+                    elapsedMs,
+                    timestamp: Date.now(),
+                    extensionId: this.extensionId || undefined,
+                });
+                entry.resolve(p.result);
+            }
+        });
+    }
+    generateCorrelationId() {
+        // Correlation ids only need to be unique within one extension's view
+        // iframe for the lifetime of one pending request. Math.random twice
+        // concatenated gives ~15 bytes of entropy which is more than enough.
+        return (Math.random().toString(36).slice(2, 15) +
+            Math.random().toString(36).slice(2, 15));
+    }
+    // ── worker-side: onRequest / delivery / abort ──────────────────────────
+    /**
+     * Register a handler for `id`. Overwrites any previous handler for the
+     * same id; extensions that need fan-out can branch inside the handler.
+     */
+    onRequest(id, handler) {
+        this.handlers.set(id, handler);
+        return () => {
+            if (this.handlers.get(id) === handler)
+                this.handlers.delete(id);
+        };
+    }
+    /**
+     * Install the worker-side delivery shim. This method exists so tests can
+     * trigger the listener installation explicitly; the worker entry-point
+     * factory calls it once at bootstrap.
+     *
+     * The SDK inspects every `asyar:action:execute` message for a top-level
+     * `__rpc__` discriminator and routes RPC envelopes here. The glue lives
+     * in the worker entry factory (it has the `window` handle). This class
+     * only exposes [`deliverActionPayload`] so the factory can feed one
+     * payload at a time.
+     */
+    installWorkerMessageListener() {
+        // No-op: the wiring lives in the worker entry factory. This method
+        // makes the SDK surface symmetric with the view-side equivalent and
+        // gives tests a stable hook that doesn't drag in the factory.
+    }
+    /**
+     * Test + factory entry: hand one `asyar:action:execute` payload to the
+     * RPC dispatcher. Non-RPC payloads are ignored (the factory should not
+     * call this for those; tests do).
+     */
+    deliverActionPayload(payload) {
+        if (!payload || typeof payload !== 'object')
+            return;
+        const p = payload;
+        if (p.__rpc__ === 'request') {
+            if (typeof p.id !== 'string' || typeof p.correlationId !== 'string')
+                return;
+            this.dispatchRequest(p.id, p.correlationId, p.payload);
+        }
+        else if (p.__rpc__ === 'abort') {
+            if (typeof p.correlationId !== 'string')
+                return;
+            this.dispatchAbort(p.correlationId);
+        }
+    }
+    dispatchRequest(id, correlationId, payload) {
+        const handler = this.handlers.get(id);
+        if (!handler) {
+            this.broker
+                .invoke('state:rpcReply', {
+                correlationId,
+                error: `No handler registered for RPC id "${id}"`,
+            })
+                .catch(() => { });
+            return;
+        }
+        const controller = new AbortController();
+        this.inFlight.set(correlationId, { controller });
+        void (() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield handler(payload, controller.signal);
+                this.inFlight.delete(correlationId);
+                yield this.broker
+                    .invoke('state:rpcReply', { correlationId, result })
+                    .catch(() => { });
+            }
+            catch (err) {
+                this.inFlight.delete(correlationId);
+                const msg = err instanceof Error ? err.message : String(err);
+                yield this.broker
+                    .invoke('state:rpcReply', { correlationId, error: msg })
+                    .catch(() => { });
+            }
+        }))();
+    }
+    dispatchAbort(correlationId) {
+        const h = this.inFlight.get(correlationId);
+        if (!h)
+            return;
+        h.controller.abort();
+        this.inFlight.delete(correlationId);
+    }
+}
+export const extensionRpc = new ExtensionRpc();
+//# sourceMappingURL=ExtensionRpc.js.map

package/dist/services/ExtensionRpc.js.map

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

package/dist/services/ExtensionRpc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ExtensionRpc.test.d.ts.map

package/dist/services/ExtensionRpc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRpc.test.d.ts","sourceRoot":"","sources":["../../src/services/ExtensionRpc.test.ts"],"names":[],"mappings":""}

package/dist/services/ExtensionRpc.test.js

@@ -0,0 +1,259 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/** @vitest-environment jsdom */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { messageBroker } from '../ipc/MessageBroker';
+import { ExtensionRpc, extensionRpc } from './ExtensionRpc';
+describe('ExtensionRpc', () => {
+    let invokeSpy;
+    let onSpy;
+    let pushHandlers;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        invokeSpy = vi.spyOn(messageBroker, 'invoke');
+        pushHandlers = new Map();
+        onSpy = vi.spyOn(messageBroker, 'on').mockImplementation(((event, handler) => {
+            var _a;
+            const list = (_a = pushHandlers.get(event)) !== null && _a !== void 0 ? _a : [];
+            list.push(handler);
+            pushHandlers.set(event, list);
+        }));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        invokeSpy.mockRestore();
+        onSpy.mockRestore();
+    });
+    function deliverPush(event, payload) {
+        var _a;
+        for (const h of (_a = pushHandlers.get(event)) !== null && _a !== void 0 ? _a : [])
+            h(payload);
+    }
+    // ── view-side: request → reply happy path ──────────────────────────────
+    it('request invokes state:rpcRequest with id, correlationId, payload', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('start', { minutes: 25 });
+        // Microtask for the await on broker.invoke inside request.
+        yield Promise.resolve();
+        expect(invokeSpy).toHaveBeenCalledTimes(1);
+        const [type, payload] = invokeSpy.mock.calls[0];
+        expect(type).toBe('state:rpcRequest');
+        expect(payload).toMatchObject({
+            id: 'start',
+            payload: { minutes: 25 },
+        });
+        const correlationId = payload.correlationId;
+        expect(typeof correlationId).toBe('string');
+        expect(correlationId.length).toBeGreaterThan(0);
+        // Deliver the reply.
+        deliverPush('asyar:event:state:rpc-reply:push', {
+            correlationId,
+            result: { ok: true },
+        });
+        expect(yield promise).toEqual({ ok: true });
+    }));
+    it('request rejects when the reply carries an error', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('start', {});
+        yield Promise.resolve();
+        const correlationId = invokeSpy.mock.calls[0][1].correlationId;
+        deliverPush('asyar:event:state:rpc-reply:push', {
+            correlationId,
+            error: 'handler threw',
+        });
+        yield expect(promise).rejects.toThrow(/handler threw/);
+    }));
+    // ── timeout & abort ────────────────────────────────────────────────────
+    it('request rejects after default 5000ms timeout', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('slow', {});
+        yield Promise.resolve();
+        vi.advanceTimersByTime(4999);
+        // Still pending.
+        let settled = false;
+        promise.catch(() => {
+            settled = true;
+        });
+        yield Promise.resolve();
+        expect(settled).toBe(false);
+        vi.advanceTimersByTime(2);
+        yield expect(promise).rejects.toThrow(/timeout/i);
+    }));
+    it('request honours per-call timeoutMs override', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('slow', {}, { timeoutMs: 100 });
+        yield Promise.resolve();
+        vi.advanceTimersByTime(101);
+        yield expect(promise).rejects.toThrow(/timeout/i);
+    }));
+    it('on timeout, fires state:rpcAbort to the worker so the in-flight handler can bail', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('slow', {}, { timeoutMs: 50 });
+        yield Promise.resolve();
+        const corrId = invokeSpy.mock.calls[0][1].correlationId;
+        invokeSpy.mockClear();
+        vi.advanceTimersByTime(60);
+        yield promise.catch(() => { });
+        const abortCall = invokeSpy.mock.calls.find((c) => c[0] === 'state:rpcAbort');
+        expect(abortCall).toBeDefined();
+        expect(abortCall[1]).toEqual({ correlationId: corrId });
+    }));
+    it('stale reply arriving after timeout is silently dropped (no double settle)', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('slow', {}, { timeoutMs: 10 });
+        yield Promise.resolve();
+        const corrId = invokeSpy.mock.calls[0][1].correlationId;
+        vi.advanceTimersByTime(20);
+        yield expect(promise).rejects.toThrow(/timeout/i);
+        // Stale reply arrives: must not throw, must not warn loudly.
+        expect(() => deliverPush('asyar:event:state:rpc-reply:push', {
+            correlationId: corrId,
+            result: { tooLate: true },
+        })).not.toThrow();
+    }));
+    it('pagehide clears pending-reply entries silently', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeSpy.mockResolvedValue(undefined);
+        const rpc = new ExtensionRpc();
+        rpc.installViewMessageListener();
+        const promise = rpc.request('slow', {}, { timeoutMs: 60000 });
+        yield Promise.resolve();
+        rpc.disposeAllPending();
+        // pagehide cleanup leaves the promise pending until next mount; the
+        // contract is "no zombie state survives". We assert by attempting to
+        // settle with a stale reply and observing nothing fires.
+        deliverPush('asyar:event:state:rpc-reply:push', {
+            correlationId: invokeSpy.mock.calls[0][1].correlationId,
+            result: 'should be dropped',
+        });
+        let resolved = undefined;
+        promise.then((r) => (resolved = r)).catch(() => { });
+        yield Promise.resolve();
+        expect(resolved).toBeUndefined();
+    }));
+    // ── worker-side: onRequest dispatches matching id with abort signal ────
+    it('onRequest registers a handler that fires when matching __rpc__:request arrives', () => __awaiter(void 0, void 0, void 0, function* () {
+        const rpc = new ExtensionRpc();
+        rpc.installWorkerMessageListener();
+        const handler = vi.fn().mockResolvedValue({ done: true });
+        rpc.onRequest('start', handler);
+        invokeSpy.mockResolvedValue(undefined);
+        rpc.deliverActionPayload({
+            __rpc__: 'request',
+            id: 'start',
+            correlationId: 'c1',
+            payload: { x: 1 },
+        });
+        yield Promise.resolve();
+        yield Promise.resolve();
+        expect(handler).toHaveBeenCalledTimes(1);
+        const [callPayload, signal] = handler.mock.calls[0];
+        expect(callPayload).toEqual({ x: 1 });
+        expect(signal).toBeInstanceOf(AbortSignal);
+        expect(signal.aborted).toBe(false);
+    }));
+    it('worker-side handler reply is sent via state:rpcReply', () => __awaiter(void 0, void 0, void 0, function* () {
+        const rpc = new ExtensionRpc();
+        rpc.installWorkerMessageListener();
+        rpc.onRequest('start', () => __awaiter(void 0, void 0, void 0, function* () { return ({ done: true }); }));
+        invokeSpy.mockResolvedValue(undefined);
+        rpc.deliverActionPayload({
+            __rpc__: 'request',
+            id: 'start',
+            correlationId: 'c1',
+            payload: {},
+        });
+        // Wait for the async handler to resolve and the reply to be sent.
+        yield Promise.resolve();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const reply = invokeSpy.mock.calls.find((c) => c[0] === 'state:rpcReply');
+        expect(reply).toBeDefined();
+        expect(reply[1]).toEqual({
+            correlationId: 'c1',
+            result: { done: true },
+        });
+    }));
+    it('worker-side handler error is forwarded as { error } in state:rpcReply', () => __awaiter(void 0, void 0, void 0, function* () {
+        const rpc = new ExtensionRpc();
+        rpc.installWorkerMessageListener();
+        rpc.onRequest('start', () => __awaiter(void 0, void 0, void 0, function* () {
+            throw new Error('boom');
+        }));
+        invokeSpy.mockResolvedValue(undefined);
+        rpc.deliverActionPayload({
+            __rpc__: 'request',
+            id: 'start',
+            correlationId: 'c1',
+            payload: {},
+        });
+        yield Promise.resolve();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const reply = invokeSpy.mock.calls.find((c) => c[0] === 'state:rpcReply');
+        expect(reply).toBeDefined();
+        expect(reply[1].error).toMatch(/boom/);
+    }));
+    it('__rpc__:abort fires the AbortSignal on the in-flight handler', () => __awaiter(void 0, void 0, void 0, function* () {
+        const rpc = new ExtensionRpc();
+        rpc.installWorkerMessageListener();
+        let capturedSignal;
+        rpc.onRequest('slow', (_payload, signal) => new Promise(() => {
+            capturedSignal = signal;
+        }));
+        invokeSpy.mockResolvedValue(undefined);
+        rpc.deliverActionPayload({
+            __rpc__: 'request',
+            id: 'slow',
+            correlationId: 'c1',
+            payload: {},
+        });
+        yield Promise.resolve();
+        expect(capturedSignal).toBeDefined();
+        expect(capturedSignal.aborted).toBe(false);
+        rpc.deliverActionPayload({
+            __rpc__: 'abort',
+            correlationId: 'c1',
+        });
+        expect(capturedSignal.aborted).toBe(true);
+    }));
+    it('worker-side: __rpc__:request for an unregistered id returns an error reply', () => __awaiter(void 0, void 0, void 0, function* () {
+        const rpc = new ExtensionRpc();
+        rpc.installWorkerMessageListener();
+        invokeSpy.mockResolvedValue(undefined);
+        rpc.deliverActionPayload({
+            __rpc__: 'request',
+            id: 'unregistered',
+            correlationId: 'c1',
+            payload: {},
+        });
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const reply = invokeSpy.mock.calls.find((c) => c[0] === 'state:rpcReply');
+        expect(reply).toBeDefined();
+        expect(reply[1].error).toMatch(/unregistered|no handler/i);
+    }));
+    // ── singleton ──────────────────────────────────────────────────────────
+    it('exports a module-singleton instance', () => {
+        expect(extensionRpc).toBeInstanceOf(ExtensionRpc);
+    });
+});
+//# sourceMappingURL=ExtensionRpc.test.js.map

package/dist/services/ExtensionRpc.test.js.map

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

package/dist/services/ExtensionStateProxy.d.ts

@@ -0,0 +1,44 @@
+import { BaseServiceProxy } from './BaseServiceProxy';
+/**
+ * SDK proxy for the launcher-brokered extension state store.
+ *
+ * Worker-side: `get`, `set`, `subscribe`, `unsubscribe`.
+ * View-side:   `get`, `subscribe`, `unsubscribe` (no `set` — writes are
+ *              worker-owned by convention, enforced at the role-scoped
+ *              entry-point projection in `asyar-sdk/view` which omits `set`
+ *              from the exposed surface).
+ *
+ * Per-extension scoping is enforced by the launcher's `ExtensionIpcRouter`,
+ * which auto-injects the calling extension's id from the iframe's verified
+ * origin (see `INJECTS_EXTENSION_ID`). The SDK proxy never passes an
+ * extensionId; the host rejects any attempt to cross extension boundaries
+ * without this proxy needing to know the id.
+ */
+type StateHandler = (value: unknown) => void;
+export declare class ExtensionStateProxy extends BaseServiceProxy {
+    private pushListenerInstalled;
+    private readonly subs;
+    private pagehideInstalled;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    /**
+     * Register a subscriber for `(this-extension, key)` in the current role.
+     * Returns a disposer that issues `state:unsubscribe` when called. The
+     * disposer is idempotent — calling it twice is harmless.
+     */
+    subscribe(key: string, handler: StateHandler): Promise<() => Promise<void>>;
+    /**
+     * Install a one-shot `pagehide` listener on `window` that fires
+     * `state:unsubscribe` for every active subscription. Called by the
+     * view-side entry-point factory; worker-side projections skip this
+     * because the worker iframe only unmounts on disable/uninstall and the
+     * launcher's uninstall path calls `state:clear` which drops every
+     * subscription server-side anyway.
+     */
+    installViewAutoUnsubscribe(): void;
+    private ensurePushListener;
+    private resolveRole;
+}
+export declare const extensionStateProxy: ExtensionStateProxy;
+export {};
+//# sourceMappingURL=ExtensionStateProxy.d.ts.map

package/dist/services/ExtensionStateProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionStateProxy.d.ts","sourceRoot":"","sources":["../../src/services/ExtensionStateProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AAEH,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAU7C,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyC;IAC9D,OAAO,CAAC,iBAAiB,CAAS;IAE5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;;;OAIG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAoBjF;;;;;;;OAOG;IACH,0BAA0B,IAAI,IAAI;IAgBlC,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,WAAW;CAUpB;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}