@studyportals/ws-client 0.1.1-beta.1 → 0.1.1-beta.5

package/dist/index.d.ts

@@ -1,8 +1,168 @@
-export { eventBus } from './event-bus';
-export type { EventBus } from './event-bus';
-export { WebSocketManager } from './websocket-manager';
-export type { WsEventMap, WsIdentifiedPayload, CampaignSavingPayload, WebSocketManagerConfig, IncomingMessage, ServerEventKey, ServerMessage, ServerMessageParsed, } from './types';
-export { wsIdentifiedPayloadSchema, campaignSavingPayloadSchema, incomingMessageSchema, serverMessageSchema, } from './types';
-export type { IWebSocketTransport } from './transport.interface';
-export { RealWebSocketTransport } from './transports/real.transport';
-export { MockWebSocketTransport } from './transports/mock.transport';
+import { Emitter } from 'mitt';
+import { z } from 'zod';
+
+declare const wsIdentifiedPayloadSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+}, z.core.$strip>;
+type WsIdentifiedPayload = z.infer<typeof wsIdentifiedPayloadSchema>;
+
+declare const campaignSavingPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"start">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"success">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>], "status">;
+type CampaignSavingPayload = z.infer<typeof campaignSavingPayloadSchema>;
+
+interface WsEventMap {
+    'ws:connected': undefined;
+    'ws:disconnected': CloseEvent;
+    'ws:error': Event;
+    'ws:max-retries-exceeded': undefined;
+    'ws:unparseable': string;
+    /** Emitted when the server sends a message with type "ws:identified". */
+    'ws:identified': WsIdentifiedPayload;
+    'campaign:saving': CampaignSavingPayload;
+}
+
+/**
+ * Abstraction over a WebSocket connection.
+ *
+ * The manager wires up the callbacks and calls connect() / send() / close().
+ * Implementations handle the actual I/O (or simulation in tests).
+ */
+interface IWebSocketTransport {
+    onopen: (() => void) | null;
+    onmessage: ((data: string) => void) | null;
+    onclose: ((event: CloseEvent) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    /** Open the connection to the given URL. */
+    connect(url: string): void;
+    /** Send a raw string frame. */
+    send(data: string): void;
+    /** Close the connection with an optional status code and reason. */
+    close(code?: number, reason?: string): void;
+}
+
+type WebSocketManagerConfig = {
+    /** WebSocket endpoint URL (e.g. "wss://api.example.com/ws"). */
+    url: string;
+    /** Transport implementation. Use RealWebSocketTransport in production,
+     *  MockWebSocketTransport in tests. */
+    transport: IWebSocketTransport;
+    /** Maximum number of reconnect attempts before giving up. Default: 10. */
+    maxReconnectAttempts?: number;
+    /** Base delay (ms) for exponential backoff. Default: 500. */
+    baseReconnectDelayMs?: number;
+    /** Upper cap (ms) for reconnect delay. Default: 30 000. */
+    maxReconnectDelayMs?: number;
+    /** Interval (ms) between heartbeat messages while connected. Default: 30 000. */
+    heartbeatIntervalMs?: number;
+    /** Payload sent as the heartbeat message. Default: `{ "type": "ping" }`. */
+    heartbeatMessage?: Record<string, unknown>;
+};
+
+type ClientOnlyEvent = 'ws:connected' | 'ws:disconnected' | 'ws:error' | 'ws:max-retries-exceeded' | 'ws:unparseable';
+type ServerEventKey = Exclude<keyof WsEventMap, ClientOnlyEvent>;
+type ServerMessage = {
+    [K in ServerEventKey]: {
+        type: K;
+        payload: WsEventMap[K];
+    };
+}[ServerEventKey];
+declare const serverMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ws:identified">;
+    payload: z.ZodObject<{
+        connectionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"campaign:saving">;
+    payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"start">;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"failed">;
+        error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>], "type">;
+type ServerMessageParsed = z.infer<typeof serverMessageSchema>;
+
+type MittMap = WsEventMap & Record<string | symbol, unknown>;
+type EventBus = Emitter<MittMap>;
+declare const eventBus: EventBus;
+
+declare class WebSocketManager {
+    private static instance;
+    private readonly bus;
+    private readonly config;
+    private reconnectAttempts;
+    private intentionalClose;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private connectionId;
+    private constructor();
+    /**
+     * Returns the singleton instance, creating it on first call.
+     * Subsequent calls ignore `bus` and `config` — pass them only on first call.
+     */
+    static getInstance(bus: EventBus, config: WebSocketManagerConfig): WebSocketManager;
+    /**
+     * Destroy the singleton.
+     * Call before re-initialising in tests or when switching environments.
+     */
+    static reset(): void;
+    /** Returns the connectionId received from the last "ws:identified" message. */
+    getConnectionId(): string | undefined;
+    /** Gracefully close the connection without triggering automatic reconnect. */
+    disconnect(): void;
+    private connect;
+    private handleMessage;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private startHeartbeat;
+    private clearHeartbeat;
+}
+
+declare class RealWebSocketTransport implements IWebSocketTransport {
+    private socket;
+    onopen: (() => void) | null;
+    onmessage: ((data: string) => void) | null;
+    onclose: ((event: CloseEvent) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    connect(url: string): void;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+}
+
+/**
+ * In-memory WebSocket transport for use in unit tests and Cypress specs.
+ *
+ * Wire it up via WebSocketManagerConfig.transport, then drive the connection
+ * state with simulateMessage() and simulateClose().
+ */
+declare class MockWebSocketTransport implements IWebSocketTransport {
+    onopen: (() => void) | null;
+    onmessage: ((data: string) => void) | null;
+    onclose: ((event: CloseEvent) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    private connected;
+    connect(_url: string): void;
+    /** No-op by design. Spy on this method to assert outgoing frames in tests. */
+    send(_data: string): void;
+    close(code?: number, _reason?: string): void;
+    /**
+     * Deliver a raw message string directly to the manager's onmessage handler.
+     * Call this from tests/Cypress to simulate server-pushed frames.
+     */
+    simulateMessage(data: string): void;
+    /**
+     * Fire a CloseEvent on the manager's onclose handler.
+     * Call this from tests/Cypress to simulate a server-initiated disconnect.
+     */
+    simulateClose(code?: number): void;
+}
+
+export { type CampaignSavingPayload, type EventBus, type IWebSocketTransport, MockWebSocketTransport, RealWebSocketTransport, type ServerEventKey, type ServerMessage, type ServerMessageParsed, WebSocketManager, type WebSocketManagerConfig, type WsEventMap, type WsIdentifiedPayload, campaignSavingPayloadSchema, eventBus, serverMessageSchema, wsIdentifiedPayloadSchema };

package/dist/index.js

@@ -1,9 +1,257 @@
-// Event bus
-export { eventBus } from './event-bus';
-// Manager
-export { WebSocketManager } from './websocket-manager';
-// Zod validators (useful for consumers and tests)
-export { wsIdentifiedPayloadSchema, campaignSavingPayloadSchema, incomingMessageSchema, serverMessageSchema, } from './types';
-// Transport implementations
-export { RealWebSocketTransport } from './transports/real.transport';
-export { MockWebSocketTransport } from './transports/mock.transport';
+// src/event-bus.ts
+import mitt from "mitt";
+var eventBus = mitt();
+
+// src/types/ws-identified.ts
+import { z } from "zod";
+var wsIdentifiedPayloadSchema = z.object({
+  connectionId: z.string()
+});
+
+// src/types/campaign-saving.ts
+import { z as z2 } from "zod";
+var campaignSavingStartSchema = z2.object({
+  status: z2.literal("start")
+});
+var campaignSavingSuccessSchema = z2.object({
+  status: z2.literal("success")
+});
+var campaignSavingFailedSchema = z2.object({
+  status: z2.literal("failed"),
+  error: z2.record(z2.string(), z2.unknown())
+});
+var campaignSavingPayloadSchema = z2.discriminatedUnion("status", [
+  campaignSavingStartSchema,
+  campaignSavingSuccessSchema,
+  campaignSavingFailedSchema
+]);
+
+// src/types/server-message.ts
+import { z as z3 } from "zod";
+var serverMessageSchema = z3.discriminatedUnion("type", [
+  z3.object({ type: z3.literal("ws:identified"), payload: wsIdentifiedPayloadSchema }),
+  z3.object({ type: z3.literal("campaign:saving"), payload: campaignSavingPayloadSchema })
+]);
+
+// src/websocket-manager.ts
+var DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+var DEFAULT_BASE_RECONNECT_DELAY_MS = 500;
+var DEFAULT_MAX_RECONNECT_DELAY_MS = 3e4;
+var DEFAULT_HEARTBEAT_INTERVAL_MS = 3e4;
+var DEFAULT_HEARTBEAT_MESSAGE = { type: "ping" };
+var WebSocketManager = class _WebSocketManager {
+  static instance;
+  bus;
+  config;
+  reconnectAttempts = 0;
+  intentionalClose = false;
+  heartbeatTimer;
+  reconnectTimer;
+  connectionId;
+  constructor(bus, config) {
+    this.bus = bus;
+    this.config = {
+      url: config.url,
+      transport: config.transport,
+      maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,
+      baseReconnectDelayMs: config.baseReconnectDelayMs ?? DEFAULT_BASE_RECONNECT_DELAY_MS,
+      maxReconnectDelayMs: config.maxReconnectDelayMs ?? DEFAULT_MAX_RECONNECT_DELAY_MS,
+      heartbeatIntervalMs: config.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS,
+      heartbeatMessage: config.heartbeatMessage ?? DEFAULT_HEARTBEAT_MESSAGE
+    };
+    this.connect();
+  }
+  /**
+   * Returns the singleton instance, creating it on first call.
+   * Subsequent calls ignore `bus` and `config` — pass them only on first call.
+   */
+  static getInstance(bus, config) {
+    if (!_WebSocketManager.instance) {
+      _WebSocketManager.instance = new _WebSocketManager(bus, config);
+    }
+    return _WebSocketManager.instance;
+  }
+  /**
+   * Destroy the singleton.
+   * Call before re-initialising in tests or when switching environments.
+   */
+  static reset() {
+    _WebSocketManager.instance = void 0;
+  }
+  /** Returns the connectionId received from the last "ws:identified" message. */
+  getConnectionId() {
+    return this.connectionId;
+  }
+  /** Gracefully close the connection without triggering automatic reconnect. */
+  disconnect() {
+    this.intentionalClose = true;
+    this.clearHeartbeat();
+    this.clearReconnectTimer();
+    this.config.transport.close(1e3, "client disconnect");
+  }
+  connect() {
+    const { transport, url } = this.config;
+    transport.onopen = () => {
+      this.reconnectAttempts = 0;
+      this.intentionalClose = false;
+      this.startHeartbeat();
+      this.bus.emit("ws:connected", void 0);
+    };
+    transport.onmessage = (data) => {
+      this.handleMessage(data);
+    };
+    transport.onclose = (event) => {
+      this.clearHeartbeat();
+      this.connectionId = void 0;
+      this.bus.emit("ws:disconnected", event);
+      if (!this.intentionalClose) {
+        this.scheduleReconnect();
+      }
+    };
+    transport.onerror = (event) => {
+      this.bus.emit("ws:error", event);
+    };
+    transport.connect(url);
+  }
+  handleMessage(raw) {
+    let parsedJson;
+    try {
+      parsedJson = JSON.parse(raw);
+    } catch {
+      this.bus.emit("ws:unparseable", raw);
+      return;
+    }
+    const result = serverMessageSchema.safeParse(parsedJson);
+    if (!result.success) {
+      this.bus.emit("ws:unparseable", raw);
+      return;
+    }
+    const msg = result.data;
+    switch (msg.type) {
+      case "ws:identified":
+        this.connectionId = msg.payload.connectionId;
+        this.bus.emit("ws:identified", msg.payload);
+        break;
+      case "campaign:saving":
+        this.bus.emit("campaign:saving", msg.payload);
+        break;
+      default: {
+        const _exhaustive = msg;
+      }
+    }
+  }
+  scheduleReconnect() {
+    if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
+      this.bus.emit("ws:max-retries-exceeded", void 0);
+      return;
+    }
+    const { baseReconnectDelayMs, maxReconnectDelayMs } = this.config;
+    const exponential = baseReconnectDelayMs * Math.pow(2, this.reconnectAttempts);
+    const capped = Math.min(exponential, maxReconnectDelayMs);
+    const delay = capped + Math.random() * baseReconnectDelayMs;
+    this.reconnectAttempts++;
+    this.reconnectTimer = setTimeout(() => {
+      this.connect();
+    }, delay);
+  }
+  clearReconnectTimer() {
+    if (this.reconnectTimer !== void 0) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+  }
+  startHeartbeat() {
+    this.clearHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));
+    }, this.config.heartbeatIntervalMs);
+  }
+  clearHeartbeat() {
+    if (this.heartbeatTimer !== void 0) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = void 0;
+    }
+  }
+};
+
+// src/transports/real.transport.ts
+var RealWebSocketTransport = class {
+  socket = null;
+  onopen = null;
+  onmessage = null;
+  onclose = null;
+  onerror = null;
+  connect(url) {
+    this.socket = new WebSocket(url);
+    this.socket.addEventListener("open", () => {
+      this.onopen?.();
+    });
+    this.socket.addEventListener("message", (event) => {
+      if (typeof event.data === "string") {
+        this.onmessage?.(event.data);
+      }
+    });
+    this.socket.addEventListener("close", (event) => {
+      this.onclose?.(event);
+    });
+    this.socket.addEventListener("error", (event) => {
+      this.onerror?.(event);
+    });
+  }
+  send(data) {
+    if (this.socket?.readyState === WebSocket.OPEN) {
+      this.socket.send(data);
+    }
+  }
+  close(code, reason) {
+    this.socket?.close(code, reason);
+  }
+};
+
+// src/transports/mock.transport.ts
+var MockWebSocketTransport = class {
+  onopen = null;
+  onmessage = null;
+  onclose = null;
+  onerror = null;
+  connected = false;
+  connect(_url) {
+    this.connected = true;
+    setTimeout(() => {
+      this.onopen?.();
+    }, 0);
+  }
+  /** No-op by design. Spy on this method to assert outgoing frames in tests. */
+  send(_data) {
+  }
+  close(code = 1e3, _reason) {
+    if (!this.connected) return;
+    this.simulateClose(code);
+  }
+  /**
+   * Deliver a raw message string directly to the manager's onmessage handler.
+   * Call this from tests/Cypress to simulate server-pushed frames.
+   */
+  simulateMessage(data) {
+    this.onmessage?.(data);
+  }
+  /**
+   * Fire a CloseEvent on the manager's onclose handler.
+   * Call this from tests/Cypress to simulate a server-initiated disconnect.
+   */
+  simulateClose(code = 1e3) {
+    this.connected = false;
+    const event = new CloseEvent("close", { code, wasClean: code === 1e3 });
+    this.onclose?.(event);
+  }
+};
+export {
+  MockWebSocketTransport,
+  RealWebSocketTransport,
+  WebSocketManager,
+  campaignSavingPayloadSchema,
+  eventBus,
+  serverMessageSchema,
+  wsIdentifiedPayloadSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-bus.ts","../src/types/ws-identified.ts","../src/types/campaign-saving.ts","../src/types/server-message.ts","../src/websocket-manager.ts","../src/transports/real.transport.ts","../src/transports/mock.transport.ts"],"sourcesContent":["import mitt from 'mitt';\nimport type { Emitter } from 'mitt';\nimport type { WsEventMap } from './types';\n\n// Intersect with Record<string | symbol, unknown> to satisfy mitt's generic\n// constraint while keeping WsEventMap clean of index signatures.\ntype MittMap = WsEventMap & Record<string | symbol, unknown>;\n\nexport type EventBus = Emitter<MittMap>;\n\nexport const eventBus: EventBus = mitt<MittMap>();\n","import { z } from 'zod';\n\nexport const wsIdentifiedPayloadSchema = z.object({\n  connectionId: z.string(),\n});\n\nexport type WsIdentifiedPayload = z.infer<typeof wsIdentifiedPayloadSchema>;\n","import { z } from 'zod';\n\nconst campaignSavingStartSchema = z.object({\n  status: z.literal('start'),\n});\n\nconst campaignSavingSuccessSchema = z.object({\n  status: z.literal('success'),\n});\n\nconst campaignSavingFailedSchema = z.object({\n  status: z.literal('failed'),\n  error: z.record(z.string(), z.unknown()),\n});\n\nexport const campaignSavingPayloadSchema = z.discriminatedUnion('status', [\n  campaignSavingStartSchema,\n  campaignSavingSuccessSchema,\n  campaignSavingFailedSchema,\n]);\n\nexport type CampaignSavingPayload = z.infer<typeof campaignSavingPayloadSchema>;\n","import { z } from 'zod';\nimport type { WsEventMap } from './ws-event-map';\nimport { wsIdentifiedPayloadSchema } from './ws-identified';\nimport { campaignSavingPayloadSchema } from './campaign-saving';\n\n// ---------------------------------------------------------------------------\n// Client-only events — fired by the transport layer, never sent by the server\n// ---------------------------------------------------------------------------\n\ntype ClientOnlyEvent =\n  | 'ws:connected'\n  | 'ws:disconnected'\n  | 'ws:error'\n  | 'ws:max-retries-exceeded'\n  | 'ws:unparseable';\n\n// ---------------------------------------------------------------------------\n// ServerEventKey — every WsEventMap key the server is allowed to send\n// Automatically excludes client-only events; stays in sync with WsEventMap.\n// ---------------------------------------------------------------------------\n\nexport type ServerEventKey = Exclude<keyof WsEventMap, ClientOnlyEvent>;\n\n// ---------------------------------------------------------------------------\n// ServerMessage — strict discriminated union of all valid server wire frames.\n// Use this in backend code and anywhere a server frame must be type-narrowed.\n//\n// Shape: { type: ServerEventKey; payload: WsEventMap[K] }\n// ---------------------------------------------------------------------------\n\nexport type ServerMessage = {\n  [K in ServerEventKey]: { type: K; payload: WsEventMap[K] };\n}[ServerEventKey];\n\n// ---------------------------------------------------------------------------\n// serverMessageSchema — Zod discriminated union over every server event.\n// Validates that an incoming frame is both structurally and semantically valid.\n//\n// NOTE: if you extend WsEventMap via module augmentation you must also add\n// the corresponding member to this schema.\n// ---------------------------------------------------------------------------\n\nexport const serverMessageSchema = z.discriminatedUnion('type', [\n  z.object({ type: z.literal('ws:identified'), payload: wsIdentifiedPayloadSchema }),\n  z.object({ type: z.literal('campaign:saving'), payload: campaignSavingPayloadSchema }),\n]);\n\nexport type ServerMessageParsed = z.infer<typeof serverMessageSchema>;\n","import type { EventBus } from './event-bus';\nimport type { WebSocketManagerConfig } from './types';\nimport { serverMessageSchema } from './types';\n\nexport type { WebSocketManagerConfig } from './types';\n\nconst DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;\nconst DEFAULT_BASE_RECONNECT_DELAY_MS = 500;\nconst DEFAULT_MAX_RECONNECT_DELAY_MS = 30_000;\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;\nconst DEFAULT_HEARTBEAT_MESSAGE: Record<string, unknown> = { type: 'ping' };\n\ntype ResolvedConfig = Required<WebSocketManagerConfig>;\n\nexport class WebSocketManager {\n  private static instance: WebSocketManager | undefined;\n\n  private readonly bus: EventBus;\n  private readonly config: ResolvedConfig;\n\n  private reconnectAttempts = 0;\n  private intentionalClose = false;\n  private heartbeatTimer: ReturnType<typeof setInterval> | undefined;\n  private reconnectTimer: ReturnType<typeof setTimeout> | undefined;\n  private connectionId: string | undefined;\n\n  private constructor(bus: EventBus, config: WebSocketManagerConfig) {\n    this.bus = bus;\n    this.config = {\n      url: config.url,\n      transport: config.transport,\n      maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,\n      baseReconnectDelayMs: config.baseReconnectDelayMs ?? DEFAULT_BASE_RECONNECT_DELAY_MS,\n      maxReconnectDelayMs: config.maxReconnectDelayMs ?? DEFAULT_MAX_RECONNECT_DELAY_MS,\n      heartbeatIntervalMs: config.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS,\n      heartbeatMessage: config.heartbeatMessage ?? DEFAULT_HEARTBEAT_MESSAGE,\n    };\n\n    this.connect();\n  }\n\n  /**\n   * Returns the singleton instance, creating it on first call.\n   * Subsequent calls ignore `bus` and `config` — pass them only on first call.\n   */\n  public static getInstance(bus: EventBus, config: WebSocketManagerConfig): WebSocketManager {\n    if (!WebSocketManager.instance) {\n      WebSocketManager.instance = new WebSocketManager(bus, config);\n    }\n    return WebSocketManager.instance;\n  }\n\n  /**\n   * Destroy the singleton.\n   * Call before re-initialising in tests or when switching environments.\n   */\n  public static reset(): void {\n    WebSocketManager.instance = undefined;\n  }\n\n  /** Returns the connectionId received from the last \"ws:identified\" message. */\n  public getConnectionId(): string | undefined {\n    return this.connectionId;\n  }\n\n  /** Gracefully close the connection without triggering automatic reconnect. */\n  public disconnect(): void {\n    this.intentionalClose = true;\n    this.clearHeartbeat();\n    this.clearReconnectTimer();\n    this.config.transport.close(1000, 'client disconnect');\n  }\n\n  private connect(): void {\n    const { transport, url } = this.config;\n\n    transport.onopen = (): void => {\n      this.reconnectAttempts = 0;\n      this.intentionalClose = false;\n      this.startHeartbeat();\n      this.bus.emit('ws:connected', undefined);\n    };\n\n    transport.onmessage = (data: string): void => {\n      this.handleMessage(data);\n    };\n\n    transport.onclose = (event: CloseEvent): void => {\n      this.clearHeartbeat();\n      this.connectionId = undefined;\n      this.bus.emit('ws:disconnected', event);\n\n      if (!this.intentionalClose) {\n        this.scheduleReconnect();\n      }\n    };\n\n    transport.onerror = (event: Event): void => {\n      this.bus.emit('ws:error', event);\n    };\n\n    transport.connect(url);\n  }\n\n  private handleMessage(raw: string): void {\n    let parsedJson: unknown;\n\n    try {\n      parsedJson = JSON.parse(raw);\n    } catch {\n      this.bus.emit('ws:unparseable', raw);\n      return;\n    }\n\n    const result = serverMessageSchema.safeParse(parsedJson);\n    if (!result.success) {\n      this.bus.emit('ws:unparseable', raw);\n      return;\n    }\n\n    // result.data is ServerMessageParsed — a strict discriminated union.\n    // The switch is exhaustive: adding a new event to serverMessageSchema\n    // without handling it here is a compile error.\n    const msg = result.data;\n\n    switch (msg.type) {\n      case 'ws:identified':\n        this.connectionId = msg.payload.connectionId;\n        this.bus.emit('ws:identified', msg.payload);\n        break;\n      case 'campaign:saving':\n        this.bus.emit('campaign:saving', msg.payload);\n        break;\n      default: {\n        // Exhaustive guard — msg is `never` if all cases are handled.\n        // If this line errors, a new ServerMessage member needs a case above.\n        const _exhaustive: never = msg;\n      }\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {\n      this.bus.emit('ws:max-retries-exceeded', undefined);\n      return;\n    }\n\n    const { baseReconnectDelayMs, maxReconnectDelayMs } = this.config;\n    const exponential = baseReconnectDelayMs * Math.pow(2, this.reconnectAttempts);\n    const capped = Math.min(exponential, maxReconnectDelayMs);\n    // Add random jitter up to one base interval to avoid thundering herd\n    const delay = capped + Math.random() * baseReconnectDelayMs;\n\n    this.reconnectAttempts++;\n\n    this.reconnectTimer = setTimeout(() => {\n      this.connect();\n    }, delay);\n  }\n\n  private clearReconnectTimer(): void {\n    if (this.reconnectTimer !== undefined) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.clearHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));\n    }, this.config.heartbeatIntervalMs);\n  }\n\n  private clearHeartbeat(): void {\n    if (this.heartbeatTimer !== undefined) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n}\n","import type { IWebSocketTransport } from '../transport.interface';\n\nexport class RealWebSocketTransport implements IWebSocketTransport {\n  private socket: WebSocket | null = null;\n\n  public onopen: (() => void) | null = null;\n  public onmessage: ((data: string) => void) | null = null;\n  public onclose: ((event: CloseEvent) => void) | null = null;\n  public onerror: ((event: Event) => void) | null = null;\n\n  public connect(url: string): void {\n    this.socket = new WebSocket(url);\n\n    this.socket.addEventListener('open', () => {\n      this.onopen?.();\n    });\n\n    this.socket.addEventListener('message', (event: MessageEvent) => {\n      if (typeof event.data === 'string') {\n        this.onmessage?.(event.data);\n      }\n    });\n\n    this.socket.addEventListener('close', (event: CloseEvent) => {\n      this.onclose?.(event);\n    });\n\n    this.socket.addEventListener('error', (event: Event) => {\n      this.onerror?.(event);\n    });\n  }\n\n  public send(data: string): void {\n    if (this.socket?.readyState === WebSocket.OPEN) {\n      this.socket.send(data);\n    }\n  }\n\n  public close(code?: number, reason?: string): void {\n    this.socket?.close(code, reason);\n  }\n}\n","import type { IWebSocketTransport } from '../transport.interface';\n\n/**\n * In-memory WebSocket transport for use in unit tests and Cypress specs.\n *\n * Wire it up via WebSocketManagerConfig.transport, then drive the connection\n * state with simulateMessage() and simulateClose().\n */\nexport class MockWebSocketTransport implements IWebSocketTransport {\n  public onopen: (() => void) | null = null;\n  public onmessage: ((data: string) => void) | null = null;\n  public onclose: ((event: CloseEvent) => void) | null = null;\n  public onerror: ((event: Event) => void) | null = null;\n\n  private connected = false;\n\n  public connect(_url: string): void {\n    this.connected = true;\n    // Simulate async open so callers can register handlers before the event fires\n    setTimeout(() => {\n      this.onopen?.();\n    }, 0);\n  }\n\n  /** No-op by design. Spy on this method to assert outgoing frames in tests. */\n  public send(_data: string): void {\n    // intentionally empty\n  }\n\n  public close(code = 1000, _reason?: string): void {\n    if (!this.connected) return;\n    this.simulateClose(code);\n  }\n\n  /**\n   * Deliver a raw message string directly to the manager's onmessage handler.\n   * Call this from tests/Cypress to simulate server-pushed frames.\n   */\n  public simulateMessage(data: string): void {\n    this.onmessage?.(data);\n  }\n\n  /**\n   * Fire a CloseEvent on the manager's onclose handler.\n   * Call this from tests/Cypress to simulate a server-initiated disconnect.\n   */\n  public simulateClose(code = 1000): void {\n    this.connected = false;\n    const event = new CloseEvent('close', { code, wasClean: code === 1000 });\n    this.onclose?.(event);\n  }\n}\n"],"mappings":"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","names":["z","z","z"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studyportals/ws-client",
-  "version": "0.1.1-beta.1",
+  "version": "0.1.1-beta.5",
   "description": "WebSocket client with reconnect, heartbeat, and typed event bus",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "type-check": "tsc --noEmit",
     "release": "npm publish --access public",
     "release:major": "npm run build && npm version major && npm run release",
@@ -26,6 +26,7 @@
     "typescript": ">=5.0"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^6.0.2"
   }
 }

