@qpqjs/core 0.3.0 → 0.5.0

package/lib/esm/actions/graphDatabase/askGraphDatabaseInternalFieldNames.js.map

@@ -1 +1 @@
-{"version":3,"file":"askGraphDatabaseInternalFieldNames.js","sourceRoot":"","sources":["../../../../src/actions/graphDatabase/askGraphDatabaseInternalFieldNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAUpE,MAAM,CAAC,MAAM,kCAAkC,GAAG,qBAAqB,EAAmC,CAAC;IACzG,UAAU,EAAE,uBAAuB,CAAC,kBAAkB;CACvD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { GraphDatabaseActionType } from './GraphDatabaseActionType';\n\nexport type GraphDatabaseInternalFieldNames = {\n  internalId: string;\n  internalLabel: string;\n  internalType: string;\n  internalStartNode: string;\n  internalEndNode: string;\n};\n\nexport const askGraphDatabaseInternalFieldNames = createActionRequester<GraphDatabaseInternalFieldNames>()({\n  actionType: GraphDatabaseActionType.InternalFieldNames,\n});\n"]}
+{"version":3,"file":"askGraphDatabaseInternalFieldNames.js","sourceRoot":"","sources":["../../../../src/actions/graphDatabase/askGraphDatabaseInternalFieldNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAUpE,MAAM,CAAC,MAAM,kCAAkC,GAAG,qBAAqB,EAAmC,CAAC;IACzG,UAAU,EAAE,uBAAuB,CAAC,kBAAkB;CACvD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { GraphDatabaseActionType } from './GraphDatabaseActionType';\n\nexport type GraphDatabaseInternalFieldNames = {\n  internalId: string;\n  internalLabel: string;\n  internalType: string;\n  internalStartNode: string;\n  internalEndNode: string;\n};\n\nexport const askGraphDatabaseInternalFieldNames = createActionRequester<GraphDatabaseInternalFieldNames>()({\n  actionType: GraphDatabaseActionType.InternalFieldNames,\n});\n"]}

package/lib/esm/actions/guid/askGuidNew.d.ts

@@ -0,0 +1,2 @@
+import { GuidActionType } from './GuidActionType';
+export declare const askGuidNew: import("../..").ActionRequesterFunction<GuidActionType.New, [], undefined, string, never>;

package/lib/esm/actions/guid/askGuidNew.js

@@ -0,0 +1,6 @@
+import { createActionRequester } from '../../logic/actions';
+import { GuidActionType } from './GuidActionType';
+export const askGuidNew = createActionRequester()({
+    actionType: GuidActionType.New,
+});
+//# sourceMappingURL=askGuidNew.js.map

package/lib/esm/actions/guid/askGuidNew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askGuidNew.js","sourceRoot":"","sources":["../../../../src/actions/guid/askGuidNew.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,MAAM,UAAU,GAAG,qBAAqB,EAAU,CAAC;IACxD,UAAU,EAAE,cAAc,CAAC,GAAG;CAC/B,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { GuidActionType } from './GuidActionType';\n\nexport const askGuidNew = createActionRequester<string>()({\n  actionType: GuidActionType.New,\n});\n"]}

package/lib/esm/actions/guid/askGuidNewSortable.d.ts

@@ -0,0 +1,2 @@
+import { GuidActionType } from './GuidActionType';
+export declare const askGuidNewSortable: import("../..").ActionRequesterFunction<GuidActionType.NewSortable, [], undefined, string, never>;

package/lib/esm/actions/guid/askGuidNewSortable.js

@@ -0,0 +1,6 @@
+import { createActionRequester } from '../../logic/actions';
+import { GuidActionType } from './GuidActionType';
+export const askGuidNewSortable = createActionRequester()({
+    actionType: GuidActionType.NewSortable,
+});
+//# sourceMappingURL=askGuidNewSortable.js.map

package/lib/esm/actions/guid/askGuidNewSortable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askGuidNewSortable.js","sourceRoot":"","sources":["../../../../src/actions/guid/askGuidNewSortable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,EAAU,CAAC;IAChE,UAAU,EAAE,cAAc,CAAC,WAAW;CACvC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { GuidActionType } from './GuidActionType';\n\nexport const askGuidNewSortable = createActionRequester<string>()({\n  actionType: GuidActionType.NewSortable,\n});\n"]}

package/lib/esm/actions/guid/askGuidNewSortableMany.d.ts

@@ -0,0 +1,4 @@
+import { GuidActionType } from './GuidActionType';
+export declare const askGuidNewSortableMany: import("../..").ActionRequesterFunction<GuidActionType.NewSortableMany, [count: number], {
+    count: number;
+}, string[], never>;

package/lib/esm/actions/guid/askGuidNewSortableMany.js

@@ -0,0 +1,12 @@
+import { createActionRequester } from '../../logic/actions';
+import { GuidActionType } from './GuidActionType';
+// Mint `count` sortable ids in ONE action. The processor generates them in
+// sequence, so the returned array is itself in sort order: ids[0] < ids[1] < ...
+// (uuidv7's counter bits keep same-millisecond mints monotonic). The batch
+// primitive for bulk writers, one append fan-out should not pay one action
+// per id.
+export const askGuidNewSortableMany = createActionRequester()({
+    actionType: GuidActionType.NewSortableMany,
+    getPayload: (count) => ({ count }),
+});
+//# sourceMappingURL=askGuidNewSortableMany.js.map

package/lib/esm/actions/guid/askGuidNewSortableMany.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askGuidNewSortableMany.js","sourceRoot":"","sources":["../../../../src/actions/guid/askGuidNewSortableMany.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,2EAA2E;AAC3E,iFAAiF;AACjF,2EAA2E;AAC3E,2EAA2E;AAC3E,UAAU;AACV,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,EAAY,CAAC;IACtE,UAAU,EAAE,cAAc,CAAC,eAAe;IAC1C,UAAU,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;CAC3C,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { GuidActionType } from './GuidActionType';\n\n// Mint `count` sortable ids in ONE action. The processor generates them in\n// sequence, so the returned array is itself in sort order: ids[0] < ids[1] < ...\n// (uuidv7's counter bits keep same-millisecond mints monotonic). The batch\n// primitive for bulk writers, one append fan-out should not pay one action\n// per id.\nexport const askGuidNewSortableMany = createActionRequester<string[]>()({\n  actionType: GuidActionType.NewSortableMany,\n  getPayload: (count: number) => ({ count }),\n});\n"]}

package/lib/esm/actions/guid/index.d.ts

@@ -1,4 +1,4 @@
-export * from './askNewGuid';
-export * from './askNewSortableGuid';
-export * from './askNewSortableGuids';
+export * from './askGuidNew';
+export * from './askGuidNewSortable';
+export * from './askGuidNewSortableMany';
 export * from './GuidActionType';

