@qpqjs/core 0.3.0 → 0.5.0

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

@@ -1 +1 @@
-{"version":3,"file":"askCatch.js","sourceRoot":"","sources":["../../../../src/stories/system/askCatch.ts"],"names":[],"mappings":";;AAEA,4BA8CC;AAhDD,uCAAoG;AAEpG,QAAe,CAAC,CAAC,QAAQ,CACvB,aAAgB,EAChB,eAAkC;IAElC,IAAI,CAAC;QACH,IAAI,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QAEtC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACxB,2DAA2D;YAC3D,MAAM,SAAS,GAA4B,sCACtC,UAAU,CAAC,KAAK,KACnB,YAAY,EAAE,IAAI,GACnB,CAAC;YAEF,gEAAgE;YAChE,IAAI,SAAS,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAClE,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,+BAA+B;YAC/B,iEAAiE;YACjE,0DAA0D;YAC1D,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChG,CAAC;QAED,sDAAsD;QACtD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,UAAU,CAAC,KAAK;SACzB,CAAC;IACJ,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,yGAAyG;QACzG,MAAM,SAAS,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,SAAS,EAAE,qBAAa,CAAC,YAAY;gBACrC,SAAS,EAAE,+BAA+B,SAAS,GAAG;gBACtD,UAAU,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACrD;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,CAAC,CAAC,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { AskResponse, AskResponseReturnType, EitherActionResult, ErrorTypeEnum } from '../../types';\n\nexport function* askCatch<T extends AskResponse<any>>(\n  storyIterator: T,\n  finallyIterator?: AskResponse<any>,\n): AskResponse<EitherActionResult<AskResponseReturnType<T>>> {\n  try {\n    let nextResult = storyIterator.next();\n\n    while (!nextResult.done) {\n      // Add returnErrors to the action, so we can \"catch\" errors\n      const nextInput: EitherActionResult<any> = yield {\n        ...nextResult.value,\n        returnErrors: true,\n      };\n\n      // If there is an error, and no child askCatch, return the error\n      if (nextInput.success === false && !nextResult.value.returnErrors) {\n        return nextInput;\n      }\n\n      // Continue executing the story\n      // If there is a child askCatch, then pass down the either result\n      // otherwise just pass down the result as we would expect.\n      nextResult = storyIterator.next(nextResult.value.returnErrors ? nextInput : nextInput.result);\n    }\n\n    // Return the successful final result of the generator\n    return {\n      success: true,\n      result: nextResult.value,\n    };\n  } catch (e: unknown) {\n    // Same rule as the runtime: the thrown message is for the logs (errorStack), callers get a generic text.\n    const errorName = e instanceof Error && e.name ? ` [${e.name}]` : '';\n    return {\n      success: false,\n      error: {\n        errorType: ErrorTypeEnum.GenericError,\n        errorText: `An unexpected error occurred${errorName}.`,\n        errorStack: e instanceof Error ? e.stack : undefined,\n      },\n    };\n  } finally {\n    if (finallyIterator) {\n      yield* finallyIterator;\n    }\n  }\n}\n"]}
+{"version":3,"file":"askCatch.js","sourceRoot":"","sources":["../../../../src/stories/system/askCatch.ts"],"names":[],"mappings":";;AAEA,4BA6CC;AA/CD,uCAAoG;AAEpG,QAAe,CAAC,CAAC,QAAQ,CACvB,aAAgB,EAChB,eAAkC;IAElC,IAAI,CAAC;QACH,IAAI,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QAEtC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACxB,2DAA2D;YAC3D,MAAM,SAAS,GAA4B,sCACtC,UAAU,CAAC,KAAK,KACnB,YAAY,EAAE,IAAI,GACnB,CAAC;YAEF,gEAAgE;YAChE,IAAI,SAAS,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAClE,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,+BAA+B;YAC/B,iEAAiE;YACjE,0DAA0D;YAC1D,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChG,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,UAAU,CAAC,KAAK;SACzB,CAAC;IACJ,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,yGAAyG;QACzG,MAAM,SAAS,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,SAAS,EAAE,qBAAa,CAAC,YAAY;gBACrC,SAAS,EAAE,+BAA+B,SAAS,GAAG;gBACtD,UAAU,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACrD;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,CAAC,CAAC,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { AskResponse, AskResponseReturnType, EitherActionResult, ErrorTypeEnum } from '../../types';\n\nexport function* askCatch<T extends AskResponse<any>>(\n  storyIterator: T,\n  finallyIterator?: AskResponse<any>,\n): AskResponse<EitherActionResult<AskResponseReturnType<T>>> {\n  try {\n    let nextResult = storyIterator.next();\n\n    while (!nextResult.done) {\n      // Add returnErrors to the action, so we can \"catch\" errors\n      const nextInput: EitherActionResult<any> = yield {\n        ...nextResult.value,\n        returnErrors: true,\n      };\n\n      // If there is an error, and no child askCatch, return the error\n      if (nextInput.success === false && !nextResult.value.returnErrors) {\n        return nextInput;\n      }\n\n      // Continue executing the story\n      // If there is a child askCatch, then pass down the either result\n      // otherwise just pass down the result as we would expect.\n      nextResult = storyIterator.next(nextResult.value.returnErrors ? nextInput : nextInput.result);\n    }\n\n    return {\n      success: true,\n      result: nextResult.value,\n    };\n  } catch (e: unknown) {\n    // Same rule as the runtime: the thrown message is for the logs (errorStack), callers get a generic text.\n    const errorName = e instanceof Error && e.name ? ` [${e.name}]` : '';\n    return {\n      success: false,\n      error: {\n        errorType: ErrorTypeEnum.GenericError,\n        errorText: `An unexpected error occurred${errorName}.`,\n        errorStack: e instanceof Error ? e.stack : undefined,\n      },\n    };\n  } finally {\n    if (finallyIterator) {\n      yield* finallyIterator;\n    }\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"askExecuteIf.js","sourceRoot":"","sources":["../../../../src/stories/system/askExecuteIf.ts"],"names":[],"mappings":";;AAEA,oCASC;AATD,QAAe,CAAC,CAAC,YAAY,CAC3B,aAA0B,EAC1B,YAAqB,IAAI;IAEzB,IAAI,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { AskResponse, AskResponseReturnType, EitherActionResult, ErrorTypeEnum } from '../../types';\n\nexport function* askExecuteIf<T extends AskResponse<any>>(\n  storyIterator: T | boolean,\n  condition: boolean = true,\n): AskResponse<AskResponseReturnType<T> | undefined> {\n  if (condition && !!storyIterator && typeof storyIterator === 'object') {\n    return yield* storyIterator;\n  }\n\n  return undefined;\n}\n"]}
+{"version":3,"file":"askExecuteIf.js","sourceRoot":"","sources":["../../../../src/stories/system/askExecuteIf.ts"],"names":[],"mappings":";;AAEA,oCASC;AATD,QAAe,CAAC,CAAC,YAAY,CAC3B,aAA0B,EAC1B,YAAqB,IAAI;IAEzB,IAAI,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { AskResponse, AskResponseReturnType } from '../../types';\n\nexport function* askExecuteIf<T extends AskResponse<any>>(\n  storyIterator: T | boolean,\n  condition: boolean = true,\n): AskResponse<AskResponseReturnType<T> | undefined> {\n  if (condition && !!storyIterator && typeof storyIterator === 'object') {\n    return yield* storyIterator;\n  }\n\n  return undefined;\n}\n"]}

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

