@venizia/ignis-helpers 0.2.0-4 → 0.2.0-40

package/dist/cjs/common/types/injection.d.ts

@@ -0,0 +1,8 @@
+import type { ValueOrPromise } from './utility';
+export type TInjectionGetter = <T>(opts: {
+    key: string | symbol;
+}) => T;
+export interface IConfigurable<Options extends object = any, Result = any> {
+    configure(opts?: Options): ValueOrPromise<Result>;
+}
+//# sourceMappingURL=injection.d.ts.map

package/dist/cjs/common/types/injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../../../../src/common/types/injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,KAAK,CAAC,CAAC;AAExE,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG;IACvE,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;CACnD"}

package/dist/cjs/common/types/injection.js

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

package/dist/cjs/common/types/injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.js","sourceRoot":"","sources":["../../../../src/common/types/injection.ts"],"names":[],"mappings":""}

package/dist/cjs/common/types/resolver.d.ts

@@ -0,0 +1,2 @@
+export type { TAsyncResolver, TResolver, TValueOrAsyncResolver, TValueOrResolver, } from '@venizia/ignis-inversion';
+//# sourceMappingURL=resolver.d.ts.map

package/dist/cjs/common/types/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/common/types/resolver.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/cjs/common/types/resolver.js

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

package/dist/cjs/common/types/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/common/types/resolver.ts"],"names":[],"mappings":""}

package/dist/cjs/common/types/utility.d.ts

@@ -0,0 +1,12 @@
+export type TNullable<T> = T | undefined | null;
+export type AnyType = any;
+export type AnyObject = Record<string | symbol | number, any>;
+export type TOptions<T extends object = {}> = T;
+export type ValueOrPromise<T> = T | Promise<T>;
+export type ValueOf<T> = T[keyof T];
+export type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+export type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;
+export type TPrettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+//# sourceMappingURL=utility.d.ts.map

package/dist/cjs/common/types/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;AAEhD,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAC1B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9D,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;AAEhD,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/C,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACnF,MAAM,MAAM,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEzF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC"}

package/dist/cjs/common/types/utility.js

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

package/dist/cjs/common/types/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":""}

package/dist/cjs/core.d.ts

@@ -1,16 +1,32 @@
 export { BaseHelper } from './modules/base';
 export { EnvironmentNames } from './modules/env/names';
 export * from './modules/error';
-export * from './modules/uid';
-export * from './modules/pool';
-export * from './modules/queue/internal/hf';
-export type { ILogger, ILoggerProvider, TLogLevel } from './modules/logger/common/types';
 export { LogLevels } from './modules/logger/common/types';
+export type { ILogger, ILoggerProvider, TLogLevel } from './modules/logger/common/types';
 export * from './modules/network/http-request/fetcher/base-fetcher';