package/dist/event-bus.d.ts

@@ -1,6 +0,0 @@
-import mitt from 'mitt';
-import type { WsEventMap } from './types';
-type MittMap = WsEventMap & Record<string | symbol, unknown>;
-export type EventBus = ReturnType<typeof mitt<MittMap>>;
-export declare const eventBus: EventBus;
-export {};

package/dist/event-bus.js

@@ -1,2 +0,0 @@
-import mitt from 'mitt';
-export const eventBus = mitt();

package/dist/transport.interface.d.ts

@@ -1,18 +0,0 @@
-/**
- * Abstraction over a WebSocket connection.
- *
- * The manager wires up the callbacks and calls connect() / send() / close().
- * Implementations handle the actual I/O (or simulation in tests).
- */
-export interface IWebSocketTransport {
-    onopen: (() => void) | null;
-    onmessage: ((data: string) => void) | null;
-    onclose: ((event: CloseEvent) => void) | null;
-    onerror: ((event: Event) => void) | null;
-    /** Open the connection to the given URL. */
-    connect(url: string): void;
-    /** Send a raw string frame. */
-    send(data: string): void;
-    /** Close the connection with an optional status code and reason. */
-    close(code?: number, reason?: string): void;
-}

package/dist/transport.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/transports/mock.transport.d.ts

