@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/logic/config/getConfigSetting.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigSetting = void 0;
+const getConfigSettings_1 = require("./getConfigSettings");
+// The first setting of one type, or undefined when the config has none.
+const getConfigSetting = (qpqConfig, configSettingType) => {
+    const [setting] = (0, getConfigSettings_1.getConfigSettings)(qpqConfig, configSettingType);
+    return setting;
+};
+exports.getConfigSetting = getConfigSetting;
+//# sourceMappingURL=getConfigSetting.js.map

package/lib/commonjs/logic/config/getConfigSetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigSetting.js","sourceRoot":"","sources":["../../../../src/logic/config/getConfigSetting.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AAExD,wEAAwE;AACjE,MAAM,gBAAgB,GAAG,CAA6B,SAAoB,EAAE,iBAAyB,EAAiB,EAAE;IAC7H,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,qCAAiB,EAAI,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAHW,QAAA,gBAAgB,oBAG3B","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { getConfigSettings } from './getConfigSettings';\n\n// The first setting of one type, or undefined when the config has none.\nexport const getConfigSetting = <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string): T | undefined => {\n  const [setting] = getConfigSettings<T>(qpqConfig, configSettingType);\n  return setting;\n};\n"]}

package/lib/commonjs/logic/config/getConfigSettings.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+export declare const getConfigSettings: <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string) => T[];

package/lib/commonjs/logic/config/getConfigSettings.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigSettings = void 0;
+const flattenQpqConfig_1 = require("./flattenQpqConfig");
+// Every setting of one type, in declaration order, from the flattened config.
+const getConfigSettings = (qpqConfig, configSettingType) => 
+// eslint-disable-next-line no-restricted-syntax -- D1: the generic accessor every is<Name>Setting guard is built on.
+(0, flattenQpqConfig_1.flattenQpqConfig)(qpqConfig).filter((c) => c.configSettingType === configSettingType);
+exports.getConfigSettings = getConfigSettings;
+//# sourceMappingURL=getConfigSettings.js.map

package/lib/commonjs/logic/config/getConfigSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigSettings.js","sourceRoot":"","sources":["../../../../src/logic/config/getConfigSettings.ts"],"names":[],"mappings":";;;AACA,yDAAsD;AAEtD,8EAA8E;AACvE,MAAM,iBAAiB,GAAG,CAA6B,SAAoB,EAAE,iBAAyB,EAAO,EAAE;AACpH,qHAAqH;AACrH,IAAA,mCAAgB,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,iBAAiB,CAAQ,CAAC;AAFjF,QAAA,iBAAiB,qBAEgE","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { flattenQpqConfig } from './flattenQpqConfig';\n\n// Every setting of one type, in declaration order, from the flattened config.\nexport const getConfigSettings = <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string): T[] =>\n  // eslint-disable-next-line no-restricted-syntax -- D1: the generic accessor every is<Name>Setting guard is built on.\n  flattenQpqConfig(qpqConfig).filter((c) => c.configSettingType === configSettingType) as T[];\n"]}

package/lib/commonjs/logic/config/getForeignItems.d.ts

@@ -0,0 +1,3 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+/** The settings another service owns (declared here with a cross-module owner): the inverse of getOwnedItems. */
+export declare const getForeignItems: <T extends QPQConfigSetting>(settings: T[], qpqConfig: QPQConfig) => T[];

package/lib/commonjs/logic/config/getForeignItems.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getForeignItems = void 0;
+const getOwnedItems_1 = require("./getOwnedItems");
+/** The settings another service owns (declared here with a cross-module owner): the inverse of getOwnedItems. */
+const getForeignItems = (settings, qpqConfig) => {
+    const owned = (0, getOwnedItems_1.getOwnedItems)(settings, qpqConfig);
+    return settings.filter((setting) => !owned.includes(setting));
+};
+exports.getForeignItems = getForeignItems;
+//# sourceMappingURL=getForeignItems.js.map

package/lib/commonjs/logic/config/getForeignItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getForeignItems.js","sourceRoot":"","sources":["../../../../src/logic/config/getForeignItems.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAEhD,iHAAiH;AAC1G,MAAM,eAAe,GAAG,CAA6B,QAAa,EAAE,SAAoB,EAAO,EAAE;IACtG,MAAM,KAAK,GAAG,IAAA,6BAAa,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC;AAJW,QAAA,eAAe,mBAI1B","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { getOwnedItems } from './getOwnedItems';\n\n/** The settings another service owns (declared here with a cross-module owner): the inverse of getOwnedItems. */\nexport const getForeignItems = <T extends QPQConfigSetting>(settings: T[], qpqConfig: QPQConfig): T[] => {\n  const owned = getOwnedItems(settings, qpqConfig);\n\n  return settings.filter((setting) => !owned.includes(setting));\n};\n"]}

package/lib/commonjs/logic/config/getOwnedItems.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+export declare const getOwnedItems: <T extends QPQConfigSetting>(settings: T[], qpqConfig: QPQConfig) => T[];

package/lib/commonjs/logic/config/getOwnedItems.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOwnedItems = void 0;
+const getApplicationModuleEnvironment_1 = require("./getApplicationModuleEnvironment");
+const getApplicationModuleFeature_1 = require("./getApplicationModuleFeature");
+const getApplicationModuleName_1 = require("./getApplicationModuleName");
+const getApplicationName_1 = require("./getApplicationName");
+// The settings this config's module owns: those with no owner, and those whose owner names this
+// module, application, feature and environment (an omitted owner field matches anything).
+const getOwnedItems = (settings, qpqConfig) => {
+    const appModuleName = (0, getApplicationModuleName_1.getApplicationModuleName)(qpqConfig);
+    const appName = (0, getApplicationName_1.getApplicationName)(qpqConfig);
+    const appFeature = (0, getApplicationModuleFeature_1.getApplicationModuleFeature)(qpqConfig);
+    const appEnvironment = (0, getApplicationModuleEnvironment_1.getApplicationModuleEnvironment)(qpqConfig);
+    return settings.filter((s) => !s.owner ||
+        ((!s.owner.module || s.owner.module === appModuleName) &&
+            (!s.owner.application || s.owner.application === appName) &&
+            (s.owner.feature === undefined || (!s.owner.feature && !appFeature) || s.owner.feature === appFeature) &&
+            (!s.owner.environment || s.owner.environment === appEnvironment)));
+};
+exports.getOwnedItems = getOwnedItems;
+//# sourceMappingURL=getOwnedItems.js.map

