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

package/dist/cjs/modules/worker-thread/{base.js → worker/base.js}

@@ -1,14 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseWorkerThreadHelper = exports.AbstractWorkerThreadHelper = exports.BaseWorkerHelper = exports.AbstractWorkerHelper = void 0;
-const promise_utility_1 = require("../../utilities/promise.utility");
+exports.BaseWorkerHelper = void 0;
+const promise_utility_1 = require("../../../utilities/promise.utility");
 const node_worker_threads_1 = require("node:worker_threads");
-const base_1 = require("../../modules/base");
-const error_1 = require("../../modules/error");
-class AbstractWorkerHelper extends base_1.BaseHelper {
-}
-exports.AbstractWorkerHelper = AbstractWorkerHelper;
-class BaseWorkerHelper extends AbstractWorkerHelper {
+const error_1 = require("../../error");
+const abstract_1 = require("./abstract");
+class BaseWorkerHelper extends abstract_1.AbstractWorkerHelper {
     constructor(opts) {
         super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });
         this.worker = new node_worker_threads_1.Worker(opts.path, opts.options);
@@ -103,52 +100,4 @@ class BaseWorkerHelper extends AbstractWorkerHelper {
     }
 }
 exports.BaseWorkerHelper = BaseWorkerHelper;
-class AbstractWorkerThreadHelper extends base_1.BaseHelper {
-}
-exports.AbstractWorkerThreadHelper = AbstractWorkerThreadHelper;
-class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
-    constructor(opts) {
-        const { scope } = opts;
-        super({ scope, identifier: scope });
-        if (node_worker_threads_1.isMainThread) {
-            throw (0, error_1.getError)({
-                message: '[BaseWorker] Cannot start worker in MAIN_THREAD',
-            });
-        }
-        this.buses = {};
-    }
-    bindWorkerBus(opts) {
-        if (!this.buses) {
-            this.buses = {};
-        }
-        const { key, bus } = opts;
-        if (this.buses[key]) {
-            this.logger.for(this.bindWorkerBus.name).warn('Worker Bus existed | key: %s', key);
-            return;
-        }
-        this.buses[key] = bus;
-    }
-    unbindWorkerBus(opts) {
-        if (!this.buses) {
-            return;
-        }
-        const { key } = opts;
-        if (!(key in this.buses)) {
-            this.logger.for(this.unbindWorkerBus.name).warn('Worker Bus not existed | key: %s', key);
-            return;
-        }
-        this.buses[key]?.port?.removeAllListeners();
-        delete this.buses[key];
-    }
-    getWorkerBus(opts) {
-        const rs = this.buses[opts.key];
-        if (!rs) {
-            throw (0, error_1.getError)({
-                message: `[getWorkerBus] Not found worker bus | key: ${opts.key}`,
-            });
-        }
-        return rs;
-    }
-}
-exports.BaseWorkerThreadHelper = BaseWorkerThreadHelper;
 //# sourceMappingURL=base.js.map

package/dist/cjs/modules/worker-thread/worker/base.js.map

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

package/dist/cjs/modules/worker-thread/worker/index.d.ts

@@ -0,0 +1,3 @@
+export * from './abstract';
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/worker-thread/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/dist/cjs/modules/worker-thread/worker/index.js

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

package/dist/cjs/modules/worker-thread/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB"}

package/dist/cjs/modules/worker-thread/worker-pool.d.ts

