@venizia/ignis-helpers 0.1.1-12 → 0.1.1-14

package/dist/modules/queue/kafka/bundler/common/constants.d.ts

@@ -1,9 +1,20 @@
 export declare class KafkaBundlerPluginNames {
     static readonly PLATFORMATIC_WASM = "ignis:platformatic-wasm";
+    static readonly PLATFORMATIC_REQUIRE = "ignis:platformatic-require";
 }
 export declare class PlatformaticWasmSpecifiers {
     static readonly ENTRYPOINT = "@platformatic/wasm-utils";
     static readonly BUNDLED_ENTRYPOINT = "@platformatic/wasm-utils/bundled";
     static readonly ENTRYPOINT_FILTER: RegExp;
 }
+export declare class PlatformaticRequireSpecifiers {
+    /** Modules whose module-scope `require()` calls must be hoisted to static imports. */
+    static readonly MODULE_FILTER: RegExp;
+    /** `const <binding> = require('<specifier>');` at module scope; anchored so a lazy `require()` nested inside a function body never matches. */
+    static readonly REQUIRE_PATTERN: RegExp;
+    /** Optional peers of `@platformatic/kafka`; a static import would break builds that do not install them. */
+    static readonly SKIPPED_SPECIFIERS: readonly string[];
+    /** Prefix for the injected import bindings, namespaced to avoid colliding with upstream identifiers. */
+    static readonly IMPORT_ALIAS_PREFIX = "__ignisRequire";
+}
 //# sourceMappingURL=constants.d.ts.map

package/dist/modules/queue/kafka/bundler/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,6BAA6B;CAC/D;AAED,qBAAa,0BAA0B;IACrC,MAAM,CAAC,QAAQ,CAAC,UAAU,8BAA8B;IACxD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,sCAAsC;IACxE,MAAM,CAAC,QAAQ,CAAC,iBAAiB,SAAiC;CACnE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,6BAA6B;IAC9D,MAAM,CAAC,QAAQ,CAAC,oBAAoB,gCAAgC;CACrE;AAED,qBAAa,0BAA0B;IACrC,MAAM,CAAC,QAAQ,CAAC,UAAU,8BAA8B;IACxD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,sCAAsC;IACxE,MAAM,CAAC,QAAQ,CAAC,iBAAiB,SAAiC;CACnE;AAED,qBAAa,6BAA6B;IACxC,sFAAsF;IACtF,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAkD;IAE/E,+IAA+I;IAC/I,MAAM,CAAC,QAAQ,CAAC,eAAe,SAAwD;IAEvF,4GAA4G;IAC5G,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAoC;IAEzF,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,mBAAmB,oBAAoB;CACxD"}

