lemon-core 5.0.5 → 5.0.7

package/dist/cores/protocol/protocol-relay.js

@@ -0,0 +1,339 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accountOfArn = exports.logTrace = exports.traceLine = exports.warnJsonIdentity = exports.acceptLegacy = exports.nextHopContext = exports.entryTrace = exports.entryChannel = exports.asRelayContext = exports.decodeRelay = exports.encodeRelay = exports.buildRelay = exports.relayIdentityOf = exports.assertHop = exports.readMaxHop = exports.readLegacyAccept = exports.readLegacySend = exports.traceIdOf = exports.SAFE_TRACE_ID = exports.DEFAULT_MAX_HOP = exports.PROTOCOL_MAX_HOP = exports.PROTOCOL_LEGACY_ACCEPT = exports.PROTOCOL_LEGACY_CONTEXT = exports.RELAY_IDENTITY_FIELDS = exports.RELAY_MAX_BYTES = exports.RELAY_PREFIX = exports.RELAY_PARAM = exports.HEADER_LEMON_RELAY = void 0;
+/**
+ * `cores/protocol/protocol-relay.ts`
+ * - v5 B14: the relay envelope of an internal hop — a whitelisted identity and the trace, nothing else.
+ * - web: header `x-lemon-relay`. SNS/SQS: the `relay` field of the protocol param (no `context` field).
+ * - value `r1.<base64url(JSON)>`, JSON keys `idt tid hop src via pid iat`. signed by the existing signature
+ *   (web: the relay string in the context slot of the canonical; SNS/SQS: the message signature).
+ * - the legacy `x-protocol-context` (full context) is deprecated: `PROTOCOL_LEGACY_CONTEXT` (send) and
+ *   `PROTOCOL_LEGACY_ACCEPT` (receive) decide whether it is sent and accepted. removal in v6.
+ * - hop cap `PROTOCOL_MAX_HOP` (default 8): `508 LOOP DETECTED - protocol hop <n>` on send and on receive.
+ * - NOTE: deep module only (`./dist/cores/protocol/protocol-relay`). not re-exported by the root.
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-30 initial version (v5 B14)
+ * @date        2026-10-30 a safe trace id (`SAFE_TRACE_ID`), and `nextHopContext()` for an in-process (same-service) callback.
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+const crypto_1 = require("crypto");
+const url_1 = __importDefault(require("url"));
+const engine_1 = require("../../engine/");
+const protocol_sign_1 = require("./protocol-sign");
+Object.defineProperty(exports, "HEADER_LEMON_RELAY", { enumerable: true, get: function () { return protocol_sign_1.HEADER_LEMON_RELAY; } });
+const NS = engine_1.$U.NS('PRTS', 'yellow'); // NAMESPACE TO BE PRINTED.
+/** field name of the relay in the SNS/SQS protocol param */
+exports.RELAY_PARAM = 'relay';
+/** prefix (format version) of the relay value */
+exports.RELAY_PREFIX = 'r1.';
+/** max bytes of a relay value (the receiver rejects a larger one) */
+exports.RELAY_MAX_BYTES = 4096;
+/** identity fields that cross a hop (whitelist). nothing else of `NextIdentity` is relayed */
+exports.RELAY_IDENTITY_FIELDS = ['sid', 'uid', 'gid', 'roles', 'identityId', 'lang'];
+/** env name of the send mode of the legacy context (`off` | `send`) */
+exports.PROTOCOL_LEGACY_CONTEXT = 'PROTOCOL_LEGACY_CONTEXT';
+/** env name of the receive mode of the legacy context (`accept` | `warn` | `reject`) */
+exports.PROTOCOL_LEGACY_ACCEPT = 'PROTOCOL_LEGACY_ACCEPT';
+/** env name of the hop cap */
+exports.PROTOCOL_MAX_HOP = 'PROTOCOL_MAX_HOP';
+/** default hop cap */
+exports.DEFAULT_MAX_HOP = 8;
+/** a requestId used as a trace id as is (else a new uuid): the local express id `YYYY-MM-DD hh:mm:ss.SSS` is not */
+exports.SAFE_TRACE_ID = /^[\w.:-]{1,128}$/;
+/** the requestId as a trace id if it is a safe token, else a new uuid (unique, no whitespace) */
+const traceIdOf = (requestId) => typeof requestId === 'string' && exports.SAFE_TRACE_ID.test(requestId) ? requestId : (0, crypto_1.randomUUID)();
+exports.traceIdOf = traceIdOf;
+//* the relay keys in the order they are written.
+const RELAY_KEYS = ['idt', 'tid', 'hop', 'src', 'via', 'pid', 'iat'];
+//* max length of a string field of the relay.
+const MAX_TEXT = 2048;
+/** read the send mode of the legacy context (default `off`) */
+const readLegacySend = () => `${(0, protocol_sign_1.readConfig)(exports.PROTOCOL_LEGACY_CONTEXT) ?? ''}`.trim().toLowerCase() === 'send' ? 'send' : 'off';
+exports.readLegacySend = readLegacySend;
+/** read the receive mode of the legacy context (default `warn`) */
+const readLegacyAccept = () => {
+    const mode = `${(0, protocol_sign_1.readConfig)(exports.PROTOCOL_LEGACY_ACCEPT) ?? ''}`.trim().toLowerCase();
+    return mode === 'accept' || mode === 'reject' ? mode : 'warn';
+};
+exports.readLegacyAccept = readLegacyAccept;
+/** read the hop cap (a positive integer, default 8) */
+const readMaxHop = () => {
+    const n = Number(`${(0, protocol_sign_1.readConfig)(exports.PROTOCOL_MAX_HOP) ?? ''}`.trim() || NaN);
+    return Number.isInteger(n) && n > 0 ? n : exports.DEFAULT_MAX_HOP;
+};
+exports.readMaxHop = readMaxHop;
+/** throw `508 LOOP DETECTED` if the hop is over the cap */
+const assertHop = (hop, max = (0, exports.readMaxHop)()) => {
+    if (hop > max)
+        throw new Error(`508 LOOP DETECTED - protocol hop ${hop}`);
+};
+exports.assertHop = assertHop;
+/** the whitelisted identity of a context (`undefined` if nothing to relay) */
+const relayIdentityOf = (identity) => {
+    if (!identity || typeof identity !== 'object')
+        return undefined;
+    const idt = {};
+    const src = identity;
+    //* copy only the whitelisted fields of the right type.
+    exports.RELAY_IDENTITY_FIELDS.forEach(k => {
+        const v = src[k];
+        if (k === 'roles') {
+            if (Array.isArray(v))
+                idt.roles = v.filter(r => typeof r === 'string');
+        }
+        else if (typeof v === 'string')
+            idt[k] = v;
+    });
+    return Object.keys(idt).length ? idt : undefined;
+};
+exports.relayIdentityOf = relayIdentityOf;
+/**
+ * build the relay of the next hop from the caller context.
+ * - `tid` = caller `trace.tid`, else `requestId`, else a new id. `hop` = caller `trace.hop` + 1.
+ * - `src` = caller `trace.src`, else `source`. `pid` = caller `requestId`. `via` = the caller's service uri.
+ * - throws `508 LOOP DETECTED` if the next hop is over the cap (before any send).
+ *
+ * @param context   the caller context
+ * @param options   `via` (caller uri), `now` (ms, for tests), `max` (hop cap)
+ */
+const buildRelay = (context, options) => {
+    const trace = context?.trace;
+    const hop = (Number.isInteger(trace?.hop) && trace.hop >= 0 ? trace.hop : 0) + 1;
+    (0, exports.assertHop)(hop, options?.max);
+    const text = (v) => (typeof v === 'string' && v ? v : undefined);
+    const relay = {
+        idt: (0, exports.relayIdentityOf)(context?.identity),
+        tid: text(trace?.tid) ?? (0, exports.traceIdOf)(context?.requestId),
+        hop,
+        src: text(trace?.src) ?? text(context?.source),
+        via: text(options?.via),
+        pid: text(context?.requestId),
+        iat: Math.floor((options?.now ?? Date.now()) / 1000),
+    };
+    //* drop empty keys (smaller value, stable shape).
+    return RELAY_KEYS.reduce((R, k) => {
+        if (relay[k] !== undefined)
+            R[k] = relay[k];
+        return R;
+    }, {});
+};
+exports.buildRelay = buildRelay;
+/** encode a relay as `r1.<base64url(JSON)>` */
+const encodeRelay = (relay) => `${exports.RELAY_PREFIX}${Buffer.from(JSON.stringify(relay), 'utf8').toString('base64url')}`;
+exports.encodeRelay = encodeRelay;
+//* the error of a bad relay.
+const invalid = (reason) => new Error(`400 INVALID CONTEXT - relay ${reason}`);
+/**
+ * decode and validate a relay value (shape, types, size). unknown keys and non-whitelisted identity keys are dropped.
+ * - throws `400 INVALID CONTEXT - relay <reason>` (`format`, `size`, `json`, `shape`, or the bad key).
+ */
+const decodeRelay = (text) => {
+    if (typeof text !== 'string' || !text.startsWith(exports.RELAY_PREFIX))
+        throw invalid('format');
+    if (Buffer.byteLength(text, 'utf8') > exports.RELAY_MAX_BYTES)
+        throw invalid('size');
+    //* base64url → JSON.
+    const data = (() => {
+        try {
+            return JSON.parse(Buffer.from(text.substring(exports.RELAY_PREFIX.length), 'base64url').toString('utf8'));
+        }
+        catch (e) {
+            throw invalid('json');
+        }
+    })();
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        throw invalid('shape');
+    //* string fields: optional, bounded.
+    const str = (k, required) => {
+        const v = data[k];
+        if (v === undefined && !required)
+            return undefined;
+        if (typeof v !== 'string' || (required && !v) || v.length > MAX_TEXT)
+            throw invalid(k);
+        return v;
+    };
+    const relay = { tid: str('tid', true), hop: data.hop };
+    if (!Number.isInteger(data.hop) || data.hop < 0)
+        throw invalid('hop');
+    if (data.idt !== undefined)
+        relay.idt = decodeIdentity(data.idt);
+    ['src', 'via', 'pid'].forEach(k => {
+        const v = str(k);
+        if (v !== undefined)
+            relay[k] = v;
+    });
+    if (data.iat !== undefined) {
+        if (typeof data.iat !== 'number' || !Number.isFinite(data.iat))
+            throw invalid('iat');
+        relay.iat = data.iat;
+    }
+    //* the key order of the encoder (so a decoded relay equals the built one).
+    return RELAY_KEYS.reduce((R, k) => {
+        if (relay[k] !== undefined)
+            R[k] = relay[k];
+        return R;
+    }, {});
+};
+exports.decodeRelay = decodeRelay;
+//* validate the `idt` of a relay (whitelisted keys only, typed).
+const decodeIdentity = (idt) => {
+    if (!idt || typeof idt !== 'object' || Array.isArray(idt))
+        throw invalid('idt');
+    const res = {};
+    exports.RELAY_IDENTITY_FIELDS.forEach(k => {
+        const v = idt[k];
+        if (v === undefined || v === null)
+            return;
+        if (k === 'roles') {
+            if (!Array.isArray(v) || v.some(r => typeof r !== 'string'))
+                throw invalid('idt.roles');
+            res.roles = [...v];
+        }
+        else {
+            if (typeof v !== 'string' || v.length > MAX_TEXT)
+                throw invalid(`idt.${k}`);
+            res[k] = v;
+        }
+    });
+    return res;
+};
+/**
+ * the receiver context of a relay (B14 D2 table).
+ * - `identity` = `idt`, `channel` = `internal`, `depth` = `hop`, `source` = `src`, `trace` = `{ tid, hop, via, pid, src }`.
+ * - `requestId`, `accountId` = the receiver's own values (`own`). nothing else of the caller crosses the hop.
+ */
+const asRelayContext = (relay, own) => {
+    const trace = { tid: relay.tid, hop: relay.hop };
+    if (relay.via !== undefined)
+        trace.via = relay.via;
+    if (relay.pid !== undefined)
+        trace.pid = relay.pid;
+    if (relay.src !== undefined)
+        trace.src = relay.src;
+    const context = {
+        identity: { ...(relay.idt || {}) },
+        channel: 'internal',
+        depth: relay.hop,
+        source: relay.src,
+        trace,
+        requestId: own?.requestId,
+        accountId: own?.accountId,
+    };
+    //* drop the undefined keys.
+    return Object.entries(context).reduce((M, [k, v]) => {
+        if (v !== undefined)
+            M[k] = v;
+        return M;
+    }, {});
+};
+exports.asRelayContext = asRelayContext;
+/** the channel of an entry without a protocol context: local mode wins, else `host` → `external`, else `internal` */
+const entryChannel = (hasHost) => engine_1.$U.isLocalMode() ? 'local' : hasHost ? 'external' : 'internal';
+exports.entryChannel = entryChannel;
+/** the trace of an entry without a relay: `{ tid: requestId, hop: 0 }` (a new tid if the requestId is not a safe id) */
+const entryTrace = (context) => ({
+    tid: (0, exports.traceIdOf)(context?.requestId),
+    hop: 0,
+});
+exports.entryTrace = entryTrace;
+/**
+ * the context of an in-process next hop (a same-service callback): the same rules as a relay hop.
+ * - `trace.hop` + 1 (cap → `508 LOOP DETECTED`), the same `tid`/`src`, `via` = this service, `pid` = this requestId.
+ * - `depth` = the new hop (kept in sync for v4-style code). the other fields of the context are kept.
+ *
+ * @param context   the current receiver context (copied, not changed)
+ * @param via       this service's uri
+ */
+const nextHopContext = (context, via) => {
+    const trace = context?.trace;
+    const hop = (Number.isInteger(trace?.hop) && trace.hop >= 0 ? trace.hop : 0) + 1;
+    (0, exports.assertHop)(hop);
+    const next = { tid: trace?.tid || (0, exports.traceIdOf)(context?.requestId), hop };
+    if (via)
+        next.via = via;
+    if (context?.requestId)
+        next.pid = context.requestId;
+    const src = trace?.src ?? context?.source;
+    if (src)
+        next.src = src;
+    return { ...context, depth: hop, trace: next };
+};
+exports.nextHopContext = nextHopContext;
+/**
+ * apply `PROTOCOL_LEGACY_ACCEPT` to a legacy context (`x-protocol-context` or the SNS/SQS `context` field).
+ * - `reject`: throws `400 INVALID CONTEXT - legacy context rejected`. `warn`: one line. `accept`: nothing.
+ *
+ * @param transport `web` | `sns` | `sqs` (for the log line)
+ * @param legacy    the legacy context (for the log line: the service of its `source`)
+ */
+const acceptLegacy = (transport, legacy) => {
+    const mode = (0, exports.readLegacyAccept)();
+    if (mode === 'reject')
+        throw new Error(`400 INVALID CONTEXT - legacy context rejected`);
+    if (mode === 'warn')
+        (0, engine_1._inf)(NS, `PROTOCOL deprecated x-protocol-context ${hostOf(legacy?.source)} (${transport})`);
+};
+exports.acceptLegacy = acceptLegacy;
+/** one `PROTOCOL deprecated json identity (<transport>)` line (not in `accept`). the behaviour is unchanged */
+const warnJsonIdentity = (transport) => {
+    if ((0, exports.readLegacyAccept)() !== 'accept')
+        (0, engine_1._inf)(NS, `PROTOCOL deprecated json identity (${transport})`);
+};
+exports.warnJsonIdentity = warnJsonIdentity;
+//* a log token: no whitespace, bounded (a relay value cannot break the line).
+const token = (v) => {
+    const s = `${v ?? ''}`.replace(/\s/g, '_').substring(0, 128);
+    return s || '-';
+};
+//* the host (service) of a protocol uri, without the account and the version ('-' if none).
+const hostOf = (uri) => {
+    try {
+        return token(uri ? url_1.default.parse(uri).hostname : '');
+    }
+    catch (e) {
+        return '-';
+    }
+};
+//* the path of a protocol uri ('-' if none).
+const pathOf = (uri) => {
+    try {
+        const path = uri ? url_1.default.parse(uri).pathname : '';
+        return token(path && path !== '/' ? path : '');
+    }
+    catch (e) {
+        return '-';
+    }
+};
+/**
+ * the `TRACE` line of an entry: `TRACE tid=<tid> hop=<hop> ch=<channel> via=<service|-> src=<path|->`.
+ * - no identity value, no account (the via host and the src path only).
+ */
+const traceLine = (context) => {
+    const trace = context?.trace;
+    const src = trace?.src ?? context?.source;
+    return [
+        `TRACE tid=${token(trace?.tid)}`,
+        `hop=${token(trace?.hop)}`,
+        `ch=${token(context?.channel)}`,
+        `via=${hostOf(trace?.via)}`,
+        `src=${pathOf(src)}`,
+    ].join(' ');
+};
+exports.traceLine = traceLine;
+/** print the `TRACE` line of an entry (one per web entry and per protocol receive) */
+const logTrace = (context) => {
+    (0, engine_1._inf)(NS, (0, exports.traceLine)(context));
+};
+exports.logTrace = logTrace;
+/** the account id (12 digits) of an ARN, or '' */
+const accountOfArn = (arn) => {
+    const id = `${arn || ''}`.split(':')[4] || '';
+    return /^\d{12}$/.test(id) ? id : '';
+};
+exports.accountOfArn = accountOfArn;
+//# sourceMappingURL=protocol-relay.js.map

