tiny-essentials 1.28.19 → 1.29.1

package/dist/v1/libs/tools/TinyHttpResponseRegistry/index.cjs

@@ -0,0 +1,268 @@
+'use strict';
+
+var objChecker = require('../../../basics/objChecker.cjs');
+var index = require('../../text/TinyI18/index.cjs');
+var RequestCodes = require('./RequestCodes.cjs');
+
+/**
+ * @typedef {import('./JsDoc.mjs').HttpResponse} HttpResponse
+ * @typedef {import('./JsDoc.mjs').HttpResponses} HttpResponses
+ */
+
+/**
+ * A centralized registry designed for managing HTTP response metadata.
+ * It provides strict data validation and integrated internationalization (i18n) support,
+ * enabling the retrieval of localized response names, summaries, and descriptions
+ * while preventing accidental state mutation.
+ */
+class TinyHttpResponseRegistry {
+  /** @type {HttpResponses} */
+  static #DefaultRequestCodes = RequestCodes;
+
+  /**
+   * A collection of utility methods to check HTTP status code ranges.
+   */
+  static codeIs = Object.freeze({
+    /**
+     * Checks if the status code is in the 1xx (Informational) range.
+     * @param {number} code - The HTTP status code to evaluate.
+     * @returns {boolean} True if the code is between 100 and 199, inclusive.
+     * @throws {TypeError} If the provided code is not a number or is NaN.
+     */
+    info: (code) => {
+      if (typeof code !== 'number' || Number.isNaN(code))
+        throw new TypeError('The status code must be a valid number.');
+      return code >= 100 && code <= 199;
+    },
+    /**
+     * Checks if the status code is in the 2xx (Success) range.
+     * @param {number} code - The HTTP status code to evaluate.
+     * @returns {boolean} True if the code is between 200 and 299, inclusive.
+     * @throws {TypeError} If the provided code is not a number or is NaN.
+     */
+    success: (code) => {
+      if (typeof code !== 'number' || Number.isNaN(code))
+        throw new TypeError('The status code must be a valid number.');
+      return code >= 200 && code <= 299;
+    },
+    /**
+     * Checks if the status code is in the 3xx (Redirection) range.
+     * @param {number} code - The HTTP status code to evaluate.
+     * @returns {boolean} True if the code is between 300 and 399, inclusive.
+     * @throws {TypeError} If the provided code is not a number or is NaN.
+     */
+    redirect: (code) => {
+      if (typeof code !== 'number' || Number.isNaN(code))
+        throw new TypeError('The status code must be a valid number.');
+      return code >= 300 && code <= 399;
+    },
+    /**
+     * Checks if the status code is in the 4xx (Client Error) range.
+     * @param {number} code - The HTTP status code to evaluate.
+     * @returns {boolean} True if the code is between 400 and 499, inclusive.
+     * @throws {TypeError} If the provided code is not a number or is NaN.
+     */
+    clientError: (code) => {
+      if (typeof code !== 'number' || Number.isNaN(code))
+        throw new TypeError('The status code must be a valid number.');
+      return code >= 400 && code <= 499;
+    },
+    /**
+     * Checks if the status code is in the 5xx (Server Error) range.
+     * @param {number} code - The HTTP status code to evaluate.
+     * @returns {boolean} True if the code is between 500 and 599, inclusive.
+     * @throws {TypeError} If the provided code is not a number or is NaN.
+     */
+    serverError: (code) => {
+      if (typeof code !== 'number' || Number.isNaN(code))
+        throw new TypeError('The status code must be a valid number.');
+      return code >= 500 && code <= 599;
+    },
+  });
+
+  /**
+   * Getter for the default request codes.
+   * Returns a deep clone to prevent external mutation of the private state.
+   *
+   * @returns {HttpResponses} A deep copy of the current status codes.
+   */
+  static get defaultRequestCodes() {
+    return structuredClone(TinyHttpResponseRegistry.#DefaultRequestCodes);
+  }
+
+  /**
+   * Setter for the default request codes.
+   * Performs deep validation and stores a deep clone to prevent external mutation.
+   *
+   * @param {HttpResponses} newCodes - The new mapping of HTTP responses.
+   * @throws {TypeError} If the input is not a valid HttpResponses object.
+   */
+  static set defaultRequestCodes(newCodes) {
+    // 1. Validate that the input is a non-null object
+    if (typeof newCodes !== 'object' || newCodes === null || Array.isArray(newCodes)) {
+      throw new TypeError('The value must be a non-null object.');
+    }
+
+    // 2. Deep validation of the object structure
+    for (const [key, response] of Object.entries(newCodes)) {
+      // Validate that the key represents a valid number
+      if (Number.isNaN(Number(key))) {
+        throw new TypeError(`Invalid key: "${key}". Status code keys must be numeric.`);
+      }
+
+      // Validate that the value is a valid object
+      if (typeof response !== 'object' || response === null || Array.isArray(response)) {
+        throw new TypeError(`The value for status code ${key} must be an object.`);
+      }
+
+      // Validate internal properties of the HttpResponse object
+      if (typeof response.name !== 'string') {
+        throw new TypeError(`Property 'name' in status ${key} must be a string.`);
+      }
+      if (typeof response.summary !== 'string') {
+        throw new TypeError(`Property 'summary' in status ${key} must be a string.`);
+      }
+      if (typeof response.description !== 'string') {
+        throw new TypeError(`Property 'description' in status ${key} must be a string.`);
+      }
+    }
+
+    // 3. Store a deep clone to ensure the class owns the data entirely
+    TinyHttpResponseRegistry.#DefaultRequestCodes = structuredClone(newCodes);
+  }
+
+  /** @type {Set<number>} The set of all registered HTTP status codes. */
+  #reqCodes = new Set();
+
+  /** @type {TinyI18} The internationalization instance used for managing localized response data. */
+  #i18;
+
+  /** @type {string} The current active locale for the registry. */
+  #locale = 'en';
+
+  /**
+   * Initializes a new instance of the TinyHttpResponseRegistry.
+   * @param {typeof TinyI18} I18 - The TinyI18 constructor.
+   * @param {HttpResponses} [initialResponses] - An object of initial response objects to populate the registry.
+   * @throws {TypeError} If the input is not an object.
+   */
+  constructor(I18, initialResponses = {}) {
+    if (!objChecker.isJsonObject(initialResponses)) {
+      throw new TypeError('Initial responses must be an object.');
+    }
+
+    this.#i18 = new I18({
+      defaultLocale: 'en',
+      mode: 'local',
+      strict: false,
+      acceptNullResults: true,
+    });
+
+    if (!(this.#i18 instanceof index))
+      throw new TypeError('The "i18" must be an instance of TinyI18.');
+
+    this.#i18.loadLocaleLocal(this.#locale, {});
+    for (const id in TinyHttpResponseRegistry.#DefaultRequestCodes) {
+      const response = TinyHttpResponseRegistry.#DefaultRequestCodes[id];
+      this.addResponse(Number(id), response);
+    }
+    for (const id in initialResponses) {
+      const response = initialResponses[id];
+      this.addResponse(Number(id), response);
+    }
+  }
+
+  /**
+   * Validates the structure and types of a response object.
+   * @param {number} id - The HTTP status code (e.g., 404).
+   * @param {any} data - The data to validate.
+   * @throws {TypeError} If the data structure or types are incorrect.
+   * @throws {RangeError} If the ID is not a valid HTTP status code range.
+   * @throws {Error} If the ID already exists in the registry.
+   */
+  #validateResponse(id, data) {
+    if (typeof data !== 'object' || data === null) {
+      throw new TypeError('Response must be a non-null object.');
+    }
+
+    if (typeof data.name !== 'string') {
+      throw new TypeError('The "name" property must be a string.');
+    }
+
+    if (typeof data.summary !== 'string') {
+      throw new TypeError('The "summary" property must be a string.');
+    }
+
+    if (typeof data.description !== 'string') {
+      throw new TypeError('The "description" property must be a string.');
+    }
+
+    if (this.#i18.get(String(id))) {
+      throw new Error(`Response with ID ${id} already exists in the registry.`);
+    }
+  }
+
+  /**
+   * Adds a new response to the registry.
+   * The object is frozen to prevent any modifications to its properties.
+   * @param {number} id - The HTTP status code (e.g., 404).
+   * @param {HttpResponse} response - The response object to be added.
+   * @param {string} [locale] - The locale to use for storing the response.
+   */
+  addResponse(id, response, locale = this.#locale) {
+    this.#validateResponse(id, response);
+    this.#reqCodes.add(id);
+
+    // Create a frozen copy to ensure immutability of the stored object
+    this.#i18.loadLocaleLocal(locale, {
+      [id]: {
+        name: response.name,
+        summary: response.summary,
+        description: response.description,
+      },
+    });
+  }
+
+  /**
+   * Retrieves a response by its ID.
+   * @param {number} id - The HTTP status code.
+   * @returns {HttpResponse | null} The response object or null if not found.
+   * @param {import('../../text/TinyI18/index.mjs').Dict} [params]
+   * @param {string} [locale] - The locale to use for retrieval.
+   */
+  get(id, params = {}, locale = this.#locale) {
+    const name = this.#i18.get(`${id}.name`, params, { locale });
+    const summary = this.#i18.get(`${id}.summary`, params, { locale });
+    const description = this.#i18.get(`${id}.description`, params, { locale });
+
+    if (typeof name !== 'string' || typeof summary !== 'string' || typeof description !== 'string')
+      return null;
+
+    return { name, summary, description };
+  }
+
+  /**
+   * Checks if a response ID exists in the registry.
+   * @param {number} id - The HTTP status code.
+   * @returns {boolean} True if the ID exists, false otherwise.
+   */
+  has(id) {
+    return !!this.#i18.get(String(id));
+  }
+
+  /**
+   * Returns all registered responses as an object.
+   * @returns {HttpResponses} An object containing all registered response objects.
+   */
+  getAll() {
+    /** @type {HttpResponses} */
+    const result = {};
+    this.#reqCodes.forEach((code) => {
+      const data = this.get(code);
+      if (data) result[code] = data;
+    });
+    return result;
+  }
+}
+
+module.exports = TinyHttpResponseRegistry;

