@xemahq/realtime-client 0.1.1

package/dist/lib/sse-client.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseClient = void 0;
+const cursor_store_1 = require("./cursor-store");
+class SseClient {
+    options;
+    onEnvelope;
+    onControl;
+    onResync;
+    onStatus;
+    cursorStore;
+    url;
+    watchdogMs;
+    baseMs;
+    maxMs;
+    abortController = null;
+    watchdogTimer = null;
+    reconnectAttempt = 0;
+    stopped = false;
+    constructor(options, onEnvelope, onControl, onResync, cursorStore, onStatus) {
+        this.options = options;
+        this.onEnvelope = onEnvelope;
+        this.onControl = onControl;
+        this.onResync = onResync;
+        this.onStatus = onStatus;
+        this.cursorStore = cursorStore ?? new cursor_store_1.CursorStore();
+        this.url = options.url ?? '/realtime/stream';
+        this.watchdogMs = options.watchdogMs ?? 45_000;
+        this.baseMs = options.reconnectBaseMs ?? 1_000;
+        this.maxMs = options.reconnectMaxMs ?? 30_000;
+    }
+    emitStatus(status) {
+        if (this.onStatus)
+            this.onStatus(status);
+    }
+    start() {
+        if (this.stopped)
+            return;
+        void this.connect();
+    }
+    stop() {
+        this.stopped = true;
+        this.clearWatchdog();
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this.emitStatus('closed');
+    }
+    cursors() {
+        return this.cursorStore.get();
+    }
+    async connect() {
+        if (this.stopped)
+            return;
+        this.emitStatus('connecting');
+        const token = await this.options.tokenProvider();
+        const lastEventId = this.cursorStore.encodeForLastEventId();
+        console.log('[Realtime:SSE]', 'connect.start', {
+            url: this.url,
+            orgId: this.options.orgId,
+            lastEventId,
+            attempt: this.reconnectAttempt,
+        });
+        this.abortController = new AbortController();
+        const signal = this.abortController.signal;
+        try {
+            const res = await fetch(this.url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: 'text/event-stream',
+                    'X-Org-Id': this.options.orgId,
+                    'Last-Event-ID': lastEventId,
+                },
+                signal,
+            });
+            if (!res.ok || !res.body) {
+                console.error('[Realtime:SSE]', 'connect.fail', {
+                    url: this.url,
+                    status: res.status,
+                    statusText: res.statusText,
+                });
+                throw new Error(`SSE connect failed: HTTP ${res.status}`);
+            }
+            console.log('[Realtime:SSE]', 'connect.ok', {
+                url: this.url,
+                status: res.status,
+            });
+            this.reconnectAttempt = 0;
+            this.emitStatus('open');
+            this.armWatchdog();
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder('utf-8');
+            let buffer = '';
+            while (!signal.aborted) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                this.armWatchdog();
+                const events = drainSseEvents(buffer);
+                buffer = events.remainder;
+                for (const evt of events.parsed)
+                    this.handleParsed(evt);
+            }
+            console.log('[Realtime:SSE]', 'connect.closed', {
+                aborted: signal.aborted,
+                stopped: this.stopped,
+            });
+        }
+        catch (err) {
+            if (signal.aborted || this.stopped)
+                return;
+            console.error('[Realtime:SSE]', 'connect.error', {
+                url: this.url,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+        this.clearWatchdog();
+        if (!this.stopped) {
+            this.emitStatus('reconnecting');
+            this.scheduleReconnect();
+        }
+    }
+    handleParsed(evt) {
+        if (evt.event === 'resync') {
+            console.log('[Realtime:SSE]', 'frame.resync', { id: evt.id ?? null });
+            this.cursorStore.reset();
+            this.onResync();
+            return;
+        }
+        if (!evt.data) {
+            console.log('[Realtime:SSE]', 'frame.empty', {
+                id: evt.id ?? null,
+                event: evt.event ?? null,
+            });
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(evt.data);
+        }
+        catch (err) {
+            console.error('[Realtime:SSE]', 'frame.json-parse-failed', {
+                id: evt.id ?? null,
+                event: evt.event ?? null,
+                rawLength: evt.data.length,
+                message: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        const evtType = typeof parsed['type'] === 'string' ? parsed['type'] : '';
+        if (evt.event && evt.event !== 'message') {
+            console.log('[Realtime:SSE]', 'frame.control', {
+                id: evt.id ?? null,
+                event: evt.event,
+            });
+            this.onControl(evt.event, parsed);
+            this.captureControlCursors(evt.event, parsed);
+            return;
+        }
+        if (typeof parsed['type'] === 'string' && evtType.length > 0) {
+            console.log('[Realtime:SSE]', 'frame.envelope', {
+                id: evt.id ?? null,
+                type: evtType,
+            });
+            this.onEnvelope(parsed);
+            this.captureCursors(parsed);
+        }
+        else {
+            console.log('[Realtime:SSE]', 'frame.unknown-shape', {
+                id: evt.id ?? null,
+                event: evt.event ?? null,
+                keys: Object.keys(parsed),
+            });
+        }
+    }
+    captureCursors(envelope) {
+        const g = envelope['ehglobalseq'];
+        if (typeof g === 'string')
+            this.cursorStore.patchGlobal(g);
+        const o = envelope['ehorgseq'];
+        if (typeof o === 'string')
+            this.cursorStore.patchOrg(o);
+        const p = envelope['ehprojectseq'];
+        const pid = envelope['ehprojectid'];
+        if (typeof p === 'string' && typeof pid === 'string') {
+            this.cursorStore.patchProject(pid, p);
+        }
+        const s = envelope['ehsessionseq'];
+        const subject = envelope['subject'];
+        if (typeof s === 'string' && typeof subject === 'string') {
+            const prefix = 'session/';
+            if (subject.startsWith(prefix)) {
+                this.cursorStore.patchSession(subject.slice(prefix.length), s);
+            }
+        }
+    }
+    captureControlCursors(frameType, parsed) {
+        if (frameType !== 'connected')
+            return;
+        const c = parsed['cursors'];
+        if (!c || typeof c !== 'object')
+            return;
+        const obj = c;
+        const g = obj['global'];
+        if (typeof g === 'string')
+            this.cursorStore.patchGlobal(g);
+        const o = obj['org'];
+        if (typeof o === 'string')
+            this.cursorStore.patchOrg(o);
+    }
+    armWatchdog() {
+        this.clearWatchdog();
+        this.watchdogTimer = setTimeout(() => {
+            if (this.abortController)
+                this.abortController.abort();
+        }, this.watchdogMs);
+    }
+    clearWatchdog() {
+        if (this.watchdogTimer) {
+            clearTimeout(this.watchdogTimer);
+            this.watchdogTimer = null;
+        }
+    }
+    scheduleReconnect() {
+        const attempt = this.reconnectAttempt++;
+        const baseDelay = Math.min(this.baseMs * 2 ** attempt, this.maxMs);
+        const jitter = 0.5 + Math.random();
+        const delay = Math.round(baseDelay * jitter);
+        setTimeout(() => {
+            if (!this.stopped)
+                void this.connect();
+        }, delay);
+    }
+}
+exports.SseClient = SseClient;
+function drainSseEvents(buffer) {
+    const events = [];
+    let cursor = 0;
+    while (true) {
+        const next = buffer.indexOf('\n\n', cursor);
+        if (next === -1)
+            break;
+        const block = buffer.slice(cursor, next);
+        cursor = next + 2;
+        const evt = {};
+        for (const line of block.split('\n')) {
+            if (!line || line.startsWith(':'))
+                continue;
+            const colon = line.indexOf(':');
+            const field = colon === -1 ? line : line.slice(0, colon);
+            const value = colon === -1
+                ? ''
+                : line[colon + 1] === ' '
+                    ? line.slice(colon + 2)
+                    : line.slice(colon + 1);
+            if (field === 'id')
+                evt.id = value;
+            else if (field === 'event')
+                evt.event = value;
+            else if (field === 'data') {
+                evt.data = evt.data === undefined ? value : `${evt.data}\n${value}`;
+            }
+        }
+        events.push(evt);
+    }
+    return { parsed: events, remainder: buffer.slice(cursor) };
+}
+//# sourceMappingURL=sse-client.js.map

package/dist/lib/sse-client.js.map

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

package/dist/lib/use-event-scope.d.ts

@@ -0,0 +1,6 @@
+export interface EventScopeOptions {
+    scope: 'project' | 'session';
+    id: string;
+}
+export declare function useEventScope(options: EventScopeOptions): void;
+//# sourceMappingURL=use-event-scope.d.ts.map

package/dist/lib/use-event-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-scope.d.ts","sourceRoot":"","sources":["../../src/lib/use-event-scope.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ;AAUD,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA4C9D"}

package/dist/lib/use-event-scope.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEventScope = useEventScope;
+const react_1 = require("react");
+const realtime_context_1 = require("./realtime-context");
+function useEventScope(options) {
+    const ctx = (0, realtime_context_1.useRealtimeContext)();
+    const ctxRef = (0, react_1.useRef)(ctx);
+    ctxRef.current = ctx;
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        let subscribedScope = null;
+        void (async () => {
+            const start = Date.now();
+            while (Date.now() - start < 5_000) {
+                if (cancelled)
+                    return;
+                const cid = ctxRef.current.state?.connectionId;
+                if (cid) {
+                    const scope = { kind: options.scope, id: options.id };
+                    await ctxRef.current.subscribeToScope(cid, scope);
+                    if (cancelled) {
+                        ctxRef.current.unsubscribeFromScope(scope);
+                        return;
+                    }
+                    subscribedScope = scope;
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, 100));
+            }
+        })();
+        return () => {
+            cancelled = true;
+            if (subscribedScope) {
+                ctxRef.current.unsubscribeFromScope(subscribedScope);
+                subscribedScope = null;
+            }
+        };
+    }, [options.scope, options.id]);
+}
+//# sourceMappingURL=use-event-scope.js.map

package/dist/lib/use-event-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-scope.js","sourceRoot":"","sources":["../../src/lib/use-event-scope.tsx"],"names":[],"mappings":";;AAiBA,sCA4CC;AA7DD,iCAA0C;AAE1C,yDAAwD;AAexD,SAAgB,aAAa,CAAC,OAA0B;IACtD,MAAM,GAAG,GAAG,IAAA,qCAAkB,GAAE,CAAC;IAMjC,MAAM,MAAM,GAAG,IAAA,cAAM,EAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,eAAe,GAAuD,IAAI,CAAC;QAC/E,KAAK,CAAC,KAAK,IAAI,EAAE;YAIf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;gBAClC,IAAI,SAAS;oBAAE,OAAO;gBACtB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC;gBAC/C,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAClD,IAAI,SAAS,EAAE,CAAC;wBAGd,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;wBAC3C,OAAO;oBACT,CAAC;oBACD,eAAe,GAAG,KAAK,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;gBACrD,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@xemahq/realtime-client",
+  "version": "0.1.1",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5",
+    "react": "^18.3.1"
+  },
+  "dependencies": {
+    "@xemahq/events": "^0.1.1"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.100.13",
+    "@types/jest": "^30.0.0",
+    "@types/node": "25.2.3",
+    "@types/react": "^18.3.30",
+    "jest": "^30.3.0",
+    "prettier": "3.6.2",
+    "react": "^19.0.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "jest --config jest.config.ts"
+  }
+}