@xemahq/realtime-stream 0.1.1

package/dist/lib/realtime-fanout.service.js

@@ -0,0 +1,384 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RealtimeFanoutService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeFanoutService = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_os_1 = require("node:os");
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const control_frame_1 = require("./control-frame");
+const frame_authz_1 = require("./frame-authz");
+const tokens_1 = require("./tokens");
+let RealtimeFanoutService = RealtimeFanoutService_1 = class RealtimeFanoutService {
+    options;
+    membership;
+    hubSource;
+    logger = new common_1.Logger(RealtimeFanoutService_1.name);
+    connections = new Map();
+    heartbeatIntervalMs;
+    maxConnections;
+    podId;
+    lifecycleListener;
+    heartbeatTimer = null;
+    stopHubSource = null;
+    constructor(options, membership, hubSource) {
+        this.options = options;
+        this.membership = membership;
+        this.hubSource = hubSource;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? 15_000;
+        this.maxConnections = options.maxConnectionsPerPod ?? 5_000;
+        this.podId = options.podId ?? `${(0, node_os_1.hostname)?.() ?? 'pod'}-${process.pid}`;
+        this.lifecycleListener = options.connectionLifecycleListener;
+    }
+    async onModuleInit() {
+        this.heartbeatTimer = setInterval(() => this.broadcastHeartbeat(), this.heartbeatIntervalMs);
+        const initial = this.options.initialFromGlobalSeq ?? '0';
+        this.stopHubSource = await this.hubSource.open(initial, (env) => this.onUpstreamEnvelope(env), () => this.onUpstreamResync(), (err) => this.onUpstreamError(err));
+        this.logger.log({
+            message: 'RealtimeFanoutService started',
+            podId: this.podId,
+            heartbeatIntervalMs: this.heartbeatIntervalMs,
+            maxConnections: this.maxConnections,
+            initialCursor: initial,
+        });
+    }
+    onModuleDestroy() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.stopHubSource) {
+            try {
+                this.stopHubSource();
+            }
+            catch (err) {
+                this.logger.warn({
+                    message: 'hub-source stop hook threw',
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            this.stopHubSource = null;
+        }
+        for (const conn of this.connections.values()) {
+            this.emitControl(conn, {
+                type: control_frame_1.ControlFrameType.GOODBYE,
+                reason: 'shutdown',
+            });
+            conn.subject.complete();
+        }
+        this.connections.clear();
+    }
+    openConnection(input) {
+        if (this.connections.size >= this.maxConnections) {
+            throw new common_1.ServiceUnavailableException(`Pod ${this.podId} at max realtime connections (${this.maxConnections}).`);
+        }
+        const id = (0, node_crypto_1.randomUUID)();
+        const subject = new rxjs_1.Subject();
+        const record = {
+            id,
+            caller: input.caller,
+            subject,
+            projectSubs: new Map(),
+            sessionSubs: new Map(),
+            mode: input.mode,
+            ...(input.dedicatedSessionId !== undefined
+                ? { dedicatedSessionId: input.dedicatedSessionId }
+                : {}),
+            cursors: { ...input.initialCursors },
+        };
+        this.connections.set(id, record);
+        const stream = new rxjs_1.Observable((sub) => {
+            this.emitConnected(record, sub);
+            const inner = subject.subscribe({
+                next: (frame) => sub.next(frame),
+                complete: () => sub.complete(),
+                error: (err) => sub.error(err),
+            });
+            return () => {
+                inner.unsubscribe();
+                this.closeConnection(id);
+            };
+        });
+        this.logger.debug({
+            message: 'connection opened',
+            connectionId: id,
+            orgId: input.caller.orgId,
+            userId: input.caller.userId,
+            mode: input.mode,
+            ...(input.dedicatedSessionId !== undefined
+                ? { dedicatedSessionId: input.dedicatedSessionId }
+                : {}),
+        });
+        this.fireLifecycle('onOpen', record);
+        return { connectionId: id, stream };
+    }
+    closeConnection(connectionId) {
+        const record = this.connections.get(connectionId);
+        if (!record)
+            return;
+        this.connections.delete(connectionId);
+        record.subject.complete();
+        this.fireLifecycle('onClose', record);
+    }
+    async addSubscription(connectionId, scope) {
+        const conn = this.connections.get(connectionId);
+        if (!conn) {
+            throw new Error(`No connection ${connectionId}.`);
+        }
+        if (conn.mode !== 'unified') {
+            throw new Error('Scope subscriptions are only valid on the unified stream.');
+        }
+        if (scope.kind === 'project') {
+            const ok = await this.membership.hasProjectAccess(conn.caller, scope.id);
+            if (!ok) {
+                this.emitControl(conn, {
+                    type: control_frame_1.ControlFrameType.SCOPE_DENIED,
+                    scope,
+                    reason: 'no-project-access',
+                });
+                throw new Error(`Caller lacks project access for ${scope.id}.`);
+            }
+            conn.projectSubs.set(scope.id, true);
+        }
+        else {
+            const ok = await this.membership.hasSessionAccess(conn.caller, scope.id);
+            if (!ok) {
+                this.emitControl(conn, {
+                    type: control_frame_1.ControlFrameType.SCOPE_DENIED,
+                    scope,
+                    reason: 'no-session-access',
+                });
+                throw new Error(`Caller lacks session access for ${scope.id}.`);
+            }
+            conn.sessionSubs.set(scope.id, true);
+        }
+        const cursor = this.cursorForScope(conn.cursors, scope) ?? '0';
+        this.emitControl(conn, {
+            type: control_frame_1.ControlFrameType.SUBSCRIBED,
+            scope,
+            cursor,
+        });
+    }
+    removeSubscription(connectionId, scope) {
+        const conn = this.connections.get(connectionId);
+        if (!conn)
+            return;
+        if (scope.kind === 'project') {
+            conn.projectSubs.delete(scope.id);
+        }
+        else {
+            conn.sessionSubs.delete(scope.id);
+        }
+        this.emitControl(conn, {
+            type: control_frame_1.ControlFrameType.UNSUBSCRIBED,
+            scope,
+        });
+    }
+    onUpstreamEnvelope(envelope) {
+        const env = envelope;
+        if (!env.ehorgid || !env.ehvisibility || !env.type)
+            return;
+        for (const conn of this.connections.values()) {
+            if (env.ehorgid !== conn.caller.orgId)
+                continue;
+            const sessionId = (0, frame_authz_1.sessionIdFromSubject)(env.subject);
+            if (conn.mode === 'session') {
+                if (!conn.dedicatedSessionId || sessionId !== conn.dedicatedSessionId) {
+                    continue;
+                }
+                if (env.ehvisibility !== 'user' && env.ehvisibility !== 'project') {
+                    continue;
+                }
+                if (env.ehvisibility === 'user' &&
+                    env.ehuserid !== conn.caller.userId) {
+                    continue;
+                }
+                this.deliverEnvelope(conn, env);
+                continue;
+            }
+            const hasProject = env.ehprojectid !== undefined &&
+                conn.projectSubs.has(env.ehprojectid);
+            const hasSession = sessionId !== null && conn.sessionSubs.has(sessionId);
+            const activeSessions = Array.from(conn.sessionSubs.keys());
+            const allowed = (0, frame_authz_1.envelopeAuthorizedForCaller)(env, conn.caller, { hasProject, hasSession }, activeSessions);
+            if (!allowed)
+                continue;
+            this.deliverEnvelope(conn, env);
+        }
+    }
+    onUpstreamResync() {
+        for (const conn of this.connections.values()) {
+            this.emitControl(conn, {
+                type: control_frame_1.ControlFrameType.RESYNC,
+                reason: 'hub-window-exceeded',
+            });
+            conn.subject.complete();
+        }
+        this.connections.clear();
+    }
+    onUpstreamError(err) {
+        this.logger.error({
+            message: 'Upstream event-hub SSE terminated mid-flight — fan-out cannot continue; shutting down for k8s restart',
+            error: err.message,
+            activeConnections: this.connections.size,
+        });
+        for (const conn of this.connections.values()) {
+            this.emitControl(conn, {
+                type: control_frame_1.ControlFrameType.GOODBYE,
+                reason: 'upstream-failure',
+            });
+            conn.subject.complete();
+        }
+        this.connections.clear();
+        setImmediate(() => {
+            process.exit(1);
+        });
+    }
+    deliverEnvelope(conn, env) {
+        advanceCursors(conn, env);
+        const seq = env.ehglobalseq;
+        const id = typeof seq === 'string' ? seq : undefined;
+        conn.subject.next({
+            type: 'message',
+            ...(id !== undefined ? { id } : {}),
+            data: env,
+        });
+    }
+    emitConnected(conn, sub) {
+        sub.next({
+            type: control_frame_1.ControlFrameType.CONNECTED,
+            data: {
+                type: control_frame_1.ControlFrameType.CONNECTED,
+                connectionId: conn.id,
+                serverTime: new Date().toISOString(),
+                cursors: conn.cursors,
+            },
+        });
+    }
+    emitControl(conn, frame) {
+        conn.subject.next({ type: frame.type, data: frame });
+    }
+    broadcastHeartbeat() {
+        if (this.connections.size === 0)
+            return;
+        const data = {
+            type: control_frame_1.ControlFrameType.HEARTBEAT,
+            serverTime: new Date().toISOString(),
+        };
+        for (const conn of this.connections.values()) {
+            conn.subject.next({ type: control_frame_1.ControlFrameType.HEARTBEAT, data });
+            this.fireLifecycle('onHeartbeat', conn);
+        }
+    }
+    fireLifecycle(hook, record) {
+        const listener = this.lifecycleListener;
+        if (!listener)
+            return;
+        const fn = listener[hook];
+        if (!fn)
+            return;
+        const event = {
+            connectionId: record.id,
+            caller: record.caller,
+            podId: this.podId,
+            mode: record.mode,
+            ...(record.dedicatedSessionId !== undefined
+                ? { dedicatedSessionId: record.dedicatedSessionId }
+                : {}),
+        };
+        try {
+            const ret = fn.call(listener, event);
+            if (ret && typeof ret.then === 'function') {
+                ret.catch((err) => {
+                    this.logger.warn({
+                        message: `connection-lifecycle ${hook} listener rejected`,
+                        connectionId: record.id,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+        }
+        catch (err) {
+            this.logger.warn({
+                message: `connection-lifecycle ${hook} listener threw`,
+                connectionId: record.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    cursorForScope(cursors, scope) {
+        if (scope.kind === 'project') {
+            return cursors.project?.[scope.id];
+        }
+        return cursors.session?.[scope.id];
+    }
+    stats() {
+        return {
+            podId: this.podId,
+            totalConnections: this.connections.size,
+            maxConnections: this.maxConnections,
+        };
+    }
+};
+exports.RealtimeFanoutService = RealtimeFanoutService;
+exports.RealtimeFanoutService = RealtimeFanoutService = RealtimeFanoutService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.REALTIME_STREAM_OPTIONS)),
+    __param(1, (0, common_1.Inject)(tokens_1.MEMBERSHIP_RESOLVER)),
+    __param(2, (0, common_1.Inject)(tokens_1.HUB_STREAM_SOURCE)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], RealtimeFanoutService);
+function advanceCursors(conn, env) {
+    const e = env;
+    const g = e['ehglobalseq'];
+    if (typeof g === 'string') {
+        if (compareNumeric(g, conn.cursors.global) > 0) {
+            conn.cursors = { ...conn.cursors, global: g };
+        }
+    }
+    const o = e['ehorgseq'];
+    if (typeof o === 'string') {
+        if (conn.cursors.org === undefined ||
+            compareNumeric(o, conn.cursors.org) > 0) {
+            conn.cursors = { ...conn.cursors, org: o };
+        }
+    }
+    if (env.ehprojectid && typeof e['ehprojectseq'] === 'string') {
+        const pid = env.ehprojectid;
+        const seq = e['ehprojectseq'];
+        const map = { ...(conn.cursors.project ?? {}) };
+        if (!map[pid] || compareNumeric(seq, map[pid]) > 0) {
+            map[pid] = seq;
+            conn.cursors = { ...conn.cursors, project: map };
+        }
+    }
+    const sessionId = (0, frame_authz_1.sessionIdFromSubject)(env.subject);
+    if (sessionId !== null && typeof e['ehsessionseq'] === 'string') {
+        const seq = e['ehsessionseq'];
+        const map = { ...(conn.cursors.session ?? {}) };
+        if (!map[sessionId] || compareNumeric(seq, map[sessionId]) > 0) {
+            map[sessionId] = seq;
+            conn.cursors = { ...conn.cursors, session: map };
+        }
+    }
+}
+function compareNumeric(a, b) {
+    if (a.length !== b.length)
+        return a.length - b.length;
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=realtime-fanout.service.js.map

package/dist/lib/realtime-fanout.service.js.map

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

package/dist/lib/realtime-stream.controller.d.ts

@@ -0,0 +1,19 @@
+import { type MessageEvent } from '@nestjs/common';
+import { type Observable } from 'rxjs';
+import type { CallerIdentityExtractor, RealtimeStreamModuleOptions } from './module-options';
+import { RealtimeFanoutService } from './realtime-fanout.service';
+declare class SubscriptionRequestDto {
+    scope: 'project' | 'session';
+    id: string;
+}
+export declare class RealtimeStreamController {
+    private readonly identityExtractor;
+    private readonly fanout;
+    constructor(_options: RealtimeStreamModuleOptions, identityExtractor: CallerIdentityExtractor, fanout: RealtimeFanoutService);
+    stream(req: unknown, lastEventId: string | undefined): Observable<MessageEvent>;
+    subscribe(connectionId: string, body: SubscriptionRequestDto): Promise<void>;
+    unsubscribe(connectionId: string, scopeKind: string, scopeId: string): void;
+    sessionStream(sessionId: string, req: unknown, lastEventId: string | undefined): Observable<MessageEvent>;
+}
+export {};
+//# sourceMappingURL=realtime-stream.controller.d.ts.map

package/dist/lib/realtime-stream.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-stream.controller.d.ts","sourceRoot":"","sources":["../../src/lib/realtime-stream.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAKjD,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAOlE,cAAM,sBAAsB;IAG1B,KAAK,EAAG,SAAS,GAAG,SAAS,CAAC;IAI9B,EAAE,EAAG,MAAM,CAAC;CACb;AAMD,qBAGa,wBAAwB;IASjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHU,QAAQ,EAAE,2BAA2B,EAErD,iBAAiB,EAAE,uBAAuB,EAC1C,MAAM,EAAE,qBAAqB;IAahD,MAAM,CACG,GAAG,EAAE,OAAO,EACO,WAAW,EAAE,MAAM,GAAG,SAAS,GACxD,UAAU,CAAC,YAAY,CAAC;IAkBrB,SAAS,CACU,YAAY,EAAE,MAAM,EACnC,IAAI,EAAE,sBAAsB,GACnC,OAAO,CAAC,IAAI,CAAC;IAiBhB,WAAW,CACc,YAAY,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAChC,IAAI;IAmBP,aAAa,CACS,SAAS,EAAE,MAAM,EAC9B,GAAG,EAAE,OAAO,EACO,WAAW,EAAE,MAAM,GAAG,SAAS,GACxD,UAAU,CAAC,YAAY,CAAC;CA2B5B"}

package/dist/lib/realtime-stream.controller.js

@@ -0,0 +1,185 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeStreamController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const cursor_1 = require("./cursor");
+const frame_authz_1 = require("./frame-authz");
+const tokens_1 = require("./tokens");
+const realtime_fanout_service_1 = require("./realtime-fanout.service");
+var ScopeKind;
+(function (ScopeKind) {
+    ScopeKind["project"] = "project";
+    ScopeKind["session"] = "session";
+})(ScopeKind || (ScopeKind = {}));
+class SubscriptionRequestDto {
+    scope;
+    id;
+}
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ScopeKind, description: 'Scope kind to subscribe to' }),
+    (0, class_validator_1.IsEnum)(ScopeKind),
+    __metadata("design:type", String)
+], SubscriptionRequestDto.prototype, "scope", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Scope resource id' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SubscriptionRequestDto.prototype, "id", void 0);
+let RealtimeStreamController = class RealtimeStreamController {
+    identityExtractor;
+    fanout;
+    constructor(_options, identityExtractor, fanout) {
+        this.identityExtractor = identityExtractor;
+        this.fanout = fanout;
+    }
+    stream(req, lastEventId) {
+        const caller = this.identityExtractor.fromRequest(req);
+        const cursors = (0, cursor_1.parseCursorMap)(lastEventId);
+        const { stream } = this.fanout.openConnection({
+            caller,
+            initialCursors: cursors,
+            mode: 'unified',
+        });
+        return stream.pipe((0, operators_1.map)(toMessageEvent));
+    }
+    async subscribe(connectionId, body) {
+        const scope = validateScope(body);
+        try {
+            await this.fanout.addSubscription(connectionId, scope);
+        }
+        catch (err) {
+            throw new common_1.ForbiddenException(err instanceof Error ? err.message : 'Subscription denied');
+        }
+    }
+    unsubscribe(connectionId, scopeKind, scopeId) {
+        if (scopeKind !== 'project' && scopeKind !== 'session') {
+            throw new common_1.BadRequestException(`Unknown scope kind '${scopeKind}'.`);
+        }
+        this.fanout.removeSubscription(connectionId, {
+            kind: scopeKind,
+            id: scopeId,
+        });
+    }
+    sessionStream(sessionId, req, lastEventId) {
+        const caller = this.identityExtractor.fromRequest(req);
+        const cursors = (0, cursor_1.parseCursorMap)(lastEventId);
+        return (0, rxjs_1.from)(this.fanout['membership'].hasSessionAccess(caller, sessionId)).pipe((0, operators_1.switchMap)((ok) => {
+            if (!ok) {
+                throw new common_1.ForbiddenException(`Caller lacks session access for ${sessionId}.`);
+            }
+            const { stream } = this.fanout.openConnection({
+                caller,
+                initialCursors: cursors,
+                mode: 'session',
+                dedicatedSessionId: sessionId,
+            });
+            return stream;
+        }), (0, operators_1.map)(toMessageEvent), (0, operators_1.catchError)((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            return (0, rxjs_1.of)({ type: 'error', data: { message } });
+        }));
+    }
+};
+exports.RealtimeStreamController = RealtimeStreamController;
+__decorate([
+    (0, common_1.Sse)('stream'),
+    (0, swagger_1.ApiOperation)({
+        operationId: 'realtime_stream',
+        summary: 'Open the unified realtime SSE channel',
+        description: 'Server-Sent Events channel delivering CloudEvents envelopes for ' +
+            'org-broadcast and project events the caller is a member of. ' +
+            'Honors `Last-Event-ID` (JSON multi-scope cursor). Open scope ' +
+            'subscriptions via POST /realtime/streams/:cid/subscriptions.',
+    }),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Headers)('last-event-id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Function)
+], RealtimeStreamController.prototype, "stream", null);
+__decorate([
+    (0, common_1.Post)('streams/:connectionId/subscriptions'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, swagger_1.ApiOperation)({
+        operationId: 'realtime_subscribe_scope',
+        summary: 'Subscribe a unified-stream connection to a scope',
+    }),
+    (0, swagger_1.ApiBody)({ type: SubscriptionRequestDto }),
+    __param(0, (0, common_1.Param)('connectionId')),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, SubscriptionRequestDto]),
+    __metadata("design:returntype", Promise)
+], RealtimeStreamController.prototype, "subscribe", null);
+__decorate([
+    (0, common_1.Delete)('streams/:connectionId/subscriptions/:scopeKind/:scopeId'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, swagger_1.ApiOperation)({
+        operationId: 'realtime_unsubscribe_scope',
+        summary: 'Unsubscribe a unified-stream connection from a scope',
+    }),
+    __param(0, (0, common_1.Param)('connectionId')),
+    __param(1, (0, common_1.Param)('scopeKind')),
+    __param(2, (0, common_1.Param)('scopeId')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", void 0)
+], RealtimeStreamController.prototype, "unsubscribe", null);
+__decorate([
+    (0, common_1.Sse)('sessions/:sessionId/stream'),
+    (0, swagger_1.ApiOperation)({
+        operationId: 'realtime_session_stream',
+        summary: 'Dedicated SSE for ultra-high-frequency session streams',
+        description: 'Escape-hatch route for token-by-token agent output and other ' +
+            'extreme-bandwidth surfaces. Carries ONLY events tagged ' +
+            'session/<sessionId>. Caller must have session membership.',
+    }),
+    __param(0, (0, common_1.Param)('sessionId')),
+    __param(1, (0, common_1.Req)()),
+    __param(2, (0, common_1.Headers)('last-event-id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object]),
+    __metadata("design:returntype", Function)
+], RealtimeStreamController.prototype, "sessionStream", null);
+exports.RealtimeStreamController = RealtimeStreamController = __decorate([
+    (0, swagger_1.ApiTags)('Realtime'),
+    (0, swagger_1.ApiBearerAuth)(),
+    (0, common_1.Controller)('realtime'),
+    __param(0, (0, common_1.Inject)(tokens_1.REALTIME_STREAM_OPTIONS)),
+    __param(1, (0, common_1.Inject)(tokens_1.CALLER_IDENTITY_EXTRACTOR)),
+    __metadata("design:paramtypes", [Object, Object, realtime_fanout_service_1.RealtimeFanoutService])
+], RealtimeStreamController);
+function toMessageEvent(frame) {
+    const data = (frame.data ?? {});
+    if (frame.id !== undefined) {
+        return { type: frame.type, id: frame.id, data };
+    }
+    return { type: frame.type, data };
+}
+function validateScope(body) {
+    if (!body || (body.scope !== 'project' && body.scope !== 'session')) {
+        throw new common_1.BadRequestException('Subscription body must be { scope: "project"|"session", id: string }.');
+    }
+    const scope = { kind: body.scope, id: body.id };
+    if (!(0, frame_authz_1.isValidScopeRef)(scope)) {
+        throw new common_1.BadRequestException('Subscription scope id is missing or invalid.');
+    }
+    return scope;
+}
+//# sourceMappingURL=realtime-stream.controller.js.map

package/dist/lib/realtime-stream.controller.js.map

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

package/dist/lib/realtime-stream.module.d.ts

@@ -0,0 +1,14 @@
+import { DynamicModule, type ModuleMetadata, type Type } from '@nestjs/common';
+import { DefaultHubStreamSource } from './default-hub-stream-source';
+import type { RealtimeStreamModuleOptions } from './module-options';
+export interface RealtimeStreamModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    inject?: any[];
+    useFactory: (...deps: any[]) => Promise<RealtimeStreamModuleOptions> | RealtimeStreamModuleOptions;
+    extraProviders?: ReadonlyArray<Type<any> | any>;
+}
+export declare class RealtimeStreamModule {
+    static forRoot(options: RealtimeStreamModuleOptions): DynamicModule;
+    static defaultSourceProvider(): typeof DefaultHubStreamSource;
+    static forRootAsync(options: RealtimeStreamModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=realtime-stream.module.d.ts.map

package/dist/lib/realtime-stream.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-stream.module.d.ts","sourceRoot":"","sources":["../../src/lib/realtime-stream.module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,KAAK,cAAc,EAEnB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AASrE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,gCACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC;IAEvC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAEf,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,2BAA2B,CAAC,GAAG,2BAA2B,CAAC;IAExE,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;CACjD;AAgBD,qBACa,oBAAoB;IAC/B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa;IAoBnE,MAAM,CAAC,qBAAqB,IAAI,OAAO,sBAAsB;IAI7D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,gCAAgC,GAAG,aAAa;CAwC9E"}