@useragent-kit/sdk 0.0.0 → 0.0.1

package/dist/internal/api-protocol/shared/transport/transport.js

@@ -0,0 +1,420 @@
+/**
+ * Core transport layer.
+ *
+ * Ported from triangle-js-sdks `packages/host-api/src/transport.ts`,
+ * adapted for the new architecture:
+ *
+ * 1. Auto-detects incoming message format (Uint8Array → SCALE,
+ *    plain object → structured clone) and auto-upgrades the
+ *    outgoing codec when structured clone is detected.
+ * 2. Exposes a `swapCodecAdapter` method so codec negotiation can
+ *    explicitly upgrade the wire format.
+ * 3. Keeps the full API surface: `request`, `handleRequest`,
+ *    `subscribe`, `handleSubscription`, plus low-level
+ *    `postMessage` / `listenMessages`.
+ */
+import { createNanoEvents } from "nanoevents";
+import { structuredCloneCodecAdapter } from "../codec/structured/index.js";
+import { scaleCodecAdapter } from "../codec/scale/adapter.js";
+import { composeAction, delay, promiseWithResolvers } from "../util/helpers.js";
+import { createIdFactory } from "../util/idFactory.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Interval (ms) between handshake retries. */
+export const HANDSHAKE_INTERVAL = 50;
+/** Maximum time (ms) to wait for a handshake response. */
+export const HANDSHAKE_TIMEOUT = 10000;
+/**
+ * Marker value sent as the response when a request targets a method
+ * that has no registered handler. The sender detects this and rejects
+ * the promise with a `MethodNotSupported` error.
+ */
+const NOT_SUPPORTED_MARKER = { _notSupported: true };
+/** Error thrown when a request targets a method with no registered handler. */
+export class MethodNotSupportedError extends Error {
+    constructor(method) {
+        super(`Method not supported: ${method}`);
+        this.name = "MethodNotSupportedError";
+    }
+}
+/**
+ * Build a deterministic key for subscription de-duplication.
+ *
+ * Two `subscribe()` calls with the same method + payload share a
+ * single underlying wire subscription; only their callbacks differ.
+ */
+function getSubscriptionKey(method, payload) {
+    // Use a stable JSON representation.  For binary codecs this won't be
+    // as compact as a hex hash of the encoded payload, but it is
+    // codec-agnostic and still unique.
+    try {
+        return `${method}_${JSON.stringify(payload)}`;
+    }
+    catch {
+        // Fallback for non-serialisable payloads.
+        return `${method}_${String(payload)}`;
+    }
+}
+export function createTransport(options) {
+    const { provider, handshake, protocolVersionId = 1, idPrefix = "" } = options;
+    /** Codec used for encoding outgoing messages. Starts as SCALE, upgrades to structured clone. */
+    let codecAdapter = scaleCodecAdapter;
+    /**
+     * Decode an incoming message by inspecting its shape:
+     * - Uint8Array → SCALE decode
+     * - Object with `requestId` → structured clone (identity)
+     *
+     * When a structured clone message is detected, the outgoing codec
+     * is automatically upgraded to structured clone as well (preferred).
+     */
+    function decodeIncoming(message) {
+        if (message instanceof Uint8Array ||
+            (typeof message === "object" &&
+                message !== null &&
+                message.constructor?.name === "Uint8Array")) {
+            return scaleCodecAdapter.decode(message);
+        }
+        if (typeof message === "object" &&
+            message !== null &&
+            "requestId" in message) {
+            // Upgrade outgoing codec to structured clone on first structured clone message.
+            codecAdapter = structuredCloneCodecAdapter;
+            return message;
+        }
+        throw new Error("Unrecognized message format");
+    }
+    const nextId = createIdFactory(idPrefix);
+    const handshakeAbortController = new AbortController();
+    let handshakePromise;
+    let connectionStatus = "disconnected";
+    let disposed = false;
+    const events = createNanoEvents();
+    events.on("connectionStatus", (value) => {
+        connectionStatus = value;
+    });
+    function changeConnectionStatus(status) {
+        events.emit("connectionStatus", status);
+    }
+    function throwIfDisposed() {
+        if (disposed) {
+            throw new Error("Transport is disposed");
+        }
+    }
+    // -- Subscription multiplexing --------------------------------------------
+    const activeSubscriptions = new Map();
+    // -- Handler tracking (for not-supported detection) -----------------------
+    /** Actions that have registered handlers. */
+    const handledActions = new Set();
+    // -- Transport implementation ---------------------------------------------
+    const transport = {
+        swapCodecAdapter(adapter) {
+            codecAdapter = adapter;
+        },
+        // -- Handshake ----------------------------------------------------------
+        whenReady() {
+            throwIfDisposed();
+            return handshakePromise;
+        },
+        // -- Request / Response -------------------------------------------------
+        async request(method, payload, signal) {
+            throwIfDisposed();
+            await transport.whenReady();
+            signal?.throwIfAborted();
+            const requestId = nextId();
+            const requestAction = composeAction(method, "request");
+            const responseAction = composeAction(method, "response");
+            const { resolve, reject, promise } = promiseWithResolvers();
+            const cleanup = () => {
+                unsubscribe();
+                signal?.removeEventListener("abort", onAbort);
+            };
+            const onAbort = () => {
+                cleanup();
+                reject(signal?.reason ?? new Error("Request aborted"));
+            };
+            const unsubscribe = transport.listenMessages(responseAction, (receivedId, value) => {
+                if (receivedId === requestId) {
+                    cleanup();
+                    const v = value;
+                    if (v && v._notSupported) {
+                        reject(new MethodNotSupportedError(method));
+                    }
+                    else {
+                        resolve(value);
+                    }
+                }
+            });
+            signal?.addEventListener("abort", onAbort, { once: true });
+            transport.postMessage(requestId, { tag: requestAction, value: payload });
+            return promise;
+        },
+        // -- Handle incoming requests (host side) -------------------------------
+        handleRequest(method, handler) {
+            throwIfDisposed();
+            const requestAction = composeAction(method, "request");
+            const responseAction = composeAction(method, "response");
+            return transport.listenMessages(requestAction, (requestId, value) => {
+                void Promise.resolve(handler(value)).then((result) => {
+                    transport.postMessage(requestId, { tag: responseAction, value: result });
+                });
+            });
+        },
+        // -- Subscriptions (product side) ---------------------------------------
+        subscribe(method, payload, callback) {
+            throwIfDisposed();
+            const subEvents = createNanoEvents();
+            const startAction = composeAction(method, "start");
+            const startPayload = { tag: startAction, value: payload };
+            const subscriptionKey = getSubscriptionKey(method, startPayload);
+            let subscription = activeSubscriptions.get(subscriptionKey);
+            function unsub() {
+                const sub = activeSubscriptions.get(subscriptionKey);
+                if (sub) {
+                    const remaining = sub.listeners.filter((l) => l.call !== callback);
+                    if (remaining.length === 0) {
+                        activeSubscriptions.delete(subscriptionKey);
+                        sub.kill();
+                    }
+                    else {
+                        sub.listeners = remaining;
+                    }
+                }
+            }
+            const listener = {
+                call: callback,
+                unsubscribe: unsub,
+            };
+            const publicSubscription = {
+                unsubscribe: unsub,
+                onInterrupt(cb) {
+                    return subEvents.on("interrupt", cb);
+                },
+            };
+            if (!subscription) {
+                const requestId = nextId();
+                const stopAction = composeAction(method, "stop");
+                const interruptAction = composeAction(method, "interrupt");
+                const receiveAction = composeAction(method, "receive");
+                const unsubscribeReceive = transport.listenMessages(receiveAction, (receivedId, value) => {
+                    if (receivedId === requestId) {
+                        const sub = activeSubscriptions.get(subscriptionKey);
+                        if (sub) {
+                            for (const l of sub.listeners) {
+                                l.call(value);
+                            }
+                        }
+                    }
+                });
+                const unsubscribeInterrupt = transport.listenMessages(interruptAction, (receivedId) => {
+                    if (receivedId === requestId) {
+                        subEvents.emit("interrupt");
+                        stopSubscription();
+                    }
+                });
+                const stopSubscription = () => {
+                    unsubscribeReceive();
+                    unsubscribeInterrupt();
+                    subEvents.events = {};
+                };
+                subscription = {
+                    requestId,
+                    kill: () => {
+                        stopSubscription();
+                        transport.postMessage(requestId, { tag: stopAction, value: undefined });
+                    },
+                    listeners: [listener],
+                };
+                activeSubscriptions.set(subscriptionKey, subscription);
+                transport.postMessage(requestId, startPayload);
+            }
+            else {
+                subscription.listeners.push(listener);
+            }
+            return publicSubscription;
+        },
+        // -- Handle subscriptions (host side) -----------------------------------
+        handleSubscription(method, handler) {
+            throwIfDisposed();
+            const startAction = composeAction(method, "start");
+            const stopAction = composeAction(method, "stop");
+            const interruptAction = composeAction(method, "interrupt");
+            const receiveAction = composeAction(method, "receive");
+            const subscriptions = new Map();
+            const unsubStart = transport.listenMessages(startAction, (requestId, value) => {
+                if (subscriptions.has(requestId))
+                    return;
+                let interrupted = false;
+                const unsubscribe = handler(value, 
+                // send callback
+                (value) => {
+                    transport.postMessage(requestId, { tag: receiveAction, value });
+                }, 
+                // interrupt callback
+                () => {
+                    interrupted = true;
+                    subscriptions.delete(requestId);
+                    transport.postMessage(requestId, { tag: interruptAction, value: undefined });
+                });
+                if (interrupted) {
+                    unsubscribe();
+                }
+                else {
+                    subscriptions.set(requestId, unsubscribe);
+                }
+            });
+            const unsubStop = transport.listenMessages(stopAction, (requestId) => {
+                subscriptions.get(requestId)?.();
+                subscriptions.delete(requestId);
+            });
+            return () => {
+                subscriptions.forEach((unsub) => unsub());
+                subscriptions.clear();
+                unsubStart();
+                unsubStop();
+            };
+        },
+        // -- Low-level message I/O ---------------------------------------------
+        postMessage(requestId, payload) {
+            throwIfDisposed();
+            const message = { requestId, payload };
+            const encoded = codecAdapter.encode(message);
+            provider.postMessage(encoded);
+        },
+        listenMessages(action, callback, onError) {
+            // Track _request/_start actions so the not-supported catch-all
+            // doesn't fire for actions that have low-level listeners.
+            const isHandlerAction = action.endsWith("_request") || action.endsWith("_start");
+            if (isHandlerAction) {
+                handledActions.add(action);
+            }
+            const unsubscribe = provider.subscribe((message) => {
+                try {
+                    const result = decodeIncoming(message);
+                    if (result.payload.tag === action) {
+                        callback(result.requestId, result.payload.value);
+                    }
+                }
+                catch (e) {
+                    onError?.(e);
+                }
+            });
+            return () => {
+                unsubscribe();
+                if (isHandlerAction) {
+                    handledActions.delete(action);
+                }
+            };
+        },
+        // -- Connection status --------------------------------------------------
+        onConnectionStatusChange(callback) {
+            callback(connectionStatus);
+            return events.on("connectionStatus", callback);
+        },
+        onDestroy(callback) {
+            return events.on("destroy", callback);
+        },
+        // -- Lifecycle -----------------------------------------------------------
+        destroy() {
+            disposed = true;
+            provider.dispose();
+            changeConnectionStatus("disconnected");
+            events.emit("destroy");
+            events.events = {};
+            handshakeAbortController.abort("Transport disposed");
+        },
+    };
+    // -- Not-supported catch-all -----------------------------------------------
+    //
+    // Responds immediately to any _request or _start message that has no
+    // registered handler, so the sender doesn't wait forever.
+    provider.subscribe((message) => {
+        try {
+            const result = decodeIncoming(message);
+            const { tag } = result.payload;
+            if (tag.endsWith("_request") && !handledActions.has(tag)) {
+                const responseTag = tag.replace(/_request$/, "_response");
+                transport.postMessage(result.requestId, { tag: responseTag, value: NOT_SUPPORTED_MARKER });
+            }
+            else if (tag.endsWith("_start") && !handledActions.has(tag)) {
+                const interruptTag = tag.replace(/_start$/, "_interrupt");
+                transport.postMessage(result.requestId, { tag: interruptTag, value: undefined });
+            }
+        }
+        catch {
+            // Ignore decode errors — handled by listenMessages subscribers.
+        }
+    });
+    // -- Handshake setup -------------------------------------------------------
+    if (handshake === "respond") {
+        // Host side: register handler and resolve whenReady() when the first
+        // handshake request arrives and is successfully responded to.
+        const { resolve: resolveHandshake, reject: rejectHandshake, promise, } = promiseWithResolvers();
+        handshakePromise = promise;
+        transport.handleRequest("host_handshake", async (version) => {
+            if (version.tag === "v1" && version.value === protocolVersionId) {
+                changeConnectionStatus("connected");
+                resolveHandshake();
+                return { tag: "v1", value: { success: true, value: undefined } };
+            }
+            return {
+                tag: "v1",
+                value: { success: false, value: { tag: "UnsupportedProtocolVersion", value: undefined } },
+            };
+        });
+        // Reject on disposal so whenReady() doesn't hang forever.
+        events.on("destroy", () => rejectHandshake(new Error("Transport destroyed before handshake completed")));
+        // Suppress unhandled rejection — callers that care will await whenReady().
+        handshakePromise.catch(() => { });
+    }
+    else {
+        // Product side: eagerly start sending handshake requests.
+        changeConnectionStatus("connecting");
+        const performHandshake = () => {
+            const id = nextId();
+            const cleanup = (interval, unsubscribe) => {
+                clearInterval(interval);
+                unsubscribe();
+                handshakeAbortController.signal.removeEventListener("abort", unsubscribe);
+            };
+            return new Promise((resolve, reject) => {
+                const unsubscribe = transport.listenMessages("host_handshake_response", (responseId) => {
+                    if (responseId === id) {
+                        cleanup(interval, unsubscribe);
+                        resolve();
+                    }
+                });
+                handshakeAbortController.signal.addEventListener("abort", unsubscribe, {
+                    once: true,
+                });
+                const interval = setInterval(() => {
+                    if (handshakeAbortController.signal.aborted) {
+                        clearInterval(interval);
+                        reject(new Error("Handshake aborted"));
+                        return;
+                    }
+                    transport.postMessage(id, {
+                        tag: "host_handshake_request",
+                        value: { tag: "v1", value: protocolVersionId },
+                    });
+                }, HANDSHAKE_INTERVAL);
+            });
+        };
+        handshakePromise = Promise.race([
+            performHandshake(),
+            delay(HANDSHAKE_TIMEOUT).then(() => {
+                handshakeAbortController.abort("Timeout");
+                throw new Error("Handshake timed out");
+            }),
+        ]).then(() => {
+            changeConnectionStatus("connected");
+        }, (err) => {
+            changeConnectionStatus("disconnected");
+            throw err;
+        });
+        // Suppress unhandled rejection — callers that care will await whenReady().
+        handshakePromise.catch(() => { });
+    }
+    return transport;
+}
+//# sourceMappingURL=transport.js.map

