@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/runtime/processAction.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processAction = processAction;
-const actionLogic_1 = require("../logic/actionLogic");
+const actionResult_1 = require("../logic/actionResult");
 const ErrorTypeEnum_1 = require("../types/ErrorTypeEnum");
 function processAction(action, actionProcessors, session, logger, updateSession, dynamicModuleLoader, streamRegistry) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -26,11 +26,11 @@ function processAction(action, actionProcessors, session, logger, updateSession,
             // The registered list goes in the stack, not the text: the text reaches callers, and the list
             // describes the runtime. The user-script sandbox relies on this text naming the action.
             if (!processor) {
-                return (0, actionLogic_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `Unable to process action: ${action === null || action === void 0 ? void 0 : action.type}`, `Registered actions: [${Object.keys(actionProcessors).join(', ')}]`);
+                return (0, actionResult_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `Unable to process action: ${action === null || action === void 0 ? void 0 : action.type}`, `Registered actions: [${Object.keys(actionProcessors).join(', ')}]`);
             }
             // Merge any context carried on the action into the session
             // This allows context providers to propagate values to sub-runtimes
-            // TODO: We need todo the same thing with auth, currently we mutate the runtime when set new auth.
+            // TODO: @joe-coady: do the same thing with auth, currently we mutate the runtime when set new auth.
             const effectiveSession = Object.assign(Object.assign({}, session), { context: Object.assign(Object.assign({}, session.context), action.context), localContext: Object.assign(Object.assign({}, session.localContext), action.localContext) });
             return yield processor(action.payload, effectiveSession, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry);
         }
@@ -39,9 +39,9 @@ function processAction(action, actionProcessors, session, logger, updateSession,
             // unmapped failure's message can name resources, paths, or accounts.
             if (e instanceof Error) {
                 const errorName = e.name ? ` [${e.name}]` : '';
-                return (0, actionLogic_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `An unexpected error occurred in [${action === null || action === void 0 ? void 0 : action.type}]${errorName}.`, e.stack);
+                return (0, actionResult_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `An unexpected error occurred in [${action === null || action === void 0 ? void 0 : action.type}]${errorName}.`, e.stack);
             }
-            return (0, actionLogic_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `An unknown error occurred in [${action === null || action === void 0 ? void 0 : action.type}]`);
+            return (0, actionResult_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `An unknown error occurred in [${action === null || action === void 0 ? void 0 : action.type}]`);
         }
     });
 }

package/lib/commonjs/runtime/processAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"processAction.js","sourceRoot":"","sources":["../../../src/runtime/processAction.ts"],"names":[],"mappings":";;;;;;;;;;;AAKA,sCA+CC;AApDD,sDAAyD;AAGzD,0DAAuD;AAEvD,SAAsB,aAAa,CACjC,MAAmB,EACnB,gBAAqC,EACrC,OAAqB,EACrB,MAAiB,EACjB,aAAuD,EACvD,mBAAwC,EACxC,cAA8B;;QAE9B,IAAI,CAAC;YACH,8EAA8E;YAC9E,8EAA8E;YAC9E,8EAA8E;YAC9E,8EAA8E;YAC9E,6EAA6E;YAC7E,0EAA0E;YAC1E,MAAM,SAAS,GAAG,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,SAAS,KAAM,MAAM,CAAC,SAAiB,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,8FAA8F;YAC9F,wFAAwF;YACxF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,IAAA,+BAAiB,EACtB,6BAAa,CAAC,YAAY,EAC1B,6BAA6B,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,EAAE,EAC3C,wBAAwB,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpE,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,oEAAoE;YACpE,kGAAkG;YAClG,MAAM,gBAAgB,mCACjB,OAAO,KACV,OAAO,kCAAO,OAAO,CAAC,OAAO,GAAK,MAAM,CAAC,OAAO,GAChD,YAAY,kCAAO,OAAO,CAAC,YAAY,GAAK,MAAM,CAAC,YAAY,IAChE,CAAC;YAEF,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC;QACzI,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,gGAAgG;YAChG,qEAAqE;YACrE,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,IAAA,+BAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,oCAAoC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAClI,CAAC;YACD,OAAO,IAAA,+BAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,iCAAiC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,GAAG,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { actionResultError } from '../logic/actionLogic';\nimport { DynamicModuleLoader, QpqLogger, StorySession, StreamRegistry } from '../types';\nimport { Action, ActionProcessorList, ActionProcessorResult } from '../types/Action';\nimport { ErrorTypeEnum } from '../types/ErrorTypeEnum';\n\nexport async function processAction(\n  action: Action<any>,\n  actionProcessors: ActionProcessorList,\n  session: StorySession,\n  logger: QpqLogger,\n  updateSession: (session: Partial<StorySession>) => void,\n  dynamicModuleLoader: DynamicModuleLoader,\n  streamRegistry: StreamRegistry,\n): Promise<ActionProcessorResult<any>> {\n  try {\n    // A plain string index resolves inherited Object.prototype members for action\n    // types like 'constructor' or 'toString' and would invoke them as processors.\n    // Reject anything that is just an inherited prototype member so unknown types\n    // hit the error path below. This stays an identity check (not an own-property\n    // check) because some processor lists are Proxies that synthesize processors\n    // in their get trap (see createDebugLogActionProcessor in qpqExecuteLog).\n    const candidate = actionProcessors?.[action?.type];\n    const processor = candidate === (Object.prototype as any)[action?.type] ? undefined : candidate;\n    // The registered list goes in the stack, not the text: the text reaches callers, and the list\n    // describes the runtime. The user-script sandbox relies on this text naming the action.\n    if (!processor) {\n      return actionResultError(\n        ErrorTypeEnum.GenericError,\n        `Unable to process action: ${action?.type}`,\n        `Registered actions: [${Object.keys(actionProcessors).join(', ')}]`,\n      );\n    }\n\n    // Merge any context carried on the action into the session\n    // This allows context providers to propagate values to sub-runtimes\n    // TODO: We need todo the same thing with auth, currently we mutate the runtime when set new auth.\n    const effectiveSession = {\n      ...session,\n      context: { ...session.context, ...action.context },\n      localContext: { ...session.localContext, ...action.localContext },\n    };\n\n    return await processor(action.payload, effectiveSession, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry);\n  } catch (e: unknown) {\n    // The exception's own message stays in the stack for the logs. The text reaches callers, and an\n    // unmapped failure's message can name resources, paths, or accounts.\n    if (e instanceof Error) {\n      const errorName = e.name ? ` [${e.name}]` : '';\n      return actionResultError(ErrorTypeEnum.GenericError, `An unexpected error occurred in [${action?.type}]${errorName}.`, e.stack);\n    }\n    return actionResultError(ErrorTypeEnum.GenericError, `An unknown error occurred in [${action?.type}]`);\n  }\n}\n"]}
+{"version":3,"file":"processAction.js","sourceRoot":"","sources":["../../../src/runtime/processAction.ts"],"names":[],"mappings":";;;;;;;;;;;AAKA,sCA+CC;AApDD,wDAA0D;AAG1D,0DAAuD;AAEvD,SAAsB,aAAa,CACjC,MAAmB,EACnB,gBAAqC,EACrC,OAAqB,EACrB,MAAiB,EACjB,aAAuD,EACvD,mBAAwC,EACxC,cAA8B;;QAE9B,IAAI,CAAC;YACH,8EAA8E;YAC9E,8EAA8E;YAC9E,8EAA8E;YAC9E,8EAA8E;YAC9E,6EAA6E;YAC7E,0EAA0E;YAC1E,MAAM,SAAS,GAAG,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,SAAS,KAAM,MAAM,CAAC,SAAiB,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,8FAA8F;YAC9F,wFAAwF;YACxF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,IAAA,gCAAiB,EACtB,6BAAa,CAAC,YAAY,EAC1B,6BAA6B,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,EAAE,EAC3C,wBAAwB,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpE,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,oEAAoE;YACpE,oGAAoG;YACpG,MAAM,gBAAgB,mCACjB,OAAO,KACV,OAAO,kCAAO,OAAO,CAAC,OAAO,GAAK,MAAM,CAAC,OAAO,GAChD,YAAY,kCAAO,OAAO,CAAC,YAAY,GAAK,MAAM,CAAC,YAAY,IAChE,CAAC;YAEF,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC;QACzI,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,gGAAgG;YAChG,qEAAqE;YACrE,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,IAAA,gCAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,oCAAoC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAClI,CAAC;YACD,OAAO,IAAA,gCAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,iCAAiC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,GAAG,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { actionResultError } from '../logic/actionResult';\nimport { DynamicModuleLoader, QpqLogger, StorySession, StreamRegistry } from '../types';\nimport { Action, ActionProcessorList, ActionProcessorResult } from '../types/Action';\nimport { ErrorTypeEnum } from '../types/ErrorTypeEnum';\n\nexport async function processAction(\n  action: Action<any>,\n  actionProcessors: ActionProcessorList,\n  session: StorySession,\n  logger: QpqLogger,\n  updateSession: (session: Partial<StorySession>) => void,\n  dynamicModuleLoader: DynamicModuleLoader,\n  streamRegistry: StreamRegistry,\n): Promise<ActionProcessorResult<any>> {\n  try {\n    // A plain string index resolves inherited Object.prototype members for action\n    // types like 'constructor' or 'toString' and would invoke them as processors.\n    // Reject anything that is just an inherited prototype member so unknown types\n    // hit the error path below. This stays an identity check (not an own-property\n    // check) because some processor lists are Proxies that synthesize processors\n    // in their get trap (see createDebugLogActionProcessor in qpqExecuteLog).\n    const candidate = actionProcessors?.[action?.type];\n    const processor = candidate === (Object.prototype as any)[action?.type] ? undefined : candidate;\n    // The registered list goes in the stack, not the text: the text reaches callers, and the list\n    // describes the runtime. The user-script sandbox relies on this text naming the action.\n    if (!processor) {\n      return actionResultError(\n        ErrorTypeEnum.GenericError,\n        `Unable to process action: ${action?.type}`,\n        `Registered actions: [${Object.keys(actionProcessors).join(', ')}]`,\n      );\n    }\n\n    // Merge any context carried on the action into the session\n    // This allows context providers to propagate values to sub-runtimes\n    // TODO: @joe-coady: do the same thing with auth, currently we mutate the runtime when set new auth.\n    const effectiveSession = {\n      ...session,\n      context: { ...session.context, ...action.context },\n      localContext: { ...session.localContext, ...action.localContext },\n    };\n\n    return await processor(action.payload, effectiveSession, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry);\n  } catch (e: unknown) {\n    // The exception's own message stays in the stack for the logs. The text reaches callers, and an\n    // unmapped failure's message can name resources, paths, or accounts.\n    if (e instanceof Error) {\n      const errorName = e.name ? ` [${e.name}]` : '';\n      return actionResultError(ErrorTypeEnum.GenericError, `An unexpected error occurred in [${action?.type}]${errorName}.`, e.stack);\n    }\n    return actionResultError(ErrorTypeEnum.GenericError, `An unknown error occurred in [${action?.type}]`);\n  }\n}\n"]}

