@openlv/session 0.1.3 → 0.3.1

package/dist/dynamic.d.ts

@@ -0,0 +1,2 @@
+export declare const loadSignaling: (protocol: string) => Promise<import("@openlv/signaling").SignalingProtocol>;
+export declare const loadTransport: (protocol: string) => Promise<import("@openlv/transport").Transport>;

package/dist/dynamic.js

@@ -0,0 +1,26 @@
+import { match } from "ts-pattern";
+export const loadSignaling = async (protocol) => match(protocol)
+    .with("mqtt", async () => {
+    const module_ = await import("@openlv/signaling/mqtt");
+    return module_.mqtt;
+})
+    .with("ntfy", async () => {
+    const module_ = await import("@openlv/signaling/ntfy");
+    return module_.ntfy;
+})
+    .with("gun", async () => {
+    const module_ = await import("@openlv/signaling/gundb");
+    return module_.gundb;
+})
+    .otherwise(() => {
+    throw new Error(`Unknown signaling protocol: ${protocol}`);
+});
+export const loadTransport = async (protocol) => match(protocol)
+    .with("webrtc", async () => {
+    const module_ = await import("@openlv/transport/webrtc");
+    return module_.webrtc;
+})
+    .otherwise(() => {
+    throw new Error(`Unknown transport protocol: ${protocol}`);
+});
+//# sourceMappingURL=dynamic.js.map

package/dist/dynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.js","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;KACrE,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;IACvB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEvD,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC,CAAC;KACD,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;IACvB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEvD,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC,CAAC;KACD,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;IACtB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAExD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC,CAAC;KACD,SAAS,CAAC,GAAG,EAAE;IACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;KACrE,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IACzB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEzD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC,CAAC;KACD,SAAS,CAAC,GAAG,EAAE;IACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC","sourcesContent":["import { match } from \"ts-pattern\";\n\nexport const loadSignaling = async (protocol: string) => match(protocol)\n  .with(\"mqtt\", async () => {\n    const module_ = await import(\"@openlv/signaling/mqtt\");\n\n    return module_.mqtt;\n  })\n  .with(\"ntfy\", async () => {\n    const module_ = await import(\"@openlv/signaling/ntfy\");\n\n    return module_.ntfy;\n  })\n  .with(\"gun\", async () => {\n    const module_ = await import(\"@openlv/signaling/gundb\");\n\n    return module_.gundb;\n  })\n  .otherwise(() => {\n    throw new Error(`Unknown signaling protocol: ${protocol}`);\n  });\n\nexport const loadTransport = async (protocol: string) => match(protocol)\n  .with(\"webrtc\", async () => {\n    const module_ = await import(\"@openlv/transport/webrtc\");\n\n    return module_.webrtc;\n  })\n  .otherwise(() => {\n    throw new Error(`Unknown transport protocol: ${protocol}`);\n  });\n"]}

package/dist/events.d.ts