package/dist/modules/queue/kafka/bundler/common/constants.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlatformaticWasmSpecifiers = exports.KafkaBundlerPluginNames = void 0;
+exports.PlatformaticRequireSpecifiers = exports.PlatformaticWasmSpecifiers = exports.KafkaBundlerPluginNames = void 0;
 class KafkaBundlerPluginNames {
     static { this.PLATFORMATIC_WASM = 'ignis:platformatic-wasm'; }
+    static { this.PLATFORMATIC_REQUIRE = 'ignis:platformatic-require'; }
 }
 exports.KafkaBundlerPluginNames = KafkaBundlerPluginNames;
 class PlatformaticWasmSpecifiers {
@@ -11,4 +12,15 @@ class PlatformaticWasmSpecifiers {
     static { this.ENTRYPOINT_FILTER = /^@platformatic\/wasm-utils$/; }
 }
 exports.PlatformaticWasmSpecifiers = PlatformaticWasmSpecifiers;
+class PlatformaticRequireSpecifiers {
+    /** Modules whose module-scope `require()` calls must be hoisted to static imports. */
+    static { this.MODULE_FILTER = /@platformatic[\\/]kafka[\\/]dist[\\/].*\.js$/; }
+    /** `const <binding> = require('<specifier>');` at module scope; anchored so a lazy `require()` nested inside a function body never matches. */
+    static { this.REQUIRE_PATTERN = /^const\s+(\w+)\s*=\s*require\((['"])(.+?)\2\);?$/gm; }
+    /** Optional peers of `@platformatic/kafka`; a static import would break builds that do not install them. */
+    static { this.SKIPPED_SPECIFIERS = ['protobufjs', '@node-rs/crc32']; }
+    /** Prefix for the injected import bindings, namespaced to avoid colliding with upstream identifiers. */
+    static { this.IMPORT_ALIAS_PREFIX = '__ignisRequire'; }
+}
+exports.PlatformaticRequireSpecifiers = PlatformaticRequireSpecifiers;
 //# sourceMappingURL=constants.js.map

package/dist/modules/queue/kafka/bundler/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/common/constants.ts"],"names":[],"mappings":";;;AAAA,MAAa,uBAAuB;aAClB,sBAAiB,GAAG,yBAAyB,CAAC;;AADhE,0DAEC;AAED,MAAa,0BAA0B;aACrB,eAAU,GAAG,0BAA0B,CAAC;aACxC,uBAAkB,GAAG,kCAAkC,CAAC;aACxD,sBAAiB,GAAG,6BAA6B,CAAC;;AAHpE,gEAIC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/common/constants.ts"],"names":[],"mappings":";;;AAAA,MAAa,uBAAuB;aAClB,sBAAiB,GAAG,yBAAyB,CAAC;aAC9C,yBAAoB,GAAG,4BAA4B,CAAC;;AAFtE,0DAGC;AAED,MAAa,0BAA0B;aACrB,eAAU,GAAG,0BAA0B,CAAC;aACxC,uBAAkB,GAAG,kCAAkC,CAAC;aACxD,sBAAiB,GAAG,6BAA6B,CAAC;;AAHpE,gEAIC;AAED,MAAa,6BAA6B;IACxC,sFAAsF;aACtE,kBAAa,GAAG,8CAA8C,CAAC;IAE/E,+IAA+I;aAC/H,oBAAe,GAAG,oDAAoD,CAAC;IAEvF,4GAA4G;aAC5F,uBAAkB,GAAsB,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAEzF,wGAAwG;aACxF,wBAAmB,GAAG,gBAAgB,CAAC;;AAXzD,sEAYC"}

package/dist/modules/queue/kafka/bundler/index.d.ts

@@ -1,3 +1,5 @@
 export * from './common';
+export * from './platformatic-require.plugin';
 export * from './platformatic-wasm.plugin';
+export * from './plugins';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/queue/kafka/bundler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}

package/dist/modules/queue/kafka/bundler/index.js

@@ -15,5 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
+__exportStar(require("./platformatic-require.plugin"), exports);
 __exportStar(require("./platformatic-wasm.plugin"), exports);
+__exportStar(require("./plugins"), exports);
 //# sourceMappingURL=index.js.map

package/dist/modules/queue/kafka/bundler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6DAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,gEAA8C;AAC9C,6DAA2C;AAC3C,4CAA0B"}

package/dist/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts

@@ -0,0 +1,4 @@
+import type { BunPlugin } from 'bun';
+/** `@platformatic/kafka` resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with "Cannot find package" before boot - this plugin hoists those calls to static imports at bundle time. */
+export declare const platformaticRequirePlugin: () => BunPlugin;
+//# sourceMappingURL=platformatic-require.plugin.d.ts.map

package/dist/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformatic-require.plugin.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,gUAAgU;AAChU,eAAO,MAAM,yBAAyB,QAAO,SAgC3C,CAAC"}

package/dist/modules/queue/kafka/bundler/platformatic-require.plugin.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.platformaticRequirePlugin = void 0;
+const common_1 = require("./common");
+/** `@platformatic/kafka` resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with "Cannot find package" before boot - this plugin hoists those calls to static imports at bundle time. */
+const platformaticRequirePlugin = () => ({
+    name: common_1.KafkaBundlerPluginNames.PLATFORMATIC_REQUIRE,
+    setup(build) {
+        build.onLoad({ filter: common_1.PlatformaticRequireSpecifiers.MODULE_FILTER }, async (args) => {
+            const source = await Bun.file(args.path).text();
+            const imports = [];
+            const contents = source.replace(common_1.PlatformaticRequireSpecifiers.REQUIRE_PATTERN, (matched, binding, _quote, specifier) => {
+                if (common_1.PlatformaticRequireSpecifiers.SKIPPED_SPECIFIERS.includes(specifier)) {
+                    return matched;
+                }
+                const alias = `${common_1.PlatformaticRequireSpecifiers.IMPORT_ALIAS_PREFIX}${imports.length}`;
+                imports.push(`import ${alias} from ${JSON.stringify(specifier)};`);
+                // No `?.default` unwrap: a default import already yields `module.exports` for CJS, and
+                // unwrapping would break JSON payloads carrying their own top-level `default` key - the
+                // draft-06 meta schema has one, so unwrapping silently replaces it with `{}`.
+                return `const ${binding} = ${alias};`;
+            });
+            // No match is not an error: upstream fixing this makes the plugin an inert no-op.
+            if (!imports.length) {
+                return undefined;
+            }
+            return { contents: `${imports.join('\n')}\n${contents}`, loader: 'js' };
+        });
+    },
+});
+exports.platformaticRequirePlugin = platformaticRequirePlugin;
+//# sourceMappingURL=platformatic-require.plugin.js.map

package/dist/modules/queue/kafka/bundler/platformatic-require.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformatic-require.plugin.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":";;;AACA,qCAAkF;AAElF,gUAAgU;AACzT,MAAM,yBAAyB,GAAG,GAAc,EAAE,CAAC,CAAC;IACzD,IAAI,EAAE,gCAAuB,CAAC,oBAAoB;IAClD,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,sCAA6B,CAAC,aAAa,EAAE,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACjF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC7B,sCAA6B,CAAC,eAAe,EAC7C,CAAC,OAAO,EAAE,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE;gBAC9D,IAAI,sCAA6B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzE,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,sCAA6B,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAEnE,uFAAuF;gBACvF,wFAAwF;gBACxF,8EAA8E;gBAC9E,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG,CAAC;YACxC,CAAC,CACF,CAAC;YAEF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAhCU,QAAA,yBAAyB,6BAgCnC"}

package/dist/modules/queue/kafka/bundler/plugins.d.ts

@@ -0,0 +1,4 @@
+import type { BunPlugin } from 'bun';
+/** Every `@platformatic/kafka` fix needed by `bun build --compile`, as one list - a service compile script registers this instead of tracking the individual plugins. */
+export declare const platformaticKafkaPlugins: () => BunPlugin[];
+//# sourceMappingURL=plugins.d.ts.map

package/dist/modules/queue/kafka/bundler/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAIrC,yKAAyK;AACzK,eAAO,MAAM,wBAAwB,QAAO,SAAS,EAGpD,CAAC"}

package/dist/modules/queue/kafka/bundler/plugins.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.platformaticKafkaPlugins = void 0;
+const platformatic_require_plugin_1 = require("./platformatic-require.plugin");
+const platformatic_wasm_plugin_1 = require("./platformatic-wasm.plugin");
+/** Every `@platformatic/kafka` fix needed by `bun build --compile`, as one list - a service compile script registers this instead of tracking the individual plugins. */
+const platformaticKafkaPlugins = () => [
+    (0, platformatic_wasm_plugin_1.platformaticWasmPlugin)(),
+    (0, platformatic_require_plugin_1.platformaticRequirePlugin)(),
+];
+exports.platformaticKafkaPlugins = platformaticKafkaPlugins;
+//# sourceMappingURL=plugins.js.map

package/dist/modules/queue/kafka/bundler/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/bundler/plugins.ts"],"names":[],"mappings":";;;AACA,+EAA0E;AAC1E,yEAAoE;AAEpE,yKAAyK;AAClK,MAAM,wBAAwB,GAAG,GAAgB,EAAE,CAAC;IACzD,IAAA,iDAAsB,GAAE;IACxB,IAAA,uDAAyB,GAAE;CAC5B,CAAC;AAHW,QAAA,wBAAwB,4BAGnC"}

package/dist/modules/secrets/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAI3F,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,cAAc,CAAC,CA2BzB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAI3F,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,cAAc,CAAC,CA2CzB"}

package/dist/modules/secrets/factory.js

@@ -12,19 +12,34 @@ async function createSecretsHelper(opts) {
         cacheTtlSeconds: opts.cacheTtlSeconds,
         renewBeforeRatio: opts.renewBeforeRatio,
     };
+    const config = opts.config;
     switch (opts.provider) {
         case common_1.SecretProviders.SYSTEM_ENVS: {
             return new system_envs_1.SystemEnvsHelper({ identifier: opts.identifier });
         }
         case common_1.SecretProviders.HASHICORP_VAULT: {
-            module_utility_1.ModuleUtility.assertInstalled({ scope: 'HashiCorpVaultHelper', modules: ['node-vault'] });
+            // `client` is the injected escape: the helper never reaches for the peer, so demanding it here would defeat the escape.
+            if (!config?.client) {
+                module_utility_1.ModuleUtility.assertInstalled({
+                    scope: 'HashiCorpVaultHelper',
+                    modules: ['node-vault'],
+                    allowRegistered: true,
+                });
+            }
             const { HashiCorpVaultHelper } = (await import('./hashicorp/index.js'));
-            return new HashiCorpVaultHelper({ ...opts.config, ...shared });
+            return new HashiCorpVaultHelper({ ...config, ...shared });
         }
         case common_1.SecretProviders.DOTENV_VAULT: {
-            module_utility_1.ModuleUtility.assertInstalled({ scope: 'DotenvVaultHelper', modules: ['@dotenvx/dotenvx'] });
+            // `decode` is the injected escape - same reasoning as `client` above.
+            if (!config?.decode) {
+                module_utility_1.ModuleUtility.assertInstalled({
+                    scope: 'DotenvVaultHelper',
+                    modules: ['@dotenvx/dotenvx'],
+                    allowRegistered: true,
+                });
+            }
             const { DotenvVaultHelper } = (await import('./dotenv/index.js'));
-            return new DotenvVaultHelper({ ...opts.config, ...shared });
+            return new DotenvVaultHelper({ ...config, ...shared });
         }
         default: {
             throw (0, error_1.getError)({

package/dist/modules/secrets/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/modules/secrets/factory.ts"],"names":[],"mappings":";;AAOA,kDA6BC;AAnCD,2CAA2C;AAC3C,+DAA2D;AAC3D,qCAA2F;AAC3F,+CAAiD;AAEjD,0RAA0R;AACnR,KAAK,UAAU,mBAAmB,CACvC,IAAoD;IAEpD,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC;IAEF,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,wBAAe,CAAC,WAAW,CAAC,CAAC,CAAC;YACjC,OAAO,IAAI,8BAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,wBAAe,CAAC,eAAe,CAAC,CAAC,CAAC;YACrC,8BAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC1F,MAAM,EAAE,oBAAoB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAY,CAAC;YACnF,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAI,IAAI,CAAC,MAAkB,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,wBAAe,CAAC,YAAY,CAAC,CAAC,CAAC;YAClC,8BAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;YAC7F,MAAM,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAY,CAAC;YAC7E,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAI,IAAI,CAAC,MAAkB,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/modules/secrets/factory.ts"],"names":[],"mappings":";;AAOA,kDA6CC;AAnDD,2CAA2C;AAC3C,+DAA2D;AAC3D,qCAA2F;AAC3F,+CAAiD;AAEjD,0RAA0R;AACnR,KAAK,UAAU,mBAAmB,CACvC,IAAoD;IAEpD,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;IAEtC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,wBAAe,CAAC,WAAW,CAAC,CAAC,CAAC;YACjC,OAAO,IAAI,8BAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,wBAAe,CAAC,eAAe,CAAC,CAAC,CAAC;YACrC,wHAAwH;YACxH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACpB,8BAAa,CAAC,eAAe,CAAC;oBAC5B,KAAK,EAAE,sBAAsB;oBAC7B,OAAO,EAAE,CAAC,YAAY,CAAC;oBACvB,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,oBAAoB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAY,CAAC;YACnF,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,wBAAe,CAAC,YAAY,CAAC,CAAC,CAAC;YAClC,sEAAsE;YACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACpB,8BAAa,CAAC,eAAe,CAAC;oBAC5B,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,CAAC,kBAAkB,CAAC;oBAC7B,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAY,CAAC;YAC7E,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utilities/module.utility.d.ts

@@ -11,6 +11,10 @@ export declare class ModuleUtility {
      * A `bun build --compile` binary ships without `node_modules`, which leaves runtime resolution
      * nothing to resolve against: the application imports such a peer statically - that import is
      * what gets it into the binary - and registers it here before the consuming component boots.
+     *
+     * Deliberately does not log. It runs at the entrypoint of exactly the deployment that has no
+     * logger provider yet, where `LoggerFactory` throws - and a throw mid-loop would drop every
+     * module after the first.
      */
     static register(opts: {
         modules: Record<string, AnyType>;
@@ -23,10 +27,18 @@ export declare class ModuleUtility {
     static loadSync<T = AnyType>(opts: {
         module: string;
     }): T;
-    /** Presence check only - throws naming what to install, without executing the module. */
+    /**
+     * Presence check only - throws naming what to install, without executing the module.
+     *
+     * `allowRegistered` must be set only where {@link load} or {@link loadSync} is what finally loads
+     * the module. Where the consumer resolves the specifier itself - `pino.transport()` inside a
+     * worker thread, or any caller with its own `createRequire` - the registry cannot reach it, and
+     * counting a registration as installed would replace this precise error with an opaque one.
+     */
     static assertInstalled(opts: {
         modules: Array<string>;
         scope?: string;
+        allowRegistered?: boolean;
     }): void;
 }
 //# sourceMappingURL=module.utility.d.ts.map

package/dist/utilities/module.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/module.utility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,4LAA4L;AAC5L,qBAAa,aAAa;IACxB,sGAAsG;IACtG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEhE,8FAA8F;IAC9F,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,IAAI;IAanB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAOjE,sFAAsF;WACzE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpE,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC;IAczD,yFAAyF;IACzF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAgB/E"}
+{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/module.utility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,4LAA4L;AAC5L,qBAAa,aAAa;IACxB,sGAAsG;IACtG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEhE,8FAA8F;IAC9F,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,IAAI;IAanB;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAMjE,sFAAsF;WACzE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpE,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC;IAczD;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,IAAI;CAgBT"}

package/dist/utilities/module.utility.js

@@ -30,11 +30,14 @@ class ModuleUtility {
      * A `bun build --compile` binary ships without `node_modules`, which leaves runtime resolution
      * nothing to resolve against: the application imports such a peer statically - that import is
      * what gets it into the binary - and registers it here before the consuming component boots.
+     *
+     * Deliberately does not log. It runs at the entrypoint of exactly the deployment that has no
+     * logger provider yet, where `LoggerFactory` throws - and a throw mid-loop would drop every
+     * module after the first.
      */
     static register(opts) {
         for (const [module, value] of Object.entries(opts.modules)) {
             this.registered.set(module, value);
-            logger.for(this.register.name).debug("Registered module: '%s'", module);
         }
     }
     /** Loads the module. Use this everywhere except a constructor, which cannot await. */
@@ -63,12 +66,19 @@ class ModuleUtility {
             throw this.fail({ method: 'loadSync', module, error });
         }
     }
-    /** Presence check only - throws naming what to install, without executing the module. */
+    /**
+     * Presence check only - throws naming what to install, without executing the module.
+     *
+     * `allowRegistered` must be set only where {@link load} or {@link loadSync} is what finally loads
+     * the module. Where the consumer resolves the specifier itself - `pino.transport()` inside a
+     * worker thread, or any caller with its own `createRequire` - the registry cannot reach it, and
+     * counting a registration as installed would replace this precise error with an opaque one.
+     */
     static assertInstalled(opts) {
-        const { modules, scope } = opts;
+        const { modules, scope, allowRegistered = false } = opts;
         const appRequire = this.appRequire();
         for (const module of modules) {
-            if (this.registered.has(module)) {
+            if (allowRegistered && this.registered.has(module)) {
                 continue;
             }
             try {

package/dist/utilities/module.utility.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-helpers",
-  "version": "0.1.1-12",
+  "version": "0.1.1-14",
   "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",
@@ -268,7 +268,7 @@
   "devDependencies": {
     "@dotenvx/dotenvx": "^2.14.0",
     "@hono/zod-openapi": "^1.5.1",
-    "@platformatic/kafka": "^2.6.1",
+    "@platformatic/kafka": "^2.8.0",
     "@socket.io/redis-adapter": "^8.3.0",
     "@socket.io/redis-emitter": "^5.1.0",
     "@types/bun": "^1.3.14",