package/lib/commonjs/runtime/resolveStory.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveStory = resolveStory;
-const actionLogic_1 = require("../logic/actionLogic");
+const actionResult_1 = require("../logic/actionResult");
 const stream_1 = require("../logic/stream");
 const qpqCoreUtils_1 = require("../qpqCoreUtils");
 const ErrorTypeEnum_1 = require("../types/ErrorTypeEnum");
@@ -85,19 +85,19 @@ function resolveStory(story, args, qpqConfig, callerSession, getActionProcessors
                     finishedAt: getTimeNow(),
                 };
                 response.history.push(historyEntry);
-                if ((0, actionLogic_1.isErroredActionResult)(actionResult) && !action.returnErrors) {
-                    return Object.assign(Object.assign({}, response), { finishedAt: getTimeNow(), error: (0, actionLogic_1.resolveActionResultError)(actionResult) });
+                if ((0, actionResult_1.isErroredActionResult)(actionResult) && !action.returnErrors) {
+                    return Object.assign(Object.assign({}, response), { finishedAt: getTimeNow(), error: (0, actionResult_1.resolveActionResultError)(actionResult) });
                 }
                 // Feed the result back to the story generator
                 if (action.returnErrors) {
-                    const isSuccess = !(0, actionLogic_1.isErroredActionResult)(actionResult);
+                    const isSuccess = !(0, actionResult_1.isErroredActionResult)(actionResult);
                     const result = isSuccess
-                        ? { success: true, result: (0, actionLogic_1.resolveActionResult)(actionResult) }
-                        : { success: false, error: (0, actionLogic_1.resolveActionResultError)(actionResult) };
+                        ? { success: true, result: (0, actionResult_1.resolveActionResult)(actionResult) }
+                        : { success: false, error: (0, actionResult_1.resolveActionResultError)(actionResult) };
                     storyProgress = reader.next(result);
                 }
                 else {
-                    storyProgress = reader.next((0, actionLogic_1.resolveActionResult)(actionResult));
+                    storyProgress = reader.next((0, actionResult_1.resolveActionResult)(actionResult));
                 }
             }
         }

