stitchkit 0.93.0 → 0.94.1

package/dist/browser/socket-io-connection.d.ts

@@ -0,0 +1,82 @@
+import type { SocketEventMap, SocketIOClientConfig } from './socket-io.js';
+import type { IoFn } from './socket-io-peer.js';
+type ClientSocket = ReturnType<IoFn>;
+/** The `io()` options this client's configuration stands for. */
+export declare function ioOptions<TServerEvents extends SocketEventMap>(config: SocketIOClientConfig<TServerEvents>): {
+    path: string;
+    withCredentials: boolean;
+    auth: Record<string, unknown> | ((cb: (data: object) => void) => void) | undefined;
+    query?: Record<string, string | number | boolean> | undefined;
+    extraHeaders?: Record<string, string> | undefined;
+    transports: ("polling" | "websocket")[];
+    autoConnect: boolean;
+    reconnection: boolean;
+    reconnectionAttempts: number;
+    reconnectionDelay: number;
+    reconnectionDelayMax: number;
+    timeout: number;
+};
+/**
+ * A peer that will not load is a TERMINAL connection failure, and it is
+ * reported as one.
+ *
+ * It used to be an unhandled rejection: `connect()` fired the load and
+ * nothing was listening on the failure path, so a missing `socket.io-client`
+ * took the process down at the first connect. The message was already the
+ * right one — the loader has wrapped the cause in an explanatory error for a
+ * long time — but an unhandled rejection is not something a caller can act
+ * on, retry, or report: the only outcome available was the process dying.
+ * For the self-contained-artifact consumer this adapter's `peers` option
+ * exists for, that is the worst possible moment to have no choices.
+ *
+ * With no `onConnectError` the failure is still re-thrown, so a project that
+ * asked for nothing keeps today's loud behaviour instead of a silent
+ * never-connecting client.
+ */
+export declare function reportPeerFailure(config: Pick<SocketIOClientConfig, 'onConnectError'>, error: unknown): void;
+/**
+ * One acknowledged emit, settled exactly once: by the acknowledgement, by its
+ * timeout, or by the socket dropping — each a distinguishable rejection.
+ */
+export declare function awaitAcknowledgement(input: {
+    active: ClientSocket;
+    event: string;
+    args: readonly unknown[];
+    timeoutMs: number;
+    pendingRequestDisconnects: Set<() => void>;
+    closeTrace(phase: 'timeout' | 'disconnected'): void;
+    emit(): Promise<unknown>;
+}): Promise<unknown>;
+/**
+ * Sticky events — retained last value per topic. The store lives outside the
+ * socket, so a retained value survives a disconnect()/connect() cycle; each
+ * value is the event's first emitted argument.
+ */
+export declare function createStickyEvents(retain: readonly PropertyKey[] | undefined): {
+    /**
+     * Record retained events' latest payload, independent of any user handler,
+     * so the value is available to a subscriber that connects later. Attached
+     * before connect so a handshake-time emission is captured too.
+     */
+    record(socket: ClientSocket): void;
+    replay(name: string, handler: (...args: unknown[]) => void): void;
+};
+/** The one pending server-disconnect recycle, replaced by a newer one and cleared on teardown. */
+export declare function createRecycle(delay: number | false): {
+    clear: () => void;
+    schedule(run: () => void): void;
+};
+/**
+ * A connection error as the application hears it. `active === false` means
+ * socket.io destroyed its own retry path (a namespace middleware rejection is
+ * terminal); the caller then resets its connection intent so a later
+ * `connect()` is not swallowed by the idempotence guard and re-reads a
+ * function-form `auth`.
+ */
+export declare function connectErrorReport(error: Error, socket: ClientSocket | null): {
+    message: string;
+    data: any;
+    terminal: boolean;
+};
+export {};
+//# sourceMappingURL=socket-io-connection.d.ts.map

