@arkyn/server 3.0.1-beta.117 → 3.0.1-beta.119

package/dist/utilities/decodeRequestBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeRequestBody.d.ts","sourceRoot":"","sources":["../../src/utilities/decodeRequestBody.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,iBAAe,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAsB/D;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/{services → utilities}/decodeRequestBody.js

@@ -7,14 +7,14 @@ import { BadRequest } from "../http/badResponses/badRequest";
  * 2. If JSON parsing fails, attempts to parse the body as URL-encoded form data.
  * 3. If both parsing attempts fail, logs the errors and returns an empty object.
  *
- * @param req - The incoming request object containing the body to decode.
- * @returns A promise that resolves to the decoded data as a JavaScript object.
+ * @param {Request} request - The incoming request object containing the body to decode.
+ * @returns {Promise<any>} A promise that resolves to the decoded data as a JavaScript object.
  *
  * @throws Logs errors to the console if the request body cannot be read or parsed.
  */
-const decodeRequestBody = async (req) => {
+async function decodeRequestBody(request) {
     let data;
-    const arrayBuffer = await req.arrayBuffer();
+    const arrayBuffer = await request.arrayBuffer();
     const text = new TextDecoder().decode(arrayBuffer);
     try {
         data = JSON.parse(text);
@@ -34,5 +34,5 @@ const decodeRequestBody = async (req) => {
         }
     }
     return data;
-};
+}
 export { decodeRequestBody };

package/dist/{services/decodeErrorMessageFromRequest.d.ts → utilities/decodeRequestErrorMessage.d.ts}

@@ -5,13 +5,13 @@
  * `data` or `response` objects by checking various properties in a specific order.
  * If no valid error message is found, it returns a default message: "Missing error message".
  *
- * @param data - The data object that may contain error information. It can have properties
+ * @param {any} data - The data object that may contain error information. It can have properties
  * such as `message`, `error`, or `error.message` that are checked for a string value.
- * @param response - The response object that may contain a `statusText` property
+ * @param {Response} response - The response object that may contain a `statusText` property
  * representing the HTTP status text.
- * @returns A string representing the decoded error message, or a default message
+ * @returns {string} A string representing the decoded error message, or a default message
  * if no error message is found.
  */
-declare function decodeErrorMessageFromRequest(data: any, response: Response): string;
-export { decodeErrorMessageFromRequest };
-//# sourceMappingURL=decodeErrorMessageFromRequest.d.ts.map
+declare function decodeRequestErrorMessage(data: any, response: Response): string;
+export { decodeRequestErrorMessage };
+//# sourceMappingURL=decodeRequestErrorMessage.d.ts.map

package/dist/utilities/decodeRequestErrorMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeRequestErrorMessage.d.ts","sourceRoot":"","sources":["../../src/utilities/decodeRequestErrorMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,iBAAS,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAkBxE;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/{services/decodeErrorMessageFromRequest.js → utilities/decodeRequestErrorMessage.js}

@@ -5,14 +5,14 @@
  * `data` or `response` objects by checking various properties in a specific order.
  * If no valid error message is found, it returns a default message: "Missing error message".
  *
- * @param data - The data object that may contain error information. It can have properties
+ * @param {any} data - The data object that may contain error information. It can have properties
  * such as `message`, `error`, or `error.message` that are checked for a string value.
- * @param response - The response object that may contain a `statusText` property
+ * @param {Response} response - The response object that may contain a `statusText` property
  * representing the HTTP status text.
- * @returns A string representing the decoded error message, or a default message
+ * @returns {string} A string representing the decoded error message, or a default message
  * if no error message is found.
  */
