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

package/dist/modules/http/api/_logRequest.js

@@ -0,0 +1,69 @@
+import { formatJsonObject as w } from "@arkyn/shared";
+import { LogService as x } from "../../services/logService.js";
+import { flushDebugLogs as n } from "../../utilities/flushDebugLogs.js";
+async function B(a) {
+  const r = x.getConfig();
+  if (!r) return;
+  const { userToken: i, apiUrl: c, trafficSourceId: u } = r, {
+    elapsedTime: p,
+    method: d,
+    queryParams: f,
+    requestBody: m,
+    requestHeaders: l,
+    responseBody: g,
+    responseHeaders: h,
+    status: y,
+    token: L,
+    rawUrl: S
+  } = a;
+  if (process.env.NODE_ENV !== "development")
+    try {
+      const e = new URL(S);
+      let o = "https";
+      e.protocol === "http:" && (o = "http");
+      const N = JSON.stringify({
+        domainUrl: e.protocol + "//" + e.host,
+        pathnameUrl: e.pathname,
+        trafficSourceId: u,
+        status: y,
+        protocol: o,
+        method: d.toLowerCase(),
+        trafficUserId: null,
+        elapsedTime: p,
+        requestHeaders: JSON.stringify(l),
+        requestBody: JSON.stringify(m),
+        queryParams: JSON.stringify(f),
+        responseHeaders: JSON.stringify(h),
+        responseBody: JSON.stringify(g)
+      }), O = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${i}`
+      }, t = await fetch(c, {
+        method: "POST",
+        body: N,
+        headers: O
+      });
+      if (!t.ok) {
+        const q = await t.text(), J = t.status, T = t.statusText, s = await t.json().catch(() => null);
+        n({
+          name: "LogError",
+          scheme: "red",
+          debugs: [
+            "Failed to log request.",
+            `Status: ${J} ${T}.`,
+            `Status text: ${q}.`,
+            `JSON Response: ${s ? w(s, 0) : "No JSON response"}`
+          ]
+        });
+      }
+    } catch (e) {
+      n({
+        debugs: [`Error sending request: ${e}`],
+        name: "LogError",
+        scheme: "red"
+      });
+    }
+}
+export {
+  B as logRequest
+};

package/dist/modules/http/api/_makeRequest.js

@@ -0,0 +1,69 @@
+import { flushDebugLogs as n } from "../../utilities/flushDebugLogs.js";
+import { LogMapperService as d } from "../../services/logMapperService.js";
+import { logRequest as f } from "./_logRequest.js";
+async function i(e) {
+  let a = e.url;
+  e.urlParams && Object.entries(e.urlParams).forEach(([r, c]) => {
+    a = a.replaceAll(`:${r}`, c);
+  });
+  const u = {
+    POST: "Resource created successfully",
+    PUT: "Resource updated successfully",
+    DELETE: "Resource deleted successfully",
+    PATCH: "Resource patched successfully",
+    GET: "Request successful"
+  };
+  try {
+    const r = performance.now(), c = { ...e.headers, "Content-Type": "application/json" }, o = await fetch(a, {
+      headers: c,
+      method: e.method,
+      body: e.body ? JSON.stringify(e.body) : void 0
+    }), l = performance.now() - r, t = o.status;
+    let s = null;
+    try {
+      s = await o.json();
+    } catch {
+      s = null;
+    }
+    const m = d.handle({
+      elapsedTime: l,
+      method: e.method,
+      queryParams: new URL(a).searchParams,
+      requestHeaders: c,
+      requestBody: e.body,
+      responseBody: s,
+      responseHeaders: o.headers,
+      status: t,
+      rawUrl: e.url,
+      urlParams: e.urlParams
+    });
+    return f(m), o.ok ? {
+      success: !0,
+      status: t,
+      message: (s == null ? void 0 : s.message) || u[e.method],
+      response: s,
+      cause: null
+    } : {
+      success: !1,
+      status: t,
+      message: (s == null ? void 0 : s.message) || o.statusText || "Request failed",
+      response: s,
+      cause: null
+    };
+  } catch (r) {
+    return n({
+      debugs: [`Network error or request failed: ${r}`],
+      name: "MakeRequestError",
+      scheme: "red"
+    }), {
+      success: !1,
+      status: 0,
+      message: "Network error or request failed",
+      response: null,
+      cause: r instanceof Error ? r.message : String(r)
+    };
+  }
+}
+export {
+  i as makeRequest
+};

package/dist/modules/http/api/deleteRequest.js

@@ -0,0 +1,13 @@
+import { makeRequest as r } from "./_makeRequest.js";
+async function o(e) {
+  return r({
+    method: "DELETE",
+    url: e.url,
+    urlParams: e.urlParams,
+    headers: e.headers,
+    body: e.body
+  });
+}
+export {
+  o as deleteRequest
+};

package/dist/modules/http/api/getRequest.js

@@ -0,0 +1,12 @@
+import { makeRequest as r } from "./_makeRequest.js";
+async function s(e) {
+  return r({
+    method: "GET",
+    url: e.url,
+    urlParams: e.urlParams,
+    headers: e.headers
+  });
+}
+export {
+  s as getRequest
+};

package/dist/modules/http/api/patchRequest.js

@@ -0,0 +1,13 @@
+import { makeRequest as e } from "./_makeRequest.js";
+async function o(r) {
+  return e({
+    method: "PATCH",
+    url: r.url,
+    urlParams: r.urlParams,
+    headers: r.headers,
+    body: r.body
+  });
+}
+export {
+  o as patchRequest
+};

package/dist/modules/http/api/postRequest.js

@@ -0,0 +1,13 @@
+import { makeRequest as e } from "./_makeRequest.js";
+async function o(r) {
+  return e({
+    method: "POST",
+    url: r.url,
+    urlParams: r.urlParams,
+    headers: r.headers,
+    body: r.body
+  });
+}
+export {
+  o as postRequest
+};

package/dist/modules/http/api/putRequest.js

@@ -0,0 +1,13 @@
+import { makeRequest as e } from "./_makeRequest.js";
+async function o(r) {
+  return e({
+    method: "PUT",
+    url: r.url,
+    urlParams: r.urlParams,
+    headers: r.headers,
+    body: r.body
+  });
+}
+export {
+  o as putRequest
+};

package/dist/modules/http/badResponses/_badResponse.js

@@ -0,0 +1,59 @@
+var r = Object.defineProperty;
+var n = (t, s, e) => s in t ? r(t, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[s] = e;
+var u = (t, s, e) => n(t, typeof s != "symbol" ? s + "" : s, e);
+import { formatJsonString as o } from "@arkyn/shared";
+import { DebugService as i } from "../../services/debugService.js";
+import { flushDebugLogs as h } from "../../utilities/flushDebugLogs.js";
+class l {
+  constructor() {
+    u(this, "_cause");
+    u(this, "_name", "BadResponse");
+    u(this, "_status", 500);
+    u(this, "_statusText", "Unknown error");
+    u(this, "_debugColor", "red");
+  }
+  get cause() {
+    return this._cause;
+  }
+  set cause(s) {
+    this._cause = s;
+  }
+  get name() {
+    return this._name;
+  }
+  set name(s) {
+    this._name = s;
+  }
+  get status() {
+    return this._status;
+  }
+  set status(s) {
+    this._status = s;
+  }
+  get statusText() {
+    return this._statusText;
+  }
+  set statusText(s) {
+    this._statusText = s;
+  }
+  get debugColor() {
+    return this._debugColor;
+  }
+  set debugColor(s) {
+    ["green", "yellow", "cyan", "red"].includes(s) && (this._debugColor = s);
+  }
+  onDebug() {
+    const s = [], { callerInfo: e, functionName: a } = i.getCaller();
+    s.push(`Caller Function: ${a}`), s.push(`Caller Location: ${e}`), this._statusText && s.push(`Message: ${this._statusText}`), this._cause && s.push(`Cause: ${o(JSON.stringify(this._cause))}`), h({ scheme: "red", name: this._name, debugs: s });
+  }
+  makeBody() {
+    return {
+      name: this._name,
+      message: this._statusText,
+      cause: this._cause
+    };
+  }
+}
+export {
+  l as BadResponse
+};

package/dist/modules/http/badResponses/badGateway.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class o extends e {
+  /**
+   * @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(s, t) {
+    super(), this.name = "BadGateway", this.status = 502, this.statusText = s, this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  o as BadGateway
+};

package/dist/modules/http/badResponses/badRequest.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "BadRequest", this.status = 400, this.statusText = s, this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  i as BadRequest
+};

package/dist/modules/http/badResponses/conflict.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "Conflict", this.status = 409, this.statusText = s, this.debugColor = "yellow", this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  i as Conflict
+};

package/dist/modules/http/badResponses/forbidden.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "Forbidden", this.status = 403, this.statusText = s, this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  i as Forbidden
+};

package/dist/modules/http/badResponses/notFound.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "NotFound", this.status = 404, this.statusText = s, this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  i as NotFound
+};

package/dist/modules/http/badResponses/notImplemented.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(t, s) {
+    super(), this.name = "NotImplemented", this.status = 501, this.statusText = t, this.cause = s ? JSON.stringify(s) : void 0, this.onDebug();
+  }
+  /** Converts to a `Response` with `Content-Type: application/json` header. */
+  toResponse() {
+    const t = {
+      headers: { "Content-Type": "application/json" },
+      status: this.status,
+      statusText: this.statusText
+    };
+    return new Response(JSON.stringify(this.makeBody()), t);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const t = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), t);
+  }
+}
+export {
+  i as NotImplemented
+};

package/dist/modules/http/badResponses/serverError.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class r extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "ServerError", this.status = 500, this.statusText = s, this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  r as ServerError
+};

package/dist/modules/http/badResponses/unauthorized.js

@@ -0,0 +1,30 @@
+import { BadResponse as e } from "./_badResponse.js";
+class i extends e {
+  /**
+   * @param message - Error description.
+   * @param cause - Optional extra context (serialized to JSON).
+   */
+  constructor(s, t) {
+    super(), this.name = "Unauthorized", this.status = 401, this.statusText = s, this.debugColor = "yellow", this.cause = t ? JSON.stringify(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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  i as Unauthorized
+};

package/dist/modules/http/badResponses/unprocessableEntity.js

@@ -0,0 +1,36 @@
+import { BadResponse as t } from "./_badResponse.js";
+class o extends t {
+  /**
+   * @param props.message - Human-readable description of the error.
+   * @param props.fieldErrors - Per-field validation messages keyed by field name.
+   * @param props.fields - Original submitted field values (useful for repopulating forms).
+   * @param props.data - Any extra data to include in the response body.
+   */
+  constructor(s) {
+    super(), this.name = "UnprocessableEntity", this.status = 422, this.statusText = s.message || "Unprocessable entity", this.debugColor = "yellow", this.cause = {
+      data: s.data,
+      fieldErrors: s.fieldErrors,
+      fields: s.fields
+    }, 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.makeBody()), s);
+  }
+  /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
+  toJson() {
+    const s = {
+      status: this.status,
+      statusText: this.statusText
+    };
+    return Response.json(this.makeBody(), s);
+  }
+}
+export {
+  o as UnprocessableEntity
+};

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

@@ -0,0 +1,69 @@
+var r = Object.defineProperty;
+var a = (e, t, s) => t in e ? r(e, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : e[t] = s;
+var u = (e, t, s) => a(e, typeof t != "symbol" ? t + "" : t, s);
+import { DebugService as i } from "../../services/debugService.js";
+import { flushDebugLogs as h } from "../../utilities/flushDebugLogs.js";
+class m {
+  constructor() {
+    u(this, "_body", null);
+    u(this, "_name", "SuccessResponse");
+    u(this, "_status", 200);
+    u(this, "_statusText", "OK");
+    u(this, "_debugColor", "green");
+  }
+  get body() {
+    return this._body;
+  }
+  set body(t) {
+    this._body = t ?? null;
+  }
+  get name() {
+    return this._name;
+  }
+  set name(t) {
+    this._name = t;
+  }
+  get status() {
+    return this._status;
+  }
+  set status(t) {
+    this._status = t;
+  }
+  get statusText() {
+    return this._statusText;
+  }
+  set statusText(t) {
+    this._statusText = t;
+  }
+  get debugColor() {
+    return this._debugColor;
+  }
+  set debugColor(t) {
+    ["green", "yellow", "cyan", "red"].includes(t) && (this._debugColor = t);
+  }
+  /**
+   * Logs debug information for success responses including caller context and response details.
+   *
+   * @param {any} body - The response body or success data to be logged
+   *
+   * @example
+   * ```typescript
+   * const SuccessResponse = new SuccessResponse();
+   * SuccessResponse.onDebug({ data: "Operation completed successfully" });
+   * ```
+   */
+  onDebug(t) {
+    const s = [], { callerInfo: o, functionName: n } = i.getCaller();
+    s.push(`Caller Function: ${n}`), s.push(`Caller Location: ${o}`), this.statusText && s.push(`Message: ${this.statusText}`), t && s.push(`Body: ${JSON.stringify(t)}`), h({ scheme: this._debugColor, name: this.name, debugs: s });
+  }
+  makeBody() {
+    return {
+      name: this.name,
+      message: this.statusText,
+      body: this.body
+    };
+  }
+}
+export {
+  m as SuccessResponse
+};

package/dist/modules/http/successResponses/created.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 = "Created", this.status = 201, 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 Created
+};

package/dist/modules/http/successResponses/found.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 = "Found", this.status = 302, 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 Found
+};