@arkyn/server 2.0.1-beta.9 → 2.0.2

package/dist/http/successResponses/success.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"success.d.ts","sourceRoot":"","sources":["../../../src/http/successResponses/success.ts"],"names":[],"mappings":"AAAA,cAAM,OAAO,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;gBAEP,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY;IAOxC,UAAU;IAUV,MAAM;CASP;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"success.d.ts","sourceRoot":"","sources":["../../../src/http/successResponses/success.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAM,OAAO,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY;IAOxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CASnB;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/http/successResponses/success.js

@@ -1,14 +1,33 @@
+/**
+ * Represents a successful HTTP response with a status code of 200 (OK).
+ * This class is used to standardize the structure of a "Success" response,
+ * including the response body, headers, status, and status text.
+ *
+ * @template T - The type of the response body.
+ */
 class Success {
     body;
     headers;
     status;
     statusText;
+    /**
+     * Creates an instance of the `Success` class.
+     *
+     * @param body - The response body to be included in the HTTP response.
+     * @param init - Optional initialization object for customizing headers, status, and status text.
+     */
     constructor(body, init) {
         this.body = body;
         this.headers = init?.headers || {};
         this.status = init?.status || 200;
         this.statusText = init?.statusText ?? "OK";
     }
+    /**
+     * Converts the `Success` 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.
+     */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json", ...this.headers },
@@ -17,6 +36,12 @@ class Success {
         };
         return new Response(JSON.stringify(this.body), responseInit);
     }
