@kyneta/sse-transport 1.3.1 → 1.4.0

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client-transport.ts","../src/client-program.ts"],"sourcesContent":["// client-transport — SSE client transport for @kyneta/exchange.\n//\n// Thin imperative shell around the pure client program (client-program.ts).\n// The program produces data effects; this module interprets them as I/O.\n//\n// FC/IS design:\n// - client-program.ts: pure Mealy machine (functional core)\n// - client-transport.ts: effect executor (imperative shell)\n//\n// Uses two HTTP channels:\n// - EventSource (GET) for server→client messages\n// - fetch POST for client→server messages\n//\n// Both directions use the text wire format (textCodec + text framing).\n//\n// Features:\n// - Pure Mealy machine for connection lifecycle (client-program.ts)\n// - Exponential backoff reconnection with jitter\n// - POST retry with exponential backoff\n// - Text-level fragmentation for large payloads\n// - Inbound TextReassembler for fragmented SSE messages\n// - Observable connection state via subscribeToTransitions()\n//\n// The connection handshake:\n// 1. Client creates EventSource, waits for open\n// 2. EventSource.onopen fires → client creates channel + calls establishChannel()\n// 3. Synchronizer exchanges establish-request / establish-response via POST + SSE\n//\n// On EventSource.onerror, the adapter closes the EventSource immediately and\n// takes over reconnection via the program's backoff logic, rather than\n// letting the browser's built-in EventSource reconnection run.\n\nimport type {\n  ObservableHandle,\n  StateTransition,\n  TransitionListener,\n} from \"@kyneta/machine\"\nimport { createObservableProgram } from \"@kyneta/machine\"\nimport type {\n  Channel,\n  ChannelMsg,\n  GeneratedChannel,\n  PeerId,\n  TransportFactory,\n} from \"@kyneta/transport\"\nimport { Transport } from \"@kyneta/transport\"\nimport {\n  encodeTextComplete,\n  fragmentTextPayload,\n  TextReassembler,\n  textCodec,\n} from \"@kyneta/wire\"\nimport {\n  createSseClientProgram,\n  type SseClientEffect,\n  type SseClientMsg,\n} from \"./client-program.js\"\nimport type {\n  DisconnectReason,\n  SseClientLifecycleEvents,\n  SseClientState,\n} from \"./types.js\"\n\n// Re-export state types for convenience\nexport type { DisconnectReason, SseClientLifecycleEvents, SseClientState }\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/**\n * Default fragment threshold in characters.\n * 60K chars provides a safety margin below typical 100KB body-parser limits,\n * accounting for JSON overhead and potential base64 expansion.\n */\nexport const DEFAULT_FRAGMENT_THRESHOLD = 60_000\n\n/**\n * Options for the SSE client adapter.\n */\nexport interface SseClientOptions {\n  /** URL for POST requests (client→server). String or function of peerId. */\n  postUrl: string | ((peerId: PeerId) => string)\n\n  /** URL for SSE EventSource (server→client). String or function of peerId. */\n  eventSourceUrl: string | ((peerId: PeerId) => string)\n\n  /** Reconnection options for EventSource. */\n  reconnect?: {\n    enabled?: boolean\n    maxAttempts?: number\n    baseDelay?: number\n    maxDelay?: number\n  }\n\n  /** POST retry options. */\n  postRetry?: {\n    maxAttempts?: number\n    baseDelay?: number\n    maxDelay?: number\n  }\n\n  /** Fragment threshold in characters. Default: 60000 (60K chars). */\n  fragmentThreshold?: number\n\n  /** Lifecycle event callbacks. */\n  lifecycle?: SseClientLifecycleEvents\n}\n\n/**\n * Default POST retry options.\n */\nconst DEFAULT_POST_RETRY = {\n  maxAttempts: 3,\n  baseDelay: 1000,\n  maxDelay: 10000,\n}\n\n// ---------------------------------------------------------------------------\n// State transition type alias\n// ---------------------------------------------------------------------------\n\n/**\n * State transition event for SSE client states.\n */\nexport type SseClientStateTransition = StateTransition<SseClientState>\n\n// ---------------------------------------------------------------------------\n// SseClientTransport\n// ---------------------------------------------------------------------------\n\n/**\n * SSE client network adapter for @kyneta/exchange.\n *\n * Uses two HTTP channels:\n * - **EventSource** (GET, long-lived) for server→client messages\n * - **fetch POST** for client→server messages\n *\n * Both directions use the text wire format (`textCodec` + text framing).\n *\n * Internally, the connection lifecycle is a `Program<Msg, Model, Fx>` —\n * a pure Mealy machine whose transitions are deterministically testable.\n * This class is the imperative shell that interprets data effects as I/O.\n *\n * @example\n * ```typescript\n * import { createSseClient } from \"@kyneta/sse-transport/client\"\n *\n * const exchange = new Exchange({\n *   identity: { peerId: \"browser-client\" },\n *   transports: [createSseClient({\n *     postUrl: \"/sync\",\n *     eventSourceUrl: (peerId) => `/events?peerId=${peerId}`,\n *     reconnect: { enabled: true },\n *   })],\n * })\n * ```\n */\nexport class SseClientTransport extends Transport<void> {\n  #peerId?: PeerId\n  #options: SseClientOptions\n\n  // Observable program handle — created in onStart(), drives all state\n  #handle: ObservableHandle<SseClientMsg, SseClientState>\n\n  // Executor-local I/O state — not in the program model\n  #eventSource?: EventSource\n  #serverChannel?: Channel\n  #reconnectTimer?: ReturnType<typeof setTimeout>\n\n  // Fragmentation\n  readonly #fragmentThreshold: number\n\n  // Inbound reassembly for fragmented SSE messages from server\n  readonly #reassembler: TextReassembler\n\n  // POST retry\n  #currentRetryAbortController?: AbortController\n\n  constructor(options: SseClientOptions) {\n    super({ transportType: \"sse-client\" })\n    this.#options = options\n    this.#fragmentThreshold =\n      options.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD\n    this.#reassembler = new TextReassembler({\n      timeoutMs: 10_000,\n    })\n\n    // Create the program with a placeholder URL — the executor resolves the\n    // real eventSourceUrl (which may be a function of peerId) at effect time.\n    // The URL in the program is used only as a marker; the executor overrides it.\n    const program = createSseClientProgram({\n      url: \"__deferred__\",\n      reconnect: options.reconnect,\n    })\n\n    this.#handle = createObservableProgram(program, (effect, dispatch) => {\n      this.#executeEffect(effect, dispatch)\n    })\n\n    // Set up lifecycle event forwarding\n    this.#setupLifecycleEvents()\n  }\n\n  // ==========================================================================\n  // Lifecycle event forwarding\n  // ==========================================================================\n\n  /**\n   * Subscribe to the observable handle's transitions and forward them to\n   * the lifecycle callbacks. `wasConnectedBefore` is observer-local state,\n   * not in the program model.\n   */\n  #setupLifecycleEvents(): void {\n    let wasConnectedBefore = false\n\n    this.#handle.subscribeToTransitions(transition => {\n      // Forward to onStateChange callback\n      this.#options.lifecycle?.onStateChange?.(transition)\n\n      const { from, to } = transition\n\n      // onDisconnect: transitioning TO disconnected\n      if (to.status === \"disconnected\" && to.reason) {\n        this.#options.lifecycle?.onDisconnect?.(to.reason)\n      }\n\n      // onReconnecting: transitioning TO reconnecting\n      if (to.status === \"reconnecting\") {\n        this.#options.lifecycle?.onReconnecting?.(to.attempt, to.nextAttemptMs)\n      }\n\n      // onReconnected: from reconnecting/connecting TO connected (after prior connection)\n      if (\n        wasConnectedBefore &&\n        (from.status === \"reconnecting\" || from.status === \"connecting\") &&\n        to.status === \"connected\"\n      ) {\n        this.#options.lifecycle?.onReconnected?.()\n      }\n\n      // Track whether we've ever been connected\n      if (to.status === \"connected\") {\n        wasConnectedBefore = true\n      }\n\n      // Reset on intentional disconnect (stop)\n      if (to.status === \"disconnected\" && to.reason?.type === \"intentional\") {\n        wasConnectedBefore = false\n      }\n    })\n  }\n\n  // ==========================================================================\n  // Effect executor — interprets data effects as I/O\n  // ==========================================================================\n\n  #executeEffect(\n    effect: SseClientEffect,\n    dispatch: (msg: SseClientMsg) => void,\n  ): void {\n    switch (effect.type) {\n      case \"create-event-source\": {\n        this.#doCreateEventSource(dispatch)\n        break\n      }\n\n      case \"close-event-source\": {\n        if (this.#eventSource) {\n          this.#eventSource.onopen = null\n          this.#eventSource.onmessage = null\n          this.#eventSource.onerror = null\n          this.#eventSource.close()\n          this.#eventSource = undefined\n        }\n        break\n      }\n\n      case \"add-channel-and-establish\": {\n        // Remove any stale channel from a previous connection\n        if (this.#serverChannel) {\n          this.removeChannel(this.#serverChannel.channelId)\n          this.#serverChannel = undefined\n        }\n\n        this.#serverChannel = this.addChannel()\n\n        // No \"ready\" handshake — establish immediately\n        this.establishChannel(this.#serverChannel.channelId)\n        break\n      }\n\n      case \"remove-channel\": {\n        if (this.#serverChannel) {\n          this.removeChannel(this.#serverChannel.channelId)\n          this.#serverChannel = undefined\n        }\n        break\n      }\n\n      case \"start-reconnect-timer\": {\n        this.#reconnectTimer = setTimeout(() => {\n          this.#reconnectTimer = undefined\n          dispatch({ type: \"reconnect-timer-fired\" })\n        }, effect.delayMs)\n        break\n      }\n\n      case \"cancel-reconnect-timer\": {\n        if (this.#reconnectTimer !== undefined) {\n          clearTimeout(this.#reconnectTimer)\n          this.#reconnectTimer = undefined\n        }\n        break\n      }\n\n      case \"abort-pending-posts\": {\n        if (this.#currentRetryAbortController) {\n          this.#currentRetryAbortController.abort()\n          this.#currentRetryAbortController = undefined\n        }\n        break\n      }\n    }\n  }\n\n  /**\n   * Create an EventSource and wire up event handlers.\n   * The URL is resolved here (may be a function of peerId).\n   */\n  #doCreateEventSource(dispatch: (msg: SseClientMsg) => void): void {\n    if (!this.#peerId) {\n      throw new Error(\"Cannot connect: peerId not set\")\n    }\n\n    // Resolve URL — may be a string or function of peerId\n    const url =\n      typeof this.#options.eventSourceUrl === \"function\"\n        ? this.#options.eventSourceUrl(this.#peerId)\n        : this.#options.eventSourceUrl\n\n    try {\n      this.#eventSource = new EventSource(url)\n\n      this.#eventSource.onopen = () => {\n        dispatch({ type: \"event-source-opened\" })\n      }\n\n      this.#eventSource.onmessage = (event: MessageEvent) => {\n        this.#handleMessage(event)\n      }\n\n      this.#eventSource.onerror = () => {\n        dispatch({ type: \"event-source-error\" })\n      }\n    } catch (_error) {\n      // EventSource constructor threw (e.g. invalid URL) — treat as error\n      dispatch({ type: \"event-source-error\" })\n    }\n  }\n\n  // ==========================================================================\n  // State observation — delegated to the observable handle\n  // ==========================================================================\n\n  /**\n   * Get the current connection state.\n   */\n  getState(): SseClientState {\n    return this.#handle.getState()\n  }\n\n  /**\n   * Subscribe to state transitions.\n   */\n  subscribeToTransitions(\n    listener: TransitionListener<SseClientState>,\n  ): () => void {\n    return this.#handle.subscribeToTransitions(listener)\n  }\n\n  /**\n   * Wait for a specific state.\n   */\n  waitForState(\n    predicate: (state: SseClientState) => boolean,\n    options?: { timeoutMs?: number },\n  ): Promise<SseClientState> {\n    return this.#handle.waitForState(predicate, options)\n  }\n\n  /**\n   * Wait for a specific status.\n   */\n  waitForStatus(\n    status: SseClientState[\"status\"],\n    options?: { timeoutMs?: number },\n  ): Promise<SseClientState> {\n    return this.#handle.waitForStatus(status, options)\n  }\n\n  /**\n   * Whether the client is connected and ready to send/receive.\n   */\n  get isConnected(): boolean {\n    return this.#handle.getState().status === \"connected\"\n  }\n\n  // ==========================================================================\n  // Transport abstract method implementations\n  // ==========================================================================\n\n  protected generate(): GeneratedChannel {\n    return {\n      transportType: this.transportType,\n      send: (msg: ChannelMsg) => {\n        if (!this.#peerId) {\n          return\n        }\n\n        // Check if EventSource is closed before sending\n        // readyState: 0=CONNECTING, 1=OPEN, 2=CLOSED\n        if (!this.#eventSource || this.#eventSource.readyState === 2) {\n          return\n        }\n\n        // Resolve the postUrl with the peerId\n        const resolvedPostUrl =\n          typeof this.#options.postUrl === \"function\"\n            ? this.#options.postUrl(this.#peerId)\n            : this.#options.postUrl\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(\n            payload,\n            this.#fragmentThreshold,\n          )\n          for (const fragment of fragments) {\n            void this.#sendTextWithRetry(resolvedPostUrl, fragment)\n          }\n        } else {\n          void this.#sendTextWithRetry(resolvedPostUrl, textFrame)\n        }\n      },\n      stop: () => {\n        // Don't call disconnect here — channel.stop() is called when\n        // the channel is removed, which can happen during effect execution.\n        // The actual disconnect is handled by onStop() or the program.\n      },\n    }\n  }\n\n  async onStart(): Promise<void> {\n    if (!this.identity) {\n      throw new Error(\n        \"Adapter not properly initialized — identity not available\",\n      )\n    }\n    this.#peerId = this.identity.peerId\n    this.#handle.dispatch({ type: \"start\" })\n  }\n\n  async onStop(): Promise<void> {\n    this.#reassembler.dispose()\n    this.#handle.dispatch({ type: \"stop\" })\n  }\n\n  // ==========================================================================\n  // Inbound message handling\n  // ==========================================================================\n\n  /**\n   * Handle incoming SSE message.\n   *\n   * Each SSE `data:` event contains a text wire frame string.\n   * Feed it through the TextReassembler to handle both complete\n   * and fragmented frames.\n   */\n  #handleMessage(event: MessageEvent): void {\n    if (!this.#serverChannel) {\n      return\n    }\n\n    const data = event.data\n    if (typeof data !== \"string\") {\n      return\n    }\n\n    // Feed through reassembler (handles both complete and fragment frames)\n    const result = this.#reassembler.receive(data)\n\n    if (result.status === \"complete\") {\n      try {\n        // Two-step decode: Frame<string> → JSON.parse → textCodec.decode\n        const parsed = JSON.parse(result.frame.content.payload)\n        const messages = textCodec.decode(parsed)\n        for (const msg of messages) {\n          this.#serverChannel.onReceive(msg)\n        }\n      } catch (error) {\n        console.error(\"Failed to decode SSE message:\", error)\n      }\n    } else if (result.status === \"error\") {\n      console.error(\"SSE message reassembly error:\", result.error)\n    }\n    // \"pending\" status means we're waiting for more fragments — nothing to do\n  }\n\n  // ==========================================================================\n  // POST sending with retry\n  // ==========================================================================\n\n  /**\n   * Send a text frame via POST with retry logic.\n   */\n  async #sendTextWithRetry(url: string, textFrame: string): Promise<void> {\n    let attempt = 0\n    const postRetryOpts = {\n      ...DEFAULT_POST_RETRY,\n      ...this.#options.postRetry,\n    }\n    const { maxAttempts, baseDelay, maxDelay } = postRetryOpts\n\n    while (attempt < maxAttempts) {\n      try {\n        if (!this.#currentRetryAbortController) {\n          this.#currentRetryAbortController = new AbortController()\n        }\n\n        if (!this.#peerId) {\n          throw new Error(\"PeerId not available for retry\")\n        }\n\n        const response = await fetch(url, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"text/plain\",\n            \"X-Peer-Id\": this.#peerId,\n          },\n          body: textFrame,\n          signal: this.#currentRetryAbortController.signal,\n        })\n\n        if (!response.ok) {\n          // Don't retry on client errors (4xx)\n          if (response.status >= 400 && response.status < 500) {\n            throw new Error(`Failed to send message: ${response.statusText}`)\n          }\n          throw new Error(`Server error: ${response.statusText}`)\n        }\n\n        // Success\n        this.#currentRetryAbortController = undefined\n        return\n      } catch (error: unknown) {\n        attempt++\n\n        const err = error as Error\n\n        // If aborted, stop retrying\n        if (err.name === \"AbortError\") {\n          throw error\n        }\n\n        // If controller was cleared (e.g. by abort-pending-posts effect), stop retrying\n        if (!this.#currentRetryAbortController) {\n          const abortError = new Error(\"Retry aborted by connection reset\")\n          abortError.name = \"AbortError\"\n          throw abortError\n        }\n\n        // If max attempts reached, throw the last error\n        if (attempt >= maxAttempts) {\n          this.#currentRetryAbortController = undefined\n          throw error\n        }\n\n        // Calculate delay with exponential backoff and jitter\n        const delay = Math.min(\n          baseDelay * 2 ** (attempt - 1) + Math.random() * 100,\n          maxDelay,\n        )\n\n        // Wait for delay or abort signal\n        await new Promise<void>((resolve, reject) => {\n          if (this.#currentRetryAbortController?.signal.aborted) {\n            const error = new Error(\"Retry aborted\")\n            error.name = \"AbortError\"\n            reject(error)\n            return\n          }\n\n          const timer = setTimeout(() => {\n            cleanup()\n            resolve()\n          }, delay)\n\n          const onAbort = () => {\n            clearTimeout(timer)\n            cleanup()\n            const error = new Error(\"Retry aborted\")\n            error.name = \"AbortError\"\n            reject(error)\n          }\n\n          const cleanup = () => {\n            this.#currentRetryAbortController?.signal.removeEventListener(\n              \"abort\",\n              onAbort,\n            )\n          }\n\n          this.#currentRetryAbortController?.signal.addEventListener(\n            \"abort\",\n            onAbort,\n          )\n        })\n      }\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Create an SSE client adapter for browser-to-server connections.\n *\n * @example\n * ```typescript\n * import { createSseClient } from \"@kyneta/sse-transport/client\"\n *\n * const exchange = new Exchange({\n *   transports: [createSseClient({\n *     postUrl: \"/sync\",\n *     eventSourceUrl: (peerId) => `/events?peerId=${peerId}`,\n *     reconnect: { enabled: true },\n *   })],\n * })\n * ```\n */\nexport function createSseClient(options: SseClientOptions): TransportFactory {\n  return () => new SseClientTransport(options)\n}\n","// client-program — pure Mealy machine for SSE client connection lifecycle.\n//\n// The client program encodes every state transition and effect as data.\n// The imperative shell (client-transport.ts) interprets effects as I/O.\n// Tests assert on data — no EventSource, no timing, never flaky.\n//\n// Algebra: Program<SseClientMsg, SseClientState, SseClientEffect>\n// Interpreter: client-transport.ts executeClientEffect()\n\nimport type { Program } from \"@kyneta/machine\"\nimport type { ReconnectOptions } from \"@kyneta/transport\"\nimport { computeBackoffDelay, DEFAULT_RECONNECT } from \"@kyneta/transport\"\n\nimport type { DisconnectReason, SseClientState } from \"./types.js\"\n\n// ---------------------------------------------------------------------------\n// Messages\n// ---------------------------------------------------------------------------\n\nexport type SseClientMsg =\n  | { type: \"start\" }\n  | { type: \"event-source-opened\" }\n  | { type: \"event-source-error\" }\n  | { type: \"stop\" }\n  | { type: \"reconnect-timer-fired\" }\n\n// ---------------------------------------------------------------------------\n// Effects (data — interpreted by the imperative shell)\n// ---------------------------------------------------------------------------\n\nexport type SseClientEffect =\n  | { type: \"create-event-source\"; url: string; attempt: number }\n  | { type: \"close-event-source\" }\n  | { type: \"add-channel-and-establish\" }\n  | { type: \"remove-channel\" }\n  | { type: \"start-reconnect-timer\"; delayMs: number }\n  | { type: \"cancel-reconnect-timer\" }\n  | { type: \"abort-pending-posts\" }\n\n// ---------------------------------------------------------------------------\n// Program factory\n// ---------------------------------------------------------------------------\n\nexport interface SseClientProgramOptions {\n  url: string\n  reconnect?: Partial<ReconnectOptions>\n  /** Inject jitter source for deterministic testing. Default: () => Math.random() * 1000 */\n  jitterFn?: () => number\n}\n\n/**\n * Create the SSE client connection lifecycle program — a pure Mealy machine.\n *\n * The returned `Program<SseClientMsg, SseClientState, SseClientEffect>`\n * encodes every state transition and effect as inspectable data. The imperative\n * shell interprets `SseClientEffect` as actual I/O.\n */\nexport function createSseClientProgram(\n  options: SseClientProgramOptions,\n): Program<SseClientMsg, SseClientState, SseClientEffect> {\n  const { url, jitterFn = () => Math.random() * 1000 } = options\n  const reconnect: ReconnectOptions = {\n    ...DEFAULT_RECONNECT,\n    ...options.reconnect,\n  }\n\n  /**\n   * Attempt to transition into reconnecting, or give up and disconnect.\n   *\n   * Pure — computes the next state and effects from the current attempt\n   * count and reconnect configuration. Returns a tuple suitable for\n   * spreading into an `update` return.\n   */\n  function tryReconnect(\n    currentAttempt: number,\n    reason: DisconnectReason,\n    ...extraEffects: SseClientEffect[]\n  ): [SseClientState, ...SseClientEffect[]] {\n    if (!reconnect.enabled) {\n      return [{ status: \"disconnected\", reason }, ...extraEffects]\n    }\n\n    if (currentAttempt >= reconnect.maxAttempts) {\n      return [\n        {\n          status: \"disconnected\",\n          reason: { type: \"max-retries-exceeded\", attempts: currentAttempt },\n        },\n        ...extraEffects,\n      ]\n    }\n\n    const delay = computeBackoffDelay(\n      currentAttempt + 1,\n      reconnect.baseDelay,\n      reconnect.maxDelay,\n      jitterFn(),\n    )\n\n    return [\n      {\n        status: \"reconnecting\",\n        attempt: currentAttempt + 1,\n        nextAttemptMs: delay,\n      },\n      ...extraEffects,\n      { type: \"start-reconnect-timer\", delayMs: delay },\n    ]\n  }\n\n  return {\n    init: [{ status: \"disconnected\" }],\n\n    update(msg, model): [SseClientState, ...SseClientEffect[]] {\n      switch (msg.type) {\n        // -----------------------------------------------------------------\n        // start\n        // -----------------------------------------------------------------\n        case \"start\": {\n          if (model.status !== \"disconnected\") return [model]\n          return [\n            { status: \"connecting\", attempt: 1 },\n            { type: \"create-event-source\", url, attempt: 1 },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // event-source-opened\n        // -----------------------------------------------------------------\n        case \"event-source-opened\": {\n          if (model.status !== \"connecting\") return [model]\n          return [\n            { status: \"connected\" },\n            { type: \"add-channel-and-establish\" },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // event-source-error\n        // -----------------------------------------------------------------\n        case \"event-source-error\": {\n          const reason: DisconnectReason = {\n            type: \"error\",\n            error: new Error(\"EventSource connection error\"),\n          }\n\n          if (model.status === \"connecting\") {\n            return tryReconnect(model.attempt, reason, {\n              type: \"close-event-source\",\n            })\n          }\n\n          if (model.status === \"connected\") {\n            return tryReconnect(\n              0,\n              reason,\n              { type: \"remove-channel\" },\n              { type: \"close-event-source\" },\n              { type: \"abort-pending-posts\" },\n            )\n          }\n\n          return [model]\n        }\n\n        // -----------------------------------------------------------------\n        // reconnect-timer-fired\n        // -----------------------------------------------------------------\n        case \"reconnect-timer-fired\": {\n          if (model.status !== \"reconnecting\") return [model]\n          return [\n            { status: \"connecting\", attempt: model.attempt },\n            { type: \"create-event-source\", url, attempt: model.attempt },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // stop\n        // -----------------------------------------------------------------\n        case \"stop\": {\n          if (model.status === \"disconnected\") return [model]\n\n          const effects: SseClientEffect[] = [\n            { type: \"cancel-reconnect-timer\" },\n          ]\n\n          if (model.status === \"connecting\") {\n            effects.push({ type: \"close-event-source\" })\n          }\n\n          if (model.status === \"connected\") {\n            effects.push(\n              { type: \"close-event-source\" },\n              { type: \"remove-channel\" },\n              { type: \"abort-pending-posts\" },\n            )\n          }\n\n          return [\n            { status: \"disconnected\", reason: { type: \"intentional\" } },\n            ...effects,\n          ]\n        }\n      }\n    },\n  }\n}\n"],"mappings":"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","names":["error"]}
+{"version":3,"file":"client.js","names":["#fragmentThreshold","#reassembler","#options","#handle","#executeEffect","#setupLifecycleEvents","#doCreateEventSource","#eventSource","#serverChannel","#reconnectTimer","#currentRetryAbortController","#peerId","#handleMessage","#sendTextWithRetry"],"sources":["../src/client-program.ts","../src/client-transport.ts"],"sourcesContent":["// client-program — pure Mealy machine for SSE client connection lifecycle.\n//\n// The client program encodes every state transition and effect as data.\n// The imperative shell (client-transport.ts) interprets effects as I/O.\n// Tests assert on data — no EventSource, no timing, never flaky.\n//\n// Algebra: Program<SseClientMsg, SseClientState, SseClientEffect>\n// Interpreter: client-transport.ts executeClientEffect()\n\nimport type { Program } from \"@kyneta/machine\"\nimport type { ReconnectOptions } from \"@kyneta/transport\"\nimport { computeBackoffDelay, DEFAULT_RECONNECT } from \"@kyneta/transport\"\n\nimport type { DisconnectReason, SseClientState } from \"./types.js\"\n\n// ---------------------------------------------------------------------------\n// Messages\n// ---------------------------------------------------------------------------\n\nexport type SseClientMsg =\n  | { type: \"start\" }\n  | { type: \"event-source-opened\" }\n  | { type: \"event-source-error\" }\n  | { type: \"stop\" }\n  | { type: \"reconnect-timer-fired\" }\n\n// ---------------------------------------------------------------------------\n// Effects (data — interpreted by the imperative shell)\n// ---------------------------------------------------------------------------\n\nexport type SseClientEffect =\n  | { type: \"create-event-source\"; url: string; attempt: number }\n  | { type: \"close-event-source\" }\n  | { type: \"add-channel-and-establish\" }\n  | { type: \"remove-channel\" }\n  | { type: \"start-reconnect-timer\"; delayMs: number }\n  | { type: \"cancel-reconnect-timer\" }\n  | { type: \"abort-pending-posts\" }\n\n// ---------------------------------------------------------------------------\n// Program factory\n// ---------------------------------------------------------------------------\n\nexport interface SseClientProgramOptions {\n  url: string\n  reconnect?: Partial<ReconnectOptions>\n  /** Inject jitter source for deterministic testing. Default: () => Math.random() * 1000 */\n  jitterFn?: () => number\n}\n\n/**\n * Create the SSE client connection lifecycle program — a pure Mealy machine.\n *\n * The returned `Program<SseClientMsg, SseClientState, SseClientEffect>`\n * encodes every state transition and effect as inspectable data. The imperative\n * shell interprets `SseClientEffect` as actual I/O.\n */\nexport function createSseClientProgram(\n  options: SseClientProgramOptions,\n): Program<SseClientMsg, SseClientState, SseClientEffect> {\n  const { url, jitterFn = () => Math.random() * 1000 } = options\n  const reconnect: ReconnectOptions = {\n    ...DEFAULT_RECONNECT,\n    ...options.reconnect,\n  }\n\n  /**\n   * Attempt to transition into reconnecting, or give up and disconnect.\n   *\n   * Pure — computes the next state and effects from the current attempt\n   * count and reconnect configuration. Returns a tuple suitable for\n   * spreading into an `update` return.\n   */\n  function tryReconnect(\n    currentAttempt: number,\n    reason: DisconnectReason,\n    ...extraEffects: SseClientEffect[]\n  ): [SseClientState, ...SseClientEffect[]] {\n    if (!reconnect.enabled) {\n      return [{ status: \"disconnected\", reason }, ...extraEffects]\n    }\n\n    if (currentAttempt >= reconnect.maxAttempts) {\n      return [\n        {\n          status: \"disconnected\",\n          reason: { type: \"max-retries-exceeded\", attempts: currentAttempt },\n        },\n        ...extraEffects,\n      ]\n    }\n\n    const delay = computeBackoffDelay(\n      currentAttempt + 1,\n      reconnect.baseDelay,\n      reconnect.maxDelay,\n      jitterFn(),\n    )\n\n    return [\n      {\n        status: \"reconnecting\",\n        attempt: currentAttempt + 1,\n        nextAttemptMs: delay,\n      },\n      ...extraEffects,\n      { type: \"start-reconnect-timer\", delayMs: delay },\n    ]\n  }\n\n  return {\n    init: [{ status: \"disconnected\" }],\n\n    update(msg, model): [SseClientState, ...SseClientEffect[]] {\n      switch (msg.type) {\n        // -----------------------------------------------------------------\n        // start\n        // -----------------------------------------------------------------\n        case \"start\": {\n          if (model.status !== \"disconnected\") return [model]\n          return [\n            { status: \"connecting\", attempt: 1 },\n            { type: \"create-event-source\", url, attempt: 1 },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // event-source-opened\n        // -----------------------------------------------------------------\n        case \"event-source-opened\": {\n          if (model.status !== \"connecting\") return [model]\n          return [\n            { status: \"connected\" },\n            { type: \"add-channel-and-establish\" },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // event-source-error\n        // -----------------------------------------------------------------\n        case \"event-source-error\": {\n          const reason: DisconnectReason = {\n            type: \"error\",\n            error: new Error(\"EventSource connection error\"),\n          }\n\n          if (model.status === \"connecting\") {\n            return tryReconnect(model.attempt, reason, {\n              type: \"close-event-source\",\n            })\n          }\n\n          if (model.status === \"connected\") {\n            return tryReconnect(\n              0,\n              reason,\n              { type: \"remove-channel\" },\n              { type: \"close-event-source\" },\n              { type: \"abort-pending-posts\" },\n            )\n          }\n\n          return [model]\n        }\n\n        // -----------------------------------------------------------------\n        // reconnect-timer-fired\n        // -----------------------------------------------------------------\n        case \"reconnect-timer-fired\": {\n          if (model.status !== \"reconnecting\") return [model]\n          return [\n            { status: \"connecting\", attempt: model.attempt },\n            { type: \"create-event-source\", url, attempt: model.attempt },\n          ]\n        }\n\n        // -----------------------------------------------------------------\n        // stop\n        // -----------------------------------------------------------------\n        case \"stop\": {\n          if (model.status === \"disconnected\") return [model]\n\n          const effects: SseClientEffect[] = [\n            { type: \"cancel-reconnect-timer\" },\n          ]\n\n          if (model.status === \"connecting\") {\n            effects.push({ type: \"close-event-source\" })\n          }\n\n          if (model.status === \"connected\") {\n            effects.push(\n              { type: \"close-event-source\" },\n              { type: \"remove-channel\" },\n              { type: \"abort-pending-posts\" },\n            )\n          }\n\n          return [\n            { status: \"disconnected\", reason: { type: \"intentional\" } },\n            ...effects,\n          ]\n        }\n      }\n    },\n  }\n}\n","// client-transport — SSE client transport for @kyneta/exchange.\n//\n// Thin imperative shell around the pure client program (client-program.ts).\n// The program produces data effects; this module interprets them as I/O.\n//\n// FC/IS design:\n// - client-program.ts: pure Mealy machine (functional core)\n// - client-transport.ts: effect executor (imperative shell)\n//\n// Uses two HTTP channels:\n// - EventSource (GET) for server→client messages\n// - fetch POST for client→server messages\n//\n// Both directions use the text wire format (textCodec + text framing).\n//\n// Features:\n// - Pure Mealy machine for connection lifecycle (client-program.ts)\n// - Exponential backoff reconnection with jitter\n// - POST retry with exponential backoff\n// - Text-level fragmentation for large payloads\n// - Inbound TextReassembler for fragmented SSE messages\n// - Observable connection state via subscribeToTransitions()\n//\n// The connection handshake:\n// 1. Client creates EventSource, waits for open\n// 2. EventSource.onopen fires → client creates channel + calls establishChannel()\n// 3. Synchronizer exchanges establish messages via POST + SSE\n//\n// On EventSource.onerror, the adapter closes the EventSource immediately and\n// takes over reconnection via the program's backoff logic, rather than\n// letting the browser's built-in EventSource reconnection run.\n\nimport type {\n  ObservableHandle,\n  StateTransition,\n  TransitionListener,\n} from \"@kyneta/machine\"\nimport { createObservableProgram } from \"@kyneta/machine\"\nimport type {\n  Channel,\n  ChannelMsg,\n  GeneratedChannel,\n  PeerId,\n  TransportFactory,\n} from \"@kyneta/transport\"\nimport { Transport } from \"@kyneta/transport\"\nimport {\n  encodeTextComplete,\n  fragmentTextPayload,\n  TextReassembler,\n  textCodec,\n} from \"@kyneta/wire\"\nimport {\n  createSseClientProgram,\n  type SseClientEffect,\n  type SseClientMsg,\n} from \"./client-program.js\"\nimport type {\n  DisconnectReason,\n  SseClientLifecycleEvents,\n  SseClientState,\n} from \"./types.js\"\n\n// Re-export state types for convenience\nexport type { DisconnectReason, SseClientLifecycleEvents, SseClientState }\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/**\n * Default fragment threshold in characters.\n * 60K chars provides a safety margin below typical 100KB body-parser limits,\n * accounting for JSON overhead and potential base64 expansion.\n */\nexport const DEFAULT_FRAGMENT_THRESHOLD = 60_000\n\n/**\n * Options for the SSE client adapter.\n */\nexport interface SseClientOptions {\n  /** URL for POST requests (client→server). String or function of peerId. */\n  postUrl: string | ((peerId: PeerId) => string)\n\n  /** URL for SSE EventSource (server→client). String or function of peerId. */\n  eventSourceUrl: string | ((peerId: PeerId) => string)\n\n  /** Reconnection options for EventSource. */\n  reconnect?: {\n    enabled?: boolean\n    maxAttempts?: number\n    baseDelay?: number\n    maxDelay?: number\n  }\n\n  /** POST retry options. */\n  postRetry?: {\n    maxAttempts?: number\n    baseDelay?: number\n    maxDelay?: number\n  }\n\n  /** Fragment threshold in characters. Default: 60000 (60K chars). */\n  fragmentThreshold?: number\n\n  /** Lifecycle event callbacks. */\n  lifecycle?: SseClientLifecycleEvents\n}\n\n/**\n * Default POST retry options.\n */\nconst DEFAULT_POST_RETRY = {\n  maxAttempts: 3,\n  baseDelay: 1000,\n  maxDelay: 10000,\n}\n\n// ---------------------------------------------------------------------------\n// State transition type alias\n// ---------------------------------------------------------------------------\n\n/**\n * State transition event for SSE client states.\n */\nexport type SseClientStateTransition = StateTransition<SseClientState>\n\n// ---------------------------------------------------------------------------\n// SseClientTransport\n// ---------------------------------------------------------------------------\n\n/**\n * SSE client network adapter for @kyneta/exchange.\n *\n * Uses two HTTP channels:\n * - **EventSource** (GET, long-lived) for server→client messages\n * - **fetch POST** for client→server messages\n *\n * Both directions use the text wire format (`textCodec` + text framing).\n *\n * Internally, the connection lifecycle is a `Program<Msg, Model, Fx>` —\n * a pure Mealy machine whose transitions are deterministically testable.\n * This class is the imperative shell that interprets data effects as I/O.\n *\n * @example\n * ```typescript\n * import { createSseClient } from \"@kyneta/sse-transport/client\"\n *\n * const exchange = new Exchange({\n *   id: \"browser-client\",\n *   transports: [createSseClient({\n *     postUrl: \"/sync\",\n *     eventSourceUrl: (peerId) => `/events?peerId=${peerId}`,\n *     reconnect: { enabled: true },\n *   })],\n * })\n * ```\n */\nexport class SseClientTransport extends Transport<void> {\n  #peerId?: PeerId\n  #options: SseClientOptions\n\n  // Observable program handle — created in onStart(), drives all state\n  #handle: ObservableHandle<SseClientMsg, SseClientState>\n\n  // Executor-local I/O state — not in the program model\n  #eventSource?: EventSource\n  #serverChannel?: Channel\n  #reconnectTimer?: ReturnType<typeof setTimeout>\n\n  // Fragmentation\n  readonly #fragmentThreshold: number\n\n  // Inbound reassembly for fragmented SSE messages from server\n  readonly #reassembler: TextReassembler\n\n  // POST retry\n  #currentRetryAbortController?: AbortController\n\n  constructor(options: SseClientOptions) {\n    super({ transportType: \"sse-client\" })\n    this.#options = options\n    this.#fragmentThreshold =\n      options.fragmentThreshold ?? DEFAULT_FRAGMENT_THRESHOLD\n    this.#reassembler = new TextReassembler({\n      timeoutMs: 10_000,\n    })\n\n    // Create the program with a placeholder URL — the executor resolves the\n    // real eventSourceUrl (which may be a function of peerId) at effect time.\n    // The URL in the program is used only as a marker; the executor overrides it.\n    const program = createSseClientProgram({\n      url: \"__deferred__\",\n      reconnect: options.reconnect,\n    })\n\n    this.#handle = createObservableProgram(program, (effect, dispatch) => {\n      this.#executeEffect(effect, dispatch)\n    })\n\n    // Set up lifecycle event forwarding\n    this.#setupLifecycleEvents()\n  }\n\n  // ==========================================================================\n  // Lifecycle event forwarding\n  // ==========================================================================\n\n  /**\n   * Subscribe to the observable handle's transitions and forward them to\n   * the lifecycle callbacks. `wasConnectedBefore` is observer-local state,\n   * not in the program model.\n   */\n  #setupLifecycleEvents(): void {\n    let wasConnectedBefore = false\n\n    this.#handle.subscribeToTransitions(transition => {\n      // Forward to onStateChange callback\n      this.#options.lifecycle?.onStateChange?.(transition)\n\n      const { from, to } = transition\n\n      // onDisconnect: transitioning TO disconnected\n      if (to.status === \"disconnected\" && to.reason) {\n        this.#options.lifecycle?.onDisconnect?.(to.reason)\n      }\n\n      // onReconnecting: transitioning TO reconnecting\n      if (to.status === \"reconnecting\") {\n        this.#options.lifecycle?.onReconnecting?.(to.attempt, to.nextAttemptMs)\n      }\n\n      // onReconnected: from reconnecting/connecting TO connected (after prior connection)\n      if (\n        wasConnectedBefore &&\n        (from.status === \"reconnecting\" || from.status === \"connecting\") &&\n        to.status === \"connected\"\n      ) {\n        this.#options.lifecycle?.onReconnected?.()\n      }\n\n      // Track whether we've ever been connected\n      if (to.status === \"connected\") {\n        wasConnectedBefore = true\n      }\n\n      // Reset on intentional disconnect (stop)\n      if (to.status === \"disconnected\" && to.reason?.type === \"intentional\") {\n        wasConnectedBefore = false\n      }\n    })\n  }\n\n  // ==========================================================================\n  // Effect executor — interprets data effects as I/O\n  // ==========================================================================\n\n  #executeEffect(\n    effect: SseClientEffect,\n    dispatch: (msg: SseClientMsg) => void,\n  ): void {\n    switch (effect.type) {\n      case \"create-event-source\": {\n        this.#doCreateEventSource(dispatch)\n        break\n      }\n\n      case \"close-event-source\": {\n        if (this.#eventSource) {\n          this.#eventSource.onopen = null\n          this.#eventSource.onmessage = null\n          this.#eventSource.onerror = null\n          this.#eventSource.close()\n          this.#eventSource = undefined\n        }\n        break\n      }\n\n      case \"add-channel-and-establish\": {\n        // Remove any stale channel from a previous connection\n        if (this.#serverChannel) {\n          this.removeChannel(this.#serverChannel.channelId)\n          this.#serverChannel = undefined\n        }\n\n        this.#serverChannel = this.addChannel()\n\n        // No \"ready\" handshake — establish immediately\n        this.establishChannel(this.#serverChannel.channelId)\n        break\n      }\n\n      case \"remove-channel\": {\n        if (this.#serverChannel) {\n          this.removeChannel(this.#serverChannel.channelId)\n          this.#serverChannel = undefined\n        }\n        break\n      }\n\n      case \"start-reconnect-timer\": {\n        this.#reconnectTimer = setTimeout(() => {\n          this.#reconnectTimer = undefined\n          dispatch({ type: \"reconnect-timer-fired\" })\n        }, effect.delayMs)\n        break\n      }\n\n      case \"cancel-reconnect-timer\": {\n        if (this.#reconnectTimer !== undefined) {\n          clearTimeout(this.#reconnectTimer)\n          this.#reconnectTimer = undefined\n        }\n        break\n      }\n\n      case \"abort-pending-posts\": {\n        if (this.#currentRetryAbortController) {\n          this.#currentRetryAbortController.abort()\n          this.#currentRetryAbortController = undefined\n        }\n        break\n      }\n    }\n  }\n\n  /**\n   * Create an EventSource and wire up event handlers.\n   * The URL is resolved here (may be a function of peerId).\n   */\n  #doCreateEventSource(dispatch: (msg: SseClientMsg) => void): void {\n    if (!this.#peerId) {\n      throw new Error(\"Cannot connect: peerId not set\")\n    }\n\n    // Resolve URL — may be a string or function of peerId\n    const url =\n      typeof this.#options.eventSourceUrl === \"function\"\n        ? this.#options.eventSourceUrl(this.#peerId)\n        : this.#options.eventSourceUrl\n\n    try {\n      this.#eventSource = new EventSource(url)\n\n      this.#eventSource.onopen = () => {\n        dispatch({ type: \"event-source-opened\" })\n      }\n\n      this.#eventSource.onmessage = (event: MessageEvent) => {\n        this.#handleMessage(event)\n      }\n\n      this.#eventSource.onerror = () => {\n        dispatch({ type: \"event-source-error\" })\n      }\n    } catch (_error) {\n      // EventSource constructor threw (e.g. invalid URL) — treat as error\n      dispatch({ type: \"event-source-error\" })\n    }\n  }\n\n  // ==========================================================================\n  // State observation — delegated to the observable handle\n  // ==========================================================================\n\n  /**\n   * Get the current connection state.\n   */\n  getState(): SseClientState {\n    return this.#handle.getState()\n  }\n\n  /**\n   * Subscribe to state transitions.\n   */\n  subscribeToTransitions(\n    listener: TransitionListener<SseClientState>,\n  ): () => void {\n    return this.#handle.subscribeToTransitions(listener)\n  }\n\n  /**\n   * Wait for a specific state.\n   */\n  waitForState(\n    predicate: (state: SseClientState) => boolean,\n    options?: { timeoutMs?: number },\n  ): Promise<SseClientState> {\n    return this.#handle.waitForState(predicate, options)\n  }\n\n  /**\n   * Wait for a specific status.\n   */\n  waitForStatus(\n    status: SseClientState[\"status\"],\n    options?: { timeoutMs?: number },\n  ): Promise<SseClientState> {\n    return this.#handle.waitForStatus(status, options)\n  }\n\n  /**\n   * Whether the client is connected and ready to send/receive.\n   */\n  get isConnected(): boolean {\n    return this.#handle.getState().status === \"connected\"\n  }\n\n  // ==========================================================================\n  // Transport abstract method implementations\n  // ==========================================================================\n\n  protected generate(): GeneratedChannel {\n    return {\n      transportType: this.transportType,\n      send: (msg: ChannelMsg) => {\n        if (!this.#peerId) {\n          return\n        }\n\n        // Check if EventSource is closed before sending\n        // readyState: 0=CONNECTING, 1=OPEN, 2=CLOSED\n        if (!this.#eventSource || this.#eventSource.readyState === 2) {\n          return\n        }\n\n        // Resolve the postUrl with the peerId\n        const resolvedPostUrl =\n          typeof this.#options.postUrl === \"function\"\n            ? this.#options.postUrl(this.#peerId)\n            : this.#options.postUrl\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(\n            payload,\n            this.#fragmentThreshold,\n          )\n          for (const fragment of fragments) {\n            void this.#sendTextWithRetry(resolvedPostUrl, fragment)\n          }\n        } else {\n          void this.#sendTextWithRetry(resolvedPostUrl, textFrame)\n        }\n      },\n      stop: () => {\n        // Don't call disconnect here — channel.stop() is called when\n        // the channel is removed, which can happen during effect execution.\n        // The actual disconnect is handled by onStop() or the program.\n      },\n    }\n  }\n\n  async onStart(): Promise<void> {\n    if (!this.identity) {\n      throw new Error(\n        \"Adapter not properly initialized — identity not available\",\n      )\n    }\n    this.#peerId = this.identity.peerId\n    this.#handle.dispatch({ type: \"start\" })\n  }\n\n  async onStop(): Promise<void> {\n    this.#reassembler.dispose()\n    this.#handle.dispatch({ type: \"stop\" })\n  }\n\n  // ==========================================================================\n  // Inbound message handling\n  // ==========================================================================\n\n  /**\n   * Handle incoming SSE message.\n   *\n   * Each SSE `data:` event contains a text wire frame string.\n   * Feed it through the TextReassembler to handle both complete\n   * and fragmented frames.\n   */\n  #handleMessage(event: MessageEvent): void {\n    if (!this.#serverChannel) {\n      return\n    }\n\n    const data = event.data\n    if (typeof data !== \"string\") {\n      return\n    }\n\n    // Feed through reassembler (handles both complete and fragment frames)\n    const result = this.#reassembler.receive(data)\n\n    if (result.status === \"complete\") {\n      try {\n        // Two-step decode: Frame<string> → JSON.parse → textCodec.decode\n        const parsed = JSON.parse(result.frame.content.payload)\n        const messages = textCodec.decode(parsed)\n        for (const msg of messages) {\n          this.#serverChannel.onReceive(msg)\n        }\n      } catch (error) {\n        console.error(\"Failed to decode SSE message:\", error)\n      }\n    } else if (result.status === \"error\") {\n      console.error(\"SSE message reassembly error:\", result.error)\n    }\n    // \"pending\" status means we're waiting for more fragments — nothing to do\n  }\n\n  // ==========================================================================\n  // POST sending with retry\n  // ==========================================================================\n\n  /**\n   * Send a text frame via POST with retry logic.\n   */\n  async #sendTextWithRetry(url: string, textFrame: string): Promise<void> {\n    let attempt = 0\n    const postRetryOpts = {\n      ...DEFAULT_POST_RETRY,\n      ...this.#options.postRetry,\n    }\n    const { maxAttempts, baseDelay, maxDelay } = postRetryOpts\n\n    while (attempt < maxAttempts) {\n      try {\n        if (!this.#currentRetryAbortController) {\n          this.#currentRetryAbortController = new AbortController()\n        }\n\n        if (!this.#peerId) {\n          throw new Error(\"PeerId not available for retry\")\n        }\n\n        const response = await fetch(url, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"text/plain\",\n            \"X-Peer-Id\": this.#peerId,\n          },\n          body: textFrame,\n          signal: this.#currentRetryAbortController.signal,\n        })\n\n        if (!response.ok) {\n          // Don't retry on client errors (4xx)\n          if (response.status >= 400 && response.status < 500) {\n            throw new Error(`Failed to send message: ${response.statusText}`)\n          }\n          throw new Error(`Server error: ${response.statusText}`)\n        }\n\n        // Success\n        this.#currentRetryAbortController = undefined\n        return\n      } catch (error: unknown) {\n        attempt++\n\n        const err = error as Error\n\n        // If aborted, stop retrying\n        if (err.name === \"AbortError\") {\n          throw error\n        }\n\n        // If controller was cleared (e.g. by abort-pending-posts effect), stop retrying\n        if (!this.#currentRetryAbortController) {\n          const abortError = new Error(\"Retry aborted by connection reset\")\n          abortError.name = \"AbortError\"\n          throw abortError\n        }\n\n        // If max attempts reached, throw the last error\n        if (attempt >= maxAttempts) {\n          this.#currentRetryAbortController = undefined\n          throw error\n        }\n\n        // Calculate delay with exponential backoff and jitter\n        const delay = Math.min(\n          baseDelay * 2 ** (attempt - 1) + Math.random() * 100,\n          maxDelay,\n        )\n\n        // Wait for delay or abort signal\n        await new Promise<void>((resolve, reject) => {\n          if (this.#currentRetryAbortController?.signal.aborted) {\n            const error = new Error(\"Retry aborted\")\n            error.name = \"AbortError\"\n            reject(error)\n            return\n          }\n\n          const timer = setTimeout(() => {\n            cleanup()\n            resolve()\n          }, delay)\n\n          const onAbort = () => {\n            clearTimeout(timer)\n            cleanup()\n            const error = new Error(\"Retry aborted\")\n            error.name = \"AbortError\"\n            reject(error)\n          }\n\n          const cleanup = () => {\n            this.#currentRetryAbortController?.signal.removeEventListener(\n              \"abort\",\n              onAbort,\n            )\n          }\n\n          this.#currentRetryAbortController?.signal.addEventListener(\n            \"abort\",\n            onAbort,\n          )\n        })\n      }\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Create an SSE client adapter for browser-to-server connections.\n *\n * @example\n * ```typescript\n * import { createSseClient } from \"@kyneta/sse-transport/client\"\n *\n * const exchange = new Exchange({\n *   transports: [createSseClient({\n *     postUrl: \"/sync\",\n *     eventSourceUrl: (peerId) => `/events?peerId=${peerId}`,\n *     reconnect: { enabled: true },\n *   })],\n * })\n * ```\n */\nexport function createSseClient(options: SseClientOptions): TransportFactory {\n  return () => new SseClientTransport(options)\n}\n"],"mappings":"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"}

