@zintrust/core 0.1.40 → 0.1.42

package/src/helper/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Lightweight validation / type helper utilities used across the codebase.
+ * Keep implementations small and dependency-free so they work in both
+ * Node and Cloudflare Worker runtimes.
+ */
+/** Check whether value is a string primitive */
+export declare const isString: (value: unknown) => value is string;
+/** Check whether value is an array */
+export declare const isArray: (value: unknown) => value is unknown[];
+/** Check whether value is an object (and not null/array) */
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+/** Check whether value is a function */
+export declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+/** Check whether value is a valid Date object */
+export declare const isDate: (value: unknown) => value is Date;
+/**
+ * Check if value is "empty".
+ * Matches legacy behavior: null, undefined, false, 0, '', '0' are all considered empty.
+ */
+export declare const isEmpty: (value: unknown) => boolean;
+/** Check if value is null or string 'null'/'NULL' or empty string */
+export declare const isNull: (value: unknown) => boolean;
+/** Check if value is undefined */
+export declare const isUndefined: (value: unknown) => boolean;
+/** Check if value is undefined or satisfies isNull() */
+export declare const isUndefinedOrNull: (value: unknown) => boolean;
+/**
+ * Check whether value is a boolean primitive.
+ */
+export declare function isBoolean(value: unknown, allowString?: false): value is boolean;
+/**
+ * Check whether value is a boolean primitive OR a boolean-like string.
+ */
+export declare function isBoolean(value: unknown, allowString: true): value is boolean | string;
+/** Check if value is a string representation of a boolean (true/false/1/0) */
+export declare const isBooleanString: (value: unknown) => boolean;
+/** Check if value is a valid number or numeric string */
+export declare const isNumeric: (value: unknown) => boolean;
+/**
+ * Check if value is an integer.
+ */
+export declare function isInt(value: unknown, allowString?: false, conditions?: {
+    min?: number;
+    max?: number;
+}): value is number;
+/**
+ * Check if value is an integer OR a string representing an integer.
+ */
+export declare function isInt(value: unknown, allowString: true, conditions?: {
+    min?: number;
+    max?: number;
+}): value is number | string;
+/**
+ * Check if value is a float (finite number).
+ */
+export declare function isFloat(value: unknown, allowString?: false, conditions?: {
+    min?: number;
+    max?: number;
+}): value is number;
+/**
+ * Check if value is a float OR a string representing a float.
+ */
+export declare function isFloat(value: unknown, allowString: true, conditions?: {
+    min?: number;
+    max?: number;
+}): value is number | string;
+/** Check if value is a valid integer string (supports min/max) */
+export declare const isIntString: (value: unknown, conditions?: {
+    min?: number;
+    max?: number;
+}) => boolean;
+/** Check if value is a valid float string (supports min/max) */
+export declare const isFloatString: (value: unknown, conditions?: {
+    min?: number;
+    max?: number;
+}) => boolean;
+/** Check if value is a valid email string */
+export declare const isEmail: (value: unknown) => boolean;
+/** Check if value is a valid URL string (http/https) */
+export declare const isUrl: (value: unknown) => boolean;
+/** Check if string contains only letters */
+export declare const isAlpha: (value: unknown) => boolean;
+/** Check if string contains only letters and numbers */
+export declare const isAlphanumeric: (value: unknown) => boolean;
+/**
+ * Check if string matches regex.
+ *
+ * Security/perf: Regex evaluation can be expensive for some patterns.
+ * This helper defensively caps the input length to reduce ReDoS risk
+ * when used on untrusted strings.
+ */
+export declare const isMatch: (value: unknown, regex: RegExp, options?: {
+    maxLength?: number;
+}) => boolean;
+/** Check if value exists in array */
+export declare const isIn: (value: unknown, array: unknown[]) => boolean;
+/** Check if value does not exist in array */
+export declare const isNotIn: (value: unknown, array: unknown[]) => boolean;
+/** Check if string or array has exact length */
+export declare const isLength: (value: unknown, length: number) => boolean;
+/** Check if string or array has minimum length */
+export declare const isMinLength: (value: unknown, min: number) => boolean;
+/** Check if string or array has maximum length */
+export declare const isMaxLength: (value: unknown, max: number) => boolean;
+/** Check if value is a string with length > 0 (after trim) */
+export declare const isNonEmptyString: (value: unknown) => value is string;
+/** Check if value is an array with items */
+export declare const isNonEmptyArray: (value: unknown) => value is unknown[];
+/** Check if value is an object with keys */
+export declare const isNonEmptyObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Check if value is a string containing only whitespace.
+ * Useful for distinguishing between truly empty and whitespace-only strings.
+ */
+export declare const isWhitespaceOnly: (value: unknown) => boolean;
+/**
+ * Check if value is a valid UUID v4 string.
+ * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export declare const isUUID: (value: unknown) => boolean;
+/**
+ * Check if value is a valid JSON string (parses without error).
+ */
+export declare const isJSON: (value: unknown) => boolean;
+/**
+ * Check if value is a valid Base64-encoded string.
+ */
+export declare const isBase64: (value: unknown) => boolean;
+/**
+ * Check if value is a valid hexadecimal color string.
+ * Accepts #RGB, #RGBA, #RRGGBB, #RRGGBBAA formats.
+ */
+export declare const isHexColor: (value: unknown) => boolean;
+/**
+ * Check if value is a valid URL slug (lowercase alphanumeric with hyphens).
+ * Example: "my-blog-post", "user-profile-page"
+ */
+export declare const isSlug: (value: unknown) => boolean;
+/**
+ * Check if value is a string with uppercase letters.
+ */
+export declare const isUpperCase: (value: unknown) => boolean;
+/**
+ * Check if value is a string with lowercase letters.
+ */
+export declare const isLowerCase: (value: unknown) => boolean;
+/** Check if number is positive (> 0) */
+export declare const isPositive: (value: unknown) => boolean;
+/** Check if number is negative (< 0) */
+export declare const isNegative: (value: unknown) => boolean;
+/** Check if number is zero */
+export declare const isZero: (value: unknown) => boolean;
+/** Check if number is even */
+export declare const isEven: (value: unknown) => boolean;
+/** Check if number is odd */
+export declare const isOdd: (value: unknown) => boolean;
+/**
+ * Check if number has decimal places.
+ * Examples: 1.5 → true, 1.0 → false, 1 → false
+ */
+export declare const isDecimal: (value: unknown) => boolean;
+/**
+ * Check if number is between min and max (inclusive).
+ */
+export declare const isBetween: (value: unknown, min: number, max: number) => boolean;
+/**
+ * Check if number is divisible by divisor.
+ */
+export declare const isDivisibleBy: (value: unknown, divisor: number) => boolean;
+export declare const Helpers: Readonly<{
+    isString: (value: unknown) => value is string;
+    isBoolean: typeof isBoolean;
+    isBooleanString: (value: unknown) => boolean;
+    isEmpty: (value: unknown) => boolean;
+    isNull: (value: unknown) => boolean;
+    isUndefined: (value: unknown) => boolean;
+    isUndefinedOrNull: (value: unknown) => boolean;
+    isArray: (value: unknown) => value is unknown[];
+    isObject: (value: unknown) => value is Record<string, unknown>;
+    isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+    isDate: (value: unknown) => value is Date;
+    isEmail: (value: unknown) => boolean;
+    isUrl: (value: unknown) => boolean;
+    isIn: (value: unknown, array: unknown[]) => boolean;
+    isNotIn: (value: unknown, array: unknown[]) => boolean;
+    isLength: (value: unknown, length: number) => boolean;
+    isMinLength: (value: unknown, min: number) => boolean;
+    isMaxLength: (value: unknown, max: number) => boolean;
+    isMatch: (value: unknown, regex: RegExp, options?: {
+        maxLength?: number;
+    }) => boolean;
+    isAlpha: (value: unknown) => boolean;
+    isAlphanumeric: (value: unknown) => boolean;
+    isNumeric: (value: unknown) => boolean;
+    isInt: typeof isInt;
+    isFloat: typeof isFloat;
+    isIntString: (value: unknown, conditions?: {
+        min?: number;
+        max?: number;
+    }) => boolean;
+    isFloatString: (value: unknown, conditions?: {
+        min?: number;
+        max?: number;
+    }) => boolean;
+    isNonEmptyString: (value: unknown) => value is string;
+    isNonEmptyArray: (value: unknown) => value is unknown[];
+    isNonEmptyObject: (value: unknown) => value is Record<string, unknown>;
+    isWhitespaceOnly: (value: unknown) => boolean;
+    isUUID: (value: unknown) => boolean;
+    isJSON: (value: unknown) => boolean;
+    isBase64: (value: unknown) => boolean;
+    isHexColor: (value: unknown) => boolean;
+    isSlug: (value: unknown) => boolean;
+    isUpperCase: (value: unknown) => boolean;
+    isLowerCase: (value: unknown) => boolean;
+    isPositive: (value: unknown) => boolean;
+    isNegative: (value: unknown) => boolean;
+    isZero: (value: unknown) => boolean;
+    isEven: (value: unknown) => boolean;
+    isOdd: (value: unknown) => boolean;
+    isDecimal: (value: unknown) => boolean;
+    isBetween: (value: unknown, min: number, max: number) => boolean;
+    isDivisibleBy: (value: unknown, divisor: number) => boolean;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/src/helper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helper/index.ts"],"names":[],"mappings":"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"}

package/src/helper/index.js

@@ -0,0 +1,347 @@
+/**
+ * Lightweight validation / type helper utilities used across the codebase.
+ * Keep implementations small and dependency-free so they work in both
+ * Node and Cloudflare Worker runtimes.
+ */
+/* -------------------------------------------------------------------------- */
+/*                               Type Checkers                                */
+/* -------------------------------------------------------------------------- */
+/** Check whether value is a string primitive */
+export const isString = (value) => typeof value === 'string';
+/** Check whether value is an array */
+export const isArray = (value) => Array.isArray(value);
+/** Check whether value is an object (and not null/array) */
+export const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** Check whether value is a function */
+export const isFunction = (value) => typeof value === 'function';
+/** Check whether value is a valid Date object */
+export const isDate = (value) => value instanceof Date && !Number.isNaN(value.getTime());
+/* -------------------------------------------------------------------------- */
+/*                            Empty / Null Checks                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * Check if value is "empty".
+ * Matches legacy behavior: null, undefined, false, 0, '', '0' are all considered empty.
+ */
+export const isEmpty = (value) => value === null ||
+    value === undefined ||
+    value === false ||
+    value === 0 ||
+    value === '' ||
+    value === '0';
+/** Check if value is null or string 'null'/'NULL' or empty string */
+export const isNull = (value) => value === null ||
+    (typeof value === 'string' && value.trim().toLowerCase() === 'null') ||
+    (typeof value === 'string' && value === '');
+/** Check if value is undefined */
+export const isUndefined = (value) => value === undefined;
+/** Check if value is undefined or satisfies isNull() */
+export const isUndefinedOrNull = (value) => isUndefined(value) || isNull(value);
+/**
+ * Implementation
+ */
+export function isBoolean(value, allowString = false) {
+    if (typeof value === 'boolean')
+        return true;
+    if (!allowString)
+        return false;
+    if (typeof value !== 'string' && typeof value !== 'number')
+        return false;
+    const v = String(value).trim().toLowerCase();
+    return v === 'true' || v === 'false' || v === '1' || v === '0';
+}
+/** Check if value is a string representation of a boolean (true/false/1/0) */
+export const isBooleanString = (value) => typeof value === 'string' && /^(?:true|false|1|0)$/i.test(value.trim());
+/* -------------------------------------------------------------------------- */
+/*                              Numeric Checks                                */
+/* -------------------------------------------------------------------------- */
+/** Check if value is a valid number or numeric string */
+export const isNumeric = (value) => {
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'string')
+        return false;
+    const s = value.trim();
+    if (s.length === 0)
+        return false;
+    return /^[-+]?\d+(?:\.\d+)?$/.test(s);
+};
+/**
+ * Implementation
+ */
+export function isInt(value, allowString = false, conditions) {
+    let n;
+    if (typeof value === 'number') {
+        n = value;
+    }
+    else if (allowString && typeof value === 'string' && /^[+-]?\d+$/.test(value.trim())) {
+        n = Number(value);
+    }
+    else {
+        return false;
+    }
+    if (!Number.isInteger(n))
+        return false;
+    if (conditions?.min !== undefined && n < conditions.min)
+        return false;
+    if (conditions?.max !== undefined && n > conditions.max)
+        return false;
+    return true;
+}
+/**
+ * Implementation
+ */
+export function isFloat(value, allowString = false, conditions) {
+    let n;
+    if (typeof value === 'number') {
+        n = value;
+    }
+    else if (allowString &&
+        typeof value === 'string' &&
+        /^[-+]?\d+(?:\.\d+)?$/.test(value.trim())) {
+        n = Number(value);
+    }
+    else {
+        return false;
+    }
+    if (!Number.isFinite(n))
+        return false;
+    if (conditions?.min !== undefined && n < conditions.min)
+        return false;
+    if (conditions?.max !== undefined && n > conditions.max)
+        return false;
+    return true;
+}
+/** Check if value is a valid integer string (supports min/max) */
+export const isIntString = (value, conditions) => typeof value === 'string' && isInt(value, true, conditions);
+/** Check if value is a valid float string (supports min/max) */
+export const isFloatString = (value, conditions) => typeof value === 'string' && isFloat(value, true, conditions);
+/* -------------------------------------------------------------------------- */
+/*                            String / Format Checks                          */
+/* -------------------------------------------------------------------------- */
+const EMAIL_RE = /^[^\s@]+@[^\s@.]+(\.[^\s@.]+)+$/;
+/** Check if value is a valid email string */
+export const isEmail = (value) => typeof value === 'string' && EMAIL_RE.test(value);
+/** Check if value is a valid URL string (http/https) */
+export const isUrl = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        const u = new URL(value);
+        return u.protocol === 'http:' || u.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+};
+/** Check if string contains only letters */
+export const isAlpha = (value) => typeof value === 'string' && /^[A-Za-z]+$/.test(value);
+/** Check if string contains only letters and numbers */
+export const isAlphanumeric = (value) => typeof value === 'string' && /^[A-Za-z0-9]+$/.test(value);
+/** Check if string matches regex */
+const DEFAULT_MAX_REGEX_INPUT_LENGTH = 2048;
+/**
+ * Check if string matches regex.
+ *
+ * Security/perf: Regex evaluation can be expensive for some patterns.
+ * This helper defensively caps the input length to reduce ReDoS risk
+ * when used on untrusted strings.
+ */
+export const isMatch = (value, regex, options) => {
+    if (typeof value !== 'string')
+        return false;
+    if (!(regex instanceof RegExp))
+        return false;
+    const maxLength = typeof options?.maxLength === 'number' &&
+        Number.isInteger(options.maxLength) &&
+        options.maxLength >= 0
+        ? options.maxLength
+        : DEFAULT_MAX_REGEX_INPUT_LENGTH;
+    if (value.length > maxLength)
+        return false;
+    // Normalize stateful RegExp usage (e.g. /.../g) to avoid surprising false negatives.
+    if (regex.global || regex.sticky)
+        regex.lastIndex = 0;
+    return regex.test(value);
+};
+/* -------------------------------------------------------------------------- */
+/*                            Collection / Length                             */
+/* -------------------------------------------------------------------------- */
+/** Check if value exists in array */
+export const isIn = (value, array) => array.includes(value);
+/** Check if value does not exist in array */
+export const isNotIn = (value, array) => !array.includes(value);
+/** Check if string or array has exact length */
+export const isLength = (value, length) => {
+    if (typeof value === 'string' || Array.isArray(value))
+        return value.length === length;
+    return false;
+};
+/** Check if string or array has minimum length */
+export const isMinLength = (value, min) => {
+    if (typeof value === 'string' || Array.isArray(value))
+        return value.length >= min;
+    return false;
+};
+/** Check if string or array has maximum length */
+export const isMaxLength = (value, max) => {
+    if (typeof value === 'string' || Array.isArray(value))
+        return value.length <= max;
+    return false;
+};
+/* -------------------------------------------------------------------------- */
+/*                            Non-Empty Checks                                */
+/* -------------------------------------------------------------------------- */
+/** Check if value is a string with length > 0 (after trim) */
+export const isNonEmptyString = (value) => typeof value === 'string' && value.trim().length > 0;
+/** Check if value is an array with items */
+export const isNonEmptyArray = (value) => Array.isArray(value) && value.length > 0;
+/** Check if value is an object with keys */
+export const isNonEmptyObject = (value) => isObject(value) && Object.keys(value).length > 0;
+/* -------------------------------------------------------------------------- */
+/*                          Additional Format Checks                          */
+/* -------------------------------------------------------------------------- */
+/**
+ * Check if value is a string containing only whitespace.
+ * Useful for distinguishing between truly empty and whitespace-only strings.
+ */
+export const isWhitespaceOnly = (value) => typeof value === 'string' && value.length > 0 && value.trim().length === 0;
+/**
+ * Check if value is a valid UUID v4 string.
+ * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export const isUUID = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    const uuidv4Regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidv4Regex.test(value);
+};
+/**
+ * Check if value is a valid JSON string (parses without error).
+ */
+export const isJSON = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Check if value is a valid Base64-encoded string.
+ */
+export const isBase64 = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+    if (!base64Regex.test(value))
+        return false;
+    // Base64 length must be multiple of 4
+    return value.length % 4 === 0;
+};
+/**
+ * Check if value is a valid hexadecimal color string.
+ * Accepts #RGB, #RGBA, #RRGGBB, #RRGGBBAA formats.
+ */
+export const isHexColor = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    // Matches: #RGB (3), #RGBA (4), #RRGGBB (6), #RRGGBBAA (8)
+    return /^#(?:[0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(value);
+};
+/**
+ * Check if value is a valid URL slug (lowercase alphanumeric with hyphens).
+ * Example: "my-blog-post", "user-profile-page"
+ */
+export const isSlug = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
+};
+/**
+ * Check if value is a string with uppercase letters.
+ */
+export const isUpperCase = (value) => typeof value === 'string' && value.length > 0 && value === value.toUpperCase();
+/**
+ * Check if value is a string with lowercase letters.
+ */
+export const isLowerCase = (value) => typeof value === 'string' && value.length > 0 && value === value.toLowerCase();
+/* -------------------------------------------------------------------------- */
+/*                          Numeric Predicates                                */
+/* -------------------------------------------------------------------------- */
+/** Check if number is positive (> 0) */
+export const isPositive = (value) => typeof value === 'number' && Number.isFinite(value) && value > 0;
+/** Check if number is negative (< 0) */
+export const isNegative = (value) => typeof value === 'number' && Number.isFinite(value) && value < 0;
+/** Check if number is zero */
+export const isZero = (value) => typeof value === 'number' && Number.isFinite(value) && value === 0;
+/** Check if number is even */
+export const isEven = (value) => typeof value === 'number' && Number.isInteger(value) && value % 2 === 0;
+/** Check if number is odd */
+export const isOdd = (value) => typeof value === 'number' && Number.isInteger(value) && value % 2 !== 0;
+/**
+ * Check if number has decimal places.
+ * Examples: 1.5 → true, 1.0 → false, 1 → false
+ */
+export const isDecimal = (value) => typeof value === 'number' && Number.isFinite(value) && !Number.isInteger(value);
+/**
+ * Check if number is between min and max (inclusive).
+ */
+export const isBetween = (value, min, max) => typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+/**
+ * Check if number is divisible by divisor.
+ */
+export const isDivisibleBy = (value, divisor) => typeof value === 'number' && Number.isInteger(value) && divisor !== 0 && value % divisor === 0;
+/* -------------------------------------------------------------------------- */
+/*                                Factory Export                              */
+/* -------------------------------------------------------------------------- */
+export const Helpers = Object.freeze({
+    isString,
+    isBoolean,
+    isBooleanString,
+    isEmpty,
+    isNull,
+    isUndefined,
+    isUndefinedOrNull,
+    isArray,
+    isObject,
+    isFunction,
+    isDate,
+    isEmail,
+    isUrl,
+    isIn,
+    isNotIn,
+    isLength,
+    isMinLength,
+    isMaxLength,
+    isMatch,
+    isAlpha,
+    isAlphanumeric,
+    isNumeric,
+    isInt,
+    isFloat,
+    isIntString,
+    isFloatString,
+    isNonEmptyString,
+    isNonEmptyArray,
+    isNonEmptyObject,
+    isWhitespaceOnly,
+    isUUID,
+    isJSON,
+    isBase64,
+    isHexColor,
+    isSlug,
+    isUpperCase,
+    isLowerCase,
+    isPositive,
+    isNegative,
+    isZero,
+    isEven,
+    isOdd,
+    isDecimal,
+    isBetween,
+    isDivisibleBy,
+});

