@studyportals/ws-client 0.1.1-beta.7 → 0.1.1-beta.8

package/dist/index.d.mts

@@ -0,0 +1,175 @@
+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;
+    /**
+     * Resolves with the connectionId once the server sends "ws:identified".
+     * Resolves immediately if identification has already happened.
+     * Rejects if the socket disconnects before identification, or if
+     * `timeoutMs` elapses (default 10 000 ms).
+     */
+    waitForConnectionId(timeoutMs?: number): Promise<string>;
+    /** 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,36 +1,78 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MockWebSocketTransport: () => MockWebSocketTransport,
+  RealWebSocketTransport: () => RealWebSocketTransport,
+  WebSocketManager: () => WebSocketManager,
+  campaignSavingPayloadSchema: () => campaignSavingPayloadSchema,
+  eventBus: () => eventBus,
+  serverMessageSchema: () => serverMessageSchema,
+  wsIdentifiedPayloadSchema: () => wsIdentifiedPayloadSchema
+});
+module.exports = __toCommonJS(index_exports);
+
 // src/event-bus.ts
-import mitt from "mitt";
-var eventBus = mitt();
+var import_mitt = __toESM(require("mitt"));
+var eventBus = (0, import_mitt.default)();
 
 // src/types/ws-identified.ts
-import { z } from "zod";
-var wsIdentifiedPayloadSchema = z.object({
-  connectionId: z.string()
+var import_zod = require("zod");
+var wsIdentifiedPayloadSchema = import_zod.z.object({
+  connectionId: import_zod.z.string()
 });
 
 // src/types/campaign-saving.ts
-import { z as z2 } from "zod";
-var campaignSavingStartSchema = z2.object({
-  status: z2.literal("start")
+var import_zod2 = require("zod");
+var campaignSavingStartSchema = import_zod2.z.object({
+  status: import_zod2.z.literal("start")
 });
-var campaignSavingSuccessSchema = z2.object({
-  status: z2.literal("success")
+var campaignSavingSuccessSchema = import_zod2.z.object({
+  status: import_zod2.z.literal("success")
 });
-var campaignSavingFailedSchema = z2.object({
-  status: z2.literal("failed"),
-  error: z2.record(z2.string(), z2.unknown())
+var campaignSavingFailedSchema = import_zod2.z.object({
+  status: import_zod2.z.literal("failed"),
+  error: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown())
 });
-var campaignSavingPayloadSchema = z2.discriminatedUnion("status", [
+var campaignSavingPayloadSchema = import_zod2.z.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 })
+var import_zod3 = require("zod");
+var serverMessageSchema = import_zod3.z.discriminatedUnion("type", [
+  import_zod3.z.object({ type: import_zod3.z.literal("ws:identified"), payload: wsIdentifiedPayloadSchema }),
+  import_zod3.z.object({ type: import_zod3.z.literal("campaign:saving"), payload: campaignSavingPayloadSchema })
 ]);
 
 // src/websocket-manager.ts
@@ -283,7 +325,8 @@ var MockWebSocketTransport = class {
     this.onclose?.(event);
   }
 };
-export {
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
   MockWebSocketTransport,
   RealWebSocketTransport,
   WebSocketManager,
@@ -291,5 +334,5 @@ export {
   eventBus,
   serverMessageSchema,
   wsIdentifiedPayloadSchema
-};
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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, WsIdentifiedPayload } 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> = { action: \"who-am-I\" };\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  /**\n   * Resolves with the connectionId once the server sends \"ws:identified\".\n   * Resolves immediately if identification has already happened.\n   * Rejects if the socket disconnects before identification, or if\n   * `timeoutMs` elapses (default 10 000 ms).\n   */\n  public waitForConnectionId(timeoutMs = 10_000): Promise<string> {\n    if (this.connectionId !== undefined) {\n      return Promise.resolve(this.connectionId);\n    }\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n\n      const cleanup = (): void => {\n        settled = true;\n        clearTimeout(timer);\n        this.bus.off('ws:identified', onIdentified);\n        this.bus.off('ws:disconnected', onDisconnected);\n      };\n\n      const onIdentified = ({ connectionId }: WsIdentifiedPayload): void => {\n        if (settled) return;\n        cleanup();\n        resolve(connectionId);\n      };\n\n      const onDisconnected = (): void => {\n        if (settled) return;\n        cleanup();\n        reject(new Error('WebSocket disconnected before identification'));\n      };\n\n      const timer = setTimeout(() => {\n        if (settled) return;\n        cleanup();\n        reject(new Error(`waitForConnectionId timed out after ${timeoutMs}ms`));\n      }, timeoutMs);\n\n      this.bus.on('ws:identified', onIdentified);\n      this.bus.on('ws:disconnected', onDisconnected);\n    });\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      // Send immediately so the server can respond with ws:identified,\n      // then keep the connection alive on the regular interval.\n      this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));\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"]}
+{"version":3,"sources":["../src/index.ts","../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":["// Event bus\nexport { eventBus } from './event-bus';\nexport type { EventBus } from './event-bus';\n\n// Manager\nexport { WebSocketManager } from './websocket-manager';\n\n// All types\nexport type {\n  WsEventMap,\n  WsIdentifiedPayload,\n  CampaignSavingPayload,\n  WebSocketManagerConfig,\n  ServerEventKey,\n  ServerMessage,\n  ServerMessageParsed,\n} from './types';\n\n// Zod validators (useful for consumers and tests)\nexport {\n  wsIdentifiedPayloadSchema,\n  campaignSavingPayloadSchema,\n  serverMessageSchema,\n} from './types';\n\n// Transport interface\nexport type { IWebSocketTransport } from './transport.interface';\n\n// Transport implementations\nexport { RealWebSocketTransport } from './transports/real.transport';\nexport { MockWebSocketTransport } from './transports/mock.transport';\n","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, WsIdentifiedPayload } 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> = { action: \"who-am-I\" };\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  /**\n   * Resolves with the connectionId once the server sends \"ws:identified\".\n   * Resolves immediately if identification has already happened.\n   * Rejects if the socket disconnects before identification, or if\n   * `timeoutMs` elapses (default 10 000 ms).\n   */\n  public waitForConnectionId(timeoutMs = 10_000): Promise<string> {\n    if (this.connectionId !== undefined) {\n      return Promise.resolve(this.connectionId);\n    }\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n\n      const cleanup = (): void => {\n        settled = true;\n        clearTimeout(timer);\n        this.bus.off('ws:identified', onIdentified);\n        this.bus.off('ws:disconnected', onDisconnected);\n      };\n\n      const onIdentified = ({ connectionId }: WsIdentifiedPayload): void => {\n        if (settled) return;\n        cleanup();\n        resolve(connectionId);\n      };\n\n      const onDisconnected = (): void => {\n        if (settled) return;\n        cleanup();\n        reject(new Error('WebSocket disconnected before identification'));\n      };\n\n      const timer = setTimeout(() => {\n        if (settled) return;\n        cleanup();\n        reject(new Error(`waitForConnectionId timed out after ${timeoutMs}ms`));\n      }, timeoutMs);\n\n      this.bus.on('ws:identified', onIdentified);\n      this.bus.on('ws:disconnected', onDisconnected);\n    });\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      // Send immediately so the server can respond with ws:identified,\n      // then keep the connection alive on the regular interval.\n      this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));\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":["mitt","import_zod","import_zod"]}

package/dist/index.mjs

@@ -0,0 +1,295 @@
+// 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 = { action: "who-am-I" };
+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;
+  }
+  /**
+   * Resolves with the connectionId once the server sends "ws:identified".
+   * Resolves immediately if identification has already happened.
+   * Rejects if the socket disconnects before identification, or if
+   * `timeoutMs` elapses (default 10 000 ms).
+   */
+  waitForConnectionId(timeoutMs = 1e4) {
+    if (this.connectionId !== void 0) {
+      return Promise.resolve(this.connectionId);
+    }
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const cleanup = () => {
+        settled = true;
+        clearTimeout(timer);
+        this.bus.off("ws:identified", onIdentified);
+        this.bus.off("ws:disconnected", onDisconnected);
+      };
+      const onIdentified = ({ connectionId }) => {
+        if (settled) return;
+        cleanup();
+        resolve(connectionId);
+      };
+      const onDisconnected = () => {
+        if (settled) return;
+        cleanup();
+        reject(new Error("WebSocket disconnected before identification"));
+      };
+      const timer = setTimeout(() => {
+        if (settled) return;
+        cleanup();
+        reject(new Error(`waitForConnectionId timed out after ${timeoutMs}ms`));
+      }, timeoutMs);
+      this.bus.on("ws:identified", onIdentified);
+      this.bus.on("ws:disconnected", onDisconnected);
+    });
+  }
+  /** 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.config.transport.send(JSON.stringify(this.config.heartbeatMessage));
+      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.mjs.map

package/dist/index.mjs.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, WsIdentifiedPayload } 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> = { action: \"who-am-I\" };\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  /**\n   * Resolves with the connectionId once the server sends \"ws:identified\".\n   * Resolves immediately if identification has already happened.\n   * Rejects if the socket disconnects before identification, or if\n   * `timeoutMs` elapses (default 10 000 ms).\n   */\n  public waitForConnectionId(timeoutMs = 10_000): Promise<string> {\n    if (this.connectionId !== undefined) {\n      return Promise.resolve(this.connectionId);\n    }\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n\n      const cleanup = (): void => {\n        settled = true;\n        clearTimeout(timer);\n        this.bus.off('ws:identified', onIdentified);\n        this.bus.off('ws:disconnected', onDisconnected);\n      };\n\n      const onIdentified = ({ connectionId }: WsIdentifiedPayload): void => {\n        if (settled) return;\n        cleanup();\n        resolve(connectionId);\n      };\n\n      const onDisconnected = (): void => {\n        if (settled) return;\n        cleanup();\n        reject(new Error('WebSocket disconnected before identification'));\n      };\n\n      const timer = setTimeout(() => {\n        if (settled) return;\n        cleanup();\n        reject(new Error(`waitForConnectionId timed out after ${timeoutMs}ms`));\n      }, timeoutMs);\n\n      this.bus.on('ws:identified', onIdentified);\n      this.bus.on('ws:disconnected', onDisconnected);\n    });\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      // Send immediately so the server can respond with ws:identified,\n      // then keep the connection alive on the regular interval.\n      this.config.transport.send(JSON.stringify(this.config.heartbeatMessage));\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,11 +1,22 @@
 {
   "name": "@studyportals/ws-client",
-  "version": "0.1.1-beta.7",
+  "version": "0.1.1-beta.8",
   "description": "WebSocket client with reconnect, heartbeat, and typed event bus",
-  "type": "module",
   "main": "dist/index.js",
-  "module": "dist/index.js",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
   "files": [
     "dist"
   ],