package/dist/express.d.ts

@@ -1,34 +1,35 @@
-import { PeerId, ChannelMsg } from '@kyneta/transport';
-import { Request, Router } from 'express';
-import { b as SseServerTransport } from './server-transport-D9l5s5PV.js';
-import { TextReassembler } from '@kyneta/wire';
+import { t as SseServerTransport } from "./server-transport-C0bHmtVV.js";
+import { ChannelMsg, PeerId } from "@kyneta/transport";
+import { TextReassembler } from "@kyneta/wire";
+import { Request, Router } from "express";
 
+//#region src/express-router.d.ts
 interface SseExpressRouterOptions {
-    /**
-     * Path for the sync endpoint where clients POST messages.
-     * @default "/sync"
-     */
-    syncPath?: string;
-    /**
-     * Path for the events endpoint where clients connect via SSE.
-     * @default "/events"
-     */
-    eventsPath?: string;
-    /**
-     * Interval in milliseconds for sending heartbeat comments to keep connections alive.
-     * @default 30000 (30 seconds)
-     */
-    heartbeatInterval?: number;
-    /**
-     * Custom function to extract peerId from the sync request.
-     * By default, reads from the "x-peer-id" header.
-     */
-    getPeerIdFromSyncRequest?: (req: Request) => PeerId | undefined;
-    /**
-     * Custom function to extract peerId from the events request.
-     * By default, reads from the "peerId" query parameter.
-     */
-    getPeerIdFromEventsRequest?: (req: Request) => PeerId | undefined;
+  /**
+   * Path for the sync endpoint where clients POST messages.
+   * @default "/sync"
+   */
+  syncPath?: string;
+  /**
+   * Path for the events endpoint where clients connect via SSE.
+   * @default "/events"
+   */
+  eventsPath?: string;
+  /**
+   * Interval in milliseconds for sending heartbeat comments to keep connections alive.
+   * @default 30000 (30 seconds)
+   */
+  heartbeatInterval?: number;
+  /**
+   * Custom function to extract peerId from the sync request.
+   * By default, reads from the "x-peer-id" header.
+   */
+  getPeerIdFromSyncRequest?: (req: Request) => PeerId | undefined;
+  /**
+   * Custom function to extract peerId from the events request.
+   * By default, reads from the "peerId" query parameter.
+   */
+  getPeerIdFromEventsRequest?: (req: Request) => PeerId | undefined;
 }
 /**
  * Create an Express router for SSE server adapter.
@@ -57,7 +58,7 @@ 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],
  * })
  *
@@ -69,19 +70,20 @@ interface SseExpressRouterOptions {
  * ```
  */
 declare function createSseExpressRouter(adapter: SseServerTransport, options?: SseExpressRouterOptions): Router;