package/src/http/FileUpload.d.ts

@@ -2,8 +2,9 @@
  * File Upload Handler
  * Handles multipart/form-data file uploads with validation and storage integration
  */
+import type { ReadableOptions } from '../node-singletons/stream';
 import type { IRequest } from './Request';
-import type { Readable } from 'node:stream';
+type Streamer = ReadableOptions | NodeJS.ReadableStream;
 export interface UploadedFile {
     fieldName: string;
     originalName: string;
@@ -21,7 +22,7 @@ export interface UploadedFile {
     /**
      * Returns a fresh readable stream for the uploaded content.
      */
-    stream?: () => Readable;
+    stream?: () => Streamer;
     /**
      * Optional cleanup hook (e.g., delete temp file after response).
      */

package/src/http/FileUpload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/http/FileUpload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAAC;IACtE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;CAClE;AAoBD;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,QAAQ,KAAG,kBAsEvD,CAAC;AAEF,eAAO,MAAM,UAAU;IACrB;;OAEG;uBACgB,QAAQ,GAAG,kBAAkB;IAIhD;;OAEG;yBAEM,YAAY,EAAE,WACZ;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;EA6BrC,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/http/FileUpload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,QAAQ,GAAG,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAAC;IACtE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;CAClE;AAoBD;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,QAAQ,KAAG,kBAsEvD,CAAC;AAEF,eAAO,MAAM,UAAU;IACrB;;OAEG;uBACgB,QAAQ,GAAG,kBAAkB;IAIhD;;OAEG;yBAEM,YAAY,EAAE,WACZ;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;EA6BrC,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/src/http/Kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../../src/http/Kernel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK7E,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAGpE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/C,wBAAwB,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACpE,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IAGvC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAuTD,eAAO,MAAM,MAAM;qBA1DK,OAAO,aAAa,iBAAiB,KAAG,OAAO;EA4DrE,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../../src/http/Kernel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK7E,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAGpE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/C,wBAAwB,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACpE,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IAGvC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AA4TD,eAAO,MAAM,MAAM;qBA1DK,OAAO,aAAa,iBAAiB,KAAG,OAAO;EA4DrE,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/http/Kernel.js

@@ -89,7 +89,8 @@ const runKernelPipeline = async (router, globalMiddleware, routeMiddleware, req,
     if (!route) {
         const routeLabel = 'not_found';
         maybeSetKernelTraceRoute(traceSpan, context.method, routeLabel);
-        ErrorRouting.handleNotFound(req, res, context.requestId);
+        const handleNotFound = ErrorRouting.handleNotFound;
+        await handleNotFound(req, res, context.requestId);
         return routeLabel;
     }
     // Safe type guard to ensure route.routePath is a non-empty string before calling .trim()

package/src/http/error-pages/ErrorPageRenderer.d.ts

@@ -1,4 +1,5 @@
 import type { IRequest } from '../Request';
+type ErrorTemplateName = '404' | '500';
 type RenderInput = {
     statusCode: number;
     errorName: string;
@@ -9,9 +10,12 @@ type RenderInput = {
     requestPretty?: string;
     requestRaw?: string;
 };
+type TemplateStore = Partial<Record<ErrorTemplateName, string>>;
 export declare const ErrorPageRenderer: Readonly<{
+    setTemplates(templates: TemplateStore): void;
     shouldSendHtml(request: IRequest): boolean;
     renderHtml(publicRoot: string, input: RenderInput): string | undefined;
+    renderHtmlAsync(publicRoot: string, input: RenderInput): Promise<string | undefined>;
 }>;
 export {};
 //# sourceMappingURL=ErrorPageRenderer.d.ts.map

package/src/http/error-pages/ErrorPageRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorPageRenderer.d.ts","sourceRoot":"","sources":["../../../../src/http/error-pages/ErrorPageRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM9C,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA2EF,eAAO,MAAM,iBAAiB;4BACJ,QAAQ,GAAG,OAAO;2BAInB,MAAM,SAAS,WAAW,GAAG,MAAM,GAAG,SAAS;EAUtE,CAAC"}
+{"version":3,"file":"ErrorPageRenderer.d.ts","sourceRoot":"","sources":["../../../../src/http/error-pages/ErrorPageRenderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,KAAK,iBAAiB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvC,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;AAmJhE,eAAO,MAAM,iBAAiB;4BACJ,aAAa,GAAG,IAAI;4BASpB,QAAQ,GAAG,OAAO;2BAInB,MAAM,SAAS,WAAW,GAAG,MAAM,GAAG,SAAS;gCAyBpC,MAAM,SAAS,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;EAiB1F,CAAC"}