@sumicom/quicksave 0.8.2 → 0.8.3

package/dist/connection/e2eHarness.js

@@ -0,0 +1,565 @@
+import { EventEmitter } from 'events';
+import { gzip, gunzip } from 'zlib';
+import { promisify } from 'util';
+import { generateKeyPair, generateSigningKeyPair, encodeKeyPair, encodeBase64, decodeBase64, generateSessionDEK, encryptDEK, encryptWithSharedSecret, decryptWithSharedSecret, signKeyExchangeV2, parseMessage, serializeMessage, createMessage, } from '@sumicom/quicksave-shared';
+import { MessageBusClient, MessageBusServer, } from '@sumicom/quicksave-message-bus';
+import { AgentConnection } from './connection.js';
+import { BusServerTransport } from '../messageBus/busServerTransport.js';
+/**
+ * E2E test harness: spins up a real `AgentConnection` + `MessageBusServer`
+ * over a `FakeRelayHub`, and a real PWA-side `MessageBusClient` whose
+ * transport rides through the relay+encryption layers exactly like prod.
+ *
+ * Setup (per test file) requires three vi.mocks at the top:
+ *
+ * ```ts
+ * vi.mock('ws', () => ({ default: FakeWebSocket, WebSocket: FakeWebSocket }));
+ * vi.mock('../tombstoneCheck.js', () => ({
+ *   checkTombstone: vi.fn().mockResolvedValue({ status: 'absent' }),
+ *   hashPublicKey: vi.fn((pk: string) => `hash-${pk.slice(0, 8)}`),
+ *   verifyTombstonePayload: vi.fn(),
+ * }));
+ * ```
+ *
+ * Plus a per-test temp `QUICKSAVE_HOME` (via `setQuicksaveDir`) so the real
+ * `config.ts` can write the agent's identity without colliding across tests.
+ *
+ * What this harness exercises end-to-end on the agent side:
+ * - `relay.ts` ws framing (compressed `{z}`, routed envelopes, signaling
+ *   types like `pwa-bye` and `agent-status`)
+ * - `connection.ts` V2 key-exchange validation, TOFU pinning, DEK
+ *   encryption / decryption, gzip + base64 framing, send-queue ordering
+ * - `BusServerTransport` ↔ `MessageBusServer` command/subscribe routing
+ *
+ * Out of scope (use other tests):
+ * - Tombstone HTTP catch-up path (mocked here, exercised in tombstoneCheck.test.ts)
+ * - PWA UI / store wiring (this harness sits at the bus layer)
+ * - Reconnect timing and exponential backoff (covered by relay.fakeHub.test.ts)
+ */
+const gzipAsync = promisify(gzip);
+const gunzipAsync = promisify(gunzip);
+/**
+ * Wire up `AgentConnection` + `BusServerTransport` + `MessageBusServer` for
+ * a single test agent. The caller is responsible for:
+ *   1. Calling `setQuicksaveDir(tempDir)` first
+ *   2. Calling `createDefaultConfig(...)` (or hand-crafting a config) so
+ *      `loadConfig()` returns the same `{agentId, keyPair}` we pass in here
+ *   3. Mocking `'ws'` so `relay.ts`'s `new WebSocket(...)` reaches the hub
+ *
+ * Returns the live agent objects. After `start()` resolves, the agent is
+ * connected to the hub and waiting for a PWA to drive key-exchange.
+ */
+export function buildAgent(opts) {
+    const connection = new AgentConnection({
+        signalingServer: opts.signalingServer ?? 'ws://test',
+        agentId: opts.agentId,
+        keyPair: opts.agentKeyPair,
+    });
+    const transport = new BusServerTransport(connection);
+    const bus = new MessageBusServer(transport);
+    return {
+        agentId: opts.agentId,
+        publicKeyB64: opts.agentKeyPair.publicKey,
+        connection,
+        bus,
+        transport,
+        async start() {
+            await connection.start();
+        },
+        stop() {
+            connection.disconnect();
+        },
+    };
+}
+/**
+ * Stand-in for a PWA tab on the message bus. Performs a real V2 key
+ * exchange against the agent (signing keypair + DEK encryption + base64
+ * framing exactly as the real PWA does), then exposes a real
+ * `MessageBusClient` whose transport pipes `bus:frame` envelopes through
+ * the encrypted+gzipped channel.
+ *
+ * The client's connect/disconnect events fire after `start()` completes
+ * so consumers can subscribe before issuing commands. Only one active
+ * agent per `FakePwa` — multi-agent flows aren't modeled here.
+ */
+export class FakePwa {
+    connectionId;
+    hub;
+    socket = null;
+    agentId;
+    agentPublicKey;
+    boxKeyPair;
+    signKeyPair;
+    sessionDEK = null;
+    /**
+     * Mirrors `WebSocketClient.AgentSession.keyExchangeComplete`. The agent's
+     * `key-exchange-ack` is delivered as plaintext JSON inside the routed
+     * envelope — distinguished from encrypted bus frames by this flag, not by
+     * inspecting the payload (the prod PWA does the same).
+     */
+    keyExchangeComplete = false;
+    busTransport;
+    busClient;
+    startPromise = null;
+    events = new EventEmitter();
+    /**
+     * Serialize incoming routed-message processing so async decompress doesn't
+     * resolve out of order, mirroring `WebSocketClient.messageQueue`.
+     */
+    incomingQueue = Promise.resolve();
+    constructor(opts) {
+        this.hub = opts.hub;
+        this.agentId = opts.agentId;
+        this.agentPublicKey = decodeBase64(opts.agentPublicKeyB64);
+        this.boxKeyPair = generateKeyPair();
+        this.signKeyPair = opts.signKeyPair ?? generateSigningKeyPair();
+        this.connectionId =
+            opts.connectionId ?? `pwa-${Math.random().toString(36).slice(2, 10)}`;
+        this.busTransport = new FakePwaBusTransport((frame) => this.sendBusFrame(frame));
+        this.busClient = new MessageBusClient(this.busTransport);
+    }
+    /** Base64-encoded Ed25519 signing public key (the PWA group's TOFU anchor). */
+    signingPublicKeyB64() {
+        return encodeBase64(this.signKeyPair.publicKey);
+    }
+    /**
+     * The Ed25519 signing keypair used for V2 key-exchange. Exposed so a test
+     * can pass it to a second `FakePwa` to simulate multiple tabs sharing a
+     * group identity (the agent TOFU-pins the first sigPubkey it sees and
+     * rejects later handshakes that don't match).
+     */
+    groupSignKeyPair() {
+        return this.signKeyPair;
+    }
+    /** Base64-encoded X25519 box public key (used to derive `pwa:{key}`). */
+    boxPublicKeyB64() {
+        return encodeBase64(this.boxKeyPair.publicKey);
+    }
+    /**
+     * Attach to the relay, send `watch-agent`, complete key exchange, wait
+     * for the ack. Resolves once the bus transport is `connected`. Idempotent.
+     */
+    start() {
+        if (this.startPromise)
+            return this.startPromise;
+        this.startPromise = this.doStart();
+        return this.startPromise;
+    }
+    async doStart() {
+        // The hub address and the `from` field of every routed envelope MUST
+        // match: the agent extracts `peerPWAPublicKey` from `from` to TOFU-pin
+        // and replies routed to that exact address. We use `connectionId` for
+        // both — by default it's `pwa-{random}`, which is opaque but stable.
+        this.socket = this.hub.attachPwa(this.connectionId);
+        await waitForOpen(this.socket);
+        this.socket.on('message', (data) => {
+            const text = typeof data === 'string' ? data : data.toString('utf-8');
+            this.incomingQueue = this.incomingQueue.then(() => this.handleIncoming(text));
+        });
+        this.socket.on('close', () => {
+            this.busTransport._fireDisconnected();
+        });
+        // Watch the agent so the hub will tell us when it's online (or now).
+        const ackPromise = new Promise((resolve) => this.events.once('key-exchange-ack', resolve));
+        this.sendRaw({ type: 'watch-agent', agentId: this.agentId });
+        // The hub replies synchronously with `agent-status`. If the agent is
+        // already attached we proceed to key-exchange immediately; otherwise we
+        // wait for an `agent-status: online=true` push.
+        await ackPromise;
+        this.busTransport._fireConnected();
+    }
+    /**
+     * Resolves when the next key-exchange ack is received. Used by reconnect
+     * tests to wait for the agent to come back up after a hub-induced
+     * disconnect.
+     */
+    waitForReconnect() {
+        return new Promise((resolve) => this.events.once('key-exchange-ack', () => resolve()));
+    }
+    /** The bus client. Use `command()`, `subscribe()`, etc. as in production. */
+    bus() {
+        return this.busClient;
+    }
+    /** Tear down. Idempotent. */
+    close() {
+        this.socket?.close();
+        this.socket = null;
+        this.startPromise = null;
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    async handleIncoming(text) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            return;
+        const obj = parsed;
+        // Routed envelope from the agent: either key-exchange-ack JSON or an
+        // encrypted bus frame.
+        if (typeof obj.from === 'string' &&
+            typeof obj.to === 'string' &&
+            'payload' in obj) {
+            await this.handleRoutedPayload(obj.payload);
+            return;
+        }
+        // Signaling messages from the relay.
+        if (obj.type === 'agent-status') {
+            const payload = obj.payload;
+            if (payload.agentId !== this.agentId)
+                return;
+            if (payload.online) {
+                // Either first-time online or a reconnect — either way, start a
+                // fresh V2 handshake. `startKeyExchange` resets DEK + the
+                // `keyExchangeComplete` flag itself.
+                await this.startKeyExchange();
+            }
+            else {
+                // Agent went offline (relay closed its socket). Mirror the prod
+                // PWA path: drop the session DEK so a stale-key encrypt can't
+                // happen, mark the bus transport disconnected so the PWA's
+                // `MessageBusClient.handleDisconnected` rejects in-flight commands
+                // and marks subscriptions wireActive=false. The next online push
+                // will trigger a fresh handshake.
+                this.sessionDEK = null;
+                this.keyExchangeComplete = false;
+                this.busTransport._fireDisconnected();
+            }
+            return;
+        }
+        if (obj.type === 'pwa-bye' || obj.type === 'bye') {
+            this.busTransport._fireDisconnected();
+            return;
+        }
+        // Other signaling types (peer-connected, peer-offline) are no-ops here.
+    }
+    async handleRoutedPayload(payload) {
+        // Pre-ack window: the agent sends `key-exchange-ack` as plaintext JSON
+        // inside the routed envelope. We track an explicit `keyExchangeComplete`
+        // flag rather than inspecting `sessionDEK`, because we generate the DEK
+        // before sending the key-exchange and would otherwise fall through to
+        // the decrypt path with a payload that isn't ciphertext.
+        if (!this.keyExchangeComplete) {
+            try {
+                const obj = JSON.parse(payload);
+                if (obj.type === 'key-exchange-ack' && obj.version === 2) {
+                    this.keyExchangeComplete = true;
+                    // Idempotent: returns early if the bus transport is already
+                    // connected (e.g. on the very first ack `doStart` already awaits
+                    // the same event and calls this itself; no harm in firing twice).
+                    this.busTransport._fireConnected();
+                    this.events.emit('key-exchange-ack');
+                    return;
+                }
+            }
+            catch {
+                // Agent shouldn't send anything else before ack, but be permissive.
+            }
+            return;
+        }
+        if (!this.sessionDEK)
+            return;
+        let plaintext;
+        try {
+            plaintext = decryptWithSharedSecret(payload, this.sessionDEK);
+        }
+        catch (err) {
+            console.error('FakePwa: decrypt failed', err);
+            return;
+        }
+        let buffer;
+        try {
+            buffer = Buffer.from(plaintext, 'base64');
+        }
+        catch {
+            return;
+        }
+        let decompressed;
+        try {
+            decompressed = await gunzipAsync(buffer);
+        }
+        catch (err) {
+            console.error('FakePwa: gunzip failed', err);
+            return;
+        }
+        let message;
+        try {
+            message = parseMessage(decompressed.toString('utf-8'));
+        }
+        catch {
+            return;
+        }
+        if (message.type === 'bus:frame') {
+            this.busTransport._receive(message.payload);
+            return;
+        }
+        // Other message types (handshake:ack, etc.) are not modeled in this
+        // harness — the e2e tests focus on the bus layer.
+    }
+    async startKeyExchange() {
+        // Generate session DEK + sign the V2 envelope exactly like the PWA does.
+        const dek = generateSessionDEK();
+        this.sessionDEK = dek;
+        const encryptedDEK = encryptDEK(dek, this.agentPublicKey);
+        const timestamp = Date.now();
+        const { sigPubkey, signature } = signKeyExchangeV2({
+            agentId: this.agentId,
+            encryptedDEK,
+            timestamp,
+            signingPublicKey: this.signKeyPair.publicKey,
+            signingSecretKey: this.signKeyPair.secretKey,
+            encodeBase64,
+        });
+        const payload = JSON.stringify({
+            type: 'key-exchange',
+            version: 2,
+            encryptedDEK,
+            timestamp,
+            sigPubkey,
+            signature,
+        });
+        this.sendRouted(payload);
+    }
+    sendRaw(obj) {
+        if (!this.socket)
+            return;
+        this.socket.send(JSON.stringify(obj));
+    }
+    sendRouted(payload) {
+        if (!this.socket)
+            return;
+        const envelope = {
+            from: `pwa:${this.connectionId}`,
+            to: `agent:${this.agentId}`,
+            payload,
+        };
+        this.socket.send(JSON.stringify(envelope));
+    }
+    /**
+     * Called by the bus transport: wraps a `ClientFrame` in a `bus:frame`
+     * Message, gzips, encrypts with the session DEK, sends as a routed
+     * envelope. Mirrors `AgentConnection.send()` in reverse.
+     */
+    async sendBusFrame(frame) {
+        if (!this.sessionDEK) {
+            throw new Error('FakePwa: bus frame sent before key exchange');
+        }
+        const wrapper = createMessage('bus:frame', frame);
+        const serialized = serializeMessage(wrapper);
+        const compressed = await gzipAsync(Buffer.from(serialized));
+        const compressedBase64 = compressed.toString('base64');
+        const encrypted = encryptWithSharedSecret(compressedBase64, this.sessionDEK);
+        this.sendRouted(encrypted);
+    }
+}
+// ---------------------------------------------------------------------------
+// Bus transport adapter (PWA side)
+// ---------------------------------------------------------------------------
+class FakePwaBusTransport {
+    dispatch;
+    connected = false;
+    frameHandlers = [];
+    connectHandlers = [];
+    disconnectHandlers = [];
+    outboundQueue = Promise.resolve();
+    /** `dispatch` runs the encrypt+send pipeline; rejection means crypto/IO error. */
+    constructor(dispatch) {
+        this.dispatch = dispatch;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    send(frame) {
+        // Serialize outbound dispatch so multi-frame burst preserves order, the
+        // way `AgentConnection.sendQueues` does on the agent side.
+        this.outboundQueue = this.outboundQueue
+            .then(() => this.dispatch(frame))
+            .catch((err) => {
+            console.error('FakePwaBusTransport: dispatch failed', err);
+        });
+    }
+    onFrame(handler) {
+        this.frameHandlers.push(handler);
+    }
+    onConnected(handler) {
+        this.connectHandlers.push(handler);
+    }
+    onDisconnected(handler) {
+        this.disconnectHandlers.push(handler);
+    }
+    _receive(frame) {
+        for (const h of this.frameHandlers)
+            h(frame);
+    }
+    _fireConnected() {
+        if (this.connected)
+            return;
+        this.connected = true;
+        for (const h of this.connectHandlers)
+            h();
+    }
+    _fireDisconnected() {
+        if (!this.connected)
+            return;
+        this.connected = false;
+        for (const h of this.disconnectHandlers)
+            h();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Generate a fresh agent identity. Real crypto. */
+export function makeAgentIdentity() {
+    return {
+        // Random id is fine; nothing else in tests cares about format.
+        agentId: `agent-${Math.random().toString(36).slice(2, 10)}`,
+        keyPair: encodeKeyPair(generateKeyPair()),
+        signKeyPair: encodeKeyPair(generateSigningKeyPair()),
+    };
+}
+function waitForOpen(socket) {
+    return new Promise((resolve) => {
+        if (socket.readyState === 1) {
+            // Already open — flush a microtask so listeners attach first.
+            queueMicrotask(() => resolve());
+            return;
+        }
+        socket.once('open', () => resolve());
+    });
+}
+export class StubProvider {
+    id;
+    historyMode;
+    generateSessionId;
+    counter = 0;
+    sessions = new Map();
+    constructor(opts = {}) {
+        this.id = opts.id ?? 'claude-code';
+        this.historyMode = opts.historyMode ?? 'memory';
+        this.generateSessionId =
+            opts.generateSessionId ??
+                (() => `stub-${Date.now()}-${++this.counter}`);
+    }
+    async startSession(opts, cardBuilder, callbacks) {
+        const sessionId = this.generateSessionId();
+        const session = this.makeSession(sessionId, opts.cwd, opts.streamId, cardBuilder, callbacks);
+        session.receivedPrompts.push(opts.prompt);
+        return { sessionId, session: this.toProviderSession(session) };
+    }
+    async resumeSession(opts, cardBuilder, callbacks) {
+        const session = this.makeSession(opts.sessionId, opts.cwd, opts.streamId, cardBuilder, callbacks);
+        session.receivedPrompts.push(opts.prompt);
+        return { sessionId: opts.sessionId, session: this.toProviderSession(session) };
+    }
+    // ── Test API ────────────────────────────────────────────────────────────
+    /** Push a `card-event` for a given session. Throws if the session is not active. */
+    emitCard(sessionId, event) {
+        const s = this.requireSession(sessionId);
+        s.callbacks.emitCardEvent(event);
+    }
+    /** Fire `card-stream-end` and mark the session inactive (mirrors the
+     *  provider exiting). */
+    finishStream(sessionId, result) {
+        const s = this.requireSession(sessionId);
+        s.alive = false;
+        const full = {
+            streamId: s.streamId,
+            sessionId,
+            ...result,
+        };
+        s.callbacks.emitStreamEnd(full);
+        s.callbacks.onSessionExited?.(sessionId, this.toProviderSession(s));
+    }
+    /** Inspect what `sendUserMessage` calls the provider has received. */
+    promptsFor(sessionId) {
+        return [...this.requireSession(sessionId).receivedPrompts];
+    }
+    /** Whether `interrupt()` was called. */
+    wasInterrupted(sessionId) {
+        return this.requireSession(sessionId).interrupted;
+    }
+    /** Whether `kill()` was called. */
+    wasKilled(sessionId) {
+        return this.requireSession(sessionId).killed;
+    }
+    // ── Internals ───────────────────────────────────────────────────────────
+    makeSession(sessionId, cwd, streamId, cardBuilder, callbacks) {
+        const session = {
+            sessionId,
+            cwd,
+            streamId,
+            cardBuilder,
+            callbacks,
+            alive: true,
+            receivedPrompts: [],
+            interrupted: false,
+            killed: false,
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    toProviderSession(s) {
+        return {
+            get alive() {
+                return s.alive;
+            },
+            sendUserMessage(prompt) {
+                s.receivedPrompts.push(prompt);
+            },
+            interrupt() {
+                s.interrupted = true;
+            },
+            kill() {
+                s.killed = true;
+                s.alive = false;
+            },
+        };
+    }
+    requireSession(sessionId) {
+        const s = this.sessions.get(sessionId);
+        if (!s)
+            throw new Error(`StubProvider: no session ${sessionId}`);
+        return s;
+    }
+}
+// ---------------------------------------------------------------------------
+// wireSessionBus — minimal subset of `service/run.ts`'s session-bus wiring
+// for tests. Registers `/sessions/active`, `/sessions/:sessionId/cards`,
+// `/preferences`, `/sessions/config` subscriptions and forwards SessionManager
+// events onto the bus. No push-notify, no event-store, no session registry
+// side effects — the harness focuses on the bus surface.
+// ---------------------------------------------------------------------------
+export function wireSessionBus(bus, sessionManager) {
+    bus.onSubscribe('/sessions/active', { snapshot: () => sessionManager.snapshotActiveSessions() });
+    bus.onSubscribe('/sessions/:sessionId/cards', {
+        snapshot: async ({ params }) => {
+            const sessionId = params.sessionId;
+            const cwd = sessionManager.getSessionCwd(sessionId) ?? '';
+            return sessionManager.getCards(sessionId, cwd, 0, 50);
+        },
+    });
+    bus.onSubscribe('/preferences', { snapshot: () => sessionManager.getPreferences() });
+    bus.onSubscribe('/sessions/config', { snapshot: () => sessionManager.getAllSessionConfigs() });
+    sessionManager.on('card-event', (event) => {
+        bus.publish(`/sessions/${event.sessionId}/cards`, { kind: 'card', event });
+    });
+    sessionManager.on('card-stream-end', (result) => {
+        bus.publish(`/sessions/${result.sessionId}/cards`, { kind: 'stream-end', result });
+    });
+    sessionManager.on('session-updated', (payload) => {
+        bus.publish('/sessions/active', payload);
+    });
+    sessionManager.on('preferences-updated', (prefs) => {
+        bus.publish('/preferences', prefs);
+    });
+    sessionManager.on('session-config-updated', (payload) => {
+        bus.publish('/sessions/config', payload);
+    });
+}
+//# sourceMappingURL=e2eHarness.js.map

package/dist/connection/e2eHarness.js.map

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

package/dist/connection/fakeRelay.d.ts

@@ -0,0 +1,77 @@
+import { EventEmitter } from 'events';
+export interface FakeRelayPeer {
+    channel: 'agent' | 'pwa';
+    id: string;
+    /** Routing address as the relay would render it: e.g. `agent:abc` / `pwa:xyz`. */
+    address: string;
+    socket: FakeWsSocket;
+}
+/** Subset of the `ws` WebSocket API that `relay.ts` uses. */
+export declare class FakeWsSocket extends EventEmitter {
+    readyState: number;
+    /** Set by the hub during `attach`; null once closed. */
+    private hub;
+    private address;
+    constructor(hub: FakeRelayHub, address: string);
+    send(data: string | Buffer | ArrayBuffer | Uint8Array): void;
+    ping(): void;
+    terminate(): void;
+    close(): void;
+    /**
+     * Internal: deliver a frame from the hub to this socket. Always async via
+     * microtask so the hub stays consistent and listeners can attach in order.
+     */
+    _deliver(payload: string | Buffer): void;
+    /**
+     * Internal: simulate the relay closing this socket. Fires `close` once.
+     * No-op on repeat. The `reason` is informational only.
+     */
+    _close(_reason: string): void;
+}
+export declare class FakeRelayHub {
+    private peers;
+    private agentWatchers;
+    private tombstoneSubs;
+    /** Most-recent tombstone payload per keyHash for late-subscriber replay. */
+    private tombstonePayloads;
+    /** Register an agent peer at `agent:{agentId}`. Throws on duplicate. */
+    attachAgent(agentId: string): FakeWsSocket;
+    /**
+     * Register a PWA peer at `pwa:{connectionId}`. The relay's `pwa` channel
+     * decodes percent-encoded ids; we accept whatever the test passes. Throws
+     * on duplicate id (the prod relay's `pwa` channel uses 'replace' semantics
+     * but the duplicate case isn't relevant for the e2e flows we model here).
+     */
+    attachPwa(connectionId: string): FakeWsSocket;
+    /**
+     * Test hook: simulate the relay receiving a tombstone for `keyHash` and
+     * fanning it out to every subscribed agent. Mirrors the real relay's HTTP
+     * upload path → `tombstoneSubs.publish`.
+     */
+    publishTombstone(keyHash: string, ciphertext: string): void;
+    /** Number of currently attached peers in either channel. */
+    peerCount(): number;
+    /** Inspect attached peers for assertions. */
+    listPeers(): FakeRelayPeer[];
+    /**
+     * Tear everything down. Fires `close` on each peer socket. Tests should
+     * call this in `afterEach` to keep state isolated.
+     */
+    close(): void;
+    _handleClientSend(fromAddress: string, raw: string | Buffer | ArrayBuffer | Uint8Array): void;
+    _removePeer(address: string): void;
+    private _sendSignal;
+}
+export declare function setActiveFakeRelayHub(hub: FakeRelayHub | null): void;
+export declare function getActiveFakeRelayHub(): FakeRelayHub | null;
+/**
+ * Constructor that satisfies `new WebSocket(url)` for the production
+ * `relay.ts` code path. Picks the channel + id off the URL path; the URL
+ * scheme/host is ignored (e.g. `ws://test/agent/abc` → channel=agent, id=abc).
+ *
+ * Use with `vi.mock('ws', () => ({ default: FakeWebSocket }))` — vitest
+ * resolves the mock at module-load time, so `setActiveFakeRelayHub` must run
+ * before the production code instantiates a socket.
+ */
+export declare const FakeWebSocket: new (url: string) => FakeWsSocket;
+//# sourceMappingURL=fakeRelay.d.ts.map

package/dist/connection/fakeRelay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeRelay.d.ts","sourceRoot":"","sources":["../../src/connection/fakeRelay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA8BtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,6DAA6D;AAC7D,qBAAa,YAAa,SAAQ,YAAY;IAC5C,UAAU,SAAW;IACrB,wDAAwD;IACxD,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;IAQ9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI;IAO5D,IAAI,IAAI,IAAI;IAKZ,SAAS,IAAI,IAAI;IAIjB,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQxC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAS9B;AAYD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,aAAa,CAGjB;IACJ,4EAA4E;IAC5E,OAAO,CAAC,iBAAiB,CAAyC;IAElE,wEAAwE;IACxE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAqB1C;;;;;OAKG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY;IAgB7C;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY3D,4DAA4D;IAC5D,SAAS,IAAI,MAAM;IAInB,6CAA6C;IAC7C,SAAS,IAAI,aAAa,EAAE;IAI5B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAcb,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAC9C,IAAI;IAoFP,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAuClC,OAAO,CAAC,WAAW;CAKpB;AAsBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,qBAAqB,IAAI,YAAY,GAAG,IAAI,CAE3D;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,YAaE,CAAC"}