@datagrout/conduit 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -649,9 +649,31 @@ declare class WsTransport extends Transport {
     private readonly _pending;
     private readonly _pendingSubscribe;
     private readonly _subscriptions;
+    /**
+     * Handle for the recurring ping timer; non-null only while connected.
+     * Cleared on disconnect / close.  Set indirectly via {@link _startPingTimer}.
+     */
+    private _pingTimer;
+    /**
+     * Interval in ms between client-initiated ping frames.  Public-readable so
+     * tests can inject a small value via {@link WsTransport.setPingInterval};
+     * defaults to {@link PING_INTERVAL_MS}.
+     */
+    private _pingIntervalMs;
     constructor(url: string, auth?: AuthConfig, _timeout?: number, _identity?: ConduitIdentity);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
+    /**
+     * Override the ping interval (ms) — used by tests to avoid 25-second waits.
+     * Must be called BEFORE {@link connect}; has no effect on an already-running
+     * timer.  In production code, leave the default ({@link PING_INTERVAL_MS}).
+     */
+    setPingInterval(intervalMs: number): void;
+    /** Tracks how many ping frames this transport has sent — for tests. */
+    get pingsSent(): number;
+    private _pingsSent;
+    private _startPingTimer;
+    private _stopPingTimer;
     /**
      * Open a server-side push subscription for `topic`.
      *

package/dist/index.d.ts

@@ -649,9 +649,31 @@ declare class WsTransport extends Transport {
     private readonly _pending;
     private readonly _pendingSubscribe;
     private readonly _subscriptions;
+    /**
+     * Handle for the recurring ping timer; non-null only while connected.
+     * Cleared on disconnect / close.  Set indirectly via {@link _startPingTimer}.
+     */
+    private _pingTimer;
+    /**
+     * Interval in ms between client-initiated ping frames.  Public-readable so
+     * tests can inject a small value via {@link WsTransport.setPingInterval};
+     * defaults to {@link PING_INTERVAL_MS}.
+     */
+    private _pingIntervalMs;
     constructor(url: string, auth?: AuthConfig, _timeout?: number, _identity?: ConduitIdentity);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
+    /**
+     * Override the ping interval (ms) — used by tests to avoid 25-second waits.
+     * Must be called BEFORE {@link connect}; has no effect on an already-running
+     * timer.  In production code, leave the default ({@link PING_INTERVAL_MS}).
+     */
+    setPingInterval(intervalMs: number): void;
+    /** Tracks how many ping frames this transport has sent — for tests. */
+    get pingsSent(): number;
+    private _pingsSent;
+    private _startPingTimer;
+    private _stopPingTimer;
     /**
      * Open a server-side push subscription for `topic`.
      *

package/dist/index.js

@@ -836,6 +836,7 @@ var JSONRPCTransport = class extends Transport {
 // src/transports/ws.ts
 var SUBPROTOCOL = "datagrout-jsonrpc.v1";
 var SUBSCRIPTION_BUFFER = 256;
+var PING_INTERVAL_MS = 25e3;
 var Subscription = class {
   id;
   topic;
@@ -901,6 +902,17 @@ var WsTransport = class extends Transport {
   _pending = /* @__PURE__ */ new Map();
   _pendingSubscribe = /* @__PURE__ */ new Map();
   _subscriptions = /* @__PURE__ */ new Map();
+  /**
+   * Handle for the recurring ping timer; non-null only while connected.
+   * Cleared on disconnect / close.  Set indirectly via {@link _startPingTimer}.
+   */
+  _pingTimer = null;
+  /**
+   * Interval in ms between client-initiated ping frames.  Public-readable so
+   * tests can inject a small value via {@link WsTransport.setPingInterval};
+   * defaults to {@link PING_INTERVAL_MS}.
+   */
+  _pingIntervalMs = PING_INTERVAL_MS;
   constructor(url, auth, _timeout, _identity) {
     super();
     const scheme = new URL(url).protocol.replace(":", "");
@@ -930,13 +942,16 @@ var WsTransport = class extends Transport {
     ws.onerror = (_ev) => this._failAll("WS connection error");
     ws.onclose = () => {
       this._failAll("WS connection closed");
+      this._stopPingTimer();
       this._ws = null;
     };
     this._ws = ws;
+    this._startPingTimer();
   }
   async disconnect() {
     const ws = this._ws;
     this._ws = null;
+    this._stopPingTimer();
     this._failAll("WS connection closed");
     if (ws !== null) {
       try {
@@ -945,6 +960,42 @@ var WsTransport = class extends Transport {
       }
     }
   }
+  // ── Ping keepalive ────────────────────────────────────────────────────────
+  /**
+   * Override the ping interval (ms) — used by tests to avoid 25-second waits.
+   * Must be called BEFORE {@link connect}; has no effect on an already-running
+   * timer.  In production code, leave the default ({@link PING_INTERVAL_MS}).
+   */
+  setPingInterval(intervalMs) {
+    this._pingIntervalMs = intervalMs;
+  }
+  /** Tracks how many ping frames this transport has sent — for tests. */
+  get pingsSent() {
+    return this._pingsSent;
+  }
+  _pingsSent = 0;
+  _startPingTimer() {
+    if (this._pingTimer !== null || this._pingIntervalMs <= 0) return;
+    this._pingTimer = setInterval(() => {
+      const ws = this._ws;
+      if (ws === null) return;
+      if (typeof ws.ping === "function") {
+        try {
+          ws.ping();
+          this._pingsSent += 1;
+        } catch {
+        }
+      }
+    }, this._pingIntervalMs);
+    const t = this._pingTimer;
+    if (typeof t.unref === "function") t.unref();
+  }
+  _stopPingTimer() {
+    if (this._pingTimer !== null) {
+      clearInterval(this._pingTimer);
+      this._pingTimer = null;
+    }
+  }
   // ── Subscriptions ─────────────────────────────────────────────────────────
   /**
    * Open a server-side push subscription for `topic`.

package/dist/index.mjs

@@ -621,6 +621,7 @@ var JSONRPCTransport = class extends Transport {
 // src/transports/ws.ts
 var SUBPROTOCOL = "datagrout-jsonrpc.v1";
 var SUBSCRIPTION_BUFFER = 256;
+var PING_INTERVAL_MS = 25e3;
 var Subscription = class {
   id;
   topic;
@@ -686,6 +687,17 @@ var WsTransport = class extends Transport {
   _pending = /* @__PURE__ */ new Map();
   _pendingSubscribe = /* @__PURE__ */ new Map();
   _subscriptions = /* @__PURE__ */ new Map();
+  /**
+   * Handle for the recurring ping timer; non-null only while connected.
+   * Cleared on disconnect / close.  Set indirectly via {@link _startPingTimer}.
+   */
+  _pingTimer = null;
+  /**
+   * Interval in ms between client-initiated ping frames.  Public-readable so
+   * tests can inject a small value via {@link WsTransport.setPingInterval};
+   * defaults to {@link PING_INTERVAL_MS}.
+   */
+  _pingIntervalMs = PING_INTERVAL_MS;
   constructor(url, auth, _timeout, _identity) {
     super();
     const scheme = new URL(url).protocol.replace(":", "");
@@ -715,13 +727,16 @@ var WsTransport = class extends Transport {
     ws.onerror = (_ev) => this._failAll("WS connection error");
     ws.onclose = () => {
       this._failAll("WS connection closed");
+      this._stopPingTimer();
       this._ws = null;
     };
     this._ws = ws;
+    this._startPingTimer();
   }
   async disconnect() {
     const ws = this._ws;
     this._ws = null;
+    this._stopPingTimer();
     this._failAll("WS connection closed");
     if (ws !== null) {
       try {
@@ -730,6 +745,42 @@ var WsTransport = class extends Transport {
       }
     }
   }
+  // ── Ping keepalive ────────────────────────────────────────────────────────
+  /**
+   * Override the ping interval (ms) — used by tests to avoid 25-second waits.
+   * Must be called BEFORE {@link connect}; has no effect on an already-running
+   * timer.  In production code, leave the default ({@link PING_INTERVAL_MS}).
+   */
+  setPingInterval(intervalMs) {
+    this._pingIntervalMs = intervalMs;
+  }
+  /** Tracks how many ping frames this transport has sent — for tests. */
+  get pingsSent() {
+    return this._pingsSent;
+  }
+  _pingsSent = 0;
+  _startPingTimer() {
+    if (this._pingTimer !== null || this._pingIntervalMs <= 0) return;
+    this._pingTimer = setInterval(() => {
+      const ws = this._ws;
+      if (ws === null) return;
+      if (typeof ws.ping === "function") {
+        try {
+          ws.ping();
+          this._pingsSent += 1;
+        } catch {
+        }
+      }
+    }, this._pingIntervalMs);
+    const t = this._pingTimer;
+    if (typeof t.unref === "function") t.unref();
+  }
+  _stopPingTimer() {
+    if (this._pingTimer !== null) {
+      clearInterval(this._pingTimer);
+      this._pingTimer = null;
+    }
+  }
   // ── Subscriptions ─────────────────────────────────────────────────────────
   /**
    * Open a server-side push subscription for `topic`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datagrout/conduit",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Production-ready MCP client with mTLS, OAuth 2.1, and semantic discovery",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",