lemon-model 1.2.3 → 1.4.0

package/dist/socket/client/socket-client.js

@@ -0,0 +1,219 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSocketClientCore = void 0;
+const message_router_1 = require("./message-router");
+const pending_request_store_1 = require("./pending-request-store");
+const shared_timer_scheduler_1 = require("./shared-timer-scheduler");
+const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+const DEFAULT_MAX_INFLIGHT_REQUESTS = 32;
+const DEFAULT_MAX_PENDING_REQUESTS = 512;
+const normalizeRequestCap = (value, fallback) => {
+    const n = value !== null && value !== void 0 ? value : fallback;
+    return n > 0 ? n : Number.POSITIVE_INFINITY;
+};
+class SocketClientCoreImpl {
+    constructor(options) {
+        var _a, _b;
+        this.transportUnsubs = [];
+        this.stateListeners = new Set();
+        this.errorListeners = new Set();
+        this.messageListeners = new Set();
+        this.requestQueue = [];
+        this.inflightRequests = 0;
+        this.transport = options.transport;
+        this.codec = options.codec;
+        this.settlement = options.settlement;
+        this.getMessageType = options.getMessageType;
+        this.requestTimeoutMs = (_a = options.requestTimeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_REQUEST_TIMEOUT_MS;
+        this.maxInflightRequests = normalizeRequestCap(options.maxInflightRequests, DEFAULT_MAX_INFLIGHT_REQUESTS);
+        this.maxPendingRequests = normalizeRequestCap(options.maxPendingRequests, DEFAULT_MAX_PENDING_REQUESTS);
+        this.ownsTimerScheduler = !options.timerScheduler;
+        this.timerScheduler = (_b = options.timerScheduler) !== null && _b !== void 0 ? _b : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
+        this.pending = new pending_request_store_1.PendingRequestStore({ timerScheduler: this.timerScheduler });
+        this.router = new message_router_1.MessageRouter({ getMessageType: options.getMessageType });
+        this._state = options.transport.state;
+        this.transportUnsubs.push(this.transport.on('open', () => this.setState('connected')));
+        this.transportUnsubs.push(this.transport.on('close', () => {
+            this.rejectQueuedRequests(new Error(`499 CLIENT CLOSED REQUEST - socket closed`));
+            this.pending.clear(new Error(`499 CLIENT CLOSED REQUEST - socket closed`));
+            this.setState('closed');
+        }));
+        this.transportUnsubs.push(this.transport.on('error', event => this.emitError({ error: event.error, phase: 'transport' })));
+        this.transportUnsubs.push(this.transport.on('message', event => this.handleRawMessage(event.data)));
+    }
+    get state() {
+        return this._state;
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._state === 'connected' || this._state === 'connecting')
+                return;
+            this.setState('connecting');
+            try {
+                yield this.transport.connect();
+            }
+            catch (error) {
+                this.emitError({ error, phase: 'connect' });
+                this.setState('closed');
+                throw error;
+            }
+        });
+    }
+    disconnect(code, reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._state === 'closed' || this._state === 'idle')
+                return;
+            this.setState('closing');
+            try {
+                yield this.transport.disconnect(code, reason);
+            }
+            catch (error) {
+                this.emitError({ error, phase: 'disconnect' });
+                throw error;
+            }
+        });
+    }
+    send(message) {
+        this.transport.send(this.codec.serialize(message));
+    }
+    request(message, options = {}) {
+        const mid = this.settlement.getId(message);
+        if (!mid)
+            return Promise.reject(new Error(`@request id (string) is required - SocketClientCore.request()`));
+        const totalAccepted = this.inflightRequests + this.requestQueue.length;
+        if (totalAccepted >= this.maxPendingRequests) {
+            return Promise.reject(new Error(`429 TOO MANY REQUESTS - pending queue full (${totalAccepted}/${this.maxPendingRequests})`));
+        }
+        return new Promise((resolve, reject) => {
+            var _a;
+            const job = {
+                mid,
+                message,
+                timeoutMs: (_a = options.timeoutMs) !== null && _a !== void 0 ? _a : this.requestTimeoutMs,
+                resolve: resolve,
+                reject,
+            };
+            if (this.inflightRequests < this.maxInflightRequests) {
+                this.dispatchRequest(job);
+                return;
+            }
+            this.requestQueue.push(job);
+        });
+    }
+    onState(listener) {
+        this.stateListeners.add(listener);
+        return () => this.stateListeners.delete(listener);
+    }
+    onError(listener) {
+        this.errorListeners.add(listener);
+        return () => this.errorListeners.delete(listener);
+    }
+    onMessage(listener) {
+        this.messageListeners.add(listener);
+        return () => this.messageListeners.delete(listener);
+    }
+    onType(type, listener) {
+        return this.router.onType(type, listener);
+    }
+    destroy() {
+        this.transportUnsubs.splice(0).forEach(unsub => unsub());
+        this.rejectQueuedRequests(new Error(`499 CLIENT CLOSED REQUEST - client destroyed`));
+        this.pending.clear(new Error(`499 CLIENT CLOSED REQUEST - client destroyed`));
+        this.router.clear();
+        this.stateListeners.clear();
+        this.errorListeners.clear();
+        this.messageListeners.clear();
+        if (this.ownsTimerScheduler)
+            this.timerScheduler.cancelAll();
+        this.setState('closed');
+    }
+    dispatchRequest(job) {
+        this.inflightRequests += 1;
+        let released = false;
+        const release = () => {
+            if (released)
+                return;
+            released = true;
+            this.inflightRequests = Math.max(0, this.inflightRequests - 1);
+            this.dispatchNextQueuedRequest();
+        };
+        const pending = this.pending.create(job.mid, {
+            timeoutMs: job.timeoutMs,
+            onTimeout: mid => new Error(`408 REQUEST TIMEOUT - pending[${mid}]`),
+        });
+        void pending.then(value => {
+            job.resolve(value);
+            release();
+        }, error => {
+            job.reject(error);
+            release();
+        });
+        try {
+            this.transport.send(this.codec.serialize(job.message));
+        }
+        catch (error) {
+            this.pending.reject(job.mid, error);
+            release();
+            this.emitError({ error, phase: 'request' });
+        }
+    }
+    dispatchNextQueuedRequest() {
+        while (this.inflightRequests < this.maxInflightRequests && this.requestQueue.length) {
+            const next = this.requestQueue.shift();
+            if (!next)
+                return;
+            this.dispatchRequest(next);
+        }
+    }
+    rejectQueuedRequests(reason) {
+        const queued = this.requestQueue.splice(0);
+        queued.forEach(job => job.reject(reason));
+        return queued.length;
+    }
+    handleRawMessage(raw) {
+        try {
+            const message = this.codec.parse(raw);
+            const handled = this.settle(message);
+            const event = { message, raw };
+            this.messageListeners.forEach(listener => listener(event));
+            if (!handled)
+                this.router.route(message);
+        }
+        catch (error) {
+            this.emitError({ error, phase: 'message', raw });
+        }
+    }
+    settle(message) {
+        const mid = this.settlement.getId(message);
+        if (!mid)
+            return false;
+        if (this.settlement.isSuccess(message))
+            return this.pending.resolve(mid, this.settlement.getSuccessData(message));
+        if (this.settlement.isFailure(message))
+            return this.pending.reject(mid, this.settlement.getFailureError(message));
+        return false;
+    }
+    setState(next) {
+        const prev = this._state;
+        this._state = next;
+        if (prev === next)
+            return;
+        const event = { prev, next };
+        this.stateListeners.forEach(listener => listener(event));
+    }
+    emitError(event) {
+        this.errorListeners.forEach(listener => listener(event));
+    }
+}
+const createSocketClientCore = (options) => new SocketClientCoreImpl(options);
+exports.createSocketClientCore = createSocketClientCore;
+//# sourceMappingURL=socket-client.js.map

