stitchkit 0.60.0 → 0.61.0

package/dist/realtime/rejected-frame.d.ts

@@ -0,0 +1,86 @@
+/**
+ * A rejection the SENDER can see.
+ *
+ * A frame that fails the receiver's schema used to be dropped where it landed:
+ * the receiving side reported `onRejected` and the sending side learned
+ * nothing at all — it waited out its deadline and reported a timeout. For a
+ * distributed pair that is the worst diagnostic shape there is. The machines
+ * are healthy, the sockets are up, and every request times out in both
+ * directions at once, which reads as a network fault rather than as two peers
+ * disagreeing about a contract.
+ *
+ * It also quietly removed the point of putting a protocol generation in the
+ * envelope: the check ran, and its answer could not reach the only party able
+ * to act on it. There is no deployment order in which two generations coexist
+ * if neither can tell the other why it is being refused.
+ *
+ * So when a refused frame carries an acknowledgement callback — the one
+ * back-channel that already exists — the refusal is sent through it. A
+ * fire-and-forget event still has nowhere to answer; that boundary is real and
+ * is documented rather than papered over.
+ */
+/**
+ * The reserved key. Namespaced because it travels on the application's own
+ * acknowledgement channel: this envelope is delivered INSTEAD of a value the
+ * application's `ack` schema would accept, and the sender recognises it before
+ * parsing. An application whose acknowledgement is an object carrying this
+ * exact key would be ambiguous — hence a key nobody writes by accident.
+ */
+export declare const REALTIME_REJECTION_KEY = "@stitchkit/realtime-rejected";
+/**
+ * One field the peer refused, already flattened.
+ *
+ * `path` is dotted and tuple-aware: the first payload's `v` field is `'0.v'`,
+ * because event arguments are a tuple. This is what replaces reading a
+ * `ZodError`'s internals on the receiving end — three conditions about somebody
+ * else's object shape, for a fact that is binary.
+ */
+export interface RealtimeRejectionIssue {
+    path: string;
+    code: string;
+    message: string;
+}
+/**
+ * At most this many issues travel; a refusal is a signal, not a report.
+ *
+ * Applied on BOTH sides. On the reading side it bounds what a peer can make
+ * this process hold; on the writing side it bounds what a peer can make this
+ * process send — and that one matters more, because the number of issues is
+ * chosen by whoever sent the bad frame.
+ */
+export declare const MAX_REJECTION_ISSUES = 20;
+/**
+ * What the sender is told: which event, why, and the issues if there were any.
+ *
+ * `reason` is a union of one today, and deliberately a union: `invalid-arguments`
+ * is the only refusal that CAN be answered. An event the receiver's contract
+ * does not contain has no listener at all, so there is nothing on that side to
+ * answer with; a frame missing its acknowledgement callback has no channel by
+ * definition. Both stay reported locally, and both are honest gaps rather than
+ * reasons this envelope is never sent.
+ */
+export interface RealtimeRejectionReport {
+    event: string;
+    /**
+     * Why the peer refused it. `invalid-arguments` is what this version sends and
+     * the shape a protocol-generation mismatch takes.
+     *
+     * Typed as a string rather than as a closed union **on the wire**, because a
+     * closed union is a mechanism that cannot version itself forward: a peer on a
+     * later release refusing for a reason this one has never heard of would fail
+     * recognition, fall through to the application's acknowledgement schema, and
+     * surface as "the peer answered with something invalid" — the precise
+     * mischaracterisation this envelope exists to prevent. An unknown reason is
+     * still a refusal, and is reported as one.
+     */
+    reason: string;
+    message: string;
+    issues?: RealtimeRejectionIssue[];
+}
+export interface RealtimeRejectionEnvelope {
+    [REALTIME_REJECTION_KEY]: RealtimeRejectionReport;
+}
+export declare function realtimeRejectionEnvelope(report: RealtimeRejectionReport): RealtimeRejectionEnvelope;
+/** Whether an acknowledgement value is a peer's refusal rather than a value. */
+export declare function asRealtimeRejection(value: unknown): RealtimeRejectionReport | null;
+//# sourceMappingURL=rejected-frame.d.ts.map

