@qpqjs/core 0.3.0 → 0.5.0

package/lib/esm/index.d.ts

@@ -4,13 +4,11 @@ export * from './constants';
 export * from './createImplementationRuntime';
 export * from './deployment';
 export * from './logic';
-export * from './logic/actionLogic';
-export * from './proiseify';
+export * from './promiseify';
 export * from './qpqCoreUtilsLib';
 export * from './qpqExecuteLog';
 export * from './runtime';
 export * from './stories';
-export * from './testing';
 export * from './types';
 export * from './utils';
 export * from './validators';

package/lib/esm/index.js

@@ -4,13 +4,11 @@ export * from './constants';
 export * from './createImplementationRuntime';
 export * from './deployment';
 export * from './logic';
-export * from './logic/actionLogic';
-export * from './proiseify';
+export * from './promiseify';
 export * from './qpqCoreUtilsLib';
 export * from './qpqExecuteLog';
 export * from './runtime';
 export * from './stories';
-export * from './testing';
 export * from './types';
 export * from './utils';
 export * from './validators';

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './deployment';\nexport * from './logic';\nexport * from './logic/actionLogic';\nexport * from './proiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './testing';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './deployment';\nexport * from './logic';\nexport * from './promiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}

package/lib/esm/logic/actionResult/ErrorMap.d.ts

@@ -0,0 +1,5 @@
+import { ActionProcessorResult } from '../../types/Action';
+/** Error name (or OS code) to the catalogued result a processor answers for it. */
+export type ErrorMap = {
+    [key: string]: (error: Error) => ActionProcessorResult<any>;
+};

package/lib/esm/logic/actionResult/ErrorMap.js

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

package/lib/esm/logic/actionResult/ErrorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorMap.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/ErrorMap.ts"],"names":[],"mappings":"","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\n\n/** Error name (or OS code) to the catalogued result a processor answers for it. */\nexport type ErrorMap = { [key: string]: (error: Error) => ActionProcessorResult<any> };\n"]}

package/lib/esm/logic/actionResult/actionResult.d.ts

@@ -0,0 +1,2 @@
+import { ActionProcessorResult } from '../../types/Action';
+export declare const actionResult: <T>(result: T) => ActionProcessorResult<T>;

package/lib/esm/logic/actionResult/actionResult.js

@@ -0,0 +1,4 @@
+export const actionResult = (result) => {
+    return [result];
+};
+//# sourceMappingURL=actionResult.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/actionResult.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,MAAS,EAA4B,EAAE;IACrE,OAAO,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC,CAAC","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\n\nexport const actionResult = <T>(result: T): ActionProcessorResult<T> => {\n  return [result];\n};\n"]}

package/lib/esm/logic/actionResult/actionResultError.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorResult } from '../../types/Action';
+import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';
+export declare const actionResultError: (errorType: ErrorTypeEnum | string, errorText: string, errorStack?: string) => ActionProcessorResult<any>;

package/lib/esm/logic/actionResult/actionResultError.js

@@ -0,0 +1,4 @@
+export const actionResultError = (errorType, errorText, errorStack) => {
+    return [undefined, { errorType, errorText, errorStack }];
+};
+//# sourceMappingURL=actionResultError.js.map

package/lib/esm/logic/actionResult/actionResultError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionResultError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/actionResultError.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiC,EAAE,SAAiB,EAAE,UAAmB,EAA8B,EAAE;IACzI,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\nimport { ErrorTypeEnum } from '../../types/ErrorTypeEnum';\n\nexport const actionResultError = (errorType: ErrorTypeEnum | string, errorText: string, errorStack?: string): ActionProcessorResult<any> => {\n  return [undefined, { errorType, errorText, errorStack }];\n};\n"]}

package/lib/esm/logic/actionResult/actionResultErrorFromCaughtError.d.ts

@@ -0,0 +1,3 @@
+import { actionResultError } from './actionResultError';
+import { ErrorMap } from './ErrorMap';
+export declare const actionResultErrorFromCaughtError: (error: unknown, errorMap?: ErrorMap) => ReturnType<typeof actionResultError>;

package/lib/esm/logic/actionResult/actionResultErrorFromCaughtError.js

@@ -0,0 +1,19 @@
+import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';
+import { actionResultError } from './actionResultError';
+// The generic fallback knows nothing about any platform: a name the map does not carry is a
+// GenericError. Transient classification is a map entry too (see transientErrorMap).
+export const actionResultErrorFromCaughtError = (error, errorMap = {}) => {
+    if (error instanceof Error) {
+        const errorCode = error.code;
+        const errorName = error.name;
+        // Prefer the OS/runtime code (node fs: EACCES, ENOENT...), then fall back
+        // to the error name (AWS SDK: AccessDenied, NoSuchBucket...).
+        const handler = (errorCode && errorMap[errorCode]) || errorMap[errorName];
+        if (handler) {
+            return handler(error);
+        }
+        return actionResultError(ErrorTypeEnum.GenericError, `An unexpected error occurred [${errorCode ?? errorName}].`);
+    }
+    return actionResultError(ErrorTypeEnum.GenericError, 'An unknown error occurred.');
+};
+//# sourceMappingURL=actionResultErrorFromCaughtError.js.map

