@qpqjs/core 0.3.0 → 0.5.0

package/lib/commonjs/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/commonjs/logic/actionResult/ErrorMap.js

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

package/lib/commonjs/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/commonjs/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/commonjs/logic/actionResult/actionResult.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionResult = void 0;
+const actionResult = (result) => {
+    return [result];
+};
+exports.actionResult = actionResult;
+//# sourceMappingURL=actionResult.js.map

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

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

package/lib/commonjs/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/commonjs/logic/actionResult/actionResultError.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionResultError = void 0;
+const actionResultError = (errorType, errorText, errorStack) => {
+    return [undefined, { errorType, errorText, errorStack }];
+};
+exports.actionResultError = actionResultError;
+//# sourceMappingURL=actionResultError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionResultError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/actionResultError.ts"],"names":[],"mappings":";;;AAGO,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;AAFW,QAAA,iBAAiB,qBAE5B","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/commonjs/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/commonjs/logic/actionResult/actionResultErrorFromCaughtError.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionResultErrorFromCaughtError = void 0;
+const ErrorTypeEnum_1 = require("../../types/ErrorTypeEnum");
+const actionResultError_1 = require("./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).
+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 (0, actionResultError_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, `An unexpected error occurred [${errorCode !== null && errorCode !== void 0 ? errorCode : errorName}].`);
+    }
+    return (0, actionResultError_1.actionResultError)(ErrorTypeEnum_1.ErrorTypeEnum.GenericError, 'An unknown error occurred.');
+};
+exports.actionResultErrorFromCaughtError = actionResultErrorFromCaughtError;
+//# sourceMappingURL=actionResultErrorFromCaughtError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionResultErrorFromCaughtError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/actionResultErrorFromCaughtError.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAC1D,2DAAwD;AAGxD,4FAA4F;AAC5F,qFAAqF;AAC9E,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,IAAA,qCAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,iCAAiC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,SAAS,IAAI,CAAC,CAAC;IACpH,CAAC;IAED,OAAO,IAAA,qCAAiB,EAAC,6BAAa,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;AACrF,CAAC,CAAC;AAhBW,QAAA,gCAAgC,oCAgB3C","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/commonjs/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/commonjs/logic/actionResult/getSuccessfulEitherActionResult.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSuccessfulEitherActionResult = void 0;
+const getSuccessfulEitherActionResult = (result) => ({
+    success: true,
+    result,
+});
+exports.getSuccessfulEitherActionResult = getSuccessfulEitherActionResult;
+//# sourceMappingURL=getSuccessfulEitherActionResult.js.map

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

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

