@agentxjs/node-platform 2.0.0

package/README.md

@@ -0,0 +1,134 @@
+# @agentxjs/node-platform
+
+Node.js runtime platform for AgentX. Provides concrete implementations of persistence (SQLite), bash execution, networking (WebSocket), message queue, and logging.
+
+## Overview
+
+`@agentxjs/node-platform` assembles platform-specific components into an `AgentXPlatform` instance that the AgentX runtime requires. It handles storage, shell execution, and event infrastructure -- the driver (LLM) is injected separately.
+
+## Quick Start
+
+```typescript
+import { createNodePlatform } from "@agentxjs/node-platform";
+
+const platform = await createNodePlatform({
+  dataPath: "./data",
+});
+
+// platform.containerRepository  -- SQLite container storage
+// platform.imageRepository      -- SQLite image storage
+// platform.sessionRepository    -- SQLite session + message storage
+// platform.eventBus             -- In-memory EventBus
+// platform.bashProvider         -- Shell execution via execa
+```
+
+### Deferred Initialization
+
+Use `nodePlatform()` for lazy initialization (e.g., when passing to `createServer`):
+
+```typescript
+import { nodePlatform } from "@agentxjs/node-platform";
+import { createServer } from "@agentxjs/server";
+
+const server = await createServer({
+  platform: nodePlatform({ dataPath: "./data" }), // resolved lazily
+  createDriver: myCreateDriver,
+});
+```
+
+## API Reference
+
+### `createNodePlatform(options?): Promise<AgentXPlatform>`
+
+Immediately creates and returns a fully initialized platform.
+
+### `nodePlatform(options?): DeferredPlatformConfig`
+
+Returns a deferred config. Call `.resolve()` to initialize.
+
+### `isDeferredPlatform(value): value is DeferredPlatformConfig`
+
+Type guard for deferred platform configs.
+
+### Returned `AgentXPlatform`
+
+| Property              | Type                  | Description                     |
+| --------------------- | --------------------- | ------------------------------- |
+| `containerRepository` | `ContainerRepository` | Container CRUD (SQLite)         |
+| `imageRepository`     | `ImageRepository`     | Image CRUD (SQLite)             |
+| `sessionRepository`   | `SessionRepository`   | Session + message CRUD (SQLite) |
+| `eventBus`            | `EventBus`            | In-memory pub/sub               |
+| `bashProvider`        | `BashProvider`        | Shell execution via execa       |
+
+### Additional Exports
+
+```typescript
+// Persistence
+import { createPersistence, sqliteDriver, memoryDriver } from "@agentxjs/node-platform/persistence";
+
+// Network
+import { WebSocketServer, WebSocketConnection } from "@agentxjs/node-platform/network";
+
+// Message Queue
+import { SqliteMessageQueue, OffsetGenerator } from "@agentxjs/node-platform/mq";
+
+// Bash
+import { NodeBashProvider } from "@agentxjs/node-platform";
+
+// Logger
+import { FileLoggerFactory } from "@agentxjs/node-platform";
+```
+
+## Configuration
+
+### NodePlatformOptions
+
+```typescript
+interface NodePlatformOptions {
+  dataPath?: string; // default: "./data"
+  logDir?: string; // enables file logging if set
+  logLevel?: LogLevel; // default: "debug" (file) / "info" (console)
+}
+```
+
+| Option     | Type       | Default                               | Description                                                  |
+| ---------- | ---------- | ------------------------------------- | ------------------------------------------------------------ |
+| `dataPath` | `string`   | `"./data"`                            | Base directory for SQLite database (`<dataPath>/agentx.db`)  |
+| `logDir`   | `string`   | --                                    | Log file directory. Enables file logging when set.           |
+| `logLevel` | `LogLevel` | `"debug"` (file) / `"info"` (console) | `"debug"` \| `"info"` \| `"warn"` \| `"error"` \| `"silent"` |
+
+### Persistence Drivers
+
+```typescript
+// SQLite (production)
+const persistence = await createPersistence(sqliteDriver({ path: "./data/agentx.db" }));
+
+// In-memory (testing)
+const persistence = await createPersistence(memoryDriver());
+```
+
+### File Logging
+
+```typescript
+import { FileLoggerFactory } from "@agentxjs/node-platform";
+import { setLoggerFactory } from "commonxjs/logger";
+
+setLoggerFactory(
+  new FileLoggerFactory({
+    logDir: ".agentx/logs",
+    level: "info",
+    filename: "app.log", // default
+  })
+);
+```
+
+When `logDir` is passed to `createNodePlatform`, file logging is configured automatically.
+
+### Sub-path Exports
+
+| Import path                           | Contents                                            |
+| ------------------------------------- | --------------------------------------------------- |
+| `@agentxjs/node-platform`             | Main entry (everything)                             |
+| `@agentxjs/node-platform/persistence` | `createPersistence`, `sqliteDriver`, `memoryDriver` |
+| `@agentxjs/node-platform/mq`          | `SqliteMessageQueue`, `OffsetGenerator`             |
+| `@agentxjs/node-platform/network`     | `WebSocketServer`, `WebSocketConnection`            |