@@ -1,28 +0,0 @@
-import type { IWebSocketTransport } from '../transport.interface';
-/**
- * In-memory WebSocket transport for use in unit tests and Cypress specs.
- *
- * Wire it up via WebSocketManagerConfig.transport, then drive the connection
- * state with simulateMessage() and simulateClose().
- */
-export declare class MockWebSocketTransport implements IWebSocketTransport {
-    onopen: (() => void) | null;
-    onmessage: ((data: string) => void) | null;
-    onclose: ((event: CloseEvent) => void) | null;
-    onerror: ((event: Event) => void) | null;
-    private connected;
-    connect(_url: string): void;
-    /** No-op by design. Spy on this method to assert outgoing frames in tests. */
-    send(_data: string): void;
-    close(code?: number, _reason?: string): void;
-    /**
-     * Deliver a raw message string directly to the manager's onmessage handler.
-     * Call this from tests/Cypress to simulate server-pushed frames.
-     */
-    simulateMessage(data: string): void;
-    /**
-     * Fire a CloseEvent on the manager's onclose handler.
-     * Call this from tests/Cypress to simulate a server-initiated disconnect.
-     */
-    simulateClose(code?: number): void;
-}

package/dist/transports/mock.transport.js

@@ -1,47 +0,0 @@
-/**
- * In-memory WebSocket transport for use in unit tests and Cypress specs.
- *
- * Wire it up via WebSocketManagerConfig.transport, then drive the connection
- * state with simulateMessage() and simulateClose().
- */
-export class MockWebSocketTransport {
-    constructor() {
-        this.onopen = null;
-        this.onmessage = null;
-        this.onclose = null;
-        this.onerror = null;
-        this.connected = false;
-    }
-    connect(_url) {
-        this.connected = true;
-        // Simulate async open so callers can register handlers before the event fires
-        setTimeout(() => {
-            this.onopen?.();
-        }, 0);
-    }
-    /** No-op by design. Spy on this method to assert outgoing frames in tests. */
-    send(_data) {
-        // intentionally empty
-    }
-    close(code = 1000, _reason) {
-        if (!this.connected)
-            return;
-        this.simulateClose(code);
-    }
-    /**
-     * Deliver a raw message string directly to the manager's onmessage handler.
-     * Call this from tests/Cypress to simulate server-pushed frames.
-     */
-    simulateMessage(data) {
-        this.onmessage?.(data);
-    }
-    /**
-     * Fire a CloseEvent on the manager's onclose handler.
-     * Call this from tests/Cypress to simulate a server-initiated disconnect.
-     */
-    simulateClose(code = 1000) {
-        this.connected = false;
-        const event = new CloseEvent('close', { code, wasClean: code === 1000 });
-        this.onclose?.(event);
-    }
-}

