@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/types/NotifyErrorQueueEvent.d.ts

@@ -12,17 +12,17 @@ export type NotifyErrorQueueBaseEventPayload = {
     oldStateInAlarm: boolean;
 };
 export type NotifyErrorQueueErrorEventPayload = NotifyErrorQueueBaseEventPayload;
-export interface NotifyErrorQueueErrorEventMessage extends QueueMessage<NotifyErrorQueueErrorEventPayload> {
+export type NotifyErrorQueueErrorEventMessage = {
     type: NotifyErrorQueueEvents.Error;
-}
+} & QueueMessage<NotifyErrorQueueErrorEventPayload>;
 export type NotifyErrorQueueErrorQueueEvent = QueueEvent<NotifyErrorQueueErrorEventMessage>;
 export type NotifyErrorQueueTimeoutEventPayload = NotifyErrorQueueBaseEventPayload;
-export interface NotifyErrorQueueTimeoutEventMessage extends QueueMessage<NotifyErrorQueueTimeoutEventPayload> {
+export type NotifyErrorQueueTimeoutEventMessage = {
     type: NotifyErrorQueueEvents.Timeout;
-}
+} & QueueMessage<NotifyErrorQueueTimeoutEventPayload>;
 export type NotifyErrorQueueTimeoutQueueEvent = QueueEvent<NotifyErrorQueueTimeoutEventMessage>;
 export type NotifyErrorQueueThrottleEventPayload = NotifyErrorQueueBaseEventPayload;
-export interface NotifyErrorQueueThrottleEventMessage extends QueueMessage<NotifyErrorQueueThrottleEventPayload> {
+export type NotifyErrorQueueThrottleEventMessage = {
     type: NotifyErrorQueueEvents.Throttle;
-}
+} & QueueMessage<NotifyErrorQueueThrottleEventPayload>;
 export type NotifyErrorQueueThrottleQueueEvent = QueueEvent<NotifyErrorQueueThrottleEventMessage>;

package/lib/commonjs/types/NotifyErrorQueueEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotifyErrorQueueEvent.js","sourceRoot":"","sources":["../../../src/types/NotifyErrorQueueEvent.ts"],"names":[],"mappings":";;;AAGA,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,6CAAmB,CAAA;IACnB,+CAAqB,CAAA;IACrB,6CAAmB,CAAA;AACrB,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC","sourcesContent":["import { QueueMessage } from '../actions';\nimport { QueueEvent } from './QueueEvent';\n\nexport enum NotifyErrorQueueEvents {\n  Error = 'Error',\n  Timeout = 'Timeout',\n  Throttle = 'Throttle',\n  Unknown = 'Unknown',\n}\n\nexport type NotifyErrorQueueBaseEventPayload = {\n  newStateInAlarm: boolean;\n  newStateReason: string;\n\n  oldStateInAlarm: boolean;\n};\n\n// Error\n\nexport type NotifyErrorQueueErrorEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport interface NotifyErrorQueueErrorEventMessage extends QueueMessage<NotifyErrorQueueErrorEventPayload> {\n  type: NotifyErrorQueueEvents.Error;\n}\n\nexport type NotifyErrorQueueErrorQueueEvent = QueueEvent<NotifyErrorQueueErrorEventMessage>;\n\n// Timeout\n\nexport type NotifyErrorQueueTimeoutEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport interface NotifyErrorQueueTimeoutEventMessage extends QueueMessage<NotifyErrorQueueTimeoutEventPayload> {\n  type: NotifyErrorQueueEvents.Timeout;\n}\n\nexport type NotifyErrorQueueTimeoutQueueEvent = QueueEvent<NotifyErrorQueueTimeoutEventMessage>;\n\n// Throttle\n\nexport type NotifyErrorQueueThrottleEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport interface NotifyErrorQueueThrottleEventMessage extends QueueMessage<NotifyErrorQueueThrottleEventPayload> {\n  type: NotifyErrorQueueEvents.Throttle;\n}\n\nexport type NotifyErrorQueueThrottleQueueEvent = QueueEvent<NotifyErrorQueueThrottleEventMessage>;\n"]}
+{"version":3,"file":"NotifyErrorQueueEvent.js","sourceRoot":"","sources":["../../../src/types/NotifyErrorQueueEvent.ts"],"names":[],"mappings":";;;AAGA,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,6CAAmB,CAAA;IACnB,+CAAqB,CAAA;IACrB,6CAAmB,CAAA;AACrB,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC","sourcesContent":["import { QueueMessage } from '../actions';\nimport { QueueEvent } from './QueueEvent';\n\nexport enum NotifyErrorQueueEvents {\n  Error = 'Error',\n  Timeout = 'Timeout',\n  Throttle = 'Throttle',\n  Unknown = 'Unknown',\n}\n\nexport type NotifyErrorQueueBaseEventPayload = {\n  newStateInAlarm: boolean;\n  newStateReason: string;\n\n  oldStateInAlarm: boolean;\n};\n\n// Error\n\nexport type NotifyErrorQueueErrorEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport type NotifyErrorQueueErrorEventMessage = {\n  type: NotifyErrorQueueEvents.Error;\n} & QueueMessage<NotifyErrorQueueErrorEventPayload>;\n\nexport type NotifyErrorQueueErrorQueueEvent = QueueEvent<NotifyErrorQueueErrorEventMessage>;\n\n// Timeout\n\nexport type NotifyErrorQueueTimeoutEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport type NotifyErrorQueueTimeoutEventMessage = {\n  type: NotifyErrorQueueEvents.Timeout;\n} & QueueMessage<NotifyErrorQueueTimeoutEventPayload>;\n\nexport type NotifyErrorQueueTimeoutQueueEvent = QueueEvent<NotifyErrorQueueTimeoutEventMessage>;\n\n// Throttle\n\nexport type NotifyErrorQueueThrottleEventPayload = NotifyErrorQueueBaseEventPayload;\n\nexport type NotifyErrorQueueThrottleEventMessage = {\n  type: NotifyErrorQueueEvents.Throttle;\n} & QueueMessage<NotifyErrorQueueThrottleEventPayload>;\n\nexport type NotifyErrorQueueThrottleQueueEvent = QueueEvent<NotifyErrorQueueThrottleEventMessage>;\n"]}

package/lib/commonjs/types/OwnerDeploymentContext.d.ts

@@ -0,0 +1,6 @@
+export type OwnerDeploymentContext = {
+    application: string;
+    module: string;
+    environment: string;
+    feature?: string;
+};

package/lib/commonjs/types/OwnerDeploymentContext.js

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

package/lib/commonjs/types/OwnerDeploymentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OwnerDeploymentContext.js","sourceRoot":"","sources":["../../../src/types/OwnerDeploymentContext.ts"],"names":[],"mappings":"","sourcesContent":["// Where a resource was deployed: its owner's application, module, environment and feature,\n// each falling back to the executing service's own when the owner does not say.\nexport type OwnerDeploymentContext = {\n  application: string;\n  module: string;\n  environment: string;\n  feature?: string;\n};\n"]}

package/lib/commonjs/types/QPQBinaryData.d.ts

@@ -1,6 +1,6 @@
-export interface QPQBinaryData {
+export type QPQBinaryData = {
     base64Data: string;
     filename: string;
     mimetype?: string;
     contentDisposition?: string;
-}
+};

package/lib/commonjs/types/QPQBinaryData.js.map

@@ -1 +1 @@
-{"version":3,"file":"QPQBinaryData.js","sourceRoot":"","sources":["../../../src/types/QPQBinaryData.ts"],"names":[],"mappings":"","sourcesContent":["export interface QPQBinaryData {\n  base64Data: string;\n  filename: string;\n  mimetype?: string;\n  contentDisposition?: string;\n}\n"]}
+{"version":3,"file":"QPQBinaryData.js","sourceRoot":"","sources":["../../../src/types/QPQBinaryData.ts"],"names":[],"mappings":"","sourcesContent":["export type QPQBinaryData = {\n  base64Data: string;\n  filename: string;\n  mimetype?: string;\n  contentDisposition?: string;\n};\n"]}

