@kyneta/sse-transport 1.3.1 → 1.4.0

package/src/__tests__/sse-handler.test.ts

@@ -5,6 +5,7 @@
 // 2. Fragment text frame body → returns pending, then complete on final fragment
 // 3. Malformed body → returns error
 
+import { SYNC_AUTHORITATIVE } from "@kyneta/schema"
 import type { ChannelMsg } from "@kyneta/transport"
 import {
   encodeTextComplete,
@@ -25,13 +26,13 @@ const presentMsg: ChannelMsg = {
     {
       docId: "doc-1",
       replicaType: ["plain", 1, 0] as const,
-      mergeStrategy: "authoritative" as const,
+      syncProtocol: SYNC_AUTHORITATIVE,
       schemaHash: "test-hash",
     },
     {
       docId: "doc-2",
       replicaType: ["plain", 1, 0] as const,
-      mergeStrategy: "authoritative" as const,
+      syncProtocol: SYNC_AUTHORITATIVE,
       schemaHash: "test-hash",
     },
   ],

package/src/client-transport.ts

@@ -24,7 +24,7 @@
 // The connection handshake:
 // 1. Client creates EventSource, waits for open
 // 2. EventSource.onopen fires → client creates channel + calls establishChannel()
-// 3. Synchronizer exchanges establish-request / establish-response via POST + SSE
+// 3. Synchronizer exchanges establish messages via POST + SSE
 //
 // On EventSource.onerror, the adapter closes the EventSource immediately and
 // takes over reconnection via the program's backoff logic, rather than
@@ -147,7 +147,7 @@ export type SseClientStateTransition = StateTransition<SseClientState>
  * import { createSseClient } from "@kyneta/sse-transport/client"
  *
  * const exchange = new Exchange({
- *   identity: { peerId: "browser-client" },
+ *   id: "browser-client",
  *   transports: [createSseClient({
  *     postUrl: "/sync",
  *     eventSourceUrl: (peerId) => `/events?peerId=${peerId}`,

package/src/express-router.ts

@@ -83,7 +83,7 @@ export interface SseExpressRouterOptions {
  *
  * const serverAdapter = new SseServerTransport()
  * const exchange = new Exchange({
- *   identity: { peerId: "server", name: "server", type: "service" },
+ *   id: { peerId: "server", name: "server", type: "service" },
  *   transports: [() => serverAdapter],
  * })
  *

package/src/server-transport.ts

@@ -75,11 +75,11 @@ function generatePeerId(): PeerId {
  * The connection handshake:
  * 1. Client opens EventSource (GET /events)
  * 2. Server calls `registerConnection(peerId)` → creates channel
- * 3. Client's EventSource.onopen fires → client sends establish-request (POST)
- * 4. Server receives establish-request → Synchronizer responds with establish-response (SSE)
+ * 3. Client's EventSource.onopen fires → client sends establish (POST)
+ * 4. Server receives establish → Synchronizer upgrades channel and sends present (SSE)
  *
  * The server does NOT call `establishChannel()` — it waits for the client's
- * establish-request, which arrives via POST after the EventSource is open.
+ * establish message, which arrives via POST after the EventSource is open.
  */
 export class SseServerTransport extends Transport<PeerId> {
   #connections = new Map<PeerId, SseConnection>()

package/dist/chunk-7D4SUZUM.js

@@ -1,38 +0,0 @@
-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 __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');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-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
-));
-
-export {
-  __require,
-  __commonJS,
-  __toESM
-};
-//# sourceMappingURL=chunk-7D4SUZUM.js.map

package/dist/chunk-7D4SUZUM.js.map

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

package/dist/chunk-ZBE5AMNA.js

@@ -1,255 +0,0 @@
-// src/connection.ts
-import {
-  encodeTextComplete,
-  fragmentTextPayload,
-  TextReassembler,
-  textCodec
-} from "@kyneta/wire";
-var DEFAULT_FRAGMENT_THRESHOLD = 6e4;
-var SseConnection = class {
-  peerId;
-  channelId;
-  #channel = null;
-  #sendFn = null;
-  #onDisconnect = null;
-  // Fragmentation support
-  #fragmentThreshold;
-  /**
-   * Text reassembler for handling fragmented POST bodies.
-   * Each connection has its own reassembler to track in-flight fragment batches.
-   */
-  reassembler;
-  constructor(peerId, channelId, config) {
-    this.peerId = peerId;
-    this.channelId = channelId;
-    this.#fragmentThreshold = config?.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD;
-    this.reassembler = new TextReassembler({
-      timeoutMs: 1e4,
-      onTimeout: (frameId) => {
-        console.warn(
-          `[SseConnection] Fragment batch timed out for peer ${peerId}: ${frameId}`
-        );
-      }
-    });
-  }
-  // ==========================================================================
-  // INTERNAL API — for adapter use
-  // ==========================================================================
-  /**
-   * Set the channel reference.
-   * Called by the adapter when the channel is created.
-   * @internal
-   */
-  _setChannel(channel) {
-    this.#channel = channel;
-  }
-  // ==========================================================================
-  // PUBLIC API
-  // ==========================================================================
-  /**
-   * Set the function to call when sending messages to this peer.
-   *
-   * The function receives a fully encoded text frame string.
-   * The framework integration just wraps it in SSE syntax:
-   * - Express: `res.write(\`data: \${textFrame}\\n\\n\`)`
-   * - Hono: `stream.writeSSE({ data: textFrame })`
-   *
-   * @param sendFn Function that writes a text frame string to the SSE stream
-   */
-  setSendFunction(sendFn) {
-    this.#sendFn = sendFn;
-  }
-  /**
-   * Set the function to call when this connection is disconnected.
-   */
-  setDisconnectHandler(handler) {
-    this.#onDisconnect = handler;
-  }
-  /**
-   * Send a ChannelMsg to the peer through the SSE stream.
-   *
-   * Encodes via textCodec → text frame → fragment if needed → sendFn().
-   * Encoding and fragmentation are the connection's concern — the
-   * framework integration only needs to write strings.
-   */
-  send(msg) {
-    if (!this.#sendFn) {
-      throw new Error(
-        `Cannot send message: send function not set for peer ${this.peerId}`
-      );
-    }
-    const textFrame = encodeTextComplete(textCodec, msg);
-    if (this.#fragmentThreshold > 0 && textFrame.length > this.#fragmentThreshold) {
-      const payload = JSON.stringify(textCodec.encode(msg));
-      const fragments = fragmentTextPayload(payload, this.#fragmentThreshold);
-      for (const fragment of fragments) {
-        this.#sendFn(fragment);
-      }
-    } else {
-      this.#sendFn(textFrame);
-    }
-  }
-  /**
-   * Receive a message from the peer and route it to the channel.
-   *
-   * Called by the framework integration after parsing a POST body
-   * through `parseTextPostBody`.
-   */
-  receive(msg) {
-    if (!this.#channel) {
-      throw new Error(
-        `Cannot receive message: channel not set for peer ${this.peerId}`
-      );
-    }
-    this.#channel.onReceive(msg);
-  }
-  /**
-   * Disconnect this connection.
-   */
-  disconnect() {
-    this.#onDisconnect?.();
-  }
-  /**
-   * Dispose of resources held by this connection.
-   * Must be called when the connection is closed to prevent timer leaks.
-   */
-  dispose() {
-    this.reassembler.dispose();
-  }
-};
-
-// src/server-transport.ts
-import { Transport } from "@kyneta/transport";
-function generatePeerId() {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  let result = "sse-";
-  for (let i = 0; i < 12; i++) {
-    result += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return result;
-}
-var SseServerTransport = class extends Transport {
-  #connections = /* @__PURE__ */ new Map();
-  #fragmentThreshold;
-  constructor(options) {
-    super({ transportType: "sse-server" });
-    this.#fragmentThreshold = options?.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD;
-  }
-  // ==========================================================================
-  // Adapter abstract method implementations
-  // ==========================================================================
-  generate(peerId) {
-    return {
-      transportType: this.transportType,
-      send: (msg) => {
-        const connection = this.#connections.get(peerId);
-        if (connection) {
-          connection.send(msg);
-        }
-      },
-      stop: () => {
-        this.unregisterConnection(peerId);
-      }
-    };
-  }
-  async onStart() {
-  }
-  async onStop() {
-    for (const connection of this.#connections.values()) {
-      connection.disconnect();
-    }
-    this.#connections.clear();
-  }
-  // ==========================================================================
-  // Connection management
-  // ==========================================================================
-  /**
-   * Register a new peer connection.
-   *
-   * Call this from your framework's SSE endpoint handler when a client
-   * connects via EventSource. Returns an `SseConnection` that you wire
-   * up with `setSendFunction()` and `setDisconnectHandler()`.
-   *
-   * @param peerId The unique identifier for the peer (from query param or header)
-   * @returns An SseConnection object for managing the connection
-   *
-   * @example Express
-   * ```typescript
-   * const connection = serverAdapter.registerConnection(peerId)
-   * connection.setSendFunction((textFrame) => {
-   *   res.write(`data: ${textFrame}\n\n`)
-   * })
-   * ```
-   *
-   * @example Hono
-   * ```typescript
-   * const connection = serverAdapter.registerConnection(peerId)
-   * connection.setSendFunction((textFrame) => {
-   *   stream.writeSSE({ data: textFrame })
-   * })
-   * ```
-   */
-  registerConnection(peerId) {
-    const resolvedPeerId = peerId ?? generatePeerId();
-    const existingConnection = this.#connections.get(resolvedPeerId);
-    if (existingConnection) {
-      existingConnection.dispose();
-      this.unregisterConnection(resolvedPeerId);
-    }
-    const channel = this.addChannel(resolvedPeerId);
-    const connection = new SseConnection(resolvedPeerId, channel.channelId, {
-      fragmentThreshold: this.#fragmentThreshold
-    });
-    connection._setChannel(channel);
-    this.#connections.set(resolvedPeerId, connection);
-    return connection;
-  }
-  /**
-   * Unregister a peer connection.
-   *
-   * Removes the channel, disposes the connection's reassembler,
-   * and cleans up tracking state. Called automatically when the
-   * client disconnects (via req.on("close")) or manually.
-   *
-   * @param peerId The unique identifier for the peer
-   */
-  unregisterConnection(peerId) {
-    const connection = this.#connections.get(peerId);
-    if (connection) {
-      connection.dispose();
-      this.removeChannel(connection.channelId);
-      this.#connections.delete(peerId);
-    }
-  }
-  /**
-   * Get an active connection by peer ID.
-   */
-  getConnection(peerId) {
-    return this.#connections.get(peerId);
-  }
-  /**
-   * Get all active connections.
-   */
-  getAllConnections() {
-    return Array.from(this.#connections.values());
-  }
-  /**
-   * Check if a peer is connected.
-   */
-  isConnected(peerId) {
-    return this.#connections.has(peerId);
-  }
-  /**
-   * Get the number of connected peers.
-   */
-  get connectionCount() {
-    return this.#connections.size;
-  }
-};
-
-export {
-  DEFAULT_FRAGMENT_THRESHOLD,
-  SseConnection,
-  SseServerTransport
-};
-//# sourceMappingURL=chunk-ZBE5AMNA.js.map

package/dist/chunk-ZBE5AMNA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/connection.ts","../src/server-transport.ts"],"sourcesContent":["// connection — SseConnection for server-side peer connections.\n//\n// Wraps a TextReassembler + textCodec to provide send/receive for\n// ChannelMsg over a single SSE connection.\n//\n// Used by SseServerTransport to manage individual client connections.\n// The client adapter handles its own encoding/decoding inline since it\n// manages a single EventSource with reconnection logic.\n//\n// The sendFn receives pre-encoded text frame strings. Framework\n// integrations just wrap them in SSE syntax:\n//   Express: res.write(`data: ${textFrame}\\n\\n`)\n//   Hono:    stream.writeSSE({ data: textFrame })\n\nimport type { Channel, ChannelMsg, PeerId } from \"@kyneta/transport\"\nimport {\n  encodeTextComplete,\n  fragmentTextPayload,\n  TextReassembler,\n  textCodec,\n} from \"@kyneta/wire\"\n\n/**\n * Default fragment threshold in characters for outbound SSE messages.\n * 60K chars provides a safety margin below typical infrastructure limits.\n */\nexport const DEFAULT_FRAGMENT_THRESHOLD = 60_000\n\n/**\n * Configuration for creating an SseConnection.\n */\nexport interface SseConnectionConfig {\n  /**\n   * Fragment threshold in characters. Messages larger than this are fragmented.\n   * Set to 0 to disable fragmentation.\n   * Default: 60000 (60K chars)\n   */\n  fragmentThreshold?: number\n}\n\n/**\n * Represents a single SSE connection to a peer (server-side).\n *\n * Manages encoding, framing, fragmentation, and reassembly for one\n * connected client. Created by `SseServerTransport.registerConnection()`.\n *\n * The connection uses the text codec for transport — this is the natural\n * choice for SSE's text-only protocol.\n */\nexport class SseConnection {\n  readonly peerId: PeerId\n  readonly channelId: number\n\n  #channel: Channel | null = null\n  #sendFn: ((textFrame: string) => void) | null = null\n  #onDisconnect: (() => void) | null = null\n\n  // Fragmentation support\n  readonly #fragmentThreshold: number\n\n  /**\n   * Text reassembler for handling fragmented POST bodies.\n   * Each connection has its own reassembler to track in-flight fragment batches.\n   */\n  readonly reassembler: TextReassembler\n\n  constructor(peerId: PeerId, channelId: number, config?: SseConnectionConfig) {\n    this.peerId = peerId\n    this.channelId = channelId\n    this.#fragmentThreshold =\n      config?.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD\n    this.reassembler = new TextReassembler({\n      timeoutMs: 10_000,\n      onTimeout: (frameId: string) => {\n        console.warn(\n          `[SseConnection] Fragment batch timed out for peer ${peerId}: ${frameId}`,\n        )\n      },\n    })\n  }\n\n  // ==========================================================================\n  // INTERNAL API — for adapter use\n  // ==========================================================================\n\n  /**\n   * Set the channel reference.\n   * Called by the adapter when the channel is created.\n   * @internal\n   */\n  _setChannel(channel: Channel): void {\n    this.#channel = channel\n  }\n\n  // ==========================================================================\n  // PUBLIC API\n  // ==========================================================================\n\n  /**\n   * Set the function to call when sending messages to this peer.\n   *\n   * The function receives a fully encoded text frame string.\n   * The framework integration just wraps it in SSE syntax:\n   * - Express: `res.write(\\`data: \\${textFrame}\\\\n\\\\n\\`)`\n   * - Hono: `stream.writeSSE({ data: textFrame })`\n   *\n   * @param sendFn Function that writes a text frame string to the SSE stream\n   */\n  setSendFunction(sendFn: (textFrame: string) => void): void {\n    this.#sendFn = sendFn\n  }\n\n  /**\n   * Set the function to call when this connection is disconnected.\n   */\n  setDisconnectHandler(handler: () => void): void {\n    this.#onDisconnect = handler\n  }\n\n  /**\n   * Send a ChannelMsg to the peer through the SSE stream.\n   *\n   * Encodes via textCodec → text frame → fragment if needed → sendFn().\n   * Encoding and fragmentation are the connection's concern — the\n   * framework integration only needs to write strings.\n   */\n  send(msg: ChannelMsg): void {\n    if (!this.#sendFn) {\n      throw new Error(\n        `Cannot send message: send function not set for peer ${this.peerId}`,\n      )\n    }\n\n    // Encode to text wire format\n    const textFrame = encodeTextComplete(textCodec, msg)\n\n    // Fragment large payloads\n    if (\n      this.#fragmentThreshold > 0 &&\n      textFrame.length > this.#fragmentThreshold\n    ) {\n      const payload = JSON.stringify(textCodec.encode(msg))\n      const fragments = fragmentTextPayload(payload, this.#fragmentThreshold)\n      for (const fragment of fragments) {\n        this.#sendFn(fragment)\n      }\n    } else {\n      this.#sendFn(textFrame)\n    }\n  }\n\n  /**\n   * Receive a message from the peer and route it to the channel.\n   *\n   * Called by the framework integration after parsing a POST body\n   * through `parseTextPostBody`.\n   */\n  receive(msg: ChannelMsg): void {\n    if (!this.#channel) {\n      throw new Error(\n        `Cannot receive message: channel not set for peer ${this.peerId}`,\n      )\n    }\n    this.#channel.onReceive(msg)\n  }\n\n  /**\n   * Disconnect this connection.\n   */\n  disconnect(): void {\n    this.#onDisconnect?.()\n  }\n\n  /**\n   * Dispose of resources held by this connection.\n   * Must be called when the connection is closed to prevent timer leaks.\n   */\n  dispose(): void {\n    this.reassembler.dispose()\n  }\n}\n","// server-adapter — SSE server adapter for @kyneta/exchange.\n//\n// Manages SSE connections from clients, encoding/decoding via the\n// kyneta text wire format. Framework-agnostic — works with any HTTP\n// framework through the SseConnection's setSendFunction() callback.\n//\n// Usage with Express:\n//   import { SseServerTransport } from \"@kyneta/sse-network-adapter/server\"\n//   import { createSseExpressRouter } from \"@kyneta/sse-network-adapter/express\"\n//\n//   const serverAdapter = new SseServerTransport()\n//   app.use(\"/sse\", createSseExpressRouter(serverAdapter))\n//\n// Usage with Hono:\n//   import { SseServerTransport } from \"@kyneta/sse-network-adapter/server\"\n//   import { parseTextPostBody } from \"@kyneta/sse-network-adapter/express\"\n//\n//   const serverAdapter = new SseServerTransport()\n//   // Wire up GET /events and POST /sync manually using\n//   // serverAdapter.registerConnection() and parseTextPostBody()\n\nimport type { ChannelMsg, GeneratedChannel, PeerId } from \"@kyneta/transport\"\nimport { Transport } from \"@kyneta/transport\"\nimport { DEFAULT_FRAGMENT_THRESHOLD, SseConnection } from \"./connection.js\"\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/**\n * Options for the SSE server adapter.\n */\nexport interface SseServerTransportOptions {\n  /**\n   * Fragment threshold in characters. Messages larger than this are fragmented\n   * into multiple SSE events.\n   * Set to 0 to disable fragmentation.\n   * Default: 60000 (60K chars)\n   */\n  fragmentThreshold?: number\n}\n\n// ---------------------------------------------------------------------------\n// Peer ID generation\n// ---------------------------------------------------------------------------\n\n/**\n * Generate a random peer ID for connections that don't provide one.\n */\nfunction generatePeerId(): PeerId {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\"\n  let result = \"sse-\"\n  for (let i = 0; i < 12; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length))\n  }\n  return result\n}\n\n// ---------------------------------------------------------------------------\n// SseServerTransport\n// ---------------------------------------------------------------------------\n\n/**\n * SSE server network adapter.\n *\n * Framework-agnostic — works with any HTTP framework through the\n * `SseConnection.setSendFunction()` callback. Use `registerConnection()`\n * to integrate with your framework's SSE endpoint handler.\n *\n * Each client connection is tracked as an `SseConnection` keyed by peer ID.\n * The adapter creates a channel per connection and routes outbound messages\n * through the connection's send method (which encodes to text wire format\n * and calls the injected sendFn).\n *\n * The connection handshake:\n * 1. Client opens EventSource (GET /events)\n * 2. Server calls `registerConnection(peerId)` → creates channel\n * 3. Client's EventSource.onopen fires → client sends establish-request (POST)\n * 4. Server receives establish-request → Synchronizer responds with establish-response (SSE)\n *\n * The server does NOT call `establishChannel()` — it waits for the client's\n * establish-request, which arrives via POST after the EventSource is open.\n */\nexport class SseServerTransport extends Transport<PeerId> {\n  #connections = new Map<PeerId, SseConnection>()\n  readonly #fragmentThreshold: number\n\n  constructor(options?: SseServerTransportOptions) {\n    super({ transportType: \"sse-server\" })\n    this.#fragmentThreshold =\n      options?.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD\n  }\n\n  // ==========================================================================\n  // Adapter abstract method implementations\n  // ==========================================================================\n\n  protected generate(peerId: PeerId): GeneratedChannel {\n    return {\n      transportType: this.transportType,\n      send: (msg: ChannelMsg) => {\n        const connection = this.#connections.get(peerId)\n        if (connection) {\n          connection.send(msg)\n        }\n      },\n      stop: () => {\n        this.unregisterConnection(peerId)\n      },\n    }\n  }\n\n  async onStart(): Promise<void> {\n    // Server adapter starts passively — connections arrive via registerConnection()\n  }\n\n  async onStop(): Promise<void> {\n    // Disconnect all active connections\n    for (const connection of this.#connections.values()) {\n      connection.disconnect()\n    }\n    this.#connections.clear()\n  }\n\n  // ==========================================================================\n  // Connection management\n  // ==========================================================================\n\n  /**\n   * Register a new peer connection.\n   *\n   * Call this from your framework's SSE endpoint handler when a client\n   * connects via EventSource. Returns an `SseConnection` that you wire\n   * up with `setSendFunction()` and `setDisconnectHandler()`.\n   *\n   * @param peerId The unique identifier for the peer (from query param or header)\n   * @returns An SseConnection object for managing the connection\n   *\n   * @example Express\n   * ```typescript\n   * const connection = serverAdapter.registerConnection(peerId)\n   * connection.setSendFunction((textFrame) => {\n   *   res.write(`data: ${textFrame}\\n\\n`)\n   * })\n   * ```\n   *\n   * @example Hono\n   * ```typescript\n   * const connection = serverAdapter.registerConnection(peerId)\n   * connection.setSendFunction((textFrame) => {\n   *   stream.writeSSE({ data: textFrame })\n   * })\n   * ```\n   */\n  registerConnection(peerId?: PeerId): SseConnection {\n    const resolvedPeerId = peerId ?? generatePeerId()\n\n    // Check for existing connection and clean it up\n    const existingConnection = this.#connections.get(resolvedPeerId)\n    if (existingConnection) {\n      existingConnection.dispose()\n      this.unregisterConnection(resolvedPeerId)\n    }\n\n    // Create channel for this peer\n    const channel = this.addChannel(resolvedPeerId)\n\n    // Create connection object with fragmentation config\n    const connection = new SseConnection(resolvedPeerId, channel.channelId, {\n      fragmentThreshold: this.#fragmentThreshold,\n    })\n    connection._setChannel(channel)\n\n    // Store connection\n    this.#connections.set(resolvedPeerId, connection)\n\n    return connection\n  }\n\n  /**\n   * Unregister a peer connection.\n   *\n   * Removes the channel, disposes the connection's reassembler,\n   * and cleans up tracking state. Called automatically when the\n   * client disconnects (via req.on(\"close\")) or manually.\n   *\n   * @param peerId The unique identifier for the peer\n   */\n  unregisterConnection(peerId: PeerId): void {\n    const connection = this.#connections.get(peerId)\n    if (connection) {\n      connection.dispose()\n      this.removeChannel(connection.channelId)\n      this.#connections.delete(peerId)\n    }\n  }\n\n  /**\n   * Get an active connection by peer ID.\n   */\n  getConnection(peerId: PeerId): SseConnection | undefined {\n    return this.#connections.get(peerId)\n  }\n\n  /**\n   * Get all active connections.\n   */\n  getAllConnections(): SseConnection[] {\n    return Array.from(this.#connections.values())\n  }\n\n  /**\n   * Check if a peer is connected.\n   */\n  isConnected(peerId: PeerId): boolean {\n    return this.#connections.has(peerId)\n  }\n\n  /**\n   * Get the number of connected peers.\n   */\n  get connectionCount(): number {\n    return this.#connections.size\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/server-transport-D9l5s5PV.d.ts

@@ -1,180 +0,0 @@
-import { PeerId, Channel, ChannelMsg, Transport, GeneratedChannel } from '@kyneta/transport';
-import { TextReassembler } from '@kyneta/wire';
-
-/**
- * Default fragment threshold in characters for outbound SSE messages.
- * 60K chars provides a safety margin below typical infrastructure limits.
- */
-declare const DEFAULT_FRAGMENT_THRESHOLD = 60000;
-/**
- * Configuration for creating an SseConnection.
- */
-interface SseConnectionConfig {
-    /**
-     * Fragment threshold in characters. Messages larger than this are fragmented.
-     * Set to 0 to disable fragmentation.
-     * Default: 60000 (60K chars)
-     */
-    fragmentThreshold?: number;
-}
-/**
- * Represents a single SSE connection to a peer (server-side).
- *
- * Manages encoding, framing, fragmentation, and reassembly for one
- * connected client. Created by `SseServerTransport.registerConnection()`.
- *
- * The connection uses the text codec for transport — this is the natural
- * choice for SSE's text-only protocol.
- */
-declare class SseConnection {
-    #private;
-    readonly peerId: PeerId;
-    readonly channelId: number;
-    /**
-     * Text reassembler for handling fragmented POST bodies.
-     * Each connection has its own reassembler to track in-flight fragment batches.
-     */
-    readonly reassembler: TextReassembler;
-    constructor(peerId: PeerId, channelId: number, config?: SseConnectionConfig);
-    /**
-     * Set the channel reference.
-     * Called by the adapter when the channel is created.
-     * @internal
-     */
-    _setChannel(channel: Channel): void;
-    /**
-     * Set the function to call when sending messages to this peer.
-     *
-     * The function receives a fully encoded text frame string.
-     * The framework integration just wraps it in SSE syntax:
-     * - Express: `res.write(\`data: \${textFrame}\\n\\n\`)`
-     * - Hono: `stream.writeSSE({ data: textFrame })`
-     *
-     * @param sendFn Function that writes a text frame string to the SSE stream
-     */
-    setSendFunction(sendFn: (textFrame: string) => void): void;
-    /**
-     * Set the function to call when this connection is disconnected.
-     */
-    setDisconnectHandler(handler: () => void): void;
-    /**
-     * Send a ChannelMsg to the peer through the SSE stream.
-     *
-     * Encodes via textCodec → text frame → fragment if needed → sendFn().
-     * Encoding and fragmentation are the connection's concern — the
-     * framework integration only needs to write strings.
-     */
-    send(msg: ChannelMsg): void;
-    /**
-     * Receive a message from the peer and route it to the channel.
-     *
-     * Called by the framework integration after parsing a POST body
-     * through `parseTextPostBody`.
-     */
-    receive(msg: ChannelMsg): void;
-    /**
-     * Disconnect this connection.
-     */
-    disconnect(): void;
-    /**
-     * Dispose of resources held by this connection.
-     * Must be called when the connection is closed to prevent timer leaks.
-     */
-    dispose(): void;
-}
-
-/**
- * Options for the SSE server adapter.
- */
-interface SseServerTransportOptions {
-    /**
-     * Fragment threshold in characters. Messages larger than this are fragmented
-     * into multiple SSE events.
-     * Set to 0 to disable fragmentation.
-     * Default: 60000 (60K chars)
-     */
-    fragmentThreshold?: number;
-}
-/**
- * SSE server network adapter.
- *
- * Framework-agnostic — works with any HTTP framework through the
- * `SseConnection.setSendFunction()` callback. Use `registerConnection()`
- * to integrate with your framework's SSE endpoint handler.
- *
- * Each client connection is tracked as an `SseConnection` keyed by peer ID.
- * The adapter creates a channel per connection and routes outbound messages
- * through the connection's send method (which encodes to text wire format
- * and calls the injected sendFn).
- *
- * The connection handshake:
- * 1. Client opens EventSource (GET /events)
- * 2. Server calls `registerConnection(peerId)` → creates channel
- * 3. Client's EventSource.onopen fires → client sends establish-request (POST)
- * 4. Server receives establish-request → Synchronizer responds with establish-response (SSE)
- *
- * The server does NOT call `establishChannel()` — it waits for the client's
- * establish-request, which arrives via POST after the EventSource is open.
- */
-declare class SseServerTransport extends Transport<PeerId> {
-    #private;
-    constructor(options?: SseServerTransportOptions);
-    protected generate(peerId: PeerId): GeneratedChannel;
-    onStart(): Promise<void>;
-    onStop(): Promise<void>;
-    /**
-     * Register a new peer connection.
-     *
-     * Call this from your framework's SSE endpoint handler when a client
-     * connects via EventSource. Returns an `SseConnection` that you wire
-     * up with `setSendFunction()` and `setDisconnectHandler()`.
-     *
-     * @param peerId The unique identifier for the peer (from query param or header)
-     * @returns An SseConnection object for managing the connection
-     *
-     * @example Express
-     * ```typescript
-     * const connection = serverAdapter.registerConnection(peerId)
-     * connection.setSendFunction((textFrame) => {
-     *   res.write(`data: ${textFrame}\n\n`)
-     * })
-     * ```
-     *
-     * @example Hono
-     * ```typescript
-     * const connection = serverAdapter.registerConnection(peerId)
-     * connection.setSendFunction((textFrame) => {
-     *   stream.writeSSE({ data: textFrame })
-     * })
-     * ```
-     */
-    registerConnection(peerId?: PeerId): SseConnection;
-    /**
-     * Unregister a peer connection.
-     *
-     * Removes the channel, disposes the connection's reassembler,
-     * and cleans up tracking state. Called automatically when the
-     * client disconnects (via req.on("close")) or manually.
-     *
-     * @param peerId The unique identifier for the peer
-     */
-    unregisterConnection(peerId: PeerId): void;
-    /**
-     * Get an active connection by peer ID.
-     */
-    getConnection(peerId: PeerId): SseConnection | undefined;
-    /**
-     * Get all active connections.
-     */
-    getAllConnections(): SseConnection[];
-    /**
-     * Check if a peer is connected.
-     */
-    isConnected(peerId: PeerId): boolean;
-    /**
-     * Get the number of connected peers.
-     */
-    get connectionCount(): number;
-}
-
-export { DEFAULT_FRAGMENT_THRESHOLD as D, SseConnection as S, type SseConnectionConfig as a, SseServerTransport as b, type SseServerTransportOptions as c };

package/dist/server.js.map

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

package/dist/types-DaVaqfwF.d.ts

@@ -1,82 +0,0 @@
-import { PeerId } from '@kyneta/transport';
-
-/**
- * Discriminated union describing why an SSE connection was lost.
- *
- * Unlike WebSocket's DisconnectReason, SSE does not have:
- * - `{ type: "closed"; code; reason }` — SSE has no close codes
- * - `{ type: "not-started" }` — SSE has no "ready" gate
- */
-type DisconnectReason = {
-    type: "intentional";
-} | {
-    type: "error";
-    error: Error;
-} | {
-    type: "max-retries-exceeded";
-    attempts: number;
-};
-/**
- * All possible states of the SSE client.
- *
- * State machine transitions (4 states, no "ready"):
- * ```
- * disconnected → connecting → connected
- *                    ↓            ↓
- *               reconnecting ← ─ ─┘
- *                    ↓
- *               connecting (retry)
- *                    ↓
- *               disconnected (max retries)
- * ```
- */
-type SseClientState = {
-    status: "disconnected";
-    reason?: DisconnectReason;
-} | {
-    status: "connecting";
-    attempt: number;
-} | {
-    status: "connected";
-} | {
-    status: "reconnecting";
-    attempt: number;
-    nextAttemptMs: number;
-};
-/**
- * Handle for an active SSE connection (server-side).
- */
-interface SseConnectionHandle {
-    /** The peer ID for this connection. */
-    readonly peerId: PeerId;
-    /** The channel ID for this connection. */
-    readonly channelId: number;
-    /** Disconnect this connection. */
-    disconnect(): void;
-}
-/**
- * Result of registering an SSE connection on the server.
- */
-interface SseConnectionResult {
-    /** The connection handle for managing this peer. */
-    connection: SseConnectionHandle;
-}
-/**
- * Lifecycle event callbacks for the SSE client.
- */
-interface SseClientLifecycleEvents {
-    /** Called on every state transition (delivered async via microtask). */
-    onStateChange?: (transition: {
-        from: SseClientState;
-        to: SseClientState;
-        timestamp: number;
-    }) => void;
-    /** Called when the connection is lost. */
-    onDisconnect?: (reason: DisconnectReason) => void;
-    /** Called when a reconnection attempt is scheduled. */
-    onReconnecting?: (attempt: number, nextAttemptMs: number) => void;
-    /** Called when reconnection succeeds after a previous connection. */
-    onReconnected?: () => void;
-}
-
-export type { DisconnectReason as D, SseConnectionHandle as S, SseConnectionResult as a, SseClientLifecycleEvents as b, SseClientState as c };