package/lib/commonjs/runtime/resolveStory.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveStory.js","sourceRoot":"","sources":["../../../src/runtime/resolveStory.ts"],"names":[],"mappings":"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","sourcesContent":["import { QPQConfig } from '../config';\nimport { isErroredActionResult, resolveActionResult, resolveActionResultError } from '../logic/actionLogic';\nimport { createStreamRegistry } from '../logic/stream';\nimport { getApplicationModuleName } from '../qpqCoreUtils';\nimport { QpqFunctionRuntime, QpqLogger, StreamRegistry } from '../types';\nimport { Action, ActionProcessorList } from '../types/Action';\nimport { ErrorTypeEnum } from '../types/ErrorTypeEnum';\nimport { QpqRuntimeType, Story, StoryResult, StorySession, StorySessionUpdater } from '../types/StorySession';\nimport { getGlobalsFromQpqFunctionRuntime } from '../utils';\nimport { mergeRuntimeActionProcessors } from './mergeRuntimeActionProcessors';\nimport { processAction } from './processAction';\n\nexport async function resolveStory<TArgs extends Array<any>>(\n  story: Story<TArgs, any>,\n  args: TArgs,\n  qpqConfig: QPQConfig,\n  callerSession: StorySession,\n  getActionProcessors: (config: QPQConfig, dynamicModuleLoader: any) => Promise<ActionProcessorList>,\n  getTimeNow: () => string,\n  logger: QpqLogger,\n  runtimeCorrelation: string,\n  runtimeType: QpqRuntimeType,\n  dynamicModuleLoader: any,\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime,\n  initialTags?: string[],\n  streamRegistry?: StreamRegistry,\n): Promise<StoryResult<any>> {\n  // Runtime-attached action processor overrides merge over the base list, last\n  // wins. In-process nested executions (EXECUTE_STORY, EXECUTE_IMPLEMENTATION_STORY)\n  // inherit the caller's merged list for free: their processors pass it through as\n  // this call's getActionProcessors. Transport boundaries build the base list fresh\n  // from their own runtime's registration.\n  const actionProcessors: ActionProcessorList = await mergeRuntimeActionProcessors(\n    qpqConfig,\n    qpqFunctionRuntimeInfo,\n    await getActionProcessors(qpqConfig, dynamicModuleLoader),\n    dynamicModuleLoader,\n  );\n  const registry = streamRegistry ?? createStreamRegistry();\n  const reader = story(...args);\n\n  const runtimeGlobals = getGlobalsFromQpqFunctionRuntime(qpqFunctionRuntimeInfo);\n\n  let storyProgress: IteratorResult<Action<any>, any> | null = null;\n  let storySession: StorySession = {\n    correlation: runtimeCorrelation,\n    depth: callerSession.depth + 1,\n    decodedAccessToken: callerSession.decodedAccessToken,\n    context: callerSession.context,\n    localContext: callerSession.localContext,\n    // In-process story executions run WITHIN the caller's function, so they\n    // inherit its globals - their own registration wins on collision. This\n    // covers inline functions (EXECUTE_STORY) AND implementation stories\n    // (EXECUTE_IMPLEMENTATION_STORY: tool executors, drive file resolvers,\n    // custom implementations) - both are nested, not transport boundaries, so\n    // an AI tool executor can read the queue/route globals (e.g. the eventDoc\n    // user-directory global needed to resolve the actor). Transport entries\n    // (http/queue/ws) start fresh from their own runtime registration only.\n    functionGlobals:\n      runtimeType === QpqRuntimeType.EXECUTE_STORY || runtimeType === QpqRuntimeType.EXECUTE_IMPLEMENTATION_STORY\n        ? {\n            ...callerSession.functionGlobals,\n            ...runtimeGlobals,\n          }\n        : runtimeGlobals,\n  };\n\n  const updateSession: StorySessionUpdater = (newSession: Partial<StorySession>): void => {\n    storySession = { ...storySession, ...newSession };\n  };\n\n  const response: StoryResult<any> = {\n    input: args,\n    session: { ...storySession },\n    history: [],\n    startedAt: getTimeNow(),\n    finishedAt: getTimeNow(),\n    tags: initialTags || [],\n    moduleName: getApplicationModuleName(qpqConfig),\n    correlation: storySession.correlation!,\n    fromCorrelation: callerSession.correlation,\n    runtimeType: runtimeType,\n    logs: [],\n    qpqFunctionRuntimeInfo,\n  };\n\n  // Enforce maximum depth\n  if (storySession.depth > 100) {\n    return {\n      ...response,\n      finishedAt: getTimeNow(),\n      error: {\n        errorText: `Story depth exceeded [${storySession.depth}]!`,\n        errorType: ErrorTypeEnum.GenericError,\n      },\n    };\n  }\n\n  try {\n    storyProgress = reader.next();\n\n    while (!storyProgress.done) {\n      const action = storyProgress.value;\n      const executionTime = getTimeNow();\n\n      const actionResult = await processAction(action, actionProcessors, storySession, logger, updateSession, dynamicModuleLoader, registry);\n\n      const historyEntry = {\n        act: action,\n        res: actionResult,\n        startedAt: executionTime,\n        finishedAt: getTimeNow(),\n      };\n\n      response.history.push(historyEntry);\n\n      if (isErroredActionResult(actionResult) && !action.returnErrors) {\n        return {\n          ...response,\n          finishedAt: getTimeNow(),\n          error: resolveActionResultError(actionResult),\n        };\n      }\n\n      // Feed the result back to the story generator\n      if (action.returnErrors) {\n        const isSuccess = !isErroredActionResult(actionResult);\n        const result = isSuccess\n          ? { success: true, result: resolveActionResult(actionResult) }\n          : { success: false, error: resolveActionResultError(actionResult) };\n        storyProgress = reader.next(result);\n      } else {\n        storyProgress = reader.next(resolveActionResult(actionResult));\n      }\n    }\n  } catch (err) {\n    // Same rule as processAction: the message is for the logs (errorStack), callers get a generic text.\n    if (err instanceof Error) {\n      const errorName = err.name ? ` [${err.name}]` : '';\n      return {\n        ...response,\n        finishedAt: getTimeNow(),\n        error: {\n          errorText: `An unexpected error occurred${errorName}.`,\n          errorType: ErrorTypeEnum.GenericError,\n          errorStack: [storyProgress?.value?.type, err.stack].filter(Boolean).join(' -> '),\n        },\n      };\n    }\n    return {\n      ...response,\n      finishedAt: getTimeNow(),\n      error: {\n        errorText: 'Unknown error has occurred!',\n        errorType: ErrorTypeEnum.GenericError,\n        errorStack: storyProgress?.value?.type,\n      },\n    };\n  }\n\n  const storyResult = {\n    ...response,\n    finishedAt: getTimeNow(),\n    result: storyProgress.value,\n  };\n\n  return storyResult;\n}\n"]}
+{"version":3,"file":"resolveStory.js","sourceRoot":"","sources":["../../../src/runtime/resolveStory.ts"],"names":[],"mappings":"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","sourcesContent":["import { QPQConfig } from '../config';\nimport { isErroredActionResult, resolveActionResult, resolveActionResultError } from '../logic/actionResult';\nimport { createStreamRegistry } from '../logic/stream';\nimport { getApplicationModuleName } from '../qpqCoreUtils';\nimport { QpqFunctionRuntime, QpqLogger, StreamRegistry } from '../types';\nimport { Action, ActionProcessorList } from '../types/Action';\nimport { ErrorTypeEnum } from '../types/ErrorTypeEnum';\nimport { Nullable } from '../types/Nullable';\nimport { QpqRuntimeType, Story, StoryResult, StorySession, StorySessionUpdater } from '../types/StorySession';\nimport { getGlobalsFromQpqFunctionRuntime } from '../utils';\nimport { mergeRuntimeActionProcessors } from './mergeRuntimeActionProcessors';\nimport { processAction } from './processAction';\n\nexport async function resolveStory<TArgs extends Array<any>>(\n  story: Story<TArgs, any>,\n  args: TArgs,\n  qpqConfig: QPQConfig,\n  callerSession: StorySession,\n  getActionProcessors: (config: QPQConfig, dynamicModuleLoader: any) => Promise<ActionProcessorList>,\n  getTimeNow: () => string,\n  logger: QpqLogger,\n  runtimeCorrelation: string,\n  runtimeType: QpqRuntimeType,\n  dynamicModuleLoader: any,\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime,\n  initialTags?: string[],\n  streamRegistry?: StreamRegistry,\n): Promise<StoryResult<any>> {\n  // Runtime-attached action processor overrides merge over the base list, last\n  // wins. In-process nested executions (EXECUTE_STORY, EXECUTE_IMPLEMENTATION_STORY)\n  // inherit the caller's merged list for free: their processors pass it through as\n  // this call's getActionProcessors. Transport boundaries build the base list fresh\n  // from their own runtime's registration.\n  const actionProcessors: ActionProcessorList = await mergeRuntimeActionProcessors(\n    qpqConfig,\n    qpqFunctionRuntimeInfo,\n    await getActionProcessors(qpqConfig, dynamicModuleLoader),\n    dynamicModuleLoader,\n  );\n  const registry = streamRegistry ?? createStreamRegistry();\n  const reader = story(...args);\n\n  const runtimeGlobals = getGlobalsFromQpqFunctionRuntime(qpqFunctionRuntimeInfo);\n\n  let storyProgress: Nullable<IteratorResult<Action<any>, any>> = null;\n  let storySession: StorySession = {\n    correlation: runtimeCorrelation,\n    depth: callerSession.depth + 1,\n    decodedAccessToken: callerSession.decodedAccessToken,\n    context: callerSession.context,\n    localContext: callerSession.localContext,\n    // In-process story executions run WITHIN the caller's function, so they\n    // inherit its globals - their own registration wins on collision. This\n    // covers inline functions (EXECUTE_STORY) AND implementation stories\n    // (EXECUTE_IMPLEMENTATION_STORY: tool executors, drive file resolvers,\n    // custom implementations) - both are nested, not transport boundaries, so\n    // an AI tool executor can read the queue/route globals (e.g. the eventDoc\n    // user-directory global needed to resolve the actor). Transport entries\n    // (http/queue/ws) start fresh from their own runtime registration only.\n    functionGlobals:\n      runtimeType === QpqRuntimeType.EXECUTE_STORY || runtimeType === QpqRuntimeType.EXECUTE_IMPLEMENTATION_STORY\n        ? {\n            ...callerSession.functionGlobals,\n            ...runtimeGlobals,\n          }\n        : runtimeGlobals,\n  };\n\n  const updateSession: StorySessionUpdater = (newSession: Partial<StorySession>): void => {\n    storySession = { ...storySession, ...newSession };\n  };\n\n  const response: StoryResult<any> = {\n    input: args,\n    session: { ...storySession },\n    history: [],\n    startedAt: getTimeNow(),\n    finishedAt: getTimeNow(),\n    tags: initialTags || [],\n    moduleName: getApplicationModuleName(qpqConfig),\n    correlation: storySession.correlation!,\n    fromCorrelation: callerSession.correlation,\n    runtimeType: runtimeType,\n    logs: [],\n    qpqFunctionRuntimeInfo,\n  };\n\n  // Enforce maximum depth\n  if (storySession.depth > 100) {\n    return {\n      ...response,\n      finishedAt: getTimeNow(),\n      error: {\n        errorText: `Story depth exceeded [${storySession.depth}]!`,\n        errorType: ErrorTypeEnum.GenericError,\n      },\n    };\n  }\n\n  try {\n    storyProgress = reader.next();\n\n    while (!storyProgress.done) {\n      const action = storyProgress.value;\n      const executionTime = getTimeNow();\n\n      const actionResult = await processAction(action, actionProcessors, storySession, logger, updateSession, dynamicModuleLoader, registry);\n\n      const historyEntry = {\n        act: action,\n        res: actionResult,\n        startedAt: executionTime,\n        finishedAt: getTimeNow(),\n      };\n\n      response.history.push(historyEntry);\n\n      if (isErroredActionResult(actionResult) && !action.returnErrors) {\n        return {\n          ...response,\n          finishedAt: getTimeNow(),\n          error: resolveActionResultError(actionResult),\n        };\n      }\n\n      // Feed the result back to the story generator\n      if (action.returnErrors) {\n        const isSuccess = !isErroredActionResult(actionResult);\n        const result = isSuccess\n          ? { success: true, result: resolveActionResult(actionResult) }\n          : { success: false, error: resolveActionResultError(actionResult) };\n        storyProgress = reader.next(result);\n      } else {\n        storyProgress = reader.next(resolveActionResult(actionResult));\n      }\n    }\n  } catch (err) {\n    // Same rule as processAction: the message is for the logs (errorStack), callers get a generic text.\n    if (err instanceof Error) {\n      const errorName = err.name ? ` [${err.name}]` : '';\n      return {\n        ...response,\n        finishedAt: getTimeNow(),\n        error: {\n          errorText: `An unexpected error occurred${errorName}.`,\n          errorType: ErrorTypeEnum.GenericError,\n          errorStack: [storyProgress?.value?.type, err.stack].filter(Boolean).join(' -> '),\n        },\n      };\n    }\n    return {\n      ...response,\n      finishedAt: getTimeNow(),\n      error: {\n        errorText: 'Unknown error has occurred!',\n        errorType: ErrorTypeEnum.GenericError,\n        errorStack: storyProgress?.value?.type,\n      },\n    };\n  }\n\n  const storyResult = {\n    ...response,\n    finishedAt: getTimeNow(),\n    result: storyProgress.value,\n  };\n\n  return storyResult;\n}\n"]}

package/lib/commonjs/runtime/resolveStoryWithLogs.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveStoryWithLogs.js","sourceRoot":"","sources":["../../../src/runtime/resolveStoryWithLogs.ts"],"names":[],"mappings":";;;;;;;;;;;AA2CA,oDA0CC;AAjFD,iDAA8C;AAY9C,IAAI,mBAAmB,GAA0B,EAAE,CAAC;AACpD,IAAI,mBAAmB,GAA8B,IAAI,CAAC;AAE1D,MAAM,gBAAgB,GAAG,CAAC,SAA8B,EAAQ,EAAE;IAChE,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;QAC7B,mBAAmB,GAAG,QAAQ,CAAC;QAC/B,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YAC/B,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,SAA8B,EAAQ,EAAE;IAC/D,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAEnF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,GAAG,mBAAmB,CAAC;QAClC,mBAAmB,GAAG,IAAI,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC;AAEF,SAAsB,oBAAoB,CACxC,KAAwB,EACxB,IAAW,EACX,SAAoB,EACpB,aAA2B,EAC3B,mBAAkG,EAClG,UAAwB,EACxB,MAAiB,EACjB,kBAA0B,EAC1B,WAA2B,EAC3B,mBAAwB,EACxB,sBAA2C,EAC3C,WAAsB,EACtB,cAA+B;;QAE/B,MAAM,SAAS,GAAwB,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;QAEhE,IAAI,CAAC;YACH,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE5B,MAAM,WAAW,GAAG,MAAM,IAAA,2BAAY,EACpC,KAAK,EACL,IAAI,EACJ,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,cAAc,CACf,CAAC;YAEF,WAAW,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACxB,OAAO,WAAW,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,eAAe,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { QPQConfig } from '../config';\nimport { QpqFunctionRuntime, QpqLogger, StreamRegistry } from '../types';\nimport { ActionProcessorList } from '../types/Action';\nimport { qpqConsoleLog, QpqRuntimeType, Story, StoryResult, StorySession, StorySessionUpdater } from '../types/StorySession';\nimport { resolveStory } from './resolveStory';\n\n// Stories run concurrently in one process (overlapping requests, nested runtimes for\n// AI tools / file resolvers), so a per-story `old = console.log; ...; console.log = old`\n// interleaves badly: the outer story's restore clobbers the inner story's patch, and the\n// inner story's restore then reinstalls the outer story's wrapper — leaking one wrapper\n// per overlap until console.log is a chain deep enough to blow the stack. Instead, keep\n// ONE global patch with a stack of active collectors; every active story captures every\n// log (same semantics as the chained wrappers), and the true original is restored only\n// when the last story finishes.\ntype ConsoleLogCollector = { logs: qpqConsoleLog[]; getTimeNow: () => string };\n\nlet activeLogCollectors: ConsoleLogCollector[] = [];\nlet unpatchedConsoleLog: typeof console.log | null = null;\n\nconst pushLogCollector = (collector: ConsoleLogCollector): void => {\n  if (unpatchedConsoleLog === null) {\n    const original = console.log;\n    unpatchedConsoleLog = original;\n    console.log = (...args: any[]) => {\n      for (const active of activeLogCollectors) {\n        active.logs.push({ t: active.getTimeNow(), a: args });\n      }\n      return original(...args);\n    };\n  }\n\n  activeLogCollectors.push(collector);\n};\n\nconst popLogCollector = (collector: ConsoleLogCollector): void => {\n  activeLogCollectors = activeLogCollectors.filter((active) => active !== collector);\n\n  if (activeLogCollectors.length === 0 && unpatchedConsoleLog !== null) {\n    console.log = unpatchedConsoleLog;\n    unpatchedConsoleLog = null;\n  }\n};\n\nexport async function resolveStoryWithLogs<TArgs extends Array<any>>(\n  story: Story<TArgs, any>,\n  args: TArgs,\n  qpqConfig: QPQConfig,\n  callerSession: StorySession,\n  getActionProcessors: (config: QPQConfig, dynamicModuleLoader: any) => Promise<ActionProcessorList>,\n  getTimeNow: () => string,\n  logger: QpqLogger,\n  runtimeCorrelation: string,\n  runtimeType: QpqRuntimeType,\n  dynamicModuleLoader: any,\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime,\n  initialTags?: string[],\n  streamRegistry?: StreamRegistry,\n): Promise<StoryResult<any>> {\n  const collector: ConsoleLogCollector = { logs: [], getTimeNow };\n\n  try {\n    pushLogCollector(collector);\n\n    const storyResult = await resolveStory(\n      story,\n      args,\n      qpqConfig,\n      callerSession,\n      getActionProcessors,\n      getTimeNow,\n      logger,\n      runtimeCorrelation,\n      runtimeType,\n      dynamicModuleLoader,\n      qpqFunctionRuntimeInfo,\n      initialTags,\n      streamRegistry,\n    );\n\n    storyResult.logs = collector.logs;\n    logger.log(storyResult);\n    return storyResult;\n  } finally {\n    popLogCollector(collector);\n  }\n}\n"]}
+{"version":3,"file":"resolveStoryWithLogs.js","sourceRoot":"","sources":["../../../src/runtime/resolveStoryWithLogs.ts"],"names":[],"mappings":";;;;;;;;;;;AA4CA,oDA0CC;AAjFD,iDAA8C;AAY9C,IAAI,mBAAmB,GAA0B,EAAE,CAAC;AACpD,IAAI,mBAAmB,GAAiC,IAAI,CAAC;AAE7D,MAAM,gBAAgB,GAAG,CAAC,SAA8B,EAAQ,EAAE;IAChE,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;QAC7B,mBAAmB,GAAG,QAAQ,CAAC;QAC/B,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YAC/B,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,SAA8B,EAAQ,EAAE;IAC/D,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAEnF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,GAAG,mBAAmB,CAAC;QAClC,mBAAmB,GAAG,IAAI,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC;AAEF,SAAsB,oBAAoB,CACxC,KAAwB,EACxB,IAAW,EACX,SAAoB,EACpB,aAA2B,EAC3B,mBAAkG,EAClG,UAAwB,EACxB,MAAiB,EACjB,kBAA0B,EAC1B,WAA2B,EAC3B,mBAAwB,EACxB,sBAA2C,EAC3C,WAAsB,EACtB,cAA+B;;QAE/B,MAAM,SAAS,GAAwB,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;QAEhE,IAAI,CAAC;YACH,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE5B,MAAM,WAAW,GAAG,MAAM,IAAA,2BAAY,EACpC,KAAK,EACL,IAAI,EACJ,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,cAAc,CACf,CAAC;YAEF,WAAW,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACxB,OAAO,WAAW,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,eAAe,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { QPQConfig } from '../config';\nimport { QpqFunctionRuntime, QpqLogger, StreamRegistry } from '../types';\nimport { ActionProcessorList } from '../types/Action';\nimport { Nullable } from '../types/Nullable';\nimport { qpqConsoleLog, QpqRuntimeType, Story, StoryResult, StorySession } from '../types/StorySession';\nimport { resolveStory } from './resolveStory';\n\n// Stories run concurrently in one process (overlapping requests, nested runtimes for\n// AI tools / file resolvers), so a per-story `old = console.log; ...; console.log = old`\n// interleaves badly: the outer story's restore clobbers the inner story's patch, and the\n// inner story's restore then reinstalls the outer story's wrapper, leaking one wrapper\n// per overlap until console.log is a chain deep enough to blow the stack. Instead, keep\n// ONE global patch with a stack of active collectors; every active story captures every\n// log (same semantics as the chained wrappers), and the true original is restored only\n// when the last story finishes.\ntype ConsoleLogCollector = { logs: qpqConsoleLog[]; getTimeNow: () => string };\n\nlet activeLogCollectors: ConsoleLogCollector[] = [];\nlet unpatchedConsoleLog: Nullable<typeof console.log> = null;\n\nconst pushLogCollector = (collector: ConsoleLogCollector): void => {\n  if (unpatchedConsoleLog === null) {\n    const original = console.log;\n    unpatchedConsoleLog = original;\n    console.log = (...args: any[]) => {\n      for (const active of activeLogCollectors) {\n        active.logs.push({ t: active.getTimeNow(), a: args });\n      }\n      return original(...args);\n    };\n  }\n\n  activeLogCollectors.push(collector);\n};\n\nconst popLogCollector = (collector: ConsoleLogCollector): void => {\n  activeLogCollectors = activeLogCollectors.filter((active) => active !== collector);\n\n  if (activeLogCollectors.length === 0 && unpatchedConsoleLog !== null) {\n    console.log = unpatchedConsoleLog;\n    unpatchedConsoleLog = null;\n  }\n};\n\nexport async function resolveStoryWithLogs<TArgs extends Array<any>>(\n  story: Story<TArgs, any>,\n  args: TArgs,\n  qpqConfig: QPQConfig,\n  callerSession: StorySession,\n  getActionProcessors: (config: QPQConfig, dynamicModuleLoader: any) => Promise<ActionProcessorList>,\n  getTimeNow: () => string,\n  logger: QpqLogger,\n  runtimeCorrelation: string,\n  runtimeType: QpqRuntimeType,\n  dynamicModuleLoader: any,\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime,\n  initialTags?: string[],\n  streamRegistry?: StreamRegistry,\n): Promise<StoryResult<any>> {\n  const collector: ConsoleLogCollector = { logs: [], getTimeNow };\n\n  try {\n    pushLogCollector(collector);\n\n    const storyResult = await resolveStory(\n      story,\n      args,\n      qpqConfig,\n      callerSession,\n      getActionProcessors,\n      getTimeNow,\n      logger,\n      runtimeCorrelation,\n      runtimeType,\n      dynamicModuleLoader,\n      qpqFunctionRuntimeInfo,\n      initialTags,\n      streamRegistry,\n    );\n\n    storyResult.logs = collector.logs;\n    logger.log(storyResult);\n    return storyResult;\n  } finally {\n    popLogCollector(collector);\n  }\n}\n"]}

