lemon-core 4.3.0 → 5.0.0

package/dist/lib/http-fetch.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProxyBody = exports.isSuccessStatus = exports.asStatusError = exports.reparseBody = exports.sendRequest = exports.buildHeaders = exports.parseResponseText = exports.asFetchError = exports.toPayload = exports.isJsonBody = exports.DEFAULT_FETCH_TIMEOUT = void 0;
+/**
+ * `http-fetch.ts`
+ * - internal transport for the http proxy factories (`createSigV4Proxy`, `createHttpWebProxy`, `$X.createHttpSearchProxy`).
+ * - uses the Node built-in `fetch`, and keeps the contract of the former `request` based code (v4).
+ * - NOTE: internal only. do not export from `lib/index.ts` or any other barrel.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-27 initial version (v5 B2-a: `request` -> `fetch`)
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+const test_helper_1 = require("../common/test-helper");
+const lemon_error_1 = require("../common/lemon-error");
+//* v5 B5: default timeout of one request (ms) — under API Gateway 29 s and the 30 s Lambda timeout (SPEC § 6.6).
+exports.DEFAULT_FETCH_TIMEOUT = 25000;
+/** json mode rule of the factories: a string body goes plain, anything else as json */
+const isJsonBody = ($body) => typeof $body !== 'string';
+exports.isJsonBody = isJsonBody;
+/** serialize the body once: `null`/`undefined` → no body, json → `JSON.stringify`, string → as-is */
+const toPayload = ($body, json) => {
+    if ($body === null || $body === undefined)
+        return undefined;
+    return json ? JSON.stringify($body) : `${$body}`;
+};
+exports.toPayload = toPayload;
+/** turn a `fetch` failure into an Error whose message starts with the errno (ex: `ECONNREFUSED ...`) */
+const asFetchError = (e, timeout) => {
+    //* v5: `AbortSignal.timeout` rejects with `TimeoutError` (no `cause`) → errno-style `ETIMEDOUT timeout ...`.
+    if (e?.name === 'TimeoutError')
+        return new Error(`ETIMEDOUT timeout after ${timeout ?? exports.DEFAULT_FETCH_TIMEOUT} ms`);
+    const cause = e?.cause;
+    return new Error(`${cause?.code ?? 'FETCH_FAILED'} ${cause?.message ?? e?.message}`);
+};
+exports.asFetchError = asFetchError;
+/** parse response text like `request` did: json → try `JSON.parse` on any text (empty → `undefined`), else the text */
+const parseResponseText = (text, json) => {
+    if (!json)
+        return text;
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch (e) {
+        return text;
+    }
+};
+exports.parseResponseText = parseResponseText;
+/** build fetch headers: string values, last one wins case-insensitively, json defaults added if absent */
+const buildHeaders = (req) => {
+    const headers = new Headers();
+    // copy given headers, skipping empty values.
+    Object.entries(req.headers ?? {}).forEach(([key, val]) => {
+        if (val !== undefined && val !== null)
+            headers.set(key, `${val}`);
+    });
+    // json mode defaults, same as `request`: accept always, content-type only with a body.
+    if (req.json && !headers.has('accept'))
+        headers.set('accept', 'application/json');
+    if (req.json && req.payload !== undefined && !headers.has('content-type'))
+        headers.set('content-type', 'application/json');
+    return headers;
+};
+exports.buildHeaders = buildHeaders;
+/** send one request with `fetch`, and read the body. network errors (and timeout) are rethrown by `asFetchError()` */
+const sendRequest = async (req) => {
+    const method = `${req.method || 'GET'}`.toUpperCase();
+    // `fetch` cannot send a body with GET/HEAD (SigV4 also signs an empty body for GET).
+    const body = method === 'GET' || method === 'HEAD' ? undefined : req.payload;
+    //* v5: every request has a timeout (default 25 s, per-request `timeout`).
+    const timeout = req.timeout ?? exports.DEFAULT_FETCH_TIMEOUT;
+    try {
+        const signal = AbortSignal.timeout(timeout);
+        const res = await fetch(req.url, { method, headers: (0, exports.buildHeaders)(req), body, signal });
+        const text = await res.text();
+        return { statusCode: res.status, statusMessage: res.statusText, body: (0, exports.parseResponseText)(text, req.json) };
+    }
+    catch (e) {
+        throw (0, exports.asFetchError)(e, timeout);
+    }
+};
+exports.sendRequest = sendRequest;
+/** re-parse a string body that looks like a json object or array (kept from the v4 code) */
+const reparseBody = (body, logger) => {
+    try {
+        if (body && typeof body == 'string' && body.startsWith('{') && body.endsWith('}'))
+            return JSON.parse(body);
+        if (body && typeof body == 'string' && body.startsWith('[') && body.endsWith(']'))
+            return JSON.parse(body);
+    }
+    catch (e) {
+        logger?.err?.('!WARN! parse(body) =', e instanceof Error ? e : (0, test_helper_1.GETERR)(e));
+    }
+    return body;
+};
+exports.reparseBody = reparseBody;
+/** turn a non-success response into the v4 error message (400·404 and other formats) — v5: a `LemonError` with the peer status */
+const asStatusError = (res, logger) => {
+    const { statusCode, statusMessage, body } = res;
+    const msg = body ? (0, test_helper_1.GETERR)(body) : `${statusMessage || ''}`;
+    // 400·404: `<code> <TITLE> - <msg>`, unless the message is already `404 NOT FOUND ...`.
+    if (statusCode === 400 || statusCode === 404) {
+        const title = `${(statusCode == 404 ? '' : statusMessage) || 'NOT FOUND'}`.toUpperCase();
+        return (0, lemon_error_1.asLemonError)(statusCode, msg.startsWith('404 NOT FOUND') ? msg : `${statusCode} ${title} - ${msg}`, title);
+    }
+    statusMessage && logger?.log?.(`> statusMessage[${statusCode}] =`, statusMessage);
+    body && logger?.log?.(`> body[${statusCode}] =`, (0, test_helper_1.GETERR)(body));
+    //* v5: the message string is unchanged, the status is typed.
+    return (0, lemon_error_1.asLemonError)(statusCode, `${statusCode} ${statusMessage || 'FAILURE'} - ${msg}`, `${statusMessage || 'FAILURE'}`);
+};
+exports.asStatusError = asStatusError;
+/** v5: any 2xx is a success (B5 § 6.6) */
+const isSuccessStatus = (status) => status >= 200 && status < 300;
+exports.isSuccessStatus = isSuccessStatus;
+/** send a request and resolve the body: v5 success on any 2xx (204, or another 2xx with no body → `null`), other status codes reject */
+const fetchProxyBody = async (req, logger) => {
+    const res = await (0, exports.sendRequest)(req).catch((e) => {
+        logger?.err?.('>>>>> requested! err=', e);
+        throw e;
+    });
+    if (!(0, exports.isSuccessStatus)(res.statusCode))
+        throw (0, exports.asStatusError)(res, logger);
+    //* v5: a 2xx other than 200·201 with no body (ex: 204) → `null` (200·201 keep the v4 empty-body result).
+    const noBody = res.body === undefined || res.body === '';
+    if (noBody && res.statusCode !== 200 && res.statusCode !== 201)
+        return null;
+    return (0, exports.reparseBody)(res.body, logger);
+};
+exports.fetchProxyBody = fetchProxyBody;
+//# sourceMappingURL=http-fetch.js.map

