@kyneta/sse-transport 1.3.1 → 1.5.0

package/README.md

@@ -192,7 +192,7 @@ Both directions use the `@kyneta/wire` text pipeline — symmetric encoding with
 Every message is wrapped in a text frame — a JSON array with a 2-character prefix:
 
 ```/dev/null/text-frame-example.txt#L1-5
-Complete frame:  ["0c", {"type":"discover","docIds":["doc-1"]}]
+Complete frame:  ["0c", {"type":"present","docs":[{"docId":"doc-1"}]}]
 Fragment frame:  ["0f", "a1b2c3d4", 0, 3, 1500, "{\"type\":\"offer\"..."]
 ```
 

package/dist/client.d.ts

@@ -1,9 +1,8 @@
-import { StateTransition, TransitionListener, Program } from '@kyneta/machine';
-export { StateTransition, TransitionListener } from '@kyneta/machine';
-import { PeerId, Transport, GeneratedChannel, TransportFactory, ReconnectOptions } from '@kyneta/transport';
-import { b as SseClientLifecycleEvents, c as SseClientState } from './types-DaVaqfwF.js';
-export { D as DisconnectReason } from './types-DaVaqfwF.js';
+import { n as SseClientLifecycleEvents, r as SseClientState, t as DisconnectReason } from "./types-Bg1SdZ2w.js";
+import { Program, StateTransition, StateTransition as StateTransition$1, TransitionListener, TransitionListener as TransitionListener$1 } from "@kyneta/machine";
+import { GeneratedChannel, PeerId, ReconnectOptions, Transport, TransportFactory } from "@kyneta/transport";
 
+//#region src/client-transport.d.ts
 /**
  * Default fragment threshold in characters.
  * 60K chars provides a safety margin below typical 100KB body-parser limits,
@@ -14,32 +13,32 @@ declare const DEFAULT_FRAGMENT_THRESHOLD = 60000;
  * Options for the SSE client adapter.
  */
 interface SseClientOptions {
-    /** URL for POST requests (client→server). String or function of peerId. */
-    postUrl: string | ((peerId: PeerId) => string);
-    /** URL for SSE EventSource (server→client). String or function of peerId. */
-    eventSourceUrl: string | ((peerId: PeerId) => string);
-    /** Reconnection options for EventSource. */
-    reconnect?: {
-        enabled?: boolean;
-        maxAttempts?: number;
-        baseDelay?: number;
-        maxDelay?: number;
-    };
-    /** POST retry options. */
-    postRetry?: {
-        maxAttempts?: number;
-        baseDelay?: number;
-        maxDelay?: number;
-    };
-    /** Fragment threshold in characters. Default: 60000 (60K chars). */
-    fragmentThreshold?: number;
-    /** Lifecycle event callbacks. */
-    lifecycle?: SseClientLifecycleEvents;
+  /** URL for POST requests (client→server). String or function of peerId. */
+  postUrl: string | ((peerId: PeerId) => string);
+  /** URL for SSE EventSource (server→client). String or function of peerId. */
+  eventSourceUrl: string | ((peerId: PeerId) => string);
+  /** Reconnection options for EventSource. */
+  reconnect?: {
+    enabled?: boolean;
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+  };
+  /** POST retry options. */
+  postRetry?: {
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+  };
+  /** Fragment threshold in characters. Default: 60000 (60K chars). */
+  fragmentThreshold?: number;
+  /** Lifecycle event callbacks. */
+  lifecycle?: SseClientLifecycleEvents;
 }
 /**
  * State transition event for SSE client states.
  */
