@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/actions/network/askNetworkRequest.d.ts

@@ -1,5 +1,6 @@
 import { AskResponse } from '../../types/StorySession';
-import { HTTPMethod, HTTPNetworkResponse, HTTPRequestOptions, NetworkActionType, ResponseType } from './NetworkActionType';
+import { NetworkActionType } from './NetworkActionType';
+import { HTTPMethod, HTTPNetworkResponse, HTTPRequestOptions, ResponseType } from './types';
 export type NetworkRequestActionPayload<T> = {
     url: string;
     method: HTTPMethod;
@@ -10,4 +11,13 @@ export type NetworkRequestActionPayload<T> = {
     responseType: ResponseType;
 };
 export declare const askNetworkRequestBase: import("../..").ActionRequesterFunction<NetworkActionType, [method: HTTPMethod, url: string, httpRequestOptions?: HTTPRequestOptions<unknown> | undefined], NetworkRequestActionPayload<unknown>, HTTPNetworkResponse<unknown>, "Timeout" | "UnsupportedMethod" | "NetworkError">;
-export declare function askNetworkRequest<T, R>(method: HTTPMethod, url: string, httpRequestOptions?: HTTPRequestOptions<T>): AskResponse<HTTPNetworkResponse<R>>;
+declare function askNetworkRequestTyped<TResult, TPayload = unknown>(method: HTTPMethod, url: string, httpRequestOptions?: HTTPRequestOptions<TPayload>): AskResponse<HTTPNetworkResponse<TResult>>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askNetworkRequest: typeof askNetworkRequestTyped & {
+    errorType: {
+        Timeout: string;
+        UnsupportedMethod: string;
+        NetworkError: string;
+    };
+};
+export {};

package/lib/commonjs/actions/network/askNetworkRequest.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.askNetworkRequestBase = void 0;
-exports.askNetworkRequest = askNetworkRequest;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+exports.askNetworkRequest = exports.askNetworkRequestBase = void 0;
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const NetworkActionType_1 = require("./NetworkActionType");
 exports.askNetworkRequestBase = (0, createActionRequester_1.createActionRequester)()({
     actionType: NetworkActionType_1.NetworkActionType.Request,
@@ -23,7 +22,9 @@ exports.askNetworkRequestBase = (0, createActionRequester_1.createActionRequeste
 });
 // The request and response body types are only known to the caller, so the base takes
 // and returns unknown and this story casts to what the caller declared.
-function* askNetworkRequest(method, url, httpRequestOptions) {
+function* askNetworkRequestTyped(method, url, httpRequestOptions) {
     return (yield* (0, exports.askNetworkRequestBase)(method, url, httpRequestOptions));
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+exports.askNetworkRequest = Object.assign(askNetworkRequestTyped, { errorType: exports.askNetworkRequestBase.errorType });
 //# sourceMappingURL=askNetworkRequest.js.map

package/lib/commonjs/actions/network/askNetworkRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"askNetworkRequest.js","sourceRoot":"","sources":["../../../../src/actions/network/askNetworkRequest.ts"],"names":[],"mappings":";;;AAsCA,8CAOC;AA5CD,mFAAgF;AAChF,2DAA2H;AAe9G,QAAA,qBAAqB,GAAG,IAAA,6CAAqB,GAAgC,CAAC;IACzF,UAAU,EAAE,qCAAiB,CAAC,OAAO;IACrC,UAAU,EAAE;QACV,SAAS,EAAE,2DAA2D;QACtE,mBAAmB,EAAE,qDAAqD;QAC1E,cAAc,EAAE,kFAAkF;KACnG;IACD,UAAU,EAAE,CAAC,MAAkB,EAAE,GAAW,EAAE,kBAAgD,EAAwC,EAAE,CAAC,CAAC;QACxI,GAAG;QACH,MAAM;QAEN,IAAI,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,IAAI;QAC9B,OAAO,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,OAAO;QACpC,QAAQ,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,QAAQ;QACtC,MAAM,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,MAAM;QAClC,YAAY,EAAE,CAAA,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,YAAY,KAAI,MAAM;KACzD,CAAC;CACH,CAAC,CAAC;AAEH,sFAAsF;AACtF,wEAAwE;AACxE,QAAe,CAAC,CAAC,iBAAiB,CAChC,MAAkB,EAClB,GAAW,EAEX,kBAA0C;IAE1C,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,6BAAqB,EAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAA2B,CAAC;AACnG,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { HTTPMethod, HTTPNetworkResponse, HTTPRequestOptions, NetworkActionType, ResponseType } from './NetworkActionType';\n\n// Named because the processor layer (executeNetworkRequest) and the web-react hooks\n// build and consume this payload directly, without going through the requester.\nexport type NetworkRequestActionPayload<T> = {\n  url: string;\n  method: HTTPMethod;\n\n  body?: T;\n  basePath?: string;\n  params?: Record<string, string>;\n  headers?: Record<string, string>;\n  responseType: ResponseType;\n};\n\nexport const askNetworkRequestBase = createActionRequester<HTTPNetworkResponse<unknown>>()({\n  actionType: NetworkActionType.Request,\n  errorTypes: [\n    'Timeout', // the request exceeded the request timeout and was aborted\n    'UnsupportedMethod', // the HTTP method is one the runtime refuses to send\n    'NetworkError', // no response came back: no connection, DNS failure, CORS block, unparseable body\n  ],\n  getPayload: (method: HTTPMethod, url: string, httpRequestOptions?: HTTPRequestOptions<unknown>): NetworkRequestActionPayload<unknown> => ({\n    url,\n    method,\n\n    body: httpRequestOptions?.body,\n    headers: httpRequestOptions?.headers,\n    basePath: httpRequestOptions?.basePath,\n    params: httpRequestOptions?.params,\n    responseType: httpRequestOptions?.responseType || 'json',\n  }),\n});\n\n// The request and response body types are only known to the caller, so the base takes\n// and returns unknown and this story casts to what the caller declared.\nexport function* askNetworkRequest<T, R>(\n  method: HTTPMethod,\n  url: string,\n\n  httpRequestOptions?: HTTPRequestOptions<T>,\n): AskResponse<HTTPNetworkResponse<R>> {\n  return (yield* askNetworkRequestBase(method, url, httpRequestOptions)) as HTTPNetworkResponse<R>;\n}\n"]}
+{"version":3,"file":"askNetworkRequest.js","sourceRoot":"","sources":["../../../../src/actions/network/askNetworkRequest.ts"],"names":[],"mappings":";;;AAAA,qFAAkF;AAElF,2DAAwD;AAgB3C,QAAA,qBAAqB,GAAG,IAAA,6CAAqB,GAAgC,CAAC;IACzF,UAAU,EAAE,qCAAiB,CAAC,OAAO;IACrC,UAAU,EAAE;QACV,SAAS,EAAE,2DAA2D;QACtE,mBAAmB,EAAE,qDAAqD;QAC1E,cAAc,EAAE,kFAAkF;KACnG;IACD,UAAU,EAAE,CAAC,MAAkB,EAAE,GAAW,EAAE,kBAAgD,EAAwC,EAAE,CAAC,CAAC;QACxI,GAAG;QACH,MAAM;QAEN,IAAI,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,IAAI;QAC9B,OAAO,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,OAAO;QACpC,QAAQ,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,QAAQ;QACtC,MAAM,EAAE,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,MAAM;QAClC,YAAY,EAAE,CAAA,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,YAAY,KAAI,MAAM;KACzD,CAAC;CACH,CAAC,CAAC;AAEH,sFAAsF;AACtF,wEAAwE;AACxE,QAAQ,CAAC,CAAC,sBAAsB,CAC9B,MAAkB,EAClB,GAAW,EACX,kBAAiD;IAEjD,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,6BAAqB,EAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAiC,CAAC;AACzG,CAAC;AAED,mFAAmF;AACtE,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,6BAAqB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { NetworkActionType } from './NetworkActionType';\nimport { HTTPMethod, HTTPNetworkResponse, HTTPRequestOptions, ResponseType } from './types';\n\n// Named because the processor layer (executeNetworkRequest) and the web-react hooks\n// build and consume this payload directly, without going through the requester.\nexport type NetworkRequestActionPayload<T> = {\n  url: string;\n  method: HTTPMethod;\n\n  body?: T;\n  basePath?: string;\n  params?: Record<string, string>;\n  headers?: Record<string, string>;\n  responseType: ResponseType;\n};\n\nexport const askNetworkRequestBase = createActionRequester<HTTPNetworkResponse<unknown>>()({\n  actionType: NetworkActionType.Request,\n  errorTypes: [\n    'Timeout', // the request exceeded the request timeout and was aborted\n    'UnsupportedMethod', // the HTTP method is one the runtime refuses to send\n    'NetworkError', // no response came back: no connection, DNS failure, CORS block, unparseable body\n  ],\n  getPayload: (method: HTTPMethod, url: string, httpRequestOptions?: HTTPRequestOptions<unknown>): NetworkRequestActionPayload<unknown> => ({\n    url,\n    method,\n\n    body: httpRequestOptions?.body,\n    headers: httpRequestOptions?.headers,\n    basePath: httpRequestOptions?.basePath,\n    params: httpRequestOptions?.params,\n    responseType: httpRequestOptions?.responseType || 'json',\n  }),\n});\n\n// The request and response body types are only known to the caller, so the base takes\n// and returns unknown and this story casts to what the caller declared.\nfunction* askNetworkRequestTyped<TResult, TPayload = unknown>(\n  method: HTTPMethod,\n  url: string,\n  httpRequestOptions?: HTTPRequestOptions<TPayload>,\n): AskResponse<HTTPNetworkResponse<TResult>> {\n  return (yield* askNetworkRequestBase(method, url, httpRequestOptions)) as HTTPNetworkResponse<TResult>;\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askNetworkRequest = Object.assign(askNetworkRequestTyped, { errorType: askNetworkRequestBase.errorType });\n"]}

package/lib/commonjs/actions/network/index.d.ts

@@ -1,2 +1,3 @@
 export * from './askNetworkRequest';
 export * from './NetworkActionType';
+export * from './types';

package/lib/commonjs/actions/network/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./askNetworkRequest"), exports);
 __exportStar(require("./NetworkActionType"), exports);
+__exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/actions/network/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/network/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,sDAAoC","sourcesContent":["export * from './askNetworkRequest';\nexport * from './NetworkActionType';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/network/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,sDAAoC;AACpC,0CAAwB","sourcesContent":["export * from './askNetworkRequest';\nexport * from './NetworkActionType';\nexport * from './types';\n"]}

package/lib/commonjs/actions/network/types/HTTPMethod.d.ts

@@ -0,0 +1 @@
+export type HTTPMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'PATCH';

package/lib/commonjs/actions/network/types/HTTPMethod.js

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

package/lib/commonjs/actions/network/types/HTTPMethod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPMethod.js","sourceRoot":"","sources":["../../../../../src/actions/network/types/HTTPMethod.ts"],"names":[],"mappings":"","sourcesContent":["export type HTTPMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'PATCH';\n"]}

package/lib/commonjs/actions/network/types/HTTPNetworkResponse.d.ts

@@ -0,0 +1,7 @@
+export type HTTPNetworkResponse<T> = {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    setCookies: string[];
+};

package/lib/commonjs/actions/network/types/HTTPNetworkResponse.js

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

package/lib/commonjs/actions/network/types/HTTPNetworkResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPNetworkResponse.js","sourceRoot":"","sources":["../../../../../src/actions/network/types/HTTPNetworkResponse.ts"],"names":[],"mappings":"","sourcesContent":["export type HTTPNetworkResponse<T> = {\n  data: T;\n  status: number;\n  statusText: string;\n  headers: Record<string, string>;\n\n  // Raw Set-Cookie header lines, attributes intact, in response order. `headers` can only\n  // carry the last one (fetch collapses duplicates), so multi-cookie logins need this list.\n  // Always [] in browser runtimes: Set-Cookie is a forbidden response header in browser fetch.\n  setCookies: string[];\n};\n"]}

package/lib/commonjs/actions/network/types/HTTPRequestOptions.d.ts

@@ -0,0 +1,8 @@
+import { ResponseType } from './ResponseType';
+export type HTTPRequestOptions<T> = {
+    basePath?: string;
+    params?: Record<string, string>;
+    headers?: Record<string, string>;
+    body?: T;
+    responseType?: ResponseType;
+};

package/lib/commonjs/actions/network/types/HTTPRequestOptions.js

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

package/lib/commonjs/actions/network/types/HTTPRequestOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPRequestOptions.js","sourceRoot":"","sources":["../../../../../src/actions/network/types/HTTPRequestOptions.ts"],"names":[],"mappings":"","sourcesContent":["import { ResponseType } from './ResponseType';\n\nexport type HTTPRequestOptions<T> = {\n  basePath?: string;\n  params?: Record<string, string>;\n  headers?: Record<string, string>;\n  body?: T;\n  responseType?: ResponseType;\n};\n"]}

package/lib/commonjs/actions/network/types/ResponseType.d.ts

@@ -0,0 +1 @@
+export type ResponseType = 'binary' | 'json' | 'text';

package/lib/commonjs/actions/network/types/ResponseType.js

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

package/lib/commonjs/actions/network/types/ResponseType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseType.js","sourceRoot":"","sources":["../../../../../src/actions/network/types/ResponseType.ts"],"names":[],"mappings":"","sourcesContent":["export type ResponseType = 'binary' | 'json' | 'text';\n"]}

package/lib/commonjs/actions/network/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './HTTPMethod';
+export * from './HTTPNetworkResponse';
+export * from './HTTPRequestOptions';
+export * from './ResponseType';

package/lib/commonjs/actions/network/types/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./HTTPMethod"), exports);
+__exportStar(require("./HTTPNetworkResponse"), exports);
+__exportStar(require("./HTTPRequestOptions"), exports);
+__exportStar(require("./ResponseType"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/actions/network/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/actions/network/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,wDAAsC;AACtC,uDAAqC;AACrC,iDAA+B","sourcesContent":["export * from './HTTPMethod';\nexport * from './HTTPNetworkResponse';\nexport * from './HTTPRequestOptions';\nexport * from './ResponseType';\n"]}

package/lib/commonjs/actions/platform/askPlatformDelay.d.ts

@@ -0,0 +1,4 @@
+import { PlatformActionType } from './PlatformActionType';
+export declare const askPlatformDelay: import("../..").ActionRequesterFunction<PlatformActionType.Delay, [timeMs: number], {
+    timeMs: number;
+}, void, never>;

package/lib/commonjs/actions/platform/askPlatformDelay.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askPlatformDelay = void 0;
+const actions_1 = require("../../logic/actions");
+const PlatformActionType_1 = require("./PlatformActionType");
+exports.askPlatformDelay = (0, actions_1.createActionRequester)()({
+    actionType: PlatformActionType_1.PlatformActionType.Delay,
+    getPayload: (timeMs) => ({ timeMs }),
+});
+//# sourceMappingURL=askPlatformDelay.js.map

package/lib/commonjs/actions/platform/askPlatformDelay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askPlatformDelay.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformDelay.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,6DAA0D;AAE7C,QAAA,gBAAgB,GAAG,IAAA,+BAAqB,GAAQ,CAAC;IAC5D,UAAU,EAAE,uCAAkB,CAAC,KAAK;IACpC,UAAU,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7C,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { PlatformActionType } from './PlatformActionType';\n\nexport const askPlatformDelay = createActionRequester<void>()({\n  actionType: PlatformActionType.Delay,\n  getPayload: (timeMs: number) => ({ timeMs }),\n});\n"]}

package/lib/commonjs/actions/platform/askPlatformGetName.d.ts

@@ -5,4 +5,4 @@ import { PlatformActionType } from './PlatformActionType';
  * platform cannot do (a smoke test with no local equivalent, say). Never branch on it
  * for ordinary logic; that is what action processors are for.
  */
-export declare const askPlatformGetName: import("../../types").ActionRequesterFunction<PlatformActionType.GetName, [], {}, string, never>;
+export declare const askPlatformGetName: import("../..").ActionRequesterFunction<PlatformActionType.GetName, [], undefined, string, never>;

package/lib/commonjs/actions/platform/askPlatformGetName.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askPlatformGetName = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const PlatformActionType_1 = require("./PlatformActionType");
 /**
  * The name of the runtime executing the story, as its action processor set declares it.
@@ -9,8 +9,7 @@ const PlatformActionType_1 = require("./PlatformActionType");
  * platform cannot do (a smoke test with no local equivalent, say). Never branch on it
  * for ordinary logic; that is what action processors are for.
  */
-exports.askPlatformGetName = (0, types_1.createActionRequester)()({
+exports.askPlatformGetName = (0, actions_1.createActionRequester)()({
     actionType: PlatformActionType_1.PlatformActionType.GetName,
-    getPayload: () => ({}),
 });
 //# sourceMappingURL=askPlatformGetName.js.map

package/lib/commonjs/actions/platform/askPlatformGetName.js.map

@@ -1 +1 @@
-{"version":3,"file":"askPlatformGetName.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformGetName.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,6DAA0D;AAE1D;;;;;GAKG;AACU,QAAA,kBAAkB,GAAG,IAAA,6BAAqB,GAAU,CAAC;IAChE,UAAU,EAAE,uCAAkB,CAAC,OAAO;IACtC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CACvB,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { PlatformActionType } from './PlatformActionType';\n\n/**\n * The name of the runtime executing the story, as its action processor set declares it.\n * An opaque string a story compares against a known constant to skip or degrade work a\n * platform cannot do (a smoke test with no local equivalent, say). Never branch on it\n * for ordinary logic; that is what action processors are for.\n */\nexport const askPlatformGetName = createActionRequester<string>()({\n  actionType: PlatformActionType.GetName,\n  getPayload: () => ({}),\n});\n"]}
+{"version":3,"file":"askPlatformGetName.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformGetName.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,6DAA0D;AAE1D;;;;;GAKG;AACU,QAAA,kBAAkB,GAAG,IAAA,+BAAqB,GAAU,CAAC;IAChE,UAAU,EAAE,uCAAkB,CAAC,OAAO;CACvC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { PlatformActionType } from './PlatformActionType';\n\n/**\n * The name of the runtime executing the story, as its action processor set declares it.\n * An opaque string a story compares against a known constant to skip or degrade work a\n * platform cannot do (a smoke test with no local equivalent, say). Never branch on it\n * for ordinary logic; that is what action processors are for.\n */\nexport const askPlatformGetName = createActionRequester<string>()({\n  actionType: PlatformActionType.GetName,\n});\n"]}

package/lib/commonjs/actions/platform/index.d.ts

@@ -1,3 +1,3 @@
-export * from './askDelay';
+export * from './askPlatformDelay';
 export * from './askPlatformGetName';
 export * from './PlatformActionType';

package/lib/commonjs/actions/platform/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./askDelay"), exports);
+__exportStar(require("./askPlatformDelay"), exports);
 __exportStar(require("./askPlatformGetName"), exports);
 __exportStar(require("./PlatformActionType"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/actions/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/platform/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,uDAAqC;AACrC,uDAAqC","sourcesContent":["export * from './askDelay';\nexport * from './askPlatformGetName';\nexport * from './PlatformActionType';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/platform/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC","sourcesContent":["export * from './askPlatformDelay';\nexport * from './askPlatformGetName';\nexport * from './PlatformActionType';\n"]}

package/lib/commonjs/actions/queue/QueueActionType.d.ts

@@ -1,3 +1,3 @@
 export declare enum QueueActionType {
-    SendMessages = "@quidproquo-core/Queue/SendMessage"
+    SendMessage = "@quidproquo-core/Queue/SendMessage"
 }

package/lib/commonjs/actions/queue/QueueActionType.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.QueueActionType = void 0;
 var QueueActionType;
 (function (QueueActionType) {
-    QueueActionType["SendMessages"] = "@quidproquo-core/Queue/SendMessage";
+    QueueActionType["SendMessage"] = "@quidproquo-core/Queue/SendMessage";
 })(QueueActionType || (exports.QueueActionType = QueueActionType = {}));
 //# sourceMappingURL=QueueActionType.js.map

package/lib/commonjs/actions/queue/QueueActionType.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueueActionType.js","sourceRoot":"","sources":["../../../../src/actions/queue/QueueActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,sEAAmD,CAAA;AACrD,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B","sourcesContent":["export enum QueueActionType {\n  SendMessages = '@quidproquo-core/Queue/SendMessage',\n}\n"]}
+{"version":3,"file":"QueueActionType.js","sourceRoot":"","sources":["../../../../src/actions/queue/QueueActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,qEAAkD,CAAA;AACpD,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B","sourcesContent":["export enum QueueActionType {\n  SendMessage = '@quidproquo-core/Queue/SendMessage',\n}\n"]}

package/lib/commonjs/actions/queue/askQueueSendMessages.d.ts

@@ -10,5 +10,14 @@ export type QueueMessage<T> = CrossModuleMessage<T> & {
 export declare const askQueueSendMessagesBase: import("../../types").ActionRequesterFunction<QueueActionType, [queueName: string, queueMessages: QueueMessage<any>[]], {
     queueMessages: QueueMessage<any>[];
     queueName: string;
-}, void, "AccessDenied" | "ServiceUnavailable" | "QueueNotFound">;
-export declare function askQueueSendMessages<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void>;
+}, void, "Throttled" | "AccessDenied" | "QueueNotFound">;
+declare function askQueueSendMessagesTyped<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askQueueSendMessages: typeof askQueueSendMessagesTyped & {
+    errorType: {
+        Throttled: string;
+        AccessDenied: string;
+        QueueNotFound: string;
+    };
+};
+export {};

package/lib/commonjs/actions/queue/askQueueSendMessages.js

@@ -1,20 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.askQueueSendMessagesBase = void 0;
-exports.askQueueSendMessages = askQueueSendMessages;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+exports.askQueueSendMessages = exports.askQueueSendMessagesBase = void 0;
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const QueueActionType_1 = require("./QueueActionType");
 exports.askQueueSendMessagesBase = (0, createActionRequester_1.createActionRequester)()({
-    actionType: QueueActionType_1.QueueActionType.SendMessages,
+    actionType: QueueActionType_1.QueueActionType.SendMessage,
     errorTypes: [
         'AccessDenied', // caller lacks permission to send to the queue
-        'QueueNotFound', // the SQS queue does not exist
-        'ServiceUnavailable', // SQS internal error / throttling
+        'QueueNotFound', // the queue does not exist
+        'Throttled', // the queue is throttling or failed internally; transient
     ],
     getPayload: (queueName, queueMessages) => ({ queueMessages, queueName }),
 });
 // Generic so callers can pin the message body shape at the call site.
-function* askQueueSendMessages(queueName, ...queueMessages) {
+function* askQueueSendMessagesTyped(queueName, ...queueMessages) {
     return yield* (0, exports.askQueueSendMessagesBase)(queueName, queueMessages);
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+exports.askQueueSendMessages = Object.assign(askQueueSendMessagesTyped, { errorType: exports.askQueueSendMessagesBase.errorType });
 //# sourceMappingURL=askQueueSendMessages.js.map

package/lib/commonjs/actions/queue/askQueueSendMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"askQueueSendMessages.js","sourceRoot":"","sources":["../../../../src/actions/queue/askQueueSendMessages.ts"],"names":[],"mappings":";;;AAwBA,oDAEC;AAxBD,mFAAgF;AAChF,uDAAoD;AAUvC,QAAA,wBAAwB,GAAG,IAAA,6CAAqB,GAAQ,CAAC;IACpE,UAAU,EAAE,iCAAe,CAAC,YAAY;IACxC,UAAU,EAAE;QACV,cAAc,EAAE,+CAA+C;QAC/D,eAAe,EAAE,+BAA+B;QAChD,oBAAoB,EAAE,kCAAkC;KACzD;IACD,UAAU,EAAE,CAAC,SAAiB,EAAE,aAAkC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;CACtG,CAAC,CAAC;AAEH,sEAAsE;AACtE,QAAe,CAAC,CAAC,oBAAoB,CAA8B,SAAiB,EAAE,GAAG,aAAkB;IACzG,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAwB,EAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import { CrossModuleMessage } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { QueueActionType } from './QueueActionType';\n\nexport type QueueMessage<T> = CrossModuleMessage<T> & {\n  /** FIFO queues only: message group for ordering. Defaults to the queue name (global ordering). */\n  groupId?: string;\n\n  /** FIFO queues only: dedup id (5-min SQS window). Defaults to a generated uuid (no dedup). */\n  deduplicationId?: string;\n};\n\nexport const askQueueSendMessagesBase = createActionRequester<void>()({\n  actionType: QueueActionType.SendMessages,\n  errorTypes: [\n    'AccessDenied', // caller lacks permission to send to the queue\n    'QueueNotFound', // the SQS queue does not exist\n    'ServiceUnavailable', // SQS internal error / throttling\n  ],\n  getPayload: (queueName: string, queueMessages: QueueMessage<any>[]) => ({ queueMessages, queueName }),\n});\n\n// Generic so callers can pin the message body shape at the call site.\nexport function* askQueueSendMessages<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void> {\n  return yield* askQueueSendMessagesBase(queueName, queueMessages);\n}\n"]}
+{"version":3,"file":"askQueueSendMessages.js","sourceRoot":"","sources":["../../../../src/actions/queue/askQueueSendMessages.ts"],"names":[],"mappings":";;;AAAA,qFAAkF;AAGlF,uDAAoD;AAUvC,QAAA,wBAAwB,GAAG,IAAA,6CAAqB,GAAQ,CAAC;IACpE,UAAU,EAAE,iCAAe,CAAC,WAAW;IACvC,UAAU,EAAE;QACV,cAAc,EAAE,+CAA+C;QAC/D,eAAe,EAAE,2BAA2B;QAC5C,WAAW,EAAE,0DAA0D;KACxE;IACD,UAAU,EAAE,CAAC,SAAiB,EAAE,aAAkC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;CACtG,CAAC,CAAC;AAEH,sEAAsE;AACtE,QAAQ,CAAC,CAAC,yBAAyB,CAA8B,SAAiB,EAAE,GAAG,aAAkB;IACvG,OAAO,KAAK,CAAC,CAAC,IAAA,gCAAwB,EAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED,mFAAmF;AACtE,QAAA,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,gCAAwB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { CrossModuleMessage } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { QueueActionType } from './QueueActionType';\n\nexport type QueueMessage<T> = CrossModuleMessage<T> & {\n  /** FIFO queues only: message group for ordering. Defaults to the queue name (global ordering). */\n  groupId?: string;\n\n  /** FIFO queues only: dedup id (5-min SQS window). Defaults to a generated uuid (no dedup). */\n  deduplicationId?: string;\n};\n\nexport const askQueueSendMessagesBase = createActionRequester<void>()({\n  actionType: QueueActionType.SendMessage,\n  errorTypes: [\n    'AccessDenied', // caller lacks permission to send to the queue\n    'QueueNotFound', // the queue does not exist\n    'Throttled', // the queue is throttling or failed internally; transient\n  ],\n  getPayload: (queueName: string, queueMessages: QueueMessage<any>[]) => ({ queueMessages, queueName }),\n});\n\n// Generic so callers can pin the message body shape at the call site.\nfunction* askQueueSendMessagesTyped<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void> {\n  return yield* askQueueSendMessagesBase(queueName, queueMessages);\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askQueueSendMessages = Object.assign(askQueueSendMessagesTyped, { errorType: askQueueSendMessagesBase.errorType });\n"]}

package/lib/commonjs/actions/secureToken/askSecureTokenGenerate.d.ts

@@ -5,6 +5,6 @@ import { SecureTokenActionType } from './SecureTokenActionType';
  * characters). The admin log redaction treats the result as a secret: it's blanked in this action's
  * entry and swept from every other string in the story's log.
  */
-export declare const askSecureTokenGenerate: import("../../types").ActionRequesterFunction<SecureTokenActionType, [byteLength?: number | undefined], {
+export declare const askSecureTokenGenerate: import("../..").ActionRequesterFunction<SecureTokenActionType, [byteLength?: number | undefined], {
     byteLength: number;
 }, string, "InvalidByteLength" | "RandomSourceUnavailable">;

package/lib/commonjs/actions/secureToken/askSecureTokenGenerate.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askSecureTokenGenerate = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const SecureTokenActionType_1 = require("./SecureTokenActionType");
 /**
  * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the
@@ -9,7 +9,7 @@ const SecureTokenActionType_1 = require("./SecureTokenActionType");
  * characters). The admin log redaction treats the result as a secret: it's blanked in this action's
  * entry and swept from every other string in the story's log.
  */
-exports.askSecureTokenGenerate = (0, types_1.createActionRequester)()({
+exports.askSecureTokenGenerate = (0, actions_1.createActionRequester)()({
     actionType: SecureTokenActionType_1.SecureTokenActionType.Generate,
     errorTypes: [
         'InvalidByteLength', // not a whole number from 1 to SECURE_TOKEN_MAX_BYTE_LENGTH

package/lib/commonjs/actions/secureToken/askSecureTokenGenerate.js.map

@@ -1 +1 @@
-{"version":3,"file":"askSecureTokenGenerate.js","sourceRoot":"","sources":["../../../../src/actions/secureToken/askSecureTokenGenerate.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,mEAAgE;AAEhE;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,IAAA,6BAAqB,GAAU,CAAC;IACpE,UAAU,EAAE,6CAAqB,CAAC,QAAQ;IAC1C,UAAU,EAAE;QACV,mBAAmB,EAAE,4DAA4D;QACjF,yBAAyB,EAAE,oCAAoC;KAChE;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { SecureTokenActionType } from './SecureTokenActionType';\n\n/**\n * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the\n * platform's secure random source, as lowercase hex (so 32 bytes, the default and 256 bits, is 64\n * characters). The admin log redaction treats the result as a secret: it's blanked in this action's\n * entry and swept from every other string in the story's log.\n */\nexport const askSecureTokenGenerate = createActionRequester<string>()({\n  actionType: SecureTokenActionType.Generate,\n  errorTypes: [\n    'InvalidByteLength', // not a whole number from 1 to SECURE_TOKEN_MAX_BYTE_LENGTH\n    'RandomSourceUnavailable', // no Web Crypto API in this runtime\n  ],\n  getPayload: (byteLength: number = 32) => ({ byteLength }),\n});\n"]}
+{"version":3,"file":"askSecureTokenGenerate.js","sourceRoot":"","sources":["../../../../src/actions/secureToken/askSecureTokenGenerate.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,mEAAgE;AAEhE;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,IAAA,+BAAqB,GAAU,CAAC;IACpE,UAAU,EAAE,6CAAqB,CAAC,QAAQ;IAC1C,UAAU,EAAE;QACV,mBAAmB,EAAE,4DAA4D;QACjF,yBAAyB,EAAE,oCAAoC;KAChE;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { SecureTokenActionType } from './SecureTokenActionType';\n\n/**\n * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the\n * platform's secure random source, as lowercase hex (so 32 bytes, the default and 256 bits, is 64\n * characters). The admin log redaction treats the result as a secret: it's blanked in this action's\n * entry and swept from every other string in the story's log.\n */\nexport const askSecureTokenGenerate = createActionRequester<string>()({\n  actionType: SecureTokenActionType.Generate,\n  errorTypes: [\n    'InvalidByteLength', // not a whole number from 1 to SECURE_TOKEN_MAX_BYTE_LENGTH\n    'RandomSourceUnavailable', // no Web Crypto API in this runtime\n  ],\n  getPayload: (byteLength: number = 32) => ({ byteLength }),\n});\n"]}

package/lib/commonjs/actions/state/askStateDispatch.d.ts

@@ -1,13 +1,8 @@
-import { Action } from '../../types/Action';
 import { AskResponse } from '../../types/StorySession';
 import { StateActionType } from './StateActionType';
 export type StateDispatchActionPayload<T> = {
     action: T;
 };
-export interface StateDispatchAction<T> extends Action<StateDispatchActionPayload<T>> {
-    type: StateActionType.Dispatch;
-    payload: StateDispatchActionPayload<T>;
-}
 export declare const askStateDispatchBase: import("../..").ActionRequesterFunction<StateActionType.Dispatch, [action: unknown], {
     action: unknown;
 }, void, never>;

package/lib/commonjs/actions/state/askStateDispatch.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askStateDispatchBase = void 0;
 exports.askStateDispatch = askStateDispatch;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const StateActionType_1 = require("./StateActionType");
 exports.askStateDispatchBase = (0, createActionRequester_1.createActionRequester)()({
     actionType: StateActionType_1.StateActionType.Dispatch,

package/lib/commonjs/actions/state/askStateDispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStateDispatch.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateDispatch.ts"],"names":[],"mappings":";;;AAoBA,4CAEC;AApBD,mFAAgF;AAChF,uDAAoD;AAWvC,QAAA,oBAAoB,GAAG,IAAA,6CAAqB,GAAQ,CAAC;IAChE,UAAU,EAAE,iCAAe,CAAC,QAAQ;IACpC,UAAU,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,4FAA4F;AAC5F,QAAe,CAAC,CAAC,gBAAgB,CAAI,MAAS;IAC5C,OAAO,KAAK,CAAC,CAAC,IAAA,4BAAoB,EAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StateActionType } from './StateActionType';\n\nexport type StateDispatchActionPayload<T> = {\n  action: T;\n};\n\nexport interface StateDispatchAction<T> extends Action<StateDispatchActionPayload<T>> {\n  type: StateActionType.Dispatch;\n  payload: StateDispatchActionPayload<T>;\n}\n\nexport const askStateDispatchBase = createActionRequester<void>()({\n  actionType: StateActionType.Dispatch,\n  getPayload: (action: unknown) => ({ action }),\n});\n\n// Generic so callers can pin the effect/action shape they are dispatching at the call site.\nexport function* askStateDispatch<T>(action: T): AskResponse<void> {\n  return yield* askStateDispatchBase(action);\n}\n"]}
+{"version":3,"file":"askStateDispatch.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateDispatch.ts"],"names":[],"mappings":";;;AAcA,4CAEC;AAhBD,qFAAkF;AAElF,uDAAoD;AAMvC,QAAA,oBAAoB,GAAG,IAAA,6CAAqB,GAAQ,CAAC;IAChE,UAAU,EAAE,iCAAe,CAAC,QAAQ;IACpC,UAAU,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,4FAA4F;AAC5F,QAAe,CAAC,CAAC,gBAAgB,CAAI,MAAS;IAC5C,OAAO,KAAK,CAAC,CAAC,IAAA,4BAAoB,EAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StateActionType } from './StateActionType';\n\nexport type StateDispatchActionPayload<T> = {\n  action: T;\n};\n\nexport const askStateDispatchBase = createActionRequester<void>()({\n  actionType: StateActionType.Dispatch,\n  getPayload: (action: unknown) => ({ action }),\n});\n\n// Generic so callers can pin the effect/action shape they are dispatching at the call site.\nexport function* askStateDispatch<T>(action: T): AskResponse<void> {\n  return yield* askStateDispatchBase(action);\n}\n"]}

package/lib/commonjs/actions/state/askStateRead.d.ts

@@ -1,13 +1,8 @@
-import { Action } from '../../types/Action';
 import { AskResponse } from '../../types/StorySession';
 import { StateActionType } from './StateActionType';
 export type StateReadActionPayload = {
     path?: string;
 };
-export interface StateReadAction extends Action<StateReadActionPayload> {
-    type: StateActionType.Read;
-    payload: StateReadActionPayload;
-}
 export declare const askStateReadBase: import("../..").ActionRequesterFunction<StateActionType.Read, [path?: string | undefined], {
     path: string | undefined;
 }, unknown, never>;

package/lib/commonjs/actions/state/askStateRead.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askStateReadBase = void 0;
 exports.askStateRead = askStateRead;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const StateActionType_1 = require("./StateActionType");
 exports.askStateReadBase = (0, createActionRequester_1.createActionRequester)()({
     actionType: StateActionType_1.StateActionType.Read,

package/lib/commonjs/actions/state/askStateRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStateRead.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateRead.ts"],"names":[],"mappings":";;;AAqBA,oCAEC;AArBD,mFAAgF;AAChF,uDAAoD;AAWvC,QAAA,gBAAgB,GAAG,IAAA,6CAAqB,GAAW,CAAC;IAC/D,UAAU,EAAE,iCAAe,CAAC,IAAI;IAChC,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,uFAAuF;AACvF,+DAA+D;AAC/D,QAAe,CAAC,CAAC,YAAY,CAAI,IAAa;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,wBAAgB,EAAC,IAAI,CAAC,CAAM,CAAC;AAC9C,CAAC","sourcesContent":["import { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StateActionType } from './StateActionType';\n\nexport type StateReadActionPayload = {\n  path?: string;\n};\n\nexport interface StateReadAction extends Action<StateReadActionPayload> {\n  type: StateActionType.Read;\n  payload: StateReadActionPayload;\n}\n\nexport const askStateReadBase = createActionRequester<unknown>()({\n  actionType: StateActionType.Read,\n  getPayload: (path?: string) => ({ path }),\n});\n\n// The state's shape at the given path is only known to the caller, so the base returns\n// unknown and this story casts it to what the caller declared.\nexport function* askStateRead<R>(path?: string): AskResponse<R> {\n  return (yield* askStateReadBase(path)) as R;\n}\n"]}
+{"version":3,"file":"askStateRead.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateRead.ts"],"names":[],"mappings":";;;AAeA,oCAEC;AAjBD,qFAAkF;AAElF,uDAAoD;AAMvC,QAAA,gBAAgB,GAAG,IAAA,6CAAqB,GAAW,CAAC;IAC/D,UAAU,EAAE,iCAAe,CAAC,IAAI;IAChC,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,uFAAuF;AACvF,+DAA+D;AAC/D,QAAe,CAAC,CAAC,YAAY,CAAI,IAAa;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,wBAAgB,EAAC,IAAI,CAAC,CAAM,CAAC;AAC9C,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StateActionType } from './StateActionType';\n\nexport type StateReadActionPayload = {\n  path?: string;\n};\n\nexport const askStateReadBase = createActionRequester<unknown>()({\n  actionType: StateActionType.Read,\n  getPayload: (path?: string) => ({ path }),\n});\n\n// The state's shape at the given path is only known to the caller, so the base returns\n// unknown and this story casts it to what the caller declared.\nexport function* askStateRead<R>(path?: string): AskResponse<R> {\n  return (yield* askStateReadBase(path)) as R;\n}\n"]}

package/lib/commonjs/actions/stream/askStreamClose.d.ts

@@ -1,5 +1,5 @@
 import { StreamHandle } from '../../types/StreamRegistry';
 import { StreamActionType } from './StreamActionType';
-export declare const askStreamClose: import("../../types").ActionRequesterFunction<StreamActionType.Close, [handle: StreamHandle<import("../../types").StreamEncoding, unknown>], {
+export declare const askStreamClose: import("../..").ActionRequesterFunction<StreamActionType.Close, [handle: StreamHandle], {
     streamId: string;
 }, void, never>;

package/lib/commonjs/actions/stream/askStreamClose.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askStreamClose = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const StreamActionType_1 = require("./StreamActionType");
-exports.askStreamClose = (0, types_1.createActionRequester)()({
+exports.askStreamClose = (0, actions_1.createActionRequester)()({
     actionType: StreamActionType_1.StreamActionType.Close,
     getPayload: (handle) => ({ streamId: handle.id }),
 });

package/lib/commonjs/actions/stream/askStreamClose.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStreamClose.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamClose.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,yDAAsD;AAEzC,QAAA,cAAc,GAAG,IAAA,6BAAqB,GAAQ,CAAC;IAC1D,UAAU,EAAE,mCAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;CAChE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nexport const askStreamClose = createActionRequester<void>()({\n  actionType: StreamActionType.Close,\n  getPayload: (handle: StreamHandle) => ({ streamId: handle.id }),\n});\n"]}
+{"version":3,"file":"askStreamClose.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamClose.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAE5D,yDAAsD;AAEzC,QAAA,cAAc,GAAG,IAAA,+BAAqB,GAAQ,CAAC;IAC1D,UAAU,EAAE,mCAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;CAChE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nexport const askStreamClose = createActionRequester<void>()({\n  actionType: StreamActionType.Close,\n  getPayload: (handle: StreamHandle) => ({ streamId: handle.id }),\n});\n"]}

package/lib/commonjs/actions/stream/askStreamRead.d.ts

@@ -4,5 +4,13 @@ import { StreamActionType } from './StreamActionType';
 export declare const askStreamReadBase: import("../..").ActionRequesterFunction<StreamActionType.Read, [streamId: string, noWait?: boolean | undefined], {
     streamId: string;
     noWait: boolean | undefined;
-}, StreamChunk<string>, never>;
-export declare function askStreamRead<E extends StreamEncoding, T = unknown>(handle: StreamHandle<E, T>, noWait?: boolean): AskResponse<StreamChunk<StreamDataType<E, T>>>;
+}, StreamChunk<string>, "StreamNotFound" | "StreamFailed">;
+declare function askStreamReadTyped<E extends StreamEncoding, T = unknown>(handle: StreamHandle<E, T>, noWait?: boolean): AskResponse<StreamChunk<StreamDataType<E, T>>>;
+/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askStreamRead: typeof askStreamReadTyped & {
+    errorType: {
+        StreamNotFound: string;
+        StreamFailed: string;
+    };
+};
+export {};

package/lib/commonjs/actions/stream/askStreamRead.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.askStreamReadBase = void 0;
-exports.askStreamRead = askStreamRead;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+exports.askStreamRead = exports.askStreamReadBase = void 0;
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const StreamActionType_1 = require("./StreamActionType");
 const decodeBase64ToUint8Array = (base64) => {
     const binary = atob(base64);
@@ -16,9 +15,13 @@ const decodeBase64ToUint8Array = (base64) => {
 // the shape the handle's encoding promises.
 exports.askStreamReadBase = (0, createActionRequester_1.createActionRequester)()({
     actionType: StreamActionType_1.StreamActionType.Read,
+    errorTypes: [
+        'StreamNotFound', // no open stream has this id: it was never registered, already finished, failed or was closed
+        'StreamFailed', // the stream's producer threw; its message is relayed in errorText
+    ],
     getPayload: (streamId, noWait) => ({ streamId, noWait }),
 });
-function* askStreamRead(handle, noWait) {
+function* askStreamReadTyped(handle, noWait) {
     const rawChunk = yield* (0, exports.askStreamReadBase)(handle.id, noWait);
     if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {
         return rawChunk;
@@ -31,4 +34,6 @@ function* askStreamRead(handle, noWait) {
     }
     return rawChunk;
 }
+/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */
+exports.askStreamRead = Object.assign(askStreamReadTyped, { errorType: exports.askStreamReadBase.errorType });
 //# sourceMappingURL=askStreamRead.js.map

package/lib/commonjs/actions/stream/askStreamRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStreamRead.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamRead.ts"],"names":[],"mappings":";;;AAqBA,sCAmBC;AAtCD,mFAAgF;AAChF,yDAAsD;AAEtD,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAc,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,oFAAoF;AACpF,4CAA4C;AAC/B,QAAA,iBAAiB,GAAG,IAAA,6CAAqB,GAAuB,CAAC;IAC5E,UAAU,EAAE,mCAAgB,CAAC,IAAI;IACjC,UAAU,EAAE,CAAC,QAAgB,EAAE,MAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC3E,CAAC,CAAC;AAEH,QAAe,CAAC,CAAC,aAAa,CAC5B,MAA0B,EAC1B,MAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,IAAA,yBAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,QAA6C,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,gCAAK,QAAQ,KAAE,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAuC,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,gCAAK,QAAQ,KAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAuC,CAAC;IAC/F,CAAC;IAED,OAAO,QAA6C,CAAC;AACvD,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { StreamChunk, StreamDataType, StreamEncoding, StreamHandle } from '../../types/StreamRegistry';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StreamActionType } from './StreamActionType';\n\nconst decodeBase64ToUint8Array = (base64: string): Uint8Array => {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n};\n\n// Chunks always cross the runtime boundary as strings; this story decodes them into\n// the shape the handle's encoding promises.\nexport const askStreamReadBase = createActionRequester<StreamChunk<string>>()({\n  actionType: StreamActionType.Read,\n  getPayload: (streamId: string, noWait?: boolean) => ({ streamId, noWait }),\n});\n\nexport function* askStreamRead<E extends StreamEncoding, T = unknown>(\n  handle: StreamHandle<E, T>,\n  noWait?: boolean,\n): AskResponse<StreamChunk<StreamDataType<E, T>>> {\n  const rawChunk = yield* askStreamReadBase(handle.id, noWait);\n\n  if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {\n    return rawChunk as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'binary') {\n    return { ...rawChunk, data: decodeBase64ToUint8Array(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'json') {\n    return { ...rawChunk, data: JSON.parse(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  return rawChunk as StreamChunk<StreamDataType<E, T>>;\n}\n"]}
+{"version":3,"file":"askStreamRead.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamRead.ts"],"names":[],"mappings":";;;AAAA,qFAAkF;AAGlF,yDAAsD;AAEtD,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAc,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,oFAAoF;AACpF,4CAA4C;AAC/B,QAAA,iBAAiB,GAAG,IAAA,6CAAqB,GAAuB,CAAC;IAC5E,UAAU,EAAE,mCAAgB,CAAC,IAAI;IACjC,UAAU,EAAE;QACV,gBAAgB,EAAE,8FAA8F;QAChH,cAAc,EAAE,mEAAmE;KACpF;IACD,UAAU,EAAE,CAAC,QAAgB,EAAE,MAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC3E,CAAC,CAAC;AAEH,QAAQ,CAAC,CAAC,kBAAkB,CAC1B,MAA0B,EAC1B,MAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,IAAA,yBAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,QAA6C,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,gCAAK,QAAQ,KAAE,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAuC,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,gCAAK,QAAQ,KAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAuC,CAAC;IAC/F,CAAC;IAED,OAAO,QAA6C,CAAC;AACvD,CAAC;AAED,iKAAiK;AACpJ,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,yBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StreamChunk, StreamDataType, StreamEncoding, StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nconst decodeBase64ToUint8Array = (base64: string): Uint8Array => {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n};\n\n// Chunks always cross the runtime boundary as strings; this story decodes them into\n// the shape the handle's encoding promises.\nexport const askStreamReadBase = createActionRequester<StreamChunk<string>>()({\n  actionType: StreamActionType.Read,\n  errorTypes: [\n    'StreamNotFound', // no open stream has this id: it was never registered, already finished, failed or was closed\n    'StreamFailed', // the stream's producer threw; its message is relayed in errorText\n  ],\n  getPayload: (streamId: string, noWait?: boolean) => ({ streamId, noWait }),\n});\n\nfunction* askStreamReadTyped<E extends StreamEncoding, T = unknown>(\n  handle: StreamHandle<E, T>,\n  noWait?: boolean,\n): AskResponse<StreamChunk<StreamDataType<E, T>>> {\n  const rawChunk = yield* askStreamReadBase(handle.id, noWait);\n\n  if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {\n    return rawChunk as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'binary') {\n    return { ...rawChunk, data: decodeBase64ToUint8Array(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'json') {\n    return { ...rawChunk, data: JSON.parse(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  return rawChunk as StreamChunk<StreamDataType<E, T>>;\n}\n\n/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askStreamRead = Object.assign(askStreamReadTyped, { errorType: askStreamReadBase.errorType });\n"]}

package/lib/commonjs/actions/system/askBatch.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askBatchBase = void 0;
 exports.askBatch = askBatch;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const createActionRequester_1 = require("../../logic/actions/createActionRequester");
 const SystemActionType_1 = require("./SystemActionType");
 exports.askBatchBase = (0, createActionRequester_1.createActionRequester)()({
     actionType: SystemActionType_1.SystemActionType.Batch,
@@ -15,8 +15,9 @@ function* askBatch(actions) {
     }
     // If we only have one action, just execute it directly
     // No need to batch it
-    if (actions.length === 1) {
-        return [yield actions[0]];
+    const only = actions[0];
+    if (actions.length === 1 && only) {
+        return [yield only];
     }
     // Otherwise, batch the actions
     return (yield* (0, exports.askBatchBase)(actions));