lemon-core 5.0.4 → 5.0.5

package/dist/lib/safe-json.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * `safe-json.ts`
+ * - internal `JSON.stringify()` for error reports, which never throws.
+ * - a back-reference to an ancestor (circular structure) becomes `'[Circular]'`.
+ * - an `Error` instance is expanded to `{ name, message, stack?, ...own props, errors?, cause? }` (plain `JSON.stringify()` gives `{}`).
+ * - a `BigInt` becomes its decimal string.
+ * - otherwise the output is the same as `JSON.stringify()` (key order, `toJSON()`, omitted `undefined`/function values).
+ * - used by `asErrorPayload()`·`GETERR()` (`common/test-helper.ts`), `doReportError()`·`do_parallel()` (`engine/engine.ts`) and `AWSSNSService.publish()`.
+ * - NOTE: internal only. do not export from `lib/index.ts` or any other barrel.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-29 initial version (v5 B10-2: circular structure in `doReportError()`)
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeStringify = void 0;
+//* v5 B10-2: expand an `Error` to a plain object, so that `name`·`message`·`stack` and non-enumerable `errors`·`cause` are kept.
+const expandError = (e) => {
+    const out = { name: e.name, message: e.message };
+    if (e.stack !== undefined)
+        out.stack = e.stack;
+    // own enumerable props (e.g. `code`, `statusCode`, `errors` set by assignment).
+    for (const key of Object.keys(e))
+        out[key] = e[key];
+    // `AggregateError.errors` and `new Error(m, { cause })` are own but non-enumerable.
+    if (!('errors' in out) && e.errors !== undefined)
+        out.errors = e.errors;
+    if (!('cause' in out) && e.cause !== undefined)
+        out.cause = e.cause;
+    return out;
+};
+//* v5 B10-2: build a replacer, which tracks only the ancestors (a shared but non-circular reference is printed as is).
+const circularReplacer = () => {
+    const stack = [];
+    return function (_key, value) {
+        if (typeof value === 'bigint')
+            return value.toString();
+        if (value === null || typeof value !== 'object')
+            return value;
+        // drop the finished siblings: the top of the stack must be the current holder.
+        while (stack.length > 0 && stack[stack.length - 1].holder !== this)
+            stack.pop();
+        if (stack.some(a => a.origin === value))
+            return '[Circular]';
+        const holder = value instanceof Error ? expandError(value) : value;
+        stack.push({ holder, origin: value });
+        return holder;
+    };
+};
+/**
+ * `JSON.stringify()` which never throws (v5 B10-2).
+ * - on any failure (e.g. a throwing getter or `toJSON()`), it falls back to `String(value)`.
+ *
+ * @param value     any value to print.
+ * @param space     (optional) same as `JSON.stringify()`.
+ */
+const safeStringify = (value, space) => {
+    //* v5 B10-2: main path — `JSON.stringify()` with the circular-safe replacer.
+    try {
+        const text = JSON.stringify(value, circularReplacer(), space);
+        if (typeof text === 'string')
+            return text;
+    }
+    catch (e) {
+        // fall through to the last resort.
+    }
+    //* v5 B10-2: last resort — `String()` may throw too (e.g. `Object.create(null)`).
+    try {
+        return String(value);
+    }
+    catch (e) {
+        return '[Unserializable]';
+    }
+};
+exports.safeStringify = safeStringify;
+//# sourceMappingURL=safe-json.js.map

package/dist/lib/safe-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-json.js","sourceRoot":"","sources":["../../src/lib/safe-json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAQH,iIAAiI;AACjI,MAAM,WAAW,GAAG,CAAC,CAAQ,EAA2B,EAAE;IACtD,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1E,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,gFAAgF;IAChF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,GAAI,CAAS,CAAC,GAAG,CAAC,CAAC;IAC7D,oFAAoF;IACpF,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAK,CAAS,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAI,CAAS,CAAC,MAAM,CAAC;IAC1F,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,IAAK,CAAS,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAI,CAAS,CAAC,KAAK,CAAC;IACtF,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,uHAAuH;AACvH,MAAM,gBAAgB,GAAG,GAAG,EAAE;IAC1B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,OAAO,UAAwB,IAAY,EAAE,KAAc;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,+EAA+E;QAC/E,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAChF,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC;YAAE,OAAO,YAAY,CAAC;QAC7D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAuB,EAAU,EAAE;IAC7E,6EAA6E;IAC7E,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,mCAAmC;IACvC,CAAC;IACD,kFAAkF;IAClF,IAAI,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,kBAAkB,CAAC;IAC9B,CAAC;AACL,CAAC,CAAC;AAdW,QAAA,aAAa,iBAcxB"}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "lemon-core",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "description": "Lemon Serverless Micro-Service Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "lemon-fields-types": "bin/lemon-fields-types.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -52,6 +55,7 @@
     "api:check": "node scripts/api-check.cjs",
     "dup:check": "node scripts/dup-decls.cjs",
     "l1l2:probe": "node scripts/l1l2-probe.cjs",
+    "fields:types": "node bin/lemon-fields-types.mjs",
     "watch-ts": "tsc -w",
     "lint": "tsc --noEmit && eslint '*/**/*.{js,ts,jsx,tsx}' --fix",
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
@@ -81,7 +85,9 @@
     ]
   },
   "files": [
-    "dist/**/*"
+    "dist/**/*",
+    "bin/lemon-fields-types.mjs",
+    "bin/lib/fields-types.mjs"
   ],
   "engines": {
     "node": ">=24.0.0"
@@ -145,7 +151,8 @@
     "@aws-sdk/client-sns": "^3.1159.0",
     "@aws-sdk/client-sqs": "^3.1159.0",
     "@aws-sdk/client-sts": "^3.1159.0",
-    "@aws-sdk/credential-providers": "^3.1159.0"
+    "@aws-sdk/credential-providers": "^3.1159.0",
+    "typescript": ">=4.7"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-iam": {
@@ -171,6 +178,9 @@
     },
     "@aws-sdk/credential-providers": {
       "optional": true
+    },
+    "typescript": {
+      "optional": true
     }
   },
   "private": false,