lemon-model 1.2.0 → 1.2.1

package/dist/esm/socket/websocket.js

@@ -0,0 +1,267 @@
+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());
+    });
+};
+/** extract a connection id from known API Gateway/WebSocket handshake response shapes */
+export const extractWebSocketConnectionId = (message) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!message || typeof message !== 'object')
+        return undefined;
+    const data = message;
+    const candidates = [
+        data.connectionId,
+        data.connId,
+        (_a = data.data) === null || _a === void 0 ? void 0 : _a.connectionId,
+        (_b = data.data) === null || _b === void 0 ? void 0 : _b.connId,
+        (_d = (_c = data.data) === null || _c === void 0 ? void 0 : _c.connId) === null || _d === void 0 ? void 0 : _d.id,
+        (_e = data.data) === null || _e === void 0 ? void 0 : _e.id,
+        (_f = data.body) === null || _f === void 0 ? void 0 : _f.connectionId,
+        (_g = data.body) === null || _g === void 0 ? void 0 : _g.connId,
+        (_h = data.body) === null || _h === void 0 ? void 0 : _h.id,
+        data.id,
+    ];
+    return candidates.find(value => typeof value === 'string' && value.length > 0);
+};
+/**
+ * Wait until a WebSocket is open, send the handshake message, and resolve the
+ * first connection id found in inbound messages.
+ */
+export const waitWebSocketConnectionId = (ws, options = {}) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const timeoutMs = (_a = options.timeoutMs) !== null && _a !== void 0 ? _a : 15000;
+    const extract = (_b = options.extract) !== null && _b !== void 0 ? _b : extractWebSocketConnectionId;
+    yield waitWebSocketOpen(ws, timeoutMs);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = timeoutMs > 0
+            ? setTimeout(() => {
+                rejectOnce(new Error(`timeout waiting for connectionId from WebSocket: ${timeoutMs}ms`));
+            }, timeoutMs)
+            : undefined;
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            ws.removeEventListener('message', onMessage);
+            ws.removeEventListener('error', onError);
+            ws.removeEventListener('close', onClose);
+        };
+        const resolveOnce = (connectionId) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(connectionId);
+        };
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const onMessage = (event) => __awaiter(void 0, void 0, void 0, function* () {
+            try {
+                const raw = yield asWebSocketText(event.data);
+                const json = tryParseWebSocketJSON(raw);
+                const connectionId = extract(json !== null && json !== void 0 ? json : raw);
+                if (connectionId)
+                    resolveOnce(connectionId);
+            }
+            catch (e) {
+                rejectOnce(e);
+            }
+        });
+        const onError = (event) => rejectOnce(event);
+        const onClose = () => rejectOnce(new Error(`WebSocket closed before connectionId was received`));
+        ws.addEventListener('message', onMessage);
+        ws.addEventListener('error', onError, { once: true });
+        ws.addEventListener('close', onClose, { once: true });
+        if (options.connectMessage)
+            ws.send(options.connectMessage);
+    });
+});
+/**
+ * Adapter from browser-like WebSocket objects to `NetworkSupportable`.
+ *
+ * The adapter does not own externally supplied WebSocket instances. `close()` is
+ * intentionally equivalent to `detach()`; callers that created the WebSocket should
+ * close it themselves when they want the underlying connection closed.
+ */
+export class BrowserWebSocketNetwork {
+    constructor(ws) {
+        this.ws = ws;
+        this.messageHandlers = new Set();
+        this.errorHandlers = new Set();
+        this.detached = false;
+        this.handleOpen = () => undefined;
+        this.handleMessage = (event) => {
+            if (this.detached || typeof event.data !== 'string')
+                return;
+            for (const handler of [...this.messageHandlers])
+                handler(event.data);
+        };
+        this.handleError = (event) => {
+            if (this.detached)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: 'browserWebSocket', network: this });
+        };
+        this.handleClose = (event) => {
+            if (this.detached)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: 'browserWebSocket.close', network: this });
+        };
+        this.opened = this.isOpen()
+            ? Promise.resolve()
+            : new Promise((resolve, reject) => {
+                const onOpen = () => {
+                    this.detachReadyListeners();
+                    resolve();
+                };
+                const onError = (event) => {
+                    this.detachReadyListeners();
+                    reject(event);
+                };
+                this.readyOpenHandler = onOpen;
+                this.readyErrorHandler = onError;
+                ws.addEventListener('open', onOpen, { once: true });
+                ws.addEventListener('error', onError, { once: true });
+            });
+        ws.addEventListener('open', this.handleOpen);
+        ws.addEventListener('message', this.handleMessage);
+        ws.addEventListener('error', this.handleError);
+        ws.addEventListener('close', this.handleClose);
+    }
+    get readyState() {
+        if (this.detached)
+            return 'closed';
+        if (this.isOpen())
+            return 'open';
+        if (this.ws.readyState === this.stateValue('CLOSING', 2))
+            return 'closing';
+        if (this.ws.readyState === this.stateValue('CLOSED', 3))
+            return 'closed';
+        return 'connecting';
+    }
+    ready() {
+        if (this.detached)
+            return Promise.reject(new Error(`@network connection error: closed - browserWebSocket.ready`));
+        return this.opened;
+    }
+    send(data) {
+        if (this.detached || !this.isOpen()) {
+            throw new Error(`@network connection error: ${this.readyState} - browserWebSocket.send`);
+        }
+        this.ws.send(data);
+    }
+    onMessage(handler) {
+        if (this.detached)
+            throw new Error(`@network connection error: closed - browserWebSocket.onMessage`);
+        this.messageHandlers.add(handler);
+        return () => this.messageHandlers.delete(handler);
+    }
+    configure(_options) {
+        // Browser WebSocket transport options are controlled by the browser/runtime.
+    }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        return () => this.errorHandlers.delete(handler);
+    }
+    close() {
+        this.detach();
+    }
+    /** remove all listeners without closing the externally owned WebSocket */
+    detach() {
+        if (this.detached)
+            return;
+        this.detached = true;
+        this.messageHandlers.clear();
+        this.errorHandlers.clear();
+        this.ws.removeEventListener('open', this.handleOpen);
+        this.ws.removeEventListener('message', this.handleMessage);
+        this.ws.removeEventListener('error', this.handleError);
+        this.ws.removeEventListener('close', this.handleClose);
+        this.detachReadyListeners();
+    }
+    isOpen() {
+        return this.ws.readyState === this.stateValue('OPEN', 1);
+    }
+    stateValue(key, fallback) {
+        return typeof this.ws[key] === 'number' ? this.ws[key] : fallback;
+    }
+    detachReadyListeners() {
+        if (this.readyOpenHandler)
+            this.ws.removeEventListener('open', this.readyOpenHandler);
+        if (this.readyErrorHandler)
+            this.ws.removeEventListener('error', this.readyErrorHandler);
+        this.readyOpenHandler = undefined;
+        this.readyErrorHandler = undefined;
+    }
+}
+const waitWebSocketOpen = (ws, timeoutMs) => {
+    if (ws.readyState === stateValue(ws, 'OPEN', 1))
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = timeoutMs > 0
+            ? setTimeout(() => rejectOnce(new Error(`timeout waiting for WebSocket open: ${timeoutMs}ms`)), timeoutMs)
+            : undefined;
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            ws.removeEventListener('open', onOpen);
+            ws.removeEventListener('error', onError);
+            ws.removeEventListener('close', onClose);
+        };
+        const resolveOnce = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve();
+        };
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const onOpen = () => resolveOnce();
+        const onError = (event) => rejectOnce(event);
+        const onClose = () => rejectOnce(new Error(`WebSocket closed before open`));
+        ws.addEventListener('open', onOpen, { once: true });
+        ws.addEventListener('error', onError, { once: true });
+        ws.addEventListener('close', onClose, { once: true });
+    });
+};
+const stateValue = (ws, key, fallback) => (typeof ws[key] === 'number' ? ws[key] : fallback);
+const asWebSocketText = (data) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof data === 'string')
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new TextDecoder().decode(data);
+    if (ArrayBuffer.isView(data))
+        return new TextDecoder().decode(data);
+    const readable = data;
+    if (typeof (readable === null || readable === void 0 ? void 0 : readable.text) === 'function')
+        return readable.text();
+    if (typeof (readable === null || readable === void 0 ? void 0 : readable.arrayBuffer) === 'function')
+        return new TextDecoder().decode(yield readable.arrayBuffer());
+    return String(data);
+});
+const tryParseWebSocketJSON = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+//# sourceMappingURL=websocket.js.map