package/lib/esm/logic/actionResult/actionResultErrorFromCaughtError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionResultErrorFromCaughtError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/actionResultErrorFromCaughtError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,4FAA4F;AAC5F,qFAAqF;AACrF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,KAAc,EAAE,WAAqB,EAAE,EAAwC,EAAE;IAChI,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAI,KAAa,CAAC,IAA0B,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAE7B,0EAA0E;QAC1E,8DAA8D;QAC9D,MAAM,OAAO,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,iBAAiB,CAAC,aAAa,CAAC,YAAY,EAAE,iCAAiC,SAAS,IAAI,SAAS,IAAI,CAAC,CAAC;IACpH,CAAC;IAED,OAAO,iBAAiB,CAAC,aAAa,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;AACrF,CAAC,CAAC","sourcesContent":["import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';\nimport { actionResultError } from './actionResultError';\nimport { ErrorMap } from './ErrorMap';\n\n// The generic fallback knows nothing about any platform: a name the map does not carry is a\n// GenericError. Transient classification is a map entry too (see transientErrorMap).\nexport const actionResultErrorFromCaughtError = (error: unknown, errorMap: ErrorMap = {}): ReturnType<typeof actionResultError> => {\n  if (error instanceof Error) {\n    const errorCode = (error as any).code as string | undefined;\n    const errorName = error.name;\n\n    // Prefer the OS/runtime code (node fs: EACCES, ENOENT...), then fall back\n    // to the error name (AWS SDK: AccessDenied, NoSuchBucket...).\n    const handler = (errorCode && errorMap[errorCode]) || errorMap[errorName];\n    if (handler) {\n      return handler(error);\n    }\n\n    return actionResultError(ErrorTypeEnum.GenericError, `An unexpected error occurred [${errorCode ?? errorName}].`);\n  }\n\n  return actionResultError(ErrorTypeEnum.GenericError, 'An unknown error occurred.');\n};\n"]}

package/lib/esm/logic/actionResult/getSuccessfulEitherActionResult.d.ts

@@ -0,0 +1,2 @@
+import { EitherActionResult } from '../../types/Action';
+export declare const getSuccessfulEitherActionResult: <T>(result: T) => EitherActionResult<T>;

package/lib/esm/logic/actionResult/getSuccessfulEitherActionResult.js

@@ -0,0 +1,5 @@
+export const getSuccessfulEitherActionResult = (result) => ({
+    success: true,
+    result,
+});
+//# sourceMappingURL=getSuccessfulEitherActionResult.js.map

package/lib/esm/logic/actionResult/getSuccessfulEitherActionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSuccessfulEitherActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/getSuccessfulEitherActionResult.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAI,MAAS,EAAyB,EAAE,CAAC,CAAC;IACvF,OAAO,EAAE,IAAI;IACb,MAAM;CACP,CAAC,CAAC","sourcesContent":["import { EitherActionResult } from '../../types/Action';\n\nexport const getSuccessfulEitherActionResult = <T>(result: T): EitherActionResult<T> => ({\n  success: true,\n  result,\n});\n"]}

package/lib/esm/logic/actionResult/getUnsuccessfulEitherActionResult.d.ts

@@ -0,0 +1,3 @@
+import { EitherActionResult } from '../../types/Action';
+import { QPQError } from '../../types/ErrorTypeEnum';
+export declare const getUnsuccessfulEitherActionResult: (error: QPQError) => EitherActionResult<any>;

package/lib/esm/logic/actionResult/getUnsuccessfulEitherActionResult.js

@@ -0,0 +1,5 @@
+export const getUnsuccessfulEitherActionResult = (error) => ({
+    success: false,
+    error: error,
+});
+//# sourceMappingURL=getUnsuccessfulEitherActionResult.js.map

package/lib/esm/logic/actionResult/getUnsuccessfulEitherActionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUnsuccessfulEitherActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/getUnsuccessfulEitherActionResult.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAe,EAA2B,EAAE,CAAC,CAAC;IAC9F,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;CACb,CAAC,CAAC","sourcesContent":["import { EitherActionResult } from '../../types/Action';\nimport { QPQError } from '../../types/ErrorTypeEnum';\n\nexport const getUnsuccessfulEitherActionResult = (error: QPQError): EitherActionResult<any> => ({\n  success: false,\n  error: error,\n});\n"]}

package/lib/esm/logic/actionResult/index.d.ts

@@ -0,0 +1,10 @@
+export * from './actionResult';
+export * from './actionResultError';
+export * from './actionResultErrorFromCaughtError';
+export * from './ErrorMap';
+export * from './getSuccessfulEitherActionResult';
+export * from './getUnsuccessfulEitherActionResult';
+export * from './isErroredActionResult';
+export * from './resolveActionResult';
+export * from './resolveActionResultError';
+export * from './transientErrorMap';

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

@@ -0,0 +1,11 @@
+export * from './actionResult';
+export * from './actionResultError';
+export * from './actionResultErrorFromCaughtError';
+export * from './ErrorMap';
+export * from './getSuccessfulEitherActionResult';
+export * from './getUnsuccessfulEitherActionResult';
+export * from './isErroredActionResult';
+export * from './resolveActionResult';
+export * from './resolveActionResultError';
+export * from './transientErrorMap';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oCAAoC,CAAC;AACnD,cAAc,YAAY,CAAC;AAC3B,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC","sourcesContent":["export * from './actionResult';\nexport * from './actionResultError';\nexport * from './actionResultErrorFromCaughtError';\nexport * from './ErrorMap';\nexport * from './getSuccessfulEitherActionResult';\nexport * from './getUnsuccessfulEitherActionResult';\nexport * from './isErroredActionResult';\nexport * from './resolveActionResult';\nexport * from './resolveActionResultError';\nexport * from './transientErrorMap';\n"]}

package/lib/esm/logic/actionResult/isErroredActionResult.d.ts

@@ -0,0 +1,2 @@
+import { ActionProcessorResult } from '../../types/Action';
+export declare const isErroredActionResult: <T>(actionResult: ActionProcessorResult<T>) => boolean;

package/lib/esm/logic/actionResult/isErroredActionResult.js

@@ -0,0 +1,4 @@
+export const isErroredActionResult = (actionResult) => {
+    return !actionResult || !!actionResult[1];
+};
+//# sourceMappingURL=isErroredActionResult.js.map

package/lib/esm/logic/actionResult/isErroredActionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isErroredActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/isErroredActionResult.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAI,YAAsC,EAAW,EAAE;IAC1F,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\n\nexport const isErroredActionResult = <T>(actionResult: ActionProcessorResult<T>): boolean => {\n  return !actionResult || !!actionResult[1];\n};\n"]}

package/lib/esm/logic/actionResult/resolveActionResult.d.ts

@@ -0,0 +1,2 @@
+import { ActionProcessorResult } from '../../types/Action';
+export declare const resolveActionResult: <T>(actionResult: ActionProcessorResult<T>) => NonNullable<T>;

package/lib/esm/logic/actionResult/resolveActionResult.js

@@ -0,0 +1,6 @@
+export const resolveActionResult = (actionResult) => {
+    // We say that it has to have a value, otherwise don't call this function
+    // use isErroredActionResult to check
+    return actionResult[0];
+};
+//# sourceMappingURL=resolveActionResult.js.map

package/lib/esm/logic/actionResult/resolveActionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/resolveActionResult.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAI,YAAsC,EAAE,EAAE;IAC/E,yEAAyE;IACzE,qCAAqC;IACrC,OAAO,YAAY,CAAC,CAAC,CAAE,CAAC;AAC1B,CAAC,CAAC","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\n\nexport const resolveActionResult = <T>(actionResult: ActionProcessorResult<T>) => {\n  // We say that it has to have a value, otherwise don't call this function\n  // use isErroredActionResult to check\n  return actionResult[0]!;\n};\n"]}

package/lib/esm/logic/actionResult/resolveActionResultError.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorResult } from '../../types/Action';
+import { QPQError } from '../../types/ErrorTypeEnum';
+export declare const resolveActionResultError: <T>(actionResult: ActionProcessorResult<T>) => QPQError;

package/lib/esm/logic/actionResult/resolveActionResultError.js

@@ -0,0 +1,11 @@
+import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';
+export const resolveActionResultError = (actionResult) => {
+    if (!actionResult) {
+        return {
+            errorText: `Action processor returned no result [${JSON.stringify(actionResult)}]`,
+            errorType: ErrorTypeEnum.GenericError,
+        };
+    }
+    return actionResult[1];
+};
+//# sourceMappingURL=resolveActionResultError.js.map

package/lib/esm/logic/actionResult/resolveActionResultError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActionResultError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/resolveActionResultError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAY,MAAM,2BAA2B,CAAC;AAEpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAI,YAAsC,EAAY,EAAE;IAC9F,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,SAAS,EAAE,wCAAwC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG;YAClF,SAAS,EAAE,aAAa,CAAC,YAAY;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,CAAC,CAAa,CAAC;AACrC,CAAC,CAAC","sourcesContent":["import { ActionProcessorResult } from '../../types/Action';\nimport { ErrorTypeEnum, QPQError } from '../../types/ErrorTypeEnum';\n\nexport const resolveActionResultError = <T>(actionResult: ActionProcessorResult<T>): QPQError => {\n  if (!actionResult) {\n    return {\n      errorText: `Action processor returned no result [${JSON.stringify(actionResult)}]`,\n      errorType: ErrorTypeEnum.GenericError,\n    };\n  }\n\n  return actionResult[1] as QPQError;\n};\n"]}

package/lib/esm/logic/actionResult/transientErrorMap.d.ts

@@ -0,0 +1,28 @@
+import { ErrorMap } from './ErrorMap';
+/**
+ * AWS / runtime error names that mean "try again shortly", not "this will never work".
+ *
+ * These are RATE and CAPACITY signals, not faults in the request. A throttled DynamoDB write or a
+ * throttled Lambda invoke is a statement about the last few seconds of traffic, and the identical call a
+ * moment later usually succeeds.
+ *
+ * They matter because the default classification is the opposite. An unmapped error name falls through to
+ * GenericError, which callers reasonably treat as terminal, so a caller with retry machinery available
+ * will not use it, and a caller that records failures durably will record a permanent failure for
+ * something that was only ever momentary. That was observed in DocGen: a 300-record fanned-out batch put
+ * ~100 concurrent flows against DynamoDB, 64 records came back `ThrottlingException`, and every one was
+ * written down as a failed run rather than retried.
+ *
+ * Mapping them to OutOfResources gives callers a single typed thing to branch on, instead of matching
+ * substrings against error text.
+ */
+export declare const TRANSIENT_ERROR_NAMES: ReadonlySet<string>;
+/** Whether an error name or OS code names a transient, worth-retrying condition. */
+export declare const isTransientErrorName: (name?: string) => boolean;
+/**
+ * The error-map entries that classify every transient name, for a processor to spread ahead of its own
+ * map: `actionResultErrorFromCaughtError(error, { ...transientErrorMap(), NoSuchBucket: ... })`. The
+ * processor's own entry for a name wins. Defaults to the bare OutOfResources; pass the action's own
+ * catalogued throttle entry where it has one.
+ */
+export declare const transientErrorMap: (errorType?: string) => ErrorMap;

package/lib/esm/logic/actionResult/transientErrorMap.js