package/dist/browser/socket-io-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-connection.d.ts","sourceRoot":"","sources":["../../src/browser/socket-io-connection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,KAAK,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;AAarC,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,aAAa,SAAS,cAAc,EAC5D,MAAM,EAAE,oBAAoB,CAAC,aAAa,CAAC;;;0CAXV,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI;;;;;;;;;;EA2BjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,EACpD,KAAK,EAAE,OAAO,GACb,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAAC;IACpD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCnB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS;IAKzE;;;;OAIG;IACH,MAAM,SAAS,YAAY,GAAG,IAAI;IAMlC,MAAM,OAAO,MAAM,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;EAIpE;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;iBAE/B,IAAI;kBAON,MAAM,IAAI,GAAG,IAAI;EASlC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAExE,OAAO;IACP,IAAI;IACJ,QAAQ;EAEX"}

package/dist/browser/socket-io-peer.d.ts

@@ -0,0 +1,20 @@
+import type { SocketIOClientPeerLoaders } from './socket-io.js';
+export type IoFn = typeof import('socket.io-client')['io'];
+/**
+ * One client's way of getting to `io`, memoised.
+ *
+ * An injected loader is never put in the module-level cache: two clients in one
+ * process may legitimately be built by different bundles, and one of them
+ * winning a shared slot would decide which module the other uses.
+ */
+export declare function createIoResolver(injected: SocketIOClientPeerLoaders['client']): () => Promise<IoFn>;
+/**
+ * Adapt our friendly `auth` form to what `io()` expects. socket.io's function
+ * form is callback-based (`(cb) => cb(payload)`) and called on every (re)connect;
+ * we accept a plain sync/async producer and bridge it to that callback. If the
+ * producer fails, send an empty auth object rather than leaving the handshake
+ * waiting forever; a normal server-side auth gate will reject it. Object /
+ * `undefined` pass straight through. No casts: socket.io types `auth` as
+ * `{ [k]: any } | ((cb: (data: object) => void) => void)`.
+ */
+//# sourceMappingURL=socket-io-peer.d.ts.map

package/dist/browser/socket-io-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-peer.d.ts","sourceRoot":"","sources":["../../src/browser/socket-io-peer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,IAAI,GAAG,cAAc,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC;AA4C3D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,yBAAyB,CAAC,QAAQ,CAAC,GAC5C,MAAM,OAAO,CAAC,IAAI,CAAC,CAyCrB;AAED;;;;;;;;GAQG"}

package/dist/browser/socket-io-trace.d.ts

@@ -0,0 +1,31 @@
+import type { RealtimeRequestPhase, RealtimeRequestPhaseHook } from '../realtime/request.js';
+type ClientSocket = ReturnType<typeof import('socket.io-client')['io']>;
+export interface RealtimeRequestTrace {
+    readonly requestId: string;
+    readonly event: string;
+    readonly startedAt: number;
+    readonly observeClient?: RealtimeRequestPhaseHook;
+    readonly observeRequest?: RealtimeRequestPhaseHook;
+    nativeKey?: string;
+    closed: boolean;
+}
+export declare const realtimeRequestTraces: WeakMap<Promise<unknown>, RealtimeRequestTrace>;
+export declare function observeRealtimeRequestPhase(trace: RealtimeRequestTrace, phase: RealtimeRequestPhase): void;
+/** One client's traces: started per request, matched to engine packets by their envelope. */
+export declare function createRequestTracer(onRequestPhase: RealtimeRequestPhaseHook | undefined): {
+    /** A trace for one request, when anyone is listening for its phases. */
+    start(event: string, onPhase: RealtimeRequestPhaseHook | undefined): RealtimeRequestTrace | undefined;
+    close(trace: RealtimeRequestTrace | undefined, phase: 'timeout' | 'disconnected'): void;
+    /** Run the emit that creates the request's packet with its trace as the current one. */
+    starting<T>(trace: RealtimeRequestTrace | undefined, emit: () => T): T;
+    /**
+     * With a client-wide phase hook, watch every engine the socket's manager
+     * opens — a reconnect brings a new one. `current` is read at open time, so
+     * a socket released since is not observed.
+     */
+    observeEachOpen(target: ClientSocket, current: () => ClientSocket | null): void;
+    /** Watch a socket's engine for the packets that carry traced requests. */
+    observe(target: ClientSocket): void;
+};
+export {};
+//# sourceMappingURL=socket-io-trace.d.ts.map