package/lib/commonjs/logic/config/getOwnedItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnedItems.js","sourceRoot":"","sources":["../../../../src/logic/config/getOwnedItems.ts"],"names":[],"mappings":";;;AACA,uFAAoF;AACpF,+EAA4E;AAC5E,yEAAsE;AACtE,6DAA0D;AAE1D,gGAAgG;AAChG,0FAA0F;AACnF,MAAM,aAAa,GAAG,CAA6B,QAAa,EAAE,SAAoB,EAAO,EAAE;IACpG,MAAM,aAAa,GAAG,IAAA,mDAAwB,EAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAA,uCAAkB,EAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAA,yDAA2B,EAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,IAAA,iEAA+B,EAAC,SAAS,CAAC,CAAC;IAElE,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,KAAK;QACR,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC;YACpD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,OAAO,CAAC;YACzD,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC;YACtG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,cAAc,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,aAAa,iBAcxB","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { getApplicationModuleEnvironment } from './getApplicationModuleEnvironment';\nimport { getApplicationModuleFeature } from './getApplicationModuleFeature';\nimport { getApplicationModuleName } from './getApplicationModuleName';\nimport { getApplicationName } from './getApplicationName';\n\n// The settings this config's module owns: those with no owner, and those whose owner names this\n// module, application, feature and environment (an omitted owner field matches anything).\nexport const getOwnedItems = <T extends QPQConfigSetting>(settings: T[], qpqConfig: QPQConfig): T[] => {\n  const appModuleName = getApplicationModuleName(qpqConfig);\n  const appName = getApplicationName(qpqConfig);\n  const appFeature = getApplicationModuleFeature(qpqConfig);\n  const appEnvironment = getApplicationModuleEnvironment(qpqConfig);\n\n  return settings.filter(\n    (s) =>\n      !s.owner ||\n      ((!s.owner.module || s.owner.module === appModuleName) &&\n        (!s.owner.application || s.owner.application === appName) &&\n        (s.owner.feature === undefined || (!s.owner.feature && !appFeature) || s.owner.feature === appFeature) &&\n        (!s.owner.environment || s.owner.environment === appEnvironment)),\n  );\n};\n"]}

package/lib/commonjs/logic/config/index.d.ts

@@ -0,0 +1,13 @@
+export * from './DEFAULT_ENVIRONMENT';
+export * from './flattenQpqConfig';
+export * from './getApplicationConfigSetting';
+export * from './getApplicationModuleEnvironment';
+export * from './getApplicationModuleFeature';
+export * from './getApplicationModuleName';
+export * from './getApplicationName';
+export * from './getConfigSetting';
+export * from './getConfigSettings';
+export * from './getForeignItems';
+export * from './getOwnedItems';
+export * from './resolveOwnedResourceLocalName';
+export * from './resolveOwnerDeploymentContext';

package/lib/commonjs/logic/config/index.js