package/dist/realtime/rejected-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rejected-frame.d.ts","sourceRoot":"","sources":["../../src/realtime/rejected-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,CAAC,sBAAsB,CAAC,EAAE,uBAAuB,CAAC;CACnD;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,GAC9B,yBAAyB,CAE3B;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAgBlF"}

package/dist/realtime/request.d.ts

@@ -1,3 +1,4 @@
+import type { RealtimeRejectionIssue } from './rejected-frame';
 export interface RealtimeRequestOptions {
     /** Maximum acknowledgement wait in milliseconds. Must be finite and > 0. */
     timeoutMs: number;
@@ -18,4 +19,27 @@ export declare class RealtimeRequestInvalidAcknowledgementError extends Error {
     readonly event: string;
     constructor(event: string, cause: unknown);
 }
+/**
+ * The peer refused the frame against its own copy of the contract, and said so.
+ *
+ * Distinct from `RealtimeRequestTimeoutError` on purpose, and that distinction
+ * is the whole point: a refusal used to BE a timeout, so a version skew looked
+ * exactly like a network fault — symmetrically, on every plane at once. It is
+ * also distinct from `RealtimeRequestInvalidAcknowledgementError`, which means
+ * the peer answered with something its own contract does not allow; this one
+ * means the peer never got as far as answering.
+ */
+export declare class RealtimeRequestRejectedError extends Error {
+    readonly code = "REALTIME_REQUEST_REJECTED";
+    readonly event: string;
+    /**
+     * Why the peer refused it. `invalid-arguments` is the version-skew shape and
+     * what a peer on this release sends; a later release may name others, so
+     * compare rather than exhaustively switch.
+     */
+    readonly reason: string;
+    /** The fields the peer refused, when it named any — validated on arrival. */
+    readonly issues: RealtimeRejectionIssue[] | undefined;
+    constructor(event: string, reason: string, detail: string, issues?: RealtimeRejectionIssue[]);
+}
 //# sourceMappingURL=request.d.ts.map

package/dist/realtime/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/realtime/request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK3C;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAIxB;CACF;AAED,qBAAa,0CAA2C,SAAQ,KAAK;IACnE,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAIxC;CACF"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/realtime/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK3C;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAIxB;CACF;AAED,qBAAa,0CAA2C,SAAQ,KAAK;IACnE,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAIxC;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAEtD,YACE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAOlC;CACF"}

package/dist/realtime/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAEvB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAIpB,UAAU,8BAA8B,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAClF;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;;;;IAOhC,CAAC;AAEH,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,EAAE,CAAC,MAAM,SAAS,MAAM,QAAQ,GAAG,MAAM,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC9C,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAChD,OAAO,CAAC;CACZ;AA+DD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,EAAE,CAuBX;AAED,wBAAgB,mCAAmC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,EACxE,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,yBAAyB,GAAG,SAAS,EAC3C,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAahB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,QAAQ,SAAS,qBAAqB,EAC5C,KAAK,CAAC,SAAS,SAAS,qBAAqB,EAC7C,EACA,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,uBAAuB,CAC9E,QAAQ,EACR,SAAS,CACV,CA+HA"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAEvB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAapB,UAAU,8BAA8B,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAClF;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;;;;IAOhC,CAAC;AAEH,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,EAAE,CAAC,MAAM,SAAS,MAAM,QAAQ,GAAG,MAAM,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC9C,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAChD,OAAO,CAAC;CACZ;AA+GD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,EAAE,CAuBX;AAED,wBAAgB,mCAAmC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,EACxE,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,yBAAyB,GAAG,SAAS,EAC3C,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAqChB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,QAAQ,SAAS,qBAAqB,EAC5C,KAAK,CAAC,SAAS,SAAS,qBAAqB,EAC7C,EACA,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,uBAAuB,CAC9E,QAAQ,EACR,SAAS,CACV,CAwKA"}

package/dist/remote.js

