opinionated-machine 10.5.0 → 11.2.0

package/dist/lib/api-contracts/apiSseConnectionRegistry.js

@@ -0,0 +1,332 @@
+export class ApiSseConnectionRegistry {
+    connections = new Map();
+    /** In-flight async joins per connection id. Empty for a synchronous verdict. */
+    pendingJoins = new Map();
+    broadcaster;
+    constructor(broadcaster) {
+        this.broadcaster = broadcaster;
+        broadcaster.registerSender((connectionId, message) => {
+            const connection = this.connections.get(connectionId);
+            return connection ? connection.send(message) : Promise.resolve(false);
+        });
+    }
+    /**
+     * Register an active SSE connection with its send function.
+     * The send function must return `false` (not throw) on delivery failure so
+     * room broadcasts keep fanning out to the remaining connections.
+     *
+     * Pass `close` to make the connection evictable — without it {@link evict}
+     * can stop delivery but cannot terminate the stream.
+     */
+    register(connectionId, send, close) {
+        this.connections.set(connectionId, { send, ...(close !== undefined ? { close } : {}) });
+    }
+    /**
+     * Remove a connection: drops the sender, leaves all rooms, and clears the
+     * broadcaster's dedup cache for the connection.
+     */
+    unregister(connectionId) {
+        // Drop the map entry too: a verdict that never resolves would otherwise
+        // keep the id and its tokens alive after the session is gone. Cancellation
+        // lives on the token object the join closure captured, so a late verdict
+        // still settles as cancelled without the map.
+        this.cancelPendingJoins(connectionId);
+        this.pendingJoins.delete(connectionId);
+        this.connections.delete(connectionId);
+        this.broadcaster.roomManager.leaveAll(connectionId);
+        this.broadcaster.cleanupConnection(connectionId);
+    }
+    /**
+     * Record an async `authorizeJoin` verdict that is still in flight, so a
+     * revocation arriving before it resolves can cancel it.
+     *
+     * Pair every call with {@link settlePendingJoin}; the room wiring in
+     * {@link withSessionRooms} does this for routes.
+     */
+    beginPendingJoin(connectionId, room) {
+        const pending = { room, cancelled: false };
+        const existing = this.pendingJoins.get(connectionId);
+        if (existing)
+            existing.push(pending);
+        else
+            this.pendingJoins.set(connectionId, [pending]);
+        return pending;
+    }
+    /**
+     * Retire an in-flight join.
+     *
+     * @returns `true` when the join is still valid and may be applied, `false`
+     *   when it was cancelled while the verdict was pending.
+     */
+    settlePendingJoin(connectionId, pending) {
+        const list = this.pendingJoins.get(connectionId);
+        if (list) {
+            const index = list.indexOf(pending);
+            if (index !== -1)
+                list.splice(index, 1);
+            if (list.length === 0)
+                this.pendingJoins.delete(connectionId);
+        }
+        return !pending.cancelled;
+    }
+    /**
+     * Cancel in-flight joins for a connection — all of them, or only those for
+     * one room. A cancelled join is dropped when its verdict resolves.
+     *
+     * @returns How many joins were cancelled.
+     */
+    cancelPendingJoins(connectionId, room) {
+        const list = this.pendingJoins.get(connectionId);
+        if (!list)
+            return 0;
+        let cancelled = 0;
+        for (const pending of list) {
+            if (room !== undefined && pending.room !== room)
+                continue;
+            if (pending.cancelled)
+                continue;
+            pending.cancelled = true;
+            cancelled += 1;
+        }
+        return cancelled;
+    }
+    /**
+     * Terminate one connection: leave its rooms, stop delivering to it, and
+     * close its stream.
+     *
+     * This is the revocation path. Authorization is checked when a stream opens
+     * and then goes stale, so removing a principal's access has to be able to
+     * end the streams that access already opened; without a call like this, a
+     * revoked user keeps receiving broadcasts until they close the tab.
+     *
+     * A client that reconnects (as `@opinionated-machine/sse-fallback` does)
+     * comes back through the route's own authorization, so an eviction of a
+     * still-authorized principal costs a reconnect, not a broken surface.
+     *
+     * @returns `true` when a connection was registered under that id.
+     */
+    evict(connectionId) {
+        const connection = this.connections.get(connectionId);
+        if (!connection)
+            return false;
+        // Leave rooms first: a broadcast racing the close must not reach a
+        // connection that is being revoked. An async join still awaiting its
+        // verdict has to go too, or it rejoins a room after the eviction.
+        // Deleting the map entry is safe for the same reason as in `unregister`.
+        this.cancelPendingJoins(connectionId);
+        this.pendingJoins.delete(connectionId);
+        this.broadcaster.roomManager.leaveAll(connectionId);
+        this.connections.delete(connectionId);
+        this.broadcaster.cleanupConnection(connectionId);
+        connection.close?.();
+        return true;
+    }
+    /**
+     * Remove one connection from one room, leaving its other rooms and its
+     * stream intact. For revoking access to a single scope.
+     *
+     * A join whose async `authorizeJoin` verdict is still pending counts as
+     * membership here: the connection is not in the room yet, but it is about to
+     * be, and letting that land after a revocation would undo it.
+     *
+     * @returns `true` when the connection was in the room, or was on its way in.
+     */
+    evictFromRoom(room, connectionId) {
+        const cancelled = this.cancelPendingJoins(connectionId, room) > 0;
+        if (!this.broadcaster.roomManager.isInRoom(connectionId, room))
+            return cancelled;
+        this.broadcaster.roomManager.leave(connectionId, room);
+        return true;
+    }
+    /**
+     * Evict every connection currently in a room, terminating their streams.
+     * For revoking a whole scope (a deleted project, a disbanded team).
+     *
+     * Only connections on THIS node are closed — room membership elsewhere in
+     * the cluster is another node's registry to evict, so a revocation event
+     * has to reach every node.
+     *
+     * Joins still awaiting an async `authorizeJoin` verdict are cancelled rather
+     * than evicted: they hold no membership yet, so the revocation just denies
+     * them the room and leaves their other rooms and their stream alone. They
+     * are not counted in the return value for the same reason.
+     *
+     * @returns How many connections were evicted here.
+     */
+    closeRoom(room) {
+        let evicted = 0;
+        for (const connectionId of this.broadcaster.roomManager.getConnectionsInRoom(room)) {
+            if (this.evict(connectionId))
+                evicted += 1;
+        }
+        for (const connectionId of this.pendingJoins.keys()) {
+            this.cancelPendingJoins(connectionId, room);
+        }
+        return evicted;
+    }
+}
+const registries = new WeakMap();
+/**
+ * Get (or lazily create) the shared registry for a broadcaster.
+ * Ensures `registerSender` is called exactly once per broadcaster no matter
+ * how many routes opt into rooms.
+ */
+export function getApiSseConnectionRegistry(broadcaster) {
+    let registry = registries.get(broadcaster);
+    if (!registry) {
+        registry = new ApiSseConnectionRegistry(broadcaster);
+        registries.set(broadcaster, registry);
+    }
+    return registry;
+}
+const NOOP_ROOMS = { join: () => { }, leave: () => { } };
+/**
+ * Room operations per live session.
+ *
+ * `@lokalise/fastify-api-contracts` owns the `SSESession` shape and has no
+ * `rooms` field, so the operations live beside the session rather than on it.
+ * The map is weak: entries disappear with the session object, independently of
+ * the explicit cleanup done on close.
+ */
+const sessionRooms = new WeakMap();
+/**
+ * Room operations for an SSE session opened by a `buildApiRoute` route.
+ *
+ * Returns no-ops when the route did not pass `sseRooms` — mirroring the legacy
+ * `session.rooms` accessor, which is inert on controllers without a broadcaster.
+ *
+ * @example
+ * ```ts
+ * const session = sse.start('keepAlive')
+ * getSessionRooms(session).join(`project:${request.params.projectId}`)
+ * ```
+ */
+export function getSessionRooms(session) {
+    return sessionRooms.get(session) ?? NOOP_ROOMS;
+}
+function normalizeRoomsOptions(config) {
+    return 'broadcaster' in config ? config : { broadcaster: config };
+}
+/** Per-session lifetime timers, cleared when the session closes. */
+const lifetimeTimers = new WeakMap();
+/**
+ * Compose room wiring into a route's SSE lifecycle hooks.
+ *
+ * On connect the session is registered with the broadcaster's registry and its
+ * room operations are published for {@link getSessionRooms}; on close the
+ * connection is unregistered (rooms left, dedup cache cleared). The route's own
+ * `onConnect` / `onClose` hooks still run — room wiring is applied first on
+ * connect (so a hook can already join rooms) and last on close.
+ *
+ * `onConnect` is invoked synchronously by the package's `sse.start()`, so the
+ * registration is in place before `start()` returns to the handler.
+ *
+ * Pass {@link SSERoomsOptions} instead of a bare broadcaster to add an
+ * `authorizeJoin` scope check or a `maxSessionLifetimeMs` bound.
+ */
+export function withSessionRooms(config, options) {
+    const { broadcaster, authorizeJoin, maxSessionLifetimeMs } = normalizeRoomsOptions(config);
+    const registry = getApiSseConnectionRegistry(broadcaster);
+    const { onConnect, onClose } = options;
+    return {
+        ...options,
+        onConnect: (session) => {
+            registry.register(session.id, (message) => 
+            // The session's `send` validates against the contract's event schemas and
+            // throws on a mismatch. A broadcaster sender must not throw — one bad
+            // message would abort the fan-out for every other connection — so the
+            // failure is logged and reported as an undelivered message instead.
+            session.send(message.event ?? '', message.data, { id: message.id, retry: message.retry }).catch((err) => {
+                session.request.log.error({ err, event: message.event }, 'SSE room broadcast rejected for connection');
+                return false;
+            }), () => session.close());
+            if (maxSessionLifetimeMs !== undefined) {
+                const timer = setTimeout(() => {
+                    if (!session.isConnected())
+                        return;
+                    session.request.log.info({ connectionId: session.id, maxSessionLifetimeMs }, 'closing SSE session at its lifetime bound');
+                    session.close();
+                }, maxSessionLifetimeMs);
+                timer.unref?.();
+                lifetimeTimers.set(session, timer);
+            }
+            const joinRoom = (room) => {
+                // Guard against startup races where the stream is already dead:
+                // joining such a session would leave stale room members behind.
+                if (!session.isConnected())
+                    return;
+                broadcaster.roomManager.join(session.id, room);
+            };
+            const denied = (room, err) => {
+                session.request.log.warn({ connectionId: session.id, room, ...(err !== undefined ? { err } : {}) }, 'SSE room join refused by authorizeJoin');
+            };
+            const authorizeAndJoin = (room) => {
+                if (!authorizeJoin) {
+                    joinRoom(room);
+                    return;
+                }
+                let verdict;
+                try {
+                    verdict = authorizeJoin(session, room);
+                }
+                catch (err) {
+                    denied(room, err);
+                    return;
+                }
+                if (verdict === true) {
+                    joinRoom(room);
+                    return;
+                }
+                if (verdict === false) {
+                    denied(room);
+                    return;
+                }
+                // The verdict lands after join() has returned, so a leave, an eviction
+                // or a closed room in the meantime must be able to call it off —
+                // otherwise the resolved verdict re-adds the connection and quietly
+                // undoes the revocation. The registry owns that token because those
+                // calls come through it, not through this closure.
+                const pending = registry.beginPendingJoin(session.id, room);
+                void verdict.then((allowed) => {
+                    if (!registry.settlePendingJoin(session.id, pending))
+                        return;
+                    if (allowed)
+                        joinRoom(room);
+                    else
+                        denied(room);
+                }, (err) => {
+                    registry.settlePendingJoin(session.id, pending);
+                    denied(room, err);
+                });
+            };
+            sessionRooms.set(session, {
+                join: (room) => {
+                    for (const name of Array.isArray(room) ? room : [room])
+                        authorizeAndJoin(name);
+                },
+                leave: (room) => {
+                    for (const name of Array.isArray(room) ? room : [room]) {
+                        registry.cancelPendingJoins(session.id, name);
+                    }
+                    broadcaster.roomManager.leave(session.id, room);
+                },
+            });
+            return onConnect?.(session);
+        },
+        onClose: async (session, initiator) => {
+            try {
+                await onClose?.(session, initiator);
+            }
+            finally {
+                const timer = lifetimeTimers.get(session);
+                if (timer !== undefined) {
+                    clearTimeout(timer);
+                    lifetimeTimers.delete(session);
+                }
+                sessionRooms.delete(session);
+                registry.unregister(session.id);
+            }
+        },
+    };
+}
+//# sourceMappingURL=apiSseConnectionRegistry.js.map