package/dist/lib/http-fetch.js.map

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

package/dist/lib/lazy.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `lib/lazy.ts`
+ * - (internal) lazy singleton as a `Proxy`: nothing is built until the first trap.
+ * - not exported by the `lib` barrel.
+ *
+ * Why a Proxy (not a getter): the ESM wrapper reads every value export once at load
+ * (`export const X = cjs.X`). A getter would build the instance at that moment;
+ * reading a Proxy builds nothing.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-27 v5 B2-b (S-25)
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+/**
+ * make a lazy instance: `factory()` runs once, on the first trap, and every trap is then delegated.
+ * - traps: `get`, `has`, `ownKeys`, `getOwnPropertyDescriptor`, `getPrototypeOf`, `set`.
+ * - `instanceof` works via `getPrototypeOf`.
+ *
+ * @param factory   builds the real instance (called at most once)
+ */
+export declare const lazyInstance: <T extends object>(factory: () => T) => T;

package/dist/lib/lazy.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * `lib/lazy.ts`
+ * - (internal) lazy singleton as a `Proxy`: nothing is built until the first trap.
+ * - not exported by the `lib` barrel.
+ *
+ * Why a Proxy (not a getter): the ESM wrapper reads every value export once at load
+ * (`export const X = cjs.X`). A getter would build the instance at that moment;
+ * reading a Proxy builds nothing.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-27 v5 B2-b (S-25)
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lazyInstance = void 0;
+/**
+ * make a lazy instance: `factory()` runs once, on the first trap, and every trap is then delegated.
+ * - traps: `get`, `has`, `ownKeys`, `getOwnPropertyDescriptor`, `getPrototypeOf`, `set`.
+ * - `instanceof` works via `getPrototypeOf`.
+ *
+ * @param factory   builds the real instance (called at most once)
+ */
+const lazyInstance = (factory) => {
+    let instance = null;
+    // build once, then reuse.
+    const real = () => {
+        if (instance === null)
+            instance = factory();
+        return instance;
+    };
+    // the proxy target is an empty object; the real instance only lives in the closure.
+    const target = {};
+    return new Proxy(target, {
+        // read a property (own field, getter or method) from the real instance.
+        get: (_t, prop) => Reflect.get(real(), prop),
+        // `prop in proxy`.
+        has: (_t, prop) => Reflect.has(real(), prop),
+        // `Object.keys(proxy)` and friends.
+        ownKeys: () => Reflect.ownKeys(real()),
+        // descriptors must be configurable: the empty target does not hold the property (Proxy invariant).
+        getOwnPropertyDescriptor: (_t, prop) => {
+            const desc = Reflect.getOwnPropertyDescriptor(real(), prop);
+            return desc ? { ...desc, configurable: true } : undefined;
+        },
+        // the real prototype, so `proxy instanceof Class` is true.
+        getPrototypeOf: () => Reflect.getPrototypeOf(real()),
+        // write a property on the real instance.
+        set: (_t, prop, value) => Reflect.set(real(), prop, value),
+    });
+};
+exports.lazyInstance = lazyInstance;
+//# sourceMappingURL=lazy.js.map

