lemon-core 5.0.3 → 5.0.5

package/dist/cores/protocol/local-transport.js

@@ -0,0 +1,392 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.$localTransport = exports.deliveries = exports.drain = exports.localWeb = exports.localSqs = exports.localSns = exports.selfHostOf = exports.queueOf = exports.topicOf = exports.isActive = exports.transportLog = exports.LOCAL_TRANSPORT_CAP = exports.LOCAL_ACCOUNT_ID = exports.LOCAL_TRANSPORT = void 0;
+/**
+ * `local-transport.ts`
+ * - opt-in local transport (mock delivery): in local mode, `sns.publish()`, `sqs.sendMessage()` and the protocol
+ *   `execute/notify/enqueue/broadcast` deliver to this service in-process, with no AWS SDK client.
+ * - on only if env `LOCAL_TRANSPORT=mock` and `$U.isLocalMode()` (`LOCAL_MODE=1`, no `AWS_LAMBDA_FUNCTION_NAME`).
+ *   in Lambda the env is ignored (one warn line). without the env nothing changes.
+ * - self only: a target that is not this service throws `501 NOT SUPPORTED` (no AWS call, no silent drop).
+ *   no target and no env `MY_SNS_ENDPOINT`/`MY_SQS_ENDPOINT` (a local run) = this service's topic/queue.
+ * - fidelity: each delivery is a real Lambda event record, run by the engine's `LambdaHandler.handle()`.
+ *   SNS/SQS kinds are async (`setImmediate`), `execute` is sync. `drain()` waits for all and returns them.
+ * - loop guard: over `LOCAL_TRANSPORT_CAP` (deliveries in one burst, or chain depth) → `508 LOOP DETECTED`.
+ *   a burst ends at `drain()` or when nothing is pending (idle), so a long-running server never stays capped.
+ * - keeps only the last `LOCAL_TRANSPORT_CAP.kept` (100) finished deliveries (the oldest are dropped).
+ *
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2026-10-30 initial version.
+ * @date        2026-10-30 the burst count resets when idle (not only at `drain()`); keep the last 100 deliveries.
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+const async_hooks_1 = require("async_hooks");
+const crypto_1 = require("crypto");
+const url_1 = __importDefault(require("url"));
+const engine_1 = require("../../engine/");
+const test_helper_1 = require("../../common/test-helper");
+//* lazy namespace: this file is in the engine closure (via `aws-sns-service`), so nothing runs `$U` at load.
+const NS = (() => {
+    let ns;
+    return () => (ns ??= engine_1.$U.NS('MOCK', 'magenta'));
+})();
+/**
+ * env name of the local transport (`mock` = on, in local mode only).
+ */
+exports.LOCAL_TRANSPORT = 'LOCAL_TRANSPORT';
+/**
+ * placeholder account of the local ARNs, URLs and the fake Lambda context.
+ */
+exports.LOCAL_ACCOUNT_ID = '000000000000';
+/**
+ * loop guard: max deliveries in one burst (until `drain()` or idle), and max chain depth (a send from a delivery is +1).
+ * - `kept`: max finished deliveries kept for `drain()`/`deliveries()` (the oldest are dropped).
+ */
+exports.LOCAL_TRANSPORT_CAP = { deliveries: 50, depth: 8, kept: 100 };
+/**
+ * the log writer (one `_inf` line); an object, so a spec can spy on `inf`.
+ */
+exports.transportLog = {
+    inf: (line) => (0, engine_1._inf)(NS(), line),
+};
+//* chain of the current delivery: `depth` (1 = sent by a client request), `async` (inside an SNS/SQS delivery).
+const $chain = new async_hooks_1.AsyncLocalStorage();
+//* process-wide state: pending deliveries, running sync `execute()`s, finished deliveries, count in this burst,
+//* cap logged, warned keys.
+const $state = {
+    pending: new Set(),
+    running: 0,
+    list: [],
+    count: 0,
+    capped: false,
+    warned: new Set(),
+};
+//* keep one finished delivery (the last `LOCAL_TRANSPORT_CAP.kept` only).
+const record = (delivery) => {
+    $state.list.push(delivery);
+    if ($state.list.length > exports.LOCAL_TRANSPORT_CAP.kept)
+        $state.list.splice(0, $state.list.length - exports.LOCAL_TRANSPORT_CAP.kept);
+};
+//* end of a burst: nothing pending and no sync `execute()` running → reset the count and the cap line.
+const resetIfIdle = () => {
+    if ($state.pending.size || $state.running)
+        return;
+    $state.count = 0;
+    $state.capped = false;
+};
+//* the configured region (env `REGION`, as the SNS service).
+const region = () => `${engine_1.$engine.environ('REGION', 'ap-northeast-2') || 'ap-northeast-2'}`;
+//* log one warn line per reason (never twice in a process).
+const warnOnce = (key, line) => {
+    if ($state.warned.has(key))
+        return;
+    $state.warned.add(key);
+    exports.transportLog.inf(line);
+};
+/**
+ * true if the local transport is on: env `LOCAL_TRANSPORT=mock` and local mode (never in Lambda).
+ * - read from `process.env` on every call. an ignored value logs one warn line.
+ */
+const isActive = () => {
+    const val = `${process.env[exports.LOCAL_TRANSPORT] ?? ''}`;
+    if (!val)
+        return false;
+    //* the reason to ignore ('' = active).
+    const why = val !== 'mock'
+        ? 'unknown value'
+        : process.env.AWS_LAMBDA_FUNCTION_NAME
+            ? 'in Lambda'
+            : !engine_1.$U.isLocalMode()
+                ? 'not local mode'
+                : '';
+    if (!why)
+        return true;
+    warnOnce(`${val}/${why}`, `WARN! env.${exports.LOCAL_TRANSPORT}[${val.substring(0, 32)}] is ignored - ${why}`);
+    return false;
+};
+exports.isActive = isActive;
+//* topic name of an SNS target: `arn:aws:sns:<region>:<account>:<topic>` → `<topic>`, a name as is.
+const topicOf = (target) => `${target || ''}`.split(':').pop() || '';
+exports.topicOf = topicOf;
+//* queue name of an SQS endpoint: `https://sqs.<region>.amazonaws.com/<account>/<queue>` → `<queue>`, a name as is.
+const queueOf = (endpoint) => `${endpoint || ''}`
+    .split('/')
+    .filter(_ => !!_)
+    .pop() || '';
+exports.queueOf = queueOf;
+//* host of a protocol uri like `sns://<acct>@<host>/<path>#<ver>`.
+const hostOf = (uri) => `${url_1.default.parse(uri).hostname || ''}`;
+/**
+ * host of this service by protocol (`sns://self`, `sqs://self`, `web://self`).
+ *
+ * @param type      protocol type.
+ * @param service   (optional) the protocol service (default: the engine's).
+ * @param config    (optional) its config service.
+ */
+const selfHostOf = async (type, service, config) => {
+    //* lazy: the protocol module loads the AWS services (no import cycle at load).
+    const svc = service ?? (await Promise.resolve().then(() => __importStar(require('./index')))).default.service;
+    return hostOf(svc.asProtocolURI(type, { service: 'self' }, config));
+};
+exports.selfHostOf = selfHostOf;
+//* throw `501` if the name is not one of this service's names.
+const assertSelf = (name, selves) => {
+    if (!name || !selves.filter(_ => !!_).includes(name))
+        throw new Error(`501 NOT SUPPORTED - local transport: ${name} is not this service`);
+};
+//* loop guard: admit one delivery (returns its depth), or refuse with `508` (one `[MOCK] cap` line until `drain()`).
+const admit = (kind, target) => {
+    const depth = ($chain.getStore()?.depth ?? 0) + 1;
+    if ($state.count >= exports.LOCAL_TRANSPORT_CAP.deliveries || depth > exports.LOCAL_TRANSPORT_CAP.depth) {
+        if (!$state.capped) {
+            $state.capped = true;
+            exports.transportLog.inf(`[MOCK] cap kind=${kind} target=${target} deliveries=${$state.count} depth=${depth}`);
+        }
+        const error = `508 LOOP DETECTED - local transport`;
+        record({ kind, target, messageId: '', error });
+        throw new Error(error);
+    }
+    $state.count++;
+    return depth;
+};
+//* a fake Lambda context of this service (placeholder account).
+const asContext = (name) => ({
+    callbackWaitsForEmptyEventLoop: true,
+    functionName: name,
+    functionVersion: '$LATEST',
+    invokedFunctionArn: `arn:aws:lambda:${region()}:${exports.LOCAL_ACCOUNT_ID}:function:${name}`,
+    memoryLimitInMB: '1024',
+    awsRequestId: (0, crypto_1.randomUUID)(),
+    logGroupName: `/aws/lambda/${name}`,
+    logStreamName: 'local-transport',
+    getRemainingTimeInMillis: () => 30000,
+    done: () => { },
+    fail: () => { },
+    succeed: () => { },
+});
+//* run one event through the engine's `LambdaHandler.handle()` (never rejects, as in Lambda).
+const handleEvent = async (event) => {
+    //* lazy: the lambda module imports the protocol and AWS modules (no import cycle at load).
+    const $lambda = (await Promise.resolve().then(() => __importStar(require('../lambda')))).default;
+    const context = asContext(await (0, exports.selfHostOf)('web'));
+    return $lambda.lambda.handle(event, context);
+};
+//* the error of a finished SNS/SQS delivery ('' if none): SQS `batchItemFailures`, or the failure result `{ error }`.
+const errorOf = (result) => {
+    const failures = Array.isArray(result?.batchItemFailures) ? result.batchItemFailures : [];
+    if (failures.length)
+        return `500 BATCH ITEM FAILURES - ${failures.map(_ => _?.itemIdentifier).join(',')}`;
+    if (result && typeof result === 'object' && typeof result.error === 'string')
+        return result.error;
+    return '';
+};
+//* schedule one async delivery (`setImmediate`), tracked until `drain()`.
+const deliverAsync = (kind, target, depth, messageId, event) => {
+    exports.transportLog.inf(`[MOCK] deliver kind=${kind} target=${target} message=${messageId}`);
+    const job = new Promise(resolve => setImmediate(() => {
+        $chain
+            .run({ depth, async: true }, () => handleEvent(event))
+            .then(result => {
+            const error = errorOf(result);
+            record({ kind, target, messageId, result, ...(error ? { error } : {}) });
+        })
+            .catch(e => record({ kind, target, messageId, error: (0, test_helper_1.GETERR)(e) }))
+            .finally(() => resolve());
+    }));
+    $state.pending.add(job);
+    //* done: forget it, and end the burst if this was the last one.
+    job.then(() => {
+        $state.pending.delete(job);
+        resetIfIdle();
+    });
+};
+/**
+ * deliver an SNS message to this service: a `aws:sns` record → `LambdaHandler.handle()` (async).
+ *
+ * @param target    topic name or ARN.
+ * @param msg       subject, message (the `default` string), attributes.
+ * @param selfHost  (optional) `sns://self` host (default: by the engine's protocol service).
+ * @returns         the message id `mock-<uuid>`.
+ */
+const localSns = async (target, msg, selfHost) => {
+    const self = selfHost ?? (await (0, exports.selfHostOf)('sns'));
+    //* '' (no target, no env `MY_SNS_ENDPOINT`) → this service's topic, as the Lambda deploy sets the env.
+    const topic = (0, exports.topicOf)(target) || self;
+    assertSelf(topic, [(0, exports.topicOf)(`${engine_1.$engine.environ('MY_SNS_ENDPOINT', '') || ''}`), self]);
+    const depth = admit('sns', topic);
+    const messageId = `mock-${(0, crypto_1.randomUUID)()}`;
+    const TopicArn = `arn:aws:sns:${region()}:${exports.LOCAL_ACCOUNT_ID}:${topic}`;
+    //* attributes as the Lambda record has them (`Type`, `Value`).
+    const MessageAttributes = Object.entries(msg.MessageAttributes || {}).reduce((M, [k, v]) => ({ ...M, [k]: { Type: v.DataType, Value: v.StringValue } }), {});
+    const record = {
+        EventSource: 'aws:sns',
+        EventVersion: '1.0',
+        EventSubscriptionArn: `${TopicArn}:${(0, crypto_1.randomUUID)()}`,
+        Sns: {
+            Type: 'Notification',
+            MessageId: messageId,
+            TopicArn,
+            Subject: msg.Subject ?? null,
+            Message: msg.Message,
+            Timestamp: new Date().toISOString(),
+            MessageAttributes,
+        },
+    };
+    deliverAsync('sns', topic, depth, messageId, { Records: [record] });
+    return messageId;
+};
+exports.localSns = localSns;
+/**
+ * deliver an SQS message to this service: a `aws:sqs` record → `LambdaHandler.handle()` (async, no delay).
+ *
+ * @param endpoint  queue url or name.
+ * @param msg       body and attributes.
+ * @param selfHost  (optional) `sqs://self` host (default: by the engine's protocol service).
+ * @returns         the message id `mock-<uuid>`.
+ */
+const localSqs = async (endpoint, msg, selfHost) => {
+    const self = selfHost ?? (await (0, exports.selfHostOf)('sqs'));
+    //* '' (no endpoint, no env `MY_SQS_ENDPOINT`) → this service's queue, as the Lambda deploy sets the env.
+    const queue = (0, exports.queueOf)(endpoint) || self;
+    assertSelf(queue, [(0, exports.queueOf)(`${engine_1.$engine.environ('MY_SQS_ENDPOINT', '') || ''}`), self]);
+    const depth = admit('sqs', queue);
+    const messageId = `mock-${(0, crypto_1.randomUUID)()}`;
+    const now = `${Date.now()}`;
+    //* attributes as the Lambda record has them (`dataType`, `stringValue`).
+    const messageAttributes = Object.entries(msg.MessageAttributes || {}).reduce((M, [k, v]) => ({
+        ...M,
+        [k]: { dataType: v.DataType, stringValue: v.StringValue, stringListValues: [], binaryListValues: [] },
+    }), {});
+    const record = {
+        messageId,
+        receiptHandle: `mock-${(0, crypto_1.randomUUID)()}`,
+        body: msg.MessageBody,
+        attributes: {
+            ApproximateReceiveCount: '1',
+            SentTimestamp: now,
+            SenderId: exports.LOCAL_ACCOUNT_ID,
+            ApproximateFirstReceiveTimestamp: now,
+        },
+        messageAttributes,
+        md5OfBody: (0, crypto_1.createHash)('md5')
+            .update(`${msg.MessageBody ?? ''}`)
+            .digest('hex'),
+        eventSource: 'aws:sqs',
+        eventSourceARN: `arn:aws:sqs:${region()}:${exports.LOCAL_ACCOUNT_ID}:${queue}`,
+        awsRegion: region(),
+    };
+    deliverAsync('sqs', queue, depth, messageId, { Records: [record] });
+    return messageId;
+};
+exports.localSqs = localSqs;
+/**
+ * run a protocol `execute()` on this service: the web event → `LambdaHandler.handle()` (sync, like a sync invoke).
+ * - the result is parsed like `invokeLambda()` (a non-2xx throws). `useEvent` → async, returns the 202 output.
+ *
+ * @param fn        function name (host of the `web://` uri).
+ * @param event     the web event of `WEBProtocolTransformer`.
+ * @param selfHost  `web://self` host of the calling protocol service.
+ * @param options   `param` for logging, `useEvent` for an async invoke.
+ */
+const localWeb = async (fn, event, selfHost, options) => {
+    assertSelf(fn, [selfHost]);
+    const depth = admit('protocol', fn);
+    //* lazy: `aws-lambda-helper` runs `$U` at load (this file is in the engine closure).
+    const { asInvokeResult } = await Promise.resolve().then(() => __importStar(require('./aws-lambda-helper')));
+    const messageId = `mock-${(0, crypto_1.randomUUID)()}`;
+    //* async invoke (`InvocationType: Event`): deliver later, return the 202 output.
+    if (options?.useEvent) {
+        deliverAsync('protocol', fn, depth, messageId, event);
+        return asInvokeResult(fn, { StatusCode: 202 }, { ...options, useEvent: true });
+    }
+    exports.transportLog.inf(`[MOCK] deliver kind=protocol target=${fn} message=${messageId}`);
+    $state.running++;
+    try {
+        const result = await $chain.run({ depth, async: false }, () => handleEvent(event));
+        const Payload = new TextEncoder().encode(JSON.stringify(result ?? {}));
+        const body = await asInvokeResult(fn, { StatusCode: 200, Payload }, options);
+        record({ kind: 'protocol', target: fn, messageId, result: body });
+        return body;
+    }
+    catch (e) {
+        record({ kind: 'protocol', target: fn, messageId, error: (0, test_helper_1.GETERR)(e) });
+        throw e;
+    }
+    finally {
+        //* the sync call is over: end the burst if nothing else is pending.
+        $state.running--;
+        resetIfIdle();
+    }
+};
+exports.localWeb = localWeb;
+/**
+ * wait for every pending delivery (incl. the ones they send), then return the finished list and clear it.
+ * - resets the loop-guard count (idle also does). process-wide: it takes every delivery, not only the caller's.
+ * - must not be called inside an SNS/SQS delivery (it would wait for itself).
+ */
+const drain = async () => {
+    if ($chain.getStore()?.async)
+        throw new Error(`500 INVALID STATE - drain() inside a delivery (local transport)`);
+    while ($state.pending.size)
+        await Promise.all([...$state.pending]);
+    const list = $state.list.splice(0);
+    $state.count = 0;
+    $state.capped = false;
+    return list;
+};
+exports.drain = drain;
+/**
+ * the finished deliveries since the last `drain()`, the last 100 only (a copy; it does not wait or clear).
+ */
+const deliveries = () => [...$state.list];
+exports.deliveries = deliveries;
+/**
+ * the public API of the local transport (exported from the package root).
+ */
+exports.$localTransport = {
+    /** true if `LOCAL_TRANSPORT=mock` and local mode */
+    isActive: exports.isActive,
+    /** wait for all pending deliveries, return them, and clear */
+    drain: exports.drain,
+    /** the finished deliveries since the last `drain()` */
+    deliveries: exports.deliveries,
+};
+//# sourceMappingURL=local-transport.js.map