@@ -0,0 +1,56 @@
+import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';
+import { actionResultError } from './actionResultError';
+/**
+ * AWS / runtime error names that mean "try again shortly", not "this will never work".
+ *
+ * These are RATE and CAPACITY signals, not faults in the request. A throttled DynamoDB write or a
+ * throttled Lambda invoke is a statement about the last few seconds of traffic, and the identical call a
+ * moment later usually succeeds.
+ *
+ * They matter because the default classification is the opposite. An unmapped error name falls through to
+ * GenericError, which callers reasonably treat as terminal, so a caller with retry machinery available
+ * will not use it, and a caller that records failures durably will record a permanent failure for
+ * something that was only ever momentary. That was observed in DocGen: a 300-record fanned-out batch put
+ * ~100 concurrent flows against DynamoDB, 64 records came back `ThrottlingException`, and every one was
+ * written down as a failed run rather than retried.
+ *
+ * Mapping them to OutOfResources gives callers a single typed thing to branch on, instead of matching
+ * substrings against error text.
+ */
+export const TRANSIENT_ERROR_NAMES = new Set([
+    // Generic AWS SDK throttle, used by DynamoDB, SQS, Lambda and others.
+    'ThrottlingException',
+    'Throttling',
+    'ThrottledException',
+    'RequestThrottled',
+    'RequestThrottledException',
+    'TooManyRequestsException',
+    // DynamoDB capacity.
+    'ProvisionedThroughputExceededException',
+    'RequestLimitExceeded',
+    // Lambda concurrency.
+    'EC2ThrottledException',
+    // Transient service-side failures, retrying is the documented response to both.
+    'ServiceUnavailable',
+    'InternalServerError',
+    'InternalFailure',
+    'ServiceException',
+    // Network-level interruptions.
+    'TimeoutError',
+    'RequestTimeout',
+    'RequestTimeoutException',
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'EPIPE',
+    'ENOTFOUND',
+]);
+/** Whether an error name or OS code names a transient, worth-retrying condition. */
+export const isTransientErrorName = (name) => !!name && TRANSIENT_ERROR_NAMES.has(name);
+/**
+ * The error-map entries that classify every transient name, for a processor to spread ahead of its own
+ * map: `actionResultErrorFromCaughtError(error, { ...transientErrorMap(), NoSuchBucket: ... })`. The
+ * processor's own entry for a name wins. Defaults to the bare OutOfResources; pass the action's own
+ * catalogued throttle entry where it has one.
+ */
+export const transientErrorMap = (errorType = ErrorTypeEnum.OutOfResources) => Object.fromEntries([...TRANSIENT_ERROR_NAMES].map((name) => [name, () => actionResultError(errorType, `A transient error occurred, retry [${name}].`)]));
+//# sourceMappingURL=transientErrorMap.js.map