package/dist/cores/protocol/protocol-relay.js.map

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

package/dist/cores/protocol/protocol-service.d.ts

@@ -15,6 +15,7 @@ interface MyMessageAttributeValue {
  * header name to exchange `next-context`
  * ONLY for internal communication.
  * - v5 B10-3: defined in `protocol-sign.ts`, re-exported here (same name, same value).
+ * - v5 B14: deprecated (see the definition) — the relay `x-lemon-relay` replaces it; removal in v6.
  */
 export { HEADER_PROTOCOL_CONTEXT };
 /**
@@ -165,6 +166,7 @@ export declare class MyProtocolService implements ProtocolService {
  * - transformer for `WEB` Handler
  */
 export declare class WEBProtocolTransformer implements ProtocolTransformer<APIGatewayProxyEvent, APIGatewayProxyEvent> {
+    private service;
     constructor(service?: MyProtocolService);
     /**
      * transform param to event
@@ -191,9 +193,11 @@ export declare class SNSProtocolTransformer implements ProtocolTransformer<MySNS
     transformToEvent(uri: string, param: ProtocolParam, callback?: string): MySNSEventParam;
     /**
      * transform event data to param
+     * - v5 B14: the context comes from the `relay` (wins) or the legacy `context` (see `receiveContext()`).
      * @param event     the lambda compartible event data.
+     * @param own       (optional) the receiver's own `requestId`/`accountId` (for a relay)
      */
-    transformToParam(event: SNSMessage): MyProtocolParam;
+    transformToParam(event: SNSMessage, own?: NextContext): MyProtocolParam;
 }
 /**
  * the SQS send input this service builds (local structural type, the fields it uses; v5 B2-c).
@@ -218,7 +222,9 @@ export declare class SQSProtocolTransformer implements ProtocolTransformer<SQSEv
     transformToEvent(uri: string, param: ProtocolParam, callback?: string): SQSEventParam;
     /**
      * transform event data to param
+     * - v5 B14: the context comes from the `relay` (wins) or the legacy `context` (see `receiveContext()`).
      * @param event     the lambda compartible event data.
+     * @param own       (optional) the receiver's own `requestId`/`accountId` (for a relay)
      */
-    transformToParam(event: SQSRecord): MyProtocolParam;
+    transformToParam(event: SQSRecord, own?: NextContext): MyProtocolParam;
 }