@xemahq/realtime-stream 0.1.1

package/dist/lib/cursor.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeCursorMap = encodeCursorMap;
+exports.parseCursorMap = parseCursorMap;
+exports.cursorFromEvent = cursorFromEvent;
+function encodeCursorMap(cursors) {
+    const out = { global: cursors.global };
+    if (cursors.org !== undefined)
+        out['org'] = cursors.org;
+    if (cursors.project && Object.keys(cursors.project).length > 0) {
+        out['project'] = { ...cursors.project };
+    }
+    if (cursors.session && Object.keys(cursors.session).length > 0) {
+        out['session'] = { ...cursors.session };
+    }
+    return JSON.stringify(out);
+}
+function parseCursorMap(input) {
+    if (!input || input.length === 0)
+        return { global: '0' };
+    if (!input.startsWith('{')) {
+        return { global: assertNonNegativeInt(input, 'global') };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(input);
+    }
+    catch (err) {
+        throw new TypeError(`Last-Event-ID JSON could not be parsed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new TypeError('Last-Event-ID JSON must be an object.');
+    }
+    const obj = parsed;
+    const globalRaw = obj['global'];
+    const global = typeof globalRaw === 'number'
+        ? assertNonNegativeInt(String(globalRaw), 'global')
+        : typeof globalRaw === 'string'
+            ? assertNonNegativeInt(globalRaw, 'global')
+            : null;
+    if (global === null) {
+        throw new TypeError('Last-Event-ID JSON requires a `global` field.');
+    }
+    const out = { global };
+    const org = obj['org'];
+    if (typeof org === 'string' || typeof org === 'number') {
+        out.org = assertNonNegativeInt(String(org), 'org');
+    }
+    const project = obj['project'];
+    if (project && typeof project === 'object' && !Array.isArray(project)) {
+        out.project = freezeRecord(coerceCursorRecord(project, 'project'));
+    }
+    const session = obj['session'];
+    if (session && typeof session === 'object' && !Array.isArray(session)) {
+        out.session = freezeRecord(coerceCursorRecord(session, 'session'));
+    }
+    return out;
+}
+function coerceCursorRecord(src, scope) {
+    const out = {};
+    for (const [k, v] of Object.entries(src)) {
+        if (typeof v === 'string' || typeof v === 'number') {
+            out[k] = assertNonNegativeInt(String(v), `${scope}/${k}`);
+        }
+        else {
+            throw new TypeError(`Last-Event-ID ${scope} cursor for key "${k}" must be a string or number.`);
+        }
+    }
+    return out;
+}
+function freezeRecord(rec) {
+    return Object.freeze({ ...rec });
+}
+function assertNonNegativeInt(raw, label) {
+    if (!/^\d+$/.test(raw)) {
+        throw new TypeError(`Last-Event-ID ${label} cursor must be a non-negative integer string; got "${raw}".`);
+    }
+    return raw;
+}
+function cursorFromEvent(event, scope) {
+    if (scope === 'global') {
+        const v = event['ehglobalseq'];
+        return typeof v === 'string' ? v : undefined;
+    }
+    if (scope === 'org') {
+        const v = event['ehorgseq'];
+        return typeof v === 'string' ? v : undefined;
+    }
+    if (scope.kind === 'project') {
+        if (event['ehprojectid'] !== scope.id)
+            return undefined;
+        const v = event['ehprojectseq'];
+        return typeof v === 'string' ? v : undefined;
+    }
+    const subj = event['subject'];
+    if (subj !== `session/${scope.id}`)
+        return undefined;
+    const v = event['ehsessionseq'];
+    return typeof v === 'string' ? v : undefined;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/lib/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/lib/cursor.ts"],"names":[],"mappings":";;AAOA,0CAUC;AAYD,wCAoDC;AAoCD,0CAsBC;AApID,SAAgB,eAAe,CAAC,OAAkB;IAChD,MAAM,GAAG,GAA4B,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAChE,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IACxD,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAYD,SAAgB,cAAc,CAAC,KAAyB;IACtD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CACjB,2CACE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,GACV,OAAO,SAAS,KAAK,QAAQ;QAC3B,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;QACnD,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ;YAC/B,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC3C,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,GAAG,GAAc,EAAE,MAAM,EAAE,CAAC;IAElC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACvD,GAAG,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,GAAG,YAAY,CACxB,kBAAkB,CAAC,OAAkC,EAAE,SAAS,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,GAAG,YAAY,CACxB,kBAAkB,CAAC,OAAkC,EAAE,SAAS,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CACzB,GAA4B,EAC5B,KAAa;IAEb,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnD,GAAG,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,SAAS,CACjB,iBAAiB,KAAK,oBAAoB,CAAC,+BAA+B,CAC3E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAI,GAAsB;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW,EAAE,KAAa;IACtD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CACjB,iBAAiB,KAAK,uDAAuD,GAAG,IAAI,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,SAAgB,eAAe,CAC7B,KAAwC,EACxC,KAA2F;IAE3F,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,KAAK,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QACxD,MAAM,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,WAAW,KAAK,CAAC,EAAE,EAAE;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC"}

package/dist/lib/default-hub-stream-source.d.ts

@@ -0,0 +1,9 @@
+import { EventHubReplayClient } from '@xemahq/event-hub-client';
+import type { HubStreamSource } from './hub-stream-source';
+export declare class DefaultHubStreamSource implements HubStreamSource {
+    private readonly client;
+    private readonly logger;
+    constructor(client: EventHubReplayClient);
+    open(fromGlobalSeq: string, onEnvelope: (envelope: Record<string, unknown>) => void, onResync: () => void, onError: (err: Error) => void): Promise<() => void>;
+}
+//# sourceMappingURL=default-hub-stream-source.d.ts.map

package/dist/lib/default-hub-stream-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-hub-stream-source.d.ts","sourceRoot":"","sources":["../../src/lib/default-hub-stream-source.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAU3D,qBACa,sBAAuB,YAAW,eAAe;IAGhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;gBAErC,MAAM,EAAE,oBAAoB;IAEnD,IAAI,CACR,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACvD,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAC5B,OAAO,CAAC,MAAM,IAAI,CAAC;CAoBvB"}

package/dist/lib/default-hub-stream-source.js

@@ -0,0 +1,43 @@
+"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 DefaultHubStreamSource_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultHubStreamSource = void 0;
+const common_1 = require("@nestjs/common");
+const event_hub_client_1 = require("@xemahq/event-hub-client");
+let DefaultHubStreamSource = DefaultHubStreamSource_1 = class DefaultHubStreamSource {
+    client;
+    logger = new common_1.Logger(DefaultHubStreamSource_1.name);
+    constructor(client) {
+        this.client = client;
+    }
+    async open(fromGlobalSeq, onEnvelope, onResync, onError) {
+        const cursors = { global: fromGlobalSeq };
+        const stop = await this.client.streamFrom(cursors, {}, (env) => {
+            try {
+                onEnvelope(env);
+            }
+            catch (err) {
+                this.logger.error({
+                    message: 'envelope handler threw',
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }, onResync, onError);
+        return stop;
+    }
+};
+exports.DefaultHubStreamSource = DefaultHubStreamSource;
+exports.DefaultHubStreamSource = DefaultHubStreamSource = DefaultHubStreamSource_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [event_hub_client_1.EventHubReplayClient])
+], DefaultHubStreamSource);
+//# sourceMappingURL=default-hub-stream-source.js.map

package/dist/lib/default-hub-stream-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-hub-stream-source.js","sourceRoot":"","sources":["../../src/lib/default-hub-stream-source.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,+DAGkC;AAY3B,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAGJ;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;IAElE,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE7D,KAAK,CAAC,IAAI,CACR,aAAqB,EACrB,UAAuD,EACvD,QAAoB,EACpB,OAA6B;QAE7B,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACvC,OAAO,EACP,EAAE,EACF,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,CAAC;gBACH,UAAU,CAAC,GAA8B,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBAChB,OAAO,EAAE,wBAAwB;oBACjC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EACD,QAAQ,EACR,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA9BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAI0B,uCAAoB;GAH9C,sBAAsB,CA8BlC"}

package/dist/lib/frame-authz.d.ts

@@ -0,0 +1,17 @@
+import type { ScopeRef } from './control-frame';
+import type { CallerIdentity } from './membership-resolver';
+export interface DeliverableEnvelope {
+    readonly ehorgid: string;
+    readonly ehprojectid?: string;
+    readonly ehuserid?: string;
+    readonly ehvisibility: string;
+    readonly subject?: string;
+    readonly type: string;
+}
+export declare function envelopeAuthorizedForCaller(envelope: DeliverableEnvelope, caller: CallerIdentity, membership: {
+    hasProject: boolean;
+    hasSession: boolean;
+}, activeSessionScopes: ReadonlyArray<string>): boolean;
+export declare function sessionIdFromSubject(subject: string | undefined): string | null;
+export declare function isValidScopeRef(scope: ScopeRef): boolean;
+//# sourceMappingURL=frame-authz.d.ts.map

package/dist/lib/frame-authz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-authz.d.ts","sourceRoot":"","sources":["../../src/lib/frame-authz.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,EACxD,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,GACzC,OAAO,CAqCT;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,GAAG,IAAI,CAMf;AAMD,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAIxD"}

package/dist/lib/frame-authz.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envelopeAuthorizedForCaller = envelopeAuthorizedForCaller;
+exports.sessionIdFromSubject = sessionIdFromSubject;
+exports.isValidScopeRef = isValidScopeRef;
+function envelopeAuthorizedForCaller(envelope, caller, membership, activeSessionScopes) {
+    if (envelope.ehorgid !== caller.orgId)
+        return false;
+    if (envelope.ehvisibility === 'user') {
+        if (!envelope.ehuserid)
+            return false;
+        return envelope.ehuserid === caller.userId;
+    }
+    if (envelope.ehvisibility === 'internal')
+        return false;
+    if (envelope.ehvisibility === 'public')
+        return true;
+    if (envelope.ehvisibility === 'project') {
+        if (!envelope.ehprojectid)
+            return false;
+        if (!membership.hasProject)
+            return false;
+        const sessionId = sessionIdFromSubject(envelope.subject);
+        if (sessionId !== null) {
+            if (!membership.hasSession)
+                return false;
+            return activeSessionScopes.includes(sessionId);
+        }
+        return true;
+    }
+    return false;
+}
+function sessionIdFromSubject(subject) {
+    if (!subject)
+        return null;
+    const prefix = 'session/';
+    if (!subject.startsWith(prefix))
+        return null;
+    const id = subject.slice(prefix.length);
+    return id.length > 0 ? id : null;
+}
+function isValidScopeRef(scope) {
+    if (!scope.id || scope.id.length === 0)
+        return false;
+    if (scope.id.length > 256)
+        return false;
+    return scope.kind === 'project' || scope.kind === 'session';
+}
+//# sourceMappingURL=frame-authz.js.map

package/dist/lib/frame-authz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-authz.js","sourceRoot":"","sources":["../../src/lib/frame-authz.ts"],"names":[],"mappings":";;AA2BA,kEA0CC;AAED,oDAQC;AAMD,0CAIC;AA9DD,SAAgB,2BAA2B,CACzC,QAA6B,EAC7B,MAAsB,EACtB,UAAwD,EACxD,mBAA0C;IAI1C,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAGpD,IAAI,QAAQ,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,QAAQ,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC;IAC7C,CAAC;IAGD,IAAI,QAAQ,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAGvD,IAAI,QAAQ,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAKpD,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAEzC,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAIvB,IAAI,CAAC,UAAU,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YACzC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAA2B;IAE3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,UAAU,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAMD,SAAgB,eAAe,CAAC,KAAe;IAC7C,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9D,CAAC"}

package/dist/lib/hub-stream-source.d.ts

@@ -0,0 +1,4 @@
+export interface HubStreamSource {
+    open(fromGlobalSeq: string, onEnvelope: (envelope: Record<string, unknown>) => void, onResync: () => void, onError: (err: Error) => void): Promise<() => void>;
+}
+//# sourceMappingURL=hub-stream-source.d.ts.map

package/dist/lib/hub-stream-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-stream-source.d.ts","sourceRoot":"","sources":["../../src/lib/hub-stream-source.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAc9B,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACvD,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAC5B,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;CACxB"}

package/dist/lib/hub-stream-source.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=hub-stream-source.js.map

package/dist/lib/hub-stream-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-stream-source.js","sourceRoot":"","sources":["../../src/lib/hub-stream-source.ts"],"names":[],"mappings":""}

package/dist/lib/membership-resolver.d.ts

@@ -0,0 +1,15 @@
+export interface CallerIdentity {
+    readonly orgId: string;
+    readonly userId: string;
+    readonly realmId?: string;
+    readonly roles?: ReadonlyArray<string>;
+}
+export interface MembershipResolver {
+    hasProjectAccess(caller: CallerIdentity, projectId: string): Promise<boolean>;
+    hasSessionAccess(caller: CallerIdentity, sessionId: string): Promise<boolean>;
+}
+export declare class DenyAllMembershipResolver implements MembershipResolver {
+    hasProjectAccess(): Promise<boolean>;
+    hasSessionAccess(): Promise<boolean>;
+}
+//# sourceMappingURL=membership-resolver.d.ts.map

package/dist/lib/membership-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/membership-resolver.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAM1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAWD,MAAM,WAAW,kBAAkB;IAOjC,gBAAgB,CACd,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC;IAOpB,gBAAgB,CACd,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAQD,qBAAa,yBAA0B,YAAW,kBAAkB;IAC5D,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAGpC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;CAG3C"}

package/dist/lib/membership-resolver.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DenyAllMembershipResolver = void 0;
+class DenyAllMembershipResolver {
+    async hasProjectAccess() {
+        return false;
+    }
+    async hasSessionAccess() {
+        return false;
+    }
+}
+exports.DenyAllMembershipResolver = DenyAllMembershipResolver;
+//# sourceMappingURL=membership-resolver.js.map

package/dist/lib/membership-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership-resolver.js","sourceRoot":"","sources":["../../src/lib/membership-resolver.ts"],"names":[],"mappings":";;;AAyDA,MAAa,yBAAyB;IACpC,KAAK,CAAC,gBAAgB;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,gBAAgB;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAPD,8DAOC"}

package/dist/lib/module-options.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectionLifecycleListener } from './connection-lifecycle';
+import type { CallerIdentity, MembershipResolver } from './membership-resolver';
+import type { HubStreamSource } from './hub-stream-source';
+export interface CallerIdentityExtractor {
+    fromRequest(req: unknown): CallerIdentity;
+}
+export interface RealtimeStreamModuleOptions {
+    membershipResolver: MembershipResolver;
+    hubStreamSource: HubStreamSource;
+    callerIdentityExtractor: CallerIdentityExtractor;
+    heartbeatIntervalMs?: number;
+    maxConnectionsPerPod?: number;
+    podId?: string;
+    initialFromGlobalSeq?: string;
+    connectionLifecycleListener?: ConnectionLifecycleListener;
+}
+//# sourceMappingURL=module-options.d.ts.map

package/dist/lib/module-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-options.d.ts","sourceRoot":"","sources":["../../src/lib/module-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQ3D,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAE1C,kBAAkB,EAAE,kBAAkB,CAAC;IAEvC,eAAe,EAAE,eAAe,CAAC;IAEjC,uBAAuB,EAAE,uBAAuB,CAAC;IAKjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAK7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAK9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAOf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAQ9B,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;CAC3D"}

package/dist/lib/module-options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=module-options.js.map

package/dist/lib/module-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-options.js","sourceRoot":"","sources":["../../src/lib/module-options.ts"],"names":[],"mappings":""}

package/dist/lib/realtime-fanout.service.d.ts

@@ -0,0 +1,57 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { type CursorMap, type ScopeRef } from './control-frame';
+import type { HubStreamSource } from './hub-stream-source';
+import type { CallerIdentity, MembershipResolver } from './membership-resolver';
+import type { RealtimeStreamModuleOptions } from './module-options';
+export type ConnectionMode = 'unified' | 'session';
+export interface SseFrame {
+    readonly type: string;
+    readonly id?: string;
+    readonly data: unknown;
+}
+interface OpenConnectionInput {
+    caller: CallerIdentity;
+    initialCursors: CursorMap;
+    mode: ConnectionMode;
+    dedicatedSessionId?: string;
+}
+export declare class RealtimeFanoutService implements OnModuleInit, OnModuleDestroy {
+    private readonly options;
+    private readonly membership;
+    private readonly hubSource;
+    private readonly logger;
+    private readonly connections;
+    private readonly heartbeatIntervalMs;
+    private readonly maxConnections;
+    private readonly podId;
+    private readonly lifecycleListener;
+    private heartbeatTimer;
+    private stopHubSource;
+    constructor(options: RealtimeStreamModuleOptions, membership: MembershipResolver, hubSource: HubStreamSource);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): void;
+    openConnection(input: OpenConnectionInput): {
+        connectionId: string;
+        stream: Observable<SseFrame>;
+    };
+    closeConnection(connectionId: string): void;
+    addSubscription(connectionId: string, scope: ScopeRef): Promise<void>;
+    removeSubscription(connectionId: string, scope: ScopeRef): void;
+    onUpstreamEnvelope(envelope: Record<string, unknown>): void;
+    onUpstreamResync(): void;
+    onUpstreamError(err: Error): void;
+    private deliverEnvelope;
+    private emitConnected;
+    private emitControl;
+    private broadcastHeartbeat;
+    private fireLifecycle;
+    private cursorForScope;
+    stats(): {
+        podId: string;
+        totalConnections: number;
+        maxConnections: number;
+    };
+}
+export {};
+//# sourceMappingURL=realtime-fanout.service.d.ts.map

package/dist/lib/realtime-fanout.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-fanout.service.d.ts","sourceRoot":"","sources":["../../src/lib/realtime-fanout.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,YAAY,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AACxH,OAAO,EAAW,UAAU,EAAmB,MAAM,MAAM,CAAC;AAK5D,OAAO,EAAkC,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMhG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AA6BpE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,SAAS,CAAC;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBACa,qBAAsB,YAAW,YAAY,EAAE,eAAe;IAWtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAZvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0C;IAC5E,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,aAAa,CAA6B;gBAGE,OAAO,EAAE,2BAA2B,EACxC,UAAU,EAAE,kBAAkB,EAChC,SAAS,EAAE,eAAe;IAQlE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnC,eAAe,IAAI,IAAI;IA4BvB,cAAc,CACZ,KAAK,EAAE,mBAAmB,GACzB;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;KAAE;IAiDzD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAUrC,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC3E,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAuB/D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IA8C3D,gBAAgB,IAAI,IAAI;IA0BxB,eAAe,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAyBjC,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,aAAa;IAqCrB,OAAO,CAAC,cAAc;IAYtB,KAAK,IAAI;QACP,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB;CAOF"}