@mxweb/core 1.0.0

package/dist/response.d.ts

@@ -0,0 +1,665 @@
+/**
+ * @fileoverview Standardized HTTP response builder for API endpoints.
+ *
+ * This module provides the `ServerResponse` class which creates consistent,
+ * structured JSON responses for all HTTP status codes. All responses follow
+ * a unified format:
+ *
+ * ```json
+ * {
+ *   "success": boolean,
+ *   "message": string,
+ *   "code": string,
+ *   "status": number,
+ *   "data": any | null,
+ *   "error": any | null
+ * }
+ * ```
+ *
+ * @module response
+ *
+ * @example
+ * ```ts
+ * import { ServerResponse } from "@mxweb/core";
+ *
+ * const response = new ServerResponse();
+ *
+ * // Success responses
+ * return response.success(userData, "User fetched successfully");
+ * return response.created(newProduct, "Product created");
+ *
+ * // Error responses
+ * return response.notFound("User not found");
+ * return response.badRequest("Invalid email format", validationErrors);
+ * return response.unauthorized("Token expired");
+ * ```
+ */
+import { NextResponse } from "next/server";
+/**
+ * A utility class for building standardized HTTP responses.
+ *
+ * `ServerResponse` provides methods for all common HTTP status codes,
+ * ensuring consistent response structure across your API. Each method
+ * returns a `NextResponse` with properly formatted JSON body.
+ *
+ * @remarks
+ * - Success responses (2xx) have `success: true` and `error: null`
+ * - Error responses (4xx, 5xx) have `success: false` and `data: null`
+ * - All responses include a human-readable `message` and machine-readable `code`
+ *
+ * @example
+ * ```ts
+ * // In a controller method
+ * class ProductController extends BaseController {
+ *   async getProduct(id: string) {
+ *     const product = await this.productService.findById(id);
+ *
+ *     if (!product) {
+ *       return this.response.notFound(`Product ${id} not found`);
+ *     }
+ *
+ *     return this.response.success(product);
+ *   }
+ *
+ *   async createProduct(data: CreateProductDto) {
+ *     const product = await this.productService.create(data);
+ *     return this.response.created(product, "Product created successfully");
+ *   }
+ * }
+ * ```
+ */
+export declare class ServerResponse {
+    /**
+     * Creates a standardized JSON response object.
+     *
+     * @param code - Machine-readable status code (e.g., "SUCCESS", "NOT_FOUND")
+     * @param status - HTTP status code
+     * @param message - Human-readable message
+     * @param data - Response payload for success responses
+     * @param error - Error details for error responses
+     * @returns A structured response object
+     * @internal
+     */
+    private static toJSON;
+    /**
+     * Creates a response for HTTP OPTIONS preflight requests.
+     * Returns a 200 OK response, typically used for CORS.
+     *
+     * @returns NextResponse with 200 status
+     *
+     * @example
+     * ```ts
+     * // Handling OPTIONS request
+     * if (method === "OPTIONS") {
+     *   return ServerResponse.options();
+     * }
+     * ```
+     */
+    static options(): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 200 OK response with optional data.
+     *
+     * @param data - The response payload
+     * @param message - Custom success message (default: "Successfully")
+     * @returns NextResponse with 200 status
+     *
+     * @example
+     * ```ts
+     * return response.success(users, "Users retrieved successfully");
+     * return response.success({ token: "..." });
+     * ```
+     */
+    success(data?: unknown, message?: string): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 201 Created response for newly created resources.
+     *
+     * @param data - The created resource
+     * @param message - Custom message (default: "Resource created successfully")
+     * @returns NextResponse with 201 status
+     *
+     * @example
+     * ```ts
+     * const newUser = await userService.create(userData);
+     * return response.created(newUser, "User registered successfully");
+     * ```
+     */
+    created(data?: unknown, message?: string): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 202 Accepted response for async operations.
+     * Used when the request has been accepted but processing is not complete.
+     *
+     * @param data - Optional data (e.g., job ID for tracking)
+     * @param message - Custom message (default: "Request accepted successfully")
+     * @returns NextResponse with 202 status
+     *
+     * @example
+     * ```ts
+     * const jobId = await queue.enqueue(emailTask);
+     * return response.accepted({ jobId }, "Email will be sent shortly");
+     * ```
+     */
+    accepted(data?: unknown, message?: string): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 204 No Content response.
+     * Typically used after DELETE operations.
+     *
+     * @param message - Custom message (default: "No content")
+     * @returns NextResponse with 204 status
+     *
+     * @example
+     * ```ts
+     * await userService.delete(userId);
+     * return response.noContent("User deleted successfully");
+     * ```
+     */
+    noContent(message?: string): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 301 Moved Permanently response.
+     * Indicates the resource has been permanently moved to a new URL.
+     *
+     * @returns NextResponse with 301 status
+     *
+     * @example
+     * ```ts
+     * // Old endpoint permanently redirected
+     * return response.resourceMovedPermanently();
+     * ```
+     */
+    resourceMovedPermanently(): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 302 Found (Temporary Redirect) response.
+     * Indicates the resource has been temporarily moved.
+     *
+     * @returns NextResponse with 302 status
+     *
+     * @example
+     * ```ts
+     * // Temporary redirect during maintenance
+     * return response.resourceMovedTemporarily();
+     * ```
+     */
+    resourceMovedTemporarily(): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 400 Bad Request response.
+     * Used when the request syntax is invalid or malformed.
+     *
+     * @param message - Error message (default: "Bad Request")
+     * @param error - Detailed error information (e.g., validation errors)
+     * @returns NextResponse with 400 status
+     *
+     * @example
+     * ```ts
+     * if (!isValidEmail(email)) {
+     *   return response.badRequest("Invalid email format", {
+     *     field: "email",
+     *     reason: "Must be a valid email address"
+     *   });
+     * }
+     * ```
+     */
+    badRequest(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 401 Unauthorized response.
+     * Used when authentication is required but missing or invalid.
+     *
+     * @param message - Error message (default: "Unauthorized")
+     * @param error - Detailed error information
+     * @returns NextResponse with 401 status
+     *
+     * @example
+     * ```ts
+     * if (!authToken) {
+     *   return response.unauthorized("Authentication token required");
+     * }
+     * if (tokenExpired) {
+     *   return response.unauthorized("Token expired, please login again");
+     * }
+     * ```
+     */
+    unauthorized(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 403 Forbidden response.
+     * Used when the user is authenticated but lacks permission.
+     *
+     * @param message - Error message (default: "Forbidden")
+     * @param error - Detailed error information
+     * @returns NextResponse with 403 status
+     *
+     * @example
+     * ```ts
+     * if (!user.isAdmin) {
+     *   return response.forbidden("Admin access required");
+     * }
+     * ```
+     */
+    forbidden(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 404 Not Found response.
+     * Used when the requested resource does not exist.
+     *
+     * @param message - Error message (default: "Not Found")
+     * @param error - Detailed error information
+     * @returns NextResponse with 404 status
+     *
+     * @example
+     * ```ts
+     * const user = await userService.findById(id);
+     * if (!user) {
+     *   return response.notFound(`User with ID ${id} not found`);
+     * }
+     * ```
+     */
+    notFound(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 405 Method Not Allowed response.
+     * Used when the HTTP method is not supported for the resource.
+     *
+     * @param message - Error message (default: "Method Not Allowed")
+     * @param error - Detailed error information
+     * @returns NextResponse with 405 status
+     *
+     * @example
+     * ```ts
+     * // Route only supports GET
+     * if (method !== "GET") {
+     *   return response.methodNotAllowed(`${method} is not allowed`);
+     * }
+     * ```
+     */
+    methodNotAllowed(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 406 Not Acceptable response.
+     * Used when the server cannot produce content matching Accept headers.
+     *
+     * @param message - Error message (default: "Not Acceptable")
+     * @param error - Detailed error information
+     * @returns NextResponse with 406 status
+     *
+     * @example
+     * ```ts
+     * if (!supportedFormats.includes(acceptHeader)) {
+     *   return response.notAcceptable("Requested format not supported");
+     * }
+     * ```
+     */
+    notAcceptable(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 408 Request Timeout response.
+     * Used when the server timed out waiting for the request.
+     *
+     * @param message - Error message (default: "Request Timeout")
+     * @param error - Detailed error information
+     * @returns NextResponse with 408 status
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await Promise.race([operation(), timeout(30000)]);
+     * } catch (e) {
+     *   return response.requestTimeout("Operation timed out after 30 seconds");
+     * }
+     * ```
+     */
+    requestTimeout(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 409 Conflict response.
+     * Used when the request conflicts with the current state of the resource.
+     *
+     * @param message - Error message (default: "Conflict")
+     * @param error - Detailed error information
+     * @returns NextResponse with 409 status
+     *
+     * @example
+     * ```ts
+     * const existingUser = await userService.findByEmail(email);
+     * if (existingUser) {
+     *   return response.conflict("Email already registered");
+     * }
+     * ```
+     */
+    conflict(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 410 Gone response.
+     * Used when a resource has been permanently deleted.
+     *
+     * @param message - Error message (default: "Gone")
+     * @param error - Detailed error information
+     * @returns NextResponse with 410 status
+     *
+     * @example
+     * ```ts
+     * if (resource.deletedAt) {
+     *   return response.gone("This resource has been permanently removed");
+     * }
+     * ```
+     */
+    gone(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 413 Payload Too Large response.
+     * Used when the request body exceeds the server limit.
+     *
+     * @param message - Error message (default: "Payload Too Large")
+     * @param error - Detailed error information
+     * @returns NextResponse with 413 status
+     *
+     * @example
+     * ```ts
+     * if (file.size > MAX_FILE_SIZE) {
+     *   return response.payloadTooLarge(`File exceeds ${MAX_FILE_SIZE} bytes limit`);
+     * }
+     * ```
+     */
+    payloadTooLarge(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 415 Unsupported Media Type response.
+     * Used when the request Content-Type is not supported.
+     *
+     * @param message - Error message (default: "Unsupported Media Type")
+     * @param error - Detailed error information
+     * @returns NextResponse with 415 status
+     *
+     * @example
+     * ```ts
+     * if (contentType !== "application/json") {
+     *   return response.unsupportedMediaType("Only JSON content is accepted");
+     * }
+     * ```
+     */
+    unsupportedMediaType(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 422 Unprocessable Entity response.
+     * Used when the request is syntactically correct but semantically invalid.
+     *
+     * @param message - Error message (default: "Unprocessable Entity")
+     * @param error - Detailed error information (e.g., validation errors)
+     * @returns NextResponse with 422 status
+     *
+     * @example
+     * ```ts
+     * const errors = validateDto(data);
+     * if (errors.length > 0) {
+     *   return response.unprocessableEntity("Validation failed", { errors });
+     * }
+     * ```
+     */
+    unprocessableEntity(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 429 Too Many Requests response.
+     * Used for rate limiting.
+     *
+     * @param message - Error message (default: "Too Many Requests")
+     * @param error - Detailed error information (e.g., retry-after time)
+     * @returns NextResponse with 429 status
+     *
+     * @example
+     * ```ts
+     * if (rateLimiter.isExceeded(clientIp)) {
+     *   return response.tooManyRequests("Rate limit exceeded", {
+     *     retryAfter: 60,
+     *     limit: 100,
+     *     remaining: 0
+     *   });
+     * }
+     * ```
+     */
+    tooManyRequests(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 500 Internal Server Error response.
+     * Used for unexpected server-side errors.
+     *
+     * @param error - Error details (be careful not to expose sensitive info)
+     * @returns NextResponse with 500 status
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await riskyOperation();
+     * } catch (error) {
+     *   logger.error("Unexpected error:", error);
+     *   return response.internalServer({ message: "An unexpected error occurred" });
+     * }
+     * ```
+     */
+    internalServer(error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 501 Not Implemented response.
+     * Used when a feature is not yet implemented.
+     *
+     * @param message - Error message (default: "Not Implemented")
+     * @param error - Detailed error information
+     * @returns NextResponse with 501 status
+     *
+     * @example
+     * ```ts
+     * return response.notImplemented("This feature is coming soon");
+     * ```
+     */
+    notImplemented(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 502 Bad Gateway response.
+     * Used when an upstream server returned an invalid response.
+     *
+     * @param message - Error message (default: "Bad Gateway")
+     * @param error - Detailed error information
+     * @returns NextResponse with 502 status
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await thirdPartyApi.call();
+     * } catch (e) {
+     *   return response.badGateway("External service returned invalid response");
+     * }
+     * ```
+     */
+    badGateway(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 503 Service Unavailable response.
+     * Used during maintenance or overload conditions.
+     *
+     * @param message - Error message (default: "Service Unavailable")
+     * @param error - Detailed error information
+     * @returns NextResponse with 503 status
+     *
+     * @example
+     * ```ts
+     * if (isMaintenanceMode) {
+     *   return response.serviceUnavailable("Service under maintenance");
+     * }
+     * ```
+     */
+    serviceUnavailable(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+    /**
+     * Returns a 504 Gateway Timeout response.
+     * Used when an upstream server did not respond in time.
+     *
+     * @param message - Error message (default: "Gateway Timeout")
+     * @param error - Detailed error information
+     * @returns NextResponse with 504 status
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await fetchWithTimeout(upstreamUrl, 5000);
+     * } catch (e) {
+     *   return response.gatewayTimeout("Upstream server did not respond");
+     * }
+     * ```
+     */
+    gatewayTimeout(message?: string, error?: unknown): NextResponse<{
+        success: boolean;
+        message: string;
+        code: string;
+        status: number;
+        data: unknown;
+        error: unknown;
+    }>;
+}

package/dist/response.js

@@ -0,0 +1 @@
+"use strict";var e=require("next/server");class t{static toJSON(e,t=200,s="Successfully",o=null,r=null){return{success:t>=200&&t<400,message:s,code:e,status:t,data:o,error:r}}static options(){return(new t).success()}success(s=null,o){return e.NextResponse.json(t.toJSON("SUCCESS",200,o,s,null),{status:200})}created(s=null,o){return e.NextResponse.json(t.toJSON("CREATED",201,o??"Resource created successfully",s,null),{status:201})}accepted(s=null,o){return e.NextResponse.json(t.toJSON("ACCEPTED",202,o??"Request accepted successfully",s,null),{status:202})}noContent(s){return e.NextResponse.json(t.toJSON("NO_CONTENT",204,s??"No content",null,null),{status:204})}resourceMovedPermanently(){return e.NextResponse.json(t.toJSON("MOVED_PERMANENTLY",301,"Resource moved permanently",null,null),{status:301})}resourceMovedTemporarily(){return e.NextResponse.json(t.toJSON("REDIRECTED",302,"Resource moved temporarily",null,null),{status:302})}badRequest(s="Bad Request",o){return e.NextResponse.json(t.toJSON("BAD_REQUEST",400,s,null,o??{message:"The server could not understand the request due to invalid syntax",name:"BadRequestError",code:"BAD_REQUEST"}),{status:400})}unauthorized(s="Unauthorized",o){return e.NextResponse.json(t.toJSON("UNAUTHORIZED",401,s,null,o??{message:"Authentication is required and has failed or has not yet been provided",name:"UnauthorizedError",code:"AUTHENTICATION_REQUIRED"}),{status:401})}forbidden(s="Forbidden",o){return e.NextResponse.json(t.toJSON("FORBIDDEN",403,s,null,o??{message:"You do not have permission to access this resource",name:"ForbiddenError",code:"ACCESS_FORBIDDEN"}),{status:403})}notFound(s="Not Found",o){return e.NextResponse.json(t.toJSON("NOT_FOUND",404,s,null,o??{message:"The requested resource was not found",name:"NotFoundError",code:"URL_NOT_FOUND"}),{status:404})}methodNotAllowed(s="Method Not Allowed",o){return e.NextResponse.json(t.toJSON("METHOD_NOT_ALLOWED",405,s,null,o??{message:"The HTTP method is not allowed for this resource",name:"MethodNotAllowedError",code:"METHOD_NOT_ALLOWED"}),{status:405})}notAcceptable(s="Not Acceptable",o){return e.NextResponse.json(t.toJSON("NOT_ACCEPTABLE",406,s,null,o??{message:"The server cannot produce a response matching the acceptable values",name:"NotAcceptableError",code:"NOT_ACCEPTABLE"}),{status:406})}requestTimeout(s="Request Timeout",o){return e.NextResponse.json(t.toJSON("REQUEST_TIMEOUT",408,s,null,o??{message:"The server timed out waiting for the request",name:"RequestTimeoutError",code:"REQUEST_TIMEOUT"}),{status:408})}conflict(s="Conflict",o){return e.NextResponse.json(t.toJSON("CONFLICT",409,s,null,o??{message:"The request could not be completed due to a conflict with the current state of the resource",name:"ConflictError",code:"RESOURCE_CONFLICT"}),{status:409})}gone(s="Gone",o){return e.NextResponse.json(t.toJSON("GONE",410,s,null,o??{message:"The requested resource is no longer available and has been permanently removed",name:"GoneError",code:"RESOURCE_GONE"}),{status:410})}payloadTooLarge(s="Payload Too Large",o){return e.NextResponse.json(t.toJSON("PAYLOAD_TOO_LARGE",413,s,null,o??{message:"The request payload is larger than the server is willing to process",name:"PayloadTooLargeError",code:"PAYLOAD_TOO_LARGE"}),{status:413})}unsupportedMediaType(s="Unsupported Media Type",o){return e.NextResponse.json(t.toJSON("UNSUPPORTED_MEDIA_TYPE",415,s,null,o??{message:"The media format of the requested data is not supported by the server",name:"UnsupportedMediaTypeError",code:"UNSUPPORTED_MEDIA_TYPE"}),{status:415})}unprocessableEntity(s="Unprocessable Entity",o){return e.NextResponse.json(t.toJSON("UNPROCESSABLE_ENTITY",422,s,null,o??{message:"The request was well-formed but was unable to be followed due to semantic errors",name:"UnprocessableEntityError",code:"UNPROCESSABLE_ENTITY"}),{status:422})}tooManyRequests(s="Too Many Requests",o){return e.NextResponse.json(t.toJSON("TOO_MANY_REQUESTS",429,s,null,o??{message:"You have sent too many requests in a given amount of time",name:"TooManyRequestsError",code:"TOO_MANY_REQUESTS"}),{status:429})}internalServer(s){return e.NextResponse.json(t.toJSON("INTERNAL_SERVER_ERROR",500,"Internal Server Error",null,s??{message:"An unexpected error occurred on the server",name:"InternalServerError",code:"INTERNAL_SERVER_ERROR"}),{status:500})}notImplemented(s="Not Implemented",o){return e.NextResponse.json(t.toJSON("NOT_IMPLEMENTED",501,s,null,o??{message:"The requested functionality is not implemented",name:"NotImplementedError",code:"NOT_IMPLEMENTED"}),{status:501})}badGateway(s="Bad Gateway",o){return e.NextResponse.json(t.toJSON("BAD_GATEWAY",502,s,null,o??{message:"Received an invalid response from the upstream server",name:"BadGatewayError",code:"BAD_GATEWAY"}),{status:502})}serviceUnavailable(s="Service Unavailable",o){return e.NextResponse.json(t.toJSON("SERVICE_UNAVAILABLE",503,s,null,o??{message:"The server is currently unable to handle the request",name:"ServiceUnavailableError",code:"SERVICE_UNAVAILABLE"}),{status:503})}gatewayTimeout(s="Gateway Timeout",o){return e.NextResponse.json(t.toJSON("GATEWAY_TIMEOUT",504,s,null,o??{message:"The server did not receive a timely response from the upstream server",name:"GatewayTimeoutError",code:"GATEWAY_TIMEOUT"}),{status:504})}}exports.ServerResponse=t;

package/dist/response.mjs

@@ -0,0 +1 @@
+import{NextResponse as e}from"next/server";class t{static toJSON(e,t=200,r="Successfully",o=null,s=null){return{success:t>=200&&t<400,message:r,code:e,status:t,data:o,error:s}}static options(){return(new t).success()}success(r=null,o){return e.json(t.toJSON("SUCCESS",200,o,r,null),{status:200})}created(r=null,o){return e.json(t.toJSON("CREATED",201,o??"Resource created successfully",r,null),{status:201})}accepted(r=null,o){return e.json(t.toJSON("ACCEPTED",202,o??"Request accepted successfully",r,null),{status:202})}noContent(r){return e.json(t.toJSON("NO_CONTENT",204,r??"No content",null,null),{status:204})}resourceMovedPermanently(){return e.json(t.toJSON("MOVED_PERMANENTLY",301,"Resource moved permanently",null,null),{status:301})}resourceMovedTemporarily(){return e.json(t.toJSON("REDIRECTED",302,"Resource moved temporarily",null,null),{status:302})}badRequest(r="Bad Request",o){return e.json(t.toJSON("BAD_REQUEST",400,r,null,o??{message:"The server could not understand the request due to invalid syntax",name:"BadRequestError",code:"BAD_REQUEST"}),{status:400})}unauthorized(r="Unauthorized",o){return e.json(t.toJSON("UNAUTHORIZED",401,r,null,o??{message:"Authentication is required and has failed or has not yet been provided",name:"UnauthorizedError",code:"AUTHENTICATION_REQUIRED"}),{status:401})}forbidden(r="Forbidden",o){return e.json(t.toJSON("FORBIDDEN",403,r,null,o??{message:"You do not have permission to access this resource",name:"ForbiddenError",code:"ACCESS_FORBIDDEN"}),{status:403})}notFound(r="Not Found",o){return e.json(t.toJSON("NOT_FOUND",404,r,null,o??{message:"The requested resource was not found",name:"NotFoundError",code:"URL_NOT_FOUND"}),{status:404})}methodNotAllowed(r="Method Not Allowed",o){return e.json(t.toJSON("METHOD_NOT_ALLOWED",405,r,null,o??{message:"The HTTP method is not allowed for this resource",name:"MethodNotAllowedError",code:"METHOD_NOT_ALLOWED"}),{status:405})}notAcceptable(r="Not Acceptable",o){return e.json(t.toJSON("NOT_ACCEPTABLE",406,r,null,o??{message:"The server cannot produce a response matching the acceptable values",name:"NotAcceptableError",code:"NOT_ACCEPTABLE"}),{status:406})}requestTimeout(r="Request Timeout",o){return e.json(t.toJSON("REQUEST_TIMEOUT",408,r,null,o??{message:"The server timed out waiting for the request",name:"RequestTimeoutError",code:"REQUEST_TIMEOUT"}),{status:408})}conflict(r="Conflict",o){return e.json(t.toJSON("CONFLICT",409,r,null,o??{message:"The request could not be completed due to a conflict with the current state of the resource",name:"ConflictError",code:"RESOURCE_CONFLICT"}),{status:409})}gone(r="Gone",o){return e.json(t.toJSON("GONE",410,r,null,o??{message:"The requested resource is no longer available and has been permanently removed",name:"GoneError",code:"RESOURCE_GONE"}),{status:410})}payloadTooLarge(r="Payload Too Large",o){return e.json(t.toJSON("PAYLOAD_TOO_LARGE",413,r,null,o??{message:"The request payload is larger than the server is willing to process",name:"PayloadTooLargeError",code:"PAYLOAD_TOO_LARGE"}),{status:413})}unsupportedMediaType(r="Unsupported Media Type",o){return e.json(t.toJSON("UNSUPPORTED_MEDIA_TYPE",415,r,null,o??{message:"The media format of the requested data is not supported by the server",name:"UnsupportedMediaTypeError",code:"UNSUPPORTED_MEDIA_TYPE"}),{status:415})}unprocessableEntity(r="Unprocessable Entity",o){return e.json(t.toJSON("UNPROCESSABLE_ENTITY",422,r,null,o??{message:"The request was well-formed but was unable to be followed due to semantic errors",name:"UnprocessableEntityError",code:"UNPROCESSABLE_ENTITY"}),{status:422})}tooManyRequests(r="Too Many Requests",o){return e.json(t.toJSON("TOO_MANY_REQUESTS",429,r,null,o??{message:"You have sent too many requests in a given amount of time",name:"TooManyRequestsError",code:"TOO_MANY_REQUESTS"}),{status:429})}internalServer(r){return e.json(t.toJSON("INTERNAL_SERVER_ERROR",500,"Internal Server Error",null,r??{message:"An unexpected error occurred on the server",name:"InternalServerError",code:"INTERNAL_SERVER_ERROR"}),{status:500})}notImplemented(r="Not Implemented",o){return e.json(t.toJSON("NOT_IMPLEMENTED",501,r,null,o??{message:"The requested functionality is not implemented",name:"NotImplementedError",code:"NOT_IMPLEMENTED"}),{status:501})}badGateway(r="Bad Gateway",o){return e.json(t.toJSON("BAD_GATEWAY",502,r,null,o??{message:"Received an invalid response from the upstream server",name:"BadGatewayError",code:"BAD_GATEWAY"}),{status:502})}serviceUnavailable(r="Service Unavailable",o){return e.json(t.toJSON("SERVICE_UNAVAILABLE",503,r,null,o??{message:"The server is currently unable to handle the request",name:"ServiceUnavailableError",code:"SERVICE_UNAVAILABLE"}),{status:503})}gatewayTimeout(r="Gateway Timeout",o){return e.json(t.toJSON("GATEWAY_TIMEOUT",504,r,null,o??{message:"The server did not receive a timely response from the upstream server",name:"GatewayTimeoutError",code:"GATEWAY_TIMEOUT"}),{status:504})}}export{t as ServerResponse};