package/dist/esm/socket/websocket.js.map

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

package/dist/esm/types/core-storage.js

@@ -0,0 +1,30 @@
+/**
+ * `core-storage.ts`
+ * - common types for core storage
+ *
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2019-11-20 initial version
+ * @date        2020-01-03 support cognito-identity
+ * @date        2021-12-07 support SearchBody
+ *
+ * @copyright   (C) lemoncloud.io 2019 - All Rights Reserved.
+ */
+//NOTE! - BE WARE TO USE `ts-transformer-keys` DUE TO MISSING `ttypescript`
+export const CORE_FIELDS = [
+    '$',
+    'ns',
+    'type',
+    'stereo',
+    'sid',
+    'uid',
+    'gid',
+    'lock',
+    'next',
+    'meta',
+    'createdAt',
+    'updatedAt',
+    'deletedAt',
+    'error',
+];
+//# sourceMappingURL=core-storage.js.map

package/dist/esm/types/core-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-storage.js","sourceRoot":"","sources":["../../../src/types/core-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwHH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAa;IACjC,GAAG;IACH,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,WAAW;IACX,WAAW;IACX,OAAO;CACV,CAAC"}

package/dist/esm/types/core-types.js

@@ -0,0 +1,17 @@
+/**
+ * `core-types.ts`
+ * - common types for core service
+ *
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2019-11-20 initial version
+ * @date        2020-01-03 support cognito-identity
+ * @date        2021-12-07 support SearchBody
+ * @date        2024-12-20 optimized `NextIdentityCognito`
+ * @date        2025-05-13 optimized `NextContext` with `Authorization` header
+ * @date        2025-06-12 optimized `SearchBody` with `knn` support
+ *
+ * @copyright   (C) lemoncloud.io 2019 - All Rights Reserved.
+ */
+export {};
+//# sourceMappingURL=core-types.js.map