package/lib/esm/actions/guid/index.js

@@ -1,5 +1,5 @@
-export * from './askNewGuid';
-export * from './askNewSortableGuid';
-export * from './askNewSortableGuids';
+export * from './askGuidNew';
+export * from './askGuidNewSortable';
+export * from './askGuidNewSortableMany';
 export * from './GuidActionType';
 //# sourceMappingURL=index.js.map

package/lib/esm/actions/guid/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/guid/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './askNewGuid';\nexport * from './askNewSortableGuid';\nexport * from './askNewSortableGuids';\nexport * from './GuidActionType';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/guid/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './askGuidNew';\nexport * from './askGuidNewSortable';\nexport * from './askGuidNewSortableMany';\nexport * from './GuidActionType';\n"]}

package/lib/esm/actions/index.d.ts

@@ -22,5 +22,5 @@ export * from './secureToken';
 export * from './state';
 export * from './stream';
 export * from './system';
-export * from './userScript';
 export * from './userDirectory';
+export * from './userScript';

package/lib/esm/actions/index.js

@@ -22,6 +22,6 @@ export * from './secureToken';
 export * from './state';
 export * from './stream';
 export * from './system';
-export * from './userScript';
 export * from './userDirectory';
+export * from './userScript';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC","sourcesContent":["export * from './ai';\nexport * from './config';\nexport * from './context';\nexport * from './crypto';\nexport * from './date';\nexport * from './dynamicFunctions';\nexport * from './error';\nexport * from './event';\nexport * from './eventBus';\nexport * from './file';\nexport * from './graphDatabase';\nexport * from './guid';\nexport * from './inlineFunction';\nexport * from './keyValueStore';\nexport * from './log';\nexport * from './math';\nexport * from './metric';\nexport * from './network';\nexport * from './platform';\nexport * from './queue';\nexport * from './secureToken';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\nexport * from './userScript';\nexport * from './userDirectory';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC","sourcesContent":["export * from './ai';\nexport * from './config';\nexport * from './context';\nexport * from './crypto';\nexport * from './date';\nexport * from './dynamicFunctions';\nexport * from './error';\nexport * from './event';\nexport * from './eventBus';\nexport * from './file';\nexport * from './graphDatabase';\nexport * from './guid';\nexport * from './inlineFunction';\nexport * from './keyValueStore';\nexport * from './log';\nexport * from './math';\nexport * from './metric';\nexport * from './network';\nexport * from './platform';\nexport * from './queue';\nexport * from './secureToken';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\nexport * from './userDirectory';\nexport * from './userScript';\n"]}

package/lib/esm/actions/inlineFunction/askInlineFunctionExecute.d.ts

@@ -4,4 +4,4 @@ export declare const askInlineFunctionExecuteBase: import("../..").ActionRequest
     functionName: string;
     payload: unknown;
 }, unknown, never>;
-export declare function askInlineFunctionExecute<R, T>(functionName: string, payload: T): AskResponse<R>;
+export declare function askInlineFunctionExecute<TResult, TPayload = unknown>(functionName: string, payload: TPayload): AskResponse<TResult>;