package/dist/lib/api-contracts/apiSseConnectionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiSseConnectionRegistry.js","sourceRoot":"","sources":["../../../lib/api-contracts/apiSseConnectionRegistry.ts"],"names":[],"mappings":"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"}

package/dist/lib/api-contracts/index.d.ts

@@ -1,4 +1,5 @@
 export type { ApiHandlerContext, ApiHandlerReply, InferApiHandler, InferApiHandlerRequest, InferApiHandlerResult, InferContractResponseContentTypes, } from '@lokalise/fastify-api-contracts';
 export { AbstractApiController } from './AbstractApiController.ts';
 export { type ApiRouteOptions, buildApiRoute } from './apiRouteBuilder.ts';
+export { ApiSseConnectionRegistry, getApiSseConnectionRegistry, getSessionRooms, type PendingJoin, type SSERoomsOptions, withSessionRooms, } from './apiSseConnectionRegistry.ts';
 export { asApiControllerClass } from './asApiControllerClass.ts';

package/dist/lib/api-contracts/index.js

@@ -1,4 +1,5 @@
 export { AbstractApiController } from "./AbstractApiController.js";
 export { buildApiRoute } from "./apiRouteBuilder.js";
+export { ApiSseConnectionRegistry, getApiSseConnectionRegistry, getSessionRooms, withSessionRooms, } from "./apiSseConnectionRegistry.js";
 export { asApiControllerClass } from "./asApiControllerClass.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/api-contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/api-contracts/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAwB,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/api-contracts/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAwB,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,eAAe,EAGf,gBAAgB,GACjB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/lib/gateway/gatewayMetadata.d.ts