package/dist/lib/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/lib/lazy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAmB,OAAgB,EAAK,EAAE;IAClE,IAAI,QAAQ,GAAM,IAAI,CAAC;IACvB,0BAA0B;IAC1B,MAAM,IAAI,GAAG,GAAM,EAAE;QACjB,IAAI,QAAQ,KAAK,IAAI;YAAE,QAAQ,GAAG,OAAO,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC;IACpB,CAAC,CAAC;IACF,oFAAoF;IACpF,MAAM,MAAM,GAAG,EAAO,CAAC;IACvB,OAAO,IAAI,KAAK,CAAI,MAAM,EAAE;QACxB,wEAAwE;QACxE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC;QAC5C,mBAAmB;QACnB,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC;QAC5C,oCAAoC;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,mGAAmG;QACnG,wBAAwB,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YACnC,MAAM,IAAI,GAAG,OAAO,CAAC,wBAAwB,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,CAAC;QACD,2DAA2D;QAC3D,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QACpD,yCAAyC;QACzC,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC;KAC7D,CAAC,CAAC;AACP,CAAC,CAAC;AA1BW,QAAA,YAAY,gBA0BvB"}

package/dist/lib/perf.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `lib/perf.ts`
+ * - (internal) performance checkpoint helpers for the `PERF` log lines (v5 B2-c, D40).
+ * - not exported by the `lib` barrel.
+ * - imports nothing from `engine/`: the caller passes its logger and namespace,
+ *   so `tools/` and other engine-free files can use it too.
+ *
+ * line format: `log(ns, '>', label, '<ms> ms')` with one decimal, e.g. `PERF: > lazy-load <package> 12.3 ms`.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-27 v5 B2-c (D40)
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+/** a logger like `_inf` or `$engine.inf`. */
+export type PerfLogger = (...args: any[]) => void;
+/**
+ * current monotonic time in ms (from `process.hrtime.bigint()`).
+ */
+export declare const nowMs: () => number;
+/**
+ * run `fn` and print one line with its elapsed ms; returns the result.
+ * - an exception is thrown as is, and no line is printed.
+ *
+ * @param log   logger (e.g. `_inf`)
+ * @param ns    namespace (e.g. `$U.NS('PERF', 'cyan')`)
+ * @param label checkpoint label (no values, no hosts)
+ * @param fn    the work to measure
+ */
+export declare const measure: <T>(log: PerfLogger, ns: string, label: string, fn: () => T) => T;
+/**
+ * the async version of `measure()`: the line is printed after `fn()` resolves.
+ * - a rejection is passed through, and no line is printed.
+ */
+export declare const measureAsync: <T>(log: PerfLogger, ns: string, label: string, fn: () => Promise<T>) => Promise<T>;