@@ -0,0 +1,30 @@
+"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("./DEFAULT_ENVIRONMENT"), exports);
+__exportStar(require("./flattenQpqConfig"), exports);
+__exportStar(require("./getApplicationConfigSetting"), exports);
+__exportStar(require("./getApplicationModuleEnvironment"), exports);
+__exportStar(require("./getApplicationModuleFeature"), exports);
+__exportStar(require("./getApplicationModuleName"), exports);
+__exportStar(require("./getApplicationName"), exports);
+__exportStar(require("./getConfigSetting"), exports);
+__exportStar(require("./getConfigSettings"), exports);
+__exportStar(require("./getForeignItems"), exports);
+__exportStar(require("./getOwnedItems"), exports);
+__exportStar(require("./resolveOwnedResourceLocalName"), exports);
+__exportStar(require("./resolveOwnerDeploymentContext"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/logic/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC;AACnC,gEAA8C;AAC9C,oEAAkD;AAClD,gEAA8C;AAC9C,6DAA2C;AAC3C,uDAAqC;AACrC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,kDAAgC;AAChC,kEAAgD;AAChD,kEAAgD","sourcesContent":["export * from './DEFAULT_ENVIRONMENT';\nexport * from './flattenQpqConfig';\nexport * from './getApplicationConfigSetting';\nexport * from './getApplicationModuleEnvironment';\nexport * from './getApplicationModuleFeature';\nexport * from './getApplicationModuleName';\nexport * from './getApplicationName';\nexport * from './getConfigSetting';\nexport * from './getConfigSettings';\nexport * from './getForeignItems';\nexport * from './getOwnedItems';\nexport * from './resolveOwnedResourceLocalName';\nexport * from './resolveOwnerDeploymentContext';\n"]}

package/lib/commonjs/logic/config/resolveOwnedResourceLocalName.d.ts

@@ -0,0 +1,2 @@
+import { CrossModuleOwner } from '../../types/CrossModuleOwner';
+export declare const resolveOwnedResourceLocalName: (resourceName: string, owner?: CrossModuleOwner) => string;

package/lib/commonjs/logic/config/resolveOwnedResourceLocalName.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOwnedResourceLocalName = void 0;
+// The name a resource was declared under by its owner: the owner's override when it renamed
+// it, else the name this service refers to it by.
+const resolveOwnedResourceLocalName = (resourceName, owner) => (owner === null || owner === void 0 ? void 0 : owner.resourceNameOverride) || resourceName;
+exports.resolveOwnedResourceLocalName = resolveOwnedResourceLocalName;
+//# sourceMappingURL=resolveOwnedResourceLocalName.js.map

package/lib/commonjs/logic/config/resolveOwnedResourceLocalName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOwnedResourceLocalName.js","sourceRoot":"","sources":["../../../../src/logic/config/resolveOwnedResourceLocalName.ts"],"names":[],"mappings":";;;AAEA,4FAA4F;AAC5F,kDAAkD;AAC3C,MAAM,6BAA6B,GAAG,CAAC,YAAoB,EAAE,KAAwB,EAAU,EAAE,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,oBAAoB,KAAI,YAAY,CAAC;AAAxI,QAAA,6BAA6B,iCAA2G","sourcesContent":["import { CrossModuleOwner } from '../../types/CrossModuleOwner';\n\n// The name a resource was declared under by its owner: the owner's override when it renamed\n// it, else the name this service refers to it by.\nexport const resolveOwnedResourceLocalName = (resourceName: string, owner?: CrossModuleOwner): string => owner?.resourceNameOverride || resourceName;\n"]}

package/lib/commonjs/logic/config/resolveOwnerDeploymentContext.d.ts

@@ -0,0 +1,4 @@
+import { QPQConfig } from '../../config/QPQConfig';
+import { CrossModuleOwner } from '../../types/CrossModuleOwner';
+import { OwnerDeploymentContext } from '../../types/OwnerDeploymentContext';
+export declare const resolveOwnerDeploymentContext: (qpqConfig: QPQConfig, owner?: CrossModuleOwner) => OwnerDeploymentContext;

package/lib/commonjs/logic/config/resolveOwnerDeploymentContext.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOwnerDeploymentContext = void 0;
+const getApplicationModuleEnvironment_1 = require("./getApplicationModuleEnvironment");
+const getApplicationModuleFeature_1 = require("./getApplicationModuleFeature");
+const getApplicationModuleName_1 = require("./getApplicationModuleName");
+const getApplicationName_1 = require("./getApplicationName");
+// A resource declared with a CrossModuleOwner belongs to another service. Every owner field
+// falls back to the executing service's own deployment context, so every consumer resolves
+// the exact place the owning service deployed it. The one definition of that fallback.
+const resolveOwnerDeploymentContext = (qpqConfig, owner) => ({
+    application: (owner === null || owner === void 0 ? void 0 : owner.application) || (0, getApplicationName_1.getApplicationName)(qpqConfig),
+    module: (owner === null || owner === void 0 ? void 0 : owner.module) || (0, getApplicationModuleName_1.getApplicationModuleName)(qpqConfig),
+    environment: (owner === null || owner === void 0 ? void 0 : owner.environment) || (0, getApplicationModuleEnvironment_1.getApplicationModuleEnvironment)(qpqConfig),
+    feature: (owner === null || owner === void 0 ? void 0 : owner.feature) || (0, getApplicationModuleFeature_1.getApplicationModuleFeature)(qpqConfig),
+});
+exports.resolveOwnerDeploymentContext = resolveOwnerDeploymentContext;
+//# sourceMappingURL=resolveOwnerDeploymentContext.js.map

package/lib/commonjs/logic/config/resolveOwnerDeploymentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOwnerDeploymentContext.js","sourceRoot":"","sources":["../../../../src/logic/config/resolveOwnerDeploymentContext.ts"],"names":[],"mappings":";;;AAGA,uFAAoF;AACpF,+EAA4E;AAC5E,yEAAsE;AACtE,6DAA0D;AAE1D,4FAA4F;AAC5F,2FAA2F;AAC3F,uFAAuF;AAChF,MAAM,6BAA6B,GAAG,CAAC,SAAoB,EAAE,KAAwB,EAA0B,EAAE,CAAC,CAAC;IACxH,WAAW,EAAE,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,WAAW,KAAI,IAAA,uCAAkB,EAAC,SAAS,CAAC;IAChE,MAAM,EAAE,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,KAAI,IAAA,mDAAwB,EAAC,SAAS,CAAC;IAC5D,WAAW,EAAE,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,WAAW,KAAI,IAAA,iEAA+B,EAAC,SAAS,CAAC;IAC7E,OAAO,EAAE,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,KAAI,IAAA,yDAA2B,EAAC,SAAS,CAAC;CAClE,CAAC,CAAC;AALU,QAAA,6BAA6B,iCAKvC","sourcesContent":["import { QPQConfig } from '../../config/QPQConfig';\nimport { CrossModuleOwner } from '../../types/CrossModuleOwner';\nimport { OwnerDeploymentContext } from '../../types/OwnerDeploymentContext';\nimport { getApplicationModuleEnvironment } from './getApplicationModuleEnvironment';\nimport { getApplicationModuleFeature } from './getApplicationModuleFeature';\nimport { getApplicationModuleName } from './getApplicationModuleName';\nimport { getApplicationName } from './getApplicationName';\n\n// A resource declared with a CrossModuleOwner belongs to another service. Every owner field\n// falls back to the executing service's own deployment context, so every consumer resolves\n// the exact place the owning service deployed it. The one definition of that fallback.\nexport const resolveOwnerDeploymentContext = (qpqConfig: QPQConfig, owner?: CrossModuleOwner): OwnerDeploymentContext => ({\n  application: owner?.application || getApplicationName(qpqConfig),\n  module: owner?.module || getApplicationModuleName(qpqConfig),\n  environment: owner?.environment || getApplicationModuleEnvironment(qpqConfig),\n  feature: owner?.feature || getApplicationModuleFeature(qpqConfig),\n});\n"]}

package/lib/commonjs/logic/context/createContextReaderOrThrow.d.ts

@@ -0,0 +1,8 @@
+import { AskResponse, QpqContextIdentifier, QPQError } from '../../types';
+/**
+ * Builds a reader that throws `errorType` with `message` when nothing has provided the context,
+ * for values a story cannot sensibly run without (an active scope, a signed-in user). A value
+ * counts as unprovided when the read comes back `undefined` or `null`, which is what an
+ * identifier declared with an empty default yields outside its provider.
+ */
+export declare function createContextReaderOrThrow<R>(contextIdentifier: QpqContextIdentifier<R>, errorType: QPQError['errorType'], message: string): () => AskResponse<NonNullable<R>>;

package/lib/commonjs/logic/context/createContextReaderOrThrow.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextReaderOrThrow = createContextReaderOrThrow;
+const askContextRead_1 = require("../../actions/context/askContextRead");
+const askThrowError_1 = require("../../actions/error/askThrowError");
+/**
+ * Builds a reader that throws `errorType` with `message` when nothing has provided the context,
+ * for values a story cannot sensibly run without (an active scope, a signed-in user). A value
+ * counts as unprovided when the read comes back `undefined` or `null`, which is what an
+ * identifier declared with an empty default yields outside its provider.
+ */
+function createContextReaderOrThrow(contextIdentifier, errorType, message) {
+    return function* askContextReadOrThrowWrapper() {
+        const value = yield* (0, askContextRead_1.askContextRead)(contextIdentifier);
+        if (value === undefined || value === null) {
+            return yield* (0, askThrowError_1.askThrowError)(errorType, message);
+        }
+        return value;
+    };
+}
+//# sourceMappingURL=createContextReaderOrThrow.js.map

package/lib/commonjs/logic/context/createContextReaderOrThrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextReaderOrThrow.js","sourceRoot":"","sources":["../../../../src/logic/context/createContextReaderOrThrow.ts"],"names":[],"mappings":";;AAUA,gEAUC;AApBD,yEAAsE;AACtE,qEAAkE;AAGlE;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAI,iBAA0C,EAAE,SAAgC,EAAE,OAAe;IACzI,OAAO,QAAQ,CAAC,CAAC,4BAA4B;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,IAAA,+BAAc,EAAC,iBAAiB,CAAC,CAAC;QAEvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,CAAC,IAAA,6BAAa,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { askContextRead } from '../../actions/context/askContextRead';\nimport { askThrowError } from '../../actions/error/askThrowError';\nimport { AskResponse, QpqContextIdentifier, QPQError } from '../../types';\n\n/**\n * Builds a reader that throws `errorType` with `message` when nothing has provided the context,\n * for values a story cannot sensibly run without (an active scope, a signed-in user). A value\n * counts as unprovided when the read comes back `undefined` or `null`, which is what an\n * identifier declared with an empty default yields outside its provider.\n */\nexport function createContextReaderOrThrow<R>(contextIdentifier: QpqContextIdentifier<R>, errorType: QPQError['errorType'], message: string) {\n  return function* askContextReadOrThrowWrapper(): AskResponse<NonNullable<R>> {\n    const value = yield* askContextRead(contextIdentifier);\n\n    if (value === undefined || value === null) {\n      return yield* askThrowError(errorType, message);\n    }\n\n    return value;\n  };\n}\n"]}

package/lib/commonjs/logic/context/index.d.ts

@@ -1,5 +1,6 @@
 export * from './createContextIdentifier';
 export * from './createContextProvider';
 export * from './createContextReader';
+export * from './createContextReaderOrThrow';
 export * from './createLocalContextIdentifier';
 export * from './toCrossServiceSession';

package/lib/commonjs/logic/context/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./createContextIdentifier"), exports);
 __exportStar(require("./createContextProvider"), exports);
 __exportStar(require("./createContextReader"), exports);
+__exportStar(require("./createContextReaderOrThrow"), exports);
 __exportStar(require("./createLocalContextIdentifier"), exports);
 __exportStar(require("./toCrossServiceSession"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/logic/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,0DAAwC;AACxC,wDAAsC;AACtC,iEAA+C;AAC/C,0DAAwC","sourcesContent":["export * from './createContextIdentifier';\nexport * from './createContextProvider';\nexport * from './createContextReader';\nexport * from './createLocalContextIdentifier';\nexport * from './toCrossServiceSession';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,0DAAwC;AACxC,wDAAsC;AACtC,+DAA6C;AAC7C,iEAA+C;AAC/C,0DAAwC","sourcesContent":["export * from './createContextIdentifier';\nexport * from './createContextProvider';\nexport * from './createContextReader';\nexport * from './createContextReaderOrThrow';\nexport * from './createLocalContextIdentifier';\nexport * from './toCrossServiceSession';\n"]}

package/lib/commonjs/logic/graphDatabase/GraphResultConverters.d.ts

@@ -0,0 +1,11 @@
+import { GraphNodeResult } from '../../config/settings/graphDatabase/types/GraphNodeResult';
+import { GraphRelationshipResult } from '../../config/settings/graphDatabase/types/GraphRelationshipResult';
+import { AskResponse } from '../../types/StorySession';
+/** What a vendor supplies to turn its own result cells into the platform-neutral graph results. */
+export type GraphResultConverters<TResult, TNode extends TResult, TRelationship extends TResult> = {
+    vendor: string;
+    isNode: (result: TResult) => result is TNode;
+    isRelationship: (result: TResult) => result is TRelationship;
+    askConvertNode: (node: TNode) => AskResponse<GraphNodeResult>;
+    askConvertRelationship: (relationship: TRelationship) => AskResponse<GraphRelationshipResult>;
+};

package/lib/commonjs/logic/graphDatabase/GraphResultConverters.js

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

package/lib/commonjs/logic/graphDatabase/GraphResultConverters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphResultConverters.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/GraphResultConverters.ts"],"names":[],"mappings":"","sourcesContent":["import { GraphNodeResult } from '../../config/settings/graphDatabase/types/GraphNodeResult';\nimport { GraphRelationshipResult } from '../../config/settings/graphDatabase/types/GraphRelationshipResult';\nimport { AskResponse } from '../../types/StorySession';\n\n/** What a vendor supplies to turn its own result cells into the platform-neutral graph results. */\nexport type GraphResultConverters<TResult, TNode extends TResult, TRelationship extends TResult> = {\n  vendor: string;\n  isNode: (result: TResult) => result is TNode;\n  isRelationship: (result: TResult) => result is TRelationship;\n  askConvertNode: (node: TNode) => AskResponse<GraphNodeResult>;\n  askConvertRelationship: (relationship: TRelationship) => AskResponse<GraphRelationshipResult>;\n};\n"]}

package/lib/commonjs/logic/graphDatabase/createAnyGraphResultConverter.d.ts

@@ -0,0 +1,9 @@
+import { AnyGraphResult } from '../../config/settings/graphDatabase/types/AnyGraphResult';
+import { AskResponse } from '../../types/StorySession';
+import { GraphResultConverters } from './GraphResultConverters';
+/**
+ * Builds the story that converts any one cell of a vendor's query result: scalars pass through,
+ * nodes and relationships go through the vendor's converters, anything else is a wire-format
+ * drift and throws. Neptune and Neo4j share this shape and differ only in the guards and converters.
+ */
+export declare function createAnyGraphResultConverter<TResult, TNode extends TResult, TRelationship extends TResult>(converters: GraphResultConverters<TResult, TNode, TRelationship>): (result: TResult) => AskResponse<AnyGraphResult>;

package/lib/commonjs/logic/graphDatabase/createAnyGraphResultConverter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAnyGraphResultConverter = createAnyGraphResultConverter;
+const askThrowError_1 = require("../../actions/error/askThrowError");
+const ErrorTypeEnum_1 = require("../../types/ErrorTypeEnum");
+const isGraphScalarResult_1 = require("./isGraphScalarResult");
+/**
+ * Builds the story that converts any one cell of a vendor's query result: scalars pass through,
+ * nodes and relationships go through the vendor's converters, anything else is a wire-format
+ * drift and throws. Neptune and Neo4j share this shape and differ only in the guards and converters.
+ */
+function createAnyGraphResultConverter(converters) {
+    return function* askConvertAnyResultToAnyGraphResult(result) {
+        if ((0, isGraphScalarResult_1.isGraphScalarResult)(result)) {
+            return result;
+        }
+        if (converters.isNode(result)) {
+            return yield* converters.askConvertNode(result);
+        }
+        if (converters.isRelationship(result)) {
+            return yield* converters.askConvertRelationship(result);
+        }
+        return yield* (0, askThrowError_1.askThrowError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `Unable to convert ${converters.vendor} query result`);
+    };
+}
+//# sourceMappingURL=createAnyGraphResultConverter.js.map

package/lib/commonjs/logic/graphDatabase/createAnyGraphResultConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnyGraphResultConverter.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/createAnyGraphResultConverter.ts"],"names":[],"mappings":";;AAYA,sEAkBC;AA9BD,qEAAkE;AAElE,6DAA0D;AAG1D,+DAA4D;AAE5D;;;;GAIG;AACH,SAAgB,6BAA6B,CAC3C,UAAgE;IAEhE,OAAO,QAAQ,CAAC,CAAC,mCAAmC,CAAC,MAAe;QAClE,IAAI,IAAA,yCAAmB,EAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,KAAK,CAAC,CAAC,IAAA,6BAAa,EAAC,6BAAa,CAAC,YAAY,EAAE,qBAAqB,UAAU,CAAC,MAAM,eAAe,CAAC,CAAC;IACjH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { askThrowError } from '../../actions/error/askThrowError';\nimport { AnyGraphResult } from '../../config/settings/graphDatabase/types/AnyGraphResult';\nimport { ErrorTypeEnum } from '../../types/ErrorTypeEnum';\nimport { AskResponse } from '../../types/StorySession';\nimport { GraphResultConverters } from './GraphResultConverters';\nimport { isGraphScalarResult } from './isGraphScalarResult';\n\n/**\n * Builds the story that converts any one cell of a vendor's query result: scalars pass through,\n * nodes and relationships go through the vendor's converters, anything else is a wire-format\n * drift and throws. Neptune and Neo4j share this shape and differ only in the guards and converters.\n */\nexport function createAnyGraphResultConverter<TResult, TNode extends TResult, TRelationship extends TResult>(\n  converters: GraphResultConverters<TResult, TNode, TRelationship>,\n) {\n  return function* askConvertAnyResultToAnyGraphResult(result: TResult): AskResponse<AnyGraphResult> {\n    if (isGraphScalarResult(result)) {\n      return result;\n    }\n\n    if (converters.isNode(result)) {\n      return yield* converters.askConvertNode(result);\n    }\n\n    if (converters.isRelationship(result)) {\n      return yield* converters.askConvertRelationship(result);\n    }\n\n    return yield* askThrowError(ErrorTypeEnum.GenericError, `Unable to convert ${converters.vendor} query result`);\n  };\n}\n"]}

package/lib/commonjs/logic/graphDatabase/index.d.ts

@@ -0,0 +1,3 @@
+export * from './createAnyGraphResultConverter';
+export * from './GraphResultConverters';
+export * from './isGraphScalarResult';

package/lib/commonjs/logic/graphDatabase/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("./createAnyGraphResultConverter"), exports);
+__exportStar(require("./GraphResultConverters"), exports);
+__exportStar(require("./isGraphScalarResult"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/logic/graphDatabase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,0DAAwC;AACxC,wDAAsC","sourcesContent":["export * from './createAnyGraphResultConverter';\nexport * from './GraphResultConverters';\nexport * from './isGraphScalarResult';\n"]}

package/lib/commonjs/logic/graphDatabase/isGraphScalarResult.d.ts

@@ -0,0 +1,3 @@
+import { GraphScalarResult } from '../../config/settings/graphDatabase/types/GraphScalarResult';
+/** A cell that is a plain value rather than a node or relationship entity; the same test for every graph vendor. */
+export declare const isGraphScalarResult: (value: unknown) => value is GraphScalarResult;

package/lib/commonjs/logic/graphDatabase/isGraphScalarResult.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGraphScalarResult = void 0;
+/** A cell that is a plain value rather than a node or relationship entity; the same test for every graph vendor. */
+const isGraphScalarResult = (value) => typeof value !== 'object' || value === null;
+exports.isGraphScalarResult = isGraphScalarResult;
+//# sourceMappingURL=isGraphScalarResult.js.map

package/lib/commonjs/logic/graphDatabase/isGraphScalarResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isGraphScalarResult.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/isGraphScalarResult.ts"],"names":[],"mappings":";;;AAEA,oHAAoH;AAC7G,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAAlH,QAAA,mBAAmB,uBAA+F","sourcesContent":["import { GraphScalarResult } from '../../config/settings/graphDatabase/types/GraphScalarResult';\n\n/** A cell that is a plain value rather than a node or relationship entity; the same test for every graph vendor. */\nexport const isGraphScalarResult = (value: unknown): value is GraphScalarResult => typeof value !== 'object' || value === null;\n"]}

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

@@ -1,7 +1,11 @@
+export * from './actionResult';
+export * from './actions';
 export * from './actionValidators';
+export * from './config';
 export * from './context';
 export * from './decomposedString';
 export * from './error';
+export * from './graphDatabase';
 export * from './keyValueStore';
 export * from './logHistory';
 export * from './lookup';
@@ -9,4 +13,3 @@ export * from './qpqPackage';
 export * from './scope';
 export * from './stateEffects';
 export * from './stream';
-export * from './transientErrorNames';

package/lib/commonjs/logic/index.js

@@ -14,10 +14,14 @@ 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("./actionResult"), exports);
+__exportStar(require("./actions"), exports);
 __exportStar(require("./actionValidators"), exports);
+__exportStar(require("./config"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./decomposedString"), exports);
 __exportStar(require("./error"), exports);
+__exportStar(require("./graphDatabase"), exports);
 __exportStar(require("./keyValueStore"), exports);
 __exportStar(require("./logHistory"), exports);
 __exportStar(require("./lookup"), exports);
@@ -25,5 +29,4 @@ __exportStar(require("./qpqPackage"), exports);
 __exportStar(require("./scope"), exports);
 __exportStar(require("./stateEffects"), exports);
 __exportStar(require("./stream"), exports);
-__exportStar(require("./transientErrorNames"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logic/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,4CAA0B;AAC1B,qDAAmC;AACnC,0CAAwB;AACxB,kDAAgC;AAChC,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAC7B,0CAAwB;AACxB,iDAA+B;AAC/B,2CAAyB;AACzB,wDAAsC","sourcesContent":["export * from './actionValidators';\nexport * from './context';\nexport * from './decomposedString';\nexport * from './error';\nexport * from './keyValueStore';\nexport * from './logHistory';\nexport * from './lookup';\nexport * from './qpqPackage';\nexport * from './scope';\nexport * from './stateEffects';\nexport * from './stream';\nexport * from './transientErrorNames';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logic/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,4CAA0B;AAC1B,qDAAmC;AACnC,2CAAyB;AACzB,4CAA0B;AAC1B,qDAAmC;AACnC,0CAAwB;AACxB,kDAAgC;AAChC,kDAAgC;AAChC,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAC7B,0CAAwB;AACxB,iDAA+B;AAC/B,2CAAyB","sourcesContent":["export * from './actionResult';\nexport * from './actions';\nexport * from './actionValidators';\nexport * from './config';\nexport * from './context';\nexport * from './decomposedString';\nexport * from './error';\nexport * from './graphDatabase';\nexport * from './keyValueStore';\nexport * from './logHistory';\nexport * from './lookup';\nexport * from './qpqPackage';\nexport * from './scope';\nexport * from './stateEffects';\nexport * from './stream';\n"]}

package/lib/commonjs/logic/logHistory/filterLogHistoryByActionTypes.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.filterLogHistoryByActionTypes = filterLogHistoryByActionTypes;
-const actionLogic_1 = require("../actionLogic");
+const actionResult_1 = require("../actionResult");
 const actionValidators_1 = require("../actionValidators");
 // Rebuild the ActionProcessorResult a nested action would have produced on its own,
 // so a flattened entry only carries its own result and not every sibling's.
@@ -10,11 +10,11 @@ function getNestedActionResult(nestedAction, nestedValue) {
     if (nestedAction.returnErrors) {
         const either = nestedValue;
         if (either && either.success === false) {
-            return (0, actionLogic_1.actionResultError)(either.error.errorType, either.error.errorText, either.error.errorStack);
+            return (0, actionResult_1.actionResultError)(either.error.errorType, either.error.errorText, either.error.errorStack);
         }
-        return (0, actionLogic_1.actionResult)(either === null || either === void 0 ? void 0 : either.result);
+        return (0, actionResult_1.actionResult)(either === null || either === void 0 ? void 0 : either.result);
     }
-    return (0, actionLogic_1.actionResult)(nestedValue);
+    return (0, actionResult_1.actionResult)(nestedValue);
 }
 function filterLogHistoryByActionTypes(history, actionTypes) {
     const result = [];
@@ -25,7 +25,7 @@ function filterLogHistoryByActionTypes(history, actionTypes) {
                 // A successful batch result is an array with one value per nested action.
                 // Slice it up so each flattened entry gets its own result; if the batch
                 // itself errored there is nothing per-action, so keep the batch error.
-                const batchValues = !(0, actionLogic_1.isErroredActionResult)(res) ? (0, actionLogic_1.resolveActionResult)(res) : undefined;
+                const batchValues = !(0, actionResult_1.isErroredActionResult)(res) ? (0, actionResult_1.resolveActionResult)(res) : undefined;
                 // Create new ActionHistory entries for each nested action
                 const nestedHistories = act.payload.actions.map((nestedAction, index) => {
                     const newHistory = {

package/lib/commonjs/logic/logHistory/filterLogHistoryByActionTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"filterLogHistoryByActionTypes.js","sourceRoot":"","sources":["../../../../src/logic/logHistory/filterLogHistoryByActionTypes.ts"],"names":[],"mappings":";;AAqBA,sEAkCC;AAtDD,gDAA6G;AAC7G,0DAAoD;AAEpD,oFAAoF;AACpF,4EAA4E;AAC5E,SAAS,qBAAqB,CAAC,YAAyB,EAAE,WAAgB;IACxE,mFAAmF;IACnF,IAAI,YAAY,CAAC,YAAY,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,WAAsC,CAAC;QAEtD,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACvC,OAAO,IAAA,+BAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,IAAA,0BAAY,EAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAA,0BAAY,EAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAA6B,EAAE,WAAqB;IAChG,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,SAAS,cAAc,CAAC,SAA+B;QACrD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;YAElD,IAAI,IAAA,gCAAa,EAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,wEAAwE;gBACxE,uEAAuE;gBACvE,MAAM,WAAW,GAAG,CAAC,IAAA,mCAAqB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,iCAAmB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEvF,0DAA0D;gBAC1D,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;oBACtE,MAAM,UAAU,GAAuB;wBACrC,GAAG,EAAE,YAAY;wBACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;wBAC/F,SAAS;wBACT,UAAU;qBACX,CAAC;oBAEF,OAAO,UAAU,CAAC;gBACpB,CAAC,CAAC,CAAC;gBAEH,cAAc,CAAC,eAAe,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { Action, ActionHistory, ActionProcessorResult, EitherActionResult } from '../../types';\nimport { actionResult, actionResultError, isErroredActionResult, resolveActionResult } from '../actionLogic';\nimport { isBatchAction } from '../actionValidators';\n\n// Rebuild the ActionProcessorResult a nested action would have produced on its own,\n// so a flattened entry only carries its own result and not every sibling's.\nfunction getNestedActionResult(nestedAction: Action<any>, nestedValue: any): ActionProcessorResult<any> {\n  // Batched actions flagged returnErrors come back wrapped as an EitherActionResult.\n  if (nestedAction.returnErrors) {\n    const either = nestedValue as EitherActionResult<any>;\n\n    if (either && either.success === false) {\n      return actionResultError(either.error.errorType, either.error.errorText, either.error.errorStack);\n    }\n\n    return actionResult(either?.result);\n  }\n\n  return actionResult(nestedValue);\n}\n\nexport function filterLogHistoryByActionTypes(history: ActionHistory<any>[], actionTypes: string[]): ActionHistory<any>[] {\n  const result: ActionHistory<any>[] = [];\n\n  function processHistory(histories: ActionHistory<any>[]) {\n    for (const entry of histories) {\n      const { act, startedAt, finishedAt, res } = entry;\n\n      if (isBatchAction(act)) {\n        // A successful batch result is an array with one value per nested action.\n        // Slice it up so each flattened entry gets its own result; if the batch\n        // itself errored there is nothing per-action, so keep the batch error.\n        const batchValues = !isErroredActionResult(res) ? resolveActionResult(res) : undefined;\n\n        // Create new ActionHistory entries for each nested action\n        const nestedHistories = act.payload.actions.map((nestedAction, index) => {\n          const newHistory: ActionHistory<any> = {\n            act: nestedAction,\n            res: Array.isArray(batchValues) ? getNestedActionResult(nestedAction, batchValues[index]) : res,\n            startedAt,\n            finishedAt,\n          };\n\n          return newHistory;\n        });\n\n        processHistory(nestedHistories);\n      } else if (actionTypes.length == 0 || actionTypes.includes(act.type)) {\n        result.push(entry);\n      }\n    }\n  }\n\n  processHistory(history);\n  return result;\n}\n"]}
+{"version":3,"file":"filterLogHistoryByActionTypes.js","sourceRoot":"","sources":["../../../../src/logic/logHistory/filterLogHistoryByActionTypes.ts"],"names":[],"mappings":";;AAqBA,sEAkCC;AAtDD,kDAA8G;AAC9G,0DAAoD;AAEpD,oFAAoF;AACpF,4EAA4E;AAC5E,SAAS,qBAAqB,CAAC,YAAyB,EAAE,WAAgB;IACxE,mFAAmF;IACnF,IAAI,YAAY,CAAC,YAAY,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,WAAsC,CAAC;QAEtD,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACvC,OAAO,IAAA,gCAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,IAAA,2BAAY,EAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAA,2BAAY,EAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAA6B,EAAE,WAAqB;IAChG,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,SAAS,cAAc,CAAC,SAA+B;QACrD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;YAElD,IAAI,IAAA,gCAAa,EAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,wEAAwE;gBACxE,uEAAuE;gBACvE,MAAM,WAAW,GAAG,CAAC,IAAA,oCAAqB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEvF,0DAA0D;gBAC1D,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;oBACtE,MAAM,UAAU,GAAuB;wBACrC,GAAG,EAAE,YAAY;wBACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;wBAC/F,SAAS;wBACT,UAAU;qBACX,CAAC;oBAEF,OAAO,UAAU,CAAC;gBACpB,CAAC,CAAC,CAAC;gBAEH,cAAc,CAAC,eAAe,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { Action, ActionHistory, ActionProcessorResult, EitherActionResult } from '../../types';\nimport { actionResult, actionResultError, isErroredActionResult, resolveActionResult } from '../actionResult';\nimport { isBatchAction } from '../actionValidators';\n\n// Rebuild the ActionProcessorResult a nested action would have produced on its own,\n// so a flattened entry only carries its own result and not every sibling's.\nfunction getNestedActionResult(nestedAction: Action<any>, nestedValue: any): ActionProcessorResult<any> {\n  // Batched actions flagged returnErrors come back wrapped as an EitherActionResult.\n  if (nestedAction.returnErrors) {\n    const either = nestedValue as EitherActionResult<any>;\n\n    if (either && either.success === false) {\n      return actionResultError(either.error.errorType, either.error.errorText, either.error.errorStack);\n    }\n\n    return actionResult(either?.result);\n  }\n\n  return actionResult(nestedValue);\n}\n\nexport function filterLogHistoryByActionTypes(history: ActionHistory<any>[], actionTypes: string[]): ActionHistory<any>[] {\n  const result: ActionHistory<any>[] = [];\n\n  function processHistory(histories: ActionHistory<any>[]) {\n    for (const entry of histories) {\n      const { act, startedAt, finishedAt, res } = entry;\n\n      if (isBatchAction(act)) {\n        // A successful batch result is an array with one value per nested action.\n        // Slice it up so each flattened entry gets its own result; if the batch\n        // itself errored there is nothing per-action, so keep the batch error.\n        const batchValues = !isErroredActionResult(res) ? resolveActionResult(res) : undefined;\n\n        // Create new ActionHistory entries for each nested action\n        const nestedHistories = act.payload.actions.map((nestedAction, index) => {\n          const newHistory: ActionHistory<any> = {\n            act: nestedAction,\n            res: Array.isArray(batchValues) ? getNestedActionResult(nestedAction, batchValues[index]) : res,\n            startedAt,\n            finishedAt,\n          };\n\n          return newHistory;\n        });\n\n        processHistory(nestedHistories);\n      } else if (actionTypes.length == 0 || actionTypes.includes(act.type)) {\n        result.push(entry);\n      }\n    }\n  }\n\n  processHistory(history);\n  return result;\n}\n"]}

package/lib/commonjs/logic/scope/context/askStorageScopeProvide.d.ts

@@ -0,0 +1 @@
+export declare const askStorageScopeProvide: <T extends import("../../..").AskResponse<any>>(scope: string, storyItter: T) => import("../../..").AskResponse<import("../../..").AskResponseReturnType<T>>;

package/lib/commonjs/logic/scope/context/askStorageScopeProvide.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askStorageScopeProvide = void 0;
+const createContextProvider_1 = require("../../context/createContextProvider");
+const storageScopeContext_1 = require("./storageScopeContext");
+exports.askStorageScopeProvide = (0, createContextProvider_1.createContextProvider)(storageScopeContext_1.storageScopeContext, (scope) => scope);
+//# sourceMappingURL=askStorageScopeProvide.js.map

package/lib/commonjs/logic/scope/context/askStorageScopeProvide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askStorageScopeProvide.js","sourceRoot":"","sources":["../../../../../src/logic/scope/context/askStorageScopeProvide.ts"],"names":[],"mappings":";;;AAAA,+EAA4E;AAC5E,+DAA4D;AAE/C,QAAA,sBAAsB,GAAG,IAAA,6CAAqB,EAAC,yCAAmB,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import { createContextProvider } from '../../context/createContextProvider';\nimport { storageScopeContext } from './storageScopeContext';\n\nexport const askStorageScopeProvide = createContextProvider(storageScopeContext, (scope: string) => scope);\n"]}

package/lib/commonjs/logic/scope/context/askStorageScopeRead.d.ts

@@ -0,0 +1 @@
+export declare const askStorageScopeRead: () => import("../../..").AskResponse<import("../../..").Nullable<string>>;

package/lib/commonjs/logic/scope/context/askStorageScopeRead.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askStorageScopeRead = void 0;
+const createContextReader_1 = require("../../context/createContextReader");
+const storageScopeContext_1 = require("./storageScopeContext");
+exports.askStorageScopeRead = (0, createContextReader_1.createContextReader)(storageScopeContext_1.storageScopeContext);
+//# sourceMappingURL=askStorageScopeRead.js.map

package/lib/commonjs/logic/scope/context/askStorageScopeRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askStorageScopeRead.js","sourceRoot":"","sources":["../../../../../src/logic/scope/context/askStorageScopeRead.ts"],"names":[],"mappings":";;;AAAA,2EAAwE;AACxE,+DAA4D;AAE/C,QAAA,mBAAmB,GAAG,IAAA,yCAAmB,EAAC,yCAAmB,CAAC,CAAC","sourcesContent":["import { createContextReader } from '../../context/createContextReader';\nimport { storageScopeContext } from './storageScopeContext';\n\nexport const askStorageScopeRead = createContextReader(storageScopeContext);\n"]}

package/lib/commonjs/logic/scope/context/index.d.ts

@@ -0,0 +1,3 @@
+export * from './askStorageScopeProvide';
+export * from './askStorageScopeRead';
+export * from './storageScopeContext';

package/lib/commonjs/logic/scope/context/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("./askStorageScopeProvide"), exports);
+__exportStar(require("./askStorageScopeRead"), exports);
+__exportStar(require("./storageScopeContext"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/logic/scope/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logic/scope/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,wDAAsC;AACtC,wDAAsC","sourcesContent":["export * from './askStorageScopeProvide';\nexport * from './askStorageScopeRead';\nexport * from './storageScopeContext';\n"]}

package/lib/commonjs/logic/scope/context/storageScopeContext.d.ts

@@ -0,0 +1,2 @@
+import { Nullable } from '../../../types/Nullable';
+export declare const storageScopeContext: import("../../..").QpqContextIdentifier<Nullable<string>>;

package/lib/commonjs/logic/scope/context/storageScopeContext.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storageScopeContext = void 0;
+const createContextIdentifier_1 = require("../../context/createContextIdentifier");
+// The ambient storage scope: THE value scope-aware data layers (e.g. the
+// eventDoc feature) forward as the File/KVS `scope` option. Null = unscoped.
+//
+// Deliberately NON-local: the scope rides the serialized session context across
+// queue/service boundaries, so async work spawned inside a scoped request (a
+// render job, an AI edit) reads and writes the same partition as the request
+// that started it.
+exports.storageScopeContext = (0, createContextIdentifier_1.createContextIdentifier)('qpq-storage-scope', null);
+//# sourceMappingURL=storageScopeContext.js.map

package/lib/commonjs/logic/scope/context/storageScopeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageScopeContext.js","sourceRoot":"","sources":["../../../../../src/logic/scope/context/storageScopeContext.ts"],"names":[],"mappings":";;;AACA,mFAAgF;AAEhF,yEAAyE;AACzE,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AACN,QAAA,mBAAmB,GAAG,IAAA,iDAAuB,EAAmB,mBAAmB,EAAE,IAAI,CAAC,CAAC","sourcesContent":["import { Nullable } from '../../../types/Nullable';\nimport { createContextIdentifier } from '../../context/createContextIdentifier';\n\n// The ambient storage scope: THE value scope-aware data layers (e.g. the\n// eventDoc feature) forward as the File/KVS `scope` option. Null = unscoped.\n//\n// Deliberately NON-local: the scope rides the serialized session context across\n// queue/service boundaries, so async work spawned inside a scoped request (a\n// render job, an AI edit) reads and writes the same partition as the request\n// that started it.\nexport const storageScopeContext = createContextIdentifier<Nullable<string>>('qpq-storage-scope', null);\n"]}

package/lib/commonjs/logic/scope/index.d.ts

@@ -1,10 +1,10 @@
 export * from './composeScopedFilePath';
+export * from './context';
 export * from './fileScopeGate';
 export * from './InvalidScopeError';
 export * from './kvsScopeGate';
 export * from './kvsScopeRules';
 export * from './KvsStoreNotFoundError';
 export * from './splitScopedFilePath';
-export * from './storageScopeContext';
 export * from './stripScopedFilePath';
 export * from './validateScopeSegment';