package/dist/cores/protocol/local-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../../src/cores/protocol/local-transport.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,6CAAgD;AAChD,mCAAgD;AAChD,8CAAsB;AAGtB,0CAAkD;AAClD,0DAAkD;AAGlD,6GAA6G;AAC7G,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE;IACb,IAAI,EAAsB,CAAC;IAC3B,OAAO,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,WAAE,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,EAAE,CAAC;AAEL;;GAEG;AACU,QAAA,eAAe,GAAG,iBAAiB,CAAC;AAEjD;;GAEG;AACU,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAE/C;;;GAGG;AACU,QAAA,mBAAmB,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AA+B3E;;GAEG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,EAAE,CAAC,IAAY,EAAQ,EAAE,CAAC,IAAA,aAAI,EAAC,EAAE,EAAE,EAAE,IAAI,CAAC;CAChD,CAAC;AAEF,gHAAgH;AAChH,MAAM,MAAM,GAAG,IAAI,+BAAiB,EAAqC,CAAC;AAE1E,gHAAgH;AAChH,4BAA4B;AAC5B,MAAM,MAAM,GAAG;IACX,OAAO,EAAE,IAAI,GAAG,EAAiB;IACjC,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,EAAqB;IAC3B,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,IAAI,GAAG,EAAU;CAC5B,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,GAAG,CAAC,QAAuB,EAAE,EAAE;IACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,2BAAmB,CAAC,IAAI;QAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,2BAAmB,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,uGAAuG;AACvG,MAAM,WAAW,GAAG,GAAG,EAAE;IACrB,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO;IAClD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;AAC1B,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,GAAG,gBAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,gBAAgB,EAAE,CAAC;AAElG,4DAA4D;AAC5D,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,EAAE;IAC3C,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACnC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,oBAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,QAAQ,GAAG,GAAY,EAAE;IAClC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAe,CAAC,IAAI,EAAE,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,uCAAuC;IACvC,MAAM,GAAG,GACL,GAAG,KAAK,MAAM;QACV,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB;YACtC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,CAAC,WAAE,CAAC,WAAW,EAAE;gBACnB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,EAAE,CAAC;IACb,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,QAAQ,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,EAAE,aAAa,uBAAe,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;IACvG,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAfW,QAAA,QAAQ,YAenB;AAEF,oGAAoG;AAC7F,MAAM,OAAO,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;AAA/E,QAAA,OAAO,WAAwE;AAE5F,oHAAoH;AAC7G,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAU,EAAE,CAChD,GAAG,QAAQ,IAAI,EAAE,EAAE;KACd,KAAK,CAAC,GAAG,CAAC;KACV,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;KAChB,GAAG,EAAE,IAAI,EAAE,CAAC;AAJR,QAAA,OAAO,WAIC;AAErB,mEAAmE;AACnE,MAAM,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,aAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AAE3E;;;;;;GAMG;AACI,MAAM,UAAU,GAAG,KAAK,EAC3B,IAA2B,EAC3B,OAA2B,EAC3B,MAAoC,EACrB,EAAE;IACjB,+EAA+E;IAC/E,MAAM,GAAG,GAAG,OAAO,IAAK,CAAC,wDAAa,SAAS,GAAC,CAAC,CAAC,OAAO,CAAC,OAA6B,CAAC;IACxF,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;AACzF,CAAC,CAAC;AARW,QAAA,UAAU,cAQrB;AAEF,+DAA+D;AAC/D,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,MAAgB,EAAE,EAAE;IAClD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,sBAAsB,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,qHAAqH;AACrH,MAAM,KAAK,GAAG,CAAC,IAAuB,EAAE,MAAc,EAAU,EAAE;IAC9D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,KAAK,IAAI,2BAAmB,CAAC,UAAU,IAAI,KAAK,GAAG,2BAAmB,CAAC,KAAK,EAAE,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,oBAAY,CAAC,GAAG,CAAC,mBAAmB,IAAI,WAAW,MAAM,eAAe,MAAM,CAAC,KAAK,UAAU,KAAK,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,MAAM,KAAK,GAAG,qCAAqC,CAAC;QACpD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,SAAS,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC;IAC1C,8BAA8B,EAAE,IAAI;IACpC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,SAAS;IAC1B,kBAAkB,EAAE,kBAAkB,MAAM,EAAE,IAAI,wBAAgB,aAAa,IAAI,EAAE;IACrF,eAAe,EAAE,MAAM;IACvB,YAAY,EAAE,IAAA,mBAAU,GAAE;IAC1B,YAAY,EAAE,eAAe,IAAI,EAAE;IACnC,aAAa,EAAE,iBAAiB;IAChC,wBAAwB,EAAE,GAAG,EAAE,CAAC,KAAK;IACrC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;CACpB,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,WAAW,GAAG,KAAK,EAAE,KAAU,EAAgB,EAAE;IACnD,2FAA2F;IAC3F,MAAM,OAAO,GAAG,CAAC,wDAAa,WAAW,GAAC,CAAC,CAAC,OAAO,CAAC;IACpD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,sHAAsH;AACtH,MAAM,OAAO,GAAG,CAAC,MAAW,EAAU,EAAE;IACpC,MAAM,QAAQ,GAAU,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACjG,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,6BAA6B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1G,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAClG,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,YAAY,GAAG,CAAC,IAAuB,EAAE,MAAc,EAAE,KAAa,EAAE,SAAiB,EAAE,KAAU,EAAE,EAAE;IAC3G,oBAAY,CAAC,GAAG,CAAC,uBAAuB,IAAI,WAAW,MAAM,YAAY,SAAS,EAAE,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CACpC,YAAY,CAAC,GAAG,EAAE;QACd,MAAM;aACD,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;aACrD,IAAI,CAAC,MAAM,CAAC,EAAE;YACX,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9B,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAA,oBAAM,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACjE,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CACL,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;QACV,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,WAAW,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAWF;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,GAAoB,EAAE,QAAiB,EAAmB,EAAE;IACvG,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC,CAAC;IACnD,uGAAuG;IACvG,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACtC,UAAU,CAAC,KAAK,EAAE,CAAC,IAAA,eAAO,EAAC,GAAG,gBAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,QAAQ,IAAA,mBAAU,GAAE,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,eAAe,MAAM,EAAE,IAAI,wBAAgB,IAAI,KAAK,EAAE,CAAC;IACxE,+DAA+D;IAC/D,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,MAAM,CACxE,CAAC,CAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,EAC/E,EAAE,CACL,CAAC;IACF,MAAM,MAAM,GAAG;QACX,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,KAAK;QACnB,oBAAoB,EAAE,GAAG,QAAQ,IAAI,IAAA,mBAAU,GAAE,EAAE;QACnD,GAAG,EAAE;YACD,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,SAAS;YACpB,QAAQ;YACR,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,iBAAiB;SACpB;KACJ,CAAC;IACF,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AA7BW,QAAA,QAAQ,YA6BnB;AAUF;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAgB,EAAE,GAAoB,EAAE,QAAiB,EAAmB,EAAE;IACzG,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC,CAAC;IACnD,yGAAyG;IACzG,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IACxC,UAAU,CAAC,KAAK,EAAE,CAAC,IAAA,eAAO,EAAC,GAAG,gBAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,QAAQ,IAAA,mBAAU,GAAE,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC5B,yEAAyE;IACzE,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,MAAM,CACxE,CAAC,CAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjB,GAAG,CAAC;QACJ,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;KACxG,CAAC,EACF,EAAE,CACL,CAAC;IACF,MAAM,MAAM,GAAG;QACX,SAAS;QACT,aAAa,EAAE,QAAQ,IAAA,mBAAU,GAAE,EAAE;QACrC,IAAI,EAAE,GAAG,CAAC,WAAW;QACrB,UAAU,EAAE;YACR,uBAAuB,EAAE,GAAG;YAC5B,aAAa,EAAE,GAAG;YAClB,QAAQ,EAAE,wBAAgB;YAC1B,gCAAgC,EAAE,GAAG;SACxC;QACD,iBAAiB;QACjB,SAAS,EAAE,IAAA,mBAAU,EAAC,KAAK,CAAC;aACvB,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;aAClC,MAAM,CAAC,KAAK,CAAC;QAClB,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,eAAe,MAAM,EAAE,IAAI,wBAAgB,IAAI,KAAK,EAAE;QACtE,SAAS,EAAE,MAAM,EAAE;KACtB,CAAC;IACF,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AApCW,QAAA,QAAQ,YAoCnB;AAEF;;;;;;;;GAQG;AACI,MAAM,QAAQ,GAAG,KAAK,EACzB,EAAU,EACV,KAA2B,EAC3B,QAAgB,EAChB,OAAuD,EAC7C,EAAE;IACZ,UAAU,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpC,qFAAqF;IACrF,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,qBAAqB,GAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,QAAQ,IAAA,mBAAU,GAAE,EAAE,CAAC;IACzC,iFAAiF;IACjF,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,cAAc,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAyB,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,oBAAY,CAAC,GAAG,CAAC,uCAAuC,EAAE,YAAY,SAAS,EAAE,CAAC,CAAC;IACnF,MAAM,CAAC,OAAO,EAAE,CAAC;IACjB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAyB,EAAE,OAAO,CAAC,CAAC;QACpG,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,IAAS,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAA,oBAAM,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,CAAC;IACZ,CAAC;YAAS,CAAC;QACP,oEAAoE;QACpE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,WAAW,EAAE,CAAC;IAClB,CAAC;AACL,CAAC,CAAC;AAhCW,QAAA,QAAQ,YAgCnB;AAEF;;;;GAIG;AACI,MAAM,KAAK,GAAG,KAAK,IAA8B,EAAE;IACtD,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACjH,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI;QAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAPW,QAAA,KAAK,SAOhB;AAEF;;GAEG;AACI,MAAM,UAAU,GAAG,GAAoB,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;AAArD,QAAA,UAAU,cAA2C;AAElE;;GAEG;AACU,QAAA,eAAe,GAAG;IAC3B,oDAAoD;IACpD,QAAQ,EAAR,gBAAQ;IACR,8DAA8D;IAC9D,KAAK,EAAL,aAAK;IACL,uDAAuD;IACvD,UAAU,EAAV,kBAAU;CACb,CAAC"}

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

