@xemahq/realtime-client 0.1.1

package/dist/lib/leader-election.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeLeader = void 0;
+class RealtimeLeader {
+    hooks;
+    tabId;
+    channelName;
+    channel = null;
+    isLeader = false;
+    knownPeers = new Map();
+    heartbeatTimer = null;
+    peerCheckTimer = null;
+    constructor(orgId, hooks) {
+        this.hooks = hooks;
+        this.tabId =
+            typeof crypto !== 'undefined' && crypto.randomUUID
+                ? crypto.randomUUID()
+                : `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+        this.channelName = `xema_realtime_${orgId}`;
+    }
+    start() {
+        this.channel = new BroadcastChannel(this.channelName);
+        this.channel.addEventListener('message', (e) => this.handle(e.data));
+        this.broadcast({ kind: 'HELLO', tabId: this.tabId });
+        this.knownPeers.set(this.tabId, Date.now());
+        setTimeout(() => this.elect(), 100);
+        this.heartbeatTimer = setInterval(() => {
+            if (this.isLeader) {
+                this.broadcast({ kind: 'HEARTBEAT', tabId: this.tabId });
+            }
+        }, 3_000);
+        this.peerCheckTimer = setInterval(() => this.purgeStalePeers(), 5_000);
+        if (typeof window !== 'undefined') {
+            window.addEventListener('beforeunload', () => {
+                this.broadcast({ kind: 'BYE', tabId: this.tabId });
+            });
+        }
+    }
+    stop() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        if (this.peerCheckTimer)
+            clearInterval(this.peerCheckTimer);
+        if (this.channel) {
+            this.broadcast({ kind: 'BYE', tabId: this.tabId });
+            this.channel.close();
+            this.channel = null;
+        }
+        this.heartbeatTimer = null;
+        this.peerCheckTimer = null;
+    }
+    fanoutFrame(envelope) {
+        if (!this.isLeader)
+            return;
+        this.broadcast({ kind: 'FRAME', tabId: this.tabId, payload: envelope });
+    }
+    fanoutControl(frameType, data) {
+        if (!this.isLeader)
+            return;
+        this.broadcast({
+            kind: 'CONTROL',
+            tabId: this.tabId,
+            controlType: frameType,
+            payload: data,
+        });
+    }
+    handle(msg) {
+        if (msg.tabId === this.tabId)
+            return;
+        switch (msg.kind) {
+            case 'HELLO':
+                this.knownPeers.set(msg.tabId, Date.now());
+                if (this.isLeader) {
+                    this.broadcast({ kind: 'HEARTBEAT', tabId: this.tabId });
+                }
+                this.elect();
+                break;
+            case 'HEARTBEAT':
+                this.knownPeers.set(msg.tabId, Date.now());
+                break;
+            case 'BYE':
+                this.knownPeers.delete(msg.tabId);
+                this.elect();
+                break;
+            case 'FRAME':
+                if (!this.isLeader) {
+                    this.hooks.onFrame(msg.payload);
+                }
+                break;
+            case 'CONTROL':
+                if (!this.isLeader) {
+                    this.hooks.onControl(msg.controlType ?? '', msg.payload);
+                }
+                break;
+        }
+    }
+    elect() {
+        const sorted = [...this.knownPeers.keys()].sort();
+        const leader = sorted[0];
+        const wasLeader = this.isLeader;
+        this.isLeader = leader === this.tabId;
+        if (this.isLeader && !wasLeader)
+            this.hooks.onPromoted();
+        else if (!this.isLeader && wasLeader)
+            this.hooks.onDemoted();
+    }
+    purgeStalePeers() {
+        const cutoff = Date.now() - 10_000;
+        let changed = false;
+        for (const [id, ts] of this.knownPeers) {
+            if (ts < cutoff && id !== this.tabId) {
+                this.knownPeers.delete(id);
+                changed = true;
+            }
+        }
+        if (changed)
+            this.elect();
+    }
+    broadcast(msg) {
+        if (!this.channel)
+            return;
+        try {
+            this.channel.postMessage(msg);
+        }
+        catch {
+        }
+    }
+    isCurrentLeader() {
+        return this.isLeader;
+    }
+}
+exports.RealtimeLeader = RealtimeLeader;
+//# sourceMappingURL=leader-election.js.map

package/dist/lib/leader-election.js.map

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

package/dist/lib/realtime-context.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+import { type DeliveredEvent } from './invalidation-registry';
+import { type SseClientOptions } from './sse-client';
+export interface RealtimeProviderProps {
+    orgId: string;
+    tokenProvider: SseClientOptions['tokenProvider'];
+    url?: string;
+    watchdogMs?: number;
+    reconnectBaseMs?: number;
+    reconnectMaxMs?: number;
+    onResync?: () => void;
+    children: ReactNode;
+}
+export type RealtimeConnectionStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+export interface RealtimeConnectionState {
+    status: RealtimeConnectionStatus;
+    connectionId?: string;
+}
+interface RealtimeContextValue {
+    isLeader: boolean;
+    state: RealtimeConnectionState;
+    subscribe(eventType: string, handler: (event: DeliveredEvent) => void): () => void;
+    subscribeToScope(connectionId: string, scope: {
+        kind: 'project' | 'session';
+        id: string;
+    }): Promise<void>;
+    unsubscribeFromScope(scope: {
+        kind: 'project' | 'session';
+        id: string;
+    }): void;
+}
+export declare function RealtimeProvider(props: RealtimeProviderProps): ReactNode;
+export declare function useCloudEvent(eventType: string, handler: (event: DeliveredEvent) => void): void;
+export declare function useRealtimeContext(): RealtimeContextValue;
+export declare function useRealtimeStatus(): RealtimeConnectionState;
+export declare function useRealtimeIsLeader(): boolean;
+export {};
+//# sourceMappingURL=realtime-context.d.ts.map

package/dist/lib/realtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-context.d.ts","sourceRoot":"","sources":["../../src/lib/realtime-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAQD,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,wBAAwB,CAAC;IAEjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,oBAAoB;IAE5B,QAAQ,EAAE,OAAO,CAAC;IAElB,KAAK,EAAE,uBAAuB,CAAC;IAE/B,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,MAAM,IAAI,CAAC;IAOd,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,IAAI,CAAC,CAAC;IASjB,oBAAoB,CAAC,KAAK,EAAE;QAC1B,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAC5B,EAAE,EAAE,MAAM,CAAC;KACZ,GAAG,IAAI,CAAC;CACV;AAyED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAqNxE;AAGD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,IAAI,CAMN;AAED,wBAAgB,kBAAkB,IAAI,oBAAoB,CAQzD;AAQD,wBAAgB,iBAAiB,IAAI,uBAAuB,CAG3D;AAGD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/lib/realtime-context.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeProvider = RealtimeProvider;
+exports.useCloudEvent = useCloudEvent;
+exports.useRealtimeContext = useRealtimeContext;
+exports.useRealtimeStatus = useRealtimeStatus;
+exports.useRealtimeIsLeader = useRealtimeIsLeader;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_query_1 = require("@tanstack/react-query");
+const invalidation_registry_1 = require("./invalidation-registry");
+const leader_election_1 = require("./leader-election");
+const sse_client_1 = require("./sse-client");
+const RealtimeContext = (0, react_1.createContext)(null);
+function eventDebugCategory(type) {
+    if (type.startsWith('design-system-builder.'))
+        return 'design-system-builder';
+    if (type.startsWith('session.'))
+        return 'session';
+    if (type.startsWith('workflow.run.'))
+        return 'workflow-run';
+    if (type.startsWith('workflow.job.'))
+        return 'workflow-job';
+    if (type.startsWith('workflow.activity.'))
+        return 'workflow-activity';
+    return undefined;
+}
+function parseProducerSource(source) {
+    if (!source || typeof source !== 'string') {
+        return { sourceKind: 'unknown', sourceId: 'unknown' };
+    }
+    const sourceMatch = source.match(/\/(services|biomes)\/([^/?#]+)/i);
+    const segment = sourceMatch?.[1];
+    const id = sourceMatch?.[2];
+    if (!sourceMatch || segment === undefined || id === undefined) {
+        return { sourceKind: 'unknown', sourceId: source };
+    }
+    return {
+        sourceKind: segment.toLowerCase() === 'services' ? 'service' : 'biome',
+        sourceId: id,
+    };
+}
+function debugGlobalRealtimeEvent(event, invalidationKeys) {
+    const category = eventDebugCategory(event.type) ?? 'other';
+    const { sourceKind, sourceId } = parseProducerSource(event.source);
+    console.log('[GlobalRealtime]', {
+        category,
+        type: event.type,
+        id: event.id ?? null,
+        source: event.source ?? null,
+        sourceKind,
+        sourceId,
+        orgId: event.ehorgid,
+        projectId: event.ehprojectid ?? null,
+        userId: event.ehuserid ?? null,
+        sessionSeq: event.ehsessionseq ?? null,
+        hint: event.__hint ?? null,
+        invalidationKeys,
+        data: event.data ?? null,
+    });
+}
+function debugGlobalRealtimeControl(frameType, data) {
+    console.log('[GlobalRealtime:control]', {
+        frameType,
+        data,
+    });
+}
+function RealtimeProvider(props) {
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const sseRef = (0, react_1.useRef)(null);
+    const subscribersRef = (0, react_1.useRef)(new Map());
+    const [isLeader, setIsLeader] = (0, react_1.useState)(false);
+    const [state, setState] = (0, react_1.useState)({
+        status: 'idle',
+    });
+    const scopeRefcountsRef = (0, react_1.useRef)(new Map());
+    const scopeBoundConnectionIdRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        const cid = state.connectionId ?? null;
+        if (cid !== scopeBoundConnectionIdRef.current) {
+            scopeRefcountsRef.current.clear();
+            scopeBoundConnectionIdRef.current = cid;
+        }
+    }, [state.connectionId]);
+    const dispatchEnvelope = (0, react_1.useCallback)((envelope) => {
+        const event = envelope;
+        const keys = invalidation_registry_1.globalInvalidationRegistry.resolveQueryKeys(event);
+        debugGlobalRealtimeEvent(event, keys);
+        for (const key of keys) {
+            void queryClient.invalidateQueries({
+                queryKey: key,
+            });
+        }
+        const subs = subscribersRef.current.get(event.type);
+        if (subs) {
+            for (const fn of subs) {
+                try {
+                    fn(event);
+                }
+                catch {
+                }
+            }
+        }
+    }, [queryClient]);
+    const dispatchControl = (0, react_1.useCallback)((frameType, data) => {
+        debugGlobalRealtimeControl(frameType, data);
+        if (frameType === 'connected' && data && typeof data === 'object') {
+            const cid = data.connectionId;
+            setState({
+                status: 'connected',
+                ...(typeof cid === 'string' ? { connectionId: cid } : {}),
+            });
+        }
+        else if (frameType === 'goodbye') {
+            setState({ status: 'reconnecting' });
+        }
+    }, []);
+    const dispatchTransportStatus = (0, react_1.useCallback)((transport) => {
+        setState((prev) => {
+            if (transport === 'closed')
+                return { status: 'closed' };
+            if (transport === 'reconnecting')
+                return { status: 'reconnecting' };
+            if (transport === 'connecting') {
+                return prev.status === 'connected'
+                    ? { status: 'reconnecting' }
+                    : { status: 'connecting' };
+            }
+            return prev;
+        });
+    }, []);
+    const leader = (0, react_1.useMemo)(() => new leader_election_1.RealtimeLeader(props.orgId, {
+        onPromoted: () => {
+            setIsLeader(true);
+            setState({ status: 'connecting' });
+            const sse = new sse_client_1.SseClient({
+                orgId: props.orgId,
+                tokenProvider: props.tokenProvider,
+                ...(props.url !== undefined ? { url: props.url } : {}),
+                ...(props.watchdogMs !== undefined
+                    ? { watchdogMs: props.watchdogMs }
+                    : {}),
+                ...(props.reconnectBaseMs !== undefined
+                    ? { reconnectBaseMs: props.reconnectBaseMs }
+                    : {}),
+                ...(props.reconnectMaxMs !== undefined
+                    ? { reconnectMaxMs: props.reconnectMaxMs }
+                    : {}),
+            }, (envelope) => {
+                dispatchEnvelope(envelope);
+                leader.fanoutFrame(envelope);
+            }, (frameType, data) => {
+                dispatchControl(frameType, data);
+                leader.fanoutControl(frameType, data);
+            }, () => {
+                if (props.onResync)
+                    props.onResync();
+                void queryClient.invalidateQueries();
+            }, undefined, dispatchTransportStatus);
+            sseRef.current = sse;
+            sse.start();
+        },
+        onDemoted: () => {
+            setIsLeader(false);
+            setState({ status: 'idle' });
+            if (sseRef.current) {
+                sseRef.current.stop();
+                sseRef.current = null;
+            }
+        },
+        onFrame: dispatchEnvelope,
+        onControl: dispatchControl,
+    }), [props.orgId]);
+    (0, react_1.useEffect)(() => {
+        leader.start();
+        return () => {
+            leader.stop();
+            if (sseRef.current) {
+                sseRef.current.stop();
+                sseRef.current = null;
+            }
+            setState({ status: 'closed' });
+        };
+    }, [leader]);
+    const value = (0, react_1.useMemo)(() => ({
+        isLeader,
+        state,
+        subscribe(eventType, handler) {
+            const subs = subscribersRef.current.get(eventType) ?? new Set();
+            subs.add(handler);
+            subscribersRef.current.set(eventType, subs);
+            return () => {
+                subs.delete(handler);
+            };
+        },
+        async subscribeToScope(connectionId, scope) {
+            const key = `${scope.kind}:${scope.id}`;
+            const current = scopeRefcountsRef.current.get(key) ?? 0;
+            scopeRefcountsRef.current.set(key, current + 1);
+            if (current > 0) {
+                return;
+            }
+            const token = await Promise.resolve(props.tokenProvider());
+            const sseUrl = props.url ?? '/realtime/stream';
+            const subscriptionsUrl = sseUrl.replace(/\/stream\/?$/, `/streams/${encodeURIComponent(connectionId)}/subscriptions`);
+            await fetch(subscriptionsUrl, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                    'X-Org-Id': props.orgId,
+                },
+                body: JSON.stringify({ scope: scope.kind, id: scope.id }),
+            });
+        },
+        unsubscribeFromScope(scope) {
+            const key = `${scope.kind}:${scope.id}`;
+            const current = scopeRefcountsRef.current.get(key) ?? 0;
+            if (current <= 1) {
+                scopeRefcountsRef.current.delete(key);
+            }
+            else {
+                scopeRefcountsRef.current.set(key, current - 1);
+            }
+        },
+    }), [isLeader, state, props.orgId, props.tokenProvider]);
+    return ((0, jsx_runtime_1.jsx)(RealtimeContext.Provider, { value: value, children: props.children }));
+}
+function useCloudEvent(eventType, handler) {
+    const ctx = (0, react_1.useContext)(RealtimeContext);
+    (0, react_1.useEffect)(() => {
+        if (!ctx)
+            return;
+        return ctx.subscribe(eventType, handler);
+    }, [ctx, eventType, handler]);
+}
+function useRealtimeContext() {
+    const ctx = (0, react_1.useContext)(RealtimeContext);
+    if (!ctx) {
+        throw new Error('useRealtimeContext must be used inside a RealtimeProvider.');
+    }
+    return ctx;
+}
+function useRealtimeStatus() {
+    const ctx = (0, react_1.useContext)(RealtimeContext);
+    return ctx?.state ?? { status: 'idle' };
+}
+function useRealtimeIsLeader() {
+    return useRealtimeContext().isLeader;
+}
+//# sourceMappingURL=realtime-context.js.map

package/dist/lib/realtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-context.js","sourceRoot":"","sources":["../../src/lib/realtime-context.tsx"],"names":[],"mappings":";;AAmKA,4CAqNC;AAGD,sCASC;AAED,gDAQC;AAQD,8CAGC;AAGD,kDAEC;;AA9ZD,iCASe;AAEf,uDAAuD;AACvD,mEAIiC;AACjC,uDAAmD;AACnD,6CAIsB;AAsEtB,MAAM,eAAe,GAAG,IAAA,qBAAa,EAA8B,IAAI,CAAC,CAAC;AAEzE,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAAE,OAAO,uBAAuB,CAAC;IAC9E,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,cAAc,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,cAAc,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA0B;IAIrD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;QACtE,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAqB,EACrB,gBAA4B;IAE5B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IAC3D,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAGnE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE;QAC9B,QAAQ;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,UAAU;QACV,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,SAAS,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACpC,MAAM,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAC9B,UAAU,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACtC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC1B,gBAAgB;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,SAAiB,EAAE,IAAa;IAGlE,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;QACtC,SAAS;QACT,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AASD,SAAgB,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,WAAW,GAAG,IAAA,4BAAc,GAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAA,cAAM,EAAmB,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAA,cAAM,EAC3B,IAAI,GAAG,EAAgD,CACxD,CAAC;IAEF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAA0B;QAC1D,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAKH,MAAM,iBAAiB,GAAG,IAAA,cAAM,EAAC,IAAI,GAAG,EAAkB,CAAC,CAAC;IAC5D,MAAM,yBAAyB,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAC;IAC9D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;QACvC,IAAI,GAAG,KAAK,yBAAyB,CAAC,OAAO,EAAE,CAAC;YAC9C,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,yBAAyB,CAAC,OAAO,GAAG,GAAG,CAAC;QAC1C,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzB,MAAM,gBAAgB,GAAG,IAAA,mBAAW,EAClC,CAAC,QAAiC,EAAQ,EAAE;QAC1C,MAAM,KAAK,GAAG,QAAqC,CAAC;QACpD,MAAM,IAAI,GAAG,kDAA0B,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChE,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,WAAW,CAAC,iBAAiB,CAAC;gBACjC,QAAQ,EAAE,GAAyB;aACpC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,EAAE,CAAC,KAAK,CAAC,CAAC;gBACZ,CAAC;gBAAC,MAAM,CAAC;gBAET,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,eAAe,GAAG,IAAA,mBAAW,EACjC,CAAC,SAAiB,EAAE,IAAa,EAAQ,EAAE;QACzC,0BAA0B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,KAAK,WAAW,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,GAAG,GAAI,IAAmC,CAAC,YAAY,CAAC;YAC9D,QAAQ,CAAC;gBACP,MAAM,EAAE,WAAW;gBACnB,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,EACD,EAAE,CACH,CAAC;IAQF,MAAM,uBAAuB,GAAG,IAAA,mBAAW,EACzC,CAAC,SAA6B,EAAQ,EAAE;QACtC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,SAAS,KAAK,QAAQ;gBAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACxD,IAAI,SAAS,KAAK,cAAc;gBAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YACpE,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;gBAC/B,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW;oBAChC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE;oBAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;YAC/B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,eAAO,EACpB,GAAG,EAAE,CACH,IAAI,gCAAc,CAAC,KAAK,CAAC,KAAK,EAAE;QAC9B,UAAU,EAAE,GAAG,EAAE;YACf,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,sBAAS,CACvB;gBACE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS;oBACrC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE;oBAC5C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;oBAC1C,CAAC,CAAC,EAAE,CAAC;aACR,EACD,CAAC,QAAQ,EAAE,EAAE;gBACX,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC3B,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC,EACD,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE;gBAClB,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACjC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC,EACD,GAAG,EAAE;gBACH,IAAI,KAAK,CAAC,QAAQ;oBAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,KAAK,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACvC,CAAC,EACD,SAAS,EACT,uBAAuB,CACxB,CAAC;YACF,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,WAAW,CAAC,KAAK,CAAC,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,eAAe;KAC3B,CAAC,EAGJ,CAAC,KAAK,CAAC,KAAK,CAAC,CACd,CAAC;IAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ;QACR,KAAK;QACL,SAAS,CAAC,SAAS,EAAE,OAAO;YAC1B,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YAChE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClB,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK;YACxC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAChD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAEhB,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,kBAAkB,CAAC;YAC/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CACrC,cAAc,EACd,YAAY,kBAAkB,CAAC,YAAY,CAAC,gBAAgB,CAC7D,CAAC;YACF,MAAM,KAAK,CAAC,gBAAgB,EAAE;gBAC5B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,KAAK,EAAE;oBAChC,cAAc,EAAE,kBAAkB;oBAClC,UAAU,EAAE,KAAK,CAAC,KAAK;iBACxB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;QACD,oBAAoB,CAAC,KAAK;YACxB,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjB,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAClD,CAAC;QAKH,CAAC;KACF,CAAC,EAEF,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CACpD,CAAC;IAEF,OAAO,CACL,uBAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACnC,KAAK,CAAC,QAAQ,GACU,CAC5B,CAAC;AACJ,CAAC;AAGD,SAAgB,aAAa,CAC3B,SAAiB,EACjB,OAAwC;IAExC,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,eAAe,CAAC,CAAC;IACxC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,eAAe,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,SAAgB,iBAAiB;IAC/B,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,eAAe,CAAC,CAAC;IACxC,OAAO,GAAG,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAGD,SAAgB,mBAAmB;IACjC,OAAO,kBAAkB,EAAE,CAAC,QAAQ,CAAC;AACvC,CAAC"}

package/dist/lib/sse-client.d.ts

@@ -0,0 +1,43 @@
+import { CursorStore, type ClientCursorMap } from './cursor-store';
+export interface SseClientOptions {
+    url?: string;
+    tokenProvider: () => Promise<string> | string;
+    orgId: string;
+    watchdogMs?: number;
+    reconnectBaseMs?: number;
+    reconnectMaxMs?: number;
+}
+export type SseEventHandler = (envelope: Record<string, unknown>) => void;
+export type SseControlHandler = (frameType: string, data: unknown) => void;
+export type SseResyncHandler = () => void;
+export type SseTransportStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';
+export type SseStatusHandler = (status: SseTransportStatus) => void;
+export declare class SseClient {
+    private readonly options;
+    private readonly onEnvelope;
+    private readonly onControl;
+    private readonly onResync;
+    private readonly onStatus?;
+    private readonly cursorStore;
+    private readonly url;
+    private readonly watchdogMs;
+    private readonly baseMs;
+    private readonly maxMs;
+    private abortController;
+    private watchdogTimer;
+    private reconnectAttempt;
+    private stopped;
+    constructor(options: SseClientOptions, onEnvelope: SseEventHandler, onControl: SseControlHandler, onResync: SseResyncHandler, cursorStore?: CursorStore, onStatus?: SseStatusHandler | undefined);
+    private emitStatus;
+    start(): void;
+    stop(): void;
+    cursors(): ClientCursorMap;
+    private connect;
+    private handleParsed;
+    private captureCursors;
+    private captureControlCursors;
+    private armWatchdog;
+    private clearWatchdog;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/lib/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/lib/sse-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAE/B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAE9C,KAAK,EAAE,MAAM,CAAC;IAEd,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3E,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAgB1C,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,MAAM,GACN,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAapE,qBAAa,SAAS;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAhB5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAGL,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,gBAAgB,EAC3C,WAAW,CAAC,EAAE,WAAW,EACR,QAAQ,CAAC,EAAE,gBAAgB,YAAA;IAS9C,OAAO,CAAC,UAAU;IAKlB,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAWZ,OAAO,IAAI,eAAe;YAMZ,OAAO;IA4ErB,OAAO,CAAC,YAAY;IA2DpB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;CAS1B"}