@@ -4,14 +4,16 @@ import {
 } from "./index-svqhcrrj.js";
 import"./index-48ffdxgk.js";
 import {
-  AppError,
   mergeMeta
-} from "./index-v6e8hnkx.js";
+} from "./index-wd8g8z6e.js";
 import"./index-6k1937bx.js";
 import"./index-pzyt11ch.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";
+import {
+  AppError
+} from "./index-xxye8j3k.js";
 
 // src/tools/remote.ts
 var HTTP_ONLY = Object.freeze(["HTTP"]);

package/dist/server/index.d.ts

@@ -25,6 +25,7 @@ export { type ManagedServerHandle, type ShutdownOptions, ShutdownOptionsSchema,
 export type { SocketIOHandshakeConfig, SocketIOPeerLoaders, SocketIORequestPolicy, SocketIOServerConfig, SocketIOServerHandle, SocketIOServerLifecycle, } from './socket-io';
 export { createSocketIOServer, socketIoLane } from './socket-io';
 export { type ParseSSEOptions, parseSSE, streamSSE } from './stream';
+export { DEFAULT_STREAM_HEARTBEAT_MS, ndjsonRoute, type StreamingFormat, type StreamingRouteOptions, type StreamingSourceContext, sseRoute, streamingRoute, } from './streaming-route';
 export type { AuthorizationContext, EffectiveScope, EndpointHandlerContext, Handlers, LifecycleHooks, LoggingConfig, LogOutcome, MethodDef, MultipartFileMetadata, MultipartReceiver, MultipartReceiverResult, OperationIdentity, RouteGroup, ScopeContexts, ScopedHandlers, ServiceDef, StitchLogger, StreamingMultipartImplementation, } from './types';
 export { type ComposedLane, composeWebSocketHandlers, type WebSocketComposeConfig, type WebSocketLane, webSocketLane, } from './websocket';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

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

package/dist/server/index.js

@@ -7,7 +7,7 @@ import {
   parseMultipart,
   socketIoLane,
   webSocketLane
-} from "../index-f7521k0x.js";
+} from "../index-s1tywej8.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -20,7 +20,7 @@ import {
   signJwt,
   verifyJwt,
   verifyPkce
-} from "../index-3w74r08v.js";
+} from "../index-mfw1pec7.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
@@ -34,7 +34,7 @@ import {
   defineMultipartStream,
   implement,
   implementRegistry
-} from "../index-3hn10n4c.js";
+} from "../index-y91zd0ch.js";
 import {
   isWithinDir,
   realPathWithinDir
@@ -65,7 +65,16 @@ import {
   resolveSocketIp,
   resolveTraceId,
   zodIssues
-} from "../index-6fbp58g8.js";
+} from "../index-tvwcrx2d.js";
+import"../index-wd8g8z6e.js";
+import"../index-6k1937bx.js";
+import {
+  joinRoutePath,
+  parseTrailingWildcard
+} from "../index-pzyt11ch.js";
+import {
+  isRecord
+} from "../index-smpbdg6k.js";
 import {
   AppError,
   STITCH_ERROR_STATUS,
@@ -77,15 +86,7 @@ import {
   notFound,
   rateLimited,
   unauthorized
-} from "../index-v6e8hnkx.js";
-import"../index-6k1937bx.js";
-import {
-  joinRoutePath,
-  parseTrailingWildcard
-} from "../index-pzyt11ch.js";
-import {
-  isRecord
-} from "../index-smpbdg6k.js";
+} from "../index-xxye8j3k.js";
 // src/server/bun.ts
 import { chmodSync, statSync, unlinkSync } from "node:fs";
 function reclaimStaleUnixSocket(path) {
@@ -972,9 +973,11 @@ function streamSSE(generator) {
         controller.close();
       }
     },