@@ -1,5 +1,5 @@
-import { BaseHelper } from '../../modules/base';
-import { IWorker } from './types';
+import { BaseHelper } from '../base';
+import { IWorker } from './common';
 export declare class WorkerPoolHelper extends BaseHelper {
     private static instance;
     protected registry: Map<string | symbol, IWorker<any>>;

package/dist/cjs/modules/worker-thread/worker-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IASjD,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAQtC,IAAI;IAIJ,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS;IAGxE,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAIzB,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE;IAmCnE,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CA0BvC"}
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IASjD,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAQtC,IAAI;IAIJ,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS;IAGxE,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAIzB,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE;IAmCnE,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CA0BvC"}

package/dist/cjs/modules/worker-thread/worker-pool.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerPoolHelper = void 0;
-const base_1 = require("../../modules/base");
-const error_1 = require("../../modules/error");
+const base_1 = require("../base");
+const error_1 = require("../error");
 const node_os_1 = __importDefault(require("node:os"));
 class WorkerPoolHelper extends base_1.BaseHelper {
     constructor(opts) {

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,9 +1,8 @@
-export * from './crypto.utility';
+export * from './build-info.utility';
 export * from './date.utility';
 export * from './module.utility';
 export * from './parse.utility';
 export * from './performance.utility';
 export * from './promise.utility';
 export * from './request.utility';
-export * from './retry.utility';
 //# sourceMappingURL=index.d.ts.map

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,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,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,12 +14,11 @@ 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("./crypto.utility"), exports);
+__exportStar(require("./build-info.utility"), exports);
 __exportStar(require("./date.utility"), exports);
 __exportStar(require("./module.utility"), exports);
 __exportStar(require("./parse.utility"), exports);
 __exportStar(require("./performance.utility"), exports);
 __exportStar(require("./promise.utility"), exports);
 __exportStar(require("./request.utility"), exports);
-__exportStar(require("./retry.utility"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,iDAA+B;AAC/B,mDAAiC;AACjC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC;AAClC,oDAAkC;AAClC,kDAAgC"}
+{"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/cjs/utilities/module.utility.d.ts

@@ -1,9 +1,15 @@
 import type { AnyType } from '../common/types';
 /** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */
 export declare class ModuleUtility {
-    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. */
+    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */
     private static readonly registered;
-    /** Resolves peers against the APP's node_modules, not this package's own `dist/` location. */
+    private static sharedRegistry;
+    /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */
+    static setProjectRoot(opts: {
+        projectRoot: string;
+    }): void;
+    static getProjectRoot(): string;
+    /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */
     private static appRequire;
     private static fail;
     /**

package/dist/cjs/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;;;;;;;;;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"}
+{"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;AAO9C,4LAA4L;AAC5L,qBAAa,aAAa;IACxB,0RAA0R;IAC1R,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAwD;IAE1F,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,0PAA0P;IAC1P,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI1D,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B,uHAAuH;IACvH,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/cjs/utilities/module.utility.js

@@ -8,14 +8,32 @@ const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
 const logger_1 = require("../modules/logger");
 const error_1 = require("../modules/error");
+const project_root_utility_1 = require("./project-root.utility");
 const logger = logger_1.LoggerFactory.getLogger(['ModuleUtility']);
 /** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */
 class ModuleUtility {
-    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. */
-    static { this.registered = new Map(); }
-    /** Resolves peers against the APP's node_modules, not this package's own `dist/` location. */
+    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */
+    static { this.registered = ModuleUtility.sharedRegistry(); }
+    static sharedRegistry() {
+        const slot = Symbol.for('ignis:module-registry');
+        const shared = Reflect.get(globalThis, slot);
+        if (shared) {
+            return shared;
+        }
+        const created = new Map();
+        Reflect.set(globalThis, slot, created);
+        return created;
+    }
+    /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */
+    static setProjectRoot(opts) {
+        project_root_utility_1.ProjectRootRegistry.set(opts);
+    }
+    static getProjectRoot() {
+        return project_root_utility_1.ProjectRootRegistry.getShared() ?? process.cwd();
+    }
+    /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */
     static appRequire() {
-        return (0, node_module_1.createRequire)(node_path_1.default.join(process.cwd(), 'node_modules'));
+        return (0, node_module_1.createRequire)(node_path_1.default.join(this.getProjectRoot(), 'node_modules'));
     }
     static fail(opts) {
         const { method, module, error, scope } = opts;

package/dist/cjs/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/dist/cjs/utilities/project-root.utility.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `globalThis` slot an application's project root lives in, shared across every copy of this
+ * package - a process (or a compiled bundle) can carry two, and a root set through one copy must be
+ * found by the other. No Node import here on purpose: `ModuleUtility` delegates to this file, and so
+ * does a browser Worker host through the `/core` sub-path - either would bundle a module-level Node
+ * specifier straight into a host that cannot resolve it.
+ */
+export declare class ProjectRootRegistry {
+    private static readonly SLOT;
+    /** Called by an application once it knows its root; every peer lookup that follows resolves against it. */
+    static set(opts: {
+        projectRoot: string;
+    }): void;
+    /** The shared root, or `undefined` until an application sets it - never a `process.cwd()` fallback here, so a host with no `process` never needs one. */
+    static getShared(): string | undefined;
+}
+//# sourceMappingURL=project-root.utility.d.ts.map

package/dist/cjs/utilities/project-root.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/project-root.utility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAoC;IAEhE,2GAA2G;IAC3G,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI/C,yJAAyJ;IACzJ,MAAM,CAAC,SAAS,IAAI,MAAM,GAAG,SAAS;CAGvC"}

package/dist/cjs/utilities/project-root.utility.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectRootRegistry = void 0;
+/**
+ * The `globalThis` slot an application's project root lives in, shared across every copy of this
+ * package - a process (or a compiled bundle) can carry two, and a root set through one copy must be
+ * found by the other. No Node import here on purpose: `ModuleUtility` delegates to this file, and so
+ * does a browser Worker host through the `/core` sub-path - either would bundle a module-level Node
+ * specifier straight into a host that cannot resolve it.
+ */
+class ProjectRootRegistry {
+    static { this.SLOT = Symbol.for('ignis:project-root'); }
+    /** Called by an application once it knows its root; every peer lookup that follows resolves against it. */
+    static set(opts) {
+        Reflect.set(globalThis, this.SLOT, opts.projectRoot);
+    }
+    /** The shared root, or `undefined` until an application sets it - never a `process.cwd()` fallback here, so a host with no `process` never needs one. */
+    static getShared() {
+        return Reflect.get(globalThis, this.SLOT);
+    }
+}
+exports.ProjectRootRegistry = ProjectRootRegistry;
+//# sourceMappingURL=project-root.utility.js.map

package/dist/cjs/utilities/project-root.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.utility.js","sourceRoot":"","sources":["../../../src/utilities/project-root.utility.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,mBAAmB;aACN,SAAI,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAEhE,2GAA2G;IAC3G,MAAM,CAAC,GAAG,CAAC,IAA6B;QACtC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,yJAAyJ;IACzJ,MAAM,CAAC,SAAS;QACd,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;;AAXH,kDAYC"}

package/dist/esm/common/constants/app.d.ts

@@ -1,4 +1,4 @@
-import { TConstValue } from '../types.js';
+import { TConstValue } from '../types/index.js';
 export declare class Defaults {
     static readonly APPLICATION_NAME: string;
     static readonly QUERY_LIMIT = 50;

package/dist/esm/common/constants/duration.d.ts

@@ -1,4 +1,4 @@
-import { TConstValue } from '../types.js';
+import { TConstValue } from '../types/index.js';
 /** The time units a duration can be expressed in, smallest first. */
 export declare class DurationUnits {
     static readonly MILLISECOND = "millisecond";

package/dist/esm/common/constants/grpc.d.ts

@@ -1,4 +1,4 @@
-import { ValueOf } from '../types.js';
+import { ValueOf } from '../types/index.js';
 export declare class GRPC {
     /** Standard gRPC methods (lowercase). */
     static readonly Methods: {

package/dist/esm/common/constants/http.d.ts

@@ -1,4 +1,4 @@
-import { ValueOf } from '../types.js';
+import { ValueOf } from '../types/index.js';
 export declare class HTTP {
     /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */
     static readonly Headers: {

package/dist/esm/common/constants/mime.d.ts

@@ -1,9 +1,76 @@
-import { TConstValue } from '../types.js';
+import { TConstValue } from '../types/index.js';
 export declare class MimeTypes {
     static readonly UNKNOWN = "unknown";
     static readonly IMAGE = "image";
     static readonly VIDEO = "video";
     static readonly TEXT = "text";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
 }
 export type TMimeTypes = TConstValue<typeof MimeTypes>;
+/** The leading dot is part of the value: `path.extname` returns one. */
+export declare class FileExtensions {
+    static readonly PNG = ".png";
+    static readonly JPG = ".jpg";
+    static readonly JPEG = ".jpeg";
+    static readonly GIF = ".gif";
+    static readonly WEBP = ".webp";
+    static readonly SVG = ".svg";
+    static readonly PDF = ".pdf";
+    static readonly JSON = ".json";
+    static readonly TXT = ".txt";
+    static readonly HTML = ".html";
+    static readonly CSS = ".css";
+    static readonly JS = ".js";
+    static readonly MP4 = ".mp4";
+    static readonly WEBM = ".webm";
+    static readonly MP3 = ".mp3";
+    static readonly WAV = ".wav";
+    static readonly ZIP = ".zip";
+    static readonly CSV = ".csv";
+    static readonly XML = ".xml";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TFileExtension = TConstValue<typeof FileExtensions>;
+/** Full content types, as they go on the wire. `MimeTypes` holds only the top-level part. */
+export declare class ContentTypes {
+    static readonly OCTET_STREAM = "application/octet-stream";
+    static readonly PNG = "image/png";
+    static readonly JPEG = "image/jpeg";
+    static readonly GIF = "image/gif";
+    static readonly WEBP = "image/webp";
+    static readonly SVG = "image/svg+xml";
+    static readonly PDF = "application/pdf";
+    static readonly JSON = "application/json";
+    static readonly PLAIN_TEXT = "text/plain";
+    static readonly HTML = "text/html";
+    static readonly CSS = "text/css";
+    static readonly JAVASCRIPT = "text/javascript";
+    static readonly MP4 = "video/mp4";
+    static readonly WEBM = "video/webm";
+    static readonly MPEG_AUDIO = "audio/mpeg";
+    static readonly WAV = "audio/wav";
+    static readonly ZIP = "application/zip";
+    static readonly CSV = "text/csv";
+    static readonly XML = "application/xml";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TContentType = TConstValue<typeof ContentTypes>;
+/** The extension table and the lookup that reads it, together - the `DurationMultipliers` shape. */
+export declare class ContentTypeTable {
+    /** `satisfies` makes the table total; the declared `string` key keeps a lookup cast-free. */
+    static readonly BY_EXTENSION: Readonly<Partial<Record<string, TContentType>>>;
+    /**
+     * The content type an object name implies. `node:path` is deliberately not used: this file is
+     * reachable from the browser-pure `./common` subpath, and an extension is the tail after the last
+     * dot either way.
+     */
+    static resolve(opts: {
+        filename: string;
+    }): TContentType;
+}
+/** Published before the table moved onto the class; kept as the one-line delegate it now is. */
+export declare const CONTENT_TYPE_BY_EXTENSION: Readonly<Partial<Record<string, TContentType>>>;
 //# sourceMappingURL=mime.d.ts.map

package/dist/esm/common/constants/mime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/mime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;CAC/B;AACD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC"}
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/mime.ts"],"names":[],"mappings":"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"}