@supalive/core 0.1.4 → 0.1.6

package/dist/src/client/ws_client_manager.d.ts

@@ -1,268 +0,0 @@
-type WSEventHandler<E> = ((event: E) => void) | null;
-export interface WSLike {
-    readyState: number;
-    send(data: string): void;
-    close(code?: number, reason?: string): void;
-    onopen: WSEventHandler<unknown>;
-    onmessage: WSEventHandler<{
-        data: string | {
-            toString(): string;
-        };
-    }>;
-    onclose: WSEventHandler<unknown>;
-    onerror: WSEventHandler<unknown>;
-}
-export interface WSConstructor {
-    new (url: string): WSLike;
-}
-export declare class RPCError extends Error {
-    code?: string;
-    constructor(message: string, code?: string);
-}
-export interface HeartbeatOptions {
-    /**
-     * Close + reconnect when no server message arrives for this long. The
-     * server emits `{type:"ping"}` every ~15s of channel idle, so anything
-     * larger than ~30s leaves comfortable headroom. Default 60_000.
-     */
-    serverInactivityMs?: number;
-}
-export interface SendThrottleOptions {
-    /** Yield the event loop every N `call()` invocations. 0 disables. Default 100. */
-    everyN?: number;
-    /** Length of the yield in ms. Default 10. */
-    delayMs?: number;
-}
-export interface WSClientOptions {
-    /** WebSocket URL (e.g. ws://localhost:3000/ws) */
-    url: string;
-    /** Auth token to send after connection */
-    token?: () => Promise<string | undefined>;
-    /** Optional: reconnection timeout in ms (default: 180000 = 3 minutes) */
-    reconnectionTimeout?: number;
-    /** Reconnection options */
-    reconnect?: {
-        /** Enable automatic reconnection (default: true) */
-        enabled?: boolean;
-        /** Max reconnection attempts (default: 5) */
-        maxAttempts?: number;
-        /** Delay between attempts in ms (default: 1000) */
-        delay?: number;
-        /** Exponential backoff multiplier (default: 1.5) */
-        backoff?: number;
-    };
-    /** Server-inactivity watchdog. See {@link HeartbeatOptions.serverInactivityMs}. */
-    heartbeat?: HeartbeatOptions;
-    /**
-     * Yields the event loop for `delayMs` ms after every `everyN`
-     * `call()` invocations. Useful for keeping React renders / GC tasks
-     * scheduled during long synchronous bursts of mutations/actions; the
-     * heartbeat does not depend on this (the server drives it).
-     * Default `{ everyN: 100, delayMs: 10 }`. Set `everyN: 0` to disable.
-     */
-    throttle?: SendThrottleOptions;
-    /** Called when connection is established */
-    onConnect?: () => void;
-    /** Called when connection is lost */
-    onDisconnect?: () => void;
-    /** Called on connection error */
-    onError?: (error: Error) => void;
-}
-/**
- * Public state of the client, surfaced to consumers (React provider, etc.).
- * - "connecting" — initial connect or reconnect handshake in flight
- * - "authenticating" — connected, waiting for auth result
- * - "ready" — connected and auth resolved (authenticated, anonymous, or
- *   explicitly failed — i.e. ready to send calls)
- * - "disconnected" — currently offline (may auto-retry)
- */
-export type ClientPublicState = "disconnected" | "connecting" | "authenticating" | "ready";
-export declare class WsClientManager {
-    private ws;
-    private options;
-    private lastSuccessfulConnectionTime;
-    private reconnectionTimeout;
-    private requestId;
-    private pendingRequests;
-    /**
-     * Single source of truth for live subscriptions.
-     *
-     * Keying:
-     *   - In-flight subscribe (no subId yet): `_pending:<requestId>`.
-     *   - Established: the server-returned canonical `subId`.
-     *
-     * Routing `sub:update` / `sub:gone` is O(1) (`get(subId)`). Subscribe-time
-     * dedup scans `values()` for a matching `localKey` (O(N)), which is cheap
-     * since subscribes happen on component mounts, not in the hot path.
-     */
-    private subscriptions;
-    private queuedCalls;
-    private reconnectAttempts;
-    private reconnectTimer;
-    private connectionState;
-    private authState;
-    /**
-     * Authenticated user id from `auth:success`. Distinct from `queryIdentity`
-     * (server-side cache/sub segmentation key); this is just "who am I logged
-     * in as" for app display purposes. Null while unauthenticated / anonymous.
-     */
-    private authUserId;
-    private explicitlyClosed;
-    private stateListeners;
-    private lastPublicState;
-    private serverInactivityMs;
-    private lastServerMessageAt;
-    private inactivityTimer;
-    private pendingConnectResolve;
-    private pendingConnectReject;
-    private throttleEveryN;
-    private throttleDelayMs;
-    private throttleCounter;
-    private throttling;
-    private visibilityListener;
-    private onlineListener;
-    constructor(options: WSClientOptions);
-    /**
-     * Subscribe to client state transitions. Returns an unsubscribe fn.
-     * The listener is called immediately with the current state.
-     */
-    onState(listener: (s: ClientPublicState) => void): () => void;
-    /** Current public state. */
-    getPublicState(): ClientPublicState;
-    /**
-     * Connect to the WebSocket server.
-     * Returns a promise that resolves when connected and authenticated.
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the server.
-     */
-    disconnect(): void;
-    /**
-     * Check if connected and authenticated.
-     */
-    isReady(): boolean;
-    /**
-     * Check if authenticated.
-     */
-    isAuthenticated(): boolean;
-    /**
-     * Check if anonymouse.
-     */
-    isAnonymouse(): boolean;
-    /**
-     * The authenticated user's id (from `auth:success`), or null when
-     * unauthenticated / anonymous. Useful for "Logged in as …" display.
-     *
-     * Not to be confused with server-side `queryIdentity`, which is the
-     * cache/subscription segmentation key (resolved entirely on the server).
-     */
-    getAuthUserId(): string | null;
-    /**
-     * Call a procedure (query, mutation, or action).
-     *
-     * If the client is not ready (disconnected or still authenticating), the
-     * call is FIFO-queued and dispatched on the next ready state. The promise
-     * still resolves with the eventual server response.
-     *
-     * Pass `onSend` to be notified when the call actually leaves the queue
-     * (used by `useMutation` to flip `state` from "queued" → "loading").
-     */
-    call(procedure: string, input: unknown, options?: {
-        onSend?: () => void;
-    }): Promise<unknown>;
-    /**
-     * Throttle drain loop. Each iteration: sleep `throttleDelayMs`, then
-     * dispatch up to `throttleEveryN` queued items. Exits as soon as the
-     * queue drains inside a single batch (burst over, back to direct
-     * dispatch on the next `call()`) or the connection goes away
-     * (reconnect path will restart us via `flushQueuedCalls`).
-     */
-    private runThrottleLoop;
-    /**
-     * Issue the call against an established connection. Caller must ensure
-     * `isReady()` before invoking.
-     */
-    private dispatchCall;
-    /**
-     * Flush queued calls in FIFO order. Called once `isReady()` becomes
-     * true. With the throttle enabled, dispatch the first batch
-     * synchronously then hand off to the drain loop so a large
-     * post-reconnect flush respects backpressure instead of dumping 10k
-     * frames in one tick.
-     */
-    private flushQueuedCalls;
-    /**
-     * Re-send `subscribe` for every existing subscription. The subId for each
-     * may legitimately change (e.g. `queryIdentity` was a function of user
-     * identity and the user changed during the disconnect), so we re-key the
-     * unified `subscriptions` Map: snapshot every record, drop them from the
-     * Map, then reinsert under a fresh `_pending:<reqId>` key. Each pending
-     * request's `resolve` rekeys the parked record under the new server-issued
-     * subId so subsequent `sub:update` frames route to the existing
-     * `onUpdate` callback (which the React handle is still holding).
-     */
-    private resubscribeAll;
-    /**
-     * Subscribe to a live query.
-     *
-     * The client does not compute the subId locally — it sends the
-     * (procedure, input) pair and receives the canonical subId on the
-     * subscribe response. This lets the server's per-procedure
-     * `queryIdentity` override be authoritative without forcing the client
-     * to mirror any of the resolution logic.
-     *
-     * Returns the server-assigned subId and an unsubscribe function.
-     */
-    subscribe(procedure: string, input: unknown, serializedInput: string, onUpdate: (data: unknown) => void, onGone?: (reason: string | undefined) => void): Promise<{
-        subId: string;
-        unsubscribe: () => void;
-    }>;
-    private findSubByLocalKey;
-    /** Resolve every joiner waiting on this Subscription with the canonical subId. */
-    private resolveJoiners;
-    /** Reject every joiner waiting on this Subscription with the given error. */
-    private rejectJoiners;
-    private unsubscribeByLocalKey;
-    private handleMessage;
-    /**
-     * Called once the client transitions to a "ready" state on a fresh
-     * connection. Replays live-query subscriptions and flushes any queued
-     * calls in FIFO order.
-     */
-    private afterReady;
-    private handleResponse;
-    private handleSubscriptionUpdate;
-    /**
-     * Handles a `sub:gone` message: the server no longer tracks this
-     * subscription (e.g. it was fully unregistered while we were disconnected
-     * from the sub-manager). Notify the handle and drop the local entry so a
-     * re-subscribe is required to receive further updates.
-     */
-    private handleSubscriptionGone;
-    private handleClose;
-    private handleError;
-    private startInactivityWatchdog;
-    private stopInactivityWatchdog;
-    /**
-     * Close the current WebSocket and schedule a reconnect via `handleClose`.
-     *
-     * Atomically swaps the old socket's event handlers to no-ops BEFORE
-     * `close()` so a frame in flight at the moment of close cannot fire
-     * `handleMessage` into a half-cleaned state — that was the source of
-     * the "browser says socket is alive but client says disconnected" race.
-     */
-    private closeAndReconnect;
-    private installEnvironmentListeners;
-    private removeEnvironmentListeners;
-    private scheduleReconnect;
-    private computePublicState;
-    private emitState;
-    private ensureConnected;
-    private send;
-    private cleanup;
-    private generateRequestId;
-}
-declare function getWebSocket(): Promise<WSConstructor>;
-export { getWebSocket };
-//# sourceMappingURL=ws_client_manager.d.ts.map

package/dist/src/client/ws_client_manager.d.ts.map

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