@@ -9,17 +9,14 @@ function* askRunParallel(storyRuntimes) {
         iteratorResult: input.next(),
     }));
     while (true) {
-        // Get all the stories that are not done
         const activeStoryProgress = storyProgress.filter((a) => !a.iteratorResult.done);
         if (activeStoryProgress.length === 0) {
             return storyProgress.map((a) => a.iteratorResult.value);
         }
-        // Get the active story actions and batch them for results
         const batchActions = activeStoryProgress.map((a) => a.iteratorResult.value);
         const actionResults = yield* (0, actions_1.askBatch)(batchActions);
         // continue each story with that new value
-        for (let i = 0; i < activeStoryProgress.length; i++) {
-            const storyIterator = activeStoryProgress[i];
+        for (const [i, storyIterator] of activeStoryProgress.entries()) {
             storyIterator.iteratorResult = storyIterator.iterator.next(actionResults[i]);
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"askRunParallel.js","sourceRoot":"","sources":["../../../../src/stories/system/askRunParallel.ts"],"names":[],"mappings":";;AAGA,wCA0BC;AA7BD,2CAAyC;AAGzC,QAAe,CAAC,CAAC,cAAc,CAC7B,aAAqB;IAErB,8BAA8B;IAC9B,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,QAAQ,EAAE,KAAK;QACf,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,EAAE,CAAC;QACZ,wCAAwC;QACxC,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAQ,CAAC;QACjE,CAAC;QAED,0DAA0D;QAC1D,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,IAAA,kBAAQ,EAAC,YAAY,CAAC,CAAC;QAEpD,0CAA0C;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAC7C,aAAa,CAAC,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { askBatch } from '../../actions';\nimport { AskResponse, AskResponseReturnType } from '../../types';\n\nexport function* askRunParallel<T extends Array<AskResponse<any>>>(\n  storyRuntimes: [...T],\n): AskResponse<{ [K in keyof T]: AskResponseReturnType<T[K]> }> {\n  // Begin executing the stories\n  const storyProgress = storyRuntimes.map((input) => ({\n    iterator: input,\n    iteratorResult: input.next(),\n  }));\n\n  while (true) {\n    // Get all the stories that are not done\n    const activeStoryProgress = storyProgress.filter((a) => !a.iteratorResult.done);\n    if (activeStoryProgress.length === 0) {\n      return storyProgress.map((a) => a.iteratorResult.value) as any;\n    }\n\n    // Get the active story actions and batch them for results\n    const batchActions = activeStoryProgress.map((a) => a.iteratorResult.value);\n    const actionResults = yield* askBatch(batchActions);\n\n    // continue each story with that new value\n    for (let i = 0; i < activeStoryProgress.length; i++) {\n      const storyIterator = activeStoryProgress[i];\n      storyIterator.iteratorResult = storyIterator.iterator.next(actionResults[i]);\n    }\n  }\n}\n"]}
+{"version":3,"file":"askRunParallel.js","sourceRoot":"","sources":["../../../../src/stories/system/askRunParallel.ts"],"names":[],"mappings":";;AAGA,wCAuBC;AA1BD,2CAAyC;AAGzC,QAAe,CAAC,CAAC,cAAc,CAC7B,aAAqB;IAErB,8BAA8B;IAC9B,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,QAAQ,EAAE,KAAK;QACf,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAQ,CAAC;QACjE,CAAC;QAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,IAAA,kBAAQ,EAAC,YAAY,CAAC,CAAC;QAEpD,0CAA0C;QAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,aAAa,CAAC,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { askBatch } from '../../actions';\nimport { AskResponse, AskResponseReturnType } from '../../types';\n\nexport function* askRunParallel<T extends Array<AskResponse<any>>>(\n  storyRuntimes: [...T],\n): AskResponse<{ [K in keyof T]: AskResponseReturnType<T[K]> }> {\n  // Begin executing the stories\n  const storyProgress = storyRuntimes.map((input) => ({\n    iterator: input,\n    iteratorResult: input.next(),\n  }));\n\n  while (true) {\n    const activeStoryProgress = storyProgress.filter((a) => !a.iteratorResult.done);\n    if (activeStoryProgress.length === 0) {\n      return storyProgress.map((a) => a.iteratorResult.value) as any;\n    }\n\n    const batchActions = activeStoryProgress.map((a) => a.iteratorResult.value);\n    const actionResults = yield* askBatch(batchActions);\n\n    // continue each story with that new value\n    for (const [i, storyIterator] of activeStoryProgress.entries()) {\n      storyIterator.iteratorResult = storyIterator.iterator.next(actionResults[i]);\n    }\n  }\n}\n"]}

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

@@ -1,4 +1,4 @@
 export * from './askCatch';
 export * from './askExecuteIf';
-export * from './askOverrideActions';
 export * from './askRunParallel';
+export * from './overrideActions';

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

@@ -16,6 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./askCatch"), exports);
 __exportStar(require("./askExecuteIf"), exports);
-__exportStar(require("./askOverrideActions"), exports);
 __exportStar(require("./askRunParallel"), exports);
