@asteby/metacore-websocket 0.5.0 → 2.0.0

package/README.md

@@ -78,3 +78,72 @@ function MyComponent() {
 
 - `useWebSocket<TMessage>()` — returns `{ status, isConnected, lastMessage, lastEvent, send, disconnect, reconnect, subscribe }`.
 - `useWebSocketMessage<TMessage>(type, handler)` — typed subscription; auto-unsubscribes on unmount.
+
+## Realtime data events (`createRealtimeClient`)
+
+The wire protocol behind `host.realtime` / `api.realtime` (contract:
+`RealtimeAPI` in `@asteby/metacore-sdk`). The host bridges the kernel's
+canonical CRUD events into lean, **org-scoped, value-free** `DATA_EVENT`
+frames; addons subscribe by model and refetch what they show. Nothing flows
+until somebody subscribes.
+
+```
+client → server  {"type":"SUBSCRIBE","models":["SalesOrder","work_orders"]}
+                 {"type":"UNSUBSCRIBE","models":["SalesOrder"]}
+server → client  {"type":"DATA_SUBSCRIBED","payload":{"models":[...]}}
+                 {"type":"DATA_EVENT","payload":{org_id,addon,model,table,action,id,
+                                                 stage_from?,stage_to?,actor_id?,at,fields?,coalesced?}}
+                 {"type":"DATA_EVENTS_DROPPED","payload":{"dropped":N,"models":[...]}}
+```
+
+A subscription token matches a frame when it equals (case-insensitively) the
+model key, the table name or `addon.Model`; `"*"` matches everything. The
+server coalesces bursts on the same `(model, id)` (~150 ms) and rate-limits
+each connection; when frames are dropped the client synthesises one `resync`
+event per subscribed model so consumers refetch instead of trusting a stream
+with a hole in it. The same happens after a reconnect.
+
+### Own socket (a standalone addon or a non-React host)
+
+```ts
+import { createRealtimeClient } from '@asteby/metacore-websocket'
+
+// GET /api/realtime/info → { enabled, ws_url, channels: ['org:<id>'], ... }
+const info = await api.get('/realtime/info').then((r) => r.data.data)
+
+const realtime = createRealtimeClient({
+  wsUrl: info.ws_url,
+  channel: info.channels[0],
+  getToken: () => useAuthStore.getState().auth.accessToken,
+})
+
+const off = realtime.subscribe({ models: ['SalesOrder'] }, (e) => {
+  if (e.action === 'resync' || e.id === currentId) refetch()
+})
+// later
+off()
+realtime.close()
+```
+
+### Host socket (what ops does — one socket for chat, presence, calls AND data)
+
+```ts
+import { createRealtimeClient, transportFromHostSocket } from '@asteby/metacore-websocket'
+
+const realtime = createRealtimeClient({
+  transport: transportFromHostSocket({
+    subscribe: ws.subscribe, // (type, handler) => unsubscribe
+    send: (frame) => ws.sendMessage(JSON.stringify(frame)),
+    isConnected: () => ws.isConnected,
+    onConnected: (listener) => ws.onConnected(listener),
+  }),
+})
+// hand `realtime` to addons: <Mounted host={{ ..., realtime }} /> or api.realtime
+```
+
+`RealtimeClient` also exposes `onStatus(listener)`, `subscribedModels()`,
+`serverModels()` (last `DATA_SUBSCRIBED` ack) and `close()`. `subscribe` never
+throws and may be called before the socket is open — the `SUBSCRIBE` frame is
+sent on the next open. React consumers should use `useRealtime` /
+`useRealtimeInvalidate` from `@asteby/metacore-runtime-react` instead of
+calling the client directly.

package/dist/index.d.ts

@@ -1,7 +1,17 @@
 export { WebSocketProvider, WebSocketContext } from './provider';
 export { useWebSocket, useWebSocketMessage } from './hooks';
 export { WebSocketStatus } from './types';
-export type { WebSocketMessage, WebSocketContextValue, WebSocketProviderProps, SendPayload, TokenGetter, } from './types';
+export type { WebSocketMessage, WebSocketContextValue, WebSocketProviderProps, SendPayload, TokenGetter, CallKind, CallInvitePayload, CallJoinPayload, CallSignalPayload, CallEndPayload, CallSignalType, } from './types';
+/** Well-known WebSocket message types for realtime A/V calls. */
+export declare const CallMessageType: {
+    readonly Invite: "CALL_INVITE";
+    readonly Join: "CALL_JOIN";
+    readonly Signal: "CALL_SIGNAL";
+    readonly End: "CALL_END";
+};
+export type CallMessageType = (typeof CallMessageType)[keyof typeof CallMessageType];
+export { createRealtimeClient, createSocketTransport, transportFromHostSocket, } from './realtime';
+export type { RealtimeClient, RealtimeClientOptions, RealtimeTransport, RealtimeFrame, HostSocketLike, } from './realtime';
 export { createChannelClient } from './channels';
 export type { ChannelClient, ChannelClientOptions, ChannelMessageHandler, ChannelConnectionState, } from './channels';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAA;AAEhB,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAIpF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,6 +1,16 @@
 export { WebSocketProvider, WebSocketContext } from './provider';
 export { useWebSocket, useWebSocketMessage } from './hooks';
 export { WebSocketStatus } from './types';
+/** Well-known WebSocket message types for realtime A/V calls. */
+export const CallMessageType = {
+    Invite: 'CALL_INVITE',
+    Join: 'CALL_JOIN',
+    Signal: 'CALL_SIGNAL',
+    End: 'CALL_END',
+};
+// Realtime data-event client (org-scoped DATA_EVENT protocol behind
+// `host.realtime` / `api.realtime` — see @asteby/metacore-sdk RealtimeAPI).
+export { createRealtimeClient, createSocketTransport, transportFromHostSocket, } from './realtime';
 // Multi-channel imperative client (one socket per logical channel, routed
 // by query params). Complements the single-socket WebSocketProvider.
 export { createChannelClient } from './channels';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AASzC,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAezC,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,aAAa;IACrB,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,aAAa;IACrB,GAAG,EAAE,UAAU;CACP,CAAA;AAIV,oEAAoE;AACpE,4EAA4E;AAC5E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AASnB,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/realtime.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Realtime data-event client — the wire protocol behind `host.realtime` /
+ * `api.realtime` (see `RealtimeAPI` in `@asteby/metacore-sdk`).
+ *
+ * Protocol (server = ops hub, `docs/REALTIME.md`):
+ *
+ *   client → server  {"type":"SUBSCRIBE","models":["SalesOrder","work_orders"]}
+ *                    {"type":"UNSUBSCRIBE","models":["SalesOrder"]}
+ *   server → client  {"type":"DATA_SUBSCRIBED","payload":{"models":[...]}}
+ *                    {"type":"DATA_EVENT","payload":{org_id,addon,model,table,action,id,...}}
+ *                    {"type":"DATA_EVENTS_DROPPED","payload":{"dropped":N,"models":[...]}}
+ *
+ * The client ref-counts models across every `subscribe()` call so the server
+ * only ever forwards what somebody on this page is listening to, re-sends the
+ * whole subscription set on every (re)open, and turns a reconnect or a
+ * DROPPED notice into synthetic `resync` events so consumers refetch instead
+ * of trusting a stream with a hole in it.
+ *
+ * Two ways to run it:
+ *
+ *   1. Own socket — `createRealtimeClient({ wsUrl, getToken, channel })`.
+ *      Opens `wsUrl?channel=org:<id>&token=<jwt>` with reconnect/backoff.
+ *   2. Host socket — `createRealtimeClient({ transport })` where the host
+ *      adapts its existing authenticated connection (`send`, `onFrame`,
+ *      `isOpen`, `onOpen`). This is what ops does: one socket for chat,
+ *      presence, calls AND data events.
+ */
+import type { DataEvent, RealtimeAPI, RealtimeStatus } from '@asteby/metacore-sdk';
+/** Minimal frame shape the client reads off the transport. */
+export interface RealtimeFrame {
+    type: string;
+    payload?: unknown;
+}
+/**
+ * Transport adapter for hosts that already own an authenticated socket. Every
+ * method must be safe to call at any time (before open, after close).
+ */
+export interface RealtimeTransport {
+    /** Send a JSON-serialisable frame. Return false when the socket is not open. */
+    send(frame: unknown): boolean;
+    /** Receive every parsed frame. Returns an unsubscribe function. */
+    onFrame(handler: (frame: RealtimeFrame) => void): () => void;
+    /** True while the socket is OPEN. */
+    isOpen(): boolean;
+    /** Fires after every successful (re)open. Returns an unsubscribe function. */
+    onOpen(handler: () => void): () => void;
+    /** Optional status feed — when absent the client derives it from isOpen/onOpen. */
+    onStatus?(handler: (status: RealtimeStatus) => void): () => void;
+    status?(): RealtimeStatus;
+    /** Optional teardown (own-socket transports close the socket). */
+    close?(): void;
+}
+export interface RealtimeClientOptions {
+    /** Base WS URL (e.g. `wss://panel.example.com/ws`) — own-socket mode. */
+    wsUrl?: string;
+    /** JWT getter — own-socket mode. `null` postpones the connection. */
+    getToken?: () => string | null | undefined;
+    /** Channel to join, e.g. `org:<org_id>` (from `GET /api/realtime/info`). */
+    channel?: string;
+    /** Reuse the host's socket instead of opening one. Wins over `wsUrl`. */
+    transport?: RealtimeTransport;
+    /** Base reconnect delay in ms (own-socket mode). Default 2000. */
+    reconnectInterval?: number;
+    /** Max reconnect attempts (own-socket mode). Default Infinity. */
+    maxReconnectAttempts?: number;
+    /** Tap every delivered event (diagnostics). */
+    onEvent?: (event: DataEvent) => void;
+    /** Diagnostics logger. Silent by default. */
+    log?: (msg: string, data?: unknown) => void;
+}
+export interface RealtimeClient extends RealtimeAPI {
+    /** Observe status changes. Returns an unsubscribe function. */
+    onStatus(listener: (status: RealtimeStatus) => void): () => void;
+    /** Models currently ref-counted on this page (normalised, sorted). */
+    subscribedModels(): string[];
+    /** Models the server last acknowledged (`DATA_SUBSCRIBED`). */
+    serverModels(): string[];
+    /** Drop every subscription and, in own-socket mode, close the socket. */
+    close(): void;
+}
+/**
+ * Build a realtime client. Never throws from `subscribe`; a transport that is
+ * not open yet simply defers the SUBSCRIBE frame to the next open.
+ */
+export declare function createRealtimeClient(options: RealtimeClientOptions): RealtimeClient;
+/**
+ * Own-socket transport: native WebSocket on `wsUrl?channel=…&token=…` with
+ * exponential backoff (capped at 30 s). Exported so hosts can wrap it or
+ * reuse it for other channels.
+ */
+export declare function createSocketTransport(options: RealtimeClientOptions): RealtimeTransport;
+/**
+ * Adapter for hosts whose socket exposes `subscribe(type, handler)` +
+ * `send(payload)` + a live `isConnected` flag (the ops `WebSocketProvider`
+ * shape). `onConnected` must invoke its callback with the current flag AND on
+ * every change — React hosts typically wire it to an effect on `isConnected`.
+ */
+export interface HostSocketLike {
+    subscribe: (type: string, handler: (frame: RealtimeFrame) => void) => () => void;
+    send: (payload: unknown) => void;
+    isConnected: () => boolean;
+    /** Register a listener for connection-state changes. */
+    onConnected: (listener: (connected: boolean) => void) => () => void;
+}
+export declare function transportFromHostSocket(host: HostSocketLike): RealtimeTransport;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,SAAS,EAET,WAAW,EACX,cAAc,EAEf,MAAM,sBAAsB,CAAA;AAG7B,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7B,mEAAmE;IACnE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC5D,qCAAqC;IACrC,MAAM,IAAI,OAAO,CAAA;IACjB,8EAA8E;IAC9E,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAChE,MAAM,CAAC,IAAI,cAAc,CAAA;IACzB,kEAAkE;IAClE,KAAK,CAAC,IAAI,IAAI,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACpC,6CAA6C;IAC7C,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAChE,sEAAsE;IACtE,gBAAgB,IAAI,MAAM,EAAE,CAAA;IAC5B,+DAA+D;IAC/D,YAAY,IAAI,MAAM,EAAE,CAAA;IACxB,yEAAyE;IACzE,KAAK,IAAI,IAAI,CAAA;CACd;AAeD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA+KnF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAmKvF;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAChF,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,WAAW,EAAE,MAAM,OAAO,CAAA;IAC1B,wDAAwD;IACxD,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CACpE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAiC/E"}

package/dist/realtime.js

@@ -0,0 +1,437 @@
+/**
+ * Realtime data-event client — the wire protocol behind `host.realtime` /
+ * `api.realtime` (see `RealtimeAPI` in `@asteby/metacore-sdk`).
+ *
+ * Protocol (server = ops hub, `docs/REALTIME.md`):
+ *
+ *   client → server  {"type":"SUBSCRIBE","models":["SalesOrder","work_orders"]}
+ *                    {"type":"UNSUBSCRIBE","models":["SalesOrder"]}
+ *   server → client  {"type":"DATA_SUBSCRIBED","payload":{"models":[...]}}
+ *                    {"type":"DATA_EVENT","payload":{org_id,addon,model,table,action,id,...}}
+ *                    {"type":"DATA_EVENTS_DROPPED","payload":{"dropped":N,"models":[...]}}
+ *
+ * The client ref-counts models across every `subscribe()` call so the server
+ * only ever forwards what somebody on this page is listening to, re-sends the
+ * whole subscription set on every (re)open, and turns a reconnect or a
+ * DROPPED notice into synthetic `resync` events so consumers refetch instead
+ * of trusting a stream with a hole in it.
+ *
+ * Two ways to run it:
+ *
+ *   1. Own socket — `createRealtimeClient({ wsUrl, getToken, channel })`.
+ *      Opens `wsUrl?channel=org:<id>&token=<jwt>` with reconnect/backoff.
+ *   2. Host socket — `createRealtimeClient({ transport })` where the host
+ *      adapts its existing authenticated connection (`send`, `onFrame`,
+ *      `isOpen`, `onOpen`). This is what ops does: one socket for chat,
+ *      presence, calls AND data events.
+ */
+import { dataEventMatches } from '@asteby/metacore-sdk';
+const DATA_EVENT = 'DATA_EVENT';
+const DATA_SUBSCRIBED = 'DATA_SUBSCRIBED';
+const DATA_EVENTS_DROPPED = 'DATA_EVENTS_DROPPED';
+function normaliseModel(raw) {
+    return raw.trim().toLowerCase();
+}
+/**
+ * Build a realtime client. Never throws from `subscribe`; a transport that is
+ * not open yet simply defers the SUBSCRIBE frame to the next open.
+ */
+export function createRealtimeClient(options) {
+    const log = options.log ?? (() => { });
+    const transport = options.transport ?? createSocketTransport(options);
+    const subscriptions = new Set();
+    const modelCounts = new Map();
+    let acked = [];
+    let everOpened = false;
+    let closed = false;
+    const statusListeners = new Set();
+    const currentStatus = () => {
+        if (transport.status)
+            return transport.status();
+        return transport.isOpen() ? 'open' : closed ? 'closed' : 'connecting';
+    };
+    const emitStatus = (status) => {
+        statusListeners.forEach((l) => {
+            try {
+                l(status);
+            }
+            catch (err) {
+                log('status listener threw', err);
+            }
+        });
+    };
+    const send = (type, models) => {
+        if (models.length === 0)
+            return;
+        if (!transport.isOpen())
+            return;
+        transport.send({ type, models });
+    };
+    const dispatch = (event) => {
+        options.onEvent?.(event);
+        subscriptions.forEach((sub) => {
+            if (!dataEventMatches(sub.opts, event))
+                return;
+            try {
+                sub.handler(event);
+            }
+            catch (err) {
+                log('data event handler threw', err);
+            }
+        });
+    };
+    /** Synthesises one `resync` per subscribed model so every consumer refetches. */
+    const resyncAll = (reason) => {
+        const at = new Date().toISOString();
+        const models = Array.from(modelCounts.keys());
+        if (models.length === 0)
+            return;
+        log(`resync (${reason})`, models);
+        for (const model of models) {
+            dispatch({
+                org_id: '',
+                addon: '',
+                model,
+                action: 'resync',
+                id: '',
+                at,
+            });
+        }
+    };
+    const offFrame = transport.onFrame((frame) => {
+        if (!frame || typeof frame.type !== 'string')
+            return;
+        switch (frame.type) {
+            case DATA_EVENT: {
+                const p = frame.payload;
+                if (!p || typeof p.model !== 'string' || typeof p.action !== 'string')
+                    return;
+                dispatch({
+                    org_id: String(p.org_id ?? ''),
+                    addon: String(p.addon ?? ''),
+                    model: p.model,
+                    table: typeof p.table === 'string' ? p.table : undefined,
+                    action: p.action,
+                    id: String(p.id ?? ''),
+                    stage_from: typeof p.stage_from === 'string' ? p.stage_from : undefined,
+                    stage_to: typeof p.stage_to === 'string' ? p.stage_to : undefined,
+                    actor_id: typeof p.actor_id === 'string' ? p.actor_id : undefined,
+                    at: typeof p.at === 'string' ? p.at : new Date().toISOString(),
+                    fields: Array.isArray(p.fields) ? p.fields : undefined,
+                    coalesced: typeof p.coalesced === 'number' ? p.coalesced : undefined,
+                });
+                return;
+            }
+            case DATA_SUBSCRIBED: {
+                const p = frame.payload;
+                acked = Array.isArray(p?.models) ? p.models.map(String) : [];
+                return;
+            }
+            case DATA_EVENTS_DROPPED:
+                resyncAll('server dropped frames');
+                return;
+            default:
+                return;
+        }
+    });
+    const offOpen = transport.onOpen(() => {
+        const models = Array.from(modelCounts.keys());
+        send('SUBSCRIBE', models);
+        if (everOpened) {
+            // Frames emitted during the gap are gone — refetch everything shown.
+            resyncAll('reconnect');
+        }
+        everOpened = true;
+        emitStatus('open');
+    });
+    const offStatus = transport.onStatus
+        ? transport.onStatus((s) => {
+            if (s !== 'open')
+                emitStatus(s);
+        })
+        : () => { };
+    const subscribe = (opts, handler) => {
+        if (closed)
+            return () => { };
+        const sub = { opts: { ...opts, models: opts.models ?? [] }, handler };
+        subscriptions.add(sub);
+        const added = [];
+        for (const raw of sub.opts.models ?? []) {
+            const m = normaliseModel(raw);
+            if (!m)
+                continue;
+            const n = (modelCounts.get(m) ?? 0) + 1;
+            modelCounts.set(m, n);
+            if (n === 1)
+                added.push(m);
+        }
+        send('SUBSCRIBE', added);
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            subscriptions.delete(sub);
+            const removed = [];
+            for (const raw of sub.opts.models ?? []) {
+                const m = normaliseModel(raw);
+                if (!m)
+                    continue;
+                const n = (modelCounts.get(m) ?? 0) - 1;
+                if (n <= 0) {
+                    modelCounts.delete(m);
+                    removed.push(m);
+                }
+                else {
+                    modelCounts.set(m, n);
+                }
+            }
+            send('UNSUBSCRIBE', removed);
+        };
+    };
+    return {
+        subscribe,
+        status: currentStatus,
+        onStatus(listener) {
+            statusListeners.add(listener);
+            return () => {
+                statusListeners.delete(listener);
+            };
+        },
+        subscribedModels: () => Array.from(modelCounts.keys()).sort(),
+        serverModels: () => acked.slice(),
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            const models = Array.from(modelCounts.keys());
+            send('UNSUBSCRIBE', models);
+            subscriptions.clear();
+            modelCounts.clear();
+            offFrame();
+            offOpen();
+            offStatus();
+            transport.close?.();
+            emitStatus('closed');
+            statusListeners.clear();
+        },
+    };
+}
+/**
+ * Own-socket transport: native WebSocket on `wsUrl?channel=…&token=…` with
+ * exponential backoff (capped at 30 s). Exported so hosts can wrap it or
+ * reuse it for other channels.
+ */
+export function createSocketTransport(options) {
+    const frameHandlers = new Set();
+    const openHandlers = new Set();
+    const statusHandlers = new Set();
+    const log = options.log ?? (() => { });
+    const baseDelay = options.reconnectInterval ?? 2000;
+    const maxAttempts = options.maxReconnectAttempts ?? Number.POSITIVE_INFINITY;
+    let ws = null;
+    let attempts = 0;
+    let timer = null;
+    let closed = false;
+    let status = 'closed';
+    const setStatus = (s) => {
+        status = s;
+        statusHandlers.forEach((h) => {
+            try {
+                h(s);
+            }
+            catch (err) {
+                log('status handler threw', err);
+            }
+        });
+    };
+    const buildUrl = () => {
+        if (!options.wsUrl)
+            return null;
+        const token = options.getToken?.();
+        if (options.getToken && !token)
+            return null;
+        let url;
+        try {
+            url = new URL(options.wsUrl, typeof window !== 'undefined' ? window.location.href : undefined);
+        }
+        catch {
+            return null;
+        }
+        if (options.channel)
+            url.searchParams.set('channel', options.channel);
+        if (token)
+            url.searchParams.set('token', token);
+        return url.toString();
+    };
+    const schedule = () => {
+        if (closed || attempts >= maxAttempts)
+            return;
+        const delay = Math.min(baseDelay * 2 ** attempts, 30_000);
+        attempts += 1;
+        timer = setTimeout(connect, delay);
+    };
+    const connect = () => {
+        if (closed || typeof WebSocket === 'undefined')
+            return;
+        const url = buildUrl();
+        if (!url) {
+            // No token yet — poll again with backoff.
+            schedule();
+            return;
+        }
+        setStatus('connecting');
+        let socket;
+        try {
+            socket = new WebSocket(url);
+        }
+        catch (err) {
+            log('socket construct failed', err);
+            setStatus('closed');
+            schedule();
+            return;
+        }
+        ws = socket;
+        socket.onopen = () => {
+            attempts = 0;
+            setStatus('open');
+            openHandlers.forEach((h) => {
+                try {
+                    h();
+                }
+                catch (err) {
+                    log('open handler threw', err);
+                }
+            });
+        };
+        socket.onmessage = (ev) => {
+            if (typeof ev.data !== 'string')
+                return;
+            let parsed = null;
+            try {
+                parsed = JSON.parse(ev.data);
+            }
+            catch {
+                return;
+            }
+            if (!parsed || typeof parsed.type !== 'string')
+                return;
+            frameHandlers.forEach((h) => {
+                try {
+                    h(parsed);
+                }
+                catch (err) {
+                    log('frame handler threw', err);
+                }
+            });
+        };
+        socket.onerror = (ev) => log('socket error', ev);
+        socket.onclose = (ev) => {
+            if (ws === socket)
+                ws = null;
+            setStatus('closed');
+            // 1008 = policy violation (channel/org mismatch) — never retry that.
+            if (closed || ev.code === 1008)
+                return;
+            schedule();
+        };
+    };
+    // Connect lazily on the first listener so building a client is side-effect free.
+    const ensureConnected = () => {
+        if (!ws && !timer && !closed)
+            connect();
+    };
+    return {
+        send(frame) {
+            if (!ws || ws.readyState !== WebSocket.OPEN)
+                return false;
+            try {
+                ws.send(typeof frame === 'string' ? frame : JSON.stringify(frame));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        onFrame(handler) {
+            frameHandlers.add(handler);
+            ensureConnected();
+            return () => {
+                frameHandlers.delete(handler);
+            };
+        },
+        isOpen: () => !!ws && ws.readyState === WebSocket.OPEN,
+        onOpen(handler) {
+            openHandlers.add(handler);
+            ensureConnected();
+            return () => {
+                openHandlers.delete(handler);
+            };
+        },
+        onStatus(handler) {
+            statusHandlers.add(handler);
+            return () => {
+                statusHandlers.delete(handler);
+            };
+        },
+        status: () => status,
+        close() {
+            closed = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            const socket = ws;
+            ws = null;
+            if (socket) {
+                socket.onopen = null;
+                socket.onmessage = null;
+                socket.onerror = null;
+                socket.onclose = null;
+                try {
+                    socket.close(1000, 'realtime client closed');
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            setStatus('closed');
+        },
+    };
+}
+export function transportFromHostSocket(host) {
+    const statusHandlers = new Set();
+    return {
+        send(frame) {
+            if (!host.isConnected())
+                return false;
+            host.send(frame);
+            return true;
+        },
+        onFrame(handler) {
+            const offs = [DATA_EVENT, DATA_SUBSCRIBED, DATA_EVENTS_DROPPED].map((t) => host.subscribe(t, handler));
+            return () => offs.forEach((off) => off());
+        },
+        isOpen: () => host.isConnected(),
+        onOpen(handler) {
+            let was = host.isConnected();
+            if (was)
+                handler();
+            return host.onConnected((connected) => {
+                if (connected && !was)
+                    handler();
+                was = connected;
+            });
+        },
+        onStatus(handler) {
+            statusHandlers.add(handler);
+            const off = host.onConnected((connected) => handler(connected ? 'open' : 'connecting'));
+            return () => {
+                statusHandlers.delete(handler);
+                off();
+            };
+        },
+        status: () => (host.isConnected() ? 'open' : 'connecting'),
+    };
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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

package/dist/realtime.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realtime.test.d.ts.map

package/dist/realtime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.test.d.ts","sourceRoot":"","sources":["../src/realtime.test.ts"],"names":[],"mappings":""}

package/dist/realtime.test.js

@@ -0,0 +1,193 @@
+// createRealtimeClient over a fake transport: subscription ref-counting,
+// (re)subscribe on open, DATA_EVENT dispatch with model/action filters, and
+// the resync synthesised on DROPPED notices / reconnects.
+import { describe, expect, it, vi } from 'vitest';
+import { createRealtimeClient, transportFromHostSocket } from './realtime';
+function fakeTransport(open = true) {
+    const frameHandlers = new Set();
+    const openHandlers = new Set();
+    const sent = [];
+    let isOpen = open;
+    const transport = {
+        send: (frame) => {
+            if (!isOpen)
+                return false;
+            sent.push(frame);
+            return true;
+        },
+        onFrame: (h) => {
+            frameHandlers.add(h);
+            return () => frameHandlers.delete(h);
+        },
+        isOpen: () => isOpen,
+        onOpen: (h) => {
+            openHandlers.add(h);
+            return () => openHandlers.delete(h);
+        },
+        close: vi.fn(),
+    };
+    return {
+        transport,
+        sent,
+        open() {
+            isOpen = true;
+            openHandlers.forEach((h) => h());
+        },
+        drop() {
+            isOpen = false;
+        },
+        frame(f) {
+            frameHandlers.forEach((h) => h(f));
+        },
+    };
+}
+const event = (over = {}) => ({
+    org_id: 'org-1',
+    addon: 'pos',
+    model: 'SalesOrder',
+    table: 'sales_orders',
+    action: 'updated',
+    id: 'so-1',
+    at: '2026-08-31T00:00:00Z',
+    fields: ['status'],
+    ...over,
+});
+describe('createRealtimeClient', () => {
+    it('sends SUBSCRIBE once per model and UNSUBSCRIBE when the last listener leaves', () => {
+        const t = fakeTransport();
+        const client = createRealtimeClient({ transport: t.transport });
+        const offA = client.subscribe({ models: ['SalesOrder', 'WorkOrder'] }, () => { });
+        const offB = client.subscribe({ models: ['salesorder'] }, () => { });
+        expect(t.sent).toEqual([{ type: 'SUBSCRIBE', models: ['salesorder', 'workorder'] }]);
+        expect(client.subscribedModels()).toEqual(['salesorder', 'workorder']);
+        offA();
+        // WorkOrder had a single listener → unsubscribed; SalesOrder still has B.
+        expect(t.sent[1]).toEqual({ type: 'UNSUBSCRIBE', models: ['workorder'] });
+        offB();
+        expect(t.sent[2]).toEqual({ type: 'UNSUBSCRIBE', models: ['salesorder'] });
+        expect(client.subscribedModels()).toEqual([]);
+        // Idempotent unsubscribe.
+        offB();
+        expect(t.sent).toHaveLength(3);
+    });
+    it('defers SUBSCRIBE until the transport opens and re-sends the full set on every open', () => {
+        const t = fakeTransport(false);
+        const client = createRealtimeClient({ transport: t.transport });
+        const handler = vi.fn();
+        client.subscribe({ models: ['SalesOrder'] }, handler);
+        expect(t.sent).toEqual([]);
+        t.open();
+        expect(t.sent).toEqual([{ type: 'SUBSCRIBE', models: ['salesorder'] }]);
+        expect(client.status()).toBe('open');
+        // First open → no resync (nothing was missed).
+        expect(handler).not.toHaveBeenCalled();
+        t.drop();
+        t.open();
+        expect(t.sent[1]).toEqual({ type: 'SUBSCRIBE', models: ['salesorder'] });
+        // Reconnect → synthetic resync so consumers refetch.
+        expect(handler).toHaveBeenCalledTimes(1);
+        expect(handler.mock.calls[0][0]).toMatchObject({ action: 'resync', model: 'salesorder' });
+    });
+    it('dispatches DATA_EVENT frames only to matching subscriptions', () => {
+        const t = fakeTransport();
+        const client = createRealtimeClient({ transport: t.transport });
+        const byModel = vi.fn();
+        const byTable = vi.fn();
+        const byQualified = vi.fn();
+        const other = vi.fn();
+        const onlyDeletes = vi.fn();
+        client.subscribe({ models: ['SalesOrder'] }, byModel);
+        client.subscribe({ models: ['sales_orders'] }, byTable);
+        client.subscribe({ models: ['pos.SalesOrder'] }, byQualified);
+        client.subscribe({ models: ['WorkOrder'] }, other);
+        client.subscribe({ models: ['SalesOrder'], events: ['deleted'] }, onlyDeletes);
+        t.frame({ type: 'DATA_EVENT', payload: event() });
+        expect(byModel).toHaveBeenCalledTimes(1);
+        expect(byTable).toHaveBeenCalledTimes(1);
+        expect(byQualified).toHaveBeenCalledTimes(1);
+        expect(other).not.toHaveBeenCalled();
+        expect(onlyDeletes).not.toHaveBeenCalled();
+        expect(byModel.mock.calls[0][0]).toEqual(event());
+        t.frame({ type: 'DATA_EVENT', payload: event({ action: 'deleted', fields: undefined }) });
+        expect(onlyDeletes).toHaveBeenCalledTimes(1);
+        // Malformed / unrelated frames are ignored.
+        t.frame({ type: 'DATA_EVENT', payload: { nope: true } });
+        t.frame({ type: 'NOTIFICATION', payload: { title: 'x' } });
+        expect(byModel).toHaveBeenCalledTimes(2);
+    });
+    it('records the server ack and turns DROPPED notices into resync events', () => {
+        const t = fakeTransport();
+        const client = createRealtimeClient({ transport: t.transport });
+        const handler = vi.fn();
+        client.subscribe({ models: ['SalesOrder', 'WorkOrder'] }, handler);
+        t.frame({ type: 'DATA_SUBSCRIBED', payload: { models: ['salesorder', 'workorder'] } });
+        expect(client.serverModels()).toEqual(['salesorder', 'workorder']);
+        t.frame({ type: 'DATA_EVENTS_DROPPED', payload: { dropped: 7, models: ['salesorder'] } });
+        expect(handler).toHaveBeenCalledTimes(2);
+        expect(handler.mock.calls.map((c) => c[0].model).sort()).toEqual(['salesorder', 'workorder']);
+        expect(handler.mock.calls.every((c) => c[0].action === 'resync')).toBe(true);
+    });
+    it('never lets a throwing handler starve the others', () => {
+        const t = fakeTransport();
+        const log = vi.fn();
+        const client = createRealtimeClient({ transport: t.transport, log });
+        const bad = vi.fn(() => {
+            throw new Error('boom');
+        });
+        const good = vi.fn();
+        client.subscribe({ models: ['SalesOrder'] }, bad);
+        client.subscribe({ models: ['SalesOrder'] }, good);
+        t.frame({ type: 'DATA_EVENT', payload: event() });
+        expect(good).toHaveBeenCalledTimes(1);
+        expect(log).toHaveBeenCalled();
+    });
+    it('close() unsubscribes everything, closes the transport and reports closed', () => {
+        const t = fakeTransport();
+        const client = createRealtimeClient({ transport: t.transport });
+        const status = vi.fn();
+        client.onStatus(status);
+        client.subscribe({ models: ['SalesOrder'] }, () => { });
+        client.close();
+        expect(t.sent.at(-1)).toEqual({ type: 'UNSUBSCRIBE', models: ['salesorder'] });
+        expect(t.transport.close).toHaveBeenCalled();
+        expect(status).toHaveBeenCalledWith('closed');
+        expect(client.subscribedModels()).toEqual([]);
+        // After close, subscribe is a no-op.
+        const off = client.subscribe({ models: ['X'] }, () => { });
+        off();
+        expect(client.subscribedModels()).toEqual([]);
+    });
+});
+describe('transportFromHostSocket', () => {
+    it('adapts a host subscribe/send/isConnected surface', () => {
+        const subs = new Map();
+        const sent = [];
+        let connected = false;
+        const listeners = new Set();
+        const transport = transportFromHostSocket({
+            subscribe: (type, handler) => {
+                subs.set(type, handler);
+                return () => subs.delete(type);
+            },
+            send: (p) => sent.push(p),
+            isConnected: () => connected,
+            onConnected: (l) => {
+                listeners.add(l);
+                return () => listeners.delete(l);
+            },
+        });
+        const client = createRealtimeClient({ transport });
+        const handler = vi.fn();
+        client.subscribe({ models: ['SalesOrder'] }, handler);
+        expect(sent).toEqual([]); // not connected yet
+        expect(client.status()).toBe('connecting');
+        connected = true;
+        listeners.forEach((l) => l(true));
+        expect(sent).toEqual([{ type: 'SUBSCRIBE', models: ['salesorder'] }]);
+        expect(client.status()).toBe('open');
+        subs.get('DATA_EVENT')({ type: 'DATA_EVENT', payload: event() });
+        expect(handler).toHaveBeenCalledTimes(1);
+        expect(subs.has('DATA_EVENTS_DROPPED')).toBe(true);
+    });
+});
+//# sourceMappingURL=realtime.test.js.map

package/dist/realtime.test.js.map

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

package/dist/types.d.ts

@@ -86,4 +86,47 @@ export interface WebSocketContextValue<TMessage extends WebSocketMessage = WebSo
     /** Register a handler for a specific message `type`. Returns an unsubscribe fn. */
     subscribe: <T extends TMessage = TMessage>(type: T['type'], handler: (message: T) => void) => () => void;
 }
+/** Audio / video / screen-share call kind. */
+export type CallKind = 'audio' | 'video' | 'screen';
+export type CallSignalType = 'offer' | 'answer' | 'ice';
+/** Host → clients: someone started a call in a channel. */
+export interface CallInvitePayload {
+    call_id: string;
+    channel_id: string;
+    kind: CallKind;
+    from_user_id: string;
+    from_name?: string;
+}
+/** Peer joined an existing call (mesh renegotiation trigger). */
+export interface CallJoinPayload {
+    call_id: string;
+    channel_id: string;
+    user_id: string;
+    name?: string;
+}
+/**
+ * SDP / ICE relay. `to_user_id` is set for directed mesh edges; omit to
+ * broadcast to every other participant (rare — prefer directed).
+ */
+export interface CallSignalPayload {
+    call_id: string;
+    channel_id: string;
+    from_user_id: string;
+    to_user_id?: string;
+    signal_type: CallSignalType;
+    sdp?: RTCSessionDescriptionInit | {
+        type: string;
+        sdp?: string;
+    };
+    candidate?: RTCIceCandidateInit | null;
+}
+export interface CallEndPayload {
+    call_id: string;
+    channel_id: string;
+    /** Who hung up / ended the room (mesh v1 ends for everyone). */
+    ended_by?: string;
+    /** @deprecated Prefer ended_by */
+    user_id?: string;
+    reason?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,OAAO;IACjF,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAE9F,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,eAAe,GAAG,gBAAgB,CAAA;AAE9F,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB;IAC1F,4DAA4D;IAC5D,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAA;IAC3E,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,WAAW,CAAA;IAC9B,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC/B,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IACrC,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAC5D,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,qBAAqB,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB;IACzF,iCAAiC;IACjC,MAAM,EAAE,eAAe,CAAA;IACvB,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAA;IACpB,6CAA6C;IAC7C,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC5B,wDAAwD;IACxD,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;IAC9B;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAA;IACvC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,iDAAiD;IACjD,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,mFAAmF;IACnF,SAAS,EAAE,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACvC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,MAAM,IAAI,CAAA;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-websocket",
-  "version": "0.5.0",
+  "version": "2.0.0",
   "description": "Metacore WebSocket provider — auto-reconnect, typed messages, channel subscriptions",
   "license": "Apache-2.0",
   "repository": {
@@ -35,14 +35,17 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "react-dom": ">=18"
+    "react-dom": ">=18",
+    "@asteby/metacore-sdk": "^3.8.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "typescript": "^6.0.0"
+    "typescript": "^6.0.0",
+    "vitest": "^4.0.0",
+    "@asteby/metacore-sdk": "3.8.0"
   },
   "publishConfig": {
     "access": "public"
@@ -51,6 +54,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -w -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }