@mxweb/core 1.0.1 → 1.1.0

package/dist/response.d.ts

@@ -34,18 +34,263 @@
  * return response.unauthorized("Token expired");
  * ```
  */
-import { NextResponse } from "next/server";
+/**
+ * Standard response body structure for all API responses.
+ * This is the JSON payload that will be sent to the client.
+ */
+export interface CoreResponseBody<T = unknown> {
+    /** Whether the request was successful (2xx-3xx = true, 4xx-5xx = false) */
+    success: boolean;
+    /** Human-readable message describing the result */
+    message: string;
+    /** Machine-readable status code (e.g., "SUCCESS", "NOT_FOUND", "BAD_REQUEST") */
+    code: string;
+    /** HTTP status code */
+    status: number;
+    /** Response payload for success responses, null for errors */
+    data: T | null;
+    /** Error details for error responses, null for success */
+    error: unknown;
+}
+/**
+ * Framework-agnostic response class.
+ * Use `json()` method to convert to standard Web Response, or use a transformer
+ * for framework-specific responses (NextResponse, Express, etc.)
+ *
+ * @template T - The type of the response data
+ *
+ * @example
+ * ```ts
+ * // Direct usage with standard Response
+ * const coreResponse = new CoreResponse(body, 200, "OK");
+ * return coreResponse.json(); // Returns standard Response
+ *
+ * // In Application options (Next.js transformer)
+ * import { NextResponse } from "next/server";
+ *
+ * const app = Application.create({
+ *   responseTransformer: (coreResponse) => {
+ *     return CoreResponse.json(coreResponse.body, {
+ *       status: coreResponse.status,
+ *       headers: coreResponse.headers,
+ *     });
+ *   },
+ * });
+ * ```
+ */
+export declare class CoreResponse<T = unknown> {
+    readonly body: CoreResponseBody<T>;
+    readonly status: number;
+    readonly statusText: string;
+    /** Response headers */
+    readonly headers: Headers;
+    /**
+     * Creates a new CoreResponse instance.
+     *
+     * @param body - The structured response body
+     * @param status - HTTP status code
+     * @param statusText - HTTP status text (e.g., "OK", "Not Found")
+     * @param headers - Optional additional headers
+     */
+    constructor(body: CoreResponseBody<T>, status: number, statusText: string, headers?: HeadersInit);
+    /**
+     * Returns the response body as a plain object.
+     * Use this to get the standardized schema for custom response handling.
+     *
+     * @returns The CoreResponseBody object
+     *
+     * @example
+     * ```ts
+     * const coreResponse = new CoreResponse(body, 200, "OK");
+     * const schema = coreResponse.json();
+     * // { success: true, message: "...", code: "SUCCESS", status: 200, data: ..., error: null }
+     *
+     * // Next.js
+     * return NextResponse.json(schema, { status: coreResponse.status });
+     *
+     * // Express
+     * res.status(coreResponse.status).json(schema);
+     * ```
+     */
+    json(): CoreResponseBody<T>;
+    /**
+     * Creates a CoreResponse from a body object and options.
+     *
+     * @param body - The response body
+     * @param init - Response init options (status, statusText, headers)
+     * @returns A new CoreResponse instance
+     */
+    static json<T = unknown>(body: CoreResponseBody<T>, init?: {
+        status?: number;
+        statusText?: string;
+        headers?: HeadersInit;
+    }): CoreResponse<T>;
+}
+/**
+ * Interface for response classes that have a static json() method.
+ * This allows passing NextResponse, Response, or custom response classes directly.
+ *
+ * @template R - The type of response instance returned by json()
+ *
+ * @example
+ * ```ts
+ * // NextResponse is compatible
+ * import { NextResponse } from "next/server";
+ * // NextResponse.json(body, init) returns NextResponse
+ *
+ * // Standard Response is also compatible
+ * Response.json(body, init) // returns Response
+ * ```
+ */
+export interface ResponseClass<R = Response> {
+    json(body: unknown, init?: ResponseInit): R;
+}
+/**
+ * Type for response transformer.
+ * Can be either:
+ * 1. A response class with static json() method (NextResponse, Response)
+ * 2. A custom function that transforms CoreResponse
+ *
+ * @template R - The type of the final response
+ *
+ * @example
+ * ```ts
+ * // Option 1: Pass class directly (recommended for Next.js)
+ * import { NextResponse } from "next/server";
+ *
+ * Application.create({
+ *   responseTransformer: NextResponse, // Just pass the class!
+ * });
+ *
+ * // Option 2: Custom transformer function
+ * Application.create({
+ *   responseTransformer: (coreResponse) => {
+ *     // Custom logic
+ *     return new Response(JSON.stringify(coreResponse.body), {
+ *       status: coreResponse.status,
+ *       headers: coreResponse.headers,
+ *     });
+ *   },
+ * });
+ *
+ * // Option 3: Express/Fastify adapter (external package)
+ * Application.create({
+ *   responseTransformer: (coreResponse, res) => {
+ *     res.status(coreResponse.status).json(coreResponse.body);
+ *     return res;
+ *   },
+ * });
+ * ```
+ */
+export type ResponseTransformer<R = Response> = ResponseClass<R> | ((response: CoreResponse) => R);
+/**
+ * Helper to apply a response transformer to a CoreResponse.
+ * Handles both class-based and function-based transformers.
+ *
+ * @param transformer - The transformer (class or function)
+ * @param response - The CoreResponse to transform
+ * @returns The transformed response
+ *
+ * @example
+ * ```ts
+ * import { NextResponse } from "next/server";
+ *
+ * const coreResponse = new CoreResponse(body, 200, "OK");
+ *
+ * // With class
+ * const nextRes = applyTransformer(NextResponse, coreResponse);
+ *
+ * // With function
+ * const customRes = applyTransformer(
+ *   (r) => new Response(JSON.stringify(r.body)),
+ *   coreResponse
+ * );
+ * ```
+ */
+export declare function applyTransformer<R = Response>(transformer: ResponseTransformer<R>, response: CoreResponse): R;
+/**
+ * Type for response interceptor function.
+ * Interceptors receive a CoreResponse and can transform it (add headers, modify body, etc.)
+ * The interceptor is called AFTER the handler returns, allowing post-processing.
+ *
+ * @template T - The type of the response data
+ *
+ * @example
+ * ```ts
+ * // Add custom header
+ * const addTimestamp: ResponseInterceptor = async (response) => {
+ *   response.headers.set("X-Timestamp", Date.now().toString());
+ *   return response;
+ * };
+ *
+ * // Transform response body
+ * const wrapResponse: ResponseInterceptor = async (response) => {
+ *   const newBody = {
+ *     ...response.body,
+ *     metadata: { version: "1.0" },
+ *   };
+ *   return CoreResponse.json(newBody, {
+ *     status: response.status,
+ *     statusText: response.statusText,
+ *     headers: response.headers,
+ *   });
+ * };
+ *
+ * // Logging interceptor
+ * const logResponse: ResponseInterceptor = async (response) => {
+ *   console.log(`Response: ${response.status} ${response.body.message}`);
+ *   return response;
+ * };
+ * ```
+ */
+export type ResponseInterceptor<T = unknown> = (response: CoreResponse<T>) => CoreResponse<T> | Promise<CoreResponse<T>>;
+/**
+ * Interface for class-based response interceptors.
+ * Provides more flexibility than function interceptors with access to instance state.
+ *
+ * @template T - The type of the response data
+ *
+ * @example
+ * ```ts
+ * class LoggingInterceptor implements ResponseInterceptorHandler {
+ *   transform(response: CoreResponse): CoreResponse {
+ *     console.log(`[${response.status}] ${response.body.message}`);
+ *     return response;
+ *   }
+ * }
+ *
+ * class CacheHeaderInterceptor implements ResponseInterceptorHandler {
+ *   transform(response: CoreResponse): CoreResponse {
+ *     if (response.status >= 200 && response.status < 300) {
+ *       response.headers.set("Cache-Control", "max-age=3600");
+ *     }
+ *     return response;
+ *   }
+ * }
+ * ```
+ */
+export interface ResponseInterceptorHandler<T = unknown> {
+    /**
+     * Transforms the response.
+     * Called after the handler returns, allowing post-processing of the response.
+     *
+     * @param response - The CoreResponse to transform
+     * @returns The transformed CoreResponse (can be the same instance or a new one)
+     */
+    transform(response: CoreResponse<T>): CoreResponse<T> | Promise<CoreResponse<T>>;
+}
 /**
  * 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.
+ * returns a `CoreResponse` that can be transformed to any framework's response.
  *
  * @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`