package/dist/transports/real.transport.d.ts

@@ -1,11 +0,0 @@
-import type { IWebSocketTransport } from '../transport.interface';
-export declare class RealWebSocketTransport implements IWebSocketTransport {
-    private socket;
-    onopen: (() => void) | null;
-    onmessage: ((data: string) => void) | null;
-    onclose: ((event: CloseEvent) => void) | null;
-    onerror: ((event: Event) => void) | null;
-    connect(url: string): void;
-    send(data: string): void;
-    close(code?: number, reason?: string): void;
-}

package/dist/transports/real.transport.js

@@ -1,34 +0,0 @@
-export class RealWebSocketTransport {
-    constructor() {
-        this.socket = null;
-        this.onopen = null;
-        this.onmessage = null;
-        this.onclose = null;
-        this.onerror = null;
-    }
-    connect(url) {
-        this.socket = new WebSocket(url);
-        this.socket.addEventListener('open', () => {
-            this.onopen?.();
-        });
-        this.socket.addEventListener('message', (event) => {
-            if (typeof event.data === 'string') {
-                this.onmessage?.(event.data);
-            }
-        });
-        this.socket.addEventListener('close', (event) => {
-            this.onclose?.(event);
-        });
-        this.socket.addEventListener('error', (event) => {
-            this.onerror?.(event);
-        });
-    }
-    send(data) {
-        if (this.socket?.readyState === WebSocket.OPEN) {
-            this.socket.send(data);
-        }
-    }
-    close(code, reason) {
-        this.socket?.close(code, reason);
-    }
-}

