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

package/dist/http/api/_makeRequest.js

@@ -1,116 +0,0 @@
-import { flushDebugLogs } from "../..";
-import { LogMapperService } from "../../services/logMapperService";
-import { logRequest } from "./_logRequest";
-/**
- * Makes an HTTP request using the Fetch API and returns a standardized response.
- *
- * @template {any} T - The expected type of the response data.
- *
- * @param {"POST" | "PUT" | "DELETE" | "PATCH" | "GET"} method - The HTTP method to use for the request. Supported methods are:
- *   - "POST": Create a new resource.
- *   - "PUT": Update an existing resource.
- *   - "DELETE": Remove a resource.
- *   - "PATCH": Partially update a resource.
- *   - "GET": Retrieve a resource.
- * @param {string} url - The URL to which the request is sent.
- * @param {HeadersInit} headers - Optional headers to include in the request. Defaults to an empty object.
- * @param {any} body - Optional body to include in the request. Should be serializable to JSON.
- *
- * @returns {ApiResponseDTO<T>} A promise that resolves to an `ApiResponseDTO<T>` object containing:
- *   - `success`: A boolean indicating whether the request was successful.
- *   - `status`: The HTTP status code of the response.
- *   - `message`: A message describing the result of the request.
- *   - `response`: The parsed JSON response data, or `null` if parsing fails.
- *   - `cause`: Additional error information, if applicable.
- *
- * @example
- * ```typescript
- * import { makeRequest } from "./makeRequest";
- *
- * async function fetchData() {
- *   const response = await makeRequest("GET", "https://api.example.com/data");
- *   if (response.success) {
- *     console.log("Data:", response.response);
- *   } else {
- *     console.error("Error:", response.message);
- *   }
- * }
- * ```
- */
-async function makeRequest(input) {
-    let url = input.url;
-    if (input.urlParams) {
-        Object.entries(input.urlParams).forEach(([key, value]) => {
-            url = url.replaceAll(`:${key}`, value);
-        });
-    }
-    const successMessage = {
-        POST: "Resource created successfully",
-        PUT: "Resource updated successfully",
-        DELETE: "Resource deleted successfully",
-        PATCH: "Resource patched successfully",
-        GET: "Request successful",
-    };
-    try {
-        const startTime = performance.now();
-        const headers = { ...input.headers, "Content-Type": "application/json" };
-        const response = await fetch(url, {
-            headers,
-            method: input.method,
-            body: input.body ? JSON.stringify(input.body) : undefined,
-        });
-        const elapsedTime = performance.now() - startTime;
-        const status = response.status;
-        let data = null;
-        try {
-            data = await response.json();
-        }
-        catch {
-            data = null;
-        }
-        const logData = LogMapperService.handle({
-            elapsedTime,
-            method: input.method,
-            queryParams: new URL(url).searchParams,
-            requestHeaders: headers,
-            requestBody: input.body,
-            responseBody: data,
-            responseHeaders: response.headers,
-            status,
-            rawUrl: input.url,
-            urlParams: input.urlParams,
-        });
-        logRequest(logData);
-        if (!response.ok) {
-            return {
-                success: false,
-                status,
-                message: data?.message || response.statusText || "Request failed",
-                response: data,
-                cause: null,
-            };
-        }
-        return {
-            success: true,
-            status,
-            message: data?.message || successMessage[input.method],
-            response: data,
-            cause: null,
-        };
-    }
-    catch (err) {
-        flushDebugLogs({
-            debugs: [`Network error or request failed: ${err}`],
-            name: "MakeRequestError",
-            scheme: "red",
-        });
-        return {
-            success: false,
-            status: 0,
-            message: "Network error or request failed",
-            response: null,
-            cause: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export { makeRequest };

package/dist/http/api/deleteRequest.js

@@ -1,18 +0,0 @@
-import { makeRequest } from "./_makeRequest";
-/**
- * Sends a DELETE request to the specified URL with optional headers and body.
- *
- * @template T - The expected type of the response data.
- * @param {InputProps} input - The options for the DELETE request, including URL, URL parameters, headers, and body.
- * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
- */
-async function deleteRequest(input) {
-    return makeRequest({
-        method: "DELETE",
-        url: input.url,
-        urlParams: input.urlParams,
-        headers: input.headers,
-        body: input.body,
-    });
-}
-export { deleteRequest };

package/dist/http/api/getRequest.js

@@ -1,17 +0,0 @@
-import { makeRequest } from "./_makeRequest";
-/**
- * Sends a GET request to the specified URL with optional headers.
- *
- * @template T - The expected type of the response data.
- * @param {InputProps} input - The options for the GET request, including URL, URL parameters, and headers.
- * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
- */
-async function getRequest(input) {
-    return makeRequest({
-        method: "GET",
-        url: input.url,
-        urlParams: input.urlParams,
-        headers: input.headers,
-    });
-}
-export { getRequest };

package/dist/http/api/patchRequest.js

@@ -1,18 +0,0 @@
-import { makeRequest } from "./_makeRequest";
-/**
- * Sends a PATCH request to the specified URL with optional headers and body.
- *
- * @template T - The expected type of the response data.
- * @param {InputProps} input - The options for the PATCH request, including URL, URL parameters, headers, and body.
- * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
- */
-async function patchRequest(input) {
-    return makeRequest({
-        method: "PATCH",
-        url: input.url,
-        urlParams: input.urlParams,
-        headers: input.headers,
-        body: input.body,
-    });
-}
-export { patchRequest };

package/dist/http/api/postRequest.js

@@ -1,18 +0,0 @@
-import { makeRequest } from "./_makeRequest";
-/**
- * Sends a POST request to the specified URL with optional headers and body.
- *
- * @template T - The expected type of the response data.
- * @param {InputProps} input - The options for the POST request, including URL, URL parameters, headers, and body.
- * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
- */
-async function postRequest(input) {
-    return makeRequest({
-        method: "POST",
-        url: input.url,
-        urlParams: input.urlParams,
-        headers: input.headers,
-        body: input.body,
-    });
-}
-export { postRequest };

package/dist/http/api/putRequest.js

@@ -1,18 +0,0 @@
-import { makeRequest } from "./_makeRequest";
-/**
- * Sends a PUT request to the specified URL with optional headers and body.
- *
- * @template T - The expected type of the response data.
- * @param {InputProps} input - The options for the PUT request, including URL, URL parameters, headers, and body.
- * @returns {Promise<ApiResponseDTO<T>>} A promise that resolves to the API response.
- */
-async function putRequest(input) {
-    return makeRequest({
-        method: "PUT",
-        url: input.url,
-        urlParams: input.urlParams,
-        headers: input.headers,
-        body: input.body,
-    });
-}
-export { putRequest };

package/dist/http/badResponses/_badResponse.js

@@ -1,62 +0,0 @@
-import { formatJsonString } from "@arkyn/shared";
-import { DebugService } from "../../services/debugService";
-import { flushDebugLogs } from "../../utilities/flushDebugLogs";
-class BadResponse {
-    _cause;
-    _name = "BadResponse";
-    _status = 500;
-    _statusText = "Unknown error";
-    _debugColor = "red";
-    get cause() {
-        return this._cause;
-    }
-    set cause(value) {
-        this._cause = value;
-    }
-    get name() {
-        return this._name;
-    }
-    set name(value) {
-        this._name = value;
-    }
-    get status() {
-        return this._status;
-    }
-    set status(value) {
-        this._status = value;
-    }
-    get statusText() {
-        return this._statusText;
-    }
-    set statusText(value) {
-        this._statusText = value;
-    }
-    get debugColor() {
-        return this._debugColor;
-    }
-    set debugColor(value) {
-        if (!["green", "yellow", "cyan", "red"].includes(value))
-            return;
-        this._debugColor = value;
-    }
-    onDebug() {
-        const debugs = [];
-        const { callerInfo, functionName } = DebugService.getCaller();
-        debugs.push(`Caller Function: ${functionName}`);
-        debugs.push(`Caller Location: ${callerInfo}`);
-        if (this._statusText)
-            debugs.push(`Message: ${this._statusText}`);
-        if (this._cause) {
-            debugs.push(`Cause: ${formatJsonString(JSON.stringify(this._cause))}`);
-        }
-        flushDebugLogs({ scheme: "red", name: this._name, debugs });
-    }
-    makeBody() {
-        return {
-            name: this._name,
-            message: this._statusText,
-            cause: this._cause,
-        };
-    }
-}
-export { BadResponse };

package/dist/http/badResponses/badGateway.js

@@ -1,43 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 502 Bad Gateway — the upstream server returned an invalid or unexpected response.
- *
- * Throw inside a server action/loader and catch with `errorHandler`, or call `.toJson()` directly.
- *
- * @example
- * ```typescript
- * throw new BadGateway("Payment gateway unavailable");
- * ```
- */
-class BadGateway extends BadResponse {
-    /**
-     * @param message - Error description sent in the response body and logged for debugging.
-     * @param cause - Optional extra context (serialized to JSON in the response).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "BadGateway";
-        this.status = 502;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { BadGateway };

package/dist/http/badResponses/badRequest.js

@@ -1,41 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 400 Bad Request — the request is malformed or contains invalid data.
- *
- * @example
- * ```typescript
- * throw new BadRequest("Invalid request body");
- * ```
- */
-class BadRequest extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "BadRequest";
-        this.status = 400;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { BadRequest };

package/dist/http/badResponses/conflict.js

@@ -1,42 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 409 Conflict — the request conflicts with the current state of the server (e.g. duplicate record).
- *
- * @example
- * ```typescript
- * throw new Conflict("Email already in use");
- * ```
- */
-class Conflict extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "Conflict";
-        this.status = 409;
-        this.statusText = message;
-        this.debugColor = "yellow";
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { Conflict };

package/dist/http/badResponses/forbidden.js

@@ -1,41 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 403 Forbidden — authenticated but not authorized to access this resource.
- *
- * @example
- * ```typescript
- * throw new Forbidden("You don't have permission to delete this resource");
- * ```
- */
-class Forbidden extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "Forbidden";
-        this.status = 403;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { Forbidden };

package/dist/http/badResponses/notFound.js

@@ -1,41 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 404 Not Found — the requested resource does not exist.
- *
- * @example
- * ```typescript
- * throw new NotFound("Product not found");
- * ```
- */
-class NotFound extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "NotFound";
-        this.status = 404;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { NotFound };

package/dist/http/badResponses/notImplemented.js

@@ -1,41 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 501 Not Implemented — the server does not support the functionality required to fulfill the request.
- *
- * @example
- * ```typescript
- * throw new NotImplemented("Webhook delivery is not yet implemented");
- * ```
- */
-class NotImplemented extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "NotImplemented";
-        this.status = 501;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { NotImplemented };

package/dist/http/badResponses/serverError.js

@@ -1,41 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 500 Internal Server Error — an unexpected condition prevented the server from fulfilling the request.
- *
- * @example
- * ```typescript
- * throw new ServerError("Failed to connect to the database");
- * ```
- */
-class ServerError extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "ServerError";
-        this.status = 500;
-        this.statusText = message;
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { ServerError };

package/dist/http/badResponses/unauthorized.js

@@ -1,42 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 401 Unauthorized — the request lacks valid authentication credentials.
- *
- * @example
- * ```typescript
- * throw new Unauthorized("Invalid or expired token");
- * ```
- */
-class Unauthorized extends BadResponse {
-    /**
-     * @param message - Error description.
-     * @param cause - Optional extra context (serialized to JSON).
-     */
-    constructor(message, cause) {
-        super();
-        this.name = "Unauthorized";
-        this.status = 401;
-        this.statusText = message;
-        this.debugColor = "yellow";
-        this.cause = cause ? JSON.stringify(cause) : undefined;
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { Unauthorized };

package/dist/http/badResponses/unprocessableEntity.js

@@ -1,53 +0,0 @@
-import { BadResponse } from "./_badResponse";
-/**
- * HTTP 422 Unprocessable Entity — the request is well-formed but contains semantic validation errors.
- * Typically used for form field validation failures.
- *
- * @example
- * ```typescript
- * throw new UnprocessableEntity({
- *   message: "Validation failed",
- *   fieldErrors: { email: "Invalid email format", age: "Must be 18 or older" },
- *   fields: { email: "not-an-email", age: "15" },
- * });
- * ```
- */
-class UnprocessableEntity extends BadResponse {
-    /**
-     * @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(props) {
-        super();
-        this.name = "UnprocessableEntity";
-        this.status = 422;
-        this.statusText = props.message || "Unprocessable entity";
-        this.debugColor = "yellow";
-        this.cause = {
-            data: props.data,
-            fieldErrors: props.fieldErrors,
-            fields: props.fields,
-        };
-        this.onDebug();
-    }
-    /** Converts to a `Response` with `Content-Type: application/json` header. */
-    toResponse() {
-        const responseInit = {
-            headers: { "Content-Type": "application/json" },
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return new Response(JSON.stringify(this.makeBody()), responseInit);
-    }
-    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
-    toJson() {
-        const responseInit = {
-            status: this.status,
-            statusText: this.statusText,
-        };
-        return Response.json(this.makeBody(), responseInit);
-    }
-}
-export { UnprocessableEntity };