@qpqjs/core 0.3.0 → 0.5.0

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

@@ -1 +1 @@
-{"version":3,"file":"askContextProvideValue.js","sourceRoot":"","sources":["../../../../src/stories/context/askContextProvideValue.ts"],"names":[],"mappings":";;AAOA,wDAkEC;AAzED,2CAA8C;AAC9C,mDAAoF;AAIpF,qEAA6G;AAE7G,QAAe,CAAC,CAAC,sBAAsB,CACrC,iBAA0C,EAC1C,KAAQ,EACR,aAAgB;IAEhB,IAAI,KAAK,GAA2B,IAAI,CAAC;IAEzC,OAAO,KAAK,CAAC,CAAC,IAAA,uCAAkB,EAAC,aAAa,EAAE;QAC9C,CAAC,2BAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAA8B;YACjE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAwC,CAAC;YAChE,IAAI,OAAO,CAAC,iBAAiB,CAAC,UAAU,KAAK,iBAAiB,CAAC,UAAU,EAAE,CAAC;gBAC1E,oEAAoE;gBACpE,OAAO,IAAA,8DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAC/E,CAAC;YAED,yEAAyE;YACzE,OAAO,MAAM,MAAM,CAAC;QACtB,CAAC;QAED,CAAC,2BAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAuC;YAC1E,iFAAiF;YACjF,IAAI,iBAAiB,CAAC,KAAK,EAAE,CAAC;gBAC5B,OAAO,MAAM,MAAM,CAAC;YACtB,CAAC;YAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,mBAAmB,GAAG,CAAC,MAAM;oBACjC,IAAI,EAAE,2BAAiB,CAAC,IAAI;oBAC5B,YAAY,EAAE,IAAI;iBACnB,CAAwC,CAAC;gBAE1C,iFAAiF;gBACjF,mFAAmF;gBACnF,mEAAmE;gBACnE,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;oBACjC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;wBACxB,OAAO,mBAAmB,CAAC;oBAC7B,CAAC;oBAED,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC9I,CAAC;gBAED,KAAK,mCACA,CAAC,mBAAmB,CAAC,MAAM,IAAI,EAAE,CAAC,KACrC,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,KAAK,GACtC,CAAC;YACJ,CAAC;YAED,oEAAoE;YACpE,OAAO,IAAA,8DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/E,CAAC;QAED,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM;YACpB,gFAAgF;YAChF,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,4FAA4F;YAC5F,qCAAqC;YACrC,OAAO,sCACF,MAAM,KACT,CAAC,UAAU,CAAC,kBACV,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,KAAK,IAClC,MAAM,CAAC,UAAU,CAAC,IAExB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { askThrowError } from '../../actions';\nimport { ContextActionType, ContextReadActionPayload } from '../../actions/context';\nimport { askContextList } from '../../actions/context/askContextList';\nimport { ContextReadAction } from '../../actions/context/askContextRead';\nimport { ActionOf, AskResponse, AskResponseReturnType, EitherActionResult, QpqContext, QpqContextIdentifier } from '../../types';\nimport { askOverrideActions, getSuccessfulEitherActionResultIfRequired } from '../system/askOverrideActions';\n\nexport function* askContextProvideValue<R, T extends AskResponse<any>>(\n  contextIdentifier: QpqContextIdentifier<R>,\n  value: R,\n  storyIterator: T,\n): AskResponse<AskResponseReturnType<T>> {\n  let cache: QpqContext<any> | null = null;\n\n  return yield* askOverrideActions(storyIterator, {\n    [ContextActionType.Read]: function* (action: ContextReadAction<any>) {\n      const payload = action.payload as ContextReadActionPayload<any>;\n      if (payload.contextIdentifier.uniqueName === contextIdentifier.uniqueName) {\n        // We produce this value ourselves, so we shape it for returnErrors.\n        return getSuccessfulEitherActionResultIfRequired(value, action.returnErrors);\n      }\n\n      // Not our identifier — relay the action and forward its result verbatim.\n      return yield action;\n    },\n\n    [ContextActionType.List]: function* (action: ActionOf<typeof askContextList>) {\n      // Local context is not part of the cross-service context list; stay transparent.\n      if (contextIdentifier.local) {\n        return yield action;\n      }\n\n      if (cache === null) {\n        const parentContextValues = (yield {\n          type: ContextActionType.List,\n          returnErrors: true,\n        }) as EitherActionResult<QpqContext<any>>;\n\n        // A failed parent list must propagate, not be masked as an empty parent context.\n        // The failure Either is already the shape the inner action expects when it carries\n        // returnErrors; otherwise rethrow so the error surfaces as normal.\n        if (!parentContextValues.success) {\n          if (action.returnErrors) {\n            return parentContextValues;\n          }\n\n          return yield* askThrowError(parentContextValues.error.errorType, parentContextValues.error.errorText, parentContextValues.error.errorStack);\n        }\n\n        cache = {\n          ...(parentContextValues.result || {}),\n          [contextIdentifier.uniqueName]: value,\n        };\n      }\n\n      // We produce this value ourselves, so we shape it for returnErrors.\n      return getSuccessfulEitherActionResultIfRequired(cache, action.returnErrors);\n    },\n\n    '*': function* (action) {\n      // Local context rides in a separate bag that is stripped at service boundaries.\n      const contextKey = contextIdentifier.local ? 'localContext' : 'context';\n      // Inject our context onto the action and relay it; the parent's result is already correctly\n      // shaped, so we forward it verbatim.\n      return yield {\n        ...action,\n        [contextKey]: {\n          [contextIdentifier.uniqueName]: value,\n          ...action[contextKey],\n        },\n      };\n    },\n  });\n}\n"]}
+{"version":3,"file":"askContextProvideValue.js","sourceRoot":"","sources":["../../../../src/stories/context/askContextProvideValue.ts"],"names":[],"mappings":";;AASA,wDAUC;AAnBD,mDAA0D;AAE1D,+DAA+D;AAC/D,yFAAsF;AACtF,qFAAkF;AAClF,qFAAkF;AAElF,iGAAiG;AACjG,8DAA8D;AAC9D,QAAe,CAAC,CAAC,sBAAsB,CACrC,iBAA0C,EAC1C,KAAQ,EACR,aAAgB;IAEhB,OAAO,KAAK,CAAC,CAAC,IAAA,oCAAkB,EAAC,aAAa,EAAE;QAC9C,CAAC,2BAAiB,CAAC,IAAI,CAAC,EAAE,IAAA,qDAAyB,EAAC,iBAAiB,EAAE,KAAK,CAAC;QAC7E,CAAC,2BAAiB,CAAC,IAAI,CAAC,EAAE,IAAA,qDAAyB,EAAC,iBAAiB,EAAE,KAAK,CAAC;QAC7E,GAAG,EAAE,IAAA,yDAA2B,EAAC,iBAAiB,EAAE,KAAK,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { ContextActionType } from '../../actions/context';\nimport { AskResponse, AskResponseReturnType, QpqContextIdentifier } from '../../types';\nimport { askOverrideActions } from '../system/overrideActions';\nimport { createContextInjectOverride } from './overrides/createContextInjectOverride';\nimport { createContextListOverride } from './overrides/createContextListOverride';\nimport { createContextReadOverride } from './overrides/createContextReadOverride';\n\n// Runs the story with this identifier's value in context: reads of it are answered here, context\n// lists include it, and every other action carries it onward.\nexport function* askContextProvideValue<R, T extends AskResponse<any>>(\n  contextIdentifier: QpqContextIdentifier<R>,\n  value: R,\n  storyIterator: T,\n): AskResponse<AskResponseReturnType<T>> {\n  return yield* askOverrideActions(storyIterator, {\n    [ContextActionType.Read]: createContextReadOverride(contextIdentifier, value),\n    [ContextActionType.List]: createContextListOverride(contextIdentifier, value),\n    '*': createContextInjectOverride(contextIdentifier, value),\n  });\n}\n"]}

package/lib/commonjs/stories/context/overrides/createContextInjectOverride.d.ts

@@ -0,0 +1,2 @@
+import { Action, ActionOverrideHandler, QpqContextIdentifier } from '../../../types';
+export declare const createContextInjectOverride: <R>(contextIdentifier: QpqContextIdentifier<R>, value: R) => ActionOverrideHandler<Action<any>>;

package/lib/commonjs/stories/context/overrides/createContextInjectOverride.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextInjectOverride = void 0;
+// Rides this identifier's value on every other action that passes through, so the processor that
+// handles it (and any service it crosses into) sees the context. Local context rides in a separate
+// bag that is stripped at service boundaries.
+const createContextInjectOverride = (contextIdentifier, value) => function* askContextInjectOverride(action) {
+    const contextKey = contextIdentifier.local ? 'localContext' : 'context';
+    // The parent's result is already correctly shaped, so we forward it verbatim.
+    return yield Object.assign(Object.assign({}, action), { [contextKey]: Object.assign({ [contextIdentifier.uniqueName]: value }, action[contextKey]) });
+};
+exports.createContextInjectOverride = createContextInjectOverride;
+//# sourceMappingURL=createContextInjectOverride.js.map