package/dist/types/campaign-saving.d.ts

@@ -1,10 +0,0 @@
-import { z } from 'zod';
-export declare const campaignSavingPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    status: z.ZodLiteral<"start">;
-}, z.core.$strip>, z.ZodObject<{
-    status: z.ZodLiteral<"success">;
-}, z.core.$strip>, z.ZodObject<{
-    status: z.ZodLiteral<"failed">;
-    error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>], "status">;
-export type CampaignSavingPayload = z.infer<typeof campaignSavingPayloadSchema>;

package/dist/types/campaign-saving.js

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-const campaignSavingStartSchema = z.object({
-    status: z.literal('start'),
-});
-const campaignSavingSuccessSchema = z.object({
-    status: z.literal('success'),
-});
-const campaignSavingFailedSchema = z.object({
-    status: z.literal('failed'),
-    error: z.record(z.string(), z.unknown()),
-});
-export const campaignSavingPayloadSchema = z.discriminatedUnion('status', [
-    campaignSavingStartSchema,
-    campaignSavingSuccessSchema,
-    campaignSavingFailedSchema,
-]);

package/dist/types/index.d.ts

@@ -1,10 +0,0 @@
-export type { WsEventMap } from './ws-event-map';
-export type { WsIdentifiedPayload } from './ws-identified';
-export { wsIdentifiedPayloadSchema } from './ws-identified';
-export type { CampaignSavingPayload } from './campaign-saving';
-export { campaignSavingPayloadSchema } from './campaign-saving';
-export type { WebSocketManagerConfig } from './ws-manager-config';
-export type { IncomingMessage } from './ws-message';
-export { incomingMessageSchema } from './ws-message';
-export type { ServerEventKey, ServerMessage, ServerMessageParsed } from './server-message';
-export { serverMessageSchema } from './server-message';