@@ -2,6 +2,7 @@ import { NextContext } from 'lemon-model';
 import { STAGE, ProtocolService, ProtocolParam, ProtocolTransformer, ProtocolBody, CallbackParam, ProtocolExecuteOptions } from './../core-services';
 import { APIGatewayProxyEvent, SNSMessage, SQSRecord } from 'aws-lambda';
 import { ConfigService } from './../config/config-service';
+import { HEADER_PROTOCOL_CONTEXT } from './protocol-sign';
 /**
  * a message attribute of SNS/SQS (local structural type = the SDK `MessageAttributeValue`; v5 B2-c).
  */
@@ -13,8 +14,9 @@ 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).
  */
-export declare const HEADER_PROTOCOL_CONTEXT: any;
+export { HEADER_PROTOCOL_CONTEXT };
 /**
  * type: MyProtocolType
  * - supportable type of protocol
@@ -220,4 +222,3 @@ export declare class SQSProtocolTransformer implements ProtocolTransformer<SQSEv
      */
     transformToParam(event: SQSRecord): MyProtocolParam;
 }
-export {};

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

@@ -44,6 +44,7 @@ exports.SQSProtocolTransformer = exports.SNSProtocolTransformer = exports.WEBPro
  *
  * @author      Steve Jung <steve@lemoncloud.io>
  * @date        2019-11-27 initial version.
