lemon-core 4.2.7 → 5.0.0

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.2.7",
+  "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",

package/dist/cores/storage/redis-storage-service.d.ts

@@ -1,183 +0,0 @@
-/**
- * `redis-storage-services.ts`
- * - storage implementation on redis backend
- *
- * @author      Tim Hong <tim@lemoncloud.io>
- * @date        2020-12-08 initial version
- *
- * @copyright   (C) lemoncloud.io 2020 - All Rights Reserved.
- */
-import { Redis } from 'ioredis';
-import { StorageService, StorageModel } from './storage-service';
-/** ********************************************************************************************************************
- *  Exported Types
- ** ********************************************************************************************************************/
-/**
- * type `RedisOptions`
- */
-export interface RedisOptions {
-    /**
-     * (optional) cache server endpoint
-     */
-    endpoint?: string;
-    /**
-     * (optional) virtual table name used as key prefix
-     */
-    tableName: string | number;
-    /**
-     * (optional) default time to live of a model in seconds. 0 for unlimited (default: 0)
-     */
-    defTimeout?: number;
-}
-/** ********************************************************************************************************************
- *  Exported Class
- ** ********************************************************************************************************************/
-/**
- * class `RedisStorageService`
- */
-export declare class RedisStorageService<T extends StorageModel> implements StorageService<T> {
-    /**
-     * Environment variable name for redis server endpoint
-     * @static
-     */
-    static readonly ENV_REDIS_ENDPOINT = "MY_REDIS_ENDPOINT";
-    /**
-     * Maximum retry count of check-and-save behavior
-     * @static
-     */
-    static readonly CAS_MAX_RETRIES = 5;
-    /**
-     * ioredis client
-     * @protected
-     */
-    protected readonly redis: Redis;
-    /**
-     * Virtual table name
-     * @private
-     */
-    readonly tableName: string;
-    /**
-     * Default time to live of a model
-     * @private
-     */
-    readonly ttl: number;
-    /**
-     * Public constructor
-     *
-     * @options redis options
-     */
-    constructor(options: RedisOptions);
-    /**
-     * Say hello
-     */
-    hello(): string;
-    /**
-     * Disconnect from redis
-     */
-    quit(): Promise<void>;
-    /**
-     * Read model by id
-     *
-     * @param id
-     */
-    read(id: string): Promise<T>;
-    /**
-     * Read model or create if id does not exist
-     *
-     * @param id
-     * @param model
-     */
-    readOrCreate(id: string, model: T): Promise<T>;
-    /**
-     * Create model and overwrite if id exists
-     *
-     * @param id
-     * @param model
-     */
-    save(id: string, model: T): Promise<T>;
-    /**
-     * Update existing model and create if id does not exist
-     * @param id
-     * @param update    model to update
-     * @param increment (optional) model to increment
-     */
-    update(id: string, update: T, increment?: T): Promise<T>;
-    /**
-     * Increment the integer value of a key
-     *
-     * @param id
-     * @param increment model to increment
-     * @param update    (optional) model to update
-     */
-    increment(id: string, increment: T, update?: T): Promise<T>;
-    /**
-     * Delete a key
-     *
-     * @param id
-     * @return  true on success
-     */
-    delete(id: string): Promise<T>;
-    /**
-     * Get redis key from id
-     * @param id
-     * @protected
-     */
-    asKey(id: string): string;
-    /**
-     * Serialize model into internal data
-     * @param model
-     * @protected
-     */
-    serialize(model: T): Record<string, string>;
-    /**
-     * Deserialize internal data into model
-     * @param data
-     * @protected
-     */
-    deserialize(data: Record<string, string>): T;
-    /**
-     * Update key w/ check-and-save behavior and retries
-     * @param id
-     * @param update    (optional) model to update
-     * @param increment (optional) model to increment
-     * @private
-     */
-    private updateCAS;
-    /**
-     * Prepare new model - original model + update + increment
-     * @param orig
-     * @param update
-     * @param increment
-     * @private
-     */
-    private prepareUpdatedModel;
-    /**
-     * Check transaction results and throw if error occurred
-     * @param results   transaction pipeline execution results
-     * @private
-     */
-    private static throwIfTransactionError;
-}
-/**
- * class `DummyRedisStorageService`
- *  - Use local redis server and non-default logical database
- */
-export declare class DummyRedisStorageService<T extends StorageModel> extends RedisStorageService<T> {
-    /**
-     * Database index. Each DummyRedisStorageService uses different logical database.
-     * @private
-     */
-    private static dbIndex;
-    /**
-     * Public constructor
-     */
-    constructor();
-    /**
-     * Say hello
-     */
-    hello(): string;
-    /**
-     * Delete all data in database
-     */
-    truncate(): Promise<void>;
-}