package/lib/commonjs/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/commonjs/logic/actionResult/getUnsuccessfulEitherActionResult.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUnsuccessfulEitherActionResult = void 0;
+const getUnsuccessfulEitherActionResult = (error) => ({
+    success: false,
+    error: error,
+});
+exports.getUnsuccessfulEitherActionResult = getUnsuccessfulEitherActionResult;
+//# sourceMappingURL=getUnsuccessfulEitherActionResult.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getUnsuccessfulEitherActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/getUnsuccessfulEitherActionResult.ts"],"names":[],"mappings":";;;AAGO,MAAM,iCAAiC,GAAG,CAAC,KAAe,EAA2B,EAAE,CAAC,CAAC;IAC9F,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;CACb,CAAC,CAAC;AAHU,QAAA,iCAAiC,qCAG3C","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/commonjs/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/commonjs/logic/actionResult/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actionResult"), exports);
+__exportStar(require("./actionResultError"), exports);
+__exportStar(require("./actionResultErrorFromCaughtError"), exports);
+__exportStar(require("./ErrorMap"), exports);
+__exportStar(require("./getSuccessfulEitherActionResult"), exports);
+__exportStar(require("./getUnsuccessfulEitherActionResult"), exports);
+__exportStar(require("./isErroredActionResult"), exports);
+__exportStar(require("./resolveActionResult"), exports);
+__exportStar(require("./resolveActionResultError"), exports);
+__exportStar(require("./transientErrorMap"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,sDAAoC;AACpC,qEAAmD;AACnD,6CAA2B;AAC3B,oEAAkD;AAClD,sEAAoD;AACpD,0DAAwC;AACxC,wDAAsC;AACtC,6DAA2C;AAC3C,sDAAoC","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/commonjs/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/commonjs/logic/actionResult/isErroredActionResult.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isErroredActionResult = void 0;
+const isErroredActionResult = (actionResult) => {
+    return !actionResult || !!actionResult[1];
+};
+exports.isErroredActionResult = isErroredActionResult;
+//# sourceMappingURL=isErroredActionResult.js.map

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

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

package/lib/commonjs/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/commonjs/logic/actionResult/resolveActionResult.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveActionResult = void 0;
+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];
+};
+exports.resolveActionResult = resolveActionResult;
+//# sourceMappingURL=resolveActionResult.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActionResult.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/resolveActionResult.ts"],"names":[],"mappings":";;;AAEO,MAAM,mBAAmB,GAAG,CAAI,YAAsC,EAAE,EAAE;IAC/E,yEAAyE;IACzE,qCAAqC;IACrC,OAAO,YAAY,CAAC,CAAC,CAAE,CAAC;AAC1B,CAAC,CAAC;AAJW,QAAA,mBAAmB,uBAI9B","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/commonjs/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/commonjs/logic/actionResult/resolveActionResultError.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveActionResultError = void 0;
+const ErrorTypeEnum_1 = require("../../types/ErrorTypeEnum");
+const resolveActionResultError = (actionResult) => {
+    if (!actionResult) {
+        return {
+            errorText: `Action processor returned no result [${JSON.stringify(actionResult)}]`,
+            errorType: ErrorTypeEnum_1.ErrorTypeEnum.GenericError,
+        };
+    }
+    return actionResult[1];
+};
+exports.resolveActionResultError = resolveActionResultError;
+//# sourceMappingURL=resolveActionResultError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActionResultError.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/resolveActionResultError.ts"],"names":[],"mappings":";;;AACA,6DAAoE;AAE7D,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,6BAAa,CAAC,YAAY;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,CAAC,CAAa,CAAC;AACrC,CAAC,CAAC;AATW,QAAA,wBAAwB,4BASnC","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/commonjs/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/commonjs/logic/actionResult/transientErrorMap.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transientErrorMap = exports.isTransientErrorName = exports.TRANSIENT_ERROR_NAMES = void 0;
+const ErrorTypeEnum_1 = require("../../types/ErrorTypeEnum");
+const actionResultError_1 = require("./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.
+ */
+exports.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. */
+const isTransientErrorName = (name) => !!name && exports.TRANSIENT_ERROR_NAMES.has(name);
+exports.isTransientErrorName = isTransientErrorName;
+/**
+ * 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.
+ */
+const transientErrorMap = (errorType = ErrorTypeEnum_1.ErrorTypeEnum.OutOfResources) => Object.fromEntries([...exports.TRANSIENT_ERROR_NAMES].map((name) => [name, () => (0, actionResultError_1.actionResultError)(errorType, `A transient error occurred, retry [${name}].`)]));
+exports.transientErrorMap = transientErrorMap;
+//# sourceMappingURL=transientErrorMap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transientErrorMap.js","sourceRoot":"","sources":["../../../../src/logic/actionResult/transientErrorMap.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAC1D,2DAAwD;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,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;AAC7E,MAAM,oBAAoB,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,6BAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAA7F,QAAA,oBAAoB,wBAAyE;AAE1G;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,YAAoB,6BAAa,CAAC,cAAc,EAAY,EAAE,CAC9F,MAAM,CAAC,WAAW,CAChB,CAAC,GAAG,6BAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAA,qCAAiB,EAAC,SAAS,EAAE,sCAAsC,IAAI,IAAI,CAAC,CAAC,CAAC,CACrI,CAAC;AAHS,QAAA,iBAAiB,qBAG1B","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/commonjs/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/commonjs/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;AACzD,MAAM,qBAAqB,GAChC,CACE,SAAqB,EACrB,YAA8I,EACjH,EAAE,CACjC,CAAO,SAAS,EAAE,mBAAmB,EAAE,EAAE;IAAC,OAAA,CAAC;QACzC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC,SAAS,EAAE,mBAAmB,CAAC;KAC3E,CAAC,CAAA;EAAA,CAAC;AAPQ,QAAA,qBAAqB,yBAO7B","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/commonjs/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/commonjs/logic/actions/createActionRequester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActionRequester.js","sourceRoot":"","sources":["../../../../src/logic/actions/createActionRequester.ts"],"names":[],"mappings":";;;AAEA,yEAAsE;AAEtE,oFAAoF;AACpF,gFAAgF;AAChF,8DAA8D;AACvD,MAAM,qBAAqB,GAChC,GAAY,EAAE,CACd,CACE,UAA0E,EACH,EAAE;;IACzE,kFAAkF;IAClF,+CAA+C;IAC/C,MAAM,UAAU,GAAG,MAAA,UAAU,CAAC,UAAU,mCAAK,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,IAAA,mDAAwB,EAAC,UAAU,CAAC,UAAU,EAAE,MAAA,UAAU,CAAC,UAAU,mCAAI,EAAE,CAAC;KACxF,CAAC,CAAC;AACL,CAAC,CAAC;AAtBS,QAAA,qBAAqB,yBAsB9B","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/commonjs/logic/actions/createErrorEnumForAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createErrorEnumForAction.js","sourceRoot":"","sources":["../../../../src/logic/actions/createErrorEnumForAction.ts"],"names":[],"mappings":";;AAAA,4DAEC;AAED,4DAYC;AAhBD,SAAgB,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAClE,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,SAAgB,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/commonjs/logic/actions/index.js.map

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

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ENVIRONMENT = void 0;
+// The environment assumed when an application setting names none. flattenQpqConfig and
+// getApplicationModuleEnvironment must agree or environment-scoped settings resolve differently.
+exports.DEFAULT_ENVIRONMENT = 'production';
+//# sourceMappingURL=DEFAULT_ENVIRONMENT.js.map

package/lib/commonjs/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;AACpF,QAAA,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/commonjs/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/commonjs/logic/config/flattenQpqConfig.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenQpqConfig = void 0;
+const QPQConfig_1 = require("../../config/QPQConfig");
+const DEFAULT_ENVIRONMENT_1 = require("./DEFAULT_ENVIRONMENT");
+// The settings an environment block contributes under this environment, else its '*' fallback.
+const resolveEnvironmentSettings = (setting, scope) => { var _a, _b; return (_b = (_a = setting.settingsByEnvironment[scope.environment]) !== null && _a !== void 0 ? _a : setting.settingsByEnvironment['*']) !== null && _b !== void 0 ? _b : []; };
+// The settings a service block contributes under the current module, else its '*' fallback.
+const resolveServiceSettings = (setting, scope) => {
+    var _a, _b;
+    if (!scope.service) {
+        throw new Error('defineServiceSettings requires a module to be set first via defineModule (usually through defineApplicationModule)');
+    }
+    return (_b = (_a = setting.settingsByService[scope.service]) !== null && _a !== void 0 ? _a : setting.settingsByService['*']) !== null && _b !== void 0 ? _b : [];
+};
+/**
+ * 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.
+ */
+const flattenQpqConfig = (qpqConfig) => {
+    const scope = { environment: DEFAULT_ENVIRONMENT_1.DEFAULT_ENVIRONMENT };
+    const settings = [];
+    const visit = (items) => {
+        for (const item of items) {
+            if (Array.isArray(item)) {
+                visit(item);
+                continue;
+            }
+            switch (item.configSettingType) {
+                case QPQConfig_1.QPQCoreConfigSettingType.appName:
+                    scope.environment = item.environment || DEFAULT_ENVIRONMENT_1.DEFAULT_ENVIRONMENT;
+                    settings.push(item);
+                    break;
+                case QPQConfig_1.QPQCoreConfigSettingType.moduleName:
+                    scope.service = item.moduleName;
+                    settings.push(item);
+                    break;
+                case QPQConfig_1.QPQCoreConfigSettingType.environmentSettings:
+                    visit(resolveEnvironmentSettings(item, scope));
+                    break;
+                case QPQConfig_1.QPQCoreConfigSettingType.serviceSettings:
+                    visit(resolveServiceSettings(item, scope));
+                    break;
+                default:
+                    settings.push(item);
+            }
+        }
+    };
+    visit(qpqConfig);
+    return settings;
+};
+exports.flattenQpqConfig = flattenQpqConfig;
+//# sourceMappingURL=flattenQpqConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flattenQpqConfig.js","sourceRoot":"","sources":["../../../../src/logic/config/flattenQpqConfig.ts"],"names":[],"mappings":";;;AAAA,sDAA8G;AAK9G,+DAA4D;AAS5D,+FAA+F;AAC/F,MAAM,0BAA0B,GAAG,CAAC,OAA4C,EAAE,KAAmB,EAAmB,EAAE,eACxH,OAAA,MAAA,MAAA,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,mCAAI,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,mCAAI,EAAE,CAAA,EAAA,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,MAAA,MAAA,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,mCAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,mCAAI,EAAE,CAAC;AAC1F,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,SAAoB,EAAsB,EAAE;IAC3E,MAAM,KAAK,GAAiB,EAAE,WAAW,EAAE,yCAAmB,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,oCAAwB,CAAC,OAAO;oBACnC,KAAK,CAAC,WAAW,GAAI,IAAoC,CAAC,WAAW,IAAI,yCAAmB,CAAC;oBAC7F,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,MAAM;gBAER,KAAK,oCAAwB,CAAC,UAAU;oBACtC,KAAK,CAAC,OAAO,GAAI,IAA+B,CAAC,UAAU,CAAC;oBAC5D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,MAAM;gBAER,KAAK,oCAAwB,CAAC,mBAAmB;oBAC/C,KAAK,CAAC,0BAA0B,CAAC,IAA2C,EAAE,KAAK,CAAC,CAAC,CAAC;oBACtF,MAAM;gBAER,KAAK,oCAAwB,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;AAvCW,QAAA,gBAAgB,oBAuC3B","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/commonjs/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/commonjs/logic/config/getApplicationConfigSetting.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApplicationConfigSetting = void 0;
+const QPQConfig_1 = require("../../config/QPQConfig");
+const getConfigSetting_1 = require("./getConfigSetting");
+// The application setting every config must open with (defineApplication); throws when it is missing.
+const getApplicationConfigSetting = (qpqConfig) => {
+    const applicationModuleSetting = (0, getConfigSetting_1.getConfigSetting)(qpqConfig, QPQConfig_1.QPQCoreConfigSettingType.appName);
+    if (!applicationModuleSetting) {
+        throw new Error('please use defineApplication in your QPQ config');
+    }
+    return applicationModuleSetting;
+};
+exports.getApplicationConfigSetting = getApplicationConfigSetting;
+//# sourceMappingURL=getApplicationConfigSetting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationConfigSetting.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationConfigSetting.ts"],"names":[],"mappings":";;;AAAA,sDAA6E;AAE7E,yDAAsD;AAEtD,sGAAsG;AAC/F,MAAM,2BAA2B,GAAG,CAAC,SAAoB,EAA+B,EAAE;IAC/F,MAAM,wBAAwB,GAAG,IAAA,mCAAgB,EAA8B,SAAS,EAAE,oCAAwB,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;AARW,QAAA,2BAA2B,+BAQtC","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/commonjs/logic/config/getApplicationModuleEnvironment.d.ts

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

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApplicationModuleEnvironment = void 0;
+const DEFAULT_ENVIRONMENT_1 = require("./DEFAULT_ENVIRONMENT");
+const getApplicationConfigSetting_1 = require("./getApplicationConfigSetting");
+const getApplicationModuleEnvironment = (qpqConfig) => (0, getApplicationConfigSetting_1.getApplicationConfigSetting)(qpqConfig).environment || DEFAULT_ENVIRONMENT_1.DEFAULT_ENVIRONMENT;
+exports.getApplicationModuleEnvironment = getApplicationModuleEnvironment;
+//# sourceMappingURL=getApplicationModuleEnvironment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationModuleEnvironment.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationModuleEnvironment.ts"],"names":[],"mappings":";;;AACA,+DAA4D;AAC5D,+EAA4E;AAErE,MAAM,+BAA+B,GAAG,CAAC,SAAoB,EAAU,EAAE,CAC9E,IAAA,yDAA2B,EAAC,SAAS,CAAC,CAAC,WAAW,IAAI,yCAAmB,CAAC;AAD/D,QAAA,+BAA+B,mCACgC","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/commonjs/logic/config/getApplicationModuleFeature.d.ts

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApplicationModuleFeature = void 0;
+const getApplicationConfigSetting_1 = require("./getApplicationConfigSetting");
+const getApplicationModuleFeature = (qpqConfig) => (0, getApplicationConfigSetting_1.getApplicationConfigSetting)(qpqConfig).feature;
+exports.getApplicationModuleFeature = getApplicationModuleFeature;
+//# sourceMappingURL=getApplicationModuleFeature.js.map

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

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

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

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

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApplicationModuleName = void 0;
+const QPQConfig_1 = require("../../config/QPQConfig");
+const getConfigSetting_1 = require("./getConfigSetting");
+// The module (service) this config is for (defineModule); throws when it is missing.
+const getApplicationModuleName = (qpqConfig) => {
+    const moduleSetting = (0, getConfigSetting_1.getConfigSetting)(qpqConfig, QPQConfig_1.QPQCoreConfigSettingType.moduleName);
+    if (!moduleSetting) {
+        throw new Error('please use defineModule in your QPQ config');
+    }
+    return moduleSetting.moduleName;
+};
+exports.getApplicationModuleName = getApplicationModuleName;
+//# sourceMappingURL=getApplicationModuleName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getApplicationModuleName.js","sourceRoot":"","sources":["../../../../src/logic/config/getApplicationModuleName.ts"],"names":[],"mappings":";;;AAAA,sDAA6E;AAE7E,yDAAsD;AAEtD,qFAAqF;AAC9E,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAU,EAAE;IACvE,MAAM,aAAa,GAAG,IAAA,mCAAgB,EAAyB,SAAS,EAAE,oCAAwB,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;AARW,QAAA,wBAAwB,4BAQnC","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/commonjs/logic/config/getApplicationName.d.ts

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApplicationName = void 0;
+const getApplicationConfigSetting_1 = require("./getApplicationConfigSetting");
+const getApplicationName = (qpqConfig) => (0, getApplicationConfigSetting_1.getApplicationConfigSetting)(qpqConfig).applicationName;
+exports.getApplicationName = getApplicationName;
+//# sourceMappingURL=getApplicationName.js.map

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

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

package/lib/commonjs/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;