quidproquo-core 0.1.16 → 0.1.18

package/README.md

@@ -1,80 +1,90 @@
 # quidproquo-core
 
-The `quidproquo-core` library is the heart of the quidproquo framework. It provides the fundamental building blocks and abstractions that enable the
-creation of scalable, event-driven web applications. This library is not intended to be used directly, but rather serves as a foundation for other
-quidproquo packages.
+The heart of the [quidproquo](https://github.com/qpqjs/quidproquo) framework: the action catalogue, the story runtime, and the config system that everything else builds on.
 
-## WARNING: NOT FOR PRODUCTION
+Most applications should install [`quidproquo`](https://www.npmjs.com/package/quidproquo) instead, which re-exports this package along with `quidproquo-webserver`. Install this one directly only if you want core without the web server.
 
-**This project is currently under active development and should not be used in production environments. The APIs and functionality are subject to
-change without notice.**
+```bash
+npm install quidproquo-core
+```
 
-## Key Features
+## How it works
 
-1. **Action-Oriented Architecture**: The core of quidproquo-core is an action-oriented architecture, where all application logic is encapsulated in
-   small, reusable actions. These actions can be composed together to create complex workflows.
+An **action** is a plain object with a type and an optional payload. A **requester** is the `ask*` generator your code calls to yield one. Here is the whole of `askDateNow`:
 
-2. **Asynchronous Execution**: Actions in quidproquo-core are executed asynchronously using generators, allowing for efficient and non-blocking
-   execution of application logic.
+```typescript
+export function* askDateNow(): DateNowActionRequester {
+  return yield { type: DateActionType.Now };
+}
+```
 
-3. **Dependency Injection**: The framework provides a built-in dependency injection system, allowing for easy composition and testing of application
-   components.
+It never calls `new Date()`. A **story** composes requesters:
 
-4. **Extensibility**: The core library is designed to be highly extensible, with well-defined extension points and a modular architecture.
+```typescript
+function* askGreet(name: string): AskResponse<string> {
+  const now = yield* askDateNow();
+  return `hello ${name}, it is ${now}`;
+}
+```
 
-5. **Error Handling**: The framework includes a robust error handling system, with support for different error types and the ability to handle errors
-   at various levels of the application.
+The **runtime** drives the story, takes each yielded action, looks up the **processor** registered for that action type, awaits the result, and resumes the generator with it. Processors live in the `quidproquo-actionprocessor-*` packages, one set per platform. Swap the set and the same story runs somewhere else.
 
-6. **Logging and Observability**: The core library provides built-in support for logging and observability, making it easier to debug and monitor
-   applications built with quidproquo.
+Every action that passes through the runtime is recorded, which is where the execution logs, replay, and tracing come from.
 
-7. **Testability**: The action-oriented architecture and asynchronous execution model of quidproquo-core make it highly testable, with support for
-   unit, integration, and end-to-end testing.
+## What is in here
 
-## Key Concepts
+**Actions**, grouped by domain in `src/actions/`:
 
-1. **Actions**: Actions are the fundamental building blocks of quidproquo-core. They represent small, reusable pieces of application logic that can be
-   composed together to create complex workflows.
+| Domain | Covers |
+| --- | --- |
+| `config` | Parameters, secrets, globals |
+| `keyValueStore` | Key value storage, queries, and streams |
+| `file` | Object storage: read, write, list, signed urls |
+| `userDirectory` | Sign in, sign up, tokens, user management |
+| `eventBus`, `queue` | Publish and subscribe, message queues |
+| `network` | HTTP requests |
+| `graphDatabase` | Graph queries |
+| `ai` | Prompting and streaming completions |
+| `crypto` | Encrypt and decrypt against a managed key |
+| `date`, `guid`, `math` | The non-deterministic primitives a story must not call directly |
+| `log`, `metric`, `event` | Observability |
+| `state` | Reducer-driven state for frontend modules |
+| `stream`, `system`, `platform` | Streams, process, and platform utilities |
+| `dynamicFunctions`, `inlineFunction` | Calling code that is resolved at runtime |
+| `error`, `context` | Error handling and execution context |
 
-2. **Generators**: Generators are used to implement the asynchronous execution model of quidproquo-core. Actions are defined as generator functions,
-   which can yield other actions or return values.
+**Stories** in `src/stories/`: the composable helpers, including `askCatch` for try/finally semantics and `askRunParallel` for concurrency.
 
-3. **Dependency Injection**: The core library provides a built-in dependency injection system, allowing for easy composition and testing of
-   application components.
+**Config** in `src/config/`: the `define*` helpers that declare resources (key value stores, queues, secrets, and so on). A qpq config is a plain array of settings, which is what the deploy packages read to build infrastructure.
 
-4. **Contexts**: Contexts are used to manage the state and dependencies of a particular execution context, such as a user session or a background
-   task.
+**Testing** in `src/testing/`: `runStory` runs a story with actions mocked by type, so you can assert on behaviour without a runtime or any infrastructure.
 
-5. **Errors**: The framework includes a robust error handling system, with support for different error types and the ability to handle errors at
-   various levels of the application.
+```typescript
+import { DateActionType, runStory } from 'quidproquo-core';
 
-6. **Logging and Observability**: The core library provides built-in support for logging and observability, making it easier to debug and monitor
-   applications built with quidproquo.
+const result = runStory(askGreet('world'), {
+  [DateActionType.Now]: '2026-01-01T00:00:00.000Z',
+});
 
-7. **Testing**: The action-oriented architecture and asynchronous execution model of quidproquo-core make it highly testable, with support for unit,
-   integration, and end-to-end testing.
+expect(result).toBe('hello world, it is 2026-01-01T00:00:00.000Z');
+```
 
-## Getting Started
+A mock can be a literal value or a function, and a function mock is re-invoked per matching action, so it can be stateful.
 
-To use quidproquo-core, you'll need to install the package and its dependencies. You can do this using your preferred package manager, such as npm or
-yarn:
+## Conventions worth knowing
 
-```
-npm install quidproquo-core
-```
+- Anything named `ask*` is a generator and must be called with `yield*`. The [ESLint plugin](https://github.com/qpqjs/quidproquo/tree/main/quidproquo-eslint-config) enforces this and auto-fixes a missing `yield*`.
+- Stories must be deterministic. No `Date.now()`, `Math.random()`, or `crypto.randomUUID()`. Yield `askDateNow()` or `askNewGuid()` so logs replay and tests stay stable.
+- Throw with `return yield* askThrowError(...)`, which tells TypeScript that control stops there.
 
-Once you have the package installed, you can start building your application using the core concepts and features provided by the library.
+## Status
 
-## Documentation
+Pre-1.0. The whole `quidproquo-*` family releases in lockstep, so versions that share a number were built and tested together. Expect APIs to move between releases, and pin your versions.
 
-For more detailed information on using quidproquo-core, please refer to the
-[quidproquo-core documentation](https://github.com/joe-coady/quidproquo/tree/main/packages/quidproquo-core).
-
-## Contributing
+## Documentation
 
-If you'd like to contribute to the development of quidproquo-core, please refer to the
-[contributing guidelines](https://github.com/joe-coady/quidproquo/blob/main/CONTRIBUTING.md) for more information.
+[docs.quidproquojs.com](https://docs.quidproquojs.com)
 
 ## License
 
-quidproquo-core is licensed under the [MIT License](https://github.com/joe-coady/quidproquo/blob/main/LICENSE).
+MIT. See [LICENSE](https://github.com/qpqjs/quidproquo/blob/main/LICENSE).

package/lib/commonjs/actions/ai/askAiPrompt.d.ts

@@ -0,0 +1,23 @@
+import { AiActionType } from './AiActionType';
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+import { AiReasoningConfig } from './AiReasoningConfig';
+export type AskAiPromptOptions = {
+    system?: string;
+    aiName?: string;
+    messages?: AiMessage[];
+    reasoning?: AiReasoningConfig;
+    caching?: boolean;
+};
+export interface AiPromptActionResult {
+    text: string;
+}
+export declare const askAiPrompt: import("../../types").ActionRequesterFunction<AiActionType.Prompt, [model: AiModel, prompt: string, options?: AskAiPromptOptions | undefined], {
+    model: AiModel;
+    prompt: string;
+    messages: AiMessage[] | undefined;
+    system: string | undefined;
+    aiName: string | undefined;
+    reasoning: AiReasoningConfig | undefined;
+    caching: boolean | undefined;
+}, AiPromptActionResult, never>;

package/lib/commonjs/actions/ai/askAiPrompt.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAiPrompt = void 0;
+const types_1 = require("../../types");
+const AiActionType_1 = require("./AiActionType");
+exports.askAiPrompt = (0, types_1.createActionRequester)()({
+    actionType: AiActionType_1.AiActionType.Prompt,
+    getPayload: (model, prompt, options) => ({
+        model,
+        prompt,
+        messages: options === null || options === void 0 ? void 0 : options.messages,
+        system: options === null || options === void 0 ? void 0 : options.system,
+        aiName: options === null || options === void 0 ? void 0 : options.aiName,
+        reasoning: options === null || options === void 0 ? void 0 : options.reasoning,
+        caching: options === null || options === void 0 ? void 0 : options.caching,
+    }),
+});
+//# sourceMappingURL=askAiPrompt.js.map

package/lib/commonjs/actions/ai/askAiPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askAiPrompt.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPrompt.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,iDAA8C;AAiBjC,QAAA,WAAW,GAAG,IAAA,6BAAqB,GAAwB,CAAC;IACvE,UAAU,EAAE,2BAAY,CAAC,MAAM;IAC/B,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAA4B,EAAE,EAAE,CAAC,CAAC;QAC7E,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;KAC1B,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { AiActionType } from './AiActionType';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\n\nexport type AskAiPromptOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n};\n\nexport interface AiPromptActionResult {\n  text: string;\n}\n\nexport const askAiPrompt = createActionRequester<AiPromptActionResult>()({\n  actionType: AiActionType.Prompt,\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n  }),\n});\n"]}

package/lib/commonjs/actions/ai/askAiPromptStream.d.ts

@@ -0,0 +1,22 @@
+import { StreamHandle } from '../../types/StreamRegistry';
+import { AiActionType } from './AiActionType';
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+import { AiReasoningConfig } from './AiReasoningConfig';
+import { AiStreamPart } from './types';
+export type AskAiPromptStreamOptions = {
+    system?: string;
+    aiName?: string;
+    messages?: AiMessage[];
+    reasoning?: AiReasoningConfig;
+    caching?: boolean;
+};
+export declare const askAiPromptStream: import("../../types").ActionRequesterFunction<AiActionType.PromptStream, [model: AiModel, prompt: string, options?: AskAiPromptStreamOptions | undefined], {
+    model: AiModel;
+    prompt: string;
+    messages: AiMessage[] | undefined;
+    system: string | undefined;
+    aiName: string | undefined;
+    reasoning: AiReasoningConfig | undefined;
+    caching: boolean | undefined;
+}, StreamHandle<"json", AiStreamPart>, never>;

package/lib/commonjs/actions/ai/askAiPromptStream.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAiPromptStream = void 0;
+const types_1 = require("../../types");
+const AiActionType_1 = require("./AiActionType");
+exports.askAiPromptStream = (0, types_1.createActionRequester)()({
+    actionType: AiActionType_1.AiActionType.PromptStream,
+    getPayload: (model, prompt, options) => ({
+        model,
+        prompt,
+        messages: options === null || options === void 0 ? void 0 : options.messages,
+        system: options === null || options === void 0 ? void 0 : options.system,
+        aiName: options === null || options === void 0 ? void 0 : options.aiName,
+        reasoning: options === null || options === void 0 ? void 0 : options.reasoning,
+        caching: options === null || options === void 0 ? void 0 : options.caching,
+    }),
+});
+//# sourceMappingURL=askAiPromptStream.js.map

package/lib/commonjs/actions/ai/askAiPromptStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askAiPromptStream.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPromptStream.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,iDAA8C;AAcjC,QAAA,iBAAiB,GAAG,IAAA,6BAAqB,GAAsC,CAAC;IAC3F,UAAU,EAAE,2BAAY,CAAC,YAAY;IACrC,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAAkC,EAAE,EAAE,CAAC,CAAC;QACnF,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;KAC1B,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { AiActionType } from './AiActionType';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\nimport { AiStreamPart } from './types';\n\nexport type AskAiPromptStreamOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n};\n\nexport const askAiPromptStream = createActionRequester<StreamHandle<'json', AiStreamPart>>()({\n  actionType: AiActionType.PromptStream,\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptStreamOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n  }),\n});\n"]}

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

@@ -1,9 +1,7 @@
 export * from './AiActionType';
 export * from './AiMessage';
 export * from './AiModel';
-export * from './AiPromptActionRequester';
-export * from './AiPromptActionTypes';
-export * from './AiPromptStreamActionRequester';
-export * from './AiPromptStreamActionTypes';
 export * from './AiReasoningConfig';
+export * from './askAiPrompt';
+export * from './askAiPromptStream';
 export * from './types';

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

@@ -17,10 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AiActionType"), exports);
 __exportStar(require("./AiMessage"), exports);
 __exportStar(require("./AiModel"), exports);
-__exportStar(require("./AiPromptActionRequester"), exports);
-__exportStar(require("./AiPromptActionTypes"), exports);
-__exportStar(require("./AiPromptStreamActionRequester"), exports);
-__exportStar(require("./AiPromptStreamActionTypes"), exports);
 __exportStar(require("./AiReasoningConfig"), exports);
+__exportStar(require("./askAiPrompt"), exports);
+__exportStar(require("./askAiPromptStream"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,4DAA0C;AAC1C,wDAAsC;AACtC,kEAAgD;AAChD,8DAA4C;AAC5C,sDAAoC;AACpC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiPromptActionRequester';\nexport * from './AiPromptActionTypes';\nexport * from './AiPromptStreamActionRequester';\nexport * from './AiPromptStreamActionTypes';\nexport * from './AiReasoningConfig';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,sDAAoC;AACpC,gDAA8B;AAC9B,sDAAoC;AACpC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiReasoningConfig';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './types';\n"]}

package/lib/commonjs/actions/config/askConfigGetApplicationInfo.d.ts

@@ -0,0 +1,8 @@
+import { ConfigActionType } from './ConfigActionType';
+export type ApplicationConfigInfo = {
+    name: string;
+    environment: string;
+    module: string;
+    feature?: string;
+};
+export declare const askConfigGetApplicationInfo: import("../../types").ActionRequesterFunction<ConfigActionType.GetApplicationInfo, [], undefined, ApplicationConfigInfo, never>;

package/lib/commonjs/actions/config/askConfigGetApplicationInfo.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigGetApplicationInfo = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigGetApplicationInfo = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.GetApplicationInfo,
+});
+//# sourceMappingURL=askConfigGetApplicationInfo.js.map

package/lib/commonjs/actions/config/askConfigGetApplicationInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigGetApplicationInfo.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigGetApplicationInfo.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AASzC,QAAA,2BAA2B,GAAG,IAAA,6BAAqB,GAAyB,CAAC;IACxF,UAAU,EAAE,mCAAgB,CAAC,kBAAkB;CAChD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport type ApplicationConfigInfo = {\n  name: string;\n  environment: string;\n  module: string;\n  feature?: string;\n};\n\nexport const askConfigGetApplicationInfo = createActionRequester<ApplicationConfigInfo>()({\n  actionType: ConfigActionType.GetApplicationInfo,\n});\n"]}

package/lib/commonjs/actions/config/askConfigGetGlobal.d.ts

@@ -0,0 +1,6 @@
+import { AskResponse } from '../../types/StorySession';
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigGetGlobalBase: import("../..").ActionRequesterFunction<ConfigActionType.GetGlobal, [globalName: string], {
+    globalName: string;
+}, unknown, never>;
+export declare function askConfigGetGlobal<T>(globalName: string): AskResponse<T>;

package/lib/commonjs/actions/config/askConfigGetGlobal.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigGetGlobalBase = void 0;
+exports.askConfigGetGlobal = askConfigGetGlobal;
+const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigGetGlobalBase = (0, createActionRequester_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.GetGlobal,
+    getPayload: (globalName) => ({ globalName }),
+});
+// The stored global's type is only known to the caller, so the base returns unknown
+// and this story casts it to what the caller declared.
+function* askConfigGetGlobal(globalName) {
+    return (yield* (0, exports.askConfigGetGlobalBase)(globalName));
+}
+//# sourceMappingURL=askConfigGetGlobal.js.map

package/lib/commonjs/actions/config/askConfigGetGlobal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigGetGlobal.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigGetGlobal.ts"],"names":[],"mappings":";;;AAWA,gDAEC;AAZD,mFAAgF;AAChF,yDAAsD;AAEzC,QAAA,sBAAsB,GAAG,IAAA,6CAAqB,GAAW,CAAC;IACrE,UAAU,EAAE,mCAAgB,CAAC,SAAS;IACtC,UAAU,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CACrD,CAAC,CAAC;AAEH,oFAAoF;AACpF,uDAAuD;AACvD,QAAe,CAAC,CAAC,kBAAkB,CAAI,UAAkB;IACvD,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,8BAAsB,EAAC,UAAU,CAAC,CAAM,CAAC;AAC1D,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigGetGlobalBase = createActionRequester<unknown>()({\n  actionType: ConfigActionType.GetGlobal,\n  getPayload: (globalName: string) => ({ globalName }),\n});\n\n// The stored global's type is only known to the caller, so the base returns unknown\n// and this story casts it to what the caller declared.\nexport function* askConfigGetGlobal<T>(globalName: string): AskResponse<T> {\n  return (yield* askConfigGetGlobalBase(globalName)) as T;\n}\n"]}

package/lib/commonjs/actions/config/askConfigGetParameter.d.ts

@@ -0,0 +1,4 @@
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigGetParameter: import("../../types").ActionRequesterFunction<ConfigActionType.GetParameter, [parameterName: string], {
+    parameterName: string;
+}, string, "Throttling">;

package/lib/commonjs/actions/config/askConfigGetParameter.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigGetParameter = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigGetParameter = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.GetParameter,
+    errorTypes: [
+        'Throttling', // request rate exceeded
+    ],
+    getPayload: (parameterName) => ({ parameterName }),
+});
+//# sourceMappingURL=askConfigGetParameter.js.map