-type SseClientStateTransition = StateTransition<SseClientState>;
+type SseClientStateTransition = StateTransition$1<SseClientState>;
 /**
  * SSE client network adapter for @kyneta/exchange.
  *
@@ -47,7 +46,7 @@ type SseClientStateTransition = StateTransition<SseClientState>;
  * - **EventSource** (GET, long-lived) for server→client messages
  * - **fetch POST** for client→server messages
  *
- * Both directions use the text wire format (`textCodec` + text framing).
+ * Both directions use the alias-aware text pipeline.
  *
  * Internally, the connection lifecycle is a `Program<Msg, Model, Fx>` —
  * a pure Mealy machine whose transitions are deterministically testable.
@@ -58,7 +57,7 @@ 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}`,
@@ -68,35 +67,35 @@ type SseClientStateTransition = StateTransition<SseClientState>;
  * ```
  */
 declare class SseClientTransport extends Transport<void> {
-    #private;
-    constructor(options: SseClientOptions);
-    /**
-     * Get the current connection state.
-     */
-    getState(): SseClientState;
-    /**
-     * Subscribe to state transitions.
-     */
-    subscribeToTransitions(listener: TransitionListener<SseClientState>): () => void;
-    /**
-     * Wait for a specific state.
-     */
-    waitForState(predicate: (state: SseClientState) => boolean, options?: {
-        timeoutMs?: number;
-    }): Promise<SseClientState>;
-    /**
-     * Wait for a specific status.
-     */
-    waitForStatus(status: SseClientState["status"], options?: {
-        timeoutMs?: number;
-    }): Promise<SseClientState>;
-    /**
-     * Whether the client is connected and ready to send/receive.
-     */
-    get isConnected(): boolean;
-    protected generate(): GeneratedChannel;
-    onStart(): Promise<void>;
-    onStop(): Promise<void>;
+  #private;
+  constructor(options: SseClientOptions);
+  /**
+   * Get the current connection state.
+   */
+  getState(): SseClientState;
+  /**
+   * Subscribe to state transitions.
+   */
+  subscribeToTransitions(listener: TransitionListener$1<SseClientState>): () => void;
+  /**
+   * Wait for a specific state.
+   */
+  waitForState(predicate: (state: SseClientState) => boolean, options?: {
+    timeoutMs?: number;
+  }): Promise<SseClientState>;
+  /**
+   * Wait for a specific status.
+   */
+  waitForStatus(status: SseClientState["status"], options?: {
+    timeoutMs?: number;
+  }): Promise<SseClientState>;
+  /**
+   * Whether the client is connected and ready to send/receive.
+   */
+  get isConnected(): boolean;
+  protected generate(): GeneratedChannel;
+  onStart(): Promise<void>;
+  onStop(): Promise<void>;
 }
 /**
  * Create an SSE client adapter for browser-to-server connections.
@@ -115,41 +114,42 @@ declare class SseClientTransport extends Transport<void> {
  * ```
  */
 declare function createSseClient(options: SseClientOptions): TransportFactory;
-
+//#endregion
+//#region src/client-program.d.ts
 type SseClientMsg = {
-    type: "start";
+  type: "start";
 } | {
-    type: "event-source-opened";
+  type: "event-source-opened";
 } | {
-    type: "event-source-error";
+  type: "event-source-error";
 } | {
-    type: "stop";
+  type: "stop";
 } | {
-    type: "reconnect-timer-fired";
+  type: "reconnect-timer-fired";
 };
 type SseClientEffect = {
-    type: "create-event-source";
-    url: string;
-    attempt: number;
+  type: "create-event-source";
+  url: string;
+  attempt: number;
 } | {
-    type: "close-event-source";
+  type: "close-event-source";
 } | {
-    type: "add-channel-and-establish";
+  type: "add-channel-and-establish";
 } | {
-    type: "remove-channel";
+  type: "remove-channel";
 } | {
-    type: "start-reconnect-timer";
-    delayMs: number;
+  type: "start-reconnect-timer";
+  delayMs: number;
 } | {
-    type: "cancel-reconnect-timer";
+  type: "cancel-reconnect-timer";
 } | {
-    type: "abort-pending-posts";
+  type: "abort-pending-posts";
 };
 interface SseClientProgramOptions {
-    url: string;
-    reconnect?: Partial<ReconnectOptions>;
-    /** Inject jitter source for deterministic testing. Default: () => Math.random() * 1000 */
-    jitterFn?: () => number;
+  url: string;
+  reconnect?: Partial<ReconnectOptions>;
+  /** Inject jitter source for deterministic testing. Default: () => Math.random() * 1000 */
+  jitterFn?: () => number;
 }
 /**
  * Create the SSE client connection lifecycle program — a pure Mealy machine.
@@ -159,5 +159,6 @@ interface SseClientProgramOptions {
  * shell interprets `SseClientEffect` as actual I/O.
  */
 declare function createSseClientProgram(options: SseClientProgramOptions): Program<SseClientMsg, SseClientState, SseClientEffect>;
