@arkyn/server 3.0.1-beta.99 → 3.0.3

package/dist/http/api/_deleteRequest.d.ts

@@ -0,0 +1,17 @@
+import { type ApiResponseDTO } from "./_makeRequest";
+type InputProps = {
+    url: string;
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+    body?: any;
+};
+/**
+ * Sends a DELETE request to the specified URL with optional headers and body.
+ *
+ * @template T - The expected type of the response data.
+ * @param {InputProps} input - The options for the DELETE request, including URL, URL parameters, headers, and body.
+ * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
+ */
+declare function deleteRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { deleteRequest };
+//# sourceMappingURL=_deleteRequest.d.ts.map

package/dist/http/api/_deleteRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_deleteRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_deleteRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAEF;;;;;;GAMG;AAGH,iBAAe,aAAa,CAAC,CAAC,GAAG,GAAG,EACnC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/http/api/_getRequest.d.ts

@@ -0,0 +1,16 @@
+import { type ApiResponseDTO } from "./_makeRequest";
+type InputProps = {
+    url: string;
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+};
+/**
+ * Sends a GET request to the specified URL with optional headers.
+ *
+ * @template T - The expected type of the response data.
+ * @param {InputProps} input - The options for the GET request, including URL, URL parameters, and headers.
+ * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
+ */
+declare function getRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { getRequest };
+//# sourceMappingURL=_getRequest.d.ts.map

package/dist/http/api/_getRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_getRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_getRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AAGH,iBAAe,UAAU,CAAC,CAAC,GAAG,GAAG,EAChC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAO5B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/api/_logMapperService.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Input properties for log mapping.
+ *
+ * @typedef {object} InputProps
+ * @property {number} status - HTTP response status code.
+ * @property {string} url - The request URL.
+ * @property {"GET" | "POST" | "PUT" | "DELETE" | "PATCH"} method - HTTP method used.
+ * @property {HeadersInit} requestHeaders - Headers sent with the request.
+ * @property {HeadersInit} responseHeaders - Headers received in the response.
+ * @property {any} requestBody - Body of the request.
+ * @property {number} elapsedTime - Time elapsed for the request in milliseconds.
+ * @property {any} responseBody - Body of the response.
+ * @property {URLSearchParams} queryParams - Query parameters from the URL.
+ */
+type InputProps = {
+    status: number;
+    rawUrl: string;
+    urlParams?: Record<string, string>;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    requestHeaders: HeadersInit;
+    responseHeaders: HeadersInit;
+    requestBody: any;
+    elapsedTime: number;
+    responseBody: any;
+    queryParams: URLSearchParams;
+};
+/**
+ * Output properties after log mapping transformation.
+ *
+ * @typedef {object} OutputProps
+ * @property {string} rawUrl - The original request URL.
+ * @property {number} status - HTTP response status code.
+ * @property {"GET" | "POST" | "PUT" | "DELETE" | "PATCH"} method - HTTP method used.
+ * @property {string | null} token - Authentication token (if present).
+ * @property {number} elapsedTime - Time elapsed for the request in milliseconds.
+ * @property {Record<string, string>} requestHeaders - Mapped request headers.
+ * @property {Record<string, string>} requestBody - Mapped request body.
+ * @property {Record<string, string>} queryParams - Mapped query parameters.
+ * @property {Record<string, string>} responseHeaders - Mapped response headers.
+ * @property {any} responseBody - The response body.
+ */
+type OutputProps = {
+    rawUrl: string;
+    status: number;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    token: string | null;
+    elapsedTime: number;
+    requestHeaders: Record<string, string>;
+    requestBody: Record<string, string>;
+    queryParams: Record<string, string>;
+    responseHeaders: Record<string, string>;
+    responseBody: any;
+};
+/**
+ * Static service for mapping HTTP request/response data into a standardized log format.
+ *
+ * Provides utilities to transform headers and query parameters into plain objects,
+ * and produces a unified output structure for logging purposes.
+ */
+declare class LogMapperService {
+    /**
+     * Converts various header formats into a plain key-value object.
+     *
+     * @param {HeadersInit} headers - The headers to map.
+     * @returns {Record<string, string>} A plain object with header key-value pairs.
+     * @private
+     */
+    private static mapHeaders;
+    /**
+     * Converts URLSearchParams into a plain key-value object.
+     *
+     * @param {URLSearchParams} queryParams - The query parameters to map.
+     * @returns {Record<string, string>} A plain object with query parameter key-value pairs.
+     * @private
+     */
+    private static mapQueryParams;
+    /**
+     * Transforms raw HTTP request/response data into a standardized log output format.
+     *
+     * @param {InputProps} props - The input properties containing request/response data.
+     * @returns {OutputProps} The mapped output object ready for logging.
+     */
+    static handle(props: InputProps): OutputProps;
+}
+export { LogMapperService };
+//# sourceMappingURL=_logMapperService.d.ts.map