@@ -1,10 +1,8 @@
-import type { SessionStateObject } from "./index.js";
 export type SessionEvents = {
-    state_change: (state?: SessionStateObject) => void;
     /**
-       * Emitted when a request arrives from the remote peer — before the reply
-       * is sent. Useful for observability, logging, or UI integration without
-       * needing to intercept the `onMessage` callback.
-       */
-    request: (payload: object | string) => void;
+     * Emitted when a request arrives from the remote peer -- before the reply
+     * is sent. Useful for observability, logging, or UI integration without
+     * needing to intercept the `onMessage` callback.
+     */
+    request: (payload: unknown) => void;
 };

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"","sourcesContent":["import type { SessionStateObject } from \"./index.js\";\n\nexport type SessionEvents = {\n  state_change: (state?: SessionStateObject) => void;\n  /**\n     * Emitted when a request arrives from the remote peer — before the reply\n     * is sent. Useful for observability, logging, or UI integration without\n     * needing to intercept the `onMessage` callback.\n     */\n  request: (payload: object | string) => void;\n};\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"","sourcesContent":["export type SessionEvents = {\n  /**\n   * Emitted when a request arrives from the remote peer -- before the reply\n   * is sent. Useful for observability, logging, or UI integration without\n   * needing to intercept the `onMessage` callback.\n   */\n  request: (payload: unknown) => void;\n};\n"]}

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-import { type SessionHandshakeParameters, type SessionLinkParameters } from "@openlv/core";
-import { type PeerInfo, type SignalingLayer, type SignalingProtocol, type SignalState } from "@openlv/signaling";
-import { type TransportLayer, type TransportLayerFn } from "@openlv/transport";
+import { type Observable, type SessionHandshakeParameters, type SessionLinkParameters } from "@openlv/core";
+import { type PeerInfo, type SignalingLayer, Status as SignalStatus } from "@openlv/signaling";
+import { type TransportLayer, type TransportLayerFunction } from "@openlv/transport";
 import { EventEmitter } from "eventemitter3";
 import type { SessionEvents } from "./events.js";
-export type { PeerCapabilities, PeerInfo } from "@openlv/signaling";
-export declare const SESSION_STATE: {
+export { loadSignaling, loadTransport } from "./dynamic.js";
+export { RequestFailedError } from "./messages/correlate.js";
+export type { SessionMessage } from "./messages/index.js";
+export type { PeerInfo } from "@openlv/signaling";
+export declare const SessionStatus: {
     readonly CREATED: "created";
     readonly SIGNALING: "signaling";
     readonly READY: "ready";
@@ -12,19 +15,8 @@ export declare const SESSION_STATE: {
     readonly CONNECTED: "connected";
     readonly DISCONNECTED: "disconnected";
 };
-export type SessionState = (typeof SESSION_STATE)[keyof typeof SESSION_STATE];
-export type SessionStateObject = {
-    status: SessionState;
-    signaling?: {
-        state: SignalState;
-    };
-    /** The peer's self-description, set once capabilities are exchanged. */
-    peerInfo?: PeerInfo;
-    /** Human-readable reason for the last disconnect/failure, if any. */
-    error?: string;
-};
+export type SessionStatus = (typeof SessionStatus)[keyof typeof SessionStatus];
 export type SessionOptions = {
-    /** Shared with the peer during the handshake and shown in its UI. */
     info?: PeerInfo;
 };
 /**
@@ -33,22 +25,14 @@ export type SessionOptions = {
  * https://openlv.sh/api/session
  */
 export type Session = {
-    getState(): SessionStateObject;
+    status: Observable<SessionStatus>;
+    signalStatus: Observable<SignalStatus>;
+    error: Observable<string | undefined>;
+    peerInfo: Observable<PeerInfo | undefined>;
     getHandshakeParameters(): SessionHandshakeParameters;
     connect(): Promise<void>;
-    waitForLink(): Promise<void>;
     close(): Promise<void>;
-    /**
-       * Send a request to the remote peer and await a correlated response.
-       *
-       * Two-phase timeout:
-       * - `ackTimeout` (default 10 s): the remote peer must send back an ack
-       *   within this window, confirming it received the message.
-       * - After an ack arrives the wait is extended to `responseTimeout`
-       *   (default 1 hour) — enough for user-interactive flows such as
-       *   `eth_sendTransaction` or `personal_sign`.
-       */
-    send(message: object, ackTimeout?: number, responseTimeout?: number): Promise<unknown>;
+    send(message: unknown, ackTimeout?: number, responseTimeout?: number): Promise<unknown>;
     emitter: EventEmitter<SessionEvents>;
     _internal: {
         signal: SignalingLayer;
@@ -61,8 +45,8 @@ export type Session = {
  *
  * https://openlv.sh/api/session
  */
-export declare const createSession: (initParameters: SessionLinkParameters, signalLayer: SignalingProtocol, transportLayers: TransportLayerFn[], onMessage: (message: object) => Promise<object | string>, options?: SessionOptions) => Promise<Session>;
+export declare const createSession: (initParameters: SessionLinkParameters, transportLayers: TransportLayerFunction[], onMessage: (message: unknown) => Promise<unknown>, options?: SessionOptions) => Promise<Session>;
 /**
  * Connect to a session from its openlv:// URL
  */
-export declare const connectSession: (connectionUrl: string, onMessage: (message: object) => Promise<object | string>, transports: TransportLayerFn[], options?: SessionOptions) => Promise<Session>;
+export declare const connectSession: (connectionUrl: string, onMessage: (message: unknown) => Promise<unknown>, transports: TransportLayerFunction[], options?: SessionOptions) => Promise<Session>;

package/dist/index.js

@@ -1,13 +1,15 @@
-import { decodeConnectionURL, OPENLV_PROTOCOL_VERSION, } from "@openlv/core";
-import { deriveSymmetricKey, generateHandshakeKey, generateSessionId, initEncryptionKeys, initHash, parseEncryptionKey, } from "@openlv/core/encryption";
-import { SIGNAL_STATE, validatePeerInfo, } from "@openlv/signaling";
-import { dynamicSignalingLayer } from "@openlv/signaling/dynamic";
-import { TRANSPORT_STATE, } from "@openlv/transport";
+import { createScope, decodeConnectionURL, observable, OPENLV_PROTOCOL_VERSION, } from "@openlv/core";
+import { createHandshakeCipher, generateHandshakeKey, generateKeyPair, generateSessionId, hashPublicKey, } from "@openlv/core/encryption";
+import { Status as SignalStatus, validatePeerInfo, } from "@openlv/signaling";
+import { Status as TransportStatus, } from "@openlv/transport";
 import { EventEmitter } from "eventemitter3";
+import { loadSignaling } from "./dynamic.js";
 import { awaitCorrelatedResponse } from "./messages/correlate.js";
-import { selectTransportId } from "./transports.js";
+import { isSessionMessage } from "./messages/index.js";
 import { log } from "./utils/log.js";
-export const SESSION_STATE = {
+export { loadSignaling, loadTransport } from "./dynamic.js";
+export { RequestFailedError } from "./messages/correlate.js";
+export const SessionStatus = {
     CREATED: "created",
     SIGNALING: "signaling",
     READY: "ready",
@@ -20,13 +22,11 @@ export const SESSION_STATE = {
  *
  * https://openlv.sh/api/session
  */
-export const createSession = async (initParameters, signalLayer, transportLayers, onMessage, options) => {
+export const createSession = async (initParameters, transportLayers, onMessage, options) => {
     if (transportLayers.length === 0) {
         throw new Error("At least one transport is required");
     }
     if (options?.info) {
-        // A receiver silently drops out-of-bounds info with the whole packet,
-        // which would surface only as a handshake timeout — fail loudly here.
         const problem = validatePeerInfo(options.info);
         if (problem)
             throw new Error(`Invalid session info: ${problem}`);
@@ -36,101 +36,100 @@ export const createSession = async (initParameters, signalLayer, transportLayers
     const sessionId = "sessionId" in initParameters
         ? initParameters.sessionId
         : generateSessionId();
-    const { encryptionKey, decryptionKey: { decrypt }, } = await initEncryptionKeys(initParameters);
-    let relyingPublicKey;
-    const handshakeKey = "k" in initParameters
-        ? await deriveSymmetricKey(initParameters.k)
-        : await generateHandshakeKey();
-    const { hash, isHost } = await initHash("h" in initParameters ? initParameters.h : undefined, encryptionKey);
-    let status = SESSION_STATE.CREATED;
-    let lastError;
+    const keyPair = generateKeyPair();
+    const k = "k" in initParameters ? initParameters.k : generateHandshakeKey();
+    const ownHash = await hashPublicKey(keyPair.publicKey);
+    const hash = ("h" in initParameters && initParameters.h) || ownHash;
+    const isHost = hash === ownHash;
     const protocol = initParameters.p;
     const server = initParameters.s;
     const capabilities = {
         transports: transportLayers.map(layer => layer.transportId),
         ...(options?.info && { info: options.info }),
     };
-    let peerCaps;
+    const [status, setStatus] = observable(SessionStatus.CREATED);
+    const [lastError, setLastError] = observable(undefined);
+    const [peerInfo, setPeerInfo] = observable(undefined);
+    const setLastErrorIfUnset = (reason) => {
+        if (lastError.get() === undefined)
+            setLastError(reason);
+    };
     const updateStatus = (newStatus) => {
         log("updateStatus", newStatus);
-        status = newStatus;
-        emitter.emit("state_change", {
-            status,
-            signaling: signal.getState(),
-            peerInfo: peerCaps?.info,
-            error: lastError,
-        });
+        setStatus(newStatus);
     };
+    status.subscribe((current) => {
+        if (current === SessionStatus.DISCONNECTED) {
+            messages.emit("ended", lastError.get() ?? "Session closed");
+        }
+    });
+    const signalLayer = await loadSignaling(protocol);
     const signaling = await signalLayer({
         topic: sessionId,
         url: server,
     });
     const signal = await signaling({
         h: hash,
-        canEncrypt() {
-            return relyingPublicKey !== undefined;
-        },
-        async encrypt(message) {
-            if (!relyingPublicKey) {
-                throw new Error("Relying party public key not found");
-            }
-            return await relyingPublicKey.encrypt(message);
-        },
-        decrypt,
-        publicKey: encryptionKey,
-        k: handshakeKey,
-        async rpDiscovered(rpKey) {
-            const role = isHost ? "host" : "client";
-            log(`rpKey discovered by ${role}`, rpKey);
-            relyingPublicKey = await parseEncryptionKey(rpKey);
-        },
+        handshakeCipher: await createHandshakeCipher(k),
+        keyPair,
         capabilities,
-        peerCapabilities(received) {
-            log("peer capabilities received", received);
-            peerCaps = received;
-            // Re-emit the current status so observers see peerInfo the moment the
-            // capabilities exchange completes, not at the next status transition.
-            updateStatus(status);
-        },
         isHost,
     });
+    const scope = createScope();
+    scope.add(signal.teardown);
+    signal.peer.subscribe((peer) => {
+        const role = isHost ? "host" : "client";
+        log(`rpKey discovered by ${role}`, peer?.peerKey);
+    });
+    signal.peerCapabilities.subscribe((received) => {
+        log("peer capabilities received", received);
+        setPeerInfo(received?.info);
+    });
     let transport;
-    const createTransport = (layer) => layer.create({
-        encrypt(message) {
-            if (!relyingPublicKey) {
-                throw new Error("Relying party public key not found");
-            }
-            return relyingPublicKey?.encrypt(message);
-        },
-        decrypt,
+    const createTransport = (layer, cipher) => layer.create({
+        cipher,
         isHost,
         onmessage: async (message) => {
             log("Session: received message from transport", message);
+            if (!isSessionMessage(message)) {
+                log("dropping invalid session message", message);
+                return;
+            }
+            if (message["type"] === "close") {
+                await teardown();
+                return;
+            }
             if (message["type"] === "request") {
                 const messageId = message["messageId"];
                 try {
                     // Immediately acknowledge receipt so the sender's ack-timeout does
                     // not fire while the handler (which may await user interaction) runs.
                     await transport?.send({ type: "ack", messageId });
-                    // Notify observers before processing (e.g. wallet UI can show a
-                    // pending indicator before the handler resolves).
-                    emitter.emit("request", message["payload"]);
-                    const data = await onMessage(message["payload"])
-                        // A throwing handler must still answer, otherwise the peer waits
-                        // out its full response timeout.
-                        .catch(() => ({ error: { code: -32603, message: "Internal error" } }));
-                    await transport?.send({
-                        type: "response",
-                        messageId,
-                        payload: data,
-                    });
+                    let answer;
+                    try {
+                        // Notify observers before processing (e.g. wallet UI can show a
+                        // pending indicator before the handler resolves).
+                        emitter.emit("request", message["payload"]);
+                        answer = {
+                            type: "response",
+                            messageId,
+                            payload: await onMessage(message["payload"]),
+                        };
+                    }
+                    catch (error) {
+                        // Only the fact of failure goes to the peer; the thrown value
+                        // may carry wallet-private details and stays in the local log.
+                        log("request handler threw", error);
+                        answer = { type: "failed", messageId };
+                    }
+                    await transport?.send(answer);
                 }
                 catch (error) {
                     log("failed to respond to peer request", error);
                 }
             }
-            if (message["type"] === "response" || message["type"] === "ack") {
-                // Both acks and responses are forwarded to the send() correlator.
+            else {
+                // What is left is an ack, a response or a failure: the send() correlator takes all three.
                 messages.emit("message", message);
             }
         },
@@ -149,63 +148,66 @@ export const createSession = async (initParameters, signalLayer, transportLayers
      * keep the first configured transport.
      */
     const selectTransportLayer = () => {
+        const peerCaps = signal.peerCapabilities.get();
         if (!peerCaps)
             return transportLayers[0];
-        const selected = selectTransportId(isHost, capabilities.transports, peerCaps.transports);
+        // The host's preferred transport that the client also supports; both
+        // peers compute the same result independently -- no confirmation round trip.
+        const hostPreference = isHost ? capabilities.transports : peerCaps.transports;
+        const clientSupported = new Set(isHost ? peerCaps.transports : capabilities.transports);
+        const selected = hostPreference.find(transportId => clientSupported.has(transportId));
         return transportLayers.find(layer => layer.transportId === selected);
     };
     // Once both peers are present (signaling encrypted) the transport should
     // connect promptly; if it cannot (e.g. no ICE candidates on a restricted
     // network) fail loudly instead of sitting in "linking" forever.
     const TRANSPORT_LINK_TIMEOUT_MS = 45000;
-    let linkDeadline;
-    const clearLinkDeadline = () => {
-        clearTimeout(linkDeadline);
-        linkDeadline = undefined;
-    };
-    const onTransportStateChange = (state) => {
-        log("transport state change", state);
-        if (state === TRANSPORT_STATE.CONNECTED) {
-            clearLinkDeadline();
-            lastError = undefined;
-            updateStatus(SESSION_STATE.CONNECTED);
+    // From transport start until the session connects or ends
+    const linking = scope.child();
+    linking.closeWhen(status, value => value === SessionStatus.CONNECTED || value === SessionStatus.DISCONNECTED);
+    const onTransportStateChange = (transportStatus) => {
+        log("transport state change", transportStatus);
+        if (transportStatus === TransportStatus.CONNECTED) {
+            setLastError(undefined);
+            updateStatus(SessionStatus.CONNECTED);
         }
-        if (state === TRANSPORT_STATE.ERROR) {
-            clearLinkDeadline();
-            lastError ?? (lastError = "Peer-to-peer transport failed");
-            updateStatus(SESSION_STATE.DISCONNECTED);
+        if (transportStatus === TransportStatus.ERROR) {
+            setLastErrorIfUnset("Peer-to-peer transport failed");
+            updateStatus(SessionStatus.DISCONNECTED);
         }
     };
     const onTransportError = (reason) => {
         if (reason)
-            lastError = reason;
+            setLastError(reason);
     };
     const startTransport = () => {
         if (!transport) {
             const layer = selectTransportLayer();
             if (!layer) {
-                log("no common transport with peer", capabilities.transports, peerCaps?.transports);
-                lastError ?? (lastError = "No common transport with peer");
-                updateStatus(SESSION_STATE.DISCONNECTED);
+                log("no common transport with peer", capabilities.transports, signal.peerCapabilities.get()?.transports);
+                setLastErrorIfUnset("No common transport with peer");
+                updateStatus(SessionStatus.DISCONNECTED);
                 return;
             }
             log("selected transport", layer.transportId);
-            transport = createTransport(layer);
-            transport.emitter.on("state_change", onTransportStateChange);
-            transport.emitter.on("error", onTransportError);
+            const peer = signal.peer.get();
+            if (!peer) {
+                throw new Error("Relying party public key not found");
+            }
+            transport = createTransport(layer, peer.cipher);
+            scope.add(transport.teardown);
+            scope.add(transport.status.subscribe(onTransportStateChange));
+            scope.listen(transport.emitter, "error", onTransportError);
+            linking.timeout(TRANSPORT_LINK_TIMEOUT_MS, () => {
+                log("transport failed to connect in time");
+                setLastErrorIfUnset("Timed out establishing the peer-to-peer connection");
+                updateStatus(SessionStatus.DISCONNECTED);
+            });
         }
-        linkDeadline ?? (linkDeadline = setTimeout(() => {
-            if (status === SESSION_STATE.CONNECTED)
-                return;
-            log("transport failed to connect in time");
-            lastError ?? (lastError = "Timed out establishing the peer-to-peer connection");
-            updateStatus(SESSION_STATE.DISCONNECTED);
-        }, TRANSPORT_LINK_TIMEOUT_MS));
         Promise.resolve(transport.setup()).catch((error) => {
             log("transport setup failed", error);
-            clearLinkDeadline();
-            lastError ?? (lastError = error instanceof Error ? error.message : "Transport setup failed");
-            updateStatus(SESSION_STATE.DISCONNECTED);
+            setLastErrorIfUnset(error instanceof Error ? error.message : "Transport setup failed");
+            updateStatus(SessionStatus.DISCONNECTED);
         });
     };
     const onSignalMessage = async (message) => {
@@ -214,7 +216,7 @@ export const createSession = async (initParameters, signalLayer, transportLayers
         if (sessionMessage.type === "response") {
             messages.emit("message", sessionMessage);
         }
-        if (sessionMessage.type === "request") {
+        else if (sessionMessage.type === "request") {
             if (!transport) {
                 log("dropping negotiation message: transport not selected yet");
                 return;
@@ -229,83 +231,60 @@ export const createSession = async (initParameters, signalLayer, transportLayers
             }
         }
     };
-    const onSignalStateChange = (state) => {
-        log("signal state change", state);
-        if (state === SIGNAL_STATE.READY) {
-            updateStatus(SESSION_STATE.READY);
+    const onSignalStateChange = (signalStatus) => {
+        log("signal state change", signalStatus);
+        if (signalStatus === SignalStatus.READY) {
+            updateStatus(SessionStatus.READY);
         }
         if ([
-            SIGNAL_STATE.HANDSHAKE,
-            SIGNAL_STATE.HANDSHAKE_PARTIAL,
-        ].includes(state)) {
-            updateStatus(SESSION_STATE.LINKING);
+            SignalStatus.HANDSHAKE,
+            SignalStatus.HANDSHAKE_PARTIAL,
+        ].includes(signalStatus)) {
+            updateStatus(SessionStatus.LINKING);
         }
-        if (state === SIGNAL_STATE.ENCRYPTED) {
+        if (signalStatus === SignalStatus.ENCRYPTED) {
             startTransport();
         }
-        if (state === SIGNAL_STATE.ERROR) {
-            log("signaling error — marking session disconnected");
-            lastError ?? (lastError = "Signaling failed or timed out");
-            updateStatus(SESSION_STATE.DISCONNECTED);
+        if (signalStatus === SignalStatus.ERROR) {
+            log("signaling error -- marking session disconnected");
+            setLastErrorIfUnset("Signaling failed or timed out");
+            updateStatus(SessionStatus.DISCONNECTED);
         }
     };
+    const teardown = async () => {
+        await scope.close();
+        updateStatus(SessionStatus.DISCONNECTED);
+    };
     return {
         connect: async () => {
-            updateStatus(SESSION_STATE.SIGNALING);
+            updateStatus(SessionStatus.SIGNALING);
             log("connecting to session, isHost:", isHost);
-            signal.on("message", onSignalMessage);
-            signal.on("state_change", onSignalStateChange);
+            scope.listen(signal, "message", onSignalMessage);
+            scope.add(signal.status.subscribe(onSignalStateChange));
             await signal.setup();
         },
         async close() {
             log("session teardown");
-            clearLinkDeadline();
-            signal.off("message", onSignalMessage);
-            signal.off("state_change", onSignalStateChange);
-            transport?.emitter.off("state_change", onTransportStateChange);
-            transport?.emitter.off("error", onTransportError);
-            await Promise.all([
-                transport?.teardown(),
-                signal.teardown(),
-            ]);
-            updateStatus(SESSION_STATE.DISCONNECTED);
-        },
-        getState() {
-            return {
-                status,
-                signaling: signal.getState(),
-                peerInfo: peerCaps?.info,
-                error: lastError,
-            };
+            await transport?.send({ type: "close" })
+                .catch(error => log("failed to send close to peer", error));
+            await teardown();
         },
+        status,
+        signalStatus: signal.status,
+        error: lastError,
+        peerInfo,
         getHandshakeParameters() {
             return {
                 version: OPENLV_PROTOCOL_VERSION,
                 sessionId,
                 h: hash,
-                k: handshakeKey.toString(),
+                k,
                 p: protocol,
                 s: server,
             };
         },
-        waitForLink: async () => new Promise((resolve, reject) => {
-            const handler = (state) => {
-                if (state?.status === SESSION_STATE.CONNECTED) {
-                    emitter.off("state_change", handler);
-                    resolve();
-                }
-                else if (state?.status === SESSION_STATE.DISCONNECTED) {
-                    emitter.off("state_change", handler);
-                    reject(new Error(lastError ?? "Session failed to connect"));
-                }
-            };
-            // Subscribe before inspecting the current status so a transition
-            // between the check and the subscription cannot be missed.
-            emitter.on("state_change", handler);
-            handler({ status });
-        }),
         async send(message, ackTimeout = 10000, responseTimeout = 60 * 60000) {
-            if (!transport || signal.getState().state !== SIGNAL_STATE.ENCRYPTED) {
+            if (!transport || signal.status.get() !== SignalStatus.ENCRYPTED) {
                 throw new Error("Session not ready");
             }
             const messageId = crypto.randomUUID();
@@ -331,10 +310,6 @@ export const createSession = async (initParameters, signalLayer, transportLayers
  */
 export const connectSession = async (connectionUrl, onMessage, transports, options) => {
     const initParameters = decodeConnectionURL(connectionUrl);
-    const signaling = await dynamicSignalingLayer(initParameters.p);
-    if (!signaling) {
-        throw new Error(`Invalid signaling protocol: ${initParameters.p}`);
-    }
-    return createSession(initParameters, signaling, transports, onMessage, options);
+    return createSession(initParameters, transports, onMessage, options);
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  decodeConnectionURL,\n  OPENLV_PROTOCOL_VERSION,\n  type SessionHandshakeParameters,\n  type SessionLinkParameters,\n} from \"@openlv/core\";\nimport {\n  deriveSymmetricKey,\n  type EncryptionKey,\n  generateHandshakeKey,\n  generateSessionId,\n  initEncryptionKeys,\n  initHash,\n  parseEncryptionKey,\n} from \"@openlv/core/encryption\";\nimport {\n  type PeerCapabilities,\n  type PeerInfo,\n  SIGNAL_STATE,\n  type SignalingLayer,\n  type SignalingProtocol,\n  type SignalState,\n  validatePeerInfo,\n} from \"@openlv/signaling\";\nimport { dynamicSignalingLayer } from \"@openlv/signaling/dynamic\";\nimport {\n  TRANSPORT_STATE,\n  type TransportLayer,\n  type TransportLayerFn,\n  type TransportMessage,\n} from \"@openlv/transport\";\nimport { EventEmitter } from \"eventemitter3\";\n\nimport type { SessionEvents } from \"./events.js\";\nimport { awaitCorrelatedResponse } from \"./messages/correlate.js\";\nimport type { SessionMessage } from \"./messages/index.js\";\nimport { selectTransportId } from \"./transports.js\";\nimport { log } from \"./utils/log.js\";\n\nexport type { PeerCapabilities, PeerInfo } from \"@openlv/signaling\";\n\nexport const SESSION_STATE = {\n  CREATED: \"created\",\n  SIGNALING: \"signaling\",\n  READY: \"ready\",\n  LINKING: \"linking\",\n  CONNECTED: \"connected\",\n  DISCONNECTED: \"disconnected\",\n} as const;\nexport type SessionState = (typeof SESSION_STATE)[keyof typeof SESSION_STATE];\n\nexport type SessionStateObject = {\n  status: SessionState;\n  signaling?: {\n    state: SignalState;\n  };\n  /** The peer's self-description, set once capabilities are exchanged. */\n  peerInfo?: PeerInfo;\n  /** Human-readable reason for the last disconnect/failure, if any. */\n  error?: string;\n};\n\nexport type SessionOptions = {\n  /** Shared with the peer during the handshake and shown in its UI. */\n  info?: PeerInfo;\n};\n\n/**\n * an OpenLV Session\n *\n * https://openlv.sh/api/session\n */\nexport type Session = {\n  getState(): SessionStateObject;\n  getHandshakeParameters(): SessionHandshakeParameters;\n  connect(): Promise<void>;\n  waitForLink(): Promise<void>;\n  close(): Promise<void>;\n  /**\n     * Send a request to the remote peer and await a correlated response.\n     *\n     * Two-phase timeout:\n     * - `ackTimeout` (default 10 s): the remote peer must send back an ack\n     *   within this window, confirming it received the message.\n     * - After an ack arrives the wait is extended to `responseTimeout`\n     *   (default 1 hour) — enough for user-interactive flows such as\n     *   `eth_sendTransaction` or `personal_sign`.\n     */\n  send(message: object, ackTimeout?: number, responseTimeout?: number): Promise<unknown>;\n  emitter: EventEmitter<SessionEvents>;\n  _internal: {\n    signal: SignalingLayer;\n    /** Instantiated when signaling reaches ENCRYPTED and a transport is selected. */\n    transport: TransportLayer | undefined;\n  };\n};\n\n/**\n * OpenLV Session\n *\n * https://openlv.sh/api/session\n */\nexport const createSession = async (\n  initParameters: SessionLinkParameters,\n  signalLayer: SignalingProtocol,\n  transportLayers: TransportLayerFn[],\n  onMessage: (message: object) => Promise<object | string>,\n  options?: SessionOptions,\n): Promise<Session> => {\n  if (transportLayers.length === 0) {\n    throw new Error(\"At least one transport is required\");\n  }\n\n  if (options?.info) {\n    // A receiver silently drops out-of-bounds info with the whole packet,\n    // which would surface only as a handshake timeout — fail loudly here.\n    const problem = validatePeerInfo(options.info);\n\n    if (problem) throw new Error(`Invalid session info: ${problem}`);\n  }\n\n  const emitter = new EventEmitter<SessionEvents>();\n  const messages = new EventEmitter<{ message: SessionMessage; }>();\n  const sessionId\n    = \"sessionId\" in initParameters\n      ? initParameters.sessionId\n      : generateSessionId();\n  const {\n    encryptionKey,\n    decryptionKey: { decrypt },\n  } = await initEncryptionKeys(initParameters);\n  let relyingPublicKey: EncryptionKey | undefined;\n  const handshakeKey\n    = \"k\" in initParameters\n      ? await deriveSymmetricKey(initParameters.k)\n      : await generateHandshakeKey();\n  const { hash, isHost } = await initHash(\n    \"h\" in initParameters ? initParameters.h : undefined,\n    encryptionKey,\n  );\n  let status: SessionState = SESSION_STATE.CREATED;\n  let lastError: string | undefined;\n  const protocol = initParameters.p;\n  const server = initParameters.s;\n  const capabilities: PeerCapabilities = {\n    transports: transportLayers.map(layer => layer.transportId),\n    ...(options?.info && { info: options.info }),\n  };\n  let peerCaps: PeerCapabilities | undefined;\n\n  const updateStatus = (newStatus: SessionState) => {\n    log(\"updateStatus\", newStatus);\n    status = newStatus;\n    emitter.emit(\"state_change\", {\n      status,\n      signaling: signal.getState(),\n      peerInfo: peerCaps?.info,\n      error: lastError,\n    });\n  };\n\n  const signaling = await signalLayer({\n    topic: sessionId,\n    url: server,\n  });\n  const signal = await signaling({\n    h: hash,\n    canEncrypt() {\n      return relyingPublicKey !== undefined;\n    },\n    async encrypt(message) {\n      if (!relyingPublicKey) {\n        throw new Error(\"Relying party public key not found\");\n      }\n\n      return await relyingPublicKey.encrypt(message);\n    },\n    decrypt,\n    publicKey: encryptionKey,\n    k: handshakeKey,\n    async rpDiscovered(rpKey) {\n      const role = isHost ? \"host\" : \"client\";\n\n      log(`rpKey discovered by ${role}`, rpKey);\n\n      relyingPublicKey = await parseEncryptionKey(rpKey);\n    },\n    capabilities,\n    peerCapabilities(received) {\n      log(\"peer capabilities received\", received);\n      peerCaps = received;\n      // Re-emit the current status so observers see peerInfo the moment the\n      // capabilities exchange completes, not at the next status transition.\n      updateStatus(status);\n    },\n    isHost,\n  });\n\n  let transport: TransportLayer | undefined;\n\n  const createTransport = (layer: TransportLayerFn): TransportLayer => layer.create({\n    encrypt(message) {\n      if (!relyingPublicKey) {\n        throw new Error(\"Relying party public key not found\");\n      }\n\n      return relyingPublicKey?.encrypt(message);\n    },\n    decrypt,\n    isHost,\n    onmessage: async (message: { type: string; payload: object; messageId: string; }) => {\n      log(\"Session: received message from transport\", message);\n\n      if (message[\"type\"] === \"request\") {\n        const messageId = message[\"messageId\"] as string;\n\n        try {\n          // Immediately acknowledge receipt so the sender's ack-timeout does\n          // not fire while the handler (which may await user interaction) runs.\n          await transport?.send({ type: \"ack\", messageId } satisfies SessionMessage);\n\n          // Notify observers before processing (e.g. wallet UI can show a\n          // pending indicator before the handler resolves).\n          emitter.emit(\"request\", message[\"payload\"] as object);\n\n          const data = await onMessage(message[\"payload\"] as object)\n            // A throwing handler must still answer, otherwise the peer waits\n            // out its full response timeout.\n            .catch(() => ({ error: { code: -32_603, message: \"Internal error\" } }));\n\n          await transport?.send({\n            type: \"response\",\n            messageId,\n            payload: data,\n          } satisfies SessionMessage);\n        }\n        catch (error) {\n          log(\"failed to respond to peer request\", error);\n        }\n      }\n\n      if (message[\"type\"] === \"response\" || message[\"type\"] === \"ack\") {\n        // Both acks and responses are forwarded to the send() correlator.\n        messages.emit(\"message\", message as SessionMessage);\n      }\n    },\n    async subsend(message) {\n      log(\"Session: sending trans msg to signal\", message);\n      const sessionMessage: SessionMessage = {\n        type: \"request\",\n        messageId: crypto.randomUUID(),\n        payload: message,\n      };\n\n      await signal.send(sessionMessage);\n    },\n  });\n\n  /**\n   * Sessions resumed with a known peer key never exchange capabilities and\n   * keep the first configured transport.\n   */\n  const selectTransportLayer = (): TransportLayerFn | undefined => {\n    if (!peerCaps) return transportLayers[0];\n\n    const selected = selectTransportId(isHost, capabilities.transports, peerCaps.transports);\n\n    return transportLayers.find(layer => layer.transportId === selected);\n  };\n\n  // Once both peers are present (signaling encrypted) the transport should\n  // connect promptly; if it cannot (e.g. no ICE candidates on a restricted\n  // network) fail loudly instead of sitting in \"linking\" forever.\n  const TRANSPORT_LINK_TIMEOUT_MS = 45_000;\n  let linkDeadline: ReturnType<typeof setTimeout> | undefined;\n\n  const clearLinkDeadline = () => {\n    clearTimeout(linkDeadline);\n    linkDeadline = undefined;\n  };\n\n  const onTransportStateChange = (state: string) => {\n    log(\"transport state change\", state);\n\n    if (state === TRANSPORT_STATE.CONNECTED) {\n      clearLinkDeadline();\n      lastError = undefined;\n      updateStatus(SESSION_STATE.CONNECTED);\n    }\n\n    if (state === TRANSPORT_STATE.ERROR) {\n      clearLinkDeadline();\n      lastError ??= \"Peer-to-peer transport failed\";\n      updateStatus(SESSION_STATE.DISCONNECTED);\n    }\n  };\n\n  const onTransportError = (reason?: string) => {\n    if (reason) lastError = reason;\n  };\n\n  const startTransport = () => {\n    if (!transport) {\n      const layer = selectTransportLayer();\n\n      if (!layer) {\n        log(\"no common transport with peer\", capabilities.transports, peerCaps?.transports);\n        lastError ??= \"No common transport with peer\";\n        updateStatus(SESSION_STATE.DISCONNECTED);\n\n        return;\n      }\n\n      log(\"selected transport\", layer.transportId);\n      transport = createTransport(layer);\n      transport.emitter.on(\"state_change\", onTransportStateChange);\n      transport.emitter.on(\"error\", onTransportError);\n    }\n\n    linkDeadline ??= setTimeout(() => {\n      if (status === SESSION_STATE.CONNECTED) return;\n\n      log(\"transport failed to connect in time\");\n      lastError ??= \"Timed out establishing the peer-to-peer connection\";\n      updateStatus(SESSION_STATE.DISCONNECTED);\n    }, TRANSPORT_LINK_TIMEOUT_MS);\n\n    Promise.resolve(transport.setup()).catch((error) => {\n      log(\"transport setup failed\", error);\n      clearLinkDeadline();\n      lastError ??= error instanceof Error ? error.message : \"Transport setup failed\";\n      updateStatus(SESSION_STATE.DISCONNECTED);\n    });\n  };\n\n  const onSignalMessage = async (message: object) => {\n    log(\"Session: received message from signaling\", message);\n\n    const sessionMessage = message as SessionMessage;\n\n    if (sessionMessage.type === \"response\") {\n      messages.emit(\"message\", sessionMessage);\n    }\n\n    if (sessionMessage.type === \"request\") {\n      if (!transport) {\n        log(\"dropping negotiation message: transport not selected yet\");\n\n        return;\n      }\n\n      try {\n        await transport.handle(sessionMessage.payload as TransportMessage);\n      }\n      catch (error) {\n        // Negotiation payloads come from the (untrusted) relay; a malformed\n        // one must not become an unhandled rejection.\n        log(\"failed to handle negotiation message\", error);\n      }\n    }\n  };\n\n  const onSignalStateChange = (state: SignalState) => {\n    log(\"signal state change\", state);\n\n    if (state === SIGNAL_STATE.READY) {\n      updateStatus(SESSION_STATE.READY);\n    }\n\n    if (\n      (\n        [\n          SIGNAL_STATE.HANDSHAKE,\n          SIGNAL_STATE.HANDSHAKE_PARTIAL,\n        ] as SignalState[]\n      ).includes(state)\n    ) {\n      updateStatus(SESSION_STATE.LINKING);\n    }\n\n    if (state === SIGNAL_STATE.ENCRYPTED) {\n      startTransport();\n    }\n\n    if (state === SIGNAL_STATE.ERROR) {\n      log(\"signaling error — marking session disconnected\");\n      lastError ??= \"Signaling failed or timed out\";\n      updateStatus(SESSION_STATE.DISCONNECTED);\n    }\n  };\n\n  return {\n    connect: async () => {\n      updateStatus(SESSION_STATE.SIGNALING);\n      log(\"connecting to session, isHost:\", isHost);\n\n      signal.on(\"message\", onSignalMessage);\n      signal.on(\"state_change\", onSignalStateChange);\n\n      await signal.setup();\n    },\n    async close() {\n      log(\"session teardown\");\n      clearLinkDeadline();\n      signal.off(\"message\", onSignalMessage);\n      signal.off(\"state_change\", onSignalStateChange);\n      transport?.emitter.off(\"state_change\", onTransportStateChange);\n      transport?.emitter.off(\"error\", onTransportError);\n      await Promise.all([\n        transport?.teardown(),\n        signal.teardown(),\n      ]);\n      updateStatus(SESSION_STATE.DISCONNECTED);\n    },\n    getState() {\n      return {\n        status,\n        signaling: signal.getState(),\n        peerInfo: peerCaps?.info,\n        error: lastError,\n      };\n    },\n    getHandshakeParameters() {\n      return {\n        version: OPENLV_PROTOCOL_VERSION,\n        sessionId,\n        h: hash,\n        k: handshakeKey.toString(),\n        p: protocol,\n        s: server,\n      };\n    },\n    waitForLink: async () => new Promise<void>((resolve, reject) => {\n      const handler = (state?: SessionStateObject) => {\n        if (state?.status === SESSION_STATE.CONNECTED) {\n          emitter.off(\"state_change\", handler);\n          resolve();\n        }\n        else if (state?.status === SESSION_STATE.DISCONNECTED) {\n          emitter.off(\"state_change\", handler);\n          reject(new Error(lastError ?? \"Session failed to connect\"));\n        }\n      };\n\n      // Subscribe before inspecting the current status so a transition\n      // between the check and the subscription cannot be missed.\n      emitter.on(\"state_change\", handler);\n      handler({ status });\n    }),\n    async send(\n      message: object,\n      ackTimeout: number = 10_000,\n      responseTimeout: number = 60 * 60_000,\n    ) {\n      if (!transport || signal.getState().state !== SIGNAL_STATE.ENCRYPTED) {\n        throw new Error(\"Session not ready\");\n      }\n\n      const messageId = crypto.randomUUID();\n      const sessionMessage: SessionMessage = {\n        type: \"request\",\n        messageId,\n        payload: message,\n      };\n\n      await transport.send(sessionMessage);\n\n      return awaitCorrelatedResponse(messages, messageId, ackTimeout, responseTimeout);\n    },\n    _internal: {\n      signal,\n      get transport() {\n        return transport;\n      },\n    },\n    emitter,\n  };\n};\n\n/**\n * Connect to a session from its openlv:// URL\n */\nexport const connectSession = async (\n  connectionUrl: string,\n  onMessage: (message: object) => Promise<object | string>,\n  transports: TransportLayerFn[],\n  options?: SessionOptions,\n): Promise<Session> => {\n  const initParameters = decodeConnectionURL(connectionUrl);\n\n  const signaling = await dynamicSignalingLayer(initParameters.p);\n\n  if (!signaling) {\n    throw new Error(`Invalid signaling protocol: ${initParameters.p}`);\n  }\n\n  return createSession(initParameters, signaling, transports, onMessage, options);\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createScope,\n  decodeConnectionURL,\n  type Observable,\n  observable,\n  OPENLV_PROTOCOL_VERSION,\n  type SessionHandshakeParameters,\n  type SessionLinkParameters,\n} from \"@openlv/core\";\nimport {\n  type Cipher,\n  createHandshakeCipher,\n  generateHandshakeKey,\n  generateKeyPair,\n  generateSessionId,\n  hashPublicKey,\n} from \"@openlv/core/encryption\";\nimport {\n  type PeerCapabilities,\n  type PeerInfo,\n  type SignalingLayer,\n  Status as SignalStatus,\n  validatePeerInfo,\n} from \"@openlv/signaling\";\nimport {\n  Status as TransportStatus,\n  type TransportLayer,\n  type TransportLayerFunction,\n  type TransportMessage,\n} from \"@openlv/transport\";\nimport { EventEmitter } from \"eventemitter3\";\n\nimport { loadSignaling } from \"./dynamic.js\";\nimport type { SessionEvents } from \"./events.js\";\nimport { awaitCorrelatedResponse, type CorrelationEvents } from \"./messages/correlate.js\";\nimport { isSessionMessage, type SessionMessage } from \"./messages/index.js\";\nimport { log } from \"./utils/log.js\";\n\nexport { loadSignaling, loadTransport } from \"./dynamic.js\";\nexport { RequestFailedError } from \"./messages/correlate.js\";\nexport type { SessionMessage } from \"./messages/index.js\";\n\n// `peerInfo` is part of the session's surface, so consumers must be able to\n// name its type without reaching into @openlv/signaling.\nexport type { PeerInfo } from \"@openlv/signaling\";\n\nexport const SessionStatus = {\n  CREATED: \"created\",\n  SIGNALING: \"signaling\",\n  READY: \"ready\",\n  LINKING: \"linking\",\n  CONNECTED: \"connected\",\n  DISCONNECTED: \"disconnected\",\n} as const;\nexport type SessionStatus = (typeof SessionStatus)[keyof typeof SessionStatus];\n\nexport type SessionOptions = {\n  info?: PeerInfo;\n};\n\n/**\n * an OpenLV Session\n *\n * https://openlv.sh/api/session\n */\nexport type Session = {\n  status: Observable<SessionStatus>;\n  signalStatus: Observable<SignalStatus>;\n  error: Observable<string | undefined>;\n  peerInfo: Observable<PeerInfo | undefined>;\n  getHandshakeParameters(): SessionHandshakeParameters;\n  connect(): Promise<void>;\n  close(): Promise<void>;\n  send(\n    message: unknown,\n    ackTimeout?: number,\n    responseTimeout?: number,\n  ): Promise<unknown>;\n  emitter: EventEmitter<SessionEvents>;\n  _internal: {\n    signal: SignalingLayer;\n    /** Instantiated when signaling reaches ENCRYPTED and a transport is selected. */\n    transport: TransportLayer | undefined;\n  };\n};\n\n/**\n * OpenLV Session\n *\n * https://openlv.sh/api/session\n */\nexport const createSession = async (\n  initParameters: SessionLinkParameters,\n  transportLayers: TransportLayerFunction[],\n  onMessage: (message: unknown) => Promise<unknown>,\n  options?: SessionOptions,\n): Promise<Session> => {\n  if (transportLayers.length === 0) {\n    throw new Error(\"At least one transport is required\");\n  }\n\n  if (options?.info) {\n    const problem = validatePeerInfo(options.info);\n\n    if (problem) throw new Error(`Invalid session info: ${problem}`);\n  }\n\n  const emitter = new EventEmitter<SessionEvents>();\n  const messages = new EventEmitter<CorrelationEvents>();\n  const sessionId\n    = \"sessionId\" in initParameters\n      ? initParameters.sessionId\n      : generateSessionId();\n  const keyPair = generateKeyPair();\n  const k = \"k\" in initParameters ? initParameters.k : generateHandshakeKey();\n  const ownHash = await hashPublicKey(keyPair.publicKey);\n  const hash = (\"h\" in initParameters && initParameters.h) || ownHash;\n  const isHost = hash === ownHash;\n  const protocol = initParameters.p;\n  const server = initParameters.s;\n  const capabilities: PeerCapabilities = {\n    transports: transportLayers.map(layer => layer.transportId),\n    ...(options?.info && { info: options.info }),\n  };\n\n  const [status, setStatus] = observable<SessionStatus>(SessionStatus.CREATED);\n  const [lastError, setLastError] = observable<string | undefined>(undefined);\n  const [peerInfo, setPeerInfo] = observable<PeerInfo | undefined>(undefined);\n\n  const setLastErrorIfUnset = (reason: string) => {\n    if (lastError.get() === undefined) setLastError(reason);\n  };\n\n  const updateStatus = (newStatus: SessionStatus) => {\n    log(\"updateStatus\", newStatus);\n    setStatus(newStatus);\n  };\n\n  status.subscribe((current) => {\n    if (current === SessionStatus.DISCONNECTED) {\n      messages.emit(\"ended\", lastError.get() ?? \"Session closed\");\n    }\n  });\n\n  const signalLayer = await loadSignaling(protocol);\n  const signaling = await signalLayer({\n    topic: sessionId,\n    url: server,\n  });\n  const signal = await signaling({\n    h: hash,\n    handshakeCipher: await createHandshakeCipher(k),\n    keyPair,\n    capabilities,\n    isHost,\n  });\n\n  const scope = createScope();\n\n  scope.add(signal.teardown);\n\n  signal.peer.subscribe((peer) => {\n    const role = isHost ? \"host\" : \"client\";\n\n    log(`rpKey discovered by ${role}`, peer?.peerKey);\n  });\n\n  signal.peerCapabilities.subscribe((received) => {\n    log(\"peer capabilities received\", received);\n    setPeerInfo(received?.info);\n  });\n\n  let transport: TransportLayer | undefined;\n\n  const createTransport = (layer: TransportLayerFunction, cipher: Cipher): TransportLayer => layer.create({\n    cipher,\n    isHost,\n    onmessage: async (message) => {\n      log(\"Session: received message from transport\", message);\n\n      if (!isSessionMessage(message)) {\n        log(\"dropping invalid session message\", message);\n\n        return;\n      }\n\n      if (message[\"type\"] === \"close\") {\n        await teardown();\n\n        return;\n      }\n\n      if (message[\"type\"] === \"request\") {\n        const messageId = message[\"messageId\"];\n\n        try {\n          // Immediately acknowledge receipt so the sender's ack-timeout does\n          // not fire while the handler (which may await user interaction) runs.\n          await transport?.send({ type: \"ack\", messageId } satisfies SessionMessage);\n\n          let answer: SessionMessage;\n\n          try {\n            // Notify observers before processing (e.g. wallet UI can show a\n            // pending indicator before the handler resolves).\n            emitter.emit(\"request\", message[\"payload\"]);\n\n            answer = {\n              type: \"response\",\n              messageId,\n              payload: await onMessage(message[\"payload\"]),\n            };\n          }\n          catch (error) {\n            // Only the fact of failure goes to the peer; the thrown value\n            // may carry wallet-private details and stays in the local log.\n            log(\"request handler threw\", error);\n            answer = { type: \"failed\", messageId };\n          }\n\n          await transport?.send(answer);\n        }\n        catch (error) {\n          log(\"failed to respond to peer request\", error);\n        }\n      }\n\n      else {\n        // What is left is an ack, a response or a failure: the send() correlator takes all three.\n        messages.emit(\"message\", message);\n      }\n    },\n    async subsend(message) {\n      log(\"Session: sending trans msg to signal\", message);\n      const sessionMessage: SessionMessage = {\n        type: \"request\",\n        messageId: crypto.randomUUID(),\n        payload: message,\n      };\n\n      await signal.send(sessionMessage);\n    },\n  });\n\n  /**\n   * Sessions resumed with a known peer key never exchange capabilities and\n   * keep the first configured transport.\n   */\n  const selectTransportLayer = (): TransportLayerFunction | undefined => {\n    const peerCaps = signal.peerCapabilities.get();\n\n    if (!peerCaps) return transportLayers[0];\n\n    // The host's preferred transport that the client also supports; both\n    // peers compute the same result independently -- no confirmation round trip.\n    const hostPreference = isHost ? capabilities.transports : peerCaps.transports;\n    const clientSupported = new Set(isHost ? peerCaps.transports : capabilities.transports);\n    const selected = hostPreference.find(transportId => clientSupported.has(transportId));\n\n    return transportLayers.find(layer => layer.transportId === selected);\n  };\n\n  // Once both peers are present (signaling encrypted) the transport should\n  // connect promptly; if it cannot (e.g. no ICE candidates on a restricted\n  // network) fail loudly instead of sitting in \"linking\" forever.\n  const TRANSPORT_LINK_TIMEOUT_MS = 45_000;\n  // From transport start until the session connects or ends\n  const linking = scope.child();\n\n  linking.closeWhen(status, value => value === SessionStatus.CONNECTED || value === SessionStatus.DISCONNECTED);\n\n  const onTransportStateChange = (transportStatus: TransportStatus) => {\n    log(\"transport state change\", transportStatus);\n\n    if (transportStatus === TransportStatus.CONNECTED) {\n      setLastError(undefined);\n      updateStatus(SessionStatus.CONNECTED);\n    }\n\n    if (transportStatus === TransportStatus.ERROR) {\n      setLastErrorIfUnset(\"Peer-to-peer transport failed\");\n      updateStatus(SessionStatus.DISCONNECTED);\n    }\n  };\n\n  const onTransportError = (reason?: string) => {\n    if (reason) setLastError(reason);\n  };\n\n  const startTransport = () => {\n    if (!transport) {\n      const layer = selectTransportLayer();\n\n      if (!layer) {\n        log(\"no common transport with peer\", capabilities.transports, signal.peerCapabilities.get()?.transports);\n        setLastErrorIfUnset(\"No common transport with peer\");\n        updateStatus(SessionStatus.DISCONNECTED);\n\n        return;\n      }\n\n      log(\"selected transport\", layer.transportId);\n      const peer = signal.peer.get();\n\n      if (!peer) {\n        throw new Error(\"Relying party public key not found\");\n      }\n\n      transport = createTransport(layer, peer.cipher);\n      scope.add(transport.teardown);\n      scope.add(transport.status.subscribe(onTransportStateChange));\n      scope.listen(transport.emitter, \"error\", onTransportError);\n      linking.timeout(TRANSPORT_LINK_TIMEOUT_MS, () => {\n        log(\"transport failed to connect in time\");\n        setLastErrorIfUnset(\"Timed out establishing the peer-to-peer connection\");\n        updateStatus(SessionStatus.DISCONNECTED);\n      });\n    }\n\n    Promise.resolve(transport.setup()).catch((error) => {\n      log(\"transport setup failed\", error);\n      setLastErrorIfUnset(error instanceof Error ? error.message : \"Transport setup failed\");\n      updateStatus(SessionStatus.DISCONNECTED);\n    });\n  };\n\n  const onSignalMessage = async (message: object) => {\n    log(\"Session: received message from signaling\", message);\n\n    const sessionMessage = message as SessionMessage;\n\n    if (sessionMessage.type === \"response\") {\n      messages.emit(\"message\", sessionMessage);\n    }\n    else if (sessionMessage.type === \"request\") {\n      if (!transport) {\n        log(\"dropping negotiation message: transport not selected yet\");\n\n        return;\n      }\n\n      try {\n        await transport.handle(sessionMessage.payload as TransportMessage);\n      }\n      catch (error) {\n        // Negotiation payloads come from the (untrusted) relay; a malformed\n        // one must not become an unhandled rejection.\n        log(\"failed to handle negotiation message\", error);\n      }\n    }\n  };\n\n  const onSignalStateChange = (signalStatus: SignalStatus) => {\n    log(\"signal state change\", signalStatus);\n\n    if (signalStatus === SignalStatus.READY) {\n      updateStatus(SessionStatus.READY);\n    }\n\n    if (\n      (\n        [\n          SignalStatus.HANDSHAKE,\n          SignalStatus.HANDSHAKE_PARTIAL,\n        ] as SignalStatus[]\n      ).includes(signalStatus)\n    ) {\n      updateStatus(SessionStatus.LINKING);\n    }\n\n    if (signalStatus === SignalStatus.ENCRYPTED) {\n      startTransport();\n    }\n\n    if (signalStatus === SignalStatus.ERROR) {\n      log(\"signaling error -- marking session disconnected\");\n      setLastErrorIfUnset(\"Signaling failed or timed out\");\n      updateStatus(SessionStatus.DISCONNECTED);\n    }\n  };\n\n  const teardown = async () => {\n    await scope.close();\n    updateStatus(SessionStatus.DISCONNECTED);\n  };\n\n  return {\n    connect: async () => {\n      updateStatus(SessionStatus.SIGNALING);\n      log(\"connecting to session, isHost:\", isHost);\n\n      scope.listen(signal, \"message\", onSignalMessage);\n      scope.add(signal.status.subscribe(onSignalStateChange));\n\n      await signal.setup();\n    },\n    async close() {\n      log(\"session teardown\");\n      await transport?.send({ type: \"close\" } satisfies SessionMessage)\n        .catch(error => log(\"failed to send close to peer\", error));\n      await teardown();\n    },\n    status,\n    signalStatus: signal.status,\n    error: lastError,\n    peerInfo,\n    getHandshakeParameters() {\n      return {\n        version: OPENLV_PROTOCOL_VERSION,\n        sessionId,\n        h: hash,\n        k,\n        p: protocol,\n        s: server,\n      };\n    },\n    async send(\n      message: unknown,\n      ackTimeout: number = 10_000,\n      responseTimeout: number = 60 * 60_000,\n    ) {\n      if (!transport || signal.status.get() !== SignalStatus.ENCRYPTED) {\n        throw new Error(\"Session not ready\");\n      }\n\n      const messageId = crypto.randomUUID();\n      const sessionMessage: SessionMessage = {\n        type: \"request\",\n        messageId,\n        payload: message,\n      };\n\n      await transport.send(sessionMessage);\n\n      return awaitCorrelatedResponse(messages, messageId, ackTimeout, responseTimeout);\n    },\n    _internal: {\n      signal,\n      get transport() {\n        return transport;\n      },\n    },\n    emitter,\n  };\n};\n\n/**\n * Connect to a session from its openlv:// URL\n */\nexport const connectSession = async (\n  connectionUrl: string,\n  onMessage: (message: unknown) => Promise<unknown>,\n  transports: TransportLayerFunction[],\n  options?: SessionOptions,\n): Promise<Session> => {\n  const initParameters = decodeConnectionURL(connectionUrl);\n\n  return createSession(initParameters, transports, onMessage, options);\n};\n"]}

package/dist/index.test.js

@@ -1,20 +1,19 @@
 import { decodeConnectionURL, encodeConnectionURL } from "@openlv/core";
-import { ntfy } from "@openlv/signaling/ntfy";
 import { webrtc } from "@openlv/transport/webrtc";
 import { describe, expect, test } from "vitest";
-import { connectSession, createSession } from "./index.js";
+import { connectSession, createSession, RequestFailedError, SessionStatus } from "./index.js";
 describe("Session", () => {
     test("Should be able to create a session", async () => {
         const sessionA = await createSession({
             sessionId: "mytestsession111",
             p: "ntfy",
             s: "https://ntfy.sh/",
-        }, ntfy, [webrtc()], async (message) => {
+        }, [webrtc()], async (message) => {
             console.log("sessionA received message", message);
             return { result: "success" };
         });
         expect(sessionA).toBeDefined();
-        console.log(sessionA.getState());
+        console.log(sessionA.status.get());
         await sessionA.connect();
         const handshakeParametersA = sessionA.getHandshakeParameters();
         const encodedUrl = encodeConnectionURL(handshakeParametersA);
@@ -26,17 +25,22 @@ describe("Session", () => {
         console.log("Connecting to session B");
         const sessionB = await connectSession(encodedUrl, async (message) => {
             console.log("sessionB received message", message);
+            if (JSON.stringify(message).includes("boom")) {
+                throw new Error("failed to sign with privkey 12345");
+            }
             return { result: "success" };
         }, [webrtc()]);
-        console.log(sessionB.getState());
+        console.log(sessionB.status.get());
         await sessionB.connect();
-        await Promise.all([sessionA.waitForLink(), sessionB.waitForLink()]);
+        await Promise.all([sessionA, sessionB].map(session => session.status.until(current => current === SessionStatus.CONNECTED)));
         //
-        console.log("A", sessionA.getState());
-        console.log("B", sessionB.getState());
+        console.log("A", sessionA.status.get());
+        console.log("B", sessionB.status.get());
         const response = await sessionA.send({ data: "test" });
         console.log("response", response);
         expect(response).toEqual({ result: "success" });
+        // A throwing handler fails the request at once instead of leaving it to time out.
+        await expect(sessionA.send({ data: "boom" })).rejects.toBeInstanceOf(RequestFailedError);
     });
 });
 //# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC;YACE,SAAS,EAAE,kBAAkB;YAC7B,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,kBAAkB;SACtB,EACD,IAAI,EACJ,CAAC,MAAM,EAAE,CAAC,EACV,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;YAElD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEjC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzB,MAAM,oBAAoB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QAC/D,MAAM,UAAU,GAAG,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAExB,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAEnD,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEjD,EAAE;QACF,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAExD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,UAAU,EACV,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;YAElD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC,EACD,CAAC,MAAM,EAAE,CAAC,CACX,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAEpE,EAAE;QACF,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { decodeConnectionURL, encodeConnectionURL } from \"@openlv/core\";\nimport { ntfy } from \"@openlv/signaling/ntfy\";\nimport { webrtc } from \"@openlv/transport/webrtc\";\nimport { describe, expect, test } from \"vitest\";\n\nimport { connectSession, createSession } from \"./index.js\";\n\ndescribe(\"Session\", () => {\n  test(\"Should be able to create a session\", async () => {\n    const sessionA = await createSession(\n      {\n        sessionId: \"mytestsession111\",\n        p: \"ntfy\",\n        s: \"https://ntfy.sh/\",\n      },\n      ntfy,\n      [webrtc()],\n      async (message) => {\n        console.log(\"sessionA received message\", message);\n\n        return { result: \"success\" };\n      },\n    );\n\n    expect(sessionA).toBeDefined();\n    console.log(sessionA.getState());\n\n    await sessionA.connect();\n\n    const handshakeParametersA = sessionA.getHandshakeParameters();\n    const encodedUrl = encodeConnectionURL(handshakeParametersA);\n\n    console.log(encodedUrl);\n\n    const decodedUrl = decodeConnectionURL(encodedUrl);\n\n    expect(decodedUrl).toEqual(handshakeParametersA);\n\n    //\n    await new Promise(resolve => setTimeout(resolve, 1000));\n\n    console.log(\"Connecting to session B\");\n\n    const sessionB = await connectSession(\n      encodedUrl,\n      async (message) => {\n        console.log(\"sessionB received message\", message);\n\n        return { result: \"success\" };\n      },\n      [webrtc()],\n    );\n\n    console.log(sessionB.getState());\n    await sessionB.connect();\n\n    await Promise.all([sessionA.waitForLink(), sessionB.waitForLink()]);\n\n    //\n    console.log(\"A\", sessionA.getState());\n    console.log(\"B\", sessionB.getState());\n\n    const response = await sessionA.send({ data: \"test\" });\n\n    console.log(\"response\", response);\n\n    expect(response).toEqual({ result: \"success\" });\n  });\n});\n"]}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { decodeConnectionURL, encodeConnectionURL } from \"@openlv/core\";\nimport { webrtc } from \"@openlv/transport/webrtc\";\nimport { describe, expect, test } from \"vitest\";\n\nimport { connectSession, createSession, RequestFailedError, SessionStatus } from \"./index.js\";\n\ndescribe(\"Session\", () => {\n  test(\"Should be able to create a session\", async () => {\n    const sessionA = await createSession(\n      {\n        sessionId: \"mytestsession111\",\n        p: \"ntfy\",\n        s: \"https://ntfy.sh/\",\n      },\n      [webrtc()],\n      async (message) => {\n        console.log(\"sessionA received message\", message);\n\n        return { result: \"success\" };\n      },\n    );\n\n    expect(sessionA).toBeDefined();\n    console.log(sessionA.status.get());\n\n    await sessionA.connect();\n\n    const handshakeParametersA = sessionA.getHandshakeParameters();\n    const encodedUrl = encodeConnectionURL(handshakeParametersA);\n\n    console.log(encodedUrl);\n\n    const decodedUrl = decodeConnectionURL(encodedUrl);\n\n    expect(decodedUrl).toEqual(handshakeParametersA);\n\n    //\n    await new Promise(resolve => setTimeout(resolve, 1000));\n\n    console.log(\"Connecting to session B\");\n\n    const sessionB = await connectSession(\n      encodedUrl,\n      async (message) => {\n        console.log(\"sessionB received message\", message);\n\n        if (JSON.stringify(message).includes(\"boom\")) {\n          throw new Error(\"failed to sign with privkey 12345\");\n        }\n\n        return { result: \"success\" };\n      },\n      [webrtc()],\n    );\n\n    console.log(sessionB.status.get());\n    await sessionB.connect();\n\n    await Promise.all([sessionA, sessionB].map(\n      session => session.status.until(current => current === SessionStatus.CONNECTED),\n    ));\n\n    //\n    console.log(\"A\", sessionA.status.get());\n    console.log(\"B\", sessionB.status.get());\n\n    const response = await sessionA.send({ data: \"test\" });\n\n    console.log(\"response\", response);\n\n    expect(response).toEqual({ result: \"success\" });\n\n    // A throwing handler fails the request at once instead of leaving it to time out.\n    await expect(sessionA.send({ data: \"boom\" })).rejects.toBeInstanceOf(RequestFailedError);\n  });\n});\n"]}

package/dist/messages/correlate.d.ts

@@ -1,12 +1,20 @@
 import type { EventEmitter } from "eventemitter3";
-import type { SessionMessage } from "./index.js";
+import type { SessionMessageAck, SessionMessageFailed, SessionMessageResponse } from "./index.js";
+/** The peer's handler threw. The peer sends no detail, so there is none here. */
+export declare class RequestFailedError extends Error {
+    name: string;
+    constructor();
+}
+export type CorrelationEvents = {
+    message: SessionMessageAck | SessionMessageFailed | SessionMessageResponse;
+    /** The session ended; every open request fails with `reason`. */
+    ended: (reason: string) => void;
+};
 /**
  * Await the ack and response correlated to a sent request.
  *
  * Two-phase timeout: the peer must ack within `ackTimeoutMs`, confirming it
  * received the message; after the ack the wait extends to `responseTimeoutMs`
- * — enough for user-interactive flows such as `eth_sendTransaction`.
+ * -- enough for user-interactive flows such as `eth_sendTransaction`.
  */
-export declare const awaitCorrelatedResponse: (messages: EventEmitter<{
-    message: SessionMessage;
-}>, messageId: string, ackTimeoutMs: number, responseTimeoutMs: number) => Promise<unknown>;
+export declare const awaitCorrelatedResponse: (messages: EventEmitter<CorrelationEvents>, messageId: string, ackTimeoutMs: number, responseTimeoutMs: number) => Promise<unknown>;

package/dist/messages/correlate.js

@@ -1,46 +1,54 @@
+import { createScope } from "@openlv/core";
+/** The peer's handler threw. The peer sends no detail, so there is none here. */
+export class RequestFailedError extends Error {
+    constructor() {
+        super("The remote peer failed to handle the request");
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "RequestFailedError"
+        });
+    }
+}
 /**
  * Await the ack and response correlated to a sent request.
  *
  * Two-phase timeout: the peer must ack within `ackTimeoutMs`, confirming it
  * received the message; after the ack the wait extends to `responseTimeoutMs`
- * — enough for user-interactive flows such as `eth_sendTransaction`.
+ * -- enough for user-interactive flows such as `eth_sendTransaction`.
  */
-export const awaitCorrelatedResponse = (messages, messageId, ackTimeoutMs, responseTimeoutMs) => new Promise((resolve, reject) => {
-    let isAckReceived = false;
-    // eslint-disable-next-line prefer-const
-    let ackTimer;
-    let responseTimer;
-    const cleanup = () => {
-        clearTimeout(ackTimer);
-        clearTimeout(responseTimer);
-        messages.off("message", handler);
-    };
-    const handler = (message) => {
-        if (message.messageId !== messageId)
-            return;
-        if (message.type === "ack" && !isAckReceived) {
-            isAckReceived = true;
-            clearTimeout(ackTimer);
-            // The other side confirmed receipt; wait for the full response.
-            responseTimer = setTimeout(() => {
-                cleanup();
-                reject(new Error("Request timed out: no response after acknowledgement"));
-            }, responseTimeoutMs);
-            return;
-        }
-        if (message.type === "response") {
-            cleanup();
-            resolve(message.payload);
-        }
-    };
-    messages.on("message", handler);
-    // Short window for the ack — tells us the peer is alive and processing.
-    ackTimer = setTimeout(() => {
-        if (isAckReceived) {
-            return;
-        }
-        cleanup();
-        reject(new Error("Request timed out: remote peer did not acknowledge"));
-    }, ackTimeoutMs);
-});
+export const awaitCorrelatedResponse = async (messages, messageId, ackTimeoutMs, responseTimeoutMs) => {
+    const request = createScope();
+    // Short window for the ack -- tells us the peer is alive and processing.
+    const ackWait = request.child();
+    const timeout = (scope, delayMs, reason) => new Promise((_resolve, reject) => {
+        scope.timeout(delayMs, () => reject(new Error(`Request timed out: ${reason}`)));
+    });
+    const acknowledged = new Promise((resolve) => {
+        ackWait.listen(messages, "message", (message) => {
+            if (message.messageId === messageId && message.type === "ack")
+                resolve();
+        });
+    });
+    const response = new Promise((resolve, reject) => {
+        request.listen(messages, "ended", (reason) => reject(new Error(reason)));
+        request.listen(messages, "message", (message) => {
+            if (message.messageId !== messageId)
+                return;
+            if (message.type === "failed")
+                reject(new RequestFailedError());
+            else if (message.type === "response")
+                resolve(message.payload);
+        });
+    });
+    try {
+        await Promise.race([acknowledged, response, timeout(ackWait, ackTimeoutMs, "remote peer did not acknowledge")]);
+        await ackWait.close();
+        return await Promise.race([response, timeout(request, responseTimeoutMs, "no response after acknowledgement")]);
+    }
+    finally {
+        await request.close();
+    }
+};
 //# sourceMappingURL=correlate.js.map

package/dist/messages/correlate.js.map

@@ -1 +1 @@
-{"version":3,"file":"correlate.js","sourceRoot":"","sources":["../../src/messages/correlate.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,QAAoD,EACpD,SAAiB,EACjB,YAAoB,EACpB,iBAAyB,EACP,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IACrD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,wCAAwC;IACxC,IAAI,QAAmD,CAAC;IACxD,IAAI,aAAwD,CAAC;IAE7D,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,YAAY,CAAC,aAAa,CAAC,CAAC;QAC5B,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,OAAuB,EAAE,EAAE;QAC1C,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO;QAE5C,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,aAAa,GAAG,IAAI,CAAC;YACrB,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,gEAAgE;YAChE,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;YAC5E,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAEtB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhC,wEAAwE;IACxE,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;QACzB,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC,CAAC;IAC1E,CAAC,EAAE,YAAY,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC","sourcesContent":["import type { EventEmitter } from \"eventemitter3\";\n\nimport type { SessionMessage } from \"./index.js\";\n\n/**\n * Await the ack and response correlated to a sent request.\n *\n * Two-phase timeout: the peer must ack within `ackTimeoutMs`, confirming it\n * received the message; after the ack the wait extends to `responseTimeoutMs`\n * — enough for user-interactive flows such as `eth_sendTransaction`.\n */\nexport const awaitCorrelatedResponse = (\n  messages: EventEmitter<{ message: SessionMessage; }>,\n  messageId: string,\n  ackTimeoutMs: number,\n  responseTimeoutMs: number,\n): Promise<unknown> => new Promise((resolve, reject) => {\n  let isAckReceived = false;\n  // eslint-disable-next-line prefer-const\n  let ackTimer: ReturnType<typeof setTimeout> | undefined;\n  let responseTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const cleanup = () => {\n    clearTimeout(ackTimer);\n    clearTimeout(responseTimer);\n    messages.off(\"message\", handler);\n  };\n\n  const handler = (message: SessionMessage) => {\n    if (message.messageId !== messageId) return;\n\n    if (message.type === \"ack\" && !isAckReceived) {\n      isAckReceived = true;\n      clearTimeout(ackTimer);\n      // The other side confirmed receipt; wait for the full response.\n      responseTimer = setTimeout(() => {\n        cleanup();\n        reject(new Error(\"Request timed out: no response after acknowledgement\"));\n      }, responseTimeoutMs);\n\n      return;\n    }\n\n    if (message.type === \"response\") {\n      cleanup();\n      resolve(message.payload);\n    }\n  };\n\n  messages.on(\"message\", handler);\n\n  // Short window for the ack — tells us the peer is alive and processing.\n  ackTimer = setTimeout(() => {\n    if (isAckReceived) {\n      return;\n    }\n\n    cleanup();\n    reject(new Error(\"Request timed out: remote peer did not acknowledge\"));\n  }, ackTimeoutMs);\n});\n"]}
+{"version":3,"file":"correlate.js","sourceRoot":"","sources":["../../src/messages/correlate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAKvD,iFAAiF;AACjF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAG3C;QACE,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAH/C;;;;mBAAO,oBAAoB;WAAC;IAIrC,CAAC;CACF;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,QAAyC,EACzC,SAAiB,EACjB,YAAoB,EACpB,iBAAyB,EACP,EAAE;IACpB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,OAAe,EAAE,MAAc,EAAE,EAAE,CAAC,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACzG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,OAAqC,EAAE,EAAE;YAC5E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;gBAAE,OAAO,EAAE,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,OAAqC,EAAE,EAAE;YAC5E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO;YAE5C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;iBAC3D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,iCAAiC,CAAC,CAAC,CAAC,CAAC;QAChH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QAEtB,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,mCAAmC,CAAC,CAAC,CAAC,CAAC;IAClH,CAAC;YACO,CAAC;QACP,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { createScope, type Scope } from \"@openlv/core\";\nimport type { EventEmitter } from \"eventemitter3\";\n\nimport type { SessionMessageAck, SessionMessageFailed, SessionMessageResponse } from \"./index.js\";\n\n/** The peer's handler threw. The peer sends no detail, so there is none here. */\nexport class RequestFailedError extends Error {\n  override name = \"RequestFailedError\";\n\n  constructor() {\n    super(\"The remote peer failed to handle the request\");\n  }\n}\n\nexport type CorrelationEvents = {\n  message: SessionMessageAck | SessionMessageFailed | SessionMessageResponse;\n  /** The session ended; every open request fails with `reason`. */\n  ended: (reason: string) => void;\n};\n\n/**\n * Await the ack and response correlated to a sent request.\n *\n * Two-phase timeout: the peer must ack within `ackTimeoutMs`, confirming it\n * received the message; after the ack the wait extends to `responseTimeoutMs`\n * -- enough for user-interactive flows such as `eth_sendTransaction`.\n */\nexport const awaitCorrelatedResponse = async (\n  messages: EventEmitter<CorrelationEvents>,\n  messageId: string,\n  ackTimeoutMs: number,\n  responseTimeoutMs: number,\n): Promise<unknown> => {\n  const request = createScope();\n  // Short window for the ack -- tells us the peer is alive and processing.\n  const ackWait = request.child();\n\n  const timeout = (scope: Scope, delayMs: number, reason: string) => new Promise<never>((_resolve, reject) => {\n    scope.timeout(delayMs, () => reject(new Error(`Request timed out: ${reason}`)));\n  });\n  const acknowledged = new Promise<void>((resolve) => {\n    ackWait.listen(messages, \"message\", (message: CorrelationEvents[\"message\"]) => {\n      if (message.messageId === messageId && message.type === \"ack\") resolve();\n    });\n  });\n  const response = new Promise<unknown>((resolve, reject) => {\n    request.listen(messages, \"ended\", (reason: string) => reject(new Error(reason)));\n    request.listen(messages, \"message\", (message: CorrelationEvents[\"message\"]) => {\n      if (message.messageId !== messageId) return;\n\n      if (message.type === \"failed\") reject(new RequestFailedError());\n      else if (message.type === \"response\") resolve(message.payload);\n    });\n  });\n\n  try {\n    await Promise.race([acknowledged, response, timeout(ackWait, ackTimeoutMs, \"remote peer did not acknowledge\")]);\n    await ackWait.close();\n\n    return await Promise.race([response, timeout(request, responseTimeoutMs, \"no response after acknowledgement\")]);\n  }\n  finally {\n    await request.close();\n  }\n};\n"]}

package/dist/messages/correlate.test.js

@@ -0,0 +1,18 @@
+import { EventEmitter } from "eventemitter3";
+import { describe, expect, test } from "vitest";
+import { awaitCorrelatedResponse, RequestFailedError } from "./correlate.js";
+describe("awaitCorrelatedResponse", () => {
+    test.each([
+        ["before any ack", false],
+        ["after the ack", true],
+    ])("rejects at once when the peer reports failure %s", async (_name, hasAck) => {
+        const messages = new EventEmitter();
+        const pending = awaitCorrelatedResponse(messages, "request-1", 60000, 60000);
+        if (hasAck)
+            messages.emit("message", { type: "ack", messageId: "request-1" });
+        messages.emit("message", { type: "failed", messageId: "another-request" });
+        messages.emit("message", { type: "failed", messageId: "request-1" });
+        await expect(pending).rejects.toBeInstanceOf(RequestFailedError);
+    });
+});
+//# sourceMappingURL=correlate.test.js.map

package/dist/messages/correlate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlate.test.js","sourceRoot":"","sources":["../../src/messages/correlate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,uBAAuB,EAA0B,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAErG,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,CAAC,IAAI,CAAC;QACR,CAAC,gBAAgB,EAAE,KAAK,CAAC;QACzB,CAAC,eAAe,EAAE,IAAI,CAAC;KACxB,CAAC,CAAC,kDAAkD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAqB,CAAC;QACvD,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAM,EAAE,KAAM,CAAC,CAAC;QAE/E,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAE9E,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAErE,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { EventEmitter } from \"eventemitter3\";\nimport { describe, expect, test } from \"vitest\";\n\nimport { awaitCorrelatedResponse, type CorrelationEvents, RequestFailedError } from \"./correlate.js\";\n\ndescribe(\"awaitCorrelatedResponse\", () => {\n  test.each([\n    [\"before any ack\", false],\n    [\"after the ack\", true],\n  ])(\"rejects at once when the peer reports failure %s\", async (_name, hasAck) => {\n    const messages = new EventEmitter<CorrelationEvents>();\n    const pending = awaitCorrelatedResponse(messages, \"request-1\", 60_000, 60_000);\n\n    if (hasAck) messages.emit(\"message\", { type: \"ack\", messageId: \"request-1\" });\n\n    messages.emit(\"message\", { type: \"failed\", messageId: \"another-request\" });\n    messages.emit(\"message\", { type: \"failed\", messageId: \"request-1\" });\n\n    await expect(pending).rejects.toBeInstanceOf(RequestFailedError);\n  });\n});\n"]}

package/dist/messages/index.d.ts

@@ -1,15 +1,24 @@
-export type SessionMessage = SessionMessageRequest | SessionMessageResponse | SessionMessageAck;
+export type SessionMessage = SessionMessageRequest | SessionMessageResponse | SessionMessageAck | SessionMessageFailed | SessionMessageClose;
 export type SessionMessageRequest = {
     type: "request";
     messageId: string;
-    payload: object | string;
+    payload: unknown;
 };
 export type SessionMessageResponse = {
     type: "response";
     messageId: string;
-    payload: object | string;
+    payload: unknown;
 };
 export type SessionMessageAck = {
     type: "ack";
     messageId: string;
 };
+/** The request's handler threw; carries no detail on purpose. */
+export type SessionMessageFailed = {
+    type: "failed";
+    messageId: string;
+};
+export type SessionMessageClose = {
+    type: "close";
+};
+export declare const isSessionMessage: (message: object) => message is SessionMessage;

package/dist/messages/index.js

@@ -1,2 +1,12 @@
-export {};
+export const isSessionMessage = (message) => {
+    if (!("type" in message) || typeof message.type !== "string")
+        return false;
+    if (message.type === "close")
+        return true;
+    if (!("messageId" in message) || typeof message.messageId !== "string")
+        return false;
+    return message.type === "ack"
+        || message.type === "failed"
+        || ((message.type === "request" || message.type === "response") && "payload" in message);
+};
 //# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"","sourcesContent":["export type SessionMessage\n  = | SessionMessageRequest\n    | SessionMessageResponse\n    | SessionMessageAck;\n\nexport type SessionMessageRequest = {\n  type: \"request\";\n  messageId: string;\n  payload: object | string;\n};\n\nexport type SessionMessageResponse = {\n  type: \"response\";\n  messageId: string;\n  payload: object | string;\n};\n\nexport type SessionMessageAck = {\n  type: \"ack\";\n  messageId: string;\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAA6B,EAAE;IAC7E,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE3E,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1C,IAAI,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAErF,OAAO,OAAO,CAAC,IAAI,KAAK,KAAK;WACxB,OAAO,CAAC,IAAI,KAAK,QAAQ;WACzB,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,SAAS,IAAI,OAAO,CAAC,CAAC;AAC7F,CAAC,CAAC","sourcesContent":["export type SessionMessage\n  = | SessionMessageRequest\n    | SessionMessageResponse\n    | SessionMessageAck\n    | SessionMessageFailed\n    | SessionMessageClose;\n\nexport type SessionMessageRequest = {\n  type: \"request\";\n  messageId: string;\n  payload: unknown;\n};\n\nexport type SessionMessageResponse = {\n  type: \"response\";\n  messageId: string;\n  payload: unknown;\n};\n\nexport type SessionMessageAck = {\n  type: \"ack\";\n  messageId: string;\n};\n\n/** The request's handler threw; carries no detail on purpose. */\nexport type SessionMessageFailed = {\n  type: \"failed\";\n  messageId: string;\n};\n\nexport type SessionMessageClose = {\n  type: \"close\";\n};\n\nexport const isSessionMessage = (message: object): message is SessionMessage => {\n  if (!(\"type\" in message) || typeof message.type !== \"string\") return false;\n\n  if (message.type === \"close\") return true;\n\n  if (!(\"messageId\" in message) || typeof message.messageId !== \"string\") return false;\n\n  return message.type === \"ack\"\n    || message.type === \"failed\"\n    || ((message.type === \"request\" || message.type === \"response\") && \"payload\" in message);\n};\n"]}

package/dist/messages/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/messages/index.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+import { isSessionMessage } from "./index.js";
+describe("isSessionMessage", () => {
+    it("accepts every session message type", () => {
+        expect(isSessionMessage({ type: "request", messageId: "1", payload: null })).toBe(true);
+        expect(isSessionMessage({ type: "response", messageId: "1", payload: "0x1" })).toBe(true);
+        expect(isSessionMessage({ type: "ack", messageId: "1" })).toBe(true);
+        expect(isSessionMessage({ type: "close" })).toBe(true);
+    });
+    it("rejects messages without a message id or payload", () => {
+        expect(isSessionMessage({ type: "ack" })).toBe(false);
+        expect(isSessionMessage({ type: "request", messageId: "1" })).toBe(false);
+        expect(isSessionMessage({ type: "response", messageId: 1, payload: {} })).toBe(false);
+        expect(isSessionMessage({ type: "unknown", messageId: "1", payload: {} })).toBe(false);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/messages/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/messages/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxF,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1F,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtF,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\n\nimport { isSessionMessage } from \"./index.js\";\n\ndescribe(\"isSessionMessage\", () => {\n  it(\"accepts every session message type\", () => {\n    expect(isSessionMessage({ type: \"request\", messageId: \"1\", payload: null })).toBe(true);\n    expect(isSessionMessage({ type: \"response\", messageId: \"1\", payload: \"0x1\" })).toBe(true);\n    expect(isSessionMessage({ type: \"ack\", messageId: \"1\" })).toBe(true);\n    expect(isSessionMessage({ type: \"close\" })).toBe(true);\n  });\n\n  it(\"rejects messages without a message id or payload\", () => {\n    expect(isSessionMessage({ type: \"ack\" })).toBe(false);\n    expect(isSessionMessage({ type: \"request\", messageId: \"1\" })).toBe(false);\n    expect(isSessionMessage({ type: \"response\", messageId: 1, payload: {} })).toBe(false);\n    expect(isSessionMessage({ type: \"unknown\", messageId: \"1\", payload: {} })).toBe(false);\n  });\n});\n"]}

package/dist/options.test.js

@@ -1,25 +1,21 @@
 import { webrtc } from "@openlv/transport/webrtc";
 import { describe, expect, it } from "vitest";
 import { createSession } from "./index.js";
-// The guards under test throw before any signaling connection is attempted.
-const unreachableSignaling = () => {
-    throw new Error("signaling should not be reached");
-};
 const linkParameters = { p: "ntfy", s: "https://ntfy.sh/" };
 const onMessage = async () => ({});
 describe("createSession input validation", () => {
     it("rejects an empty transport list", async () => {
-        await expect(createSession(linkParameters, unreachableSignaling, [], onMessage)).rejects.toThrow("At least one transport is required");
+        await expect(createSession(linkParameters, [], onMessage)).rejects.toThrow("At least one transport is required");
     });
     it("rejects info a receiver would silently drop", async () => {
-        await expect(createSession(linkParameters, unreachableSignaling, [webrtc()], onMessage, {
+        await expect(createSession(linkParameters, [webrtc()], onMessage, {
             info: {
                 identity: "com.example.dapp",
                 name: "Example dApp",
                 icon: "x".repeat(10000),
             },
         })).rejects.toThrow(/icon/);
-        await expect(createSession(linkParameters, unreachableSignaling, [webrtc()], onMessage, {
+        await expect(createSession(linkParameters, [webrtc()], onMessage, {
             info: { identity: "", name: "Example dApp" },
         })).rejects.toThrow(/identity/);
     });

package/dist/options.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.test.js","sourceRoot":"","sources":["../src/options.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,oBAAoB,GAAsB,GAAG,EAAE;IACnD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC;AAC5D,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnC,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,oBAAoB,EAAE,EAAE,EAAE,SAAS,CAAC,CACnE,CAAC,OAAO,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,oBAAoB,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE;YACzE,IAAI,EAAE;gBACJ,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAM,CAAC;aACzB;SACF,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1B,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,oBAAoB,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE;YACzE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAC7C,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import type { SignalingProtocol } from \"@openlv/signaling\";\nimport { webrtc } from \"@openlv/transport/webrtc\";\nimport { describe, expect, it } from \"vitest\";\n\nimport { createSession } from \"./index.js\";\n\n// The guards under test throw before any signaling connection is attempted.\nconst unreachableSignaling: SignalingProtocol = () => {\n  throw new Error(\"signaling should not be reached\");\n};\n\nconst linkParameters = { p: \"ntfy\", s: \"https://ntfy.sh/\" };\nconst onMessage = async () => ({});\n\ndescribe(\"createSession input validation\", () => {\n  it(\"rejects an empty transport list\", async () => {\n    await expect(\n      createSession(linkParameters, unreachableSignaling, [], onMessage),\n    ).rejects.toThrow(\"At least one transport is required\");\n  });\n\n  it(\"rejects info a receiver would silently drop\", async () => {\n    await expect(\n      createSession(linkParameters, unreachableSignaling, [webrtc()], onMessage, {\n        info: {\n          identity: \"com.example.dapp\",\n          name: \"Example dApp\",\n          icon: \"x\".repeat(10_000),\n        },\n      }),\n    ).rejects.toThrow(/icon/);\n\n    await expect(\n      createSession(linkParameters, unreachableSignaling, [webrtc()], onMessage, {\n        info: { identity: \"\", name: \"Example dApp\" },\n      }),\n    ).rejects.toThrow(/identity/);\n  });\n});\n"]}
+{"version":3,"file":"options.test.js","sourceRoot":"","sources":["../src/options.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC;AAC5D,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnC,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,CAAC,CAC7C,CAAC,OAAO,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE;YACnD,IAAI,EAAE;gBACJ,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAM,CAAC;aACzB;SACF,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1B,MAAM,MAAM,CACV,aAAa,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE;YACnD,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAC7C,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { webrtc } from \"@openlv/transport/webrtc\";\nimport { describe, expect, it } from \"vitest\";\n\nimport { createSession } from \"./index.js\";\n\nconst linkParameters = { p: \"ntfy\", s: \"https://ntfy.sh/\" };\nconst onMessage = async () => ({});\n\ndescribe(\"createSession input validation\", () => {\n  it(\"rejects an empty transport list\", async () => {\n    await expect(\n      createSession(linkParameters, [], onMessage),\n    ).rejects.toThrow(\"At least one transport is required\");\n  });\n\n  it(\"rejects info a receiver would silently drop\", async () => {\n    await expect(\n      createSession(linkParameters, [webrtc()], onMessage, {\n        info: {\n          identity: \"com.example.dapp\",\n          name: \"Example dApp\",\n          icon: \"x\".repeat(10_000),\n        },\n      }),\n    ).rejects.toThrow(/icon/);\n\n    await expect(\n      createSession(linkParameters, [webrtc()], onMessage, {\n        info: { identity: \"\", name: \"Example dApp\" },\n      }),\n    ).rejects.toThrow(/identity/);\n  });\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlv/session",
-  "version": "0.1.3",
+  "version": "0.3.1",
   "keywords": [
     "open-lavatory"
   ],
@@ -37,13 +37,13 @@
     "eventemitter3": "^5.0.1",
     "globals": "^16.2.0",
     "ts-pattern": "^5",
-    "@openlv/core": "0.1.2",
-    "@openlv/signaling": "0.1.3",
-    "@openlv/transport": "0.1.2"
+    "@openlv/core": "0.3.0",
+    "@openlv/signaling": "0.3.1",
+    "@openlv/transport": "0.3.0"
   },
   "devDependencies": {
     "@vitest/browser-playwright": "^4.0.8",
-    "playwright": "1.58.1",
+    "playwright": "1.60.0",
     "typescript": "^5",
     "vitest": "^4"
   },

package/dist/transports.d.ts

@@ -1,7 +0,0 @@
-/**
- * Pick the transport once both capability lists are known: the first entry
- * in the host's preference list that the client also supports. Both peers
- * compute the same result independently — no confirmation round trip.
- * Unknown identifiers are skipped, not fatal.
- */
-export declare const selectTransportId: (isHost: boolean, ownTransports: string[], peerTransports: string[]) => string | undefined;

package/dist/transports.js

@@ -1,12 +0,0 @@
-/**
- * Pick the transport once both capability lists are known: the first entry
- * in the host's preference list that the client also supports. Both peers
- * compute the same result independently — no confirmation round trip.
- * Unknown identifiers are skipped, not fatal.
- */
-export const selectTransportId = (isHost, ownTransports, peerTransports) => {
-    const hostPreference = isHost ? ownTransports : peerTransports;
-    const clientSupported = new Set(isHost ? peerTransports : ownTransports);
-    return hostPreference.find(transportId => clientSupported.has(transportId));
-};
-//# sourceMappingURL=transports.js.map

package/dist/transports.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transports.js","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAe,EACf,aAAuB,EACvB,cAAwB,EACJ,EAAE;IACtB,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEzE,OAAO,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC","sourcesContent":["/**\n * Pick the transport once both capability lists are known: the first entry\n * in the host's preference list that the client also supports. Both peers\n * compute the same result independently — no confirmation round trip.\n * Unknown identifiers are skipped, not fatal.\n */\nexport const selectTransportId = (\n  isHost: boolean,\n  ownTransports: string[],\n  peerTransports: string[],\n): string | undefined => {\n  const hostPreference = isHost ? ownTransports : peerTransports;\n  const clientSupported = new Set(isHost ? peerTransports : ownTransports);\n\n  return hostPreference.find(transportId => clientSupported.has(transportId));\n};\n"]}

package/dist/transports.test.js

@@ -1,22 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { selectTransportId } from "./transports.js";
-describe("selectTransportId", () => {
-    it("picks the first host preference the client supports", () => {
-        expect(selectTransportId(true, ["ws", "wrtc"], ["wrtc", "ws"])).toBe("ws");
-        expect(selectTransportId(true, ["wrtc", "ws"], ["ws"])).toBe("ws");
-    });
-    it("computes the same result from both perspectives", () => {
-        const hostTransports = ["ws", "wrtc"];
-        const clientTransports = ["wrtc", "ws"];
-        expect(selectTransportId(true, hostTransports, clientTransports))
-            .toBe(selectTransportId(false, clientTransports, hostTransports));
-    });
-    it("skips identifiers the client has never heard of", () => {
-        expect(selectTransportId(true, ["quic", "wrtc"], ["wrtc"])).toBe("wrtc");
-    });
-    it("returns undefined when there is no common transport", () => {
-        expect(selectTransportId(true, ["ws"], ["wrtc"])).toBeUndefined();
-        expect(selectTransportId(true, ["wrtc"], [])).toBeUndefined();
-    });
-});
-//# sourceMappingURL=transports.test.js.map

package/dist/transports.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transports.test.js","sourceRoot":"","sources":["../src/transports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAExC,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;aAC9D,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAClE,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\n\nimport { selectTransportId } from \"./transports.js\";\n\ndescribe(\"selectTransportId\", () => {\n  it(\"picks the first host preference the client supports\", () => {\n    expect(selectTransportId(true, [\"ws\", \"wrtc\"], [\"wrtc\", \"ws\"])).toBe(\"ws\");\n    expect(selectTransportId(true, [\"wrtc\", \"ws\"], [\"ws\"])).toBe(\"ws\");\n  });\n\n  it(\"computes the same result from both perspectives\", () => {\n    const hostTransports = [\"ws\", \"wrtc\"];\n    const clientTransports = [\"wrtc\", \"ws\"];\n\n    expect(selectTransportId(true, hostTransports, clientTransports))\n      .toBe(selectTransportId(false, clientTransports, hostTransports));\n  });\n\n  it(\"skips identifiers the client has never heard of\", () => {\n    expect(selectTransportId(true, [\"quic\", \"wrtc\"], [\"wrtc\"])).toBe(\"wrtc\");\n  });\n\n  it(\"returns undefined when there is no common transport\", () => {\n    expect(selectTransportId(true, [\"ws\"], [\"wrtc\"])).toBeUndefined();\n    expect(selectTransportId(true, [\"wrtc\"], [])).toBeUndefined();\n  });\n});\n"]}