package/dist/internal/api-protocol/shared/transport/transport.js.map

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

package/dist/internal/api-protocol/shared/transport/windowProvider.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Window-based provider.
+ *
+ * Implements the Provider interface targeting a Window reference,
+ * using `window.postMessage` for bidirectional communication.
+ *
+ * Accepts either a direct Window reference or a Promise that resolves
+ * to one (e.g. when the iframe hasn't loaded yet). Messages sent before
+ * the promise resolves are delivered once the window becomes available.
+ */
+import type { Provider } from "./provider.js";
+export declare function createWindowProvider(targetOrPromise: Window | Promise<Window>): Provider;
+//# sourceMappingURL=windowProvider.d.ts.map

package/dist/internal/api-protocol/shared/transport/windowProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/internal/api-protocol/shared/transport/windowProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA2B9C,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CA4DxF"}

package/dist/internal/api-protocol/shared/transport/windowProvider.js

@@ -0,0 +1,85 @@
+/**
+ * Window-based provider.
+ *
+ * Implements the Provider interface targeting a Window reference,
+ * using `window.postMessage` for bidirectional communication.
+ *
+ * Accepts either a direct Window reference or a Promise that resolves
+ * to one (e.g. when the iframe hasn't loaded yet). Messages sent before
+ * the promise resolves are delivered once the window becomes available.
+ */
+function isProtocolMessage(data) {
+    return (typeof data === "object" &&
+        data !== null &&
+        "requestId" in data &&
+        "payload" in data);
+}
+function isValidMessage(event, sourceWindow, currentWindow) {
+    return (sourceWindow !== undefined &&
+        event.source !== currentWindow &&
+        event.source === sourceWindow &&
+        event.data != null &&
+        (event.data instanceof Uint8Array ||
+            (typeof event.data === "object" && event.data.constructor?.name === "Uint8Array") ||
+            isProtocolMessage(event.data)));
+}
+export function createWindowProvider(targetOrPromise) {
+    let disposed = false;
+    let targetWindow;
+    const subscribers = new Set();
+    const targetReady = targetOrPromise instanceof Promise ? targetOrPromise : Promise.resolve(targetOrPromise);
+    targetReady.then((w) => {
+        if (disposed)
+            return;
+        targetWindow = w;
+    });
+    function withWindow(fn) {
+        if (targetWindow) {
+            fn(targetWindow);
+        }
+        else {
+            targetReady.then((w) => {
+                if (!disposed)
+                    fn(w);
+            });
+        }
+    }
+    const messageHandler = (event) => {
+        if (disposed)
+            return;
+        if (!isValidMessage(event, targetWindow, window))
+            return;
+        for (const subscriber of subscribers) {
+            subscriber(event.data);
+        }
+    };
+    window.addEventListener("message", messageHandler);
+    return {
+        postMessage(message) {
+            if (disposed)
+                return;
+            withWindow((w) => {
+                if (disposed)
+                    return;
+                if (message instanceof Uint8Array) {
+                    w.postMessage(message, "*", [message.buffer]);
+                }
+                else {
+                    w.postMessage(message, "*");
+                }
+            });
+        },
+        subscribe(callback) {
+            subscribers.add(callback);
+            return () => {
+                subscribers.delete(callback);
+            };
+        },
+        dispose() {
+            disposed = true;
+            subscribers.clear();
+            window.removeEventListener("message", messageHandler);
+        },
+    };
+}
+//# sourceMappingURL=windowProvider.js.map

package/dist/internal/api-protocol/shared/transport/windowProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowProvider.js","sourceRoot":"","sources":["../../../../../src/internal/api-protocol/shared/transport/windowProvider.ts"],"names":[],"mappings":"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"}

package/dist/internal/api-protocol/shared/util/helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Miscellaneous helper utilities ported from triangle-js-sdks.
+ */
+/**
+ * Return a promise that resolves after `ttl` milliseconds.
+ */
+export declare function delay(ttl: number): Promise<void>;
+/**
+ * Ponyfill for `Promise.withResolvers()` (available natively from ES2024).
+ */
+export declare function promiseWithResolvers<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason: unknown) => void;
+};
+/**
+ * Build an action string from a method name and a suffix.
+ *
+ * Example: `composeAction('host_account_get', 'request')` produces
+ * `'host_account_get_request'`.
+ */
+export declare function composeAction<M extends string, S extends string>(method: M, suffix: S): `${M}_${S}`;
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ */
+export declare function extractErrorMessage(err: unknown): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/internal/api-protocol/shared/util/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/internal/api-protocol/shared/util/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,KAAK;IACzC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAQA;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC9D,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,GACR,GAAG,CAAC,IAAI,CAAC,EAAE,CAEb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQxD"}

