@venizia/ignis-helpers 0.2.0-8 → 0.2.0

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/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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"}

package/dist/esm/common/constants/mime.js

@@ -3,5 +3,139 @@ export class MimeTypes {
     static { this.IMAGE = 'image'; }
     static { this.VIDEO = 'video'; }
     static { this.TEXT = 'text'; }
+    static { this.SCHEME_SET = new Set([this.UNKNOWN, this.IMAGE, this.VIDEO, this.TEXT]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
 }
+/** The leading dot is part of the value: `path.extname` returns one. */
+export class FileExtensions {
+    static { this.PNG = '.png'; }
+    static { this.JPG = '.jpg'; }
+    static { this.JPEG = '.jpeg'; }
+    static { this.GIF = '.gif'; }
+    static { this.WEBP = '.webp'; }
+    static { this.SVG = '.svg'; }
+    static { this.PDF = '.pdf'; }
+    static { this.JSON = '.json'; }
+    static { this.TXT = '.txt'; }
+    static { this.HTML = '.html'; }
+    static { this.CSS = '.css'; }
+    static { this.JS = '.js'; }
+    static { this.MP4 = '.mp4'; }
+    static { this.WEBM = '.webm'; }
+    static { this.MP3 = '.mp3'; }
+    static { this.WAV = '.wav'; }
+    static { this.ZIP = '.zip'; }
+    static { this.CSV = '.csv'; }
+    static { this.XML = '.xml'; }
+    static { this.SCHEME_SET = new Set([
+        this.PNG,
+        this.JPG,
+        this.JPEG,
+        this.GIF,
+        this.WEBP,
+        this.SVG,
+        this.PDF,
+        this.JSON,
+        this.TXT,
+        this.HTML,
+        this.CSS,
+        this.JS,
+        this.MP4,
+        this.WEBM,
+        this.MP3,
+        this.WAV,
+        this.ZIP,
+        this.CSV,
+        this.XML,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** Full content types, as they go on the wire. `MimeTypes` holds only the top-level part. */
+export class ContentTypes {
+    static { this.OCTET_STREAM = 'application/octet-stream'; }
+    static { this.PNG = 'image/png'; }
+    static { this.JPEG = 'image/jpeg'; }
+    static { this.GIF = 'image/gif'; }
+    static { this.WEBP = 'image/webp'; }
+    static { this.SVG = 'image/svg+xml'; }
+    static { this.PDF = 'application/pdf'; }
+    static { this.JSON = 'application/json'; }
+    static { this.PLAIN_TEXT = 'text/plain'; }
+    static { this.HTML = 'text/html'; }
+    static { this.CSS = 'text/css'; }
+    static { this.JAVASCRIPT = 'text/javascript'; }
+    static { this.MP4 = 'video/mp4'; }
+    static { this.WEBM = 'video/webm'; }
+    static { this.MPEG_AUDIO = 'audio/mpeg'; }
+    static { this.WAV = 'audio/wav'; }
+    static { this.ZIP = 'application/zip'; }
+    static { this.CSV = 'text/csv'; }
+    static { this.XML = 'application/xml'; }
+    static { this.SCHEME_SET = new Set([
+        this.OCTET_STREAM,
+        this.PNG,
+        this.JPEG,
+        this.GIF,
+        this.WEBP,
+        this.SVG,
+        this.PDF,
+        this.JSON,
+        this.PLAIN_TEXT,
+        this.HTML,
+        this.CSS,
+        this.JAVASCRIPT,
+        this.MP4,
+        this.WEBM,
+        this.MPEG_AUDIO,
+        this.WAV,
+        this.ZIP,
+        this.CSV,
+        this.XML,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** The extension table and the lookup that reads it, together - the `DurationMultipliers` shape. */
+export class ContentTypeTable {
+    /** `satisfies` makes the table total; the declared `string` key keeps a lookup cast-free. */
+    static { this.BY_EXTENSION = {
+        [FileExtensions.PNG]: ContentTypes.PNG,
+        [FileExtensions.JPG]: ContentTypes.JPEG,
+        [FileExtensions.JPEG]: ContentTypes.JPEG,
+        [FileExtensions.GIF]: ContentTypes.GIF,
+        [FileExtensions.WEBP]: ContentTypes.WEBP,
+        [FileExtensions.SVG]: ContentTypes.SVG,
+        [FileExtensions.PDF]: ContentTypes.PDF,
+        [FileExtensions.JSON]: ContentTypes.JSON,
+        [FileExtensions.TXT]: ContentTypes.PLAIN_TEXT,
+        [FileExtensions.HTML]: ContentTypes.HTML,
+        [FileExtensions.CSS]: ContentTypes.CSS,
+        [FileExtensions.JS]: ContentTypes.JAVASCRIPT,
+        [FileExtensions.MP4]: ContentTypes.MP4,
+        [FileExtensions.WEBM]: ContentTypes.WEBM,
+        [FileExtensions.MP3]: ContentTypes.MPEG_AUDIO,
+        [FileExtensions.WAV]: ContentTypes.WAV,
+        [FileExtensions.ZIP]: ContentTypes.ZIP,
+        [FileExtensions.CSV]: ContentTypes.CSV,
+        [FileExtensions.XML]: ContentTypes.XML,
+    }; }
+    /**
+     * 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) {
+        const { filename } = opts;
+        const lastDot = filename.lastIndexOf('.');
+        const extension = lastDot === -1 ? '' : filename.slice(lastDot).toLowerCase();
+        return this.BY_EXTENSION[extension] ?? ContentTypes.OCTET_STREAM;
+    }
+}
+/** Published before the table moved onto the class; kept as the one-line delegate it now is. */
+export const CONTENT_TYPE_BY_EXTENSION = ContentTypeTable.BY_EXTENSION;
 //# sourceMappingURL=mime.js.map

package/dist/esm/common/constants/mime.js.map

@@ -1 +1 @@
-{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../../src/common/constants/mime.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAS;aACJ,YAAO,GAAG,SAAS,CAAC;aACpB,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC"}
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../../src/common/constants/mime.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 export * from './constants/index.js';
 export * from './redact.js';
-export * from './types.js';
+export * from './resolvers.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/esm/common/index.js

@@ -1,4 +1,5 @@
 export * from './constants/index.js';
 export * from './redact.js';
-export * from './types.js';
+export * from './resolvers.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/esm/common/redact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/common/redact.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,QAAQ,eAAe,CAAC;AA4ErC;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,OAAO,OAAO,CAAC,MAAM,CAAC,EACtB,QAAO,MAAiB,KACvB,OAUF,CAAC;AAEF,4dAA4d;AAC5d,eAAO,MAAM,UAAU,GAAI,MAAM;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAMrE,CAAC;AAEF,sPAAsP;AACtP,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAmBlD,CAAC"}
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/common/redact.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,QAAQ,eAAe,CAAC;AA4HrC;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,OAAO,OAAO,CAAC,MAAM,CAAC,EACtB,QAAO,MAAiB,KACvB,OAWF,CAAC;AAEF,4dAA4d;AAC5d,eAAO,MAAM,UAAU,GAAI,MAAM;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OASrE,CAAC;AAEF,sPAAsP;AACtP,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAmBlD,CAAC"}