@@ -70,6 +70,7 @@ export declare const gatewayMetadataSchema: z.ZodObject<{
         request: z.ZodOptional<z.ZodString>;
         idle: z.ZodOptional<z.ZodString>;
         connect: z.ZodOptional<z.ZodString>;
+        maxDuration: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     retry: z.ZodOptional<z.ZodObject<{
         attempts: z.ZodOptional<z.ZodNumber>;

package/dist/lib/gateway/gatewayMetadata.js

@@ -37,6 +37,17 @@ const timeoutsSchema = z
     request: durationSchema.optional(),
     idle: durationSchema.optional(),
     connect: durationSchema.optional(),
+    /**
+     * Hard ceiling on the total lifetime of one connection, for streaming
+     * routes where `request` is unusable (it would cut a healthy stream) and
+     * `idle` is disabled (heartbeats are the liveness bound).
+     *
+     * Authorization is checked when a stream opens and then goes stale: a user
+     * removed from a project keeps receiving events for as long as the stream
+     * lives. A finite lifetime forces a reconnect, which re-authorizes with a
+     * fresh token, so this is the revocation backstop. `'0s'` opts out.
+     */
+    maxDuration: durationSchema.optional(),
 })
     .strict();
 const retrySchema = z

package/dist/lib/gateway/gatewayMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"gatewayMetadata.js","sourceRoot":"","sources":["../../../lib/gateway/gatewayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE;IAChE,OAAO,EAAE,4EAA4E;CACtF,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAChC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAChC,CAAC,CAAA;AAGF,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AAE7F,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;IACzD,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC7D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClF,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,EAAE,EAAE,CAAC;SACF,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;SACpF,QAAQ,EAAE;IACb,aAAa,EAAE,cAAc,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC;SAC3E,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACtD,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC;IACjC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACf,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACzC,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/C,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACxC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CAC/C,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5F,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;KACpC,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,GAAG,EAAE,cAAc;IACnB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAChD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAChD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;AAE3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IAEjC,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAE/C,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IAEjC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAE7B,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IAEjC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAA"}
+{"version":3,"file":"gatewayMetadata.js","sourceRoot":"","sources":["../../../lib/gateway/gatewayMetadata.ts"],"names":[],"mappings":"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"}