package/dist/http/api/_logMapperService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_logMapperService.d.ts","sourceRoot":"","sources":["../../../src/http/api/_logMapperService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,GAAG;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,cAAc,EAAE,WAAW,CAAC;IAC5B,eAAe,EAAE,WAAW,CAAC;IAE7B,WAAW,EAAE,GAAG,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,GAAG,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,KAAK,WAAW,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,YAAY,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,cAAM,gBAAgB;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAiBzB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAY7B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW;CAiB7C;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/{api/arkynLogRequest.d.ts → http/api/_logRequest.d.ts}

@@ -13,25 +13,28 @@ type ConfigProps = {
 /**
  * Sends a request to the inbox flow API with the provided configuration.
  *
- * @param config - The configuration object for the request.
- * @param config.rawUrl - The raw URL of the request.
- * @param config.status - The HTTP status code associated with the request.
- * @param config.method - The HTTP method used for the request. Can be "POST", "GET", "PUT", "DELETE", or "PATCH".
- * @param config.token - The authentication token for the request.
- * @param config.elapsedTime - The elapsed time for the request in milliseconds.
- * @param config.requestHeaders - The headers sent with the request.
- * @param config.requestBody - The body of the request, if applicable.
- * @param config.queryParams - The query parameters for the request.
- * @param config.responseHeaders - The headers received in the response.
- * @param config.responseBody - The body of the response received.
- *
- * @remarks
- * - This function retrieves the inbox flow configuration using `InboxFlowService.getInboxConfig()`.
+ * - This function retrieves the inbox flow configuration using `LogService.getConfig()`.
  * - If the configuration is not available, the function will return early without performing any action.
  * - In a development environment (`NODE_ENV === "development"`), the function will also return early.
  * - The request is sent as a POST request to the inbox API URL with the provided configuration details.
  * - If an error occurs during the request, it will be logged using the `httpDebug` service.
  *
+ * @param {ConfigProps} config - The configuration object for the request.
+ * @param {string} config.rawUrl - The raw URL of the request.
+ * @param {number} config.status - The HTTP status code associated with the request.
+ * @param {"GET" | "POST" | "PUT" | "DELETE" | "PATCH"} config.method - The HTTP method used for the request. Can be "POST", "GET", "PUT", "DELETE", or "PATCH".
+ * @param {string | null} config.token - The authentication token for the request.
+ * @param {number} config.elapsedTime - The elapsed time for the request in milliseconds.
+ * @param {Record<string, string>} config.requestHeaders - The headers sent with the request.
+ * @param {Record<string, string>} config.requestBody - The body of the request, if applicable.
+ * @param {Record<string, string>} config.queryParams - The query parameters for the request.
+ * @param {Record<string, string>} config.responseHeaders - The headers received in the response.
+ * @param {Record<string, string>} config.responseBody - The body of the response received.
+ *
+ * @remarks
+ *
+ * @returns {Promise<void>} A promise that resolves when the request is complete.
+ *
  * @example
  * ```typescript
  * const config = {
@@ -39,7 +42,7 @@ type ConfigProps = {
  *   status: 200,
  *   method: "GET",
  *   token: "auth-token-123",
- *   elapsedTime: "150ms",
+ *   elapsedTime: 150,
  *   requestHeaders: { "Accept": "application/json", "Authorization": "Bearer token123" },
  *   requestBody: {},
  *   queryParams: { "page": "1", "limit": "10" },
@@ -47,9 +50,9 @@ type ConfigProps = {
  *   responseBody: { "data": "example response" }
  * };
  *
- * await arkynLogRequest(config);
+ * await logRequest(config);
  * ```
  */
-declare function arkynLogRequest(config: ConfigProps): Promise<void>;
-export { arkynLogRequest };
-//# sourceMappingURL=arkynLogRequest.d.ts.map
+declare function logRequest(config: ConfigProps): Promise<void>;
+export { logRequest };
+//# sourceMappingURL=_logRequest.d.ts.map

package/dist/{api/arkynLogRequest.d.ts.map → http/api/_logRequest.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"arkynLogRequest.d.ts","sourceRoot":"","sources":["../../src/api/arkynLogRequest.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,iBAAe,eAAe,CAAC,MAAM,EAAE,WAAW,iBAyDjD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"_logRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_logRequest.ts"],"names":[],"mappings":"AAIA,KAAK,WAAW,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,iBAAe,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E5D;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/api/_makeRequest.d.ts

@@ -0,0 +1,61 @@
+type InputProps = {
+    url: string;
+    method: "POST" | "PUT" | "DELETE" | "PATCH" | "GET";
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+    body?: any;
+};
+type ApiSuccessResponse<T = any> = {
+    success: true;
+    status: number;
+    message: string;
+    response: T;
+    cause: null;
+};
+type ApiFailedResponse = {
+    success: false;
+    status: number;
+    message: string;
+    response: any;
+    cause: string | Error | null;
+};
+type ApiResponseDTO<T = any> = ApiSuccessResponse<T> | ApiFailedResponse;
+/**
+ * Makes an HTTP request using the Fetch API and returns a standardized response.
+ *
+ * @template {any} T - The expected type of the response data.
+ *
+ * @param {"POST" | "PUT" | "DELETE" | "PATCH" | "GET"} method - The HTTP method to use for the request. Supported methods are:
+ *   - "POST": Create a new resource.
+ *   - "PUT": Update an existing resource.
+ *   - "DELETE": Remove a resource.
+ *   - "PATCH": Partially update a resource.
+ *   - "GET": Retrieve a resource.
+ * @param {string} url - The URL to which the request is sent.
+ * @param {HeadersInit} headers - Optional headers to include in the request. Defaults to an empty object.
+ * @param {any} body - Optional body to include in the request. Should be serializable to JSON.
+ *
+ * @returns {ApiResponseDTO<T>} A promise that resolves to an `ApiResponseDTO<T>` object containing:
+ *   - `success`: A boolean indicating whether the request was successful.
+ *   - `status`: The HTTP status code of the response.
+ *   - `message`: A message describing the result of the request.
+ *   - `response`: The parsed JSON response data, or `null` if parsing fails.
+ *   - `cause`: Additional error information, if applicable.
+ *
+ * @example
+ * ```typescript
+ * import { makeRequest } from "./makeRequest";
+ *
+ * async function fetchData() {
+ *   const response = await makeRequest("GET", "https://api.example.com/data");
+ *   if (response.success) {
+ *     console.log("Data:", response.response);
+ *   } else {
+ *     console.error("Error:", response.message);
+ *   }
+ * }
+ * ```
+ */
+declare function makeRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { type ApiResponseDTO, makeRequest };
+//# sourceMappingURL=_makeRequest.d.ts.map

package/dist/http/api/_makeRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_makeRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_makeRequest.ts"],"names":[],"mappings":"AAIA,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAGF,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACxB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CAC7B,CAAC;AAGF,KAAK,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,iBAAe,WAAW,CAAC,CAAC,GAAG,GAAG,EACjC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAqF5B;AAED,OAAO,EAAE,KAAK,cAAc,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/api/_patchRequest.d.ts

@@ -0,0 +1,17 @@
+import { type ApiResponseDTO } from "./_makeRequest";
+type InputProps = {
+    url: string;
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+    body?: any;
+};
+/**
+ * Sends a PATCH request to the specified URL with optional headers and body.
+ *
+ * @template T - The expected type of the response data.
+ * @param {InputProps} input - The options for the PATCH request, including URL, URL parameters, headers, and body.
+ * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
+ */
+declare function patchRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { patchRequest };
+//# sourceMappingURL=_patchRequest.d.ts.map

package/dist/http/api/_patchRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_patchRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_patchRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAEF;;;;;;GAMG;AAGH,iBAAe,YAAY,CAAC,CAAC,GAAG,GAAG,EAClC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/http/api/_postRequest.d.ts

@@ -0,0 +1,17 @@
+import { type ApiResponseDTO } from "./_makeRequest";
+type InputProps = {
+    url: string;
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+    body?: any;
+};
+/**
+ * Sends a POST request to the specified URL with optional headers and body.
+ *
+ * @template T - The expected type of the response data.
+ * @param {InputProps} input - The options for the POST request, including URL, URL parameters, headers, and body.
+ * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
+ */
+declare function postRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { postRequest };
+//# sourceMappingURL=_postRequest.d.ts.map

package/dist/http/api/_postRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_postRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_postRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAEF;;;;;;GAMG;AAGH,iBAAe,WAAW,CAAC,CAAC,GAAG,GAAG,EACjC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/api/_putRequest.d.ts

@@ -0,0 +1,17 @@
+import { type ApiResponseDTO } from "./_makeRequest";
+type InputProps = {
+    url: string;
+    urlParams?: Record<string, string>;
+    headers?: HeadersInit;
+    body?: any;
+};
+/**
+ * Sends a PUT request to the specified URL with optional headers and body.
+ *
+ * @template T - The expected type of the response data.
+ * @param {InputProps} input - The options for the PUT request, including URL, URL parameters, headers, and body.
+ * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
+ */
+declare function putRequest<T = any>(input: InputProps): Promise<ApiResponseDTO<T>>;
+export { putRequest };
+//# sourceMappingURL=_putRequest.d.ts.map

package/dist/http/api/_putRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_putRequest.d.ts","sourceRoot":"","sources":["../../../src/http/api/_putRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAEF;;;;;;GAMG;AAGH,iBAAe,UAAU,CAAC,CAAC,GAAG,GAAG,EAChC,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/badResponses/_badResponse.d.ts

@@ -1,11 +1,25 @@
-type Input = {
-    name: string;
-    body?: any;
-    cause?: any;
-    message?: string;
-};
 declare class BadResponse {
-    onDebug(input: Input): void;
+    private _cause?;
+    private _name;
+    private _status;
+    private _statusText;
+    private _debugColor;
+    get cause(): any;
+    set cause(value: any);
+    get name(): string;
+    set name(value: string);
+    get status(): number;
+    set status(value: number);
+    get statusText(): string;
+    set statusText(value: string);
+    get debugColor(): "green" | "yellow" | "cyan" | "red";
+    set debugColor(value: "green" | "yellow" | "cyan" | "red");
+    onDebug(): void;
+    makeBody(): {
+        name: string;
+        message: string;
+        cause: any;
+    };
 }
 export { BadResponse };
 //# sourceMappingURL=_badResponse.d.ts.map

package/dist/http/badResponses/_badResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_badResponse.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/_badResponse.ts"],"names":[],"mappings":"AAGA,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,cAAM,WAAW;IACf,OAAO,CAAC,KAAK,EAAE,KAAK;CAgBrB;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"_badResponse.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/_badResponse.ts"],"names":[],"mappings":"AAKA,cAAM,WAAW;IAEhB,OAAO,CAAC,MAAM,CAAC,CAAM;IACrB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,WAAW,CAA8C;IAGjE,IAAI,KAAK,IAAI,GAAG,CAEf;IAGD,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,EAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAE3B;IAED,IAAI,UAAU,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAEpD;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,EAGxD;IAED,OAAO;IAeP,QAAQ;;;;;CAOR;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/badResponses/badGateway.d.ts

@@ -1,34 +1,23 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 502 (Bad Gateway).
- * This class is used to standardize the structure of a "Bad Gateway" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 502 Bad Gateway — the upstream server returned an invalid or unexpected response.
+ *
+ * Throw inside a server action/loader and catch with `errorHandler`, or call `.toJson()` directly.
+ *
+ * @example
+ * ```typescript
+ * throw new BadGateway("Payment gateway unavailable");
+ * ```
  */
 declare class BadGateway extends BadResponse {
-    body: any;
-    cause?: any;
-    status: number;
-    statusText: string;
     /**
-     * Creates an instance of the `BadGateway` class.
-     *
-     * @param message - A descriptive message explaining the cause of the error.
-     * @param cause - Optional additional information about the cause of the error.
+     * @param message - Error description sent in the response body and logged for debugging.
+     * @param cause - Optional extra context (serialized to JSON in the response).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `BadGateway` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `BadGateway` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { BadGateway };

package/dist/http/badResponses/badGateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badGateway.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,UAAW,SAAQ,WAAW;IAClC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAO;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAexC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"badGateway.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;GASG;AACH,cAAM,UAAW,SAAQ,WAAW;IACnC;;;OAGG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQlB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/badResponses/badRequest.d.ts

@@ -1,34 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 400 (Bad Request).
- * This class is used to standardize the structure of a "Bad Request" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 400 Bad Request — the request is malformed or contains invalid data.
+ *
+ * @example
+ * ```typescript
+ * throw new BadRequest("Invalid request body");
+ * ```
  */
 declare class BadRequest extends BadResponse {
-    body: any;
-    cause?: any;
-    status: number;
-    statusText: string;
     /**
-     * Creates an instance of the `BadRequest` class.
-     *
-     * @param message - A descriptive message explaining the cause of the error.
-     * @param cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `BadRequest` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `BadRequest` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { BadRequest };

package/dist/http/badResponses/badRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badRequest.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,UAAW,SAAQ,WAAW;IAClC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAO;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAexC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"badRequest.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,UAAW,SAAQ,WAAW;IACnC;;;OAGG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQlB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/badResponses/conflict.d.ts

@@ -1,34 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 409 (Conflict).
- * This class is used to standardize the structure of a "Conflict" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 409 Conflict — the request conflicts with the current state of the server (e.g. duplicate record).
+ *
+ * @example
+ * ```typescript
+ * throw new Conflict("Email already in use");
+ * ```
  */
 declare class Conflict extends BadResponse {
-    body: any;
-    cause?: any;
-    status: number;
-    statusText: string;
     /**
-     * Creates an instance of the `Conflict` class.
-     *
-     * @param message - A descriptive message explaining the cause of the conflict.
-     * @param cause - Optional additional information about the cause of the conflict.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `Conflict` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `Conflict` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { Conflict };

package/dist/http/badResponses/conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,QAAS,SAAQ,WAAW;IAChC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAO;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAexC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,QAAS,SAAQ,WAAW;IACjC;;;OAGG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAYxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQlB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/http/badResponses/forbidden.d.ts

@@ -1,34 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 403 (Forbidden).
- * This class is used to standardize the structure of a "Forbidden" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 403 Forbidden — authenticated but not authorized to access this resource.
+ *
+ * @example
+ * ```typescript
+ * throw new Forbidden("You don't have permission to delete this resource");
+ * ```
  */
 declare class Forbidden extends BadResponse {
-    body: any;
-    cause?: any;
-    status: number;
-    statusText: string;
     /**
-     * Creates an instance of the `Forbidden` class.
-     *
-     * @param message - A descriptive message explaining why access is forbidden.
-     * @param cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `Forbidden` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `Forbidden` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { Forbidden };

package/dist/http/badResponses/forbidden.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forbidden.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,SAAU,SAAQ,WAAW;IACjC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAO;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAexC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"forbidden.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,SAAU,SAAQ,WAAW;IAClC;;;OAGG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQlB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/http/badResponses/notFound.d.ts

@@ -1,34 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 404 (Not Found).
- * This class is used to standardize the structure of a "Not Found" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 404 Not Found — the requested resource does not exist.
+ *
+ * @example
+ * ```typescript
+ * throw new NotFound("Product not found");
+ * ```
  */
 declare class NotFound extends BadResponse {
-    body: any;
-    cause?: any;
-    status: number;
-    statusText: string;
     /**
-     * Creates an instance of the `NotFound` class.
-     *
-     * @param message - A descriptive message explaining the reason the resource was not found.
-     * @param cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `NotFound` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `NotFound` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { NotFound };