@hardlydifficult/websocket 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/websocket
 
-A resilient WebSocket client for Node.js with automatic reconnection, heartbeat-based dead connection detection, and graceful request draining.
+A resilient WebSocket client with automatic reconnection (exponential backoff), heartbeat monitoring, proactive token refresh, and request tracking — fully typed in TypeScript.
 
 ## Installation
 
@@ -8,309 +8,137 @@ A resilient WebSocket client for Node.js with automatic reconnection, heartbeat-
 npm install @hardlydifficult/websocket
 ```
 
-Requires Node.js 18+.
-
 ## Quick Start
 
 ```typescript
 import { ReconnectingWebSocket } from "@hardlydifficult/websocket";
 
-interface Message {
-  type: string;
-  data: unknown;
-}
-
-const client = new ReconnectingWebSocket<Message>({
-  url: "ws://localhost:8080",
-});
-
-client.on("open", () => {
-  console.log("Connected");
-  client.send({ type: "hello", data: "world" });
-});
-
-client.on("message", (msg) => {
-  console.log("Received:", msg);
+const ws = new ReconnectingWebSocket({
+  url: "wss://api.example.com/ws",
+  auth: {
+    getToken: () => "Bearer token",
+  },
+  heartbeat: {
+    intervalMs: 30000, // ping every 30s
+    timeoutMs: 10000,  // terminate if no pong in 10s
+  },
 });
 
-client.on("error", (err) => {
-  console.error("Error:", err);
-});
+ws.on("open", () => console.log("Connected"));
+ws.on("message", (data) => console.log("Received:", data));
+ws.on("close", (code, reason) => console.log("Closed:", code, reason));
 
-client.connect();
+ws.connect();
+ws.send({ type: "hello" }); // sends as JSON
 ```
 
-## ReconnectingWebSocket
+## Auto-Reconnecting WebSocket
 
-A generic WebSocket client that automatically reconnects on disconnection, sends protocol-level pings for heartbeats, and parses JSON messages.
+`ReconnectingWebSocket` maintains a persistent connection with exponential backoff on disconnect, JSON message parsing, and optional authentication.
 
-### Constructor
-
-```typescript
-const client = new ReconnectingWebSocket<T>(options: WebSocketOptions);
-```
+### Constructor Options
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `url` | `string` | — | WebSocket server URL (required) |
-| `backoff.initialDelayMs` | `number` | `1000` | Initial reconnection delay in milliseconds |
-| `backoff.maxDelayMs` | `number` | `30000` | Maximum reconnection delay in milliseconds |
-| `backoff.multiplier` | `number` | `2` | Multiplier applied per reconnection attempt |
-| `heartbeat.intervalMs` | `number` | `30000` | Interval between pings in milliseconds |
-| `heartbeat.timeoutMs` | `number` | `10000` | Time to wait for pong before terminating |
+| `url` | `string` | — | WebSocket server URL |
+| `backoff` | `BackoffOptions` | `{ initialDelayMs: 1000, maxDelayMs: 30000, multiplier: 2 }` | Reconnection backoff config |
+| `heartbeat` | `HeartbeatOptions` | `{ intervalMs: 30000, timeoutMs: 10000 }` | Ping/pong monitoring |
+| `auth` | `AuthOptions` | — | Authentication (token fetched on each connect) |
+| `protocols` | `string[]` | — | WebSocket subprotocols |
+| `headers` | `Record<string, string>` | — | Additional handshake headers |
 
-### Methods
-
-#### `connect(): void`
-
-Connect to the WebSocket server. Idempotent — calling multiple times has no additional effect. If a reconnect timer is pending, cancels it and connects immediately, resetting the attempt counter.
+### Core Methods
 
 ```typescript
-client.connect();
+ws.connect(); // Connect or reconnect (idempotent)
+ws.disconnect(); // Stop and prevent future reconnects
+ws.reconnect(); // Force reconnect with fresh auth token
+ws.send(message); // Send JSON-serializable message
+ws.stopReconnecting(); // Allow in-flight work but prevent reconnection
+ws.connected; // Read-only: true if socket is open
+ws.on(event, listener); // Register event listener (returns unsubscribe function)
 ```
 
-#### `disconnect(): void`
-
-Disconnect from the server and stop all reconnection attempts. Closes the socket with code 1000.
+### Event Types
 
 ```typescript
-client.disconnect();
+ws.on("open", () => { /* connected */ });
+ws.on("close", (code, reason) => { /* disconnected */ });
+ws.on("error", (error) => { /* connection or parse error */ });
+ws.on("message", (data) => { /* message received & parsed */ });
 ```
 
-#### `send(message: T): void`
-
-Send a message as JSON. No-op if not currently connected.
-
-```typescript
-client.send({ type: "ping" });
-```
-
-#### `stopReconnecting(): void`
-
-Prevent reconnection without closing the current connection. Useful for graceful shutdown: deliver in-flight results but do not reconnect if the socket drops.
-
-```typescript
-client.stopReconnecting();
-```
-
-#### `on<K extends keyof WebSocketEvents<T>>(event: K, listener: WebSocketEvents<T>[K]): () => void`
-
-Subscribe to a WebSocket lifecycle event. Multiple listeners per event are supported. Returns an unsubscribe function.
+### Backoff Behavior
 
 ```typescript
-const unsubscribe = client.on("message", (msg) => {
-  console.log(msg);
-});
-
-unsubscribe(); // Stop listening
-```
-
-### Events
-
-#### `open`
+import { getBackoffDelay } from "@hardlydifficult/websocket";
 
-Fired when the connection is established.
+const opts = { initialDelayMs: 1000, maxDelayMs: 30000, multiplier: 2 };
 
-```typescript
-client.on("open", () => {
-  console.log("Connected");
-});
+getBackoffDelay(0, opts); // 1000 ms
+getBackoffDelay(1, opts); // 2000 ms
+getBackoffDelay(2, opts); // 4000 ms
+getBackoffDelay(10, opts); // capped at 30000 ms
 ```
 
-#### `close`
+## Proactive Token Refresh
 
-Fired when the connection is closed.
+`calculateTokenRefreshTime` schedules token refresh before expiry, using either 50% lifetime (short tokens) or a 2-minute buffer (longer tokens):
 
 ```typescript
-client.on("close", (code: number, reason: string) => {
-  console.log(`Closed with code ${code}: ${reason}`);
-});
-```
+import { calculateTokenRefreshTime } from "@hardlydifficult/websocket";
 
-#### `error`
+// 60s token → refresh at 30s (50% wins)
+calculateTokenRefreshTime(Date.now(), Date.now() + 60_000);
 
-Fired on connection or parse errors.
+// 5min token → refresh at 3min (2min buffer wins)
+calculateTokenRefreshTime(Date.now(), Date.now() + 5 * 60_000);
 
-```typescript
-client.on("error", (error: Error) => {
-  console.error("Error:", error.message);
-});
+// Reconnect to refresh token
+ws.reconnect(); // fetches fresh token from auth
 ```
 
-#### `message`
+### Token Refresh Strategy
 
-Fired when a message is received and parsed.
+| Token lifetime | Refresh strategy | Example (60s token) | Example (5min token) |
+|----------------|----------------|---------------------|----------------------|
+| Short (≤4min) | 50% lifetime | 30s after issue | N/A |
+| Long (>4min) | 2min before expiry | N/A | 3min after issue |
 
-```typescript
-client.on("message", (data: T) => {
-  console.log("Received:", data);
-});
-```
+## Request Tracker
 
-### Properties
+`RequestTracker` helps manage graceful shutdown by rejecting new requests during drain and notifying when all active requests complete.
 
-#### `connected: boolean`
-
-Whether the socket is currently open.
+### Methods
 
 ```typescript
-if (client.connected) {
-  client.send({ type: "ping" });
-}
-```
-
-### Exponential Backoff
-
-The client uses exponential backoff for reconnection delays. The delay for attempt `n` is calculated as:
-
-```
-delay = min(initialDelayMs × multiplier^n, maxDelayMs)
-```
-
-For example, with default settings (initial: 1000ms, max: 30000ms, multiplier: 2):
-- Attempt 0: 1000ms
-- Attempt 1: 2000ms
-- Attempt 2: 4000ms
-- Attempt 3: 8000ms
-- Attempt 4+: 30000ms (capped)
+const tracker = new RequestTracker();
 
-You can access this calculation directly:
+tracker.tryAccept(); // false if draining, otherwise increments active & returns true
+tracker.complete(); // decrements active; emits 'drained' when active reaches 0
+tracker.startDraining("reason"); // enter drain mode; rejects new requests
 
-```typescript
-import { getBackoffDelay } from "@hardlydifficult/websocket";
+tracker.draining; // true if draining
+tracker.active; // number of in-flight requests
 
-const delay = getBackoffDelay(2, {
-  initialDelayMs: 1000,
-  maxDelayMs: 30000,
-  multiplier: 2,
-});
-// delay = 4000
+tracker.on("draining", (reason) => { /* draining started */ });
+tracker.on("drained", () => { /* all requests complete */ });
 ```
 
-## RequestTracker
-
-Tracks active requests and manages draining state. Centralizes the pattern of rejecting new work during shutdown and notifying listeners when the last request completes.
-
-### Constructor
+### Example Usage
 
 ```typescript
 const tracker = new RequestTracker();
-```
+let activeRequests = 0;
 
-### Methods
-
-#### `tryAccept(): boolean`
+tracker.on("draining", (reason) => console.log("Draining:", reason));
+tracker.on("drained", () => console.log("All requests complete"));
 
-Try to accept a new request. Returns `false` if draining — caller should send a rejection response.
-
-```typescript
+// Accept a request
 if (tracker.tryAccept()) {
-  // Process request
-  tracker.complete();
-} else {
-  // Send rejection (service is shutting down)
+  processRequest().finally(() => tracker.complete());
 }
-```
-
-#### `complete(): void`
-
-Mark a request as complete. Decrements the active count and emits `drained` when the last request finishes during a drain.
-
-```typescript
-tracker.complete();
-```
-
-#### `startDraining(reason: string): void`
-
-Enter draining mode — no new requests will be accepted. Idempotent: subsequent calls are ignored. Emits `draining` immediately and `drained` when active reaches zero.
-
-```typescript
-tracker.startDraining("server shutting down");
-```
-
-#### `on<K extends keyof RequestTrackerEvents>(event: K, listener: RequestTrackerEvents[K]): () => void`
-
-Subscribe to a RequestTracker event. Returns an unsubscribe function.
-
-```typescript
-const unsubscribe = tracker.on("drained", () => {
-  console.log("All requests completed");
-});
-```
-
-### Events
-
-#### `draining`
-
-Fired when draining mode is entered.
-
-```typescript
-tracker.on("draining", (reason: string) => {
-  console.log(`Draining: ${reason}`);
-});
-```
-
-#### `drained`
 
-Fired when all active requests complete during drain.
-
-```typescript
-tracker.on("drained", () => {
-  console.log("Ready to shut down");
-});
-```
-
-### Properties
-
-#### `draining: boolean`
-
-Whether the tracker is in draining mode.
-
-```typescript
-if (tracker.draining) {
-  console.log("Not accepting new requests");
-}
-```
-
-#### `active: number`
-
-Number of currently active requests.
-
-```typescript
-console.log(`${tracker.active} requests in flight`);
-```
-
-### Example: Graceful Shutdown
-
-```typescript
-import { ReconnectingWebSocket, RequestTracker } from "@hardlydifficult/websocket";
-
-const client = new ReconnectingWebSocket({ url: "ws://localhost:8080" });
-const tracker = new RequestTracker();
-
-client.on("message", (msg) => {
-  if (!tracker.tryAccept()) {
-    // Reject new requests during shutdown
-    return;
-  }
-
-  // Process message
-  processMessage(msg);
-  tracker.complete();
-});
-
-// Initiate graceful shutdown
-async function shutdown() {
-  client.stopReconnecting();
-  tracker.startDraining("server shutting down");
-
-  // Wait for all in-flight requests to complete
-  await new Promise<void>((resolve) => {
-    tracker.on("drained", () => {
-      resolve();
-    });
-  });
-
-  client.disconnect();
-}
+// On shutdown signal
+tracker.startDraining("Server shutdown");
 ```

package/dist/ReconnectingWebSocket.d.ts

@@ -11,6 +11,10 @@ export declare function getBackoffDelay(attempt: number, options: Required<Backo
  * A generic WebSocket client that automatically reconnects on disconnection,
  * sends protocol-level pings for heartbeats, and parses JSON messages.
  *
+ * Supports optional bearer-token auth via the `auth` option. The token is
+ * fetched on every connect (including reconnects), so reconnects automatically
+ * pick up fresh tokens.
+ *
  * @typeParam T - The shape of messages exchanged over the socket (JSON-serializable)
  */
 export declare class ReconnectingWebSocket<T> {
@@ -18,6 +22,9 @@ export declare class ReconnectingWebSocket<T> {
     private readonly url;
     private readonly backoff;
     private readonly heartbeat;
+    private readonly auth;
+    private readonly protocols;
+    private readonly extraHeaders;
     private reconnectAttempt;
     private shouldReconnect;
     private heartbeatInterval;
@@ -36,13 +43,22 @@ export declare class ReconnectingWebSocket<T> {
      * Idempotent — no-op if already connected.
      * If a reconnect timer is pending, cancels it and connects immediately,
      * resetting the attempt counter.
+     *
+     * When `auth` is configured, fetches a bearer token before connecting.
      */
     connect(): void;
+    private connectInternal;
     /**
      * Disconnect from the server and stop all reconnection attempts.
      * Closes the socket with code 1000.
      */
     disconnect(): void;
+    /**
+     * Force close and reconnect. Useful for token refresh: close the current
+     * connection and reconnect with a fresh token (fetched via `auth.getToken`).
+     * Resets the backoff counter.
+     */
+    reconnect(): void;
     /**
      * Send a message as JSON. No-op if not currently connected.
      */

package/dist/ReconnectingWebSocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReconnectingWebSocket.d.ts","sourceRoot":"","sources":["../src/ReconnectingWebSocket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAapB;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAChC,MAAM,CAGR;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;gBAEQ,OAAO,EAAE,gBAAgB;IAMrC;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9B,MAAM,IAAI;IAYb;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAmCf;;;OAGG;IACH,UAAU,IAAI,IAAI;IAelB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;IAMtB;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAIxB,2CAA2C;IAC3C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,IAAI;CAab"}
+{"version":3,"file":"ReconnectingWebSocket.d.ts","sourceRoot":"","sources":["../src/ReconnectingWebSocket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,cAAc,EAEd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAapB;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAChC,MAAM,CAGR;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAClE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;gBAEQ,OAAO,EAAE,gBAAgB;IASrC;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9B,MAAM,IAAI;IAYb;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;YAID,eAAe;IAwD7B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAelB;;;;OAIG;IACH,SAAS,IAAI,IAAI;IAoBjB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;IAMtB;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAIxB,2CAA2C;IAC3C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,IAAI;CAab"}

package/dist/ReconnectingWebSocket.js

@@ -30,6 +30,10 @@ function getBackoffDelay(attempt, options) {
  * A generic WebSocket client that automatically reconnects on disconnection,
  * sends protocol-level pings for heartbeats, and parses JSON messages.
  *
+ * Supports optional bearer-token auth via the `auth` option. The token is
+ * fetched on every connect (including reconnects), so reconnects automatically
+ * pick up fresh tokens.
+ *
  * @typeParam T - The shape of messages exchanged over the socket (JSON-serializable)
  */
 class ReconnectingWebSocket {
@@ -37,6 +41,9 @@ class ReconnectingWebSocket {
     url;
     backoff;
     heartbeat;
+    auth;
+    protocols;
+    extraHeaders;
     reconnectAttempt = 0;
     shouldReconnect = true;
     heartbeatInterval = null;
@@ -47,6 +54,9 @@ class ReconnectingWebSocket {
         this.url = options.url;
         this.backoff = { ...BACKOFF_DEFAULTS, ...options.backoff };
         this.heartbeat = { ...HEARTBEAT_DEFAULTS, ...options.heartbeat };
+        this.auth = options.auth;
+        this.protocols = options.protocols;
+        this.extraHeaders = options.headers;
     }
     /**
      * Subscribe to a WebSocket lifecycle event.
@@ -69,8 +79,13 @@ class ReconnectingWebSocket {
      * Idempotent — no-op if already connected.
      * If a reconnect timer is pending, cancels it and connects immediately,
      * resetting the attempt counter.
+     *
+     * When `auth` is configured, fetches a bearer token before connecting.
      */
     connect() {
+        void this.connectInternal();
+    }
+    async connectInternal() {
         if (this.ws) {
             return;
         }
@@ -80,7 +95,22 @@ class ReconnectingWebSocket {
             this.reconnectAttempt = 0;
         }
         this.shouldReconnect = true;
-        this.ws = new ws_1.default(this.url);
+        const headers = { ...this.extraHeaders };
+        if (this.auth) {
+            try {
+                const token = await this.auth.getToken();
+                if (token !== "") {
+                    headers.Authorization = `Bearer ${token}`;
+                }
+            }
+            catch (err) {
+                this.emit("error", err instanceof Error ? err : new Error(String(err)));
+                this.scheduleReconnect();
+                return;
+            }
+        }
+        const hasHeaders = Object.keys(headers).length > 0;
+        this.ws = new ws_1.default(this.url, this.protocols, hasHeaders ? { headers } : undefined);
         this.ws.on("open", () => {
             this.onOpen();
         });
@@ -113,6 +143,26 @@ class ReconnectingWebSocket {
             this.ws = null;
         }
     }
+    /**
+     * Force close and reconnect. Useful for token refresh: close the current
+     * connection and reconnect with a fresh token (fetched via `auth.getToken`).
+     * Resets the backoff counter.
+     */
+    reconnect() {
+        this.stopHeartbeat();
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        this.reconnectAttempt = 0;
+        if (this.ws) {
+            this.ws.removeAllListeners();
+            this.ws.close(4000, "Token refresh");
+            this.ws = null;
+        }
+        this.shouldReconnect = true;
+        void this.connectInternal();
+    }
     /**
      * Send a message as JSON. No-op if not currently connected.
      */
@@ -203,7 +253,7 @@ class ReconnectingWebSocket {
             this.reconnectAttempt++;
             this.reconnectTimeout = null;
             this.ws = null;
-            this.connect();
+            void this.connectInternal();
         }, delay);
     }
     emit(event, ...args) {

package/dist/ReconnectingWebSocket.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { ReconnectingWebSocket } from "./ReconnectingWebSocket.js";
 export { RequestTracker } from "./RequestTracker.js";
-export type { BackoffOptions, HeartbeatOptions, WebSocketOptions, } from "./types.js";
+export { calculateTokenRefreshTime } from "./tokenRefresh.js";
+export type { AuthOptions, BackoffOptions, HeartbeatOptions, WebSocketOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequestTracker = exports.ReconnectingWebSocket = void 0;
+exports.calculateTokenRefreshTime = exports.RequestTracker = exports.ReconnectingWebSocket = void 0;
 var ReconnectingWebSocket_js_1 = require("./ReconnectingWebSocket.js");
 Object.defineProperty(exports, "ReconnectingWebSocket", { enumerable: true, get: function () { return ReconnectingWebSocket_js_1.ReconnectingWebSocket; } });
 var RequestTracker_js_1 = require("./RequestTracker.js");
 Object.defineProperty(exports, "RequestTracker", { enumerable: true, get: function () { return RequestTracker_js_1.RequestTracker; } });
+var tokenRefresh_js_1 = require("./tokenRefresh.js");
+Object.defineProperty(exports, "calculateTokenRefreshTime", { enumerable: true, get: function () { return tokenRefresh_js_1.calculateTokenRefreshTime; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,qDAA8D;AAArD,4HAAA,yBAAyB,OAAA"}

package/dist/tokenRefresh.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Calculate when to schedule proactive token refresh. Uses the later of:
+ *
+ * - 50% of token lifetime (protects short-lived tokens)
+ * - 2 minutes before expiry (ensures adequate buffer for longer tokens)
+ *
+ * Examples:
+ *
+ * - 60-second token: refresh at 30s (50% rule wins)
+ * - 5-minute token: refresh at 3min (2-min buffer wins)
+ * - 1-hour token: refresh at 58min (2-min buffer wins)
+ *
+ * @param issuedAt - Timestamp when token was issued (ms since epoch)
+ * @param expiresAt - Timestamp when token expires (ms since epoch)
+ * @returns Timestamp when refresh should be scheduled (ms since epoch)
+ */
+export declare function calculateTokenRefreshTime(issuedAt: number, expiresAt: number): number;
+//# sourceMappingURL=tokenRefresh.d.ts.map

package/dist/tokenRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenRefresh.d.ts","sourceRoot":"","sources":["../src/tokenRefresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAQR"}

package/dist/tokenRefresh.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTokenRefreshTime = calculateTokenRefreshTime;
+/**
+ * Calculate when to schedule proactive token refresh. Uses the later of:
+ *
+ * - 50% of token lifetime (protects short-lived tokens)
+ * - 2 minutes before expiry (ensures adequate buffer for longer tokens)
+ *
+ * Examples:
+ *
+ * - 60-second token: refresh at 30s (50% rule wins)
+ * - 5-minute token: refresh at 3min (2-min buffer wins)
+ * - 1-hour token: refresh at 58min (2-min buffer wins)
+ *
+ * @param issuedAt - Timestamp when token was issued (ms since epoch)
+ * @param expiresAt - Timestamp when token expires (ms since epoch)
+ * @returns Timestamp when refresh should be scheduled (ms since epoch)
+ */
+function calculateTokenRefreshTime(issuedAt, expiresAt) {
+    const lifetimeMs = expiresAt - issuedAt;
+    const twoMinutesMs = 2 * 60 * 1000;
+    const halfLifetime = issuedAt + Math.floor(lifetimeMs / 2);
+    const twoMinutesBefore = expiresAt - twoMinutesMs;
+    return Math.max(halfLifetime, twoMinutesBefore);
+}
+//# sourceMappingURL=tokenRefresh.js.map

package/dist/tokenRefresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenRefresh.js","sourceRoot":"","sources":["../src/tokenRefresh.ts"],"names":[],"mappings":";;AAgBA,8DAWC;AA3BD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,yBAAyB,CACvC,QAAgB,EAChB,SAAiB;IAEjB,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAEnC,MAAM,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,CAAC;IAElD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAClD,CAAC"}

package/dist/types.d.ts

@@ -18,6 +18,14 @@ export interface HeartbeatOptions {
     /** Time to wait for pong before terminating. Default: 10000 */
     timeoutMs?: number;
 }
+/**
+ * Auth configuration. Token is fetched on each connection (initial and reconnects),
+ * so reconnects automatically pick up a fresh token.
+ */
+export interface AuthOptions {
+    /** Returns a bearer token. Called on every connect and reconnect. */
+    getToken: () => Promise<string> | string;
+}
 /**
  * Configuration options for ReconnectingWebSocket.
  */
@@ -28,6 +36,12 @@ export interface WebSocketOptions {
     backoff?: BackoffOptions;
     /** Heartbeat configuration */
     heartbeat?: HeartbeatOptions;
+    /** Auth configuration. Token is added as an Authorization header on each connect. */
+    auth?: AuthOptions;
+    /** WebSocket subprotocols. */
+    protocols?: string[];
+    /** Additional headers for the WebSocket handshake. */
+    headers?: Record<string, string>;
 }
 /**
  * Event callbacks for ReconnectingWebSocket.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,0CAA0C;IAC1C,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,kDAAkD;IAClD,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,0CAA0C;IAC1C,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,kDAAkD;IAClD,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/websocket",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [