@venizia/ignis-helpers 0.2.0-9 → 0.2.0

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

@@ -8,21 +8,39 @@ 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;
         const reason = error instanceof Error ? error.message : String(error);
         logger.for(method).error("Failed to load '%s' | Error: %s", module, reason);
         return (0, error_1.getError)({
-            message: `[ModuleUtility.${method}] ${module} is required${scope ? ` for ${scope}` : ''}. Please install '${module}' | Error: ${reason}`,
+            message: `[ModuleUtility.${method}] ${module} is required, resolved from ${this.getProjectRoot()}${scope ? ` for ${scope}` : ''}. Please install '${module}' | Error: ${reason}`,
         });
     }
     /**
@@ -36,7 +54,8 @@ class ModuleUtility {
      * module after the first.
      */
     static register(opts) {
-        for (const [module, value] of Object.entries(opts.modules)) {
+        const modulesEntries = Object.entries(opts.modules);
+        for (const [module, value] of modulesEntries) {
             this.registered.set(module, value);
         }
     }

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":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAE7B,6CAAiD;AACjD,2CAA2C;AAC3C,iEAA6D;AAE7D,MAAM,MAAM,GAAG,sBAAa,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AAE1D,4LAA4L;AAC5L,MAAa,aAAa;IACxB,0RAA0R;aAClQ,eAAU,GAAyB,aAAa,CAAC,cAAc,EAAE,CAAC;IAElF,MAAM,CAAC,cAAc;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACjD,MAAM,MAAM,GAAqC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAEvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0PAA0P;IAC1P,MAAM,CAAC,cAAc,CAAC,IAA6B;QACjD,0CAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,cAAc;QACnB,OAAO,0CAAmB,CAAC,SAAS,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1D,CAAC;IAED,uHAAuH;IAC/G,MAAM,CAAC,UAAU;QACvB,OAAO,IAAA,2BAAa,EAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACzE,CAAC;IAEO,MAAM,CAAC,IAAI,CAAC,IAAwE;QAC1F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,iCAAiC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAE5E,OAAO,IAAA,gBAAQ,EAAC;YACd,OAAO,EAAE,kBAAkB,MAAM,KAAK,MAAM,+BAA+B,IAAI,CAAC,cAAc,EAAE,GAC9F,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAC5B,qBAAqB,MAAM,cAAc,MAAM,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA0C;QACxD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAc,IAAwB;QACrD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAM,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAM,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAc,IAAwB;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAM,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAM,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,IAItB;QACC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;;AAtHH,sCAuHC"}

package/dist/cjs/utilities/parse.utility.d.ts

@@ -3,6 +3,21 @@ export declare const toCamel: (s: string) => string;
 export declare const keysToCamel: (object: object) => any;
 export declare const isInt: (n: any) => boolean;
 export declare const isFloat: (input: any) => boolean;
+/**
+ * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it
+ * cannot parse - `undefined`, `''`, `'abc'`.
+ *
+ * That makes `int(value) ?? fallback` dead code, because the left side is never nullish. The
+ * fallback belongs INSIDE the call, and for an environment read it belongs in the read itself:
+ *
+ * ```ts
+ * int(applicationEnvironment.get(KEY, { defaultValue: '6379' }))  // correct
+ * int(applicationEnvironment.get(KEY)) ?? 6379                    // always 0 when KEY is unset
+ * ```
+ *
+ * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which
+ * through `AbstractRedisHelper.buildRetryStrategy` means "give up after the first failure".
+ */
 export declare const int: (input: any) => number;
 export declare const float: (input: any, digit?: number) => number;
 export declare const toBoolean: (input: any) => boolean;
@@ -10,6 +25,20 @@ export declare const toBoolean: (input: any) => boolean;
 export declare const parseArrayToMapWithKey: <T extends Record<K, PropertyKey>, K extends keyof T>(arr: T[], keyMap: K) => Map<T[K], T>;
 /** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: toDelimitedArray })`). */
 export declare const toDelimitedArray: (input: unknown, separator?: string) => string[];
+/**
+ * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.
+ *
+ * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the
+ * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:
+ *
+ * ```ts
+ * process.env.APP_ENV_LOGGER_FORMAT ?? 'text'                    // '' when the line is blank
+ * blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text'  // 'text'
+ * ```
+ *
+ * Reach for this rather than `||`, which reads `'0'` as blank as well.
+ */
+export declare const blankToUndefined: (input: string | undefined) => string | undefined;
 /** Trims a possibly-undefined env value to a clean string ('' when absent). */
 export declare const toTrimmed: (input: unknown) => string;
 //# sourceMappingURL=parse.utility.d.ts.map

package/dist/cjs/utilities/parse.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM,cAA0D,CAAC;AAE9E,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAIhC,CAAC;AAoBF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,QASzC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,YAM3B,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,OAAO,GAAG,YAMjC,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,OAAO,GAAG,WAY7B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,GAAG,EAAE,cAAS,WAY1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,OAUtC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACxF,KAAK,CAAC,EAAE,EACR,QAAQ,CAAC,KACR,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAiBb,CAAC;AAEF,sLAAsL;AACtL,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,EAAE,kBAAe,KAAG,MAAM,EASxE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAM1C,CAAC"}
+{"version":3,"file":"parse.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,MAAM,cAA0D,CAAC;AAE9E,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAIhC,CAAC;AAqBF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,QASzC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,YAM3B,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,OAAO,GAAG,YAMjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,GAAG,GAAI,OAAO,GAAG,WAY7B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,GAAG,EAAE,cAAS,WAY1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,OAUtC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACxF,KAAK,CAAC,EAAE,EACR,QAAQ,CAAC,KACR,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAiBb,CAAC;AAEF,sLAAsL;AACtL,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,EAAE,kBAAe,KAAG,MAAM,EASxE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAGrE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAM1C,CAAC"}

package/dist/cjs/utilities/parse.utility.js

@@ -1,12 +1,26 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toTrimmed = exports.toDelimitedArray = exports.parseArrayToMapWithKey = exports.toBoolean = exports.float = exports.int = exports.isFloat = exports.isInt = exports.keysToCamel = exports.toCamel = exports.getUID = void 0;
+exports.toTrimmed = exports.blankToUndefined = exports.toDelimitedArray = exports.parseArrayToMapWithKey = exports.toBoolean = exports.float = exports.int = exports.isFloat = exports.isInt = exports.keysToCamel = exports.toCamel = exports.getUID = void 0;
 const error_1 = require("../modules/error");
