@arkyn/server 3.0.1-beta.154 → 3.0.1-beta.156

package/dist/modules/http/successResponses/noContent.js

@@ -0,0 +1,21 @@
+import { SuccessResponse as s } from "./_successResponse.js";
+class o extends s {
+  /**
+   * @param message - Description included in the response status text.
+   */
+  constructor(t) {
+    super(), this.name = "NoContent", this.status = 204, this.statusText = t, this.onDebug();
+  }
+  /** Converts to a `Response` with `Content-Type: application/json` header and no body. */
+  toResponse() {
+    const t = {
+      headers: { "Content-Type": "application/json" },
+      status: this.status,
+      statusText: this.statusText
+    };
+    return new Response(null, t);
+  }
+}
+export {
+  o as NoContent
+};

package/dist/modules/http/successResponses/success.js

@@ -0,0 +1,30 @@
+import { SuccessResponse as e } from "./_successResponse.js";
+class i extends e {
+  /**
+   * @param message - Description included in the response status text.
+   * @param body - Data to include in the response body.
+   */
+  constructor(s, t) {
+    super(), this.name = "Success", this.status = 200, this.statusText = s, this.body = t || void 0, this.onDebug();
+  }
+  /** Converts to a `Response` with `Content-Type: application/json` header. */
+  toResponse() {
+    const s = {
+      headers: { "Content-Type": "application/json" },
+      status: this.status,
+      statusText: this.statusText
+    };
+    return new Response(JSON.stringify(this.body), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.body, s);
+  }
+}
+export {
+  i as Success
+};

package/dist/modules/http/successResponses/updated.js

@@ -0,0 +1,30 @@
+import { SuccessResponse as e } from "./_successResponse.js";
+class i extends e {
+  /**
+   * @param message - Description included in the response status text.
+   * @param body - Data to include in the response body.
+   */
+  constructor(s, t) {
+    super(), this.name = "Updated", this.status = 200, this.statusText = s, this.body = t || void 0, this.onDebug();
+  }
+  /** Converts to a `Response` with `Content-Type: application/json` header. */
+  toResponse() {
+    const s = {
+      headers: { "Content-Type": "application/json" },
+      status: this.status,
+      statusText: this.statusText
+    };
+    return new Response(JSON.stringify(this.body), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.body, s);
+  }
+}
+export {
+  i as Updated
+};

package/dist/modules/index.js

@@ -0,0 +1,68 @@
+import { BadGateway as e } from "./http/badResponses/badGateway.js";
+import { BadRequest as p } from "./http/badResponses/badRequest.js";
+import { Conflict as f } from "./http/badResponses/conflict.js";
+import { Forbidden as x } from "./http/badResponses/forbidden.js";
+import { NotFound as i } from "./http/badResponses/notFound.js";
+import { NotImplemented as l } from "./http/badResponses/notImplemented.js";
+import { ServerError as c } from "./http/badResponses/serverError.js";
+import { Unauthorized as u } from "./http/badResponses/unauthorized.js";
+import { UnprocessableEntity as S } from "./http/badResponses/unprocessableEntity.js";
+import { Created as P } from "./http/successResponses/created.js";
+import { Found as h } from "./http/successResponses/found.js";
+import { NoContent as E } from "./http/successResponses/noContent.js";
+import { Success as q } from "./http/successResponses/success.js";
+import { Updated as D } from "./http/successResponses/updated.js";
+import { ApiService as N } from "./services/apiService.js";
+import { DebugService as w } from "./services/debugService.js";
+import { LogService as L } from "./services/logService.js";
+import { decodeRequestBody as z } from "./utilities/decodeRequestBody.js";
+import { decodeRequestErrorMessage as H } from "./utilities/decodeRequestErrorMessage.js";
+import { errorHandler as M } from "./utilities/errorHandler.js";
+import { flushDebugLogs as k } from "./utilities/flushDebugLogs.js";
+import { formAsyncParse as K } from "./utilities/formAsyncParse.js";
+import { formParse as Q } from "./utilities/formParse.js";
+import { getScopedParams as W } from "./utilities/getScopedParams.js";
+import { SchemaValidator as Y } from "./utilities/schemaValidator.js";
+import { validateCep as _ } from "./validations/validateCep.js";
+import { validateCnpj as rr } from "./validations/validateCnpj.js";
+import { validateCpf as er } from "./validations/validateCpf.js";
+import { validateDate as pr } from "./validations/validateDate.js";
+import { validateEmail as fr } from "./validations/validateEmail.js";
+import { validatePassword as xr } from "./validations/validatePassword.js";
+import { validatePhone as ir } from "./validations/validatePhone.js";
+import { validateRg as lr } from "./validations/validateRg.js";
+export {
+  N as ApiService,
+  e as BadGateway,
+  p as BadRequest,
+  f as Conflict,
+  P as Created,
+  w as DebugService,
+  x as Forbidden,
+  h as Found,
+  L as LogService,
+  E as NoContent,
+  i as NotFound,
+  l as NotImplemented,
+  Y as SchemaValidator,
+  c as ServerError,
+  q as Success,
+  u as Unauthorized,
+  S as UnprocessableEntity,
+  D as Updated,
+  z as decodeRequestBody,
+  H as decodeRequestErrorMessage,
+  M as errorHandler,
+  k as flushDebugLogs,
+  K as formAsyncParse,
+  Q as formParse,
+  W as getScopedParams,
+  _ as validateCep,
+  rr as validateCnpj,
+  er as validateCpf,
+  pr as validateDate,
+  fr as validateEmail,
+  xr as validatePassword,
+  ir as validatePhone,
+  lr as validateRg
+};