+__exportStar(require("./overrideActions"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stories/system/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,iDAA+B;AAC/B,uDAAqC;AACrC,mDAAiC","sourcesContent":["export * from './askCatch';\nexport * from './askExecuteIf';\nexport * from './askOverrideActions';\nexport * from './askRunParallel';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stories/system/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,iDAA+B;AAC/B,mDAAiC;AACjC,oDAAkC","sourcesContent":["export * from './askCatch';\nexport * from './askExecuteIf';\nexport * from './askRunParallel';\nexport * from './overrideActions';\n"]}

package/lib/commonjs/stories/system/overrideActions/AskOverrideSlot.d.ts

@@ -0,0 +1,2 @@
+import { Action, AskResponse } from '../../../types';
+export type AskOverrideSlot = (batchAction: Action<any>) => AskResponse<unknown>;

package/lib/commonjs/stories/system/overrideActions/AskOverrideSlot.js

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

package/lib/commonjs/stories/system/overrideActions/AskOverrideSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskOverrideSlot.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/AskOverrideSlot.ts"],"names":[],"mappings":"","sourcesContent":["import { Action, AskResponse } from '../../../types';\n\n// How an overridden (or nested batch) slot is run. askOverrideActions passes itself in here, so the\n// batch splitting never has to import the loop it is part of.\nexport type AskOverrideSlot = (batchAction: Action<any>) => AskResponse<unknown>;\n"]}

package/lib/commonjs/stories/system/overrideActions/OverrideBatchSlot.d.ts

@@ -0,0 +1,7 @@
+import { Action, EitherActionResult } from '../../../types';
+/** One slot of a cracked-open batch: the action, whether it ran here already, and that run's outcome if so. */
+export type OverrideBatchSlot = {
+    action: Action<any>;
+    alreadyProcessed: boolean;
+    result: EitherActionResult<any> | undefined;
+};

package/lib/commonjs/stories/system/overrideActions/OverrideBatchSlot.js

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

package/lib/commonjs/stories/system/overrideActions/OverrideBatchSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverrideBatchSlot.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/OverrideBatchSlot.ts"],"names":[],"mappings":"","sourcesContent":["import { Action, EitherActionResult } from '../../../types';\n\n/** One slot of a cracked-open batch: the action, whether it ran here already, and that run's outcome if so. */\nexport type OverrideBatchSlot = {\n  action: Action<any>;\n  // Already processed here, so it must not be sent to the runtime again.\n  alreadyProcessed: boolean;\n  // Set once the slot has run, here or in the runtime batch; successful ones are unwrapped on reassembly.\n  result: EitherActionResult<any> | undefined;\n};\n"]}

package/lib/commonjs/stories/system/overrideActions/askOverrideActions.d.ts

@@ -0,0 +1,3 @@
+import { AskResponse, AskResponseReturnType } from '../../../types';
+import { ActionOverrideMap } from '../../../types/ActionOverrideMap';
+export declare function askOverrideActions<T extends AskResponse<any>>(storyIterator: T, overrides: ActionOverrideMap): AskResponse<AskResponseReturnType<T>>;

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askOverrideActions = askOverrideActions;
+const actions_1 = require("../../../actions");
+const askOverrideBatch_1 = require("./askOverrideBatch");
+const askProcessAction_1 = require("./askProcessAction");
+const getOwnOverrideHandler_1 = require("./getOwnOverrideHandler");
+// Sits between a story and the runtime, intercepting actions as the story yields them. An action
+// with an override (by type, or the "*" wildcard) runs the handler instead of the runtime; a batch
+// is cracked open by askOverrideBatch so overrides apply however deeply the batches nest; anything
+// else is yielded up to the parent untouched.
+function* askOverrideActions(storyIterator, overrides) {
+    let nextResult = storyIterator.next();
+    while (!nextResult.done) {
+        const action = nextResult.value;
+        // The specific type takes priority over the wildcard. A batch is never handed to the wildcard
+        // as a whole; its members are checked one by one instead.
+        const handler = (0, getOwnOverrideHandler_1.getOwnOverrideHandler)(overrides, action.type) || (action.type !== actions_1.SystemActionType.Batch ? (0, getOwnOverrideHandler_1.getOwnOverrideHandler)(overrides, '*') : undefined);
+        if (handler) {
+            // The handler's return value is fed to the story VERBATIM, never reshaped. That is what lets
+            // a handler relay an action with a bare `return yield action`: what it gets back from the
+            // parent (raw, or an EitherActionResult when the action carries returnErrors, e.g. under
+            // askCatch) is already what the story expects. A handler that returns its OWN computed value
+            // shapes it with getSuccessfulEitherActionResultIfRequired.
+            nextResult = storyIterator.next(yield* handler(action));
+            continue;
+        }
+        if (action.type === actions_1.SystemActionType.Batch) {
+            nextResult = storyIterator.next(yield* (0, askOverrideBatch_1.askOverrideBatch)(action, overrides, (batchAction) => askOverrideActions((0, askProcessAction_1.askProcessAction)(batchAction), overrides)));
+            continue;
+        }
+        nextResult = storyIterator.next(yield action);
+    }
+    return nextResult.value;
+}
+//# sourceMappingURL=askOverrideActions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"askOverrideActions.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/askOverrideActions.ts"],"names":[],"mappings":";;AAWA,gDAmCC;AA9CD,8CAAoD;AAGpD,yDAAsD;AACtD,yDAAsD;AACtD,mEAAgE;AAEhE,iGAAiG;AACjG,mGAAmG;AACnG,mGAAmG;AACnG,8CAA8C;AAC9C,QAAe,CAAC,CAAC,kBAAkB,CACjC,aAAgB,EAChB,SAA4B;IAE5B,IAAI,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IAEtC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAEhC,8FAA8F;QAC9F,0DAA0D;QAC1D,MAAM,OAAO,GACX,IAAA,6CAAqB,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,0BAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,6CAAqB,EAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEhJ,IAAI,OAAO,EAAE,CAAC;YACZ,6FAA6F;YAC7F,0FAA0F;YAC1F,yFAAyF;YACzF,6FAA6F;YAC7F,4DAA4D;YAC5D,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,0BAAgB,CAAC,KAAK,EAAE,CAAC;YAC3C,UAAU,GAAG,aAAa,CAAC,IAAI,CAC7B,KAAK,CAAC,CAAC,IAAA,mCAAgB,EAAC,MAAM,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAA,mCAAgB,EAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC,CAC1H,CAAC;YACF,SAAS;QACX,CAAC;QAED,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC;AAC1B,CAAC","sourcesContent":["import { SystemActionType } from '../../../actions';\nimport { AskResponse, AskResponseReturnType } from '../../../types';\nimport { ActionOverrideMap } from '../../../types/ActionOverrideMap';\nimport { askOverrideBatch } from './askOverrideBatch';\nimport { askProcessAction } from './askProcessAction';\nimport { getOwnOverrideHandler } from './getOwnOverrideHandler';\n\n// Sits between a story and the runtime, intercepting actions as the story yields them. An action\n// with an override (by type, or the \"*\" wildcard) runs the handler instead of the runtime; a batch\n// is cracked open by askOverrideBatch so overrides apply however deeply the batches nest; anything\n// else is yielded up to the parent untouched.\nexport function* askOverrideActions<T extends AskResponse<any>>(\n  storyIterator: T,\n  overrides: ActionOverrideMap,\n): AskResponse<AskResponseReturnType<T>> {\n  let nextResult = storyIterator.next();\n\n  while (!nextResult.done) {\n    const action = nextResult.value;\n\n    // The specific type takes priority over the wildcard. A batch is never handed to the wildcard\n    // as a whole; its members are checked one by one instead.\n    const handler =\n      getOwnOverrideHandler(overrides, action.type) || (action.type !== SystemActionType.Batch ? getOwnOverrideHandler(overrides, '*') : undefined);\n\n    if (handler) {\n      // The handler's return value is fed to the story VERBATIM, never reshaped. That is what lets\n      // a handler relay an action with a bare `return yield action`: what it gets back from the\n      // parent (raw, or an EitherActionResult when the action carries returnErrors, e.g. under\n      // askCatch) is already what the story expects. A handler that returns its OWN computed value\n      // shapes it with getSuccessfulEitherActionResultIfRequired.\n      nextResult = storyIterator.next(yield* handler(action));\n      continue;\n    }\n\n    if (action.type === SystemActionType.Batch) {\n      nextResult = storyIterator.next(\n        yield* askOverrideBatch(action, overrides, (batchAction) => askOverrideActions(askProcessAction(batchAction), overrides)),\n      );\n      continue;\n    }\n\n    nextResult = storyIterator.next(yield action);\n  }\n\n  return nextResult.value;\n}\n"]}

package/lib/commonjs/stories/system/overrideActions/askOverrideBatch.d.ts

@@ -0,0 +1,4 @@
+import { Action, AskResponse } from '../../../types';
+import { ActionOverrideMap } from '../../../types/ActionOverrideMap';
+import { AskOverrideSlot } from './AskOverrideSlot';
+export declare function askOverrideBatch(action: Action<any>, overrides: ActionOverrideMap, askOverrideSlot: AskOverrideSlot): AskResponse<unknown>;

package/lib/commonjs/stories/system/overrideActions/askOverrideBatch.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askOverrideBatch = askOverrideBatch;
+const actions_1 = require("../../../actions");
+const actionResult_1 = require("../../../logic/actionResult");
+const askMapParallel_1 = require("../../array/askMapParallel");
+const askCatch_1 = require("../askCatch");
+const askOverrideSlotRun_1 = require("./askOverrideSlotRun");
+const getSuccessfulEitherActionResultIfRequired_1 = require("./getSuccessfulEitherActionResultIfRequired");
+const isFailedSlotResult = (slotResult) => slotResult !== undefined && !slotResult.success;
+// When stories run things in parallel (askRunParallel), the actions get bundled into a single batch
+// action. This cracks the batch open, runs every overridden slot (and every nested batch, which may
+// hold overridden actions deeper inside) through `askOverrideSlot`, sends the rest to the runtime as
+// a smaller batch, and reassembles the results in the original order. Returns the value the story
+// should be resumed with; a failure throws unless the batch carries returnErrors, in which case the
+// failure comes back as the value, matching what the runtime would do.
+function* askOverrideBatch(action, overrides, askOverrideSlot) {
+    const batchActionPayload = action.payload;
+    const batchActionsToRun = yield* (0, askMapParallel_1.askMapParallel)(batchActionPayload.actions, function* (batchAction) {
+        return yield* (0, askOverrideSlotRun_1.askOverrideSlotRun)(batchAction, overrides, askOverrideSlot);
+    });
+    const remainingBatchActionsToRun = batchActionsToRun.filter((ba) => !ba.alreadyProcessed);
+    // askCatch so a failing runtime batch comes back as a value instead of killing everything.
+    const results = yield* (0, askCatch_1.askCatch)((0, actions_1.askBatch)(remainingBatchActionsToRun.map((ba) => ba.action)));
+    if (results.success) {
+        remainingBatchActionsToRun.forEach((ba, index) => {
+            ba.result = (0, actionResult_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 failedResult = !results.success ? results : batchActionsToRun.map((ba) => ba.result).find(isFailedSlotResult);
+    if (failedResult) {
+        if (!action.returnErrors) {
+            return yield* (0, actions_1.askThrowError)(failedResult.error.errorType, failedResult.error.errorText, failedResult.error.errorStack);
+        }
+        return failedResult;
+    }
+    const allResults = batchActionsToRun.map((ba) => { var _a; return (_a = ba.result) === null || _a === void 0 ? void 0 : _a.result; });
+    return (0, getSuccessfulEitherActionResultIfRequired_1.getSuccessfulEitherActionResultIfRequired)(allResults, action.returnErrors);
+}
+//# sourceMappingURL=askOverrideBatch.js.map

package/lib/commonjs/stories/system/overrideActions/askOverrideBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askOverrideBatch.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/askOverrideBatch.ts"],"names":[],"mappings":";;AAmBA,4CAiCC;AApDD,8CAAqF;AACrF,8DAA8E;AAG9E,+DAA4D;AAC5D,0CAAuC;AAEvC,6DAA0D;AAC1D,2GAAwG;AAExG,MAAM,kBAAkB,GAAG,CAAC,UAA+C,EAA8D,EAAE,CACzI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;AAElD,oGAAoG;AACpG,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,oGAAoG;AACpG,uEAAuE;AACvE,QAAe,CAAC,CAAC,gBAAgB,CAAC,MAAmB,EAAE,SAA4B,EAAE,eAAgC;IACnH,MAAM,kBAAkB,GAA6B,MAAM,CAAC,OAAO,CAAC;IAEpE,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,IAAA,+BAAc,EAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW;QAChG,OAAO,KAAK,CAAC,CAAC,IAAA,uCAAkB,EAAC,WAAW,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAE1F,2FAA2F;IAC3F,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAA,kBAAQ,EAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE7F,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YAC/C,EAAE,CAAC,MAAM,GAAG,IAAA,8CAA+B,EAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uFAAuF;IACvF,oFAAoF;IACpF,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAEpH,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,WAAC,OAAA,MAAA,EAAE,CAAC,MAAM,0CAAE,MAAM,CAAA,EAAA,CAAC,CAAC;IAEpE,OAAO,IAAA,qFAAyC,EAAC,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AACpF,CAAC","sourcesContent":["import { askBatch, askThrowError, SystemBatchActionPayload } from '../../../actions';\nimport { getSuccessfulEitherActionResult } from '../../../logic/actionResult';\nimport { Action, AskResponse, EitherActionResult } from '../../../types';\nimport { ActionOverrideMap } from '../../../types/ActionOverrideMap';\nimport { askMapParallel } from '../../array/askMapParallel';\nimport { askCatch } from '../askCatch';\nimport { AskOverrideSlot } from './AskOverrideSlot';\nimport { askOverrideSlotRun } from './askOverrideSlotRun';\nimport { getSuccessfulEitherActionResultIfRequired } from './getSuccessfulEitherActionResultIfRequired';\n\nconst isFailedSlotResult = (slotResult: EitherActionResult<any> | undefined): slotResult is EitherActionResult<any> & { success: false } =>\n  slotResult !== undefined && !slotResult.success;\n\n// When stories run things in parallel (askRunParallel), the actions get bundled into a single batch\n// action. This cracks the batch open, runs every overridden slot (and every nested batch, which may\n// hold overridden actions deeper inside) through `askOverrideSlot`, sends the rest to the runtime as\n// a smaller batch, and reassembles the results in the original order. Returns the value the story\n// should be resumed with; a failure throws unless the batch carries returnErrors, in which case the\n// failure comes back as the value, matching what the runtime would do.\nexport function* askOverrideBatch(action: Action<any>, overrides: ActionOverrideMap, askOverrideSlot: AskOverrideSlot): AskResponse<unknown> {\n  const batchActionPayload: SystemBatchActionPayload = action.payload;\n\n  const batchActionsToRun = yield* askMapParallel(batchActionPayload.actions, function* (batchAction) {\n    return yield* askOverrideSlotRun(batchAction, overrides, askOverrideSlot);\n  });\n\n  const remainingBatchActionsToRun = batchActionsToRun.filter((ba) => !ba.alreadyProcessed);\n\n  // askCatch so a failing runtime batch comes back as a value instead of killing everything.\n  const results = yield* askCatch(askBatch(remainingBatchActionsToRun.map((ba) => ba.action)));\n\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 failedResult = !results.success ? results : batchActionsToRun.map((ba) => ba.result).find(isFailedSlotResult);\n\n  if (failedResult) {\n    if (!action.returnErrors) {\n      return yield* askThrowError(failedResult.error.errorType, failedResult.error.errorText, failedResult.error.errorStack);\n    }\n\n    return failedResult;\n  }\n\n  const allResults = batchActionsToRun.map((ba) => ba.result?.result);\n\n  return getSuccessfulEitherActionResultIfRequired(allResults, action.returnErrors);\n}\n"]}

package/lib/commonjs/stories/system/overrideActions/askOverrideSlotRun.d.ts

@@ -0,0 +1,11 @@
+import { Action, AskResponse } from '../../../types';
+import { ActionOverrideMap } from '../../../types/ActionOverrideMap';
+import { AskOverrideSlot } from './AskOverrideSlot';
+import { OverrideBatchSlot } from './OverrideBatchSlot';
+/**
+ * Runs one batch slot here when an override claims it, or when it is itself a batch that may hold overridden
+ * actions deeper inside; any other slot is left for the runtime batch. The run 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.
+ */
+export declare function askOverrideSlotRun(batchAction: Action<any>, overrides: ActionOverrideMap, askOverrideSlot: AskOverrideSlot): AskResponse<OverrideBatchSlot>;

package/lib/commonjs/stories/system/overrideActions/askOverrideSlotRun.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askOverrideSlotRun = askOverrideSlotRun;
+const actions_1 = require("../../../actions");
+const askCatch_1 = require("../askCatch");
+const getOwnOverrideHandler_1 = require("./getOwnOverrideHandler");
+/**
+ * Runs one batch slot here when an override claims it, or when it is itself a batch that may hold overridden
+ * actions deeper inside; any other slot is left for the runtime batch. The run 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.
+ */
+function* askOverrideSlotRun(batchAction, overrides, askOverrideSlot) {
+    const isOverridden = !!((0, getOwnOverrideHandler_1.getOwnOverrideHandler)(overrides, batchAction.type) || (0, getOwnOverrideHandler_1.getOwnOverrideHandler)(overrides, '*'));
+    const isBatch = batchAction.type === actions_1.SystemActionType.Batch;
+    const needsRecursion = isOverridden || isBatch;
+    return {
+        action: batchAction,
+        alreadyProcessed: needsRecursion,
+        result: needsRecursion ? yield* (0, askCatch_1.askCatch)(askOverrideSlot(batchAction)) : undefined,
+    };
+}
+//# sourceMappingURL=askOverrideSlotRun.js.map

package/lib/commonjs/stories/system/overrideActions/askOverrideSlotRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askOverrideSlotRun.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/askOverrideSlotRun.ts"],"names":[],"mappings":";;AAcA,gDAcC;AA5BD,8CAAoD;AAGpD,0CAAuC;AAEvC,mEAAgE;AAGhE;;;;;GAKG;AACH,QAAe,CAAC,CAAC,kBAAkB,CACjC,WAAwB,EACxB,SAA4B,EAC5B,eAAgC;IAEhC,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,IAAA,6CAAqB,EAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,IAAA,6CAAqB,EAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACrH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,KAAK,0BAAgB,CAAC,KAAK,CAAC;IAC5D,MAAM,cAAc,GAAG,YAAY,IAAI,OAAO,CAAC;IAE/C,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,gBAAgB,EAAE,cAAc;QAChC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAA,mBAAQ,EAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KACnF,CAAC;AACJ,CAAC","sourcesContent":["import { SystemActionType } from '../../../actions';\nimport { Action, AskResponse } from '../../../types';\nimport { ActionOverrideMap } from '../../../types/ActionOverrideMap';\nimport { askCatch } from '../askCatch';\nimport { AskOverrideSlot } from './AskOverrideSlot';\nimport { getOwnOverrideHandler } from './getOwnOverrideHandler';\nimport { OverrideBatchSlot } from './OverrideBatchSlot';\n\n/**\n * Runs one batch slot here when an override claims it, or when it is itself a batch that may hold overridden\n * actions deeper inside; any other slot is left for the runtime batch. The run is wrapped in askCatch so a failing\n * sub-action becomes a captured failure for this slot instead of escaping bare and bypassing the enclosing batch's\n * returnErrors protection.\n */\nexport function* askOverrideSlotRun(\n  batchAction: Action<any>,\n  overrides: ActionOverrideMap,\n  askOverrideSlot: AskOverrideSlot,\n): AskResponse<OverrideBatchSlot> {\n  const isOverridden = !!(getOwnOverrideHandler(overrides, batchAction.type) || getOwnOverrideHandler(overrides, '*'));\n  const isBatch = batchAction.type === SystemActionType.Batch;\n  const needsRecursion = isOverridden || isBatch;\n\n  return {\n    action: batchAction,\n    alreadyProcessed: needsRecursion,\n    result: needsRecursion ? yield* askCatch(askOverrideSlot(batchAction)) : undefined,\n  };\n}\n"]}

package/lib/commonjs/stories/system/overrideActions/askProcessAction.d.ts

@@ -0,0 +1,2 @@
+import { Action, AskResponse } from '../../../types';
+export declare function askProcessAction<R>(action: Action<any>): AskResponse<R>;

package/lib/commonjs/stories/system/overrideActions/askProcessAction.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askProcessAction = askProcessAction;
+// 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);
+}
+//# sourceMappingURL=askProcessAction.js.map

package/lib/commonjs/stories/system/overrideActions/askProcessAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askProcessAction.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/askProcessAction.ts"],"names":[],"mappings":";;AAMA,4CAEC;AAND,sGAAsG;AACtG,kGAAkG;AAClG,+FAA+F;AAC/F,qFAAqF;AACrF,QAAe,CAAC,CAAC,gBAAgB,CAAI,MAAmB;IACtD,OAAO,CAAC,MAAM,MAAM,CAAM,CAAC;AAC7B,CAAC","sourcesContent":["import { Action, AskResponse } from '../../../types';\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.\nexport function* askProcessAction<R>(action: Action<any>): AskResponse<R> {\n  return (yield action) as R;\n}\n"]}

package/lib/commonjs/stories/system/overrideActions/getOwnOverrideHandler.d.ts

@@ -0,0 +1,3 @@
+import { ActionOverrideHandler } from '../../../types/ActionOverrideHandler';
+import { ActionOverrideMap } from '../../../types/ActionOverrideMap';
+export declare const getOwnOverrideHandler: (overrides: ActionOverrideMap, actionType: string) => ActionOverrideHandler | undefined;

package/lib/commonjs/stories/system/overrideActions/getOwnOverrideHandler.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOwnOverrideHandler = void 0;
+// 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.
+const getOwnOverrideHandler = (overrides, actionType) => Object.prototype.hasOwnProperty.call(overrides, actionType) ? overrides[actionType] : undefined;
+exports.getOwnOverrideHandler = getOwnOverrideHandler;
+//# sourceMappingURL=getOwnOverrideHandler.js.map

package/lib/commonjs/stories/system/overrideActions/getOwnOverrideHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnOverrideHandler.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/getOwnOverrideHandler.ts"],"names":[],"mappings":";;;AAGA,8FAA8F;AAC9F,+FAA+F;AAC/F,yDAAyD;AAClD,MAAM,qBAAqB,GAAG,CAAC,SAA4B,EAAE,UAAkB,EAAqC,EAAE,CAC3H,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AADrF,QAAA,qBAAqB,yBACgE","sourcesContent":["import { ActionOverrideHandler } from '../../../types/ActionOverrideHandler';\nimport { ActionOverrideMap } from '../../../types/ActionOverrideMap';\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.\nexport const getOwnOverrideHandler = (overrides: ActionOverrideMap, actionType: string): ActionOverrideHandler | undefined =>\n  Object.prototype.hasOwnProperty.call(overrides, actionType) ? overrides[actionType] : undefined;\n"]}

package/lib/commonjs/stories/system/overrideActions/getSuccessfulEitherActionResultIfRequired.d.ts

@@ -0,0 +1,2 @@
+import { EitherActionResult } from '../../../types';
+export declare function getSuccessfulEitherActionResultIfRequired<T, ReturnErrors extends boolean>(value: T, returnErrors?: ReturnErrors): ReturnErrors extends true ? EitherActionResult<T> : T;

package/lib/commonjs/stories/system/overrideActions/getSuccessfulEitherActionResultIfRequired.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSuccessfulEitherActionResultIfRequired = getSuccessfulEitherActionResultIfRequired;
+const actionResult_1 = require("../../../logic/actionResult");
+// 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, actionResult_1.getSuccessfulEitherActionResult)(value);
+    }
+    else {
+        // returnErrors is false, so just pass the raw value through unchanged
+        return value;
+    }
+}
+//# sourceMappingURL=getSuccessfulEitherActionResultIfRequired.js.map

package/lib/commonjs/stories/system/overrideActions/getSuccessfulEitherActionResultIfRequired.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSuccessfulEitherActionResultIfRequired.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/getSuccessfulEitherActionResultIfRequired.ts"],"names":[],"mappings":";;AAcA,8FAUC;AAxBD,8DAA8E;AAG9E,qEAAqE;AACrE,EAAE;AACF,mGAAmG;AACnG,sGAAsG;AACtG,qGAAqG;AACrG,sGAAsG;AACtG,aAAa;AACb,EAAE;AACF,sGAAsG;AACtG,iGAAiG;AACjG,2FAA2F;AAC3F,SAAgB,yCAAyC,CACvD,KAAQ,EACR,YAA2B;IAE3B,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAA,8CAA+B,EAAC,KAAK,CAA0D,CAAC;IACzG,CAAC;SAAM,CAAC;QACN,sEAAsE;QACtE,OAAO,KAA8D,CAAC;IACxE,CAAC;AACH,CAAC","sourcesContent":["import { getSuccessfulEitherActionResult } from '../../../logic/actionResult';\nimport { EitherActionResult } from '../../../types';\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"]}

package/lib/commonjs/stories/system/overrideActions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './askOverrideActions';
+export * from './askOverrideBatch';
+export * from './AskOverrideSlot';
+export * from './getSuccessfulEitherActionResultIfRequired';

package/lib/commonjs/stories/system/overrideActions/index.js

@@ -0,0 +1,21 @@
+"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("./askOverrideActions"), exports);
+__exportStar(require("./askOverrideBatch"), exports);
+__exportStar(require("./AskOverrideSlot"), exports);
+__exportStar(require("./getSuccessfulEitherActionResultIfRequired"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/stories/system/overrideActions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/stories/system/overrideActions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,qDAAmC;AACnC,oDAAkC;AAClC,8EAA4D","sourcesContent":["export * from './askOverrideActions';\nexport * from './askOverrideBatch';\nexport * from './AskOverrideSlot';\nexport * from './getSuccessfulEitherActionResultIfRequired';\n"]}

package/lib/commonjs/types/Action.d.ts

@@ -3,15 +3,15 @@ import { DynamicModuleLoader } from './DynamicModuleLoader';
 import { QPQError } from './ErrorTypeEnum';
 import { QpqContext } from './QpqContextIdentifier';
 import { QpqLogger } from './QpqLogger';
-import { ExtractGeneratorReturnType, StorySession, StorySessionUpdater } from './StorySession';
+import { StorySession, StorySessionUpdater } from './StorySession';
 import { StreamRegistry } from './StreamRegistry';
-export interface Action<T> {
+export type Action<T> = {
     type: string;
     payload?: T;
     returnErrors?: boolean;
     context?: QpqContext<any>;
     localContext?: QpqContext<any>;
-}
+};
 export type ActionProcessorResult<T> = [T?, QPQError?];
 export type AsyncActionProcessorResult<T> = Promise<ActionProcessorResult<T>>;
 export type EitherActionResult<T> = {
@@ -25,7 +25,6 @@ export type EitherActionResult<T> = {
 };
 export type ActionProcessor<TAction extends Action<any>, TReturn = any> = (payload: TAction['payload'], session: StorySession, actionProcessors: ActionProcessorList, logger: QpqLogger, updateSession: StorySessionUpdater, dynamicModuleLoader: DynamicModuleLoader, streamRegistry: StreamRegistry) => AsyncActionProcessorResult<TReturn>;
 export type ActionRequester<TAction extends Action<any>, TReturn = undefined, TQPQReturn = TReturn> = Generator<TAction, TReturn, TQPQReturn>;
-export type ActionProcessorReturnType<T extends Generator<any, any, any>> = ExtractGeneratorReturnType<T>;
 export type ActionProcessorList = {
     [key: string]: ActionProcessor<any, any>;
 };

package/lib/commonjs/types/Action.js.map

@@ -1 +1 @@
-{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../../src/types/Action.ts"],"names":[],"mappings":"","sourcesContent":["import { QPQConfig } from '../config';\nimport { DynamicModuleLoader } from './DynamicModuleLoader';\nimport { QPQError } from './ErrorTypeEnum';\nimport { QpqContext } from './QpqContextIdentifier';\nimport { QpqLogger } from './QpqLogger';\nimport { ExtractGeneratorReturnType, StoryResult, StorySession, StorySessionUpdater } from './StorySession';\nimport { StreamRegistry } from './StreamRegistry';\n\n// Action ~ Think redux action\n// They must have a type, and an optional payload\nexport interface Action<T> {\n  type: string;\n  payload?: T;\n\n  returnErrors?: boolean;\n  context?: QpqContext<any>;\n  localContext?: QpqContext<any>;\n}\n\n// Result tuple ~ Either result or error\nexport type ActionProcessorResult<T> = [T?, QPQError?];\n\nexport type AsyncActionProcessorResult<T> = Promise<ActionProcessorResult<T>>;\n\n// Action result ~ Either result or error\nexport type EitherActionResult<T> =\n  | {\n      success: true;\n      result: T;\n      error?: never;\n    }\n  | {\n      success: false;\n      result?: never;\n      error: QPQError;\n    };\n\n// A function type ~ Processes an action and returns an ActionProcessorResult\nexport type ActionProcessor<TAction extends Action<any>, TReturn = any> = (\n  payload: TAction['payload'],\n  session: StorySession,\n  actionProcessors: ActionProcessorList,\n  logger: QpqLogger,\n  updateSession: StorySessionUpdater,\n  dynamicModuleLoader: DynamicModuleLoader,\n  streamRegistry: StreamRegistry,\n) => AsyncActionProcessorResult<TReturn>;\n\n// Generator<\n//  Thing you are giving to QPQ,\n//  Thing the function returns to the regular logic,\n//  the thing QPQ gives us\n// >\nexport type ActionRequester<TAction extends Action<any>, TReturn = undefined, TQPQReturn = TReturn> = Generator<TAction, TReturn, TQPQReturn>;\n\nexport type ActionProcessorReturnType<T extends Generator<any, any, any>> = ExtractGeneratorReturnType<T>;\n\nexport type ActionProcessorList = {\n  [key: string]: ActionProcessor<any, any>;\n};\n\nexport type ActionProcessorListResolver = (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader) => Promise<ActionProcessorList>;\n\nexport type AnyStory<TArgs extends Array<any> = Array<any>> = (...args: TArgs) => ActionRequester<Action<any>, any, any>;\n"]}
+{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../../src/types/Action.ts"],"names":[],"mappings":"","sourcesContent":["import { QPQConfig } from '../config';\nimport { DynamicModuleLoader } from './DynamicModuleLoader';\nimport { QPQError } from './ErrorTypeEnum';\nimport { QpqContext } from './QpqContextIdentifier';\nimport { QpqLogger } from './QpqLogger';\nimport { StorySession, StorySessionUpdater } from './StorySession';\nimport { StreamRegistry } from './StreamRegistry';\n\n// Action ~ Think redux action\n// They must have a type, and an optional payload\nexport type Action<T> = {\n  type: string;\n  payload?: T;\n\n  returnErrors?: boolean;\n  context?: QpqContext<any>;\n  localContext?: QpqContext<any>;\n};\n\n// Result tuple ~ Either result or error\nexport type ActionProcessorResult<T> = [T?, QPQError?];\n\nexport type AsyncActionProcessorResult<T> = Promise<ActionProcessorResult<T>>;\n\n// Action result ~ Either result or error\nexport type EitherActionResult<T> =\n  | {\n      success: true;\n      result: T;\n      error?: never;\n    }\n  | {\n      success: false;\n      result?: never;\n      error: QPQError;\n    };\n\n// A function type ~ Processes an action and returns an ActionProcessorResult\nexport type ActionProcessor<TAction extends Action<any>, TReturn = any> = (\n  payload: TAction['payload'],\n  session: StorySession,\n  actionProcessors: ActionProcessorList,\n  logger: QpqLogger,\n  updateSession: StorySessionUpdater,\n  dynamicModuleLoader: DynamicModuleLoader,\n  streamRegistry: StreamRegistry,\n) => AsyncActionProcessorResult<TReturn>;\n\n// Generator<\n//  Thing you are giving to QPQ,\n//  Thing the function returns to the regular logic,\n//  the thing QPQ gives us\n// >\nexport type ActionRequester<TAction extends Action<any>, TReturn = undefined, TQPQReturn = TReturn> = Generator<TAction, TReturn, TQPQReturn>;\n\nexport type ActionProcessorList = {\n  [key: string]: ActionProcessor<any, any>;\n};\n\nexport type ActionProcessorListResolver = (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader) => Promise<ActionProcessorList>;\n\nexport type AnyStory<TArgs extends Array<any> = Array<any>> = (...args: TArgs) => ActionRequester<Action<any>, any, any>;\n"]}

package/lib/commonjs/types/ActionOverrideHandler.d.ts

@@ -0,0 +1,3 @@
+import { Action } from './Action';
+import { AskResponse } from './StorySession';
+export type ActionOverrideHandler<TAction extends Action<any> = Action<any>, TResult = any> = (action: TAction) => AskResponse<TResult>;

package/lib/commonjs/types/ActionOverrideHandler.js

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

package/lib/commonjs/types/ActionOverrideHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionOverrideHandler.js","sourceRoot":"","sources":["../../../src/types/ActionOverrideHandler.ts"],"names":[],"mappings":"","sourcesContent":["import { Action } from './Action';\nimport { AskResponse } from './StorySession';\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"]}

package/lib/commonjs/types/ActionOverrideMap.d.ts

@@ -0,0 +1,4 @@
+import { ActionOverrideHandler } from './ActionOverrideHandler';
+export type ActionOverrideMap = {
+    [actionType: string]: ActionOverrideHandler<any, any>;
+};

package/lib/commonjs/types/ActionOverrideMap.js

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

package/lib/commonjs/types/ActionOverrideMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionOverrideMap.js","sourceRoot":"","sources":["../../../src/types/ActionOverrideMap.ts"],"names":[],"mappings":"","sourcesContent":["import { ActionOverrideHandler } from './ActionOverrideHandler';\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"]}

package/lib/commonjs/types/CrossModuleMessage.d.ts

@@ -1,4 +1,4 @@
-export interface CrossModuleMessage<T> {
+export type CrossModuleMessage<T> = {
     type: string;
     payload: T;
-}
+};

package/lib/commonjs/types/CrossModuleMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"CrossModuleMessage.js","sourceRoot":"","sources":["../../../src/types/CrossModuleMessage.ts"],"names":[],"mappings":"","sourcesContent":["export interface CrossModuleMessage<T> {\n  type: string;\n  payload: T;\n}\n"]}
+{"version":3,"file":"CrossModuleMessage.js","sourceRoot":"","sources":["../../../src/types/CrossModuleMessage.ts"],"names":[],"mappings":"","sourcesContent":["export type CrossModuleMessage<T> = {\n  type: string;\n  payload: T;\n};\n"]}

package/lib/commonjs/types/ErrorTypeEnum.d.ts

@@ -3,7 +3,7 @@ export declare enum ErrorTypeEnum {
     PaymentRequired = "PaymentRequired",
     Forbidden = "Forbidden",
     NotFound = "NotFound",
-    TimeOut = "TimeOut",
+    Timeout = "Timeout",
     UnsupportedMediaType = "UnsupportedMediaType",
     OutOfResources = "OutOfResources",
     GenericError = "GenericError",
@@ -13,8 +13,8 @@ export declare enum ErrorTypeEnum {
     Invalid = "Invalid",
     Conflict = "Conflict"
 }
-export interface QPQError {
+export type QPQError = {
     errorType: ErrorTypeEnum | string;
     errorText: string;
     errorStack?: string;
-}
+};

package/lib/commonjs/types/ErrorTypeEnum.js

@@ -15,7 +15,7 @@ var ErrorTypeEnum;
     // The requested resource was not found on the server
     ErrorTypeEnum["NotFound"] = "NotFound";
     // The server timed out while waiting for a response from a resource
-    ErrorTypeEnum["TimeOut"] = "TimeOut";
+    ErrorTypeEnum["Timeout"] = "Timeout";
     // The request included an unsupported media type or format
     ErrorTypeEnum["UnsupportedMediaType"] = "UnsupportedMediaType";
     // The system or downstream resource is out of resources

package/lib/commonjs/types/ErrorTypeEnum.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorTypeEnum.js","sourceRoot":"","sources":["../../../src/types/ErrorTypeEnum.ts"],"names":[],"mappings":";;;AAAA,oDAAoD;AACpD,EAAE;AACF,IAAY,aAyCX;AAzCD,WAAY,aAAa;IACvB,gFAAgF;IAChF,oDAAoD;IACpD,8CAA6B,CAAA;IAE7B,mEAAmE;IACnE,oDAAmC,CAAA;IAEnC,mEAAmE;IACnE,wCAAuB,CAAA;IAEvB,qDAAqD;IACrD,sCAAqB,CAAA;IAErB,oEAAoE;IACpE,oCAAmB,CAAA;IAEnB,2DAA2D;IAC3D,8DAA6C,CAAA;IAE7C,wDAAwD;IACxD,kDAAiC,CAAA;IAEjC,2EAA2E;IAC3E,oDAAoD;IACpD,8CAA6B,CAAA;IAE7B,gEAAgE;IAChE,kDAAiC,CAAA;IAEjC,+EAA+E;IAC/E,wCAAuB,CAAA;IAEvB,kDAAkD;IAClD,0CAAyB,CAAA;IAEzB,8DAA8D;IAC9D,oCAAmB,CAAA;IAEnB,uGAAuG;IACvG,sCAAqB,CAAA;AACvB,CAAC,EAzCW,aAAa,6BAAb,aAAa,QAyCxB","sourcesContent":["// Note: Error enum text may be surfaced to the user\n//\nexport enum ErrorTypeEnum {\n  // User failed to provide valid credentials required for accessing this resource\n  // ~ typically occurs when user is not authenticated\n  Unauthorized = 'Unauthorized',\n\n  // Payment is required to access this resource or perform an action\n  PaymentRequired = 'PaymentRequired',\n\n  // User does not have sufficient privileges to access this resource\n  Forbidden = 'Forbidden',\n\n  // The requested resource was not found on the server\n  NotFound = 'NotFound',\n\n  // The server timed out while waiting for a response from a resource\n  TimeOut = 'TimeOut',\n\n  // The request included an unsupported media type or format\n  UnsupportedMediaType = 'UnsupportedMediaType',\n\n  // The system or downstream resource is out of resources\n  OutOfResources = 'OutOfResources',\n\n  // A generic error occurred that does not fit into a more specific category\n  // ~ Think 500 Internal Server Error in a web server\n  GenericError = 'GenericError',\n\n  // The requested resource or action has not yet been implemented\n  NotImplemented = 'NotImplemented',\n\n  // The requested resource or action was successful, but no content was returned\n  NoContent = 'NoContent',\n\n  // The request included invalid data or parameters\n  BadRequest = 'BadRequest',\n\n  // The request payload was invalid or in an unsupported format\n  Invalid = 'Invalid',\n\n  // The request attempted to create a resource that already exists, or conflicting changes were detected\n  Conflict = 'Conflict',\n}\n\nexport interface QPQError {\n  errorType: ErrorTypeEnum | string;\n  errorText: string;\n  errorStack?: string;\n}\n"]}
+{"version":3,"file":"ErrorTypeEnum.js","sourceRoot":"","sources":["../../../src/types/ErrorTypeEnum.ts"],"names":[],"mappings":";;;AAAA,oDAAoD;AACpD,EAAE;AACF,IAAY,aAyCX;AAzCD,WAAY,aAAa;IACvB,gFAAgF;IAChF,oDAAoD;IACpD,8CAA6B,CAAA;IAE7B,mEAAmE;IACnE,oDAAmC,CAAA;IAEnC,mEAAmE;IACnE,wCAAuB,CAAA;IAEvB,qDAAqD;IACrD,sCAAqB,CAAA;IAErB,oEAAoE;IACpE,oCAAmB,CAAA;IAEnB,2DAA2D;IAC3D,8DAA6C,CAAA;IAE7C,wDAAwD;IACxD,kDAAiC,CAAA;IAEjC,2EAA2E;IAC3E,oDAAoD;IACpD,8CAA6B,CAAA;IAE7B,gEAAgE;IAChE,kDAAiC,CAAA;IAEjC,+EAA+E;IAC/E,wCAAuB,CAAA;IAEvB,kDAAkD;IAClD,0CAAyB,CAAA;IAEzB,8DAA8D;IAC9D,oCAAmB,CAAA;IAEnB,uGAAuG;IACvG,sCAAqB,CAAA;AACvB,CAAC,EAzCW,aAAa,6BAAb,aAAa,QAyCxB","sourcesContent":["// Note: Error enum text may be surfaced to the user\n//\nexport enum ErrorTypeEnum {\n  // User failed to provide valid credentials required for accessing this resource\n  // ~ typically occurs when user is not authenticated\n  Unauthorized = 'Unauthorized',\n\n  // Payment is required to access this resource or perform an action\n  PaymentRequired = 'PaymentRequired',\n\n  // User does not have sufficient privileges to access this resource\n  Forbidden = 'Forbidden',\n\n  // The requested resource was not found on the server\n  NotFound = 'NotFound',\n\n  // The server timed out while waiting for a response from a resource\n  Timeout = 'Timeout',\n\n  // The request included an unsupported media type or format\n  UnsupportedMediaType = 'UnsupportedMediaType',\n\n  // The system or downstream resource is out of resources\n  OutOfResources = 'OutOfResources',\n\n  // A generic error occurred that does not fit into a more specific category\n  // ~ Think 500 Internal Server Error in a web server\n  GenericError = 'GenericError',\n\n  // The requested resource or action has not yet been implemented\n  NotImplemented = 'NotImplemented',\n\n  // The requested resource or action was successful, but no content was returned\n  NoContent = 'NoContent',\n\n  // The request included invalid data or parameters\n  BadRequest = 'BadRequest',\n\n  // The request payload was invalid or in an unsupported format\n  Invalid = 'Invalid',\n\n  // The request attempted to create a resource that already exists, or conflicting changes were detected\n  Conflict = 'Conflict',\n}\n\nexport type QPQError = {\n  errorType: ErrorTypeEnum | string;\n  errorText: string;\n  errorStack?: string;\n};\n"]}

package/lib/commonjs/types/KvsStreamEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"KvsStreamEvent.js","sourceRoot":"","sources":["../../../src/types/KvsStreamEvent.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,qCAAqC;AACrC,EAAE;AACF,0FAA0F;AAC1F,wFAAwF;AACxF,6EAA6E;AAC7E,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B","sourcesContent":["// One change to a key-value store item, delivered by the store's stream (see\n// defineKeyValueStore's `onStream`).\n//\n// The images are plain objects, not the storage layer's wire format: the action processor\n// unmarshals them, so a stream handler is ordinary story code and never sees a DynamoDB\n// AttributeValue. That also keeps handlers portable to a non-DynamoDB store.\nexport enum KvsStreamEventType {\n  Insert = 'Insert',\n  Modify = 'Modify',\n  Remove = 'Remove',\n}\n\nexport type KvsStreamRecord<TItem extends object = any> = {\n  keyValueStoreName: string;\n\n  eventType: KvsStreamEventType;\n\n  // The storage scope the item was written under; absent for an unscoped row.\n  //\n  // Scope is composed INTO the partition key value on the way to storage, so the raw stored\n  // key carries it. Every other read path hides that (the scoped translator strips it before\n  // a consumer ever sees it), and a stream record is the one place it would otherwise leak.\n  // Handing it back as its own field keeps that promise: a consumer re-enters the scope by\n  // reading this, instead of having to know the composition format and remember to undo it.\n  // Forgetting to would mean acting on one tenant's data while pointed at another's.\n  scope?: string;\n\n  // The item's key attributes only — always present, including on Remove. RAW: the scope has\n  // been stripped back out of the partition key, so these are the values the caller wrote.\n  keys: Record<string, unknown>;\n\n  // The item after the change, scope stripped like `keys`. Absent on Remove.\n  newImage?: TItem;\n\n  // The item before the change, scope stripped like `keys`. Absent on Insert.\n  oldImage?: TItem;\n};\n\n// Handlers are invoked per record, mirroring how storage drive and queue events are\n// dispatched. Ordering is guaranteed per partition key; records for different partition\n// keys may be processed concurrently.\nexport type KvsStreamEventResponse = void;\n"]}
+{"version":3,"file":"KvsStreamEvent.js","sourceRoot":"","sources":["../../../src/types/KvsStreamEvent.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,qCAAqC;AACrC,EAAE;AACF,0FAA0F;AAC1F,wFAAwF;AACxF,6EAA6E;AAC7E,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B","sourcesContent":["// One change to a key-value store item, delivered by the store's stream (see\n// defineKeyValueStore's `onStream`).\n//\n// The images are plain objects, not the storage layer's wire format: the action processor\n// unmarshals them, so a stream handler is ordinary story code and never sees a DynamoDB\n// AttributeValue. That also keeps handlers portable to a non-DynamoDB store.\nexport enum KvsStreamEventType {\n  Insert = 'Insert',\n  Modify = 'Modify',\n  Remove = 'Remove',\n}\n\nexport type KvsStreamRecord<TItem extends object = any> = {\n  keyValueStoreName: string;\n\n  eventType: KvsStreamEventType;\n\n  // The storage scope the item was written under; absent for an unscoped row.\n  //\n  // Scope is composed INTO the partition key value on the way to storage, so the raw stored\n  // key carries it. Every other read path hides that (the scoped translator strips it before\n  // a consumer ever sees it), and a stream record is the one place it would otherwise leak.\n  // Handing it back as its own field keeps that promise: a consumer re-enters the scope by\n  // reading this, instead of having to know the composition format and remember to undo it.\n  // Forgetting to would mean acting on one tenant's data while pointed at another's.\n  scope?: string;\n\n  // The item's key attributes only, always present, including on Remove. RAW: the scope has\n  // been stripped back out of the partition key, so these are the values the caller wrote.\n  keys: Record<string, unknown>;\n\n  // The item after the change, scope stripped like `keys`. Absent on Remove.\n  newImage?: TItem;\n\n  // The item before the change, scope stripped like `keys`. Absent on Insert.\n  oldImage?: TItem;\n};\n\n// Handlers are invoked per record, mirroring how storage drive and queue events are\n// dispatched. Ordering is guaranteed per partition key; records for different partition\n// keys may be processed concurrently.\nexport type KvsStreamEventResponse = void;\n"]}

package/lib/commonjs/types/LogLevelEnum.js

@@ -7,7 +7,7 @@ const lookup_1 = require("../logic/lookup");
 var LogLevelEnum;
 (function (LogLevelEnum) {
     // the log level that tells that the application encountered an event or entered a state
-    // in which one of the crucial business functionality is no longer working. A FATAL log
+    // in which one of the crucial business functions has stopped working. A FATAL log
     // level may be used when the application is not able to connect to a crucial data store
     // like a database or all the payment systems are not available and users can’t checkout
     // their baskets in your e-commerce.

package/lib/commonjs/types/LogLevelEnum.js.map

@@ -1 +1 @@
-{"version":3,"file":"LogLevelEnum.js","sourceRoot":"","sources":["../../../src/types/LogLevelEnum.ts"],"names":[],"mappings":";;;AAAA,4CAAkD;AAGlD,2BAA2B;AAC3B,EAAE;AACF,IAAY,YA0CX;AA1CD,WAAY,YAAY;IACtB,wFAAwF;IACxF,uFAAuF;IACvF,wFAAwF;IACxF,wFAAwF;IACxF,oCAAoC;IACpC,iDAAS,CAAA;IAET,yFAAyF;IACzF,uFAAuF;IACvF,sFAAsF;IACtF,wFAAwF;IACxF,kCAAkC;IAClC,iDAAS,CAAA;IAET,wFAAwF;IACxF,oFAAoF;IACpF,qFAAqF;IACrF,mFAAmF;IACnF,oEAAoE;IACpE,+CAAQ,CAAA;IAER,uFAAuF;IACvF,yFAAyF;IACzF,+EAA+E;IAC/E,uFAAuF;IACvF,sFAAsF;IACtF,+CAA+C;IAC/C,+CAAQ,CAAA;IAER,kFAAkF;IAClF,sFAAsF;IACtF,oFAAoF;IACpF,6EAA6E;IAC7E,iDAAS,CAAA;IAET,+EAA+E;IAC/E,sFAAsF;IACtF,qFAAqF;IACrF,uFAAuF;IACvF,sCAAsC;IACtC,iDAAS,CAAA;AACX,CAAC,EA1CW,YAAY,4BAAZ,YAAY,QA0CvB;AAID,mFAAmF;AACnF,6CAA6C;AAChC,QAAA,qBAAqB,GAAmB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAExI,QAAA,mBAAmB,GAAyB,IAAA,wBAAe,EAAC,YAAY,CAAC,CAAC","sourcesContent":["import { getLookupValues } from '../logic/lookup';\nimport { Lookup } from './Lookup';\n\n// How important is the log\n//\nexport enum LogLevelEnum {\n  // the log level that tells that the application encountered an event or entered a state\n  // in which one of the crucial business functionality is no longer working. A FATAL log\n  // level may be used when the application is not able to connect to a crucial data store\n  // like a database or all the payment systems are not available and users can’t checkout\n  // their baskets in your e-commerce.\n  Fatal = 0,\n\n  // the log level that should be used when the application hits an issue preventing one or\n  // more functionalities from properly functioning. The ERROR log level can be used when\n  // one of the payment systems is not available, but there is still the option to check\n  // out the basket in the e-commerce application or when your social media logging option\n  // is not working for some reason.\n  Error = 1,\n\n  // the log level that indicates that something unexpected happened in the application, a\n  // problem, or a situation that might disturb one of the processes. But that doesn’t\n  // mean that the application failed. The WARN level should be used in situations that\n  // are unexpected, but the code can continue the work. For example, a parsing error\n  // occurred that resulted in a certain document not being processed.\n  Warn = 2,\n\n  // The standard log level indicating that something happened, the application entered a\n  // certain state, etc. For example, a controller of your authorization API may include an\n  // INFO log level with information on which user requested authorization if the\n  // authorization was successful or not. The information logged using the INFO log level\n  // should be purely informative and not looking into them on a regular basis shouldn’t\n  // result in missing any important information.\n  Info = 3,\n\n  // less granular compared to the TRACE level, but it is more than you will need in\n  // everyday use. The DEBUG log level should be used for information that may be needed\n  // for diagnosing issues and troubleshooting or when running application in the test\n  // environment for the purpose of making sure everything is running correctly\n  Debug = 4,\n\n  // the most fine-grained information only used in rare cases where you need the\n  // full visibility of what is happening in your application and inside the third-party\n  // libraries that you use. You can expect the TRACE logging level to be very verbose.\n  // You can use it for example to annotate each step in the algorithm or each individual\n  // query with parameters in your code.\n  Trace = 5,\n}\n\nexport type LogLevelEnumLookup = Lookup<typeof LogLevelEnum>;\n\n// Object.values on a numeric enum returns the reverse-mapping names as well as the\n// numbers, so keep only the numeric members.\nexport const allLogLevelEnumValues: LogLevelEnum[] = Object.values(LogLevelEnum).filter((value): value is LogLevelEnum => typeof value === 'number');\n\nexport const logLevelEnumLookups: LogLevelEnumLookup[] = getLookupValues(LogLevelEnum);\n"]}
+{"version":3,"file":"LogLevelEnum.js","sourceRoot":"","sources":["../../../src/types/LogLevelEnum.ts"],"names":[],"mappings":";;;AAAA,4CAAkD;AAGlD,2BAA2B;AAC3B,EAAE;AACF,IAAY,YA0CX;AA1CD,WAAY,YAAY;IACtB,wFAAwF;IACxF,kFAAkF;IAClF,wFAAwF;IACxF,wFAAwF;IACxF,oCAAoC;IACpC,iDAAS,CAAA;IAET,yFAAyF;IACzF,uFAAuF;IACvF,sFAAsF;IACtF,wFAAwF;IACxF,kCAAkC;IAClC,iDAAS,CAAA;IAET,wFAAwF;IACxF,oFAAoF;IACpF,qFAAqF;IACrF,mFAAmF;IACnF,oEAAoE;IACpE,+CAAQ,CAAA;IAER,uFAAuF;IACvF,yFAAyF;IACzF,+EAA+E;IAC/E,uFAAuF;IACvF,sFAAsF;IACtF,+CAA+C;IAC/C,+CAAQ,CAAA;IAER,kFAAkF;IAClF,sFAAsF;IACtF,oFAAoF;IACpF,6EAA6E;IAC7E,iDAAS,CAAA;IAET,+EAA+E;IAC/E,sFAAsF;IACtF,qFAAqF;IACrF,uFAAuF;IACvF,sCAAsC;IACtC,iDAAS,CAAA;AACX,CAAC,EA1CW,YAAY,4BAAZ,YAAY,QA0CvB;AAID,mFAAmF;AACnF,6CAA6C;AAChC,QAAA,qBAAqB,GAAmB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAExI,QAAA,mBAAmB,GAAyB,IAAA,wBAAe,EAAC,YAAY,CAAC,CAAC","sourcesContent":["import { getLookupValues } from '../logic/lookup';\nimport { Lookup } from './Lookup';\n\n// How important is the log\n//\nexport enum LogLevelEnum {\n  // the log level that tells that the application encountered an event or entered a state\n  // in which one of the crucial business functions has stopped working. A FATAL log\n  // level may be used when the application is not able to connect to a crucial data store\n  // like a database or all the payment systems are not available and users can’t checkout\n  // their baskets in your e-commerce.\n  Fatal = 0,\n\n  // the log level that should be used when the application hits an issue preventing one or\n  // more functionalities from properly functioning. The ERROR log level can be used when\n  // one of the payment systems is not available, but there is still the option to check\n  // out the basket in the e-commerce application or when your social media logging option\n  // is not working for some reason.\n  Error = 1,\n\n  // the log level that indicates that something unexpected happened in the application, a\n  // problem, or a situation that might disturb one of the processes. But that doesn’t\n  // mean that the application failed. The WARN level should be used in situations that\n  // are unexpected, but the code can continue the work. For example, a parsing error\n  // occurred that resulted in a certain document not being processed.\n  Warn = 2,\n\n  // The standard log level indicating that something happened, the application entered a\n  // certain state, etc. For example, a controller of your authorization API may include an\n  // INFO log level with information on which user requested authorization if the\n  // authorization was successful or not. The information logged using the INFO log level\n  // should be purely informative and not looking into them on a regular basis shouldn’t\n  // result in missing any important information.\n  Info = 3,\n\n  // less granular compared to the TRACE level, but it is more than you will need in\n  // everyday use. The DEBUG log level should be used for information that may be needed\n  // for diagnosing issues and troubleshooting or when running application in the test\n  // environment for the purpose of making sure everything is running correctly\n  Debug = 4,\n\n  // the most fine-grained information only used in rare cases where you need the\n  // full visibility of what is happening in your application and inside the third-party\n  // libraries that you use. You can expect the TRACE logging level to be very verbose.\n  // You can use it for example to annotate each step in the algorithm or each individual\n  // query with parameters in your code.\n  Trace = 5,\n}\n\nexport type LogLevelEnumLookup = Lookup<typeof LogLevelEnum>;\n\n// Object.values on a numeric enum returns the reverse-mapping names as well as the\n// numbers, so keep only the numeric members.\nexport const allLogLevelEnumValues: LogLevelEnum[] = Object.values(LogLevelEnum).filter((value): value is LogLevelEnum => typeof value === 'number');\n\nexport const logLevelEnumLookups: LogLevelEnumLookup[] = getLookupValues(LogLevelEnum);\n"]}