@arkyn/server 3.0.1-beta.21 → 3.0.1-beta.22

package/src/http/badResponses/badRequest.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 400 (Bad Request).
- * This class is used to standardize the structure of a "Bad Request" error response,
- * including the response body, headers, status, and status text.
- */
-
-class BadRequest {
-  body: any;
-  cause?: any;
-  status: number = 400;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `BadRequest` class.
-   *
-   * @param message - A descriptive message explaining the cause of the error.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "BadRequest", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("BadRequest", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `BadRequest` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `BadRequest` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { BadRequest };

package/src/http/badResponses/conflict.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 409 (Conflict).
- * This class is used to standardize the structure of a "Conflict" error response,
- * including the response body, headers, status, and status text.
- */
-
-class Conflict {
-  body: any;
-  cause?: any;
-  status: number = 409;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `Conflict` class.
-   *
-   * @param message - A descriptive message explaining the cause of the conflict.
-   * @param cause - Optional additional information about the cause of the conflict.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "Conflict", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("Conflict", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `Conflict` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `Conflict` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { Conflict };

package/src/http/badResponses/forbidden.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 403 (Forbidden).
- * This class is used to standardize the structure of a "Forbidden" error response,
- * including the response body, headers, status, and status text.
- */
-
-class Forbidden {
-  body: any;
-  cause?: any;
-  status: number = 403;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `Forbidden` class.
-   *
-   * @param message - A descriptive message explaining why access is forbidden.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "Forbidden", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("Forbidden", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `Forbidden` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `Forbidden` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { Forbidden };

package/src/http/badResponses/notFound.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 404 (Not Found).
- * This class is used to standardize the structure of a "Not Found" error response,
- * including the response body, headers, status, and status text.
- */
-
-class NotFound {
-  body: any;
-  cause?: any;
-  status: number = 404;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `NotFound` class.
-   *
-   * @param message - A descriptive message explaining the reason the resource was not found.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "NotFound", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("NotFound", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `NotFound` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `NotFound` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { NotFound };

package/src/http/badResponses/notImplemented.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 501 (Not Implemented).
- * This class is used to standardize the structure of a "Not Implemented" error response,
- * including the response body, headers, status, and status text.
- */
-
-class NotImplemented {
-  body: any;
-  cause?: any;
-  status: number = 501;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `NotImplemented` class.
-   *
-   * @param message - A descriptive message explaining why the functionality is not implemented.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "NotImplemented", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("NotImplemented", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `NotImplemented` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `NotImplemented` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { NotImplemented };

package/src/http/badResponses/serverError.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 500 (Internal Server Error).
- * This class is used to standardize the structure of a "Server Error" response,
- * including the response body, headers, status, and status text.
- */
-
-class ServerError {
-  body: any;
-  cause?: any;
-  status: number = 500;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `ServerError` class.
-   *
-   * @param message - A descriptive message explaining the cause of the server error.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "ServerError", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("ServerError", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `ServerError` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `ServerError` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { ServerError };

package/src/http/badResponses/unauthorized.ts

@@ -1,63 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-/**
- * Represents an HTTP error response with a status code of 401 (Unauthorized).
- * This class is used to standardize the structure of an "Unauthorized" error response,
- * including the response body, headers, status, and status text.
- */
-
-class Unauthorized {
-  body: any;
-  cause?: any;
-  status: number = 401;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `Unauthorized` class.
-   *
-   * @param message - A descriptive message explaining why the request is unauthorized.
-   * @param cause - Optional additional information about the cause of the error.
-   */
-
-  constructor(message: string, cause?: any) {
-    this.body = { name: "Unauthorized", message: message };
-    this.statusText = message;
-    this.cause = cause ? JSON.stringify(cause) : undefined;
-    httpDebug("Unauthorized", this.body, this.cause);
-  }
-
-  /**
-   * Converts the `Unauthorized` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `Unauthorized` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { Unauthorized };

package/src/http/badResponses/unprocessableEntity.ts

@@ -1,79 +0,0 @@
-import { httpDebug } from "../../services/httpDebug";
-
-type UnprocessableEntityProps = {
-  data?: any;
-  fieldErrors?: Record<string, string>;
-  fields?: Record<string, string>;
-  message?: string;
-};
-
-/**
- * Represents an HTTP error response with a status code of 422 (Unprocessable Entity).
- * This class is used to standardize the structure of an "Unprocessable Entity" error response,
- * including the response body, headers, status, and status text.
- */
-
-class UnprocessableEntity {
-  body: any;
-  status: number = 422;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `UnprocessableEntity` class.
-   *
-   * @param props - An object containing details about the error, such as:
-   *   - `data`: Additional data related to the error.
-   *   - `fieldErrors`: A record of field-specific error messages.
-   *   - `fields`: A record of field values that caused the error.
-   *   - `message`: A descriptive message explaining the error.
-   * @param enableDebug - A boolean indicating whether to enable debug logging for this error.
-   */
-
-  constructor(props: UnprocessableEntityProps, enableDebug = false) {
-    this.statusText = props.message || "Unprocessable Entity";
-    this.body = {
-      name: "UnprocessableEntity",
-      message: props.message || null,
-      data: props.data,
-      fieldErrors: props.fieldErrors,
-      fields: props.fields,
-    };
-
-    enableDebug && httpDebug("UnprocessableEntity", this.body);
-  }
-
-  /**
-   * Converts the `UnprocessableEntity` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json" },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `UnprocessableEntity` instance into a `Response` object using the `Response.json` method.
-   * This method is an alternative to `toResponse` for generating JSON error responses.
-   *
-   * @returns A `Response` object with the JSON body and response metadata.
-   */
-
-  toJson(): Response {
-    const responseInit: ResponseInit = {
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { UnprocessableEntity };

package/src/http/successResponses/created.ts

@@ -1,64 +0,0 @@
-/**
- * Represents a successful HTTP response with a status code of 201 (Created).
- * This class is used to standardize the structure of a "Created" response,
- * including the response body, headers, status, and status text.
- *
- * @template T - The type of the response body.
- */
-
-class Created<T> {
-  body: T;
-  headers: ResponseInit["headers"];
-  status: number;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `Created` 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) {
-    this.body = body;
-    this.headers = init?.headers || {};
-    this.status = init?.status || 201;
-    this.statusText = init?.statusText || "Resource created successfully";
-  }
-
-  /**
-   * Converts the `Created` 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 {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json", ...this.headers },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `Created` 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 {
-    const responseInit: ResponseInit = {
-      headers: this.headers,
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { Created };

package/src/http/successResponses/found.ts

@@ -1,67 +0,0 @@
-/**
- * Represents an HTTP 302 Found response.
- * This class is used to create a standardized HTTP response with a status of 302 (Found),
- * including optional headers and a response body.
- *
- * @template T - The type of the response body.
- */
-
-class Found<T> {
-  body: T;
-  headers: ResponseInit["headers"];
-  status: number;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `Found` class.
-   *
-   * @param body - The body of the response.
-   * @param init - Optional initialization object to set headers, status, and statusText.
-   *   - `headers`: Additional headers to include in the response.
-   *   - `status`: HTTP status code (default is 302).
-   *   - `statusText`: HTTP status text (default is "Found").
-   */
-
-  constructor(body: T, init?: ResponseInit) {
-    this.body = body;
-    this.headers = init?.headers || {};
-    this.status = init?.status || 302;
-    this.statusText = init?.statusText || "Found";
-  }
-
-  /**
-   * Converts the `Found` instance into a `Response` object.
-   * This method serializes the response body as JSON and includes the appropriate headers.
-   *
-   * @returns A `Response` object with the serialized JSON body and the specified headers, status, and statusText.
-   */
-
-  toResponse() {
-    const responseInit: ResponseInit = {
-      headers: { "Content-Type": "application/json", ...this.headers },
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(JSON.stringify(this.body), responseInit);
-  }
-
-  /**
-   * Converts the `Found` instance into a JSON response using `Response.json`.
-   * This method is an alternative to `toResponse` for creating JSON responses.
-   *
-   * @returns A `Response` object with the JSON body and the specified headers, status, and statusText.
-   */
-
-  toJson() {
-    const responseInit: ResponseInit = {
-      headers: this.headers,
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return Response.json(this.body, responseInit);
-  }
-}
-
-export { Found };

package/src/http/successResponses/noContent.ts

@@ -1,42 +0,0 @@
-/**
- * Represents a successful HTTP response with a status code of 204 (No Content).
- * This class is used to standardize the structure of a "No Content" response,
- * including headers, status, and status text.
- */
-
-class NoContent {
-  headers: ResponseInit["headers"];
-  status: number;
-  statusText: string;
-
-  /**
-   * Creates an instance of the `NoContent` class.
-   *
-   * @param init - Optional initialization object for customizing headers, status, and status text.
-   */
-
-  constructor(init?: ResponseInit) {
-    this.headers = init?.headers || {};
-    this.status = init?.status || 204;
-    this.statusText = init?.statusText ?? "No content";
-  }
-
-  /**
-   * Converts the `NoContent` instance into a `Response` object.
-   * This method ensures the response has the appropriate headers, status, and status text.
-   *
-   * @returns A `Response` object with no body and response metadata.
-   */
-
-  toResponse(): Response {
-    const responseInit: ResponseInit = {
-      headers: this.headers,
-      status: this.status,
-      statusText: this.statusText,
-    };
-
-    return new Response(null, responseInit);
-  }
-}
-
-export { NoContent };