package/lib/esm/actions/inlineFunction/askInlineFunctionExecute.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { InlineFunctionActionType } from './InlineFunctionActionType';
 export const askInlineFunctionExecuteBase = createActionRequester()({
     actionType: InlineFunctionActionType.Execute,

package/lib/esm/actions/inlineFunction/askInlineFunctionExecute.js.map

@@ -1 +1 @@
-{"version":3,"file":"askInlineFunctionExecute.js","sourceRoot":"","sources":["../../../../src/actions/inlineFunction/askInlineFunctionExecute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,EAAW,CAAC;IAC3E,UAAU,EAAE,wBAAwB,CAAC,OAAO;IAC5C,UAAU,EAAE,CAAC,YAAoB,EAAE,OAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;CACpF,CAAC,CAAC;AAEH,oFAAoF;AACpF,8EAA8E;AAC9E,MAAM,SAAS,CAAC,CAAC,wBAAwB,CAAO,YAAoB,EAAE,OAAU;IAC9E,OAAO,CAAC,KAAK,CAAC,CAAC,4BAA4B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAM,CAAC;AAC3E,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { InlineFunctionActionType } from './InlineFunctionActionType';\n\nexport const askInlineFunctionExecuteBase = createActionRequester<unknown>()({\n  actionType: InlineFunctionActionType.Execute,\n  getPayload: (functionName: string, payload: unknown) => ({ functionName, payload }),\n});\n\n// The function's payload and result types are only known to the caller, so the base\n// takes and returns unknown and this story casts to what the caller declared.\nexport function* askInlineFunctionExecute<R, T>(functionName: string, payload: T): AskResponse<R> {\n  return (yield* askInlineFunctionExecuteBase(functionName, payload)) as R;\n}\n"]}
+{"version":3,"file":"askInlineFunctionExecute.js","sourceRoot":"","sources":["../../../../src/actions/inlineFunction/askInlineFunctionExecute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,EAAW,CAAC;IAC3E,UAAU,EAAE,wBAAwB,CAAC,OAAO;IAC5C,UAAU,EAAE,CAAC,YAAoB,EAAE,OAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;CACpF,CAAC,CAAC;AAEH,oFAAoF;AACpF,8EAA8E;AAC9E,MAAM,SAAS,CAAC,CAAC,wBAAwB,CAA8B,YAAoB,EAAE,OAAiB;IAC5G,OAAO,CAAC,KAAK,CAAC,CAAC,4BAA4B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAY,CAAC;AACjF,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { InlineFunctionActionType } from './InlineFunctionActionType';\n\nexport const askInlineFunctionExecuteBase = createActionRequester<unknown>()({\n  actionType: InlineFunctionActionType.Execute,\n  getPayload: (functionName: string, payload: unknown) => ({ functionName, payload }),\n});\n\n// The function's payload and result types are only known to the caller, so the base\n// takes and returns unknown and this story casts to what the caller declared.\nexport function* askInlineFunctionExecute<TResult, TPayload = unknown>(functionName: string, payload: TPayload): AskResponse<TResult> {\n  return (yield* askInlineFunctionExecuteBase(functionName, payload)) as TResult;\n}\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreDelete.d.ts

@@ -8,4 +8,4 @@ export declare const askKeyValueStoreDelete: import("../..").ActionRequesterFunc
     key: KvsCoreDataType;
     sortKey: KvsCoreDataType | undefined;
     options: KeyValueStoreDeleteOptions | undefined;
-}, void, "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound">;
+}, void, "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound">;

package/lib/esm/actions/keyValueStore/askKeyValueStoreDelete.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreDelete = createActionRequester()({
     actionType: KeyValueStoreActionType.Delete,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)

package/lib/esm/actions/keyValueStore/askKeyValueStoreDelete.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreDelete.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreDelete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAQpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,EAAQ,CAAC;IAClE,UAAU,EAAE,uBAAuB,CAAC,MAAM;IAC1C,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,GAAoB,EAAE,OAAyB,EAAE,OAAoC,EAAE,EAAE,CAAC,CAAC;QACjI,iBAAiB;QACjB,GAAG;QACH,OAAO;QACP,OAAO;KACR,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsCoreDataType } from './types';\n\nexport type KeyValueStoreDeleteOptions = {\n  // Composed into the partition key value by the processor; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreDelete = createActionRequester<void>()({\n  actionType: KeyValueStoreActionType.Delete,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, key: KvsCoreDataType, sortKey?: KvsCoreDataType, options?: KeyValueStoreDeleteOptions) => ({\n    keyValueStoreName,\n    key,\n    sortKey,\n    options,\n  }),\n});\n"]}
+{"version":3,"file":"askKeyValueStoreDelete.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreDelete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAQpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,EAAQ,CAAC;IAClE,UAAU,EAAE,uBAAuB,CAAC,MAAM;IAC1C,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,GAAoB,EAAE,OAAyB,EAAE,OAAoC,EAAE,EAAE,CAAC,CAAC;QACjI,iBAAiB;QACjB,GAAG;QACH,OAAO;QACP,OAAO;KACR,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsCoreDataType } from './types';\n\nexport type KeyValueStoreDeleteOptions = {\n  // Composed into the partition key value by the processor; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreDelete = createActionRequester<void>()({\n  actionType: KeyValueStoreActionType.Delete,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, key: KvsCoreDataType, sortKey?: KvsCoreDataType, options?: KeyValueStoreDeleteOptions) => ({\n    keyValueStoreName,\n    key,\n    sortKey,\n    options,\n  }),\n});\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreGet.d.ts

@@ -1,3 +1,4 @@
+import { Nullable } from '../../types/Nullable';
 import { AskResponse } from '../../types/StorySession';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export type KeyValueStoreGetOptions = {
@@ -7,5 +8,15 @@ export declare const askKeyValueStoreGetBase: import("../..").ActionRequesterFun
     keyValueStoreName: string;
     key: string;
     options: KeyValueStoreGetOptions | undefined;
-}, unknown, "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound">;
-export declare function askKeyValueStoreGet<Value>(keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions): AskResponse<Value | null>;
+}, unknown, "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound">;
+declare function askKeyValueStoreGetTyped<Value>(keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions): AskResponse<Nullable<Value>>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreGet: typeof askKeyValueStoreGetTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        InvalidScope: string;
+        StoreNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreGet.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreGetBase = createActionRequester()({
     actionType: KeyValueStoreActionType.Get,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
@@ -12,7 +12,9 @@ export const askKeyValueStoreGetBase = createActionRequester()({
 });
 // The stored item's shape is only known to the caller, so the base returns unknown and
 // this story casts it to what the caller declared.
-export function* askKeyValueStoreGet(keyValueStoreName, key, options) {
+function* askKeyValueStoreGetTyped(keyValueStoreName, key, options) {
     return (yield* askKeyValueStoreGetBase(keyValueStoreName, key, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreGet = Object.assign(askKeyValueStoreGetTyped, { errorType: askKeyValueStoreGetBase.errorType });
 //# sourceMappingURL=askKeyValueStoreGet.js.map

package/lib/esm/actions/keyValueStore/askKeyValueStoreGet.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreGet.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreGet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,EAAW,CAAC;IACtE,UAAU,EAAE,uBAAuB,CAAC,GAAG;IACvC,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,GAAW,EAAE,OAAiC,EAAE,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;CACjI,CAAC,CAAC;AAEH,uFAAuF;AACvF,mDAAmD;AACnD,MAAM,SAAS,CAAC,CAAC,mBAAmB,CAAQ,iBAAyB,EAAE,GAAW,EAAE,OAAiC;IACnH,OAAO,CAAC,KAAK,CAAC,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAiB,CAAC;AAC3F,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\n\nexport type KeyValueStoreGetOptions = {\n  // Composed into the partition key value by the processor; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreGetBase = createActionRequester<unknown>()({\n  actionType: KeyValueStoreActionType.Get,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions) => ({ keyValueStoreName, key, options }),\n});\n\n// The stored item's shape is only known to the caller, so the base returns unknown and\n// this story casts it to what the caller declared.\nexport function* askKeyValueStoreGet<Value>(keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions): AskResponse<Value | null> {\n  return (yield* askKeyValueStoreGetBase(keyValueStoreName, key, options)) as Value | null;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreGet.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreGet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,EAAW,CAAC;IACtE,UAAU,EAAE,uBAAuB,CAAC,GAAG;IACvC,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,GAAW,EAAE,OAAiC,EAAE,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;CACjI,CAAC,CAAC;AAEH,uFAAuF;AACvF,mDAAmD;AACnD,QAAQ,CAAC,CAAC,wBAAwB,CAAQ,iBAAyB,EAAE,GAAW,EAAE,OAAiC;IACjH,OAAO,CAAC,KAAK,CAAC,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAoB,CAAC;AAC9F,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,uBAAuB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { Nullable } from '../../types/Nullable';\nimport { AskResponse } from '../../types/StorySession';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\n\nexport type KeyValueStoreGetOptions = {\n  // Composed into the partition key value by the processor; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreGetBase = createActionRequester<unknown>()({\n  actionType: KeyValueStoreActionType.Get,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions) => ({ keyValueStoreName, key, options }),\n});\n\n// The stored item's shape is only known to the caller, so the base returns unknown and\n// this story casts it to what the caller declared.\nfunction* askKeyValueStoreGetTyped<Value>(keyValueStoreName: string, key: string, options?: KeyValueStoreGetOptions): AskResponse<Nullable<Value>> {\n  return (yield* askKeyValueStoreGetBase(keyValueStoreName, key, options)) as Nullable<Value>;\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askKeyValueStoreGet = Object.assign(askKeyValueStoreGetTyped, { errorType: askKeyValueStoreGetBase.errorType });\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreGetAll.d.ts

@@ -6,5 +6,15 @@ export type KeyValueStoreGetAllOptions = {
 export declare const askKeyValueStoreGetAllBase: import("../..").ActionRequesterFunction<KeyValueStoreActionType.GetAll, [keyValueStoreName: string, options?: KeyValueStoreGetAllOptions | undefined], {
     keyValueStoreName: string;
     options: KeyValueStoreGetAllOptions | undefined;
-}, unknown[], "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound">;
-export declare function askKeyValueStoreGetAll<Value>(keyValueStoreName: string, options?: KeyValueStoreGetAllOptions): AskResponse<Value[]>;
+}, unknown[], "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound">;
+declare function askKeyValueStoreGetAllTyped<Value>(keyValueStoreName: string, options?: KeyValueStoreGetAllOptions): AskResponse<Value[]>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreGetAll: typeof askKeyValueStoreGetAllTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        InvalidScope: string;
+        StoreNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreGetAll.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreGetAllBase = createActionRequester()({
     actionType: KeyValueStoreActionType.GetAll,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
@@ -12,7 +12,9 @@ export const askKeyValueStoreGetAllBase = createActionRequester()({
 });
 // The stored item shape is only known to the caller, so the base returns unknown[] and
 // this story casts it to what the caller declared.
-export function* askKeyValueStoreGetAll(keyValueStoreName, options) {
+function* askKeyValueStoreGetAllTyped(keyValueStoreName, options) {
     return (yield* askKeyValueStoreGetAllBase(keyValueStoreName, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreGetAll = Object.assign(askKeyValueStoreGetAllTyped, { errorType: askKeyValueStoreGetAllBase.errorType });
 //# sourceMappingURL=askKeyValueStoreGetAll.js.map

package/lib/esm/actions/keyValueStore/askKeyValueStoreGetAll.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreGetAll.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreGetAll.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,EAAa,CAAC;IAC3E,UAAU,EAAE,uBAAuB,CAAC,MAAM;IAC1C,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,OAAoC,EAAE,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;CAClH,CAAC,CAAC;AAEH,uFAAuF;AACvF,mDAAmD;AACnD,MAAM,SAAS,CAAC,CAAC,sBAAsB,CAAQ,iBAAyB,EAAE,OAAoC;IAC5G,OAAO,CAAC,KAAK,CAAC,CAAC,0BAA0B,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAY,CAAC;AACpF,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\n\nexport type KeyValueStoreGetAllOptions = {\n  // Enforced by the processor as a partition-key prefix filter; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreGetAllBase = createActionRequester<unknown[]>()({\n  actionType: KeyValueStoreActionType.GetAll,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, options?: KeyValueStoreGetAllOptions) => ({ keyValueStoreName, options }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown[] and\n// this story casts it to what the caller declared.\nexport function* askKeyValueStoreGetAll<Value>(keyValueStoreName: string, options?: KeyValueStoreGetAllOptions): AskResponse<Value[]> {\n  return (yield* askKeyValueStoreGetAllBase(keyValueStoreName, options)) as Value[];\n}\n"]}
+{"version":3,"file":"askKeyValueStoreGetAll.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreGetAll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,EAAa,CAAC;IAC3E,UAAU,EAAE,uBAAuB,CAAC,MAAM;IAC1C,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,OAAoC,EAAE,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;CAClH,CAAC,CAAC;AAEH,uFAAuF;AACvF,mDAAmD;AACnD,QAAQ,CAAC,CAAC,2BAA2B,CAAQ,iBAAyB,EAAE,OAAoC;IAC1G,OAAO,CAAC,KAAK,CAAC,CAAC,0BAA0B,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAY,CAAC;AACpF,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,0BAA0B,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\n\nexport type KeyValueStoreGetAllOptions = {\n  // Enforced by the processor as a partition-key prefix filter; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreGetAllBase = createActionRequester<unknown[]>()({\n  actionType: KeyValueStoreActionType.GetAll,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, options?: KeyValueStoreGetAllOptions) => ({ keyValueStoreName, options }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown[] and\n// this story casts it to what the caller declared.\nfunction* askKeyValueStoreGetAllTyped<Value>(keyValueStoreName: string, options?: KeyValueStoreGetAllOptions): AskResponse<Value[]> {\n  return (yield* askKeyValueStoreGetAllBase(keyValueStoreName, options)) as Value[];\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askKeyValueStoreGetAll = Object.assign(askKeyValueStoreGetAllTyped, { errorType: askKeyValueStoreGetAllBase.errorType });\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreQuery.d.ts

@@ -16,5 +16,16 @@ export declare const askKeyValueStoreQueryBase: import("../..").ActionRequesterF
     keyValueStoreName: string;
     keyCondition: KvsQueryOperation;
     options: KeyValueStoreQueryOptions | undefined;
-}, QpqPagedData<unknown>, "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound" | "IndexNotFound">;
-export declare function askKeyValueStoreQuery<KvsItem>(keyValueStoreName: string, keyCondition: KvsQueryOperation, options?: KeyValueStoreQueryOptions): AskResponse<QpqPagedData<KvsItem>>;
+}, QpqPagedData<unknown>, "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound" | "IndexNotFound">;
+declare function askKeyValueStoreQueryTyped<KvsItem>(keyValueStoreName: string, keyCondition: KvsQueryOperation, options?: KeyValueStoreQueryOptions): AskResponse<QpqPagedData<KvsItem>>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreQuery: typeof askKeyValueStoreQueryTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        InvalidScope: string;
+        StoreNotFound: string;
+        IndexNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreQuery.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreQueryBase = createActionRequester()({
     actionType: KeyValueStoreActionType.Query,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
@@ -17,7 +17,9 @@ export const askKeyValueStoreQueryBase = createActionRequester()({
 });
 // The stored item shape is only known to the caller, so the base returns unknown items
 // and this story casts the page to what the caller declared.
-export function* askKeyValueStoreQuery(keyValueStoreName, keyCondition, options) {
+function* askKeyValueStoreQueryTyped(keyValueStoreName, keyCondition, options) {
     return (yield* askKeyValueStoreQueryBase(keyValueStoreName, keyCondition, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreQuery = Object.assign(askKeyValueStoreQueryTyped, { errorType: askKeyValueStoreQueryBase.errorType });
 //# sourceMappingURL=askKeyValueStoreQuery.js.map

package/lib/esm/actions/keyValueStore/askKeyValueStoreQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreQuery.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AA8BpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,EAAyB,CAAC;IACtF,UAAU,EAAE,uBAAuB,CAAC,KAAK;IACzC,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;QAClF,eAAe,EAAE,0EAA0E;KAC5F;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,YAA+B,EAAE,OAAmC,EAAE,EAAE,CAAC,CAAC;QAChH,iBAAiB;QACjB,YAAY;QACZ,OAAO;KACR,CAAC;CACH,CAAC,CAAC;AAEH,uFAAuF;AACvF,6DAA6D;AAC7D,MAAM,SAAS,CAAC,CAAC,qBAAqB,CACpC,iBAAyB,EAEzB,YAA+B,EAC/B,OAAmC;IAEnC,OAAO,CAAC,KAAK,CAAC,CAAC,yBAAyB,CAAC,iBAAiB,EAAE,YAAY,EAAE,OAAO,CAAC,CAA0B,CAAC;AAC/G,CAAC","sourcesContent":["import { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\nexport type KeyValueStoreQueryOptions = {\n  // Accepted but not implemented: no processor applies a TTL to query results.\n  ttlInSeconds?: number;\n  sortAscending?: boolean;\n  limit?: number;\n  nextPageKey?: string;\n  filter?: KvsQueryOperation;\n  // Composed into partition-key conditions by the processor; requires a string-typed partition key.\n  scope?: string;\n  // Query the declared index with this name (which defaults to its partition key attribute) and read in\n  // its sort order. Without it the table, or else the first index, whose keys cover the key condition\n  // serves it, so an index sharing the table's keys is only used when named here.\n  indexName?: string;\n  // Read the writer's own most recent writes, at the cost of a slower and (on DynamoDB) doubly-charged\n  // read.\n  //\n  // Default reads are EVENTUALLY consistent, which is right for a viewer and wrong for a caller that just\n  // wrote and is now reading back to decide something. That case is not hypothetical: a flow run appends\n  // its terminal event and immediately re-lists the log to fold the outcome, and under load the terminal\n  // event is intermittently not yet visible — so a run that succeeded reads back as having no outcome at\n  // all, with nothing recorded to explain it.\n  //\n  // Use it for read-your-own-writes and for any fold used as a COORDINATION primitive (deciding \"am I\n  // last\", \"did this finish\"). Do not use it for ordinary reads.\n  consistentRead?: boolean;\n};\n\nexport const askKeyValueStoreQueryBase = createActionRequester<QpqPagedData<unknown>>()({\n  actionType: KeyValueStoreActionType.Query,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n    'IndexNotFound', // `indexName` names an index the store doesn't declare (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, keyCondition: KvsQueryOperation, options?: KeyValueStoreQueryOptions) => ({\n    keyValueStoreName,\n    keyCondition,\n    options,\n  }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown items\n// and this story casts the page to what the caller declared.\nexport function* askKeyValueStoreQuery<KvsItem>(\n  keyValueStoreName: string,\n\n  keyCondition: KvsQueryOperation,\n  options?: KeyValueStoreQueryOptions,\n): AskResponse<QpqPagedData<KvsItem>> {\n  return (yield* askKeyValueStoreQueryBase(keyValueStoreName, keyCondition, options)) as QpqPagedData<KvsItem>;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreQuery.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AA8BpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,EAAyB,CAAC;IACtF,UAAU,EAAE,uBAAuB,CAAC,KAAK;IACzC,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;QAClF,eAAe,EAAE,0EAA0E;KAC5F;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,YAA+B,EAAE,OAAmC,EAAE,EAAE,CAAC,CAAC;QAChH,iBAAiB;QACjB,YAAY;QACZ,OAAO;KACR,CAAC;CACH,CAAC,CAAC;AAEH,uFAAuF;AACvF,6DAA6D;AAC7D,QAAQ,CAAC,CAAC,0BAA0B,CAClC,iBAAyB,EAEzB,YAA+B,EAC/B,OAAmC;IAEnC,OAAO,CAAC,KAAK,CAAC,CAAC,yBAAyB,CAAC,iBAAiB,EAAE,YAAY,EAAE,OAAO,CAAC,CAA0B,CAAC;AAC/G,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,yBAAyB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\nexport type KeyValueStoreQueryOptions = {\n  // Accepted but not implemented: no processor applies a TTL to query results.\n  ttlInSeconds?: number;\n  sortAscending?: boolean;\n  limit?: number;\n  nextPageKey?: string;\n  filter?: KvsQueryOperation;\n  // Composed into partition-key conditions by the processor; requires a string-typed partition key.\n  scope?: string;\n  // Query the declared index with this name (which defaults to its partition key attribute) and read in\n  // its sort order. Without it the table, or else the first index, whose keys cover the key condition\n  // serves it, so an index sharing the table's keys is only used when named here.\n  indexName?: string;\n  // Read the writer's own most recent writes, at the cost of a slower and (on DynamoDB) doubly-charged\n  // read.\n  //\n  // Default reads are EVENTUALLY consistent, which is right for a viewer and wrong for a caller that just\n  // wrote and is now reading back to decide something. That case is not hypothetical: a flow run appends\n  // its terminal event and immediately re-lists the log to fold the outcome, and under load the terminal\n  // event is intermittently not yet visible, so a run that succeeded reads back as having no outcome at\n  // all, with nothing recorded to explain it.\n  //\n  // Use it for read-your-own-writes and for any fold used as a COORDINATION primitive (deciding \"am I\n  // last\", \"did this finish\"). Do not use it for ordinary reads.\n  consistentRead?: boolean;\n};\n\nexport const askKeyValueStoreQueryBase = createActionRequester<QpqPagedData<unknown>>()({\n  actionType: KeyValueStoreActionType.Query,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n    'IndexNotFound', // `indexName` names an index the store doesn't declare (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, keyCondition: KvsQueryOperation, options?: KeyValueStoreQueryOptions) => ({\n    keyValueStoreName,\n    keyCondition,\n    options,\n  }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown items\n// and this story casts the page to what the caller declared.\nfunction* askKeyValueStoreQueryTyped<KvsItem>(\n  keyValueStoreName: string,\n\n  keyCondition: KvsQueryOperation,\n  options?: KeyValueStoreQueryOptions,\n): AskResponse<QpqPagedData<KvsItem>> {\n  return (yield* askKeyValueStoreQueryBase(keyValueStoreName, keyCondition, options)) as QpqPagedData<KvsItem>;\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askKeyValueStoreQuery = Object.assign(askKeyValueStoreQueryTyped, { errorType: askKeyValueStoreQueryBase.errorType });\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreScan.d.ts

@@ -12,5 +12,15 @@ export declare const askKeyValueStoreScanBase: import("../..").ActionRequesterFu
     filterCondition: KvsQueryOperation | undefined;
     nextPageKey: string | undefined;
     options: KeyValueStoreScanOptions | undefined;
-}, QpqPagedData<unknown>, "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound">;
-export declare function askKeyValueStoreScan<KvsItem>(keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanOptions): AskResponse<QpqPagedData<KvsItem>>;
+}, QpqPagedData<unknown>, "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound">;
+declare function askKeyValueStoreScanTyped<KvsItem>(keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanOptions): AskResponse<QpqPagedData<KvsItem>>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreScan: typeof askKeyValueStoreScanTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        InvalidScope: string;
+        StoreNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreScan.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreScanBase = createActionRequester()({
     actionType: KeyValueStoreActionType.Scan,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
@@ -17,7 +17,9 @@ export const askKeyValueStoreScanBase = createActionRequester()({
 });
 // The stored item shape is only known to the caller, so the base returns unknown items
 // and this story casts the page to what the caller declared.
-export function* askKeyValueStoreScan(keyValueStoreName, filterCondition, nextPageKey, options) {
+function* askKeyValueStoreScanTyped(keyValueStoreName, filterCondition, nextPageKey, options) {
     return (yield* askKeyValueStoreScanBase(keyValueStoreName, filterCondition, nextPageKey, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreScan = Object.assign(askKeyValueStoreScanTyped, { errorType: askKeyValueStoreScanBase.errorType });
 //# sourceMappingURL=askKeyValueStoreScan.js.map

package/lib/esm/actions/keyValueStore/askKeyValueStoreScan.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreScan.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreScan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAYpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAyB,CAAC;IACrF,UAAU,EAAE,uBAAuB,CAAC,IAAI;IACxC,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,eAAmC,EAAE,WAAoB,EAAE,OAAkC,EAAE,EAAE,CAAC,CAAC;QACzI,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,OAAO;KACR,CAAC;CACH,CAAC,CAAC;AAEH,uFAAuF;AACvF,6DAA6D;AAC7D,MAAM,SAAS,CAAC,CAAC,oBAAoB,CACnC,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAAkC;IAElC,OAAO,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,CAA0B,CAAC;AAC9H,CAAC","sourcesContent":["import { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\nexport type KeyValueStoreScanOptions = {\n  // Accepted but not implemented: no processor applies a TTL to scans.\n  ttlInSeconds?: number;\n  // Accepted but not implemented: no processor caps the page size of a scan.\n  limit?: number;\n  // Enforced by the processor as a partition-key prefix filter; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreScanBase = createActionRequester<QpqPagedData<unknown>>()({\n  actionType: KeyValueStoreActionType.Scan,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanOptions) => ({\n    keyValueStoreName,\n    filterCondition,\n    nextPageKey,\n    options,\n  }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown items\n// and this story casts the page to what the caller declared.\nexport function* askKeyValueStoreScan<KvsItem>(\n  keyValueStoreName: string,\n  filterCondition?: KvsQueryOperation,\n  nextPageKey?: string,\n  options?: KeyValueStoreScanOptions,\n): AskResponse<QpqPagedData<KvsItem>> {\n  return (yield* askKeyValueStoreScanBase(keyValueStoreName, filterCondition, nextPageKey, options)) as QpqPagedData<KvsItem>;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreScan.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreScan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAYpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAyB,CAAC;IACrF,UAAU,EAAE,uBAAuB,CAAC,IAAI;IACxC,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,cAAc,EAAE,sEAAsE;QACtF,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAE,eAAmC,EAAE,WAAoB,EAAE,OAAkC,EAAE,EAAE,CAAC,CAAC;QACzI,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,OAAO;KACR,CAAC;CACH,CAAC,CAAC;AAEH,uFAAuF;AACvF,6DAA6D;AAC7D,QAAQ,CAAC,CAAC,yBAAyB,CACjC,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAAkC;IAElC,OAAO,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,CAA0B,CAAC;AAC9H,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\nexport type KeyValueStoreScanOptions = {\n  // Accepted but not implemented: no processor applies a TTL to scans.\n  ttlInSeconds?: number;\n  // Accepted but not implemented: no processor caps the page size of a scan.\n  limit?: number;\n  // Enforced by the processor as a partition-key prefix filter; requires a string-typed partition key.\n  scope?: string;\n};\n\nexport const askKeyValueStoreScanBase = createActionRequester<QpqPagedData<unknown>>()({\n  actionType: KeyValueStoreActionType.Scan,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'InvalidScope', // scope is malformed or the store's partition key is not string-typed\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanOptions) => ({\n    keyValueStoreName,\n    filterCondition,\n    nextPageKey,\n    options,\n  }),\n});\n\n// The stored item shape is only known to the caller, so the base returns unknown items\n// and this story casts the page to what the caller declared.\nfunction* askKeyValueStoreScanTyped<KvsItem>(\n  keyValueStoreName: string,\n  filterCondition?: KvsQueryOperation,\n  nextPageKey?: string,\n  options?: KeyValueStoreScanOptions,\n): AskResponse<QpqPagedData<KvsItem>> {\n  return (yield* askKeyValueStoreScanBase(keyValueStoreName, filterCondition, nextPageKey, options)) as QpqPagedData<KvsItem>;\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askKeyValueStoreScan = Object.assign(askKeyValueStoreScanTyped, { errorType: askKeyValueStoreScanBase.errorType });\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreScanAllScopes.d.ts

@@ -14,7 +14,7 @@ export declare const askKeyValueStoreScanAllScopesBase: import("../..").ActionRe
     filterCondition: KvsQueryOperation | undefined;
     nextPageKey: string | undefined;
     options: KeyValueStoreScanAllScopesOptions | undefined;
-}, QpqPagedData<KvsScopedItem<unknown>>, "ResourceNotFound" | "ServiceUnavailable" | "StoreNotFound">;
+}, QpqPagedData<KvsScopedItem<unknown>>, "Throttled" | "ResourceNotFound" | "StoreNotFound">;
 /**
  * Read EVERY row in a store, across every scope, each paired with the scope it lives under.
  *
@@ -29,14 +29,23 @@ export declare const askKeyValueStoreScanAllScopesBase: import("../..").ActionRe
  *
  * So: reach for this only from a migration or an equivalent whole-store operation, never on a
  * request path. Nothing in the framework calls it, and a caller with a user's request in hand
- * has no business using it — scope is what keeps tenants apart, and this steps over it.
+ * has no business using it, scope is what keeps tenants apart, and this steps over it.
  *
  * The scope comes back per row rather than being discarded, so a caller can write each row
  * back where it came from.
  *
  * DRAIN THE PAGE KEY: loop until `nextPageKey` comes back undefined. Every backend pages,
- * including the local one, deliberately so — a backend that returned everything in one call
+ * including the local one, deliberately so, a backend that returned everything in one call
  * would let a caller stop after the first page, be right locally, and silently skip most of
  * the data deployed. A local run has to be able to prove the loop.
  */
-export declare function askKeyValueStoreScanAllScopes<KvsItem>(keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanAllScopesOptions): AskResponse<QpqPagedData<KvsScopedItem<KvsItem>>>;
+declare function askKeyValueStoreScanAllScopesTyped<KvsItem>(keyValueStoreName: string, filterCondition?: KvsQueryOperation, nextPageKey?: string, options?: KeyValueStoreScanAllScopesOptions): AskResponse<QpqPagedData<KvsScopedItem<KvsItem>>>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreScanAllScopes: typeof askKeyValueStoreScanAllScopesTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        StoreNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreScanAllScopes.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreScanAllScopesBase = createActionRequester()({
     actionType: KeyValueStoreActionType.ScanAllScopes,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
     ],
@@ -23,17 +23,21 @@ export const askKeyValueStoreScanAllScopesBase = createActionRequester()({
  *
  * So: reach for this only from a migration or an equivalent whole-store operation, never on a
  * request path. Nothing in the framework calls it, and a caller with a user's request in hand
- * has no business using it — scope is what keeps tenants apart, and this steps over it.
+ * has no business using it, scope is what keeps tenants apart, and this steps over it.
  *
  * The scope comes back per row rather than being discarded, so a caller can write each row
  * back where it came from.
  *
  * DRAIN THE PAGE KEY: loop until `nextPageKey` comes back undefined. Every backend pages,
- * including the local one, deliberately so — a backend that returned everything in one call
+ * including the local one, deliberately so, a backend that returned everything in one call
  * would let a caller stop after the first page, be right locally, and silently skip most of
  * the data deployed. A local run has to be able to prove the loop.
  */
-export function* askKeyValueStoreScanAllScopes(keyValueStoreName, filterCondition, nextPageKey, options) {
+function* askKeyValueStoreScanAllScopesTyped(keyValueStoreName, filterCondition, nextPageKey, options) {
     return (yield* askKeyValueStoreScanAllScopesBase(keyValueStoreName, filterCondition, nextPageKey, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreScanAllScopes = Object.assign(askKeyValueStoreScanAllScopesTyped, {
+    errorType: askKeyValueStoreScanAllScopesBase.errorType,
+});
 //# sourceMappingURL=askKeyValueStoreScanAllScopes.js.map

package/lib/esm/actions/keyValueStore/askKeyValueStoreScanAllScopes.js.map

@@ -1 +1 @@
-{"version":3,"file":"askKeyValueStoreScanAllScopes.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreScanAllScopes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAkBpE,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,EAAwC,CAAC;IAC7G,UAAU,EAAE,uBAAuB,CAAC,aAAa;IACjD,UAAU,EAAE;QACV,oBAAoB,EAAE,uCAAuC;QAC7D,kBAAkB,EAAE,sCAAsC;QAC1D,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CACV,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAA2C,EAC3C,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;CACpE,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,SAAS,CAAC,CAAC,6BAA6B,CAC5C,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAA2C;IAE3C,OAAO,CAAC,KAAK,CAAC,CAAC,iCAAiC,CAAC,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,CAAyC,CAAC;AACtJ,CAAC","sourcesContent":["import { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\n// One row and the scope it lives under. `scope` is absent for an unscoped row.\n//\n// The scope is reported rather than dropped BECAUSE this crosses scopes: a caller that reads\n// every tenant's rows in one pass has to know which tenant each belongs to, or anything it\n// writes back lands in the wrong partition. Handing back bare items would make silent\n// cross-tenant corruption the easy mistake.\nexport type KvsScopedItem<KvsItem> = {\n  scope?: string;\n  item: KvsItem;\n};\n\nexport type KeyValueStoreScanAllScopesOptions = {\n  limit?: number;\n};\n\nexport const askKeyValueStoreScanAllScopesBase = createActionRequester<QpqPagedData<KvsScopedItem<unknown>>>()({\n  actionType: KeyValueStoreActionType.ScanAllScopes,\n  errorTypes: [\n    'ServiceUnavailable', // DynamoDB internal error / throttling\n    'ResourceNotFound', // the underlying table does not exist\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (\n    keyValueStoreName: string,\n    filterCondition?: KvsQueryOperation,\n    nextPageKey?: string,\n    options?: KeyValueStoreScanAllScopesOptions,\n  ) => ({ keyValueStoreName, filterCondition, nextPageKey, options }),\n});\n\n/**\n * Read EVERY row in a store, across every scope, each paired with the scope it lives under.\n *\n * This deliberately crosses the tenant boundary that the rest of the KVS layer works hard to\n * hold. An ordinary unscoped Scan cannot see scoped rows at all: the translator ANDs on a\n * predicate that excludes them, precisely so one tenant's request can never read another's.\n * That is the right default and nothing about it changes.\n *\n * The exception exists for MIGRATIONS, where the job is \"rewrite every row\" and any row you\n * cannot see is data you silently leave behind. The alternative is asking the app to\n * enumerate its own tenants and loop, which fails quietly the moment that list is incomplete.\n *\n * So: reach for this only from a migration or an equivalent whole-store operation, never on a\n * request path. Nothing in the framework calls it, and a caller with a user's request in hand\n * has no business using it — scope is what keeps tenants apart, and this steps over it.\n *\n * The scope comes back per row rather than being discarded, so a caller can write each row\n * back where it came from.\n *\n * DRAIN THE PAGE KEY: loop until `nextPageKey` comes back undefined. Every backend pages,\n * including the local one, deliberately so — a backend that returned everything in one call\n * would let a caller stop after the first page, be right locally, and silently skip most of\n * the data deployed. A local run has to be able to prove the loop.\n */\nexport function* askKeyValueStoreScanAllScopes<KvsItem>(\n  keyValueStoreName: string,\n  filterCondition?: KvsQueryOperation,\n  nextPageKey?: string,\n  options?: KeyValueStoreScanAllScopesOptions,\n): AskResponse<QpqPagedData<KvsScopedItem<KvsItem>>> {\n  return (yield* askKeyValueStoreScanAllScopesBase(keyValueStoreName, filterCondition, nextPageKey, options)) as QpqPagedData<KvsScopedItem<KvsItem>>;\n}\n"]}
+{"version":3,"file":"askKeyValueStoreScanAllScopes.js","sourceRoot":"","sources":["../../../../src/actions/keyValueStore/askKeyValueStoreScanAllScopes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAkBpE,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,EAAwC,CAAC;IAC7G,UAAU,EAAE,uBAAuB,CAAC,aAAa;IACjD,UAAU,EAAE;QACV,WAAW,EAAE,0DAA0D;QACvE,kBAAkB,EAAE,sCAAsC;QAC1D,eAAe,EAAE,iEAAiE;KACnF;IACD,UAAU,EAAE,CACV,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAA2C,EAC3C,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;CACpE,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAQ,CAAC,CAAC,kCAAkC,CAC1C,iBAAyB,EACzB,eAAmC,EACnC,WAAoB,EACpB,OAA2C;IAE3C,OAAO,CAAC,KAAK,CAAC,CAAC,iCAAiC,CAAC,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,CAAyC,CAAC;AACtJ,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC,kCAAkC,EAAE;IAC7F,SAAS,EAAE,iCAAiC,CAAC,SAAS;CACvD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { QpqPagedData } from '../../types/QpqPagedData';\nimport { AskResponse } from '../../types/StorySession';\nimport { KeyValueStoreActionType } from './KeyValueStoreActionType';\nimport { KvsQueryOperation } from './types';\n\n// One row and the scope it lives under. `scope` is absent for an unscoped row.\n//\n// The scope is reported rather than dropped BECAUSE this crosses scopes: a caller that reads\n// every tenant's rows in one pass has to know which tenant each belongs to, or anything it\n// writes back lands in the wrong partition. Handing back bare items would make silent\n// cross-tenant corruption the easy mistake.\nexport type KvsScopedItem<KvsItem> = {\n  scope?: string;\n  item: KvsItem;\n};\n\nexport type KeyValueStoreScanAllScopesOptions = {\n  limit?: number;\n};\n\nexport const askKeyValueStoreScanAllScopesBase = createActionRequester<QpqPagedData<KvsScopedItem<unknown>>>()({\n  actionType: KeyValueStoreActionType.ScanAllScopes,\n  errorTypes: [\n    'Throttled', // the store is throttling or failed internally; transient\n    'ResourceNotFound', // the underlying table does not exist\n    'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)\n  ],\n  getPayload: (\n    keyValueStoreName: string,\n    filterCondition?: KvsQueryOperation,\n    nextPageKey?: string,\n    options?: KeyValueStoreScanAllScopesOptions,\n  ) => ({ keyValueStoreName, filterCondition, nextPageKey, options }),\n});\n\n/**\n * Read EVERY row in a store, across every scope, each paired with the scope it lives under.\n *\n * This deliberately crosses the tenant boundary that the rest of the KVS layer works hard to\n * hold. An ordinary unscoped Scan cannot see scoped rows at all: the translator ANDs on a\n * predicate that excludes them, precisely so one tenant's request can never read another's.\n * That is the right default and nothing about it changes.\n *\n * The exception exists for MIGRATIONS, where the job is \"rewrite every row\" and any row you\n * cannot see is data you silently leave behind. The alternative is asking the app to\n * enumerate its own tenants and loop, which fails quietly the moment that list is incomplete.\n *\n * So: reach for this only from a migration or an equivalent whole-store operation, never on a\n * request path. Nothing in the framework calls it, and a caller with a user's request in hand\n * has no business using it, scope is what keeps tenants apart, and this steps over it.\n *\n * The scope comes back per row rather than being discarded, so a caller can write each row\n * back where it came from.\n *\n * DRAIN THE PAGE KEY: loop until `nextPageKey` comes back undefined. Every backend pages,\n * including the local one, deliberately so, a backend that returned everything in one call\n * would let a caller stop after the first page, be right locally, and silently skip most of\n * the data deployed. A local run has to be able to prove the loop.\n */\nfunction* askKeyValueStoreScanAllScopesTyped<KvsItem>(\n  keyValueStoreName: string,\n  filterCondition?: KvsQueryOperation,\n  nextPageKey?: string,\n  options?: KeyValueStoreScanAllScopesOptions,\n): AskResponse<QpqPagedData<KvsScopedItem<KvsItem>>> {\n  return (yield* askKeyValueStoreScanAllScopesBase(keyValueStoreName, filterCondition, nextPageKey, options)) as QpqPagedData<KvsScopedItem<KvsItem>>;\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askKeyValueStoreScanAllScopes = Object.assign(askKeyValueStoreScanAllScopesTyped, {\n  errorType: askKeyValueStoreScanAllScopesBase.errorType,\n});\n"]}

package/lib/esm/actions/keyValueStore/askKeyValueStoreUpdate.d.ts

@@ -11,5 +11,16 @@ export declare const askKeyValueStoreUpdateBase: import("../..").ActionRequester
     sortKey: KvsCoreDataType | undefined;
     updates: KvsUpdate;
     options: KeyValueStoreUpdateOptions | undefined;
-}, unknown, "ResourceNotFound" | "ServiceUnavailable" | "InvalidScope" | "StoreNotFound" | "ConditionFailed">;
-export declare function askKeyValueStoreUpdate<Value>(keyValueStoreName: string, updates: KvsUpdate, key: KvsCoreDataType, sortKey?: KvsCoreDataType, options?: KeyValueStoreUpdateOptions): AskResponse<Value>;
+}, unknown, "Throttled" | "ResourceNotFound" | "InvalidScope" | "StoreNotFound" | "ConditionFailed">;
+declare function askKeyValueStoreUpdateTyped<Value>(keyValueStoreName: string, updates: KvsUpdate, key: KvsCoreDataType, sortKey?: KvsCoreDataType, options?: KeyValueStoreUpdateOptions): AskResponse<Value>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askKeyValueStoreUpdate: typeof askKeyValueStoreUpdateTyped & {
+    errorType: {
+        Throttled: string;
+        ResourceNotFound: string;
+        InvalidScope: string;
+        StoreNotFound: string;
+        ConditionFailed: string;
+    };
+};
+export {};

package/lib/esm/actions/keyValueStore/askKeyValueStoreUpdate.js

@@ -1,9 +1,9 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { KeyValueStoreActionType } from './KeyValueStoreActionType';
 export const askKeyValueStoreUpdateBase = createActionRequester()({
     actionType: KeyValueStoreActionType.Update,
     errorTypes: [
-        'ServiceUnavailable', // DynamoDB internal error / throttling
+        'Throttled', // the store is throttling or failed internally; transient
         'ResourceNotFound', // the underlying table does not exist
         'InvalidScope', // scope is malformed or the store's partition key is not string-typed
         'StoreNotFound', // the store is not declared in the qpq config (misconfiguration)
@@ -16,7 +16,9 @@ export const askKeyValueStoreUpdateBase = createActionRequester()({
 });
 // The updated item's shape is only known to the caller, so the base returns unknown and
 // this story casts it to what the caller declared.
-export function* askKeyValueStoreUpdate(keyValueStoreName, updates, key, sortKey, options) {
+function* askKeyValueStoreUpdateTyped(keyValueStoreName, updates, key, sortKey, options) {
     return (yield* askKeyValueStoreUpdateBase(keyValueStoreName, updates, key, sortKey, options));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askKeyValueStoreUpdate = Object.assign(askKeyValueStoreUpdateTyped, { errorType: askKeyValueStoreUpdateBase.errorType });
 //# sourceMappingURL=askKeyValueStoreUpdate.js.map