@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/proiseify/getSystemExecuteStoryActionProcessor.js

@@ -1,106 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSystemExecuteStoryActionProcessor = exports.getRun = exports.QpqPromisifyActionError = exports.getDateNow = void 0;
-exports.qpqPromisify = qpqPromisify;
-const actions_1 = require("../actions");
-const actionLogic_1 = require("../logic/actionLogic");
-const runtime_1 = require("../runtime");
-const stories_1 = require("../stories");
-const types_1 = require("../types");
-const getDateNow = () => new Date().toISOString();
-exports.getDateNow = getDateNow;
-// Thrown when an action inside a promisified story fails without returnErrors.
-// Carries the structured action error so the ExecuteStory processor can
-// surface the original errorType instead of collapsing everything to a
-// GenericError string.
-class QpqPromisifyActionError extends Error {
-    constructor(actionError) {
-        super(actionError.errorText);
-        this.actionError = actionError;
-        this.code = 'qpqPromisifyActionError';
-    }
-}
-exports.QpqPromisifyActionError = QpqPromisifyActionError;
-function qpqPromisify(story, runtimeInfo) {
-    return (...params) => __awaiter(this, void 0, void 0, function* () {
-        try {
-            const reader = story(...params);
-            let storyProgress = reader.next();
-            while (!storyProgress.done) {
-                const action = storyProgress.value;
-                const [payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry] = runtimeInfo;
-                const actionResult = yield (0, runtime_1.processAction)(action, actionProcessors, session, logger, updateSession, dynamicModuleLoader, streamRegistry);
-                const isSuccess = !(0, actionLogic_1.isErroredActionResult)(actionResult);
-                if (action.returnErrors) {
-                    const result = isSuccess
-                        ? { success: true, result: (0, actionLogic_1.resolveActionResult)(actionResult) }
-                        : { success: false, error: (0, actionLogic_1.resolveActionResultError)(actionResult) };
-                    storyProgress = reader.next(result);
-                }
-                else {
-                    if (!isSuccess) {
-                        throw new QpqPromisifyActionError((0, actionLogic_1.resolveActionResultError)(actionResult));
-                    }
-                    const result = (0, actionLogic_1.resolveActionResult)(actionResult);
-                    storyProgress = reader.next(result);
-                }
-            }
-            return storyProgress.value;
-        }
-        catch (error) {
-            // Real errors (including QpqPromisifyActionError above) propagate as-is
-            // so callers keep the original message, type and stack. Only non-Error
-            // throws get wrapped.
-            if (error instanceof Error) {
-                throw error;
-            }
-            throw new Error(`Error in qpqPromisify: ${error}`);
-        }
-    });
-}
-const getRun = (qpqPromisifyRuntime) => (storyRuntime) => __awaiter(void 0, void 0, void 0, function* () {
-    const runAny = qpqPromisify(stories_1.askRunParallel, qpqPromisifyRuntime);
-    const [result] = yield runAny([storyRuntime]);
-    return result;
-});
-exports.getRun = getRun;
-const getProcessExecuteStory = (qpqConfig) => {
-    return (payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry) => __awaiter(void 0, void 0, void 0, function* () {
-        const story = yield dynamicModuleLoader(payload.runtime);
-        if (!story) {
-            return (0, actionLogic_1.actionResultError)(types_1.ErrorTypeEnum.NotFound, `Unable to dynamically load: [${payload.runtime}]`);
-        }
-        try {
-            const qpqPromisifyRuntime = [
-                payload,
-                session,
-                actionProcessors,
-                logger,
-                updateSession,
-                dynamicModuleLoader,
-                streamRegistry,
-            ];
-            const result = yield story(...payload.params, (0, exports.getRun)(qpqPromisifyRuntime));
-            return (0, actionLogic_1.actionResult)(result);
-        }
-        catch (error) {
-            // Keep the original error type when a nested action failed, instead of
-            // collapsing everything into a GenericError.
-            if (error instanceof QpqPromisifyActionError) {
-                return (0, actionLogic_1.actionResultError)(error.actionError.errorType, error.actionError.errorText, error.actionError.errorStack);
-            }
-            return (0, actionLogic_1.actionResultError)(types_1.ErrorTypeEnum.GenericError, `${error}`);
-        }
-    });
-};
-exports.getSystemExecuteStoryActionProcessor = (0, types_1.createActionProcessor)(actions_1.askExecuteStoryBase, getProcessExecuteStory);
-//# sourceMappingURL=getSystemExecuteStoryActionProcessor.js.map