package/lib/commonjs/types/QpqContextIdentifier.d.ts

@@ -1,6 +1,6 @@
-export interface QpqContextIdentifier<T> {
+export type QpqContextIdentifier<T> = {
     uniqueName: string;
     defaultValue: T;
     local?: boolean;
-}
+};
 export type QpqContext<T> = Record<QpqContextIdentifier<T>['uniqueName'], T>;

package/lib/commonjs/types/QpqContextIdentifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"QpqContextIdentifier.js","sourceRoot":"","sources":["../../../src/types/QpqContextIdentifier.ts"],"names":[],"mappings":"","sourcesContent":["export interface QpqContextIdentifier<T> {\n  uniqueName: string;\n  defaultValue: T;\n\n  // Service-local context lives in a separate bag (StorySession.localContext)\n  // that is never serialized across a service boundary.\n  local?: boolean;\n}\n\nexport type QpqContext<T> = Record<QpqContextIdentifier<T>['uniqueName'], T>;\n"]}
+{"version":3,"file":"QpqContextIdentifier.js","sourceRoot":"","sources":["../../../src/types/QpqContextIdentifier.ts"],"names":[],"mappings":"","sourcesContent":["export type QpqContextIdentifier<T> = {\n  uniqueName: string;\n  defaultValue: T;\n\n  // Service-local context lives in a separate bag (StorySession.localContext)\n  // that is never serialized across a service boundary.\n  local?: boolean;\n};\n\nexport type QpqContext<T> = Record<QpqContextIdentifier<T>['uniqueName'], T>;\n"]}

package/lib/commonjs/types/QpqExecutionTrace.d.ts

@@ -1,29 +1,29 @@
 import { QpqIsoDateTime } from './QpqIsoDateTime';