package/dist/lib/perf.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * `lib/perf.ts`
+ * - (internal) performance checkpoint helpers for the `PERF` log lines (v5 B2-c, D40).
+ * - not exported by the `lib` barrel.
+ * - imports nothing from `engine/`: the caller passes its logger and namespace,
+ *   so `tools/` and other engine-free files can use it too.
+ *
+ * line format: `log(ns, '>', label, '<ms> ms')` with one decimal, e.g. `PERF: > lazy-load <package> 12.3 ms`.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-27 v5 B2-c (D40)
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.measureAsync = exports.measure = exports.nowMs = void 0;
+/**
+ * current monotonic time in ms (from `process.hrtime.bigint()`).
+ */
+const nowMs = () => Number(process.hrtime.bigint()) / 1e6;
+exports.nowMs = nowMs;
+// format the elapsed ms with one decimal.
+const asMs = (t0) => `${((0, exports.nowMs)() - t0).toFixed(1)} ms`;
+/**
+ * run `fn` and print one line with its elapsed ms; returns the result.
+ * - an exception is thrown as is, and no line is printed.
+ *
+ * @param log   logger (e.g. `_inf`)
+ * @param ns    namespace (e.g. `$U.NS('PERF', 'cyan')`)
+ * @param label checkpoint label (no values, no hosts)
+ * @param fn    the work to measure
+ */
+const measure = (log, ns, label, fn) => {
+    const t0 = (0, exports.nowMs)();
+    const res = fn();
+    log(ns, '>', label, asMs(t0));
+    return res;
+};
+exports.measure = measure;
+/**
+ * the async version of `measure()`: the line is printed after `fn()` resolves.
+ * - a rejection is passed through, and no line is printed.
+ */
+const measureAsync = async (log, ns, label, fn) => {
+    const t0 = (0, exports.nowMs)();
+    const res = await fn();
+    log(ns, '>', label, asMs(t0));
+    return res;
+};
+exports.measureAsync = measureAsync;
+//# sourceMappingURL=perf.js.map

package/dist/lib/perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.js","sourceRoot":"","sources":["../../src/lib/perf.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAKH;;GAEG;AACI,MAAM,KAAK,GAAG,GAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC;AAA5D,QAAA,KAAK,SAAuD;AAEzE,0CAA0C;AAC1C,MAAM,IAAI,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,GAAG,CAAC,IAAA,aAAK,GAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAEvE;;;;;;;;GAQG;AACI,MAAM,OAAO,GAAG,CAAI,GAAe,EAAE,EAAU,EAAE,KAAa,EAAE,EAAW,EAAK,EAAE;IACrF,MAAM,EAAE,GAAG,IAAA,aAAK,GAAE,CAAC;IACnB,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB;AAEF;;;GAGG;AACI,MAAM,YAAY,GAAG,KAAK,EAAK,GAAe,EAAE,EAAU,EAAE,KAAa,EAAE,EAAoB,EAAc,EAAE;IAClH,MAAM,EAAE,GAAG,IAAA,aAAK,GAAE,CAAC;IACnB,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AALW,QAAA,YAAY,gBAKvB"}