package/dist/esm/types/core-types.js.map

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

package/dist/esm/types/index.js

@@ -0,0 +1,13 @@
+/**
+ * `index.ts`
+ * - main index
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2019-08-09 initial commit
+ * @date        2019-11-26 cleanup and optimized for `lemon-core#v2`
+ *
+ * @copyright (C) lemoncloud.io 2019 - All Rights Reserved.
+ */
+export * from './core-types.js';
+export * from './core-storage.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/genai/index.js

@@ -26,6 +26,6 @@ __exportStar(require("./proxy"), exports);
 __exportStar(require("./transport"), exports);
 __exportStar(require("./dump-test"), exports);
 //! NOTE: test helpers (`./mocks`) are intentionally NOT re-exported here.
-//! Import them via the isolated `lemon-model/dist/genai/testing` entry so
+//! Import them via the isolated `lemon-model/genai/testing` entry so
 //! production (esp. frontend) bundles do not pull in test-only helpers.
 //# sourceMappingURL=index.js.map

package/dist/genai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/genai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/genai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0EAA0E;AAC1E,qEAAqE;AACrE,wEAAwE"}

package/dist/genai/testing.d.ts

@@ -4,7 +4,7 @@
  * - kept OUT of the package root barrel so production bundles do not include test helpers.
  *
  * Usage (tests / dev only):
- *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/dist/genai/testing';
+ *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/genai/testing';
  *
  * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
  */

package/dist/genai/testing.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * - kept OUT of the package root barrel so production bundles do not include test helpers.
  *
  * Usage (tests / dev only):
- *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/dist/genai/testing';
+ *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/genai/testing';
  *
  * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
  */

package/dist/socket/index.js

@@ -24,6 +24,6 @@ __exportStar(require("./types"), exports);
 __exportStar(require("./transport"), exports);
 __exportStar(require("./websocket"), exports);
 //! NOTE: the in-memory peer simulator (`./socket`) is intentionally NOT re-exported here.
-//! It is a test/dev utility — import it via the isolated `lemon-model/dist/socket/testing` entry
+//! It is a test/dev utility — import it via the isolated `lemon-model/socket/testing` entry
 //! so production (esp. frontend) bundles do not pull in the simulator runtime.
 //# sourceMappingURL=index.js.map

package/dist/socket/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0FAA0F;AAC1F,iGAAiG;AACjG,+EAA+E"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0FAA0F;AAC1F,4FAA4F;AAC5F,+EAA+E"}

package/dist/socket/testing.d.ts

@@ -4,7 +4,7 @@
  * - kept OUT of the package root barrel so production bundles do not include the simulator runtime.
  *
  * Usage (tests / dev only):
- *   import { createNetwork, createPeer, createSocketFactory } from 'lemon-model/dist/socket/testing';
+ *   import { createNetwork, createPeer, createSocketFactory } from 'lemon-model/socket/testing';
  *
  * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
  */

package/dist/socket/testing.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * - kept OUT of the package root barrel so production bundles do not include the simulator runtime.
  *
  * Usage (tests / dev only):
- *   import { createNetwork, createPeer, createSocketFactory } from 'lemon-model/dist/socket/testing';
+ *   import { createNetwork, createPeer, createSocketFactory } from 'lemon-model/socket/testing';
  *
  * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
  */

package/package.json

@@ -1,12 +1,35 @@
 {
   "name": "lemon-model",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Common shared model definitions for Lemon Micro-Service Platform",
   "main": "dist/index.js",
+  "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./genai/testing": {
+      "types": "./dist/genai/testing.d.ts",
+      "import": "./dist/esm/genai/testing.js",
+      "require": "./dist/genai/testing.js",
+      "default": "./dist/genai/testing.js"
+    },
+    "./socket/testing": {
+      "types": "./dist/socket/testing.d.ts",
+      "import": "./dist/esm/socket/testing.js",
+      "require": "./dist/socket/testing.js",
+      "default": "./dist/socket/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
-    "build": "npm run build-ts",
+    "build": "npm run build-ts && npm run build-esm",
     "build-ts": "tsc -v && tsc",
+    "build-esm": "tsc -p tsconfig.esm.json && node scripts/fix-esm-build.cjs",
     "watch-ts": "tsc -w",
     "doc": "npm run doc:html && open dist/docs/index.html",
     "doc:html": "typedoc src/ --exclude **/*.spec.ts --target ES6 --mode file --out dist/docs",
@@ -15,6 +38,7 @@
     "format": "prettier --write \"src/**/*.ts\"",
     "!test": "------- run self-test with jest -----",
     "test": "jest --config=jest.config.json",
+    "test:package-exports": "npm run build && node scripts/check-package-exports.cjs",
     "test:watch": "jest --config=jest.config.json --watchAll",
     "!publish": "------- publish into repository -----",
     "prepare": "npm run build",