package/dist/browser/socket-io-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-trace.d.ts","sourceRoot":"","sources":["../../src/browser/socket-io-trace.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,oBAAoB,EAEpB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,KAAK,YAAY,GAAG,UAAU,CAAC,cAAc,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB,iDAAwD,CAAC;AAE3F,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,GAC1B,IAAI,CAoBN;AAkDD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS;IAKpF,wEAAwE;IACxE,KAAK,QAAQ,MAAM,WAAW,wBAAwB,GAAG,SAAS;IAYlE,KAAK,QAAQ,oBAAoB,GAAG,SAAS,SAAS,SAAS,GAAG,cAAc,GAAG,IAAI;IAMvF,wFAAwF;IACxF,QAAQ,CAAC,CAAC,SAAS,oBAAoB,GAAG,SAAS,QAAQ,MAAM,CAAC,GAAG,CAAC;IAQtE;;;;OAIG;IACH,eAAe,SAAS,YAAY,WAAW,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI;IAO/E,0EAA0E;IAC1E,OAAO,SAAS,YAAY,GAAG,IAAI;EAyBtC"}

package/dist/browser/socket-io.d.ts

@@ -1,7 +1,28 @@
-import type { StitchLogger } from '../logger.js';
-import type { RealtimeAcknowledgedEvent, RealtimeAcknowledgement, RealtimeContract, RealtimeEventRegistry, RealtimeRejectedEventHook, RealtimeRequestArguments } from '../realtime/contract.js';
+/**
+ * Typed Socket.IO client — the family WebSocket client.
+ *
+ * The whole family runs on Socket.IO (`polling` fallback, heartbeat, acks,
+ * mature reconnection) — not a hand-rolled WebSocket. Every project copied the
+ * same ~150-line client: `io()` config, connection-state machine, a typed
+ * `on/emit`, a connection-change subscription. `createSocketIOClient` is that
+ * shared kernel.
+ *
+ * Subscriptions are durable: `on()` registers a handler once and the client
+ * re-attaches it onto every socket it builds — so a handler survives an
+ * explicit `disconnect()` / `connect()` cycle, and (because re-attach happens
+ * before `socket.connect()`) no handshake-time event is ever missed. A thin
+ * per-project layer can therefore subscribe once at construction.
+ *
+ * Auth identity (`userId`, `clientId`) is project-specific — it arrives in an
+ * app `authenticated` event — so it stays in that per-project layer on top.
+ * This client owns only the transport: connection lifecycle + typed events.
+ *
+ * The returned client satisfies `CacheBridgeSocket` (`on()` returns an
+ * unsubscribe), so it plugs straight into `createCacheBridge`.
+ */
+import type { RealtimeContract, RealtimeEventRegistry } from '../realtime/contract.js';
 import { type RealtimeRequestOptions, type RealtimeRequestPhaseHook } from '../realtime/request.js';
-import { type ValidatedRealtimeSocket } from '../realtime/socket.js';
+import { type BindRealtimeClientOptions, type BoundRealtimeClient } from './realtime-client.js';
 /**
  * How this project loads the optional Socket.IO **client** peer.
  *
@@ -187,23 +208,10 @@ export interface SocketIOClient<TServerEvents extends SocketEventMap, TClientEve
     onConnectionChange(listener: (connected: boolean, reason?: string) => void): () => void;
 }
 /** Minimal Stitchkit client transport required by a validated realtime binding. */