-    async cancel() {
+    cancel() {
       cancelled = true;
-      await generator.return(undefined);
+      generator.return(undefined).catch(() => {
+        return;
+      });
     }
   });
   return new Response(stream, {
@@ -1018,10 +1021,198 @@ async function* parseSSE(response, options) {
     reader.releaseLock();
   }
 }
+// src/server/streaming-route.ts
+var DEFAULT_STREAM_HEARTBEAT_MS = 5000;
+var FRAMINGS = {
+  ndjson: {
+    contentType: "application/x-ndjson",
+    keepAlive: `
+`,
+    frame: (value) => `${JSON.stringify(value)}
+`
+  },
+  sse: {
+    contentType: "text/event-stream",
+    keepAlive: `: keep-alive
+
+`,
+    frame: (value) => `data: ${JSON.stringify(value)}
+
+`,
+    done: `data: [DONE]
+
+`
+  }
+};
+function applyIdleTimeout(server, request, seconds) {
+  if (typeof server !== "object" || server === null)
+    return;
+  const timeout = Reflect.get(server, "timeout");
+  if (typeof timeout !== "function")
+    return;
+  try {
+    Reflect.apply(timeout, server, [request, seconds]);
+  } catch {}
+}
+function unrefTimer(timer) {
+  if (typeof timer !== "object" || timer === null)
+    return;
+  const unref = Reflect.get(timer, "unref");
+  if (typeof unref === "function")
+    Reflect.apply(unref, timer, []);
+}
+var MAX_BUFFERED_FRAMES = 16;
+function responseHeaders(framing, extra) {
+  const headers = new Headers(extra);
+  headers.set("Content-Type", framing.contentType);
+  headers.set("Cache-Control", "no-cache");
+  headers.set("Connection", "keep-alive");
+  headers.set("X-Accel-Buffering", "no");
+  return headers;
+}
+function streamingRoute(options) {
+  const heartbeatMs = options.heartbeatMs ?? DEFAULT_STREAM_HEARTBEAT_MS;
+  if (!Number.isFinite(heartbeatMs) || heartbeatMs <= 0) {
+    throw new TypeError("heartbeatMs must be a finite positive number of milliseconds");
+  }
+  const idleTimeoutSeconds = options.idleTimeoutSeconds ?? 0;
+  if (!Number.isInteger(idleTimeoutSeconds) || idleTimeoutSeconds < 0) {
+    throw new TypeError("idleTimeoutSeconds must be a non-negative integer");
+  }
+  const framing = FRAMINGS[options.format ?? "ndjson"];
+  return {
+    method: options.method ?? "GET",
+    path: options.path,
+    handler: async (request, context) => {
+      applyIdleTimeout(context.server, request, idleTimeoutSeconds);
+      const departed = new AbortController;
+      const iterable = await options.source(request, { ...context, signal: departed.signal });
+      const iterator = iterable[Symbol.asyncIterator]();
+      const encoder = new TextEncoder;
+      let heartbeat = null;
+      let closed = false;
+      const stopHeartbeat = () => {
+        if (heartbeat === null)
+          return;
+        clearInterval(heartbeat);
+        heartbeat = null;
+      };
+      const release = () => {
+        if (closed)
+          return;
+        closed = true;
+        try {
+          stopHeartbeat();
+          signalDemand();
+          departed.abort();
+          Promise.resolve(iterator.return?.(undefined)).catch(() => {
+            return;
+          });
+        } catch {}
+      };
+      let demand = null;
+      const signalDemand = () => {
+        const resolve2 = demand;
+        demand = null;
+        resolve2?.();
+      };
+      const stream = new ReadableStream({
+        start(controller) {
+          const send = (text) => {
+            if (closed)
+              return false;
+            try {
+              controller.enqueue(encoder.encode(text));
+              return true;
+            } catch {
+              release();
+              return false;
+            }
+          };
+          const finish = () => {
+            try {
+              controller.close();
+            } catch {}
+          };
+          if (request.signal.aborted) {
+            release();
+            finish();
+            return;
+          }
+          request.signal.addEventListener("abort", () => {
+            release();
+            finish();
+          });
+          send(framing.keepAlive);
+          heartbeat = setInterval(() => {
+            if ((controller.desiredSize ?? 1) > 0)
+              send(framing.keepAlive);
+          }, heartbeatMs);
+          unrefTimer(heartbeat);
+          const awaitDemand = async () => {
+            while (!closed && (controller.desiredSize ?? 1) <= 0) {
+              await new Promise((resolve2) => {
+                demand = resolve2;
+              });
+            }
+          };
+          let sinceYield = 0;
+          (async () => {
+            try {
+              for (;; ) {
+                await awaitDemand();
+                if (closed)
+                  return;
+                const next = await iterator.next();
+                if (closed)
+                  return;
+                if (next.done)
+                  break;
+                if (!send(framing.frame(next.value)))
+                  return;
+                sinceYield += 1;
+                if (sinceYield >= MAX_BUFFERED_FRAMES) {
+                  sinceYield = 0;
+                  await new Promise((resolve2) => {
+                    setTimeout(resolve2, 0);
+                  });
+                  if (closed)
+                    return;
+                }
+              }
+              if (framing.done)
+                send(framing.done);
+            } catch (error) {
+              if (!closed)
+                send(framing.frame(normalizeError(error).toJSON()));
+            } finally {
+              release();
+              finish();
+            }
+          })();
+        },
+        pull() {
+          signalDemand();
+        },
+        cancel() {
+          release();
+        }
+      }, { highWaterMark: MAX_BUFFERED_FRAMES });
+      return new Response(stream, { headers: responseHeaders(framing, options.headers) });
+    }
+  };
+}
+function ndjsonRoute(options) {
+  return streamingRoute({ ...options, format: "ndjson" });
+}
+function sseRoute(options) {
+  return streamingRoute({ ...options, format: "sse" });
+}
 export {
   AppError,
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
+  DEFAULT_STREAM_HEARTBEAT_MS,
   STITCH_ERROR_STATUS,
   ShutdownOptionsSchema,
   ShutdownResultSchema,
@@ -1068,6 +1259,7 @@ export {
   implementRegistry,
   isStitchErrorCode,
   isWithinDir,
+  ndjsonRoute,
   normalizeError,
   notFound,
   openApiRoute,
@@ -1084,8 +1276,10 @@ export {
   serveFile,
   signJwt,
   socketIoLane,
+  sseRoute,
   staticRoute,
   streamSSE,
+  streamingRoute,
   unauthorized,
   verifyJwt,
   verifyPkce,

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

@@ -1 +1 @@
-{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/server/socket-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,IAAI,SAAS,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,IAAI,cAAc,EAGzB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAc/D,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzD;;;;;OAKG;IACH,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,6EAA6E;IAC7E,aAAa,IAAI,IAAI,CAAC;IACtB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sEAAsE;IACtE,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CACnC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,KAAK,GAAG,GAAG,CACX,SAAQ,uBAAuB;IAC/B,+EAA+E;IAC/E,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC3E;AA0ID,wBAAsB,oBAAoB,CACxC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EAKpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,OAAO,EAEf,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,OAAO,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAmKpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,WAAW,CAAC,GAC3E,YAAY,CAMd"}
+{"version":3,"file":"socket-io.d.ts","sourceRoot":"","sources":["../../src/server/socket-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,IAAI,SAAS,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,IAAI,cAAc,EAGzB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAc/D,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzD;;;;;OAKG;IACH,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,6EAA6E;IAC7E,aAAa,IAAI,IAAI,CAAC;IACtB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sEAAsE;IACtE,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CACnC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EACpC,KAAK,GAAG,GAAG,CACX,SAAQ,uBAAuB;IAC/B,+EAA+E;IAC/E,EAAE,EAAE,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC3E;AA8HD,wBAAsB,oBAAoB,CACxC,aAAa,SAAS,cAAc,EACpC,aAAa,SAAS,cAAc,EAKpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,OAAO,EAEf,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,OAAO,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAmKpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,WAAW,CAAC,GAC3E,YAAY,CAMd"}

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

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/server/stream.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,QAAQ,CAmCtE;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,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,CAmCnB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/server/stream.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,QAAQ,CA2CtE;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,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,CAmCnB"}

package/dist/server/streaming-route.d.ts

@@ -0,0 +1,130 @@
+/**
+ * A long-lived response, with the three things everyone has to remember.
+ *
+ * `RawRoute` + `ctx.server` already gave every capability needed to serve a
+ * continuing NDJSON or SSE body. The problem was never capability — it was that
+ * the author of each such route had to independently remember three unrelated
+ * things, and forgetting any one of them breaks the stream **silently**:
+ *
+ * 1. **Clear the generic HTTP idle timeout.** Without `server.timeout(req, 0)`
+ *    Bun resets the connection after ten seconds. For a stream whose normal
+ *    state is silence — a subscription to a rare event, the log of an idle
+ *    process — that is a healthy connection being severed on a schedule.
+ * 2. **Send a heartbeat.** Even with the timeout cleared, intermediate proxies
+ *    and client stacks are under no obligation to hold a connection carrying no
+ *    bytes.
+ * 3. **Flush the headers at open.** A runtime does not send the response until
+ *    the body produces something, so the consumer's `fetch` does not return
+ *    until the first frame. On a quiet stream "subscribed and silent" becomes
+ *    indistinguishable from "not answering" — and there is nothing to inspect,
+ *    because there is no response yet.
+ *
+ * Each is obvious alone. Together they are a checklist that lived in the head
+ * of whoever wrote the route rather than in the types — and a route written
+ * later, doing the same job for another plane, got none of the three. Reviews
+ * did not catch it and neither did the tests, because every test published an
+ * event immediately and never lived long enough to reach the threshold. The
+ * shape of the defect is the point: not "done wrong", but "done incompletely,
+ * and the incompleteness is invisible".
+ *
+ * They are not independent, and the measurement is worth keeping: with a
+ * heartbeat under the threshold, point 1 does not change the outcome in
+ * process — either measure alone kept a connection alive through twelve
+ * seconds of silence, and only dropping both killed it. Point 1 earns its place
+ * against what a heartbeat cannot reach: a proxy or a client stack applying its
+ * own idle rule. Points 2 and 3 are each load-bearing on their own.
+ *
+ * A fourth thing is handled here that is easy to not even think of:
+ * **cancellation reaches the source.** When the consumer goes away, the async
+ * iterable is returned, so a departed subscriber does not leave live work
+ * running on the server.
+ */
+import type { HttpMethod } from '../contract/define';
+import type { RawRoute, RawRouteContext } from './types';
+/** How a value becomes bytes on the wire. The only thing the two formats differ in. */
+export type StreamingFormat = 'ndjson' | 'sse';
+/**
+ * Default heartbeat, deliberately well under Bun's ten-second idle threshold.
+ *
+ * A default at or near the threshold does not protect anything: the first
+ * pulse would arrive at about the moment the connection was already being
+ * dropped, so the option would look configured and do nothing.
+ */
+export declare const DEFAULT_STREAM_HEARTBEAT_MS = 5000;
+export interface StreamingRouteOptions<TServer = unknown> {
+    path: string;
+    /** Default `GET` — a subscription is a read. */
+    method?: HttpMethod | 'ALL';
+    /** Wire framing. Default `ndjson`. */
+    format?: StreamingFormat;
+    /**
+     * Interval between keep-alive frames while the source is silent. Default
+     * `DEFAULT_STREAM_HEARTBEAT_MS`. Must be finite and positive.
+     */
+    heartbeatMs?: number;
+    /**
+     * Per-request idle timeout in **seconds**, applied through the runtime's own
+     * per-request control where it has one (Bun). Default `0` — no timeout.
+     *
+     * Zero by default and not by accident. The generic timeout exists to reap
+     * connections whose peer has gone quiet, and a stream whose normal state is
+     * silence is the one case where that inference is wrong — which is the reason
+     * this primitive is being reached for at all. It is still a field, because
+     * removing a general limit is a decision worth being able to see and to
+     * override.
+     */
+    idleTimeoutSeconds?: number;
+    /**
+     * The frames. Returned as an async iterable so a generator is the natural
+     * way to write one.
+     *
+     * **A source that waits must honour `context.signal`.** See
+     * `StreamingSourceContext` — this is the one part of cancellation the
+     * primitive cannot do on the source's behalf.
+     */
+    source: (request: Request, context: StreamingSourceContext<TServer>) => AsyncIterable<unknown> | Promise<AsyncIterable<unknown>>;
+    /** Extra response headers. The framing headers below cannot be overridden. */
+    headers?: Record<string, string>;
+}
+/**
+ * What a source is given, and the reason the signal is not optional.
+ *
+ * Closing an async iterator is not enough to stop a source, and the mechanism
+ * is worth stating because the failure is silent. An async generator serialises
+ * its requests: `return()` issued while a `next()` is still in flight is
+ * QUEUED behind it. A subscription source's `next()` is in flight almost all
+ * the time — that is what a subscription is — so the return is queued behind a
+ * promise that will only settle when the next event arrives, which for a quiet
+ * plane may be never. `iterator.return()` is still called, because it does
+ * close a source suspended at a `yield`; it simply cannot interrupt one that is
+ * waiting.
+ *
+ * The signal is what can. It is aborted the moment the consumer goes away —
+ * through either route, a request abort or a stream cancel, which are not the
+ * same event — and a source that awaits on it stops immediately:
+ *
+ * ```ts
+ * ndjsonRoute({
+ *   path: '/events/subscribe',
+ *   source: async function* (request, { signal }) {
+ *     for await (const event of subscribe({ signal })) yield event
+ *   },
+ * })
+ * ```
+ */
+export interface StreamingSourceContext<TServer = unknown> extends RawRouteContext<TServer> {
+    /** Aborted when the consumer goes away. A waiting source must honour it. */
+    signal: AbortSignal;
+}
+/**
+ * A `RawRoute` serving a continuing body.
+ *
+ * @see ndjsonRoute
+ * @see sseRoute
+ */
+export declare function streamingRoute<TServer = unknown>(options: StreamingRouteOptions<TServer>): RawRoute<TServer>;
+/** A `streamingRoute` framed as newline-delimited JSON. Keep-alive is a blank line. */
+export declare function ndjsonRoute<TServer = unknown>(options: Omit<StreamingRouteOptions<TServer>, 'format'>): RawRoute<TServer>;
+/** A `streamingRoute` framed as Server-Sent Events — readable by `parseSSE`. */
+export declare function sseRoute<TServer = unknown>(options: Omit<StreamingRouteOptions<TServer>, 'format'>): RawRoute<TServer>;
+//# sourceMappingURL=streaming-route.d.ts.map

package/dist/server/streaming-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-route.d.ts","sourceRoot":"","sources":["../../src/server/streaming-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEzD,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,OAAO;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,KACrC,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,sBAAsB,CAAC,OAAO,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,OAAO,CAAC;IACzF,4EAA4E;IAC5E,MAAM,EAAE,WAAW,CAAC;CACrB;AAiGD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAG,OAAO,EAC9C,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,GACtC,QAAQ,CAAC,OAAO,CAAC,CAgNnB;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,OAAO,GAAG,OAAO,EAC3C,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,QAAQ,CAAC,OAAO,CAAC,CAEnB;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,OAAO,GAAG,OAAO,EACxC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACtD,QAAQ,CAAC,OAAO,CAAC,CAEnB"}

package/dist/testing.js

@@ -4,7 +4,7 @@ import {
 } from "./index-vtjgx3vv.js";
 import {
   createApplication
-} from "./index-1zencgcb.js";
+} from "./index-eabpd4tb.js";
 import"./index-8eywc9zv.js";
 import {
   RealtimeRequestDisconnectedError,
@@ -32,6 +32,7 @@ import {
 import {
   isRecord
 } from "./index-smpbdg6k.js";
+import"./index-xxye8j3k.js";
 
 // src/agent-runtime/testing.ts
 function createAgentRaceBarrier(timeoutMs = 5000) {