+    /**
+     * Converts the `Success` instance into a `Response` object using the `Response.json` method.
+     * This method is an alternative to `toResponse` for generating JSON responses.
+     *
+     * @returns A `Response` object with the JSON body and response metadata.
+     */
     toJson() {
         const responseInit = {
             headers: this.headers,

package/dist/http/successResponses/updated.d.ts

@@ -1,10 +1,35 @@
+/**
+ * Represents a successful HTTP response with a status code of 200 (OK) or other custom status codes.
+ * This class is used to standardize the structure of an "Updated" response,
+ * including the response body, headers, status, and status text.
+ *
+ * @template T - The type of the response body.
+ */
 declare class Updated<T> {
     body: T;
     headers: ResponseInit["headers"];
     status: number;
     statusText: string;
+    /**
+     * Creates an instance of the `Updated` class.
+     *
+     * @param body - The response body to be included in the HTTP response.
+     * @param init - Optional initialization object for customizing headers, status, and status text.
+     */
     constructor(body: T, init?: ResponseInit);
+    /**
+     * Converts the `Updated` 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.
+     */
     toResponse(): Response;
+    /**
+     * Converts the `Updated` instance into a `Response` object using the `Response.json` method.
+     * This method is an alternative to `toResponse` for generating JSON responses.
+     *
+     * @returns A `Response` object with the JSON body and response metadata.
+     */
     toJson(): Response;
 }
 export { Updated };

package/dist/http/successResponses/updated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updated.d.ts","sourceRoot":"","sources":["../../../src/http/successResponses/updated.ts"],"names":[],"mappings":"AAAA,cAAM,OAAO,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;gBAEP,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY;IAOxC,UAAU;IAUV,MAAM;CASP;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"updated.d.ts","sourceRoot":"","sources":["../../../src/http/successResponses/updated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAM,OAAO,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;gBAES,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY;IAOxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CASnB;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/http/successResponses/updated.js

@@ -1,14 +1,33 @@
+/**
+ * Represents a successful HTTP response with a status code of 200 (OK) or other custom status codes.
+ * This class is used to standardize the structure of an "Updated" response,
+ * including the response body, headers, status, and status text.
+ *
+ * @template T - The type of the response body.
+ */
 class Updated {
     body;
     headers;
     status;
     statusText;
+    /**
+     * Creates an instance of the `Updated` class.
+     *
+     * @param body - The response body to be included in the HTTP response.
+     * @param init - Optional initialization object for customizing headers, status, and status text.
+     */
     constructor(body, init) {
         this.body = body;
         this.headers = init?.headers || {};
         this.status = init?.status || 200;
         this.statusText = init?.statusText || "Resource updated successfully";
     }
+    /**
+     * Converts the `Updated` 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.
+     */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json", ...this.headers },
@@ -17,6 +36,12 @@ class Updated {
         };
         return new Response(JSON.stringify(this.body), responseInit);
     }
+    /**
+     * Converts the `Updated` instance into a `Response` object using the `Response.json` method.
+     * This method is an alternative to `toResponse` for generating JSON responses.
+     *
+     * @returns A `Response` object with the JSON body and response metadata.
+     */
     toJson() {
         const responseInit = {
             headers: this.headers,

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { ApiInstance } from "./config/apiInstance";
+export { InboxFlowInstance } from "./config/inboxFlowInstance";
 export { BadGateway } from "./http/badResponses/badGateway";
 export { BadRequest } from "./http/badResponses/badRequest";
 export { Conflict } from "./http/badResponses/conflict";
@@ -12,9 +14,13 @@ export { Found } from "./http/successResponses/found";
 export { NoContent } from "./http/successResponses/noContent";
 export { Success } from "./http/successResponses/success";
 export { Updated } from "./http/successResponses/updated";
+export { decodeErrorMessageFromRequest } from "./services/decodeErrorMessageFromRequest";
 export { decodeRequestBody } from "./services/decodeRequestBody";
 export { errorHandler } from "./services/errorHandler";
 export { formParse } from "./services/formParse";
+export { getCaller } from "./services/getCaller";
 export { getScopedParams } from "./services/getScopedParams";
+export { httpDebug } from "./services/httpDebug";
+export { SchemaValidator } from "./services/schemaValidator";
 export { sendFileToS3 } from "./services/sendFileToS3";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,3 +1,7 @@
+// config
+export { ApiInstance } from "./config/apiInstance";
+export { InboxFlowInstance } from "./config/inboxFlowInstance";
+// http bad responses
 export { BadGateway } from "./http/badResponses/badGateway";
 export { BadRequest } from "./http/badResponses/badRequest";
 export { Conflict } from "./http/badResponses/conflict";
@@ -7,13 +11,19 @@ export { NotImplemented } from "./http/badResponses/notImplemented";
 export { ServerError } from "./http/badResponses/serverError";
 export { Unauthorized } from "./http/badResponses/unauthorized";
 export { UnprocessableEntity } from "./http/badResponses/unprocessableEntity";
+// http success responses
 export { Created } from "./http/successResponses/created";
 export { Found } from "./http/successResponses/found";
 export { NoContent } from "./http/successResponses/noContent";
 export { Success } from "./http/successResponses/success";
 export { Updated } from "./http/successResponses/updated";
+// services
+export { decodeErrorMessageFromRequest } from "./services/decodeErrorMessageFromRequest";
 export { decodeRequestBody } from "./services/decodeRequestBody";
 export { errorHandler } from "./services/errorHandler";
 export { formParse } from "./services/formParse";
+export { getCaller } from "./services/getCaller";
 export { getScopedParams } from "./services/getScopedParams";
+export { httpDebug } from "./services/httpDebug";
+export { SchemaValidator } from "./services/schemaValidator";
 export { sendFileToS3 } from "./services/sendFileToS3";

package/dist/services/decodeErrorMessageFromRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Decodes an error message from a given request data object or response object.
+ *
+ * This function attempts to extract a meaningful error message from the provided
+ * `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
+ * 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
+ * representing the HTTP status text.
+ * @returns 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

package/dist/services/decodeErrorMessageFromRequest.d.ts.map

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

package/dist/services/decodeErrorMessageFromRequest.js

@@ -0,0 +1,30 @@
+/**
+ * Decodes an error message from a given request data object or response object.
+ *
+ * This function attempts to extract a meaningful error message from the provided
+ * `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
+ * 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
+ * representing the HTTP status text.
+ * @returns A string representing the decoded error message, or a default message
+ * if no error message is found.
+ */
+function decodeErrorMessageFromRequest(data, response) {
+    if (data?.message && typeof data?.message === "string") {
+        return data?.message;
+    }
+    if (data?.error && typeof data?.error === "string") {
+        return data?.error;
+    }
+    if (data?.error?.message && typeof data?.error?.message === "string") {
+        return data?.error?.message;
+    }
+    if (response?.statusText && typeof response?.statusText === "string") {
+        return response?.statusText;
+    }
+    return "Missing error message";
+}
+export { decodeErrorMessageFromRequest };

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

@@ -1 +1 @@
-{"version":3,"file":"decodeRequestBody.d.ts","sourceRoot":"","sources":["../../src/services/decodeRequestBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,iBAAiB,EAAE,yBA2BxB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"decodeRequestBody.d.ts","sourceRoot":"","sources":["../../src/services/decodeRequestBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAG9D;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,iBAAiB,EAAE,yBAsBxB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/services/decodeRequestBody.js

@@ -1,3 +1,4 @@
+import { BadRequest } from "../http/badResponses/badRequest";
 /**
  * Decodes the body of an incoming request into a JavaScript object.
  *
@@ -13,29 +14,24 @@
  */
 const decodeRequestBody = async (req) => {
     let data;
+    const arrayBuffer = await req.arrayBuffer();
+    const text = new TextDecoder().decode(arrayBuffer);
     try {
-        const arrayBuffer = await req.arrayBuffer();
-        const text = new TextDecoder().decode(arrayBuffer);
+        data = JSON.parse(text);
+    }
+    catch (jsonError) {
         try {
-            data = JSON.parse(text);
-        }
-        catch (jsonError) {
-            try {
+            if (text.includes("=")) {
                 const formData = new URLSearchParams(text);
                 data = Object.fromEntries(formData.entries());
             }
-            catch (formDataError) {
-                console.error("Failed to extract data from request:", {
-                    jsonError,
-                    formDataError,
-                });
-                data = {};
+            else {
+                throw new BadRequest("Invalid URLSearchParams format");
             }
         }
-    }
-    catch (error) {
-        console.error("Failed to read request body:", error);
-        data = {};
+        catch (formDataError) {
+            throw new BadRequest("Failed to extract data from request");
+        }
     }
     return data;
 };

package/dist/services/errorHandler.d.ts

@@ -1,3 +1,44 @@
-declare function errorHandler(error: any): Response | undefined;
+/**
+ * Handles errors and converts them into appropriate HTTP responses.
+ *
+ * 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.
+ *
+ * @param error - The error object to handle. It can be an instance of various
+ * HTTP response classes or a generic error.
+ *
+ * @returns The corresponding HTTP response object if the error matches a known
+ * type, or `undefined` if no match is found.
+ *
+ * ### Supported Success Responses:
+ * - `Found`
+ * - `Created`
+ * - `Updated`
+ * - `Success`
+ * - `NoContent`
+ *
+ * ### Supported Error Responses:
+ * - `BadGateway`
+ * - `BadRequest`
+ * - `Conflict`
+ * - `Forbidden`
+ * - `NotFound`
+ * - `NotImplemented`
+ * - `ServerError`
+ * - `Unauthorized`
+ * - `UnprocessableEntity`
+ *
+ * ### Example Usage:
+ * ```typescript
+ * try {
+ *   // Some operation that might throw an error
+ * } catch (error) {
+ *   return errorHandler(error);
+ * }
+ * ```
+ */
+declare function errorHandler(error: any): Response;
 export { errorHandler };
 //# sourceMappingURL=errorHandler.d.ts.map

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

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

package/dist/services/errorHandler.js

@@ -12,6 +12,47 @@ import { Found } from "../http/successResponses/found";
 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.
+ *
+ * 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.
+ *
+ * @param error - The error object to handle. It can be an instance of various
+ * HTTP response classes or a generic error.
+ *
+ * @returns The corresponding HTTP response object if the error matches a known
+ * type, or `undefined` if no match is found.
+ *
+ * ### Supported Success Responses:
+ * - `Found`
+ * - `Created`
+ * - `Updated`
+ * - `Success`
+ * - `NoContent`
+ *
+ * ### Supported Error Responses:
+ * - `BadGateway`
+ * - `BadRequest`
+ * - `Conflict`
+ * - `Forbidden`
+ * - `NotFound`
+ * - `NotImplemented`
+ * - `ServerError`
+ * - `Unauthorized`
+ * - `UnprocessableEntity`
+ *
+ * ### Example Usage:
+ * ```typescript
+ * try {
+ *   // Some operation that might throw an error
+ * } catch (error) {
+ *   return errorHandler(error);
+ * }
+ * ```
+ */
 function errorHandler(error) {
     switch (true) {
         case error instanceof Response:
@@ -47,5 +88,6 @@ function errorHandler(error) {
         case error instanceof UnprocessableEntity:
             return error.toResponse();
     }
+    return new ServerError("Server error").toResponse();
 }
 export { errorHandler };

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

@@ -1 +1 @@
-{"version":3,"file":"formParse.d.ts","sourceRoot":"","sources":["../../src/services/formParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAS,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAC3C,QAAQ,EACR,MAAM,EACP,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAoB5B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"formParse.d.ts","sourceRoot":"","sources":["../../src/services/formParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAS,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAC3C,QAAQ,EACR,MAAM,EACP,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAmB5B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/formParse.js

@@ -39,8 +39,10 @@
 function formParse([formData, schema,]) {
     const zodResponse = schema.safeParse(formData);
     if (zodResponse.success === false) {
-        const errorsArray = Object.entries(zodResponse.error.formErrors.fieldErrors);
-        const errorsObject = Object.fromEntries(errorsArray.map((item) => [item[0], item[1]?.[0] || "Error"]));
+        const errorsObject = Object.fromEntries(zodResponse.error.errors.map((item) => [
+            item.path.join("."),
+            item.message,
+        ]));
         return {
             success: zodResponse.success,
             fieldErrors: errorsObject,

package/dist/services/getCaller.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Retrieves information about the caller of the current function.
+ *
+ * This function analyzes the stack trace to determine the file path and function name
+ * of the caller. It excludes stack trace entries related to the `@arkyn/server` package
+ * and attempts to resolve the file path relative to the project root directory.
+ *
+ * @returns An object containing:
+ * - `functionName`: The name of the function that called the current function, or "Unknown function" if it cannot be determined.
+ * - `callerInfo`: The file path of the caller relative to the project root, or "Unknown caller" if it cannot be determined.
+ */
+declare function getCaller(): {
+    functionName: string;
+    callerInfo: string;
+};
+export { getCaller };
+//# sourceMappingURL=getCaller.d.ts.map

package/dist/services/getCaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCaller.d.ts","sourceRoot":"","sources":["../../src/services/getCaller.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,iBAAS,SAAS;;;EAyCjB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/getCaller.js

@@ -0,0 +1,45 @@
+import path from "path";
+/**
+ * Retrieves information about the caller of the current function.
+ *
+ * This function analyzes the stack trace to determine the file path and function name
+ * of the caller. It excludes stack trace entries related to the `@arkyn/server` package
+ * and attempts to resolve the file path relative to the project root directory.
+ *
+ * @returns An object containing:
+ * - `functionName`: The name of the function that called the current function, or "Unknown function" if it cannot be determined.
+ * - `callerInfo`: The file path of the caller relative to the project root, or "Unknown caller" if it cannot be determined.
+ */
+function getCaller() {
+    const projectRoot = process.cwd();
+    const error = new Error();
+    const stackLines = error.stack?.split("\n").map((line) => line.trim()) || [];
+    let callerInfo = "Unknown caller";
+    let functionName = "Unknown function";
+    const relevantLines = stackLines.filter((line) => !line.includes("@arkyn/server"));
+    let foundGetCaller = false;
+    for (const line of relevantLines) {
+        if (!foundGetCaller) {
+            if (line.includes("getCaller")) {
+                foundGetCaller = true;
+            }
+            continue;
+        }
+        const match = line.match(/at (.+?) \((.+?)\)/) || line.match(/at (.+)/);
+        if (match) {
+            const rawFuncName = match[1]?.split(" ")[0] || "";
+            functionName =
+                rawFuncName && !rawFuncName.includes("/")
+                    ? rawFuncName
+                    : "Unknown function";
+            let fullPath = match[2] || match[1];
+            if (fullPath.startsWith(projectRoot)) {
+                fullPath = path.relative(projectRoot, fullPath);
+            }
+            callerInfo = fullPath;
+            break;
+        }
+    }
+    return { functionName, callerInfo };
+}
+export { getCaller };

package/dist/services/httpDebug.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Logs debug information to the console when in development mode or when the
+ * `SHOW_ERRORS_IN_CONSOLE` environment variable is set to "true".
+ *
+ * This function provides detailed information about the caller function,
+ * its location, and the provided body and cause, if any.
+ *
+ * @param name - A string representing the name or context of the debug log.
+ * @param body - The main content or data to be logged.
+ * @param cause - (Optional) Additional information or error cause to be logged.
+ *
+ * @remarks
+ * The debug logs are only displayed when the application is running in
+ * development mode (`NODE_ENV === "development"`) or when the
+ * `SHOW_ERRORS_IN_CONSOLE` environment variable is explicitly set to "true".
+ *
+ * The logs include:
+ * - The name of the debug context.
+ * - The caller function name and its location.
+ * - The provided body content.
+ * - The optional cause, if provided.
+ *
+ * @example
+ * ```typescript
+ * httpDebug("FetchUserData", { userId: 123 });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * httpDebug("FetchUserDataError", { userId: 123 }, new Error("User not found"));
+ * ```
+ */
+declare function httpDebug(name: string, body: any, cause?: any): void;
+export { httpDebug };
+//# sourceMappingURL=httpDebug.d.ts.map

package/dist/services/httpDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpDebug.d.ts","sourceRoot":"","sources":["../../src/services/httpDebug.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,QAyBtD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/httpDebug.js

@@ -0,0 +1,56 @@
+import { InboxFlowInstance } from "../config/inboxFlowInstance";
+import { getCaller } from "../services/getCaller";
+/**
+ * Logs debug information to the console when in development mode or when the
+ * `SHOW_ERRORS_IN_CONSOLE` environment variable is set to "true".
+ *
+ * This function provides detailed information about the caller function,
+ * its location, and the provided body and cause, if any.
+ *
+ * @param name - A string representing the name or context of the debug log.
+ * @param body - The main content or data to be logged.
+ * @param cause - (Optional) Additional information or error cause to be logged.
+ *
+ * @remarks
+ * The debug logs are only displayed when the application is running in
+ * development mode (`NODE_ENV === "development"`) or when the
+ * `SHOW_ERRORS_IN_CONSOLE` environment variable is explicitly set to "true".
+ *
+ * The logs include:
+ * - The name of the debug context.
+ * - The caller function name and its location.
+ * - The provided body content.
+ * - The optional cause, if provided.
+ *
+ * @example
+ * ```typescript
+ * httpDebug("FetchUserData", { userId: 123 });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * httpDebug("FetchUserDataError", { userId: 123 }, new Error("User not found"));
+ * ```
+ */
+function httpDebug(name, body, cause) {
+    const isDebugMode = process.env.NODE_ENV === "development" ||
+        process.env?.SHOW_ERRORS_IN_CONSOLE === "true";
+    if (isDebugMode) {
+        const reset = "\x1b[0m";
+        const cyan = "\x1b[36m";
+        const debugName = `${cyan}[ARKYN-DEBUG]${reset}`;
+        const { callerInfo, functionName } = getCaller();
+        let consoleData = `${debugName} ${name} initialized\n`;
+        consoleData += `${debugName} Caller Function: ${functionName}\n`;
+        consoleData += `${debugName} Caller Location: ${callerInfo}\n`;
+        consoleData += `${debugName} Body: ${JSON.stringify(body, null, 2)}\n`;
+        if (cause) {
+            consoleData += `${debugName} Cause: ${JSON.stringify(cause, null, 2)}\n`;
+        }
+        console.log(consoleData);
+        const arkynKeys = InboxFlowInstance.getInboxConfig();
+        if (arkynKeys)
+            console.log(arkynKeys);
+    }
+}
+export { httpDebug };

package/dist/services/schemaValidator.d.ts

@@ -0,0 +1,13 @@
+import { Schema, z } from "zod";
+declare class SchemaValidator<T extends Schema> {
+    readonly schema: T;
+    functionName: string;
+    callerInfo: string;
+    constructor(schema: T);
+    isValid(data: any): boolean;
+    safeValidate(data: any): z.SafeParseReturnType<z.infer<T>, z.infer<T>>;
+    validate(data: any): z.infer<T>;
+    formValidate(data: any, message?: string): z.infer<T>;
+}
+export { SchemaValidator };
+//# sourceMappingURL=schemaValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.d.ts","sourceRoot":"","sources":["../../src/services/schemaValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBhC,cAAM,eAAe,CAAC,CAAC,SAAS,MAAM;IAIxB,QAAQ,CAAC,MAAM,EAAE,CAAC;IAH9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;gBAEE,MAAM,EAAE,CAAC;IAM9B,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;IAI3B,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAItE,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAQ/B,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAoBtD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}