quidproquo-actionprocessor-awslambda 0.1.10 → 0.1.12

package/lib/commonjs/lambdaHandlers/helpers/{logger.js → getLogger.js}

@@ -12,17 +12,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLogger = exports.getS3LoggerViaExtension = exports.getS3Logger = exports.moveLogsToPerminateStorage = exports.storyLoggerFs = exports.storyLogger = void 0;
+exports.getLogger = void 0;
+const quidproquo_config_aws_1 = require("quidproquo-config-aws");
 const quidproquo_core_1 = require("quidproquo-core");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const client_s3_1 = require("@aws-sdk/client-s3");
 const awsNamingUtils_1 = require("../../awsNamingUtils");
 const logExtensionPort_1 = require("../../lambdaExtensions/logExtensionPort");
+// Where the old fs-buffered logger parked results. Nothing writes here today, but
+// moveToPermanentStorage still sweeps it so any stragglers from an older deploy
+// (or a future fs buffer) get shipped rather than lost.
 const tempDirectory = '/tmp/qpqlogs';
-const quidproquo_config_aws_1 = require("quidproquo-config-aws");
-const quidproquo_core_2 = require("quidproquo-core");
-const storyLogger = (result, bucketName, s3Client) => __awaiter(void 0, void 0, void 0, function* () {
+const putStoryResult = (result, bucketName, s3Client) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const commandParams = {
             Key: `${result.correlation}.json`,
@@ -36,21 +38,7 @@ const storyLogger = (result, bucketName, s3Client) => __awaiter(void 0, void 0,
         console.log(`Failed to log story result to S3 [${result.correlation}]:`, error);
     }
 });
-exports.storyLogger = storyLogger;
-const storyLoggerFs = (result) => __awaiter(void 0, void 0, void 0, function* () {
-    try {
-        yield fs_1.default.promises.mkdir(tempDirectory, { recursive: true });
-        const filePath = path_1.default.join(tempDirectory, `${result.correlation}.json`);
-        yield fs_1.default.promises.writeFile(filePath, JSON.stringify(result));
-        console.log(`Story result logged to temporary file [${filePath}]`);
-    }
-    catch (error) {
-        console.log(`Failed to log story result to temporary file [${result.correlation}]`);
-        console.error(error);
-    }
-});
-exports.storyLoggerFs = storyLoggerFs;
-const moveLogsToPerminateStorage = (bucketName, region) => __awaiter(void 0, void 0, void 0, function* () {
+const moveLogsToPermanentStorage = (bucketName, region) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         yield fs_1.default.promises.mkdir(tempDirectory, { recursive: true });
         const files = yield fs_1.default.promises.readdir(tempDirectory);
@@ -59,7 +47,7 @@ const moveLogsToPerminateStorage = (bucketName, region) => __awaiter(void 0, voi
             const filePath = path_1.default.join(tempDirectory, file);
             const data = yield fs_1.default.promises.readFile(filePath, 'utf-8');
             const result = JSON.parse(data);
-            yield (0, exports.storyLogger)(result, bucketName, s3Client);
+            yield putStoryResult(result, bucketName, s3Client);
             yield fs_1.default.promises.unlink(filePath);
             console.log(`Moved log file [${file}] to S3 and deleted from temporary directory`);
         }
@@ -69,7 +57,6 @@ const moveLogsToPerminateStorage = (bucketName, region) => __awaiter(void 0, voi
         console.error(error);
     }
 });
-exports.moveLogsToPerminateStorage = moveLogsToPerminateStorage;
 const noopLogger = {
     enableLogs: () => __awaiter(void 0, void 0, void 0, function* () { }),
     log: () => { },
@@ -77,6 +64,7 @@ const noopLogger = {
     moveToPermanentStorage: () => __awaiter(void 0, void 0, void 0, function* () { }),
 };
 // Resolves which S3 bucket (and its region) story logs go to for this config.
+// Only called after getLogger has checked logServiceName is set, hence the `!`.
 const resolveLogTarget = (qpqConfig) => {
     const service = (0, quidproquo_config_aws_1.getAwsServiceAccountInfoConfig)(qpqConfig).logServiceName;
     const application = quidproquo_core_1.qpqCoreUtils.getApplicationName(qpqConfig);
@@ -102,7 +90,7 @@ const createBufferedLogger = (bucketName, regionForBucket, ship) => {
                 .then(() => {
                 const modifyableResult = !disabledLogCorrelations.includes(result.correlation)
                     ? result
-                    : Object.assign(Object.assign({}, result), { history: (0, quidproquo_core_2.filterLogHistoryByActionTypes)(result.history, [
+                    : Object.assign(Object.assign({}, result), { history: (0, quidproquo_core_1.filterLogHistoryByActionTypes)(result.history, [
                             quidproquo_core_1.LogActionType.Create,
                             quidproquo_core_1.LogActionType.TemplateLiteral,
                             quidproquo_core_1.LogActionType.DisableEventHistory,
@@ -118,7 +106,7 @@ const createBufferedLogger = (bucketName, regionForBucket, ship) => {
             yield Promise.all(logs);
         }),
         moveToPermanentStorage: () => __awaiter(void 0, void 0, void 0, function* () {
-            yield (0, exports.moveLogsToPerminateStorage)(bucketName, regionForBucket);
+            yield moveLogsToPermanentStorage(bucketName, regionForBucket);
         }),
     };
 };
@@ -127,9 +115,8 @@ const createBufferedLogger = (bucketName, regionForBucket, ship) => {
 const getS3Logger = (qpqConfig) => {
     const { bucketName, regionForBucket } = resolveLogTarget(qpqConfig);
     const s3Client = new client_s3_1.S3Client({ region: regionForBucket });
-    return createBufferedLogger(bucketName, regionForBucket, (result) => (0, exports.storyLogger)(result, bucketName, s3Client));
+    return createBufferedLogger(bucketName, regionForBucket, (result) => putStoryResult(result, bucketName, s3Client));
 };
-exports.getS3Logger = getS3Logger;
 // Logs via the qpq-log-extension: a fast local HTTP POST hands the log off so the
 // response is not blocked on S3. Falls back to a direct S3 write if the extension
 // is unreachable, so a log is never silently dropped.
@@ -158,24 +145,28 @@ const getS3LoggerViaExtension = (qpqConfig) => {
         }
         catch (error) {
             console.log(`qpq-log-extension unreachable, writing [${result.correlation}] to S3 directly:`, error);
-            yield (0, exports.storyLogger)(result, bucketName, s3Client);
+            yield putStoryResult(result, bucketName, s3Client);
         }
     }));
 };
-exports.getS3LoggerViaExtension = getS3LoggerViaExtension;
+/**
+ * Picks the story-result logger for this config: a no-op when logging is off (or
+ * when running inside the logs bucket's own file-event lambda, which must never
+ * log its own activity back into the bucket), the direct S3 logger when
+ * `instantLogs` is set or outside a real Lambda, otherwise the log extension.
+ */
 const getLogger = (qpqConfig) => {
     const awsSettings = (0, quidproquo_config_aws_1.getAwsServiceAccountInfoConfig)(qpqConfig);
-    // If we have no log service, just return nothing.
     if (!awsSettings.logServiceName || awsSettings.disableLogs || process.env.storageDriveName === quidproquo_core_1.QPQ_LOGS_STORAGE_DRIVE_NAME) {
         return noopLogger;
     }
     // instantLogs forces the synchronous direct-to-S3 path, bypassing the extension.
     if (awsSettings.instantLogs) {
-        return (0, exports.getS3Logger)(qpqConfig);
+        return getS3Logger(qpqConfig);
     }
     // Use the off-response-path extension when running inside a real Lambda (where it
     // is always attached); otherwise log directly to S3.
-    return process.env.AWS_LAMBDA_RUNTIME_API ? (0, exports.getS3LoggerViaExtension)(qpqConfig) : (0, exports.getS3Logger)(qpqConfig);
+    return process.env.AWS_LAMBDA_RUNTIME_API ? getS3LoggerViaExtension(qpqConfig) : getS3Logger(qpqConfig);
 };
 exports.getLogger = getLogger;
-//# sourceMappingURL=logger.js.map
+//# sourceMappingURL=getLogger.js.map

package/lib/commonjs/lambdaHandlers/helpers/getLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLogger.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/getLogger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,iEAAiH;AACjH,qDAQyB;AAEzB,4CAAoB;AACpB,gDAAwB;AACxB,kDAAuF;AAEvF,yDAAoE;AACpE,8EAA6E;AAE7E,kFAAkF;AAClF,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,MAAM,cAAc,GAAG,CAAO,MAA8B,EAAE,UAAkB,EAAE,QAAkB,EAAiB,EAAE;IACrH,IAAI,CAAC;QACH,MAAM,aAAa,GAA0B;YAC3C,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,OAAO;YACjC,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC5B,YAAY,EAAE,qBAAqB;SACpC,CAAC;QAEF,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,4BAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,CAAC,WAAW,IAAI,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAO,UAAkB,EAAE,MAAc,EAAiB,EAAE;IAC7F,IAAI,CAAC;QACH,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAA2B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAExD,MAAM,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEnD,MAAM,YAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,8CAA8C,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,MAAM,UAAU,GAAc;IAC5B,UAAU,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;IAC1B,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,mBAAmB,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;IACnC,sBAAsB,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;CACvC,CAAC;AAEF,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,CAAC,SAAoB,EAAmD,EAAE;IACjG,MAAM,OAAO,GAAG,IAAA,sDAA8B,EAAC,SAAS,CAAC,CAAC,cAAe,CAAC;IAC1E,MAAM,WAAW,GAAG,8BAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,8BAAY,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,8BAAY,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,IAAA,6CAA4B,EAAC,6CAA2B,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACzH,MAAM,eAAe,GAAG,IAAA,gEAAwC,EAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC;IAElI,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,gFAAgF;AAChF,kEAAkE;AAClE,kFAAkF;AAClF,MAAM,oBAAoB,GAAG,CAAC,UAAkB,EAAE,eAAuB,EAAE,IAAuD,EAAa,EAAE;IAC/I,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,uBAAuB,GAAa,EAAE,CAAC;IAE3C,OAAO;QACL,UAAU,EAAE,CAAO,MAAe,EAAE,MAAc,EAAE,WAAmB,EAAE,EAAE;YACzE,uBAAuB,GAAG,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,uBAAuB,EAAE,WAAW,CAAC,CAAC;QAC9I,CAAC,CAAA;QAED,GAAG,EAAE,CAAC,MAAwB,EAAE,EAAE;YAChC,yFAAyF;YACzF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;iBAC9B,IAAI,CAAC,GAAG,EAAE;gBACT,MAAM,gBAAgB,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;oBAC5E,CAAC,CAAC,MAAM;oBACR,CAAC,iCACM,MAAM,KACT,OAAO,EAAE,IAAA,+CAA6B,EAAC,MAAM,CAAC,OAAO,EAAE;4BACrD,+BAAa,CAAC,MAAM;4BACpB,+BAAa,CAAC,eAAe;4BAC7B,+BAAa,CAAC,mBAAmB;yBAClC,CAAC,GACH,CAAC;gBAEN,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAChC,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;gBACX,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;YAEL,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAED,mBAAmB,EAAE,GAAS,EAAE;YAC9B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAA;QAED,sBAAsB,EAAE,GAAS,EAAE;YACjC,MAAM,0BAA0B,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAChE,CAAC,CAAA;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,iFAAiF;AACjF,8DAA8D;AAC9D,MAAM,WAAW,GAAG,CAAC,SAAoB,EAAa,EAAE;IACtD,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAE3D,OAAO,oBAAoB,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrH,CAAC,CAAC;AAEF,kFAAkF;AAClF,kFAAkF;AAClF,sDAAsD;AACtD,MAAM,uBAAuB,GAAG,CAAC,SAAoB,EAAa,EAAE;IAClE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAE3D,MAAM,eAAe,GAAG,CAAO,MAA8B,EAAiB,EAAE;QAC9E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,qCAAkB,MAAM,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,UAAU;gBACV,MAAM,EAAE,eAAe;gBACvB,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,OAAO;gBACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAC5B,YAAY,EAAE,qBAAqB;aACpC,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAA,CAAC;IAEF,OAAO,oBAAoB,CAAC,UAAU,EAAE,eAAe,EAAE,CAAO,MAAM,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,2CAA2C,MAAM,CAAC,WAAW,mBAAmB,EAAE,KAAK,CAAC,CAAC;YACrG,MAAM,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAA,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,SAAS,GAAG,CAAC,SAAoB,EAAa,EAAE;IAC3D,MAAM,WAAW,GAAG,IAAA,sDAA8B,EAAC,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC,WAAW,CAAC,cAAc,IAAI,WAAW,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,6CAA2B,EAAE,CAAC;QAC3H,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iFAAiF;IACjF,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,kFAAkF;IAClF,qDAAqD;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AAC1G,CAAC,CAAC;AAfW,QAAA,SAAS,aAepB","sourcesContent":["import { getAwsServiceAccountInfoByDeploymentInfo, getAwsServiceAccountInfoConfig } from 'quidproquo-config-aws';\nimport {\n  filterLogHistoryByActionTypes,\n  LogActionType,\n  QPQ_LOGS_STORAGE_DRIVE_NAME,\n  QPQConfig,\n  qpqCoreUtils,\n  QpqLogger,\n  StoryResult,\n} from 'quidproquo-core';\n\nimport fs from 'fs';\nimport path from 'path';\nimport { PutObjectCommand, PutObjectCommandInput, S3Client } from '@aws-sdk/client-s3';\n\nimport { getConfigRuntimeResourceName } from '../../awsNamingUtils';\nimport { LOG_EXTENSION_PORT } from '../../lambdaExtensions/logExtensionPort';\n\n// Where the old fs-buffered logger parked results. Nothing writes here today, but\n// moveToPermanentStorage still sweeps it so any stragglers from an older deploy\n// (or a future fs buffer) get shipped rather than lost.\nconst tempDirectory = '/tmp/qpqlogs';\n\nconst putStoryResult = async (result: StoryResult<unknown[]>, bucketName: string, s3Client: S3Client): Promise<void> => {\n  try {\n    const commandParams: PutObjectCommandInput = {\n      Key: `${result.correlation}.json`,\n      Bucket: bucketName,\n      Body: JSON.stringify(result),\n      StorageClass: 'INTELLIGENT_TIERING',\n    };\n\n    await s3Client.send(new PutObjectCommand(commandParams));\n  } catch (error) {\n    console.log(`Failed to log story result to S3 [${result.correlation}]:`, error);\n  }\n};\n\nconst moveLogsToPermanentStorage = async (bucketName: string, region: string): Promise<void> => {\n  try {\n    await fs.promises.mkdir(tempDirectory, { recursive: true });\n    const files = await fs.promises.readdir(tempDirectory);\n\n    const s3Client = new S3Client({ region });\n\n    for (const file of files) {\n      const filePath = path.join(tempDirectory, file);\n      const data = await fs.promises.readFile(filePath, 'utf-8');\n      const result: StoryResult<unknown[]> = JSON.parse(data);\n\n      await putStoryResult(result, bucketName, s3Client);\n\n      await fs.promises.unlink(filePath);\n      console.log(`Moved log file [${file}] to S3 and deleted from temporary directory`);\n    }\n  } catch (error) {\n    console.error('Failed to move logs to permanent storage');\n    console.error(error);\n  }\n};\n\nconst noopLogger: QpqLogger = {\n  enableLogs: async () => {},\n  log: () => {},\n  waitToFinishWriting: async () => {},\n  moveToPermanentStorage: async () => {},\n};\n\n// Resolves which S3 bucket (and its region) story logs go to for this config.\n// Only called after getLogger has checked logServiceName is set, hence the `!`.\nconst resolveLogTarget = (qpqConfig: QPQConfig): { bucketName: string; regionForBucket: string } => {\n  const service = getAwsServiceAccountInfoConfig(qpqConfig).logServiceName!;\n  const application = qpqCoreUtils.getApplicationName(qpqConfig);\n  const environment = qpqCoreUtils.getApplicationModuleEnvironment(qpqConfig);\n  const feature = qpqCoreUtils.getApplicationModuleFeature(qpqConfig);\n\n  const bucketName = getConfigRuntimeResourceName(QPQ_LOGS_STORAGE_DRIVE_NAME, application, service, environment, feature);\n  const regionForBucket = getAwsServiceAccountInfoByDeploymentInfo(qpqConfig, service, environment, feature, application).awsRegion;\n\n  return { bucketName, regionForBucket };\n};\n\n// Shared plumbing for both loggers: defers each log to a microtask, applies the\n// disabled-correlation history filter, and tracks the promises so\n// waitToFinishWriting can await them. Only `ship` (how a log reaches S3) differs.\nconst createBufferedLogger = (bucketName: string, regionForBucket: string, ship: (result: StoryResult<unknown[]>) => Promise<void>): QpqLogger => {\n  const logs: Promise<void>[] = [];\n  let disabledLogCorrelations: string[] = [];\n\n  return {\n    enableLogs: async (enable: boolean, reason: string, correlation: string) => {\n      disabledLogCorrelations = enable ? disabledLogCorrelations.filter((dlc) => dlc !== correlation) : [...disabledLogCorrelations, correlation];\n    },\n\n    log: (result: StoryResult<any>) => {\n      // Defer all work (including JSON.stringify) to a microtask so the caller is not blocked.\n      const promise = Promise.resolve()\n        .then(() => {\n          const modifyableResult = !disabledLogCorrelations.includes(result.correlation)\n            ? result\n            : {\n                ...result,\n                history: filterLogHistoryByActionTypes(result.history, [\n                  LogActionType.Create,\n                  LogActionType.TemplateLiteral,\n                  LogActionType.DisableEventHistory,\n                ]),\n              };\n\n          return ship(modifyableResult);\n        })\n        .catch((e) => {\n          console.log('Failed to log story result to S3', JSON.stringify(e, null, 2));\n        });\n\n      logs.push(promise);\n    },\n\n    waitToFinishWriting: async () => {\n      await Promise.all(logs);\n    },\n\n    moveToPermanentStorage: async () => {\n      await moveLogsToPermanentStorage(bucketName, regionForBucket);\n    },\n  };\n};\n\n// Logs straight to S3: the handler awaits the PutObject itself. Simple and fully\n// durable, but the invoke waits on S3. No extension required.\nconst getS3Logger = (qpqConfig: QPQConfig): QpqLogger => {\n  const { bucketName, regionForBucket } = resolveLogTarget(qpqConfig);\n  const s3Client = new S3Client({ region: regionForBucket });\n\n  return createBufferedLogger(bucketName, regionForBucket, (result) => putStoryResult(result, bucketName, s3Client));\n};\n\n// Logs via the qpq-log-extension: a fast local HTTP POST hands the log off so the\n// response is not blocked on S3. Falls back to a direct S3 write if the extension\n// is unreachable, so a log is never silently dropped.\nconst getS3LoggerViaExtension = (qpqConfig: QPQConfig): QpqLogger => {\n  const { bucketName, regionForBucket } = resolveLogTarget(qpqConfig);\n  const s3Client = new S3Client({ region: regionForBucket });\n\n  const sendToExtension = async (result: StoryResult<unknown[]>): Promise<void> => {\n    const res = await fetch(`http://127.0.0.1:${LOG_EXTENSION_PORT}/log`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        bucketName,\n        region: regionForBucket,\n        key: `${result.correlation}.json`,\n        body: JSON.stringify(result),\n        storageClass: 'INTELLIGENT_TIERING',\n      }),\n    });\n\n    if (!res.ok) {\n      throw new Error(`extension responded ${res.status}`);\n    }\n  };\n\n  return createBufferedLogger(bucketName, regionForBucket, async (result) => {\n    try {\n      await sendToExtension(result);\n    } catch (error) {\n      console.log(`qpq-log-extension unreachable, writing [${result.correlation}] to S3 directly:`, error);\n      await putStoryResult(result, bucketName, s3Client);\n    }\n  });\n};\n\n/**\n * Picks the story-result logger for this config: a no-op when logging is off (or\n * when running inside the logs bucket's own file-event lambda, which must never\n * log its own activity back into the bucket), the direct S3 logger when\n * `instantLogs` is set or outside a real Lambda, otherwise the log extension.\n */\nexport const getLogger = (qpqConfig: QPQConfig): QpqLogger => {\n  const awsSettings = getAwsServiceAccountInfoConfig(qpqConfig);\n\n  if (!awsSettings.logServiceName || awsSettings.disableLogs || process.env.storageDriveName === QPQ_LOGS_STORAGE_DRIVE_NAME) {\n    return noopLogger;\n  }\n\n  // instantLogs forces the synchronous direct-to-S3 path, bypassing the extension.\n  if (awsSettings.instantLogs) {\n    return getS3Logger(qpqConfig);\n  }\n\n  // Use the off-response-path extension when running inside a real Lambda (where it\n  // is always attached); otherwise log directly to S3.\n  return process.env.AWS_LAMBDA_RUNTIME_API ? getS3LoggerViaExtension(qpqConfig) : getS3Logger(qpqConfig);\n};\n"]}

package/lib/commonjs/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.d.ts

@@ -1,4 +1,8 @@
 import { ActionProcessorListResolver, askProcessEvent, DynamicModuleLoader, QPQConfig, QpqRuntimeType, StorySession } from 'quidproquo-core';
 import { Context } from 'aws-lambda';
 import { QpqFunctionExecutionEvent } from '../types';
+/**
+ * Builds the shared lambda handler: wires a qpq runtime for the event type,
+ * short-circuits SNS warmer pings, runs the process-event story and ships logs.
+ */
 export declare const getQpqLambdaRuntimeForEvent: <E extends QpqFunctionExecutionEvent<any>>(runtimeType: QpqRuntimeType, getStorySession: (event: E) => StorySession, getActionProcessorList: ActionProcessorListResolver, dynamicModuleLoader: DynamicModuleLoader, qpqConfig: QPQConfig, getProcessEventStory?: () => typeof askProcessEvent) => (event: E, context: Context) => Promise<any>;

package/lib/commonjs/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.js

@@ -14,8 +14,12 @@ const quidproquo_actionprocessor_js_1 = require("quidproquo-actionprocessor-js")
 const quidproquo_core_1 = require("quidproquo-core");
 const getActionProcessor_1 = require("../../getActionProcessor");
 const dynamicModuleLoaderWarmer_1 = require("./dynamicModuleLoaderWarmer");
+const getLogger_1 = require("./getLogger");
 const getRuntimeCorrelation_1 = require("./getRuntimeCorrelation");
-const logger_1 = require("./logger");
+const isSnsWarmerRecord_1 = require("./isSnsWarmerRecord");
+// SQS/S3/CloudFront events also have a Records array, so this matches more than
+// real SNS events. That is harmless: the warmer scan below only acts on records
+// whose EventSource is 'aws:sns', everything else falls through to processEvent.
 const isSnsEvent = (event) => {
     if (event && typeof event === 'object') {
         const possibleSnsEvent = event;
@@ -23,13 +27,18 @@ const isSnsEvent = (event) => {
     }
     return false;
 };
+/**
+ * Builds the shared lambda handler: wires a qpq runtime for the event type,
+ * short-circuits SNS warmer pings, runs the process-event story and ships logs.
+ */
 const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getActionProcessorList, dynamicModuleLoader, qpqConfig, getProcessEventStory = () => quidproquo_core_1.askProcessEvent) => {
+    const resolveActionProcessorList = () => __awaiter(void 0, void 0, void 0, function* () {
+        return (Object.assign(Object.assign(Object.assign({}, (yield (0, getActionProcessor_1.getAwsActionProcessors)(qpqConfig, dynamicModuleLoader))), (yield getActionProcessorList(qpqConfig, dynamicModuleLoader))), (yield (0, quidproquo_actionprocessor_js_1.getCustomActionActionProcessor)(qpqConfig, dynamicModuleLoader))));
+    });
     return (event, context) => __awaiter(void 0, void 0, void 0, function* () {
         console.log('tick: ', JSON.stringify(event, null, 2));
-        const logger = (0, logger_1.getLogger)(qpqConfig);
-        const resolveStory = (0, quidproquo_core_1.createRuntime)(qpqConfig, getStorySession(event), () => __awaiter(void 0, void 0, void 0, function* () {
-            return (Object.assign(Object.assign(Object.assign({}, (yield (0, getActionProcessor_1.getAwsActionProcessors)(qpqConfig, dynamicModuleLoader))), (yield getActionProcessorList(qpqConfig, dynamicModuleLoader))), (yield (0, quidproquo_actionprocessor_js_1.getCustomActionActionProcessor)(qpqConfig, dynamicModuleLoader))));
-        }), () => new Date().toISOString(), logger, (0, getRuntimeCorrelation_1.getRuntimeCorrelation)(qpqConfig), runtimeType, dynamicModuleLoader);
+        const logger = (0, getLogger_1.getLogger)(qpqConfig);
+        const resolveStory = (0, quidproquo_core_1.createRuntime)(qpqConfig, getStorySession(event), resolveActionProcessorList, () => new Date().toISOString(), logger, (0, getRuntimeCorrelation_1.getRuntimeCorrelation)(qpqConfig), runtimeType, dynamicModuleLoader);
         const processEvent = () => __awaiter(void 0, void 0, void 0, function* () {
             const result = yield resolveStory(getProcessEventStory(), [event, context]);
             yield logger.waitToFinishWriting();
@@ -40,9 +49,9 @@ const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getActionProc
             return result.result;
         });
         if (isSnsEvent(event)) {
-            // Non warmer records
-            const recordsNoWarm = event.Records.filter((record) => record.EventSource !== 'aws:sns' || JSON.parse(record.Sns.Message).type !== 'QpqLambdaWarmerEvent');
-            // if we have found some warmers - then we need to warm the lambda
+            const recordsNoWarm = event.Records.filter((record) => !(0, isSnsWarmerRecord_1.isSnsWarmerRecord)(record));
+            // A warmer ping arrives as its own single-record SNS event; any warmer
+            // present means this invoke exists only to keep the sandbox warm.
             if (recordsNoWarm.length !== event.Records.length) {
                 console.log('Found SNS warmer');
                 // TODO: Warm qpq things with dynamic functions
@@ -52,11 +61,6 @@ const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getActionProc
                 yield logger.moveToPermanentStorage();
                 return 'Warmed up!';
             }
-            // If we have events that are not warmers, then we should execute them
-            if (recordsNoWarm.length > 0) {
-                console.log('Running other actions');
-                return yield processEvent();
-            }
         }
         return yield processEvent();
     });

package/lib/commonjs/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"getQpqLambdaRuntimeForEvent.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.ts"],"names":[],"mappings":"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","sourcesContent":["import { getCustomActionActionProcessor } from 'quidproquo-actionprocessor-js';\nimport {\n  ActionProcessorListResolver,\n  askProcessEvent,\n  createRuntime,\n  DynamicModuleLoader,\n  QPQConfig,\n  QpqRuntimeType,\n  StorySession,\n} from 'quidproquo-core';\n\nimport { Context } from 'aws-lambda';\nimport { SNSEvent } from 'aws-lambda';\n\nimport { getAwsActionProcessors } from '../../getActionProcessor';\nimport { QpqFunctionExecutionEvent } from '../types';\nimport { dynamicModuleLoaderWarmer } from './dynamicModuleLoaderWarmer';\nimport { getRuntimeCorrelation } from './getRuntimeCorrelation';\nimport { getLogger } from './logger';\n\nconst isSnsEvent = <T>(event: QpqFunctionExecutionEvent<T>): event is SNSEvent => {\n  if (event && typeof event === 'object') {\n    const possibleSnsEvent = event as unknown as SNSEvent;\n    return possibleSnsEvent.Records && Array.isArray(possibleSnsEvent.Records);\n  }\n\n  return false;\n};\n\nexport const getQpqLambdaRuntimeForEvent = <E extends QpqFunctionExecutionEvent<any>>(\n  runtimeType: QpqRuntimeType,\n  getStorySession: (event: E) => StorySession,\n  getActionProcessorList: ActionProcessorListResolver,\n  dynamicModuleLoader: DynamicModuleLoader,\n  qpqConfig: QPQConfig,\n  getProcessEventStory: () => typeof askProcessEvent = () => askProcessEvent,\n) => {\n  return async (event: E, context: Context) => {\n    console.log('tick: ', JSON.stringify(event, null, 2));\n\n    const logger = getLogger(qpqConfig);\n\n    const resolveStory = createRuntime(\n      qpqConfig,\n      getStorySession(event),\n      async () => ({\n        ...(await getAwsActionProcessors(qpqConfig, dynamicModuleLoader)),\n        ...(await getActionProcessorList(qpqConfig, dynamicModuleLoader)),\n\n        // Always done last, so they can ovveride the default ones if the user wants.\n        ...(await getCustomActionActionProcessor(qpqConfig, dynamicModuleLoader)),\n      }),\n      () => new Date().toISOString(),\n      logger,\n      getRuntimeCorrelation(qpqConfig),\n      runtimeType,\n      dynamicModuleLoader,\n    );\n\n    const processEvent = async () => {\n      const result = await resolveStory(getProcessEventStory(), [event, context]);\n      await logger.waitToFinishWriting();\n\n      if (result.error) {\n        throw new Error(result.error.errorText);\n      }\n\n      console.log('Finished, returning: ', result.result);\n      return result.result;\n    };\n\n    if (isSnsEvent(event)) {\n      // Non warmer records\n      const recordsNoWarm = event.Records.filter(\n        (record) => record.EventSource !== 'aws:sns' || JSON.parse(record.Sns.Message).type !== 'QpqLambdaWarmerEvent',\n      );\n\n      // if we have found some warmers - then we need to warm the lambda\n      if (recordsNoWarm.length !== event.Records.length) {\n        console.log('Found SNS warmer');\n\n        // TODO: Warm qpq things with dynamic functions\n        // federate in dynamic modules\n        await dynamicModuleLoaderWarmer();\n\n        // Might as well move the logs to permanent storage\n        await logger.moveToPermanentStorage();\n\n        return 'Warmed up!';\n      }\n\n      // If we have events that are not warmers, then we should execute them\n      if (recordsNoWarm.length > 0) {\n        console.log('Running other actions');\n\n        return await processEvent();\n      }\n    }\n\n    return await processEvent();\n  };\n};\n"]}
+{"version":3,"file":"getQpqLambdaRuntimeForEvent.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.ts"],"names":[],"mappings":"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","sourcesContent":["import { getCustomActionActionProcessor } from 'quidproquo-actionprocessor-js';\nimport {\n  ActionProcessorList,\n  ActionProcessorListResolver,\n  askProcessEvent,\n  createRuntime,\n  DynamicModuleLoader,\n  QPQConfig,\n  QpqRuntimeType,\n  StorySession,\n} from 'quidproquo-core';\n\nimport { Context, SNSEvent } from 'aws-lambda';\n\nimport { getAwsActionProcessors } from '../../getActionProcessor';\nimport { QpqFunctionExecutionEvent } from '../types';\nimport { dynamicModuleLoaderWarmer } from './dynamicModuleLoaderWarmer';\nimport { getLogger } from './getLogger';\nimport { getRuntimeCorrelation } from './getRuntimeCorrelation';\nimport { isSnsWarmerRecord } from './isSnsWarmerRecord';\n\n// SQS/S3/CloudFront events also have a Records array, so this matches more than\n// real SNS events. That is harmless: the warmer scan below only acts on records\n// whose EventSource is 'aws:sns', everything else falls through to processEvent.\nconst isSnsEvent = <T>(event: QpqFunctionExecutionEvent<T>): event is SNSEvent => {\n  if (event && typeof event === 'object') {\n    const possibleSnsEvent = event as unknown as SNSEvent;\n    return possibleSnsEvent.Records && Array.isArray(possibleSnsEvent.Records);\n  }\n\n  return false;\n};\n\n/**\n * Builds the shared lambda handler: wires a qpq runtime for the event type,\n * short-circuits SNS warmer pings, runs the process-event story and ships logs.\n */\nexport const getQpqLambdaRuntimeForEvent = <E extends QpqFunctionExecutionEvent<any>>(\n  runtimeType: QpqRuntimeType,\n  getStorySession: (event: E) => StorySession,\n  getActionProcessorList: ActionProcessorListResolver,\n  dynamicModuleLoader: DynamicModuleLoader,\n  qpqConfig: QPQConfig,\n  getProcessEventStory: () => typeof askProcessEvent = () => askProcessEvent,\n) => {\n  const resolveActionProcessorList = async (): Promise<ActionProcessorList> => ({\n    ...(await getAwsActionProcessors(qpqConfig, dynamicModuleLoader)),\n    ...(await getActionProcessorList(qpqConfig, dynamicModuleLoader)),\n\n    // Always done last, so they can override the default ones if the user wants.\n    ...(await getCustomActionActionProcessor(qpqConfig, dynamicModuleLoader)),\n  });\n\n  return async (event: E, context: Context) => {\n    console.log('tick: ', JSON.stringify(event, null, 2));\n\n    const logger = getLogger(qpqConfig);\n\n    const resolveStory = createRuntime(\n      qpqConfig,\n      getStorySession(event),\n      resolveActionProcessorList,\n      () => new Date().toISOString(),\n      logger,\n      getRuntimeCorrelation(qpqConfig),\n      runtimeType,\n      dynamicModuleLoader,\n    );\n\n    const processEvent = async () => {\n      const result = await resolveStory(getProcessEventStory(), [event, context]);\n      await logger.waitToFinishWriting();\n\n      if (result.error) {\n        throw new Error(result.error.errorText);\n      }\n\n      console.log('Finished, returning: ', result.result);\n      return result.result;\n    };\n\n    if (isSnsEvent(event)) {\n      const recordsNoWarm = event.Records.filter((record) => !isSnsWarmerRecord(record));\n\n      // A warmer ping arrives as its own single-record SNS event; any warmer\n      // present means this invoke exists only to keep the sandbox warm.\n      if (recordsNoWarm.length !== event.Records.length) {\n        console.log('Found SNS warmer');\n\n        // TODO: Warm qpq things with dynamic functions\n        // federate in dynamic modules\n        await dynamicModuleLoaderWarmer();\n\n        // Might as well move the logs to permanent storage\n        await logger.moveToPermanentStorage();\n\n        return 'Warmed up!';\n      }\n    }\n\n    return await processEvent();\n  };\n};\n"]}

package/lib/commonjs/lambdaHandlers/helpers/index.d.ts

@@ -1,4 +1,6 @@
 export * from './dynamicModuleLoaderWarmer';
+export * from './getBlankStorySession';
+export * from './getLogger';
 export * from './getQpqLambdaRuntimeForEvent';
 export * from './getRuntimeCorrelation';
-export * from './logger';
+export * from './isSnsWarmerRecord';

package/lib/commonjs/lambdaHandlers/helpers/index.js

@@ -15,7 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./dynamicModuleLoaderWarmer"), exports);
+__exportStar(require("./getBlankStorySession"), exports);
+__exportStar(require("./getLogger"), exports);
 __exportStar(require("./getQpqLambdaRuntimeForEvent"), exports);
 __exportStar(require("./getRuntimeCorrelation"), exports);
-__exportStar(require("./logger"), exports);
+__exportStar(require("./isSnsWarmerRecord"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/lambdaHandlers/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,gEAA8C;AAC9C,0DAAwC;AACxC,2CAAyB","sourcesContent":["export * from './dynamicModuleLoaderWarmer';\nexport * from './getQpqLambdaRuntimeForEvent';\nexport * from './getRuntimeCorrelation';\nexport * from './logger';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,yDAAuC;AACvC,8CAA4B;AAC5B,gEAA8C;AAC9C,0DAAwC;AACxC,sDAAoC","sourcesContent":["export * from './dynamicModuleLoaderWarmer';\nexport * from './getBlankStorySession';\nexport * from './getLogger';\nexport * from './getQpqLambdaRuntimeForEvent';\nexport * from './getRuntimeCorrelation';\nexport * from './isSnsWarmerRecord';\n"]}

package/lib/commonjs/lambdaHandlers/helpers/isSnsWarmerRecord.d.ts

@@ -0,0 +1,6 @@
+import { SNSEventRecord } from 'aws-lambda';
+/**
+ * True when an SNS record is a lambda warmer ping published by the bootstrap
+ * warmer schedule (BSQpqLambdaWarmerEventConstruct sends `{ type: 'QpqLambdaWarmerEvent' }`).
+ */
+export declare const isSnsWarmerRecord: (record: SNSEventRecord) => boolean;

package/lib/commonjs/lambdaHandlers/helpers/isSnsWarmerRecord.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSnsWarmerRecord = void 0;
+/**
+ * True when an SNS record is a lambda warmer ping published by the bootstrap
+ * warmer schedule (BSQpqLambdaWarmerEventConstruct sends `{ type: 'QpqLambdaWarmerEvent' }`).
+ */
+const isSnsWarmerRecord = (record) => {
+    if (record.EventSource !== 'aws:sns') {
+        return false;
+    }
+    // Message is whatever the topic's publisher sent; a non-JSON or non-object
+    // message is simply not a warmer, it must not crash the invoke.
+    try {
+        const message = JSON.parse(record.Sns.Message);
+        return typeof message === 'object' && message !== null && message.type === 'QpqLambdaWarmerEvent';
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isSnsWarmerRecord = isSnsWarmerRecord;
+//# sourceMappingURL=isSnsWarmerRecord.js.map

package/lib/commonjs/lambdaHandlers/helpers/isSnsWarmerRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSnsWarmerRecord.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/isSnsWarmerRecord.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,MAAsB,EAAW,EAAE;IACnE,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,CAAC;QACH,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAK,OAA8B,CAAC,IAAI,KAAK,sBAAsB,CAAC;IAC5H,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAbW,QAAA,iBAAiB,qBAa5B","sourcesContent":["import { SNSEventRecord } from 'aws-lambda';\n\n/**\n * True when an SNS record is a lambda warmer ping published by the bootstrap\n * warmer schedule (BSQpqLambdaWarmerEventConstruct sends `{ type: 'QpqLambdaWarmerEvent' }`).\n */\nexport const isSnsWarmerRecord = (record: SNSEventRecord): boolean => {\n  if (record.EventSource !== 'aws:sns') {\n    return false;\n  }\n\n  // Message is whatever the topic's publisher sent; a non-JSON or non-object\n  // message is simply not a warmer, it must not crash the invoke.\n  try {\n    const message: unknown = JSON.parse(record.Sns.Message);\n    return typeof message === 'object' && message !== null && (message as { type?: unknown }).type === 'QpqLambdaWarmerEvent';\n  } catch {\n    return false;\n  }\n};\n"]}

package/lib/commonjs/lambdaHandlers/types/QpqFunctionExecutionEvent.d.ts

@@ -0,0 +1,7 @@
+import { SNSEvent } from 'aws-lambda';
+/**
+ * What a qpq lambda can actually receive: its own trigger's event type, or an
+ * SNS event, because every lambda is also subscribed to the bootstrap warmer
+ * topic (see isSnsWarmerRecord / getQpqLambdaRuntimeForEvent).
+ */
+export type QpqFunctionExecutionEvent<T> = SNSEvent | T;

package/lib/commonjs/lambdaHandlers/types/QpqFunctionExecutionEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=QpqFunctionExecutionEvent.js.map

package/lib/commonjs/lambdaHandlers/types/QpqFunctionExecutionEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqFunctionExecutionEvent.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/types/QpqFunctionExecutionEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { SNSEvent } from 'aws-lambda';\n\n/**\n * What a qpq lambda can actually receive: its own trigger's event type, or an\n * SNS event, because every lambda is also subscribed to the bootstrap warmer\n * topic (see isSnsWarmerRecord / getQpqLambdaRuntimeForEvent).\n */\nexport type QpqFunctionExecutionEvent<T> = SNSEvent | T;\n"]}

package/lib/commonjs/lambdaHandlers/types/index.d.ts

@@ -1 +1 @@
-export * from './QpqWarmLambdaEvent';
+export * from './QpqFunctionExecutionEvent';

package/lib/commonjs/lambdaHandlers/types/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./QpqWarmLambdaEvent"), exports);
+__exportStar(require("./QpqFunctionExecutionEvent"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/lambdaHandlers/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from './QpqWarmLambdaEvent';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C","sourcesContent":["export * from './QpqFunctionExecutionEvent';\n"]}

package/lib/commonjs/lambdas/anyExecuteServiceFunctionEvent_serviceFunction.d.ts

@@ -1,3 +1,3 @@
-export declare const anyExecuteServiceFunctionEvent_serviceFunction: (event: import("quidproquo-webserver").ExecuteServiceFunctionEvent<any[]> & {
+export declare const anyExecuteServiceFunctionEvent_serviceFunction: (event: import("quidproquo-webserver").ExecuteServiceFunctionEvent<unknown[]> & {
     storySession: import("quidproquo-core").StorySession;
 }, context: import("aws-lambda").Context) => Promise<any>;

package/lib/commonjs/lambdas/cloudFrontRequestEvent_viewerRequest.js

@@ -2,6 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cloudFrontRequestEvent_viewerRequest = void 0;
 const lambdaHandlers_1 = require("../lambdaHandlers");
-// Default executor
 exports.cloudFrontRequestEvent_viewerRequest = (0, lambdaHandlers_1.getCloudFrontRequestEvent_viewerRequest)();
 //# sourceMappingURL=cloudFrontRequestEvent_viewerRequest.js.map

package/lib/commonjs/lambdas/cloudFrontRequestEvent_viewerRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudFrontRequestEvent_viewerRequest.js","sourceRoot":"","sources":["../../../src/lambdas/cloudFrontRequestEvent_viewerRequest.ts"],"names":[],"mappings":";;;AAAA,sDAA4E;AAC5E,mBAAmB;AACN,QAAA,oCAAoC,GAAG,IAAA,wDAAuC,GAAE,CAAC","sourcesContent":["import { getCloudFrontRequestEvent_viewerRequest } from '../lambdaHandlers';\n// Default executor\nexport const cloudFrontRequestEvent_viewerRequest = getCloudFrontRequestEvent_viewerRequest();\n"]}
+{"version":3,"file":"cloudFrontRequestEvent_viewerRequest.js","sourceRoot":"","sources":["../../../src/lambdas/cloudFrontRequestEvent_viewerRequest.ts"],"names":[],"mappings":";;;AAAA,sDAA4E;AAE/D,QAAA,oCAAoC,GAAG,IAAA,wDAAuC,GAAE,CAAC","sourcesContent":["import { getCloudFrontRequestEvent_viewerRequest } from '../lambdaHandlers';\n\nexport const cloudFrontRequestEvent_viewerRequest = getCloudFrontRequestEvent_viewerRequest();\n"]}

package/lib/commonjs/lambdas/dynamicModuleLoader/dynamicModuleLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicModuleLoader.js","sourceRoot":"","sources":["../../../../src/lambdas/dynamicModuleLoader/dynamicModuleLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;AAsBA,0EAA0E;AAC1E,yEAA8E;AAE9E,2EAAsE;AAE/D,MAAM,mBAAmB,GAAG,CAAgB,kBAAsC,EAAc,EAAE;IACvG,2FAA2F;IAC3F,MAAM,cAAc,GAAG,MAAM,IAAA,yCAAkB,EAAI,qCAAS,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gFAAgF;IAChF,OAAO,IAAA,kDAAsB,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC,CAAA,CAAC;AATW,QAAA,mBAAmB,uBAS9B","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// The dynamic module loader — the single seam every lambda entry uses to turn a\n// QpqFunctionRuntime (e.g. \"/src/routes/getOrders::getOrders\") into the actual\n// story function to run. Each lambda entry file (apiGatewayEventHandler, etc.)\n// imports THIS and hands it to the qpq runtime.\n//\n// Two tiers, tried in order:\n//   1. FEDERATED  — loadFederatedStory reads the service's code bucket and returns\n//                   the published version of the story (see ../../logic/\n//                   federatedModuleStore/loadFederatedStory.ts for the whole flow).\n//   2. BUNDLED    — qpqDynamicModuleLoader is a build-time-generated function\n//                   (the 'quidproquo-dynamic-loader' virtual module, produced by the\n//                   deploy-webpack/deploy-rspack QpqPlugin) — an if-chain that\n//                   require()s the story code statically bundled into the lambda zip.\n//\n// loadFederatedStory returns undefined on any miss (no store configured, nothing\n// published, runtime not in the manifest), which is the signal to fall back to the\n// bundled tier. If the service opted into `bundleFallback: false` (a \"thin shell\"),\n// the bundled tier itself throws instead of resolving — so an unpublished thin shell\n// fails loudly rather than silently serving stale code.\n// ─────────────────────────────────────────────────────────────────────────────\nimport { QpqFunctionRuntime } from 'quidproquo-core';\n// @ts-expect-error - injected at build time by QpqPlugin (virtual module)\nimport { qpqConfig, qpqDynamicModuleLoader } from 'quidproquo-dynamic-loader';\n\nimport { loadFederatedStory } from '../../logic/federatedModuleStore';\n\nexport const dynamicModuleLoader = async <T = any>(qpqFunctionRuntime: QpqFunctionRuntime): Promise<T> => {\n  // Tier 1: federated. undefined means \"nothing published for this runtime\" -> fall through.\n  const federatedStory = await loadFederatedStory<T>(qpqConfig, qpqFunctionRuntime);\n  if (federatedStory !== undefined) {\n    return federatedStory;\n  }\n\n  // Tier 2: the statically bundled story (or a fail-fast throw for a thin shell).\n  return qpqDynamicModuleLoader(qpqFunctionRuntime);\n};\n"]}
+{"version":3,"file":"dynamicModuleLoader.js","sourceRoot":"","sources":["../../../../src/lambdas/dynamicModuleLoader/dynamicModuleLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;AAsBA,0EAA0E;AAC1E,yEAA8E;AAE9E,2EAAsE;AAE/D,MAAM,mBAAmB,GAAG,CAAgB,kBAAsC,EAAc,EAAE;IACvG,2FAA2F;IAC3F,MAAM,cAAc,GAAG,MAAM,IAAA,yCAAkB,EAAI,qCAAS,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gFAAgF;IAChF,OAAO,IAAA,kDAAsB,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC,CAAA,CAAC;AATW,QAAA,mBAAmB,uBAS9B","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// The dynamic module loader: the single seam every lambda entry uses to turn a\n// QpqFunctionRuntime (e.g. \"/src/routes/getOrders::getOrders\") into the actual\n// story function to run. Each lambda entry file (apiGatewayEventHandler, etc.)\n// imports THIS and hands it to the qpq runtime.\n//\n// Two tiers, tried in order:\n//   1. FEDERATED  : loadFederatedStory reads the service's code bucket and returns\n//                   the published version of the story (see ../../logic/\n//                   federatedModuleStore/loadFederatedStory.ts for the whole flow).\n//   2. BUNDLED    : qpqDynamicModuleLoader is a build-time-generated function\n//                   (the 'quidproquo-dynamic-loader' virtual module, produced by the\n//                   deploy-webpack/deploy-rspack QpqPlugin), an if-chain that\n//                   require()s the story code statically bundled into the lambda zip.\n//\n// loadFederatedStory returns undefined on any miss (no store configured, nothing\n// published, runtime not in the manifest), which is the signal to fall back to the\n// bundled tier. If the service opted into `bundleFallback: false` (a \"thin shell\"),\n// the bundled tier itself throws instead of resolving, so an unpublished thin shell\n// fails loudly rather than silently serving stale code.\n// ─────────────────────────────────────────────────────────────────────────────\nimport { QpqFunctionRuntime } from 'quidproquo-core';\n// @ts-expect-error - injected at build time by QpqPlugin (virtual module)\nimport { qpqConfig, qpqDynamicModuleLoader } from 'quidproquo-dynamic-loader';\n\nimport { loadFederatedStory } from '../../logic/federatedModuleStore';\n\nexport const dynamicModuleLoader = async <T = any>(qpqFunctionRuntime: QpqFunctionRuntime): Promise<T> => {\n  // Tier 1: federated. undefined means \"nothing published for this runtime\" -> fall through.\n  const federatedStory = await loadFederatedStory<T>(qpqConfig, qpqFunctionRuntime);\n  if (federatedStory !== undefined) {\n    return federatedStory;\n  }\n\n  // Tier 2: the statically bundled story (or a fail-fast throw for a thin shell).\n  return qpqDynamicModuleLoader(qpqFunctionRuntime);\n};\n"]}

package/lib/commonjs/lambdas/dynamicModuleLoader/index.d.ts

@@ -1,2 +1 @@
 export * from './dynamicModuleLoader';
-export * from './dynamicModuleLoaderWarmer';

package/lib/commonjs/lambdas/dynamicModuleLoader/index.js

@@ -15,5 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./dynamicModuleLoader"), exports);
-__exportStar(require("./dynamicModuleLoaderWarmer"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/lambdas/dynamicModuleLoader/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdas/dynamicModuleLoader/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,8DAA4C","sourcesContent":["export * from './dynamicModuleLoader';\nexport * from './dynamicModuleLoaderWarmer';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdas/dynamicModuleLoader/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC","sourcesContent":["export * from './dynamicModuleLoader';\n"]}

package/lib/commonjs/lambdas/index.js

@@ -1,2 +1,6 @@
 "use strict";
+// Deliberately empty. The files in this folder are bundler ENTRY POINTS, not
+// library code: each one imports the 'quidproquo-dynamic-loader' virtual module
+// that only exists inside a deploy bundle (see getLambdaEntries.ts). Re-exporting
+// them here would drag that unresolvable import into the package's own surface.
 //# sourceMappingURL=index.js.map

package/lib/commonjs/lambdas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lambdas/index.ts"],"names":[],"mappings":"","sourcesContent":[""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lambdas/index.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF","sourcesContent":["// Deliberately empty. The files in this folder are bundler ENTRY POINTS, not\n// library code: each one imports the 'quidproquo-dynamic-loader' virtual module\n// that only exists inside a deploy bundle (see getLambdaEntries.ts). Re-exporting\n// them here would drag that unresolvable import into the package's own surface.\n"]}

package/lib/commonjs/logic/apiGateway/sendMessageToWebSocketConnection.d.ts

@@ -0,0 +1,2 @@
+/** JSON-serialises the payload and posts it to one websocket connection. */
+export declare const sendMessageToWebSocketConnection: (apiId: string, connectionId: string, region: string, payload: unknown) => Promise<void>;

package/lib/commonjs/logic/apiGateway/{websocketSendMessage.js → sendMessageToWebSocketConnection.js}

@@ -12,19 +12,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sendMessageToWebSocketConnection = void 0;
 const client_apigatewaymanagementapi_1 = require("@aws-sdk/client-apigatewaymanagementapi");
 const createAwsClient_1 = require("../createAwsClient");
+/** JSON-serialises the payload and posts it to one websocket connection. */
 const sendMessageToWebSocketConnection = (apiId, connectionId, region, payload) => __awaiter(void 0, void 0, void 0, function* () {
-    // Create a new ApiGatewayManagementApiClient
     const apiGatewayManagementApiClient = (0, createAwsClient_1.createAwsClient)(client_apigatewaymanagementapi_1.ApiGatewayManagementApiClient, {
         apiVersion: '2018-11-29',
+        // QPQ deploys every websocket api with a single stage named 'prod' (see the CDK
+        // websocket construct), so the management endpoint stage is fixed.
         endpoint: `https://${apiId}.execute-api.${region}.amazonaws.com/prod`,
         region,
     });
-    // Create a new PostToConnectionCommand with the connection ID and payload
-    const command = new client_apigatewaymanagementapi_1.PostToConnectionCommand({
+    yield apiGatewayManagementApiClient.send(new client_apigatewaymanagementapi_1.PostToConnectionCommand({
         ConnectionId: connectionId,
-        Data: JSON.stringify(payload), // Convert payload to string if necessary
-    });
-    yield apiGatewayManagementApiClient.send(command);
+        Data: JSON.stringify(payload),
+    }));
 });
 exports.sendMessageToWebSocketConnection = sendMessageToWebSocketConnection;
-//# sourceMappingURL=websocketSendMessage.js.map
+//# sourceMappingURL=sendMessageToWebSocketConnection.js.map

package/lib/commonjs/logic/apiGateway/sendMessageToWebSocketConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessageToWebSocketConnection.js","sourceRoot":"","sources":["../../../../src/logic/apiGateway/sendMessageToWebSocketConnection.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4FAAiH;AAEjH,wDAAqD;AAErD,4EAA4E;AACrE,MAAM,gCAAgC,GAAG,CAAO,KAAa,EAAE,YAAoB,EAAE,MAAc,EAAE,OAAgB,EAAiB,EAAE;IAC7I,MAAM,6BAA6B,GAAG,IAAA,iCAAe,EAAC,8DAA6B,EAAE;QACnF,UAAU,EAAE,YAAY;QACxB,gFAAgF;QAChF,mEAAmE;QACnE,QAAQ,EAAE,WAAW,KAAK,gBAAgB,MAAM,qBAAqB;QACrE,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,6BAA6B,CAAC,IAAI,CACtC,IAAI,wDAAuB,CAAC;QAC1B,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CACH,CAAC;AACJ,CAAC,CAAA,CAAC;AAfW,QAAA,gCAAgC,oCAe3C","sourcesContent":["import { ApiGatewayManagementApiClient, PostToConnectionCommand } from '@aws-sdk/client-apigatewaymanagementapi';\n\nimport { createAwsClient } from '../createAwsClient';\n\n/** JSON-serialises the payload and posts it to one websocket connection. */\nexport const sendMessageToWebSocketConnection = async (apiId: string, connectionId: string, region: string, payload: unknown): Promise<void> => {\n  const apiGatewayManagementApiClient = createAwsClient(ApiGatewayManagementApiClient, {\n    apiVersion: '2018-11-29',\n    // QPQ deploys every websocket api with a single stage named 'prod' (see the CDK\n    // websocket construct), so the management endpoint stage is fixed.\n    endpoint: `https://${apiId}.execute-api.${region}.amazonaws.com/prod`,\n    region,\n  });\n\n  await apiGatewayManagementApiClient.send(\n    new PostToConnectionCommand({\n      ConnectionId: connectionId,\n      Data: JSON.stringify(payload),\n    }),\n  );\n};\n"]}

package/lib/commonjs/logic/cache/memoFunc.d.ts

@@ -1,7 +1,10 @@
+type AnyFunc = (...args: any[]) => any;
 /**
- * Memoizes a function by caching its return values.
+ * Memoizes a synchronous function by its JSON-stringified arguments.
+ * Note: only truthy results are cached; a falsy result is recomputed on every call.
  * @param func The function to memoize.
  * @param ttlInSeconds Time-to-live for the cached values in seconds.
  * @returns The memoized function.
  */
-export declare const memoFunc: <T extends (...args: any[]) => any>(func: T, ttlInSeconds?: number) => T;
+export declare const memoFunc: <T extends AnyFunc>(func: T, ttlInSeconds?: number) => T;
+export {};

package/lib/commonjs/logic/cache/memoFunc.js

@@ -5,18 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memoFunc = void 0;
 const node_cache_1 = __importDefault(require("node-cache"));
+// Keyed per wrapped function so each memoized function gets its own cache.
 const cache = new WeakMap();
 /**
- * Memoizes a function by caching its return values.
+ * Memoizes a synchronous function by its JSON-stringified arguments.
+ * Note: only truthy results are cached; a falsy result is recomputed on every call.
  * @param func The function to memoize.
  * @param ttlInSeconds Time-to-live for the cached values in seconds.
  * @returns The memoized function.
  */
 const memoFunc = (func, ttlInSeconds = 3600) => {
     return ((...args) => {
-        // Check if the function has a corresponding cache entry
         if (!cache.has(func)) {
-            // Create a new NodeCache instance and store it in the cache
             cache.set(func, new node_cache_1.default({ stdTTL: ttlInSeconds }));
         }
         const cacheKey = JSON.stringify(args);
@@ -25,9 +25,7 @@ const memoFunc = (func, ttlInSeconds = 3600) => {
         if (cachedValue) {
             return cachedValue;
         }
-        // Call the original function if the value is not cached
         const result = func(...args);
-        // Cache the result for future use
         nodeCache.set(cacheKey, result);
         return result;
     });

package/lib/commonjs/logic/cache/memoFunc.js.map

@@ -1 +1 @@
-{"version":3,"file":"memoFunc.js","sourceRoot":"","sources":["../../../../src/logic/cache/memoFunc.ts"],"names":[],"mappings":";;;;;;AAAA,4DAAmC;AAEnC,MAAM,KAAK,GAAG,IAAI,OAAO,EAAqB,CAAC;AAE/C;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,CAAoC,IAAO,EAAE,eAAuB,IAAI,EAAK,EAAE;IACrG,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACzB,wDAAwD;QACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,4DAA4D;YAC5D,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,oBAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACnC,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAI,QAAQ,CAAC,CAAC;QAE/C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,wDAAwD;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAE7B,kCAAkC;QAClC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAM,CAAC;AACV,CAAC,CAAC;AAxBW,QAAA,QAAQ,YAwBnB","sourcesContent":["import NodeCache from 'node-cache';\n\nconst cache = new WeakMap<object, NodeCache>();\n\n/**\n * Memoizes a function by caching its return values.\n * @param func The function to memoize.\n * @param ttlInSeconds Time-to-live for the cached values in seconds.\n * @returns The memoized function.\n */\nexport const memoFunc = <T extends (...args: any[]) => any>(func: T, ttlInSeconds: number = 3600): T => {\n  return ((...args: any[]) => {\n    // Check if the function has a corresponding cache entry\n    if (!cache.has(func)) {\n      // Create a new NodeCache instance and store it in the cache\n      cache.set(func, new NodeCache({ stdTTL: ttlInSeconds }));\n    }\n\n    const cacheKey = JSON.stringify(args);\n    const nodeCache = cache.get(func)!;\n    const cachedValue = nodeCache.get<T>(cacheKey);\n\n    if (cachedValue) {\n      return cachedValue;\n    }\n\n    // Call the original function if the value is not cached\n    const result = func(...args);\n\n    // Cache the result for future use\n    nodeCache.set(cacheKey, result);\n\n    return result;\n  }) as T;\n};\n"]}
+{"version":3,"file":"memoFunc.js","sourceRoot":"","sources":["../../../../src/logic/cache/memoFunc.ts"],"names":[],"mappings":";;;;;;AAAA,4DAAmC;AAKnC,2EAA2E;AAC3E,MAAM,KAAK,GAAG,IAAI,OAAO,EAAsB,CAAC;AAEhD;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAoB,IAAO,EAAE,eAAuB,IAAI,EAAK,EAAE;IACrF,OAAO,CAAC,CAAC,GAAG,IAAmB,EAAE,EAAE;QACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,oBAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACnC,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAgB,QAAQ,CAAC,CAAC;QAE3D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAM,CAAC;AACV,CAAC,CAAC;AAnBW,QAAA,QAAQ,YAmBnB","sourcesContent":["import NodeCache from 'node-cache';\n\n// `any` is the variance boundary that lets one signature wrap functions of any arity.\ntype AnyFunc = (...args: any[]) => any;\n\n// Keyed per wrapped function so each memoized function gets its own cache.\nconst cache = new WeakMap<AnyFunc, NodeCache>();\n\n/**\n * Memoizes a synchronous function by its JSON-stringified arguments.\n * Note: only truthy results are cached; a falsy result is recomputed on every call.\n * @param func The function to memoize.\n * @param ttlInSeconds Time-to-live for the cached values in seconds.\n * @returns The memoized function.\n */\nexport const memoFunc = <T extends AnyFunc>(func: T, ttlInSeconds: number = 3600): T => {\n  return ((...args: Parameters<T>) => {\n    if (!cache.has(func)) {\n      cache.set(func, new NodeCache({ stdTTL: ttlInSeconds }));\n    }\n\n    const cacheKey = JSON.stringify(args);\n    const nodeCache = cache.get(func)!;\n    const cachedValue = nodeCache.get<ReturnType<T>>(cacheKey);\n\n    if (cachedValue) {\n      return cachedValue;\n    }\n\n    const result = func(...args);\n    nodeCache.set(cacheKey, result);\n\n    return result;\n  }) as T;\n};\n"]}

package/lib/commonjs/logic/cache/memoFuncAsync.d.ts

@@ -1,7 +1,10 @@
+type AnyFunc = (...args: any[]) => any;
 /**
- * Memoizes a function by caching its return values.
+ * Memoizes an async function by its JSON-stringified arguments, caching the RESOLVED
+ * value (falsy values included). A rejected promise is not cached, so failures retry.
  * @param func The function to memoize.
  * @param ttlInSeconds Time-to-live for the cached values in seconds.
  * @returns The memoized function.
  */
-export declare const memoFuncAsync: <T extends (...args: any[]) => any>(func: T, ttlInSeconds?: number) => T;
+export declare const memoFuncAsync: <T extends AnyFunc>(func: T, ttlInSeconds?: number) => T;
+export {};

package/lib/commonjs/logic/cache/memoFuncAsync.js

@@ -14,9 +14,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memoFuncAsync = void 0;
 const node_cache_1 = __importDefault(require("node-cache"));
+// Keyed per wrapped function so each memoized function gets its own cache.
 const cache = new WeakMap();
 /**
- * Memoizes a function by caching its return values.
+ * Memoizes an async function by its JSON-stringified arguments, caching the RESOLVED
+ * value (falsy values included). A rejected promise is not cached, so failures retry.
  * @param func The function to memoize.
  * @param ttlInSeconds Time-to-live for the cached values in seconds.
  * @returns The memoized function.
@@ -31,9 +33,8 @@ const memoFuncAsync = (func, ttlInSeconds = 3600) => {
         if (nodeCache.has(cacheKey)) {
             return nodeCache.get(cacheKey);
         }
-        // Await the result
+        // Await before caching so only resolved values are stored
         const result = yield func(...args);
-        // and then cache it
         nodeCache.set(cacheKey, result);
         return result;
     }));