@nority/bridge-sdk 0.1.0

package/dist/runtime/proactive.d.ts

@@ -0,0 +1,14 @@
+import type { ContentPart } from "../agent.js";
+import { type BridgeFrame } from "../protocol/frames.js";
+export interface ProactiveTurnRequest {
+    requestId: string;
+    idempotencyKey: string;
+    input: ContentPart[];
+}
+/**
+ * Proactive turn runtime surface.
+ *
+ * Enables bridge-initiated assistant turns for existing conversations.
+ */
+export declare function createProactiveTurnFrame(conversationId: string, request: ProactiveTurnRequest): BridgeFrame<"assistant_turn_start">;
+//# sourceMappingURL=proactive.d.ts.map

package/dist/runtime/proactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive.d.ts","sourceRoot":"","sources":["../../src/runtime/proactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB,GAC5B,WAAW,CAAC,sBAAsB,CAAC,CAqCrC"}

package/dist/runtime/proactive.js

@@ -0,0 +1,36 @@
+import { createFrame } from "../protocol/frames.js";
+/**
+ * Proactive turn runtime surface.
+ *
+ * Enables bridge-initiated assistant turns for existing conversations.
+ */
+export function createProactiveTurnFrame(conversationId, request) {
+    if (!conversationId) {
+        throw new Error("createProactiveTurnFrame: conversationId is required");
+    }
+    if (!request) {
+        throw new Error("createProactiveTurnFrame: request is required");
+    }
+    if (!request.requestId) {
+        throw new Error("createProactiveTurnFrame: requestId is required");
+    }
+    if (!request.idempotencyKey) {
+        throw new Error("createProactiveTurnFrame: idempotencyKey is required");
+    }
+    if (!Array.isArray(request.input) || request.input.length === 0) {
+        throw new Error("createProactiveTurnFrame: input must be a non-empty array");
+    }
+    return createFrame("assistant_turn_start", {
+        request_id: request.requestId,
+        idempotency_key: request.idempotencyKey,
+        input: request.input.map((part) => part.kind === "text"
+            ? { kind: "text", text: part.text }
+            : {
+                kind: "media",
+                media_id: part.media.mediaId,
+                media_type: part.media.mediaType,
+                size: part.media.size,
+            }),
+    }, conversationId);
+}
+//# sourceMappingURL=proactive.js.map

package/dist/runtime/proactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive.js","sourceRoot":"","sources":["../../src/runtime/proactive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAoB,MAAM,uBAAuB,CAAC;AAQtE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,cAAsB,EACtB,OAA6B;IAE7B,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,sDAAsD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,WAAW,CAChB,sBAAsB,EACtB;QACE,UAAU,EAAE,OAAO,CAAC,SAAS;QAC7B,eAAe,EAAE,OAAO,CAAC,cAAc;QACvC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,CAAC,IAAI,KAAK,MAAM;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACnC,CAAC,CAAC;gBACE,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC5B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;gBAChC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB,CACN;KACF,EACD,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/storage/conversation-store.d.ts

@@ -0,0 +1,15 @@
+import type { BridgeLogger } from "../agent.js";
+import { type ConversationEntry } from "../conversation/state.js";
+/**
+ * Durable conversation key/history persistence.
+ */
+export declare class FileConversationStore {
+    private readonly conversationsDir;
+    private readonly logger;
+    constructor(dataDir: string, logger?: BridgeLogger);
+    save(entry: ConversationEntry): Promise<void>;
+    loadAll(): Promise<ConversationEntry[]>;
+    delete(conversationId: string): Promise<void>;
+    private getConversationPath;
+}
+//# sourceMappingURL=conversation-store.d.ts.map

package/dist/storage/conversation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.d.ts","sourceRoot":"","sources":["../../src/storage/conversation-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AASlC;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,YAAyB;IAQxD,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA4BvC,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,OAAO,CAAC,mBAAmB;CAQ5B"}

package/dist/storage/conversation-store.js

