@qpqjs/core 0.3.0 → 0.5.0

package/lib/esm/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/esm/logic/config/getForeignItems.js

@@ -0,0 +1,7 @@
+import { getOwnedItems } from './getOwnedItems';
+/** The settings another service owns (declared here with a cross-module owner): the inverse of getOwnedItems. */
+export const getForeignItems = (settings, qpqConfig) => {
+    const owned = getOwnedItems(settings, qpqConfig);
+    return settings.filter((setting) => !owned.includes(setting));
+};
+//# sourceMappingURL=getForeignItems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getForeignItems.js","sourceRoot":"","sources":["../../../../src/logic/config/getForeignItems.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,iHAAiH;AACjH,MAAM,CAAC,MAAM,eAAe,GAAG,CAA6B,QAAa,EAAE,SAAoB,EAAO,EAAE;IACtG,MAAM,KAAK,GAAG,aAAa,CAAC,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","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/esm/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/esm/logic/config/getOwnedItems.js

@@ -0,0 +1,18 @@
+import { getApplicationModuleEnvironment } from './getApplicationModuleEnvironment';
+import { getApplicationModuleFeature } from './getApplicationModuleFeature';
+import { getApplicationModuleName } from './getApplicationModuleName';
+import { getApplicationName } from './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).
+export const getOwnedItems = (settings, qpqConfig) => {
+    const appModuleName = getApplicationModuleName(qpqConfig);
+    const appName = getApplicationName(qpqConfig);
+    const appFeature = getApplicationModuleFeature(qpqConfig);
+    const appEnvironment = 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)));
+};
+//# sourceMappingURL=getOwnedItems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnedItems.js","sourceRoot":"","sources":["../../../../src/logic/config/getOwnedItems.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,gGAAgG;AAChG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,CAA6B,QAAa,EAAE,SAAoB,EAAO,EAAE;IACpG,MAAM,aAAa,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,+BAA+B,CAAC,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","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/esm/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/esm/logic/config/index.js

@@ -0,0 +1,14 @@
+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';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC","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/esm/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/esm/logic/config/resolveOwnedResourceLocalName.js

@@ -0,0 +1,4 @@
+// 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.
+export const resolveOwnedResourceLocalName = (resourceName, owner) => owner?.resourceNameOverride || resourceName;
+//# sourceMappingURL=resolveOwnedResourceLocalName.js.map

package/lib/esm/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;AAClD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,YAAoB,EAAE,KAAwB,EAAU,EAAE,CAAC,KAAK,EAAE,oBAAoB,IAAI,YAAY,CAAC","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/esm/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/esm/logic/config/resolveOwnerDeploymentContext.js

@@ -0,0 +1,14 @@
+import { getApplicationModuleEnvironment } from './getApplicationModuleEnvironment';
+import { getApplicationModuleFeature } from './getApplicationModuleFeature';
+import { getApplicationModuleName } from './getApplicationModuleName';
+import { getApplicationName } from './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.
+export const resolveOwnerDeploymentContext = (qpqConfig, owner) => ({
+    application: owner?.application || getApplicationName(qpqConfig),
+    module: owner?.module || getApplicationModuleName(qpqConfig),
+    environment: owner?.environment || getApplicationModuleEnvironment(qpqConfig),
+    feature: owner?.feature || getApplicationModuleFeature(qpqConfig),
+});
+//# sourceMappingURL=resolveOwnerDeploymentContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOwnerDeploymentContext.js","sourceRoot":"","sources":["../../../../src/logic/config/resolveOwnerDeploymentContext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,4FAA4F;AAC5F,2FAA2F;AAC3F,uFAAuF;AACvF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,SAAoB,EAAE,KAAwB,EAA0B,EAAE,CAAC,CAAC;IACxH,WAAW,EAAE,KAAK,EAAE,WAAW,IAAI,kBAAkB,CAAC,SAAS,CAAC;IAChE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC;IAC5D,WAAW,EAAE,KAAK,EAAE,WAAW,IAAI,+BAA+B,CAAC,SAAS,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,2BAA2B,CAAC,SAAS,CAAC;CAClE,CAAC,CAAC","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/esm/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/esm/logic/context/createContextReaderOrThrow.js