package/dist/WebSocketConnection-BUL85bFC.d.ts

@@ -0,0 +1,66 @@
+import { ChannelServer, ChannelServerOptions, MinimalHTTPServer, ChannelConnection, Unsubscribe, SendReliableOptions } from '@agentxjs/core/network';
+import { WebSocket } from 'ws';
+
+/**
+ * WebSocket Server - Manages WebSocket connections
+ *
+ * Supports:
+ * - Standalone mode (listen on port)
+ * - Attached mode (attach to existing HTTP server)
+ */
+
+/**
+ * WebSocket Server
+ */
+declare class WebSocketServer implements ChannelServer {
+    private wss;
+    private connections;
+    private connectionHandlers;
+    private options;
+    private attachedToServer;
+    constructor(options?: ChannelServerOptions);
+    listen(port: number, host?: string): Promise<void>;
+    attach(server: MinimalHTTPServer, path?: string): void;
+    private handleConnection;
+    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
+    broadcast(message: string): void;
+    close(): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+/**
+ * WebSocket Connection - Server-side connection wrapper
+ *
+ * Handles:
+ * - Heartbeat (ping/pong)
+ * - Reliable message delivery with ACK
+ * - Message routing
+ */
+
+/**
+ * WebSocket connection implementation
+ */
+declare class WebSocketConnection implements ChannelConnection {
+    readonly id: string;
+    private ws;
+    private messageHandlers;
+    private closeHandlers;
+    private errorHandlers;
+    private heartbeatInterval?;
+    private isAlive;
+    private pendingAcks;
+    private msgIdCounter;
+    constructor(ws: WebSocket, options: ChannelServerOptions);
+    private setupHeartbeat;
+    private setupMessageHandler;
+    private setupCloseHandler;
+    private setupErrorHandler;
+    send(message: string): void;
+    sendReliable(message: string, options?: SendReliableOptions): void;
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    onClose(handler: () => void): Unsubscribe;
+    onError(handler: (error: Error) => void): Unsubscribe;
+    close(): void;
+}
+
+export { WebSocketServer as W, WebSocketConnection as a };

package/dist/WebSocketFactory-SDWPRZVB.js

@@ -0,0 +1,8 @@
+import {
+  createNodeWebSocket
+} from "./chunk-V664KD3R.js";
+import "./chunk-DGUM43GV.js";
+export {
+  createNodeWebSocket
+};
+//# sourceMappingURL=WebSocketFactory-SDWPRZVB.js.map

package/dist/WebSocketFactory-SDWPRZVB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-BBZV6B5R.js

@@ -0,0 +1,264 @@
+// src/network/WebSocketServer.ts
+import { createLogger as createLogger2 } from "commonxjs/logger";
+
+// src/network/WebSocketConnection.ts
+import { isAckMessage } from "@agentxjs/core/network";
+import { createLogger } from "commonxjs/logger";
+var logger = createLogger("node-platform/WebSocketConnection");
+var WebSocketConnection = class {
+  id;
+  ws;
+  messageHandlers = /* @__PURE__ */ new Set();
+  closeHandlers = /* @__PURE__ */ new Set();
+  errorHandlers = /* @__PURE__ */ new Set();
+  heartbeatInterval;
+  isAlive = true;
+  pendingAcks = /* @__PURE__ */ new Map();
+  msgIdCounter = 0;
+  constructor(ws, options) {
+    this.ws = ws;
+    this.id = `conn_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+    this.setupHeartbeat(options);
+    this.setupMessageHandler();
+    this.setupCloseHandler();
+    this.setupErrorHandler();
+  }
+  setupHeartbeat(options) {
+    if (options.heartbeat === false) return;
+    const interval = options.heartbeatInterval || 3e4;
+    this.ws.on("pong", () => {
+      this.isAlive = true;
+      logger.debug("Heartbeat pong received", { id: this.id });
+    });
+    this.heartbeatInterval = setInterval(() => {
+      if (!this.isAlive) {
+        logger.warn("Client heartbeat timeout, terminating connection", { id: this.id });
+        clearInterval(this.heartbeatInterval);
+        this.ws.terminate();
+        return;
+      }
+      this.isAlive = false;
+      this.ws.ping();
+      logger.debug("Heartbeat ping sent", { id: this.id });
+    }, interval);
+  }
+  setupMessageHandler() {
+    this.ws.on("message", (data) => {
+      const message = data.toString();
+      try {
+        const parsed = JSON.parse(message);
+        if (isAckMessage(parsed)) {
+          const pending = this.pendingAcks.get(parsed.__ack);
+          if (pending) {
+            clearTimeout(pending.timer);
+            pending.resolve();
+            this.pendingAcks.delete(parsed.__ack);
+            logger.debug("ACK received", { msgId: parsed.__ack, connectionId: this.id });
+          }
+          return;
+        }
+      } catch {
+      }
+      for (const handler of this.messageHandlers) {
+        handler(message);
+      }
+    });
+  }
+  setupCloseHandler() {
+    this.ws.on("close", () => {
+      if (this.heartbeatInterval) {
+        clearInterval(this.heartbeatInterval);
+      }
+      for (const handler of this.closeHandlers) {
+        handler();
+      }
+    });
+  }
+  setupErrorHandler() {
+    this.ws.on("error", (err) => {
+      if (this.heartbeatInterval) {
+        clearInterval(this.heartbeatInterval);
+      }
+      for (const handler of this.errorHandlers) {
+        handler(err);
+      }
+    });
+  }
+  send(message) {
+    if (this.ws.readyState === 1) {
+      this.ws.send(message);
+    }
+  }
+  sendReliable(message, options) {
+    if (this.ws.readyState !== 1) {
+      options?.onTimeout?.();
+      return;
+    }
+    if (!options?.onAck) {
+      this.send(message);
+      return;
+    }
+    const msgId = `${this.id}_${++this.msgIdCounter}`;
+    const wrapped = {
+      __msgId: msgId,
+      __payload: message
+    };
+    const timeout = options.timeout ?? 5e3;
+    const timer = setTimeout(() => {
+      if (this.pendingAcks.has(msgId)) {
+        this.pendingAcks.delete(msgId);
+        logger.warn("ACK timeout", { msgId, connectionId: this.id, timeout });
+        options.onTimeout?.();
+      }
+    }, timeout);
+    this.pendingAcks.set(msgId, {
+      resolve: options.onAck,
+      timer
+    });
+    this.ws.send(JSON.stringify(wrapped));
+    logger.debug("Sent reliable message", { msgId, connectionId: this.id });
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+    return () => {
+      this.messageHandlers.delete(handler);
+    };
+  }
+  onClose(handler) {
+    this.closeHandlers.add(handler);
+    return () => {
+      this.closeHandlers.delete(handler);
+    };
+  }
+  onError(handler) {
+    this.errorHandlers.add(handler);
+    return () => {
+      this.errorHandlers.delete(handler);
+    };
+  }
+  close() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+    }
+    for (const pending of this.pendingAcks.values()) {
+      clearTimeout(pending.timer);
+    }
+    this.pendingAcks.clear();
+    this.ws.close();
+  }
+};
+
+// src/network/WebSocketServer.ts
+var logger2 = createLogger2("node-platform/WebSocketServer");
+var WebSocketServer = class {
+  wss = null;
+  connections = /* @__PURE__ */ new Set();
+  connectionHandlers = /* @__PURE__ */ new Set();
+  options;
+  attachedToServer = false;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  async listen(port, host = "0.0.0.0") {
+    if (this.wss) {
+      throw new Error("Server already listening");
+    }
+    if (this.attachedToServer) {
+      throw new Error(
+        "Cannot listen when attached to existing server. The server should call listen() instead."
+      );
+    }
+    const { WebSocketServer: WSS } = await import("ws");
+    this.wss = new WSS({ port, host });
+    this.wss.on("connection", (ws) => {
+      this.handleConnection(ws);
+    });
+    logger2.info("WebSocket server listening", { port, host });
+  }
+  attach(server, path = "/ws") {
+    if (this.wss) {
+      throw new Error("Server already initialized");
+    }
+    import("ws").then(({ WebSocketServer: WSS }) => {
+      this.wss = new WSS({ noServer: true });
+      server.on("upgrade", (request, socket, head) => {
+        const url = new URL(
+          request.url || "",
+          `http://${request.headers.host}`
+        );
+        if (url.pathname === path) {
+          this.wss.handleUpgrade(request, socket, head, (ws) => {
+            this.wss.emit("connection", ws, request);
+          });
+        } else {
+          socket.destroy();
+        }
+      });
+      this.wss.on("connection", (ws) => {
+        this.handleConnection(ws);
+      });
+      this.attachedToServer = true;
+      logger2.info("WebSocket attached to existing HTTP server", { path });
+    });
+  }
+  handleConnection(ws) {
+    const connection = new WebSocketConnection(ws, this.options);
+    this.connections.add(connection);
+    logger2.info("Client connected", {
+      connectionId: connection.id,
+      totalConnections: this.connections.size
+    });
+    connection.onClose(() => {
+      this.connections.delete(connection);
+      logger2.info("Client disconnected", {
+        connectionId: connection.id,
+        totalConnections: this.connections.size
+      });
+    });
+    for (const handler of this.connectionHandlers) {
+      handler(connection);
+    }
+  }
+  onConnection(handler) {
+    this.connectionHandlers.add(handler);
+    return () => {
+      this.connectionHandlers.delete(handler);
+    };
+  }
+  broadcast(message) {
+    for (const connection of this.connections) {
+      connection.send(message);
+    }
+  }
+  async close() {
+    if (!this.wss) return;
+    for (const connection of this.connections) {
+      connection.close();
+    }
+    this.connections.clear();
+    if (!this.attachedToServer) {
+      await new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+          logger2.warn("WebSocket server close timeout, forcing close");
+          resolve();
+        }, 1e3);
+        this.wss.close(() => {
+          clearTimeout(timeout);
+          resolve();
+        });
+      });
+    }
+    this.wss = null;
+    logger2.info("WebSocket server closed");
+  }
+  async dispose() {
+    await this.close();
+    this.connectionHandlers.clear();
+  }
+};
+
+export {
+  WebSocketConnection,
+  WebSocketServer
+};
+//# sourceMappingURL=chunk-BBZV6B5R.js.map