package/dist/types/index.js

@@ -1,4 +0,0 @@
-export { wsIdentifiedPayloadSchema } from './ws-identified';
-export { campaignSavingPayloadSchema } from './campaign-saving';
-export { incomingMessageSchema } from './ws-message';
-export { serverMessageSchema } from './server-message';

package/dist/types/server-message.d.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import type { WsEventMap } from './ws-event-map';
-type ClientOnlyEvent = 'ws:connected' | 'ws:disconnected' | 'ws:error' | 'ws:max-retries-exceeded' | 'ws:unparseable';
-export type ServerEventKey = Exclude<keyof WsEventMap, ClientOnlyEvent>;
-export type ServerMessage = {
-    [K in ServerEventKey]: {
-        type: K;
-        payload: WsEventMap[K];
-    };
-}[ServerEventKey];
-export declare const serverMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"ws:identified">;
-    payload: z.ZodObject<{
-        connectionId: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"campaign:saving">;
-    payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        status: z.ZodLiteral<"start">;
-    }, z.core.$strip>, z.ZodObject<{
-        status: z.ZodLiteral<"success">;
-    }, z.core.$strip>, z.ZodObject<{
-        status: z.ZodLiteral<"failed">;
-        error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strip>], "status">;
-}, z.core.$strip>], "type">;
-export type ServerMessageParsed = z.infer<typeof serverMessageSchema>;
-export {};

