@spinajs/http-socket-client 0.0.0-stage → 3.0.0

package/lib/mjs/client.d.ts

@@ -0,0 +1,94 @@
+import { type ContractShape, type SocketContract, type SocketError } from '@spinajs/http-socket-common';
+import { type CommandOptions } from './commands.js';
+import { type AuthProvider, type ConnectionState, type IoOptions } from './connection.js';
+import type { TypedSocketClient } from './contract.js';
+import { type AckedCommand, type DurableCommandOptions, type DurableOptions, type FailedCommand, type HeldCommand } from './durable.js';
+import { type OutboxStore } from './outbox.js';
+import type { ReconnectOptions } from './reconnect.js';
+import { type StreamOptions } from './streams.js';
+export interface SocketClientOptions {
+    /** Server origin; a path in it selects a socket.io namespace. */
+    url: string;
+    /** socket.io endpoint path (socket.io's default: '/socket.io'). */
+    path?: string;
+    /** Asked on every (re)connect; its fields go into the handshake. */
+    auth?: AuthProvider;
+    /** Stable per install, persisted by the app; 1 to MAX_ID_LENGTH printable ASCII characters. Generated when omitted. */
+    clientId?: string;
+    reconnect?: Partial<ReconnectOptions>;
+    defaultTimeoutMs?: number;
+    connectTimeoutMs?: number;
+    autoConnect?: boolean;
+    /** Passed to socket.io-client; reconnection, autoConnect, forceNew, retries and auth stay owned by the client. */
+    io?: IoOptions;
+    /**
+     * Where durable commands wait for their reply. The MemoryOutboxStore default does not survive a reload: browsers pass
+     * IndexedDbOutboxStore ( `/browser` ), Node passes FileOutboxStore ( `/node` ). Requires an explicit `clientId`.
+     */
+    outbox?: OutboxStore;
+    durable?: DurableOptions;
+    onListenerError?: (error: unknown) => void;
+}
+export interface ClientLifecycleEvents {
+    state: (state: ConnectionState, previous: ConnectionState) => void;
+    auth_required: (error: SocketError) => void;
+    incompatible: (error: SocketError) => void;
+    /** The server refused the connection for a reason no retry can fix (forbidden, invalid_argument …); connect() tries again. */
+    refused: (error: SocketError) => void;
+    /** A durable command was acknowledged; also for commands resumed from the outbox after a reload. In send order. */
+    acked: (event: AckedCommand) => void;
+    /** A durable command the server refused for good; it is in the outbox's failed list. In send order. */
+    failed: (event: FailedCommand) => void;
+    /** A durable command was refused as unauthenticated and stays queued; the queue sends nothing until the connection comes online again. */
+    held: (event: HeldCommand) => void;
+}
+export type LifecycleEventName = keyof ClientLifecycleEvents;
+/** Names `on()` routes to client lifecycle listeners; server events with these names are unreachable. */
+export declare const LIFECYCLE_EVENTS: ReadonlySet<string>;
+export type ServerEventListener<T = unknown> = (payload: T) => void;
+export type Unsubscribe = () => void;
+export declare class SocketClient {
+    readonly clientId: string;
+    private readonly connection;
+    private readonly commands;
+    private readonly durableQueue;
+    private readonly streams;
+    private readonly lifecycle;
+    private readonly serverEvents;
+    private controlled;
+    constructor(options: SocketClientOptions);
+    private autoConnect;
+    get state(): ConnectionState;
+    connect(): void;
+    /** Goes offline and stops reconnecting until connect(). */
+    disconnect(): void;
+    /**
+     * Terminal: rejects pending commands and releases the socket. Resolves once the outbox has no write of this
+     * client in flight and every answered durable command has been reported: await it before opening the next
+     * client or store on the same outbox, and keep the `acked` / `failed` listeners until then.
+     * The outbox store is not closed: call `store.close()` yourself to release its lock and connection before reopening the same name.
+     */
+    close(): Promise<void>;
+    /** The same client, typed by a contract shared with the server; no runtime cost. */
+    typed<C extends ContractShape>(_contract: SocketContract<C>): TypedSocketClient<C>;
+    command<R = unknown>(name: string, payload?: unknown, options?: CommandOptions): Promise<R>;
+    /**
+     * Persisted, ordered and retried until the server answers ( spec §6 ); the server command must be idempotent; `ordered: 'client'` is optional, the `after` fence alone orders execution.
+     * With the default MemoryOutboxStore the queue is lost on reload; pass `outbox` ( IndexedDbOutboxStore in browsers, FileOutboxStore in Node ) to keep it.
+     */
+    durable<R = unknown>(name: string, payload?: unknown, options?: DurableCommandOptions): Promise<R>;
+    /**
+     * A stream reply as an async iterator. The request goes out on the first `next()`; at most
+     * `credits` chunks are in flight or buffered; `break` cancels it on the server.
+     */
+    stream<T = unknown>(name: string, payload?: unknown, options?: StreamOptions): AsyncIterableIterator<T>;
+    /** Fire-and-forget event to the server; returns false and drops it when not online. */
+    emit(name: string, payload?: unknown): boolean;
+    on<K extends LifecycleEventName>(event: K, listener: ClientLifecycleEvents[K]): Unsubscribe;
+    on<T = unknown>(event: string, listener: ServerEventListener<T>): Unsubscribe;
+    once<K extends LifecycleEventName>(event: K, listener: ClientLifecycleEvents[K]): Unsubscribe;
+    once<T = unknown>(event: string, listener: ServerEventListener<T>): Unsubscribe;
+    off<K extends LifecycleEventName>(event: K, listener: ClientLifecycleEvents[K]): void;
+    off<T = unknown>(event: string, listener: ServerEventListener<T>): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/mjs/client.d.ts.map

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

package/lib/mjs/client.js

@@ -0,0 +1,135 @@
+import { WIRE_EVENTS } from '@spinajs/http-socket-common';
+import { CommandDispatcher, DEFAULT_TIMEOUT_MS } from './commands.js';
+import { Connection } from './connection.js';
+import { DurableQueue } from './durable.js';
+import { Emitter, rethrowAsync } from './emitter.js';
+import { randomId } from './ids.js';
+import { MemoryOutboxStore } from './outbox.js';
+import { StreamDispatcher } from './streams.js';
+/** Names `on()` routes to client lifecycle listeners; server events with these names are unreachable. */
+export const LIFECYCLE_EVENTS = new Set(['state', 'auth_required', 'incompatible', 'refused', 'acked', 'failed', 'held']);
+function isLifecycleEvent(event) {
+    return LIFECYCLE_EVENTS.has(event);
+}
+export class SocketClient {
+    constructor(options) {
+        // set once the app calls connect(), disconnect() or close(), which then override autoConnect
+        this.controlled = false;
+        const onListenerError = options.onListenerError ?? rethrowAsync;
+        // persisted keys are `${clientId}:…`: a fresh random id after a reload would break exactly-once and ordering
+        if (options.outbox !== undefined && options.clientId === undefined) {
+            throw new RangeError('an outbox requires a stable clientId, persisted by the app');
+        }
+        this.clientId = options.clientId ?? randomId();
+        this.lifecycle = new Emitter(onListenerError);
+        this.serverEvents = new Emitter(onListenerError);
+        this.connection = new Connection({
+            url: options.url,
+            path: options.path,
+            clientId: this.clientId,
+            auth: options.auth,
+            reconnect: options.reconnect,
+            connectTimeoutMs: options.connectTimeoutMs,
+            io: options.io,
+            onListenerError,
+        });
+        try {
+            this.commands = new CommandDispatcher(this.connection, options.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS);
+            this.durableQueue = new DurableQueue({
+                connection: this.connection,
+                commands: this.commands,
+                store: options.outbox ?? new MemoryOutboxStore(),
+                clientId: this.clientId,
+                reconnect: options.reconnect,
+                durable: options.durable,
+                onListenerError,
+            });
+        }
+        catch (error) {
+            // invalid options must not leave a socket behind
+            this.connection.close();
+            throw error;
+        }
+        this.durableQueue.events.on('acked', (event) => this.lifecycle.emit('acked', event));
+        this.durableQueue.events.on('failed', (event) => this.lifecycle.emit('failed', event));
+        this.durableQueue.events.on('held', (event) => this.lifecycle.emit('held', event));
+        this.streams = new StreamDispatcher(this.connection, () => this.commands.nextId(), options.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS);
+        this.connection.events.on('state', (state, previous) => this.lifecycle.emit('state', state, previous));
+        this.connection.events.on('auth_required', (error) => this.lifecycle.emit('auth_required', error));
+        this.connection.events.on('incompatible', (error) => this.lifecycle.emit('incompatible', error));
+        this.connection.events.on('refused', (error) => this.lifecycle.emit('refused', error));
+        this.connection.listen(WIRE_EVENTS.event, (frame) => {
+            if (typeof frame?.name === 'string')
+                this.serverEvents.emit(frame.name, frame.payload);
+        });
+        // a microtask, so listeners attached right after construction still see 'connecting'
+        if (options.autoConnect !== false)
+            queueMicrotask(() => this.autoConnect());
+    }
+    autoConnect() {
+        if (!this.controlled)
+            this.connection.connect();
+    }
+    get state() {
+        return this.connection.state;
+    }
+    connect() {
+        this.controlled = true;
+        this.connection.connect();
+    }
+    /** Goes offline and stops reconnecting until connect(). */
+    disconnect() {
+        this.controlled = true;
+        this.connection.disconnect();
+    }
+    /**
+     * Terminal: rejects pending commands and releases the socket. Resolves once the outbox has no write of this
+     * client in flight and every answered durable command has been reported: await it before opening the next
+     * client or store on the same outbox, and keep the `acked` / `failed` listeners until then.
+     * The outbox store is not closed: call `store.close()` yourself to release its lock and connection before reopening the same name.
+     */
+    close() {
+        this.controlled = true;
+        this.connection.close();
+        return this.durableQueue.close();
+    }
+    /** The same client, typed by a contract shared with the server; no runtime cost. */
+    typed(_contract) {
+        return this;
+    }
+    command(name, payload, options) {
+        return this.commands.execute(name, payload, options);
+    }
+    /**
+     * Persisted, ordered and retried until the server answers ( spec §6 ); the server command must be idempotent; `ordered: 'client'` is optional, the `after` fence alone orders execution.
+     * With the default MemoryOutboxStore the queue is lost on reload; pass `outbox` ( IndexedDbOutboxStore in browsers, FileOutboxStore in Node ) to keep it.
+     */
+    durable(name, payload, options) {
+        return this.durableQueue.submit(name, payload, options);
+    }
+    /**
+     * A stream reply as an async iterator. The request goes out on the first `next()`; at most
+     * `credits` chunks are in flight or buffered; `break` cancels it on the server.
+     */
+    stream(name, payload, options) {
+        return this.streams.stream(name, payload, options);
+    }
+    /** Fire-and-forget event to the server; returns false and drops it when not online. */
+    emit(name, payload) {
+        const frame = { name, payload };
+        return this.connection.send(WIRE_EVENTS.event, frame);
+    }
+    on(event, listener) {
+        return isLifecycleEvent(event) ? this.lifecycle.on(event, listener) : this.serverEvents.on(event, listener);
+    }
+    once(event, listener) {
+        return isLifecycleEvent(event) ? this.lifecycle.once(event, listener) : this.serverEvents.once(event, listener);
+    }
+    off(event, listener) {
+        if (isLifecycleEvent(event))
+            this.lifecycle.off(event, listener);
+        else
+            this.serverEvents.off(event, listener);
+    }
+}
+//# sourceMappingURL=client.js.map

package/lib/mjs/client.js.map

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

package/lib/mjs/commands.d.ts

@@ -0,0 +1,30 @@
+import type { Connection } from './connection.js';
+export type WhenOffline = 'fail' | 'wait';
+export interface CommandOptions {
+    /** Budget for the whole call: the wait for a connection (whenOffline 'wait') and for the reply. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    whenOffline?: WhenOffline;
+    /** W3C trace context, carried into the server handler. */
+    traceparent?: string;
+}
+export declare const DEFAULT_TIMEOUT_MS = 15000;
+/** Plain (non-durable) commands: one attempt each, never re-sent. */
+export declare class CommandDispatcher {
+    private readonly connection;
+    private readonly defaultTimeoutMs;
+    private seq;
+    private readonly waiting;
+    private readonly inFlight;
+    constructor(connection: Connection, defaultTimeoutMs?: number);
+    /** Unique per client instance; durable and stream requests take ids from here too. */
+    nextId(): string;
+    execute(name: string, payload: unknown, options?: CommandOptions): Promise<unknown>;
+    private transmit;
+    private onReply;
+    private onState;
+    private succeed;
+    private fail;
+    private finish;
+}
+//# sourceMappingURL=commands.d.ts.map

package/lib/mjs/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAGnE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAuBzC,qEAAqE;AACrE,qBAAa,iBAAiB;IAMhB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAc,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALtF,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,YAA6B,UAAU,EAAE,UAAU,EAAmB,gBAAgB,GAAE,MAA2B,EAGlH;IAED,sFAAsF;IAC/E,MAAM,IAAI,MAAM,CAEtB;IAEM,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwC7F;IAED,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;CAQf"}

package/lib/mjs/commands.js

@@ -0,0 +1,128 @@
+import { SocketException, WIRE_EVENTS, isSocketError } from '@spinajs/http-socket-common';
+import { assertTimeoutMs } from './timeout.js';
+export const DEFAULT_TIMEOUT_MS = 15_000;
+const CLOSED = { code: 'unavailable', message: 'the client is closed', retryable: false };
+const OFFLINE = { code: 'unavailable', message: 'the client is offline', retryable: true };
+const STAYED_OFFLINE = { code: 'unavailable', message: 'the client stayed offline until the timeout', retryable: true };
+const CONNECTION_LOST = { code: 'unavailable', message: 'the connection dropped before the reply', retryable: true };
+const NO_REPLY = { code: 'deadline_exceeded', message: 'no reply before the timeout', retryable: true };
+const CANCELLED = { code: 'cancelled', message: 'the command was cancelled', retryable: false };
+const STREAM_REPLY = { code: 'failed_precondition', message: 'the command replies with a stream; use stream()', retryable: false };
+const MALFORMED_REPLY = { code: 'internal', message: 'malformed reply', retryable: false };
+/** Plain (non-durable) commands: one attempt each, never re-sent. */
+export class CommandDispatcher {
+    constructor(connection, defaultTimeoutMs = DEFAULT_TIMEOUT_MS) {
+        this.connection = connection;
+        this.defaultTimeoutMs = defaultTimeoutMs;
+        this.seq = 0;
+        // insertion-ordered, so commands held while offline go out in call order
+        this.waiting = new Set();
+        this.inFlight = new Set();
+        assertTimeoutMs('defaultTimeoutMs', defaultTimeoutMs);
+        connection.events.on('state', (state, previous) => this.onState(state, previous));
+    }
+    /** Unique per client instance; durable and stream requests take ids from here too. */
+    nextId() {
+        return (++this.seq).toString(36);
+    }
+    execute(name, payload, options = {}) {
+        const timeoutMs = options.timeoutMs ?? this.defaultTimeoutMs;
+        try {
+            assertTimeoutMs('timeoutMs', timeoutMs);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        if (this.connection.state === 'closed')
+            return rejected(CLOSED);
+        if (options.signal?.aborted)
+            return rejected(CANCELLED);
+        if (!this.connection.connected && (options.whenOffline ?? 'fail') === 'fail')
+            return rejected(OFFLINE);
+        const request = { id: this.nextId(), name, payload };
+        if (options.traceparent !== undefined)
+            request.traceparent = options.traceparent;
+        const signal = options.signal;
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                if (command.sent) {
+                    const cancel = { id: request.id };
+                    this.connection.send(WIRE_EVENTS.cancel, cancel);
+                }
+                this.fail(command, CANCELLED);
+            };
+            const timer = setTimeout(() => this.fail(command, command.sent ? NO_REPLY : STAYED_OFFLINE), timeoutMs);
+            const command = {
+                request,
+                deadlineAt: Date.now() + timeoutMs,
+                sent: false,
+                done: false,
+                resolve,
+                reject,
+                dispose: () => {
+                    clearTimeout(timer);
+                    signal?.removeEventListener('abort', onAbort);
+                },
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+            if (this.connection.connected)
+                this.transmit(command);
+            else
+                this.waiting.add(command);
+        });
+    }
+    transmit(command) {
+        this.waiting.delete(command);
+        // relative, so client/server clock skew cannot expire it; the server ignores a deadline <= 0
+        command.request.deadline = Math.max(1, command.deadlineAt - Date.now());
+        command.sent = true;
+        this.inFlight.add(command);
+        const sent = this.connection.request(WIRE_EVENTS.command, command.request, (reply) => this.onReply(command, reply));
+        if (!sent)
+            this.fail(command, CONNECTION_LOST);
+    }
+    onReply(command, reply) {
+        if (typeof reply !== 'object' || reply === null || typeof reply.ok !== 'boolean')
+            return this.fail(command, MALFORMED_REPLY);
+        if (!reply.ok)
+            return this.fail(command, isSocketError(reply.error) ? reply.error : MALFORMED_REPLY);
+        // a CommandStreamReply: the result follows as stream frames, which only stream() consumes
+        if ('stream' in reply)
+            return this.fail(command, STREAM_REPLY);
+        this.succeed(command, reply.result);
+    }
+    onState(state, previous) {
+        if (state === 'closed') {
+            for (const command of [...this.waiting, ...this.inFlight])
+                this.fail(command, CLOSED);
+            return;
+        }
+        if (previous === 'online')
+            for (const command of [...this.inFlight])
+                this.fail(command, CONNECTION_LOST);
+        if (state === 'online')
+            for (const command of [...this.waiting])
+                this.transmit(command);
+    }
+    succeed(command, value) {
+        if (this.finish(command))
+            command.resolve(value);
+    }
+    fail(command, error) {
+        if (this.finish(command))
+            command.reject(SocketException.fromWire(error));
+    }
+    finish(command) {
+        if (command.done)
+            return false;
+        command.done = true;
+        command.dispose();
+        this.waiting.delete(command);
+        this.inFlight.delete(command);
+        return true;
+    }
+}
+function rejected(error) {
+    return Promise.reject(SocketException.fromWire(error));
+}
+//# sourceMappingURL=commands.js.map