-export { toBoolean, int, toCamel, keysToCamel } from './utilities/parse.utility';
+export * from './modules/network/http-request/fetcher/node-fetcher';
+export * from './modules/network/http-request/base-network-request.helper';
+export * from './modules/pool';
+export * from './modules/queue/internal/hf';
+export * from './modules/temporal';
+export * from './modules/uid';
+export * from './modules/network/utilities/url-safety/common/constants';
+export type { IUrlSafetyPolicy } from './modules/network/utilities/url-safety/common/types';
+export * from './modules/network/utilities/url-safety/policy';
+export * from './modules/network/utilities/query-string';
+export { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants';
+export type { TRetryBackoffStrategy, TRetryJitterMode } from './modules/retry/common/constants';
+export type { IRetryBackoffOptions, IRetryContext } from './modules/retry/common/types';
+export { RetryHelper } from './modules/retry/helper';
+export { SlugHelper } from './modules/slug/helper';
+export { TreeBuilder } from './modules/tree/builder';
+export type { IBuildOptions, IHeightWhereOptions, ILeavesOptions, INodeWithPath, IPrintOptions, ITreeNode, IWalkAsyncOptions, IWalkOptions, TNodePredicate, TOnVisit, TOnVisitAsync, } from './modules/tree/common/types';
+export { TreeWalker } from './modules/tree/walk';
+export { BuildInfoRegistry } from './utilities/build-info.utility';
+export type { IBuildInfo, TBuildInfoRecord } from './utilities/build-info.utility';
+export { blankToUndefined, int, keysToCamel, toBoolean, toCamel } from './utilities/parse.utility';
 export { executeWithPerformanceMeasure } from './utilities/performance.utility';
-export { executeWithRetry, executeWithRetryUntil, RetryBackoffStrategies, RetryJitterModes, } from './utilities/retry.utility';
-export type { IRetryBackoffOptions, IRetryContext, TRetryBackoffStrategy, TRetryJitterMode, } from './utilities/retry.utility';
+export { ProjectRootRegistry } from './utilities/project-root.utility';
 export type { AESAlgorithmType } from './modules/crypto/algorithms/aes.algorithm';
 export type { IPayloadCipher } from './modules/crypto/common/types';
 export type { IRedisHelper } from './modules/redis/common/interfaces';

package/dist/cjs/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,cAAc,qDAAqD,CAAC;AAMpE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAKnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACzF,cAAc,qDAAqD,CAAC;AAIpE,cAAc,qDAAqD,CAAC;AACpE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAG9B,cAAc,yDAAyD,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAChG,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/cjs/core.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RetryJitterModes = exports.RetryBackoffStrategies = exports.executeWithRetryUntil = exports.executeWithRetry = exports.executeWithPerformanceMeasure = exports.keysToCamel = exports.toCamel = exports.int = exports.toBoolean = exports.LogLevels = exports.EnvironmentNames = exports.BaseHelper = void 0;
+exports.ProjectRootRegistry = exports.executeWithPerformanceMeasure = exports.toCamel = exports.toBoolean = exports.keysToCamel = exports.int = exports.blankToUndefined = exports.BuildInfoRegistry = exports.TreeWalker = exports.TreeBuilder = exports.SlugHelper = exports.RetryHelper = exports.RetryJitterModes = exports.RetryBackoffStrategies = exports.LogLevels = exports.EnvironmentNames = exports.BaseHelper = void 0;
 var base_1 = require("./modules/base");
 Object.defineProperty(exports, "BaseHelper", { enumerable: true, get: function () { return base_1.BaseHelper; } });
 // By name, never `export *` from `./modules/env`: that barrel also carries `Environment` and
@@ -22,26 +22,48 @@ Object.defineProperty(exports, "BaseHelper", { enumerable: true, get: function (
 var names_1 = require("./modules/env/names");
 Object.defineProperty(exports, "EnvironmentNames", { enumerable: true, get: function () { return names_1.EnvironmentNames; } });
 __exportStar(require("./modules/error"), exports);
-__exportStar(require("./modules/uid"), exports);
-__exportStar(require("./modules/pool"), exports);
-__exportStar(require("./modules/queue/internal/hf"), exports);
 var types_1 = require("./modules/logger/common/types");
 Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return types_1.LogLevels; } });
 __exportStar(require("./modules/network/http-request/fetcher/base-fetcher"), exports);
+// The node fetcher carries no node builtin - its one `querystring.stringify` is written out - so the
+// framework HTTP layer is reachable from a browser bundle, and a connector on HTTP need not
+// re-implement one.
+__exportStar(require("./modules/network/http-request/fetcher/node-fetcher"), exports);
+__exportStar(require("./modules/network/http-request/base-network-request.helper"), exports);
+__exportStar(require("./modules/pool"), exports);
+__exportStar(require("./modules/queue/internal/hf"), exports);
+__exportStar(require("./modules/temporal"), exports);
+__exportStar(require("./modules/uid"), exports);
+// The url guard, pure half only: `UrlPolicy` decides a url and a literal address with string and
+// number work. Its sibling `UrlIngest` reaches `node:dns` and stays out of this subpath.
+__exportStar(require("./modules/network/utilities/url-safety/common/constants"), exports);
+__exportStar(require("./modules/network/utilities/url-safety/policy"), exports);
+__exportStar(require("./modules/network/utilities/query-string"), exports);
+var constants_1 = require("./modules/retry/common/constants");
+Object.defineProperty(exports, "RetryBackoffStrategies", { enumerable: true, get: function () { return constants_1.RetryBackoffStrategies; } });
+Object.defineProperty(exports, "RetryJitterModes", { enumerable: true, get: function () { return constants_1.RetryJitterModes; } });
+var helper_1 = require("./modules/retry/helper");
+Object.defineProperty(exports, "RetryHelper", { enumerable: true, get: function () { return helper_1.RetryHelper; } });
+var helper_2 = require("./modules/slug/helper");
+Object.defineProperty(exports, "SlugHelper", { enumerable: true, get: function () { return helper_2.SlugHelper; } });
+var builder_1 = require("./modules/tree/builder");
+Object.defineProperty(exports, "TreeBuilder", { enumerable: true, get: function () { return builder_1.TreeBuilder; } });
+var walk_1 = require("./modules/tree/walk");
+Object.defineProperty(exports, "TreeWalker", { enumerable: true, get: function () { return walk_1.TreeWalker; } });
 // Pure value/type utilities that already live under the root barrel's `./utilities` re-export -
-// that barrel also carries node-only siblings (module.utility.ts, request.utility.ts,
-// crypto.utility.ts), so it cannot itself become a subpath. Named one at a time here instead of
-// widening the barrel: every symbol below is verified free of node builtins/globals.
+// that barrel also carries node-only siblings (module.utility.ts, request.utility.ts), so it
+// cannot itself become a subpath. Named one at a time here instead of widening the barrel: every
+// symbol below is verified free of node builtins/globals.
+var build_info_utility_1 = require("./utilities/build-info.utility");
+Object.defineProperty(exports, "BuildInfoRegistry", { enumerable: true, get: function () { return build_info_utility_1.BuildInfoRegistry; } });
 var parse_utility_1 = require("./utilities/parse.utility");
-Object.defineProperty(exports, "toBoolean", { enumerable: true, get: function () { return parse_utility_1.toBoolean; } });
+Object.defineProperty(exports, "blankToUndefined", { enumerable: true, get: function () { return parse_utility_1.blankToUndefined; } });
 Object.defineProperty(exports, "int", { enumerable: true, get: function () { return parse_utility_1.int; } });
-Object.defineProperty(exports, "toCamel", { enumerable: true, get: function () { return parse_utility_1.toCamel; } });
 Object.defineProperty(exports, "keysToCamel", { enumerable: true, get: function () { return parse_utility_1.keysToCamel; } });
+Object.defineProperty(exports, "toBoolean", { enumerable: true, get: function () { return parse_utility_1.toBoolean; } });
+Object.defineProperty(exports, "toCamel", { enumerable: true, get: function () { return parse_utility_1.toCamel; } });
 var performance_utility_1 = require("./utilities/performance.utility");
 Object.defineProperty(exports, "executeWithPerformanceMeasure", { enumerable: true, get: function () { return performance_utility_1.executeWithPerformanceMeasure; } });
-var retry_utility_1 = require("./utilities/retry.utility");
-Object.defineProperty(exports, "executeWithRetry", { enumerable: true, get: function () { return retry_utility_1.executeWithRetry; } });
-Object.defineProperty(exports, "executeWithRetryUntil", { enumerable: true, get: function () { return retry_utility_1.executeWithRetryUntil; } });
-Object.defineProperty(exports, "RetryBackoffStrategies", { enumerable: true, get: function () { return retry_utility_1.RetryBackoffStrategies; } });
-Object.defineProperty(exports, "RetryJitterModes", { enumerable: true, get: function () { return retry_utility_1.RetryJitterModes; } });
+var project_root_utility_1 = require("./utilities/project-root.utility");
+Object.defineProperty(exports, "ProjectRootRegistry", { enumerable: true, get: function () { return project_root_utility_1.ProjectRootRegistry; } });
 //# sourceMappingURL=core.js.map

package/dist/cjs/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AACnB,6FAA6F;AAC7F,8DAA8D;AAC9D,6CAAuD;AAA9C,yGAAA,gBAAgB,OAAA;AACzB,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,8DAA4C;AAE5C,uDAA0D;AAAjD,kGAAA,SAAS,OAAA;AAClB,sFAAoE;AAEpE,gGAAgG;AAChG,sFAAsF;AACtF,gGAAgG;AAChG,qFAAqF;AACrF,2DAAiF;AAAxE,0GAAA,SAAS,OAAA;AAAE,oGAAA,GAAG,OAAA;AAAE,wGAAA,OAAO,OAAA;AAAE,4GAAA,WAAW,OAAA;AAC7C,uEAAgF;AAAvE,oIAAA,6BAA6B,OAAA;AACtC,2DAKmC;AAJjC,iHAAA,gBAAgB,OAAA;AAChB,sHAAA,qBAAqB,OAAA;AACrB,uHAAA,sBAAsB,OAAA;AACtB,iHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AACnB,6FAA6F;AAC7F,8DAA8D;AAC9D,6CAAuD;AAA9C,yGAAA,gBAAgB,OAAA;AACzB,kDAAgC;AAChC,uDAA0D;AAAjD,kGAAA,SAAS,OAAA;AAElB,sFAAoE;AACpE,qGAAqG;AACrG,4FAA4F;AAC5F,oBAAoB;AACpB,sFAAoE;AACpE,6FAA2E;AAC3E,iDAA+B;AAC/B,8DAA4C;AAC5C,qDAAmC;AACnC,gDAA8B;AAC9B,iGAAiG;AACjG,yFAAyF;AACzF,0FAAwE;AAExE,gFAA8D;AAC9D,2EAAyD;AACzD,8DAA4F;AAAnF,mHAAA,sBAAsB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAGjD,iDAAqD;AAA5C,qGAAA,WAAW,OAAA;AACpB,gDAAmD;AAA1C,oGAAA,UAAU,OAAA;AACnB,kDAAqD;AAA5C,sGAAA,WAAW,OAAA;AAcpB,4CAAiD;AAAxC,kGAAA,UAAU,OAAA;AAEnB,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,qEAAmE;AAA1D,uHAAA,iBAAiB,OAAA;AAE1B,2DAAmG;AAA1F,iHAAA,gBAAgB,OAAA;AAAE,oGAAA,GAAG,OAAA;AAAE,4GAAA,WAAW,OAAA;AAAE,0GAAA,SAAS,OAAA;AAAE,wGAAA,OAAO,OAAA;AAC/D,uEAAgF;AAAvE,oIAAA,6BAA6B,OAAA;AACtC,yEAAuE;AAA9D,2HAAA,mBAAmB,OAAA"}

package/dist/cjs/modules/base.d.ts

@@ -1,12 +1,15 @@
-import { ILogger } from '../modules/logger/common/types';
+import { ILogger } from './logger/common/types';
 export declare class BaseHelper {
     scope: string;
     identifier: string;
-    logger: ILogger;
     constructor(opts: {
         scope: string;
         identifier?: string;
     });
+    /** The helper's logger, resolved on first read - a helper that never logs never builds one. */
+    get logger(): ILogger;
+    /** Installs one logger on this helper - a test spy, or a host overriding the global resolver. */
+    set logger(value: ILogger);
     getIdentifier(): string;
     getLogger(): ILogger;
 }

package/dist/cjs/modules/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD,qBAAa,UAAU;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;gBAEJ,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IASxD,aAAa;IAIb,SAAS,IAAI,OAAO;CAGrB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD,qBAAa,UAAU;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;gBAEP,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAKxD,+FAA+F;IAC/F,IAAI,MAAM,IAAI,OAAO,CAWpB;IAED,iGAAiG;IACjG,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAExB;IAED,aAAa;IAIb,SAAS,IAAI,OAAO;CAGrB"}

package/dist/cjs/modules/base.js

@@ -1,15 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseHelper = void 0;
-const resolver_1 = require("../modules/logger/resolver");
+const slot_1 = require("./logger/slot");
 class BaseHelper {
     constructor(opts) {
-        this.logger = resolver_1.LoggerResolver.resolve({
-            scopes: [opts.scope, opts.identifier ?? ''].filter(el => el && el.length > 0),
-        });
         this.scope = opts.scope ?? '';
         this.identifier = opts.identifier ?? '';
     }
+    /** The helper's logger, resolved on first read - a helper that never logs never builds one. */
+    get logger() {
+        const scopes = [this.scope, this.identifier].filter(scope => typeof scope === 'string' && scope.length > 0);
+        const logger = (0, slot_1.resolveHelperLogger)({ scopes });
+        // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.
+        if (Object.hasOwn(this, 'scope')) {
+            (0, slot_1.pinHelperLogger)({ helper: this, logger });
+        }
+        return logger;
+    }
+    /** Installs one logger on this helper - a test spy, or a host overriding the global resolver. */
+    set logger(value) {
+        (0, slot_1.pinHelperLogger)({ helper: this, logger: value });
+    }
     getIdentifier() {
         return this.identifier;
     }

package/dist/cjs/modules/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":";;;AACA,wDAA2D;AAE3D,MAAa,UAAU;IAKrB,YAAY,IAA4C;QACtD,IAAI,CAAC,MAAM,GAAG,yBAAc,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SAC9E,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AArBD,gCAqBC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":";;;AACA,gDAA6E;AAE7E,MAAa,UAAU;IAIrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,+FAA+F;IAC/F,IAAI,MAAM;QACR,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACjD,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACvD,CAAC;QACF,MAAM,MAAM,GAAG,IAAA,0BAAmB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,qGAAqG;QACrG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACjC,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iGAAiG;IACjG,IAAI,MAAM,CAAC,KAAc;QACvB,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnCD,gCAmCC"}

package/dist/cjs/modules/cron/{cron.helper.d.ts → helper.d.ts}

@@ -1,4 +1,4 @@
-import { BaseHelper } from '../../modules/base';
+import { BaseHelper } from '../base';
 import { CronJob, CronOnCompleteCommand } from 'cron';
 export interface ICronHelperOptions {
     cronTime: string;
@@ -32,4 +32,4 @@ export declare class CronHelper extends BaseHelper {
         cronTime: string;
     }): CronHelper;
 }
-//# sourceMappingURL=cron.helper.d.ts.map
+//# sourceMappingURL=helper.d.ts.map

package/dist/cjs/modules/cron/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/cron/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAY,MAAM,MAAM,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAChD;AAED,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,WAAW,CAAC,CAA+B;IACnD,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAS;IACpB,OAAO,CAAC,YAAY,CAAC,CAAkC;IAEhD,QAAQ,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IAcpC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,kBAAkB;IAI3C,sFAAsF;IACtF,SAAS,CAAC,aAAa,IAAI,IAAI;IAuB/B,uLAAuL;IACjL,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,KAAK;IASC,IAAI;IASV,cAAc,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IAwBrE,SAAS,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAcrC"}

package/dist/cjs/modules/cron/{cron.helper.js → helper.js}

@@ -1,13 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CronHelper = void 0;
-const base_1 = require("../../modules/base");
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const base_1 = require("../base");
 const promise_utility_1 = require("../../utilities/promise.utility");
 const cron_1 = require("cron");
-const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
 const error_1 = require("../error");
 class CronHelper extends base_1.BaseHelper {
     constructor(opts) {
@@ -26,7 +23,7 @@ class CronHelper extends base_1.BaseHelper {
     }
     /** Builds the job. Synchronous, so the constructor still THROWS on a bad cronTime. */
     buildInstance() {
-        if (!this.cronTime || (0, isEmpty_1.default)(this.cronTime)) {
+        if (!this.cronTime || (0, ignis_inversion_1.isEmpty)({ value: this.cronTime })) {
             throw error_1.ApplicationError.getError({
                 message: '[CronHelper][configure] Invalid cronTime to configure application cron!',
             });
@@ -103,4 +100,4 @@ class CronHelper extends base_1.BaseHelper {
     }
 }
 exports.CronHelper = CronHelper;
-//# sourceMappingURL=cron.helper.js.map
+//# sourceMappingURL=helper.js.map

package/dist/cjs/modules/cron/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/cron/helper.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/cron/index.d.ts

@@ -1,2 +1,2 @@
-export * from './cron.helper';
+export * from './helper';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/cron/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/cron/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/cron/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/cjs/modules/cron/index.js

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

package/dist/cjs/modules/cron/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/cron/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/cron/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/cjs/modules/crypto/algorithms/aes-legacy.algorithm.d.ts

@@ -1,12 +1,16 @@
-import C from 'node:crypto';
 import type { AESAlgorithmType } from './aes.algorithm';
 import { BaseCryptoAlgorithm } from './base.algorithm';
 interface IAESExtraOptions {
     iv?: Buffer;
-    inputEncoding?: C.Encoding;
-    outputEncoding?: C.Encoding;
+    inputEncoding?: BufferEncoding;
+    outputEncoding?: BufferEncoding;
     doThrow?: boolean;
 }
+/**
+ * Frozen back-compat format - keys come from `normalizeSecretKeyLegacy` (padEnd/truncate), never
+ * PBKDF2. `kdfSalt`/`kdfIterations` are deliberately absent from `IAESExtraOptions`: there is no
+ * salt to override, so the option would type-check and silently do nothing.
+ */
 export declare class LegacyAES extends BaseCryptoAlgorithm<AESAlgorithmType, string, string, string, string, string, IAESExtraOptions> {
     constructor(opts: {
         algorithm: AESAlgorithmType;

package/dist/cjs/modules/crypto/algorithms/aes-legacy.algorithm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aes-legacy.algorithm.d.ts","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes-legacy.algorithm.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,aAAa,CAAC;AAG5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvD,UAAU,gBAAgB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,SAAU,SAAQ,mBAAmB,CAChD,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,gBAAgB,CACjB;gBACa,IAAI,EAAE;QAAE,SAAS,EAAE,gBAAgB,CAAA;KAAE;IAIjD,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,gBAAgB;IAIhD,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IA2C1E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAanE,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IA6C1E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAa1D,OAAO,CAAC,wBAAwB;CASjC"}
+{"version":3,"file":"aes-legacy.algorithm.d.ts","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes-legacy.algorithm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvD,UAAU,gBAAgB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,mBAAmB,CAChD,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,gBAAgB,CACjB;gBACa,IAAI,EAAE;QAAE,SAAS,EAAE,gBAAgB,CAAA;KAAE;IAIjD,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,gBAAgB;IAIhD,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IA2C1E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAanE,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IA6C1E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAa1D,OAAO,CAAC,wBAAwB;CASjC"}

package/dist/cjs/modules/crypto/algorithms/aes-legacy.algorithm.js

@@ -4,12 +4,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LegacyAES = void 0;
-const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const common_1 = require("../common");
 const base_algorithm_1 = require("./base.algorithm");
 const DEFAULT_LENGTH = 16;
+/**
+ * Frozen back-compat format - keys come from `normalizeSecretKeyLegacy` (padEnd/truncate), never
+ * PBKDF2. `kdfSalt`/`kdfIterations` are deliberately absent from `IAESExtraOptions`: there is no
+ * salt to override, so the option would type-check and silently do nothing.
+ */
 class LegacyAES extends base_algorithm_1.BaseCryptoAlgorithm {
     constructor(opts) {
         super({ scope: LegacyAES.name, ...opts });
@@ -51,7 +56,7 @@ class LegacyAES extends base_algorithm_1.BaseCryptoAlgorithm {
     }
     encryptFile(opts) {
         const { absolutePath, secret } = opts;
-        if (!absolutePath || (0, isEmpty_1.default)(absolutePath)) {
+        if (!absolutePath || (0, ignis_inversion_1.isEmpty)({ value: absolutePath })) {
             return '';
         }
         const buffer = node_fs_1.default.readFileSync(absolutePath);
@@ -95,7 +100,7 @@ class LegacyAES extends base_algorithm_1.BaseCryptoAlgorithm {
     }
     decryptFile(opts) {
         const { absolutePath, secret } = opts;
-        if (!absolutePath || (0, isEmpty_1.default)(absolutePath)) {
+        if (!absolutePath || (0, ignis_inversion_1.isEmpty)({ value: absolutePath })) {
             return '';
         }
         const buffer = node_fs_1.default.readFileSync(absolutePath);

package/dist/cjs/modules/crypto/algorithms/aes-legacy.algorithm.js.map

@@ -1 +1 @@
-{"version":3,"file":"aes-legacy.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes-legacy.algorithm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aes-legacy.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes-legacy.algorithm.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/crypto/algorithms/aes.algorithm.d.ts

@@ -1,9 +1,12 @@
-import C from 'node:crypto';
 import { BaseCryptoAlgorithm } from './base.algorithm';
 interface IAESDecryptOptions {
-    inputEncoding?: C.Encoding;
-    outputEncoding?: C.Encoding;
+    inputEncoding?: BufferEncoding;
+    outputEncoding?: BufferEncoding;
     doThrow?: boolean;
+    /** Per-deployment PBKDF2 salt override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */
+    kdfSalt?: string;
+    /** PBKDF2 iteration count override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */
+    kdfIterations?: number;
 }
 /** `iv` is encrypt-only: the envelope carries the IV, so decrypt reads it from there and a supplied one would be silently ignored. */
 interface IAESExtraOptions extends IAESDecryptOptions {
@@ -20,11 +23,20 @@ export declare class AES extends BaseCryptoAlgorithm<AESAlgorithmType, string, s
         algorithm: AESAlgorithmType;
     });
     static withAlgorithm(algorithm: AESAlgorithmType): AES;
-    protected resolveEncryptKey(secret: TAESSecret): {
+    protected resolveEncryptKey(opts: {
+        secret: TAESSecret;
+        kdfSalt?: string;
+        kdfIterations?: number;
+    }): {
         id: string;
         key: Buffer;
     };
-    protected resolveDecryptKey(secret: TAESSecret, id: string): Buffer;
+    protected resolveDecryptKey(opts: {
+        secret: TAESSecret;
+        id: string;
+        kdfSalt?: string;
+        kdfIterations?: number;
+    }): Buffer;
     encrypt(opts: {
         message: string;
         secret: TAESSecret;

package/dist/cjs/modules/crypto/algorithms/aes.algorithm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aes.algorithm.d.ts","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,aAAa,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAMvD,UAAU,kBAAkB;IAC1B,aAAa,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sIAAsI;AACtI,UAAU,gBAAiB,SAAQ,kBAAkB;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,aAAa,CAAC;AAE7D,qBAAa,GAAI,SAAQ,mBAAmB,CAC1C,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,EACN,MAAM,EACN,gBAAgB,CACjB;gBACa,IAAI,EAAE;QAAE,SAAS,EAAE,gBAAgB,CAAA;KAAE;IAIjD,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,gBAAgB;IAIhD,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAc5E,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAwBnE,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IA+C9E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM;IAavE,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAAE;IAiDhF,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE;CAY/D"}
+{"version":3,"file":"aes.algorithm.d.ts","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAMvD,UAAU,kBAAkB;IAC1B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8HAA8H;IAC9H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0HAA0H;IAC1H,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sIAAsI;AACtI,UAAU,gBAAiB,SAAQ,kBAAkB;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,aAAa,CAAC;AAE7D,qBAAa,GAAI,SAAQ,mBAAmB,CAC1C,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,EACN,MAAM,EACN,gBAAgB,CACjB;gBACa,IAAI,EAAE;QAAE,SAAS,EAAE,gBAAgB,CAAA;KAAE;IAIjD,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,gBAAgB;IAIhD,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAChC,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAiB/B,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAChC,MAAM,EAAE,UAAU,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,MAAM;IAyBV,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;KAAE;IAiD9E,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM;IAavE,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAAE;IAuDhF,WAAW,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE;CAY/D"}

package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js

@@ -4,10 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AES = void 0;
-const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
-const error_1 = require("../../../modules/error");
+const error_1 = require("../../error");
 const base_algorithm_1 = require("./base.algorithm");
 const DEFAULT_LENGTH = 16;
 const CIPHERTEXT_VERSION = 0x01;
@@ -19,21 +19,25 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
     static withAlgorithm(algorithm) {
         return new AES({ algorithm });
     }
-    resolveEncryptKey(secret) {
+    resolveEncryptKey(opts) {
+        const { secret, kdfSalt, kdfIterations } = opts;
         const entry = Array.isArray(secret) ? secret[0] : { id: DEFAULT_KEY_ID, secret };
-        if (!entry || (0, isEmpty_1.default)(entry.secret)) {
+        if (!entry || (0, ignis_inversion_1.isEmpty)({ value: entry.secret })) {
             throw (0, error_1.getError)({ message: '[AES][resolveEncryptKey] Missing secret or empty keyring' });
         }
         const key = this.normalizeSecretKey({
             secret: entry.secret,
             length: this.getAlgorithmKeySize(),
+            kdfSalt,
+            kdfIterations,
         });
         return { id: entry.id, key };
     }
-    resolveDecryptKey(secret, id) {
+    resolveDecryptKey(opts) {
+        const { secret, id, kdfSalt, kdfIterations } = opts;
         const length = this.getAlgorithmKeySize();
         if (!Array.isArray(secret)) {
-            return this.normalizeSecretKey({ secret, length });
+            return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });
         }
         const entry = secret.find(e => e.id === id);
         if (!entry) {
@@ -42,18 +46,18 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
             });
         }
         // Without this the empty secret derives a key from '' and fails as an opaque OpenSSL error, hiding a plain configuration mistake.
-        if ((0, isEmpty_1.default)(entry.secret)) {
+        if ((0, ignis_inversion_1.isEmpty)({ value: entry.secret })) {
             throw (0, error_1.getError)({
                 message: `[AES][resolveDecryptKey] Keyring entry for key id "${id}" has an empty secret`,
             });
         }
-        return this.normalizeSecretKey({ secret: entry.secret, length });
+        return this.normalizeSecretKey({ secret: entry.secret, length, kdfSalt, kdfIterations });
     }
     encrypt(opts) {
         const { message, secret } = opts;
-        const { iv = node_crypto_1.default.randomBytes(DEFAULT_LENGTH), inputEncoding = 'utf-8', outputEncoding = 'base64', doThrow = true, } = opts.opts ?? {};
+        const { iv = node_crypto_1.default.randomBytes(DEFAULT_LENGTH), inputEncoding = 'utf-8', outputEncoding = 'base64', doThrow = true, kdfSalt, kdfIterations, } = opts.opts ?? {};
         try {
-            const { id, key } = this.resolveEncryptKey(secret);
+            const { id, key } = this.resolveEncryptKey({ secret, kdfSalt, kdfIterations });
             const idBuffer = Buffer.from(id, 'utf-8');
             if (idBuffer.length > 0xff) {
                 throw (0, error_1.getError)({ message: '[AES][encrypt] Key id too long (max 255 bytes)' });
@@ -86,7 +90,7 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
     }
     encryptFile(opts) {
         const { absolutePath, secret } = opts;
-        if (!absolutePath || (0, isEmpty_1.default)(absolutePath)) {
+        if (!absolutePath || (0, ignis_inversion_1.isEmpty)({ value: absolutePath })) {
             return '';
         }
         const buffer = node_fs_1.default.readFileSync(absolutePath);
@@ -96,7 +100,7 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
     }
     decrypt(opts) {
         const { message, secret } = opts;
-        const { inputEncoding = 'base64', outputEncoding = 'utf-8', doThrow = true } = opts.opts ?? {};
+        const { inputEncoding = 'base64', outputEncoding = 'utf-8', doThrow = true, kdfSalt, kdfIterations, } = opts.opts ?? {};
         try {
             const raw = Buffer.from(message, inputEncoding);
             const version = raw[0];
@@ -109,7 +113,7 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
             cursor += idLength;
             const iv = raw.subarray(cursor, cursor + DEFAULT_LENGTH);
             cursor += DEFAULT_LENGTH;
-            const key = this.resolveDecryptKey(secret, id);
+            const key = this.resolveDecryptKey({ secret, id, kdfSalt, kdfIterations });
             const decipher = node_crypto_1.default.createDecipheriv(this.algorithm, key, iv);
             switch (this.algorithm) {
                 case 'aes-256-cbc': {
@@ -134,7 +138,7 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
     }
     decryptFile(opts) {
         const { absolutePath, secret } = opts;
-        if (!absolutePath || (0, isEmpty_1.default)(absolutePath)) {
+        if (!absolutePath || (0, ignis_inversion_1.isEmpty)({ value: absolutePath })) {
             return '';
         }
         const buffer = node_fs_1.default.readFileSync(absolutePath);