@calimero-network/mero-js 1.0.2 → 1.2.0

package/dist/auth/index.js

@@ -0,0 +1,51 @@
+/**
+ * Parse an auth callback URL hash fragment.
+ * Returns null if access_token is missing.
+ */
+export function parseAuthCallback(url) {
+    try {
+        const hashIndex = url.indexOf('#');
+        if (hashIndex === -1)
+            return null;
+        const hash = url.substring(hashIndex + 1);
+        const params = new URLSearchParams(hash);
+        const accessToken = params.get('access_token');
+        if (!accessToken)
+            return null;
+        return {
+            accessToken,
+            refreshToken: params.get('refresh_token') ?? '',
+            applicationId: params.get('application_id') ?? '',
+            contextId: params.get('context_id') ?? '',
+            contextIdentity: params.get('context_identity') ?? '',
+            nodeUrl: params.get('node_url') ?? '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the auth login URL for redirecting users to the node's auth page.
+ */
+export function buildAuthLoginUrl(nodeUrl, opts) {
+    const params = new URLSearchParams();
+    params.set('callback-url', opts.callbackUrl);
+    if (opts.permissions && opts.permissions.length > 0) {
+        params.set('permissions', opts.permissions.join(','));
+    }
+    params.set('mode', opts.mode);
+    if (opts.packageName) {
+        params.set('package-name', opts.packageName);
+        if (opts.packageVersion) {
+            params.set('package-version', opts.packageVersion);
+        }
+        if (opts.registryUrl) {
+            params.set('registry-url', opts.registryUrl);
+        }
+    }
+    // Trim trailing slash from nodeUrl
+    const base = nodeUrl.replace(/\/+$/, '');
+    return `${base}/auth/login?${params.toString()}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI;QACF,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAElC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAE9B,OAAO;YACL,WAAW;YACX,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE;YAC/C,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE;YACjD,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE;YACzC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE;YACrD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE;SACtC,CAAC;KACH;IAAC,MAAM;QACN,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAsB;IACvE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAE7C,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;QACnD,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;KACvD;IAED,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9B,IAAI,IAAI,CAAC,WAAW,EAAE;QACpB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,cAAc,EAAE;YACvB,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;SACpD;QACD,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;SAC9C;KACF;IAED,mCAAmC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,OAAO,GAAG,IAAI,eAAe,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACnD,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,5 @@
+export { SseClient } from './sse';
+export type { SseEventData } from './sse';
+export { WsClient } from './ws';
+export type { WsEventData } from './ws';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,3 @@
+export { SseClient } from './sse';
+export { WsClient } from './ws';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}

package/dist/events/sse.d.ts

@@ -0,0 +1,41 @@
+export interface SseEventData {
+    contextId: string;
+    data: unknown;
+}
+type SseEventHandler = (event: SseEventData) => void;
+type SseConnectHandler = (sessionId: string) => void;
+type SseErrorHandler = (error: Error) => void;
+export declare class SseClient {
+    private baseUrl;
+    private getAuthToken;
+    private reconnectDelayMs;
+    private sessionId;
+    private abortController;
+    private reconnectTimer;
+    private subscribedContextIds;
+    private closed;
+    private listeners;
+    constructor(opts: {
+        baseUrl: string;
+        getAuthToken: () => Promise<string>;
+        reconnectDelayMs?: number;
+    });
+    on(event: 'connect', handler: SseConnectHandler): void;
+    on(event: 'event', handler: SseEventHandler): void;
+    on(event: 'error', handler: SseErrorHandler): void;
+    off(event: 'connect', handler: SseConnectHandler): void;
+    off(event: 'event', handler: SseEventHandler): void;
+    off(event: 'error', handler: SseErrorHandler): void;
+    private emit;
+    connect(): Promise<void>;
+    private readStream;
+    private handleMessage;
+    subscribe(contextIds: string[]): Promise<void>;
+    unsubscribe(contextIds: string[]): Promise<void>;
+    private sendSubscription;
+    private forceReconnect;
+    private scheduleReconnect;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=sse.d.ts.map

package/dist/events/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/events/sse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AACrD,KAAK,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AACrD,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAQ9C,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,oBAAoB,CAA0B;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAuD;gBAE5D,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAMD,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IACtD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAClD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAUlD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IACvD,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IACnD,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAWnD,OAAO,CAAC,IAAI;IAiBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAwChB,UAAU;IA6CxB,OAAO,CAAC,aAAa;IAuCf,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAUxC,gBAAgB;IAuB9B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,iBAAiB;IAWzB,KAAK,IAAI,IAAI;CAad"}

package/dist/events/sse.js

@@ -0,0 +1,237 @@
+export class SseClient {
+    constructor(opts) {
+        this.sessionId = null;
+        this.abortController = null;
+        this.reconnectTimer = null;
+        this.subscribedContextIds = new Set();
+        this.closed = false;
+        this.listeners = { connect: [], event: [], error: [] };
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.getAuthToken = opts.getAuthToken;
+        this.reconnectDelayMs = opts.reconnectDelayMs ?? 3000;
+    }
+    on(event, handler) {
+        const key = event;
+        if (key in this.listeners) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const arr = this.listeners[key];
+            if (!arr.includes(handler))
+                arr.push(handler);
+        }
+    }
+    off(event, handler) {
+        const key = event;
+        if (key in this.listeners) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const arr = this.listeners[key];
+            const idx = arr.indexOf(handler);
+            if (idx !== -1)
+                arr.splice(idx, 1);
+        }
+    }
+    emit(event, arg) {
+        const key = event;
+        if (key in this.listeners) {
+            for (const handler of this.listeners[key]) {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    handler(arg);
+                }
+                catch {
+                    // Swallow handler errors
+                }
+            }
+        }
+    }
+    async connect() {
+        // Already connected — don't reconnect
+        if (this.abortController && !this.closed) {
+            return;
+        }
+        this.closed = false;
+        this.abortController = new AbortController();
+        try {
+            const token = await this.getAuthToken();
+            const response = await fetch(`${this.baseUrl}/sse`, {
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Accept': 'text/event-stream',
+                },
+                signal: this.abortController.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`SSE connection failed: ${response.status}`);
+            }
+            if (!response.body) {
+                throw new Error('SSE response has no body');
+            }
+            this.readStream(response.body).catch((err) => {
+                if (this.closed)
+                    return;
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.emit('error', error);
+                this.scheduleReconnect();
+            });
+        }
+        catch (err) {
+            if (this.closed)
+                return;
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('error', error);
+            this.scheduleReconnect();
+        }
+    }
+    async readStream(body) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                // Keep the last partial line in the buffer
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (line.startsWith('data:')) {
+                        const jsonStr = line.slice(5).trim();
+                        if (jsonStr) {
+                            this.handleMessage(jsonStr);
+                        }
+                    }
+                }
+            }
+            // Flush remaining bytes from the decoder
+            buffer += decoder.decode();
+            if (buffer.startsWith('data:')) {
+                const jsonStr = buffer.slice(5).trim();
+                if (jsonStr) {
+                    this.handleMessage(jsonStr);
+                }
+            }
+        }
+        catch (err) {
+            if (this.closed)
+                return;
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('error', error);
+        }
+        // Stream ended, reconnect
+        if (!this.closed) {
+            this.scheduleReconnect();
+        }
+    }
+    handleMessage(jsonStr) {
+        try {
+            const msg = JSON.parse(jsonStr);
+            // Connection message
+            if (msg.type === 'connect' && msg.session_id) {
+                this.sessionId = msg.session_id;
+                this.emit('connect', msg.session_id);
+                // Re-subscribe after reconnect
+                if (this.subscribedContextIds.size > 0) {
+                    this.sendSubscription('subscribe', [...this.subscribedContextIds]);
+                }
+                return;
+            }
+            // Context event message
+            if (msg.result && msg.result.contextId) {
+                let eventData = msg.result.data;
+                // Decode byte-array data if needed
+                if (Array.isArray(eventData)) {
+                    try {
+                        const bytes = new Uint8Array(eventData);
+                        const text = new TextDecoder().decode(bytes);
+                        eventData = JSON.parse(text);
+                    }
+                    catch {
+                        // Keep raw data
+                    }
+                }
+                this.emit('event', {
+                    contextId: msg.result.contextId,
+                    data: eventData,
+                });
+            }
+        }
+        catch {
+            // Invalid JSON, ignore
+        }
+    }
+    async subscribe(contextIds) {
+        const newIds = contextIds.filter(id => !this.subscribedContextIds.has(id));
+        for (const id of contextIds) {
+            this.subscribedContextIds.add(id);
+        }
+        if (newIds.length > 0 && this.sessionId) {
+            await this.sendSubscription('subscribe', newIds);
+        }
+    }
+    async unsubscribe(contextIds) {
+        const hadIds = contextIds.filter(id => this.subscribedContextIds.has(id));
+        for (const id of contextIds) {
+            this.subscribedContextIds.delete(id);
+        }
+        if (hadIds.length > 0 && this.sessionId) {
+            await this.sendSubscription('unsubscribe', hadIds);
+        }
+    }
+    async sendSubscription(method, contextIds) {
+        try {
+            const token = await this.getAuthToken();
+            const response = await fetch(`${this.baseUrl}/sse/subscription`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    id: this.sessionId,
+                    method,
+                    params: { contextIds },
+                }),
+            });
+            if (!response.ok) {
+                this.emit('error', new Error(`SSE ${method} failed: ${response.status}`));
+            }
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(`SSE ${method} failed`));
+        }
+    }
+    forceReconnect() {
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this.sessionId = null;
+        this.connect();
+    }
+    scheduleReconnect() {
+        if (this.closed)
+            return;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+        }
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.forceReconnect();
+        }, this.reconnectDelayMs);
+    }
+    close() {
+        this.closed = true;
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.sessionId = null;
+        this.subscribedContextIds.clear();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/events/sse.js.map

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

package/dist/events/ws.d.ts

@@ -0,0 +1,42 @@
+export interface WsEventData {
+    contextId: string;
+    data: unknown;
+}
+type WsEventHandler = (event: WsEventData) => void;
+type WsConnectHandler = () => void;
+type WsErrorHandler = (error: Error) => void;
+/**
+ * @experimental WebSocket event client. The SSE client (`SseClient`) is the
+ * recommended transport for production — use `MeroJs.events` instead of `MeroJs.ws`.
+ */
+export declare class WsClient {
+    private baseUrl;
+    private getAuthToken;
+    private ws;
+    private closed;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private subscribedContextIds;
+    private listeners;
+    private static readonly MAX_BACKOFF_MS;
+    constructor(opts: {
+        baseUrl: string;
+        getAuthToken: () => Promise<string>;
+    });
+    on(event: 'connect', handler: WsConnectHandler): void;
+    on(event: 'event', handler: WsEventHandler): void;
+    on(event: 'error', handler: WsErrorHandler): void;
+    off(event: 'connect', handler: WsConnectHandler): void;
+    off(event: 'event', handler: WsEventHandler): void;
+    off(event: 'error', handler: WsErrorHandler): void;
+    private emit;
+    connect(): Promise<void>;
+    private handleMessage;
+    subscribe(contextIds: string[]): void;
+    unsubscribe(contextIds: string[]): void;
+    private sendMessage;
+    private scheduleReconnect;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=ws.d.ts.map

package/dist/events/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/events/ws.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AACnD,KAAK,gBAAgB,GAAG,MAAM,IAAI,CAAC;AACnC,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAQ7C;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,oBAAoB,CAA0B;IACtD,OAAO,CAAC,SAAS,CAAsD;IAEvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAEnC,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KACrC;IAKD,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IACrD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IACjD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAUjD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IACtD,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAClD,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAWlD,OAAO,CAAC,IAAI;IAiBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD9B,OAAO,CAAC,aAAa;IA4BrB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAcrC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAcvC,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,iBAAiB;IAgBzB,KAAK,IAAI,IAAI;CAad"}

package/dist/events/ws.js

@@ -0,0 +1,178 @@
+/**
+ * @experimental WebSocket event client. The SSE client (`SseClient`) is the
+ * recommended transport for production — use `MeroJs.events` instead of `MeroJs.ws`.
+ */
+export class WsClient {
+    constructor(opts) {
+        this.ws = null;
+        this.closed = false;
+        this.reconnectAttempt = 0;
+        this.reconnectTimer = null;
+        this.subscribedContextIds = new Set();
+        this.listeners = { connect: [], event: [], error: [] };
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.getAuthToken = opts.getAuthToken;
+    }
+    on(event, handler) {
+        const key = event;
+        if (key in this.listeners) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const arr = this.listeners[key];
+            if (!arr.includes(handler))
+                arr.push(handler);
+        }
+    }
+    off(event, handler) {
+        const key = event;
+        if (key in this.listeners) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const arr = this.listeners[key];
+            const idx = arr.indexOf(handler);
+            if (idx !== -1)
+                arr.splice(idx, 1);
+        }
+    }
+    emit(event, arg) {
+        const key = event;
+        if (key in this.listeners) {
+            for (const handler of this.listeners[key]) {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    handler(arg);
+                }
+                catch {
+                    // Swallow handler errors
+                }
+            }
+        }
+    }
+    async connect() {
+        if (this.ws && (this.ws.readyState === WebSocket.CONNECTING || this.ws.readyState === WebSocket.OPEN)) {
+            return;
+        }
+        this.closed = false;
+        try {
+            const token = await this.getAuthToken();
+            if (!token) {
+                throw new Error('No authentication token available for WebSocket connection');
+            }
+            // Browser WebSocket API can't set headers, use query param
+            const wsUrl = this.baseUrl.replace(/^http/, 'ws');
+            this.ws = new WebSocket(`${wsUrl}/ws?token=${encodeURIComponent(token)}`);
+            this.ws.onopen = () => {
+                this.reconnectAttempt = 0;
+                this.emit('connect');
+                // Re-subscribe on reconnect
+                if (this.subscribedContextIds.size > 0) {
+                    this.sendMessage({
+                        id: null,
+                        method: 'subscribe',
+                        params: { contextIds: [...this.subscribedContextIds] },
+                    });
+                }
+            };
+            this.ws.onmessage = (event) => {
+                this.handleMessage(event.data);
+            };
+            this.ws.onerror = () => {
+                this.emit('error', new Error('WebSocket error'));
+            };
+            this.ws.onclose = () => {
+                if (!this.closed) {
+                    this.scheduleReconnect();
+                }
+            };
+        }
+        catch (err) {
+            if (this.closed)
+                return;
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('error', error);
+            this.scheduleReconnect();
+        }
+    }
+    handleMessage(raw) {
+        if (typeof raw !== 'string')
+            return;
+        try {
+            const msg = JSON.parse(raw);
+            if (msg.result && msg.result.contextId) {
+                let eventData = msg.result.data;
+                if (Array.isArray(eventData)) {
+                    try {
+                        const bytes = new Uint8Array(eventData);
+                        const text = new TextDecoder().decode(bytes);
+                        eventData = JSON.parse(text);
+                    }
+                    catch {
+                        // Keep raw data
+                    }
+                }
+                this.emit('event', {
+                    contextId: msg.result.contextId,
+                    data: eventData,
+                });
+            }
+        }
+        catch {
+            // Invalid JSON, ignore
+        }
+    }
+    subscribe(contextIds) {
+        for (const id of contextIds) {
+            this.subscribedContextIds.add(id);
+        }
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.sendMessage({
+                id: null,
+                method: 'subscribe',
+                params: { contextIds },
+            });
+        }
+    }
+    unsubscribe(contextIds) {
+        for (const id of contextIds) {
+            this.subscribedContextIds.delete(id);
+        }
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.sendMessage({
+                id: null,
+                method: 'unsubscribe',
+                params: { contextIds },
+            });
+        }
+    }
+    sendMessage(msg) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(msg));
+        }
+    }
+    scheduleReconnect() {
+        if (this.closed)
+            return;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+        }
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempt), WsClient.MAX_BACKOFF_MS);
+        this.reconnectAttempt++;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+    close() {
+        this.closed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.subscribedContextIds.clear();
+    }
+}
+WsClient.MAX_BACKOFF_MS = 30000;
+//# sourceMappingURL=ws.js.map

package/dist/events/ws.js.map

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

package/dist/http-client/http-factory.d.ts

@@ -4,6 +4,12 @@ export declare function createBrowserHttpClient(options: {
     baseUrl: string;
     getAuthToken?: () => Promise<string | undefined>;
     onTokenRefresh?: (newToken: string) => Promise<void>;
+    /**
+     * Callback to refresh the access token when a 401 error with 'token_expired' is detected.
+     * Should return the new access token, or throw an error if refresh fails.
+     * If provided, the client will automatically retry the request after a successful refresh.
+     */
+    refreshToken?: () => Promise<string>;
     defaultHeaders?: Record<string, string>;
     timeoutMs?: number;
     credentials?: RequestCredentials;
@@ -14,6 +20,12 @@ export declare function createNodeHttpClient(options: {
     fetch?: typeof fetch;
     getAuthToken?: () => Promise<string | undefined>;
     onTokenRefresh?: (newToken: string) => Promise<void>;
+    /**
+     * Callback to refresh the access token when a 401 error with 'token_expired' is detected.
+     * Should return the new access token, or throw an error if refresh fails.
+     * If provided, the client will automatically retry the request after a successful refresh.
+     */
+    refreshToken?: () => Promise<string>;
     defaultHeaders?: Record<string, string>;
     timeoutMs?: number;
     credentials?: RequestCredentials;
@@ -24,6 +36,12 @@ export declare function createUniversalHttpClient(options: {
     fetch?: typeof fetch;
     getAuthToken?: () => Promise<string | undefined>;
     onTokenRefresh?: (newToken: string) => Promise<void>;
+    /**
+     * Callback to refresh the access token when a 401 error with 'token_expired' is detected.
+     * Should return the new access token, or throw an error if refresh fails.
+     * If provided, the client will automatically retry the request after a successful refresh.
+     */
+    refreshToken?: () => Promise<string>;
     defaultHeaders?: Record<string, string>;
     timeoutMs?: number;
     credentials?: RequestCredentials;

package/dist/http-client/http-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-factory.d.ts","sourceRoot":"","sources":["../../src/http-client/http-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAEjE;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CAeb;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CAiCb;AAGD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CASb"}
+{"version":3,"file":"http-factory.d.ts","sourceRoot":"","sources":["../../src/http-client/http-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAEjE;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CAgBb;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CAkCb;AAGD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,GAAG,UAAU,CASb"}