package/dist/lib/gateway/index.d.ts

@@ -5,4 +5,5 @@ export type { ContractHeaderKey, ContractQueryKey, GatewayMetadata, } from './ga
 export { type BuildGatewayManifestOptions, buildGatewayManifestFrom, type CollectedController, } from './manifest/buildManifest.ts';
 export { type GatewayManifest, type GatewayManifestRoute, gatewayManifestRouteSchema, gatewayManifestSchema, } from './manifest/manifestSchema.ts';
 export { normalizePath } from './manifest/pathNormalize.ts';
+export { attachRouteStreamingMode, ROUTE_STREAMING_DEFAULT_MODE_SYMBOL, ROUTE_STREAMING_SYMBOL, type RouteStreamingDefaultMode, type RouteStreamingMode, readRouteStreamingDefaultMode, readRouteStreamingMode, } from './routeStreaming.ts';
 export { readGatewayMetadata, withGatewayMetadata } from './withGatewayMetadata.ts';

package/dist/lib/gateway/index.js

@@ -4,5 +4,6 @@ export { GATEWAY_METADATA_SYMBOL } from "./gatewaySymbol.js";
 export { buildGatewayManifestFrom, } from "./manifest/buildManifest.js";
 export { gatewayManifestRouteSchema, gatewayManifestSchema, } from "./manifest/manifestSchema.js";
 export { normalizePath } from "./manifest/pathNormalize.js";