package/dist/modules/services/apiService.js

@@ -0,0 +1,129 @@
+var b = Object.defineProperty;
+var l = (n, s, e) => s in n ? b(n, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[s] = e;
+var h = (n, s, e) => l(n, typeof s != "symbol" ? s + "" : s, e);
+import { deleteRequest as g } from "../http/api/deleteRequest.js";
+import { getRequest as m } from "../http/api/getRequest.js";
+import { patchRequest as c } from "../http/api/patchRequest.js";
+import { postRequest as t } from "../http/api/postRequest.js";
+import { putRequest as p } from "../http/api/putRequest.js";
+import { flushDebugLogs as y } from "../utilities/flushDebugLogs.js";
+class w {
+  constructor(s) {
+    h(this, "baseUrl");
+    h(this, "baseHeaders");
+    h(this, "baseToken");
+    h(this, "enableDebug");
+    this.baseUrl = s.baseUrl, this.baseHeaders = s.baseHeaders || void 0, this.baseToken = s.baseToken || void 0, this.enableDebug = s.enableDebug || !1;
+  }
+  onDebug(s, e, r) {
+    if (this.enableDebug) {
+      const o = [], u = (i) => JSON.stringify(i, null, 2);
+      o.push(`Base URL: ${this.baseUrl}`), o.push(`Endpoint: ${s}`), o.push(`Status/Method: ${e} => ${r.status}`), o.push(`Message: ${r.message}`), r.headers && o.push(`Headers: ${u(r.headers)}`), r.body && o.push(`Body: ${u(r.body)}`), y({ debugs: o, name: "ApiDebug", scheme: "yellow" });
+    }
+  }
+  generateHeaders(s, e) {
+    let r = {};
+    return this.baseToken && (r = { Authorization: `Bearer ${this.baseToken}` }), this.baseHeaders && (r = { ...r, ...this.baseHeaders }), s && (r = { ...r, ...s }), e && (r = { ...r, Authorization: `Bearer ${e}` }), r;
+  }
+  /**
+   * Sends a get request to the specified endpoint.
+   * @param endpoint - The API endpoint to send the get request to.
+   * @param data - The request data, including optional headers and token.
+   * @returns The API response data.
+   */
+  async get(s, e) {
+    const r = this.generateHeaders((e == null ? void 0 : e.headers) || {}, e == null ? void 0 : e.token), o = await m({
+      url: this.baseUrl + s,
+      urlParams: (e == null ? void 0 : e.urlParams) || {},
+      headers: r
+    });
+    return this.onDebug(s, "get", {
+      headers: r,
+      message: o.message,
+      status: o.status
+    }), o;
+  }
+  /**
+   * Sends a post request to the specified endpoint.
+   * @param endpoint - The API endpoint to send the post request to.
+   * @param data - The request data, including body, optional headers, and token.
+   * @returns The API response data.
+   */
+  async post(s, e) {
+    const r = this.generateHeaders((e == null ? void 0 : e.headers) || {}, e == null ? void 0 : e.token), o = e == null ? void 0 : e.body, u = await t({
+      url: this.baseUrl + s,
+      urlParams: (e == null ? void 0 : e.urlParams) || {},
+      headers: r,
+      body: o
+    });
+    return this.onDebug(s, "post", {
+      headers: r,
+      body: o,
+      message: u.message,
+      status: u.status
+    }), u;
+  }
+  /**
+   * Sends a put request to the specified endpoint.
+   * @param endpoint - The API endpoint to send the put request to.
+   * @param data - The request data, including body, optional headers, and token.
+   * @returns The API response data.
+   */
+  async put(s, e) {
+    const r = this.generateHeaders((e == null ? void 0 : e.headers) || {}, e == null ? void 0 : e.token), o = e == null ? void 0 : e.body, u = await p({
+      url: this.baseUrl + s,
+      urlParams: (e == null ? void 0 : e.urlParams) || {},
+      headers: r,
+      body: o
+    });
+    return this.onDebug(s, "put", {
+      headers: r,
+      body: o,
+      message: u.message,
+      status: u.status
+    }), u;
+  }
+  /**
+   * Sends a patch request to the specified endpoint.
+   * @param endpoint - The API endpoint to send the patch request to.
+   * @param data - The request data, including body, optional headers, and token.
+   * @returns The API response data.
+   */
+  async patch(s, e) {
+    const r = this.generateHeaders((e == null ? void 0 : e.headers) || {}, e == null ? void 0 : e.token), o = e == null ? void 0 : e.body, u = await c({
+      url: this.baseUrl + s,
+      urlParams: (e == null ? void 0 : e.urlParams) || {},
+      headers: r,
+      body: o
+    });
+    return this.onDebug(s, "patch", {
+      headers: r,
+      body: o,
+      message: u.message,
+      status: u.status
+    }), u;
+  }
+  /**
+   * Sends a delete request to the specified endpoint.
+   * @param endpoint - The API endpoint to send the delete request to.
+   * @param data - The request data, including body, optional headers, and token.
+   * @returns The API response data.
+   */
+  async delete(s, e) {
+    const r = this.generateHeaders((e == null ? void 0 : e.headers) || {}, e == null ? void 0 : e.token), o = e == null ? void 0 : e.body, u = await g({
+      url: this.baseUrl + s,
+      urlParams: (e == null ? void 0 : e.urlParams) || {},
+      headers: r,
+      body: o
+    });
+    return this.onDebug(s, "delete", {
+      headers: r,
+      body: o,
+      message: u.message,
+      status: u.status
+    }), u;
+  }
+}
+export {
+  w as ApiService
+};

package/dist/modules/services/debugService.js

@@ -0,0 +1,66 @@
+var u = Object.defineProperty;
+var g = (i, t, l) => t in i ? u(i, t, { enumerable: !0, configurable: !0, writable: !0, value: l }) : i[t] = l;
+var d = (i, t, l) => g(i, typeof t != "symbol" ? t + "" : t, l);
+import m from "node:path";
+class f {
+  /**
+   * Adds a file name to the ignore list so it is skipped when resolving the caller in stack traces.
+   *
+   * @param file - File name to ignore (e.g. `"httpAdapter.ts"`).
+   */
+  static setIgnoreFile(t) {
+    this.ignoreFiles.push(t);
+  }
+  /** Resets the ignore list, restoring full stack trace analysis. */
+  static clearIgnoreFiles() {
+    this.ignoreFiles = [];
+  }
+  /**
+   * Resolves the file path and function name of the code that triggered the current debug call,
+   * skipping internal node modules and any files registered with `setIgnoreFile`.
+   *
+   * @returns `{ functionName, callerInfo }` — caller function name and file path relative to `process.cwd()`.
+   */
+  static getCaller() {
+    const t = process.cwd(), c = (new Error().stack || "").split(`
+`).map((s) => s.trim());
+    let n = 2;
+    for (; n < c.length && (c[n].includes("node:internal") || c[n].includes("/node_modules/")); )
+      n++;
+    if (this.ignoreFiles.length > 0)
+      for (; n < c.length && this.ignoreFiles.some(
+        (s) => c[n].includes(s)
+      ); )
+        n++;
+    const h = c[n] || "";
+    let o = "Unknown function", e = "Unknown caller";
+    const a = h.match(/at\s+([^(\s]+)\s+\(([^)]+)\)/);
+    if (a)
+      o = a[1], e = a[2];
+    else {
+      const s = h.match(/at\s+(.+)/);
+      if (s) {
+        e = s[1];
+        const r = e.match(/at\s+([^(\s]+)\s+/);
+        r && r[1] !== "new" && (o = r[1]);
+      }
+    }
+    e.includes("(") && (e = e.substring(
+      e.indexOf("(") + 1,
+      e.lastIndexOf(")")
+    )), e = e.split(":").slice(0, -2).join(":");
+    try {
+      e = m.relative(t, e);
+    } catch {
+    }
+    return { functionName: o, callerInfo: e };
+  }
+}
+/**
+ * The name of the file to ignore when analyzing the stack trace.
+ * When set, the `getCaller` function will skip stack frames containing this file name.
+ */
+d(f, "ignoreFiles", []);
+export {
+  f as DebugService
+};

package/dist/modules/services/logMapperService.js

@@ -0,0 +1,52 @@
+class n {
+  /**
+   * 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
+   */
+  static mapHeaders(e) {
+    return e instanceof Headers ? Object.fromEntries(e.entries()) : typeof e == "object" ? Object.entries(e).reduce(
+      (r, [t, s]) => (typeof s == "string" ? r[t] = s : Array.isArray(s) ? r[t] = s.join(", ") : r[t] = JSON.stringify(s), r),
+      {}
+    ) : {};
+  }
+  /**
+   * 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
+   */
+  static mapQueryParams(e) {
+    const r = {};
+    return e.forEach((t, s) => r[s] = t), r;
+  }
+  /**
+   * 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(e) {
+    return {
+      rawUrl: e.rawUrl,
+      status: e.status,
+      method: e.method,
+      token: null,
+      elapsedTime: e.elapsedTime,
+      requestHeaders: this.mapHeaders(e.requestHeaders),
+      requestBody: e.requestBody || null,
+      queryParams: {
+        ...this.mapQueryParams(e.queryParams),
+        ...e.urlParams
+      },
+      responseHeaders: this.mapHeaders(e.responseHeaders),
+      responseBody: e.responseBody || null
+    };
+  }
+}
+export {
+  n as LogMapperService
+};

package/dist/modules/services/logService.js

@@ -0,0 +1,31 @@
+var r = Object.defineProperty;
+var g = (i, t, s) => t in i ? r(i, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : i[t] = s;
+var o = (i, t, s) => g(i, typeof t != "symbol" ? t + "" : t, s);
+class f {
+  /**
+   * Sets the log service configuration once. Subsequent calls are ignored.
+   *
+   * @param config.trafficSourceId - Traffic source identifier.
+   * @param config.userToken - User token for authentication.
+   * @param config.logBaseApiUrl - Override the default log ingestion base URL.
+   */
+  static setConfig(t) {
+    if (this.config) return;
+    const { trafficSourceId: s, userToken: c, logBaseApiUrl: n } = t, e = `${n || "http://62.238.8.44:8081"}/ingest-log`;
+    this.config = { trafficSourceId: s, userToken: c, apiUrl: e };
+  }
+  /** Returns the stored configuration, or `undefined` if `setConfig` has not been called. */
+  static getConfig() {
+    return this.config;
+  }
+  /**
+   * Resets the stored configuration, allowing a new initialization.
+   */
+  static resetConfig() {
+    this.config = void 0;
+  }
+}
+o(f, "config");
+export {
+  f as LogService
+};

package/dist/modules/utilities/decodeRequestBody.js

@@ -0,0 +1,22 @@
+import { BadRequest as a } from "../http/badResponses/badRequest.js";
+async function d(o) {
+  let r;
+  const c = await o.arrayBuffer(), e = new TextDecoder().decode(c);
+  try {
+    r = JSON.parse(e);
+  } catch {
+    try {
+      if (e.includes("=")) {
+        const t = new URLSearchParams(e);
+        r = Object.fromEntries(t.entries());
+      } else
+        throw new a("Invalid URLSearchParams format");
+    } catch {
+      throw new a("Failed to extract data from request");
+    }
+  }
+  return r;
+}
+export {
+  d as decodeRequestBody
+};

package/dist/modules/utilities/decodeRequestErrorMessage.js

@@ -0,0 +1,7 @@
+function o(r, e) {
+  var g, i, f;
+  return r != null && r.message && typeof (r == null ? void 0 : r.message) == "string" ? r == null ? void 0 : r.message : r != null && r.operator_erro_message && typeof (r == null ? void 0 : r.operator_erro_message) == "string" ? r == null ? void 0 : r.operator_erro_message : r != null && r.error && typeof (r == null ? void 0 : r.error) == "string" ? r == null ? void 0 : r.error : (g = r == null ? void 0 : r.error) != null && g.message && typeof ((i = r == null ? void 0 : r.error) == null ? void 0 : i.message) == "string" ? (f = r == null ? void 0 : r.error) == null ? void 0 : f.message : e != null && e.statusText && typeof (e == null ? void 0 : e.statusText) == "string" ? e == null ? void 0 : e.statusText : "Missing error message";
+}
+export {
+  o as decodeRequestErrorMessage
+};

package/dist/modules/utilities/errorHandler.js

@@ -0,0 +1,54 @@
+import { BadGateway as e } from "../http/badResponses/badGateway.js";
+import { BadRequest as s } from "../http/badResponses/badRequest.js";
+import { Conflict as o } from "../http/badResponses/conflict.js";
+import { Forbidden as a } from "../http/badResponses/forbidden.js";
+import { NotFound as c } from "../http/badResponses/notFound.js";
+import { NotImplemented as i } from "../http/badResponses/notImplemented.js";
+import { ServerError as n } from "../http/badResponses/serverError.js";
+import { Unauthorized as p } from "../http/badResponses/unauthorized.js";
+import { UnprocessableEntity as f } from "../http/badResponses/unprocessableEntity.js";
+import { Created as m } from "../http/successResponses/created.js";
+import { Found as u } from "../http/successResponses/found.js";
+import { NoContent as R } from "../http/successResponses/noContent.js";
+import { Success as d } from "../http/successResponses/success.js";
+import { Updated as l } from "../http/successResponses/updated.js";
+function z(t) {
+  switch (!0) {
+    case t instanceof Response:
+      return t;
+    case t instanceof u:
+      return t.toResponse();
+    case t instanceof m:
+      return t.toResponse();
+    case t instanceof l:
+      return t.toResponse();
+    case t instanceof d:
+      return t.toResponse();
+    case t instanceof R:
+      return t.toResponse();
+  }
+  switch (!0) {
+    case t instanceof e:
+      return t.toResponse();
+    case t instanceof s:
+      return t.toResponse();
+    case t instanceof o:
+      return t.toResponse();
+    case t instanceof a:
+      return t.toResponse();
+    case t instanceof c:
+      return t.toResponse();
+    case t instanceof i:
+      return t.toResponse();
+    case t instanceof n:
+      return t.toResponse();
+    case t instanceof p:
+      return t.toResponse();
+    case t instanceof f:
+      return t.toResponse();
+  }
+  return new n("Server error", t).toResponse();
+}
+export {
+  z as errorHandler
+};

package/dist/modules/utilities/flushDebugLogs.js

@@ -0,0 +1,20 @@
+function r(e) {
+  var s;
+  if (process.env.NODE_ENV === "development" || ((s = process.env) == null ? void 0 : s.DEBUG_MODE) === "true") {
+    const n = `${{
+      yellow: "\x1B[33m",
+      cyan: "\x1B[36m",
+      red: "\x1B[31m",
+      green: "\x1B[32m"
+    }[e.scheme]}[${e.name}]\x1B[0m`;
+    let o = `
+`;
+    e.debugs.forEach((c, t) => {
+      o += `${n} ${c.trim()}`, t < e.debugs.length - 1 && (o += `
+`);
+    }), console.log(o);
+  }
+}
+export {
+  r as flushDebugLogs
+};

package/dist/modules/utilities/formAsyncParse.js

@@ -0,0 +1,19 @@
+async function a([
+  e,
+  c
+]) {
+  const s = await c.safeParseAsync(e);
+  return s.success === !1 ? {
+    success: !1,
+    fieldErrors: Object.fromEntries(
+      s.error.issues.map((r) => [r.path.join("."), r.message])
+    ),
+    fields: e
+  } : {
+    success: !0,
+    data: s.data
+  };
+}
+export {
+  a as formAsyncParse
+};

package/dist/modules/utilities/formParse.js

@@ -0,0 +1,19 @@
+function o([
+  e,
+  t
+]) {
+  const s = t.safeParse(e);
+  return s.success === !1 ? {
+    success: !1,
+    fieldErrors: Object.fromEntries(
+      s.error.issues.map((r) => [r.path.join("."), r.message])
+    ),
+    fields: e
+  } : {
+    success: !0,
+    data: s.data
+  };
+}
+export {
+  o as formParse
+};

package/dist/modules/utilities/getScopedParams.js

@@ -0,0 +1,11 @@
+function c(t, r = "") {
+  const e = new URL(t.url);
+  if (r === "") return e.searchParams;
+  const s = Array.from(
+    e.searchParams.entries()
+  ).filter(([a]) => a.startsWith(`${r}:`)).map(([a, n]) => [a.replace(`${r}:`, ""), n]);
+  return new URLSearchParams(s);
+}
+export {
+  c as getScopedParams
+};