package/dist/socket/client/socket-client.js.map

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

package/dist/socket/client/types.d.ts

@@ -0,0 +1,101 @@
+import type { SocketUnsubscribe } from '../types';
+import type { WebSocketCompartible } from '../websocket';
+export type { SocketUnsubscribe } from '../types';
+export declare type SocketClientState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
+export interface SocketClientStateEvent {
+    prev: SocketClientState;
+    next: SocketClientState;
+}
+export interface SocketClientErrorEvent {
+    error: unknown;
+    phase: 'connect' | 'disconnect' | 'message' | 'request' | 'transport';
+    raw?: unknown;
+}
+export interface SocketClientMessageEvent<TMessage> {
+    message: TMessage;
+    raw: string;
+}
+export interface SocketMessageCodec<TMessage> {
+    parse(raw: string): TMessage;
+    serialize(message: TMessage): string;
+}
+export interface RequestSettlementStrategy<TMessage> {
+    getId(message: TMessage): string | undefined;
+    isSuccess(message: TMessage): boolean;
+    isFailure(message: TMessage): boolean;
+    getSuccessData(message: TMessage): unknown;
+    getFailureError(message: TMessage): unknown;
+}
+export interface SocketClientTransportEventMap {
+    open: void;
+    close: {
+        code?: number;
+        reason?: string;
+        wasClean?: boolean;
+    };
+    error: {
+        error?: unknown;
+    };
+    message: {
+        data: string;
+    };
+}
+export interface SocketClientTransport {
+    readonly state: SocketClientState;
+    connect(): Promise<void>;
+    disconnect(code?: number, reason?: string): Promise<void>;
+    send(raw: string): void;
+    on<TType extends keyof SocketClientTransportEventMap>(type: TType, listener: (event: SocketClientTransportEventMap[TType]) => void): SocketUnsubscribe;
+}
+export interface SharedTimerScheduler {
+    schedule(key: string, delayMs: number, task: () => unknown | Promise<unknown>): void;
+    cancel(key: string): void;
+    cancelAll(prefix?: string): void;
+}
+export interface SocketClientCore<TMessage> {
+    readonly state: SocketClientState;
+    connect(): Promise<void>;
+    disconnect(code?: number, reason?: string): Promise<void>;
+    send(message: TMessage): void;
+    request<TResult = unknown>(message: TMessage, options?: {
+        timeoutMs?: number;
+    }): Promise<TResult>;
+    onState(listener: (event: SocketClientStateEvent) => void): SocketUnsubscribe;
+    onError(listener: (event: SocketClientErrorEvent) => void): SocketUnsubscribe;
+    onMessage(listener: (event: SocketClientMessageEvent<TMessage>) => void): SocketUnsubscribe;
+    onType(type: string, listener: (message: TMessage) => void): SocketUnsubscribe;
+    destroy(): void;
+}
+export interface SocketClientCoreOptions<TMessage> {
+    transport: SocketClientTransport;
+    codec: SocketMessageCodec<TMessage>;
+    settlement: RequestSettlementStrategy<TMessage>;
+    getMessageType(message: TMessage): string | undefined;
+    requestTimeoutMs?: number;
+    maxInflightRequests?: number;
+    maxPendingRequests?: number;
+    timerScheduler?: SharedTimerScheduler;
+}
+export interface SocketRuntimePort<TMessage = unknown> {
+    readonly state: SocketClientState;
+    connect(): Promise<void>;
+    disconnect(code?: number, reason?: string): Promise<void>;
+    send(message: TMessage): void;
+    request<TResult = unknown>(message: TMessage, options?: {
+        timeoutMs?: number;
+    }): Promise<TResult>;
+    onState(listener: (event: SocketClientStateEvent) => void): SocketUnsubscribe;
+    onError(listener: (event: SocketClientErrorEvent) => void): SocketUnsubscribe;
+}
+export interface WebSocketClientTransportSocket extends WebSocketCompartible {
+    close(code?: number, reason?: string): void;
+}
+export interface WebSocketClientTransportOptions {
+    url: string;
+    protocols?: string | string[];
+    socketFactory: (context: {
+        url: string;
+        protocols?: string | string[];
+    }) => WebSocketClientTransportSocket;
+    connectTimeoutMs?: number;
+}

