lemon-model 5.0.0 → 5.0.2

package/README.md

@@ -147,6 +147,7 @@ See [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md)
 
 | Version   | Description
 |--         |--
+| 5.0.2     | (Unreleased) v5 B15: `NextIdentity.cid?`, `NextIdentity.aid?`; `NextContext.accountId` doc (receiving service's own account); `channel`/`trace` bundle label B13 -> B14.
 | 1.0.6     | optimized `SearchBody` with `knn` support.
 | 1.0.5     | optimized `NextIdentity` with `authorization`.
 | 1.0.4     | optimized `NextIdentity` with `referer` and `origin`.

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

@@ -10,6 +10,8 @@
  * @date        2024-12-20 optimized `NextIdentityCognito`
  * @date        2025-05-13 optimized `NextContext` with `Authorization` header
  * @date        2025-06-12 optimized `SearchBody` with `knn` support
+ * @date        2026-10-30 v5 B14: `NextContext.channel` and `NextContext.trace` (`NextTrace`).
+ * @date        2026-10-30 v5 B15: `NextIdentity.cid` and `NextIdentity.aid`.
  *
  * @copyright   (C) lemoncloud.io 2019 - All Rights Reserved.
  */

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

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

package/dist/types/core-types.d.ts

@@ -10,6 +10,8 @@
  * @date        2024-12-20 optimized `NextIdentityCognito`
  * @date        2025-05-13 optimized `NextContext` with `Authorization` header
  * @date        2025-06-12 optimized `SearchBody` with `knn` support
+ * @date        2026-10-30 v5 B14: `NextContext.channel` and `NextContext.trace` (`NextTrace`).
+ * @date        2026-10-30 v5 B15: `NextIdentity.cid` and `NextIdentity.aid`.
  *
  * @copyright   (C) lemoncloud.io 2019 - All Rights Reserved.
  */
@@ -82,6 +84,17 @@ export interface NextIdentity<T = any> {
      * @since ver2.2.3 2020/JUL/15
      */
     lang?: string;
+    /**
+     * (optional) cloud-id: the AWS account number of the cloud the identity belongs to (v5 B15).
+     * - empty means the same cloud as the receiving service.
+     * - a value different from the receiver's `NextContext.accountId` marks a cross-cloud request.
+     */
+    cid?: string;
+    /**
+     * (optional) auth-id: the id of the authentication record (`AuthModel`) behind this identity (v5 B15).
+     * - not an account id.
+     */
+    aid?: string;
     /**
      * (optional) internal last-error message
      * - if this is not empty, then DO NOT use this object.
@@ -224,7 +237,8 @@ export interface NextContext<T extends NextIdentity = NextIdentity> {
      */
     requestId?: string;
     /**
-     * id of aws account number from initial request. (ex: `085403634746` for lemon profile)
+     * id of the aws account number of the receiving service itself (from `invokedFunctionArn`).
+     * - not the account of the initial request (since lemon-core 5.0.6, v5 B14).
      */
     accountId?: string;
     /**
@@ -253,6 +267,43 @@ export interface NextContext<T extends NextIdentity = NextIdentity> {
      * calling depth for every handler. ( automatically increased from lambda-handler )
      */
     depth?: number;
+    /**
+     * (optional) the channel of this request, set once by the receiving entry (v5 B14).
+     * - `external`: a web request with a `host` header (API Gateway, ALB, Function URL).
+     * - `internal`: a host-less web event (direct invoke) or a protocol call (relay, SNS, SQS).
+     * - `local`: the local express harness (local mode).
+     */
+    channel?: 'external' | 'internal' | 'local';
+    /**
+     * (optional) the trace of the call chain, set by the receiving entry (v5 B14).
+     */
+    trace?: NextTrace;
+}
+/**
+ * type: `NextTrace`
+ * - the trace of a call chain across internal hops (v5 B14).
+ */
+export interface NextTrace {
+    /**
+     * trace id: the requestId of the first entry of the chain.
+     */
+    tid: string;
+    /**
+     * hop count from the first entry (the first entry is `0`).
+     */
+    hop: number;
+    /**
+     * (optional) service uri of the direct caller (the previous hop).
+     */
+    via?: string;
+    /**
+     * (optional) requestId of the direct caller (the previous hop).
+     */
+    pid?: string;
+    /**
+     * (optional) the first request path uri of the chain (like `context.source`).
+     */
+    src?: string;
 }
 /**
  * type: `NextHandler`

package/dist/types/core-types.js

@@ -11,6 +11,8 @@
  * @date        2024-12-20 optimized `NextIdentityCognito`
  * @date        2025-05-13 optimized `NextContext` with `Authorization` header
  * @date        2025-06-12 optimized `SearchBody` with `knn` support
+ * @date        2026-10-30 v5 B14: `NextContext.channel` and `NextContext.trace` (`NextTrace`).
+ * @date        2026-10-30 v5 B15: `NextIdentity.cid` and `NextIdentity.aid`.
  *
  * @copyright   (C) lemoncloud.io 2019 - All Rights Reserved.
  */

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lemon-model",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "Common shared model definitions for Lemon Micro-Service Platform",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",