package/dist/internal/api-protocol/shared/util/helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Miscellaneous helper utilities ported from triangle-js-sdks.
+ */
+/**
+ * Return a promise that resolves after `ttl` milliseconds.
+ */
+export function delay(ttl) {
+    return new Promise((resolve) => setTimeout(resolve, ttl));
+}
+/**
+ * Ponyfill for `Promise.withResolvers()` (available natively from ES2024).
+ */
+export function promiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
+/**
+ * Build an action string from a method name and a suffix.
+ *
+ * Example: `composeAction('host_account_get', 'request')` produces
+ * `'host_account_get_request'`.
+ */
+export function composeAction(method, suffix) {
+    return `${method}_${suffix}`;
+}
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ */
+export function extractErrorMessage(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    if (err) {
+        return String(err);
+    }
+    return "Unknown error occurred.";
+}
+//# sourceMappingURL=helpers.js.map

package/dist/internal/api-protocol/shared/util/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/internal/api-protocol/shared/util/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAKlC,IAAI,OAA4B,CAAC;IACjC,IAAI,MAAkC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,OAAO,GAAG,GAAG,CAAC;QACd,MAAM,GAAG,GAAG,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAS,EACT,MAAS;IAET,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,yBAAyB,CAAC;AACnC,CAAC"}

package/dist/internal/api-protocol/shared/util/idFactory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Request-ID generation.
+ *
+ * Each factory has its own independent counter with a prefix
+ * (e.g. "h:" for host, "p:" for product) so IDs from both sides
+ * never collide on the shared postMessage channel.
+ */
+export declare function createIdFactory(prefix: string): () => string;
+//# sourceMappingURL=idFactory.d.ts.map

package/dist/internal/api-protocol/shared/util/idFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idFactory.d.ts","sourceRoot":"","sources":["../../../../../src/internal/api-protocol/shared/util/idFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,MAAM,CAG5D"}

package/dist/internal/api-protocol/shared/util/idFactory.js

@@ -0,0 +1,12 @@
+/**
+ * Request-ID generation.
+ *
+ * Each factory has its own independent counter with a prefix
+ * (e.g. "h:" for host, "p:" for product) so IDs from both sides
+ * never collide on the shared postMessage channel.
+ */
+export function createIdFactory(prefix) {
+    let id = 0;
+    return () => `${prefix}${++id}`;
+}
+//# sourceMappingURL=idFactory.js.map