-const get_1 = __importDefault(require("lodash/get"));
-const round_1 = __importDefault(require("lodash/round"));
+/**
+ * Rounds at a decimal precision, shifting the exponent rather than multiplying: `1.005` at 2 is
+ * `1.01` here, where `Math.round(1.005 * 100) / 100` gives `1`.
+ *
+ * Hand-written to keep lodash out of a browser bundle. One deliberate difference from `lodash/round`:
+ * a result of negative zero is normalised to `0`. They compare equal, stringify the same and
+ * serialise the same, so nothing downstream can tell - checked across 114 value/precision pairs, and
+ * the sign of zero was the only disagreement.
+ */
+const round = (opts) => {
+    const { value, precision = 0 } = opts;
+    if (!Number.isFinite(value) || precision === 0) {
+        return Math.round(value) + 0;
+    }
+    const [mantissa, exponent] = `${value}e`.split('e');
+    const shifted = Math.round(Number(`${mantissa}e${Number(exponent) + precision}`));
+    const [shiftedMantissa, shiftedExponent] = `${shifted}e`.split('e');
+    return Number(`${shiftedMantissa}e${Number(shiftedExponent) - precision}`) + 0;
+};
 const getUID = () => Math.random().toString(36).slice(2).toUpperCase();
 exports.getUID = getUID;
 const toCamel = (s) => {
@@ -24,8 +38,9 @@ const camelizeValue = (value) => {
         return value;
     }
     const camelized = {};
-    for (const key of Object.keys(value)) {
-        camelized[(0, exports.toCamel)(key)] = camelizeValue((0, get_1.default)(value, key));
+    const valueKeys = Object.keys(value);
+    for (const key of valueKeys) {
+        camelized[(0, exports.toCamel)(key)] = camelizeValue(value[key]);
     }
     return camelized;
 };
@@ -33,7 +48,7 @@ const keysToCamel = (object) => {
     const n = {};
     const keys = Object.keys(object);
     for (const key of keys) {
-        n[(0, exports.toCamel)(key)] = camelizeValue((0, get_1.default)(object, key));
+        n[(0, exports.toCamel)(key)] = camelizeValue(object[key]);
     }
     return n;
 };
@@ -52,6 +67,21 @@ const isFloat = (input) => {
     return Number(input) === input || Number(input) % 1 !== 0;
 };
 exports.isFloat = isFloat;
+/**
+ * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it
+ * cannot parse - `undefined`, `''`, `'abc'`.
+ *
+ * That makes `int(value) ?? fallback` dead code, because the left side is never nullish. The
+ * fallback belongs INSIDE the call, and for an environment read it belongs in the read itself:
+ *
+ * ```ts
+ * int(applicationEnvironment.get(KEY, { defaultValue: '6379' }))  // correct
+ * int(applicationEnvironment.get(KEY)) ?? 6379                    // always 0 when KEY is unset
+ * ```
+ *
+ * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which
+ * through `AbstractRedisHelper.buildRetryStrategy` means "give up after the first failure".
+ */
 const int = (input) => {
     if (!input) {
         return 0;
@@ -72,7 +102,7 @@ const float = (input, digit = 2) => {
     if (isNaN(normalized)) {
         return 0;
     }
-    const parsed = (0, round_1.default)(Number.parseFloat(normalized), digit);
+    const parsed = round({ value: Number.parseFloat(normalized), precision: digit });
     return Number.isNaN(parsed) ? 0 : parsed;
 };
 exports.float = float;
@@ -114,6 +144,24 @@ const toDelimitedArray = (input, separator = ',') => {
         .filter(entry => entry.length > 0);
 };
 exports.toDelimitedArray = toDelimitedArray;
+/**
+ * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.
+ *
+ * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the
+ * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:
+ *
+ * ```ts
+ * process.env.APP_ENV_LOGGER_FORMAT ?? 'text'                    // '' when the line is blank
+ * blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text'  // 'text'
+ * ```
+ *
+ * Reach for this rather than `||`, which reads `'0'` as blank as well.
+ */
+const blankToUndefined = (input) => {
+    const trimmed = input?.trim();
+    return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;
+};
+exports.blankToUndefined = blankToUndefined;
 /** Trims a possibly-undefined env value to a clean string ('' when absent). */
 const toTrimmed = (input) => {
     if (input == null) {

package/dist/cjs/utilities/parse.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":";;;AAAA,2CAA2C;AAE3C;;;;;;;;GAQG;AACH,MAAM,KAAK,GAAG,CAAC,IAA2C,EAAU,EAAE;IACpE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAEtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC,GAAG,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC,CAAC;AAEK,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAAjE,QAAA,MAAM,UAA2D;AAEvE,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,GAAW,EAAE,EAAE;QAChD,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB;AAEF,gMAAgM;AAChM,MAAM,aAAa,GAAG,CAAC,KAAc,EAAW,EAAE;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAQ,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,SAAS,CAAC,IAAA,eAAO,EAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEK,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,EAAE;IAC5C,MAAM,CAAC,GAAQ,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,IAAA,eAAO,EAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAE,MAAkC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AATW,QAAA,WAAW,eAStB;AAEK,MAAM,KAAK,GAAG,CAAC,CAAM,EAAE,EAAE;IAC9B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC,CAAC;AANW,QAAA,KAAK,SAMhB;AAEK,MAAM,OAAO,GAAG,CAAC,KAAU,EAAE,EAAE;IACpC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC;AANW,QAAA,OAAO,WAMlB;AAEF;;;;;;;;;;;;;;GAcG;AACI,MAAM,GAAG,GAAG,CAAC,KAAU,EAAE,EAAE;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC,CAAC;AAZW,QAAA,GAAG,OAYd;AAEK,MAAM,KAAK,GAAG,CAAC,KAAU,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC,CAAC;AAZW,QAAA,KAAK,SAYhB;AAEK,MAAM,SAAS,GAAG,CAAC,KAAU,EAAW,EAAE;IAC/C,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,KAAK;QACf,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,SAAS,CACpB,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,SAAS,aAUpB;AAEF,yFAAyF;AAClF,MAAM,sBAAsB,GAAG,CACpC,GAAQ,EACR,MAAS,EACK,EAAE;IAChB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAW,CAAC;IAErC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACpB,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,gBAAgB;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AApBW,QAAA,sBAAsB,0BAoBjC;AAEF,sLAAsL;AAC/K,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,SAAS,GAAG,GAAG,EAAY,EAAE;IAC5E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC;SACjB,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAChF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7E,CAAC,CAAC;AAHW,QAAA,gBAAgB,oBAG3B;AAEF,+EAA+E;AACxE,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE;IAClD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB"}

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/cjs/utilities/request.utility.d.ts

@@ -23,11 +23,16 @@ interface IParsedFile {
     filename?: string;
     path?: string;
 }
+/** Files and the text fields posted beside them - dropping the second silently loses what the client sent. */
+export interface IParsedMultipartBody {
+    files: IParsedFile[];
+    fields: Record<string, string>;
+}
 export declare const parseMultipartBody: <C extends {
     req: any;
 } = {
     req: any;
-}>(opts: IParseMultipartOptions<C>) => Promise<IParsedFile[]>;
+}>(opts: IParseMultipartOptions<C>) => Promise<IParsedMultipartBody>;
 /** Sanitizes a filename by removing path components and dangerous characters. */
 export declare const sanitizeFilename: (filename: string) => string;
 export declare const encodeRFC5987: (filename: string) => string;
@@ -35,5 +40,21 @@ export declare const createContentDispositionHeader: (opts: {
     filename: string;
     type: "attachment" | "inline";
 }) => string;
+/**
+ * Reads a filename out of a `Content-Disposition` value.
+ *
+ * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,
+ * and the one hand-rolled parsers miss), a quoted `filename="..."`, and a bare `filename=...`.
+ * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in
+ * a product with non-English filenames is most of them.
+ *
+ * The pair of {@link createContentDispositionHeader}: one writes the header, this one reads it.
+ */
+export declare const parseContentDisposition: (opts: {
+    header: string | null | undefined;
+}) => {
+    type?: string;
+    filename?: string;
+};
 export {};
 //# sourceMappingURL=request.utility.d.ts.map

package/dist/cjs/utilities/request.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,EAC5E,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,WAAW,EAAE,CAyDvB,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAUnD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAIhD,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,MAAM;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC/B,KAAG,MAOH,CAAC"}
+{"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8GAA8G;AAC9G,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,EAC5E,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,oBAAoB,CA6D9B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAUnD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAIhD,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,MAAM;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC/B,KAAG,MAOH,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC,KAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CA8BrC,CAAC"}

package/dist/cjs/utilities/request.utility.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createContentDispositionHeader = exports.encodeRFC5987 = exports.sanitizeFilename = exports.parseMultipartBody = void 0;
+exports.parseContentDisposition = exports.createContentDispositionHeader = exports.encodeRFC5987 = exports.sanitizeFilename = exports.parseMultipartBody = void 0;
 const error_1 = require("../modules/error");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -14,8 +14,12 @@ const parseMultipartBody = async (opts) => {
     }
     const formData = await context.req.formData();
     const files = [];
-    for (const [fieldname, value] of formData.entries()) {
+    const fields = {};
+    const entries = formData.entries();
+    for (const [fieldname, value] of entries) {
         if (typeof value === 'string') {
+            // Last one wins, like a repeated query parameter.
+            fields[fieldname] = value;
             continue;
         }
         const file = value;
@@ -53,7 +57,7 @@ const parseMultipartBody = async (opts) => {
         }
         files.push(parsedFile);
     }
-    return files;
+    return { files, fields };
 };
 exports.parseMultipartBody = parseMultipartBody;
 /** Sanitizes a filename by removing path components and dangerous characters. */
@@ -83,4 +87,41 @@ const createContentDispositionHeader = (opts) => {
     return `${type}; filename="${sanitized}"; filename*=UTF-8''${encoded}`;
 };
 exports.createContentDispositionHeader = createContentDispositionHeader;
+/**
+ * Reads a filename out of a `Content-Disposition` value.
+ *
+ * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,
+ * and the one hand-rolled parsers miss), a quoted `filename="..."`, and a bare `filename=...`.
+ * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in
+ * a product with non-English filenames is most of them.
+ *
+ * The pair of {@link createContentDispositionHeader}: one writes the header, this one reads it.
+ */
+const parseContentDisposition = (opts) => {
+    const { header } = opts;
+    if (!header) {
+        return {};
+    }
+    const type = header.split(';')[0]?.trim() || undefined;
+    // `filename*` wins when both are present - it is the one that can carry a non-ASCII name.
+    const extended = header.match(/filename\*\s*=\s*([^;]+)/i);
+    if (extended) {
+        const value = extended[1].trim();
+        // `UTF-8''name` or `UTF-8'lang'name`; anything before the last quote is charset and language.
+        const encoded = value.slice(value.lastIndexOf("'") + 1);
+        try {
+            return { type, filename: decodeURIComponent(encoded) };
+        }
+        catch {
+            // A malformed sequence is not worth failing a download over - fall through to `filename`.
+        }
+    }
+    const quoted = header.match(/filename\s*=\s*"([^"]*)"/i);
+    if (quoted) {
+        return { type, filename: quoted[1] };
+    }
+    const bare = header.match(/filename\s*=\s*([^;]+)/i);
+    return { type, filename: bare ? bare[1].trim() : undefined };
+};
+exports.parseContentDisposition = parseContentDisposition;
 //# sourceMappingURL=request.utility.js.map

package/dist/cjs/utilities/request.utility.js.map

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

package/dist/cjs/utilities/sleep.utility.d.ts

@@ -1,3 +1,2 @@
-/** Split out of `date.utility.ts` - that module reads `process.env` at load time (dayjs timezone default), which would drag a node global into any bundle that only wants this one timer primitive. */
 export declare const sleep: (ms: number) => Promise<unknown>;
 //# sourceMappingURL=sleep.utility.d.ts.map

package/dist/cjs/utilities/sleep.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sleep.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":"AAAA,uMAAuM;AACvM,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAE/B,CAAC"}
+{"version":3,"file":"sleep.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAE/B,CAAC"}

package/dist/cjs/utilities/sleep.utility.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sleep = void 0;
-/** Split out of `date.utility.ts` - that module reads `process.env` at load time (dayjs timezone default), which would drag a node global into any bundle that only wants this one timer primitive. */
 const sleep = (ms) => {
     return new Promise(resolve => setTimeout(resolve, ms));
 };

package/dist/cjs/utilities/sleep.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"sleep.utility.js","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":";;;AAAA,uMAAuM;AAChM,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB"}
+{"version":3,"file":"sleep.utility.js","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":";;;AAAO,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB"}

package/dist/cjs/uuid.d.ts

@@ -0,0 +1,2 @@
+export * from './modules/uid/uuid';
+//# sourceMappingURL=uuid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/uuid.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC"}

package/dist/cjs/uuid.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 });
+// The UUID primitives alone, for a browser bundle that wants an id and nothing else.
+__exportStar(require("./modules/uid/uuid"), exports);
+//# sourceMappingURL=uuid.js.map

package/dist/cjs/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/uuid.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qFAAqF;AACrF,qDAAmC"}

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

@@ -4,6 +4,73 @@ export declare class MimeTypes {
     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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"}