@asenajs/asena 0.1.18 → 0.2.0

package/dist/lib/adapter/AsenaContext.d.ts

@@ -1,141 +1,151 @@
 import type { CookieExtra, SendOptions } from './types';
 /**
- * Interface representing the context for Asena.
+ * AsenaContext represents the core context interface for handling HTTP requests and responses in Asena framework.
+ * It provides essential methods and properties for request/response handling, data manipulation, and state management.
  *
- * @template R - The type of the request object.
- * @template S - The type of the response object.
+ * @template R - Type parameter for the underlying request object
+ * @template S - Type parameter for the underlying response object
  */
 export interface AsenaContext<R, S> {
+    /** The original request object */
     req: R;
+    /** The original response object */
     res: S;
     /**
-     * Headers associated with the request.
+     * Request headers stored as key-value pairs
      */
     headers: Record<string, string>;
     /**
-     * Retrieves the request body as an ArrayBuffer.
+     * Retrieves the raw request body as an ArrayBuffer.
+     * Useful for handling binary data.
      *
-     * @returns {Promise<ArrayBuffer>} A promise that resolves to an ArrayBuffer.
+     * @returns {Promise<ArrayBuffer>} The request body as an ArrayBuffer
      */
     getArrayBuffer: () => Promise<ArrayBuffer>;
     /**
-     * Parses and retrieves the request body.
+     * Automatically parses the request body based on content type.
+     * Supports JSON, form data, and other common formats.
      *
-     * @returns {Promise<any>} A promise that resolves to the parsed body.
+     * @returns {Promise<any>} The parsed request body
      */
     getParseBody: () => Promise<any>;
     /**
-     * Retrieves the request body as a Blob.
+     * Retrieves the request body as a Blob object.
+     * Useful for handling file uploads and binary data.
      *
-     * @returns {Promise<Blob>} A promise that resolves to a Blob.
+     * @returns {Promise<Blob>} The request body as a Blob
      */
     getBlob: () => Promise<Blob>;
     /**
      * Retrieves the request body as FormData.
+     * Useful for processing multipart/form-data submissions.
      *
-     * @returns {Promise<FormData>} A promise that resolves to FormData.
+     * @returns {Promise<FormData>} The request body as FormData
      */
     getFormData: () => Promise<FormData>;
     /**
-     * Retrieves a parameter from the request.
+     * Retrieves a route parameter by name.
+     * Example: For route "/users/:id", getParam("id") returns the actual ID value.
      *
-     * @param {string} s - The name of the parameter.
-     * @returns {string} The value of the parameter.
+     * @param {string} s - The parameter name to retrieve
+     * @returns {string} The parameter value
      */
     getParam: (s: string) => string;
     /**
-     * Retrieves the request body as a specified type.
+     * Retrieves and automatically type-casts the request body.
      *
-     * @template U - The type to which the body should be parsed.
-     * @returns {Promise<U>} A promise that resolves to the parsed body.
+     * @template U - The expected type of the body
+     * @returns {Promise<U>} The typed request body
      */
     getBody: <U>() => Promise<U>;
     /**
-     * Retrieves a query parameter from the request.
+     * Retrieves a single query parameter value.
+     * For URL "?name=john", getQuery("name") returns "john".
      *
-     * @param {string} query - The name of the query parameter.
-     * @returns {Promise<string>} A promise that resolves to the value of the query parameter.
+     * @param {string} query - The query parameter name
+     * @returns {Promise<string>} The query parameter value
      */
     getQuery: (query: string) => Promise<string>;
     /**
-     * Retrieves all values of a query parameter from the request.
+     * Retrieves all values for a query parameter that appears multiple times.
+     * For URL "?color=red&color=blue", getQueryAll("color") returns ["red", "blue"].
      *
-     * @param {string} query - The name of the query parameter.
-     * @returns {Promise<string[]>} A promise that resolves to an array of values.
+     * @param {string} query - The query parameter name
+     * @returns {Promise<string[]>} Array of all values for the query parameter
      */
     getQueryAll: (query: string) => Promise<string[]>;
     /**
-     * Retrieves a cookie from the request.
+     * Retrieves a cookie value by name, with optional signature verification.
      *
-     * @param {string} name - The name of the cookie.
-     * @param {string | BufferSource} [secret] - Optional secret for signed cookies.
-     * @returns {Promise<string | false>} A promise that resolves to the cookie value or false if not found.
+     * @param {string} name - The cookie name
+     * @param {string | BufferSource} [secret] - Optional secret for verifying signed cookies
+     * @returns {Promise<string | false>} The cookie value if found, false otherwise
      */
     getCookie: (name: string, secret?: string | BufferSource) => Promise<string | false>;
     /**
-     * Sets a cookie in the response.
+     * Sets a cookie with the specified name, value, and options.
      *
-     * @param {string} name - The name of the cookie.
-     * @param {string} value - The value of the cookie.
-     * @param {CookieExtra<any>} [options] - Optional settings for the cookie.
-     * @returns {Promise<void>} A promise that resolves when the cookie is set.
+     * @param {string} name - The cookie name
+     * @param {string} value - The cookie value
+     * @param {CookieExtra<any>} [options] - Cookie options (expires, domain, path, etc.)
+     * @returns {Promise<void>}
      */
     setCookie: (name: string, value: string, options?: CookieExtra<any>) => Promise<void>;
     /**
-     * Deletes a cookie from the response.
+     * Deletes a cookie by setting its expiration to the past.
      *
-     * @param {string} name - The name of the cookie to delete.
-     * @param {CookieExtra<any>} [options] - Optional settings for the cookie.
-     * @returns {Promise<void>} A promise that resolves when the cookie is deleted.
+     * @param {string} name - The cookie name to delete
+     * @param {CookieExtra<any>} [options] - Cookie options (domain, path, etc.)
+     * @returns {Promise<void>}
      */
     deleteCookie: (name: string, options?: CookieExtra<any>) => Promise<void>;
     /**
-     * Retrieves a value from the context.
+     * Retrieves a value from the context's state storage.
      *
-     * @template T - The type of the value.
-     * @param {string} key - The key of the value.
-     * @returns {T} The value associated with the key.
+     * @template T - The expected type of the value
+     * @param {string} key - The key to retrieve
+     * @returns {T} The stored value
      */
     getValue: <T>(key: string) => T;
     /**
-     * Sets a value in the context.
+     * Stores a value in the context's state storage.
      *
-     * @param {string} key - The key of the value.
-     * @param {any} value - The value to set.
+     * @param {string} key - The key to store under
+     * @param {any} value - The value to store
      */
     setValue: (key: string, value: any) => void;
     /**
-     * Sets a value for WebSocket communication.
+     * Stores a value specifically for WebSocket communication.
      *
-     * @param {any} value - The value to set.
+     * @param {any} value - The value to store for WebSocket context
      */
     setWebSocketValue: (value: any) => void;
     /**
-     * Retrieves a value for WebSocket communication.
+     * Retrieves the stored WebSocket-specific value.
      *
-     * @template T - The type of the value.
-     * @returns {T} The value associated with the WebSocket.
+     * @template T - The expected type of the WebSocket value
+     * @returns {T} The stored WebSocket value
      */
     getWebSocketValue: <T>() => T;
     /**
-     * Sends an HTML response.
+     * Sends an HTML response with appropriate content-type headers.
      *
-     * @param {string} data - The HTML data to send.
-     * @returns {Response | Promise<Response> } The response object.
+     * @param {string} data - The HTML content to send
+     * @returns {Response | Promise<Response>} The response object
      */
     html: (data: string) => Response | Promise<Response>;
     /**
-     * Sends a response.
+     * Sends a response with automatic content-type detection.
      *
-     * @param {string | any} data - The data to send.
-     * @param {SendOptions | number} [status] - Optional status code or send options.
-     * @returns {Response | Promise<Response>} The response object.
+     * @param {string | any} data - The content to send
+     * @param {SendOptions | number} [status] - HTTP status code or send options
+     * @returns {Response | Promise<Response>} The response object
      */
     send: (data: string | any, status?: SendOptions | number) => Response | Promise<Response>;
     /**
-     * Redirects the request to a new URL.
+     * Performs an HTTP redirect to the specified URL.
      *
-     * @param {string} url - The URL to redirect to.
+     * @param {string} url - The destination URL
      */
     redirect: (url: string) => void;
 }