package/dist/tools/tools.d.ts

@@ -1,6 +1,17 @@
 import { CrendentialForAWS } from '../environ';
-import { RuntimeConfigAwsCredentialIdentityProvider } from '@aws-sdk/types/dist-types/identity/AwsCredentialIdentity';
 import { LemonEngine } from '../engine/types';
+/**
+ * type: `AwsCredentialProvider`
+ * - the credentials provider (an async function) for the AWS SDK clients.
+ * - local structural type (v5 B2-c): no AWS SDK type in the published `.d.ts`.
+ * - not exported (no new root name); it shows in `.d.ts` through `AwsConfigParams.credentials`.
+ */
+type AwsCredentialProvider = (props?: Record<string, any>) => Promise<{
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+    expiration?: Date;
+}>;
 /**
  * Check if the current environment is AWS Lambda
  * @returns {boolean} - true if running in AWS Lambda environment
@@ -31,7 +42,7 @@ export interface AwsConfigParams {
     /** AWS profile */
     profile?: string;
     /** AWS credentials provider */
-    credentials?: RuntimeConfigAwsCredentialIdentityProvider;
+    credentials?: AwsCredentialProvider;
 }
 /**
  * load config for aws sdk
@@ -48,5 +59,6 @@ export interface AwsConfigParams {
 export declare const awsConfig: <T extends AwsConfigParams>($engine: LemonEngine, 
 /** params or region */
 params?: T | string | (() => string)) => T & {
-    credentials?: RuntimeConfigAwsCredentialIdentityProvider;
+    credentials?: AwsCredentialProvider;
 };
+export {};

package/dist/tools/tools.js

@@ -23,8 +23,24 @@ exports.awsConfig = exports.asyncCredentials = exports.loadDataYml = exports.loa
  */
 const fs_1 = __importDefault(require("fs"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
-const credential_providers_1 = require("@aws-sdk/credential-providers");
 const test_helper_1 = require("../common/test-helper");
+const perf_1 = require("../lib/perf");
+/**
+ * `@aws-sdk/credential-providers`, required on the first use (not at import; v5 B2-c, K6).
+ */
+let $credentialProviders = null;
+// memoized sync loader; prints `PERF > lazy-load ...` only when an engine logger is given (`awsConfig`).
+const loadCredentialProviders = ($engine) => {
+    if (!$credentialProviders) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const load = () => require('@aws-sdk/credential-providers');
+        $credentialProviders =
+            $engine?.inf && $engine?.U
+                ? (0, perf_1.measure)($engine.inf, $engine.U.NS('PERF', 'cyan'), 'lazy-load @aws-sdk/credential-providers', load)
+                : load();
+    }
+    return $credentialProviders;
+};
 /**
  * Check if the current environment is AWS Lambda
  * @returns {boolean} - true if running in AWS Lambda environment
@@ -66,7 +82,8 @@ exports.loadDataYml = loadDataYml;
  * @returns {Promise<CrendentialForAWS>} - AWS credentials
  */
 const asyncCredentials = async (profile) => {
-    const provider = (0, credential_providers_1.fromIni)({ profile });
+    //* no logger here: `PERF` is printed only when `awsConfig()` loads the package first.
+    const provider = loadCredentialProviders().fromIni({ profile });
     const $res = await provider();
     return { ...$res, profile };
 };
@@ -107,11 +124,11 @@ params) => {
     });
     if (typeof $conf.region === 'string' && !$conf.region)
         throw new Error(`.region[${$conf.region}] is invalid (empty) - ${errScope}`);
-    //! load the credentials provider(async function).
+    //! load the credentials provider(async function); the package is loaded only when a profile is set.
     const credentials = typeof $conf.credentials === 'function'
         ? $conf.credentials
         : $conf.profile
-            ? (0, credential_providers_1.fromIni)({ profile: $conf.profile })
+            ? loadCredentialProviders($engine).fromIni({ profile: $conf.profile })
             : undefined;
     return (0, test_helper_1.onlyDefined)({ ...$conf, credentials });
 };