-export type RealtimeClientTransport = Pick<SocketIOClient<SocketEventMap, SocketEventMap>, 'connected' | 'on' | 'emit' | 'emitWithAck' | 'onConnectionChange'>;
-export interface BoundRealtimeClient<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry> extends ValidatedRealtimeSocket<TServerToClient, TClientToServer> {
-    readonly connected: boolean;
-    request<TEvent extends RealtimeAcknowledgedEvent<TClientToServer>>(event: TEvent, ...args: [
-        ...RealtimeRequestArguments<TClientToServer[TEvent]>,
-        options: RealtimeRequestOptions
-    ]): Promise<RealtimeAcknowledgement<TClientToServer[TEvent]>>;
-    onConnectionChange(listener: (connected: boolean, reason?: string) => void): () => void;
-}
 export interface RealtimeClient<TServerToClient extends RealtimeEventRegistry, TClientToServer extends RealtimeEventRegistry> extends BoundRealtimeClient<TServerToClient, TClientToServer> {
     connect(): void;
     disconnect(): void;
 }
-export interface BindRealtimeClientOptions {
-    onRejected?: RealtimeRejectedEventHook;
-    logger?: StitchLogger;
-}
 export interface RealtimeClientOptions<TServerToClient extends RealtimeEventRegistry> extends BindRealtimeClientOptions, SocketIOClientConfig<{
     [TEvent in keyof TServerToClient]: (...args: unknown[]) => void;
 }> {
@@ -214,8 +222,6 @@ export interface RealtimeClientOptions<TServerToClient extends RealtimeEventRegi
      */
     onRequestPhase?: RealtimeRequestPhaseHook;
 }
-/** Add contract validation and typed acknowledgements without owning the transport lifecycle. */
-export declare function bindRealtimeClient<const TServerToClient extends RealtimeEventRegistry, const TClientToServer extends RealtimeEventRegistry>(contract: RealtimeContract<TServerToClient, TClientToServer>, transport: RealtimeClientTransport, { onRejected, logger }?: BindRealtimeClientOptions): BoundRealtimeClient<TServerToClient, TClientToServer>;
 export declare function createRealtimeClient<const TServerToClient extends RealtimeEventRegistry, const TClientToServer extends RealtimeEventRegistry>(contract: RealtimeContract<TServerToClient, TClientToServer>, { onRejected, logger, onRequestPhase, ...config }: RealtimeClientOptions<TServerToClient>): RealtimeClient<TServerToClient, TClientToServer>;
 export declare function createSocketIOClient<TServerEvents extends SocketEventMap, TClientEvents extends SocketEventMap>(config: SocketIOClientConfig<TServerEvents>): SocketIOClient<TServerEvents, TClientEvents>;
 //# sourceMappingURL=socket-io.d.ts.map

package/dist/browser/socket-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/browser/socket-io.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/browser/socket-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AAoB3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAI7B,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB,CAAC,aAAa,SAAS,cAAc,GAAG,cAAc;IACzF,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,IAAI,CAAC,EACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAClD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC5C,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;;OAcG;IACH,2BAA2B,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7C;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC;IAC7C;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE;;;;;OAKG;IACH,KAAK,CAAC,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,cAAc,CAC7B,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc;IAEpC,6DAA6D;IAC7D,OAAO,IAAI,IAAI,CAAC;IAChB,+CAA+C;IAC/C,UAAU,IAAI,IAAI,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAC5F;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,GAAG,MAAM,EACzC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC;IACX;;;OAGG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACzF;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc,CAC7B,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB,CAC7C,SAAQ,mBAAmB,CAAC,eAAe,EAAE,eAAe,CAAC;IAC7D,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,eAAe,SAAS,qBAAqB,CAClF,SAAQ,yBAAyB,EAC/B,oBAAoB,CAAC;KAClB,MAAM,IAAI,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI;CAChE,CAAC;IACJ;;;;OAIG;IACH,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,CAAC,eAAe,SAAS,qBAAqB,EAEnD,QAAQ,EAAE,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,EAC5D,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,EAAE,qBAAqB,CAAC,eAAe,CAAC,GACxF,cAAc,CAAC,eAAe,EAAE,eAAe,CAAC,CAclD;AAED,wBAAgB,oBAAoB,CAClC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,MAAM,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAAG,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAE3F"}