-
-export { DEFAULT_FRAGMENT_THRESHOLD, type SseClientEffect, SseClientLifecycleEvents, type SseClientMsg, type SseClientOptions, type SseClientProgramOptions, SseClientState, type SseClientStateTransition, SseClientTransport, createSseClient, createSseClientProgram };
+//#endregion
+export { DEFAULT_FRAGMENT_THRESHOLD, type DisconnectReason, type SseClientEffect, type SseClientLifecycleEvents, type SseClientMsg, type SseClientOptions, type SseClientProgramOptions, type SseClientState, type SseClientStateTransition, SseClientTransport, type StateTransition, type TransitionListener, createSseClient, createSseClientProgram };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client-transport.ts","../src/client-program.ts"],"mappings":";;;;;AAmFA;;;;;AAAA,cAAa,0BAAA;;;;UAKI,gBAAA;EA0BH;EAxBZ,OAAA,aAAoB,MAAA,EAAQ,MAAA;EAwBQ;EArBpC,cAAA,aAA2B,MAAA,EAAQ,MAAA;EAHP;EAM5B,SAAA;IACE,OAAA;IACA,WAAA;IACA,SAAA;IACA,QAAA;EAAA;EAFA;EAMF,SAAA;IACE,WAAA;IACA,SAAA;IACA,QAAA;EAAA;EAAA;EAIF,iBAAA;EAGA;EAAA,SAAA,GAAY,wBAAA;AAAA;;AAmBd;;KAAY,wBAAA,GAA2B,iBAAA,CAAgB,cAAA;;;AAiCvD;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,kBAAA,SAA2B,SAAA;EAAA;cAwB1B,OAAA,EAAS,gBAAA;EAyMU;;;EAR/B,QAAA,CAAA,GAAY,cAAA;EAiBE;;;EAVd,sBAAA,CACE,QAAA,EAAU,oBAAA,CAAmB,cAAA;EAW5B;;;EAHH,YAAA,CACE,SAAA,GAAY,KAAA,EAAO,cAAA,cACnB,OAAA;IAAY,SAAA;EAAA,IACX,OAAA,CAAQ,cAAA;EAST;;;EAFF,aAAA,CACE,MAAA,EAAQ,cAAA,YACR,OAAA;IAAY,SAAA;EAAA,IACX,OAAA,CAAQ,cAAA;EA4EL;;;EAAA,IArEF,WAAA,CAAA;EAAA,UAQM,QAAA,CAAA,GAAY,gBAAA;EA6DhB,OAAA,CAAA,GAAW,OAAA;EAUX,MAAA,CAAA,GAAU,OAAA;AAAA;;;;;;;;;;;AC/dlB;;;;;;iBDupBgB,eAAA,CAAgB,OAAA,EAAS,gBAAA,GAAmB,gBAAA;;;KCvpBhD,YAAA;EACN,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;AAAA;AAAA,KAMM,eAAA;EACN,IAAA;EAA6B,GAAA;EAAa,OAAA;AAAA;EAC1C,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;EAA+B,OAAA;AAAA;EAC/B,IAAA;AAAA;EACA,IAAA;AAAA;AAAA,UAMW,uBAAA;EACf,GAAA;EACA,SAAA,GAAY,OAAA,CAAQ,gBAAA;EDqER;ECnEZ,QAAA;AAAA;ADsFF;;;;;AAiCA;;AAjCA,iBC5EgB,sBAAA,CACd,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,YAAA,EAAc,cAAA,EAAgB,eAAA"}