@@ -0,0 +1,75 @@
+import { mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { deserializeConversationEntry, serializeConversationEntry, } from "../conversation/state.js";
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Durable conversation key/history persistence.
+ */
+export class FileConversationStore {
+    conversationsDir;
+    logger;
+    constructor(dataDir, logger = noopLogger) {
+        if (!dataDir) {
+            throw new Error("FileConversationStore: dataDir is required");
+        }
+        this.conversationsDir = join(dataDir, "conversations");
+        this.logger = logger;
+    }
+    async save(entry) {
+        const persisted = serializeConversationEntry(entry);
+        await mkdir(this.conversationsDir, { recursive: true });
+        const targetPath = this.getConversationPath(entry.conversationId);
+        const tempPath = `${targetPath}.tmp`;
+        await writeFile(tempPath, `${JSON.stringify(persisted, null, 2)}\n`, "utf-8");
+        await rename(tempPath, targetPath);
+    }
+    async loadAll() {
+        try {
+            const entries = await readdir(this.conversationsDir);
+            const conversations = [];
+            for (const entry of entries) {
+                if (!entry.endsWith(".json")) {
+                    continue;
+                }
+                try {
+                    const raw = await readFile(join(this.conversationsDir, entry), "utf-8");
+                    conversations.push(deserializeConversationEntry(JSON.parse(raw)));
+                }
+                catch (error) {
+                    this.logger.warn("FileConversationStore.loadAll: skipping unreadable conversation file", entry, error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+            return conversations;
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async delete(conversationId) {
+        if (!conversationId) {
+            throw new Error("FileConversationStore.delete: conversationId is required");
+        }
+        await rm(this.getConversationPath(conversationId), { force: true });
+    }
+    getConversationPath(conversationId) {
+        if (!conversationId) {
+            throw new Error("FileConversationStore.getConversationPath: conversationId is required");
+        }
+        return join(this.conversationsDir, `${conversationId}.json`);
+    }
+}
+function isNotFoundError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=conversation-store.js.map

package/dist/storage/conversation-store.js.map

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

package/dist/storage/state-store.d.ts

@@ -0,0 +1,20 @@
+export interface StoredBridgeState {
+    agentId?: string;
+    bridgeCredential?: string;
+    privateKeyPem: string;
+    publicKeyPem: string;
+}
+/**
+ * Persists durable bridge identity state.
+ * Access JWTs are intentionally excluded from this file.
+ */
+export declare class FileBridgeStateStore {
+    private readonly dataDir;
+    private readonly statePath;
+    constructor(dataDir: string);
+    loadOrCreateIdentity(): Promise<StoredBridgeState>;
+    load(): Promise<StoredBridgeState | null>;
+    save(state: StoredBridgeState): Promise<void>;
+    private assertState;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/storage/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/storage/state-store.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,MAAM;IAQrB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgBlD,IAAI,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAczC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/storage/state-store.js

@@ -0,0 +1,74 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { generateEd25519Identity } from "../crypto/identity.js";
+/**
+ * Persists durable bridge identity state.
+ * Access JWTs are intentionally excluded from this file.
+ */
+export class FileBridgeStateStore {
+    dataDir;
+    statePath;
+    constructor(dataDir) {
+        if (!dataDir) {
+            throw new Error("FileBridgeStateStore: dataDir is required");
+        }
+        this.dataDir = dataDir;
+        this.statePath = join(dataDir, "bridge-state.json");
+    }
+    async loadOrCreateIdentity() {
+        const existing = await this.load();
+        if (existing !== null) {
+            this.assertState(existing, "loadOrCreateIdentity");
+            return existing;
+        }
+        const identity = generateEd25519Identity();
+        const created = {
+            privateKeyPem: identity.privateKeyPem,
+            publicKeyPem: identity.publicKeyPem,
+        };
+        await this.save(created);
+        return created;
+    }
+    async load() {
+        try {
+            const raw = await readFile(this.statePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            this.assertState(parsed, "load");
+            return parsed;
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async save(state) {
+        this.assertState(state, "save");
+        await mkdir(this.dataDir, { recursive: true });
+        const tempPath = `${this.statePath}.tmp`;
+        await writeFile(tempPath, `${JSON.stringify(state, null, 2)}\n`, "utf-8");
+        await rename(tempPath, this.statePath);
+    }
+    assertState(state, method) {
+        if (!state.privateKeyPem) {
+            throw new Error(`FileBridgeStateStore.${method}: privateKeyPem is required`);
+        }
+        if (!state.publicKeyPem) {
+            throw new Error(`FileBridgeStateStore.${method}: publicKeyPem is required`);
+        }
+        if (state.bridgeCredential !== undefined && state.bridgeCredential.length === 0) {
+            throw new Error(`FileBridgeStateStore.${method}: bridgeCredential must not be empty when present`);
+        }
+        if (state.agentId !== undefined && state.agentId.length === 0) {
+            throw new Error(`FileBridgeStateStore.${method}: agentId must not be empty when present`);
+        }
+    }
+}
+function isNotFoundError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=state-store.js.map

package/dist/storage/state-store.js.map

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

package/dist/transport/outbound-queue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Outbound message queue.
+ *
+ * Responsibilities:
+ * - Buffer outbound messages during reconnect
+ * - Drain queue when connection is re-established
+ * - Bounded queue with explicit drop policy
+ */
+export declare const DEFAULT_MAX_QUEUE_SIZE = 1000;
+export declare class OutboundQueue<T> {
+    private readonly maxQueueSize;
+    private readonly frames;
+    constructor(maxQueueSize?: number);
+    enqueue(frame: T): void;
+    drain(): T[];
+    size(): number;
+}
+//# sourceMappingURL=outbound-queue.d.ts.map

package/dist/transport/outbound-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-queue.d.ts","sourceRoot":"","sources":["../../src/transport/outbound-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,qBAAa,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEtB,YAAY,SAAyB;IASjD,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYvB,KAAK,IAAI,CAAC,EAAE;IAMZ,IAAI,IAAI,MAAM;CAGf"}

package/dist/transport/outbound-queue.js

@@ -0,0 +1,37 @@
+/**
+ * Outbound message queue.
+ *
+ * Responsibilities:
+ * - Buffer outbound messages during reconnect
+ * - Drain queue when connection is re-established
+ * - Bounded queue with explicit drop policy
+ */
+export const DEFAULT_MAX_QUEUE_SIZE = 1000;
+export class OutboundQueue {
+    maxQueueSize;
+    frames = [];
+    constructor(maxQueueSize = DEFAULT_MAX_QUEUE_SIZE) {
+        if (!Number.isInteger(maxQueueSize) || maxQueueSize <= 0) {
+            throw new Error(`OutboundQueue: maxQueueSize must be a positive integer, got ${maxQueueSize}`);
+        }
+        this.maxQueueSize = maxQueueSize;
+    }
+    enqueue(frame) {
+        if (frame === undefined) {
+            throw new Error("OutboundQueue.enqueue: frame is required");
+        }
+        if (this.frames.length >= this.maxQueueSize) {
+            throw new Error(`OutboundQueue.enqueue: queue capacity ${this.maxQueueSize} exceeded`);
+        }
+        this.frames.push(frame);
+    }
+    drain() {
+        const drained = [...this.frames];
+        this.frames.length = 0;
+        return drained;
+    }
+    size() {
+        return this.frames.length;
+    }
+}
+//# sourceMappingURL=outbound-queue.js.map

package/dist/transport/outbound-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-queue.js","sourceRoot":"","sources":["../../src/transport/outbound-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,MAAM,OAAO,aAAa;IACP,YAAY,CAAS;IACrB,MAAM,GAAQ,EAAE,CAAC;IAElC,YAAY,YAAY,GAAG,sBAAsB;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,+DAA+D,YAAY,EAAE,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,KAAQ;QACd,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,YAAY,WAAW,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF"}

package/dist/transport/websocket.d.ts

@@ -0,0 +1,109 @@
+import type { BridgeLogger } from "../agent.js";
+import { type BridgeFrame } from "../protocol/frames.js";
+export declare const BACKOFF_BASE_MS = 1000;
+export declare const BACKOFF_MAX_MS = 30000;
+export declare const BACKOFF_JITTER = 0.5;
+export interface WebSocketFactoryOptions {
+    headers?: Record<string, string>;
+}
+export interface WebSocketMessageEvent {
+    data: string;
+}
+export interface WebSocketCloseEvent {
+    code: number;
+    reason: string;
+    wasClean: boolean;
+}
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: "open", listener: (event: {
+        type: "open";
+    }) => void): void;
+    addEventListener(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+    addEventListener(type: "close", listener: (event: WebSocketCloseEvent) => void): void;
+    addEventListener(type: "error", listener: (event: {
+        type: "error";
+        error?: unknown;
+    }) => void): void;
+    removeEventListener(type: "open", listener: (event: {
+        type: "open";
+    }) => void): void;
+    removeEventListener(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+    removeEventListener(type: "close", listener: (event: WebSocketCloseEvent) => void): void;
+    removeEventListener(type: "error", listener: (event: {
+        type: "error";
+        error?: unknown;
+    }) => void): void;
+}
+export interface WebSocketFactory {
+    create(url: string, options?: WebSocketFactoryOptions): WebSocketLike;
+}
+export interface CloseCodeAction {
+    kind: "reconnect" | "stop";
+    forceRefresh: boolean;
+    immediate: boolean;
+    fatal: boolean;
+}
+export interface AuthenticatedWebSocketTransportOptions {
+    backendUrl: string;
+    getAccessToken: (forceRefresh?: boolean) => Promise<string>;
+    webSocketFactory?: WebSocketFactory;
+    heartbeatIntervalMs?: number;
+    idleTimeoutMs?: number;
+    random?: () => number;
+    clock?: () => Date;
+    logger?: BridgeLogger;
+    onFrame?: (frame: BridgeFrame) => void | Promise<void>;
+    onStateChange?: (state: TransportState) => void;
+}
+export type TransportState = "idle" | "connecting" | "connected" | "reconnecting" | "stopped" | "blocked" | "failed";
+/**
+ * Calculate next backoff delay with jitter.
+ */
+export declare function calculateBackoff(attempt: number, random?: () => number): number;
+export declare function getCloseCodeAction(code: number): CloseCodeAction;
+/**
+ * Authenticated WebSocket transport with reconnect and heartbeat handling.
+ */
+export declare class AuthenticatedWebSocketTransport {
+    private readonly backendUrl;
+    private readonly getAccessToken;
+    private readonly webSocketFactory;
+    private readonly heartbeatIntervalMs;
+    private readonly idleTimeoutMs;
+    private readonly random;
+    private readonly clock;
+    private readonly logger;
+    private readonly onFrame?;
+    private readonly onStateChange?;
+    private readonly outboundQueue;
+    private state;
+    private socket;
+    private connectingSocket;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private lastActivityAt;
+    private stopRequested;
+    constructor(options: AuthenticatedWebSocketTransportOptions);
+    getState(): TransportState;
+    connect(forceRefresh?: boolean): Promise<void>;
+    disconnect(): Promise<void>;
+    send(frame: BridgeFrame): void;
+    private openSocket;
+    private attachPersistentListeners;
+    private handleMessage;
+    private handleClose;
+    private startHeartbeat;
+    private flushOutboundQueue;
+    private waitForOpen;
+    private clearTimers;
+    private clearHeartbeatTimer;
+    private clearReconnectTimer;
+    private scheduleReconnect;
+    private retryOpenSocket;
+    private setState;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/transport/websocket.d.ts.map

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