package/dist/v1/libs/tools/TinyHttpResponseRegistry/index.d.mts

@@ -0,0 +1,107 @@
+import TinyI18 from '../../text/TinyI18/index.mjs';
+export type HttpResponse = import('./JsDoc.mjs').HttpResponse;
+export type HttpResponses = import('./JsDoc.mjs').HttpResponses;
+/**
+ * @typedef {import('./JsDoc.mjs').HttpResponse} HttpResponse
+ * @typedef {import('./JsDoc.mjs').HttpResponses} HttpResponses
+ */
+/**
+ * A centralized registry designed for managing HTTP response metadata.
+ * It provides strict data validation and integrated internationalization (i18n) support,
+ * enabling the retrieval of localized response names, summaries, and descriptions
+ * while preventing accidental state mutation.
+ */
+declare class TinyHttpResponseRegistry {
+    #private;
+    /**
+     * A collection of utility methods to check HTTP status code ranges.
+     */
+    static codeIs: Readonly<{
+        /**
+         * Checks if the status code is in the 1xx (Informational) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 100 and 199, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        info: (code: number) => boolean;
+        /**
+         * Checks if the status code is in the 2xx (Success) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 200 and 299, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        success: (code: number) => boolean;
+        /**
+         * Checks if the status code is in the 3xx (Redirection) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 300 and 399, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        redirect: (code: number) => boolean;
+        /**
+         * Checks if the status code is in the 4xx (Client Error) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 400 and 499, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        clientError: (code: number) => boolean;
+        /**
+         * Checks if the status code is in the 5xx (Server Error) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 500 and 599, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        serverError: (code: number) => boolean;
+    }>;
+    /**
+     * Getter for the default request codes.
+     * Returns a deep clone to prevent external mutation of the private state.
+     *
+     * @returns {HttpResponses} A deep copy of the current status codes.
+     */
+    static get defaultRequestCodes(): HttpResponses;
+    /**
+     * Setter for the default request codes.
+     * Performs deep validation and stores a deep clone to prevent external mutation.
+     *
+     * @param {HttpResponses} newCodes - The new mapping of HTTP responses.
+     * @throws {TypeError} If the input is not a valid HttpResponses object.
+     */
+    static set defaultRequestCodes(newCodes: HttpResponses);
+    /**
+     * Initializes a new instance of the TinyHttpResponseRegistry.
+     * @param {typeof TinyI18} I18 - The TinyI18 constructor.
+     * @param {HttpResponses} [initialResponses] - An object of initial response objects to populate the registry.
+     * @throws {TypeError} If the input is not an object.
+     */
+    constructor(I18: typeof TinyI18, initialResponses?: HttpResponses);
+    /**
+     * Adds a new response to the registry.
+     * The object is frozen to prevent any modifications to its properties.
+     * @param {number} id - The HTTP status code (e.g., 404).
+     * @param {HttpResponse} response - The response object to be added.
+     * @param {string} [locale] - The locale to use for storing the response.
+     */
+    addResponse(id: number, response: HttpResponse, locale?: string): void;
+    /**
+     * Retrieves a response by its ID.
+     * @param {number} id - The HTTP status code.
+     * @returns {HttpResponse | null} The response object or null if not found.
+     * @param {import('../../text/TinyI18/index.mjs').Dict} [params]
+     * @param {string} [locale] - The locale to use for retrieval.
+     */
+    get(id: number, params?: import('../../text/TinyI18/index.mjs').Dict, locale?: string): HttpResponse | null;
+    /**
+     * Checks if a response ID exists in the registry.
+     * @param {number} id - The HTTP status code.
+     * @returns {boolean} True if the ID exists, false otherwise.
+     */
+    has(id: number): boolean;
+    /**
+     * Returns all registered responses as an object.
+     * @returns {HttpResponses} An object containing all registered response objects.
+     */
+    getAll(): HttpResponses;
+}
+export default TinyHttpResponseRegistry;
+//# sourceMappingURL=index.d.mts.map

package/dist/v1/libs/tools/TinyHttpResponseRegistry/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/tools/TinyHttpResponseRegistry/index.mjs"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,8BAA8B,CAAC;AAIhD,YAA8C,YAAY,GAAhD,OAAO,aAAa,EAAE,YAAY,CAAc;AAC1D,YAA+C,aAAa,GAAlD,OAAO,aAAa,EAAE,aAAa,CAAe;AAF/D;;;GAGG;AAEH;;;;;GAKG;AACH,cAAM,wBAAwB;;IAI5B;;OAEG;IACH,MAAM,CAAC,MAAM;QACX;;;;;WAKG;qBAHQ,MAAM,KACJ,OAAO;QAQpB;;;;;WAKG;wBAHQ,MAAM,KACJ,OAAO;QAQpB;;;;;WAKG;yBAHQ,MAAM,KACJ,OAAO;QAQpB;;;;;WAKG;4BAHQ,MAAM,KACJ,OAAO;QAQpB;;;;;WAKG;4BAHQ,MAAM,KACJ,OAAO;OAQnB;IAEH;;;;;OAKG;IACH,MAAM,KAAK,mBAAmB,IAFjB,aAAa,CAIzB;IAED;;;;;;OAMG;IACH,MAAM,KAAK,mBAAmB,CAAC,QAAQ,EAH5B,aAG4B,EAgCtC;IAWD;;;;;OAKG;IACH,YAAY,GAAG,EAJJ,OAAO,OAIH,EAAE,gBAAgB,AAH9B,CACA,EADQ,aAG2B,EAwBrC;IAgCD;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAJH,MAIG,EAAE,QAAQ,EAHb,YAGa,EAAE,MAAM,AAF7B,CACF,EADU,MAEoC,QAY9C;IAED;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EALK,MAKL,EAAE,MAAM,AAHX,CACA,EADQ,OAAO,8BAA8B,EAAE,IAG/B,EAAE,MAAM,AAFxB,CACF,EADU,MAE+B,GAJ7B,YAAY,GAAG,IAAI,CAa/B;IAED;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAHK,MAGL,GAFO,OAAO,CAInB;IAED;;;OAGG;IACH,MAAM,IAFO,aAAa,CAUzB;CACF;eAEc,wBAAwB"}

