lemon-model 1.2.3 → 1.4.0

package/dist/esm/upload/engine/index.js

@@ -0,0 +1,13 @@
+/**
+ * `upload/engine/index.ts`
+ * - isolated entry for the client upload engine: `import { ... } from 'lemon-model/upload/engine'`.
+ * - kept OUT of both the package root barrel and `lemon-model/upload`: a server consumer needs the
+ *   contract only, and must not pull the engine in with it.
+ * - shell adapters (XHR, RN bridge, Electron fs) are NOT here — they belong to the consuming app.
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+export * from './progress.js';
+export * from './engine.js';
+export * from './executors.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/upload/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/upload/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/esm/upload/engine/progress.js

@@ -0,0 +1,52 @@
+/**
+ * `upload/engine/progress.ts`
+ * - progress is a CLIENT-LOCAL signal: nothing here travels on the wire and no server ever sees it.
+ *   the server's knowledge of progress differs per transfer kind (a presigned PUT it cannot see at all),
+ *   so the contract deliberately carries none of it.
+ * - scope A: per-file percent + one batch percent. everything is measured in bytes of the ORIGINAL
+ *   content, never in wire bytes, so the bar means the same thing whichever executor runs.
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+/** scale request-body progress (base64 JSON or raw bytes) to original-send bytes */
+export const asContentBytes = (loaded, total, contentSize) => total > 0 ? Math.min(contentSize, Math.round((loaded / total) * contentSize)) : 0;
+/** byte-weighted aggregation; one immutable snapshot per change so a UI store can replace state as-is */
+export class UploadProgressTracker {
+    constructor(totals, emit) {
+        this.emit = emit;
+        this.files = totals.map((total, index) => ({ index, total: Math.max(0, total), settled: false }));
+        this.totalBytes = this.files.reduce((sum, file) => sum + file.total, 0);
+    }
+    /** the per-file sink handed to an executor: clamps to [previous, total], ignores reports after settle */
+    sink(index) {
+        return sent => {
+            var _a;
+            const file = this.files[index];
+            if (!file || file.settled)
+                return;
+            const next = Math.min(file.total, Math.max(sent, (_a = file.sent) !== null && _a !== void 0 ? _a : 0));
+            if (next === file.sent)
+                return;
+            this.files = this.files.map(item => (item.index === index ? Object.assign(Object.assign({}, item), { sent: next }) : item));
+            this.publish();
+        };
+    }
+    settle(index) {
+        const file = this.files[index];
+        if (!file || file.settled)
+            return;
+        this.files = this.files.map(item => (item.index === index ? Object.assign(Object.assign({}, item), { settled: true }) : item));
+        this.publish();
+    }
+    snapshot() {
+        const sentBytes = this.files.reduce((sum, file) => { var _a; return sum + (file.settled ? file.total : (_a = file.sent) !== null && _a !== void 0 ? _a : 0); }, 0);
+        const settled = this.files.filter(file => file.settled).length;
+        const ratio = this.totalBytes > 0 ? sentBytes / this.totalBytes : this.files.length > 0 ? settled / this.files.length : 1;
+        return { files: this.files, totalBytes: this.totalBytes, sentBytes, ratio };
+    }
+    publish() {
+        if (this.emit)
+            this.emit(this.snapshot());
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/esm/upload/engine/progress.js.map

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

package/dist/esm/upload/index.js

@@ -0,0 +1,11 @@
+/**
+ * `upload/index.ts`
+ * - isolated entry for the upload contract: `import { ... } from 'lemon-model/upload'`.
+ * - kept OUT of the package root barrel: a consumer that only needs this contract must not pull
+ *   the socket/genai runtime, and a subpath can be promoted to the root later without a breaking
+ *   change (the reverse is not true).
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/upload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/upload/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,SAAS,CAAC"}

package/dist/esm/upload/testing.js

@@ -0,0 +1,73 @@
+import { UPLOAD_STATUS, UPLOAD_STEREO, UPLOAD_TRANSFER_KIND } from './types.js';
+/** a settled image as the server returns it after `complete` */
+export const SAMPLE_UPLOAD_STORED = {
+    id: 'up-001',
+    status: UPLOAD_STATUS.stored,
+    stereo: UPLOAD_STEREO.image,
+    name: 'photo.png',
+    contentType: 'image/png',
+    contentSize: 123456,
+    url: 'https://cdn.example.com/up-001.png',
+    width: 1024,
+    height: 768,
+    createdAt: 1757894400000,
+    updatedAt: 1757894401000,
+};
+/** the head a message embeds under `upload$$` for the same upload */
+export const SAMPLE_UPLOAD_HEAD = {
+    id: 'up-001',
+    stereo: UPLOAD_STEREO.image,
+    name: 'photo.png',
+    contentType: 'image/png',
+    contentSize: 123456,
+    url: 'https://cdn.example.com/up-001.png',
+    width: 1024,
+    height: 768,
+};
+/** what a message view carries: both halves of the pair, never one */
+export const SAMPLE_UPLOAD_REFS = {
+    uploadIds: ['up-001'],
+    upload$$: [SAMPLE_UPLOAD_HEAD],
+};
+/** start slot: inline ticket (roadmap 1) */
+export const SAMPLE_UPLOAD_TICKET_INLINE = {
+    upload: {
+        id: 'up-002',
+        status: UPLOAD_STATUS.pending,
+        stereo: UPLOAD_STEREO.image,
+        name: 'photo.png',
+        contentType: 'image/png',
+        contentSize: 123456,
+    },
+    transfer: { kind: UPLOAD_TRANSFER_KIND.inline, maxBytes: 4000000 },
+};
+/** start slot: presigned ticket (roadmap 2) */
+export const SAMPLE_UPLOAD_TICKET_PRESIGNED = {
+    upload: {
+        id: 'up-003',
+        status: UPLOAD_STATUS.pending,
+        stereo: UPLOAD_STEREO.image,
+        name: 'photo.png',
+        contentType: 'image/png',
+        contentSize: 123456,
+    },
+    transfer: {
+        kind: UPLOAD_TRANSFER_KIND.presignedPut,
+        method: 'PUT',
+        url: 'https://storage.example.com/up-003?X-Amz-Signature=masked',
+        headers: { 'content-type': 'image/png', 'content-length': '123456' },
+        maxBytes: 50000000,
+        expiresAt: 1757895300000,
+    },
+};
+/** start slot rejected at validation: no id, nothing to transfer or complete */
+export const SAMPLE_UPLOAD_REJECTED = {
+    upload: {
+        status: UPLOAD_STATUS.failed,
+        name: 'big.png',
+        contentType: 'image/png',
+        contentSize: 6291456,
+        error: '413 TOO LARGE - 6291456 > 4000000',
+    },
+};
+//# sourceMappingURL=testing.js.map

package/dist/esm/upload/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/upload/testing.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC5C,EAAE,EAAE,QAAQ;IACZ,MAAM,EAAE,aAAa,CAAC,MAAM;IAC5B,MAAM,EAAE,aAAa,CAAC,KAAK;IAC3B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,MAAM;IACnB,GAAG,EAAE,oCAAoC;IACzC,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,GAAG;IACX,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CAC3B,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC1C,EAAE,EAAE,QAAQ;IACZ,MAAM,EAAE,aAAa,CAAC,KAAK;IAC3B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,MAAM;IACnB,GAAG,EAAE,oCAAoC;IACzC,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,GAAG;CACd,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC1C,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,QAAQ,EAAE,CAAC,kBAAkB,CAAC;CACjC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAiB;IACrD,MAAM,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,MAAM,EAAE,aAAa,CAAC,KAAK;QAC3B,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,MAAM;KACtB;IACD,QAAQ,EAAE,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;CACrE,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAiB;IACxD,MAAM,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,MAAM,EAAE,aAAa,CAAC,KAAK;QAC3B,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,MAAM;KACtB;IACD,QAAQ,EAAE;QACN,IAAI,EAAE,oBAAoB,CAAC,YAAY;QACvC,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,2DAA2D;QAChE,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE;QACpE,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,aAAa;KAC3B;CACJ,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAChD,MAAM,EAAE;QACJ,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,OAAO;QACpB,KAAK,EAAE,mCAAmC;KAC7C;CACJ,CAAC"}

package/dist/esm/upload/types.js

@@ -0,0 +1,69 @@
+/** kind of stored content. same vocabulary as lemon-uploads-api `MediaStereo` minus its internal markers */
+export const UPLOAD_STEREO = {
+    image: 'image',
+    video: 'video',
+    sound: 'sound',
+    docs: 'docs',
+};
+/** lifecycle of one upload as the client sees it. `url` is meaningful only when `stored` */
+export const UPLOAD_STATUS = {
+    /** ticket issued; bytes not confirmed by the server yet */
+    pending: 'pending',
+    /** bytes durable and `url` valid */
+    stored: 'stored',
+    /** terminal; `error` carries "<status> <LABEL> - <detail>" */
+    failed: 'failed',
+};
+/** how bytes travel. the only axis that changes across the roadmap */
+export const UPLOAD_TRANSFER_KIND = {
+    /** base64 JSON to the API via the `send` operation (roadmap 1) */
+    inline: 'inline',
+    /** HTTP PUT straight to storage with a server-issued url + headers (roadmap 2) */
+    presignedPut: 'presigned-put',
+};
+/** who produced a failure */
+export const UPLOAD_FAILURE_SOURCE = {
+    /** our API answered with an error */
+    api: 'api',
+    /** the storage endpoint (presigned PUT) answered with an error */
+    storage: 'storage',
+    /** the client gave up before or without a response */
+    client: 'client',
+};
+/** normalized failure codes; the app branches on these, never on raw HTTP status */
+export const UPLOAD_FAILURE_CODE = {
+    invalid: 'invalid',
+    tooLarge: 'too-large',
+    unsupported: 'unsupported',
+    notAcceptable: 'not-acceptable',
+    notFound: 'not-found',
+    conflict: 'conflict',
+    expired: 'expired',
+    signature: 'signature',
+    checksum: 'checksum',
+    network: 'network',
+    aborted: 'aborted',
+    unknown: 'unknown',
+};
+/** HTTP binding relative to the server's upload base path (lemon-core `/{type}/{id}/{cmd}` shape) */
+export const UPLOAD_ROUTES = {
+    start: { method: 'POST', path: '/start' },
+    send: { method: 'POST', path: '/{id}/send' },
+    complete: { method: 'POST', path: '/complete' },
+    read: { method: 'GET', path: '/{id}' },
+};
+export const isUploadStored = (view) => view.status === UPLOAD_STATUS.stored && typeof view.id === 'string' && typeof view.url === 'string';
+/** shared stereo derivation so an optimistic client tile and the server agree */
+export const uploadStereoOf = (contentType) => {
+    const type = contentType.toLowerCase().split(';')[0].trim();
+    if (type.startsWith('image/'))
+        return UPLOAD_STEREO.image;
+    if (type.startsWith('video/'))
+        return UPLOAD_STEREO.video;
+    if (type.startsWith('audio/'))
+        return UPLOAD_STEREO.sound;
+    if (type === 'application/pdf')
+        return UPLOAD_STEREO.docs;
+    return undefined;
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/upload/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/upload/types.ts"],"names":[],"mappings":"AAaA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACN,CAAC;AAGX,4FAA4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,2DAA2D;IAC3D,OAAO,EAAE,SAAS;IAClB,oCAAoC;IACpC,MAAM,EAAE,QAAQ;IAChB,8DAA8D;IAC9D,MAAM,EAAE,QAAQ;CACV,CAAC;AAGX,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,kEAAkE;IAClE,MAAM,EAAE,QAAQ;IAChB,kFAAkF;IAClF,YAAY,EAAE,eAAe;CACvB,CAAC;AAoHX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,qCAAqC;IACrC,GAAG,EAAE,KAAK;IACV,kEAAkE;IAClE,OAAO,EAAE,SAAS;IAClB,sDAAsD;IACtD,MAAM,EAAE,QAAQ;CACV,CAAC;AAGX,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,gBAAgB;IAC/B,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACZ,CAAC;AA8CX,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE;IAC5C,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;IAC/C,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE;CAChC,CAAC;AAKX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAgB,EAA4B,EAAE,CACzE,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC;AAExG,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAmB,EAA4B,EAAE;IAC5E,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC;IAC1D,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -13,5 +13,6 @@ export * from './cores';
 export * from './socket';
 export * from './genai';
 export * from './buffer';
+export * from './sync';
 export * from './progress';
 export * from './logtrace';

package/dist/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./cores"), exports);
 __exportStar(require("./socket"), exports);
 __exportStar(require("./genai"), exports);
 __exportStar(require("./buffer"), exports);
+__exportStar(require("./sync"), exports);
 __exportStar(require("./progress"), exports);
 __exportStar(require("./logtrace"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,6CAA2B;AAC3B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,yCAAuB;AACvB,6CAA2B;AAC3B,6CAA2B"}

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

@@ -0,0 +1,9 @@
+export * from './types';
+export * from './shared-timer-scheduler';
+export * from './message-router';
+export * from './pending-request-store';
+export * from './socket-client';
+export * from './websocket-client-transport';
+export * from './keep-alive-controller';
+export * from './reconnect-controller';
+export * from './rotation-controller';

package/dist/socket/client/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./shared-timer-scheduler"), exports);
+__exportStar(require("./message-router"), exports);
+__exportStar(require("./pending-request-store"), exports);
+__exportStar(require("./socket-client"), exports);
+__exportStar(require("./websocket-client-transport"), exports);
+__exportStar(require("./keep-alive-controller"), exports);
+__exportStar(require("./reconnect-controller"), exports);
+__exportStar(require("./rotation-controller"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/socket/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2DAAyC;AACzC,mDAAiC;AACjC,0DAAwC;AACxC,kDAAgC;AAChC,+DAA6C;AAC7C,0DAAwC;AACxC,yDAAuC;AACvC,wDAAsC"}

package/dist/socket/client/keep-alive-controller.d.ts

@@ -0,0 +1,35 @@
+import type { SharedTimerScheduler, SocketRuntimePort } from './types';
+export interface KeepAliveControllerOptions<TMessage> {
+    client: SocketRuntimePort<TMessage>;
+    buildMessage: () => TMessage;
+    intervalMs?: number;
+    timeoutMs?: number;
+    maxMissedPongs?: number;
+    mode?: 'send' | 'request';
+    timerScheduler?: SharedTimerScheduler;
+    timerKey?: string;
+    onPongTimeout?: () => unknown | Promise<unknown>;
+}
+export declare class KeepAliveController<TMessage> {
+    private readonly client;
+    private readonly buildMessage;
+    private readonly intervalMs;
+    private readonly timeoutMs;
+    private readonly maxMissedPongs;
+    private readonly mode;
+    private readonly timerScheduler;
+    private readonly timerKey;
+    private readonly onPongTimeout;
+    private readonly unsubs;
+    private running;
+    private inFlight;
+    private missedPongs;
+    constructor(options: KeepAliveControllerOptions<TMessage>);
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    private scheduleNow;
+    private scheduleNext;
+    private clearTimer;
+    private tick;
+}

package/dist/socket/client/keep-alive-controller.js

@@ -0,0 +1,101 @@
+"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.KeepAliveController = void 0;
+const shared_timer_scheduler_1 = require("./shared-timer-scheduler");
+class KeepAliveController {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f;
+        this.unsubs = [];
+        this.running = false;
+        this.inFlight = false;
+        this.missedPongs = 0;
+        this.client = options.client;
+        this.buildMessage = options.buildMessage;
+        this.intervalMs = (_a = options.intervalMs) !== null && _a !== void 0 ? _a : 30000;
+        this.timeoutMs = (_b = options.timeoutMs) !== null && _b !== void 0 ? _b : 10000;
+        this.maxMissedPongs = Math.max(1, (_c = options.maxMissedPongs) !== null && _c !== void 0 ? _c : 2);
+        this.mode = (_d = options.mode) !== null && _d !== void 0 ? _d : 'request';
+        this.timerScheduler = (_e = options.timerScheduler) !== null && _e !== void 0 ? _e : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
+        this.timerKey = (_f = options.timerKey) !== null && _f !== void 0 ? _f : 'keepalive';
+        this.onPongTimeout = options.onPongTimeout;
+        this.unsubs.push(options.client.onState(event => {
+            if (event.next === 'connected' && this.running) {
+                this.missedPongs = 0;
+                this.scheduleNow();
+            }
+            if (event.next === 'closing' || event.next === 'closed') {
+                this.missedPongs = 0;
+                this.clearTimer();
+            }
+        }));
+    }
+    start() {
+        this.running = true;
+        if (this.client.state === 'connected')
+            this.scheduleNow();
+    }
+    stop() {
+        this.running = false;
+        this.clearTimer();
+    }
+    destroy() {
+        this.stop();
+        this.unsubs.splice(0).forEach(unsub => unsub());
+    }
+    scheduleNow() {
+        this.clearTimer();
+        this.timerScheduler.schedule(this.timerKey, 0, () => this.tick());
+    }
+    scheduleNext() {
+        this.clearTimer();
+        if (!this.running || this.client.state !== 'connected')
+            return;
+        this.timerScheduler.schedule(this.timerKey, this.intervalMs, () => this.tick());
+    }
+    clearTimer() {
+        this.timerScheduler.cancel(this.timerKey);
+    }
+    tick() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.running || this.client.state !== 'connected' || this.inFlight)
+                return;
+            this.inFlight = true;
+            try {
+                const message = this.buildMessage();
+                if (this.mode === 'send') {
+                    this.client.send(message);
+                    return;
+                }
+                yield this.client.request(message, { timeoutMs: this.timeoutMs });
+                this.missedPongs = 0;
+            }
+            catch (_a) {
+                if (this.mode === 'request') {
+                    this.missedPongs += 1;
+                    if (this.missedPongs >= this.maxMissedPongs) {
+                        this.missedPongs = 0;
+                        if (this.onPongTimeout)
+                            yield Promise.resolve(this.onPongTimeout()).catch(() => undefined);
+                        else
+                            yield this.client.disconnect(1001, 'pong-timeout').catch(() => undefined);
+                    }
+                }
+            }
+            finally {
+                this.inFlight = false;
+                this.scheduleNext();
+            }
+        });
+    }
+}
+exports.KeepAliveController = KeepAliveController;
+//# sourceMappingURL=keep-alive-controller.js.map

package/dist/socket/client/keep-alive-controller.js.map

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

package/dist/socket/client/message-router.d.ts

@@ -0,0 +1,15 @@
+import type { SocketUnsubscribe } from '../types';
+export declare type MessageListener<TMessage = unknown> = (message: TMessage) => void;
+export interface MessageRouterOptions<TMessage> {
+    getMessageType?: (message: TMessage) => string | undefined;
+}
+export declare class MessageRouter<TMessage = any> {
+    private readonly anyListeners;
+    private readonly typeListeners;
+    private readonly getMessageType;
+    constructor(options?: MessageRouterOptions<TMessage>);
+    onAny(listener: MessageListener<TMessage>): SocketUnsubscribe;
+    onType(type: string, listener: MessageListener<TMessage>): SocketUnsubscribe;
+    clear(): void;
+    route(message: TMessage): number;
+}

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageRouter = void 0;
+class MessageRouter {
+    constructor(options = {}) {
+        var _a;
+        this.anyListeners = new Set();
+        this.typeListeners = new Map();
+        this.getMessageType = (_a = options.getMessageType) !== null && _a !== void 0 ? _a : (message => { var _a; return `${(_a = message === null || message === void 0 ? void 0 : message.type) !== null && _a !== void 0 ? _a : ''}`; });
+    }
+    onAny(listener) {
+        this.anyListeners.add(listener);
+        return () => this.anyListeners.delete(listener);
+    }
+    onType(type, listener) {
+        var _a;
+        const key = `${type !== null && type !== void 0 ? type : ''}`.trim();
+        if (!key)
+            throw new Error(`@type (string) is required - MessageRouter.onType()`);
+        const bucket = (_a = this.typeListeners.get(key)) !== null && _a !== void 0 ? _a : new Set();
+        bucket.add(listener);
+        this.typeListeners.set(key, bucket);
+        return () => {
+            bucket.delete(listener);
+            if (!bucket.size)
+                this.typeListeners.delete(key);
+        };
+    }
+    clear() {
+        this.anyListeners.clear();
+        this.typeListeners.clear();
+    }
+    route(message) {
+        var _a;
+        const key = `${(_a = this.getMessageType(message)) !== null && _a !== void 0 ? _a : ''}`.trim();
+        let count = 0;
+        this.anyListeners.forEach(listener => {
+            listener(message);
+            count += 1;
+        });
+        if (!key)
+            return count;
+        const bucket = this.typeListeners.get(key);
+        bucket === null || bucket === void 0 ? void 0 : bucket.forEach(listener => {
+            listener(message);
+            count += 1;
+        });
+        return count;
+    }
+}
+exports.MessageRouter = MessageRouter;
+//# sourceMappingURL=message-router.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../../../src/socket/client/message-router.ts"],"names":[],"mappings":";;;AAQA,MAAa,aAAa;IAKtB,YAAmB,UAA0C,EAAE;;QAJ9C,iBAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;QACpD,kBAAa,GAAG,IAAI,GAAG,EAA0C,CAAC;QAI/E,IAAI,CAAC,cAAc,GAAG,MAAA,OAAO,CAAC,cAAc,mCAAI,CAAC,OAAO,CAAC,EAAE,WAAC,OAAA,GAAG,MAAC,OAAe,aAAf,OAAO,uBAAP,OAAO,CAAU,IAAI,mCAAI,EAAE,EAAE,CAAA,EAAA,CAAC,CAAC;IACnG,CAAC;IAEM,KAAK,CAAC,QAAmC;QAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAEM,MAAM,CAAC,IAAY,EAAE,QAAmC;;QAC3D,MAAM,GAAG,GAAG,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,IAAI,GAAG,EAA6B,CAAC;QACnF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE;YACR,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI;gBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC,CAAC;IACN,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,OAAiB;;QAC1B,MAAM,GAAG,GAAG,GAAG,MAAA,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,mCAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACjC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;YACvB,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AA9CD,sCA8CC"}

package/dist/socket/client/pending-request-store.d.ts

@@ -0,0 +1,24 @@
+import type { SharedTimerScheduler } from './types';
+export interface PendingRequestStoreOptions {
+    timerScheduler?: SharedTimerScheduler;
+    timerPrefix?: string;
+}
+export interface PendingRequestCreateOptions {
+    timeoutMs?: number;
+    onTimeout?: (mid: string) => Error;
+}
+export declare class PendingRequestStore {
+    private readonly items;
+    private readonly timerScheduler;
+    private readonly timerPrefix;
+    constructor(options?: PendingRequestStoreOptions);
+    size(): number;
+    has(mid: string): boolean;
+    create<T = unknown>(mid: string, options?: PendingRequestCreateOptions): Promise<T>;
+    resolve<T = unknown>(mid: string, value: T): boolean;
+    reject(mid: string, error: unknown): boolean;
+    clear(reason?: unknown): number;
+    private timeout;
+    private remove;
+    private toTimerKey;
+}

package/dist/socket/client/pending-request-store.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingRequestStore = void 0;
+class PendingRequestStore {
+    constructor(options = {}) {
+        var _a;
+        this.items = new Map();
+        this.timerScheduler = options.timerScheduler;
+        this.timerPrefix = (_a = options.timerPrefix) !== null && _a !== void 0 ? _a : 'pending:';
+    }
+    size() {
+        return this.items.size;
+    }
+    has(mid) {
+        return this.items.has(mid);
+    }
+    create(mid, options = {}) {
+        if (!mid)
+            throw new Error(`@mid (string) is required - PendingRequestStore.create()`);
+        if (this.items.has(mid))
+            throw new Error(`409 CONFLICT - pending request[${mid}] already exists`);
+        return new Promise((resolve, reject) => {
+            const item = {
+                resolve,
+                reject,
+                timer: options.timeoutMs && options.timeoutMs > 0 && !this.timerScheduler
+                    ? setTimeout(() => this.timeout(mid, options), options.timeoutMs)
+                    : undefined,
+            };
+            this.items.set(mid, item);
+            if (options.timeoutMs && options.timeoutMs > 0 && this.timerScheduler) {
+                this.timerScheduler.schedule(this.toTimerKey(mid), options.timeoutMs, () => this.timeout(mid, options));
+            }
+        });
+    }
+    resolve(mid, value) {
+        const item = this.items.get(mid);
+        if (!item)
+            return false;
+        this.remove(mid, item);
+        item.resolve(value);
+        return true;
+    }
+    reject(mid, error) {
+        const item = this.items.get(mid);
+        if (!item)
+            return false;
+        this.remove(mid, item);
+        item.reject(error);
+        return true;
+    }
+    clear(reason = new Error(`499 CLIENT CLOSED REQUEST`)) {
+        const mids = [...this.items.keys()];
+        mids.forEach(mid => this.reject(mid, reason));
+        return mids.length;
+    }
+    timeout(mid, options) {
+        var _a, _b;
+        const item = this.items.get(mid);
+        if (!item)
+            return;
+        this.items.delete(mid);
+        const error = (_b = (_a = options.onTimeout) === null || _a === void 0 ? void 0 : _a.call(options, mid)) !== null && _b !== void 0 ? _b : new Error(`408 REQUEST TIMEOUT - pending[${mid}]`);
+        item.reject(error);
+    }
+    remove(mid, item) {
+        var _a;
+        this.items.delete(mid);
+        (_a = this.timerScheduler) === null || _a === void 0 ? void 0 : _a.cancel(this.toTimerKey(mid));
+        if (item.timer)
+            clearTimeout(item.timer);
+    }
+    toTimerKey(mid) {
+        return `${this.timerPrefix}${mid}`;
+    }
+}
+exports.PendingRequestStore = PendingRequestStore;
+//# sourceMappingURL=pending-request-store.js.map

package/dist/socket/client/pending-request-store.js.map

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