package/lib/commonjs/proiseify/getSystemExecuteStoryActionProcessor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getSystemExecuteStoryActionProcessor.js","sourceRoot":"","sources":["../../../src/proiseify/getSystemExecuteStoryActionProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { askExecuteStoryBase } from '../actions';\nimport { QPQConfig } from '../config';\nimport { actionResult, actionResultError, isErroredActionResult, resolveActionResult, resolveActionResultError } from '../logic/actionLogic';\nimport { processAction } from '../runtime';\nimport { askRunParallel } from '../stories';\nimport { ActionProcessor, AskResponse, AskResponseReturnType, createActionProcessor, ErrorTypeEnum, ProcessorFor, QPQError, Story } from '../types';\n\nexport const getDateNow = () => new Date().toISOString();\n\n// Thrown when an action inside a promisified story fails without returnErrors.\n// Carries the structured action error so the ExecuteStory processor can\n// surface the original errorType instead of collapsing everything to a\n// GenericError string.\nexport class QpqPromisifyActionError extends Error {\n  readonly code = 'qpqPromisifyActionError';\n\n  constructor(readonly actionError: QPQError) {\n    super(actionError.errorText);\n  }\n}\n\ntype QpqPromisifyRuntime = Parameters<ActionProcessor<any, any>>;\n\n// Define the base type for getRun\nexport type QpqResolveAsPromise = <T extends AskResponse<any>>(storyRuntime: T) => Promise<AskResponseReturnType<T>>;\n\nexport function qpqPromisify<S extends Story<any, any>>(\n  story: S,\n  runtimeInfo: QpqPromisifyRuntime,\n): (...params: Parameters<S>) => Promise<AskResponseReturnType<ReturnType<S>>> {\n  return async (...params: Parameters<S>): Promise<AskResponseReturnType<ReturnType<S>>> => {\n    try {\n      const reader = story(...params);\n      let storyProgress = reader.next();\n\n      while (!storyProgress.done) {\n        const action = storyProgress.value;\n\n        const [payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry] = runtimeInfo;\n        const actionResult = await processAction(action, actionProcessors, session, logger, updateSession, dynamicModuleLoader, streamRegistry);\n\n        const isSuccess = !isErroredActionResult(actionResult);\n\n        if (action.returnErrors) {\n          const result = isSuccess\n            ? { success: true, result: resolveActionResult(actionResult) }\n            : { success: false, error: resolveActionResultError(actionResult) };\n\n          storyProgress = reader.next(result);\n        } else {\n          if (!isSuccess) {\n            throw new QpqPromisifyActionError(resolveActionResultError(actionResult));\n          }\n\n          const result = resolveActionResult(actionResult);\n          storyProgress = reader.next(result);\n        }\n      }\n\n      return storyProgress.value;\n    } catch (error) {\n      // Real errors (including QpqPromisifyActionError above) propagate as-is\n      // so callers keep the original message, type and stack. Only non-Error\n      // throws get wrapped.\n      if (error instanceof Error) {\n        throw error;\n      }\n\n      throw new Error(`Error in qpqPromisify: ${error}`);\n    }\n  };\n}\n\nexport const getRun =\n  (qpqPromisifyRuntime: QpqPromisifyRuntime): QpqResolveAsPromise =>\n  async <T extends AskResponse<any>>(storyRuntime: T): Promise<AskResponseReturnType<T>> => {\n    const runAny = qpqPromisify(askRunParallel, qpqPromisifyRuntime);\n    const [result] = await runAny([storyRuntime]);\n    return result;\n  };\n\nconst getProcessExecuteStory = (qpqConfig: QPQConfig): ProcessorFor<typeof askExecuteStoryBase> => {\n  return async (payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry) => {\n    const story = await dynamicModuleLoader(payload.runtime);\n    if (!story) {\n      return actionResultError(ErrorTypeEnum.NotFound, `Unable to dynamically load: [${payload.runtime}]`);\n    }\n\n    try {\n      const qpqPromisifyRuntime: QpqPromisifyRuntime = [\n        payload,\n        session,\n        actionProcessors,\n        logger,\n        updateSession,\n        dynamicModuleLoader,\n        streamRegistry,\n      ];\n      const result = await story(...payload.params, getRun(qpqPromisifyRuntime));\n\n      return actionResult(result);\n    } catch (error) {\n      // Keep the original error type when a nested action failed, instead of\n      // collapsing everything into a GenericError.\n      if (error instanceof QpqPromisifyActionError) {\n        return actionResultError(error.actionError.errorType, error.actionError.errorText, error.actionError.errorStack);\n      }\n\n      return actionResultError(ErrorTypeEnum.GenericError, `${error}`);\n    }\n  };\n};\n\nexport const getSystemExecuteStoryActionProcessor = createActionProcessor(askExecuteStoryBase, getProcessExecuteStory);\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/proiseify/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yEAAuD","sourcesContent":["export * from './getSystemExecuteStoryActionProcessor';\n"]}

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

