veloce-ts 0.1.0

package/dist/types/core/metadata.d.ts.map

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

package/dist/types/core/plugin.d.ts

@@ -0,0 +1,63 @@
+import type { VeloceTS } from './application';
+/**
+ * Plugin interface that all plugins must implement
+ * Plugins can extend the framework with additional functionality
+ */
+export interface Plugin {
+    /** Unique name of the plugin */
+    name: string;
+    /** Optional version string */
+    version?: string;
+    /** Optional list of plugin names this plugin depends on */
+    dependencies?: string[];
+    /**
+     * Install method called when the plugin is registered
+     * @param app - The VeloceTS application instance
+     */
+    install(app: VeloceTS): void | Promise<void>;
+}
+/**
+ * PluginManager handles plugin registration and installation
+ * Resolves plugin dependencies using topological sort
+ */
+export declare class PluginManager {
+    private plugins;
+    private installed;
+    /**
+     * Register a plugin with the manager
+     * @param plugin - The plugin to register
+     * @throws Error if plugin with same name is already registered
+     */
+    register(plugin: Plugin): void;
+    /**
+     * Install all registered plugins in dependency order
+     * @param app - The VeloceTS application instance
+     * @throws Error if plugin dependencies cannot be resolved
+     */
+    install(app: VeloceTS): Promise<void>;
+    /**
+     * Check if a plugin is installed
+     * @param name - The plugin name
+     * @returns true if the plugin is installed
+     */
+    isInstalled(name: string): boolean;
+    /**
+     * Get a registered plugin by name
+     * @param name - The plugin name
+     * @returns The plugin or undefined if not found
+     */
+    getPlugin(name: string): Plugin | undefined;
+    /**
+     * Get all registered plugin names
+     * @returns Array of plugin names
+     */
+    getPluginNames(): string[];
+    /**
+     * Resolve plugin installation order using topological sort
+     * Ensures dependencies are installed before dependents
+     * @returns Array of plugin names in installation order
+     * @throws Error if circular dependencies are detected or dependencies are missing
+     */
+    private resolveInstallOrder;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/core/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/core/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAA0B;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO9B;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;;OAGG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAqD5B"}

package/dist/types/core/router-compiler.d.ts

@@ -0,0 +1,61 @@
+import type { Hono } from 'hono';
+import { MetadataRegistry } from './metadata';
+import { DIContainer } from '../dependencies/container';
+import { ValidationEngine } from '../validation/validator';
+import { ErrorHandler } from '../errors/handler';
+/**
+ * RouterCompiler converts metadata from decorators and functional API
+ * into actual Hono routes with full validation and dependency injection
+ */
+export declare class RouterCompiler {
+    private app;
+    private metadata;
+    private container;
+    private validator;
+    private errorHandler;
+    private compiledRoutes;
+    constructor(app: Hono, metadata: MetadataRegistry, container: DIContainer, validator: ValidationEngine, errorHandler: ErrorHandler);
+    /**
+     * Compile all registered routes and register them with Hono
+     * This is the main entry point that processes all route metadata
+     */
+    compile(): void;
+    /**
+     * Normalize a path to ensure it follows Hono's conventions
+     * Converts FastAPI-style path parameters to Hono format
+     */
+    private normalizePath;
+    /**
+     * Create a Hono handler function for a route
+     * Integrates parameter extraction, validation, dependency injection, and error handling
+     */
+    private createHandler;
+    /**
+     * Serialize the handler result into a proper HTTP response
+     * Delegates to ResponseSerializer for consistent handling
+     */
+    private serializeResponse;
+    /**
+     * Handle errors that occur during request processing
+     * Delegates to ErrorHandler for consistent error handling
+     */
+    private handleError;
+    /**
+     * Extract and validate parameters from the request context
+     * Handles body, query, params, headers, cookies, and special types
+     */
+    private extractParameters;
+    /**
+     * Merge parameters and dependencies into a single arguments array
+     * Ensures each argument is placed at its correct index
+     * Note: Returns a sparse array to maintain correct parameter positions
+     * Uses pre-computed maxArgumentIndex from compiled metadata for performance
+     */
+    private mergeArguments;
+    /**
+     * Resolve dependencies for a route handler
+     * Calls DIContainer.resolve for each dependency with appropriate scope
+     */
+    private resolveDependencies;
+}
+//# sourceMappingURL=router-compiler.d.ts.map

package/dist/types/core/router-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-compiler.d.ts","sourceRoot":"","sources":["../../../src/core/router-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;;GAGG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IAPtB,OAAO,CAAC,cAAc,CAAiD;gBAG7D,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,YAAY;IAGpC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAwBf;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqCrB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;YACW,WAAW;IAKzB;;;OAGG;YACW,iBAAiB;IA6G/B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;OAGG;YACW,mBAAmB;CA2BlC"}

package/dist/types/decorators/dependencies.d.ts

@@ -0,0 +1,28 @@
+import type { Provider, Scope } from '../types';
+/**
+ * @Depends decorator for dependency injection
+ * Marks a parameter to be injected with a dependency from the DI container
+ *
+ * @param provider - The provider (class or factory) to inject
+ * @param scope - The lifecycle scope: 'singleton', 'request', or 'transient'
+ *
+ * @example
+ * ```typescript
+ * class UserService {
+ *   constructor() {}
+ *   getUser(id: string) { return { id, name: 'John' }; }
+ * }
+ *
+ * class UserController {
+ *   @Get('/users/:id')
+ *   getUser(
+ *     @Param('id') id: string,
+ *     @Depends(UserService, 'singleton') userService: UserService
+ *   ) {
+ *     return userService.getUser(id);
+ *   }
+ * }
+ * ```
+ */
+export declare function Depends<T>(provider: Provider<T>, scope?: Scope): ParameterDecorator;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/types/decorators/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/decorators/dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,KAAiB,GAAG,kBAAkB,CAc9F"}

package/dist/types/decorators/docs.d.ts

@@ -0,0 +1,38 @@
+import type { RouteDocumentation, ResponseMetadata } from '../types';
+/**
+ * ApiDoc decorator - adds documentation metadata to a route
+ * @param docs - Documentation object with summary, description, tags, etc.
+ * @example
+ * ```ts
+ * @ApiDoc({
+ *   summary: 'Get user by ID',
+ *   description: 'Retrieves a user from the database by their unique ID',
+ *   tags: ['Users'],
+ *   deprecated: false
+ * })
+ * @Get('/:id')
+ * getUser(@Param('id') id: string) {}
+ * ```
+ */
+export declare function ApiDoc(docs: RouteDocumentation): MethodDecorator;
+/**
+ * ApiResponse decorator - documents a possible response for a route
+ * Can be used multiple times to document different status codes
+ * @param response - Response metadata with status code, description, and schema
+ * @example
+ * ```ts
+ * @ApiResponse({
+ *   statusCode: 200,
+ *   description: 'User found',
+ *   schema: UserSchema
+ * })
+ * @ApiResponse({
+ *   statusCode: 404,
+ *   description: 'User not found'
+ * })
+ * @Get('/:id')
+ * getUser(@Param('id') id: string) {}
+ * ```
+ */
+export declare function ApiResponse(response: ResponseMetadata): MethodDecorator;
+//# sourceMappingURL=docs.d.ts.map

package/dist/types/decorators/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/decorators/docs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAchE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CA6BvE"}

package/dist/types/decorators/graphql.d.ts

@@ -0,0 +1,126 @@
+import 'reflect-metadata';
+import type { ZodSchema } from 'zod';
+import type { GraphQLResolverMetadata, GraphQLFieldMetadata, GraphQLArgumentMetadata } from '../types';
+/**
+ * @Resolver decorator - Marks a class as a GraphQL resolver
+ *
+ * @example
+ * ```typescript
+ * @Resolver()
+ * class UserResolver {
+ *   @Query()
+ *   async getUser(@Arg('id', z.string()) id: string) {
+ *     return { id, name: 'John' };
+ *   }
+ * }
+ * ```
+ */
+export declare function Resolver(name?: string): ClassDecorator;
+/**
+ * @GQLQuery decorator - Marks a method as a GraphQL query
+ *
+ * @example
+ * ```typescript
+ * @GQLQuery()
+ * async getUser(@Arg('id', z.string()) id: string) {
+ *   return { id, name: 'John' };
+ * }
+ * ```
+ */
+export declare function GQLQuery(name?: string, options?: {
+    description?: string;
+    deprecated?: boolean;
+    deprecationReason?: string;
+}): MethodDecorator;
+export { GQLQuery as GraphQLQuery };
+/**
+ * @GQLMutation decorator - Marks a method as a GraphQL mutation
+ *
+ * @example
+ * ```typescript
+ * @GQLMutation()
+ * async createUser(@Arg('input', CreateUserSchema) input: CreateUserInput) {
+ *   return { id: '1', ...input };
+ * }
+ * ```
+ */
+export declare function GQLMutation(name?: string, options?: {
+    description?: string;
+    deprecated?: boolean;
+    deprecationReason?: string;
+}): MethodDecorator;
+export { GQLMutation as GraphQLMutation };
+/**
+ * @GQLSubscription decorator - Marks a method as a GraphQL subscription
+ *
+ * @example
+ * ```typescript
+ * @GQLSubscription()
+ * async onUserCreated() {
+ *   return pubsub.asyncIterator('USER_CREATED');
+ * }
+ * ```
+ */
+export declare function GQLSubscription(name?: string, options?: {
+    description?: string;
+    deprecated?: boolean;
+    deprecationReason?: string;
+}): MethodDecorator;
+export { GQLSubscription as GraphQLSubscription };
+/**
+ * @Arg decorator - Marks a parameter as a GraphQL argument with validation
+ *
+ * @example
+ * ```typescript
+ * @Query()
+ * async getUser(
+ *   @Arg('id', z.string().uuid()) id: string,
+ *   @Arg('includeProfile', z.boolean().optional()) includeProfile?: boolean
+ * ) {
+ *   return { id, name: 'John' };
+ * }
+ * ```
+ */
+export declare function Arg<T extends ZodSchema>(name: string, schema?: T, options?: {
+    description?: string;
+    defaultValue?: any;
+    nullable?: boolean;
+}): ParameterDecorator;
+/**
+ * @GQLContext decorator - Injects GraphQL context into a parameter
+ *
+ * @example
+ * ```typescript
+ * @GQLQuery()
+ * async getCurrentUser(@GQLContext() ctx: GraphQLContext) {
+ *   return ctx.user;
+ * }
+ * ```
+ */
+export declare function GQLContext(): ParameterDecorator;
+export { GQLContext as GraphQLCtx };
+/**
+ * Get resolver metadata from a class
+ */
+export declare function getResolverMetadata(target: any): GraphQLResolverMetadata | undefined;
+/**
+ * Get all field metadata from a resolver class
+ */
+export declare function getFieldsMetadata(target: any): GraphQLFieldMetadata[];
+/**
+ * Get field metadata from a specific method
+ */
+export declare function getFieldMetadata(target: any, propertyKey: string): GraphQLFieldMetadata | undefined;
+/**
+ * Get argument metadata from a method
+ */
+export declare function getArgumentsMetadata(target: any, propertyKey: string): GraphQLArgumentMetadata[];
+/**
+ * Check if a class has resolver metadata
+ */
+export declare function hasResolverMetadata(target: any): boolean;
+/**
+ * Check if a method has field metadata
+ */
+export declare function hasFieldMetadata(target: any, propertyKey: string): boolean;
+//# sourceMappingURL=graphql.d.ts.map

package/dist/types/decorators/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../../src/decorators/graphql.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,UAAU,CAAC;AAOlB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAStD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,eAAe,CAElB;AAGD,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,eAAe,CAElB;AAGD,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,eAAe,CAElB;AAGD,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAE,CAAC;AAmClD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,SAAS,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,kBAAkB,CAkBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CAe/C;AAGD,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,CAAC;AAMpC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,uBAAuB,GAAG,SAAS,CAEpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,oBAAoB,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEnG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAEhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/types/decorators/http.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Controller decorator - marks a class as a controller and sets a route prefix
+ * @param prefix - The route prefix for all routes in this controller (e.g., '/users')
+ * @example
+ * ```ts
+ * @Controller('/api/users')
+ * class UserController {
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ * ```
+ */
+export declare function Controller(prefix?: string): ClassDecorator;
+/**
+ * GET method decorator
+ * @param path - The route path (e.g., '/:id' or '/list')
+ * @example
+ * ```ts
+ * @Get('/:id')
+ * getUser(@Param('id') id: string) {}
+ * ```
+ */
+export declare const Get: (path?: string) => MethodDecorator;
+/**
+ * POST method decorator
+ * @param path - The route path
+ * @example
+ * ```ts
+ * @Post('/')
+ * createUser(@Body(UserSchema) data: User) {}
+ * ```
+ */
+export declare const Post: (path?: string) => MethodDecorator;
+/**
+ * PUT method decorator
+ * @param path - The route path
+ * @example
+ * ```ts
+ * @Put('/:id')
+ * updateUser(@Param('id') id: string, @Body(UserSchema) data: User) {}
+ * ```
+ */
+export declare const Put: (path?: string) => MethodDecorator;
+/**
+ * DELETE method decorator
+ * @param path - The route path
+ * @example
+ * ```ts
+ * @Delete('/:id')
+ * deleteUser(@Param('id') id: string) {}
+ * ```
+ */
+export declare const Delete: (path?: string) => MethodDecorator;
+/**
+ * PATCH method decorator
+ * @param path - The route path
+ * @example
+ * ```ts
+ * @Patch('/:id')
+ * patchUser(@Param('id') id: string, @Body(PartialUserSchema) data: Partial<User>) {}
+ * ```
+ */
+export declare const Patch: (path?: string) => MethodDecorator;
+/**
+ * ALL method decorator - responds to all HTTP methods
+ * @param path - The route path
+ * @example
+ * ```ts
+ * @All('/health')
+ * health() { return { status: 'ok' }; }
+ * ```
+ */
+export declare const All: (path?: string) => MethodDecorator;
+//# sourceMappingURL=http.d.ts.map

package/dist/types/decorators/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/decorators/http.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAgB9D;AA0BD;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,UA7BA,MAAM,KAAQ,eA6BiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,UAxCD,MAAM,KAAQ,eAwCmB,CAAC;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,UAnDA,MAAM,KAAQ,eAmDiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,UA9DH,MAAM,KAAQ,eA8DuB,CAAC;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,UAzEF,MAAM,KAAQ,eAyEqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,UApFA,MAAM,KAAQ,eAoFiB,CAAC"}

package/dist/types/decorators/middleware.d.ts

@@ -0,0 +1,30 @@
+import type { Middleware } from '../types';
+/**
+ * UseMiddleware decorator - applies middleware to a specific route
+ *
+ * Middleware functions are executed before the route handler.
+ * Multiple middleware can be chained and will execute in order.
+ *
+ * @param middleware - One or more middleware functions to apply
+ *
+ * @example
+ * ```typescript
+ * const authMiddleware: Middleware = async (c, next) => {
+ *   const token = c.req.header('authorization');
+ *   if (!token) {
+ *     return c.json({ error: 'Unauthorized' }, 401);
+ *   }
+ *   await next();
+ * };
+ *
+ * class UserController {
+ *   @Get('/profile')
+ *   @UseMiddleware(authMiddleware)
+ *   getProfile() {
+ *     return { name: 'John', email: 'john@example.com' };
+ *   }
+ * }
+ * ```
+ */
+export declare function UseMiddleware(...middleware: Middleware[]): MethodDecorator;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/types/decorators/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/decorators/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,eAAe,CAG1E"}

package/dist/types/decorators/params.d.ts

@@ -0,0 +1,82 @@
+import type { ZodSchema } from 'zod';
+/**
+ * Body decorator - extracts and validates request body
+ * @param schema - Optional Zod schema for validation
+ * @example
+ * ```ts
+ * @Post('/users')
+ * createUser(@Body(UserSchema) data: User) {}
+ * ```
+ */
+export declare function Body<T extends ZodSchema>(schema?: T): ParameterDecorator;
+/**
+ * Query decorator - extracts and validates query parameters
+ * @param schema - Optional Zod schema for validation
+ * @example
+ * ```ts
+ * @Get('/users')
+ * listUsers(@Query(QuerySchema) query: { page: number, limit: number }) {}
+ * ```
+ */
+export declare function Query<T extends ZodSchema>(schema?: T): ParameterDecorator;
+/**
+ * Param decorator - extracts route parameters
+ * @param name - Optional specific parameter name to extract
+ * @example
+ * ```ts
+ * @Get('/:id')
+ * getUser(@Param('id') id: string) {}
+ *
+ * // Or extract all params
+ * @Get('/:userId/posts/:postId')
+ * getPost(@Param() params: { userId: string, postId: string }) {}
+ * ```
+ */
+export declare function Param(name?: string): ParameterDecorator;
+/**
+ * Header decorator - extracts request headers
+ * @param name - Optional specific header name to extract
+ * @example
+ * ```ts
+ * @Get('/protected')
+ * getProtected(@Header('authorization') auth: string) {}
+ *
+ * // Or extract all headers
+ * @Get('/info')
+ * getInfo(@Header() headers: Record<string, string>) {}
+ * ```
+ */
+export declare function Header(name?: string): ParameterDecorator;
+/**
+ * Cookie decorator - extracts cookies
+ * @param name - Optional specific cookie name to extract
+ * @example
+ * ```ts
+ * @Get('/profile')
+ * getProfile(@Cookie('session') sessionId: string) {}
+ *
+ * // Or extract all cookies
+ * @Get('/info')
+ * getInfo(@Cookie() cookies: Record<string, string>) {}
+ * ```
+ */
+export declare function Cookie(name?: string): ParameterDecorator;
+/**
+ * Req decorator - injects the raw Hono Request object
+ * @example
+ * ```ts
+ * @Get('/raw')
+ * getRaw(@Req() req: Request) {}
+ * ```
+ */
+export declare function Req(): ParameterDecorator;
+/**
+ * Ctx decorator - injects the Hono Context object
+ * @example
+ * ```ts
+ * @Get('/context')
+ * getContext(@Ctx() ctx: Context) {}
+ * ```
+ */
+export declare function Ctx(): ParameterDecorator;
+//# sourceMappingURL=params.d.ts.map

package/dist/types/decorators/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/decorators/params.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAIrC;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAaxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAazE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAavD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAaxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAaxD;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,IAAI,kBAAkB,CAYxC;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,IAAI,kBAAkB,CAYxC"}

package/dist/types/decorators/websocket.d.ts

@@ -0,0 +1,61 @@
+import 'reflect-metadata';
+import type { ZodSchema } from 'zod';
+/**
+ * @WebSocket decorator - Marks a class as a WebSocket handler
+ * @param path - WebSocket endpoint path
+ *
+ * @example
+ * ```typescript
+ * @WebSocket('/ws/chat')
+ * class ChatHandler {
+ *   @OnConnect()
+ *   handleConnect(connection: WebSocketConnection) {
+ *     console.log('Client connected');
+ *   }
+ * }
+ * ```
+ */
+export declare function WebSocket(path: string): ClassDecorator;
+/**
+ * @OnConnect decorator - Marks a method to be called when a client connects
+ *
+ * @example
+ * ```typescript
+ * @OnConnect()
+ * handleConnect(connection: WebSocketConnection) {
+ *   connection.send({ type: 'welcome', message: 'Connected!' });
+ * }
+ * ```
+ */
+export declare function OnConnect(): MethodDecorator;
+/**
+ * @OnMessage decorator - Marks a method to be called when a message is received
+ * @param schema - Optional Zod schema for message validation
+ *
+ * @example
+ * ```typescript
+ * const MessageSchema = z.object({
+ *   type: z.string(),
+ *   content: z.string()
+ * });
+ *
+ * @OnMessage(MessageSchema)
+ * handleMessage(connection: WebSocketConnection, data: z.infer<typeof MessageSchema>) {
+ *   connection.broadcast(data);
+ * }
+ * ```
+ */
+export declare function OnMessage(schema?: ZodSchema): MethodDecorator;
+/**
+ * @OnDisconnect decorator - Marks a method to be called when a client disconnects
+ *
+ * @example
+ * ```typescript
+ * @OnDisconnect()
+ * handleDisconnect(connection: WebSocketConnection) {
+ *   console.log('Client disconnected');
+ * }
+ * ```
+ */
+export declare function OnDisconnect(): MethodDecorator;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/types/decorators/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/decorators/websocket.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAItD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAO3C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,eAAe,CAQ7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAO9C"}