package/dist/socket/client/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/socket/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/socket/client/types.ts"],"names":[],"mappings":""}

package/dist/socket/client/websocket-client-transport.d.ts

@@ -0,0 +1,23 @@
+import type { SocketClientState, SocketClientTransport, SocketClientTransportEventMap, WebSocketClientTransportOptions } from './types';
+export declare class WebSocketClientTransport implements SocketClientTransport {
+    private _state;
+    private socket?;
+    private connecting?;
+    private cancelConnecting?;
+    private readonly listeners;
+    private readonly unbinders;
+    private readonly url;
+    private readonly protocols;
+    private readonly socketFactory;
+    private readonly connectTimeoutMs;
+    constructor(options: WebSocketClientTransportOptions);
+    get state(): SocketClientState;
+    connect(): Promise<void>;
+    disconnect(code?: number, reason?: string): Promise<void>;
+    send(raw: string): void;
+    on<TType extends keyof SocketClientTransportEventMap>(type: TType, listener: (event: SocketClientTransportEventMap[TType]) => void): () => void;
+    private bindSocketListener;
+    private emit;
+    private cleanupSocket;
+    private stateValue;
+}

package/dist/socket/client/websocket-client-transport.js

@@ -0,0 +1,152 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketClientTransport = void 0;
+const DEFAULT_CONNECT_TIMEOUT_MS = 10000;
+class WebSocketClientTransport {
+    constructor(options) {
+        var _a;
+        this._state = 'idle';
+        this.listeners = new Map();
+        this.unbinders = [];
+        this.url = options.url;
+        this.protocols = options.protocols;
+        this.socketFactory = options.socketFactory;
+        this.connectTimeoutMs = (_a = options.connectTimeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_CONNECT_TIMEOUT_MS;
+    }
+    get state() {
+        return this._state;
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._state === 'connected')
+                return;
+            if (this.connecting)
+                return this.connecting;
+            this.cleanupSocket();
+            this._state = 'connecting';
+            const socket = this.socketFactory({ url: this.url, protocols: this.protocols });
+            this.socket = socket;
+            this.connecting = new Promise((resolve, reject) => {
+                let settled = false;
+                let timeoutTimer;
+                const settle = (handler) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timeoutTimer)
+                        clearTimeout(timeoutTimer);
+                    this.connecting = undefined;
+                    this.cancelConnecting = undefined;
+                    handler();
+                };
+                this.cancelConnecting = error => settle(() => reject(error));
+                if (this.connectTimeoutMs > 0) {
+                    timeoutTimer = setTimeout(() => {
+                        const error = new Error(`408 CONNECT TIMEOUT - WebSocketClientTransport.connect() after ${this.connectTimeoutMs}ms`);
+                        this._state = 'closed';
+                        settle(() => reject(error));
+                        try {
+                            socket.close(1000, 'connect-timeout');
+                        }
+                        catch (_a) {
+                            undefined;
+                        }
+                    }, this.connectTimeoutMs);
+                }
+                this.unbinders.push(this.bindSocketListener(socket, 'open', () => {
+                    this._state = 'connected';
+                    this.emit('open', undefined);
+                    settle(() => resolve());
+                }), this.bindSocketListener(socket, 'close', event => {
+                    this._state = 'closed';
+                    this.emit('close', {
+                        code: event === null || event === void 0 ? void 0 : event.code,
+                        reason: event === null || event === void 0 ? void 0 : event.reason,
+                        wasClean: event === null || event === void 0 ? void 0 : event.wasClean,
+                    });
+                    if (!settled)
+                        settle(() => reject(new Error(`WebSocket closed before open`)));
+                }), this.bindSocketListener(socket, 'error', event => {
+                    var _a, _b;
+                    const error = (_b = (_a = event === null || event === void 0 ? void 0 : event.error) !== null && _a !== void 0 ? _a : event) !== null && _b !== void 0 ? _b : new Error(`socket transport error`);
+                    this.emit('error', { error });
+                    if (this._state !== 'connected')
+                        this._state = 'closed';
+                    if (!settled)
+                        settle(() => reject(error));
+                }), this.bindSocketListener(socket, 'message', event => {
+                    const data = event === null || event === void 0 ? void 0 : event.data;
+                    if (typeof data === 'string')
+                        this.emit('message', { data });
+                }));
+            });
+            return this.connecting;
+        });
+    }
+    disconnect(code, reason) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.socket) {
+                this._state = 'closed';
+                return;
+            }
+            this._state = 'closing';
+            const socket = this.socket;
+            let didEmitClose = false;
+            const unsubscribeClose = this.on('close', () => {
+                didEmitClose = true;
+            });
+            socket.close(code, reason);
+            unsubscribeClose();
+            (_a = this.cancelConnecting) === null || _a === void 0 ? void 0 : _a.call(this, new Error(`499 CLIENT CLOSED REQUEST - disconnect during connecting`));
+            this.cleanupSocket();
+            if (!didEmitClose) {
+                this._state = 'closed';
+                this.emit('close', { code, reason, wasClean: true });
+            }
+        });
+    }
+    send(raw) {
+        if (!this.socket || this.socket.readyState !== this.stateValue(this.socket, 'OPEN', 1)) {
+            throw new Error(`503 SOCKET NOT CONNECTED - WebSocketClientTransport.send()`);
+        }
+        this.socket.send(raw);
+    }
+    on(type, listener) {
+        var _a;
+        const bucket = (_a = this.listeners.get(type)) !== null && _a !== void 0 ? _a : new Set();
+        bucket.add(listener);
+        this.listeners.set(type, bucket);
+        return () => {
+            bucket.delete(listener);
+            if (!bucket.size)
+                this.listeners.delete(type);
+        };
+    }
+    bindSocketListener(socket, type, listener) {
+        socket.addEventListener(type, listener);
+        return () => socket.removeEventListener(type, listener);
+    }
+    emit(type, event) {
+        var _a;
+        (_a = this.listeners.get(type)) === null || _a === void 0 ? void 0 : _a.forEach(listener => listener(event));
+    }
+    cleanupSocket() {
+        this.unbinders.splice(0).forEach(unbind => unbind());
+        this.socket = undefined;
+    }
+    stateValue(socket, key, fallback) {
+        return typeof socket[key] === 'number' ? socket[key] : fallback;
+    }
+}
+exports.WebSocketClientTransport = WebSocketClientTransport;
+//# sourceMappingURL=websocket-client-transport.js.map