package/lib/commonjs/stories/context/overrides/createContextInjectOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextInjectOverride.js","sourceRoot":"","sources":["../../../../../src/stories/context/overrides/createContextInjectOverride.ts"],"names":[],"mappings":";;;AAEA,iGAAiG;AACjG,mGAAmG;AACnG,8CAA8C;AACvC,MAAM,2BAA2B,GAAG,CAAI,iBAA0C,EAAE,KAAQ,EAAsC,EAAE,CACzI,QAAQ,CAAC,CAAC,wBAAwB,CAAC,MAAM;IACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,8EAA8E;IAC9E,OAAO,sCACF,MAAM,KACT,CAAC,UAAU,CAAC,kBACV,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,KAAK,IAClC,MAAM,CAAC,UAAU,CAAC,IAExB,CAAC;AACJ,CAAC,CAAC;AAZS,QAAA,2BAA2B,+BAYpC","sourcesContent":["import { Action, ActionOverrideHandler, AskResponse, QpqContextIdentifier } from '../../../types';\n\n// Rides this identifier's value on every other action that passes through, so the processor that\n// handles it (and any service it crosses into) sees the context. Local context rides in a separate\n// bag that is stripped at service boundaries.\nexport const createContextInjectOverride = <R>(contextIdentifier: QpqContextIdentifier<R>, value: R): ActionOverrideHandler<Action<any>> =>\n  function* askContextInjectOverride(action): AskResponse<unknown> {\n    const contextKey = contextIdentifier.local ? 'localContext' : 'context';\n\n    // The parent's result is already correctly shaped, so we forward it verbatim.\n    return yield {\n      ...action,\n      [contextKey]: {\n        [contextIdentifier.uniqueName]: value,\n        ...action[contextKey],\n      },\n    };\n  };\n"]}

package/lib/commonjs/stories/context/overrides/createContextListOverride.d.ts

@@ -0,0 +1,3 @@
+import { askContextList } from '../../../actions/context/askContextList';
+import { ActionOf, ActionOverrideHandler, QpqContextIdentifier } from '../../../types';
+export declare const createContextListOverride: <R>(contextIdentifier: QpqContextIdentifier<R>, value: R) => ActionOverrideHandler<ActionOf<typeof askContextList>>;

package/lib/commonjs/stories/context/overrides/createContextListOverride.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextListOverride = void 0;
+const actions_1 = require("../../../actions");
+const context_1 = require("../../../actions/context");
+const overrideActions_1 = require("../../system/overrideActions");
+// Answers a context list with the parent's list plus this identifier's value. The parent's list is
+// asked for once and kept for the life of the provide. A local identifier is not part of the
+// cross-service context list, so its override stays transparent.
+const createContextListOverride = (contextIdentifier, value) => {
+    let cache = null;
+    return function* askContextListOverride(action) {
+        if (contextIdentifier.local) {
+            return yield action;
+        }
+        if (cache === null) {
+            const parentContextValues = (yield {
+                type: context_1.ContextActionType.List,
+                returnErrors: true,
+            });
+            // A failed parent list must propagate, not be masked as an empty parent context.
+            // The failure Either is already the shape the inner action expects when it carries
+            // returnErrors; otherwise rethrow so the error surfaces as normal.
+            if (!parentContextValues.success) {
+                if (action.returnErrors) {
+                    return parentContextValues;
+                }
+                return yield* (0, actions_1.askThrowError)(parentContextValues.error.errorType, parentContextValues.error.errorText, parentContextValues.error.errorStack);
+            }
+            cache = Object.assign(Object.assign({}, (parentContextValues.result || {})), { [contextIdentifier.uniqueName]: value });
+        }
+        // We produce this value ourselves, so we shape it for returnErrors.
+        return (0, overrideActions_1.getSuccessfulEitherActionResultIfRequired)(cache, action.returnErrors);
+    };
+};
+exports.createContextListOverride = createContextListOverride;
+//# sourceMappingURL=createContextListOverride.js.map

package/lib/commonjs/stories/context/overrides/createContextListOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextListOverride.js","sourceRoot":"","sources":["../../../../../src/stories/context/overrides/createContextListOverride.ts"],"names":[],"mappings":";;;AAAA,8CAAiD;AACjD,sDAA6D;AAG7D,kEAAyF;AAEzF,mGAAmG;AACnG,6FAA6F;AAC7F,iEAAiE;AAC1D,MAAM,yBAAyB,GAAG,CACvC,iBAA0C,EAC1C,KAAQ,EACgD,EAAE;IAC1D,IAAI,KAAK,GAA8B,IAAI,CAAC;IAE5C,OAAO,QAAQ,CAAC,CAAC,sBAAsB,CAAC,MAAM;QAC5C,IAAI,iBAAiB,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,MAAM,MAAM,CAAC;QACtB,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,mBAAmB,GAAG,CAAC,MAAM;gBACjC,IAAI,EAAE,2BAAiB,CAAC,IAAI;gBAC5B,YAAY,EAAE,IAAI;aACnB,CAAwC,CAAC;YAE1C,iFAAiF;YACjF,mFAAmF;YACnF,mEAAmE;YACnE,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;oBACxB,OAAO,mBAAmB,CAAC;gBAC7B,CAAC;gBAED,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9I,CAAC;YAED,KAAK,mCACA,CAAC,mBAAmB,CAAC,MAAM,IAAI,EAAE,CAAC,KACrC,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,KAAK,GACtC,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,OAAO,IAAA,2DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC,CAAC;AArCW,QAAA,yBAAyB,6BAqCpC","sourcesContent":["import { askThrowError } from '../../../actions';\nimport { ContextActionType } from '../../../actions/context';\nimport { askContextList } from '../../../actions/context/askContextList';\nimport { ActionOf, ActionOverrideHandler, AskResponse, EitherActionResult, Nullable, QpqContext, QpqContextIdentifier } from '../../../types';\nimport { getSuccessfulEitherActionResultIfRequired } from '../../system/overrideActions';\n\n// Answers a context list with the parent's list plus this identifier's value. The parent's list is\n// asked for once and kept for the life of the provide. A local identifier is not part of the\n// cross-service context list, so its override stays transparent.\nexport const createContextListOverride = <R>(\n  contextIdentifier: QpqContextIdentifier<R>,\n  value: R,\n): ActionOverrideHandler<ActionOf<typeof askContextList>> => {\n  let cache: Nullable<QpqContext<any>> = null;\n\n  return function* askContextListOverride(action): AskResponse<unknown> {\n    if (contextIdentifier.local) {\n      return yield action;\n    }\n\n    if (cache === null) {\n      const parentContextValues = (yield {\n        type: ContextActionType.List,\n        returnErrors: true,\n      }) as EitherActionResult<QpqContext<any>>;\n\n      // A failed parent list must propagate, not be masked as an empty parent context.\n      // The failure Either is already the shape the inner action expects when it carries\n      // returnErrors; otherwise rethrow so the error surfaces as normal.\n      if (!parentContextValues.success) {\n        if (action.returnErrors) {\n          return parentContextValues;\n        }\n\n        return yield* askThrowError(parentContextValues.error.errorType, parentContextValues.error.errorText, parentContextValues.error.errorStack);\n      }\n\n      cache = {\n        ...(parentContextValues.result || {}),\n        [contextIdentifier.uniqueName]: value,\n      };\n    }\n\n    // We produce this value ourselves, so we shape it for returnErrors.\n    return getSuccessfulEitherActionResultIfRequired(cache, action.returnErrors);\n  };\n};\n"]}

package/lib/commonjs/stories/context/overrides/createContextReadOverride.d.ts

@@ -0,0 +1,3 @@
+import { askContextReadBase } from '../../../actions/context/askContextRead';
+import { ActionOf, ActionOverrideHandler, QpqContextIdentifier } from '../../../types';
+export declare const createContextReadOverride: <R>(contextIdentifier: QpqContextIdentifier<R>, value: R) => ActionOverrideHandler<ActionOf<typeof askContextReadBase>>;

package/lib/commonjs/stories/context/overrides/createContextReadOverride.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextReadOverride = void 0;
+const overrideActions_1 = require("../../system/overrideActions");
+// Answers a read of this identifier with the provided value; any other identifier is relayed to the parent.
+const createContextReadOverride = (contextIdentifier, value) => function* askContextReadOverride(action) {
+    if (action.payload.contextIdentifier.uniqueName === contextIdentifier.uniqueName) {
+        // We produce this value ourselves, so we shape it for returnErrors.
+        return (0, overrideActions_1.getSuccessfulEitherActionResultIfRequired)(value, action.returnErrors);
+    }
+    // Not our identifier, relay the action and forward its result verbatim.
+    return yield action;
+};
+exports.createContextReadOverride = createContextReadOverride;
+//# sourceMappingURL=createContextReadOverride.js.map

package/lib/commonjs/stories/context/overrides/createContextReadOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextReadOverride.js","sourceRoot":"","sources":["../../../../../src/stories/context/overrides/createContextReadOverride.ts"],"names":[],"mappings":";;;AAEA,kEAAyF;AAEzF,4GAA4G;AACrG,MAAM,yBAAyB,GAAG,CACvC,iBAA0C,EAC1C,KAAQ,EACoD,EAAE,CAC9D,QAAQ,CAAC,CAAC,sBAAsB,CAAC,MAAM;IACrC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,UAAU,KAAK,iBAAiB,CAAC,UAAU,EAAE,CAAC;QACjF,oEAAoE;QACpE,OAAO,IAAA,2DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/E,CAAC;IAED,wEAAwE;IACxE,OAAO,MAAM,MAAM,CAAC;AACtB,CAAC,CAAC;AAZS,QAAA,yBAAyB,6BAYlC","sourcesContent":["import { askContextReadBase } from '../../../actions/context/askContextRead';\nimport { ActionOf, ActionOverrideHandler, AskResponse, QpqContextIdentifier } from '../../../types';\nimport { getSuccessfulEitherActionResultIfRequired } from '../../system/overrideActions';\n\n// Answers a read of this identifier with the provided value; any other identifier is relayed to the parent.\nexport const createContextReadOverride = <R>(\n  contextIdentifier: QpqContextIdentifier<R>,\n  value: R,\n): ActionOverrideHandler<ActionOf<typeof askContextReadBase>> =>\n  function* askContextReadOverride(action): AskResponse<unknown> {\n    if (action.payload.contextIdentifier.uniqueName === contextIdentifier.uniqueName) {\n      // We produce this value ourselves, so we shape it for returnErrors.\n      return getSuccessfulEitherActionResultIfRequired(value, action.returnErrors);\n    }\n\n    // Not our identifier, relay the action and forward its result verbatim.\n    return yield action;\n  };\n"]}