+ * - Use `responseTransformer` in Application options to customize output format
  *
  * @example
  * ```ts
@@ -85,7 +330,7 @@ export declare class ServerResponse {
      * Creates a response for HTTP OPTIONS preflight requests.
      * Returns a 200 OK response, typically used for CORS.
      *
-     * @returns NextResponse with 200 status
+     * @returns CoreResponse with 200 status
      *
      * @example
      * ```ts
@@ -95,20 +340,13 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    static options(): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    static options(): CoreResponse<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
+     * @returns CoreResponse with 200 status
      *
      * @example
      * ```ts
@@ -116,20 +354,13 @@ export declare class ServerResponse {
      * return response.success({ token: "..." });
      * ```
      */
-    success(data?: unknown, message?: string): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    success(data?: unknown, message?: string): CoreResponse<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
+     * @returns CoreResponse with 201 status
      *
      * @example
      * ```ts
@@ -137,21 +368,14 @@ export declare class ServerResponse {
      * 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;
-    }>;
+    created(data?: unknown, message?: string): CoreResponse<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
+     * @returns CoreResponse with 202 status
      *
      * @example
      * ```ts
@@ -159,20 +383,13 @@ export declare class ServerResponse {
      * 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;
-    }>;
+    accepted(data?: unknown, message?: string): CoreResponse<unknown>;
     /**
      * Returns a 204 No Content response.
      * Typically used after DELETE operations.
      *
      * @param message - Custom message (default: "No content")
-     * @returns NextResponse with 204 status
+     * @returns CoreResponse with 204 status
      *
      * @example
      * ```ts
@@ -180,19 +397,12 @@ export declare class ServerResponse {
      * return response.noContent("User deleted successfully");
      * ```
      */