-
+//#endregion
+//#region src/sse-handler.d.ts
 /**
  * Response to send back to the client after processing a POST.
  */
 interface SsePostResponse {
-    status: 200 | 202 | 400;
-    body: {
-        ok: true;
-    } | {
-        pending: true;
-    } | {
-        error: string;
-    };
+  status: 200 | 202 | 400;
+  body: {
+    ok: true;
+  } | {
+    pending: true;
+  } | {
+    error: string;
+  };
 }
 /**
  * Result of parsing a text POST body.
@@ -92,15 +94,15 @@ interface SsePostResponse {
  * - "error": Decode/reassembly error
  */
 type SsePostResult = {
-    type: "messages";
-    messages: ChannelMsg[];
-    response: SsePostResponse;
+  type: "messages";
+  messages: ChannelMsg[];
+  response: SsePostResponse;
 } | {
-    type: "pending";
-    response: SsePostResponse;
+  type: "pending";
+  response: SsePostResponse;
 } | {
-    type: "error";
-    response: SsePostResponse;
+  type: "error";
+  response: SsePostResponse;
 };
 /**
  * Parse a text POST body through the reassembler.
@@ -131,5 +133,6 @@ type SsePostResult = {
  * ```
  */
 declare function parseTextPostBody(reassembler: TextReassembler, body: string): SsePostResult;
