veloce-ts 0.1.0

package/dist/types/responses/response.d.ts

@@ -0,0 +1,200 @@
+import type { Context } from '../types';
+export interface FileOptions {
+    filename?: string;
+    contentType?: string;
+    download?: boolean;
+}
+export interface StreamOptions {
+    contentType?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Response builder class providing static factory methods
+ * for creating different types of HTTP responses
+ *
+ * @example
+ * ```typescript
+ * // Return JSON response
+ * return Response.json({ id: 1, name: 'John' });
+ *
+ * // Return HTML
+ * return Response.html('<h1>Hello World</h1>');
+ *
+ * // Serve a file
+ * return Response.file('./uploads/document.pdf', { download: true });
+ *
+ * // Redirect
+ * return Response.redirect('/login', 302);
+ * ```
+ */
+export declare class Response {
+    /**
+     * Create a JSON response
+     * @param data - The data to serialize as JSON
+     * @param status - HTTP status code (default: 200)
+     * @param headers - Optional custom headers
+     * @returns JSONResponse instance
+     *
+     * @example
+     * ```typescript
+     * @Get('/users/:id')
+     * getUser(@Param('id') id: string) {
+     *   return Response.json({ id, name: 'John' }, 200);
+     * }
+     * ```
+     */
+    static json(data: any, status?: number, headers?: Record<string, string>): JSONResponse;
+    /**
+     * Create an HTML response
+     * @param content - HTML content string
+     * @param status - HTTP status code (default: 200)
+     * @returns HTMLResponse instance
+     *
+     * @example
+     * ```typescript
+     * @Get('/page')
+     * getPage() {
+     *   return Response.html('<h1>Welcome</h1>');
+     * }
+     * ```
+     */
+    static html(content: string, status?: number): HTMLResponse;
+    /**
+     * Create a file response to serve static files
+     * @param path - Path to the file
+     * @param options - File serving options (filename, contentType, download)
+     * @returns FileResponse instance
+     *
+     * @example
+     * ```typescript
+     * @Get('/download/:filename')
+     * downloadFile(@Param('filename') filename: string) {
+     *   return Response.file(`./uploads/${filename}`, { download: true });
+     * }
+     * ```
+     */
+    static file(path: string, options?: FileOptions): FileResponse;
+    /**
+     * Create a streaming response for large data or real-time content
+     * @param stream - ReadableStream to send
+     * @param options - Stream options (contentType, headers)
+     * @returns StreamResponse instance
+     *
+     * @example
+     * ```typescript
+     * @Get('/stream')
+     * streamData() {
+     *   const stream = new ReadableStream({
+     *     start(controller) {
+     *       controller.enqueue('chunk 1');
+     *       controller.close();
+     *     }
+     *   });
+     *   return Response.stream(stream, { contentType: 'text/plain' });
+     * }
+     * ```
+     */
+    static stream(stream: ReadableStream, options?: StreamOptions): StreamResponse;
+    /**
+     * Create a redirect response
+     * @param url - URL to redirect to
+     * @param status - HTTP status code (default: 302)
+     * @returns RedirectResponse instance
+     *
+     * @example
+     * ```typescript
+     * @Post('/login')
+     * login(@Body(LoginSchema) credentials: LoginData) {
+     *   // ... authenticate user
+     *   return Response.redirect('/dashboard', 302);
+     * }
+     * ```
+     */
+    static redirect(url: string, status?: number): RedirectResponse;
+}
+/**
+ * JSON response class
+ * Serializes data as JSON with specified status code and headers
+ */
+export declare class JSONResponse {
+    data: any;
+    status: number;
+    headers: Record<string, string>;
+    constructor(data: any, status?: number, headers?: Record<string, string>);
+    /**
+     * Convert to Hono response format
+     * @param c - Hono context
+     * @returns Hono JSON response
+     */
+    toHonoResponse(c: Context): globalThis.Response & import("hono").TypedResponse<any, any, "json">;
+}
+/**
+ * HTML response class
+ * Returns HTML content with proper Content-Type header
+ */
+export declare class HTMLResponse {
+    content: string;
+    status: number;
+    constructor(content: string, status?: number);
+    /**
+     * Convert to Hono response format
+     * @param c - Hono context
+     * @returns Hono HTML response
+     */
+    toHonoResponse(c: Context): globalThis.Response;
+}
+/**
+ * Redirect response class
+ * Performs HTTP redirect to specified URL
+ */
+export declare class RedirectResponse {
+    url: string;
+    status: number;
+    constructor(url: string, status?: number);
+    /**
+     * Convert to Hono response format
+     * @param c - Hono context
+     * @returns Hono redirect response
+     */
+    toHonoResponse(c: Context): globalThis.Response & import("hono").TypedResponse<undefined, any, "redirect">;
+}
+/**
+ * FileResponse serves a file from the filesystem
+ * Supports custom filenames, content types, and download mode
+ */
+export declare class FileResponse {
+    path: string;
+    options?: FileOptions | undefined;
+    constructor(path: string, options?: FileOptions | undefined);
+    toHonoResponse(c: Context): Promise<(globalThis.Response & import("hono").TypedResponse<any, 200, "body">) | (globalThis.Response & import("hono").TypedResponse<{
+        error: string;
+        message: string;
+    }, 404, "json">)>;
+    private readFileNode;
+    private guessContentType;
+}
+/**
+ * StreamResponse sends data as a stream
+ * Useful for large files, real-time data, or server-sent events
+ */
+export declare class StreamResponse {
+    stream: ReadableStream;
+    options?: StreamOptions | undefined;
+    constructor(stream: ReadableStream, options?: StreamOptions | undefined);
+    toHonoResponse(c: Context): globalThis.Response & import("hono").TypedResponse<any, 200, "body">;
+}
+/**
+ * ResponseSerializer handles automatic serialization of handler return values
+ * Converts different return types into appropriate HTTP responses
+ */
+export declare class ResponseSerializer {
+    /**
+     * Serialize a handler result into an HTTP response
+     *
+     * @param c - Hono context
+     * @param result - The value returned from the handler
+     * @returns Serialized HTTP response
+     */
+    static serialize(c: Context, result: any): any;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/types/responses/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/responses/response.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,GAAE,MAAY,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7E;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY;IAIjD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;IAI/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa;IAI7D;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY;CAGlD;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEd,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAF/B,IAAI,EAAE,GAAG,EACT,MAAM,GAAE,MAAY,EACpB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAG7C;;;;OAIG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO;CAG1B;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEd,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;gBADd,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAY;IAG7B;;;;OAIG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO;CAG1B;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAElB,GAAG,EAAE,MAAM;IACX,MAAM,EAAE,MAAM;gBADd,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAY;IAG7B;;;;OAIG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO;CAG1B;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEd,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,WAAW;gBADrB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,YAAA;IAGxB,cAAc,CAAC,CAAC,EAAE,OAAO;;;;YA0CjB,YAAY;IAM1B,OAAO,CAAC,gBAAgB;CAkBzB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEhB,MAAM,EAAE,cAAc;IACtB,OAAO,CAAC,EAAE,aAAa;gBADvB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,aAAa,YAAA;IAGhC,cAAc,CAAC,CAAC,EAAE,OAAO;CAS1B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG;CAwC/C"}

package/dist/types/testing/helpers.d.ts

@@ -0,0 +1,98 @@
+import { VeloceTS } from '../core/application';
+import { TestClient } from './test-client';
+import type { VeloceTSConfig, Provider, ProviderConfig } from '../types';
+/**
+ * Create a test instance of VeloceTS application
+ * This is useful for creating isolated test instances with specific configurations
+ *
+ * @param config - Optional configuration for the test app
+ * @returns A new VeloceTS instance configured for testing
+ *
+ * @example
+ * ```typescript
+ * const app = createTestApp({ docs: false });
+ * app.get('/test', { handler: () => ({ message: 'test' }) });
+ * await app.compile();
+ *
+ * const client = new TestClient(app);
+ * const response = await client.get('/test');
+ * ```
+ */
+export declare function createTestApp(config?: VeloceTSConfig): VeloceTS;
+/**
+ * Mock a dependency in the DI container
+ * This allows you to replace real dependencies with mocks for testing
+ *
+ * @param app - The VeloceTS application instance
+ * @param provider - The provider to mock
+ * @param mockValue - The mock value or factory function
+ * @param config - Optional provider configuration
+ *
+ * @example
+ * ```typescript
+ * class UserService {
+ *   getUser(id: string) { return { id, name: 'Real User' }; }
+ * }
+ *
+ * const app = createTestApp();
+ * const mockUserService = { getUser: (id: string) => ({ id, name: 'Mock User' }) };
+ *
+ * mockDependency(app, UserService, mockUserService);
+ * ```
+ */
+export declare function mockDependency<T>(app: VeloceTS, provider: Provider<T>, mockValue: T | (() => T | Promise<T>), config?: ProviderConfig): void;
+/**
+ * Create a test client for an application
+ * This is a convenience function that creates a TestClient instance
+ *
+ * @param app - The VeloceTS application instance
+ * @returns A TestClient instance for making test requests
+ *
+ * @example
+ * ```typescript
+ * const app = createTestApp();
+ * app.get('/hello', { handler: () => ({ message: 'Hello' }) });
+ * await app.compile();
+ *
+ * const client = createTestClient(app);
+ * const response = await client.get('/hello');
+ * ```
+ */
+export declare function createTestClient(app: VeloceTS): TestClient;
+/**
+ * Setup a test application with routes and compile it
+ * This is a convenience function for quickly setting up test scenarios
+ *
+ * @param setup - Function that sets up routes on the app
+ * @param config - Optional configuration for the test app
+ * @returns Object containing the app and client
+ *
+ * @example
+ * ```typescript
+ * const { app, client } = await setupTestApp((app) => {
+ *   app.get('/users', { handler: () => [{ id: 1, name: 'User' }] });
+ *   app.post('/users', { handler: (c) => ({ id: 2, name: 'New User' }) });
+ * });
+ *
+ * const response = await client.get('/users');
+ * ```
+ */
+export declare function setupTestApp(setup: (app: VeloceTS) => void | Promise<void>, config?: VeloceTSConfig): Promise<{
+    app: VeloceTS;
+    client: TestClient;
+}>;
+/**
+ * Clear all mocked dependencies from an application
+ * This is useful for cleaning up between tests
+ *
+ * @param app - The VeloceTS application instance
+ *
+ * @example
+ * ```typescript
+ * afterEach(() => {
+ *   clearMocks(app);
+ * });
+ * ```
+ */
+export declare function clearMocks(app: VeloceTS): void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/testing/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/testing/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CAS/D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EACrC,MAAM,CAAC,EAAE,cAAc,GACtB,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CAE1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC9C,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAShD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAG9C"}

package/dist/types/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { TestClient } from './test-client';
+export type { TestRequestOptions, TestResponse } from './test-client';
+export { createTestApp, createTestClient, mockDependency, setupTestApp, clearMocks, } from './helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,WAAW,CAAC"}

package/dist/types/testing/test-client.d.ts

@@ -0,0 +1,86 @@
+import type { VeloceTS } from '../core/application';
+/**
+ * Options for making test requests
+ */
+export interface TestRequestOptions {
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    body?: any;
+    json?: any;
+}
+/**
+ * Response from a test request
+ */
+export interface TestResponse {
+    status: number;
+    headers: Headers;
+    body: any;
+    text: string;
+    json: () => Promise<any>;
+    ok: boolean;
+}
+/**
+ * TestClient provides a convenient interface for testing VeloceTS applications
+ * Wraps the Hono app.request method with helper methods for common HTTP verbs
+ */
+export declare class TestClient {
+    private hono;
+    constructor(app: VeloceTS);
+    /**
+     * Make a GET request
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    get(path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Make a POST request
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    post(path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Make a PUT request
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    put(path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Make a DELETE request
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    delete(path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Make a PATCH request
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    patch(path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Make a generic HTTP request
+     * @param method - The HTTP method
+     * @param path - The path to request
+     * @param options - Optional request options
+     * @returns The test response
+     */
+    request(method: string, path: string, options?: TestRequestOptions): Promise<TestResponse>;
+    /**
+     * Build URL with query parameters
+     * @param path - The base path
+     * @param query - Optional query parameters
+     * @returns The complete URL
+     */
+    private buildUrl;
+    /**
+     * Build headers for the request
+     * @param options - Request options
+     * @returns Headers object
+     */
+    private buildHeaders;
+}
+//# sourceMappingURL=test-client.d.ts.map

package/dist/types/testing/test-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-client.d.ts","sourceRoot":"","sources":["../../../src/testing/test-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAO;gBAEP,GAAG,EAAE,QAAQ;IAIzB;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5E;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7E;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5E;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9E;;;;;;OAMG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC;IAwCxB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAShB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAYrB"}

package/dist/types/types/index.d.ts

@@ -0,0 +1,232 @@
+import type { Context as HonoContext, MiddlewareHandler } from 'hono';
+import type { ZodSchema, z } from 'zod';
+export { z } from 'zod';
+export type { infer as Infer } from 'zod';
+export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'ALL';
+export type Class<T = any> = new (...args: any[]) => T;
+export type Provider<T = any> = Class<T> | (() => T | Promise<T>);
+export type Scope = 'singleton' | 'request' | 'transient';
+export type Context = HonoContext;
+export type Middleware = MiddlewareHandler;
+export interface RouteMetadata {
+    target: Class;
+    propertyKey: string;
+    method: HTTPMethod;
+    path: string;
+    middleware: Middleware[];
+    parameters: ParameterMetadata[];
+    dependencies: DependencyMetadata[];
+    responses: ResponseMetadata[];
+    docs?: RouteDocumentation;
+}
+export interface ParameterMetadata {
+    index: number;
+    type: 'body' | 'query' | 'param' | 'header' | 'cookie' | 'request' | 'response' | 'context';
+    schema?: ZodSchema;
+    name?: string;
+    required: boolean;
+}
+export interface DependencyMetadata {
+    index: number;
+    provider: Provider;
+    scope: Scope;
+}
+export interface ResponseMetadata {
+    statusCode: number;
+    description?: string;
+    schema?: ZodSchema;
+}
+export interface ControllerMetadata {
+    prefix: string;
+    middleware: Middleware[];
+}
+export interface RouteDocumentation {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+}
+export interface VeloceTSConfig {
+    adapter?: 'hono' | 'express' | 'native';
+    title?: string;
+    version?: string;
+    description?: string;
+    docs?: boolean | {
+        path?: string;
+        openapi?: string;
+    };
+    cors?: CorsOptions | boolean;
+    plugins?: any[];
+}
+export interface CorsOptions {
+    origin?: string | string[] | ((origin: string) => boolean);
+    methods?: string[];
+    allowedHeaders?: string[];
+    exposedHeaders?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+export interface RateLimitOptions {
+    windowMs?: number;
+    max?: number;
+    keyGenerator?: (c: Context) => string;
+}
+export interface CompressionOptions {
+    threshold?: number;
+    level?: number;
+}
+export interface RouteConfig {
+    handler: (c: Context, ...args: any[]) => any | Promise<any>;
+    schema?: {
+        body?: ZodSchema;
+        query?: ZodSchema;
+        params?: ZodSchema;
+        headers?: ZodSchema;
+    };
+    middleware?: Middleware[];
+    docs?: RouteDocumentation;
+    responses?: ResponseMetadata[];
+}
+export interface ProviderConfig {
+    scope?: Scope;
+    factory?: () => any;
+}
+export interface OpenAPIOptions {
+    title?: string;
+    version?: string;
+    description?: string;
+    path?: string;
+    docsPath?: string;
+    docs?: boolean;
+}
+export interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths: Record<string, any>;
+    components?: {
+        schemas?: Record<string, any>;
+        securitySchemes?: Record<string, any>;
+    };
+}
+export interface WebSocketMetadata {
+    target: Class;
+    path: string;
+    onConnect?: string;
+    onMessage?: string;
+    onDisconnect?: string;
+    messageSchema?: ZodSchema;
+}
+export interface WebSocketHandlerMetadata {
+    type: 'connect' | 'message' | 'disconnect';
+    method: string;
+    schema?: ZodSchema;
+}
+export type GraphQLOperationType = 'query' | 'mutation' | 'subscription';
+export interface GraphQLResolverMetadata {
+    target: Class;
+    name?: string;
+}
+export interface GraphQLFieldMetadata {
+    target: Class;
+    propertyKey: string;
+    type: GraphQLOperationType;
+    name?: string;
+    returnType?: any;
+    description?: string;
+    deprecated?: boolean;
+    deprecationReason?: string;
+}
+export interface GraphQLArgumentMetadata {
+    index: number;
+    name: string;
+    schema?: ZodSchema;
+    description?: string;
+    defaultValue?: any;
+    nullable?: boolean;
+}
+export interface GraphQLContextMetadata {
+    index: number;
+}
+/**
+ * Infer TypeScript type from a Zod schema
+ * @example
+ * const UserSchema = z.object({ name: z.string(), age: z.number() });
+ * type User = InferSchema<typeof UserSchema>; // { name: string; age: number }
+ */
+export type InferSchema<T extends ZodSchema> = z.infer<T>;
+/**
+ * Infer the body type from a route handler
+ * @example
+ * const handler = (body: InferBody<typeof UserSchema>) => { ... }
+ */
+export type InferBody<T extends ZodSchema> = z.infer<T>;
+/**
+ * Infer the query parameters type from a route handler
+ * @example
+ * const handler = (query: InferQuery<typeof QuerySchema>) => { ... }
+ */
+export type InferQuery<T extends ZodSchema> = z.infer<T>;
+/**
+ * Infer the route parameters type from a route handler
+ * @example
+ * const handler = (params: InferParams<typeof ParamsSchema>) => { ... }
+ */
+export type InferParams<T extends ZodSchema> = z.infer<T>;
+/**
+ * Infer the headers type from a route handler
+ * @example
+ * const handler = (headers: InferHeaders<typeof HeadersSchema>) => { ... }
+ */
+export type InferHeaders<T extends ZodSchema> = z.infer<T>;
+/**
+ * Extract the return type of a handler function
+ * @example
+ * const handler = async () => ({ id: 1, name: 'John' });
+ * type Response = InferResponse<typeof handler>; // { id: number; name: string }
+ */
+export type InferResponse<T extends (...args: any[]) => any> = Awaited<ReturnType<T>>;
+/**
+ * Extract the dependency type from a provider
+ * @example
+ * class UserService { ... }
+ * type Service = InferDependency<typeof UserService>; // UserService
+ */
+export type InferDependency<T extends Provider> = T extends Class<infer R> ? R : T extends () => infer R ? R : T extends () => Promise<infer R> ? R : never;
+/**
+ * Type-safe route handler with inferred parameter types
+ * @example
+ * const handler: TypedHandler<typeof BodySchema, typeof QuerySchema> =
+ *   async (body, query) => { ... }
+ */
+export type TypedHandler<TBody extends ZodSchema = any, TQuery extends ZodSchema = any, TParams extends ZodSchema = any, TResponse = any> = (body?: z.infer<TBody>, query?: z.infer<TQuery>, params?: z.infer<TParams>, context?: Context) => TResponse | Promise<TResponse>;
+/**
+ * Utility type to make all properties of T optional recursively
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Utility type to make all properties of T required recursively
+ */
+export type DeepRequired<T> = {
+    [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : T[P];
+};
+/**
+ * Extract keys from T that are of type U
+ */
+export type KeysOfType<T, U> = {
+    [K in keyof T]: T[K] extends U ? K : never;
+}[keyof T];
+/**
+ * Make specific keys K of T optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Make specific keys K of T required
+ */
+export type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/validation/exceptions.d.ts

@@ -0,0 +1,25 @@
+import { ZodError } from 'zod';
+import { HTTPException } from '../errors/exceptions.js';
+/**
+ * ValidationException is thrown when Zod validation fails
+ * Extends HTTPException with 422 Unprocessable Entity status
+ * Provides detailed validation error information
+ */
+export declare class ValidationException extends HTTPException {
+    zodError: ZodError;
+    constructor(zodError: ZodError);
+    /**
+     * Converts the validation error to a user-friendly JSON format
+     * @returns Object with error message and detailed validation errors
+     */
+    toJSON(): {
+        error: string;
+        statusCode: number;
+        details: {
+            path: string;
+            message: string;
+            code: "custom" | "invalid_type" | "invalid_literal" | "unrecognized_keys" | "invalid_union" | "invalid_union_discriminator" | "invalid_enum_value" | "invalid_arguments" | "invalid_return_type" | "invalid_date" | "invalid_string" | "too_small" | "too_big" | "invalid_intersection_types" | "not_multiple_of" | "not_finite";
+        }[];
+    };
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/types/validation/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/validation/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACjC,QAAQ,EAAE,QAAQ;gBAAlB,QAAQ,EAAE,QAAQ;IAKrC;;;OAGG;IACH,MAAM;;;;;;;;;CAWP"}