quidproquo-actionprocessor-awslambda 0.1.11 → 0.1.12

package/lib/esm/lambdaHandlers/helpers/dynamicModuleLoaderWarmer.js

@@ -1,3 +1,8 @@
+/**
+ * Placeholder hook run on an SNS warmer ping. Intended to pre-fetch federated
+ * dynamic modules so the first real invoke does not pay the load cost; nothing
+ * is wired up yet, so it is a no-op.
+ */
 export const dynamicModuleLoaderWarmer = async () => {
     // NOOP
 };

package/lib/esm/lambdaHandlers/helpers/dynamicModuleLoaderWarmer.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicModuleLoaderWarmer.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/dynamicModuleLoaderWarmer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,IAAmB,EAAE;IACjE,OAAO;AACT,CAAC,CAAC","sourcesContent":["export const dynamicModuleLoaderWarmer = async (): Promise<void> => {\n  // NOOP\n};\n"]}
+{"version":3,"file":"dynamicModuleLoaderWarmer.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/dynamicModuleLoaderWarmer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,IAAmB,EAAE;IACjE,OAAO;AACT,CAAC,CAAC","sourcesContent":["/**\n * Placeholder hook run on an SNS warmer ping. Intended to pre-fetch federated\n * dynamic modules so the first real invoke does not pay the load cost; nothing\n * is wired up yet, so it is a no-op.\n */\nexport const dynamicModuleLoaderWarmer = async (): Promise<void> => {\n  // NOOP\n};\n"]}

package/lib/esm/lambdaHandlers/helpers/getBlankStorySession.d.ts

@@ -0,0 +1,6 @@
+import { StorySession } from 'quidproquo-core';
+/**
+ * The root story session for lambdas whose triggering event carries no session
+ * of its own (api gateway, cognito triggers, schedules, s3/sqs events, ...).
+ */
+export declare const getBlankStorySession: () => StorySession;

package/lib/esm/lambdaHandlers/helpers/getBlankStorySession.js

@@ -0,0 +1,9 @@
+/**
+ * The root story session for lambdas whose triggering event carries no session
+ * of its own (api gateway, cognito triggers, schedules, s3/sqs events, ...).
+ */
+export const getBlankStorySession = () => ({
+    depth: 0,
+    context: {},
+});
+//# sourceMappingURL=getBlankStorySession.js.map

package/lib/esm/lambdaHandlers/helpers/getBlankStorySession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBlankStorySession.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/getBlankStorySession.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAiB,EAAE,CAAC,CAAC;IACvD,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,EAAE;CACZ,CAAC,CAAC","sourcesContent":["import { StorySession } from 'quidproquo-core';\n\n/**\n * The root story session for lambdas whose triggering event carries no session\n * of its own (api gateway, cognito triggers, schedules, s3/sqs events, ...).\n */\nexport const getBlankStorySession = (): StorySession => ({\n  depth: 0,\n  context: {},\n});\n"]}

package/lib/esm/lambdaHandlers/helpers/getLogger.d.ts

@@ -0,0 +1,8 @@
+import { QPQConfig, QpqLogger } from 'quidproquo-core';
+/**
+ * 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.
+ */
+export declare const getLogger: (qpqConfig: QPQConfig) => QpqLogger;

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

@@ -1,13 +1,15 @@
-import { LogActionType, QPQ_LOGS_STORAGE_DRIVE_NAME, qpqCoreUtils } from 'quidproquo-core';
+import { getAwsServiceAccountInfoByDeploymentInfo, getAwsServiceAccountInfoConfig } from 'quidproquo-config-aws';
+import { filterLogHistoryByActionTypes, LogActionType, QPQ_LOGS_STORAGE_DRIVE_NAME, qpqCoreUtils, } from 'quidproquo-core';
 import fs from 'fs';
 import path from 'path';
 import { PutObjectCommand, S3Client } from '@aws-sdk/client-s3';
 import { getConfigRuntimeResourceName } from '../../awsNamingUtils';
 import { LOG_EXTENSION_PORT } from '../../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';
-import { getAwsServiceAccountInfoByDeploymentInfo, getAwsServiceAccountInfoConfig } from 'quidproquo-config-aws';
-import { filterLogHistoryByActionTypes } from 'quidproquo-core';
-export const storyLogger = async (result, bucketName, s3Client) => {
+const putStoryResult = async (result, bucketName, s3Client) => {
     try {
         const commandParams = {
             Key: `${result.correlation}.json`,
@@ -21,19 +23,7 @@ export const storyLogger = async (result, bucketName, s3Client) => {
         console.log(`Failed to log story result to S3 [${result.correlation}]:`, error);
     }
 };
-export const storyLoggerFs = async (result) => {
-    try {
-        await fs.promises.mkdir(tempDirectory, { recursive: true });
-        const filePath = path.join(tempDirectory, `${result.correlation}.json`);
-        await fs.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);
-    }
-};
-export const moveLogsToPerminateStorage = async (bucketName, region) => {
+const moveLogsToPermanentStorage = async (bucketName, region) => {
     try {
         await fs.promises.mkdir(tempDirectory, { recursive: true });
         const files = await fs.promises.readdir(tempDirectory);
@@ -42,7 +32,7 @@ export const moveLogsToPerminateStorage = async (bucketName, region) => {
             const filePath = path.join(tempDirectory, file);
             const data = await fs.promises.readFile(filePath, 'utf-8');
             const result = JSON.parse(data);
-            await storyLogger(result, bucketName, s3Client);
+            await putStoryResult(result, bucketName, s3Client);
             await fs.promises.unlink(filePath);
             console.log(`Moved log file [${file}] to S3 and deleted from temporary directory`);
         }
@@ -59,6 +49,7 @@ const noopLogger = {
     moveToPermanentStorage: async () => { },
 };
 // 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 = getAwsServiceAccountInfoConfig(qpqConfig).logServiceName;
     const application = qpqCoreUtils.getApplicationName(qpqConfig);
@@ -103,21 +94,21 @@ const createBufferedLogger = (bucketName, regionForBucket, ship) => {
             await Promise.all(logs);
         },
         moveToPermanentStorage: async () => {
-            await moveLogsToPerminateStorage(bucketName, regionForBucket);
+            await moveLogsToPermanentStorage(bucketName, regionForBucket);
         },
     };
 };
 // Logs straight to S3: the handler awaits the PutObject itself. Simple and fully
 // durable, but the invoke waits on S3. No extension required.
-export const getS3Logger = (qpqConfig) => {
+const getS3Logger = (qpqConfig) => {
     const { bucketName, regionForBucket } = resolveLogTarget(qpqConfig);
     const s3Client = new S3Client({ region: regionForBucket });
-    return createBufferedLogger(bucketName, regionForBucket, (result) => storyLogger(result, bucketName, s3Client));
+    return createBufferedLogger(bucketName, regionForBucket, (result) => putStoryResult(result, bucketName, s3Client));
 };
 // 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.
-export const getS3LoggerViaExtension = (qpqConfig) => {
+const getS3LoggerViaExtension = (qpqConfig) => {
     const { bucketName, regionForBucket } = resolveLogTarget(qpqConfig);
     const s3Client = new S3Client({ region: regionForBucket });
     const sendToExtension = async (result) => {
@@ -142,13 +133,18 @@ export const getS3LoggerViaExtension = (qpqConfig) => {
         }
         catch (error) {
             console.log(`qpq-log-extension unreachable, writing [${result.correlation}] to S3 directly:`, error);
-            await storyLogger(result, bucketName, s3Client);
+            await putStoryResult(result, bucketName, s3Client);
         }
     });
 };
+/**
+ * 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.
+ */
 export const getLogger = (qpqConfig) => {
     const awsSettings = getAwsServiceAccountInfoConfig(qpqConfig);
-    // If we have no log service, just return nothing.
     if (!awsSettings.logServiceName || awsSettings.disableLogs || process.env.storageDriveName === QPQ_LOGS_STORAGE_DRIVE_NAME) {
         return noopLogger;
     }
@@ -160,4 +156,4 @@ export const getLogger = (qpqConfig) => {
     // is always attached); otherwise log directly to S3.
     return process.env.AWS_LAMBDA_RUNTIME_API ? getS3LoggerViaExtension(qpqConfig) : getS3Logger(qpqConfig);
 };
-//# sourceMappingURL=logger.js.map
+//# sourceMappingURL=getLogger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getLogger.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/getLogger.ts"],"names":[],"mappings":"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","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/esm/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/esm/lambdaHandlers/helpers/getQpqLambdaRuntimeForEvent.js

@@ -2,8 +2,12 @@ import { getCustomActionActionProcessor } from 'quidproquo-actionprocessor-js';
 import { askProcessEvent, createRuntime, } from 'quidproquo-core';
 import { getAwsActionProcessors } from '../../getActionProcessor';
 import { dynamicModuleLoaderWarmer } from './dynamicModuleLoaderWarmer';
+import { getLogger } from './getLogger';
 import { getRuntimeCorrelation } from './getRuntimeCorrelation';
-import { getLogger } from './logger';
+import { isSnsWarmerRecord } from './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;
@@ -11,16 +15,21 @@ 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.
+ */
 export const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getActionProcessorList, dynamicModuleLoader, qpqConfig, getProcessEventStory = () => askProcessEvent) => {
+    const resolveActionProcessorList = async () => ({
+        ...(await getAwsActionProcessors(qpqConfig, dynamicModuleLoader)),
+        ...(await getActionProcessorList(qpqConfig, dynamicModuleLoader)),
+        // Always done last, so they can override the default ones if the user wants.
+        ...(await getCustomActionActionProcessor(qpqConfig, dynamicModuleLoader)),
+    });
     return async (event, context) => {
         console.log('tick: ', JSON.stringify(event, null, 2));
         const logger = getLogger(qpqConfig);
-        const resolveStory = createRuntime(qpqConfig, getStorySession(event), async () => ({
-            ...(await getAwsActionProcessors(qpqConfig, dynamicModuleLoader)),
-            ...(await getActionProcessorList(qpqConfig, dynamicModuleLoader)),
-            // Always done last, so they can ovveride the default ones if the user wants.
-            ...(await getCustomActionActionProcessor(qpqConfig, dynamicModuleLoader)),
-        }), () => new Date().toISOString(), logger, getRuntimeCorrelation(qpqConfig), runtimeType, dynamicModuleLoader);
+        const resolveStory = createRuntime(qpqConfig, getStorySession(event), resolveActionProcessorList, () => new Date().toISOString(), logger, getRuntimeCorrelation(qpqConfig), runtimeType, dynamicModuleLoader);
         const processEvent = async () => {
             const result = await resolveStory(getProcessEventStory(), [event, context]);
             await logger.waitToFinishWriting();
@@ -31,9 +40,9 @@ export const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getAct
             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) => !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
@@ -43,11 +52,6 @@ export const getQpqLambdaRuntimeForEvent = (runtimeType, getStorySession, getAct
                 await 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 await processEvent();
-            }
         }
         return await processEvent();
     };

package/lib/esm/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/esm/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/esm/lambdaHandlers/helpers/index.js

@@ -1,5 +1,7 @@
 export * from './dynamicModuleLoaderWarmer';
+export * from './getBlankStorySession';
+export * from './getLogger';
 export * from './getQpqLambdaRuntimeForEvent';
 export * from './getRuntimeCorrelation';
-export * from './logger';
+export * from './isSnsWarmerRecord';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC","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,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC","sourcesContent":["export * from './dynamicModuleLoaderWarmer';\nexport * from './getBlankStorySession';\nexport * from './getLogger';\nexport * from './getQpqLambdaRuntimeForEvent';\nexport * from './getRuntimeCorrelation';\nexport * from './isSnsWarmerRecord';\n"]}

package/lib/esm/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/esm/lambdaHandlers/helpers/isSnsWarmerRecord.js

@@ -0,0 +1,19 @@
+/**
+ * True when an SNS record is a lambda warmer ping published by the bootstrap
+ * warmer schedule (BSQpqLambdaWarmerEventConstruct sends `{ type: 'QpqLambdaWarmerEvent' }`).
+ */
+export 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 {
+        return false;
+    }
+};
+//# sourceMappingURL=isSnsWarmerRecord.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isSnsWarmerRecord.js","sourceRoot":"","sources":["../../../../src/lambdaHandlers/helpers/isSnsWarmerRecord.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,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,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC","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/esm/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/esm/lambdaHandlers/types/QpqFunctionExecutionEvent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QpqFunctionExecutionEvent.js.map

package/lib/esm/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/esm/lambdaHandlers/types/index.d.ts

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

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

@@ -1,2 +1,2 @@
-export * from './QpqWarmLambdaEvent';
+export * from './QpqFunctionExecutionEvent';
 //# sourceMappingURL=index.js.map

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

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

package/lib/esm/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/esm/lambdas/cloudFrontRequestEvent_viewerRequest.js

@@ -1,4 +1,3 @@
 import { getCloudFrontRequestEvent_viewerRequest } from '../lambdaHandlers';
-// Default executor
 export const cloudFrontRequestEvent_viewerRequest = getCloudFrontRequestEvent_viewerRequest();
 //# sourceMappingURL=cloudFrontRequestEvent_viewerRequest.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"cloudFrontRequestEvent_viewerRequest.js","sourceRoot":"","sources":["../../../src/lambdas/cloudFrontRequestEvent_viewerRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,mBAAmB,CAAC;AAC5E,mBAAmB;AACnB,MAAM,CAAC,MAAM,oCAAoC,GAAG,uCAAuC,EAAE,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,OAAO,EAAE,uCAAuC,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,CAAC,MAAM,oCAAoC,GAAG,uCAAuC,EAAE,CAAC","sourcesContent":["import { getCloudFrontRequestEvent_viewerRequest } from '../lambdaHandlers';\n\nexport const cloudFrontRequestEvent_viewerRequest = getCloudFrontRequestEvent_viewerRequest();\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"dynamicModuleLoader.js","sourceRoot":"","sources":["../../../../src/lambdas/dynamicModuleLoader/dynamicModuleLoader.ts"],"names":[],"mappings":"AAsBA,0EAA0E;AAC1E,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAW,kBAAsC,EAAc,EAAE;IACvG,2FAA2F;IAC3F,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAI,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gFAAgF;IAChF,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC,CAAC","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,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAW,kBAAsC,EAAc,EAAE;IACvG,2FAA2F;IAC3F,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAI,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gFAAgF;IAChF,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC,CAAC","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/esm/lambdas/dynamicModuleLoader/index.d.ts

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

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

@@ -1,3 +1,2 @@
 export * from './dynamicModuleLoader';
-export * from './dynamicModuleLoaderWarmer';
 //# sourceMappingURL=index.js.map

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

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

package/lib/esm/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/esm/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/esm/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/esm/logic/apiGateway/{websocketSendMessage.js → sendMessageToWebSocketConnection.js}

@@ -1,17 +1,17 @@
 import { ApiGatewayManagementApiClient, PostToConnectionCommand } from '@aws-sdk/client-apigatewaymanagementapi';
 import { createAwsClient } from '../createAwsClient';
+/** JSON-serialises the payload and posts it to one websocket connection. */
 export const sendMessageToWebSocketConnection = async (apiId, connectionId, region, payload) => {
-    // Create a new ApiGatewayManagementApiClient
     const apiGatewayManagementApiClient = createAwsClient(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 PostToConnectionCommand({
+    await apiGatewayManagementApiClient.send(new PostToConnectionCommand({
         ConnectionId: connectionId,
-        Data: JSON.stringify(payload), // Convert payload to string if necessary
-    });
-    await apiGatewayManagementApiClient.send(command);
+        Data: JSON.stringify(payload),
+    }));
 };
-//# sourceMappingURL=websocketSendMessage.js.map
+//# sourceMappingURL=sendMessageToWebSocketConnection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessageToWebSocketConnection.js","sourceRoot":"","sources":["../../../../src/logic/apiGateway/sendMessageToWebSocketConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEjH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,EAAE,KAAa,EAAE,YAAoB,EAAE,MAAc,EAAE,OAAgB,EAAiB,EAAE;IAC7I,MAAM,6BAA6B,GAAG,eAAe,CAAC,6BAA6B,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,uBAAuB,CAAC;QAC1B,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CACH,CAAC;AACJ,CAAC,CAAC","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/esm/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/esm/logic/cache/memoFunc.js

@@ -1,16 +1,16 @@
 import NodeCache from '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.
  */
 export 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 NodeCache({ stdTTL: ttlInSeconds }));
         }
         const cacheKey = JSON.stringify(args);
@@ -19,9 +19,7 @@ export 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/esm/logic/cache/memoFunc.js.map

@@ -1 +1 @@
-{"version":3,"file":"memoFunc.js","sourceRoot":"","sources":["../../../../src/logic/cache/memoFunc.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAAG,IAAI,OAAO,EAAqB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,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,SAAS,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","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,OAAO,SAAS,MAAM,YAAY,CAAC;AAKnC,2EAA2E;AAC3E,MAAM,KAAK,GAAG,IAAI,OAAO,EAAsB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,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,SAAS,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","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/esm/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/esm/logic/cache/memoFuncAsync.js

@@ -1,7 +1,9 @@
 import NodeCache from '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.
@@ -16,9 +18,8 @@ export 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 = await func(...args);
-        // and then cache it
         nodeCache.set(cacheKey, result);
         return result;
     });