-    noContent(message?: string): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    noContent(message?: string): CoreResponse<null>;
     /**
      * Returns a 301 Moved Permanently response.
      * Indicates the resource has been permanently moved to a new URL.
      *
-     * @returns NextResponse with 301 status
+     * @returns CoreResponse with 301 status
      *
      * @example
      * ```ts
@@ -200,19 +410,12 @@ export declare class ServerResponse {
      * return response.resourceMovedPermanently();
      * ```
      */
-    resourceMovedPermanently(): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    resourceMovedPermanently(): CoreResponse<null>;
     /**
      * Returns a 302 Found (Temporary Redirect) response.
      * Indicates the resource has been temporarily moved.
      *
-     * @returns NextResponse with 302 status
+     * @returns CoreResponse with 302 status
      *
      * @example
      * ```ts
@@ -220,21 +423,14 @@ export declare class ServerResponse {
      * return response.resourceMovedTemporarily();
      * ```
      */
-    resourceMovedTemporarily(): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    resourceMovedTemporarily(): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 400 status
      *
      * @example
      * ```ts
@@ -246,21 +442,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    badRequest(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    badRequest(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 401 status
      *
      * @example
      * ```ts
@@ -272,21 +461,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    unauthorized(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    unauthorized(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 403 status
      *
      * @example
      * ```ts
@@ -295,21 +477,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    forbidden(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    forbidden(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 404 status
      *
      * @example
      * ```ts
@@ -319,21 +494,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    notFound(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    notFound(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 405 status
      *
      * @example
      * ```ts
@@ -343,21 +511,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    methodNotAllowed(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    methodNotAllowed(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 406 status
      *
      * @example
      * ```ts
@@ -366,21 +527,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    notAcceptable(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    notAcceptable(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 408 status
      *
      * @example
      * ```ts
@@ -391,21 +545,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    requestTimeout(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    requestTimeout(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 409 status
      *
      * @example
      * ```ts
@@ -415,21 +562,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    conflict(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    conflict(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 410 status
      *
      * @example
      * ```ts
@@ -438,21 +578,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    gone(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    gone(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 413 status
      *
      * @example
      * ```ts
@@ -461,21 +594,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    payloadTooLarge(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    payloadTooLarge(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 415 status
      *
      * @example
      * ```ts
@@ -484,21 +610,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    unsupportedMediaType(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    unsupportedMediaType(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 422 status
      *
      * @example
      * ```ts
@@ -508,21 +627,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    unprocessableEntity(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    unprocessableEntity(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 429 status
      *
      * @example
      * ```ts
@@ -535,20 +647,13 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    tooManyRequests(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    tooManyRequests(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 500 status
      *
      * @example
      * ```ts
@@ -560,42 +665,28 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    internalServer(error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    internalServer(error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse 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;
-    }>;
+    notImplemented(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 502 status
      *
      * @example
      * ```ts
@@ -606,21 +697,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    badGateway(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    badGateway(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 503 status
      *
      * @example
      * ```ts
@@ -629,21 +713,14 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    serviceUnavailable(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    serviceUnavailable(message?: string, error?: unknown): CoreResponse<null>;
     /**
      * 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
+     * @returns CoreResponse with 504 status
      *
      * @example
      * ```ts
@@ -654,12 +731,5 @@ export declare class ServerResponse {
      * }
      * ```
      */
-    gatewayTimeout(message?: string, error?: unknown): NextResponse<{
-        success: boolean;
-        message: string;
-        code: string;
-        status: number;
-        data: unknown;
-        error: unknown;
-    }>;
+    gatewayTimeout(message?: string, error?: unknown): CoreResponse<null>;
 }