-
+//#endregion
 export { type SseExpressRouterOptions, type SsePostResponse, type SsePostResult, SseServerTransport, createSseExpressRouter, parseTextPostBody };
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","names":[],"sources":["../src/express-router.ts","../src/sse-handler.ts"],"mappings":";;;;;;UAsBiB,uBAAA;;;AAAjB;;EAKE,QAAA;EAkBiC;;;;EAZjC,UAAA;EAkBqD;;;;EAZrD,iBAAA;EAMiC;;;;EAAjC,wBAAA,IAA4B,GAAA,EAAK,OAAA,KAAY,MAAA;EAMf;;;;EAA9B,0BAAA,IAA8B,GAAA,EAAK,OAAA,KAAY,MAAA;AAAA;;;;;;;;;;;;;;;;;AC1BjD;;;;;;;;;;;AAaA;;;;;;;;;;;iBD0DgB,sBAAA,CACd,OAAA,EAAS,kBAAA,EACT,OAAA,GAAS,uBAAA,GACR,MAAA;;;;;;UC1Ec,eAAA;EACf,MAAA;EACA,IAAA;IAAQ,EAAA;EAAA;IAAe,OAAA;EAAA;IAAoB,KAAA;EAAA;AAAA;;;;;;;;;KAWjC,aAAA;EACN,IAAA;EAAkB,QAAA,EAAU,UAAA;EAAc,QAAA,EAAU,eAAA;AAAA;EACpD,IAAA;EAAiB,QAAA,EAAU,eAAA;AAAA;EAC3B,IAAA;EAAe,QAAA,EAAU,eAAA;AAAA;;;;;;;;;;;;;AAhB/B;;;;;;;;;;;AAaA;;;;;iBAqCgB,iBAAA,CACd,WAAA,EAAa,eAAA,EACb,IAAA,WACC,aAAA"}