package/dist/tools/tools.js.map

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

package/package.json

@@ -1,20 +1,58 @@
 {
   "name": "lemon-core",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "description": "Lemon Serverless Micro-Service Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/common/test-helper.d.ts",
+      "import": "./dist/esm/testing.mjs",
+      "require": "./dist/common/test-helper.js",
+      "default": "./dist/common/test-helper.js"
+    },
+    "./dist/environ": {
+      "types": "./dist/environ.d.ts",
+      "import": "./dist/environ.js",
+      "require": "./dist/environ.js",
+      "default": "./dist/environ.js"
+    },
+    "./dist/cores/lambda/lambda-web-handler": {
+      "types": "./dist/cores/lambda/lambda-web-handler.d.ts",
+      "import": "./dist/cores/lambda/lambda-web-handler.js",
+      "require": "./dist/cores/lambda/lambda-web-handler.js",
+      "default": "./dist/cores/lambda/lambda-web-handler.js"
+    },
+    "./dist/extended/cores": {
+      "types": "./dist/extended/cores/index.d.ts",
+      "import": "./dist/extended/cores/index.js",
+      "require": "./dist/extended/cores/index.js",
+      "default": "./dist/extended/cores/index.js"
+    },
+    "./dist/*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "require": "./dist/*.js",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
-    "build": "npm run fields:gen && npm run build-ts",
+    "build": "npm run build-ts && node scripts/gen-esm-wrapper.cjs",
     "build-ts": "tsc -v && tsc",
-    "fields:migrate": "lemon-fields migrate --report --update-tsconfig",
-    "fields:gen": "lemon-fields gen --report",
-    "fields:check": "lemon-fields --check",
-    "fields:guard-common": "lemon-fields guard-common --report",
+    "!v5": "------- v5 packaging gates -----",
+    "esm:smoke": "LS=1 node scripts/esm-smoke.mjs",
+    "api:names": "node scripts/api-names.cjs --out -",
+    "api:check": "node scripts/api-check.cjs",
+    "dup:check": "node scripts/dup-decls.cjs",
+    "l1l2:probe": "node scripts/l1l2-probe.cjs",
     "watch-ts": "tsc -w",
-    "doc": "npm run doc:html && open dist/docs/index.html",
-    "doc:html": "typedoc src/ --exclude **/*.spec.ts --out dist/docs",
-    "doc:publish": "npm run doc:html && gh-pages -m \"docs(gh-pages): publish gh-pages via typedoc\" -d dist/docs",
     "lint": "tsc --noEmit && eslint '*/**/*.{js,ts,jsx,tsx}' --fix",
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
     "!test": "------- run self-test with vitest -----",
@@ -22,7 +60,7 @@
     "test.lemon": "ENV=lemon npm run test",
     "test:dev": "LS=1 vitest",
     "!test:watch": "---- custom test with profile -----",
-    "test:watch": "lemon-fields guard-common && LS=1 vitest",
+    "test:watch": "LS=1 vitest",
     "test:watch.lemon": "ENV=lemon npm run test:watch",
     "!prepare": "------- run self-test with vitest -----",
     "prepare": "npm run build",
