@owlmeans/client-socket 0.1.18-rc.21 → 0.1.18-rc.23

package/build/status.js

@@ -0,0 +1,94 @@
+import { createService } from '@owlmeans/context';
+import { useContext } from '@owlmeans/client';
+import { useEffect, useState } from 'react';
+export const SOCKET_STATUS = 'socket-status';
+const RANK = { online: 0, reconnecting: 1, lost: 2 };
+/**
+ * Aggregates the coarse health of every `ws()`/`useWs()` connection an app has open into one
+ * worst-of-all state. A page with several sockets (thinking stream, file watch, notifications…)
+ * still shows one dialog, not one per socket — so the aggregate, not any single connection, is
+ * what a UI like `SocketReloadDialog` reads.
+ */
+export const createSocketStatusService = (alias = SOCKET_STATUS) => {
+    const states = new Map();
+    const listeners = new Set();
+    let current = 'online';
+    const recompute = () => {
+        let worst = 'online';
+        for (const state of states.values()) {
+            if (RANK[state] > RANK[worst])
+                worst = state;
+        }
+        if (worst !== current) {
+            current = worst;
+            listeners.forEach(listener => listener(current));
+        }
+    };
+    return createService(alias, {
+        report: (id, state) => { states.set(id, state); recompute(); },
+        release: (id) => { states.delete(id); recompute(); },
+        state: () => current,
+        subscribe: listener => {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+    }, service => async () => { service.initialized = true; });
+};
+/**
+ * Register the shared socket-status aggregator. Idempotent, and cheap enough for a host package
+ * (`@owlmeans/web-panel`) to call unconditionally on every context: every `ws()`/`useWs()`
+ * connection reports itself here if — and only if — the context carries this service, so an app
+ * that never calls this behaves exactly as it did before reconnect support existed.
+ */
+export const appendSocketStatus = (ctx, alias = SOCKET_STATUS) => {
+    const _ctx = ctx;
+    if (!ctx.hasService(alias)) {
+        ctx.registerService(createSocketStatusService(alias));
+    }
+    _ctx.socketStatus = () => ctx.service(alias);
+    return _ctx;
+};
+const readSocketStatusService = (ctx) => {
+    try {
+        return typeof ctx.hasService === 'function' && ctx.hasService(SOCKET_STATUS)
+            ? ctx.socketStatus?.() ?? null : null;
+    }
+    catch {
+        // Registered but not yet run through the context's OWN `init()` — a component that renders
+        // as a sibling of the router (as `SocketReloadDialog` does) mounts before that finishes,
+        // since `context.configure().init()` runs from the router's effect, not before React's
+        // first commit. Treat it as "not ready yet" rather than crash the render.
+        return null;
+    }
+};
+/**
+ * The worst state across every live `ws()`/`useWs()` connection, or `'online'` if the app never
+ * registered the status service (`appendSocketStatus`) or has not finished initializing yet.
+ */
+export const useSocketStatus = () => {
+    const ctx = useContext();
+    const [state, setState] = useState(() => readSocketStatusService(ctx)?.state() ?? 'online');
+    useEffect(() => {
+        let cancelled = false;
+        let unsubscribe = null;
+        const attach = () => {
+            const service = readSocketStatusService(ctx);
+            if (service == null)
+                return false;
+            setState(service.state());
+            unsubscribe = service.subscribe(next => { if (!cancelled)
+                setState(next); });
+            return true;
+        };
+        if (!attach()) {
+            void ctx.waitForInitialized?.().then(() => { if (!cancelled)
+                attach(); });
+        }
+        return () => {
+            cancelled = true;
+            unsubscribe?.();
+        };
+    }, [ctx]);
+    return state;
+};
+//# sourceMappingURL=status.js.map

package/build/status.js.map

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

package/build/types.d.ts

@@ -1,7 +1,71 @@
 import type { ClientConfig } from '@owlmeans/client-context';
 import type { ClientContext } from '@owlmeans/client';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
+import type { InitializedService } from '@owlmeans/context';
 export interface Config extends ClientConfig {
+    socket?: SocketClientSettings;
 }
 export interface Context<C extends Config = Config> extends ClientContext<C> {
 }
+/**
+ * How aggressively a dropped socket is retried, and when the carrier gives up on it.
+ *
+ * The delay grows geometrically from `minDelay` to `maxDelay` (±`jitter`, a fraction of the
+ * computed delay) and stays there. `budget` is measured from the connection's FIRST failed
+ * attempt in an outage — a socket that opens and drops again right away does not get a fresh
+ * budget — and `stableAfter` is how long a reopened socket must stay up before the attempt
+ * counter and the outage clock reset, so a flapping link is never read as "recovered" between
+ * two drops a second apart.
+ */
+export interface ReconnectPolicy {
+    /** First retry delay, in ms. Default 200. */
+    minDelay: number;
+    /** Delay ceiling, in ms — the backoff never grows past this. Default 3000. */
+    maxDelay: number;
+    /** Geometric growth factor applied to the delay after every failed attempt. Default 2. */
+    factor: number;
+    /** Randomization applied to each computed delay, as a fraction of it. Default 0.1 (±10%). */
+    jitter: number;
+    /** Total time, in ms, the carrier keeps retrying before it reports the socket lost. Default
+     *  600000 (10 minutes). */
+    budget: number;
+    /** How long a reopened socket must stay open before the attempt count and the outage clock
+     *  reset, in ms. Default 10000. */
+    stableAfter: number;
+    /** Heartbeat ping interval, in ms. Default 30000. */
+    heartbeat: number;
+    /** How long to wait for ANY inbound frame after a ping before treating the socket as dead and
+     *  forcing it closed, in ms. Default 10000. */
+    pongTimeout: number;
+}
+export interface SocketClientSettings {
+    /** `false` disables reconnection outright — a dropped socket is reported gone and stays gone,
+     *  the pre-reconnect-support behaviour. Anything else merges over the defaults. */
+    reconnect?: false | Partial<ReconnectPolicy>;
+}
+export interface ConnectOptions {
+    reconnect?: false | Partial<ReconnectPolicy>;
+}
+export interface WsOptions extends ConnectOptions {
+    /**
+     * Run before every connection attempt, the first one included, given the request that will be
+     * turned into the socket URL — where a caller refreshes a token or other query/param value
+     * that may have changed since the previous attempt.
+     */
+    beforeConnect?: (request: AbstractRequest<any>) => void | Promise<void>;
+}
+/** The coarse health of a socket connection — the worst of everything a status service tracks. */
+export type SocketConnectionState = 'online' | 'reconnecting' | 'lost';
+export interface SocketStatusService extends InitializedService {
+    /** Record this connection's current state under `id` — call again to update it. */
+    report: (id: string, state: SocketConnectionState) => void;
+    /** Stop tracking `id` (the connection closed on purpose). */
+    release: (id: string) => void;
+    /** The worst state across every tracked connection; `'online'` when none are tracked. */
+    state: () => SocketConnectionState;
+    subscribe: (listener: (state: SocketConnectionState) => void) => () => void;
+}
+export interface SocketStatusServiceAppend {
+    socketStatus: () => SocketStatusService;
+}
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,MAAM,WAAW,MAAO,SAAQ,YAAY;CAAI;AAEhD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,MAAO,SAAQ,YAAY;IAC1C,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAC9B;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEhF;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAA;IACd;+BAC2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd;uCACmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAA;IACjB;mDAC+C;IAC/C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;uFACmF;IACnF,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxE;AAED,kGAAkG;AAClG,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,CAAA;AAEtE,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,mFAAmF;IACnF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAC1D,6DAA6D;IAC7D,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,yFAAyF;IACzF,KAAK,EAAE,MAAM,qBAAqB,CAAA;IAClC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,mBAAmB,CAAA;CACxC"}

package/build/utils/connection.d.ts

@@ -1,4 +1,37 @@
-import type { Config, Context } from '../types.js';
 import type { Connection } from '@owlmeans/socket';
-export declare const makeConnection: <C extends Config = Config, T extends Context<C> = Context<C>>(conn: WebSocket, _context: T) => Connection;
+import type { ReconnectPolicy, SocketConnectionState } from '../types.js';
+export interface ConnectionOpener {
+    (): Promise<WebSocket>;
+}
+export interface ManagedConnectionOptions {
+    policy: ReconnectPolicy;
+    /** Whether a drop schedules a retry at all. `false` keeps the pre-reconnect-support
+     *  behaviour — one attempt, report and stop — while the heartbeat/liveness check below still
+     *  runs exactly as it always did. */
+    retry: boolean;
+    /** Opens a fresh socket for the first attempt and every retry — already reflecting whatever a
+     *  caller's `beforeConnect` refreshed (a token, most often). Resolves once the socket is OPEN,
+     *  rejects on a handshake failure. */
+    open: ConnectionOpener;
+    /** Told this connection's coarse health, if a caller wants to aggregate it — the status
+     *  service `@owlmeans/web-panel`'s reload dialog reads. */
+    onStatus?: (state: SocketConnectionState) => void;
+}
+export interface ManagedConnection {
+    connection: Connection;
+    /** Settles once the first socket opens; rejects with `SocketConnectionError('lost')` once the
+     *  retry budget elapses first (or the single attempt fails, with `retry: false`). */
+    ready: Promise<void>;
+}
+/**
+ * Build a `Connection` whose transport survives a dropped WebSocket.
+ *
+ * The connection MODEL (`createBasicConnection()`) is created exactly once and never replaced —
+ * every `observe`/`listen` a caller registered keeps firing across a reconnect, because only the
+ * underlying `WebSocket` is swapped underneath it. A server's own subscriptions do NOT survive a
+ * new TCP connection, so a caller whose server sets up state only after an in-band
+ * `authenticated` frame (as this platform's handlers do) must replay that frame itself on
+ * `SocketSystemEvent.Reconnected` — this carrier only re-opens the pipe.
+ */
+export declare const makeConnection: (opts: ManagedConnectionOptions) => ManagedConnection;
 //# sourceMappingURL=connection.d.ts.map

package/build/utils/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,kBAAkB,CAAA;AAG5E,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,QACnF,SAAS,YAAY,CAAC,KAC3B,UAkDF,CAAA"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,kBAAkB,CAAA;AAM5E,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAQzE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,eAAe,CAAA;IACvB;;yCAEqC;IACrC,KAAK,EAAE,OAAO,CAAA;IACd;;0CAEsC;IACtC,IAAI,EAAE,gBAAgB,CAAA;IACtB;+DAC2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAA;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAA;IACtB;yFACqF;IACrF,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAU,wBAAwB,KAAG,iBA6L/D,CAAA"}

package/build/utils/connection.js

@@ -1,19 +1,198 @@
-import { createBasicConnection, MessageType } from '@owlmeans/socket';
-export const makeConnection = (conn, _context) => {
+import { createBasicConnection, MessageType, SocketConnectionError, SocketSystemEvent, SOCKET_HEARTBEAT_TIMEOUT_CODE } from '@owlmeans/socket';
+import { AuthenticationStage } from '@owlmeans/auth';
+/** Close codes that mean "this connection is finished on purpose" — never worth retrying: a
+ *  normal closure the SERVER initiated (1000, e.g. the protocol's own one-shot completion) and a
+ *  policy violation (1008, e.g. the guard rejected the frame that opened it). A client-initiated
+ *  close is handled separately, through `closedByClient`. */
+const TERMINAL_CLOSE_CODES = new Set([1000, 1008]);
+/**
+ * Build a `Connection` whose transport survives a dropped WebSocket.
+ *
+ * The connection MODEL (`createBasicConnection()`) is created exactly once and never replaced —
+ * every `observe`/`listen` a caller registered keeps firing across a reconnect, because only the
+ * underlying `WebSocket` is swapped underneath it. A server's own subscriptions do NOT survive a
+ * new TCP connection, so a caller whose server sets up state only after an in-band
+ * `authenticated` frame (as this platform's handlers do) must replay that frame itself on
+ * `SocketSystemEvent.Reconnected` — this carrier only re-opens the pipe.
+ */
+export const makeConnection = (opts) => {
+    const { policy, retry, open, onStatus } = opts;
     const model = createBasicConnection();
+    let current = null;
+    let closedByClient = false;
+    let finished = false;
+    let attempts = 0;
+    let outageStartedAt = null;
+    let stableTimer = null;
+    let retryTimer = null;
+    let heartbeatTimer = null;
+    let lastFrameAt = Date.now();
+    let resolveReady = () => void 0;
+    let rejectReady = () => void 0;
+    const ready = new Promise((resolve, reject) => { resolveReady = resolve; rejectReady = reject; });
+    let settled = false;
+    const settle = (error) => {
+        if (settled)
+            return;
+        settled = true;
+        if (error != null)
+            rejectReady(error);
+        else
+            resolveReady();
+    };
+    const emitSystem = async (event, payload) => {
+        const msg = { type: MessageType.System, event, payload };
+        model.prepare?.(msg);
+        await Promise.all(model.getListeners().map(async (listener) => listener(msg)));
+    };
+    const clearHeartbeat = () => {
+        if (heartbeatTimer != null) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = null;
+        }
+    };
+    const clearTimers = () => {
+        if (retryTimer != null) {
+            clearTimeout(retryTimer);
+            retryTimer = null;
+        }
+        if (stableTimer != null) {
+            clearTimeout(stableTimer);
+            stableTimer = null;
+        }
+        clearHeartbeat();
+    };
+    const startHeartbeat = (socket) => {
+        lastFrameAt = Date.now();
+        heartbeatTimer = setInterval(() => {
+            if (socket.readyState !== WebSocket.OPEN)
+                return;
+            if (Date.now() - lastFrameAt > policy.heartbeat + policy.pongTimeout) {
+                // Silent half-open TCP: nothing at all has arrived since well past a heartbeat interval
+                // plus its grace period — force the close this socket's own stack would eventually
+                // notice on its own, minutes later.
+                socket.close(SOCKET_HEARTBEAT_TIMEOUT_CODE);
+                return;
+            }
+            socket.send(JSON.stringify({ type: 'ping' }));
+        }, policy.heartbeat);
+    };
+    const computeDelay = (attempt) => {
+        const raw = Math.min(policy.maxDelay, policy.minDelay * Math.pow(policy.factor, attempt - 1));
+        const span = raw * policy.jitter;
+        const jittered = raw + (Math.random() * 2 - 1) * span;
+        return Math.max(policy.minDelay, Math.min(policy.maxDelay, Math.round(jittered)));
+    };
+    const finish = async (code) => {
+        if (finished)
+            return;
+        finished = true;
+        closedByClient = true;
+        clearTimers();
+        onStatus?.('lost');
+        await emitSystem(SocketSystemEvent.Close, { code });
+        settle(new SocketConnectionError('lost'));
+    };
+    const scheduleReconnect = (code) => {
+        if (outageStartedAt == null)
+            outageStartedAt = Date.now();
+        if (Date.now() - outageStartedAt >= policy.budget) {
+            void (async () => {
+                onStatus?.('lost');
+                await emitSystem(SocketSystemEvent.Lost, {});
+                await finish(code);
+            })();
+            return;
+        }
+        attempts += 1;
+        const delay = computeDelay(attempts);
+        onStatus?.('reconnecting');
+        void emitSystem(SocketSystemEvent.Reconnecting, { attempt: attempts, delay });
+        retryTimer = setTimeout(() => { retryTimer = null; void attemptConnect(); }, delay);
+    };
+    const attemptConnect = async () => {
+        if (closedByClient)
+            return;
+        try {
+            const socket = await open();
+            onOpened(socket);
+        }
+        catch {
+            if (retry)
+                scheduleReconnect(1006);
+            else
+                void finish(1006);
+        }
+    };
+    const onOpened = (socket) => {
+        current = socket;
+        const wasRetry = attempts > 0;
+        const messageHandler = async (event) => {
+            lastFrameAt = Date.now();
+            await model.receive(event.data);
+        };
+        const errorHandler = () => {
+            // The close event that always follows carries the code; nothing actionable here beyond
+            // keeping the browser's own unhandled-error reporting quiet for it.
+        };
+        const closeHandler = async (event) => {
+            if (current !== socket)
+                return;
+            socket.removeEventListener('message', messageHandler);
+            socket.removeEventListener('close', closeHandler);
+            socket.removeEventListener('error', errorHandler);
+            clearHeartbeat();
+            current = null;
+            if (closedByClient) {
+                await emitSystem(SocketSystemEvent.Close, { code: event.code });
+                return;
+            }
+            if (!retry || TERMINAL_CLOSE_CODES.has(event.code)) {
+                await finish(event.code);
+                return;
+            }
+            if (model._authSequence != null) {
+                model._authSequence.reject(new SocketConnectionError('disconnected'));
+                model._authSequence = undefined;
+            }
+            model.stage = AuthenticationStage.Init;
+            await emitSystem(SocketSystemEvent.Disconnected, { code: event.code });
+            scheduleReconnect(event.code);
+        };
+        socket.addEventListener('message', messageHandler);
+        socket.addEventListener('close', closeHandler);
+        socket.addEventListener('error', errorHandler);
+        startHeartbeat(socket);
+        if (stableTimer != null)
+            clearTimeout(stableTimer);
+        stableTimer = setTimeout(() => { attempts = 0; outageStartedAt = null; }, policy.stableAfter);
+        onStatus?.('online');
+        settle();
+        if (wasRetry)
+            void emitSystem(SocketSystemEvent.Reconnected, { attempts });
+    };
     model.send = async (message) => {
-        if (typeof message !== 'string') {
+        if (typeof message !== 'string')
             model.prepare?.(message);
-        }
-        if (conn.readyState === WebSocket.OPEN) {
-            conn.send(typeof message === 'string' ? message : JSON.stringify(message));
+        if (current?.readyState === WebSocket.OPEN) {
+            current.send(typeof message === 'string' ? message : JSON.stringify(message));
         }
     };
     model.close = async () => {
-        if (conn.readyState === WebSocket.OPEN || conn.readyState === WebSocket.CONNECTING) {
-            conn.close();
+        if (finished)
+            return;
+        finished = true;
+        closedByClient = true;
+        clearTimers();
+        if (current != null && (current.readyState === WebSocket.OPEN || current.readyState === WebSocket.CONNECTING)) {
+            current.close(1000);
         }
-        // @TODO Make sure it trigger close observers
+        else {
+            // No live socket to fire a close event from — mid-retry, or closed before the first open
+            // ever resolved — so report the same frame directly.
+            await emitSystem(SocketSystemEvent.Close, { code: 1000 });
+        }
+        settle(new SocketConnectionError('closed'));
     };
     model.authenticate = async (_stage, _payload) => {
         // @TODO Provide authentication flow logic here
@@ -24,24 +203,7 @@ export const makeConnection = (conn, _context) => {
         message.dt = message.dt ?? Date.now();
         return message;
     };
-    const messageHandler = async (message) => {
-        await model.receive(message.data);
-    };
-    const closeHandler = async (event) => {
-        const msg = {
-            type: MessageType.System,
-            event: 'close',
-            payload: { code: event.code }
-        };
-        if (model.prepare != null) {
-            model.prepare(msg);
-        }
-        await Promise.all(model.getListeners().map(async (listener) => listener(msg)));
-        conn.removeEventListener('message', messageHandler);
-        conn.removeEventListener('close', closeHandler);
-    };
-    conn.addEventListener('message', messageHandler);
-    conn.addEventListener('close', closeHandler);
-    return model;
+    void attemptConnect();
+    return { connection: model, ready };
 };
 //# sourceMappingURL=connection.js.map

package/build/utils/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAe,EAAE,QAAW,EAChB,EAAE;IACd,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAA;IAErC,KAAK,CAAC,IAAI,GAAG,KAAK,EAAC,OAAO,EAAC,EAAE;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC,CAAA;IAED,KAAK,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC;YACnF,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC;QACD,6CAA6C;IAC/C,CAAC,CAAA;IAED,KAAK,CAAC,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC9C,+CAA+C;QAC/C,OAAO,EAAS,CAAA;IAClB,CAAC,CAAA;IAED,KAAK,CAAC,OAAO,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;QACtC,wCAAwC;QACxC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;QACrC,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;QACrD,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAA;IACD,MAAM,YAAY,GAAG,KAAK,EAAE,KAAiB,EAAE,EAAE;QAC/C,MAAM,GAAG,GAA+B;YACtC,IAAI,EAAE,WAAW,CAAC,MAAM;YACxB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;SAC9B,CAAA;QACD,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAC1B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5E,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QACnD,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACjD,CAAC,CAAA;IACD,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;IAChD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IAE5C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@owlmeans/client-socket",
-  "version": "0.1.18-rc.21",
+  "version": "0.1.18-rc.23",
   "license": "MIT",
   "type": "module",
   "scripts": {
     "build": "tsc -b",
     "dev": "sleep 132 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
-    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
   },
   "main": "build/index.js",
   "module": "build/index.js",
@@ -25,19 +26,21 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
+    "@types/bun": "^1.4.0",
     "@types/react": "^19.2.17",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/auth": "^0.1.18-rc.16",
-    "@owlmeans/basic-envelope": "^0.1.18-rc.19",
-    "@owlmeans/client": "^0.1.18-rc.23",
-    "@owlmeans/client-context": "^0.1.18-rc.20",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.20",
-    "@owlmeans/context": "^0.1.18-rc.15",
-    "@owlmeans/entrypoint": "^0.1.18-rc.18",
-    "@owlmeans/socket": "^0.1.18-rc.16"
+    "@owlmeans/auth": "^0.1.18-rc.18",
+    "@owlmeans/basic-envelope": "^0.1.18-rc.21",
+    "@owlmeans/basic-ids": "^0.1.18-rc.18",
+    "@owlmeans/client": "^0.1.18-rc.25",
+    "@owlmeans/client-context": "^0.1.18-rc.22",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.22",
+    "@owlmeans/context": "^0.1.18-rc.17",
+    "@owlmeans/entrypoint": "^0.1.18-rc.20",
+    "@owlmeans/socket": "^0.1.18-rc.18"
   },
   "publishConfig": {
     "access": "public"

package/src/consts.ts

@@ -0,0 +1,17 @@
+
+import type { ReconnectPolicy } from './types.js'
+
+/**
+ * 0.2s → 3s geometric backoff, retried for up to 10 minutes before the carrier gives up and
+ * reports the connection lost. See the client-socket skill's "Disconnects" section.
+ */
+export const DEFAULT_RECONNECT_POLICY: ReconnectPolicy = {
+  minDelay: 200,
+  maxDelay: 3_000,
+  factor: 2,
+  jitter: 0.1,
+  budget: 600_000,
+  stableAfter: 10_000,
+  heartbeat: 30_000,
+  pongTimeout: 10_000,
+}