package/lib/mjs/commands.js.map

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

package/lib/mjs/connection.d.ts

@@ -0,0 +1,71 @@
+import { type ManagerOptions, type SocketOptions } from 'socket.io-client';
+import { type SocketError } from '@spinajs/http-socket-common';
+import { Emitter } from './emitter.js';
+import { type ReconnectOptions } from './reconnect.js';
+export type ConnectionState = 'connecting' | 'online' | 'offline' | 'closed';
+export interface AuthPayload {
+    token?: string;
+    [key: string]: unknown;
+}
+export type AuthProvider = () => AuthPayload | Promise<AuthPayload>;
+export type IoOptions = Partial<ManagerOptions & SocketOptions>;
+export interface ConnectionOptions {
+    url: string;
+    path?: string;
+    clientId: string;
+    auth?: AuthProvider;
+    reconnect?: Partial<ReconnectOptions>;
+    connectTimeoutMs?: number;
+    io?: IoOptions;
+    onListenerError?: (error: unknown) => void;
+}
+export interface ConnectionEvents {
+    state: (state: ConnectionState, previous: ConnectionState) => void;
+    auth_required: (error: SocketError) => void;
+    incompatible: (error: SocketError) => void;
+    refused: (error: SocketError) => void;
+}
+export declare const DEFAULT_CONNECT_TIMEOUT_MS = 20000;
+/**
+ * Sole owner of the socket.io socket: state machine, handshake, reconnect and stop conditions.
+ * Commands, durable commands and streams use it and never touch socket.io directly.
+ */
+export declare class Connection {
+    private readonly options;
+    readonly events: Emitter<ConnectionEvents>;
+    private readonly socket;
+    private readonly policy;
+    private readonly connectTimeoutMs;
+    private current;
+    private stopped;
+    private attempt;
+    private attemptId;
+    private retryAfterMs;
+    private kickCode;
+    private retryTimer;
+    private connectTimer;
+    constructor(options: ConnectionOptions);
+    get state(): ConnectionState;
+    get connected(): boolean;
+    connect(): void;
+    disconnect(): void;
+    close(): void;
+    send(event: string, ...args: unknown[]): boolean;
+    request<R>(event: string, data: unknown, onReply: (reply: R) => void): boolean;
+    listen(event: string, handler: (...args: any[]) => void): () => void;
+    private open;
+    private provideAuth;
+    private onConnect;
+    private onConnectError;
+    private onDisconnect;
+    private onEventFrame;
+    private onConnectTimeout;
+    private haltFor;
+    private halt;
+    private scheduleRetry;
+    private abortAttempt;
+    private clearTimers;
+    private clearConnectTimer;
+    private setState;
+}
+//# sourceMappingURL=connection.d.ts.map

package/lib/mjs/connection.d.ts.map

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