@cnstra/devtools-transport-ws 1.1.0

package/dist/index.cjs

@@ -0,0 +1,183 @@
+'use strict';
+
+// src/index.ts
+var CNSDevToolsTransportWs = class {
+  constructor(opts) {
+    this.opts = opts;
+    this.connecting = false;
+    this.closed = false;
+    this.buffer = [];
+    this.hasConnectedOnce = false;
+    this.reconnectAttempts = 0;
+  }
+  get reconnectDelayMs() {
+    return this.opts.reconnectDelayMs ?? 1e3;
+  }
+  get bufferMaxSize() {
+    return this.opts.bufferMaxSize ?? 100;
+  }
+  get maxReconnectAttempts() {
+    return this.opts.maxReconnectAttempts ?? Infinity;
+  }
+  ensureSocket() {
+    const WS = this.opts.webSocketImpl || (typeof WebSocket !== "undefined" ? WebSocket : void 0);
+    if (!WS)
+      return Promise.reject(
+        new Error(
+          "WebSocket implementation is not available. Provide webSocketImpl."
+        )
+      );
+    if (this.ws && this.ws.readyState === 1)
+      return Promise.resolve();
+    if (this.connecting) {
+      return new Promise((resolve) => {
+        const check = () => {
+          if (this.ws && this.ws.readyState === 1)
+            return resolve();
+          setTimeout(check, 50);
+        };
+        check();
+      });
+    }
+    this.connecting = true;
+    return new Promise((resolve) => {
+      const ws = new WS(this.opts.url, this.opts.protocols);
+      this.ws = ws;
+      ws.onopen = () => {
+        if (this.opts.consoleLogEnabled) {
+          console.log("DevTools connected to server");
+        }
+        this.connecting = false;
+        this.reconnectAttempts = 0;
+        if (this.hasConnectedOnce && this.lastInitMessage) {
+          if (this.opts.consoleLogEnabled) {
+            console.log("DevTools reconnected - resending init message");
+          }
+          this.buffer.unshift({
+            type: "init",
+            payload: this.lastInitMessage
+          });
+        }
+        this.hasConnectedOnce = true;
+        this.flush();
+        resolve();
+      };
+      ws.onclose = () => {
+        this.connecting = false;
+        if (!this.closed && this.reconnectAttempts < this.maxReconnectAttempts) {
+          this.reconnectAttempts++;
+          if (this.opts.consoleLogEnabled) {
+            console.log(
+              `DevTools disconnected, reconnecting... (attempt ${this.reconnectAttempts})`
+            );
+          }
+          setTimeout(
+            () => this.ensureSocket().catch(() => {
+            }),
+            this.reconnectDelayMs
+          );
+        } else if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+          if (this.opts.consoleLogEnabled) {
+            console.log("DevTools max reconnect attempts reached");
+          }
+        }
+      };
+      ws.onerror = () => {
+        try {
+          ws.close();
+        } catch {
+        }
+      };
+      ws.onmessage = (ev) => {
+        try {
+          const data = typeof ev.data === "string" ? ev.data : "" + ev.data;
+          const msg = JSON.parse(data);
+          if (msg && msg.type === "stimulate") {
+            const cmd = msg;
+            const ack = {
+              type: "stimulate-accepted",
+              stimulationCommandId: cmd.stimulationCommandId,
+              stimulationId: cmd.stimulationCommandId,
+              appId: cmd.appId
+            };
+            try {
+              this.ws?.send(JSON.stringify(ack));
+            } catch {
+            }
+            this.onStimulate?.(cmd);
+          }
+        } catch {
+        }
+      };
+    });
+  }
+  async sendInitMessage(message) {
+    this.lastInitMessage = message;
+    this.buffer.push({ type: "init", payload: message });
+    if (this.buffer.length >= this.bufferMaxSize) await this.flush();
+    else void this.flush();
+  }
+  async sendNeuronResponseMessage(message) {
+    this.buffer.push({ type: "response", payload: message });
+    if (this.buffer.length >= this.bufferMaxSize) await this.flush();
+    else void this.flush();
+  }
+  async sendStimulationMessage(message) {
+    await this.ensureSocket();
+    if (!this.ws || this.ws.readyState !== 1) return;
+    try {
+      this.ws.send(JSON.stringify(message));
+    } catch {
+    }
+  }
+  async flush() {
+    if (this.buffer.length === 0) return;
+    await this.ensureSocket();
+    if (!this.ws || this.ws.readyState !== 1) return;
+    const items = this.buffer.splice(0, this.buffer.length);
+    const replayResponses = items.filter((item) => item.type === "response").filter((item) => {
+      const stimId = item.payload?.stimulationId || "";
+      return typeof stimId === "string" && stimId.includes("-replay-");
+    });
+    if (replayResponses.length > 0 && this.opts.consoleLogEnabled) {
+      console.log("[Transport] Flushing REPLAY responses batch:", {
+        totalItems: items.length,
+        replayResponsesCount: replayResponses.length,
+        replayStimIds: replayResponses.slice(0, 3).map((r) => r.payload?.stimulationId),
+        replayAppIds: replayResponses.slice(0, 3).map((r) => r.payload?.appId)
+      });
+    }
+    try {
+      this.ws.send(JSON.stringify({ type: "batch", items }));
+    } catch {
+      this.buffer.unshift(...items);
+    }
+  }
+  onStimulateCommand(handler) {
+    this.onStimulate = handler;
+    return () => {
+      this.onStimulate = void 0;
+    };
+  }
+  /** Close the connection and stop reconnecting */
+  close() {
+    this.closed = true;
+    try {
+      this.ws?.close();
+    } catch {
+    }
+    this.ws = void 0;
+  }
+  /** Get connection status */
+  get isConnected() {
+    return this.ws?.readyState === 1;
+  }
+  /** Get buffered message count */
+  get bufferSize() {
+    return this.buffer.length;
+  }
+};
+
+exports.CNSDevToolsTransportWs = CNSDevToolsTransportWs;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ICNSDevToolsTransport } from '@cnstra/devtools';\nimport type {\n    InitMessage,\n    NeuronResponseMessage,\n    StimulateCommand,\n    StimulateAccepted,\n    StimulateRejected,\n    StimulationMessage,\n} from '@cnstra/devtools-dto';\n\nexport type TWSOpts = {\n    /** ws://localhost:7777 or wss://... */\n    url: string;\n    /** Optional protocols */\n    protocols?: string | string[];\n    /** Reconnect delay in ms (default 1000) */\n    reconnectDelayMs?: number;\n    /** Max buffered messages before force flush (default 100) */\n    bufferMaxSize?: number;\n    /** Optional WebSocket implementation for Node (e.g., globalThis.WebSocket or ws) */\n    webSocketImpl?: typeof WebSocket;\n    /** Auto-connect on first message (default true) */\n    autoConnect?: boolean;\n    /** Max reconnect attempts (default Infinity) */\n    maxReconnectAttempts?: number;\n    /** When true, print transport-level console logs */\n    consoleLogEnabled?: boolean;\n};\n\ntype WSLike = WebSocket;\n\nexport class CNSDevToolsTransportWs implements ICNSDevToolsTransport {\n    private ws?: WSLike;\n    private connecting = false;\n    private closed = false;\n    private readonly buffer: Array<{\n        type: 'init' | 'response';\n        payload: any;\n    }> = [];\n\n    // Store the latest init message for reconnect\n    private lastInitMessage?: InitMessage;\n    private hasConnectedOnce = false;\n    private reconnectAttempts = 0;\n\n    constructor(private readonly opts: TWSOpts) {}\n\n    private get reconnectDelayMs() {\n        return this.opts.reconnectDelayMs ?? 1000;\n    }\n    private get bufferMaxSize() {\n        return this.opts.bufferMaxSize ?? 100;\n    }\n    private get maxReconnectAttempts() {\n        return this.opts.maxReconnectAttempts ?? Infinity;\n    }\n\n    private ensureSocket(): Promise<void> {\n        const WS: typeof WebSocket | undefined =\n            this.opts.webSocketImpl ||\n            (typeof WebSocket !== 'undefined' ? WebSocket : undefined);\n        if (!WS)\n            return Promise.reject(\n                new Error(\n                    'WebSocket implementation is not available. Provide webSocketImpl.'\n                )\n            );\n        if (this.ws && this.ws.readyState === 1)\n            // OPEN = 1\n            return Promise.resolve();\n        if (this.connecting) {\n            return new Promise(resolve => {\n                const check = () => {\n                    if (this.ws && this.ws.readyState === 1)\n                        // OPEN = 1\n                        return resolve();\n                    setTimeout(check, 50);\n                };\n                check();\n            });\n        }\n        this.connecting = true;\n        return new Promise(resolve => {\n            const ws = new WS(this.opts.url, this.opts.protocols) as WSLike;\n            this.ws = ws;\n            ws.onopen = () => {\n                if (this.opts.consoleLogEnabled) {\n                    console.log('DevTools connected to server');\n                }\n                this.connecting = false;\n                this.reconnectAttempts = 0; // Reset on successful connection\n\n                // On reconnect, resend init message first\n                if (this.hasConnectedOnce && this.lastInitMessage) {\n                    if (this.opts.consoleLogEnabled) {\n                        console.log('DevTools reconnected - resending init message');\n                    }\n                    this.buffer.unshift({\n                        type: 'init',\n                        payload: this.lastInitMessage,\n                    });\n                }\n\n                this.hasConnectedOnce = true;\n                this.flush();\n                resolve();\n            };\n            ws.onclose = () => {\n                this.connecting = false;\n                if (\n                    !this.closed &&\n                    this.reconnectAttempts < this.maxReconnectAttempts\n                ) {\n                    this.reconnectAttempts++;\n                    if (this.opts.consoleLogEnabled) {\n                        console.log(\n                            `DevTools disconnected, reconnecting... (attempt ${this.reconnectAttempts})`\n                        );\n                    }\n                    setTimeout(\n                        () => this.ensureSocket().catch(() => {}),\n                        this.reconnectDelayMs\n                    );\n                } else if (\n                    this.reconnectAttempts >= this.maxReconnectAttempts\n                ) {\n                    if (this.opts.consoleLogEnabled) {\n                        console.log('DevTools max reconnect attempts reached');\n                    }\n                }\n            };\n            ws.onerror = () => {\n                try {\n                    ws.close();\n                } catch {}\n            };\n            ws.onmessage = (ev: MessageEvent) => {\n                try {\n                    const data =\n                        typeof ev.data === 'string' ? ev.data : '' + ev.data;\n                    const msg = JSON.parse(data);\n                    if (msg && msg.type === 'stimulate') {\n                        const cmd = msg as StimulateCommand & {\n                            appId?: string;\n                            cnsId?: string;\n                        };\n                        const ack: StimulateAccepted = {\n                            type: 'stimulate-accepted',\n                            stimulationCommandId: cmd.stimulationCommandId,\n                            stimulationId: cmd.stimulationCommandId,\n                            appId: cmd.appId,\n                        };\n                        try {\n                            this.ws?.send(JSON.stringify(ack));\n                        } catch {}\n                        this.onStimulate?.(cmd);\n                    }\n                } catch {\n                    // ignore invalid messages\n                }\n            };\n        });\n    }\n\n    async sendInitMessage(message: InitMessage): Promise<void> {\n        // Store the latest init message for reconnects\n        this.lastInitMessage = message;\n\n        this.buffer.push({ type: 'init', payload: message });\n        if (this.buffer.length >= this.bufferMaxSize) await this.flush();\n        else void this.flush();\n    }\n\n    async sendNeuronResponseMessage(\n        message: NeuronResponseMessage\n    ): Promise<void> {\n        this.buffer.push({ type: 'response', payload: message });\n        if (this.buffer.length >= this.bufferMaxSize) await this.flush();\n        else void this.flush();\n    }\n\n    async sendStimulationMessage(message: StimulationMessage): Promise<void> {\n        await this.ensureSocket();\n        if (!this.ws || this.ws.readyState !== 1) return; // OPEN = 1\n        try {\n            this.ws.send(JSON.stringify(message));\n        } catch {\n            // ignore send errors\n        }\n    }\n\n    private async flush(): Promise<void> {\n        if (this.buffer.length === 0) return;\n        await this.ensureSocket();\n        /* istanbul ignore next -- ts-jest source-map occasionally misattributes coverage for this guard */\n        if (!this.ws || this.ws.readyState !== 1) return; // OPEN = 1\n        /* istanbul ignore next -- see note above */\n        const items = this.buffer.splice(0, this.buffer.length);\n\n        // Check for replay responses in the batch\n        /* istanbul ignore next -- see note above */\n        const replayResponses = items\n            .filter(item => item.type === 'response')\n            .filter(item => {\n                const stimId = item.payload?.stimulationId || '';\n                return (\n                    typeof stimId === 'string' && stimId.includes('-replay-')\n                );\n            });\n\n        if (replayResponses.length > 0 && this.opts.consoleLogEnabled) {\n            console.log('[Transport] Flushing REPLAY responses batch:', {\n                totalItems: items.length,\n                replayResponsesCount: replayResponses.length,\n                replayStimIds: replayResponses\n                    .slice(0, 3)\n                    .map(r => r.payload?.stimulationId),\n                replayAppIds: replayResponses\n                    .slice(0, 3)\n                    .map(r => r.payload?.appId),\n            });\n        }\n\n        try {\n            this.ws.send(JSON.stringify({ type: 'batch', items }));\n        } catch {\n            // requeue if send fails\n            this.buffer.unshift(...items);\n        }\n    }\n\n    private onStimulate?: (cmd: StimulateCommand) => void;\n    onStimulateCommand(handler: (cmd: StimulateCommand) => void): () => void {\n        this.onStimulate = handler;\n        return () => {\n            this.onStimulate = undefined;\n        };\n    }\n\n    /** Close the connection and stop reconnecting */\n    close(): void {\n        this.closed = true;\n        try {\n            this.ws?.close();\n        } catch {}\n        this.ws = undefined;\n    }\n\n    /** Get connection status */\n    get isConnected(): boolean {\n        return this.ws?.readyState === 1; // OPEN = 1\n    }\n\n    /** Get buffered message count */\n    get bufferSize(): number {\n        return this.buffer.length;\n    }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import type { ICNSDevToolsTransport } from '@cnstra/devtools';
+import type { InitMessage, NeuronResponseMessage, StimulateCommand, StimulationMessage } from '@cnstra/devtools-dto';
+export type TWSOpts = {
+    /** ws://localhost:7777 or wss://... */
+    url: string;
+    /** Optional protocols */
+    protocols?: string | string[];
+    /** Reconnect delay in ms (default 1000) */
+    reconnectDelayMs?: number;
+    /** Max buffered messages before force flush (default 100) */
+    bufferMaxSize?: number;
+    /** Optional WebSocket implementation for Node (e.g., globalThis.WebSocket or ws) */
+    webSocketImpl?: typeof WebSocket;
+    /** Auto-connect on first message (default true) */
+    autoConnect?: boolean;
+    /** Max reconnect attempts (default Infinity) */
+    maxReconnectAttempts?: number;
+    /** When true, print transport-level console logs */
+    consoleLogEnabled?: boolean;
+};
+export declare class CNSDevToolsTransportWs implements ICNSDevToolsTransport {
+    private readonly opts;
+    private ws?;
+    private connecting;
+    private closed;
+    private readonly buffer;
+    private lastInitMessage?;
+    private hasConnectedOnce;
+    private reconnectAttempts;
+    constructor(opts: TWSOpts);
+    private get reconnectDelayMs();
+    private get bufferMaxSize();
+    private get maxReconnectAttempts();
+    private ensureSocket;
+    sendInitMessage(message: InitMessage): Promise<void>;
+    sendNeuronResponseMessage(message: NeuronResponseMessage): Promise<void>;
+    sendStimulationMessage(message: StimulationMessage): Promise<void>;
+    private flush;
+    private onStimulate?;
+    onStimulateCommand(handler: (cmd: StimulateCommand) => void): () => void;
+    /** Close the connection and stop reconnecting */
+    close(): void;
+    /** Get connection status */
+    get isConnected(): boolean;
+    /** Get buffered message count */
+    get bufferSize(): number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACR,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAGhB,kBAAkB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,OAAO,GAAG;IAClB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAIF,qBAAa,sBAAuB,YAAW,qBAAqB;IAcpD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbjC,OAAO,CAAC,EAAE,CAAC,CAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGf;IAGR,OAAO,CAAC,eAAe,CAAC,CAAc;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAK;gBAED,IAAI,EAAE,OAAO;IAE1C,OAAO,KAAK,gBAAgB,GAE3B;IACD,OAAO,KAAK,aAAa,GAExB;IACD,OAAO,KAAK,oBAAoB,GAE/B;IAED,OAAO,CAAC,YAAY;IA2Gd,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASpD,yBAAyB,CAC3B,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAMV,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAU1D,KAAK;IAwCnB,OAAO,CAAC,WAAW,CAAC,CAAkC;IACtD,kBAAkB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxE,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAQb,4BAA4B;IAC5B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,iCAAiC;IACjC,IAAI,UAAU,IAAI,MAAM,CAEvB;CACJ"}

package/dist/index.js

@@ -0,0 +1,181 @@
+// src/index.ts
+var CNSDevToolsTransportWs = class {
+  constructor(opts) {
+    this.opts = opts;
+    this.connecting = false;
+    this.closed = false;
+    this.buffer = [];
+    this.hasConnectedOnce = false;
+    this.reconnectAttempts = 0;
+  }
+  get reconnectDelayMs() {
+    return this.opts.reconnectDelayMs ?? 1e3;
+  }
+  get bufferMaxSize() {
+    return this.opts.bufferMaxSize ?? 100;
+  }
+  get maxReconnectAttempts() {
+    return this.opts.maxReconnectAttempts ?? Infinity;
+  }
+  ensureSocket() {
+    const WS = this.opts.webSocketImpl || (typeof WebSocket !== "undefined" ? WebSocket : void 0);
+    if (!WS)
+      return Promise.reject(
+        new Error(
+          "WebSocket implementation is not available. Provide webSocketImpl."
+        )
+      );
+    if (this.ws && this.ws.readyState === 1)
+      return Promise.resolve();
+    if (this.connecting) {
+      return new Promise((resolve) => {
+        const check = () => {
+          if (this.ws && this.ws.readyState === 1)
+            return resolve();
+          setTimeout(check, 50);
+        };
+        check();
+      });
+    }
+    this.connecting = true;
+    return new Promise((resolve) => {
+      const ws = new WS(this.opts.url, this.opts.protocols);
+      this.ws = ws;
+      ws.onopen = () => {
+        if (this.opts.consoleLogEnabled) {
+          console.log("DevTools connected to server");
+        }
+        this.connecting = false;
+        this.reconnectAttempts = 0;
+        if (this.hasConnectedOnce && this.lastInitMessage) {
+          if (this.opts.consoleLogEnabled) {
+            console.log("DevTools reconnected - resending init message");
+          }
+          this.buffer.unshift({
+            type: "init",
+            payload: this.lastInitMessage
+          });
+        }
+        this.hasConnectedOnce = true;
+        this.flush();
+        resolve();
+      };
+      ws.onclose = () => {
+        this.connecting = false;
+        if (!this.closed && this.reconnectAttempts < this.maxReconnectAttempts) {
+          this.reconnectAttempts++;
+          if (this.opts.consoleLogEnabled) {
+            console.log(
+              `DevTools disconnected, reconnecting... (attempt ${this.reconnectAttempts})`
+            );
+          }
+          setTimeout(
+            () => this.ensureSocket().catch(() => {
+            }),
+            this.reconnectDelayMs
+          );
+        } else if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+          if (this.opts.consoleLogEnabled) {
+            console.log("DevTools max reconnect attempts reached");
+          }
+        }
+      };
+      ws.onerror = () => {
+        try {
+          ws.close();
+        } catch {
+        }
+      };
+      ws.onmessage = (ev) => {
+        try {
+          const data = typeof ev.data === "string" ? ev.data : "" + ev.data;
+          const msg = JSON.parse(data);
+          if (msg && msg.type === "stimulate") {
+            const cmd = msg;
+            const ack = {
+              type: "stimulate-accepted",
+              stimulationCommandId: cmd.stimulationCommandId,
+              stimulationId: cmd.stimulationCommandId,
+              appId: cmd.appId
+            };
+            try {
+              this.ws?.send(JSON.stringify(ack));
+            } catch {
+            }
+            this.onStimulate?.(cmd);
+          }
+        } catch {
+        }
+      };
+    });
+  }
+  async sendInitMessage(message) {
+    this.lastInitMessage = message;
+    this.buffer.push({ type: "init", payload: message });
+    if (this.buffer.length >= this.bufferMaxSize) await this.flush();
+    else void this.flush();
+  }
+  async sendNeuronResponseMessage(message) {
+    this.buffer.push({ type: "response", payload: message });
+    if (this.buffer.length >= this.bufferMaxSize) await this.flush();
+    else void this.flush();
+  }
+  async sendStimulationMessage(message) {
+    await this.ensureSocket();
+    if (!this.ws || this.ws.readyState !== 1) return;
+    try {
+      this.ws.send(JSON.stringify(message));
+    } catch {
+    }
+  }
+  async flush() {
+    if (this.buffer.length === 0) return;
+    await this.ensureSocket();
+    if (!this.ws || this.ws.readyState !== 1) return;
+    const items = this.buffer.splice(0, this.buffer.length);
+    const replayResponses = items.filter((item) => item.type === "response").filter((item) => {
+      const stimId = item.payload?.stimulationId || "";
+      return typeof stimId === "string" && stimId.includes("-replay-");
+    });
+    if (replayResponses.length > 0 && this.opts.consoleLogEnabled) {
+      console.log("[Transport] Flushing REPLAY responses batch:", {
+        totalItems: items.length,
+        replayResponsesCount: replayResponses.length,
+        replayStimIds: replayResponses.slice(0, 3).map((r) => r.payload?.stimulationId),
+        replayAppIds: replayResponses.slice(0, 3).map((r) => r.payload?.appId)
+      });
+    }
+    try {
+      this.ws.send(JSON.stringify({ type: "batch", items }));
+    } catch {
+      this.buffer.unshift(...items);
+    }
+  }
+  onStimulateCommand(handler) {
+    this.onStimulate = handler;
+    return () => {
+      this.onStimulate = void 0;
+    };
+  }
+  /** Close the connection and stop reconnecting */
+  close() {
+    this.closed = true;
+    try {
+      this.ws?.close();
+    } catch {
+    }
+    this.ws = void 0;
+  }
+  /** Get connection status */
+  get isConnected() {
+    return this.ws?.readyState === 1;
+  }
+  /** Get buffered message count */
+  get bufferSize() {
+    return this.buffer.length;
+  }
+};
+
+export { CNSDevToolsTransportWs };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ICNSDevToolsTransport } from '@cnstra/devtools';\nimport type {\n    InitMessage,\n    NeuronResponseMessage,\n    StimulateCommand,\n    StimulateAccepted,\n    StimulateRejected,\n    StimulationMessage,\n} from '@cnstra/devtools-dto';\n\nexport type TWSOpts = {\n    /** ws://localhost:7777 or wss://... */\n    url: string;\n    /** Optional protocols */\n    protocols?: string | string[];\n    /** Reconnect delay in ms (default 1000) */\n    reconnectDelayMs?: number;\n    /** Max buffered messages before force flush (default 100) */\n    bufferMaxSize?: number;\n    /** Optional WebSocket implementation for Node (e.g., globalThis.WebSocket or ws) */\n    webSocketImpl?: typeof WebSocket;\n    /** Auto-connect on first message (default true) */\n    autoConnect?: boolean;\n    /** Max reconnect attempts (default Infinity) */\n    maxReconnectAttempts?: number;\n    /** When true, print transport-level console logs */\n    consoleLogEnabled?: boolean;\n};\n\ntype WSLike = WebSocket;\n\nexport class CNSDevToolsTransportWs implements ICNSDevToolsTransport {\n    private ws?: WSLike;\n    private connecting = false;\n    private closed = false;\n    private readonly buffer: Array<{\n        type: 'init' | 'response';\n        payload: any;\n    }> = [];\n\n    // Store the latest init message for reconnect\n    private lastInitMessage?: InitMessage;\n    private hasConnectedOnce = false;\n    private reconnectAttempts = 0;\n\n    constructor(private readonly opts: TWSOpts) {}\n\n    private get reconnectDelayMs() {\n        return this.opts.reconnectDelayMs ?? 1000;\n    }\n    private get bufferMaxSize() {\n        return this.opts.bufferMaxSize ?? 100;\n    }\n    private get maxReconnectAttempts() {\n        return this.opts.maxReconnectAttempts ?? Infinity;\n    }\n\n    private ensureSocket(): Promise<void> {\n        const WS: typeof WebSocket | undefined =\n            this.opts.webSocketImpl ||\n            (typeof WebSocket !== 'undefined' ? WebSocket : undefined);\n        if (!WS)\n            return Promise.reject(\n                new Error(\n                    'WebSocket implementation is not available. Provide webSocketImpl.'\n                )\n            );\n        if (this.ws && this.ws.readyState === 1)\n            // OPEN = 1\n            return Promise.resolve();\n        if (this.connecting) {\n            return new Promise(resolve => {\n                const check = () => {\n                    if (this.ws && this.ws.readyState === 1)\n                        // OPEN = 1\n                        return resolve();\n                    setTimeout(check, 50);\n                };\n                check();\n            });\n        }\n        this.connecting = true;\n        return new Promise(resolve => {\n            const ws = new WS(this.opts.url, this.opts.protocols) as WSLike;\n            this.ws = ws;\n            ws.onopen = () => {\n                if (this.opts.consoleLogEnabled) {\n                    console.log('DevTools connected to server');\n                }\n                this.connecting = false;\n                this.reconnectAttempts = 0; // Reset on successful connection\n\n                // On reconnect, resend init message first\n                if (this.hasConnectedOnce && this.lastInitMessage) {\n                    if (this.opts.consoleLogEnabled) {\n                        console.log('DevTools reconnected - resending init message');\n                    }\n                    this.buffer.unshift({\n                        type: 'init',\n                        payload: this.lastInitMessage,\n                    });\n                }\n\n                this.hasConnectedOnce = true;\n                this.flush();\n                resolve();\n            };\n            ws.onclose = () => {\n                this.connecting = false;\n                if (\n                    !this.closed &&\n                    this.reconnectAttempts < this.maxReconnectAttempts\n                ) {\n                    this.reconnectAttempts++;\n                    if (this.opts.consoleLogEnabled) {\n                        console.log(\n                            `DevTools disconnected, reconnecting... (attempt ${this.reconnectAttempts})`\n                        );\n                    }\n                    setTimeout(\n                        () => this.ensureSocket().catch(() => {}),\n                        this.reconnectDelayMs\n                    );\n                } else if (\n                    this.reconnectAttempts >= this.maxReconnectAttempts\n                ) {\n                    if (this.opts.consoleLogEnabled) {\n                        console.log('DevTools max reconnect attempts reached');\n                    }\n                }\n            };\n            ws.onerror = () => {\n                try {\n                    ws.close();\n                } catch {}\n            };\n            ws.onmessage = (ev: MessageEvent) => {\n                try {\n                    const data =\n                        typeof ev.data === 'string' ? ev.data : '' + ev.data;\n                    const msg = JSON.parse(data);\n                    if (msg && msg.type === 'stimulate') {\n                        const cmd = msg as StimulateCommand & {\n                            appId?: string;\n                            cnsId?: string;\n                        };\n                        const ack: StimulateAccepted = {\n                            type: 'stimulate-accepted',\n                            stimulationCommandId: cmd.stimulationCommandId,\n                            stimulationId: cmd.stimulationCommandId,\n                            appId: cmd.appId,\n                        };\n                        try {\n                            this.ws?.send(JSON.stringify(ack));\n                        } catch {}\n                        this.onStimulate?.(cmd);\n                    }\n                } catch {\n                    // ignore invalid messages\n                }\n            };\n        });\n    }\n\n    async sendInitMessage(message: InitMessage): Promise<void> {\n        // Store the latest init message for reconnects\n        this.lastInitMessage = message;\n\n        this.buffer.push({ type: 'init', payload: message });\n        if (this.buffer.length >= this.bufferMaxSize) await this.flush();\n        else void this.flush();\n    }\n\n    async sendNeuronResponseMessage(\n        message: NeuronResponseMessage\n    ): Promise<void> {\n        this.buffer.push({ type: 'response', payload: message });\n        if (this.buffer.length >= this.bufferMaxSize) await this.flush();\n        else void this.flush();\n    }\n\n    async sendStimulationMessage(message: StimulationMessage): Promise<void> {\n        await this.ensureSocket();\n        if (!this.ws || this.ws.readyState !== 1) return; // OPEN = 1\n        try {\n            this.ws.send(JSON.stringify(message));\n        } catch {\n            // ignore send errors\n        }\n    }\n\n    private async flush(): Promise<void> {\n        if (this.buffer.length === 0) return;\n        await this.ensureSocket();\n        /* istanbul ignore next -- ts-jest source-map occasionally misattributes coverage for this guard */\n        if (!this.ws || this.ws.readyState !== 1) return; // OPEN = 1\n        /* istanbul ignore next -- see note above */\n        const items = this.buffer.splice(0, this.buffer.length);\n\n        // Check for replay responses in the batch\n        /* istanbul ignore next -- see note above */\n        const replayResponses = items\n            .filter(item => item.type === 'response')\n            .filter(item => {\n                const stimId = item.payload?.stimulationId || '';\n                return (\n                    typeof stimId === 'string' && stimId.includes('-replay-')\n                );\n            });\n\n        if (replayResponses.length > 0 && this.opts.consoleLogEnabled) {\n            console.log('[Transport] Flushing REPLAY responses batch:', {\n                totalItems: items.length,\n                replayResponsesCount: replayResponses.length,\n                replayStimIds: replayResponses\n                    .slice(0, 3)\n                    .map(r => r.payload?.stimulationId),\n                replayAppIds: replayResponses\n                    .slice(0, 3)\n                    .map(r => r.payload?.appId),\n            });\n        }\n\n        try {\n            this.ws.send(JSON.stringify({ type: 'batch', items }));\n        } catch {\n            // requeue if send fails\n            this.buffer.unshift(...items);\n        }\n    }\n\n    private onStimulate?: (cmd: StimulateCommand) => void;\n    onStimulateCommand(handler: (cmd: StimulateCommand) => void): () => void {\n        this.onStimulate = handler;\n        return () => {\n            this.onStimulate = undefined;\n        };\n    }\n\n    /** Close the connection and stop reconnecting */\n    close(): void {\n        this.closed = true;\n        try {\n            this.ws?.close();\n        } catch {}\n        this.ws = undefined;\n    }\n\n    /** Get connection status */\n    get isConnected(): boolean {\n        return this.ws?.readyState === 1; // OPEN = 1\n    }\n\n    /** Get buffered message count */\n    get bufferSize(): number {\n        return this.buffer.length;\n    }\n}\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@cnstra/devtools-transport-ws",
+  "version": "1.1.0",
+  "description": "WebSocket transport for CNStra DevTools",
+  "keywords": [
+    "devtools",
+    "cnstra",
+    "transport",
+    "websocket",
+    "ws"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly",
+    "build:types": "tsc --emitDeclarationOnly",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cnstra/devtools-dto": "1.0.0"
+  },
+  "peerDependencies": {
+    "@cnstra/devtools": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "tsup": "8.5.1",
+    "typescript": "^5.8.3"
+  },
+  "author": "Andrei Baikov <abaikov23@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}