package/dist/browser/stream.d.ts

@@ -1,5 +1,4 @@
-export { type ParseSSEOptions, parseSSE } from '../server/stream.js';
-import type { StreamFinalLinePolicy } from '../contract/index.js';
+import type { StreamFinalLinePolicy } from '../contract/define.js';
 export { DEFAULT_STREAM_LINE_BYTES } from '../internal/bounded-lines.js';
 /** Options for `parseNDJSON`. */
 export interface ParseNDJSONOptions {
@@ -28,4 +27,17 @@ export interface ParseNDJSONOptions {
  * the route's `context.signal` at once.
  */
 export declare function parseNDJSON<T>(response: Response, options?: ParseNDJSONOptions): AsyncGenerator<T>;
+/** Options for `parseSSE`. */
+export interface ParseSSEOptions {
+    /** Maximum bytes retained for one SSE line. Default 1 MiB. */
+    maxLineBytes?: number;
+    /** Called for invalid UTF-8/JSON; without it parsing fails closed. */
+    onParseError?: (raw: string, error: Error) => void;
+}
+/**
+ * Parse a Server-Sent Events `Response` body into an async generator of JSON
+ * values — the client counterpart of `streamSSE`. Stops at the `[DONE]`
+ * sentinel; the stream lock is released on every exit path.
+ */
+export declare function parseSSE<T>(response: Response, options?: ParseSSEOptions): AsyncGenerator<T>;
 //# sourceMappingURL=stream.d.ts.map

package/dist/browser/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/browser/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnD,wFAAwF;IACxF,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,WAAW,CAAC,CAAC,EAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,CAAC,CAAC,CAAC,CAkBnB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/browser/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnD,wFAAwF;IACxF,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,WAAW,CAAC,CAAC,EAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,CAAC,CAAC,CAAC,CAkBnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,CAAC,CAAC,CAuBnB"}

package/dist/contract/client-types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * The types a client is inferred with: every endpoint's arguments and output, multipart files, and the scoped and URL-building variants.
+ */
+import type { ZodType, z } from 'zod';
+import type { PathParams } from '../internal/route-pattern.js';
+import type { EndpointDef, Transport } from './define.js';
+type Prop<T, K extends string> = K extends keyof T ? T[K] : undefined;
+type InferInput<S> = S extends ZodType ? z.input<S> : unknown;
+/**
+ * A platform file descriptor accepted by the typed client's multipart methods
+ * where a file is not a `Blob`. React Native / Expo represent a file as
+ * `{ uri, name, type }` and their `FormData.append` streams it from disk by
+ * `uri`; reading it into a `Blob` first (`fetch(uri).blob()`) would load the
+ * whole media into memory. The web / Bun path still uses `Blob`.
+ */
+export interface FileDescriptor {
+    /** Local file URI the platform streams from (e.g. `file:///…`). */
+    uri: string;
+    /** File name for the multipart part. */
+    name: string;
+    /** MIME type for the multipart part. */
+    type: string;
+}
+/**
+ * What a `multipart` endpoint's file field accepts on the typed client — a
+ * `Blob` (web / Bun) or a platform {@link FileDescriptor} (React Native / Expo).
+ * Exported so a consumer can type its own upload helpers without a cast.
+ */
+export type MultipartFile = Blob | FileDescriptor;
+/** A single named file policy within a multipart request. */
+export type MultipartFilePolicy = {
+    required?: boolean;
+    multiple?: false;
+    maxFiles?: never;
+    maxBytes?: number;
+    contentTypes?: readonly string[];
+} | {
+    required?: boolean;
+    multiple: true;
+    maxFiles?: number;
+    maxBytes?: number;
+    contentTypes?: readonly string[];
+};
+/** One source of truth for multipart cardinality, delivery and byte policy. */
+export interface MultipartDescriptor {
+    delivery?: 'buffer' | 'stream';
+    maxRequestBytes?: number;
+    maxFieldBytes?: number;
+    files: Record<string, MultipartFilePolicy>;
+}
+type MultipartClientValue<P> = P extends {
+    multiple: true;
+} ? MultipartFile[] : MultipartFile;
+type RequiredMultipartKeys<F> = {
+    [K in keyof F]: F[K] extends {
+        required: false;
+    } ? never : K;
+}[keyof F];
+type OptionalMultipartKeys<F> = {
+    [K in keyof F]: F[K] extends {
+        required: false;
+    } ? K : never;
+}[keyof F];
+type MultipartArgs<E> = E extends {
+    multipart: {
+        files: infer F;
+    };
+} ? {
+    [K in RequiredMultipartKeys<F>]: MultipartClientValue<F[K]>;
+} & {
+    [K in OptionalMultipartKeys<F>]?: MultipartClientValue<F[K]>;
+} : unknown;
+/** Buffered server-side file values inferred from a multipart descriptor. */
+export type MultipartBufferedFiles<M> = M extends {
+    files: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        multiple: true;
+    } ? File[] : F[K] extends {
+        required: false;
+    } ? File | undefined : File;
+} : never;
+/** Public per-call options accepted by every typed HTTP endpoint's `withOptions` method. */
+export interface ClientRequestOptions {
+    signal?: AbortSignal;
+}
+type ClientEndpointWithArgs<Args, Output> = {
+    (args: Args): Promise<Output>;
+    withOptions(args: Args, options: ClientRequestOptions): Promise<Output>;
+};
+type ClientEndpointWithoutArgs<Output> = {
+    (): Promise<Output>;
+    withOptions(options: ClientRequestOptions): Promise<Output>;
+};
+type InferredPathParams<E> = E extends {
+    path: infer TPath extends string;
+} ? keyof PathParams<TPath> extends never ? unknown : PathParams<TPath> : unknown;
+type EndpointParamsInput<E> = Prop<E, 'params'> extends ZodType ? InferInput<Prop<E, 'params'>> : InferredPathParams<E>;
+type EndpointArgs<E> = EndpointParamsInput<E> & InferInput<Prop<E, 'input'>> & MultipartArgs<E>;
+/**
+ * What the typed client resolves to. A `raw` endpoint hands back the untouched
+ * `Response` — its body is bytes, and the headers carry what the caller needs
+ * (`Content-Disposition`, `Content-Range`, `ETag`). → ADR 0038.
+ */
+type EndpointOutput<E> = E extends {
+    rawResponse: true;
+} ? Response : Prop<E, 'stream'> extends {
+    item: ZodType<infer O>;
+} ? AsyncIterableIterator<O> : Prop<E, 'output'> extends ZodType<infer O> ? O : undefined;
+export type EndpointFn<E> = [keyof EndpointArgs<E>] extends [never] ? ClientEndpointWithoutArgs<EndpointOutput<E>> : ClientEndpointWithArgs<EndpointArgs<E>, EndpointOutput<E>>;
+export type TypedClient<C extends Record<string, EndpointDef>> = {
+    [K in keyof C]: EndpointFn<C[K]>;
+};
+type ExposesHttp<E> = E extends {
+    expose: readonly Transport[];
+} ? 'HTTP' extends E['expose'][number] ? true : false : true;
+type ArgsWith<E, Extra> = EndpointArgs<E> & Extra;
+export type ScopedEndpointFn<E, Extra> = [keyof ArgsWith<E, Extra>] extends [never] ? ClientEndpointWithoutArgs<EndpointOutput<E>> : ClientEndpointWithArgs<ArgsWith<E, Extra>, EndpointOutput<E>>;
+export type ScopedHttpClient<C extends Record<string, EndpointDef>, Extra> = {
+    [K in keyof C as ExposesHttp<C[K]> extends true ? K : never]: ScopedEndpointFn<C[K], Extra>;
+};
+export type TypedHttpClient<C extends Record<string, EndpointDef>> = ScopedHttpClient<C, unknown>;
+type IsUrlBuildable<E> = ExposesHttp<E>;
+type EndpointUrlArgs<E> = EndpointParamsInput<E> & (E extends {
+    method: 'GET' | 'DELETE';
+} ? InferInput<Prop<E, 'input'>> : unknown);
+type UrlArgsWith<E, Extra> = EndpointUrlArgs<E> & Extra;
+export type ScopedUrlFn<E, Extra> = [keyof UrlArgsWith<E, Extra>] extends [never] ? () => string : (args: UrlArgsWith<E, Extra>) => string;
+export type ScopedUrlBuilder<C extends Record<string, EndpointDef>, Extra> = {
+    [K in keyof C as IsUrlBuildable<C[K]> extends true ? K : never]: ScopedUrlFn<C[K], Extra>;
+};
+export type TypedUrlBuilder<C extends Record<string, EndpointDef>> = ScopedUrlBuilder<C, unknown>;
+export {};
+//# sourceMappingURL=client-types.d.ts.map

package/dist/contract/client-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-types.d.ts","sourceRoot":"","sources":["../../src/contract/client-types.ts"],"names":[],"mappings":"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"}

package/dist/contract/define-validation.d.ts

@@ -0,0 +1,30 @@
+import type { EndpointDef } from './define.js';
+export declare function assertPositiveLimit(where: string, name: string, value: number | undefined): void;
+/** Multipart is one declarative HTTP-only request boundary. */
+export declare function assertMultipartEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+/**
+ * A raw endpoint hands the whole response to the handler, so everything that
+ * only makes sense for a *tool* is meaningless on it. The type already forbids
+ * each of these; this repeats the rule for a contract assembled at runtime —
+ * and it fails loudly at definition time rather than shipping a tool that
+ * serializes a `Response` into `{}`. → ADR 0038.
+ */
+export declare function assertRawEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+export declare function assertStreamingResponseEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+export declare function assertNoUngroupedToolOptions(prefix: string, key: string, ep: EndpointDef): void;
+/** An endpoint that never reaches a tool transport has no tool options to set. */
+export declare function assertNoToolOptions(where: string, ep: EndpointDef): void;
+/** HEAD is an explicit, bodyless, HTTP-only raw-response operation. */
+export declare function assertHeadEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+/** Raw JSON text exists only on a validated, body-bearing HTTP operation. */
+export declare function assertRawBodyEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+/**
+ * A safelisted body exists only where a simple cross-origin request can carry
+ * one: a validated `POST`. Every other shape either has no JSON body (`GET`,
+ * `HEAD`, multipart) or always preflights (`PUT`, `PATCH`, `DELETE`), so the
+ * flag would buy nothing and only widen the surface the Origin check guards.
+ */
+export declare function assertSafelistedBodyEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+/** Typed response metadata is a static, HTTP-only addition to the data path. */
+export declare function assertResponseMetaEndpoint(prefix: string, key: string, ep: EndpointDef): void;
+//# sourceMappingURL=define-validation.d.ts.map

package/dist/contract/define-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-validation.d.ts","sourceRoot":"","sources":["../../src/contract/define-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,IAAI,CAIN;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAkC1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAQpF;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,WAAW,GACd,IAAI,CAuCN;AA4BD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,WAAW,GACd,IAAI,CAoBN;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAIxE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAMrF;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,WAAW,GACd,IAAI,CAMN;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,WAAW,GACd,IAAI,CAqBN"}