package/dist/v1/libs/tools/TinyHttpResponseRegistry/index.mjs

@@ -0,0 +1,238 @@
+import { isJsonObject } from '../../../basics/objChecker.mjs';
+import TinyI18 from '../../text/TinyI18/index.mjs';
+import RequestCodes from './RequestCodes.mjs';
+/**
+ * @typedef {import('./JsDoc.mjs').HttpResponse} HttpResponse
+ * @typedef {import('./JsDoc.mjs').HttpResponses} HttpResponses
+ */
+/**
+ * A centralized registry designed for managing HTTP response metadata.
+ * It provides strict data validation and integrated internationalization (i18n) support,
+ * enabling the retrieval of localized response names, summaries, and descriptions
+ * while preventing accidental state mutation.
+ */
+class TinyHttpResponseRegistry {
+    /** @type {HttpResponses} */
+    static #DefaultRequestCodes = RequestCodes;
+    /**
+     * A collection of utility methods to check HTTP status code ranges.
+     */
+    static codeIs = Object.freeze({
+        /**
+         * Checks if the status code is in the 1xx (Informational) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 100 and 199, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        info: (code) => {
+            if (typeof code !== 'number' || Number.isNaN(code))
+                throw new TypeError('The status code must be a valid number.');
+            return code >= 100 && code <= 199;
+        },
+        /**
+         * Checks if the status code is in the 2xx (Success) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 200 and 299, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        success: (code) => {
+            if (typeof code !== 'number' || Number.isNaN(code))
+                throw new TypeError('The status code must be a valid number.');
+            return code >= 200 && code <= 299;
+        },
+        /**
+         * Checks if the status code is in the 3xx (Redirection) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 300 and 399, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        redirect: (code) => {
+            if (typeof code !== 'number' || Number.isNaN(code))
+                throw new TypeError('The status code must be a valid number.');
+            return code >= 300 && code <= 399;
+        },
+        /**
+         * Checks if the status code is in the 4xx (Client Error) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 400 and 499, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        clientError: (code) => {
+            if (typeof code !== 'number' || Number.isNaN(code))
+                throw new TypeError('The status code must be a valid number.');
+            return code >= 400 && code <= 499;
+        },
+        /**
+         * Checks if the status code is in the 5xx (Server Error) range.
+         * @param {number} code - The HTTP status code to evaluate.
+         * @returns {boolean} True if the code is between 500 and 599, inclusive.
+         * @throws {TypeError} If the provided code is not a number or is NaN.
+         */
+        serverError: (code) => {
+            if (typeof code !== 'number' || Number.isNaN(code))
+                throw new TypeError('The status code must be a valid number.');
+            return code >= 500 && code <= 599;
+        },
+    });
+    /**
+     * Getter for the default request codes.
+     * Returns a deep clone to prevent external mutation of the private state.
+     *
+     * @returns {HttpResponses} A deep copy of the current status codes.
+     */
+    static get defaultRequestCodes() {
+        return structuredClone(TinyHttpResponseRegistry.#DefaultRequestCodes);
+    }
+    /**
+     * Setter for the default request codes.
+     * Performs deep validation and stores a deep clone to prevent external mutation.
+     *
+     * @param {HttpResponses} newCodes - The new mapping of HTTP responses.
+     * @throws {TypeError} If the input is not a valid HttpResponses object.
+     */
+    static set defaultRequestCodes(newCodes) {
+        // 1. Validate that the input is a non-null object
+        if (typeof newCodes !== 'object' || newCodes === null || Array.isArray(newCodes)) {
+            throw new TypeError('The value must be a non-null object.');
+        }
+        // 2. Deep validation of the object structure
+        for (const [key, response] of Object.entries(newCodes)) {
+            // Validate that the key represents a valid number
+            if (Number.isNaN(Number(key))) {
+                throw new TypeError(`Invalid key: "${key}". Status code keys must be numeric.`);
+            }
+            // Validate that the value is a valid object
+            if (typeof response !== 'object' || response === null || Array.isArray(response)) {
+                throw new TypeError(`The value for status code ${key} must be an object.`);
+            }
+            // Validate internal properties of the HttpResponse object
+            if (typeof response.name !== 'string') {
+                throw new TypeError(`Property 'name' in status ${key} must be a string.`);
+            }
+            if (typeof response.summary !== 'string') {
+                throw new TypeError(`Property 'summary' in status ${key} must be a string.`);
+            }
+            if (typeof response.description !== 'string') {
+                throw new TypeError(`Property 'description' in status ${key} must be a string.`);
+            }
+        }
+        // 3. Store a deep clone to ensure the class owns the data entirely
+        TinyHttpResponseRegistry.#DefaultRequestCodes = structuredClone(newCodes);
+    }
+    /** @type {Set<number>} The set of all registered HTTP status codes. */
+    #reqCodes = new Set();
+    /** @type {TinyI18} The internationalization instance used for managing localized response data. */
+    #i18;
+    /** @type {string} The current active locale for the registry. */
+    #locale = 'en';
+    /**
+     * Initializes a new instance of the TinyHttpResponseRegistry.
+     * @param {typeof TinyI18} I18 - The TinyI18 constructor.
+     * @param {HttpResponses} [initialResponses] - An object of initial response objects to populate the registry.
+     * @throws {TypeError} If the input is not an object.
+     */
+    constructor(I18, initialResponses = {}) {
+        if (!isJsonObject(initialResponses)) {
+            throw new TypeError('Initial responses must be an object.');
+        }
+        this.#i18 = new I18({
+            defaultLocale: 'en',
+            mode: 'local',
+            strict: false,
+            acceptNullResults: true,
+        });
+        if (!(this.#i18 instanceof TinyI18))
+            throw new TypeError('The "i18" must be an instance of TinyI18.');
+        this.#i18.loadLocaleLocal(this.#locale, {});
+        for (const id in TinyHttpResponseRegistry.#DefaultRequestCodes) {
+            const response = TinyHttpResponseRegistry.#DefaultRequestCodes[id];
+            this.addResponse(Number(id), response);
+        }
+        for (const id in initialResponses) {
+            const response = initialResponses[id];
+            this.addResponse(Number(id), response);
+        }
+    }
+    /**
+     * Validates the structure and types of a response object.
+     * @param {number} id - The HTTP status code (e.g., 404).
+     * @param {any} data - The data to validate.
+     * @throws {TypeError} If the data structure or types are incorrect.
+     * @throws {RangeError} If the ID is not a valid HTTP status code range.
+     * @throws {Error} If the ID already exists in the registry.
+     */
+    #validateResponse(id, data) {
+        if (typeof data !== 'object' || data === null) {
+            throw new TypeError('Response must be a non-null object.');
+        }
+        if (typeof data.name !== 'string') {
+            throw new TypeError('The "name" property must be a string.');
+        }
+        if (typeof data.summary !== 'string') {
+            throw new TypeError('The "summary" property must be a string.');
+        }
+        if (typeof data.description !== 'string') {
+            throw new TypeError('The "description" property must be a string.');
+        }
+        if (this.#i18.get(String(id))) {
+            throw new Error(`Response with ID ${id} already exists in the registry.`);
+        }
+    }
+    /**
+     * Adds a new response to the registry.
+     * The object is frozen to prevent any modifications to its properties.
+     * @param {number} id - The HTTP status code (e.g., 404).
+     * @param {HttpResponse} response - The response object to be added.
+     * @param {string} [locale] - The locale to use for storing the response.
+     */
+    addResponse(id, response, locale = this.#locale) {
+        this.#validateResponse(id, response);
+        this.#reqCodes.add(id);
+        // Create a frozen copy to ensure immutability of the stored object
+        this.#i18.loadLocaleLocal(locale, {
+            [id]: {
+                name: response.name,
+                summary: response.summary,
+                description: response.description,
+            },
+        });
+    }
+    /**
+     * Retrieves a response by its ID.
+     * @param {number} id - The HTTP status code.
+     * @returns {HttpResponse | null} The response object or null if not found.
+     * @param {import('../../text/TinyI18/index.mjs').Dict} [params]
+     * @param {string} [locale] - The locale to use for retrieval.
+     */
+    get(id, params = {}, locale = this.#locale) {
+        const name = this.#i18.get(`${id}.name`, params, { locale });
+        const summary = this.#i18.get(`${id}.summary`, params, { locale });
+        const description = this.#i18.get(`${id}.description`, params, { locale });
+        if (typeof name !== 'string' || typeof summary !== 'string' || typeof description !== 'string')
+            return null;
+        return { name, summary, description };
+    }
+    /**
+     * Checks if a response ID exists in the registry.
+     * @param {number} id - The HTTP status code.
+     * @returns {boolean} True if the ID exists, false otherwise.
+     */
+    has(id) {
+        return !!this.#i18.get(String(id));
+    }
+    /**
+     * Returns all registered responses as an object.
+     * @returns {HttpResponses} An object containing all registered response objects.
+     */
+    getAll() {
+        /** @type {HttpResponses} */
+        const result = {};
+        this.#reqCodes.forEach((code) => {
+            const data = this.get(code);
+            if (data)
+                result[code] = data;
+        });
+        return result;
+    }
+}
+export default TinyHttpResponseRegistry;