@@ -0,0 +1,18 @@
+import { askContextRead } from '../../actions/context/askContextRead';
+import { askThrowError } from '../../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.
+ */
+export function createContextReaderOrThrow(contextIdentifier, errorType, message) {
+    return function* askContextReadOrThrowWrapper() {
+        const value = yield* askContextRead(contextIdentifier);
+        if (value === undefined || value === null) {
+            return yield* askThrowError(errorType, message);
+        }
+        return value;
+    };
+}
+//# sourceMappingURL=createContextReaderOrThrow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createContextReaderOrThrow.js","sourceRoot":"","sources":["../../../../src/logic/context/createContextReaderOrThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAI,iBAA0C,EAAE,SAAgC,EAAE,OAAe;IACzI,OAAO,QAAQ,CAAC,CAAC,4BAA4B;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAEvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,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/esm/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/esm/logic/context/index.js

@@ -1,6 +1,7 @@
 export * from './createContextIdentifier';
 export * from './createContextProvider';
 export * from './createContextReader';
+export * from './createContextReaderOrThrow';
 export * from './createLocalContextIdentifier';
 export * from './toCrossServiceSession';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC","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,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC","sourcesContent":["export * from './createContextIdentifier';\nexport * from './createContextProvider';\nexport * from './createContextReader';\nexport * from './createContextReaderOrThrow';\nexport * from './createLocalContextIdentifier';\nexport * from './toCrossServiceSession';\n"]}

package/lib/esm/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/esm/logic/graphDatabase/GraphResultConverters.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphResultConverters.js.map

package/lib/esm/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/esm/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/esm/logic/graphDatabase/createAnyGraphResultConverter.js

@@ -0,0 +1,23 @@
+import { askThrowError } from '../../actions/error/askThrowError';
+import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';
+import { isGraphScalarResult } from './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.
+ */
+export function createAnyGraphResultConverter(converters) {
+    return function* askConvertAnyResultToAnyGraphResult(result) {
+        if (isGraphScalarResult(result)) {
+            return result;
+        }
+        if (converters.isNode(result)) {
+            return yield* converters.askConvertNode(result);
+        }
+        if (converters.isRelationship(result)) {
+            return yield* converters.askConvertRelationship(result);
+        }
+        return yield* askThrowError(ErrorTypeEnum.GenericError, `Unable to convert ${converters.vendor} query result`);
+    };
+}
+//# sourceMappingURL=createAnyGraphResultConverter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createAnyGraphResultConverter.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/createAnyGraphResultConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAgE;IAEhE,OAAO,QAAQ,CAAC,CAAC,mCAAmC,CAAC,MAAe;QAClE,IAAI,mBAAmB,CAAC,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,aAAa,CAAC,aAAa,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/esm/logic/graphDatabase/index.d.ts

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

package/lib/esm/logic/graphDatabase/index.js

@@ -0,0 +1,4 @@
+export * from './createAnyGraphResultConverter';
+export * from './GraphResultConverters';
+export * from './isGraphScalarResult';
+//# sourceMappingURL=index.js.map

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

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

package/lib/esm/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/esm/logic/graphDatabase/isGraphScalarResult.js

@@ -0,0 +1,3 @@
+/** A cell that is a plain value rather than a node or relationship entity; the same test for every graph vendor. */
+export const isGraphScalarResult = (value) => typeof value !== 'object' || value === null;
+//# sourceMappingURL=isGraphScalarResult.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isGraphScalarResult.js","sourceRoot":"","sources":["../../../../src/logic/graphDatabase/isGraphScalarResult.ts"],"names":[],"mappings":"AAEA,oHAAoH;AACpH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC","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/esm/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/esm/logic/index.js

@@ -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,5 +13,4 @@ export * from './qpqPackage';
 export * from './scope';
 export * from './stateEffects';
 export * from './stream';
-export * from './transientErrorNames';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logic/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC","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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC","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/esm/logic/logHistory/filterLogHistoryByActionTypes.js

@@ -1,4 +1,4 @@
-import { actionResult, actionResultError, isErroredActionResult, resolveActionResult } from '../actionLogic';
+import { actionResult, actionResultError, isErroredActionResult, resolveActionResult } from '../actionResult';
 import { isBatchAction } from '../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.

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

