@signe/room 2.0.0 → 2.0.1

package/dist/index.d.ts

@@ -634,6 +634,123 @@ interface RoomOnLeave {
     onLeave(user: any, conn: Connection, ctx: ConnectionContext): Promise<any> | null | any;
 }
 
+declare class ServerResponse {
+    private interceptors;
+    private statusCode;
+    private responseBody;
+    private responseHeaders;
+    /**
+     * Creates a new ServerResponse instance
+     * @param interceptors Array of interceptor functions that can modify the response
+     */
+    constructor(interceptors?: ((res: Response) => Promise<Response> | Response)[]);
+    /**
+     * Sets the status code for the response
+     * @param code HTTP status code
+     * @returns this instance for chaining
+     */
+    status(code: number): ServerResponse;
+    /**
+     * Sets the response body and returns this instance (chainable method)
+     *
+     * @param body Response body
+     * @returns this instance for chaining
+     */
+    body(body: any): ServerResponse;
+    /**
+     * Adds a header to the response
+     * @param name Header name
+     * @param value Header value
+     * @returns this instance for chaining
+     */
+    header(name: string, value: string): ServerResponse;
+    /**
+     * Adds multiple headers to the response
+     * @param headers Object containing headers
+     * @returns this instance for chaining
+     */
+    setHeaders(headers: Record<string, string>): ServerResponse;
+    /**
+     * Add an interceptor to the chain
+     * @param interceptor Function that takes a Response and returns a modified Response
+     * @returns this instance for chaining
+     */
+    use(interceptor: (res: Response) => Promise<Response> | Response): ServerResponse;
+    /**
+     * Builds and returns the Response object after applying all interceptors
+     * @returns Promise<Response> The final Response object
+     * @private Internal method used by terminal methods
+     */
+    private buildResponse;
+    /**
+     * Sets the response body to the JSON-stringified version of the provided value
+     * and sends the response (terminal method)
+     *
+     * @param body Response body to be JSON stringified
+     * @returns Promise<Response> The final Response object
+     */
+    json(body: any): Promise<Response>;
+    /**
+     * Sends the response with the current configuration (terminal method)
+     *
+     * @param body Optional body to set before sending
+     * @returns Promise<Response> The final Response object
+     */
+    send(body?: any): Promise<Response>;
+    /**
+     * Sends a plain text response (terminal method)
+     *
+     * @param text Text to send
+     * @returns Promise<Response> The final Response object
+     */
+    text(text: string): Promise<Response>;
+    /**
+     * Redirects to the specified URL (terminal method)
+     *
+     * @param url URL to redirect to
+     * @param statusCode HTTP status code (default: 302)
+     * @returns Promise<Response> The final Response object
+     */
+    redirect(url: string, statusCode?: number): Promise<Response>;
+    /**
+     * Creates a success response with status 200
+     * @param body Response body
+     * @returns Promise<Response> The final Response object
+     */
+    success(body?: any): Promise<Response>;
+    /**
+     * Creates an error response with status 400
+     * @param message Error message
+     * @param details Additional error details
+     * @returns Promise<Response> The final Response object
+     */
+    badRequest(message: string, details?: any): Promise<Response>;
+    /**
+     * Creates an error response with status 403
+     * @param message Error message
+     * @returns Promise<Response> The final Response object
+     */
+    notPermitted(message?: string): Promise<Response>;
+    /**
+     * Creates an error response with status 401
+     * @param message Error message
+     * @returns Promise<Response> The final Response object
+     */
+    unauthorized(message?: string): Promise<Response>;
+    /**
+     * Creates an error response with status 404
+     * @param message Error message
+     * @returns Promise<Response> The final Response object
+     */
+    notFound(message?: string): Promise<Response>;
+    /**
+     * Creates an error response with status 500
+     * @param message Error message
+     * @returns Promise<Response> The final Response object
+     */
+    serverError(message?: string): Promise<Response>;
+}
+
 type BalancingStrategy = 'round-robin' | 'least-connections' | 'random';
 type ShardStatus = 'active' | 'maintenance' | 'draining';
 declare class RoomConfig {
@@ -666,21 +783,11 @@ declare class WorldRoom implements RoomInterceptorPacket, RoomOnJoin {
     interceptorPacket(_: any, obj: any, conn: Connection): any;
     private cleanupInactiveShards;
     registerRoom(req: Request$1): Promise<void>;
-    updateShardStats(req: Request$1): Promise<{
-        error: string;
-    }>;
-    scaleRoom(req: Request$1): Promise<{
-        error: string;
-        roomId?: undefined;
-        currentShardCount?: undefined;
-    } | {
-        error: string;
-        roomId: string;
-        currentShardCount: number;
-    }>;
-    connect(req: Request$1): Promise<Response>;
+    updateShardStats(req: Request$1, res: ServerResponse): Promise<Response>;
+    scaleRoom(req: Request$1, res: ServerResponse): Promise<Response>;
+    connect(req: Request$1, res: ServerResponse): Promise<Response>;
     private findOptimalShard;
     private createShard;
 }
 
-export { Action, ClientIo, Guard, MockConnection, Request, type RequestOptions, Room, RoomGuard, type RoomInterceptorPacket, type RoomOnJoin, type RoomOnLeave, type RoomOptions, Server, ServerIo, Shard, type ShardOptions, WorldRoom, request, testRoom };
+export { Action, ClientIo, Guard, MockConnection, Request, type RequestOptions, Room, RoomGuard, type RoomInterceptorPacket, type RoomOnJoin, type RoomOnLeave, type RoomOptions, Server, ServerIo, ServerResponse, Shard, type ShardOptions, WorldRoom, request, testRoom };