package/dist/types/server-message.js

@@ -1,14 +0,0 @@
-import { z } from 'zod';
-import { wsIdentifiedPayloadSchema } from './ws-identified';
-import { campaignSavingPayloadSchema } from './campaign-saving';
-// ---------------------------------------------------------------------------
-// serverMessageSchema — Zod discriminated union over every server event.
-// Validates that an incoming frame is both structurally and semantically valid.
-//
-// NOTE: if you extend WsEventMap via module augmentation you must also add
-// the corresponding member to this schema.
-// ---------------------------------------------------------------------------
-export const serverMessageSchema = z.discriminatedUnion('type', [
-    z.object({ type: z.literal('ws:identified'), payload: wsIdentifiedPayloadSchema }),
-    z.object({ type: z.literal('campaign:saving'), payload: campaignSavingPayloadSchema }),
-]);

package/dist/types/ws-event-map.d.ts

@@ -1,12 +0,0 @@
-import type { WsIdentifiedPayload } from './ws-identified';
-import type { CampaignSavingPayload } from './campaign-saving';
-export interface WsEventMap {
-    'ws:connected': undefined;
-    'ws:disconnected': CloseEvent;
-    'ws:error': Event;
-    'ws:max-retries-exceeded': undefined;
-    'ws:unparseable': string;
-    /** Emitted when the server sends a message with type "ws:identified". */
-    'ws:identified': WsIdentifiedPayload;
-    'campaign:saving': CampaignSavingPayload;
-}

package/dist/types/ws-event-map.js

@@ -1 +0,0 @@
-export {};

package/dist/types/ws-identified.d.ts

@@ -1,5 +0,0 @@
-import { z } from 'zod';
-export declare const wsIdentifiedPayloadSchema: z.ZodObject<{
-    connectionId: z.ZodString;
-}, z.core.$strip>;
-export type WsIdentifiedPayload = z.infer<typeof wsIdentifiedPayloadSchema>;

package/dist/types/ws-identified.js

@@ -1,4 +0,0 @@
-import { z } from 'zod';
-export const wsIdentifiedPayloadSchema = z.object({
-    connectionId: z.string(),
-});

package/dist/types/ws-manager-config.d.ts

@@ -1,18 +0,0 @@
-import type { IWebSocketTransport } from '../transport.interface';
-export type WebSocketManagerConfig = {
-    /** WebSocket endpoint URL (e.g. "wss://api.example.com/ws"). */
-    url: string;
-    /** Transport implementation. Use RealWebSocketTransport in production,
-     *  MockWebSocketTransport in tests. */
-    transport: IWebSocketTransport;
-    /** Maximum number of reconnect attempts before giving up. Default: 10. */
-    maxReconnectAttempts?: number;
-    /** Base delay (ms) for exponential backoff. Default: 500. */
-    baseReconnectDelayMs?: number;
-    /** Upper cap (ms) for reconnect delay. Default: 30 000. */
-    maxReconnectDelayMs?: number;
-    /** Interval (ms) between heartbeat messages while connected. Default: 30 000. */
-    heartbeatIntervalMs?: number;
-    /** Payload sent as the heartbeat message. Default: `{ "type": "ping" }`. */
-    heartbeatMessage?: Record<string, unknown>;
-};

package/dist/types/ws-manager-config.js

@@ -1 +0,0 @@
-export {};

package/dist/types/ws-message.d.ts

@@ -1,6 +0,0 @@
-import { z } from 'zod';
-export declare const incomingMessageSchema: z.ZodObject<{
-    type: z.ZodString;
-    payload: z.ZodUnknown;
-}, z.core.$strip>;
-export type IncomingMessage = z.infer<typeof incomingMessageSchema>;

package/dist/types/ws-message.js

@@ -1,5 +0,0 @@
-import { z } from 'zod';
-export const incomingMessageSchema = z.object({
-    type: z.string(),
-    payload: z.unknown(),
-});

package/dist/websocket-manager.d.ts