-export interface QpqExecutionTraceSource {
+export type QpqExecutionTraceSource = {
     path: string;
     content?: string;
-}
-export interface QpqExecutionTraceValue {
+};
+export type QpqExecutionTraceValue = {
     preview: string;
     json?: string;
-}
-export interface QpqExecutionTraceStep {
+};
+export type QpqExecutionTraceStep = {
     sourceIndex: number;
     line: number;
     column: number;
     functionName: string;
     locals: Record<string, QpqExecutionTraceValue>;
     returnValue?: QpqExecutionTraceValue;
-}
-export interface QpqExecutionTraceStats {
+};
+export type QpqExecutionTraceStats = {
     pauses: number;
     breakpoints: number;
     replayMs: number;
     localsCaptureMs: number;
     instrumentMs?: number;
     instrumentedScriptUrls?: string[];
-}
-export interface QpqExecutionTrace {
+};
+export type QpqExecutionTrace = {
     correlation: string;
     moduleName: string;
     tracedAt: QpqIsoDateTime;
@@ -31,4 +31,4 @@ export interface QpqExecutionTrace {
     sources: QpqExecutionTraceSource[];
     steps: QpqExecutionTraceStep[];
     stats: QpqExecutionTraceStats;
-}
+};

package/lib/commonjs/types/QpqExecutionTrace.js.map

@@ -1 +1 @@
-{"version":3,"file":"QpqExecutionTrace.js","sourceRoot":"","sources":["../../../src/types/QpqExecutionTrace.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqIsoDateTime } from './QpqIsoDateTime';\n\n// A line-by-line execution trace of a story REPLAY (see qpqExecuteLog): every statement\n// the story executed, with the values of its local variables at that moment. Produced by\n// @qpqjs/actionprocessor-node's traceStoryExecution (worker-thread V8 inspector) and\n// rendered by qpq-admin as annotated original source. See trace-replay-plan.md.\n\n// One original source file the trace maps into. When the traced bundle shipped source\n// maps with sourcesContent (the federated remote build does), `content` is the original\n// TypeScript text, so a viewer can render annotated source with no access to the repo.\nexport interface QpqExecutionTraceSource {\n  // Original source path from the source map (e.g. webpack://service/src/story.ts), or\n  // the generated script's url when no map was available.\n  path: string;\n\n  content?: string;\n}\n\n// One captured variable value. `preview` is always present — a short single-line display\n// string (used for inline annotations). `json` is present for object values that could be\n// fully serialized: a JSON string of the value walked to the capture depth/size caps\n// (strings clamped, circular refs and overflow marked with «...» placeholders), for\n// expandable inspection in a viewer.\nexport interface QpqExecutionTraceValue {\n  preview: string;\n  json?: string;\n}\n\nexport interface QpqExecutionTraceStep {\n  // Index into QpqExecutionTrace.sources\n  sourceIndex: number;\n\n  // Position in the ORIGINAL source when a source map resolved it, otherwise in the\n  // generated script. 1-based line, 0-based column (source-map convention).\n  line: number;\n  column: number;\n\n  functionName: string;\n\n  // Local + block scope variables at this statement (size-capped at capture time)\n  locals: Record<string, QpqExecutionTraceValue>;\n\n  // Present when this step paused at a function's return point: the value being\n  // returned (V8 exposes it on the call frame at return break positions)\n  returnValue?: QpqExecutionTraceValue;\n}\n\nexport interface QpqExecutionTraceStats {\n  // Total debugger pauses, including non-story pauses that were resumed through\n  pauses: number;\n\n  // Statement breakpoints set across the traced scripts\n  breakpoints: number;\n\n  // Wall time of the traced replay / time spent reading locals out of the inspector\n  replayMs: number;\n  localsCaptureMs: number;\n\n  // Setup time before the replay could start (domain enable + breakpoint installation)\n  instrumentMs?: number;\n\n  // Urls of every script that received breakpoints (steps can only be recorded in\n  // these) — the first thing to check when expected code is missing from a trace\n  instrumentedScriptUrls?: string[];\n}\n\nexport interface QpqExecutionTrace {\n  // The log (StoryResult) that was replayed\n  correlation: string;\n  moduleName: string;\n\n  tracedAt: QpqIsoDateTime;\n\n  // True when the step budget was hit — the replay still ran to completion, but steps\n  // beyond the budget were not recorded.\n  truncated: boolean;\n\n  sources: QpqExecutionTraceSource[];\n  steps: QpqExecutionTraceStep[];\n\n  stats: QpqExecutionTraceStats;\n}\n"]}
+{"version":3,"file":"QpqExecutionTrace.js","sourceRoot":"","sources":["../../../src/types/QpqExecutionTrace.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqIsoDateTime } from './QpqIsoDateTime';\n\n// A line-by-line execution trace of a story REPLAY (see qpqExecuteLog): every statement\n// the story executed, with the values of its local variables at that moment. Produced by\n// @qpqjs/actionprocessor-node's traceStoryExecution (worker-thread V8 inspector) and\n// rendered by qpq-admin as annotated original source. See trace-replay-plan.md.\n\n// One original source file the trace maps into. When the traced bundle shipped source\n// maps with sourcesContent (the federated remote build does), `content` is the original\n// TypeScript text, so a viewer can render annotated source with no access to the repo.\nexport type QpqExecutionTraceSource = {\n  // Original source path from the source map (e.g. webpack://service/src/story.ts), or\n  // the generated script's url when no map was available.\n  path: string;\n\n  content?: string;\n};\n\n// One captured variable value. `preview` is always present, a short single-line display\n// string (used for inline annotations). `json` is present for object values that could be\n// fully serialized: a JSON string of the value walked to the capture depth/size caps\n// (strings clamped, circular refs and overflow marked with «...» placeholders), for\n// expandable inspection in a viewer.\nexport type QpqExecutionTraceValue = {\n  preview: string;\n  json?: string;\n};\n\nexport type QpqExecutionTraceStep = {\n  // Index into QpqExecutionTrace.sources\n  sourceIndex: number;\n\n  // Position in the ORIGINAL source when a source map resolved it, otherwise in the\n  // generated script. 1-based line, 0-based column (source-map convention).\n  line: number;\n  column: number;\n\n  functionName: string;\n\n  // Local + block scope variables at this statement (size-capped at capture time)\n  locals: Record<string, QpqExecutionTraceValue>;\n\n  // Present when this step paused at a function's return point: the value being\n  // returned (V8 exposes it on the call frame at return break positions)\n  returnValue?: QpqExecutionTraceValue;\n};\n\nexport type QpqExecutionTraceStats = {\n  // Total debugger pauses, including non-story pauses that were resumed through\n  pauses: number;\n\n  // Statement breakpoints set across the traced scripts\n  breakpoints: number;\n\n  // Wall time of the traced replay / time spent reading locals out of the inspector\n  replayMs: number;\n  localsCaptureMs: number;\n\n  // Setup time before the replay could start (domain enable + breakpoint installation)\n  instrumentMs?: number;\n\n  // Urls of every script that received breakpoints (steps can only be recorded in\n  // these), the first thing to check when expected code is missing from a trace\n  instrumentedScriptUrls?: string[];\n};\n\nexport type QpqExecutionTrace = {\n  // The log (StoryResult) that was replayed\n  correlation: string;\n  moduleName: string;\n\n  tracedAt: QpqIsoDateTime;\n\n  // True when the step budget was hit, the replay still ran to completion, but steps\n  // beyond the budget were not recorded.\n  truncated: boolean;\n\n  sources: QpqExecutionTraceSource[];\n  steps: QpqExecutionTraceStep[];\n\n  stats: QpqExecutionTraceStats;\n};\n"]}

package/lib/commonjs/types/QpqPagedData.d.ts

@@ -1,4 +1,4 @@
-export interface QpqPagedData<T> {
+export type QpqPagedData<T> = {
     nextPageKey?: string;
     items: T[];
-}
+};

package/lib/commonjs/types/QpqPagedData.js.map

@@ -1 +1 @@
-{"version":3,"file":"QpqPagedData.js","sourceRoot":"","sources":["../../../src/types/QpqPagedData.ts"],"names":[],"mappings":"","sourcesContent":["export interface QpqPagedData<T> {\n  nextPageKey?: string;\n  items: T[];\n}\n"]}
+{"version":3,"file":"QpqPagedData.js","sourceRoot":"","sources":["../../../src/types/QpqPagedData.ts"],"names":[],"mappings":"","sourcesContent":["export type QpqPagedData<T> = {\n  nextPageKey?: string;\n  items: T[];\n};\n"]}

package/lib/commonjs/types/QueueEvent.d.ts

@@ -1,11 +1,11 @@
 import { QueueMessage } from '../actions';
-export interface QueueEventTypeParams {
+export type QueueEventTypeParams = {
     [key: string]: string;
-}
-export interface QueueEvent<T extends QueueMessage<any>> {
+};
+export type QueueEvent<T extends QueueMessage<any>> = {
     message: T;
     id: string;
     /** FIFO queues only: the MessageGroupId of the source record. */
     groupId?: string;
-}
+};
 export type QueueEventResponse = boolean;

package/lib/commonjs/types/QueueEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueueEvent.js","sourceRoot":"","sources":["../../../src/types/QueueEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { QueueMessage } from '../actions';\n\nexport interface QueueEventTypeParams {\n  [key: string]: string;\n}\n\nexport interface QueueEvent<T extends QueueMessage<any>> {\n  message: T;\n  id: string;\n\n  /** FIFO queues only: the MessageGroupId of the source record. */\n  groupId?: string;\n}\n\nexport type QueueEventResponse = boolean;\n"]}
+{"version":3,"file":"QueueEvent.js","sourceRoot":"","sources":["../../../src/types/QueueEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { QueueMessage } from '../actions';\n\nexport type QueueEventTypeParams = {\n  [key: string]: string;\n};\n\nexport type QueueEvent<T extends QueueMessage<any>> = {\n  message: T;\n  id: string;\n\n  /** FIFO queues only: the MessageGroupId of the source record. */\n  groupId?: string;\n};\n\nexport type QueueEventResponse = boolean;\n"]}

package/lib/commonjs/types/ScheduledEvent.d.ts

@@ -1,5 +1,5 @@
-export interface ScheduledEventParams<T extends Record<string, any> = {}> {
+export type ScheduledEventParams<T extends Record<string, any> = {}> = {
     time: string;
     correlation: string;
     metadata: T;
-}
+};

package/lib/commonjs/types/ScheduledEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScheduledEvent.js","sourceRoot":"","sources":["../../../src/types/ScheduledEvent.ts"],"names":[],"mappings":"","sourcesContent":["export interface ScheduledEventParams<T extends Record<string, any> = {}> {\n  time: string;\n  correlation: string;\n\n  metadata: T;\n}\n"]}
+{"version":3,"file":"ScheduledEvent.js","sourceRoot":"","sources":["../../../src/types/ScheduledEvent.ts"],"names":[],"mappings":"","sourcesContent":["export type ScheduledEventParams<T extends Record<string, any> = {}> = {\n  time: string;\n  correlation: string;\n\n  metadata: T;\n};\n"]}

package/lib/commonjs/types/StorySession.d.ts

@@ -2,15 +2,15 @@ import { Action } from './Action';
 import { QPQError } from './ErrorTypeEnum';
 import { QpqContext } from './QpqContextIdentifier';
 import { QpqFunctionRuntime } from './QpqFunctionRuntime';
-export interface DecodedAccessToken {
+export type DecodedAccessToken = {
     userId: string;
     username: string;
     exp: number;
     roles?: string[];
     userDirectory: string;
     wasValid: boolean;
-}
-export interface StorySession {
+};
+export type StorySession = {
     correlation?: string;
     depth: number;
     accessToken?: string;
@@ -18,49 +18,18 @@ export interface StorySession {
     context: QpqContext<any>;
     localContext?: QpqContext<any>;
     functionGlobals?: Record<string, unknown>;
-}
+};
 export type StorySessionUpdater = (newSession: Partial<StorySession>) => void;
 export type AskResponse<T> = Generator<Action<any>, T, any>;
 export type Story<TArgs extends any[], R> = (...args: TArgs) => AskResponse<R>;
 export type StoryResolver = <S extends Story<any, any>>(story: S) => (...args: Parameters<S>) => Promise<AskResponseReturnType<ReturnType<S>>>;
-/**
- * Utility Type: ExtractGeneratorReturnType
- *
- * This utility type is designed to extract the return type of a Generator without
- * conflating it with the types of values it may yield. Generators in TypeScript are
- * annotated as Generator<YieldType, ReturnType, NextType>, where YieldType is the
- * type of values yielded by the generator, ReturnType is the type the generator returns
- * when it's done, and NextType is the type of the value passed to the generator's `next` method.
- *
- * By leveraging TypeScript's conditional types and the `infer` keyword, ExtractGeneratorReturnType
- * can precisely capture and extract just the ReturnType of any given Generator, providing a clean,
- * type-safe way to understand what a generator ultimately returns upon completion.
- *
- * Usage of `infer` in Conditional Types:
- * The `infer` keyword is used here to declare a type variable R within the conditional type
- * expression. TypeScript will then infer the type R as the generator's ReturnType when the
- * condition `T extends Generator<any, infer R, any>` is met. This inference is based on the
- * actual type passed to ExtractGeneratorReturnType, allowing us to "pull out" the ReturnType
- * from within the Generator type.
- *
- * This approach is particularly useful because it directly targets the ReturnType without
- * having to manually sift through or exclude the types of values that might be yielded by
- * the generator, which can often be diverse and not relevant to the final return type we're
- * interested in capturing.
- *
- * The ExtractGeneratorReturnType utility type simplifies the extraction process and ensures
- * that types dependent on the return value of generators are accurately typed, enhancing
- * code readability and maintainability.
- */
-export type ExtractGeneratorReturnType<T extends Generator> = T extends Generator<any, infer R, any> ? R : never;
-export type AskResponseReturnType<T extends AskResponse<any>> = ExtractGeneratorReturnType<T>;
-export type qpqStory = <T = any>(...args: any[]) => AskResponse<T>;
-export interface ActionHistory<P = any, R = any> {
+export type AskResponseReturnType<T extends AskResponse<any>> = T extends Generator<any, infer R, any> ? R : never;
+export type ActionHistory<P = any, R = any> = {
     act: Action<P>;
     res: R;
     startedAt: string;
     finishedAt: string;
-}
+};
 export declare enum QpqRuntimeType {
     API = "API",
     EXECUTE_STORY = "EXECUTE_STORY",
@@ -81,11 +50,11 @@ export declare enum QpqRuntimeType {
     AUTH_CREATE_AUTH_CHALLENGE = "AUTH_CREATE_AUTH_CHALLENGE",
     AUTH_VERIFY_AUTH_CHALLENGE = "AUTH_VERIFY_AUTH_CHALLENGE"
 }
-export interface qpqConsoleLog {
+export type qpqConsoleLog = {
     t: string;
     a: any[];
-}
-export interface StoryResult<TArgs extends Array<any>, TResult = any> {
+};
+export type StoryResult<TArgs extends Array<any>, TResult = any> = {
     input: TArgs;
     session: StorySession;
     history: ActionHistory[];
@@ -100,7 +69,7 @@ export interface StoryResult<TArgs extends Array<any>, TResult = any> {
     runtimeType: QpqRuntimeType;
     logs?: qpqConsoleLog[];
     qpqFunctionRuntimeInfo?: QpqFunctionRuntime;
-}
+};
 export type StoryResultMetadata = {
     correlation: string;
     fromCorrelation?: string;

package/lib/commonjs/types/StorySession.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorySession.js","sourceRoot":"","sources":["../../../src/types/StorySession.ts"],"names":[],"mappings":";;;AA+GA,IAAY,cAsBX;AAtBD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,iDAA+B,CAAA;IAC/B,+EAA6D,CAAA;IAC7D,2DAAyC,CAAA;IACzC,6CAA2B,CAAA;IAC3B,+CAA6B,CAAA;IAC7B,+DAA6C,CAAA;IAC7C,qDAAmC,CAAA;IACnC,+CAA6B,CAAA;IAC7B,2DAAyC,CAAA;IACzC,uDAAqC,CAAA;IACrC,2DAAyC,CAAA;IAEzC,yCAAuB,CAAA;IACvB,2BAAS,CAAA;IAET,uDAAqC,CAAA;IAErC,2EAAyD,CAAA;IACzD,2EAAyD,CAAA;IACzD,2EAAyD,CAAA;AAC3D,CAAC,EAtBW,cAAc,8BAAd,cAAc,QAsBzB","sourcesContent":["import { Action } from './Action';\nimport { QPQError } from './ErrorTypeEnum';\nimport { QpqContext } from './QpqContextIdentifier';\nimport { QpqFunctionRuntime } from './QpqFunctionRuntime';\n\nexport interface DecodedAccessToken {\n  userId: string;\n  username: string;\n  // Unix timestamp (number of seconds since January 1, 1970 UTC).\n  exp: number;\n  roles?: string[];\n\n  userDirectory: string;\n  wasValid: boolean;\n}\n\nexport interface StorySession {\n  correlation?: string;\n  depth: number;\n\n  // This token is never transfer cross storys\n  // can't access it via events or anything\n  accessToken?: string;\n\n  // Decoded access token + roles token\n  decodedAccessToken?: DecodedAccessToken;\n\n  // Context\n  context: QpqContext<any>;\n\n  // Service-local context, this is never transferred across a service boundary\n  // (queue / event bus / service function), but does flow to in-process sub-runtimes.\n  localContext?: QpqContext<any>;\n\n  // Globals declared on the executing function's QpqFunctionRuntimeAdvanced.\n  // Set per-runtime from qpqFunctionRuntimeInfo. In-process nested runs also inherit the\n  // caller's (their own win on collision); transport entries (http/queue/ws) never do.\n  functionGlobals?: Record<string, unknown>;\n}\n\nexport type StorySessionUpdater = (newSession: Partial<StorySession>) => void;\n\nexport type AskResponse<T> = Generator<Action<any>, T, any>;\n\nexport type Story<TArgs extends any[], R> = (...args: TArgs) => AskResponse<R>;\nexport type StoryResolver = <S extends Story<any, any>>(story: S) => (...args: Parameters<S>) => Promise<AskResponseReturnType<ReturnType<S>>>;\n\n// function* test(msg: string): AskResponse<number> {\n//   return parseInt(msg);\n// }\n\n// function DoThing<S extends Story<any, any>>(story: S): (...args: Parameters<S>) => AskResponseReturnType<ReturnType<S>> {\n//   return (...args: Parameters<S>) => {\n//     return (() => {}) as any;\n//   };\n// }\n\n// const runTest = DoThing(test);\n// const num = runTest('a');\n\n/**\n * Utility Type: ExtractGeneratorReturnType\n *\n * This utility type is designed to extract the return type of a Generator without\n * conflating it with the types of values it may yield. Generators in TypeScript are\n * annotated as Generator<YieldType, ReturnType, NextType>, where YieldType is the\n * type of values yielded by the generator, ReturnType is the type the generator returns\n * when it's done, and NextType is the type of the value passed to the generator's `next` method.\n *\n * By leveraging TypeScript's conditional types and the `infer` keyword, ExtractGeneratorReturnType\n * can precisely capture and extract just the ReturnType of any given Generator, providing a clean,\n * type-safe way to understand what a generator ultimately returns upon completion.\n *\n * Usage of `infer` in Conditional Types:\n * The `infer` keyword is used here to declare a type variable R within the conditional type\n * expression. TypeScript will then infer the type R as the generator's ReturnType when the\n * condition `T extends Generator<any, infer R, any>` is met. This inference is based on the\n * actual type passed to ExtractGeneratorReturnType, allowing us to \"pull out\" the ReturnType\n * from within the Generator type.\n *\n * This approach is particularly useful because it directly targets the ReturnType without\n * having to manually sift through or exclude the types of values that might be yielded by\n * the generator, which can often be diverse and not relevant to the final return type we're\n * interested in capturing.\n *\n * The ExtractGeneratorReturnType utility type simplifies the extraction process and ensures\n * that types dependent on the return value of generators are accurately typed, enhancing\n * code readability and maintainability.\n */\n\nexport type ExtractGeneratorReturnType<T extends Generator> = T extends Generator<any, infer R, any> ? R : never;\n\n// Directly extracting the generator's return type for any given AskResponse.\n// By applying ExtractGeneratorReturnType to an AskResponse, we can determine the\n// precise type that the AskResponse generator returns, bypassing the complexities\n// of its yield types. This is particularly useful in scenarios where the return type\n// is distinct from the types of actions or values yielded by the generator, allowing\n// for clear type inference and usage in TypeScript codebases.\nexport type AskResponseReturnType<T extends AskResponse<any>> = ExtractGeneratorReturnType<T>;\n\n// Any generator function that returns an AskResponse\n// qpq runtimes are built on stories\nexport type qpqStory = <T = any>(...args: any[]) => AskResponse<T>;\n\nexport interface ActionHistory<P = any, R = any> {\n  act: Action<P>;\n  res: R;\n  startedAt: string;\n  finishedAt: string;\n}\n\nexport enum QpqRuntimeType {\n  API = 'API',\n  EXECUTE_STORY = 'EXECUTE_STORY',\n  EXECUTE_IMPLEMENTATION_STORY = 'EXECUTE_IMPLEMENTATION_STORY',\n  RECURRING_SCHEDULE = 'RECURRING_SCHEDULE',\n  QUEUE_EVENT = 'QUEUE_EVENT',\n  EVENT_SEO_OR = 'EVENT_SEO_OR',\n  SERVICE_FUNCTION_EXE = 'SERVICE_FUNCTION_EXE',\n  WEBSOCKET_EVENT = 'WEBSOCKET_EVENT',\n  DEPLOY_EVENT = 'DEPLOY_EVENT',\n  STORAGEDRIVE_EVENT = 'STORAGEDRIVE_EVENT',\n  KVS_STREAM_EVENT = 'KVS_STREAM_EVENT',\n  CLOUD_FLARE_DEPLOY = 'CLOUD_FLARE_DEPLOY',\n\n  UNIT_TEST = 'UNIT_TEST',\n  UI = 'UI',\n\n  SEND_EMAIL_EVENT = 'SEND_EMAIL_EVENT',\n\n  AUTH_DEFINE_AUTH_CHALLENGE = 'AUTH_DEFINE_AUTH_CHALLENGE',\n  AUTH_CREATE_AUTH_CHALLENGE = 'AUTH_CREATE_AUTH_CHALLENGE',\n  AUTH_VERIFY_AUTH_CHALLENGE = 'AUTH_VERIFY_AUTH_CHALLENGE',\n}\n\nexport interface qpqConsoleLog {\n  t: string;\n  a: any[];\n}\n\nexport interface StoryResult<TArgs extends Array<any>, TResult = any> {\n  // Params to story\n  input: TArgs;\n\n  // Story Session Data\n  session: StorySession;\n\n  // History of actions\n  history: ActionHistory[];\n\n  // When the story started / finished\n  startedAt: string;\n  finishedAt: string;\n\n  // correlationGuid from the calling story\n  fromCorrelation?: string;\n\n  // correlation for this story (correlates all actions together)\n  correlation: string;\n\n  // For logging, tags to help identify the story\n  tags: string[];\n  moduleName: string;\n\n  // Result of the story result or error not both\n  result?: TResult;\n  error?: QPQError;\n\n  // User specified runtime type\n  runtimeType: QpqRuntimeType;\n\n  // Impure Logs\n  logs?: qpqConsoleLog[];\n\n  // What was the function runtime that this was executed against\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime;\n}\n\nexport type StoryResultMetadata = {\n  correlation: string;\n  fromCorrelation?: string;\n\n  moduleName: string;\n  runtimeType: QpqRuntimeType;\n\n  startedAt: string;\n\n  generic: string;\n\n  error?: string;\n\n  executionTimeMs: number;\n\n  userInfo?: string;\n\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime;\n};\n\nexport type StoryResultMetadataWithChildren = StoryResultMetadata & {\n  children: StoryResultMetadataWithChildren[];\n};\n"]}
+{"version":3,"file":"StorySession.js","sourceRoot":"","sources":["../../../src/types/StorySession.ts"],"names":[],"mappings":";;;AA+DA,IAAY,cAsBX;AAtBD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,iDAA+B,CAAA;IAC/B,+EAA6D,CAAA;IAC7D,2DAAyC,CAAA;IACzC,6CAA2B,CAAA;IAC3B,+CAA6B,CAAA;IAC7B,+DAA6C,CAAA;IAC7C,qDAAmC,CAAA;IACnC,+CAA6B,CAAA;IAC7B,2DAAyC,CAAA;IACzC,uDAAqC,CAAA;IACrC,2DAAyC,CAAA;IAEzC,yCAAuB,CAAA;IACvB,2BAAS,CAAA;IAET,uDAAqC,CAAA;IAErC,2EAAyD,CAAA;IACzD,2EAAyD,CAAA;IACzD,2EAAyD,CAAA;AAC3D,CAAC,EAtBW,cAAc,8BAAd,cAAc,QAsBzB","sourcesContent":["import { Action } from './Action';\nimport { QPQError } from './ErrorTypeEnum';\nimport { QpqContext } from './QpqContextIdentifier';\nimport { QpqFunctionRuntime } from './QpqFunctionRuntime';\n\nexport type DecodedAccessToken = {\n  userId: string;\n  username: string;\n  // Unix timestamp (number of seconds since January 1, 1970 UTC).\n  exp: number;\n  roles?: string[];\n\n  userDirectory: string;\n  wasValid: boolean;\n};\n\nexport type StorySession = {\n  correlation?: string;\n  depth: number;\n\n  // This token is never transfer cross storys\n  // can't access it via events or anything\n  accessToken?: string;\n\n  // Decoded access token + roles token\n  decodedAccessToken?: DecodedAccessToken;\n\n  // Context\n  context: QpqContext<any>;\n\n  // Service-local context, this is never transferred across a service boundary\n  // (queue / event bus / service function), but does flow to in-process sub-runtimes.\n  localContext?: QpqContext<any>;\n\n  // Globals declared on the executing function's QpqFunctionRuntimeAdvanced.\n  // Set per-runtime from qpqFunctionRuntimeInfo. In-process nested runs also inherit the\n  // caller's (their own win on collision); transport entries (http/queue/ws) never do.\n  functionGlobals?: Record<string, unknown>;\n};\n\nexport type StorySessionUpdater = (newSession: Partial<StorySession>) => void;\n\nexport type AskResponse<T> = Generator<Action<any>, T, any>;\n\nexport type Story<TArgs extends any[], R> = (...args: TArgs) => AskResponse<R>;\nexport type StoryResolver = <S extends Story<any, any>>(story: S) => (...args: Parameters<S>) => Promise<AskResponseReturnType<ReturnType<S>>>;\n\n// Directly extracting the generator's return type for any given AskResponse.\n// By applying AskResponseReturnType to an AskResponse, we can determine the\n// precise type that the AskResponse generator returns, bypassing the complexities\n// of its yield types. This is particularly useful in scenarios where the return type\n// is distinct from the types of actions or values yielded by the generator, allowing\n// for clear type inference and usage in TypeScript codebases.\nexport type AskResponseReturnType<T extends AskResponse<any>> = T extends Generator<any, infer R, any> ? R : never;\n\n// Any generator function that returns an AskResponse\nexport type ActionHistory<P = any, R = any> = {\n  act: Action<P>;\n  res: R;\n  startedAt: string;\n  finishedAt: string;\n};\n\nexport enum QpqRuntimeType {\n  API = 'API',\n  EXECUTE_STORY = 'EXECUTE_STORY',\n  EXECUTE_IMPLEMENTATION_STORY = 'EXECUTE_IMPLEMENTATION_STORY',\n  RECURRING_SCHEDULE = 'RECURRING_SCHEDULE',\n  QUEUE_EVENT = 'QUEUE_EVENT',\n  EVENT_SEO_OR = 'EVENT_SEO_OR',\n  SERVICE_FUNCTION_EXE = 'SERVICE_FUNCTION_EXE',\n  WEBSOCKET_EVENT = 'WEBSOCKET_EVENT',\n  DEPLOY_EVENT = 'DEPLOY_EVENT',\n  STORAGEDRIVE_EVENT = 'STORAGEDRIVE_EVENT',\n  KVS_STREAM_EVENT = 'KVS_STREAM_EVENT',\n  CLOUD_FLARE_DEPLOY = 'CLOUD_FLARE_DEPLOY',\n\n  UNIT_TEST = 'UNIT_TEST',\n  UI = 'UI',\n\n  SEND_EMAIL_EVENT = 'SEND_EMAIL_EVENT',\n\n  AUTH_DEFINE_AUTH_CHALLENGE = 'AUTH_DEFINE_AUTH_CHALLENGE',\n  AUTH_CREATE_AUTH_CHALLENGE = 'AUTH_CREATE_AUTH_CHALLENGE',\n  AUTH_VERIFY_AUTH_CHALLENGE = 'AUTH_VERIFY_AUTH_CHALLENGE',\n}\n\nexport type qpqConsoleLog = {\n  t: string;\n  a: any[];\n};\n\nexport type StoryResult<TArgs extends Array<any>, TResult = any> = {\n  // Params to story\n  input: TArgs;\n\n  // Story Session Data\n  session: StorySession;\n\n  // History of actions\n  history: ActionHistory[];\n\n  // When the story started / finished\n  startedAt: string;\n  finishedAt: string;\n\n  // correlationGuid from the calling story\n  fromCorrelation?: string;\n\n  // correlation for this story (correlates all actions together)\n  correlation: string;\n\n  // For logging, tags to help identify the story\n  tags: string[];\n  moduleName: string;\n\n  // Result of the story result or error not both\n  result?: TResult;\n  error?: QPQError;\n\n  // User specified runtime type\n  runtimeType: QpqRuntimeType;\n\n  // Impure Logs\n  logs?: qpqConsoleLog[];\n\n  // What was the function runtime that this was executed against\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime;\n};\n\nexport type StoryResultMetadata = {\n  correlation: string;\n  fromCorrelation?: string;\n\n  moduleName: string;\n  runtimeType: QpqRuntimeType;\n\n  startedAt: string;\n\n  generic: string;\n\n  error?: string;\n\n  executionTimeMs: number;\n\n  userInfo?: string;\n\n  qpqFunctionRuntimeInfo?: QpqFunctionRuntime;\n};\n\nexport type StoryResultMetadataWithChildren = StoryResultMetadata & {\n  children: StoryResultMetadataWithChildren[];\n};\n"]}

package/lib/commonjs/types/StreamRegistry.d.ts

@@ -1,17 +1,17 @@
 export type StreamEncoding = 'text' | 'binary' | 'json';
 export type StreamDataType<E extends StreamEncoding, T = unknown> = E extends 'text' ? string : E extends 'binary' ? Uint8Array : E extends 'json' ? T : never;
-export interface StreamHandle<E extends StreamEncoding = StreamEncoding, T = unknown> {
+export type StreamHandle<E extends StreamEncoding = StreamEncoding, _T = unknown> = {
     id: string;
     encoding: E;
-}
-export interface StreamChunk<T = unknown> {
+};
+export type StreamChunk<T = unknown> = {
     done: boolean;
     skipped?: boolean;
     data?: T;
-}
-export interface StreamRegistry {
+};
+export type StreamRegistry = {
     register(id: string, iterator: AsyncIterableIterator<string>): void;
     read(id: string, noWait?: boolean): Promise<StreamChunk<string>>;
     close(id: string): void;
     has(id: string): boolean;
-}
+};

package/lib/commonjs/types/StreamRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"StreamRegistry.js","sourceRoot":"","sources":["../../../src/types/StreamRegistry.ts"],"names":[],"mappings":"","sourcesContent":["export type StreamEncoding = 'text' | 'binary' | 'json';\n\nexport type StreamDataType<E extends StreamEncoding, T = unknown> = E extends 'text'\n  ? string\n  : E extends 'binary'\n    ? Uint8Array\n    : E extends 'json'\n      ? T\n      : never;\n\nexport interface StreamHandle<E extends StreamEncoding = StreamEncoding, T = unknown> {\n  id: string;\n  encoding: E;\n}\n\nexport interface StreamChunk<T = unknown> {\n  done: boolean;\n  skipped?: boolean;\n  data?: T;\n}\n\nexport interface StreamRegistry {\n  register(id: string, iterator: AsyncIterableIterator<string>): void;\n  read(id: string, noWait?: boolean): Promise<StreamChunk<string>>;\n  close(id: string): void;\n  has(id: string): boolean;\n}\n"]}
+{"version":3,"file":"StreamRegistry.js","sourceRoot":"","sources":["../../../src/types/StreamRegistry.ts"],"names":[],"mappings":"","sourcesContent":["export type StreamEncoding = 'text' | 'binary' | 'json';\n\nexport type StreamDataType<E extends StreamEncoding, T = unknown> = E extends 'text'\n  ? string\n  : E extends 'binary'\n    ? Uint8Array\n    : E extends 'json'\n      ? T\n      : never;\n\n// The second parameter is a phantom: it carries the chunk type for callers and is never read here.\nexport type StreamHandle<E extends StreamEncoding = StreamEncoding, _T = unknown> = {\n  id: string;\n  encoding: E;\n};\n\nexport type StreamChunk<T = unknown> = {\n  done: boolean;\n  skipped?: boolean;\n  data?: T;\n};\n\nexport type StreamRegistry = {\n  register(id: string, iterator: AsyncIterableIterator<string>): void;\n  read(id: string, noWait?: boolean): Promise<StreamChunk<string>>;\n  close(id: string): void;\n  has(id: string): boolean;\n};\n"]}

package/lib/commonjs/types/TextFileType.d.ts

@@ -0,0 +1,12 @@
+export declare enum TextFileType {
+    Json = "Json",
+    Xml = "Xml",
+    PlainText = "PlainText",
+    Html = "Html",
+    Css = "Css",
+    JavaScript = "JavaScript",
+    Csv = "Csv",
+    Markdown = "Markdown",
+    Yaml = "Yaml",
+    Rtf = "Rtf"
+}

package/lib/commonjs/types/TextFileType.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextFileType = void 0;
+var TextFileType;
+(function (TextFileType) {
+    TextFileType["Json"] = "Json";
+    TextFileType["Xml"] = "Xml";
+    TextFileType["PlainText"] = "PlainText";
+    TextFileType["Html"] = "Html";
+    TextFileType["Css"] = "Css";
+    TextFileType["JavaScript"] = "JavaScript";
+    TextFileType["Csv"] = "Csv";
+    TextFileType["Markdown"] = "Markdown";
+    TextFileType["Yaml"] = "Yaml";
+    TextFileType["Rtf"] = "Rtf";
+})(TextFileType || (exports.TextFileType = TextFileType = {}));
+//# sourceMappingURL=TextFileType.js.map

package/lib/commonjs/types/TextFileType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextFileType.js","sourceRoot":"","sources":["../../../src/types/TextFileType.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,uCAAuB,CAAA;IACvB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,yCAAyB,CAAA;IACzB,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,6BAAa,CAAA;IACb,2BAAW,CAAA;AACb,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB","sourcesContent":["export enum TextFileType {\n  Json = 'Json',\n  Xml = 'Xml',\n  PlainText = 'PlainText',\n  Html = 'Html',\n  Css = 'Css',\n  JavaScript = 'JavaScript',\n  Csv = 'Csv',\n  Markdown = 'Markdown',\n  Yaml = 'Yaml',\n  Rtf = 'Rtf',\n}\n"]}

package/lib/commonjs/types/authChallenge/CreateAuthChallengeEvent.d.ts

@@ -4,6 +4,11 @@ export type CreateAuthChallengeEvent = {
     userName: string;
     session: ChallengeSession;
     userAttributes: UserAttributes;
+    /**
+     * true when the directory has no such user. With user existence errors suppressed the trigger still runs for an
+     * unknown account, and the story must answer exactly as it would for a real one so the two cannot be told apart.
+     */
+    userNotFound?: boolean;
 };
 /**
  * Represents the response for creating an authentication challenge.

package/lib/commonjs/types/authChallenge/CreateAuthChallengeEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"CreateAuthChallengeEvent.js","sourceRoot":"","sources":["../../../../src/types/authChallenge/CreateAuthChallengeEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { UserAttributes } from '../../actions';\nimport { ChallengeSession } from './types';\n\nexport type CreateAuthChallengeEvent = {\n  userName: string;\n  session: ChallengeSession;\n  userAttributes: UserAttributes;\n};\n\n/**\n * Represents the response for creating an authentication challenge.\n */\nexport type CreateAuthChallengeEventResponse = {\n  /**\n   * The name of the custom challenge\n   */\n  challengeName?: string;\n\n  /**\n   * Key-value pairs for the client app to use when presenting the challenge to the user.\n   * This parameter should contain all necessary information to accurately present the challenge.\n   */\n  publicChallengeParameters?: Record<string, string>;\n\n  /**\n   * Key-value pairs containing the information required to validate the user's response to the challenge.\n   * Typically, this contains the correct answers or validation criteria for the challenge.\n   */\n  privateChallengeParameters?: Record<string, string>;\n};\n"]}
+{"version":3,"file":"CreateAuthChallengeEvent.js","sourceRoot":"","sources":["../../../../src/types/authChallenge/CreateAuthChallengeEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { UserAttributes } from '../../actions';\nimport { ChallengeSession } from './types';\n\nexport type CreateAuthChallengeEvent = {\n  userName: string;\n  session: ChallengeSession;\n  userAttributes: UserAttributes;\n  /**\n   * true when the directory has no such user. With user existence errors suppressed the trigger still runs for an\n   * unknown account, and the story must answer exactly as it would for a real one so the two cannot be told apart.\n   */\n  userNotFound?: boolean;\n};\n\n/**\n * Represents the response for creating an authentication challenge.\n */\nexport type CreateAuthChallengeEventResponse = {\n  /**\n   * The name of the custom challenge\n   */\n  challengeName?: string;\n\n  /**\n   * Key-value pairs for the client app to use when presenting the challenge to the user.\n   * This parameter should contain all necessary information to accurately present the challenge.\n   */\n  publicChallengeParameters?: Record<string, string>;\n\n  /**\n   * Key-value pairs containing the information required to validate the user's response to the challenge.\n   * Typically, this contains the correct answers or validation criteria for the challenge.\n   */\n  privateChallengeParameters?: Record<string, string>;\n};\n"]}

package/lib/commonjs/types/authChallenge/DefineAuthChallengeEvent.d.ts

@@ -4,6 +4,11 @@ export type DefineAuthChallengeEvent = {
     userName: string;
     session: ChallengeSession;
     userAttributes: UserAttributes;
+    /**
+     * true when the directory has no such user. With user existence errors suppressed the trigger still runs for an
+     * unknown account, and the story must answer exactly as it would for a real one so the two cannot be told apart.
+     */
+    userNotFound?: boolean;
 };
 export type DefineAuthChallengeEventResponse = {
     runCreateAuthChallenge: boolean;

package/lib/commonjs/types/authChallenge/DefineAuthChallengeEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefineAuthChallengeEvent.js","sourceRoot":"","sources":["../../../../src/types/authChallenge/DefineAuthChallengeEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { UserAttributes } from '../../actions';\nimport { ChallengeSession } from './types';\n\nexport type DefineAuthChallengeEvent = {\n  userName: string;\n  session: ChallengeSession;\n  userAttributes: UserAttributes;\n};\n\nexport type DefineAuthChallengeEventResponse = {\n  runCreateAuthChallenge: boolean;\n  failAuthentication: boolean;\n  issueTokens: boolean;\n};\n"]}
+{"version":3,"file":"DefineAuthChallengeEvent.js","sourceRoot":"","sources":["../../../../src/types/authChallenge/DefineAuthChallengeEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { UserAttributes } from '../../actions';\nimport { ChallengeSession } from './types';\n\nexport type DefineAuthChallengeEvent = {\n  userName: string;\n  session: ChallengeSession;\n  userAttributes: UserAttributes;\n  /**\n   * true when the directory has no such user. With user existence errors suppressed the trigger still runs for an\n   * unknown account, and the story must answer exactly as it would for a real one so the two cannot be told apart.\n   */\n  userNotFound?: boolean;\n};\n\nexport type DefineAuthChallengeEventResponse = {\n  runCreateAuthChallenge: boolean;\n  failAuthentication: boolean;\n  issueTokens: boolean;\n};\n"]}

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

@@ -1,4 +1,6 @@
 export * from './Action';
+export * from './ActionOverrideHandler';
+export * from './ActionOverrideMap';
 export * from './ActionRequesterFunction';
 export * from './authChallenge';
 export * from './BoundLogicStory';
@@ -20,6 +22,7 @@ export * from './LogLevelEnum';
 export * from './Lookup';
 export * from './NotifyErrorQueueEvent';
 export * from './Nullable';
+export * from './OwnerDeploymentContext';
 export * from './QPQBinaryData';
 export * from './QpqContextIdentifier';
 export * from './QpqExecutionTrace';
@@ -33,6 +36,6 @@ export * from './Readonlyify';
 export * from './ScheduledEvent';
 export * from './StorySession';
 export * from './StreamRegistry';
+export * from './TextFileType';
 export * from './UnboundLogicStory';
 export * from './UnionToIntersection';
-export * from './utils';

package/lib/commonjs/types/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Action"), exports);
+__exportStar(require("./ActionOverrideHandler"), exports);
+__exportStar(require("./ActionOverrideMap"), exports);
 __exportStar(require("./ActionRequesterFunction"), exports);
 __exportStar(require("./authChallenge"), exports);
 __exportStar(require("./BoundLogicStory"), exports);
@@ -36,6 +38,7 @@ __exportStar(require("./LogLevelEnum"), exports);
 __exportStar(require("./Lookup"), exports);
 __exportStar(require("./NotifyErrorQueueEvent"), exports);
 __exportStar(require("./Nullable"), exports);
+__exportStar(require("./OwnerDeploymentContext"), exports);
 __exportStar(require("./QPQBinaryData"), exports);
 __exportStar(require("./QpqContextIdentifier"), exports);
 __exportStar(require("./QpqExecutionTrace"), exports);
@@ -49,7 +52,7 @@ __exportStar(require("./Readonlyify"), exports);
 __exportStar(require("./ScheduledEvent"), exports);
 __exportStar(require("./StorySession"), exports);
 __exportStar(require("./StreamRegistry"), exports);
+__exportStar(require("./TextFileType"), exports);
 __exportStar(require("./UnboundLogicStory"), exports);
 __exportStar(require("./UnionToIntersection"), exports);
-__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4DAA0C;AAC1C,kDAAgC;AAChC,oDAAkC;AAClC,0CAAwB;AACxB,wDAAsC;AACtC,uDAAqC;AACrC,qDAAmC;AACnC,6DAA2C;AAC3C,qDAAmC;AACnC,gDAA8B;AAC9B,wDAAsC;AACtC,kDAAgC;AAChC,iDAA+B;AAC/B,gDAA8B;AAC9B,2DAAyC;AACzC,0CAAwB;AACxB,mDAAiC;AACjC,iDAA+B;AAC/B,2CAAyB;AACzB,0DAAwC;AACxC,6CAA2B;AAC3B,kDAAgC;AAChC,yDAAuC;AACvC,sDAAoC;AACpC,uDAAqC;AACrC,mDAAiC;AACjC,8CAA4B;AAC5B,iDAA+B;AAC/B,oDAAkC;AAClC,+CAA6B;AAC7B,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,mDAAiC;AACjC,sDAAoC;AACpC,wDAAsC;AACtC,0CAAwB","sourcesContent":["export * from './Action';\nexport * from './ActionRequesterFunction';\nexport * from './authChallenge';\nexport * from './BoundLogicStory';\nexport * from './Brand';\nexport * from './ConfigUrlDefinition';\nexport * from './CrossModuleMessage';\nexport * from './CrossModuleOwner';\nexport * from './CrossServiceResourceName';\nexport * from './DecomposedString';\nexport * from './DeployEvent';\nexport * from './DynamicModuleLoader';\nexport * from './ErrorTypeEnum';\nexport * from './EventMessage';\nexport * from './ExcludeKeys';\nexport * from './FullyQualifiedResource';\nexport * from './KeyOf';\nexport * from './KvsStreamEvent';\nexport * from './LogLevelEnum';\nexport * from './Lookup';\nexport * from './NotifyErrorQueueEvent';\nexport * from './Nullable';\nexport * from './QPQBinaryData';\nexport * from './QpqContextIdentifier';\nexport * from './QpqExecutionTrace';\nexport * from './QpqFunctionRuntime';\nexport * from './QpqIsoDateTime';\nexport * from './QpqLogger';\nexport * from './QpqPagedData';\nexport * from './QpqPureFunction';\nexport * from './QueueEvent';\nexport * from './Readonlyify';\nexport * from './ScheduledEvent';\nexport * from './StorySession';\nexport * from './StreamRegistry';\nexport * from './UnboundLogicStory';\nexport * from './UnionToIntersection';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0DAAwC;AACxC,sDAAoC;AACpC,4DAA0C;AAC1C,kDAAgC;AAChC,oDAAkC;AAClC,0CAAwB;AACxB,wDAAsC;AACtC,uDAAqC;AACrC,qDAAmC;AACnC,6DAA2C;AAC3C,qDAAmC;AACnC,gDAA8B;AAC9B,wDAAsC;AACtC,kDAAgC;AAChC,iDAA+B;AAC/B,gDAA8B;AAC9B,2DAAyC;AACzC,0CAAwB;AACxB,mDAAiC;AACjC,iDAA+B;AAC/B,2CAAyB;AACzB,0DAAwC;AACxC,6CAA2B;AAC3B,2DAAyC;AACzC,kDAAgC;AAChC,yDAAuC;AACvC,sDAAoC;AACpC,uDAAqC;AACrC,mDAAiC;AACjC,8CAA4B;AAC5B,iDAA+B;AAC/B,oDAAkC;AAClC,+CAA6B;AAC7B,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,mDAAiC;AACjC,iDAA+B;AAC/B,sDAAoC;AACpC,wDAAsC","sourcesContent":["export * from './Action';\nexport * from './ActionOverrideHandler';\nexport * from './ActionOverrideMap';\nexport * from './ActionRequesterFunction';\nexport * from './authChallenge';\nexport * from './BoundLogicStory';\nexport * from './Brand';\nexport * from './ConfigUrlDefinition';\nexport * from './CrossModuleMessage';\nexport * from './CrossModuleOwner';\nexport * from './CrossServiceResourceName';\nexport * from './DecomposedString';\nexport * from './DeployEvent';\nexport * from './DynamicModuleLoader';\nexport * from './ErrorTypeEnum';\nexport * from './EventMessage';\nexport * from './ExcludeKeys';\nexport * from './FullyQualifiedResource';\nexport * from './KeyOf';\nexport * from './KvsStreamEvent';\nexport * from './LogLevelEnum';\nexport * from './Lookup';\nexport * from './NotifyErrorQueueEvent';\nexport * from './Nullable';\nexport * from './OwnerDeploymentContext';\nexport * from './QPQBinaryData';\nexport * from './QpqContextIdentifier';\nexport * from './QpqExecutionTrace';\nexport * from './QpqFunctionRuntime';\nexport * from './QpqIsoDateTime';\nexport * from './QpqLogger';\nexport * from './QpqPagedData';\nexport * from './QpqPureFunction';\nexport * from './QueueEvent';\nexport * from './Readonlyify';\nexport * from './ScheduledEvent';\nexport * from './StorySession';\nexport * from './StreamRegistry';\nexport * from './TextFileType';\nexport * from './UnboundLogicStory';\nexport * from './UnionToIntersection';\n"]}

package/lib/commonjs/utils/array/index.d.ts

@@ -1 +1,3 @@
+export * from './unique';
+export * from './uniqueBy';
 export * from './zipArrays';

package/lib/commonjs/utils/array/index.js

@@ -14,5 +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("./unique"), exports);
+__exportStar(require("./uniqueBy"), exports);
 __exportStar(require("./zipArrays"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/utils/array/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B","sourcesContent":["export * from './zipArrays';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B","sourcesContent":["export * from './unique';\nexport * from './uniqueBy';\nexport * from './zipArrays';\n"]}

package/lib/commonjs/utils/array/unique.d.ts

@@ -0,0 +1,2 @@
+/** The array with duplicate values removed, keeping the first of each (SameValueZero equality). */
+export declare const unique: <T>(array: T[]) => T[];

package/lib/commonjs/utils/array/unique.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unique = void 0;
+const uniqueBy_1 = require("./uniqueBy");
+/** The array with duplicate values removed, keeping the first of each (SameValueZero equality). */
+const unique = (array) => (0, uniqueBy_1.uniqueBy)(array, (item) => item);
+exports.unique = unique;
+//# sourceMappingURL=unique.js.map

package/lib/commonjs/utils/array/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../../../src/utils/array/unique.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,mGAAmG;AAC5F,MAAM,MAAM,GAAG,CAAI,KAAU,EAAO,EAAE,CAAC,IAAA,mBAAQ,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAAjE,QAAA,MAAM,UAA2D","sourcesContent":["import { uniqueBy } from './uniqueBy';\n\n/** The array with duplicate values removed, keeping the first of each (SameValueZero equality). */\nexport const unique = <T>(array: T[]): T[] => uniqueBy(array, (item) => item);\n"]}

package/lib/commonjs/utils/array/uniqueBy.d.ts

@@ -0,0 +1,2 @@
+/** Returns the array with duplicates removed, keeping the FIRST item for each key (SameValueZero key equality). */
+export declare function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[];

package/lib/commonjs/utils/array/uniqueBy.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniqueBy = uniqueBy;
+/** Returns the array with duplicates removed, keeping the FIRST item for each key (SameValueZero key equality). */
+function uniqueBy(array, keyFn) {
+    const seen = new Set();
+    return array.filter((item) => {
+        const key = keyFn(item);
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=uniqueBy.js.map

package/lib/commonjs/utils/array/uniqueBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueBy.js","sourceRoot":"","sources":["../../../../src/utils/array/uniqueBy.ts"],"names":[],"mappings":";;AACA,4BAUC;AAXD,mHAAmH;AACnH,SAAgB,QAAQ,CAAI,KAAU,EAAE,KAA2B;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** Returns the array with duplicates removed, keeping the FIRST item for each key (SameValueZero key equality). */\nexport function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[] {\n  const seen = new Set<unknown>();\n  return array.filter((item) => {\n    const key = keyFn(item);\n    if (seen.has(key)) {\n      return false;\n    }\n    seen.add(key);\n    return true;\n  });\n}\n"]}

package/lib/commonjs/utils/base64Url/base64Url.d.ts

@@ -1,3 +1,4 @@
+import { Nullable } from '../../types/Nullable';
 export declare const base64UrlEncodeUtf8: (text: string) => string;
 export declare const isBase64Url: (value: string) => boolean;
-export declare const base64UrlDecodeUtf8: (value: string) => string | null;
+export declare const base64UrlDecodeUtf8: (value: string) => Nullable<string>;

package/lib/commonjs/utils/base64Url/base64Url.js

@@ -1,15 +1,15 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.base64UrlDecodeUtf8 = exports.isBase64Url = exports.base64UrlEncodeUtf8 = void 0;
 // Base64url (RFC 4648 §5, unpadded) over UTF-8 text, on web globals
 // (TextEncoder/TextDecoder/btoa/atob) rather than Node's Buffer so it works in
 // browser bundles of @qpqjs/core too. This is the JOSE encoding: JWT
 // headers and payloads are base64url, never plain base64.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.base64UrlDecodeUtf8 = exports.isBase64Url = exports.base64UrlEncodeUtf8 = void 0;
 const base64UrlEncodeUtf8 = (text) => {
     const bytes = new TextEncoder().encode(text);
     let binary = '';
-    for (let i = 0; i < bytes.length; i += 1) {
-        binary += String.fromCharCode(bytes[i]);
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
     }
     return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
 };