package/lib/commonjs/actions/config/askConfigGetParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigGetParameter.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigGetParameter.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AAEzC,QAAA,qBAAqB,GAAG,IAAA,6BAAqB,GAAU,CAAC;IACnE,UAAU,EAAE,mCAAgB,CAAC,YAAY;IACzC,UAAU,EAAE;QACV,YAAY,EAAE,wBAAwB;KACvC;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigGetParameter = createActionRequester<string>()({\n  actionType: ConfigActionType.GetParameter,\n  errorTypes: [\n    'Throttling', // request rate exceeded\n  ],\n  getPayload: (parameterName: string) => ({ parameterName }),\n});\n"]}

package/lib/commonjs/actions/config/askConfigGetParameters.d.ts

@@ -0,0 +1,4 @@
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigGetParameters: import("../../types").ActionRequesterFunction<ConfigActionType.GetParameters, [parameterNames: string[]], {
+    parameterNames: string[];
+}, string[], "Throttling">;

package/lib/commonjs/actions/config/askConfigGetParameters.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigGetParameters = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigGetParameters = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.GetParameters,
+    errorTypes: [
+        'Throttling', // request rate exceeded
+    ],
+    getPayload: (parameterNames) => ({ parameterNames }),
+});
+//# sourceMappingURL=askConfigGetParameters.js.map

package/lib/commonjs/actions/config/askConfigGetParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigGetParameters.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigGetParameters.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AAEzC,QAAA,sBAAsB,GAAG,IAAA,6BAAqB,GAAY,CAAC;IACtE,UAAU,EAAE,mCAAgB,CAAC,aAAa;IAC1C,UAAU,EAAE;QACV,YAAY,EAAE,wBAAwB;KACvC;IACD,UAAU,EAAE,CAAC,cAAwB,EAAE,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigGetParameters = createActionRequester<string[]>()({\n  actionType: ConfigActionType.GetParameters,\n  errorTypes: [\n    'Throttling', // request rate exceeded\n  ],\n  getPayload: (parameterNames: string[]) => ({ parameterNames }),\n});\n"]}

package/lib/commonjs/actions/config/askConfigGetSecret.d.ts

@@ -0,0 +1,4 @@
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigGetSecret: import("../../types").ActionRequesterFunction<ConfigActionType.GetSecret, [secretName: string], {
+    secretName: string;
+}, string, "Throttling" | "ResourceNotFound">;

package/lib/commonjs/actions/config/askConfigGetSecret.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigGetSecret = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigGetSecret = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.GetSecret,
+    errorTypes: [
+        'ResourceNotFound', // secret does not exist
+        'Throttling', // request rate exceeded
+    ],
+    getPayload: (secretName) => ({ secretName }),
+});
+//# sourceMappingURL=askConfigGetSecret.js.map

package/lib/commonjs/actions/config/askConfigGetSecret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigGetSecret.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigGetSecret.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AAEzC,QAAA,kBAAkB,GAAG,IAAA,6BAAqB,GAAU,CAAC;IAChE,UAAU,EAAE,mCAAgB,CAAC,SAAS;IACtC,UAAU,EAAE;QACV,kBAAkB,EAAE,wBAAwB;QAC5C,YAAY,EAAE,wBAAwB;KACvC;IACD,UAAU,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CACrD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigGetSecret = createActionRequester<string>()({\n  actionType: ConfigActionType.GetSecret,\n  errorTypes: [\n    'ResourceNotFound', // secret does not exist\n    'Throttling', // request rate exceeded\n  ],\n  getPayload: (secretName: string) => ({ secretName }),\n});\n"]}

package/lib/commonjs/actions/config/askConfigListParameters.d.ts

@@ -0,0 +1,2 @@
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigListParameters: import("../../types").ActionRequesterFunction<ConfigActionType.ListParameters, [], undefined, string[], "Throttling">;

package/lib/commonjs/actions/config/askConfigListParameters.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigListParameters = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigListParameters = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.ListParameters,
+    errorTypes: [
+        'Throttling', // request rate exceeded
+    ],
+});
+//# sourceMappingURL=askConfigListParameters.js.map

package/lib/commonjs/actions/config/askConfigListParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigListParameters.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigListParameters.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AAEzC,QAAA,uBAAuB,GAAG,IAAA,6BAAqB,GAAY,CAAC;IACvE,UAAU,EAAE,mCAAgB,CAAC,cAAc;IAC3C,UAAU,EAAE;QACV,YAAY,EAAE,wBAAwB;KACvC;CACF,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigListParameters = createActionRequester<string[]>()({\n  actionType: ConfigActionType.ListParameters,\n  errorTypes: [\n    'Throttling', // request rate exceeded\n  ],\n});\n"]}

package/lib/commonjs/actions/config/askConfigSetParameter.d.ts

@@ -0,0 +1,5 @@
+import { ConfigActionType } from './ConfigActionType';
+export declare const askConfigSetParameter: import("../../types").ActionRequesterFunction<ConfigActionType.SetParameter, [parameterName: string, parameterValue: string], {
+    parameterName: string;
+    parameterValue: string;
+}, void, "Throttling" | "QuotaExceeded">;

package/lib/commonjs/actions/config/askConfigSetParameter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askConfigSetParameter = void 0;
+const types_1 = require("../../types");
+const ConfigActionType_1 = require("./ConfigActionType");
+exports.askConfigSetParameter = (0, types_1.createActionRequester)()({
+    actionType: ConfigActionType_1.ConfigActionType.SetParameter,
+    errorTypes: [
+        'Throttling', // request rate exceeded
+        'QuotaExceeded', // parameter store / storage limit hit
+    ],
+    getPayload: (parameterName, parameterValue) => ({ parameterName, parameterValue }),
+});
+//# sourceMappingURL=askConfigSetParameter.js.map

package/lib/commonjs/actions/config/askConfigSetParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askConfigSetParameter.js","sourceRoot":"","sources":["../../../../src/actions/config/askConfigSetParameter.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,yDAAsD;AAEzC,QAAA,qBAAqB,GAAG,IAAA,6BAAqB,GAAQ,CAAC;IACjE,UAAU,EAAE,mCAAgB,CAAC,YAAY;IACzC,UAAU,EAAE;QACV,YAAY,EAAE,wBAAwB;QACtC,eAAe,EAAE,sCAAsC;KACxD;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,cAAsB,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;CACnG,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { ConfigActionType } from './ConfigActionType';\n\nexport const askConfigSetParameter = createActionRequester<void>()({\n  actionType: ConfigActionType.SetParameter,\n  errorTypes: [\n    'Throttling', // request rate exceeded\n    'QuotaExceeded', // parameter store / storage limit hit\n  ],\n  getPayload: (parameterName: string, parameterValue: string) => ({ parameterName, parameterValue }),\n});\n"]}

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

@@ -1,15 +1,8 @@
+export * from './askConfigGetApplicationInfo';
+export * from './askConfigGetGlobal';
+export * from './askConfigGetParameter';
+export * from './askConfigGetParameters';
+export * from './askConfigGetSecret';
+export * from './askConfigListParameters';
+export * from './askConfigSetParameter';
 export * from './ConfigActionType';
-export * from './ConfigGetApplicationInfoActionRequester';
-export * from './ConfigGetApplicationInfoActionTypes';
-export * from './ConfigGetGlobalActionRequester';
-export * from './ConfigGetGlobalActionTypes';
-export * from './ConfigGetParameterActionRequester';
-export * from './ConfigGetParameterActionTypes';
-export * from './ConfigGetParametersActionRequester';
-export * from './ConfigGetParametersActionTypes';
-export * from './ConfigGetSecretActionRequester';
-export * from './ConfigGetSecretActionTypes';
-export * from './ConfigListParametersActionRequester';
-export * from './ConfigListParametersActionTypes';
-export * from './ConfigSetParameterActionRequester';
-export * from './ConfigSetParameterActionTypes';

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

@@ -14,19 +14,12 @@ 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("./askConfigGetApplicationInfo"), exports);
+__exportStar(require("./askConfigGetGlobal"), exports);
+__exportStar(require("./askConfigGetParameter"), exports);
+__exportStar(require("./askConfigGetParameters"), exports);
+__exportStar(require("./askConfigGetSecret"), exports);
+__exportStar(require("./askConfigListParameters"), exports);
+__exportStar(require("./askConfigSetParameter"), exports);
 __exportStar(require("./ConfigActionType"), exports);
-__exportStar(require("./ConfigGetApplicationInfoActionRequester"), exports);
-__exportStar(require("./ConfigGetApplicationInfoActionTypes"), exports);
-__exportStar(require("./ConfigGetGlobalActionRequester"), exports);
-__exportStar(require("./ConfigGetGlobalActionTypes"), exports);
-__exportStar(require("./ConfigGetParameterActionRequester"), exports);
-__exportStar(require("./ConfigGetParameterActionTypes"), exports);
-__exportStar(require("./ConfigGetParametersActionRequester"), exports);
-__exportStar(require("./ConfigGetParametersActionTypes"), exports);
-__exportStar(require("./ConfigGetSecretActionRequester"), exports);
-__exportStar(require("./ConfigGetSecretActionTypes"), exports);
-__exportStar(require("./ConfigListParametersActionRequester"), exports);
-__exportStar(require("./ConfigListParametersActionTypes"), exports);
-__exportStar(require("./ConfigSetParameterActionRequester"), exports);
-__exportStar(require("./ConfigSetParameterActionTypes"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,4EAA0D;AAC1D,wEAAsD;AACtD,mEAAiD;AACjD,+DAA6C;AAC7C,sEAAoD;AACpD,kEAAgD;AAChD,uEAAqD;AACrD,mEAAiD;AACjD,mEAAiD;AACjD,+DAA6C;AAC7C,wEAAsD;AACtD,oEAAkD;AAClD,sEAAoD;AACpD,kEAAgD","sourcesContent":["export * from './ConfigActionType';\nexport * from './ConfigGetApplicationInfoActionRequester';\nexport * from './ConfigGetApplicationInfoActionTypes';\nexport * from './ConfigGetGlobalActionRequester';\nexport * from './ConfigGetGlobalActionTypes';\nexport * from './ConfigGetParameterActionRequester';\nexport * from './ConfigGetParameterActionTypes';\nexport * from './ConfigGetParametersActionRequester';\nexport * from './ConfigGetParametersActionTypes';\nexport * from './ConfigGetSecretActionRequester';\nexport * from './ConfigGetSecretActionTypes';\nexport * from './ConfigListParametersActionRequester';\nexport * from './ConfigListParametersActionTypes';\nexport * from './ConfigSetParameterActionRequester';\nexport * from './ConfigSetParameterActionTypes';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,uDAAqC;AACrC,4DAA0C;AAC1C,0DAAwC;AACxC,qDAAmC","sourcesContent":["export * from './askConfigGetApplicationInfo';\nexport * from './askConfigGetGlobal';\nexport * from './askConfigGetParameter';\nexport * from './askConfigGetParameters';\nexport * from './askConfigGetSecret';\nexport * from './askConfigListParameters';\nexport * from './askConfigSetParameter';\nexport * from './ConfigActionType';\n"]}

package/lib/commonjs/actions/context/askContextList.d.ts

@@ -0,0 +1,3 @@
+import { QpqContext } from '../../types';
+import { ContextActionType } from './ContextActionType';
+export declare const askContextList: import("../../types").ActionRequesterFunction<ContextActionType.List, [], undefined, QpqContext<any>, never>;

package/lib/commonjs/actions/context/askContextList.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askContextList = void 0;
+const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const ContextActionType_1 = require("./ContextActionType");
+// Reads the whole serializable context stack. Stories reach for askContextRead with a
+// specific identifier; this exists for the runtime itself (askContextProvideValue relays
+// it to build the parent chain) and for the log viewer.
+exports.askContextList = (0, createActionRequester_1.createActionRequester)()({
+    actionType: ContextActionType_1.ContextActionType.List,
+});
+//# sourceMappingURL=askContextList.js.map

package/lib/commonjs/actions/context/askContextList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askContextList.js","sourceRoot":"","sources":["../../../../src/actions/context/askContextList.ts"],"names":[],"mappings":";;;AACA,mFAAgF;AAChF,2DAAwD;AAExD,sFAAsF;AACtF,yFAAyF;AACzF,wDAAwD;AAC3C,QAAA,cAAc,GAAG,IAAA,6CAAqB,GAAmB,CAAC;IACrE,UAAU,EAAE,qCAAiB,CAAC,IAAI;CACnC,CAAC,CAAC","sourcesContent":["import { QpqContext } from '../../types';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { ContextActionType } from './ContextActionType';\n\n// Reads the whole serializable context stack. Stories reach for askContextRead with a\n// specific identifier; this exists for the runtime itself (askContextProvideValue relays\n// it to build the parent chain) and for the log viewer.\nexport const askContextList = createActionRequester<QpqContext<any>>()({\n  actionType: ContextActionType.List,\n});\n"]}

package/lib/commonjs/actions/context/askContextRead.d.ts

@@ -0,0 +1,15 @@
+import { QpqContextIdentifier } from '../../types';
+import { Action } from '../../types/Action';
+import { AskResponse } from '../../types/StorySession';
+import { ContextActionType } from './ContextActionType';
+export interface ContextReadActionPayload<T> {
+    contextIdentifier: QpqContextIdentifier<T>;
+}
+export interface ContextReadAction<T> extends Action<ContextReadActionPayload<T>> {
+    type: ContextActionType.Read;
+    payload: ContextReadActionPayload<T>;
+}
+export declare const askContextReadBase: import("../../types").ActionRequesterFunction<ContextActionType.Read, [contextIdentifier: QpqContextIdentifier<unknown>], {
+    contextIdentifier: QpqContextIdentifier<unknown>;
+}, unknown, never>;
+export declare function askContextRead<T>(contextIdentifier: QpqContextIdentifier<T>): AskResponse<T>;

package/lib/commonjs/actions/context/askContextRead.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askContextReadBase = void 0;
+exports.askContextRead = askContextRead;
+const createActionRequester_1 = require("../../types/utils/createActionRequester");
+const ContextActionType_1 = require("./ContextActionType");
+exports.askContextReadBase = (0, createActionRequester_1.createActionRequester)()({
+    actionType: ContextActionType_1.ContextActionType.Read,
+    getPayload: (contextIdentifier) => ({ contextIdentifier }),
+});
+// The context's value type travels on the identifier, so the base returns unknown and
+// this story casts it back to what the identifier declared.
+function* askContextRead(contextIdentifier) {
+    return (yield* (0, exports.askContextReadBase)(contextIdentifier));
+}
+//# sourceMappingURL=askContextRead.js.map

package/lib/commonjs/actions/context/askContextRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askContextRead.js","sourceRoot":"","sources":["../../../../src/actions/context/askContextRead.ts"],"names":[],"mappings":";;;AAsBA,wCAEC;AArBD,mFAAgF;AAChF,2DAAwD;AAW3C,QAAA,kBAAkB,GAAG,IAAA,6CAAqB,GAAW,CAAC;IACjE,UAAU,EAAE,qCAAiB,CAAC,IAAI;IAClC,UAAU,EAAE,CAAC,iBAAgD,EAAE,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1F,CAAC,CAAC;AAEH,sFAAsF;AACtF,4DAA4D;AAC5D,QAAe,CAAC,CAAC,cAAc,CAAI,iBAA0C;IAC3E,OAAO,CAAC,KAAK,CAAC,CAAC,IAAA,0BAAkB,EAAC,iBAAkD,CAAC,CAAM,CAAC;AAC9F,CAAC","sourcesContent":["import { QpqContextIdentifier } from '../../types';\nimport { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { ContextActionType } from './ContextActionType';\n\nexport interface ContextReadActionPayload<T> {\n  contextIdentifier: QpqContextIdentifier<T>;\n}\n\nexport interface ContextReadAction<T> extends Action<ContextReadActionPayload<T>> {\n  type: ContextActionType.Read;\n  payload: ContextReadActionPayload<T>;\n}\n\nexport const askContextReadBase = createActionRequester<unknown>()({\n  actionType: ContextActionType.Read,\n  getPayload: (contextIdentifier: QpqContextIdentifier<unknown>) => ({ contextIdentifier }),\n});\n\n// The context's value type travels on the identifier, so the base returns unknown and\n// this story casts it back to what the identifier declared.\nexport function* askContextRead<T>(contextIdentifier: QpqContextIdentifier<T>): AskResponse<T> {\n  return (yield* askContextReadBase(contextIdentifier as QpqContextIdentifier<unknown>)) as T;\n}\n"]}

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

@@ -1,4 +1,3 @@
+export * from './askContextList';
+export * from './askContextRead';
 export * from './ContextActionType';
-export * from './ContextListActionTypes';
-export * from './ContextReadActionRequester';
-export * from './ContextReadActionTypes';