@@ -1,14 +0,0 @@
-import { AskResponse, QPQBinaryData } from '../../types';
-export declare enum TextFileType {
-    Json = "Json",
-    Xml = "Xml",
-    PlainText = "PlainText",
-    Html = "Html",
-    Css = "Css",
-    JavaScript = "JavaScript",
-    Csv = "Csv",
-    Markdown = "Markdown",
-    Yaml = "Yaml",
-    Rtf = "Rtf"
-}
-export declare function askCreateTextQpqBinaryData(textData: string, filename: string, fileType: TextFileType): AskResponse<QPQBinaryData>;

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

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextFileType = void 0;
-exports.askCreateTextQpqBinaryData = askCreateTextQpqBinaryData;
-var TextFileType;
-(function (TextFileType) {
-    TextFileType["Json"] = "Json";
-    TextFileType["Xml"] = "Xml";
-    TextFileType["PlainText"] = "PlainText";
-    TextFileType["Html"] = "Html";
-    TextFileType["Css"] = "Css";
-    TextFileType["JavaScript"] = "JavaScript";
-    TextFileType["Csv"] = "Csv";
-    TextFileType["Markdown"] = "Markdown";
-    TextFileType["Yaml"] = "Yaml";
-    TextFileType["Rtf"] = "Rtf";
-})(TextFileType || (exports.TextFileType = TextFileType = {}));
-const TextFileTypeMimeTypeMap = {
-    [TextFileType.Json]: 'application/json',
-    [TextFileType.Xml]: 'application/xml',
-    [TextFileType.PlainText]: 'text/plain',
-    [TextFileType.Html]: 'text/html',
-    [TextFileType.Css]: 'text/css',
-    [TextFileType.JavaScript]: 'application/javascript',
-    [TextFileType.Csv]: 'text/csv',
-    [TextFileType.Markdown]: 'text/markdown',
-    [TextFileType.Yaml]: 'application/x-yaml',
-    [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 (let i = 0; i < utf8Bytes.length; i++) {
-        binary += String.fromCharCode(utf8Bytes[i]);
-    }
-    return btoa(binary);
-};
-function* askCreateTextQpqBinaryData(textData, filename, fileType) {
-    const binaryData = {
-        base64Data: encodeUtf8ToBase64(textData),
-        filename: filename,
-        mimetype: TextFileTypeMimeTypeMap[fileType],
-    };
-    return binaryData;
-}
-//# sourceMappingURL=askCreateBinaryData.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"askCreateBinaryData.js","sourceRoot":"","sources":["../../../../src/stories/binaryData/askCreateBinaryData.ts"],"names":[],"mappings":";;;AA0CA,gEAQC;AAhDD,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,uCAAuB,CAAA;IACvB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,yCAAyB,CAAA;IACzB,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,6BAAa,CAAA;IACb,2BAAW,CAAA;AACb,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB;AAED,MAAM,uBAAuB,GAAsC;IACjE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,kBAAkB;IACvC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,iBAAiB;IACrC,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,YAAY;IACtC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW;IAChC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU;IAC9B,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,wBAAwB;IACnD,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU;IAC9B,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,eAAe;IACxC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,oBAAoB;IACzC,CAAC,YAAY,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,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,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 } from '../../types';\n\nexport enum TextFileType {\n  Json = 'Json',\n  Xml = 'Xml',\n  PlainText = 'PlainText',\n  Html = 'Html',\n  Css = 'Css',\n  JavaScript = 'JavaScript',\n  Csv = 'Csv',\n  Markdown = 'Markdown',\n  Yaml = 'Yaml',\n  Rtf = 'Rtf',\n}\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 (let i = 0; i < utf8Bytes.length; i++) {\n    binary += String.fromCharCode(utf8Bytes[i]);\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/system/askOverrideActions.d.ts

@@ -1,7 +0,0 @@
-import { Action, AskResponse, AskResponseReturnType, EitherActionResult } from '../../types';
-export type ActionOverrideHandler<TAction extends Action<any> = Action<any>, TResult = any> = (action: TAction) => AskResponse<TResult>;
-export type ActionOverrideMap = {
-    [actionType: string]: ActionOverrideHandler<any, any>;
-};
-export declare function getSuccessfulEitherActionResultIfRequired<T, ReturnErrors extends boolean>(value: T, returnErrors?: ReturnErrors): ReturnErrors extends true ? EitherActionResult<T> : T;
-export declare function askOverrideActions<T extends AskResponse<any>>(storyIterator: T, overrides: ActionOverrideMap): AskResponse<AskResponseReturnType<T>>;

package/lib/commonjs/stories/system/askOverrideActions.js

@@ -1,169 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSuccessfulEitherActionResultIfRequired = getSuccessfulEitherActionResultIfRequired;
-exports.askOverrideActions = askOverrideActions;
-const actions_1 = require("../../actions");
-const actionLogic_1 = require("../../logic/actionLogic");
-const askMapParallel_1 = require("../array/askMapParallel");
-const askCatch_1 = require("./askCatch");
-// Looks up a handler as an OWN property of the override map. A plain-object map inherits from
-// Object.prototype, so an action type like "toString" or "constructor" would otherwise resolve
-// to an inherited function and get invoked as a handler.
-function getOwnOverrideHandler(overrides, actionType) {
-    return Object.prototype.hasOwnProperty.call(overrides, actionType) ? overrides[actionType] : undefined;
-}
-// A tiny helper story that just yields a single action and returns whatever the processor gives back.
-// We use this to wrap individual actions so we can pass them into askOverrideActions recursively.
-// For example, when we pull an action out of a batch, we wrap it in this so askOverrideActions
-// can intercept it as if it were a normal top-level action being yielded by a story.
-function* askProcessAction(action) {
-    return (yield action);
-}
-// Shapes a handler's OWN computed value into what the story expects.
-//
-// When an action has returnErrors set to true (because askCatch wrapped it), the story expects the
-// result wrapped in { success: true, result: value }. The runtime normally does this, but an override
-// bypasses the runtime — so a handler that returns a value it computed itself must shape it with this
-// helper (passing the action's returnErrors). If returnErrors is false/undefined it returns the value
-// unchanged.
-//
-// Handlers that simply RELAY the action with `return yield action` must NOT call this: the value they
-// get back from the parent is already in the right shape (raw, or an EitherActionResult when the
-// action carried returnErrors), and the engine forwards a handler's return value verbatim.
-function getSuccessfulEitherActionResultIfRequired(value, returnErrors) {
-    if (returnErrors) {
-        return (0, actionLogic_1.getSuccessfulEitherActionResult)(value);
-    }
-    else {
-        // returnErrors is false, so just pass the raw value through unchanged
-        return value;
-    }
-}
-// This is the main function. It sits between a story and the runtime, intercepting actions
-// as the story yields them. If an action matches one of the overrides (by type or wildcard "*"),
-// we run the override handler instead of letting the runtime process it. If the action doesn't
-// match any override, we yield it up to the parent (the runtime) and let it handle things normally.
-//
-// The tricky part is batches. When stories run things in parallel (askRunParallel), the actions
-// get bundled into a single batch action. We need to crack open the batch, check each action
-// inside for overrides, handle those ourselves, and then send the remaining non-overridden
-// actions back out as a smaller batch for the runtime to process. We also need to handle
-// batches-inside-batches by recursing, so overrides work no matter how deeply nested things are.
-function* askOverrideActions(storyIterator, overrides) {
-    // Kick off the story by calling .next() to get the first yielded action
-    let nextResult = storyIterator.next();
-    // Keep looping as long as the story has more actions to yield.
-    // When the story is done (returns a value instead of yielding), nextResult.done will be true.
-    while (!nextResult.done) {
-        // This is the action the story just yielded - it wants someone to process it
-        const action = nextResult.value;
-        // Check if we have an override for this specific action type, or a "*" wildcard catch-all.
-        // The specific type takes priority over the wildcard because we check it first.
-        const handler = getOwnOverrideHandler(overrides, action.type) || (action.type !== actions_1.SystemActionType.Batch ? getOwnOverrideHandler(overrides, '*') : undefined);
-        if (handler) {
-            // We have an override! Run the user's handler instead of letting the runtime process it.
-            // The handler is itself a story (generator), so we yield* into it to run it.
-            //
-            // We feed the handler's return value to the story VERBATIM — we never reshape it. That is what
-            // lets a handler relay an action with a bare `return yield action`: the value it gets back from
-            // the parent (raw, or an EitherActionResult when the action carries returnErrors, e.g. under
-            // askCatch) is already exactly what the story expects. A handler that instead returns its OWN
-            // computed value is responsible for shaping it (see getSuccessfulEitherActionResultIfRequired).
-            nextResult = storyIterator.next(yield* handler(action));
-            // Skip to the next iteration of the while loop to process the next yielded action
-            continue;
-        }
-        // If we get here, the action wasn't directly overridden.
-        // But it might be a batch action (from askRunParallel / askBatch) that contains
-        // overridden actions inside it. We need to crack it open and check each one.
-        if (action.type === actions_1.SystemActionType.Batch) {
-            // Pull out the list of individual actions that are bundled inside this batch
-            const batchActionPayload = action.payload;
-            // Go through every action in the batch one by one using askMap.
-            // For each action, we figure out if we need to handle it ourselves (override or nested batch)
-            // or if we can leave it for the runtime to process in the remaining batch.
-            const batchActionsToRun = yield* (0, askMapParallel_1.askMapParallel)(batchActionPayload.actions, function* (batchAction) {
-                // Does this individual action have an override handler (specific type or wildcard)?
-                const isOverridden = !!(getOwnOverrideHandler(overrides, batchAction.type) || getOwnOverrideHandler(overrides, '*'));
-                // Is this individual action itself another batch? If so, it could contain overridden
-                // actions deeper inside, so we need to recurse into it even though we don't override
-                // the batch action itself.
-                const isBatch = batchAction.type === actions_1.SystemActionType.Batch;
-                // We need to recursively process this action if it's either:
-                // 1. Directly overridden (we have a handler for it)
-                // 2. A nested batch (it might contain overridden actions inside)
-                const needsRecursion = isOverridden || isBatch;
-                return {
-                    action: batchAction,
-                    // Track whether we already processed this action ourselves, so we know not to
-                    // send it to the runtime again later
-                    alreadyProcessed: needsRecursion,
-                    // If we need to process it, wrap the action in askProcessAction (which makes it look
-                    // like a story that yields one action) and run it through askOverrideActions recursively.
-                    // This handles both direct overrides and nested batches-within-batches.
-                    //
-                    // The recursion is wrapped in askCatch so a failing sub-action becomes a captured
-                    // failure for THIS slot instead of escaping bare and bypassing the enclosing batch's
-                    // returnErrors protection. All slot results are held as EitherActionResults; the
-                    // successful ones are unwrapped when the batch is reassembled below.
-                    //
-                    // If we don't need to process it, leave the result undefined for now - the runtime
-                    // will fill it in when we send the remaining batch.
-                    result: needsRecursion ? yield* (0, askCatch_1.askCatch)(askOverrideActions(askProcessAction(batchAction), overrides)) : undefined,
-                };
-            });
-            // Now split the batch actions into two groups:
-            // - alreadyProcessed: we handled these above (overridden or nested batches) and have results
-            // - remaining: these are normal actions we need to send to the runtime to process
-            const remainingBatchActionsToRun = batchActionsToRun.filter((ba) => !ba.alreadyProcessed);
-            // Send the remaining non-overridden actions to the runtime as a batch.
-            // We wrap this in askCatch so that if any action in the batch fails, we get the error
-            // back as a value instead of it throwing and killing everything.
-            const results = yield* (0, askCatch_1.askCatch)((0, actions_1.askBatch)(remainingBatchActionsToRun.map((ba) => ba.action)));
-            // If the batch succeeded, take each result from the runtime and attach it to the
-            // corresponding action object (wrapped so every slot holds an EitherActionResult),
-            // so we can reassemble the full results array later.
-            if (results.success) {
-                remainingBatchActionsToRun.forEach((ba, index) => {
-                    ba.result = (0, actionLogic_1.getSuccessfulEitherActionResult)(results.result[index]);
-                });
-            }
-            // One failure fails the whole batch, matching the runtime's batch semantics: a runtime
-            // batch failure wins, otherwise the first captured failure from an overridden slot.
-            const isFailedSlotResult = (slotResult) => slotResult !== undefined && !slotResult.success;
-            const failedResult = !results.success ? results : batchActionsToRun.map((ba) => ba.result).find(isFailedSlotResult);
-            // If any sub-action failed (in the runtime batch or in an overridden slot)
-            if (failedResult) {
-                // Check if the caller wants errors returned as values (askCatch set returnErrors: true)
-                if (!action.returnErrors) {
-                    // No askCatch protecting this, so throw the error up to crash the story
-                    return yield* (0, actions_1.askThrowError)(failedResult.error.errorType, failedResult.error.errorText, failedResult.error.errorStack);
-                }
-                else {
-                    // askCatch is protecting this, so pass the error back as a value
-                    nextResult = storyIterator.next(failedResult);
-                }
-            }
-            else {
-                // Everything succeeded! Reassemble the results in the original order, unwrapping each
-                // slot's EitherActionResult back to its raw value, then wrap the whole array for the
-                // caller if needed (same returnErrors logic as the single action case above).
-                const allResults = batchActionsToRun.map((ba) => { var _a; return (_a = ba.result) === null || _a === void 0 ? void 0 : _a.result; });
-                nextResult = storyIterator.next(getSuccessfulEitherActionResultIfRequired(allResults, action.returnErrors));
-            }
-            // Skip to the next iteration to process whatever the story yields next
-            continue;
-        }
-        // If we get here, this action is not overridden and not a batch.
-        // We have nothing special to do, so just yield it up to our parent (the runtime)
-        // and let it process the action normally.
-        const actionValue = yield action;
-        // Take whatever the runtime gave us back and pass it down to the story,
-        // so the story gets the result it was waiting for.
-        nextResult = storyIterator.next(actionValue);
-    }
-    // The story is done! nextResult.value is the final return value of the generator.
-    // Pass it through as our own return value.
-    return nextResult.value;
-}
-//# sourceMappingURL=askOverrideActions.js.map

package/lib/commonjs/stories/system/askOverrideActions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askOverrideActions.js","sourceRoot":"","sources":["../../../../src/stories/system/askOverrideActions.ts"],"names":[],"mappings":"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","sourcesContent":["import { askBatch, askThrowError, SystemActionType, SystemBatchActionPayload } from '../../actions';\nimport { getSuccessfulEitherActionResult } from '../../logic/actionLogic';\nimport { Action, AskResponse, AskResponseReturnType, EitherActionResult } from '../../types';\nimport { askMapParallel } from '../array/askMapParallel';\nimport { askCatch } from './askCatch';\n\n// A function that takes an action and returns a story (generator) that produces the override result.\n// This is what the user provides for each action type they want to intercept.\nexport type ActionOverrideHandler<TAction extends Action<any> = Action<any>, TResult = any> = (action: TAction) => AskResponse<TResult>;\n\n// A map of action type strings to their override handlers.\n// The key is the action type (e.g. \"MathActionType.RandomNumber\") or \"*\" for a wildcard catch-all.\n// The value is the handler function that will run instead of the normal action processor.\nexport type ActionOverrideMap = {\n  [actionType: string]: ActionOverrideHandler<any, any>;\n};\n\n// Looks up a handler as an OWN property of the override map. A plain-object map inherits from\n// Object.prototype, so an action type like \"toString\" or \"constructor\" would otherwise resolve\n// to an inherited function and get invoked as a handler.\nfunction getOwnOverrideHandler(overrides: ActionOverrideMap, actionType: string): ActionOverrideHandler | undefined {\n  return Object.prototype.hasOwnProperty.call(overrides, actionType) ? overrides[actionType] : undefined;\n}\n\n// A tiny helper story that just yields a single action and returns whatever the processor gives back.\n// We use this to wrap individual actions so we can pass them into askOverrideActions recursively.\n// For example, when we pull an action out of a batch, we wrap it in this so askOverrideActions\n// can intercept it as if it were a normal top-level action being yielded by a story.\nfunction* askProcessAction<R>(action: Action<any>): AskResponse<R> {\n  return (yield action) as R;\n}\n\n// Shapes a handler's OWN computed value into what the story expects.\n//\n// When an action has returnErrors set to true (because askCatch wrapped it), the story expects the\n// result wrapped in { success: true, result: value }. The runtime normally does this, but an override\n// bypasses the runtime — so a handler that returns a value it computed itself must shape it with this\n// helper (passing the action's returnErrors). If returnErrors is false/undefined it returns the value\n// unchanged.\n//\n// Handlers that simply RELAY the action with `return yield action` must NOT call this: the value they\n// get back from the parent is already in the right shape (raw, or an EitherActionResult when the\n// action carried returnErrors), and the engine forwards a handler's return value verbatim.\nexport function getSuccessfulEitherActionResultIfRequired<T, ReturnErrors extends boolean>(\n  value: T,\n  returnErrors?: ReturnErrors,\n): ReturnErrors extends true ? EitherActionResult<T> : T {\n  if (returnErrors) {\n    return getSuccessfulEitherActionResult(value) as ReturnErrors extends true ? EitherActionResult<T> : T;\n  } else {\n    // returnErrors is false, so just pass the raw value through unchanged\n    return value as ReturnErrors extends true ? EitherActionResult<T> : T;\n  }\n}\n\n// This is the main function. It sits between a story and the runtime, intercepting actions\n// as the story yields them. If an action matches one of the overrides (by type or wildcard \"*\"),\n// we run the override handler instead of letting the runtime process it. If the action doesn't\n// match any override, we yield it up to the parent (the runtime) and let it handle things normally.\n//\n// The tricky part is batches. When stories run things in parallel (askRunParallel), the actions\n// get bundled into a single batch action. We need to crack open the batch, check each action\n// inside for overrides, handle those ourselves, and then send the remaining non-overridden\n// actions back out as a smaller batch for the runtime to process. We also need to handle\n// batches-inside-batches by recursing, so overrides work no matter how deeply nested things are.\nexport function* askOverrideActions<T extends AskResponse<any>>(\n  storyIterator: T,\n  overrides: ActionOverrideMap,\n): AskResponse<AskResponseReturnType<T>> {\n  // Kick off the story by calling .next() to get the first yielded action\n  let nextResult = storyIterator.next();\n\n  // Keep looping as long as the story has more actions to yield.\n  // When the story is done (returns a value instead of yielding), nextResult.done will be true.\n  while (!nextResult.done) {\n    // This is the action the story just yielded - it wants someone to process it\n    const action = nextResult.value;\n\n    // Check if we have an override for this specific action type, or a \"*\" wildcard catch-all.\n    // The specific type takes priority over the wildcard because we check it first.\n    const handler =\n      getOwnOverrideHandler(overrides, action.type) || (action.type !== SystemActionType.Batch ? getOwnOverrideHandler(overrides, '*') : undefined);\n    if (handler) {\n      // We have an override! Run the user's handler instead of letting the runtime process it.\n      // The handler is itself a story (generator), so we yield* into it to run it.\n      //\n      // We feed the handler's return value to the story VERBATIM — we never reshape it. That is what\n      // lets a handler relay an action with a bare `return yield action`: the value it gets back from\n      // the parent (raw, or an EitherActionResult when the action carries returnErrors, e.g. under\n      // askCatch) is already exactly what the story expects. A handler that instead returns its OWN\n      // computed value is responsible for shaping it (see getSuccessfulEitherActionResultIfRequired).\n      nextResult = storyIterator.next(yield* handler(action));\n\n      // Skip to the next iteration of the while loop to process the next yielded action\n      continue;\n    }\n\n    // If we get here, the action wasn't directly overridden.\n    // But it might be a batch action (from askRunParallel / askBatch) that contains\n    // overridden actions inside it. We need to crack it open and check each one.\n    if (action.type === SystemActionType.Batch) {\n      // Pull out the list of individual actions that are bundled inside this batch\n      const batchActionPayload: SystemBatchActionPayload = action.payload;\n\n      // Go through every action in the batch one by one using askMap.\n      // For each action, we figure out if we need to handle it ourselves (override or nested batch)\n      // or if we can leave it for the runtime to process in the remaining batch.\n      const batchActionsToRun = yield* askMapParallel(batchActionPayload.actions, function* (batchAction) {\n        // Does this individual action have an override handler (specific type or wildcard)?\n        const isOverridden = !!(getOwnOverrideHandler(overrides, batchAction.type) || getOwnOverrideHandler(overrides, '*'));\n\n        // Is this individual action itself another batch? If so, it could contain overridden\n        // actions deeper inside, so we need to recurse into it even though we don't override\n        // the batch action itself.\n        const isBatch = batchAction.type === SystemActionType.Batch;\n\n        // We need to recursively process this action if it's either:\n        // 1. Directly overridden (we have a handler for it)\n        // 2. A nested batch (it might contain overridden actions inside)\n        const needsRecursion = isOverridden || isBatch;\n\n        return {\n          action: batchAction,\n          // Track whether we already processed this action ourselves, so we know not to\n          // send it to the runtime again later\n          alreadyProcessed: needsRecursion,\n          // If we need to process it, wrap the action in askProcessAction (which makes it look\n          // like a story that yields one action) and run it through askOverrideActions recursively.\n          // This handles both direct overrides and nested batches-within-batches.\n          //\n          // The recursion is wrapped in askCatch so a failing sub-action becomes a captured\n          // failure for THIS slot instead of escaping bare and bypassing the enclosing batch's\n          // returnErrors protection. All slot results are held as EitherActionResults; the\n          // successful ones are unwrapped when the batch is reassembled below.\n          //\n          // If we don't need to process it, leave the result undefined for now - the runtime\n          // will fill it in when we send the remaining batch.\n          result: needsRecursion ? yield* askCatch(askOverrideActions(askProcessAction(batchAction), overrides)) : undefined,\n        };\n      });\n\n      // Now split the batch actions into two groups:\n      // - alreadyProcessed: we handled these above (overridden or nested batches) and have results\n      // - remaining: these are normal actions we need to send to the runtime to process\n      const remainingBatchActionsToRun = batchActionsToRun.filter((ba) => !ba.alreadyProcessed);\n\n      // Send the remaining non-overridden actions to the runtime as a batch.\n      // We wrap this in askCatch so that if any action in the batch fails, we get the error\n      // back as a value instead of it throwing and killing everything.\n      const results = yield* askCatch(askBatch(remainingBatchActionsToRun.map((ba) => ba.action)));\n\n      // If the batch succeeded, take each result from the runtime and attach it to the\n      // corresponding action object (wrapped so every slot holds an EitherActionResult),\n      // so we can reassemble the full results array later.\n      if (results.success) {\n        remainingBatchActionsToRun.forEach((ba, index) => {\n          ba.result = getSuccessfulEitherActionResult(results.result[index]);\n        });\n      }\n\n      // One failure fails the whole batch, matching the runtime's batch semantics: a runtime\n      // batch failure wins, otherwise the first captured failure from an overridden slot.\n      const isFailedSlotResult = (slotResult: EitherActionResult<any> | undefined): slotResult is EitherActionResult<any> & { success: false } =>\n        slotResult !== undefined && !slotResult.success;\n      const failedResult = !results.success ? results : batchActionsToRun.map((ba) => ba.result).find(isFailedSlotResult);\n\n      // If any sub-action failed (in the runtime batch or in an overridden slot)\n      if (failedResult) {\n        // Check if the caller wants errors returned as values (askCatch set returnErrors: true)\n        if (!action.returnErrors) {\n          // No askCatch protecting this, so throw the error up to crash the story\n          return yield* askThrowError(failedResult.error.errorType, failedResult.error.errorText, failedResult.error.errorStack);\n        } else {\n          // askCatch is protecting this, so pass the error back as a value\n          nextResult = storyIterator.next(failedResult);\n        }\n      } else {\n        // Everything succeeded! Reassemble the results in the original order, unwrapping each\n        // slot's EitherActionResult back to its raw value, then wrap the whole array for the\n        // caller if needed (same returnErrors logic as the single action case above).\n        const allResults = batchActionsToRun.map((ba) => ba.result?.result);\n\n        nextResult = storyIterator.next(getSuccessfulEitherActionResultIfRequired(allResults, action.returnErrors));\n      }\n\n      // Skip to the next iteration to process whatever the story yields next\n      continue;\n    }\n\n    // If we get here, this action is not overridden and not a batch.\n    // We have nothing special to do, so just yield it up to our parent (the runtime)\n    // and let it process the action normally.\n    const actionValue = yield action;\n\n    // Take whatever the runtime gave us back and pass it down to the story,\n    // so the story gets the result it was waiting for.\n    nextResult = storyIterator.next(actionValue);\n  }\n\n  // The story is done! nextResult.value is the final return value of the generator.\n  // Pass it through as our own return value.\n  return nextResult.value;\n}\n"]}

package/lib/commonjs/testing/configTesting.d.ts

@@ -1,10 +0,0 @@
-import { QPQConfig, QPQConfigItem } from '../config';
-export interface TestQpqConfigAppOptions {
-    applicationName?: string;
-    moduleName?: string;
-    environment?: string;
-    configRoot?: string;
-    apiBuildPath?: string;
-    feature?: string;
-}
-export declare const buildTestQpqConfig: (settings?: QPQConfigItem[], appOptions?: TestQpqConfigAppOptions) => QPQConfig;

package/lib/commonjs/testing/configTesting.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildTestQpqConfig = void 0;
-const config_1 = require("../config");
-// Builds a QPQConfig from `settings`, prepending a default application module so context-
-// dependent selectors work. Any field of that module can be overridden via `appOptions`.
-const buildTestQpqConfig = (settings = [], appOptions = {}) => {
-    const { applicationName = 'test-app', moduleName = 'test-module', environment = 'development', configRoot = './', apiBuildPath = './build', feature, } = appOptions;
-    return [...(0, config_1.defineApplicationModule)(applicationName, moduleName, environment, configRoot, apiBuildPath, feature), ...settings];
-};
-exports.buildTestQpqConfig = buildTestQpqConfig;
-//# sourceMappingURL=configTesting.js.map

package/lib/commonjs/testing/configTesting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"configTesting.js","sourceRoot":"","sources":["../../../src/testing/configTesting.ts"],"names":[],"mappings":";;;AAAA,sCAAoD;AAwBpD,0FAA0F;AAC1F,yFAAyF;AAClF,MAAM,kBAAkB,GAAG,CAAC,WAA4B,EAAE,EAAE,aAAsC,EAAE,EAAa,EAAE;IACxH,MAAM,EACJ,eAAe,GAAG,UAAU,EAC5B,UAAU,GAAG,aAAa,EAC1B,WAAW,GAAG,aAAa,EAC3B,UAAU,GAAG,IAAI,EACjB,YAAY,GAAG,SAAS,EACxB,OAAO,GACR,GAAG,UAAU,CAAC;IAEf,OAAO,CAAC,GAAG,IAAA,gCAAuB,EAAC,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;AAChI,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B","sourcesContent":["import { defineApplicationModule } from '../config';\nimport { QPQConfig, QPQConfigItem } from '../config';\n\n// ─── Config testing helper ───────────────────────────────────────────────────\n//\n// Almost every qpqCoreUtils selector needs app context — an appName setting (for\n// application/environment/feature) and a moduleName setting (for the service) — before\n// it can flatten, filter by ownership, or build fully-qualified resource names. Repeating\n// that boilerplate in each test buries the setting under test, so `buildTestQpqConfig`\n// prepends a sensible default application module and lets the caller drop in just the\n// settings the assertion is about.\n//\n//   const config = buildTestQpqConfig([defineSecret('apiKey')]);\n//   const config = buildTestQpqConfig([...], { environment: 'production', feature: 'beta' });\n\nexport interface TestQpqConfigAppOptions {\n  applicationName?: string;\n  moduleName?: string;\n  environment?: string;\n  configRoot?: string;\n  apiBuildPath?: string;\n  feature?: string;\n}\n\n// Builds a QPQConfig from `settings`, prepending a default application module so context-\n// dependent selectors work. Any field of that module can be overridden via `appOptions`.\nexport const buildTestQpqConfig = (settings: QPQConfigItem[] = [], appOptions: TestQpqConfigAppOptions = {}): QPQConfig => {\n  const {\n    applicationName = 'test-app',\n    moduleName = 'test-module',\n    environment = 'development',\n    configRoot = './',\n    apiBuildPath = './build',\n    feature,\n  } = appOptions;\n\n  return [...defineApplicationModule(applicationName, moduleName, environment, configRoot, apiBuildPath, feature), ...settings];\n};\n"]}