package/dist/chunk-BBZV6B5R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/network/WebSocketServer.ts","../src/network/WebSocketConnection.ts"],"sourcesContent":["/**\n * WebSocket Server - Manages WebSocket connections\n *\n * Supports:\n * - Standalone mode (listen on port)\n * - Attached mode (attach to existing HTTP server)\n */\n\nimport type { WebSocket as WS, WebSocketServer as WSS } from \"ws\";\nimport type {\n  ChannelServer,\n  ChannelConnection,\n  ChannelServerOptions,\n  MinimalHTTPServer,\n  Unsubscribe,\n} from \"@agentxjs/core/network\";\nimport { createLogger } from \"commonxjs/logger\";\nimport { WebSocketConnection } from \"./WebSocketConnection\";\n\nconst logger = createLogger(\"node-platform/WebSocketServer\");\n\n/**\n * WebSocket Server\n */\nexport class WebSocketServer implements ChannelServer {\n  private wss: WSS | null = null;\n  private connections = new Set<WebSocketConnection>();\n  private connectionHandlers = new Set<(connection: ChannelConnection) => void>();\n  private options: ChannelServerOptions;\n  private attachedToServer = false;\n\n  constructor(options: ChannelServerOptions = {}) {\n    this.options = options;\n  }\n\n  async listen(port: number, host: string = \"0.0.0.0\"): Promise<void> {\n    if (this.wss) {\n      throw new Error(\"Server already listening\");\n    }\n    if (this.attachedToServer) {\n      throw new Error(\n        \"Cannot listen when attached to existing server. The server should call listen() instead.\"\n      );\n    }\n\n    const { WebSocketServer: WSS } = await import(\"ws\");\n    this.wss = new WSS({ port, host });\n\n    this.wss.on(\"connection\", (ws: WS) => {\n      this.handleConnection(ws);\n    });\n\n    logger.info(\"WebSocket server listening\", { port, host });\n  }\n\n  attach(server: MinimalHTTPServer, path: string = \"/ws\"): void {\n    if (this.wss) {\n      throw new Error(\"Server already initialized\");\n    }\n\n    import(\"ws\").then(({ WebSocketServer: WSS }) => {\n      this.wss = new WSS({ noServer: true });\n\n      // Handle WebSocket upgrade on the HTTP server\n      server.on(\"upgrade\", (request, socket, head) => {\n        const url = new URL(\n          (request as { url?: string }).url || \"\",\n          `http://${(request as { headers: { host?: string } }).headers.host}`\n        );\n        if (url.pathname === path) {\n          this.wss!.handleUpgrade(request as never, socket as never, head as never, (ws: WS) => {\n            this.wss!.emit(\"connection\", ws, request);\n          });\n        } else {\n          (socket as { destroy: () => void }).destroy();\n        }\n      });\n\n      this.wss.on(\"connection\", (ws: WS) => {\n        this.handleConnection(ws);\n      });\n\n      this.attachedToServer = true;\n      logger.info(\"WebSocket attached to existing HTTP server\", { path });\n    });\n  }\n\n  private handleConnection(ws: WS): void {\n    const connection = new WebSocketConnection(ws, this.options);\n    this.connections.add(connection);\n\n    logger.info(\"Client connected\", {\n      connectionId: connection.id,\n      totalConnections: this.connections.size,\n    });\n\n    connection.onClose(() => {\n      this.connections.delete(connection);\n\n      logger.info(\"Client disconnected\", {\n        connectionId: connection.id,\n        totalConnections: this.connections.size,\n      });\n    });\n\n    // Notify handlers\n    for (const handler of this.connectionHandlers) {\n      handler(connection);\n    }\n  }\n\n  onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe {\n    this.connectionHandlers.add(handler);\n    return () => {\n      this.connectionHandlers.delete(handler);\n    };\n  }\n\n  broadcast(message: string): void {\n    for (const connection of this.connections) {\n      connection.send(message);\n    }\n  }\n\n  async close(): Promise<void> {\n    if (!this.wss) return;\n\n    for (const connection of this.connections) {\n      connection.close();\n    }\n    this.connections.clear();\n\n    // Don't close the server if attached to existing HTTP server\n    if (!this.attachedToServer) {\n      await new Promise<void>((resolve) => {\n        // Add timeout to prevent hanging\n        const timeout = setTimeout(() => {\n          logger.warn(\"WebSocket server close timeout, forcing close\");\n          resolve();\n        }, 1000);\n\n        this.wss!.close(() => {\n          clearTimeout(timeout);\n          resolve();\n        });\n      });\n    }\n    this.wss = null;\n    logger.info(\"WebSocket server closed\");\n  }\n\n  async dispose(): Promise<void> {\n    await this.close();\n    this.connectionHandlers.clear();\n  }\n}\n","/**\n * WebSocket Connection - Server-side connection wrapper\n *\n * Handles:\n * - Heartbeat (ping/pong)\n * - Reliable message delivery with ACK\n * - Message routing\n */\n\nimport type { WebSocket as WS } from \"ws\";\nimport type {\n  ChannelConnection,\n  ChannelServerOptions,\n  Unsubscribe,\n  SendReliableOptions,\n} from \"@agentxjs/core/network\";\nimport { isAckMessage, type ReliableWrapper } from \"@agentxjs/core/network\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"node-platform/WebSocketConnection\");\n\n/**\n * WebSocket connection implementation\n */\nexport class WebSocketConnection implements ChannelConnection {\n  public readonly id: string;\n  private ws: WS;\n  private messageHandlers = new Set<(message: string) => void>();\n  private closeHandlers = new Set<() => void>();\n  private errorHandlers = new Set<(error: Error) => void>();\n  private heartbeatInterval?: ReturnType<typeof setInterval>;\n  private isAlive = true;\n  private pendingAcks = new Map<\n    string,\n    { resolve: () => void; timer: ReturnType<typeof setTimeout> }\n  >();\n  private msgIdCounter = 0;\n\n  constructor(ws: WS, options: ChannelServerOptions) {\n    this.ws = ws;\n    this.id = `conn_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;\n\n    this.setupHeartbeat(options);\n    this.setupMessageHandler();\n    this.setupCloseHandler();\n    this.setupErrorHandler();\n  }\n\n  private setupHeartbeat(options: ChannelServerOptions): void {\n    if (options.heartbeat === false) return;\n\n    const interval = options.heartbeatInterval || 30000;\n\n    this.ws.on(\"pong\", () => {\n      this.isAlive = true;\n      logger.debug(\"Heartbeat pong received\", { id: this.id });\n    });\n\n    this.heartbeatInterval = setInterval(() => {\n      if (!this.isAlive) {\n        logger.warn(\"Client heartbeat timeout, terminating connection\", { id: this.id });\n        clearInterval(this.heartbeatInterval);\n        this.ws.terminate();\n        return;\n      }\n      this.isAlive = false;\n      this.ws.ping();\n      logger.debug(\"Heartbeat ping sent\", { id: this.id });\n    }, interval);\n  }\n\n  private setupMessageHandler(): void {\n    this.ws.on(\"message\", (data: Buffer) => {\n      const message = data.toString();\n\n      // Try to parse as JSON to check for ACK messages\n      try {\n        const parsed = JSON.parse(message);\n\n        // Handle ACK response from client\n        if (isAckMessage(parsed)) {\n          const pending = this.pendingAcks.get(parsed.__ack);\n          if (pending) {\n            clearTimeout(pending.timer);\n            pending.resolve();\n            this.pendingAcks.delete(parsed.__ack);\n            logger.debug(\"ACK received\", { msgId: parsed.__ack, connectionId: this.id });\n          }\n          return; // Don't pass ACK messages to application layer\n        }\n      } catch {\n        // Not JSON, pass through as normal message\n      }\n\n      // Pass message to handlers\n      for (const handler of this.messageHandlers) {\n        handler(message);\n      }\n    });\n  }\n\n  private setupCloseHandler(): void {\n    this.ws.on(\"close\", () => {\n      if (this.heartbeatInterval) {\n        clearInterval(this.heartbeatInterval);\n      }\n      for (const handler of this.closeHandlers) {\n        handler();\n      }\n    });\n  }\n\n  private setupErrorHandler(): void {\n    this.ws.on(\"error\", (err: Error) => {\n      if (this.heartbeatInterval) {\n        clearInterval(this.heartbeatInterval);\n      }\n      for (const handler of this.errorHandlers) {\n        handler(err);\n      }\n    });\n  }\n\n  send(message: string): void {\n    if (this.ws.readyState === 1) {\n      // WebSocket.OPEN\n      this.ws.send(message);\n    }\n  }\n\n  sendReliable(message: string, options?: SendReliableOptions): void {\n    if (this.ws.readyState !== 1) {\n      // WebSocket not open, trigger timeout immediately if callback provided\n      options?.onTimeout?.();\n      return;\n    }\n\n    // If no ACK callback needed, just send normally\n    if (!options?.onAck) {\n      this.send(message);\n      return;\n    }\n\n    // Generate unique message ID\n    const msgId = `${this.id}_${++this.msgIdCounter}`;\n\n    // Wrap message with msgId\n    const wrapped: ReliableWrapper = {\n      __msgId: msgId,\n      __payload: message,\n    };\n\n    // Set up timeout\n    const timeout = options.timeout ?? 5000;\n    const timer = setTimeout(() => {\n      if (this.pendingAcks.has(msgId)) {\n        this.pendingAcks.delete(msgId);\n        logger.warn(\"ACK timeout\", { msgId, connectionId: this.id, timeout });\n        options.onTimeout?.();\n      }\n    }, timeout);\n\n    // Store pending ACK\n    this.pendingAcks.set(msgId, {\n      resolve: options.onAck,\n      timer,\n    });\n\n    // Send wrapped message\n    this.ws.send(JSON.stringify(wrapped));\n    logger.debug(\"Sent reliable message\", { msgId, connectionId: this.id });\n  }\n\n  onMessage(handler: (message: string) => void): Unsubscribe {\n    this.messageHandlers.add(handler);\n    return () => {\n      this.messageHandlers.delete(handler);\n    };\n  }\n\n  onClose(handler: () => void): Unsubscribe {\n    this.closeHandlers.add(handler);\n    return () => {\n      this.closeHandlers.delete(handler);\n    };\n  }\n\n  onError(handler: (error: Error) => void): Unsubscribe {\n    this.errorHandlers.add(handler);\n    return () => {\n      this.errorHandlers.delete(handler);\n    };\n  }\n\n  close(): void {\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval);\n    }\n    // Clean up pending ACKs\n    for (const pending of this.pendingAcks.values()) {\n      clearTimeout(pending.timer);\n    }\n    this.pendingAcks.clear();\n    this.ws.close();\n  }\n}\n"],"mappings":"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","names":["createLogger","logger","createLogger"]}

package/dist/chunk-DGUM43GV.js

@@ -0,0 +1,11 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};
+//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/chunk-DGUM43GV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}