@@ -1 +1 @@
-{"version":3,"file":"filterLogHistoryByActionTypes.js","sourceRoot":"","sources":["../../../../src/logic/logHistory/filterLogHistoryByActionTypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;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,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,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,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,wEAAwE;gBACxE,uEAAuE;gBACvE,MAAM,WAAW,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,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":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;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,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,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,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,wEAAwE;gBACxE,uEAAuE;gBACvE,MAAM,WAAW,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,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/esm/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/esm/logic/scope/context/askStorageScopeProvide.js

@@ -0,0 +1,4 @@
+import { createContextProvider } from '../../context/createContextProvider';
+import { storageScopeContext } from './storageScopeContext';
+export const askStorageScopeProvide = createContextProvider(storageScopeContext, (scope) => scope);
+//# sourceMappingURL=askStorageScopeProvide.js.map

package/lib/esm/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,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,mBAAmB,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/esm/logic/scope/context/askStorageScopeRead.d.ts

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

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

@@ -0,0 +1,4 @@
+import { createContextReader } from '../../context/createContextReader';
+import { storageScopeContext } from './storageScopeContext';
+export const askStorageScopeRead = createContextReader(storageScopeContext);
+//# sourceMappingURL=askStorageScopeRead.js.map

package/lib/esm/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,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,CAAC","sourcesContent":["import { createContextReader } from '../../context/createContextReader';\nimport { storageScopeContext } from './storageScopeContext';\n\nexport const askStorageScopeRead = createContextReader(storageScopeContext);\n"]}

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

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

package/lib/esm/logic/scope/context/index.js

@@ -0,0 +1,4 @@
+export * from './askStorageScopeProvide';
+export * from './askStorageScopeRead';
+export * from './storageScopeContext';
+//# sourceMappingURL=index.js.map

package/lib/esm/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,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from './askStorageScopeProvide';\nexport * from './askStorageScopeRead';\nexport * from './storageScopeContext';\n"]}

package/lib/esm/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/esm/logic/scope/context/storageScopeContext.js

@@ -0,0 +1,10 @@
+import { createContextIdentifier } from '../../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.
+export const storageScopeContext = createContextIdentifier('qpq-storage-scope', null);
+//# sourceMappingURL=storageScopeContext.js.map

package/lib/esm/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,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,yEAAyE;AACzE,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AACnB,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAmB,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/esm/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';

package/lib/esm/logic/scope/index.js

@@ -1,11 +1,11 @@
 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';
 //# sourceMappingURL=index.js.map

package/lib/esm/logic/scope/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './composeScopedFilePath';\nexport * from './fileScopeGate';\nexport * from './InvalidScopeError';\nexport * from './kvsScopeGate';\nexport * from './kvsScopeRules';\nexport * from './KvsStoreNotFoundError';\nexport * from './splitScopedFilePath';\nexport * from './storageScopeContext';\nexport * from './stripScopedFilePath';\nexport * from './validateScopeSegment';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './composeScopedFilePath';\nexport * from './context';\nexport * from './fileScopeGate';\nexport * from './InvalidScopeError';\nexport * from './kvsScopeGate';\nexport * from './kvsScopeRules';\nexport * from './KvsStoreNotFoundError';\nexport * from './splitScopedFilePath';\nexport * from './stripScopedFilePath';\nexport * from './validateScopeSegment';\n"]}

package/lib/esm/logic/scope/kvsScopeGate.js

@@ -9,7 +9,7 @@ import { validateScopeSegment } from './validateScopeSegment';
 // in kvsScopeRules, so backends can never drift apart on validation.
 // Store lookup with the typed misconfiguration error (never a bare throw).
 export const resolveKvsStoreConfigOrThrow = (qpqConfig, keyValueStoreName) => {
-    const storeConfig = getKeyValueStoreByName(qpqConfig, keyValueStoreName);
+    const storeConfig = getKeyValueStoreByName(keyValueStoreName, qpqConfig);
     if (!storeConfig) {
         throw new KvsStoreNotFoundError(keyValueStoreName);
     }

package/lib/esm/logic/scope/kvsScopeGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"kvsScopeGate.js","sourceRoot":"","sources":["../../../../src/logic/scope/kvsScopeGate.ts"],"names":[],"mappings":"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","sourcesContent":["import { KvsCoreDataType, KvsQueryOperation, KvsUpdate } from '../../actions/keyValueStore/types';\nimport { KeyValueStoreQPQConfigSetting, QPQConfig } from '../../config';\nimport { getKeyValueStoreByName } from '../../qpqCoreUtils';\nimport { InvalidScopeError, InvalidScopeErrorCode } from './InvalidScopeError';\nimport {\n  validateKvsItemForScopeOrThrow,\n  validateKvsKeyConditionForScopeOrThrow,\n  validateKvsPkValueForScopeOrThrow,\n  validateKvsUpdatesForScopeOrThrow,\n  validateScopeSupportedForPartitionKeyType,\n} from './kvsScopeRules';\nimport { KvsStoreNotFoundError } from './KvsStoreNotFoundError';\nimport { validateScopeSegment } from './validateScopeSegment';\n\n// THE shared scope gate for every kvs backend (dynamo, dev-server sqlite, ...):\n// resolve the store's config and validate the call's scope against it. How a\n// backend stores the scope is its own business; the rules they all enforce are\n// in kvsScopeRules, so backends can never drift apart on validation.\n\n// Store lookup with the typed misconfiguration error (never a bare throw).\nexport const resolveKvsStoreConfigOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string): KeyValueStoreQPQConfigSetting => {\n  const storeConfig = getKeyValueStoreByName(qpqConfig, keyValueStoreName);\n  if (!storeConfig) {\n    throw new KvsStoreNotFoundError(keyValueStoreName);\n  }\n\n  return storeConfig;\n};\n\n// Every backend calls this on every call, scoped or not: the store's `scoped`\n// flag and the call's scope must agree, so a scoped store can never be reached\n// without one and an unscoped store never gains a hidden partition.\n// Scan-all-scopes is the one deliberate exception and does not go through here.\nexport const assertKvsScopeRequirementOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string, scope: string | undefined): void => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n  if (storeConfig.scoped && scope === undefined) {\n    throw new InvalidScopeError(\n      InvalidScopeErrorCode.scopeRequired,\n      `Key value store '${keyValueStoreName}' is scoped; every call must carry a scope.`,\n    );\n  }\n\n  if (!storeConfig.scoped && scope !== undefined) {\n    throw new InvalidScopeError(\n      InvalidScopeErrorCode.notScoped,\n      `Key value store '${keyValueStoreName}' is not scoped; declare it scoped or drop the scope.`,\n    );\n  }\n};\n\n/**\n * Store lookup plus every store-level scope rule: the call's scope matches the\n * store's `scoped` flag, and a scope is a valid segment on a string-pk store.\n * Backends call it once per request before touching data.\n */\nexport const resolveScopedKvsStoreOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n): KeyValueStoreQPQConfigSetting => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n  assertKvsScopeRequirementOrThrow(qpqConfig, keyValueStoreName, scope);\n\n  if (scope !== undefined) {\n    validateScopeSegment(scope);\n    validateScopeSupportedForPartitionKeyType(storeConfig.partitionKey.type);\n  }\n\n  return storeConfig;\n};\n\n// Row-partitioned backends (dev-server sqlite): the scope is a column, so the\n// same validations apply, but all the backend needs back is the real partition\n// key attribute name.\nexport const resolveScopedPkAttributeOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string, scope: string): string => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n  validateScopeSegment(scope);\n  validateScopeSupportedForPartitionKeyType(storeConfig.partitionKey.type);\n\n  return storeConfig.partitionKey.key;\n};\n\n// Request-level checks for backends that keep the scope out of stored values\n// (dev-server sqlite stores keys and items raw; the scope just picks the rows).\n// They run the same rules a composing backend runs, so a call that fails\n// deployed fails locally too.\n\nexport const validateScopedKvsKeyOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  key: KvsCoreDataType,\n): void => {\n  validateKvsPkValueForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, key);\n};\n\nexport const validateScopedKvsItemOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  item: Record<string, any>,\n): void => {\n  validateKvsItemForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, item ?? {});\n};\n\nexport const validateScopedKvsUpdatesOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  updates: KvsUpdate,\n): void => {\n  validateKvsUpdatesForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, updates);\n};\n\nexport const validateScopedKvsKeyConditionOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  keyCondition: KvsQueryOperation,\n): void => {\n  validateKvsKeyConditionForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, keyCondition);\n};\n"]}
+{"version":3,"file":"kvsScopeGate.js","sourceRoot":"","sources":["../../../../src/logic/scope/kvsScopeGate.ts"],"names":[],"mappings":"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","sourcesContent":["import { KvsCoreDataType, KvsQueryOperation, KvsUpdate } from '../../actions/keyValueStore/types';\nimport { KeyValueStoreQPQConfigSetting, QPQConfig } from '../../config';\nimport { getKeyValueStoreByName } from '../../qpqCoreUtils';\nimport { InvalidScopeError, InvalidScopeErrorCode } from './InvalidScopeError';\nimport {\n  validateKvsItemForScopeOrThrow,\n  validateKvsKeyConditionForScopeOrThrow,\n  validateKvsPkValueForScopeOrThrow,\n  validateKvsUpdatesForScopeOrThrow,\n  validateScopeSupportedForPartitionKeyType,\n} from './kvsScopeRules';\nimport { KvsStoreNotFoundError } from './KvsStoreNotFoundError';\nimport { validateScopeSegment } from './validateScopeSegment';\n\n// THE shared scope gate for every kvs backend (dynamo, dev-server sqlite, ...):\n// resolve the store's config and validate the call's scope against it. How a\n// backend stores the scope is its own business; the rules they all enforce are\n// in kvsScopeRules, so backends can never drift apart on validation.\n\n// Store lookup with the typed misconfiguration error (never a bare throw).\nexport const resolveKvsStoreConfigOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string): KeyValueStoreQPQConfigSetting => {\n  const storeConfig = getKeyValueStoreByName(keyValueStoreName, qpqConfig);\n  if (!storeConfig) {\n    throw new KvsStoreNotFoundError(keyValueStoreName);\n  }\n\n  return storeConfig;\n};\n\n// Every backend calls this on every call, scoped or not: the store's `scoped`\n// flag and the call's scope must agree, so a scoped store can never be reached\n// without one and an unscoped store never gains a hidden partition.\n// Scan-all-scopes is the one deliberate exception and does not go through here.\nexport const assertKvsScopeRequirementOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string, scope: string | undefined): void => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n  if (storeConfig.scoped && scope === undefined) {\n    throw new InvalidScopeError(\n      InvalidScopeErrorCode.scopeRequired,\n      `Key value store '${keyValueStoreName}' is scoped; every call must carry a scope.`,\n    );\n  }\n\n  if (!storeConfig.scoped && scope !== undefined) {\n    throw new InvalidScopeError(\n      InvalidScopeErrorCode.notScoped,\n      `Key value store '${keyValueStoreName}' is not scoped; declare it scoped or drop the scope.`,\n    );\n  }\n};\n\n/**\n * Store lookup plus every store-level scope rule: the call's scope matches the\n * store's `scoped` flag, and a scope is a valid segment on a string-pk store.\n * Backends call it once per request before touching data.\n */\nexport const resolveScopedKvsStoreOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n): KeyValueStoreQPQConfigSetting => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n  assertKvsScopeRequirementOrThrow(qpqConfig, keyValueStoreName, scope);\n\n  if (scope !== undefined) {\n    validateScopeSegment(scope);\n    validateScopeSupportedForPartitionKeyType(storeConfig.partitionKey.type);\n  }\n\n  return storeConfig;\n};\n\n// Row-partitioned backends (dev-server sqlite): the scope is a column, so the\n// same validations apply, but all the backend needs back is the real partition\n// key attribute name.\nexport const resolveScopedPkAttributeOrThrow = (qpqConfig: QPQConfig, keyValueStoreName: string, scope: string): string => {\n  const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n  validateScopeSegment(scope);\n  validateScopeSupportedForPartitionKeyType(storeConfig.partitionKey.type);\n\n  return storeConfig.partitionKey.key;\n};\n\n// Request-level checks for backends that keep the scope out of stored values\n// (dev-server sqlite stores keys and items raw; the scope just picks the rows).\n// They run the same rules a composing backend runs, so a call that fails\n// deployed fails locally too.\n\nexport const validateScopedKvsKeyOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  key: KvsCoreDataType,\n): void => {\n  validateKvsPkValueForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, key);\n};\n\nexport const validateScopedKvsItemOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  item: Record<string, any>,\n): void => {\n  validateKvsItemForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, item ?? {});\n};\n\nexport const validateScopedKvsUpdatesOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  updates: KvsUpdate,\n): void => {\n  validateKvsUpdatesForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, updates);\n};\n\nexport const validateScopedKvsKeyConditionOrThrow = (\n  qpqConfig: QPQConfig,\n  keyValueStoreName: string,\n  scope: string | undefined,\n  keyCondition: KvsQueryOperation,\n): void => {\n  validateKvsKeyConditionForScopeOrThrow(resolveScopedKvsStoreOrThrow(qpqConfig, keyValueStoreName, scope), scope, keyCondition);\n};\n"]}

package/lib/esm/logic/stream/createStreamRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStreamRegistry.js","sourceRoot":"","sources":["../../../../src/logic/stream/createStreamRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import { StreamChunk, StreamRegistry } from '../../types/StreamRegistry';\n\ninterface StreamEntry {\n  iterator: AsyncIterableIterator<string>;\n  nextPromise: Promise<IteratorResult<string>>;\n  settled: boolean;\n  settledResult?: IteratorResult<string>;\n  settledError?: unknown;\n}\n\nexport const createStreamRegistry = (): StreamRegistry => {\n  const streams = new Map<string, StreamEntry>();\n\n  // Pull the next value and remember when it settles, so noWait can tell synchronously\n  // whether a chunk is ready without racing an already-resolved sentinel (which would\n  // always win and make noWait report \"skipped\" forever).\n  const advance = (entry: StreamEntry): void => {\n    const next = entry.iterator.next();\n    entry.nextPromise = next;\n    entry.settled = false;\n    entry.settledResult = undefined;\n    entry.settledError = undefined;\n\n    // Track fulfilment for noWait reads.\n    const rememberResult = (result: IteratorResult<string>): void => {\n      if (entry.nextPromise === next) {\n        entry.settled = true;\n        entry.settledResult = result;\n      }\n    };\n\n    // Track rejection too: without this a failing iterator leaves an unhandled\n    // rejection and noWait reads would report \"skipped\" forever.\n    const rememberError = (error: unknown): void => {\n      if (entry.nextPromise === next) {\n        entry.settled = true;\n        entry.settledError = error;\n      }\n    };\n\n    next.then(rememberResult, rememberError);\n  };\n\n  return {\n    register(id: string, iterator: AsyncIterableIterator<string>): void {\n      if (streams.has(id)) {\n        throw new Error(`Stream already registered: ${id}`);\n      }\n\n      const entry: StreamEntry = { iterator, nextPromise: Promise.resolve() as any, settled: false };\n      streams.set(id, entry);\n      advance(entry);\n    },\n\n    async read(id: string, noWait?: boolean): Promise<StreamChunk<string>> {\n      const entry = streams.get(id);\n      if (!entry) {\n        throw new Error(`Stream not found: ${id}`);\n      }\n\n      if (noWait) {\n        // Give an already-resolvable promise a microtask to flip the settled flag.\n        await Promise.resolve();\n\n        if (!entry.settled) {\n          return { done: false, skipped: true };\n        }\n\n        // A settled entry with no result means the iterator rejected.\n        if (!entry.settledResult) {\n          streams.delete(id);\n          throw entry.settledError;\n        }\n\n        const iterResult = entry.settledResult;\n        if (iterResult.done) {\n          streams.delete(id);\n          return { done: true };\n        }\n\n        advance(entry);\n        return { done: false, data: iterResult.value };\n      }\n\n      let iterResult: IteratorResult<string>;\n      try {\n        iterResult = await entry.nextPromise;\n      } catch (error) {\n        // A failed stream cannot yield anything more, drop it so callers do not\n        // keep re-reading a dead entry.\n        streams.delete(id);\n        throw error;\n      }\n\n      if (iterResult.done) {\n        streams.delete(id);\n        return { done: true };\n      }\n\n      advance(entry);\n      return { done: false, data: iterResult.value };\n    },\n\n    close(id: string): void {\n      const entry = streams.get(id);\n      if (entry) {\n        // Swallow cleanup failures so close never surfaces as an unhandled rejection.\n        entry.iterator.return?.()?.catch(() => {});\n        streams.delete(id);\n      }\n    },\n\n    has(id: string): boolean {\n      return streams.has(id);\n    },\n  };\n};\n"]}
+{"version":3,"file":"createStreamRegistry.js","sourceRoot":"","sources":["../../../../src/logic/stream/createStreamRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import { StreamChunk, StreamRegistry } from '../../types/StreamRegistry';\n\ntype StreamEntry = {\n  iterator: AsyncIterableIterator<string>;\n  nextPromise: Promise<IteratorResult<string>>;\n  settled: boolean;\n  settledResult?: IteratorResult<string>;\n  settledError?: unknown;\n};\n\nexport const createStreamRegistry = (): StreamRegistry => {\n  const streams = new Map<string, StreamEntry>();\n\n  // Pull the next value and remember when it settles, so noWait can tell synchronously\n  // whether a chunk is ready without racing an already-resolved sentinel (which would\n  // always win and make noWait report \"skipped\" forever).\n  const advance = (entry: StreamEntry): void => {\n    const next = entry.iterator.next();\n    entry.nextPromise = next;\n    entry.settled = false;\n    entry.settledResult = undefined;\n    entry.settledError = undefined;\n\n    // Track fulfilment for noWait reads.\n    const rememberResult = (result: IteratorResult<string>): void => {\n      if (entry.nextPromise === next) {\n        entry.settled = true;\n        entry.settledResult = result;\n      }\n    };\n\n    // Track rejection too: without this a failing iterator leaves an unhandled\n    // rejection and noWait reads would report \"skipped\" forever.\n    const rememberError = (error: unknown): void => {\n      if (entry.nextPromise === next) {\n        entry.settled = true;\n        entry.settledError = error;\n      }\n    };\n\n    next.then(rememberResult, rememberError);\n  };\n\n  return {\n    register(id: string, iterator: AsyncIterableIterator<string>): void {\n      if (streams.has(id)) {\n        throw new Error(`Stream already registered: ${id}`);\n      }\n\n      const entry: StreamEntry = { iterator, nextPromise: Promise.resolve() as any, settled: false };\n      streams.set(id, entry);\n      advance(entry);\n    },\n\n    async read(id: string, noWait?: boolean): Promise<StreamChunk<string>> {\n      const entry = streams.get(id);\n      if (!entry) {\n        throw new Error(`Stream not found: ${id}`);\n      }\n\n      if (noWait) {\n        // Give an already-resolvable promise a microtask to flip the settled flag.\n        await Promise.resolve();\n\n        if (!entry.settled) {\n          return { done: false, skipped: true };\n        }\n\n        // A settled entry with no result means the iterator rejected.\n        if (!entry.settledResult) {\n          streams.delete(id);\n          throw entry.settledError;\n        }\n\n        const iterResult = entry.settledResult;\n        if (iterResult.done) {\n          streams.delete(id);\n          return { done: true };\n        }\n\n        advance(entry);\n        return { done: false, data: iterResult.value };\n      }\n\n      let iterResult: IteratorResult<string>;\n      try {\n        iterResult = await entry.nextPromise;\n      } catch (error) {\n        // A failed stream cannot yield anything more, drop it so callers do not\n        // keep re-reading a dead entry.\n        streams.delete(id);\n        throw error;\n      }\n\n      if (iterResult.done) {\n        streams.delete(id);\n        return { done: true };\n      }\n\n      advance(entry);\n      return { done: false, data: iterResult.value };\n    },\n\n    close(id: string): void {\n      const entry = streams.get(id);\n      if (entry) {\n        // Swallow cleanup failures so close never surfaces as an unhandled rejection.\n        entry.iterator.return?.()?.catch(() => {});\n        streams.delete(id);\n      }\n    },\n\n    has(id: string): boolean {\n      return streams.has(id);\n    },\n  };\n};\n"]}

package/lib/esm/promiseify/getSystemExecuteStoryActionProcessor.d.ts

@@ -0,0 +1,12 @@
+import { ActionProcessor, AskResponse, AskResponseReturnType, QPQError, Story } from '../types';
+export declare class QpqPromisifyActionError extends Error {
+    readonly actionError: QPQError;
+    readonly code = "qpqPromisifyActionError";
+    constructor(actionError: QPQError);
+}
+type QpqPromisifyRuntime = Parameters<ActionProcessor<any, any>>;
+export type QpqResolveAsPromise = <T extends AskResponse<any>>(storyRuntime: T) => Promise<AskResponseReturnType<T>>;
+export declare function qpqPromisify<S extends Story<any, any>>(story: S, runtimeInfo: QpqPromisifyRuntime): (...params: Parameters<S>) => Promise<AskResponseReturnType<ReturnType<S>>>;
+export declare const getRun: (qpqPromisifyRuntime: QpqPromisifyRuntime) => QpqResolveAsPromise;
+export declare const getSystemExecuteStoryActionProcessor: import("../types").ActionProcessorListResolver;
+export {};