package/lib/commonjs/testing/index.d.ts

@@ -1,4 +0,0 @@
-export * from './configTesting';
-export * from './requesterTesting';
-export * from './runtimeTesting';
-export * from './storyTesting';

package/lib/commonjs/testing/index.js

@@ -1,21 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __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("./configTesting"), exports);
-__exportStar(require("./requesterTesting"), exports);
-__exportStar(require("./runtimeTesting"), exports);
-__exportStar(require("./storyTesting"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,iDAA+B","sourcesContent":["export * from './configTesting';\nexport * from './requesterTesting';\nexport * from './runtimeTesting';\nexport * from './storyTesting';\n"]}

package/lib/commonjs/testing/requesterTesting.d.ts

@@ -1,6 +0,0 @@
-import { Action, AskResponse, AskResponseReturnType } from '../types';
-export interface CapturedRequester<T> {
-    readonly action: Action<any>;
-    readonly returned: T;
-}
-export declare function captureRequester<T extends AskResponse<any>>(requester: T, result?: unknown): CapturedRequester<AskResponseReturnType<T>>;

package/lib/commonjs/testing/requesterTesting.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.captureRequester = captureRequester;
-// Runs a single-action requester: pulls the one action it yields, answers with `result`,
-// and captures the value it returns. Throws if the requester yields nothing or yields
-// more than once — either means it is not a plain requester and wants a different helper.
-function captureRequester(requester, result) {
-    const first = requester.next();
-    if (first.done) {
-        throw new Error('Expected the requester to yield an action, but it returned immediately.');
-    }
-    const second = requester.next(result);
-    if (!second.done) {
-        throw new Error('Expected the requester to complete after a single action, but it yielded again.');
-    }
-    return { action: first.value, returned: second.value };
-}
-//# sourceMappingURL=requesterTesting.js.map

package/lib/commonjs/testing/requesterTesting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"requesterTesting.js","sourceRoot":"","sources":["../../../src/testing/requesterTesting.ts"],"names":[],"mappings":";;AAuBA,4CAYC;AAfD,yFAAyF;AACzF,sFAAsF;AACtF,0FAA0F;AAC1F,SAAgB,gBAAgB,CAA6B,SAAY,EAAE,MAAgB;IACzF,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,KAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAiC,EAAE,CAAC;AACpG,CAAC","sourcesContent":["import { Action, AskResponse, AskResponseReturnType } from '../types';\n\n// ─── Requester testing helper ───────────────────────────────────────────────────\n//\n// Action requesters are the simplest stories: they `yield` exactly one action and\n// `return` whatever the runtime answers with. Testing one means checking two things —\n// the shape of the action it yields, and that the runtime's response passes straight\n// through. `captureRequester` drives that single round-trip and hands both back.\n//\n//   const { action, returned } = captureRequester(askConfigGetParameter('name'), 'value');\n//   expect(action).toEqual({ type: ConfigActionType.GetParameter, payload: { parameterName: 'name' } });\n//   expect(returned).toBe('value');\n\nexport interface CapturedRequester<T> {\n  // The action the requester yielded.\n  readonly action: Action<any>;\n  // The value the requester returned after the runtime answered with `result`.\n  readonly returned: T;\n}\n\n// Runs a single-action requester: pulls the one action it yields, answers with `result`,\n// and captures the value it returns. Throws if the requester yields nothing or yields\n// more than once — either means it is not a plain requester and wants a different helper.\nexport function captureRequester<T extends AskResponse<any>>(requester: T, result?: unknown): CapturedRequester<AskResponseReturnType<T>> {\n  const first = requester.next();\n  if (first.done) {\n    throw new Error('Expected the requester to yield an action, but it returned immediately.');\n  }\n\n  const second = requester.next(result);\n  if (!second.done) {\n    throw new Error('Expected the requester to complete after a single action, but it yielded again.');\n  }\n\n  return { action: first.value as Action<any>, returned: second.value as AskResponseReturnType<T> };\n}\n"]}

package/lib/commonjs/testing/runtimeTesting.d.ts

@@ -1,11 +0,0 @@
-import { ActionProcessor, ActionProcessorList, ActionProcessorListResolver } from '../types/Action';
-import { QpqLogger } from '../types/QpqLogger';
-import { StorySession } from '../types/StorySession';
-export declare const TEST_TIME_NOW = "2024-01-01T00:00:00.000Z";
-export declare const getTestTimeNow: () => string;
-export declare const testRandomGuid: () => string;
-export declare const noopDynamicModuleLoader: () => Promise<null>;
-export declare const buildTestStorySession: (overrides?: Partial<StorySession>) => StorySession;
-export declare const createStubLogger: (log?: QpqLogger["log"]) => QpqLogger;
-export declare const buildActionProcessorList: (processors: Record<string, ActionProcessor<any, any>>) => ActionProcessorList;
-export declare const buildActionProcessorResolver: (processors: Record<string, ActionProcessor<any, any>>) => ActionProcessorListResolver;

package/lib/commonjs/testing/runtimeTesting.js

@@ -1,59 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildActionProcessorResolver = exports.buildActionProcessorList = exports.createStubLogger = exports.buildTestStorySession = exports.noopDynamicModuleLoader = exports.testRandomGuid = exports.getTestTimeNow = exports.TEST_TIME_NOW = void 0;
-// ─── Runtime testing toolkit ───────────────────────────────────────────────────
-//
-// The story-execution engine (processAction → resolveStory → resolveStoryWithLogs →
-// createRuntime) needs a fistful of collaborators before it will run: a logger, a caller
-// session, a clock, a guid source, a module loader, and a map of action processors. None
-// of them are interesting to any single test, so they are gathered here as tiny, explicit
-// fixtures. Tests then read as "here is the one processor I care about" plus an invoke.
-//
-//   const logger = createStubLogger(vi.fn());
-//   const result = await resolveStory(story, [], buildTestQpqConfig(), buildTestStorySession(),
-//     buildActionProcessorResolver({ [MyType]: async () => actionResult('ok') }),
-//     getTestTimeNow, logger, 'corr-1', QpqRuntimeType.UNIT_TEST, noopDynamicModuleLoader);
-// A fixed clock. resolveStory stamps startedAt/finishedAt/history with getTimeNow(), so a
-// constant makes those fields deterministic and assertable.
-exports.TEST_TIME_NOW = '2024-01-01T00:00:00.000Z';
-const getTestTimeNow = () => exports.TEST_TIME_NOW;
-exports.getTestTimeNow = getTestTimeNow;
-// A deterministic guid source for correlation building (`moduleName::guid`).
-const testRandomGuid = () => 'guid-0';
-exports.testRandomGuid = testRandomGuid;
-// A dynamic module loader that never resolves a module — enough for stories that do not
-// dynamically load anything.
-const noopDynamicModuleLoader = () => __awaiter(void 0, void 0, void 0, function* () { return null; });
-exports.noopDynamicModuleLoader = noopDynamicModuleLoader;
-// The base caller session every runtime needs. resolveStory derives the story session from
-// it (depth + 1, inherited context/correlation), so overriding `depth` here drives the
-// depth-limit branch.
-const buildTestStorySession = (overrides = {}) => (Object.assign({ correlation: 'corr-0', depth: 0, context: {} }, overrides));
-exports.buildTestStorySession = buildTestStorySession;
-// A QpqLogger whose async lifecycle hooks are no-ops. `log` is injectable so a test can
-// pass a spy (e.g. `vi.fn()`) and assert resolveStoryWithLogs called it with the result.
-const createStubLogger = (log = () => { }) => ({
-    enableLogs: () => __awaiter(void 0, void 0, void 0, function* () { }),
-    log,
-    waitToFinishWriting: () => __awaiter(void 0, void 0, void 0, function* () { }),
-    moveToPermanentStorage: () => __awaiter(void 0, void 0, void 0, function* () { }),
-});
-exports.createStubLogger = createStubLogger;
-// Builds an ActionProcessorList from a plain `actionType -> processor` map. Identity with a
-// type anchor, so call sites stay terse and well-typed.
-const buildActionProcessorList = (processors) => (Object.assign({}, processors));
-exports.buildActionProcessorList = buildActionProcessorList;
-// Wraps a processor map (or a plain map) in the resolver shape resolveStory/createRuntime
-// expect: an async function ignoring its (config, loader) args and returning the list.
-const buildActionProcessorResolver = (processors) => () => __awaiter(void 0, void 0, void 0, function* () { return (0, exports.buildActionProcessorList)(processors); });
-exports.buildActionProcessorResolver = buildActionProcessorResolver;
-//# sourceMappingURL=runtimeTesting.js.map

package/lib/commonjs/testing/runtimeTesting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtimeTesting.js","sourceRoot":"","sources":["../../../src/testing/runtimeTesting.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA,kFAAkF;AAClF,EAAE;AACF,oFAAoF;AACpF,yFAAyF;AACzF,yFAAyF;AACzF,0FAA0F;AAC1F,wFAAwF;AACxF,EAAE;AACF,8CAA8C;AAC9C,gGAAgG;AAChG,kFAAkF;AAClF,4FAA4F;AAE5F,0FAA0F;AAC1F,4DAA4D;AAC/C,QAAA,aAAa,GAAG,0BAA0B,CAAC;AACjD,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,qBAAa,CAAC;AAA7C,QAAA,cAAc,kBAA+B;AAE1D,6EAA6E;AACtE,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC;AAAxC,QAAA,cAAc,kBAA0B;AAErD,wFAAwF;AACxF,6BAA6B;AACtB,MAAM,uBAAuB,GAAG,GAAwB,EAAE,kDAAC,OAAA,IAAI,CAAA,GAAA,CAAC;AAA1D,QAAA,uBAAuB,2BAAmC;AAEvE,2FAA2F;AAC3F,uFAAuF;AACvF,sBAAsB;AACf,MAAM,qBAAqB,GAAG,CAAC,YAAmC,EAAE,EAAgB,EAAE,CAAC,iBAC5F,WAAW,EAAE,QAAQ,EACrB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,EAAE,IACR,SAAS,EACZ,CAAC;AALU,QAAA,qBAAqB,yBAK/B;AAEH,wFAAwF;AACxF,yFAAyF;AAClF,MAAM,gBAAgB,GAAG,CAAC,MAAwB,GAAG,EAAE,GAAE,CAAC,EAAa,EAAE,CAAC,CAAC;IAChF,UAAU,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;IAC1B,GAAG;IACH,mBAAmB,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;IACnC,sBAAsB,EAAE,GAAS,EAAE,kDAAE,CAAC,CAAA;CACvC,CAAC,CAAC;AALU,QAAA,gBAAgB,oBAK1B;AAEH,4FAA4F;AAC5F,wDAAwD;AACjD,MAAM,wBAAwB,GAAG,CAAC,UAAqD,EAAuB,EAAE,CAAC,mBACnH,UAAU,EACb,CAAC;AAFU,QAAA,wBAAwB,4BAElC;AAEH,0FAA0F;AAC1F,uFAAuF;AAChF,MAAM,4BAA4B,GACvC,CAAC,UAAqD,EAA+B,EAAE,CACvF,GAAS,EAAE,kDACT,OAAA,IAAA,gCAAwB,EAAC,UAAU,CAAC,CAAA,GAAA,CAAC;AAH5B,QAAA,4BAA4B,gCAGA","sourcesContent":["import { ActionProcessor, ActionProcessorList, ActionProcessorListResolver } from '../types/Action';\nimport { QpqLogger } from '../types/QpqLogger';\nimport { StorySession } from '../types/StorySession';\n\n// ─── Runtime testing toolkit ───────────────────────────────────────────────────\n//\n// The story-execution engine (processAction → resolveStory → resolveStoryWithLogs →\n// createRuntime) needs a fistful of collaborators before it will run: a logger, a caller\n// session, a clock, a guid source, a module loader, and a map of action processors. None\n// of them are interesting to any single test, so they are gathered here as tiny, explicit\n// fixtures. Tests then read as \"here is the one processor I care about\" plus an invoke.\n//\n//   const logger = createStubLogger(vi.fn());\n//   const result = await resolveStory(story, [], buildTestQpqConfig(), buildTestStorySession(),\n//     buildActionProcessorResolver({ [MyType]: async () => actionResult('ok') }),\n//     getTestTimeNow, logger, 'corr-1', QpqRuntimeType.UNIT_TEST, noopDynamicModuleLoader);\n\n// A fixed clock. resolveStory stamps startedAt/finishedAt/history with getTimeNow(), so a\n// constant makes those fields deterministic and assertable.\nexport const TEST_TIME_NOW = '2024-01-01T00:00:00.000Z';\nexport const getTestTimeNow = (): string => TEST_TIME_NOW;\n\n// A deterministic guid source for correlation building (`moduleName::guid`).\nexport const testRandomGuid = (): string => 'guid-0';\n\n// A dynamic module loader that never resolves a module — enough for stories that do not\n// dynamically load anything.\nexport const noopDynamicModuleLoader = async (): Promise<null> => null;\n\n// The base caller session every runtime needs. resolveStory derives the story session from\n// it (depth + 1, inherited context/correlation), so overriding `depth` here drives the\n// depth-limit branch.\nexport const buildTestStorySession = (overrides: Partial<StorySession> = {}): StorySession => ({\n  correlation: 'corr-0',\n  depth: 0,\n  context: {},\n  ...overrides,\n});\n\n// A QpqLogger whose async lifecycle hooks are no-ops. `log` is injectable so a test can\n// pass a spy (e.g. `vi.fn()`) and assert resolveStoryWithLogs called it with the result.\nexport const createStubLogger = (log: QpqLogger['log'] = () => {}): QpqLogger => ({\n  enableLogs: async () => {},\n  log,\n  waitToFinishWriting: async () => {},\n  moveToPermanentStorage: async () => {},\n});\n\n// Builds an ActionProcessorList from a plain `actionType -> processor` map. Identity with a\n// type anchor, so call sites stay terse and well-typed.\nexport const buildActionProcessorList = (processors: Record<string, ActionProcessor<any, any>>): ActionProcessorList => ({\n  ...processors,\n});\n\n// Wraps a processor map (or a plain map) in the resolver shape resolveStory/createRuntime\n// expect: an async function ignoring its (config, loader) args and returning the list.\nexport const buildActionProcessorResolver =\n  (processors: Record<string, ActionProcessor<any, any>>): ActionProcessorListResolver =>\n  async () =>\n    buildActionProcessorList(processors);\n"]}