package/dist/socket/client/websocket-client-transport.js.map

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

package/dist/socket/decorators.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `socket/decorators.ts`
+ * - L1 `NetworkSupportable` decorators: reconnect-on-death wrapper and raw wire translator.
+ * - same slot as `createFilteredNetwork`; compose freely: filtered(translated(reconnecting(factory))).
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { NetworkSupportable, SocketUnsubscribe } from './types';
+export interface ReconnectOptions {
+    /** first retry delay (default 1_000ms) */
+    baseMs?: number;
+    /** exponential backoff multiplier (default 2) */
+    factor?: number;
+    /** retry delay cap (default 30_000ms) */
+    maxMs?: number;
+    /** retry count cap (default unlimited). onError notified then permanently closed once reached */
+    maxRetries?: number;
+    /** force a reconnect when nothing has been received for this long (default off) */
+    idleTimeoutMs?: number;
+    /** readyState watchdog cadence (default 1_000ms). fallback for networks that close without notifying */
+    watchdogMs?: number;
+}
+export interface ReconnectingNetworkSupportable extends NetworkSupportable {
+    /** notified on every successful reconnect (initial connect excluded). the service catches up here with machine.tick() */
+    onReconnect(handler: () => void): SocketUnsubscribe;
+    /** internal network generation (0 initially, +1 per reconnect) */
+    readonly generation: number;
+}
+/** create the L1 reconnect decorator: swaps the internal network on death, keeping instance identity for L3 */
+export declare const createReconnectingNetwork: (factory: () => NetworkSupportable, options?: ReconnectOptions) => ReconnectingNetworkSupportable;
+export interface WireTranslator {
+    /** outbound raw transform (default passthrough) */
+    outbound?: (raw: string) => string;
+    /** inbound raw transform. returning undefined drops the raw (default passthrough) */
+    inbound?: (raw: string) => string | undefined;
+}
+/** create the L1 wire translator decorator over a raw string, same slot as `createFilteredNetwork` */
+export declare const createTranslatedNetwork: (source: NetworkSupportable, translator: WireTranslator) => NetworkSupportable;