package/lib/esm/logic/actionResult/transientErrorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transientErrorMap.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/transientErrorMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,sEAAsE;IACtE,qBAAqB;IACrB,YAAY;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,2BAA2B;IAC3B,0BAA0B;IAC1B,qBAAqB;IACrB,wCAAwC;IACxC,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,gFAAgF;IAChF,oBAAoB;IACpB,qBAAqB;IACrB,iBAAiB;IACjB,kBAAkB;IAClB,+BAA+B;IAC/B,cAAc;IACd,gBAAgB;IAChB,yBAAyB;IACzB,YAAY;IACZ,WAAW;IACX,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAE1G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAoB,aAAa,CAAC,cAAc,EAAY,EAAE,CAC9F,MAAM,CAAC,WAAW,CAChB,CAAC,GAAG,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,sCAAsC,IAAI,IAAI,CAAC,CAAC,CAAC,CACrI,CAAC","sourcesContent":["import { ErrorTypeEnum } from '../../types/ErrorTypeEnum';\nimport { actionResultError } from './actionResultError';\nimport { ErrorMap } from './ErrorMap';\n\n/**\n * AWS / runtime error names that mean \"try again shortly\", not \"this will never work\".\n *\n * These are RATE and CAPACITY signals, not faults in the request. A throttled DynamoDB write or a\n * throttled Lambda invoke is a statement about the last few seconds of traffic, and the identical call a\n * moment later usually succeeds.\n *\n * They matter because the default classification is the opposite. An unmapped error name falls through to\n * GenericError, which callers reasonably treat as terminal, so a caller with retry machinery available\n * will not use it, and a caller that records failures durably will record a permanent failure for\n * something that was only ever momentary. That was observed in DocGen: a 300-record fanned-out batch put\n * ~100 concurrent flows against DynamoDB, 64 records came back `ThrottlingException`, and every one was\n * written down as a failed run rather than retried.\n *\n * Mapping them to OutOfResources gives callers a single typed thing to branch on, instead of matching\n * substrings against error text.\n */\nexport const TRANSIENT_ERROR_NAMES: ReadonlySet<string> = new Set([\n  // Generic AWS SDK throttle, used by DynamoDB, SQS, Lambda and others.\n  'ThrottlingException',\n  'Throttling',\n  'ThrottledException',\n  'RequestThrottled',\n  'RequestThrottledException',\n  'TooManyRequestsException',\n  // DynamoDB capacity.\n  'ProvisionedThroughputExceededException',\n  'RequestLimitExceeded',\n  // Lambda concurrency.\n  'EC2ThrottledException',\n  // Transient service-side failures, retrying is the documented response to both.\n  'ServiceUnavailable',\n  'InternalServerError',\n  'InternalFailure',\n  'ServiceException',\n  // Network-level interruptions.\n  'TimeoutError',\n  'RequestTimeout',\n  'RequestTimeoutException',\n  'ECONNRESET',\n  'ETIMEDOUT',\n  'EPIPE',\n  'ENOTFOUND',\n]);\n\n/** Whether an error name or OS code names a transient, worth-retrying condition. */\nexport const isTransientErrorName = (name?: string): boolean => !!name && TRANSIENT_ERROR_NAMES.has(name);\n\n/**\n * The error-map entries that classify every transient name, for a processor to spread ahead of its own\n * map: `actionResultErrorFromCaughtError(error, { ...transientErrorMap(), NoSuchBucket: ... })`. The\n * processor's own entry for a name wins. Defaults to the bare OutOfResources; pass the action's own\n * catalogued throttle entry where it has one.\n */\nexport const transientErrorMap = (errorType: string = ErrorTypeEnum.OutOfResources): ErrorMap =>\n  Object.fromEntries(\n    [...TRANSIENT_ERROR_NAMES].map((name) => [name, () => actionResultError(errorType, `A transient error occurred, retry [${name}].`)]),\n  );\n"]}

package/lib/esm/logic/actions/createActionProcessor.d.ts

@@ -0,0 +1,5 @@
+import { QPQConfig } from '../../config';
+import { ActionProcessorListResolver } from '../../types/Action';
+import { AnyActionRequesterFunction, ProcessorFor } from '../../types/ActionRequesterFunction';
+import { DynamicModuleLoader } from '../../types/DynamicModuleLoader';
+export declare const createActionProcessor: <TRequester extends AnyActionRequesterFunction>(requester: TRequester, getProcessor: (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader) => ProcessorFor<TRequester> | Promise<ProcessorFor<TRequester>>) => ActionProcessorListResolver;

package/lib/esm/logic/actions/createActionProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActionProcessor.js","sourceRoot":"","sources":["../../../../src/logic/actions/createActionProcessor.ts"],"names":[],"mappings":"AAKA,uFAAuF;AACvF,qFAAqF;AACrF,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAChC,CACE,SAAqB,EACrB,YAA8I,EACjH,EAAE,CACjC,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC,SAAS,EAAE,mBAAmB,CAAC;CAC3E,CAAC,CAAC","sourcesContent":["import { QPQConfig } from '../../config';\nimport { ActionProcessorListResolver } from '../../types/Action';\nimport { AnyActionRequesterFunction, ProcessorFor } from '../../types/ActionRequesterFunction';\nimport { DynamicModuleLoader } from '../../types/DynamicModuleLoader';\n\n// Builds the single-entry processor map from the requester itself, so the registration\n// key can never drift from the action type the requester yields, and the processor's\n// payload and return types are checked against the requester's.\nexport const createActionProcessor =\n  <TRequester extends AnyActionRequesterFunction>(\n    requester: TRequester,\n    getProcessor: (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader) => ProcessorFor<TRequester> | Promise<ProcessorFor<TRequester>>,\n  ): ActionProcessorListResolver =>\n  async (qpqConfig, dynamicModuleLoader) => ({\n    [requester.actionType]: await getProcessor(qpqConfig, dynamicModuleLoader),\n  });\n"]}

package/lib/esm/logic/actions/createActionRequester.d.ts

@@ -0,0 +1,2 @@
+import { ActionRequesterDefinition, ActionRequesterFunction } from '../../types/ActionRequesterFunction';
+export declare const createActionRequester: <TReturn>() => <TType extends string, TArgs extends unknown[] = [], TPayload = undefined, TErrorTypes extends string = never>(definition: ActionRequesterDefinition<TType, TArgs, TPayload, TErrorTypes>) => ActionRequesterFunction<TType, TArgs, TPayload, TReturn, TErrorTypes>;

package/lib/esm/logic/actions/createActionRequester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActionRequester.js","sourceRoot":"","sources":["../../../../src/logic/actions/createActionRequester.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,oFAAoF;AACpF,gFAAgF;AAChF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAChC,GAAY,EAAE,CACd,CACE,UAA0E,EACH,EAAE;IACzE,kFAAkF;IAClF,+CAA+C;IAC/C,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,IAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAkC,CAAC;IAEhG,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAW;QAChC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAEpC,+EAA+E;QAC/E,wCAAwC;QACxC,OAAO,MAAM,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;IAClH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QAC9B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,UAAU;QACV,SAAS,EAAE,wBAAwB,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC;KACxF,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Action, ActionRequester } from '../../types/Action';\nimport { ActionRequesterDefinition, ActionRequesterFunction } from '../../types/ActionRequesterFunction';\nimport { createErrorEnumForAction } from './createErrorEnumForAction';\n\n// Curried because TypeScript has no partial type inference: the outer call pins the\n// action's return type explicitly, the inner call infers the action type, args,\n// payload shape and error catalog from the definition object.\nexport const createActionRequester =\n  <TReturn>() =>\n  <TType extends string, TArgs extends unknown[] = [], TPayload = undefined, TErrorTypes extends string = never>(\n    definition: ActionRequesterDefinition<TType, TArgs, TPayload, TErrorTypes>,\n  ): ActionRequesterFunction<TType, TArgs, TPayload, TReturn, TErrorTypes> => {\n    // Payload-less actions omit getPayload; the cast pins the stand-in builder to the\n    // defaulted TArgs = [] / TPayload = undefined.\n    const getPayload = definition.getPayload ?? ((() => undefined) as (...args: TArgs) => TPayload);\n\n    function* askAction(...args: TArgs): ActionRequester<Action<TPayload> & { type: TType }, TReturn> {\n      const payload = getPayload(...args);\n\n      // Payload-less actions yield { type } with no payload key at all, matching the\n      // hand-written requester shape exactly.\n      return yield payload === undefined ? { type: definition.actionType } : { type: definition.actionType, payload };\n    }\n\n    return Object.assign(askAction, {\n      actionType: definition.actionType,\n      getPayload,\n      errorType: createErrorEnumForAction(definition.actionType, definition.errorTypes ?? []),\n    });\n  };\n"]}

package/lib/esm/logic/actions/createErrorEnumForAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createErrorEnumForAction.js","sourceRoot":"","sources":["../../../../src/logic/actions/createErrorEnumForAction.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAClE,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAmB,IAAY,EAAE,MAAW;IAClF,kFAAkF;IAClF,+EAA+E;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,GAAG,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,GAAG,CAAC;IACb,CAAC,EACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAyB,CAC5C,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["export function createErrorTypeEnumValue(base: string, error: string): string {\n  return `${base}-${error}`;\n}\n\nexport function createErrorEnumForAction<T extends string>(base: string, values: T[]): { [K in T]: string } {\n  // Null prototype so every value lands as an own property. On a plain object a key\n  // like \"__proto__\" would hit the prototype setter and silently drop the entry.\n  const errorEnum = values.reduce(\n    (acc, value) => {\n      acc[value] = createErrorTypeEnumValue(base, value);\n      return acc;\n    },\n    Object.create(null) as { [K in T]: string },\n  );\n\n  return errorEnum;\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC","sourcesContent":["export * from './createActionProcessor';\nexport * from './createActionRequester';\nexport * from './createErrorEnumForAction';\n"]}

package/lib/esm/logic/config/DEFAULT_ENVIRONMENT.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_ENVIRONMENT = "production";

package/lib/esm/logic/config/DEFAULT_ENVIRONMENT.js

@@ -0,0 +1,4 @@
+// The environment assumed when an application setting names none. flattenQpqConfig and
+// getApplicationModuleEnvironment must agree or environment-scoped settings resolve differently.
+export const DEFAULT_ENVIRONMENT = 'production';
+//# sourceMappingURL=DEFAULT_ENVIRONMENT.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_ENVIRONMENT.js","sourceRoot":"","sources":["../../../../src/logic/config/DEFAULT_ENVIRONMENT.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,iGAAiG;AACjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC","sourcesContent":["// The environment assumed when an application setting names none. flattenQpqConfig and\n// getApplicationModuleEnvironment must agree or environment-scoped settings resolve differently.\nexport const DEFAULT_ENVIRONMENT = 'production';\n"]}

package/lib/esm/logic/config/flattenQpqConfig.d.ts

@@ -0,0 +1,7 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+/**
+ * Flattens a QPQConfig tree into one list of settings, in declaration order. Environment and
+ * service blocks are opened for the environment the application named (production when it
+ * named none) and the module declared before them; the blocks themselves are not kept.
+ */
+export declare const flattenQpqConfig: (qpqConfig: QPQConfig) => QPQConfigSetting[];

package/lib/esm/logic/config/flattenQpqConfig.js

@@ -0,0 +1,49 @@
+import { QPQCoreConfigSettingType } from '../../config/QPQConfig';
+import { DEFAULT_ENVIRONMENT } from './DEFAULT_ENVIRONMENT';
+// The settings an environment block contributes under this environment, else its '*' fallback.
+const resolveEnvironmentSettings = (setting, scope) => setting.settingsByEnvironment[scope.environment] ?? setting.settingsByEnvironment['*'] ?? [];
+// The settings a service block contributes under the current module, else its '*' fallback.
+const resolveServiceSettings = (setting, scope) => {
+    if (!scope.service) {
+        throw new Error('defineServiceSettings requires a module to be set first via defineModule (usually through defineApplicationModule)');
+    }
+    return setting.settingsByService[scope.service] ?? setting.settingsByService['*'] ?? [];
+};
+/**
+ * Flattens a QPQConfig tree into one list of settings, in declaration order. Environment and
+ * service blocks are opened for the environment the application named (production when it
+ * named none) and the module declared before them; the blocks themselves are not kept.
+ */
+export const flattenQpqConfig = (qpqConfig) => {
+    const scope = { environment: DEFAULT_ENVIRONMENT };
+    const settings = [];
+    const visit = (items) => {
+        for (const item of items) {
+            if (Array.isArray(item)) {
+                visit(item);
+                continue;
+            }
+            switch (item.configSettingType) {
+                case QPQCoreConfigSettingType.appName:
+                    scope.environment = item.environment || DEFAULT_ENVIRONMENT;
+                    settings.push(item);
+                    break;
+                case QPQCoreConfigSettingType.moduleName:
+                    scope.service = item.moduleName;
+                    settings.push(item);
+                    break;
+                case QPQCoreConfigSettingType.environmentSettings:
+                    visit(resolveEnvironmentSettings(item, scope));
+                    break;
+                case QPQCoreConfigSettingType.serviceSettings:
+                    visit(resolveServiceSettings(item, scope));
+                    break;
+                default:
+                    settings.push(item);
+            }
+        }
+    };
+    visit(qpqConfig);
+    return settings;
+};
+//# sourceMappingURL=flattenQpqConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flattenQpqConfig.js","sourceRoot":"","sources":["../../../../src/logic/config/flattenQpqConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAK9G,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D,+FAA+F;AAC/F,MAAM,0BAA0B,GAAG,CAAC,OAA4C,EAAE,KAAmB,EAAmB,EAAE,CACxH,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAE/F,4FAA4F;AAC5F,MAAM,sBAAsB,GAAG,CAAC,OAAwC,EAAE,KAAmB,EAAmB,EAAE;IAChH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oHAAoH,CAAC,CAAC;IACxI,CAAC;IAED,OAAO,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC1F,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAoB,EAAsB,EAAE;IAC3E,MAAM,KAAK,GAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,MAAM,KAAK,GAAG,CAAC,KAAsB,EAAQ,EAAE;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,CAAC;gBACZ,SAAS;YACX,CAAC;YAED,QAAQ,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC/B,KAAK,wBAAwB,CAAC,OAAO;oBACnC,KAAK,CAAC,WAAW,GAAI,IAAoC,CAAC,WAAW,IAAI,mBAAmB,CAAC;oBAC7F,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,MAAM;gBAER,KAAK,wBAAwB,CAAC,UAAU;oBACtC,KAAK,CAAC,OAAO,GAAI,IAA+B,CAAC,UAAU,CAAC;oBAC5D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,MAAM;gBAER,KAAK,wBAAwB,CAAC,mBAAmB;oBAC/C,KAAK,CAAC,0BAA0B,CAAC,IAA2C,EAAE,KAAK,CAAC,CAAC,CAAC;oBACtF,MAAM;gBAER,KAAK,wBAAwB,CAAC,eAAe;oBAC3C,KAAK,CAAC,sBAAsB,CAAC,IAAuC,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC9E,MAAM;gBAER;oBACE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,CAAC;IAEjB,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC","sourcesContent":["import { QPQConfig, QPQConfigItem, QPQConfigSetting, QPQCoreConfigSettingType } from '../../config/QPQConfig';\nimport { ApplicationQPQConfigSetting } from '../../config/settings/applicationName';\nimport { EnvironmentSettingsQPQConfigSetting } from '../../config/settings/environmentSettings';\nimport { ModuleQPQConfigSetting } from '../../config/settings/moduleName';\nimport { ServiceSettingsQPQConfigSetting } from '../../config/settings/serviceSettings';\nimport { DEFAULT_ENVIRONMENT } from './DEFAULT_ENVIRONMENT';\n\n// What the walk has learned so far about where it is: the application's environment and the\n// module declared last. Both are set by the settings that precede the ones they scope.\ntype FlattenScope = {\n  environment: string;\n  service?: string;\n};\n\n// The settings an environment block contributes under this environment, else its '*' fallback.\nconst resolveEnvironmentSettings = (setting: EnvironmentSettingsQPQConfigSetting, scope: FlattenScope): QPQConfigItem[] =>\n  setting.settingsByEnvironment[scope.environment] ?? setting.settingsByEnvironment['*'] ?? [];\n\n// The settings a service block contributes under the current module, else its '*' fallback.\nconst resolveServiceSettings = (setting: ServiceSettingsQPQConfigSetting, scope: FlattenScope): QPQConfigItem[] => {\n  if (!scope.service) {\n    throw new Error('defineServiceSettings requires a module to be set first via defineModule (usually through defineApplicationModule)');\n  }\n\n  return setting.settingsByService[scope.service] ?? setting.settingsByService['*'] ?? [];\n};\n\n/**\n * Flattens a QPQConfig tree into one list of settings, in declaration order. Environment and\n * service blocks are opened for the environment the application named (production when it\n * named none) and the module declared before them; the blocks themselves are not kept.\n */\nexport const flattenQpqConfig = (qpqConfig: QPQConfig): QPQConfigSetting[] => {\n  const scope: FlattenScope = { environment: DEFAULT_ENVIRONMENT };\n  const settings: QPQConfigSetting[] = [];\n\n  const visit = (items: QPQConfigItem[]): void => {\n    for (const item of items) {\n      if (Array.isArray(item)) {\n        visit(item);\n        continue;\n      }\n\n      switch (item.configSettingType) {\n        case QPQCoreConfigSettingType.appName:\n          scope.environment = (item as ApplicationQPQConfigSetting).environment || DEFAULT_ENVIRONMENT;\n          settings.push(item);\n          break;\n\n        case QPQCoreConfigSettingType.moduleName:\n          scope.service = (item as ModuleQPQConfigSetting).moduleName;\n          settings.push(item);\n          break;\n\n        case QPQCoreConfigSettingType.environmentSettings:\n          visit(resolveEnvironmentSettings(item as EnvironmentSettingsQPQConfigSetting, scope));\n          break;\n\n        case QPQCoreConfigSettingType.serviceSettings:\n          visit(resolveServiceSettings(item as ServiceSettingsQPQConfigSetting, scope));\n          break;\n\n        default:\n          settings.push(item);\n      }\n    }\n  };\n\n  visit(qpqConfig);\n\n  return settings;\n};\n"]}

package/lib/esm/logic/config/getApplicationConfigSetting.d.ts

@@ -0,0 +1,3 @@
+import { QPQConfig } from '../../config/QPQConfig';
+import { ApplicationQPQConfigSetting } from '../../config/settings/applicationName';
+export declare const getApplicationConfigSetting: (qpqConfig: QPQConfig) => ApplicationQPQConfigSetting;

package/lib/esm/logic/config/getApplicationConfigSetting.js

@@ -0,0 +1,11 @@
+import { QPQCoreConfigSettingType } from '../../config/QPQConfig';
+import { getConfigSetting } from './getConfigSetting';
+// The application setting every config must open with (defineApplication); throws when it is missing.
+export const getApplicationConfigSetting = (qpqConfig) => {
+    const applicationModuleSetting = getConfigSetting(qpqConfig, QPQCoreConfigSettingType.appName);
+    if (!applicationModuleSetting) {
+        throw new Error('please use defineApplication in your QPQ config');
+    }
+    return applicationModuleSetting;
+};
+//# sourceMappingURL=getApplicationConfigSetting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationConfigSetting.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationConfigSetting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,sGAAsG;AACtG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAoB,EAA+B,EAAE;IAC/F,MAAM,wBAAwB,GAAG,gBAAgB,CAA8B,SAAS,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAE5H,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,wBAAwB,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import { QPQConfig, QPQCoreConfigSettingType } from '../../config/QPQConfig';\nimport { ApplicationQPQConfigSetting } from '../../config/settings/applicationName';\nimport { getConfigSetting } from './getConfigSetting';\n\n// The application setting every config must open with (defineApplication); throws when it is missing.\nexport const getApplicationConfigSetting = (qpqConfig: QPQConfig): ApplicationQPQConfigSetting => {\n  const applicationModuleSetting = getConfigSetting<ApplicationQPQConfigSetting>(qpqConfig, QPQCoreConfigSettingType.appName);\n\n  if (!applicationModuleSetting) {\n    throw new Error('please use defineApplication in your QPQ config');\n  }\n\n  return applicationModuleSetting;\n};\n"]}

package/lib/esm/logic/config/getApplicationModuleEnvironment.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig } from '../../config/QPQConfig';
+export declare const getApplicationModuleEnvironment: (qpqConfig: QPQConfig) => string;