@@ -1,34 +0,0 @@
-import type { EventBus } from './event-bus';
-import type { WebSocketManagerConfig } from './types';
-export type { WebSocketManagerConfig } from './types';
-export declare class WebSocketManager {
-    private static instance;
-    private readonly bus;
-    private readonly config;
-    private reconnectAttempts;
-    private intentionalClose;
-    private heartbeatTimer;
-    private reconnectTimer;
-    private connectionId;
-    private constructor();
-    /**
-     * Returns the singleton instance, creating it on first call.
-     * Subsequent calls ignore `bus` and `config` — pass them only on first call.
-     */
-    static getInstance(bus: EventBus, config: WebSocketManagerConfig): WebSocketManager;
-    /**
-     * Destroy the singleton.
-     * Call before re-initialising in tests or when switching environments.
-     */
-    static reset(): void;
-    /** Returns the connectionId received from the last "ws:identified" message. */
-    getConnectionId(): string | undefined;
-    /** Gracefully close the connection without triggering automatic reconnect. */
-    disconnect(): void;
-    private connect;
-    private handleMessage;
-    private scheduleReconnect;
-    private clearReconnectTimer;
-    private startHeartbeat;
-    private clearHeartbeat;
-}

package/dist/websocket-manager.js

@@ -1,131 +0,0 @@
-import { incomingMessageSchema, wsIdentifiedPayloadSchema } from './types';
-const DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
-const DEFAULT_BASE_RECONNECT_DELAY_MS = 500;
-const DEFAULT_MAX_RECONNECT_DELAY_MS = 30000;
-const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000;
-const DEFAULT_HEARTBEAT_MESSAGE = { type: 'ping' };
-export class WebSocketManager {
-    constructor(bus, config) {
-        this.reconnectAttempts = 0;
-        this.intentionalClose = false;
-        this.bus = bus;
-        this.config = {
-            url: config.url,
-            transport: config.transport,
-            maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,
-            baseReconnectDelayMs: config.baseReconnectDelayMs ?? DEFAULT_BASE_RECONNECT_DELAY_MS,
-            maxReconnectDelayMs: config.maxReconnectDelayMs ?? DEFAULT_MAX_RECONNECT_DELAY_MS,
-            heartbeatIntervalMs: config.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS,
-            heartbeatMessage: config.heartbeatMessage ?? DEFAULT_HEARTBEAT_MESSAGE,
-        };
-        this.connect();
-    }
-    /**
-     * Returns the singleton instance, creating it on first call.
-     * Subsequent calls ignore `bus` and `config` — pass them only on first call.
-     */
-    static getInstance(bus, config) {
-        if (!WebSocketManager.instance) {
-            WebSocketManager.instance = new WebSocketManager(bus, config);
-        }
-        return WebSocketManager.instance;
-    }
-    /**
-     * Destroy the singleton.
-     * Call before re-initialising in tests or when switching environments.
-     */
-    static reset() {
-        WebSocketManager.instance = undefined;
-    }
-    /** Returns the connectionId received from the last "ws:identified" message. */
-    getConnectionId() {
-        return this.connectionId;
-    }
-    /** Gracefully close the connection without triggering automatic reconnect. */
-    disconnect() {
-        this.intentionalClose = true;
-        this.clearHeartbeat();
-        this.clearReconnectTimer();
-        this.config.transport.close(1000, 'client disconnect');
-    }
-    connect() {
-        const { transport, url } = this.config;
-        transport.onopen = () => {
-            this.reconnectAttempts = 0;
-            this.intentionalClose = false;
-            this.startHeartbeat();
-            this.bus.emit('ws:connected', undefined);
-        };
-        transport.onmessage = (data) => {
-            this.handleMessage(data);
-        };
-        transport.onclose = (event) => {
-            this.clearHeartbeat();
-            this.connectionId = undefined;
-            this.bus.emit('ws:disconnected', event);
-            if (!this.intentionalClose) {
-                this.scheduleReconnect();
-            }
-        };
-        transport.onerror = (event) => {
-            this.bus.emit('ws:error', event);
-        };
-        transport.connect(url);
-    }
-    handleMessage(raw) {
-        let parsedJson;
-        try {
-            parsedJson = JSON.parse(raw);
-        }
-        catch {
-            this.bus.emit('ws:unparseable', raw);
-            return;
-        }
-        const msgResult = incomingMessageSchema.safeParse(parsedJson);
-        if (!msgResult.success) {
-            this.bus.emit('ws:unparseable', raw);
-            return;
-        }
-        const msg = msgResult.data;
-        if (msg.type === 'ws:identified') {
-            const idResult = wsIdentifiedPayloadSchema.safeParse(msg.payload);
-            if (idResult.success) {
-                this.connectionId = idResult.data.connectionId;
-            }
-        }
-        this.bus.emit(msg.type, msg.payload);
-    }
-    scheduleReconnect() {
-        if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
-            this.bus.emit('ws:max-retries-exceeded', undefined);
-            return;
-        }
-        const { baseReconnectDelayMs, maxReconnectDelayMs } = this.config;
-        const exponential = baseReconnectDelayMs * Math.pow(2, this.reconnectAttempts);
-        const capped = Math.min(exponential, maxReconnectDelayMs);
-        // Add random jitter up to one base interval to avoid thundering herd
-        const delay = capped + Math.random() * baseReconnectDelayMs;
-        this.reconnectAttempts++;
-        this.reconnectTimer = setTimeout(() => {
-            this.connect();
-        }, delay);
-    }
-    clearReconnectTimer() {
-        if (this.reconnectTimer !== undefined) {
-            clearTimeout(this.reconnectTimer);
-            this.reconnectTimer = undefined;
-        }
-    }
-    startHeartbeat() {
-        this.clearHeartbeat();
-        this.heartbeatTimer = setInterval(() => {
-            this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));
-        }, this.config.heartbeatIntervalMs);
-    }
-    clearHeartbeat() {
-        if (this.heartbeatTimer !== undefined) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = undefined;
-        }
-    }
-}