package/lib/commonjs/runtime/storyResultToActionResult.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.storyResultToActionResult = void 0;
-const actionLogic_1 = require("../logic/actionLogic");
+const actionResult_1 = require("../logic/actionResult");
 /**
  * Turns a nested story's result into the calling processor's action result.
  * On error, `label` (the function that ran) goes in front of the error stack so the trace shows where it failed.
  */
 const storyResultToActionResult = (storyResult, label) => {
     if (storyResult.error) {
-        return (0, actionLogic_1.actionResultError)(storyResult.error.errorType, storyResult.error.errorText, storyResult.error.errorStack ? `${label} -> [${storyResult.error.errorStack}]` : label);
+        return (0, actionResult_1.actionResultError)(storyResult.error.errorType, storyResult.error.errorText, storyResult.error.errorStack ? `${label} -> [${storyResult.error.errorStack}]` : label);
     }
-    return (0, actionLogic_1.actionResult)(storyResult.result);
+    return (0, actionResult_1.actionResult)(storyResult.result);
 };
 exports.storyResultToActionResult = storyResultToActionResult;
 //# sourceMappingURL=storyResultToActionResult.js.map

package/lib/commonjs/runtime/storyResultToActionResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"storyResultToActionResult.js","sourceRoot":"","sources":["../../../src/runtime/storyResultToActionResult.ts"],"names":[],"mappings":";;;AAAA,sDAAuE;AAIvE;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAI,WAAgC,EAAE,KAAa,EAA4B,EAAE;IACxH,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,IAAA,+BAAiB,EACtB,WAAW,CAAC,KAAK,CAAC,SAAS,EAC3B,WAAW,CAAC,KAAK,CAAC,SAAS,EAC3B,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,WAAW,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,0BAAY,EAAC,WAAW,CAAC,MAAW,CAAC,CAAC;AAC/C,CAAC,CAAC;AAVW,QAAA,yBAAyB,6BAUpC","sourcesContent":["import { actionResult, actionResultError } from '../logic/actionLogic';\nimport { ActionProcessorResult } from '../types/Action';\nimport { StoryResult } from '../types/StorySession';\n\n/**\n * Turns a nested story's result into the calling processor's action result.\n * On error, `label` (the function that ran) goes in front of the error stack so the trace shows where it failed.\n */\nexport const storyResultToActionResult = <R>(storyResult: StoryResult<any, R>, label: string): ActionProcessorResult<R> => {\n  if (storyResult.error) {\n    return actionResultError(\n      storyResult.error.errorType,\n      storyResult.error.errorText,\n      storyResult.error.errorStack ? `${label} -> [${storyResult.error.errorStack}]` : label,\n    );\n  }\n\n  return actionResult(storyResult.result as R);\n};\n"]}
+{"version":3,"file":"storyResultToActionResult.js","sourceRoot":"","sources":["../../../src/runtime/storyResultToActionResult.ts"],"names":[],"mappings":";;;AAAA,wDAAwE;AAIxE;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAI,WAAgC,EAAE,KAAa,EAA4B,EAAE;IACxH,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,IAAA,gCAAiB,EACtB,WAAW,CAAC,KAAK,CAAC,SAAS,EAC3B,WAAW,CAAC,KAAK,CAAC,SAAS,EAC3B,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,WAAW,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,2BAAY,EAAC,WAAW,CAAC,MAAW,CAAC,CAAC;AAC/C,CAAC,CAAC;AAVW,QAAA,yBAAyB,6BAUpC","sourcesContent":["import { actionResult, actionResultError } from '../logic/actionResult';\nimport { ActionProcessorResult } from '../types/Action';\nimport { StoryResult } from '../types/StorySession';\n\n/**\n * Turns a nested story's result into the calling processor's action result.\n * On error, `label` (the function that ran) goes in front of the error stack so the trace shows where it failed.\n */\nexport const storyResultToActionResult = <R>(storyResult: StoryResult<any, R>, label: string): ActionProcessorResult<R> => {\n  if (storyResult.error) {\n    return actionResultError(\n      storyResult.error.errorType,\n      storyResult.error.errorText,\n      storyResult.error.errorStack ? `${label} -> [${storyResult.error.errorStack}]` : label,\n    );\n  }\n\n  return actionResult(storyResult.result as R);\n};\n"]}

package/lib/commonjs/stories/array/askMapParallelBatch.d.ts

@@ -1,9 +1,2 @@
 import { AskResponse } from '../../types';
-export declare enum InvalidBatchSizeErrorCode {
-    notPositive = "notPositive"
-}
-export declare class InvalidBatchSizeError extends Error {
-    readonly code: InvalidBatchSizeErrorCode;
-    constructor(code: InvalidBatchSizeErrorCode, message: string);
-}
 export declare function askMapParallelBatch<T, R>(items: T[], numBatch: number, askCallback: (item: T, index: number, srcArray: T[]) => AskResponse<R>, delayAfterEachBatchMs?: number): AskResponse<R[]>;

package/lib/commonjs/stories/array/askMapParallelBatch.js

@@ -1,32 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidBatchSizeError = exports.InvalidBatchSizeErrorCode = void 0;
 exports.askMapParallelBatch = askMapParallelBatch;
 const actions_1 = require("../../actions");
+const types_1 = require("../../types");
 const askMapParallel_1 = require("./askMapParallel");