-function decodeErrorMessageFromRequest(data, response) {
+function decodeRequestErrorMessage(data, response) {
     if (data?.message && typeof data?.message === "string") {
         return data?.message;
     }
@@ -27,4 +27,4 @@ function decodeErrorMessageFromRequest(data, response) {
     }
     return "Missing error message";
 }
-export { decodeErrorMessageFromRequest };
+export { decodeRequestErrorMessage };

package/dist/utilities/errorHandler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Handles errors and success responses, converting them into standard HTTP Response objects.
+ *
+ * This function acts as a centralized error and response handler that processes various
+ * response types (both success and error responses) and converts them into HTTP Response
+ * objects. If the error is not recognized, it defaults to returning a ServerError response.
+ *
+ * @param {any} error - The error or response object to be handled. Can be:
+ *   - A native Response object
+ *   - A success response instance (Found, Created, Updated, Success, NoContent)
+ *   - An error response instance (BadGateway, BadRequest, Conflict, Forbidden, NotFound, NotImplemented, ServerError, Unauthorized, UnprocessableEntity)
+ *   - Any other error object (will be wrapped in ServerError)
+ *
+ * @returns {Response} A standard HTTP Response object with appropriate status code, headers, and body
+ *
+ * @example
+ * ```typescript
+ * // Handling a success response
+ * try {
+ *   const result = await someOperation();
+ *   throw new Success("Operation successful", result);
+ * } catch (error) {
+ *   return errorHandler(error);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Handling an error response
+ * try {
+ *   const user = await findUser(id);
+ *   if (!user) throw new NotFound("User not found");
+ * } catch (error) {
+ *   return errorHandler(error);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Handling unexpected errors
+ * try {
+ *   await riskyOperation();
+ * } catch (error) {
+ *   return errorHandler(error); // Returns ServerError response
+ * }
+ * ```
+ */
+declare function errorHandler(error: any): Response;
+export { errorHandler };
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utilities/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utilities/errorHandler.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ,CAsC1C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/{services → utilities}/errorHandler.js

@@ -13,45 +13,51 @@ import { NoContent } from "../http/successResponses/noContent";
 import { Success } from "../http/successResponses/success";
 import { Updated } from "../http/successResponses/updated";
 /**
- * Handles errors and converts them into appropriate HTTP responses.
+ * Handles errors and success responses, converting them into standard HTTP Response objects.
  *
- * This function takes an error object and determines its type to return
- * the corresponding HTTP response. It supports both success and error
- * response types, converting them into a standardized format using the
- * `toResponse` method when applicable.
+ * This function acts as a centralized error and response handler that processes various
+ * response types (both success and error responses) and converts them into HTTP Response
+ * objects. If the error is not recognized, it defaults to returning a ServerError response.
  *
- * @param error - The error object to handle. It can be an instance of various
- * HTTP response classes or a generic error.
+ * @param {any} error - The error or response object to be handled. Can be:
+ *   - A native Response object
+ *   - A success response instance (Found, Created, Updated, Success, NoContent)
+ *   - An error response instance (BadGateway, BadRequest, Conflict, Forbidden, NotFound, NotImplemented, ServerError, Unauthorized, UnprocessableEntity)
+ *   - Any other error object (will be wrapped in ServerError)
  *
- * @returns The corresponding HTTP response object if the error matches a known
- * type, or `undefined` if no match is found.
+ * @returns {Response} A standard HTTP Response object with appropriate status code, headers, and body
  *
- * ### Supported Success Responses:
- * - `Found`
- * - `Created`
- * - `Updated`
- * - `Success`
- * - `NoContent`
- *
- * ### Supported Error Responses:
- * - `BadGateway`
- * - `BadRequest`
- * - `Conflict`
- * - `Forbidden`
- * - `NotFound`
- * - `NotImplemented`
- * - `ServerError`
- * - `Unauthorized`
- * - `UnprocessableEntity`
+ * @example
+ * ```typescript
+ * // Handling a success response
+ * try {
+ *   const result = await someOperation();
+ *   throw new Success("Operation successful", result);
+ * } catch (error) {
+ *   return errorHandler(error);
+ * }
+ * ```
  *
- * ### Example Usage:
+ * @example
  * ```typescript
+ * // Handling an error response
  * try {
- *   // Some operation that might throw an error
+ *   const user = await findUser(id);
+ *   if (!user) throw new NotFound("User not found");
  * } catch (error) {
  *   return errorHandler(error);
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Handling unexpected errors
+ * try {
+ *   await riskyOperation();
+ * } catch (error) {
+ *   return errorHandler(error); // Returns ServerError response
+ * }
+ * ```
  */
 function errorHandler(error) {
     switch (true) {

package/dist/utilities/flushDebugLogs.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Flushes debug logs to the console with colored output in development mode.
+ *
+ * This function only outputs logs when running in development mode or when
+ * the DEBUG_MODE environment variable is set to "true".
+ * Each log entry is prefixed with a colored name tag based on the specified color scheme.
+ *
+ * @param {object} props - Configuration object for debug logging.
+ * @param {string} props.name - The name/label to display before each log entry (e.g., "API", "Database").
+ * @param {"yellow" | "cyan" | "red" | "green"} props.scheme - The color scheme for the name tag:
+ *   - "yellow": Warning-level logs
+ *   - "cyan": Info-level logs
+ *   - "red": Error-level logs
+ *   - "green": Success-level logs
+ * @param {string[]} props.debugs - Array of debug messages to be logged.
+ *
+ * @returns {void}
+ *
+ * @example
+ * ```typescript
+ * // Log API request information
+ * flushDebugLogs({
+ *   name: "API",
+ *   scheme: "cyan",
+ *   debugs: ["POST /api/users", "Status: 201", "Response time: 45ms"]
+ * });
+ * // Output:
+ * // [API] POST /api/users
+ * // [API] Status: 201
+ * // [API] Response time: 45ms
+ *
+ * // Log error messages
+ * flushDebugLogs({
+ *   name: "ERROR",
+ *   scheme: "red",
+ *   debugs: ["Database connection failed", "Retrying in 5s..."]
+ * });
+ * ```
+ */
+declare function flushDebugLogs(props: {
+    scheme: "yellow" | "cyan" | "red" | "green";
+    name: string;
+    debugs: string[];
+}): void;
+export { flushDebugLogs };
+//# sourceMappingURL=flushDebugLogs.d.ts.map

package/dist/utilities/flushDebugLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flushDebugLogs.d.ts","sourceRoot":"","sources":["../../src/utilities/flushDebugLogs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,iBAAS,cAAc,CAAC,KAAK,EAAE;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,IAAI,CAwBP;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/utilities/flushDebugLogs.js

@@ -0,0 +1,59 @@
+/**
+ * Flushes debug logs to the console with colored output in development mode.
+ *
+ * This function only outputs logs when running in development mode or when
+ * the DEBUG_MODE environment variable is set to "true".
+ * Each log entry is prefixed with a colored name tag based on the specified color scheme.
+ *
+ * @param {object} props - Configuration object for debug logging.
+ * @param {string} props.name - The name/label to display before each log entry (e.g., "API", "Database").
+ * @param {"yellow" | "cyan" | "red" | "green"} props.scheme - The color scheme for the name tag:
+ *   - "yellow": Warning-level logs
+ *   - "cyan": Info-level logs
+ *   - "red": Error-level logs
+ *   - "green": Success-level logs
+ * @param {string[]} props.debugs - Array of debug messages to be logged.
+ *
+ * @returns {void}
+ *
+ * @example
+ * ```typescript
+ * // Log API request information
+ * flushDebugLogs({
+ *   name: "API",
+ *   scheme: "cyan",
+ *   debugs: ["POST /api/users", "Status: 201", "Response time: 45ms"]
+ * });
+ * // Output:
+ * // [API] POST /api/users
+ * // [API] Status: 201
+ * // [API] Response time: 45ms
+ *
+ * // Log error messages
+ * flushDebugLogs({
+ *   name: "ERROR",
+ *   scheme: "red",
+ *   debugs: ["Database connection failed", "Retrying in 5s..."]
+ * });
+ * ```
+ */
+function flushDebugLogs(props) {
+    const isDebugMode = process.env.NODE_ENV === "development" ||
+        process.env?.DEBUG_MODE === "true";
+    if (isDebugMode) {
+        const reset = "\x1b[0m";
+        const colors = {
+            yellow: "\x1b[33m",
+            cyan: "\x1b[36m",
+            red: "\x1b[31m",
+            green: "\x1b[32m",
+        };
+        const debugName = `${colors[props.scheme]}[${props.name}]${reset}`;
+        let consoleData = `\n`;
+        props.debugs.forEach((debug) => {
+            consoleData += `${debugName} ${debug.trim()}\n`;
+        });
+        console.log(consoleData);
+    }
+}
+export { flushDebugLogs };

package/dist/{services → utilities}/formAsyncParse.d.ts

@@ -21,9 +21,9 @@ type FormParseReturnType<T extends FormParseProps> = SuccessResponse<T> | ErrorR
  *
  * @template T - A type that extends `FormParseProps`.
  *
- * @param {T} param0 - An array containing the form data and the Zod schema.
- * @param {T[0]} param0[0] - The form data to be validated.
- * @param {T[1]} param0[1] - The Zod schema used for validation.
+ * @param {T} props - An array containing the form data and the Zod schema.
+ * @param {T[0]} formData[0] - The form data to be validated.
+ * @param {T[1]} schema[1] - The Zod schema used for validation.
  *
  * @returns {Promise<FormParseReturnType<T>>} A promise that resolves to an object containing the validation result.
  * - If validation fails, it includes:

package/dist/utilities/formAsyncParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAsyncParse.d.ts","sourceRoot":"","sources":["../../src/utilities/formAsyncParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,IAAI;IAC/C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CACjD,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAExE,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAC7C,eAAe,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAe,cAAc,CAAC,CAAC,SAAS,cAAc,EAAE,CACtD,QAAQ,EACR,MAAM,EACP,EAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAqBrC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/{services → utilities}/formAsyncParse.js

@@ -3,9 +3,9 @@
  *
  * @template T - A type that extends `FormParseProps`.
  *
- * @param {T} param0 - An array containing the form data and the Zod schema.
- * @param {T[0]} param0[0] - The form data to be validated.
- * @param {T[1]} param0[1] - The Zod schema used for validation.
+ * @param {T} props - An array containing the form data and the Zod schema.
+ * @param {T[0]} formData[0] - The form data to be validated.
+ * @param {T[1]} schema[1] - The Zod schema used for validation.
  *
  * @returns {Promise<FormParseReturnType<T>>} A promise that resolves to an object containing the validation result.
  * - If validation fails, it includes:

package/dist/{services → utilities}/formParse.d.ts

@@ -21,9 +21,9 @@ type FormParseReturnType<T extends FormParseProps> = SuccessResponse<T> | ErrorR
  *
  * @template T - A type that extends `FormParseProps`.
  *
- * @param {T} param0 - An array containing the form data and the Zod schema.
- * @param {T[0]} param0[0] - The form data to be validated.
- * @param {T[1]} param0[1] - The Zod schema used for validation.
+ * @param {T} props - An array containing the form data and the Zod schema.
+ * @param {T[0]} formData[0] - The form data to be validated.
+ * @param {T[1]} schema[1] - The Zod schema used for validation.
  *
  * @returns {FormParseReturnType<T>} An object containing the validation result.
  * - If validation fails, it includes:

package/dist/utilities/formParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formParse.d.ts","sourceRoot":"","sources":["../../src/utilities/formParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,IAAI;IAC/C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CACjD,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAExE,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAC7C,eAAe,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAS,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAC3C,QAAQ,EACR,MAAM,EACP,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAqB5B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/{services → utilities}/formParse.js

@@ -3,9 +3,9 @@
  *
  * @template T - A type that extends `FormParseProps`.
  *
- * @param {T} param0 - An array containing the form data and the Zod schema.
- * @param {T[0]} param0[0] - The form data to be validated.
- * @param {T[1]} param0[1] - The Zod schema used for validation.
+ * @param {T} props - An array containing the form data and the Zod schema.
+ * @param {T[0]} formData[0] - The form data to be validated.
+ * @param {T[1]} schema[1] - The Zod schema used for validation.
  *
  * @returns {FormParseReturnType<T>} An object containing the validation result.
  * - If validation fails, it includes:

package/dist/{services → utilities}/getScopedParams.d.ts

@@ -1,9 +1,8 @@
-type GetScopedParamsFunction = (request: Request, scope?: string) => URLSearchParams;
 /**
  * Extracts and returns scoped query parameters from a request URL.
  *
- * @param request - The incoming request object containing the URL.
- * @param scope - An optional string representing the scope prefix for filtering query parameters.
+ * @param {Request} request - The incoming request object containing the URL.
+ * @param {string} scope - An optional string representing the scope prefix for filtering query parameters.
  *                If no scope is provided, all query parameters are returned.
  *
  * @returns A `URLSearchParams` object containing the scoped query parameters.
@@ -23,6 +22,6 @@ type GetScopedParamsFunction = (request: Request, scope?: string) => URLSearchPa
  * const params = getScopedParams(request, "scope");
  * console.log(params.toString()); // Output: "key1=value1&key2=value2"
  */
-declare const getScopedParams: GetScopedParamsFunction;
+declare function getScopedParams(request: Request, scope?: string): URLSearchParams;
 export { getScopedParams };
 //# sourceMappingURL=getScopedParams.d.ts.map

package/dist/utilities/getScopedParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getScopedParams.d.ts","sourceRoot":"","sources":["../../src/utilities/getScopedParams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,MAAW,mBAW5D;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/{services → utilities}/getScopedParams.js

@@ -1,8 +1,8 @@
 /**
  * Extracts and returns scoped query parameters from a request URL.
  *
- * @param request - The incoming request object containing the URL.
- * @param scope - An optional string representing the scope prefix for filtering query parameters.
+ * @param {Request} request - The incoming request object containing the URL.
+ * @param {string} scope - An optional string representing the scope prefix for filtering query parameters.
  *                If no scope is provided, all query parameters are returned.
  *
  * @returns A `URLSearchParams` object containing the scoped query parameters.
@@ -22,7 +22,7 @@
  * const params = getScopedParams(request, "scope");
  * console.log(params.toString()); // Output: "key1=value1&key2=value2"
  */
-const getScopedParams = (request, scope = "") => {
+function getScopedParams(request, scope = "") {
     const url = new URL(request.url);
     if (scope === "")
         return url.searchParams;
@@ -30,5 +30,5 @@ const getScopedParams = (request, scope = "") => {
         .filter(([key]) => key.startsWith(`${scope}:`))
         .map(([key, value]) => [key.replace(`${scope}:`, ""), value]);
     return new URLSearchParams(scopedSearchParams);
-};
+}
 export { getScopedParams };

package/dist/{services → utilities}/schemaValidator.d.ts

@@ -2,8 +2,6 @@ import { ZodType, z } from "zod";
 /**
  * A schema validator class that provides multiple validation methods for Zod schemas.
  *
- * @template T - A type that extends ZodType.
- *
  * @example
  * ```typescript
  * import { z } from "zod";
@@ -36,11 +34,8 @@ import { ZodType, z } from "zod";
  */
 declare class SchemaValidator<T extends ZodType> {
     readonly schema: T;
-    functionName: string;
-    callerInfo: string;
     /**
      * Creates a new SchemaValidator instance.
-     *
      * @param {T} schema - The Zod schema to use for validation.
      */
     constructor(schema: T);
@@ -63,7 +58,6 @@ declare class SchemaValidator<T extends ZodType> {
      * Safely validates data and returns the complete parse result without throwing errors.
      *
      * @param {any} data - The data to validate.
-     *
      * @returns {z.ZodSafeParseResult<z.infer<T>>} The Zod safe parse result containing success status and data or error.
      *
      * @example
@@ -83,10 +77,8 @@ declare class SchemaValidator<T extends ZodType> {
      * Validates data and returns the parsed result, throwing a ServerError on validation failure.
      *
      * @param {any} data - The data to validate.
-     *
-     * @returns {z.infer<T>} The validated and parsed data.
-     *
      * @throws {ServerError} When validation fails, with a formatted error message.
+     * @returns {z.infer<T>} The validated and parsed data.
      *
      * @example
      * ```typescript
@@ -107,10 +99,8 @@ declare class SchemaValidator<T extends ZodType> {
      *
      * @param {any} data - The form data to validate.
      * @param {string} [message] - Optional custom error message.
-     *
-     * @returns {z.infer<T>} The validated and parsed form data.
-     *
      * @throws {UnprocessableEntity} When validation fails, with structured field errors for form handling.
+     * @returns {z.infer<T>} The validated and parsed form data.
      *
      * @example
      * ```typescript
@@ -133,10 +123,8 @@ declare class SchemaValidator<T extends ZodType> {
      *
      * @param {any} data - The form data to validate.
      * @param {string} [message] - Optional custom error message.
-     *
-     * @returns {Promise<z.infer<T>>} A promise that resolves to the validated and parsed form data.
-     *
      * @throws {UnprocessableEntity} When validation fails, with structured field errors for form handling.
+     * @returns {Promise<z.infer<T>>} A promise that resolves to the validated and parsed form data.
      *
      * @example
      * ```typescript

package/dist/utilities/schemaValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.d.ts","sourceRoot":"","sources":["../../src/utilities/schemaValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,cAAM,eAAe,CAAC,CAAC,SAAS,OAAO;IAKzB,QAAQ,CAAC,MAAM,EAAE,CAAC;IAJ9B;;;OAGG;gBACkB,MAAM,EAAE,CAAC;IAE9B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;IAI3B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAIzD;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAQ/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAiBrD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAgB1E;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/{services → utilities}/schemaValidator.js

@@ -3,7 +3,6 @@ import { ServerError } from "../http/badResponses/serverError";
 import { UnprocessableEntity } from "../http/badResponses/unprocessableEntity";
 import { formAsyncParse } from "./formAsyncParse";
 import { formParse } from "./formParse";
-import { getCaller } from "./getCaller";
 function formatErrorMessage(error) {
     const title = "Error validating:";
     const lines = error.issues.map(({ path, message }) => `-> ${path.join(".")}: ${message}`);
@@ -12,8 +11,6 @@ function formatErrorMessage(error) {
 /**
  * A schema validator class that provides multiple validation methods for Zod schemas.
  *
- * @template T - A type that extends ZodType.
- *
  * @example
  * ```typescript
  * import { z } from "zod";
@@ -46,18 +43,12 @@ function formatErrorMessage(error) {
  */
 class SchemaValidator {
     schema;
-    functionName;
-    callerInfo;
     /**
      * Creates a new SchemaValidator instance.
-     *
      * @param {T} schema - The Zod schema to use for validation.
      */
     constructor(schema) {
         this.schema = schema;
-        const { callerInfo, functionName } = getCaller();
-        this.callerInfo = callerInfo;
-        this.functionName = functionName;
     }
     /**
      * Checks if the provided data is valid according to the schema without throwing errors.
@@ -80,7 +71,6 @@ class SchemaValidator {
      * Safely validates data and returns the complete parse result without throwing errors.
      *
      * @param {any} data - The data to validate.
-     *
      * @returns {z.ZodSafeParseResult<z.infer<T>>} The Zod safe parse result containing success status and data or error.
      *
      * @example
@@ -102,10 +92,8 @@ class SchemaValidator {
      * Validates data and returns the parsed result, throwing a ServerError on validation failure.
      *
      * @param {any} data - The data to validate.
-     *
-     * @returns {z.infer<T>} The validated and parsed data.
-     *
      * @throws {ServerError} When validation fails, with a formatted error message.
+     * @returns {z.infer<T>} The validated and parsed data.
      *
      * @example
      * ```typescript
@@ -133,10 +121,8 @@ class SchemaValidator {
      *
      * @param {any} data - The form data to validate.
      * @param {string} [message] - Optional custom error message.
-     *
-     * @returns {z.infer<T>} The validated and parsed form data.
-     *
      * @throws {UnprocessableEntity} When validation fails, with structured field errors for form handling.
+     * @returns {z.infer<T>} The validated and parsed form data.
      *
      * @example
      * ```typescript
@@ -171,10 +157,8 @@ class SchemaValidator {
      *
      * @param {any} data - The form data to validate.
      * @param {string} [message] - Optional custom error message.
-     *
-     * @returns {Promise<z.infer<T>>} A promise that resolves to the validated and parsed form data.
-     *
      * @throws {UnprocessableEntity} When validation fails, with structured field errors for form handling.
+     * @returns {Promise<z.infer<T>>} A promise that resolves to the validated and parsed form data.
      *
      * @example
      * ```typescript

package/dist/validations/validateCep.d.ts

@@ -1,24 +1,19 @@
-type ValidateCepFunction = (rawCep: string) => boolean;
 /**
- * Removes all non-digit characters from the CEP.
- * @param cep - Raw CEP string.
- * @returns Only numeric characters.
- */
-/**
- * Validates a Brazilian CEP (Código de Endereçamento Postal).
+ * Validates a Brazilian CEP (postal code).
  *
- * A valid CEP has 8 numeric digits.
+ * A valid CEP must contain exactly 8 numeric digits,
+ * optionally formatted as "12345-678".
  *
- * @param rawCep - CEP string, may include formatting (e.g., "12345-678").
- * @returns `true` if the CEP is valid, otherwise `false`.
+ * @param {string} rawCep - CEP value, with or without formatting.
+ * @returns {boolean} `true` if the CEP is valid, otherwise `false`.
  *
  * @example
- * ```ts
+ * ```typescript
  * validateCep("12345-678"); // true
  * validateCep("12345678");  // true
  * validateCep("ABCDE-123"); // false
  * ```
  */
-declare const validateCep: ValidateCepFunction;
+declare function validateCep(rawCep: string): boolean;
 export { validateCep };
 //# sourceMappingURL=validateCep.d.ts.map

package/dist/validations/validateCep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateCep.d.ts","sourceRoot":"","sources":["../../src/validations/validateCep.ts"],"names":[],"mappings":"AAEA,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvD;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,QAAA,MAAM,WAAW,EAAE,mBAYlB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"validateCep.d.ts","sourceRoot":"","sources":["../../src/validations/validateCep.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAU5C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}