@@ -52,72 +90,91 @@
   "license": "MIT",
   "dependencies": {
     "@aws-sdk/client-dynamodb": "^3.971.0",
-    "@aws-sdk/client-dynamodb-streams": "^3.971.0",
-    "@aws-sdk/client-iam": "^3.971.0",
-    "@aws-sdk/client-kms": "^3.971.0",
-    "@aws-sdk/client-lambda": "^3.971.0",
-    "@aws-sdk/client-s3": "^3.971.0",
-    "@aws-sdk/client-sns": "^3.971.0",
-    "@aws-sdk/client-sqs": "^3.971.0",
-    "@aws-sdk/client-sts": "^3.971.0",
-    "@aws-sdk/credential-providers": "^3.971.0",
     "@aws-sdk/lib-dynamodb": "^3.971.0",
-    "@elastic/elasticsearch": "7.12",
+    "@opensearch-project/opensearch": "^3.9.0",
     "@types/aws-lambda": "^8.10.62",
-    "@types/ioredis": "^4.28.10",
     "@types/jsonwebtoken": "^8.5.9",
     "async": "^3.2.4",
     "crypto-js": "^4.2.0",
-    "ioredis": "^5.2.3",
     "js-yaml": "^4.1.1",
     "jsonwebtoken": "^9.0.3",
-    "lemon-model": "^1.1.1",
-    "lodash": "^4.17.21",
-    "memcached": "^2.2.2",
+    "lemon-model": "^5.0.0",
     "mime-types": "^3.0.2",
     "node-cache": "^5.1.2",
     "qs": "^6.15.1",
     "query-string": "^7.1.3",
-    "request": "^2.88.2",
     "source-map-support": "^0.5.21",
     "uuid": "^9.0.1"
   },
   "devDependencies": {
-    "@aws-sdk/types": "^3.972.0",
-    "@smithy/util-stream": "^3.3.4",
+    "@aws-sdk/client-iam": "^3.971.0",
+    "@aws-sdk/client-kms": "^3.971.0",
+    "@aws-sdk/client-lambda": "^3.971.0",
+    "@aws-sdk/client-s3": "^3.971.0",
+    "@aws-sdk/client-sns": "^3.971.0",
+    "@aws-sdk/client-sqs": "^3.971.0",
+    "@aws-sdk/client-sts": "^3.971.0",
+    "@aws-sdk/credential-providers": "^3.971.0",
     "@types/async": "^3.2.15",
     "@types/crypto-js": "^4.2.2",
     "@types/js-yaml": "^3.12.5",
-    "@types/lodash": "^4.17.16",
-    "@types/memcached": "^2.2.6",
     "@types/mime-types": "^2.1.0",
     "@types/node": "^24.12.2",
     "@types/qs": "^6.14.0",
-    "@types/request": "^2.48.8",
     "@types/supertest": "^2.0.10",
     "@types/uuid": "^8.3.4",
     "@typescript-eslint/eslint-plugin": "^5.15.0",
     "@typescript-eslint/parser": "^5.15.0",
     "@vitest/coverage-v8": "^4.1.4",
-    "codecov": "^3.7.2",
     "concurrently": "^5.3.0",
-    "dotenv": "^8.2.0",
     "eslint": "^8.23.1",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-prettier": "^4.0.0",
     "faker": "^4.1.0",
-    "gh-pages": "^5.0.0",
-    "husky": "^8.0.3",
-    "lemon-devkit": "^0.0.11",
+    "lemon-devkit": "^0.2.1",
     "lint-staged": "^13.1.0",
     "prettier": "^2.7.1",
-    "superagent": "^5.3.1",
-    "supertest": "^4.0.2",
+    "supertest": "^7.3.1",
     "ts-node": "^8.10.2",
-    "typedoc": "^0.28.19",
     "typescript": "^5.9.3",
     "vitest": "^4.1.4"
   },
+  "peerDependencies": {
+    "@aws-sdk/client-iam": "^3.971.0",
+    "@aws-sdk/client-kms": "^3.971.0",
+    "@aws-sdk/client-lambda": "^3.971.0",
+    "@aws-sdk/client-s3": "^3.971.0",
+    "@aws-sdk/client-sns": "^3.971.0",
+    "@aws-sdk/client-sqs": "^3.971.0",
+    "@aws-sdk/client-sts": "^3.971.0",
+    "@aws-sdk/credential-providers": "^3.971.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-iam": {
+      "optional": true
+    },
+    "@aws-sdk/client-kms": {
+      "optional": true
+    },
+    "@aws-sdk/client-lambda": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/client-sns": {
+      "optional": true
+    },
+    "@aws-sdk/client-sqs": {
+      "optional": true
+    },
+    "@aws-sdk/client-sts": {
+      "optional": true
+    },
+    "@aws-sdk/credential-providers": {
+      "optional": true
+    }
+  },
   "private": false,
   "repository": {
     "type": "git",