+ * @date        2026-10-30 `execute/notify/enqueue/broadcast`: the local transport (`LOCAL_TRANSPORT=mock`) delivers in-process.
  *
  * @copyright (C) lemoncloud.io 2019 - All Rights Reserved.
  */
@@ -56,8 +57,11 @@ const config_1 = __importDefault(require("../config/")); // load config-module.
 const aws_1 = __importDefault(require("../aws/")); // load config-module.
 const qs_1 = __importDefault(require("qs"));
 const aws_lambda_helper_1 = require("./aws-lambda-helper");
+const local_transport_1 = require("./local-transport");
+const aws_sns_service_1 = require("../aws/aws-sns-service");
 const perf_1 = require("../../lib/perf");
 const protocol_sign_1 = require("./protocol-sign");
+Object.defineProperty(exports, "HEADER_PROTOCOL_CONTEXT", { enumerable: true, get: function () { return protocol_sign_1.HEADER_PROTOCOL_CONTEXT; } });
 const NS = engine_1.$U.NS('PRTS', 'yellow'); // NAMESPACE TO BE PRINTED.
 /**
  * SDK packages, imported on the first use (not at import; v5 B2-c, K6). This file keeps its own loaders.
@@ -69,11 +73,6 @@ let $sqs;
 const loadSns = () => ($sns ??= (0, perf_1.measureAsync)(engine_1._inf, engine_1.$U.NS('PERF', 'cyan'), 'lazy-load @aws-sdk/client-sns', () => Promise.resolve().then(() => __importStar(require('@aws-sdk/client-sns')))));
 // loader of `@aws-sdk/client-sqs`.
 const loadSqs = () => ($sqs ??= (0, perf_1.measureAsync)(engine_1._inf, engine_1.$U.NS('PERF', 'cyan'), 'lazy-load @aws-sdk/client-sqs', () => Promise.resolve().then(() => __importStar(require('@aws-sdk/client-sqs')))));
-/**
- * header name to exchange `next-context`
- * ONLY for internal communication.
- */
-exports.HEADER_PROTOCOL_CONTEXT = engine_1.$U.env('HEADER_PROTOCOL_CONTEXT', 'x-protocol-context');
 /**
  * class: `MyConfigService`
  * - main implementation for `protocol-service`
@@ -328,6 +327,11 @@ class MyProtocolService {
         // const url = new URL(uri);
         const $url = url_1.default.parse(uri);
         const payload = this.transformEvent(uri, param);
+        //* local transport (opt-in, local mode only): run this service's handler in-process (sync), no AWS call.
+        if ((0, local_transport_1.isActive)()) {
+            const selfHost = await (0, local_transport_1.selfHostOf)('web', this, config);
+            return (0, local_transport_1.localWeb)(`${$url.hostname || ''}`, payload, selfHost, { param, useEvent });
+        }
         const awsCfg = (0, tools_1.awsConfig)(engine_1.default);
         return (0, aws_lambda_helper_1.invokeLambda)($url.hostname, payload, { param, config: awsCfg, useEvent });
     }
@@ -347,7 +351,12 @@ class MyProtocolService {
         (0, engine_1._inf)(NS, `> uri[${service}] =`, uri);
         const cbUrl = callback ? this.asCallbackURI(param.context, callback) : null;
         const params = this.sns.transformToEvent(uri, param, cbUrl);
-        const arn = params.TopicArn; // "arn:aws:sns:ap-northeast-2:796730245826:lemon-metrics-sns-dev"
+        //* local transport (opt-in, local mode only): deliver to this service's topic in-process, no AWS call.
+        if ((0, local_transport_1.isActive)()) {
+            const message = { ...params, Message: JSON.parse(params.Message).default };
+            return (0, local_transport_1.localSns)(params.TopicArn, message, await (0, local_transport_1.selfHostOf)('sns', this, config));
+        }
+        const arn = params.TopicArn; // "arn:aws:sns:ap-northeast-2:123456789012:lemon-metrics-sns-dev"
         // _inf(NS, `> arn[${service}] =`, arn);
         (0, engine_1._inf)(NS, `> payload[${arn}] =`, engine_1.$U.json(params));
         //* call sns
@@ -389,6 +398,9 @@ class MyProtocolService {
         (0, engine_1._inf)(NS, `> callback[${service}] =`, cbUrl);
         const params = this.sqs.transformToEvent(uri, param, cbUrl);
         params.DelaySeconds = delaySeconds;
+        //* local transport (opt-in, local mode only): deliver to this service's queue in-process (no delay), no AWS call.
+        if ((0, local_transport_1.isActive)())
+            return (0, local_transport_1.localSqs)(params.QueueUrl, params, await (0, local_transport_1.selfHostOf)('sqs', this, config));
         const endpoint = params.QueueUrl; // https://sqs.${arr[3]}.amazonaws.com
         // _inf(NS, `> endpoint[${service}] =`, endpoint);
         (0, engine_1._inf)(NS, `> payload[${endpoint}] =`, engine_1.$U.json(params));
@@ -421,6 +433,17 @@ class MyProtocolService {
         const service = this.myProtocolURI(context);
         (0, engine_1._log)(NS, `broadcast(${service})..`);
         (0, engine_1._log)(NS, `> body[${service}] =`, engine_1.$U.json(body));
+        //* local transport (opt-in, local mode only): deliver to this service's topic in-process (no endpoint lookup).
+        if ((0, local_transport_1.isActive)()) {
+            const [accountId, requestId] = [`${context?.accountId || ''}`, `${context?.requestId || ''}`];
+            const MessageAttributes = {};
+            if (accountId)
+                MessageAttributes['accountId'] = { DataType: 'String', StringValue: accountId };
+            if (requestId)
+                MessageAttributes['requestId'] = { DataType: 'String', StringValue: requestId };
+            const message = { Subject: `x-protocol-service/broadcast`, Message: engine_1.$U.json(body), MessageAttributes };
+            return (0, local_transport_1.localSns)((0, aws_sns_service_1.snsTargetOf)(endpoint), message, await (0, local_transport_1.selfHostOf)('sns', this));
+        }
         const arn = await aws_1.default.sns.endpoint(endpoint);
         (0, engine_1._inf)(NS, `> arn[${endpoint}] =`, arn);
         const accountId = `${(context && context.accountId) || ''}`;
@@ -493,7 +516,7 @@ class WEBProtocolTransformer {
         const event = {
             ...base,
             headers: {
-                [exports.HEADER_PROTOCOL_CONTEXT]: contextJson,
+                [protocol_sign_1.HEADER_PROTOCOL_CONTEXT]: contextJson,
                 ...(signature ? { [protocol_sign_1.HEADER_PROTOCOL_SIGNATURE]: signature } : {}),
             },
             path,
@@ -532,7 +555,7 @@ class WEBProtocolTransformer {
         const _context = (context) => {
             if (context)
                 return context; // use given context.
-            const ctx = headers[exports.HEADER_PROTOCOL_CONTEXT];
+            const ctx = headers[protocol_sign_1.HEADER_PROTOCOL_CONTEXT];
             if (!ctx)
                 return null; // no context.
             if (typeof ctx !== 'string')
@@ -613,7 +636,7 @@ class SNSProtocolTransformer {
     transformToEvent(uri, param, callback) {
         // const uri = this.service.asProtocolURI('sns', param);
         const context = param.context || {};
-        const arn = (0, engine_1.getHelloArn)(param.context); // "arn:aws:sns:ap-northeast-2:796730245826:lemon-metrics-sns-dev"
+        const arn = (0, engine_1.getHelloArn)(param.context); // "arn:aws:sns:ap-northeast-2:123456789012:lemon-metrics-sns-dev"
         //* build TopicArn via url.
         const url = url_1.default.parse(uri);
         const end = url.host || url.hostname;
@@ -695,7 +718,7 @@ class SQSProtocolTransformer {
     transformToEvent(uri, param, callback) {
         // const uri = this.service.asProtocolURI('sns', param);
         const context = param.context || {};
-        const arn = (0, engine_1.getHelloArn)(param.context); // "arn:aws:sns:ap-northeast-2:796730245826:lemon-metrics-sns-dev"
+        const arn = (0, engine_1.getHelloArn)(param.context); // "arn:aws:sns:ap-northeast-2:123456789012:lemon-metrics-sns-dev"
         //* build TopicArn via url.
         const url = url_1.default.parse(uri);
         const arr = arn.split(':');