@venizia/ignis-helpers 0.2.0-20 → 0.2.0-21

package/dist/cjs/core.d.ts

@@ -1,24 +1,26 @@
 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 * from './modules/network/url-safety/policy';
+export * from './modules/pool';
+export * from './modules/queue/internal/hf';
+export * from './modules/uid';
 export * from './modules/network/url-safety/common/constants';
 export type { IUrlSafetyPolicy } from './modules/network/url-safety/common/types';
-export { RetryHelper } from './modules/retry/helper';
+export * from './modules/network/url-safety/policy';
 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 { TreeWalker } from './modules/tree/walk';
 export { TreeBuilder } from './modules/tree/builder';
-export type { ITreeNode, INodeWithPath, TNodePredicate, TOnVisit, TOnVisitAsync, IWalkOptions, IWalkAsyncOptions, IHeightWhereOptions, IBuildOptions, ILeavesOptions, IPrintOptions, } from './modules/tree/common/types';
-export { toBoolean, int, toCamel, keysToCamel } from './utilities/parse.utility';
+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 { int, keysToCamel, toBoolean, toCamel } from './utilities/parse.utility';
 export { executeWithPerformanceMeasure } from './utilities/performance.utility';
 export { ProjectRootRegistry } from './utilities/project-root.utility';
 export type { AESAlgorithmType } from './modules/crypto/algorithms/aes.algorithm';

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;AAGpE,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,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,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,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"}
+{"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;AACpE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAG9B,cAAc,+CAA+C,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,cAAc,qCAAqC,CAAC;AACpD,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,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACjF,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.ProjectRootRegistry = exports.executeWithPerformanceMeasure = exports.keysToCamel = exports.toCamel = exports.int = exports.toBoolean = exports.TreeBuilder = exports.TreeWalker = exports.SlugHelper = exports.RetryJitterModes = exports.RetryBackoffStrategies = exports.RetryHelper = exports.LogLevels = exports.EnvironmentNames = exports.BaseHelper = void 0;
+exports.ProjectRootRegistry = exports.executeWithPerformanceMeasure = exports.toCamel = exports.toBoolean = exports.keysToCamel = exports.int = 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,36 +22,38 @@ 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);
+__exportStar(require("./modules/pool"), exports);
+__exportStar(require("./modules/queue/internal/hf"), 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/url-safety/policy"), exports);
 __exportStar(require("./modules/network/url-safety/common/constants"), exports);
-var helper_1 = require("./modules/retry/helper");
-Object.defineProperty(exports, "RetryHelper", { enumerable: true, get: function () { return helper_1.RetryHelper; } });
+__exportStar(require("./modules/network/url-safety/policy"), 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 walk_1 = require("./modules/tree/walk");
-Object.defineProperty(exports, "TreeWalker", { enumerable: true, get: function () { return walk_1.TreeWalker; } });
 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), 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, "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 project_root_utility_1 = require("./utilities/project-root.utility");

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;AACpE,iGAAiG;AACjG,yFAAyF;AACzF,sEAAoD;AACpD,gFAA8D;AAE9D,iDAAqD;AAA5C,qGAAA,WAAW,OAAA;AACpB,8DAA4F;AAAnF,mHAAA,sBAAsB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAGjD,gDAAmD;AAA1C,oGAAA,UAAU,OAAA;AACnB,4CAAiD;AAAxC,kGAAA,UAAU,OAAA;AACnB,kDAAqD;AAA5C,sGAAA,WAAW,OAAA;AAepB,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,2DAAiF;AAAxE,0GAAA,SAAS,OAAA;AAAE,oGAAA,GAAG,OAAA;AAAE,wGAAA,OAAO,OAAA;AAAE,4GAAA,WAAW,OAAA;AAC7C,uEAAgF;AAAvE,oIAAA,6BAA6B,OAAA;AACtC,yEAAuE;AAA9D,2HAAA,mBAAmB,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,iDAA+B;AAC/B,8DAA4C;AAC5C,gDAA8B;AAC9B,iGAAiG;AACjG,yFAAyF;AACzF,gFAA8D;AAE9D,sEAAoD;AACpD,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,2DAAiF;AAAxE,oGAAA,GAAG,OAAA;AAAE,4GAAA,WAAW,OAAA;AAAE,0GAAA,SAAS,OAAA;AAAE,wGAAA,OAAO,OAAA;AAC7C,uEAAgF;AAAvE,oIAAA,6BAA6B,OAAA;AACtC,yEAAuE;AAA9D,2HAAA,mBAAmB,OAAA"}

package/dist/cjs/modules/redis/cluster/cluster.helper.d.ts

@@ -3,7 +3,7 @@ import { AbstractRedisHelper } from './../base';
 import { IRedisClusterHelperOptions } from './../common';
 export declare class RedisClusterHelper extends AbstractRedisHelper<Cluster> {
     private startupNodes;
-    private clusterOpts?;
+    private clusterOpts;
     constructor(opts: IRedisClusterHelperOptions);
     getClient(): Cluster;
     duplicateClient(): Cluster;

package/dist/cjs/modules/redis/cluster/cluster.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAClE,OAAO,CAAC,YAAY,CAA2D;IAC/E,OAAO,CAAC,WAAW,CAAC,CAAiB;gBAEzB,IAAI,EAAE,0BAA0B;IAkBnC,SAAS,IACM,OAAO;IAGtB,eAAe,IAAI,OAAO;CAGpC"}
+{"version":3,"file":"cluster.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAClE,OAAO,CAAC,YAAY,CAA2D;IAC/E,OAAO,CAAC,WAAW,CAAiB;gBAExB,IAAI,EAAE,0BAA0B;IAgCnC,SAAS,IACM,OAAO;IAGtB,eAAe,IAAI,OAAO;CAGpC"}

package/dist/cjs/modules/redis/cluster/cluster.helper.js

@@ -6,19 +6,31 @@ const ioredis_1 = require("ioredis");
 const base_1 = require("./../base");
 class RedisClusterHelper extends base_1.AbstractRedisHelper {
     constructor(opts) {
+        const { autoConnect = true } = opts;
         const startupNodes = opts.nodes.map(node => ({
             host: node.host,
             port: (0, utilities_1.int)(node.port),
             password: node.password,
         }));
+        // Precedence (low -> high): the two framework defaults, then `clusterOptions` verbatim. The raw
+        // hatch stays the last word, because a caller already threading `lazyConnect` through it must
+        // keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from
+        // ioredis, so the queue a cluster needs between bind and connect cannot go missing on an
+        // ioredis default change. Deliberately NOT `buildDefaultOpts`: cluster's retry and
+        // per-node-failure semantics differ from single's, and folding them in here is a regression.
+        const clusterOpts = {
+            enableOfflineQueue: true,
+            lazyConnect: !autoConnect,
+            ...opts.clusterOptions,
+        };
         super({
             ...opts,
             scope: RedisClusterHelper.name,
             identifier: opts.name,
-            client: new ioredis_1.Cluster(startupNodes, opts.clusterOptions),
+            client: new ioredis_1.Cluster(startupNodes, clusterOpts),
         });
         this.startupNodes = startupNodes;
-        this.clusterOpts = opts.clusterOptions;
+        this.clusterOpts = clusterOpts;
     }
     getClient() {
         return this.client;

package/dist/cjs/modules/redis/cluster/cluster.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAkC;AAClC,qCAAuD;AACvD,oCAAgD;AAGhD,MAAa,kBAAmB,SAAQ,0BAA4B;IAIlE,YAAY,IAAgC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAA,eAAG,EAAC,IAAI,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,iBAAO,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;IACzC,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,iBAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;CACF;AA7BD,gDA6BC"}
+{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAkC;AAClC,qCAAuD;AACvD,oCAAgD;AAGhD,MAAa,kBAAmB,SAAQ,0BAA4B;IAIlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAA,eAAG,EAAC,IAAI,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,mFAAmF;QACnF,6FAA6F;QAC7F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,iBAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC/C,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,iBAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;CACF;AA3CD,gDA2CC"}

package/dist/cjs/modules/redis/common/types.d.ts

@@ -19,6 +19,8 @@ export interface IRedisClusterHelperProps {
         port: string | number;
         password?: string;
     }>;
+    /** Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`. */
+    autoConnect?: boolean;
     clusterOptions?: ClusterOptions;
 }
 export interface IRedisSentinelHelperProps {

package/dist/cjs/modules/redis/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB,EAAE,qBAAqB;CAAG;AAEpG,MAAM,WAAW,0BACf,SAAQ,wBAAwB,EAAE,qBAAqB;CAAG;AAE5D,MAAM,WAAW,2BACf,SAAQ,yBAAyB,EAAE,qBAAqB;CAAG"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,qGAAqG;IACrG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB,EAAE,qBAAqB;CAAG;AAEpG,MAAM,WAAW,0BACf,SAAQ,wBAAwB,EAAE,qBAAqB;CAAG;AAE5D,MAAM,WAAW,2BACf,SAAQ,yBAAyB,EAAE,qBAAqB;CAAG"}

package/dist/cjs/utilities/build-info.utility.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What a build stamps about itself. Every field optional: a host that never ran the generator still
+ * answers, with the fields it does know.
+ */
+export interface IBuildInfo {
+    service?: string;
+    version?: string;
+    commit?: string;
+    branch?: string;
+    builtAt?: string;
+}
+/** The stamp with every field resolved: what the generator writes and what the health reporter answers. */
+export type TBuildInfoRecord = Required<IBuildInfo>;
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+export declare class BuildInfoRegistry {
+    private static readonly SLOT;
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static readonly UNSPECIFIED = "unspecified";
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts: {
+        buildInfo: IBuildInfo;
+    }): void;
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get(): IBuildInfo | undefined;
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear(): void;
+}
+//# sourceMappingURL=build-info.utility.d.ts.map

package/dist/cjs/utilities/build-info.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAE9D,qNAAqN;IACrN,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI;IAIjD,2EAA2E;IAC3E,MAAM,CAAC,GAAG,IAAI,UAAU,GAAG,SAAS;IAIpC,4EAA4E;IAC5E,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/cjs/utilities/build-info.utility.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildInfoRegistry = void 0;
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+class BuildInfoRegistry {
+    static { this.SLOT = Symbol.for('ignis:build-info'); }
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static { this.UNSPECIFIED = 'unspecified'; }
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts) {
+        Reflect.set(globalThis, this.SLOT, opts.buildInfo);
+    }
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get() {
+        return Reflect.get(globalThis, this.SLOT);
+    }
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear() {
+        Reflect.deleteProperty(globalThis, this.SLOT);
+    }
+}
+exports.BuildInfoRegistry = BuildInfoRegistry;
+//# sourceMappingURL=build-info.utility.js.map

package/dist/cjs/utilities/build-info.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.js","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":";;;AAeA;;;;;GAKG;AACH,MAAa,iBAAiB;aACJ,SAAI,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAE9D,qNAAqN;aACrM,gBAAW,GAAG,aAAa,CAAC;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAA+B;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAG;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK;QACV,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;;AAnBH,8CAoBC"}

package/dist/cjs/utilities/index.d.ts

@@ -1,3 +1,4 @@
+export * from './build-info.utility';
 export * from './date.utility';
 export * from './module.utility';
 export * from './parse.utility';

package/dist/cjs/utilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/cjs/utilities/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./build-info.utility"), exports);
 __exportStar(require("./date.utility"), exports);
 __exportStar(require("./module.utility"), exports);
 __exportStar(require("./parse.utility"), exports);

package/dist/cjs/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,mDAAiC;AACjC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC;AAClC,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,iDAA+B;AAC/B,mDAAiC;AACjC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC;AAClC,oDAAkC"}

package/dist/esm/core.d.ts

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

package/dist/esm/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;AAGpE,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,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,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,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"}
+{"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;AACpE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAG9B,cAAc,+CAA+C,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,cAAc,qCAAqC,CAAC;AACpD,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,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACjF,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/esm/core.js

@@ -3,25 +3,26 @@ export { BaseHelper } from './modules/base.js';
 // `applicationEnvironment`, both of which read `process.env`.
 export { EnvironmentNames } from './modules/env/names.js';
 export * from './modules/error/index.js';
-export * from './modules/uid/index.js';
-export * from './modules/pool/index.js';
-export * from './modules/queue/internal/hf/index.js';
 export { LogLevels } from './modules/logger/common/types.js';
 export * from './modules/network/http-request/fetcher/base-fetcher.js';
+export * from './modules/pool/index.js';
+export * from './modules/queue/internal/hf/index.js';
+export * from './modules/uid/index.js';
 // 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.
-export * from './modules/network/url-safety/policy.js';
 export * from './modules/network/url-safety/common/constants.js';
-export { RetryHelper } from './modules/retry/helper.js';
+export * from './modules/network/url-safety/policy.js';
 export { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants.js';
+export { RetryHelper } from './modules/retry/helper.js';
 export { SlugHelper } from './modules/slug/helper.js';
-export { TreeWalker } from './modules/tree/walk.js';
 export { TreeBuilder } from './modules/tree/builder.js';
+export { TreeWalker } from './modules/tree/walk.js';
 // 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), 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.
-export { toBoolean, int, toCamel, keysToCamel } from './utilities/parse.utility.js';
+export { BuildInfoRegistry } from './utilities/build-info.utility.js';
+export { int, keysToCamel, toBoolean, toCamel } from './utilities/parse.utility.js';
 export { executeWithPerformanceMeasure } from './utilities/performance.utility.js';
 export { ProjectRootRegistry } from './utilities/project-root.utility.js';
 //# sourceMappingURL=core.js.map

package/dist/esm/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,6FAA6F;AAC7F,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,cAAc,qDAAqD,CAAC;AACpE,iGAAiG;AACjG,yFAAyF;AACzF,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAG5F,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,6FAA6F;AAC7F,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,cAAc,qDAAqD,CAAC;AACpE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,iGAAiG;AACjG,yFAAyF;AACzF,cAAc,+CAA+C,CAAC;AAE9D,cAAc,qCAAqC,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAcrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/esm/modules/redis/cluster/cluster.helper.d.ts

@@ -3,7 +3,7 @@ import { AbstractRedisHelper } from './../base/index.js';
 import { IRedisClusterHelperOptions } from './../common/index.js';
 export declare class RedisClusterHelper extends AbstractRedisHelper<Cluster> {
     private startupNodes;
-    private clusterOpts?;
+    private clusterOpts;
     constructor(opts: IRedisClusterHelperOptions);
     getClient(): Cluster;
     duplicateClient(): Cluster;

package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAClE,OAAO,CAAC,YAAY,CAA2D;IAC/E,OAAO,CAAC,WAAW,CAAC,CAAiB;gBAEzB,IAAI,EAAE,0BAA0B;IAkBnC,SAAS,IACM,OAAO;IAGtB,eAAe,IAAI,OAAO;CAGpC"}
+{"version":3,"file":"cluster.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAClE,OAAO,CAAC,YAAY,CAA2D;IAC/E,OAAO,CAAC,WAAW,CAAiB;gBAExB,IAAI,EAAE,0BAA0B;IAgCnC,SAAS,IACM,OAAO;IAGtB,eAAe,IAAI,OAAO;CAGpC"}

package/dist/esm/modules/redis/cluster/cluster.helper.js

@@ -3,19 +3,31 @@ import { Cluster } from 'ioredis';
 import { AbstractRedisHelper } from './../base/index.js';
 export class RedisClusterHelper extends AbstractRedisHelper {
     constructor(opts) {
+        const { autoConnect = true } = opts;
         const startupNodes = opts.nodes.map(node => ({
             host: node.host,
             port: int(node.port),
             password: node.password,
         }));
+        // Precedence (low -> high): the two framework defaults, then `clusterOptions` verbatim. The raw
+        // hatch stays the last word, because a caller already threading `lazyConnect` through it must
+        // keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from
+        // ioredis, so the queue a cluster needs between bind and connect cannot go missing on an
+        // ioredis default change. Deliberately NOT `buildDefaultOpts`: cluster's retry and
+        // per-node-failure semantics differ from single's, and folding them in here is a regression.
+        const clusterOpts = {
+            enableOfflineQueue: true,
+            lazyConnect: !autoConnect,
+            ...opts.clusterOptions,
+        };
         super({
             ...opts,
             scope: RedisClusterHelper.name,
             identifier: opts.name,
-            client: new Cluster(startupNodes, opts.clusterOptions),
+            client: new Cluster(startupNodes, clusterOpts),
         });
         this.startupNodes = startupNodes;
-        this.clusterOpts = opts.clusterOptions;
+        this.clusterOpts = clusterOpts;
     }
     getClient() {
         return this.client;

package/dist/esm/modules/redis/cluster/cluster.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAIlE,YAAY,IAAgC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;IACzC,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;CACF"}
+{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAIlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,mFAAmF;QACnF,6FAA6F;QAC7F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC/C,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/esm/modules/redis/common/types.d.ts

@@ -19,6 +19,8 @@ export interface IRedisClusterHelperProps {
         port: string | number;
         password?: string;
     }>;
+    /** Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`. */
+    autoConnect?: boolean;
     clusterOptions?: ClusterOptions;
 }
 export interface IRedisSentinelHelperProps {

package/dist/esm/modules/redis/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB,EAAE,qBAAqB;CAAG;AAEpG,MAAM,WAAW,0BACf,SAAQ,wBAAwB,EAAE,qBAAqB;CAAG;AAE5D,MAAM,WAAW,2BACf,SAAQ,yBAAyB,EAAE,qBAAqB;CAAG"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,qGAAqG;IACrG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB,EAAE,qBAAqB;CAAG;AAEpG,MAAM,WAAW,0BACf,SAAQ,wBAAwB,EAAE,qBAAqB;CAAG;AAE5D,MAAM,WAAW,2BACf,SAAQ,yBAAyB,EAAE,qBAAqB;CAAG"}

package/dist/esm/utilities/build-info.utility.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What a build stamps about itself. Every field optional: a host that never ran the generator still
+ * answers, with the fields it does know.
+ */
+export interface IBuildInfo {
+    service?: string;
+    version?: string;
+    commit?: string;
+    branch?: string;
+    builtAt?: string;
+}
+/** The stamp with every field resolved: what the generator writes and what the health reporter answers. */
+export type TBuildInfoRecord = Required<IBuildInfo>;
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+export declare class BuildInfoRegistry {
+    private static readonly SLOT;
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static readonly UNSPECIFIED = "unspecified";
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts: {
+        buildInfo: IBuildInfo;
+    }): void;
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get(): IBuildInfo | undefined;
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear(): void;
+}
+//# sourceMappingURL=build-info.utility.d.ts.map

package/dist/esm/utilities/build-info.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAE9D,qNAAqN;IACrN,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI;IAIjD,2EAA2E;IAC3E,MAAM,CAAC,GAAG,IAAI,UAAU,GAAG,SAAS;IAIpC,4EAA4E;IAC5E,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/esm/utilities/build-info.utility.js

@@ -0,0 +1,24 @@
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+export class BuildInfoRegistry {
+    static { this.SLOT = Symbol.for('ignis:build-info'); }
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static { this.UNSPECIFIED = 'unspecified'; }
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts) {
+        Reflect.set(globalThis, this.SLOT, opts.buildInfo);
+    }
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get() {
+        return Reflect.get(globalThis, this.SLOT);
+    }
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear() {
+        Reflect.deleteProperty(globalThis, this.SLOT);
+    }
+}
+//# sourceMappingURL=build-info.utility.js.map

package/dist/esm/utilities/build-info.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.js","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;aACJ,SAAI,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAE9D,qNAAqN;aACrM,gBAAW,GAAG,aAAa,CAAC;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAA+B;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAG;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK;QACV,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC"}

package/dist/esm/utilities/index.d.ts

@@ -1,3 +1,4 @@
+export * from './build-info.utility.js';
 export * from './date.utility.js';
 export * from './module.utility.js';
 export * from './parse.utility.js';

package/dist/esm/utilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/esm/utilities/index.js

@@ -1,3 +1,4 @@
+export * from './build-info.utility.js';
 export * from './date.utility.js';
 export * from './module.utility.js';
 export * from './parse.utility.js';

package/dist/esm/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-helpers",
-  "version": "0.2.0-20",
+  "version": "0.2.0-21",
   "description": "Production-ready TypeScript utility library: pluggable logging (winston or pino behind one ILogger contract), Redis single/cluster/sentinel with pub/sub, BullMQ/MQTT/Kafka message queues, MinIO/Disk/Bun-S3 object storage, AES-256/RSA/ECDH cryptography, Snowflake UID generation, cron scheduling, Socket.IO/WebSocket, TCP/TLS/UDP networking, HTTP clients, secrets/Vault, worker thread pools, and environment management. Sub-path imports isolate optional peer dependencies so the root barrel never forces a peer into your bundle.",
   "keywords": [
     "aes",