-var InvalidBatchSizeErrorCode;
-(function (InvalidBatchSizeErrorCode) {
-    // Zero, negative, or NaN: the loop could never drain the item list.
-    InvalidBatchSizeErrorCode["notPositive"] = "notPositive";
-})(InvalidBatchSizeErrorCode || (exports.InvalidBatchSizeErrorCode = InvalidBatchSizeErrorCode = {}));
-// Thrown when a batch size can never make progress. Without this guard a
-// numBatch below one would splice zero items per iteration and spin forever.
-class InvalidBatchSizeError extends Error {
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.name = 'InvalidBatchSizeError';
-    }
-}
-exports.InvalidBatchSizeError = InvalidBatchSizeError;
 function* askMapParallelBatch(items, numBatch, askCallback, delayAfterEachBatchMs = 0) {
     // A batch size below one would remove nothing per iteration and loop forever.
     // The negated >= comparison also rejects NaN.
     if (!(numBatch >= 1)) {
-        throw new InvalidBatchSizeError(InvalidBatchSizeErrorCode.notPositive, `numBatch must be at least 1, got ${numBatch}`);
+        return yield* (0, actions_1.askThrowError)(types_1.ErrorTypeEnum.Invalid, `numBatch must be at least 1, got ${numBatch}`);
     }
     // Copy the items array to avoid modifying the original array
-    let itemsToBatch = [...items];
+    const itemsToBatch = [...items];
     // Prepare an array to collect all results
     let allResults = [];
     // Continue creating batches until itemsToBatch is empty
@@ -45,7 +30,7 @@ function* askMapParallelBatch(items, numBatch, askCallback, delayAfterEachBatchM
         // If there is a delay after each batch, wait for the delay
         if (delayAfterEachBatchMs > 0) {
             // Wait for a delay after each batch
-            yield* (0, actions_1.askDelay)(delayAfterEachBatchMs);
+            yield* (0, actions_1.askPlatformDelay)(delayAfterEachBatchMs);
         }
     }
     return allResults;

package/lib/commonjs/stories/array/askMapParallelBatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"askMapParallelBatch.js","sourceRoot":"","sources":["../../../../src/stories/array/askMapParallelBatch.ts"],"names":[],"mappings":";;;AAqBA,kDA0CC;AA/DD,2CAAyC;AAEzC,qDAAkD;AAElD,IAAY,yBAGX;AAHD,WAAY,yBAAyB;IACnC,oEAAoE;IACpE,wDAA2B,CAAA;AAC7B,CAAC,EAHW,yBAAyB,yCAAzB,yBAAyB,QAGpC;AAED,yEAAyE;AACzE,6EAA6E;AAC7E,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YACkB,IAA+B,EAC/C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA2B;QAI/C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AARD,sDAQC;AAED,QAAe,CAAC,CAAC,mBAAmB,CAClC,KAAU,EACV,QAAgB,EAChB,WAAsE,EACtE,qBAAqB,GAAG,CAAC;IAEzB,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAAC,yBAAyB,CAAC,WAAW,EAAE,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IACzH,CAAC;IAED,6DAA6D;IAC7D,IAAI,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,IAAI,UAAU,GAAQ,EAAE,CAAC;IAEzB,wDAAwD;IACxD,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,sEAAsE;QACtE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE/C,gFAAgF;QAChF,yEAAyE;QACzE,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;QAC1C,QAAQ,CAAC,CAAC,0BAA0B,CAAC,IAAO,EAAE,UAAkB;YAC9D,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QAED,qEAAqE;QACrE,MAAM,YAAY,GAAQ,KAAK,CAAC,CAAC,IAAA,+BAAc,EAAO,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACzF,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAE7C,2DAA2D;QAC3D,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;YAC9B,oCAAoC;YACpC,KAAK,CAAC,CAAC,IAAA,kBAAQ,EAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { askDelay } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { askMapParallel } from './askMapParallel';\n\nexport enum InvalidBatchSizeErrorCode {\n  // Zero, negative, or NaN: the loop could never drain the item list.\n  notPositive = 'notPositive',\n}\n\n// Thrown when a batch size can never make progress. Without this guard a\n// numBatch below one would splice zero items per iteration and spin forever.\nexport class InvalidBatchSizeError extends Error {\n  constructor(\n    public readonly code: InvalidBatchSizeErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'InvalidBatchSizeError';\n  }\n}\n\nexport function* askMapParallelBatch<T, R>(\n  items: T[],\n  numBatch: number,\n  askCallback: (item: T, index: number, srcArray: T[]) => AskResponse<R>,\n  delayAfterEachBatchMs = 0,\n): AskResponse<R[]> {\n  // A batch size below one would remove nothing per iteration and loop forever.\n  // The negated >= comparison also rejects NaN.\n  if (!(numBatch >= 1)) {\n    throw new InvalidBatchSizeError(InvalidBatchSizeErrorCode.notPositive, `numBatch must be at least 1, got ${numBatch}`);\n  }\n\n  // Copy the items array to avoid modifying the original array\n  let itemsToBatch = [...items];\n\n  // Prepare an array to collect all results\n  let allResults: R[] = [];\n\n  // Continue creating batches until itemsToBatch is empty\n  while (itemsToBatch.length > 0) {\n    // Remove the first numBatch items from itemsToBatch to create a batch\n    const batch = itemsToBatch.splice(0, numBatch);\n\n    // askMapParallel only sees the batch slice, so re-base the callback's index and\n    // srcArray onto the original array to keep the same semantics as askMap.\n    const batchStartIndex = allResults.length;\n    function* askCallbackOnOriginalArray(item: T, batchIndex: number): AskResponse<R> {\n      return yield* askCallback(item, batchStartIndex + batchIndex, items);\n    }\n\n    // Process the current batch using askMapParallel and collect results\n    const batchResults: R[] = yield* askMapParallel<T, R>(batch, askCallbackOnOriginalArray);\n    allResults = allResults.concat(batchResults);\n\n    // If there is a delay after each batch, wait for the delay\n    if (delayAfterEachBatchMs > 0) {\n      // Wait for a delay after each batch\n      yield* askDelay(delayAfterEachBatchMs);\n    }\n  }\n\n  return allResults;\n}\n"]}
+{"version":3,"file":"askMapParallelBatch.js","sourceRoot":"","sources":["../../../../src/stories/array/askMapParallelBatch.ts"],"names":[],"mappings":";;AAIA,kDA0CC;AA9CD,2CAAgE;AAChE,uCAAyD;AACzD,qDAAkD;AAElD,QAAe,CAAC,CAAC,mBAAmB,CAClC,KAAU,EACV,QAAgB,EAChB,WAAsE,EACtE,qBAAqB,GAAG,CAAC;IAEzB,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,qBAAa,CAAC,OAAO,EAAE,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,6DAA6D;IAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAEhC,0CAA0C;IAC1C,IAAI,UAAU,GAAQ,EAAE,CAAC;IAEzB,wDAAwD;IACxD,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,sEAAsE;QACtE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE/C,gFAAgF;QAChF,yEAAyE;QACzE,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;QAC1C,QAAQ,CAAC,CAAC,0BAA0B,CAAC,IAAO,EAAE,UAAkB;YAC9D,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QAED,qEAAqE;QACrE,MAAM,YAAY,GAAQ,KAAK,CAAC,CAAC,IAAA,+BAAc,EAAO,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACzF,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAE7C,2DAA2D;QAC3D,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;YAC9B,oCAAoC;YACpC,KAAK,CAAC,CAAC,IAAA,0BAAgB,EAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { askPlatformDelay, askThrowError } from '../../actions';\nimport { AskResponse, ErrorTypeEnum } from '../../types';\nimport { askMapParallel } from './askMapParallel';\n\nexport function* askMapParallelBatch<T, R>(\n  items: T[],\n  numBatch: number,\n  askCallback: (item: T, index: number, srcArray: T[]) => AskResponse<R>,\n  delayAfterEachBatchMs = 0,\n): AskResponse<R[]> {\n  // A batch size below one would remove nothing per iteration and loop forever.\n  // The negated >= comparison also rejects NaN.\n  if (!(numBatch >= 1)) {\n    return yield* askThrowError(ErrorTypeEnum.Invalid, `numBatch must be at least 1, got ${numBatch}`);\n  }\n\n  // Copy the items array to avoid modifying the original array\n  const itemsToBatch = [...items];\n\n  // Prepare an array to collect all results\n  let allResults: R[] = [];\n\n  // Continue creating batches until itemsToBatch is empty\n  while (itemsToBatch.length > 0) {\n    // Remove the first numBatch items from itemsToBatch to create a batch\n    const batch = itemsToBatch.splice(0, numBatch);\n\n    // askMapParallel only sees the batch slice, so re-base the callback's index and\n    // srcArray onto the original array to keep the same semantics as askMap.\n    const batchStartIndex = allResults.length;\n    function* askCallbackOnOriginalArray(item: T, batchIndex: number): AskResponse<R> {\n      return yield* askCallback(item, batchStartIndex + batchIndex, items);\n    }\n\n    // Process the current batch using askMapParallel and collect results\n    const batchResults: R[] = yield* askMapParallel<T, R>(batch, askCallbackOnOriginalArray);\n    allResults = allResults.concat(batchResults);\n\n    // If there is a delay after each batch, wait for the delay\n    if (delayAfterEachBatchMs > 0) {\n      // Wait for a delay after each batch\n      yield* askPlatformDelay(delayAfterEachBatchMs);\n    }\n  }\n\n  return allResults;\n}\n"]}

package/lib/commonjs/stories/askGetApplicationVersion.d.ts

@@ -1,2 +1,2 @@
-import { AskResponse } from '../types';
-export declare function askGetApplicationVersion(): AskResponse<null | string>;
+import { AskResponse, Nullable } from '../types';
+export declare function askGetApplicationVersion(): AskResponse<Nullable<string>>;

package/lib/commonjs/stories/askGetApplicationVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"askGetApplicationVersion.js","sourceRoot":"","sources":["../../../src/stories/askGetApplicationVersion.ts"],"names":[],"mappings":";;AAKA,4DAQC;AAbD,wCAAgD;AAChD,4CAA2D;AAE3D,gDAA6C;AAE7C,QAAe,CAAC,CAAC,wBAAwB;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAA,4BAAkB,EAAS,uCAA2B,CAAC,CAAC,CAAC;IAEzF,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC","sourcesContent":["import { askConfigGetGlobal } from '../actions';\nimport { qpqApplicationVersionGlobal } from '../constants';\nimport { AskResponse } from '../types';\nimport { askCatch } from './system/askCatch';\n\nexport function* askGetApplicationVersion(): AskResponse<null | string> {\n  const version = yield* askCatch(askConfigGetGlobal<string>(qpqApplicationVersionGlobal));\n\n  if (!version.success) {\n    return null;\n  }\n\n  return version.result;\n}\n"]}
+{"version":3,"file":"askGetApplicationVersion.js","sourceRoot":"","sources":["../../../src/stories/askGetApplicationVersion.ts"],"names":[],"mappings":";;AAKA,4DAQC;AAbD,wCAAgD;AAChD,4CAA2D;AAE3D,gDAA6C;AAE7C,QAAe,CAAC,CAAC,wBAAwB;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAA,4BAAkB,EAAS,uCAA2B,CAAC,CAAC,CAAC;IAEzF,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC","sourcesContent":["import { askConfigGetGlobal } from '../actions';\nimport { qpqApplicationVersionGlobal } from '../constants';\nimport { AskResponse, Nullable } from '../types';\nimport { askCatch } from './system/askCatch';\n\nexport function* askGetApplicationVersion(): AskResponse<Nullable<string>> {\n  const version = yield* askCatch(askConfigGetGlobal<string>(qpqApplicationVersionGlobal));\n\n  if (!version.success) {\n    return null;\n  }\n\n  return version.result;\n}\n"]}

package/lib/commonjs/stories/askProcessEvent.js

@@ -5,7 +5,7 @@ exports.askProcessEventWithGroupOrdering = askProcessEventWithGroupOrdering;
 const actions_1 = require("../actions");
 const actions_2 = require("../actions");
 const system_1 = require("../actions/system");
-const actionLogic_1 = require("../logic/actionLogic");
+const actionResult_1 = require("../logic/actionResult");
 const types_1 = require("../types");
 const askCatch_1 = require("./system/askCatch");
 const array_1 = require("./array");