package/lib/esm/logic/config/getApplicationModuleEnvironment.js

@@ -0,0 +1,4 @@
+import { DEFAULT_ENVIRONMENT } from './DEFAULT_ENVIRONMENT';
+import { getApplicationConfigSetting } from './getApplicationConfigSetting';
+export const getApplicationModuleEnvironment = (qpqConfig) => getApplicationConfigSetting(qpqConfig).environment || DEFAULT_ENVIRONMENT;
+//# sourceMappingURL=getApplicationModuleEnvironment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationModuleEnvironment.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationModuleEnvironment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,SAAoB,EAAU,EAAE,CAC9E,2BAA2B,CAAC,SAAS,CAAC,CAAC,WAAW,IAAI,mBAAmB,CAAC","sourcesContent":["import { QPQConfig } from '../../config/QPQConfig';\nimport { DEFAULT_ENVIRONMENT } from './DEFAULT_ENVIRONMENT';\nimport { getApplicationConfigSetting } from './getApplicationConfigSetting';\n\nexport const getApplicationModuleEnvironment = (qpqConfig: QPQConfig): string =>\n  getApplicationConfigSetting(qpqConfig).environment || DEFAULT_ENVIRONMENT;\n"]}

package/lib/esm/logic/config/getApplicationModuleFeature.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig } from '../../config/QPQConfig';
+export declare const getApplicationModuleFeature: (qpqConfig: QPQConfig) => string | undefined;