package/lib/commonjs/stories/context/overrides/index.d.ts

@@ -0,0 +1,3 @@
+export * from './createContextInjectOverride';
+export * from './createContextListOverride';
+export * from './createContextReadOverride';

package/lib/commonjs/stories/context/overrides/index.js

@@ -0,0 +1,20 @@
+"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("./createContextInjectOverride"), exports);
+__exportStar(require("./createContextListOverride"), exports);
+__exportStar(require("./createContextReadOverride"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/stories/context/overrides/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/stories/context/overrides/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C","sourcesContent":["export * from './createContextInjectOverride';\nexport * from './createContextListOverride';\nexport * from './createContextReadOverride';\n"]}

package/lib/commonjs/stories/crypto/askCryptoVerifyJwt.js

@@ -29,6 +29,9 @@ function* askCryptoVerifyJwt(keyName, token) {
         return { valid: false, reason: 'malformed' };
     }
     const [headerSegment, payloadSegment, signature] = segments;
+    if (headerSegment === undefined || payloadSegment === undefined || signature === undefined) {
+        return { valid: false, reason: 'malformed' };
+    }
     const header = parseJson(headerSegment);
     if (!isRecord(header)) {
         return { valid: false, reason: 'malformed' };

package/lib/commonjs/stories/crypto/askCryptoVerifyJwt.js.map

@@ -1 +1 @@
-{"version":3,"file":"askCryptoVerifyJwt.js","sourceRoot":"","sources":["../../../../src/stories/crypto/askCryptoVerifyJwt.ts"],"names":[],"mappings":"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","sourcesContent":["import { askCryptoVerify } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { base64UrlDecodeUtf8, isBase64Url } from '../../utils';\nimport { askGetCurrentEpoch } from '../dateTime';\n\nexport type JwtVerifyFailureReason =\n  | 'malformed' // not three base64url segments, or header/payload is not JSON\n  | 'unsupported-algorithm' // header alg is not RS256\n  | 'bad-signature' // signature does not verify under the key\n  | 'not-yet-valid' // nbf is in the future\n  | 'expired'; // exp is in the past\n\nexport type JwtVerifyResult<T> = { valid: true; claims: T } | { valid: false; reason: JwtVerifyFailureReason };\n\ntype JwtTimeClaims = { exp?: unknown; nbf?: unknown };\n\nconst parseJson = (segment: string): unknown => {\n  const decoded = base64UrlDecodeUtf8(segment);\n  if (decoded === null) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(decoded);\n  } catch {\n    return undefined;\n  }\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// Verifies a compact JWT produced by askCryptoSignJwt (or any RS256 signer whose\n// public key is the signing key's) and returns its claims. Untrusted input never\n// throws: every way a token can be bad is a `valid: false` result with a reason,\n// so a route can map it to 401 without a try/catch. Only the signature and the\n// standard `exp`/`nbf` time claims are checked (against QPQ time, so the check is\n// deterministic); audience, issuer and anything app-specific are the caller's.\nexport function* askCryptoVerifyJwt<T extends object>(keyName: string, token: string): AskResponse<JwtVerifyResult<T>> {\n  const segments = token.split('.');\n  if (segments.length !== 3 || !segments.every(isBase64Url)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  const [headerSegment, payloadSegment, signature] = segments;\n\n  const header = parseJson(headerSegment);\n  if (!isRecord(header)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  if (header.alg !== 'RS256') {\n    return { valid: false, reason: 'unsupported-algorithm' };\n  }\n\n  // Signature before payload: nothing in an unverified payload is trusted, not\n  // even enough to decide whether it parses.\n  const signatureIsValid = yield* askCryptoVerify(keyName, `${headerSegment}.${payloadSegment}`, signature);\n  if (!signatureIsValid) {\n    return { valid: false, reason: 'bad-signature' };\n  }\n\n  const claims = parseJson(payloadSegment);\n  if (!isRecord(claims)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  const { exp, nbf } = claims as JwtTimeClaims;\n\n  if (exp !== undefined || nbf !== undefined) {\n    const now = yield* askGetCurrentEpoch();\n\n    if (typeof nbf === 'number' && now < nbf) {\n      return { valid: false, reason: 'not-yet-valid' };\n    }\n\n    if (typeof exp === 'number' && now >= exp) {\n      return { valid: false, reason: 'expired' };\n    }\n  }\n\n  return { valid: true, claims: claims as T };\n}\n"]}
+{"version":3,"file":"askCryptoVerifyJwt.js","sourceRoot":"","sources":["../../../../src/stories/crypto/askCryptoVerifyJwt.ts"],"names":[],"mappings":";;AAqCA,gDA+CC;AApFD,2CAAgD;AAEhD,uCAA+D;AAC/D,0CAAiD;AAajD,MAAM,SAAS,GAAG,CAAC,OAAe,EAAW,EAAE;IAC7C,MAAM,OAAO,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE5I,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,+EAA+E;AAC/E,QAAe,CAAC,CAAC,kBAAkB,CAAmB,OAAe,EAAE,KAAa;IAClF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAW,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,aAAa,EAAE,cAAc,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;IAC5D,IAAI,aAAa,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC3F,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC3D,CAAC;IAED,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,IAAA,yBAAe,EAAC,OAAO,EAAE,GAAG,aAAa,IAAI,cAAc,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1G,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAuB,CAAC;IAE7C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,IAAA,6BAAkB,GAAE,CAAC;QAExC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAW,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["import { askCryptoVerify } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { base64UrlDecodeUtf8, isBase64Url } from '../../utils';\nimport { askGetCurrentEpoch } from '../dateTime';\n\nexport type JwtVerifyFailureReason =\n  | 'malformed' // not three base64url segments, or header/payload is not JSON\n  | 'unsupported-algorithm' // header alg is not RS256\n  | 'bad-signature' // signature does not verify under the key\n  | 'not-yet-valid' // nbf is in the future\n  | 'expired'; // exp is in the past\n\nexport type JwtVerifyResult<T> = { valid: true; claims: T } | { valid: false; reason: JwtVerifyFailureReason };\n\ntype JwtTimeClaims = { exp?: unknown; nbf?: unknown };\n\nconst parseJson = (segment: string): unknown => {\n  const decoded = base64UrlDecodeUtf8(segment);\n  if (decoded === null) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(decoded);\n  } catch {\n    return undefined;\n  }\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// Verifies a compact JWT produced by askCryptoSignJwt (or any RS256 signer whose\n// public key is the signing key's) and returns its claims. Untrusted input never\n// throws: every way a token can be bad is a `valid: false` result with a reason,\n// so a route can map it to 401 without a try/catch. Only the signature and the\n// standard `exp`/`nbf` time claims are checked (against QPQ time, so the check is\n// deterministic); audience, issuer and anything app-specific are the caller's.\nexport function* askCryptoVerifyJwt<T extends object>(keyName: string, token: string): AskResponse<JwtVerifyResult<T>> {\n  const segments = token.split('.');\n  if (segments.length !== 3 || !segments.every(isBase64Url)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  const [headerSegment, payloadSegment, signature] = segments;\n  if (headerSegment === undefined || payloadSegment === undefined || signature === undefined) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  const header = parseJson(headerSegment);\n  if (!isRecord(header)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  if (header.alg !== 'RS256') {\n    return { valid: false, reason: 'unsupported-algorithm' };\n  }\n\n  // Signature before payload: nothing in an unverified payload is trusted, not\n  // even enough to decide whether it parses.\n  const signatureIsValid = yield* askCryptoVerify(keyName, `${headerSegment}.${payloadSegment}`, signature);\n  if (!signatureIsValid) {\n    return { valid: false, reason: 'bad-signature' };\n  }\n\n  const claims = parseJson(payloadSegment);\n  if (!isRecord(claims)) {\n    return { valid: false, reason: 'malformed' };\n  }\n\n  const { exp, nbf } = claims as JwtTimeClaims;\n\n  if (exp !== undefined || nbf !== undefined) {\n    const now = yield* askGetCurrentEpoch();\n\n    if (typeof nbf === 'number' && now < nbf) {\n      return { valid: false, reason: 'not-yet-valid' };\n    }\n\n    if (typeof exp === 'number' && now >= exp) {\n      return { valid: false, reason: 'expired' };\n    }\n  }\n\n  return { valid: true, claims: claims as T };\n}\n"]}

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

@@ -8,6 +8,7 @@ export * from './crypto';
 export * from './dateTime';
 export * from './json';
 export * from './kvs';
+export * from './paging';
 export * from './state';
 export * from './stream';
 export * from './system';

package/lib/commonjs/stories/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./crypto"), exports);
 __exportStar(require("./dateTime"), exports);
 __exportStar(require("./json"), exports);
 __exportStar(require("./kvs"), exports);
+__exportStar(require("./paging"), exports);
 __exportStar(require("./state"), exports);
 __exportStar(require("./stream"), exports);
 __exportStar(require("./system"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6DAA2C;AAC3C,oDAAkC;AAClC,6CAA2B;AAC3B,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,6CAA2B;AAC3B,yCAAuB;AACvB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB","sourcesContent":["export * from './array';\nexport * from './askGetApplicationVersion';\nexport * from './askProcessEvent';\nexport * from './askRetry';\nexport * from './binaryData';\nexport * from './context';\nexport * from './crypto';\nexport * from './dateTime';\nexport * from './json';\nexport * from './kvs';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6DAA2C;AAC3C,oDAAkC;AAClC,6CAA2B;AAC3B,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,6CAA2B;AAC3B,yCAAuB;AACvB,wCAAsB;AACtB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB","sourcesContent":["export * from './array';\nexport * from './askGetApplicationVersion';\nexport * from './askProcessEvent';\nexport * from './askRetry';\nexport * from './binaryData';\nexport * from './context';\nexport * from './crypto';\nexport * from './dateTime';\nexport * from './json';\nexport * from './kvs';\nexport * from './paging';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\n"]}

package/lib/commonjs/stories/kvs/askKeyValueStoreQueryAll.js

@@ -2,15 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askKeyValueStoreQueryAll = askKeyValueStoreQueryAll;
 const actions_1 = require("../../actions");
+const askPagedDataDrain_1 = require("../paging/askPagedDataDrain");
 function* askKeyValueStoreQueryAll(keyValueStoreName, keyCondition, options) {
-    const allData = [];
-    let data = {
-        items: [],
-    };
-    do {
-        data = yield* (0, actions_1.askKeyValueStoreQuery)(keyValueStoreName, keyCondition, Object.assign(Object.assign({}, (options || {})), { nextPageKey: data.nextPageKey }));
-        allData.push(...data.items);
-    } while (data.nextPageKey);
-    return allData;
+    const { items } = yield* (0, askPagedDataDrain_1.askPagedDataDrain)(function* askQueryPage(nextPageKey) {
+        return yield* (0, actions_1.askKeyValueStoreQuery)(keyValueStoreName, keyCondition, Object.assign(Object.assign({}, (options || {})), { nextPageKey }));
+    });
+    return items;
 }
 //# sourceMappingURL=askKeyValueStoreQueryAll.js.map

package/lib/commonjs/stories/kvs/askKeyValueStoreQueryAll.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreQueryAll.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreQueryAll.ts"],"names":[],"mappings":";;AAKA,4DAoBC;AAzBD,2CAAoG;AAKpG,QAAe,CAAC,CAAC,wBAAwB,CACvC,iBAAyB,EACzB,YAA+B,EAC/B,OAAsC;IAEtC,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,IAAI,GAAoB;QAC1B,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,GAAG,CAAC;QACF,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,+BAAqB,EAAI,iBAAiB,EAAE,YAAY,kCACjE,CAAC,OAAO,IAAI,EAAE,CAAC,KAClB,WAAW,EAAE,IAAI,CAAC,WAAW,IAC7B,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { askKeyValueStoreQuery, KeyValueStoreQueryOptions, KvsQueryOperation } from '../../actions';\nimport { AskResponse, QpqPagedData } from '../../types';\n\ntype KeyValueStoreQueryAllOptions = Omit<KeyValueStoreQueryOptions, 'nextPageKey'>;\n\nexport function* askKeyValueStoreQueryAll<T>(\n  keyValueStoreName: string,\n  keyCondition: KvsQueryOperation,\n  options?: KeyValueStoreQueryAllOptions,\n): AskResponse<T[]> {\n  const allData: T[] = [];\n  let data: QpqPagedData<T> = {\n    items: [],\n  };\n\n  do {\n    data = yield* askKeyValueStoreQuery<T>(keyValueStoreName, keyCondition, {\n      ...(options || {}),\n      nextPageKey: data.nextPageKey,\n    });\n\n    allData.push(...data.items);\n  } while (data.nextPageKey);\n\n  return allData;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreQueryAll.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreQueryAll.ts"],"names":[],"mappings":";;AAMA,4DAUC;AAhBD,2CAAoG;AAEpG,mEAAgE;AAIhE,QAAe,CAAC,CAAC,wBAAwB,CACvC,iBAAyB,EACzB,YAA+B,EAC/B,OAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,IAAA,qCAAiB,EAAI,QAAQ,CAAC,CAAC,YAAY,CAAC,WAAW;QAC9E,OAAO,KAAK,CAAC,CAAC,IAAA,+BAAqB,EAAI,iBAAiB,EAAE,YAAY,kCAAO,CAAC,OAAO,IAAI,EAAE,CAAC,KAAE,WAAW,IAAG,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { askKeyValueStoreQuery, KeyValueStoreQueryOptions, KvsQueryOperation } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { askPagedDataDrain } from '../paging/askPagedDataDrain';\n\ntype KeyValueStoreQueryAllOptions = Omit<KeyValueStoreQueryOptions, 'nextPageKey'>;\n\nexport function* askKeyValueStoreQueryAll<T>(\n  keyValueStoreName: string,\n  keyCondition: KvsQueryOperation,\n  options?: KeyValueStoreQueryAllOptions,\n): AskResponse<T[]> {\n  const { items } = yield* askPagedDataDrain<T>(function* askQueryPage(nextPageKey) {\n    return yield* askKeyValueStoreQuery<T>(keyValueStoreName, keyCondition, { ...(options || {}), nextPageKey });\n  });\n\n  return items;\n}\n"]}

package/lib/commonjs/stories/kvs/askKeyValueStoreQuerySingle.d.ts

@@ -1,3 +1,4 @@
 import { KvsQueryOperation } from '../../actions';
 import { AskResponse } from '../../types';
-export declare function askKeyValueStoreQuerySingle<T>(keyValueStoreName: string, keyCondition: KvsQueryOperation, filter?: KvsQueryOperation, sortAscending?: boolean, limit?: number, scope?: string): AskResponse<T | null>;
+import { Nullable } from '../../types/Nullable';
+export declare function askKeyValueStoreQuerySingle<T>(keyValueStoreName: string, keyCondition: KvsQueryOperation, filter?: KvsQueryOperation, sortAscending?: boolean, limit?: number, scope?: string): AskResponse<Nullable<T>>;

package/lib/commonjs/stories/kvs/askKeyValueStoreQuerySingle.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.askKeyValueStoreQuerySingle = askKeyValueStoreQuerySingle;
 const actions_1 = require("../../actions");
 function* askKeyValueStoreQuerySingle(keyValueStoreName, keyCondition, filter, sortAscending, limit = 1, scope) {
+    var _a;
     const allData = [];
     let data = {
         items: [],
@@ -20,6 +21,6 @@ function* askKeyValueStoreQuerySingle(keyValueStoreName, keyCondition, filter, s
     } while (data.nextPageKey && allData.length < limit);
     // Return the first collected item: the last fetched page can be empty (or hold a
     // later match) even when an earlier page already produced the item we want.
-    return allData.length > 0 ? allData[0] : null;
+    return (_a = allData[0]) !== null && _a !== void 0 ? _a : null;
 }
 //# sourceMappingURL=askKeyValueStoreQuerySingle.js.map

package/lib/commonjs/stories/kvs/askKeyValueStoreQuerySingle.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreQuerySingle.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreQuerySingle.ts"],"names":[],"mappings":";;AAGA,kEA6BC;AAhCD,2CAAyE;AAGzE,QAAe,CAAC,CAAC,2BAA2B,CAC1C,iBAAyB,EACzB,YAA+B,EAC/B,MAA0B,EAC1B,aAAuB,EACvB,KAAK,GAAG,CAAC,EACT,KAAc;IAEd,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,IAAI,GAAoB;QAC1B,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,qEAAqE;IACrE,GAAG,CAAC;QACF,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,+BAAqB,EAAI,iBAAiB,EAAE,YAAY,EAAE;YACtE,MAAM;YACN,KAAK;YACL,aAAa;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,QAAQ,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE;IAErD,iFAAiF;IACjF,4EAA4E;IAC5E,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC","sourcesContent":["import { askKeyValueStoreQuery, KvsQueryOperation } from '../../actions';\nimport { AskResponse, QpqPagedData } from '../../types';\n\nexport function* askKeyValueStoreQuerySingle<T>(\n  keyValueStoreName: string,\n  keyCondition: KvsQueryOperation,\n  filter?: KvsQueryOperation,\n  sortAscending?: boolean,\n  limit = 1,\n  scope?: string,\n): AskResponse<T | null> {\n  const allData: T[] = [];\n  let data: QpqPagedData<T> = {\n    items: [],\n  };\n\n  // filters apply AFTER you get the limit of the data so do pagination\n  do {\n    data = yield* askKeyValueStoreQuery<T>(keyValueStoreName, keyCondition, {\n      filter,\n      limit,\n      sortAscending,\n      nextPageKey: data.nextPageKey,\n      scope,\n    });\n\n    allData.push(...data.items);\n  } while (data.nextPageKey && allData.length < limit);\n\n  // Return the first collected item: the last fetched page can be empty (or hold a\n  // later match) even when an earlier page already produced the item we want.\n  return allData.length > 0 ? allData[0] : null;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreQuerySingle.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreQuerySingle.ts"],"names":[],"mappings":";;AAIA,kEA6BC;AAjCD,2CAAyE;AAIzE,QAAe,CAAC,CAAC,2BAA2B,CAC1C,iBAAyB,EACzB,YAA+B,EAC/B,MAA0B,EAC1B,aAAuB,EACvB,KAAK,GAAG,CAAC,EACT,KAAc;;IAEd,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,IAAI,GAAoB;QAC1B,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,qEAAqE;IACrE,GAAG,CAAC;QACF,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,+BAAqB,EAAI,iBAAiB,EAAE,YAAY,EAAE;YACtE,MAAM;YACN,KAAK;YACL,aAAa;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,QAAQ,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE;IAErD,iFAAiF;IACjF,4EAA4E;IAC5E,OAAO,MAAA,OAAO,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;AAC5B,CAAC","sourcesContent":["import { askKeyValueStoreQuery, KvsQueryOperation } from '../../actions';\nimport { AskResponse, QpqPagedData } from '../../types';\nimport { Nullable } from '../../types/Nullable';\n\nexport function* askKeyValueStoreQuerySingle<T>(\n  keyValueStoreName: string,\n  keyCondition: KvsQueryOperation,\n  filter?: KvsQueryOperation,\n  sortAscending?: boolean,\n  limit = 1,\n  scope?: string,\n): AskResponse<Nullable<T>> {\n  const allData: T[] = [];\n  let data: QpqPagedData<T> = {\n    items: [],\n  };\n\n  // filters apply AFTER you get the limit of the data so do pagination\n  do {\n    data = yield* askKeyValueStoreQuery<T>(keyValueStoreName, keyCondition, {\n      filter,\n      limit,\n      sortAscending,\n      nextPageKey: data.nextPageKey,\n      scope,\n    });\n\n    allData.push(...data.items);\n  } while (data.nextPageKey && allData.length < limit);\n\n  // Return the first collected item: the last fetched page can be empty (or hold a\n  // later match) even when an earlier page already produced the item we want.\n  return allData[0] ?? null;\n}\n"]}

package/lib/commonjs/stories/kvs/askKeyValueStoreScanAll.js

@@ -2,16 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askKeyValueStoreScanAll = askKeyValueStoreScanAll;
 const actions_1 = require("../../actions");
+const askPagedDataDrain_1 = require("../paging/askPagedDataDrain");
 function* askKeyValueStoreScanAll(storeName, filterCondition, options) {
-    const allData = [];
-    let data = {
-        items: [],
-    };
-    do {
-        // Forward the options (including any scope) on every page, not just the first
-        data = yield* (0, actions_1.askKeyValueStoreScan)(storeName, filterCondition, data.nextPageKey, options);
-        allData.push(...data.items);
-    } while (data.nextPageKey);
-    return allData;
+    // Forward the options (including any scope) on every page, not just the first
+    const { items } = yield* (0, askPagedDataDrain_1.askPagedDataDrain)(function* askScanPage(nextPageKey) {
+        return yield* (0, actions_1.askKeyValueStoreScan)(storeName, filterCondition, nextPageKey, options);
+    });
+    return items;
 }
 //# sourceMappingURL=askKeyValueStoreScanAll.js.map

package/lib/commonjs/stories/kvs/askKeyValueStoreScanAll.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreScanAll.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreScanAll.ts"],"names":[],"mappings":";;AAGA,0DAkBC;AArBD,2CAAkG;AAGlG,QAAe,CAAC,CAAC,uBAAuB,CACtC,SAAiB,EACjB,eAAmC,EACnC,OAAkC;IAElC,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,IAAI,GAAoB;QAC1B,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,GAAG,CAAC;QACF,8EAA8E;QAC9E,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,8BAAoB,EAAI,SAAS,EAAE,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE7F,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { askKeyValueStoreScan, KeyValueStoreScanOptions, KvsQueryOperation } from '../../actions';\nimport { AskResponse, QpqPagedData } from '../../types';\n\nexport function* askKeyValueStoreScanAll<T>(\n  storeName: string,\n  filterCondition?: KvsQueryOperation,\n  options?: KeyValueStoreScanOptions,\n): AskResponse<T[]> {\n  const allData: T[] = [];\n  let data: QpqPagedData<T> = {\n    items: [],\n  };\n\n  do {\n    // Forward the options (including any scope) on every page, not just the first\n    data = yield* askKeyValueStoreScan<T>(storeName, filterCondition, data.nextPageKey, options);\n\n    allData.push(...data.items);\n  } while (data.nextPageKey);\n\n  return allData;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreScanAll.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreScanAll.ts"],"names":[],"mappings":";;AAIA,0DAWC;AAfD,2CAAkG;AAElG,mEAAgE;AAEhE,QAAe,CAAC,CAAC,uBAAuB,CACtC,SAAiB,EACjB,eAAmC,EACnC,OAAkC;IAElC,8EAA8E;IAC9E,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,IAAA,qCAAiB,EAAI,QAAQ,CAAC,CAAC,WAAW,CAAC,WAAW;QAC7E,OAAO,KAAK,CAAC,CAAC,IAAA,8BAAoB,EAAI,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { askKeyValueStoreScan, KeyValueStoreScanOptions, KvsQueryOperation } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { askPagedDataDrain } from '../paging/askPagedDataDrain';\n\nexport function* askKeyValueStoreScanAll<T>(\n  storeName: string,\n  filterCondition?: KvsQueryOperation,\n  options?: KeyValueStoreScanOptions,\n): AskResponse<T[]> {\n  // Forward the options (including any scope) on every page, not just the first\n  const { items } = yield* askPagedDataDrain<T>(function* askScanPage(nextPageKey) {\n    return yield* askKeyValueStoreScan<T>(storeName, filterCondition, nextPageKey, options);\n  });\n\n  return items;\n}\n"]}

package/lib/commonjs/stories/kvs/askKeyValueStoreUpdatePartialProperties.d.ts

@@ -1,12 +1,5 @@
 import { KeyValueStoreUpdateOptions } from '../../actions';
 import { AskResponse } from '../../types';
-export declare enum InvalidKvsPartialPropertyErrorCode {
-    unsupportedValueType = "unsupportedValueType"
-}
-export declare class InvalidKvsPartialPropertyError extends Error {
-    readonly code: InvalidKvsPartialPropertyErrorCode;
-    constructor(code: InvalidKvsPartialPropertyErrorCode, message: string);
-}
 export declare function askKeyValueStoreUpdatePartialProperties<TModel extends Record<string, any>, PartitionKey extends keyof TModel>(keyValueStoreName: string, partitionKeyName: PartitionKey, partialProperties: Partial<TModel> & {
     [key in PartitionKey]: TModel[PartitionKey];
 }, sortKeyName?: undefined, options?: KeyValueStoreUpdateOptions): AskResponse<TModel>;

package/lib/commonjs/stories/kvs/askKeyValueStoreUpdatePartialProperties.js

@@ -1,24 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidKvsPartialPropertyError = exports.InvalidKvsPartialPropertyErrorCode = void 0;
 exports.askKeyValueStoreUpdatePartialProperties = askKeyValueStoreUpdatePartialProperties;
 const actions_1 = require("../../actions");
+const types_1 = require("../../types");
 const utils_1 = require("./utils");
-var InvalidKvsPartialPropertyErrorCode;
-(function (InvalidKvsPartialPropertyErrorCode) {
-    // The property value is not a KvsAdvancedDataType, so kvsSet cannot store it.
-    InvalidKvsPartialPropertyErrorCode["unsupportedValueType"] = "unsupportedValueType";
-})(InvalidKvsPartialPropertyErrorCode || (exports.InvalidKvsPartialPropertyErrorCode = InvalidKvsPartialPropertyErrorCode = {}));
-// Thrown instead of silently dropping a property whose value kvsSet cannot store
-// (e.g. a nested object): a silent drop looks to the caller like a successful write.
-class InvalidKvsPartialPropertyError extends Error {
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.name = 'InvalidKvsPartialPropertyError';
-    }
-}
-exports.InvalidKvsPartialPropertyError = InvalidKvsPartialPropertyError;
 function* askKeyValueStoreUpdatePartialProperties(keyValueStoreName, partitionKeyName, partialProperties, sortKeyName, options) {
     const operations = [];
     for (const [key, value] of Object.entries(partialProperties)) {
@@ -31,7 +16,7 @@ function* askKeyValueStoreUpdatePartialProperties(keyValueStoreName, partitionKe
             continue;
         }
         if (!(0, utils_1.isValidKvsAdvancedDataType)(value)) {
-            throw new InvalidKvsPartialPropertyError(InvalidKvsPartialPropertyErrorCode.unsupportedValueType, `Cannot update property "${key}" on store "${keyValueStoreName}": the value is not a supported kvs data type`);
+            return yield* (0, actions_1.askThrowError)(types_1.ErrorTypeEnum.Invalid, `Cannot update property "${key}" on store "${keyValueStoreName}": the value is not a supported kvs data type`);
         }
         operations.push((0, actions_1.kvsSet)(key, value));
     }

package/lib/commonjs/stories/kvs/askKeyValueStoreUpdatePartialProperties.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreUpdatePartialProperties.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreUpdatePartialProperties.ts"],"names":[],"mappings":";;;AA6CA,0FAuCC;AApFD,2CAAkI;AAElI,mCAAqD;AAErD,IAAY,kCAGX;AAHD,WAAY,kCAAkC;IAC5C,8EAA8E;IAC9E,mFAA6C,CAAA;AAC/C,CAAC,EAHW,kCAAkC,kDAAlC,kCAAkC,QAG7C;AAED,iFAAiF;AACjF,qFAAqF;AACrF,MAAa,8BAA+B,SAAQ,KAAK;IACvD,YACkB,IAAwC,EACxD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAoC;QAIxD,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AARD,wEAQC;AA0BD,QAAe,CAAC,CAAC,uCAAuC,CACtD,iBAAyB,EACzB,gBAA8B,EAC9B,iBAEC,EACD,WAA0B,EAC1B,OAAoC;IAEpC,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7D,oFAAoF;QACpF,IAAI,GAAG,KAAK,gBAAgB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,IAAA,mBAAS,EAAC,GAAG,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAA,kCAA0B,EAAC,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,8BAA8B,CACtC,kCAAkC,CAAC,oBAAoB,EACvD,2BAA2B,GAAG,eAAe,iBAAiB,+CAA+C,CAC9G,CAAC;QACJ,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,IAAA,gBAAM,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAsB,EAClC,iBAAiB,EACjB,IAAA,mBAAS,EAAC,UAAU,CAAC,EACrB,iBAAiB,CAAC,gBAAgB,CAAC,EACnC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,EACxD,OAAO,CACR,CAAC;AACJ,CAAC","sourcesContent":["import { askKeyValueStoreUpdate, KeyValueStoreUpdateOptions, kvsRemove, kvsSet, kvsUpdate, KvsUpdateAction } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { isValidKvsAdvancedDataType } from './utils';\n\nexport enum InvalidKvsPartialPropertyErrorCode {\n  // The property value is not a KvsAdvancedDataType, so kvsSet cannot store it.\n  unsupportedValueType = 'unsupportedValueType',\n}\n\n// Thrown instead of silently dropping a property whose value kvsSet cannot store\n// (e.g. a nested object): a silent drop looks to the caller like a successful write.\nexport class InvalidKvsPartialPropertyError extends Error {\n  constructor(\n    public readonly code: InvalidKvsPartialPropertyErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'InvalidKvsPartialPropertyError';\n  }\n}\n\nexport function askKeyValueStoreUpdatePartialProperties<TModel extends Record<string, any>, PartitionKey extends keyof TModel>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  },\n  sortKeyName?: undefined,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel>;\n\nexport function askKeyValueStoreUpdatePartialProperties<\n  TModel extends Record<string, any>,\n  PartitionKey extends keyof TModel,\n  SortKey extends keyof TModel,\n>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  } & { [key in SortKey]: TModel[SortKey] },\n  sortKeyName: SortKey,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel>;\n\nexport function* askKeyValueStoreUpdatePartialProperties<TModel extends Record<string, any>, PartitionKey extends keyof TModel>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  },\n  sortKeyName?: keyof TModel,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel> {\n  const operations: KvsUpdateAction[] = [];\n\n  for (const [key, value] of Object.entries(partialProperties)) {\n    // The key attributes address the item; they are never part of the update operations\n    if (key === partitionKeyName || key === sortKeyName) {\n      continue;\n    }\n\n    if (value === undefined) {\n      operations.push(kvsRemove(key));\n      continue;\n    }\n\n    if (!isValidKvsAdvancedDataType(value)) {\n      throw new InvalidKvsPartialPropertyError(\n        InvalidKvsPartialPropertyErrorCode.unsupportedValueType,\n        `Cannot update property \"${key}\" on store \"${keyValueStoreName}\": the value is not a supported kvs data type`,\n      );\n    }\n\n    operations.push(kvsSet(key, value));\n  }\n\n  return yield* askKeyValueStoreUpdate<TModel>(\n    keyValueStoreName,\n    kvsUpdate(operations),\n    partialProperties[partitionKeyName],\n    sortKeyName ? partialProperties[sortKeyName] : undefined,\n    options,\n  );\n}\n"]}
+{"version":3,"file":"askKeyValueStoreUpdatePartialProperties.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreUpdatePartialProperties.ts"],"names":[],"mappings":";;AA4BA,0FAuCC;AAnED,2CAAiJ;AACjJ,uCAAyD;AACzD,mCAAqD;AA0BrD,QAAe,CAAC,CAAC,uCAAuC,CACtD,iBAAyB,EACzB,gBAA8B,EAC9B,iBAEC,EACD,WAA0B,EAC1B,OAAoC;IAEpC,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7D,oFAAoF;QACpF,IAAI,GAAG,KAAK,gBAAgB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,IAAA,mBAAS,EAAC,GAAG,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAA,kCAA0B,EAAC,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EACzB,qBAAa,CAAC,OAAO,EACrB,2BAA2B,GAAG,eAAe,iBAAiB,+CAA+C,CAC9G,CAAC;QACJ,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,IAAA,gBAAM,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAsB,EAClC,iBAAiB,EACjB,IAAA,mBAAS,EAAC,UAAU,CAAC,EACrB,iBAAiB,CAAC,gBAAgB,CAAC,EACnC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,EACxD,OAAO,CACR,CAAC;AACJ,CAAC","sourcesContent":["import { askKeyValueStoreUpdate, askThrowError, KeyValueStoreUpdateOptions, kvsRemove, kvsSet, kvsUpdate, KvsUpdateAction } from '../../actions';\nimport { AskResponse, ErrorTypeEnum } from '../../types';\nimport { isValidKvsAdvancedDataType } from './utils';\n\nexport function askKeyValueStoreUpdatePartialProperties<TModel extends Record<string, any>, PartitionKey extends keyof TModel>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  },\n  sortKeyName?: undefined,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel>;\n\nexport function askKeyValueStoreUpdatePartialProperties<\n  TModel extends Record<string, any>,\n  PartitionKey extends keyof TModel,\n  SortKey extends keyof TModel,\n>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  } & { [key in SortKey]: TModel[SortKey] },\n  sortKeyName: SortKey,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel>;\n\nexport function* askKeyValueStoreUpdatePartialProperties<TModel extends Record<string, any>, PartitionKey extends keyof TModel>(\n  keyValueStoreName: string,\n  partitionKeyName: PartitionKey,\n  partialProperties: Partial<TModel> & {\n    [key in PartitionKey]: TModel[PartitionKey];\n  },\n  sortKeyName?: keyof TModel,\n  options?: KeyValueStoreUpdateOptions,\n): AskResponse<TModel> {\n  const operations: KvsUpdateAction[] = [];\n\n  for (const [key, value] of Object.entries(partialProperties)) {\n    // The key attributes address the item; they are never part of the update operations\n    if (key === partitionKeyName || key === sortKeyName) {\n      continue;\n    }\n\n    if (value === undefined) {\n      operations.push(kvsRemove(key));\n      continue;\n    }\n\n    if (!isValidKvsAdvancedDataType(value)) {\n      return yield* askThrowError(\n        ErrorTypeEnum.Invalid,\n        `Cannot update property \"${key}\" on store \"${keyValueStoreName}\": the value is not a supported kvs data type`,\n      );\n    }\n\n    operations.push(kvsSet(key, value));\n  }\n\n  return yield* askKeyValueStoreUpdate<TModel>(\n    keyValueStoreName,\n    kvsUpdate(operations),\n    partialProperties[partitionKeyName],\n    sortKeyName ? partialProperties[sortKeyName] : undefined,\n    options,\n  );\n}\n"]}

package/lib/commonjs/stories/kvs/askKeyValueStoreUpsertWithRetry.js

@@ -21,9 +21,9 @@ function* askKeyValueStoreUpsertWithRetry(keyValueStoreName, item, options) {
     }, maxRetries, 250, 
     // Both transient: the service is throttling, or another write holds the item for the
     // moment. Conflict (the item exists) is final and passes straight through.
-    [actions_1.askKeyValueStoreUpsertBase.errorType.ServiceUnavailable, actions_1.askKeyValueStoreUpsertBase.errorType.WriteContention]);
+    [actions_1.askKeyValueStoreUpsertBase.errorType.Throttled, actions_1.askKeyValueStoreUpsertBase.errorType.WriteContention]);
     if (!upsertResponse.success) {
-        yield* (0, actions_1.askThrowError)(upsertResponse.error.errorType, upsertResponse.error.errorText, upsertResponse.error.errorStack);
+        return yield* (0, actions_1.askThrowError)(upsertResponse.error.errorType, upsertResponse.error.errorText, upsertResponse.error.errorStack);
     }
 }
 //# sourceMappingURL=askKeyValueStoreUpsertWithRetry.js.map

package/lib/commonjs/stories/kvs/askKeyValueStoreUpsertWithRetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreUpsertWithRetry.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreUpsertWithRetry.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAQA,0EAqBC;AA7BD,2CAA8H;AAE9H,0CAAuC;AAMvC,QAAe,CAAC,CAAC,+BAA+B,CAC9C,iBAAyB,EACzB,IAAa,EACb,OAA6C;IAE7C,MAAM,KAAoC,OAAO,IAAI,EAAE,EAAjD,EAAE,UAAU,GAAG,CAAC,OAAiC,EAA5B,UAAU,cAA/B,cAAiC,CAAgB,CAAC;IAExD,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,IAAA,mBAAQ,EACpC,QAAQ,CAAC,CAAC,WAAW;QACnB,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAsB,EAAU,iBAAiB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACrF,CAAC,EACD,UAAU,EACV,GAAG;IACH,qFAAqF;IACrF,2EAA2E;IAC3E,CAAC,oCAA0B,CAAC,SAAS,CAAC,kBAAkB,EAAE,oCAA0B,CAAC,SAAS,CAAC,eAAe,CAAC,CAChH,CAAC;IAEF,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxH,CAAC;AACH,CAAC","sourcesContent":["import { askKeyValueStoreUpsert, askKeyValueStoreUpsertBase, askThrowError, KeyValueStoreUpsertOptions } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { askRetry } from '../askRetry';\n\nexport type KeyValueStoreUpsertWithRetryOptions = KeyValueStoreUpsertOptions & {\n  maxRetries?: number; // default 3\n};\n\nexport function* askKeyValueStoreUpsertWithRetry<KvsItem>(\n  keyValueStoreName: string,\n  item: KvsItem,\n  options?: KeyValueStoreUpsertWithRetryOptions,\n): AskResponse<void> {\n  const { maxRetries = 3, ...kvsOptions } = options || {};\n\n  const upsertResponse = yield* askRetry(\n    function* askRunLogic() {\n      return yield* askKeyValueStoreUpsert<KvsItem>(keyValueStoreName, item, kvsOptions);\n    },\n    maxRetries,\n    250,\n    // Both transient: the service is throttling, or another write holds the item for the\n    // moment. Conflict (the item exists) is final and passes straight through.\n    [askKeyValueStoreUpsertBase.errorType.ServiceUnavailable, askKeyValueStoreUpsertBase.errorType.WriteContention],\n  );\n\n  if (!upsertResponse.success) {\n    yield* askThrowError(upsertResponse.error.errorType, upsertResponse.error.errorText, upsertResponse.error.errorStack);\n  }\n}\n"]}
+{"version":3,"file":"askKeyValueStoreUpsertWithRetry.js","sourceRoot":"","sources":["../../../../src/stories/kvs/askKeyValueStoreUpsertWithRetry.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAQA,0EAqBC;AA7BD,2CAA8H;AAE9H,0CAAuC;AAMvC,QAAe,CAAC,CAAC,+BAA+B,CAC9C,iBAAyB,EACzB,IAAa,EACb,OAA6C;IAE7C,MAAM,KAAoC,OAAO,IAAI,EAAE,EAAjD,EAAE,UAAU,GAAG,CAAC,OAAiC,EAA5B,UAAU,cAA/B,cAAiC,CAAgB,CAAC;IAExD,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,IAAA,mBAAQ,EACpC,QAAQ,CAAC,CAAC,WAAW;QACnB,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAsB,EAAU,iBAAiB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACrF,CAAC,EACD,UAAU,EACV,GAAG;IACH,qFAAqF;IACrF,2EAA2E;IAC3E,CAAC,oCAA0B,CAAC,SAAS,CAAC,SAAS,EAAE,oCAA0B,CAAC,SAAS,CAAC,eAAe,CAAC,CACvG,CAAC;IAEF,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,CAAC,IAAA,uBAAa,EAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/H,CAAC;AACH,CAAC","sourcesContent":["import { askKeyValueStoreUpsert, askKeyValueStoreUpsertBase, askThrowError, KeyValueStoreUpsertOptions } from '../../actions';\nimport { AskResponse } from '../../types';\nimport { askRetry } from '../askRetry';\n\nexport type KeyValueStoreUpsertWithRetryOptions = KeyValueStoreUpsertOptions & {\n  maxRetries?: number; // default 3\n};\n\nexport function* askKeyValueStoreUpsertWithRetry<KvsItem>(\n  keyValueStoreName: string,\n  item: KvsItem,\n  options?: KeyValueStoreUpsertWithRetryOptions,\n): AskResponse<void> {\n  const { maxRetries = 3, ...kvsOptions } = options || {};\n\n  const upsertResponse = yield* askRetry(\n    function* askRunLogic() {\n      return yield* askKeyValueStoreUpsert<KvsItem>(keyValueStoreName, item, kvsOptions);\n    },\n    maxRetries,\n    250,\n    // Both transient: the service is throttling, or another write holds the item for the\n    // moment. Conflict (the item exists) is final and passes straight through.\n    [askKeyValueStoreUpsertBase.errorType.Throttled, askKeyValueStoreUpsertBase.errorType.WriteContention],\n  );\n\n  if (!upsertResponse.success) {\n    return yield* askThrowError(upsertResponse.error.errorType, upsertResponse.error.errorText, upsertResponse.error.errorStack);\n  }\n}\n"]}

package/lib/commonjs/stories/paging/PagedDataDrainOptions.d.ts

@@ -0,0 +1,6 @@
+import { AskResponse } from '../../types';
+/** Options for askPagedDataDrain. */
+export type PagedDataDrainOptions<T> = {
+    startPageKey?: string;
+    askShouldContinue?: (collected: T[]) => AskResponse<boolean>;
+};

package/lib/commonjs/stories/paging/PagedDataDrainOptions.js

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

package/lib/commonjs/stories/paging/PagedDataDrainOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagedDataDrainOptions.js","sourceRoot":"","sources":["../../../../src/stories/paging/PagedDataDrainOptions.ts"],"names":[],"mappings":"","sourcesContent":["import { AskResponse } from '../../types';\n\n/** Options for askPagedDataDrain. */\nexport type PagedDataDrainOptions<T> = {\n  // Where to start, for a caller that already holds the first page.\n  startPageKey?: string;\n\n  // Asked after every page lands with everything collected so far. Answering false stops the\n  // walk early; the result then carries the key of the next unread page.\n  askShouldContinue?: (collected: T[]) => AskResponse<boolean>;\n};\n"]}

package/lib/commonjs/stories/paging/askPagedDataDrain.d.ts

@@ -0,0 +1,3 @@
+import { AskResponse, QpqPagedData } from '../../types';
+import { PagedDataDrainOptions } from './PagedDataDrainOptions';
+export declare function askPagedDataDrain<T>(askPage: (nextPageKey?: string) => AskResponse<QpqPagedData<T>>, options?: PagedDataDrainOptions<T>): AskResponse<QpqPagedData<T>>;

package/lib/commonjs/stories/paging/askPagedDataDrain.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askPagedDataDrain = askPagedDataDrain;
+// The one page loop. Walks `askPage` from the start key until it answers no next page (or the
+// caller says stop) and returns everything collected. `nextPageKey` on the result is undefined
+// when the walk ran to the end, which is the normal case.
+function* askPagedDataDrain(askPage, options) {
+    const items = [];
+    let nextPageKey = options === null || options === void 0 ? void 0 : options.startPageKey;
+    do {
+        const page = yield* askPage(nextPageKey);
+        items.push(...page.items);
+        nextPageKey = page.nextPageKey;
+        if (nextPageKey && (options === null || options === void 0 ? void 0 : options.askShouldContinue) && !(yield* options.askShouldContinue(items))) {
+            break;
+        }
+    } while (nextPageKey);
+    return { items, nextPageKey };
+}
+//# sourceMappingURL=askPagedDataDrain.js.map

package/lib/commonjs/stories/paging/askPagedDataDrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askPagedDataDrain.js","sourceRoot":"","sources":["../../../../src/stories/paging/askPagedDataDrain.ts"],"names":[],"mappings":";;AAMA,8CAmBC;AAtBD,8FAA8F;AAC9F,+FAA+F;AAC/F,0DAA0D;AAC1D,QAAe,CAAC,CAAC,iBAAiB,CAChC,OAA+D,EAC/D,OAAkC;IAElC,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,IAAI,WAAW,GAAuB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,CAAC;IAE5D,GAAG,CAAC;QACF,MAAM,IAAI,GAAoB,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE1D,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAE/B,IAAI,WAAW,KAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,iBAAiB,CAAA,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5F,MAAM;QACR,CAAC;IACH,CAAC,QAAQ,WAAW,EAAE;IAEtB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import { AskResponse, QpqPagedData } from '../../types';\nimport { PagedDataDrainOptions } from './PagedDataDrainOptions';\n\n// The one page loop. Walks `askPage` from the start key until it answers no next page (or the\n// caller says stop) and returns everything collected. `nextPageKey` on the result is undefined\n// when the walk ran to the end, which is the normal case.\nexport function* askPagedDataDrain<T>(\n  askPage: (nextPageKey?: string) => AskResponse<QpqPagedData<T>>,\n  options?: PagedDataDrainOptions<T>,\n): AskResponse<QpqPagedData<T>> {\n  const items: T[] = [];\n  let nextPageKey: string | undefined = options?.startPageKey;\n\n  do {\n    const page: QpqPagedData<T> = yield* askPage(nextPageKey);\n\n    items.push(...page.items);\n    nextPageKey = page.nextPageKey;\n\n    if (nextPageKey && options?.askShouldContinue && !(yield* options.askShouldContinue(items))) {\n      break;\n    }\n  } while (nextPageKey);\n\n  return { items, nextPageKey };\n}\n"]}

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

@@ -0,0 +1,2 @@
+export * from './askPagedDataDrain';
+export * from './PagedDataDrainOptions';

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

@@ -0,0 +1,19 @@
+"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("./askPagedDataDrain"), exports);
+__exportStar(require("./PagedDataDrainOptions"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stories/paging/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,0DAAwC","sourcesContent":["export * from './askPagedDataDrain';\nexport * from './PagedDataDrainOptions';\n"]}

package/lib/commonjs/stories/state/askReduceState.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askReduceState = askReduceState;
 const state_1 = require("../../actions/state");
-const askOverrideActions_1 = require("../system/askOverrideActions");
+const overrideActions_1 = require("../system/overrideActions");
 // Runs an inner story purely for its dispatched state effects and returns the computed state.
 //
 // Every askStateDispatch the inner story yields is captured here (never reaches the runtime),
@@ -13,15 +13,16 @@ const askOverrideActions_1 = require("../system/askOverrideActions");
 // any code run the same QPQ state-dispatch logic without a runtime State processor.
 function* askReduceState(initialState, reducer, story) {
     let state = initialState;
-    yield* (0, askOverrideActions_1.askOverrideActions)(story(), {
+    yield* (0, overrideActions_1.askOverrideActions)(story(), {
         [state_1.StateActionType.Dispatch]: function* (action) {
+            // The dispatch payload is untyped on the wire; the reducer declares the effect shape it accepts.
             const [nextState, handled] = reducer(state, action.payload.action);
             if (handled) {
                 state = nextState;
                 // A dispatch produces no value (void). We shape it ourselves for returnErrors.
-                return (0, askOverrideActions_1.getSuccessfulEitherActionResultIfRequired)(undefined, action.returnErrors);
+                return (0, overrideActions_1.getSuccessfulEitherActionResultIfRequired)(undefined, action.returnErrors);
             }
-            // Reducer didn't handle this effect — relay it so a parent askReduceState (or the runtime)
+            // Reducer didn't handle this effect, relay it so a parent askReduceState (or the runtime)
             // can handle it. The parent's result is forwarded to the inner dispatch verbatim (correct
             // under askCatch, including error propagation).
             return yield action;
@@ -30,7 +31,7 @@ function* askReduceState(initialState, reducer, story) {
             // Mirror the React getStateReadActionProcessor: return the whole accumulated state and ignore
             // payload.path (path reads are unsupported everywhere today). We produce this value, so we
             // shape it for returnErrors.
-            return (0, askOverrideActions_1.getSuccessfulEitherActionResultIfRequired)(state, action.returnErrors);
+            return (0, overrideActions_1.getSuccessfulEitherActionResultIfRequired)(state, action.returnErrors);
         },
     });
     return state;

package/lib/commonjs/stories/state/askReduceState.js.map

@@ -1 +1 @@
-{"version":3,"file":"askReduceState.js","sourceRoot":"","sources":["../../../../src/stories/state/askReduceState.ts"],"names":[],"mappings":";;AAaA,wCAgCC;AA7CD,+CAA4F;AAG5F,qEAA6G;AAE7G,8FAA8F;AAC9F,EAAE;AACF,8FAA8F;AAC9F,wFAAwF;AACxF,4FAA4F;AAC5F,EAAE;AACF,iGAAiG;AACjG,oFAAoF;AACpF,QAAe,CAAC,CAAC,cAAc,CAC7B,YAAmB,EACnB,OAAkC,EAClC,KAA8B;IAE9B,IAAI,KAAK,GAAG,YAAY,CAAC;IAEzB,KAAK,CAAC,CAAC,IAAA,uCAAkB,EAAC,KAAK,EAAE,EAAE;QACjC,CAAC,uBAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAmC;YACxE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEnE,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,GAAG,SAAS,CAAC;gBAClB,+EAA+E;gBAC/E,OAAO,IAAA,8DAAyC,EAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACnF,CAAC;YAED,2FAA2F;YAC3F,0FAA0F;YAC1F,gDAAgD;YAChD,OAAO,MAAM,MAAM,CAAC;QACtB,CAAC;QAED,CAAC,uBAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAuB;YACxD,8FAA8F;YAC9F,2FAA2F;YAC3F,6BAA6B;YAC7B,OAAO,IAAA,8DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/E,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { StateActionType, StateDispatchAction, StateReadAction } from '../../actions/state';\nimport { QpqReducer } from '../../logic/stateEffects';\nimport { AskResponse } from '../../types';\nimport { askOverrideActions, getSuccessfulEitherActionResultIfRequired } from '../system/askOverrideActions';\n\n// Runs an inner story purely for its dispatched state effects and returns the computed state.\n//\n// Every askStateDispatch the inner story yields is captured here (never reaches the runtime),\n// fed through `reducer`, and accumulated into `state`. askStateRead returns the current\n// accumulated state. When the inner story finishes, askReduceState returns the final state.\n//\n// This is the backend / pure-logic counterpart to the React useQPQ bubble-reducer hooks: it lets\n// any code run the same QPQ state-dispatch logic without a runtime State processor.\nexport function* askReduceState<State, Effect>(\n  initialState: State,\n  reducer: QpqReducer<State, Effect>,\n  story: () => AskResponse<void>,\n): AskResponse<State> {\n  let state = initialState;\n\n  yield* askOverrideActions(story(), {\n    [StateActionType.Dispatch]: function* (action: StateDispatchAction<Effect>) {\n      const [nextState, handled] = reducer(state, action.payload.action);\n\n      if (handled) {\n        state = nextState;\n        // A dispatch produces no value (void). We shape it ourselves for returnErrors.\n        return getSuccessfulEitherActionResultIfRequired(undefined, action.returnErrors);\n      }\n\n      // Reducer didn't handle this effect — relay it so a parent askReduceState (or the runtime)\n      // can handle it. The parent's result is forwarded to the inner dispatch verbatim (correct\n      // under askCatch, including error propagation).\n      return yield action;\n    },\n\n    [StateActionType.Read]: function* (action: StateReadAction) {\n      // Mirror the React getStateReadActionProcessor: return the whole accumulated state and ignore\n      // payload.path (path reads are unsupported everywhere today). We produce this value, so we\n      // shape it for returnErrors.\n      return getSuccessfulEitherActionResultIfRequired(state, action.returnErrors);\n    },\n  });\n\n  return state;\n}\n"]}
+{"version":3,"file":"askReduceState.js","sourceRoot":"","sources":["../../../../src/stories/state/askReduceState.ts"],"names":[],"mappings":";;AAaA,wCAiCC;AA9CD,+CAA8F;AAG9F,+DAA0G;AAE1G,8FAA8F;AAC9F,EAAE;AACF,8FAA8F;AAC9F,wFAAwF;AACxF,4FAA4F;AAC5F,EAAE;AACF,iGAAiG;AACjG,oFAAoF;AACpF,QAAe,CAAC,CAAC,cAAc,CAC7B,YAAmB,EACnB,OAAkC,EAClC,KAA8B;IAE9B,IAAI,KAAK,GAAG,YAAY,CAAC;IAEzB,KAAK,CAAC,CAAC,IAAA,oCAAkB,EAAC,KAAK,EAAE,EAAE;QACjC,CAAC,uBAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAA6C;YAClF,iGAAiG;YACjG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAgB,CAAC,CAAC;YAE7E,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,GAAG,SAAS,CAAC;gBAClB,+EAA+E;gBAC/E,OAAO,IAAA,2DAAyC,EAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACnF,CAAC;YAED,0FAA0F;YAC1F,0FAA0F;YAC1F,gDAAgD;YAChD,OAAO,MAAM,MAAM,CAAC;QACtB,CAAC;QAED,CAAC,uBAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAyC;YAC1E,8FAA8F;YAC9F,2FAA2F;YAC3F,6BAA6B;YAC7B,OAAO,IAAA,2DAAyC,EAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/E,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { askStateDispatchBase, askStateReadBase, StateActionType } from '../../actions/state';\nimport { QpqReducer } from '../../logic/stateEffects';\nimport { ActionOf, AskResponse } from '../../types';\nimport { askOverrideActions, getSuccessfulEitherActionResultIfRequired } from '../system/overrideActions';\n\n// Runs an inner story purely for its dispatched state effects and returns the computed state.\n//\n// Every askStateDispatch the inner story yields is captured here (never reaches the runtime),\n// fed through `reducer`, and accumulated into `state`. askStateRead returns the current\n// accumulated state. When the inner story finishes, askReduceState returns the final state.\n//\n// This is the backend / pure-logic counterpart to the React useQPQ bubble-reducer hooks: it lets\n// any code run the same QPQ state-dispatch logic without a runtime State processor.\nexport function* askReduceState<State, Effect>(\n  initialState: State,\n  reducer: QpqReducer<State, Effect>,\n  story: () => AskResponse<void>,\n): AskResponse<State> {\n  let state = initialState;\n\n  yield* askOverrideActions(story(), {\n    [StateActionType.Dispatch]: function* (action: ActionOf<typeof askStateDispatchBase>) {\n      // The dispatch payload is untyped on the wire; the reducer declares the effect shape it accepts.\n      const [nextState, handled] = reducer(state, action.payload.action as Effect);\n\n      if (handled) {\n        state = nextState;\n        // A dispatch produces no value (void). We shape it ourselves for returnErrors.\n        return getSuccessfulEitherActionResultIfRequired(undefined, action.returnErrors);\n      }\n\n      // Reducer didn't handle this effect, relay it so a parent askReduceState (or the runtime)\n      // can handle it. The parent's result is forwarded to the inner dispatch verbatim (correct\n      // under askCatch, including error propagation).\n      return yield action;\n    },\n\n    [StateActionType.Read]: function* (action: ActionOf<typeof askStateReadBase>) {\n      // Mirror the React getStateReadActionProcessor: return the whole accumulated state and ignore\n      // payload.path (path reads are unsupported everywhere today). We produce this value, so we\n      // shape it for returnErrors.\n      return getSuccessfulEitherActionResultIfRequired(state, action.returnErrors);\n    },\n  });\n\n  return state;\n}\n"]}

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

@@ -17,7 +17,6 @@ function* askCatch(storyIterator, finallyIterator) {
             // otherwise just pass down the result as we would expect.
             nextResult = storyIterator.next(nextResult.value.returnErrors ? nextInput : nextInput.result);
         }
-        // Return the successful final result of the generator
         return {
             success: true,
             result: nextResult.value,