@@ -14,23 +14,29 @@ function* askProcessEventRecord(qpqEventRecord, eventArguments) {
     // Try and match a story to execute
     const matchResultResult = yield* (0, askCatch_1.askCatch)((0, actions_2.askEventMatchStory)(qpqEventRecord, eventArguments));
     if (!matchResultResult.success) {
-        return (0, actionLogic_1.getUnsuccessfulEitherActionResult)(matchResultResult.error);
+        return (0, actionResult_1.getUnsuccessfulEitherActionResult)(matchResultResult.error);
     }
     // See if we want to exit early (validation / auth etc)
     const earlyExitQpqEventRecordResponse = yield* (0, actions_2.askEventAutoRespond)(qpqEventRecord, matchResultResult.result);
     // Return
     if (earlyExitQpqEventRecordResponse != null) {
         // return the result
-        return (0, actionLogic_1.getSuccessfulEitherActionResult)(earlyExitQpqEventRecordResponse);
+        return (0, actionResult_1.getSuccessfulEitherActionResult)(earlyExitQpqEventRecordResponse);
+    }
+    const { runtime } = matchResultResult.result;
+    if (!runtime) {
+        return (0, actionResult_1.getUnsuccessfulEitherActionResult)({ errorType: types_1.ErrorTypeEnum.NotFound, errorText: 'The matched story has no runtime to execute' });
     }
     const messageSession = yield* (0, actions_2.askEventGetStorySession)(eventArguments, qpqEventRecord, matchResultResult.result);
     // Execute the story
-    const executeStoryResponse = yield* (0, askCatch_1.askCatch)((0, system_1.askExecuteStory)(matchResultResult.result.runtime, [qpqEventRecord, matchResultResult.result.runtimeOptions], messageSession));
+    const executeStoryResponse = yield* (0, askCatch_1.askCatch)((0, system_1.askExecuteStory)(runtime, [qpqEventRecord, matchResultResult.result.runtimeOptions], 
+    // An event source with no session of its own answers null; the story then starts a fresh one.
+    messageSession !== null && messageSession !== void 0 ? messageSession : undefined));
     if (executeStoryResponse.success) {
         // return the result of the story back to the event caller
-        return (0, actionLogic_1.getSuccessfulEitherActionResult)(executeStoryResponse.result);
+        return (0, actionResult_1.getSuccessfulEitherActionResult)(executeStoryResponse.result);
     }
-    return (0, actionLogic_1.getUnsuccessfulEitherActionResult)(executeStoryResponse.error);
+    return (0, actionResult_1.getUnsuccessfulEitherActionResult)(executeStoryResponse.error);
 }
 function* askTransformProcessedRecords(processedRecords, eventArguments) {
     const transformedResponse = yield* (0, askCatch_1.askCatch)((0, actions_2.askEventTransformResponseResult)(processedRecords, ...eventArguments));
@@ -62,7 +68,7 @@ function* askProcessEventWithGroupOrdering(getRecordGroupKey, ...eventArguments)
     for (const record of records) {
         const groupKey = getRecordGroupKey(record);
         if (groupKey !== undefined && failedGroupKeys.has(groupKey)) {
-            processedRecords.push((0, actionLogic_1.getUnsuccessfulEitherActionResult)({
+            processedRecords.push((0, actionResult_1.getUnsuccessfulEitherActionResult)({
                 errorType: types_1.ErrorTypeEnum.GenericError,
                 errorText: `Skipped: an earlier message in group [${groupKey}] failed`,
             }));

package/lib/commonjs/stories/askProcessEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"askProcessEvent.js","sourceRoot":"","sources":["../../../src/stories/askProcessEvent.ts"],"names":[],"mappings":"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","sourcesContent":["import { askLogCreate, askThrowError } from '../actions';\nimport {\n  AnyMatchStoryResult,\n  askEventAutoRespond,\n  askEventGetRecords,\n  askEventGetStorySession,\n  askEventMatchStory,\n  askEventTransformResponseResult,\n} from '../actions';\nimport { askExecuteStory } from '../actions/system';\nimport { getSuccessfulEitherActionResult, getUnsuccessfulEitherActionResult } from '../logic/actionLogic';\nimport { AskResponse, EitherActionResult, ErrorTypeEnum, LogLevelEnum } from '../types';\nimport { askCatch } from './system/askCatch';\nimport { askMapParallel } from './array';\nimport { askGetApplicationVersion } from './askGetApplicationVersion';\n\nfunction* askProcessEventRecord<QpqEventRecord, MSR extends AnyMatchStoryResult, QpqEventRecordResponse, EventParams extends Array<unknown> = any[]>(\n  qpqEventRecord: QpqEventRecord,\n  eventArguments: EventParams,\n): AskResponse<EitherActionResult<QpqEventRecordResponse>> {\n  // Try and match a story to execute\n  const matchResultResult = yield* askCatch(askEventMatchStory<QpqEventRecord, MSR, EventParams>(qpqEventRecord, eventArguments));\n  if (!matchResultResult.success) {\n    return getUnsuccessfulEitherActionResult(matchResultResult.error);\n  }\n\n  // See if we want to exit early (validation / auth etc)\n  const earlyExitQpqEventRecordResponse = yield* askEventAutoRespond<QpqEventRecord, MSR, QpqEventRecordResponse>(\n    qpqEventRecord,\n    matchResultResult.result,\n  );\n\n  // Return\n  if (earlyExitQpqEventRecordResponse != null) {\n    // return the result\n    return getSuccessfulEitherActionResult(earlyExitQpqEventRecordResponse);\n  }\n\n  const messageSession = yield* askEventGetStorySession<EventParams, QpqEventRecord, MSR>(eventArguments, qpqEventRecord, matchResultResult.result);\n\n  // Execute the story\n  const executeStoryResponse = yield* askCatch(\n    askExecuteStory<[QpqEventRecord, MSR['runtimeOptions']], QpqEventRecordResponse>(\n      matchResultResult.result.runtime!,\n      [qpqEventRecord, matchResultResult.result.runtimeOptions],\n      messageSession,\n    ),\n  );\n\n  if (executeStoryResponse.success) {\n    // return the result of the story back to the event caller\n    return getSuccessfulEitherActionResult(executeStoryResponse.result);\n  }\n\n  return getUnsuccessfulEitherActionResult(executeStoryResponse.error);\n}\n\nfunction* askTransformProcessedRecords<EventParams extends Array<unknown>, QpqEventRecordResponse, EventResponse>(\n  processedRecords: EitherActionResult<QpqEventRecordResponse>[],\n  eventArguments: EventParams,\n): AskResponse<EventResponse> {\n  const transformedResponse = yield* askCatch(\n    askEventTransformResponseResult<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, ...eventArguments),\n  );\n\n  if (!transformedResponse.success) {\n    yield* askLogCreate(LogLevelEnum.Fatal, transformedResponse.error.errorText);\n\n    return yield* askThrowError(transformedResponse.error.errorType, transformedResponse.error.errorText, transformedResponse.error.errorStack);\n  }\n\n  return transformedResponse.result;\n}\n\nexport function* askProcessEvent<\n  EventParams extends Array<unknown> = any[],\n  QpqEventRecord = any,\n  QpqEventRecordResponse = any,\n  MSR extends AnyMatchStoryResult = AnyMatchStoryResult,\n  EventResponse = any,\n>(...eventArguments: EventParams): AskResponse<EventResponse> {\n  // Try and get the app version\n  // This should be something the developer knows how to get to the code version\n  // like the git sha, we don't need to do anything with the global, it will be in the logs\n  yield* askGetApplicationVersion();\n\n  const records = yield* askEventGetRecords<EventParams, QpqEventRecord>(...eventArguments);\n\n  const processedRecords = yield* askMapParallel(records, function* askProcessEventRecordWithEvent(record) {\n    return yield* askProcessEventRecord<QpqEventRecord, MSR, QpqEventRecordResponse, EventParams>(record, eventArguments);\n  });\n\n  return yield* askTransformProcessedRecords<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, eventArguments);\n}\n\n// FIFO variant of askProcessEvent: records are processed one at a time, and once a record\n// fails, the remaining records in the same group are failed without executing so the\n// platform can redeliver them in order (block the group, not the batch).\nexport function* askProcessEventWithGroupOrdering<\n  EventParams extends Array<unknown> = any[],\n  QpqEventRecord = any,\n  QpqEventRecordResponse = any,\n  MSR extends AnyMatchStoryResult = AnyMatchStoryResult,\n  EventResponse = any,\n>(getRecordGroupKey: (record: QpqEventRecord) => string | undefined, ...eventArguments: EventParams): AskResponse<EventResponse> {\n  yield* askGetApplicationVersion();\n\n  const records = yield* askEventGetRecords<EventParams, QpqEventRecord>(...eventArguments);\n\n  const failedGroupKeys = new Set<string>();\n  const processedRecords: EitherActionResult<QpqEventRecordResponse>[] = [];\n\n  for (const record of records) {\n    const groupKey = getRecordGroupKey(record);\n\n    if (groupKey !== undefined && failedGroupKeys.has(groupKey)) {\n      processedRecords.push(\n        getUnsuccessfulEitherActionResult({\n          errorType: ErrorTypeEnum.GenericError,\n          errorText: `Skipped: an earlier message in group [${groupKey}] failed`,\n        }),\n      );\n      continue;\n    }\n\n    const processedRecord = yield* askProcessEventRecord<QpqEventRecord, MSR, QpqEventRecordResponse, EventParams>(record, eventArguments);\n\n    if (!processedRecord.success && groupKey !== undefined) {\n      failedGroupKeys.add(groupKey);\n    }\n\n    processedRecords.push(processedRecord);\n  }\n\n  return yield* askTransformProcessedRecords<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, eventArguments);\n}\n"]}
+{"version":3,"file":"askProcessEvent.js","sourceRoot":"","sources":["../../../src/stories/askProcessEvent.ts"],"names":[],"mappings":"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","sourcesContent":["import { askLogCreate, askThrowError } from '../actions';\nimport {\n  AnyMatchStoryResult,\n  askEventAutoRespond,\n  askEventGetRecords,\n  askEventGetStorySession,\n  askEventMatchStory,\n  askEventTransformResponseResult,\n} from '../actions';\nimport { askExecuteStory } from '../actions/system';\nimport { getSuccessfulEitherActionResult, getUnsuccessfulEitherActionResult } from '../logic/actionResult';\nimport { AskResponse, EitherActionResult, ErrorTypeEnum, LogLevelEnum } from '../types';\nimport { askCatch } from './system/askCatch';\nimport { askMapParallel } from './array';\nimport { askGetApplicationVersion } from './askGetApplicationVersion';\n\nfunction* askProcessEventRecord<QpqEventRecord, MSR extends AnyMatchStoryResult, QpqEventRecordResponse, EventParams extends Array<unknown> = any[]>(\n  qpqEventRecord: QpqEventRecord,\n  eventArguments: EventParams,\n): AskResponse<EitherActionResult<QpqEventRecordResponse>> {\n  // Try and match a story to execute\n  const matchResultResult = yield* askCatch(askEventMatchStory<QpqEventRecord, MSR, EventParams>(qpqEventRecord, eventArguments));\n  if (!matchResultResult.success) {\n    return getUnsuccessfulEitherActionResult(matchResultResult.error);\n  }\n\n  // See if we want to exit early (validation / auth etc)\n  const earlyExitQpqEventRecordResponse = yield* askEventAutoRespond<QpqEventRecord, MSR, QpqEventRecordResponse>(\n    qpqEventRecord,\n    matchResultResult.result,\n  );\n\n  // Return\n  if (earlyExitQpqEventRecordResponse != null) {\n    // return the result\n    return getSuccessfulEitherActionResult(earlyExitQpqEventRecordResponse);\n  }\n\n  const { runtime } = matchResultResult.result;\n  if (!runtime) {\n    return getUnsuccessfulEitherActionResult({ errorType: ErrorTypeEnum.NotFound, errorText: 'The matched story has no runtime to execute' });\n  }\n\n  const messageSession = yield* askEventGetStorySession<EventParams, QpqEventRecord, MSR>(eventArguments, qpqEventRecord, matchResultResult.result);\n\n  // Execute the story\n  const executeStoryResponse = yield* askCatch(\n    askExecuteStory<[QpqEventRecord, MSR['runtimeOptions']], QpqEventRecordResponse>(\n      runtime,\n      [qpqEventRecord, matchResultResult.result.runtimeOptions],\n      // An event source with no session of its own answers null; the story then starts a fresh one.\n      messageSession ?? undefined,\n    ),\n  );\n\n  if (executeStoryResponse.success) {\n    // return the result of the story back to the event caller\n    return getSuccessfulEitherActionResult(executeStoryResponse.result);\n  }\n\n  return getUnsuccessfulEitherActionResult(executeStoryResponse.error);\n}\n\nfunction* askTransformProcessedRecords<EventParams extends Array<unknown>, QpqEventRecordResponse, EventResponse>(\n  processedRecords: EitherActionResult<QpqEventRecordResponse>[],\n  eventArguments: EventParams,\n): AskResponse<EventResponse> {\n  const transformedResponse = yield* askCatch(\n    askEventTransformResponseResult<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, ...eventArguments),\n  );\n\n  if (!transformedResponse.success) {\n    yield* askLogCreate(LogLevelEnum.Fatal, transformedResponse.error.errorText);\n\n    return yield* askThrowError(transformedResponse.error.errorType, transformedResponse.error.errorText, transformedResponse.error.errorStack);\n  }\n\n  return transformedResponse.result;\n}\n\nexport function* askProcessEvent<\n  EventParams extends Array<unknown> = any[],\n  QpqEventRecord = any,\n  QpqEventRecordResponse = any,\n  MSR extends AnyMatchStoryResult = AnyMatchStoryResult,\n  EventResponse = any,\n>(...eventArguments: EventParams): AskResponse<EventResponse> {\n  // Try and get the app version\n  // This should be something the developer knows how to get to the code version\n  // like the git sha, we don't need to do anything with the global, it will be in the logs\n  yield* askGetApplicationVersion();\n\n  const records = yield* askEventGetRecords<EventParams, QpqEventRecord>(...eventArguments);\n\n  const processedRecords = yield* askMapParallel(records, function* askProcessEventRecordWithEvent(record) {\n    return yield* askProcessEventRecord<QpqEventRecord, MSR, QpqEventRecordResponse, EventParams>(record, eventArguments);\n  });\n\n  return yield* askTransformProcessedRecords<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, eventArguments);\n}\n\n// FIFO variant of askProcessEvent: records are processed one at a time, and once a record\n// fails, the remaining records in the same group are failed without executing so the\n// platform can redeliver them in order (block the group, not the batch).\nexport function* askProcessEventWithGroupOrdering<\n  EventParams extends Array<unknown> = any[],\n  QpqEventRecord = any,\n  QpqEventRecordResponse = any,\n  MSR extends AnyMatchStoryResult = AnyMatchStoryResult,\n  EventResponse = any,\n>(getRecordGroupKey: (record: QpqEventRecord) => string | undefined, ...eventArguments: EventParams): AskResponse<EventResponse> {\n  yield* askGetApplicationVersion();\n\n  const records = yield* askEventGetRecords<EventParams, QpqEventRecord>(...eventArguments);\n\n  const failedGroupKeys = new Set<string>();\n  const processedRecords: EitherActionResult<QpqEventRecordResponse>[] = [];\n\n  for (const record of records) {\n    const groupKey = getRecordGroupKey(record);\n\n    if (groupKey !== undefined && failedGroupKeys.has(groupKey)) {\n      processedRecords.push(\n        getUnsuccessfulEitherActionResult({\n          errorType: ErrorTypeEnum.GenericError,\n          errorText: `Skipped: an earlier message in group [${groupKey}] failed`,\n        }),\n      );\n      continue;\n    }\n\n    const processedRecord = yield* askProcessEventRecord<QpqEventRecord, MSR, QpqEventRecordResponse, EventParams>(record, eventArguments);\n\n    if (!processedRecord.success && groupKey !== undefined) {\n      failedGroupKeys.add(groupKey);\n    }\n\n    processedRecords.push(processedRecord);\n  }\n\n  return yield* askTransformProcessedRecords<EventParams, QpqEventRecordResponse, EventResponse>(processedRecords, eventArguments);\n}\n"]}

package/lib/commonjs/stories/askRetry.js

@@ -18,7 +18,7 @@ function* askRetry(askRunLogic, maxRetries, timeToWaitMs, errorTypeRetryList, op
         }
         let waitMs = (options === null || options === void 0 ? void 0 : options.linearBackoff) ? timeToWaitMs * attempt : timeToWaitMs;
         if (options === null || options === void 0 ? void 0 : options.maxJitterMs) {
-            const guid = yield* (0, actions_1.askNewGuid)();
+            const guid = yield* (0, actions_1.askGuidNew)();
             const jitterByte = parseInt(guid.slice(0, 2), 16);
             // Guid processors are platform-pluggable, so guard against a non-hex id
             // poisoning the wait with NaN.
@@ -26,7 +26,7 @@ function* askRetry(askRunLogic, maxRetries, timeToWaitMs, errorTypeRetryList, op
                 waitMs += Math.floor((jitterByte / 255) * options.maxJitterMs);
             }
         }
-        yield* (0, actions_1.askDelay)(waitMs);
+        yield* (0, actions_1.askPlatformDelay)(waitMs);
     }
 }
 //# sourceMappingURL=askRetry.js.map

package/lib/commonjs/stories/askRetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"askRetry.js","sourceRoot":"","sources":["../../../src/stories/askRetry.ts"],"names":[],"mappings":";;AAgBA,4BAsCC;AAtDD,wCAAkD;AAElD,qCAAoC;AAcpC,QAAe,CAAC,CAAC,QAAQ,CACvB,WAAiC,EACjC,UAAkB,EAClB,YAAoB,EACpB,kBAA6B,EAC7B,OAAyB;IAEzB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,IAAA,iBAAQ,EAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC;QAEtB,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACvB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzD,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,EAAC,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QAE5E,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,oBAAU,GAAE,CAAC;YACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAElD,wEAAwE;YACxE,+BAA+B;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,CAAC,IAAA,kBAAQ,EAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC","sourcesContent":["import { askDelay, askNewGuid } from '../actions';\nimport { AskResponse } from '../types';\nimport { askCatch } from './system';\n\nexport type AskRetryOptions = {\n  // Multiply the wait by the attempt number (1-based) — linear backoff for\n  // contended resources instead of a fixed interval.\n  linearBackoff?: boolean;\n\n  // Add 0..maxJitterMs of guid-derived jitter to each wait, so concurrent\n  // losers of a shared race spread out instead of retrying in lockstep.\n  // (Stories cannot use Math.random; askNewGuid is the replay-safe entropy\n  // source.)\n  maxJitterMs?: number;\n};\n\nexport function* askRetry<R>(\n  askRunLogic: () => AskResponse<R>,\n  maxRetries: number,\n  timeToWaitMs: number,\n  errorTypeRetryList?: string[],\n  options?: AskRetryOptions,\n): ReturnType<typeof askCatch<AskResponse<R>>> {\n  let attempt = 0;\n\n  while (true) {\n    const result = yield* askCatch(askRunLogic());\n    attempt = attempt + 1;\n\n    if (result.success || attempt > maxRetries) {\n      return result;\n    }\n\n    if (errorTypeRetryList) {\n      if (!errorTypeRetryList.includes(result.error.errorType)) {\n        return result;\n      }\n    }\n\n    let waitMs = options?.linearBackoff ? timeToWaitMs * attempt : timeToWaitMs;\n\n    if (options?.maxJitterMs) {\n      const guid = yield* askNewGuid();\n      const jitterByte = parseInt(guid.slice(0, 2), 16);\n\n      // Guid processors are platform-pluggable, so guard against a non-hex id\n      // poisoning the wait with NaN.\n      if (!Number.isNaN(jitterByte)) {\n        waitMs += Math.floor((jitterByte / 255) * options.maxJitterMs);\n      }\n    }\n\n    yield* askDelay(waitMs);\n  }\n}\n"]}
+{"version":3,"file":"askRetry.js","sourceRoot":"","sources":["../../../src/stories/askRetry.ts"],"names":[],"mappings":";;AAgBA,4BAsCC;AAtDD,wCAA0D;AAE1D,qCAAoC;AAcpC,QAAe,CAAC,CAAC,QAAQ,CACvB,WAAiC,EACjC,UAAkB,EAClB,YAAoB,EACpB,kBAA6B,EAC7B,OAAyB;IAEzB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,IAAA,iBAAQ,EAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC;QAEtB,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACvB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzD,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,EAAC,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QAE5E,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,oBAAU,GAAE,CAAC;YACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAElD,wEAAwE;YACxE,+BAA+B;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,CAAC,IAAA,0BAAgB,EAAC,MAAM,CAAC,CAAC;IAClC,CAAC;AACH,CAAC","sourcesContent":["import { askGuidNew, askPlatformDelay } from '../actions';\nimport { AskResponse } from '../types';\nimport { askCatch } from './system';\n\nexport type AskRetryOptions = {\n  // Multiply the wait by the attempt number (1-based), linear backoff for\n  // contended resources instead of a fixed interval.\n  linearBackoff?: boolean;\n\n  // Add 0..maxJitterMs of guid-derived jitter to each wait, so concurrent\n  // losers of a shared race spread out instead of retrying in lockstep.\n  // (Stories cannot use Math.random; askGuidNew is the replay-safe entropy\n  // source.)\n  maxJitterMs?: number;\n};\n\nexport function* askRetry<R>(\n  askRunLogic: () => AskResponse<R>,\n  maxRetries: number,\n  timeToWaitMs: number,\n  errorTypeRetryList?: string[],\n  options?: AskRetryOptions,\n): ReturnType<typeof askCatch<AskResponse<R>>> {\n  let attempt = 0;\n\n  while (true) {\n    const result = yield* askCatch(askRunLogic());\n    attempt = attempt + 1;\n\n    if (result.success || attempt > maxRetries) {\n      return result;\n    }\n\n    if (errorTypeRetryList) {\n      if (!errorTypeRetryList.includes(result.error.errorType)) {\n        return result;\n      }\n    }\n\n    let waitMs = options?.linearBackoff ? timeToWaitMs * attempt : timeToWaitMs;\n\n    if (options?.maxJitterMs) {\n      const guid = yield* askGuidNew();\n      const jitterByte = parseInt(guid.slice(0, 2), 16);\n\n      // Guid processors are platform-pluggable, so guard against a non-hex id\n      // poisoning the wait with NaN.\n      if (!Number.isNaN(jitterByte)) {\n        waitMs += Math.floor((jitterByte / 255) * options.maxJitterMs);\n      }\n    }\n\n    yield* askPlatformDelay(waitMs);\n  }\n}\n"]}

package/lib/commonjs/stories/binaryData/askCreateTextQpqBinaryData.d.ts

@@ -0,0 +1,2 @@
+import { AskResponse, QPQBinaryData, TextFileType } from '../../types';
+export declare function askCreateTextQpqBinaryData(textData: string, filename: string, fileType: TextFileType): AskResponse<QPQBinaryData>;

package/lib/commonjs/stories/binaryData/askCreateTextQpqBinaryData.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askCreateTextQpqBinaryData = askCreateTextQpqBinaryData;
+const types_1 = require("../../types");
+const TextFileTypeMimeTypeMap = {
+    [types_1.TextFileType.Json]: 'application/json',
+    [types_1.TextFileType.Xml]: 'application/xml',
+    [types_1.TextFileType.PlainText]: 'text/plain',
+    [types_1.TextFileType.Html]: 'text/html',
+    [types_1.TextFileType.Css]: 'text/css',
+    [types_1.TextFileType.JavaScript]: 'application/javascript',
+    [types_1.TextFileType.Csv]: 'text/csv',
+    [types_1.TextFileType.Markdown]: 'text/markdown',
+    [types_1.TextFileType.Yaml]: 'application/x-yaml',
+    [types_1.TextFileType.Rtf]: 'application/rtf',
+};
+// Base64-encode a string's UTF-8 bytes using web globals (TextEncoder/btoa) rather than
+// Node's Buffer, so this also works in browser bundles of @qpqjs/core. Mirrors the
+// decode direction in StreamReadRequester, which already uses atob.
+const encodeUtf8ToBase64 = (textData) => {
+    const utf8Bytes = new TextEncoder().encode(textData);
+    let binary = '';
+    for (const byte of utf8Bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+};
+function* askCreateTextQpqBinaryData(textData, filename, fileType) {
+    const binaryData = {
+        base64Data: encodeUtf8ToBase64(textData),
+        filename: filename,
+        mimetype: TextFileTypeMimeTypeMap[fileType],
+    };
+    return binaryData;
+}
+//# sourceMappingURL=askCreateTextQpqBinaryData.js.map

package/lib/commonjs/stories/binaryData/askCreateTextQpqBinaryData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askCreateTextQpqBinaryData.js","sourceRoot":"","sources":["../../../../src/stories/binaryData/askCreateTextQpqBinaryData.ts"],"names":[],"mappings":";;AA6BA,gEAQC;AArCD,uCAAuE;AAEvE,MAAM,uBAAuB,GAAsC;IACjE,CAAC,oBAAY,CAAC,IAAI,CAAC,EAAE,kBAAkB;IACvC,CAAC,oBAAY,CAAC,GAAG,CAAC,EAAE,iBAAiB;IACrC,CAAC,oBAAY,CAAC,SAAS,CAAC,EAAE,YAAY;IACtC,CAAC,oBAAY,CAAC,IAAI,CAAC,EAAE,WAAW;IAChC,CAAC,oBAAY,CAAC,GAAG,CAAC,EAAE,UAAU;IAC9B,CAAC,oBAAY,CAAC,UAAU,CAAC,EAAE,wBAAwB;IACnD,CAAC,oBAAY,CAAC,GAAG,CAAC,EAAE,UAAU;IAC9B,CAAC,oBAAY,CAAC,QAAQ,CAAC,EAAE,eAAe;IACxC,CAAC,oBAAY,CAAC,IAAI,CAAC,EAAE,oBAAoB;IACzC,CAAC,oBAAY,CAAC,GAAG,CAAC,EAAE,iBAAiB;CACtC,CAAC;AAEF,wFAAwF;AACxF,mFAAmF;AACnF,oEAAoE;AACpE,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAU,EAAE;IACtD,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,QAAe,CAAC,CAAC,0BAA0B,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAsB;IACpG,MAAM,UAAU,GAAkB;QAChC,UAAU,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QACxC,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,CAAC;KAC5C,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { AskResponse, QPQBinaryData, TextFileType } from '../../types';\n\nconst TextFileTypeMimeTypeMap: { [key in TextFileType]: string } = {\n  [TextFileType.Json]: 'application/json',\n  [TextFileType.Xml]: 'application/xml',\n  [TextFileType.PlainText]: 'text/plain',\n  [TextFileType.Html]: 'text/html',\n  [TextFileType.Css]: 'text/css',\n  [TextFileType.JavaScript]: 'application/javascript',\n  [TextFileType.Csv]: 'text/csv',\n  [TextFileType.Markdown]: 'text/markdown',\n  [TextFileType.Yaml]: 'application/x-yaml',\n  [TextFileType.Rtf]: 'application/rtf',\n};\n\n// Base64-encode a string's UTF-8 bytes using web globals (TextEncoder/btoa) rather than\n// Node's Buffer, so this also works in browser bundles of @qpqjs/core. Mirrors the\n// decode direction in StreamReadRequester, which already uses atob.\nconst encodeUtf8ToBase64 = (textData: string): string => {\n  const utf8Bytes = new TextEncoder().encode(textData);\n\n  let binary = '';\n  for (const byte of utf8Bytes) {\n    binary += String.fromCharCode(byte);\n  }\n\n  return btoa(binary);\n};\n\nexport function* askCreateTextQpqBinaryData(textData: string, filename: string, fileType: TextFileType): AskResponse<QPQBinaryData> {\n  const binaryData: QPQBinaryData = {\n    base64Data: encodeUtf8ToBase64(textData),\n    filename: filename,\n    mimetype: TextFileTypeMimeTypeMap[fileType],\n  };\n\n  return binaryData;\n}\n"]}

package/lib/commonjs/stories/binaryData/index.d.ts

@@ -1 +1 @@
-export * from './askCreateBinaryData';
+export * from './askCreateTextQpqBinaryData';

package/lib/commonjs/stories/binaryData/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("./askCreateBinaryData"), exports);
+__exportStar(require("./askCreateTextQpqBinaryData"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/stories/binaryData/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stories/binaryData/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC","sourcesContent":["export * from './askCreateBinaryData';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stories/binaryData/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C","sourcesContent":["export * from './askCreateTextQpqBinaryData';\n"]}

package/lib/commonjs/stories/context/askContextProvideValue.js

@@ -1,52 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askContextProvideValue = askContextProvideValue;
-const actions_1 = require("../../actions");
 const context_1 = require("../../actions/context");
-const askOverrideActions_1 = require("../system/askOverrideActions");
+const overrideActions_1 = require("../system/overrideActions");
+const createContextInjectOverride_1 = require("./overrides/createContextInjectOverride");
+const createContextListOverride_1 = require("./overrides/createContextListOverride");
+const createContextReadOverride_1 = require("./overrides/createContextReadOverride");
+// Runs the story with this identifier's value in context: reads of it are answered here, context
+// lists include it, and every other action carries it onward.
 function* askContextProvideValue(contextIdentifier, value, storyIterator) {
-    let cache = null;
-    return yield* (0, askOverrideActions_1.askOverrideActions)(storyIterator, {
-        [context_1.ContextActionType.Read]: function* (action) {
-            const payload = action.payload;
-            if (payload.contextIdentifier.uniqueName === contextIdentifier.uniqueName) {
-                // We produce this value ourselves, so we shape it for returnErrors.
-                return (0, askOverrideActions_1.getSuccessfulEitherActionResultIfRequired)(value, action.returnErrors);
-            }
-            // Not our identifier — relay the action and forward its result verbatim.
-            return yield action;
-        },
-        [context_1.ContextActionType.List]: function* (action) {
-            // Local context is not part of the cross-service context list; stay transparent.
-            if (contextIdentifier.local) {
-                return yield action;
-            }
-            if (cache === null) {
-                const parentContextValues = (yield {
-                    type: context_1.ContextActionType.List,
-                    returnErrors: true,
-                });
-                // A failed parent list must propagate, not be masked as an empty parent context.
-                // The failure Either is already the shape the inner action expects when it carries
-                // returnErrors; otherwise rethrow so the error surfaces as normal.
-                if (!parentContextValues.success) {
-                    if (action.returnErrors) {
-                        return parentContextValues;
-                    }
-                    return yield* (0, actions_1.askThrowError)(parentContextValues.error.errorType, parentContextValues.error.errorText, parentContextValues.error.errorStack);
-                }
-                cache = Object.assign(Object.assign({}, (parentContextValues.result || {})), { [contextIdentifier.uniqueName]: value });
-            }
-            // We produce this value ourselves, so we shape it for returnErrors.
-            return (0, askOverrideActions_1.getSuccessfulEitherActionResultIfRequired)(cache, action.returnErrors);
-        },
-        '*': function* (action) {
-            // Local context rides in a separate bag that is stripped at service boundaries.
-            const contextKey = contextIdentifier.local ? 'localContext' : 'context';
-            // Inject our context onto the action and relay it; the parent's result is already correctly
-            // shaped, so we forward it verbatim.
-            return yield Object.assign(Object.assign({}, action), { [contextKey]: Object.assign({ [contextIdentifier.uniqueName]: value }, action[contextKey]) });
-        },
+    return yield* (0, overrideActions_1.askOverrideActions)(storyIterator, {
+        [context_1.ContextActionType.Read]: (0, createContextReadOverride_1.createContextReadOverride)(contextIdentifier, value),
+        [context_1.ContextActionType.List]: (0, createContextListOverride_1.createContextListOverride)(contextIdentifier, value),
+        '*': (0, createContextInjectOverride_1.createContextInjectOverride)(contextIdentifier, value),
     });
 }
 //# sourceMappingURL=askContextProvideValue.js.map