package/lib/esm/logic/config/getApplicationModuleFeature.js

@@ -0,0 +1,3 @@
+import { getApplicationConfigSetting } from './getApplicationConfigSetting';
+export const getApplicationModuleFeature = (qpqConfig) => getApplicationConfigSetting(qpqConfig).feature;
+//# sourceMappingURL=getApplicationModuleFeature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationModuleFeature.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationModuleFeature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAoB,EAAsB,EAAE,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC","sourcesContent":["import { QPQConfig } from '../../config/QPQConfig';\nimport { getApplicationConfigSetting } from './getApplicationConfigSetting';\n\nexport const getApplicationModuleFeature = (qpqConfig: QPQConfig): string | undefined => getApplicationConfigSetting(qpqConfig).feature;\n"]}

package/lib/esm/logic/config/getApplicationModuleName.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig } from '../../config/QPQConfig';
+export declare const getApplicationModuleName: (qpqConfig: QPQConfig) => string;

package/lib/esm/logic/config/getApplicationModuleName.js

@@ -0,0 +1,11 @@
+import { QPQCoreConfigSettingType } from '../../config/QPQConfig';
+import { getConfigSetting } from './getConfigSetting';
+// The module (service) this config is for (defineModule); throws when it is missing.
+export const getApplicationModuleName = (qpqConfig) => {
+    const moduleSetting = getConfigSetting(qpqConfig, QPQCoreConfigSettingType.moduleName);
+    if (!moduleSetting) {
+        throw new Error('please use defineModule in your QPQ config');
+    }
+    return moduleSetting.moduleName;
+};
+//# sourceMappingURL=getApplicationModuleName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationModuleName.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationModuleName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qFAAqF;AACrF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAU,EAAE;IACvE,MAAM,aAAa,GAAG,gBAAgB,CAAyB,SAAS,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAE/G,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,aAAa,CAAC,UAAU,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import { QPQConfig, QPQCoreConfigSettingType } from '../../config/QPQConfig';\nimport { ModuleQPQConfigSetting } from '../../config/settings/moduleName';\nimport { getConfigSetting } from './getConfigSetting';\n\n// The module (service) this config is for (defineModule); throws when it is missing.\nexport const getApplicationModuleName = (qpqConfig: QPQConfig): string => {\n  const moduleSetting = getConfigSetting<ModuleQPQConfigSetting>(qpqConfig, QPQCoreConfigSettingType.moduleName);\n\n  if (!moduleSetting) {\n    throw new Error('please use defineModule in your QPQ config');\n  }\n\n  return moduleSetting.moduleName;\n};\n"]}