package/dist/lib/adapter/AsenaWebsocketAdapter.d.ts

@@ -1,71 +1,94 @@
 import type { AsenaWebSocketService, WSOptions } from '../server/web/websocket';
 import type { WebSocketHandler } from 'bun';
-import type { ServerLogger } from '../services';
-import type { WebsocketAdapterParams } from './types';
-import type { WebSocketRegistry } from './types';
+import type { BaseMiddleware, WebsocketAdapterParams, WebSocketRegistry } from './types';
+import type { ServerLogger } from '../logger';
+import type { AsenaContext } from './AsenaContext';
 /**
- * Abstract class representing a WebSocket adapter.
+ * Abstract class that provides a base implementation for WebSocket adapters.
+ * Handles WebSocket connections, registration, and management.
  *
- * @template A - The type of the application.
- * @template AM - The type of the message.
+ * @template A - Type of the application instance
+ * @template R - Type of the request object
+ * @template S - Type of the response object
  */
-export declare abstract class AsenaWebsocketAdapter<A, MH> {
+export declare abstract class AsenaWebsocketAdapter<A, C extends AsenaContext<any, any>> {
+    readonly name: string;
     /**
-     * The WebSocket services.
-     * @ string - The namespace of the WebSocket.
-     * @ AsenaWebSocketService<any> - The WebSocket service.
-     * @ MH[] - The middlewares to use.
+     * Registry containing WebSocket services and their configurations
+     * Structure:
+     * - Key: WebSocket namespace
+     * - Value: Object containing:
+     *   - service: WebSocket service instance
+     *   - middlewares: Array of middleware functions
      * @protected
      */
-    protected _websockets: WebSocketRegistry;
+    protected _websockets: WebSocketRegistry<C>;
     /**
-     * The application instance.
+     * Reference to the main application instance
      * @private
      */
     private _app;
     /**
-     * The WebSocket handler.
+     * WebSocket handler instance for managing connections
      * @private
      */
     private _websocket;
     /**
-     * The logger instance.
+     * Logger instance for WebSocket-related logging
+     * @private
      */
     private _logger;
     /**
-     * Constructor for the AsenaWebSocketAdapter class.
-     * @param params - The parameters for the constructor.
+     * Initializes a new WebSocket adapter instance
+     * @param params - Configuration parameters including app instance and logger
      */
     protected constructor(params?: WebsocketAdapterParams<A>);
     /**
-     * Registers a WebSocket handler.
-     *
-     * @param {websocket<any>} websocket - The WebSocket to register.
-     * @param middlewares to used in upgrade function
+     * Registers a new WebSocket service with associated middlewares
+     * @param websocket - WebSocket service instance to register
+     * @param middlewares - Array of middleware functions to be executed during connection upgrade
      */
-    abstract registerWebSocket(websocket: AsenaWebSocketService<any>, middlewares: MH[]): void;
+    abstract registerWebSocket(websocket: AsenaWebSocketService<any>, middlewares: BaseMiddleware<C>[]): Promise<void> | void;
     /**
-     * Prepares the WebSocket with the given options.
-     *
-     * @param {WSOptions} [wsOptions] - Optional WebSocket options.
+     * Configures and initializes the WebSocket server with provided options
+     * @param wsOptions - Configuration options for the WebSocket server
      */
-    abstract prepareWebSocket(wsOptions?: WSOptions): void;
+    abstract buildWebsocket(wsOptions?: WSOptions): Promise<void> | void;
     /**
-     * Build the WebSocket object for the server.
+     * Starts the WebSocket server on the provided HTTP/S server instance
+     * @param server - HTTP/S server instance to attach the WebSocket server to
      */
-    abstract buildWebsocket(): void;
+    abstract startWebsocket(server: any): Promise<void> | void;
     /**
-     * Start the WebSocket server.
-     *
-     * @param {Server} server - The server to start.
+     * Gets the application instance
      */
-    abstract startWebsocket(server: any): void;
     get app(): A;
+    /**
+     * Sets the application instance
+     */
     set app(value: A);
-    protected get websockets(): WebSocketRegistry;
-    protected set websockets(value: WebSocketRegistry);
+    /**
+     * Gets the WebSocket registry
+     */
+    protected get websockets(): WebSocketRegistry<C>;
+    /**
+     * Sets the WebSocket registry
+     */
+    protected set websockets(value: WebSocketRegistry<C>);
+    /**
+     * Gets the WebSocket handler
+     */
     get websocket(): WebSocketHandler;
+    /**
+     * Sets the WebSocket handler
+     */
     set websocket(value: WebSocketHandler);
+    /**
+     * Gets the logger instance
+     */
     get logger(): ServerLogger;
+    /**
+     * Sets the logger instance
+     */
     set logger(value: ServerLogger);
 }

package/dist/lib/adapter/AsenaWebsocketAdapter.js

@@ -1,61 +1,92 @@
 /**
- * Abstract class representing a WebSocket adapter.
+ * Abstract class that provides a base implementation for WebSocket adapters.
+ * Handles WebSocket connections, registration, and management.
  *
- * @template A - The type of the application.
- * @template AM - The type of the message.
+ * @template A - Type of the application instance
+ * @template R - Type of the request object
+ * @template S - Type of the response object
  */
 export class AsenaWebsocketAdapter {
+    name;
     /**
-     * The WebSocket services.
-     * @ string - The namespace of the WebSocket.
-     * @ AsenaWebSocketService<any> - The WebSocket service.
-     * @ MH[] - The middlewares to use.
+     * Registry containing WebSocket services and their configurations
+     * Structure:
+     * - Key: WebSocket namespace
+     * - Value: Object containing:
+     *   - service: WebSocket service instance
+     *   - middlewares: Array of middleware functions
      * @protected
      */
     _websockets;
     /**
-     * The application instance.
+     * Reference to the main application instance
      * @private
      */
     _app;
     /**
-     * The WebSocket handler.
+     * WebSocket handler instance for managing connections
      * @private
      */
     _websocket;
     /**
-     * The logger instance.
+     * Logger instance for WebSocket-related logging
+     * @private
      */
     _logger = console;
     /**
-     * Constructor for the AsenaWebSocketAdapter class.
-     * @param params - The parameters for the constructor.
+     * Initializes a new WebSocket adapter instance
+     * @param params - Configuration parameters including app instance and logger
      */
     constructor(params) {
         this._app = params?.app;
         this._logger = params?.logger;
     }
+    // Getters and Setters with improved documentation
+    /**
+     * Gets the application instance
+     */
     get app() {
         return this._app;
     }
+    /**
+     * Sets the application instance
+     */
     set app(value) {
         this._app = value;
     }
+    /**
+     * Gets the WebSocket registry
+     */
     get websockets() {
         return this._websockets;
     }
+    /**
+     * Sets the WebSocket registry
+     */
     set websockets(value) {
         this._websockets = value;
     }
+    /**
+     * Gets the WebSocket handler
+     */
     get websocket() {
         return this._websocket;
     }
+    /**
+     * Sets the WebSocket handler
+     */
     set websocket(value) {
         this._websocket = value;
     }
+    /**
+     * Gets the logger instance
+     */
     get logger() {
         return this._logger;
     }
+    /**
+     * Sets the logger instance
+     */
     set logger(value) {
         this._logger = value;
     }

package/dist/lib/adapter/AsenaWebsocketAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsenaWebsocketAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaWebsocketAdapter.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAgB,qBAAqB;IAEzC;;;;;;OAMG;IACO,WAAW,CAAoB;IAEzC;;;OAGG;IACK,IAAI,CAAI;IAEhB;;;OAGG;IACK,UAAU,CAAmB;IAErC;;OAEG;IACK,OAAO,GAAiB,OAAO,CAAC;IAExC;;;OAGG;IACH,YAAsB,MAAkC;QACtD,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;IAChC,CAAC;IA6BD,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAW,GAAG,CAAC,KAAQ;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAc,UAAU,CAAC,KAAwB;QAC/C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAW,SAAS,CAAC,KAAuB;QAC1C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,MAAM,CAAC,KAAmB;QACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CAEF"}
+{"version":3,"file":"AsenaWebsocketAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaWebsocketAdapter.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,OAAgB,qBAAqB;IAEzB,IAAI,CAAS;IAE7B;;;;;;;;OAQG;IACO,WAAW,CAAuB;IAE5C;;;OAGG;IACK,IAAI,CAAI;IAEhB;;;OAGG;IACK,UAAU,CAAmB;IAErC;;;OAGG;IACK,OAAO,GAAiB,OAAO,CAAC;IAExC;;;OAGG;IACH,YAAsB,MAAkC;QACtD,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;IAChC,CAAC;IAwBD,kDAAkD;IAElD;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAW,GAAG,CAAC,KAAQ;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAc,UAAU,CAAC,KAA2B;QAClD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS,CAAC,KAAuB;QAC1C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,MAAM,CAAC,KAAmB;QACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CAEF"}

package/dist/lib/adapter/index.d.ts

@@ -1,3 +1,4 @@
 export * from './AsenaAdapter';
+export * from './AsenaWebsocketAdapter';
 export * from './AsenaContext';
 export * from './types';

package/dist/lib/adapter/index.js

@@ -1,4 +1,5 @@
 export * from './AsenaAdapter';
+export * from './AsenaWebsocketAdapter';
 export * from './AsenaContext';
 export * from './types';
 //# sourceMappingURL=index.js.map

package/dist/lib/adapter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/lib/adapter/types/ApiParams.d.ts

@@ -0,0 +1,73 @@
+import type { HttpMethod } from '../../server/web/types';
+import type { AsenaContext } from '../index';
+import type { MiddlewareClass, ValidatorClass } from "../../server/web/middleware";
+/**
+ * Interface representing a route configuration.
+ *
+ * @template C - The context type extending AsenaContext.
+ * @template SH - The schema type for validation.
+ */
+export interface Route<C extends AsenaContext<any, any> = any, SH = unknown> {
+    /**
+     * A dictionary where the key is a string representing the route name
+     * and the value is an object containing the parameters for the API route.
+     */
+    [key: string]: ApiParams<C, SH>;
+}
+/**
+ * Interface representing the parameters for an API route.
+ *
+ * @template C - The context type extending AsenaContext.
+ * @template SH - The schema type for validation.
+ */
+export interface ApiParams<C extends AsenaContext<any, any> = any, SH = unknown> {
+    /** The path for the route. */
+    path: string;
+    /** The HTTP method for the route. */
+    method: HttpMethod;
+    /** A brief description of the route. */
+    description: string;
+    /** An array of middleware classes to be applied to the route. */
+    middlewares: MiddlewareClass<C>[];
+    /** A flag indicating whether to serve static files. */
+    staticServe: boolean;
+    /** The validator class for request validation. */
+    validator: ValidatorClass<SH>;
+}
+/**
+ * Type definition for a controller handler function.
+ *
+ * @template C - The context type extending AsenaContext.
+ * @param {C} c - The context object for the request and response.
+ * @param {...any[]} args - Additional arguments passed to the handler.
+ * @returns {void | Promise<void> | Promise<Response> | Response} - The result of the handler, which can be void, a promise resolving to void, a promise resolving to a Response, or a Response.
+ */
+export type ControllerHandler<C extends AsenaContext<any, any> = any> = (c: C, ...args: any[]) => void | Promise<void> | Promise<Response> | Response;
+/**
+ * Interface for defining parameters for a controller decorator.
+ *
+ * @template C - The context type extending AsenaContext.
+ * @template SH - The schema type for validation.
+ */
+export interface ControllerDecoratorParams<C extends AsenaContext<any, any> = any, SH = any> {
+    /**
+     * The path for the route.
+     */
+    path: string;
+    /**
+     * Optional array of middleware classes to be applied.
+     */
+    middlewares?: MiddlewareClass<C>[];
+    /**
+     * Optional description of the route.
+     */
+    description?: string;
+    /**
+     * Optional flag to serve static files.
+     */
+    staticServe?: boolean;
+    /**
+     * Optional validator class for request validation.
+     */
+    validator?: ValidatorClass<SH>;
+}

package/dist/lib/adapter/types/ApiParams.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ApiParams.js.map

package/dist/lib/adapter/types/ApiParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiParams.js","sourceRoot":"","sources":["../../../../lib/adapter/types/ApiParams.ts"],"names":[],"mappings":""}

package/dist/lib/adapter/types/AsenaHandler.d.ts

@@ -0,0 +1,2 @@
+import type { AsenaContext } from '../AsenaContext';
+export type AsenaHandler<C extends AsenaContext<any, any> = any> = (context: C) => Promise<void | Response> | (Response | void);

package/dist/lib/adapter/types/AsenaHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AsenaHandler.js.map

package/dist/lib/adapter/types/AsenaHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsenaHandler.js","sourceRoot":"","sources":["../../../../lib/adapter/types/AsenaHandler.ts"],"names":[],"mappings":""}

package/dist/lib/adapter/types/AsenaMiddlewareHandler.d.ts

@@ -0,0 +1,2 @@
+export type AsenaMiddlewareHandler<C> = (context: C, next: () => Promise<void>) => Promise<void> | any;
+export type AsenaNextHandler = () => Promise<void>;

package/dist/lib/adapter/types/AsenaMiddlewareHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AsenaMiddlewareHandler.js.map

package/dist/lib/adapter/types/AsenaMiddlewareHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsenaMiddlewareHandler.js","sourceRoot":"","sources":["../../../../lib/adapter/types/AsenaMiddlewareHandler.ts"],"names":[],"mappings":""}

package/dist/lib/adapter/types/BaseMiddleware.d.ts

@@ -0,0 +1,57 @@
+import type { Class } from '../../server/types';
+import type { ApiParams } from './ApiParams';
+import type { AsenaContext, AsenaMiddlewareHandler } from '../index';
+/**
+ * Interface representing a base middleware.
+ *
+ * @Templete context - The current Asena context
+ */
+export interface BaseMiddleware<C extends AsenaContext<any, any> = any> {
+    handle: AsenaMiddlewareHandler<C>;
+    override: boolean;
+}
+/**
+ * Interface representing a handler for validation.
+ *
+ * @template S - The type of schema for validation.
+ */
+export interface ValidatorHandler<S = unknown> {
+    handle: () => Promise<S> | S;
+    override: boolean;
+}
+/**
+ * Interface representing a base validator.
+ *
+ * @template S - The type of schema for validation.
+ */
+export interface BaseValidator<S = unknown> {
+    /**
+     * Validator for JSON body.
+     */
+    json?: ValidatorHandler<S>;
+    /**
+     * Validator for query parameters.
+     */
+    query?: ValidatorHandler<S>;
+    /**
+     * Validator for form data.
+     */
+    form?: ValidatorHandler<S>;
+    /**
+     * Validator for URL parameters.
+     */
+    param?: ValidatorHandler<S>;
+    /**
+     * Validator for headers.
+     */
+    header?: ValidatorHandler<S>;
+}
+/**
+ * Interface representing the parameters required to prepare middleware.
+ */
+export interface PrepareMiddlewareParams {
+    controller: Class;
+    routePath?: string;
+    params?: ApiParams;
+}
+export declare const VALIDATOR_METHODS: string[];

package/dist/lib/adapter/types/BaseMiddleware.js

@@ -0,0 +1,2 @@
+export const VALIDATOR_METHODS = ['json', 'query', 'form', 'param', 'header'];
+//# sourceMappingURL=BaseMiddleware.js.map

package/dist/lib/adapter/types/BaseMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMiddleware.js","sourceRoot":"","sources":["../../../../lib/adapter/types/BaseMiddleware.ts"],"names":[],"mappings":"AAiEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC"}

package/dist/lib/adapter/types/ErrorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { AsenaContext } from '../AsenaContext';
+export type ErrorHandler<C extends AsenaContext<any, any>> = (error: Error, context: C) => Response | Promise<Response>;

package/dist/lib/adapter/types/ErrorHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ErrorHandler.js.map