+export { attachRouteStreamingMode, ROUTE_STREAMING_DEFAULT_MODE_SYMBOL, ROUTE_STREAMING_SYMBOL, readRouteStreamingDefaultMode, readRouteStreamingMode, } from "./routeStreaming.js";
 export { readGatewayMetadata, withGatewayMetadata } from "./withGatewayMetadata.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/gateway/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,oBAAoB,GACrB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAEL,cAAc,EAEd,qBAAqB,EAErB,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAM5D,OAAO,EAEL,wBAAwB,GAEzB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAGL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,oBAAoB,GACrB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAEL,cAAc,EAEd,qBAAqB,EAErB,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAM5D,OAAO,EAEL,wBAAwB,GAEzB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAGL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,sBAAsB,EAGtB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/lib/gateway/manifest/buildManifest.d.ts

@@ -1,5 +1,7 @@
 import type { AbstractController } from '../../AbstractController.ts';
 import type { AbstractApiController } from '../../api-contracts/AbstractApiController.ts';
+import type { AbstractDualModeController } from '../../dualmode/AbstractDualModeController.ts';
+import type { AbstractSSEController } from '../../sse/AbstractSSEController.ts';
 import type { GatewayMetadataValue } from '../gatewayMetadata.ts';
 import { type GatewayManifest } from './manifestSchema.ts';
 export type BuildGatewayManifestOptions = {
@@ -9,6 +11,14 @@ export type BuildGatewayManifestOptions = {
     version?: string;
     /** Service-wide metadata defaults; merged underneath controller- and route-level metadata. */
     defaults?: GatewayMetadataValue;
+    /**
+     * Include routes from legacy `AbstractSSEController` /
+     * `AbstractDualModeController` controllers in the manifest (marked with
+     * `streaming: 'sse' | 'dual'`). Off by default so existing manifests don't
+     * silently gain routes; routes declared through `AbstractApiController` are
+     * always included regardless of this flag.
+     */
+    includeStreamingControllers?: boolean;
 };
 /**
  * Anything resolved from the DI container that may carry routes + gateway defaults.
@@ -26,6 +36,14 @@ type CollectedController = {
     name: string;
     kind: 'api';
     controller: AbstractApiController<any>;
+} | {
+    name: string;
+    kind: 'sse-legacy';
+    controller: AbstractSSEController<any>;
+} | {
+    name: string;
+    kind: 'dualmode-legacy';
+    controller: AbstractDualModeController<any>;
 };
 /**
  * Pure manifest builder. Takes already-resolved controllers; performs no DI.

package/dist/lib/gateway/manifest/buildManifest.js

@@ -1,4 +1,6 @@
 import { merge } from 'ts-deepmerge';
+import { buildFastifyRoute } from "../../routes/fastifyRouteBuilder.js";
+import { readRouteStreamingDefaultMode, readRouteStreamingMode } from "../routeStreaming.js";
 import { readGatewayMetadata } from "../withGatewayMetadata.js";
 import { gatewayManifestSchema, } from "./manifestSchema.js";
 import { normalizePath } from "./pathNormalize.js";
@@ -28,12 +30,40 @@ function collectRouteEntries(collected) {
         const built = collected.controller.buildRoutes();
         return Object.entries(built).map(([routeKey, route]) => ({ routeKey, route }));
     }
+    if (collected.kind === 'sse-legacy' || collected.kind === 'dualmode-legacy') {
+        // Legacy streaming controllers return branded handler containers; build
+        // the Fastify RouteOptions from them (pure construction — no side
+        // effects, no registration) so path/method/streaming can be read.
+        const routeConfigs = collected.kind === 'sse-legacy'
+            ? collected.controller.buildSSERoutes()
+            : collected.controller.buildDualModeRoutes();
+        return Object.entries(routeConfigs).map(([routeKey, routeConfig]) => ({
+            routeKey,
+            // biome-ignore lint/suspicious/noExplicitAny: overload selection erased at the manifest boundary
+            route: buildFastifyRoute(collected.controller, routeConfig),
+        }));
+    }
     // AbstractApiController: routes is a Record — key becomes the routeKey.
     return Object.entries(collected.controller.routes).map(([routeKey, route]) => ({
         routeKey,
         route,
     }));
 }
+/**
+ * The manifest's streaming fields for one Fastify route, read back from the
+ * markers the route builders stamped.
+ */
+function readStreamingFields(route) {
+    const streaming = readRouteStreamingMode(route);
+    if (streaming === undefined)
+        return {};
+    const defaultMode = readRouteStreamingDefaultMode(route);
+    // Only a dual route negotiates, so a fallback branch is meaningless on an
+    // SSE-only one.
+    return streaming === 'dual' && defaultMode !== undefined
+        ? { streaming, streamingDefaultMode: defaultMode }
+        : { streaming };
+}
 /**
  * Pure manifest builder. Takes already-resolved controllers; performs no DI.
  *
@@ -69,6 +99,7 @@ export function buildGatewayManifestFrom(controllers, options) {
                 path,
                 controller: collected.name,
                 routeKey,
+                ...readStreamingFields(route),
                 metadata: merged,
             });
         }

package/dist/lib/gateway/manifest/buildManifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildManifest.js","sourceRoot":"","sources":["../../../../lib/gateway/manifest/buildManifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buildManifest.js","sourceRoot":"","sources":["../../../../lib/gateway/manifest/buildManifest.ts"],"names":[],"mappings":"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"}

package/dist/lib/gateway/manifest/manifestSchema.d.ts

@@ -13,6 +13,14 @@ export declare const gatewayManifestRouteSchema: z.ZodObject<{
     path: z.ZodString;
     controller: z.ZodString;
     routeKey: z.ZodString;
+    streaming: z.ZodOptional<z.ZodEnum<{
+        sse: "sse";
+        dual: "dual";
+    }>>;
+    streamingDefaultMode: z.ZodOptional<z.ZodEnum<{
+        sse: "sse";
+        "non-sse": "non-sse";
+    }>>;
     metadata: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         upstream: z.ZodOptional<z.ZodString>;
@@ -59,6 +67,7 @@ export declare const gatewayManifestRouteSchema: z.ZodObject<{
             request: z.ZodOptional<z.ZodString>;
             idle: z.ZodOptional<z.ZodString>;
             connect: z.ZodOptional<z.ZodString>;
+            maxDuration: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         retry: z.ZodOptional<z.ZodObject<{
             attempts: z.ZodOptional<z.ZodNumber>;
@@ -169,6 +178,14 @@ export declare const gatewayManifestSchema: z.ZodObject<{
         path: z.ZodString;
         controller: z.ZodString;
         routeKey: z.ZodString;
+        streaming: z.ZodOptional<z.ZodEnum<{
+            sse: "sse";
+            dual: "dual";
+        }>>;
+        streamingDefaultMode: z.ZodOptional<z.ZodEnum<{
+            sse: "sse";
+            "non-sse": "non-sse";
+        }>>;
         metadata: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             upstream: z.ZodOptional<z.ZodString>;
@@ -215,6 +232,7 @@ export declare const gatewayManifestSchema: z.ZodObject<{
                 request: z.ZodOptional<z.ZodString>;
                 idle: z.ZodOptional<z.ZodString>;
                 connect: z.ZodOptional<z.ZodString>;
+                maxDuration: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>;
             retry: z.ZodOptional<z.ZodObject<{
                 attempts: z.ZodOptional<z.ZodNumber>;

package/dist/lib/gateway/manifest/manifestSchema.js

@@ -12,6 +12,33 @@ export const gatewayManifestRouteSchema = z
     controller: z.string(),
     /** Key of the route inside the controller (`buildRoutes` map key, or array index for `AbstractApiController`). */
     routeKey: z.string(),
+    /**
+     * How the route responds on the success path: `'sse'` (always streams) or
+     * `'dual'` (Accept-negotiated, stream or not). Absent for routes that
+     * answer in a single response. Generators use this to apply
+     * streaming-appropriate timeouts and disable response buffering.
+     *
+     * Success path only: a 4xx or 5xx is an ordinary JSON response on a
+     * streaming route too, so a generator may size timeouts from this but must
+     * not assume the content type of a failure.
+     *
+     * Additive optional field — manifests remain `manifestVersion: '1'`.
+     * Because the schemas are `.strict()`, generators must run against a
+     * library version that knows every field the manifest may carry (the
+     * gateway packages' peerDependency floor tracks this).
+     */
+    streaming: z.enum(['sse', 'dual']).optional(),
+    /**
+     * For `streaming: 'dual'` routes, which branch serves a request whose
+     * `Accept` header names neither type (absent, or a wildcard). Mirrors the
+     * route's `defaultMode` option. Absent means `'non-sse'`.
+     *
+     * A generator that splits a dual route into a stream branch and a
+     * catch-all needs this: with `'sse'` the catch-all is the STREAM, and
+     * routing it as non-streaming would put a request timeout on a long-lived
+     * stream.
+     */
+    streamingDefaultMode: z.enum(['non-sse', 'sse']).optional(),
     /** Already-merged metadata: service defaults → controller defaults → route. */
     metadata: gatewayMetadataSchema,
 })