package/lib/esm/logic/config/getApplicationName.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig } from '../../config/QPQConfig';
+export declare const getApplicationName: (qpqConfig: QPQConfig) => string;

package/lib/esm/logic/config/getApplicationName.js

@@ -0,0 +1,3 @@
+import { getApplicationConfigSetting } from './getApplicationConfigSetting';
+export const getApplicationName = (qpqConfig) => getApplicationConfigSetting(qpqConfig).applicationName;
+//# sourceMappingURL=getApplicationName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationName.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationName.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAoB,EAAU,EAAE,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC","sourcesContent":["import { QPQConfig } from '../../config/QPQConfig';\nimport { getApplicationConfigSetting } from './getApplicationConfigSetting';\n\nexport const getApplicationName = (qpqConfig: QPQConfig): string => getApplicationConfigSetting(qpqConfig).applicationName;\n"]}

package/lib/esm/logic/config/getConfigSetting.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+export declare const getConfigSetting: <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string) => T | undefined;

package/lib/esm/logic/config/getConfigSetting.js

@@ -0,0 +1,7 @@
+import { getConfigSettings } from './getConfigSettings';
+// The first setting of one type, or undefined when the config has none.
+export const getConfigSetting = (qpqConfig, configSettingType) => {
+    const [setting] = getConfigSettings(qpqConfig, configSettingType);
+    return setting;
+};
+//# sourceMappingURL=getConfigSetting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigSetting.js","sourceRoot":"","sources":["../../../../src/logic/config/getConfigSetting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAA6B,SAAoB,EAAE,iBAAyB,EAAiB,EAAE;IAC7H,MAAM,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAI,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { getConfigSettings } from './getConfigSettings';\n\n// The first setting of one type, or undefined when the config has none.\nexport const getConfigSetting = <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string): T | undefined => {\n  const [setting] = getConfigSettings<T>(qpqConfig, configSettingType);\n  return setting;\n};\n"]}

package/lib/esm/logic/config/getConfigSettings.d.ts

@@ -0,0 +1,2 @@
+import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';
+export declare const getConfigSettings: <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string) => T[];

package/lib/esm/logic/config/getConfigSettings.js

@@ -0,0 +1,6 @@
+import { flattenQpqConfig } from './flattenQpqConfig';
+// Every setting of one type, in declaration order, from the flattened config.
+export const getConfigSettings = (qpqConfig, configSettingType) => 
+// eslint-disable-next-line no-restricted-syntax -- D1: the generic accessor every is<Name>Setting guard is built on.
+flattenQpqConfig(qpqConfig).filter((c) => c.configSettingType === configSettingType);
+//# sourceMappingURL=getConfigSettings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigSettings.js","sourceRoot":"","sources":["../../../../src/logic/config/getConfigSettings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA6B,SAAoB,EAAE,iBAAyB,EAAO,EAAE;AACpH,qHAAqH;AACrH,gBAAgB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,iBAAiB,CAAQ,CAAC","sourcesContent":["import { QPQConfig, QPQConfigSetting } from '../../config/QPQConfig';\nimport { flattenQpqConfig } from './flattenQpqConfig';\n\n// Every setting of one type, in declaration order, from the flattened config.\nexport const getConfigSettings = <T extends QPQConfigSetting>(qpqConfig: QPQConfig, configSettingType: string): T[] =>\n  // eslint-disable-next-line no-restricted-syntax -- D1: the generic accessor every is<Name>Setting guard is built on.\n  flattenQpqConfig(qpqConfig).filter((c) => c.configSettingType === configSettingType) as T[];\n"]}