@riktajs/core 0.1.0

package/dist/core/decorators/autowired.decorator.d.ts

@@ -0,0 +1,72 @@
+import 'reflect-metadata';
+import { Token } from '../container/injection-token';
+/**
+ * Metadata for autowired parameters/properties
+ */
+export interface AutowiredMetadata {
+    token: Token;
+    index?: number;
+    propertyKey?: string;
+    optional?: boolean;
+}
+/**
+ * @Autowired() decorator
+ *
+ * Universal dependency injection decorator for both:
+ * - Constructor parameters
+ * - Class properties
+ *
+ * Automatically infers the type when no token is provided.
+ *
+ * @example Property injection (most common):
+ * ```typescript
+ * @Controller('/users')
+ * export class UserController {
+ *   @Autowired()
+ *   private userService!: UserService;
+ *
+ *   @Autowired(LOGGER)  // With token for interfaces
+ *   private logger!: Logger;
+ * }
+ * ```
+ *
+ * @example Constructor injection:
+ * ```typescript
+ * @Injectable()
+ * class ApiService {
+ *   constructor(
+ *     @Autowired() private userService: UserService,
+ *     @Autowired(CONFIG) private config: AppConfig
+ *   ) {}
+ * }
+ * ```
+ */
+export declare function Autowired(token?: Token): ParameterDecorator & PropertyDecorator;
+/**
+ * @Optional() decorator
+ *
+ * Marks an injection as optional. If the dependency is not found,
+ * undefined will be injected instead of throwing an error.
+ *
+ * @example Property injection:
+ * ```typescript
+ * @Controller()
+ * export class AppController {
+ *   @Optional()
+ *   @Autowired()
+ *   private analytics?: AnalyticsService;
+ * }
+ * ```
+ *
+ * @example Constructor injection:
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   constructor(
+ *     @Optional() @Autowired(SLACK) private slack?: SlackClient
+ *   ) {}
+ * }
+ * ```
+ */
+export declare function Optional(): ParameterDecorator & PropertyDecorator;
+//# sourceMappingURL=autowired.decorator.d.ts.map

package/dist/core/decorators/autowired.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autowired.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/autowired.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,kBAAkB,GAAG,iBAAiB,CAoD/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,IAAI,kBAAkB,GAAG,iBAAiB,CAsDjE"}

package/dist/core/decorators/autowired.decorator.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Autowired = Autowired;
+exports.Optional = Optional;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * @Autowired() decorator
+ *
+ * Universal dependency injection decorator for both:
+ * - Constructor parameters
+ * - Class properties
+ *
+ * Automatically infers the type when no token is provided.
+ *
+ * @example Property injection (most common):
+ * ```typescript
+ * @Controller('/users')
+ * export class UserController {
+ *   @Autowired()
+ *   private userService!: UserService;
+ *
+ *   @Autowired(LOGGER)  // With token for interfaces
+ *   private logger!: Logger;
+ * }
+ * ```
+ *
+ * @example Constructor injection:
+ * ```typescript
+ * @Injectable()
+ * class ApiService {
+ *   constructor(
+ *     @Autowired() private userService: UserService,
+ *     @Autowired(CONFIG) private config: AppConfig
+ *   ) {}
+ * }
+ * ```
+ */
+function Autowired(token) {
+    return (target, propertyKey, parameterIndex) => {
+        if (typeof parameterIndex === 'number') {
+            // Constructor parameter injection
+            const paramTypes = Reflect.getMetadata('design:paramtypes', target) ?? [];
+            const inferredType = paramTypes[parameterIndex];
+            const resolvedToken = token ?? inferredType;
+            if (!resolvedToken) {
+                throw new Error(`@Autowired() on constructor parameter ${parameterIndex} of ${target.name} ` +
+                    `could not infer type. Please provide a token explicitly.`);
+            }
+            const existingInjects = Reflect.getMetadata(constants_1.INJECT_METADATA, target) ?? [];
+            existingInjects.push({
+                token: resolvedToken,
+                index: parameterIndex,
+            });
+            Reflect.defineMetadata(constants_1.INJECT_METADATA, existingInjects, target);
+        }
+        else if (propertyKey !== undefined) {
+            // Property injection
+            const inferredType = Reflect.getMetadata('design:type', target, propertyKey);
+            const resolvedToken = token ?? inferredType;
+            if (!resolvedToken) {
+                throw new Error(`@Autowired() on ${target.constructor.name}.${String(propertyKey)} ` +
+                    `could not infer type. Please provide a token explicitly.`);
+            }
+            const existingAutowires = Reflect.getMetadata(constants_1.AUTOWIRED_METADATA, target.constructor) ?? [];
+            existingAutowires.push({
+                token: resolvedToken,
+                propertyKey: String(propertyKey),
+            });
+            Reflect.defineMetadata(constants_1.AUTOWIRED_METADATA, existingAutowires, target.constructor);
+        }
+    };
+}
+/**
+ * @Optional() decorator
+ *
+ * Marks an injection as optional. If the dependency is not found,
+ * undefined will be injected instead of throwing an error.
+ *
+ * @example Property injection:
+ * ```typescript
+ * @Controller()
+ * export class AppController {
+ *   @Optional()
+ *   @Autowired()
+ *   private analytics?: AnalyticsService;
+ * }
+ * ```
+ *
+ * @example Constructor injection:
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   constructor(
+ *     @Optional() @Autowired(SLACK) private slack?: SlackClient
+ *   ) {}
+ * }
+ * ```
+ */
+function Optional() {
+    return (target, propertyKey, parameterIndex) => {
+        if (typeof parameterIndex === 'number') {
+            // Constructor parameter
+            const existingInjects = Reflect.getMetadata(constants_1.INJECT_METADATA, target) ?? [];
+            let meta = existingInjects.find(m => m.index === parameterIndex);
+            if (meta) {
+                meta.optional = true;
+            }
+            else {
+                const paramTypes = Reflect.getMetadata('design:paramtypes', target) ?? [];
+                const paramType = paramTypes[parameterIndex];
+                if (paramType) {
+                    existingInjects.push({
+                        token: paramType,
+                        index: parameterIndex,
+                        optional: true,
+                    });
+                }
+            }
+            Reflect.defineMetadata(constants_1.INJECT_METADATA, existingInjects, target);
+        }
+        else if (propertyKey !== undefined) {
+            // Property injection
+            const existingAutowires = Reflect.getMetadata(constants_1.AUTOWIRED_METADATA, target.constructor) ?? [];
+            let meta = existingAutowires.find(m => m.propertyKey === String(propertyKey));
+            if (meta) {
+                meta.optional = true;
+            }
+            else {
+                const propType = Reflect.getMetadata('design:type', target, propertyKey);
+                if (propType) {
+                    existingAutowires.push({
+                        token: propType,
+                        propertyKey: String(propertyKey),
+                        optional: true,
+                    });
+                }
+            }
+            Reflect.defineMetadata(constants_1.AUTOWIRED_METADATA, existingAutowires, target.constructor);
+        }
+    };
+}
+//# sourceMappingURL=autowired.decorator.js.map

package/dist/core/decorators/autowired.decorator.js.map

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

package/dist/core/decorators/controller.decorator.d.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+/**
+ * Controller options
+ */
+export interface ControllerOptions {
+    /** Route prefix for all routes in this controller */
+    prefix?: string;
+}
+/**
+ * @Controller() decorator
+ *
+ * Marks a class as a controller that handles HTTP requests.
+ * Controllers are automatically:
+ * - Registered in the global registry for auto-discovery
+ * - Injectable and registered in the DI container
+ *
+ * @example
+ * ```typescript
+ * @Controller('/users')
+ * class UserController {
+ *   @Autowired()
+ *   private userService!: UserService;
+ *
+ *   @Get('/')
+ *   getUsers() { return []; }
+ *
+ *   @Get('/:id')
+ *   getUser(@Param('id') id: string) { return { id }; }
+ * }
+ * ```
+ */
+export declare function Controller(prefixOrOptions?: string | ControllerOptions): ClassDecorator;
+//# sourceMappingURL=controller.decorator.d.ts.map

package/dist/core/decorators/controller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,cAAc,CAuBvF"}

package/dist/core/decorators/controller.decorator.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Controller = Controller;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+const container_1 = require("../container/container");
+const registry_1 = require("../registry");
+/**
+ * @Controller() decorator
+ *
+ * Marks a class as a controller that handles HTTP requests.
+ * Controllers are automatically:
+ * - Registered in the global registry for auto-discovery
+ * - Injectable and registered in the DI container
+ *
+ * @example
+ * ```typescript
+ * @Controller('/users')
+ * class UserController {
+ *   @Autowired()
+ *   private userService!: UserService;
+ *
+ *   @Get('/')
+ *   getUsers() { return []; }
+ *
+ *   @Get('/:id')
+ *   getUser(@Param('id') id: string) { return { id }; }
+ * }
+ * ```
+ */
+function Controller(prefixOrOptions) {
+    return (target) => {
+        const prefix = typeof prefixOrOptions === 'string'
+            ? prefixOrOptions
+            : prefixOrOptions?.prefix ?? '';
+        // Normalize prefix (ensure it starts with / if not empty)
+        const normalizedPrefix = prefix
+            ? (prefix.startsWith('/') ? prefix : `/${prefix}`)
+            : '';
+        // Store controller metadata
+        Reflect.defineMetadata(constants_1.CONTROLLER_METADATA, { prefix: normalizedPrefix }, target);
+        // Mark as injectable
+        Reflect.defineMetadata(constants_1.INJECTABLE_METADATA, { scope: 'singleton' }, target);
+        // Register in DI container
+        container_1.container.register(target, { scope: 'singleton' });
+        // Auto-register in global registry for discovery
+        registry_1.registry.registerController(target);
+    };
+}
+//# sourceMappingURL=controller.decorator.js.map

package/dist/core/decorators/controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":";;AAoCA,gCAuBC;AA3DD,4BAA0B;AAC1B,4CAAwE;AACxE,sDAAmD;AACnD,0CAAuC;AAUvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU,CAAC,eAA4C;IACrE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK,QAAQ;YAChD,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;QAElC,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,MAAM;YAC7B,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QAEP,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;QAElF,qBAAqB;QACrB,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;QAE5E,2BAA2B;QAC3B,qBAAS,CAAC,QAAQ,CAAC,MAA6C,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAE1F,iDAAiD;QACjD,mBAAQ,CAAC,kBAAkB,CAAC,MAA6C,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/decorators/index.d.ts

@@ -0,0 +1,7 @@
+export * from './injectable.decorator';
+export * from './controller.decorator';
+export * from './route.decorator';
+export * from './param.decorator';
+export * from './autowired.decorator';
+export * from './provider.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/core/decorators/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Export all decorators
+__exportStar(require("./injectable.decorator"), exports);
+__exportStar(require("./controller.decorator"), exports);
+__exportStar(require("./route.decorator"), exports);
+__exportStar(require("./param.decorator"), exports);
+__exportStar(require("./autowired.decorator"), exports);
+__exportStar(require("./provider.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wBAAwB;AACxB,yDAAuC;AACvC,yDAAuC;AACvC,oDAAkC;AAClC,oDAAkC;AAClC,wDAAsC;AACtC,uDAAqC"}

package/dist/core/decorators/injectable.decorator.d.ts

@@ -0,0 +1,26 @@
+import 'reflect-metadata';
+import { InjectableOptions } from '../types';
+/**
+ * @Injectable() decorator
+ *
+ * Marks a class as injectable, allowing it to be managed by the DI container.
+ * Classes decorated with @Injectable() can be injected into other classes
+ * via constructor injection or @Autowired() property injection.
+ *
+ * The class is automatically registered in the global registry for lifecycle hooks.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class UserService {
+ *   getUsers() { return []; }
+ * }
+ *
+ * @Injectable()
+ * class UserController {
+ *   constructor(private userService: UserService) {}
+ * }
+ * ```
+ */
+export declare function Injectable(options?: InjectableOptions): ClassDecorator;
+//# sourceMappingURL=injectable.decorator.d.ts.map

package/dist/core/decorators/injectable.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/injectable.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAW1E"}

package/dist/core/decorators/injectable.decorator.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Injectable = Injectable;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+const container_1 = require("../container/container");
+const registry_1 = require("../registry");
+/**
+ * @Injectable() decorator
+ *
+ * Marks a class as injectable, allowing it to be managed by the DI container.
+ * Classes decorated with @Injectable() can be injected into other classes
+ * via constructor injection or @Autowired() property injection.
+ *
+ * The class is automatically registered in the global registry for lifecycle hooks.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class UserService {
+ *   getUsers() { return []; }
+ * }
+ *
+ * @Injectable()
+ * class UserController {
+ *   constructor(private userService: UserService) {}
+ * }
+ * ```
+ */
+function Injectable(options = {}) {
+    return (target) => {
+        // Store injectable metadata
+        Reflect.defineMetadata(constants_1.INJECTABLE_METADATA, options, target);
+        // Register in DI container
+        container_1.container.register(target, options);
+        // Register in global registry for lifecycle hooks
+        registry_1.registry.registerProvider(target);
+    };
+}
+//# sourceMappingURL=injectable.decorator.js.map

package/dist/core/decorators/injectable.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/injectable.decorator.ts"],"names":[],"mappings":";;AA4BA,gCAWC;AAvCD,4BAA0B;AAC1B,4CAAmD;AAEnD,sDAAmD;AACnD,0CAAuC;AAEvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,UAAU,CAAC,UAA6B,EAAE;IACxD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE7D,2BAA2B;QAC3B,qBAAS,CAAC,QAAQ,CAAC,MAA6C,EAAE,OAAO,CAAC,CAAC;QAE3E,kDAAkD;QAClD,mBAAQ,CAAC,gBAAgB,CAAC,MAA6C,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/decorators/param.decorator.d.ts

@@ -0,0 +1,72 @@
+import 'reflect-metadata';
+import { ParamType } from '../constants';
+/**
+ * Parameter metadata structure
+ */
+export interface ParamMetadata {
+    index: number;
+    type: ParamType;
+    key?: string;
+}
+/**
+ * @Body() decorator - Injects the request body
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * createUser(@Body({ schema: CreateUserDto }) data) { return data; }
+ *
+ * @Post('/users')
+ * createUser(@Body('name') name: string) { return { name }; }
+ * ```
+ */
+export declare const Body: (key?: string) => ParameterDecorator;
+/**
+ * @Query() decorator - Injects query parameters
+ *
+ * @example
+ * ```typescript
+ * @Get('/users')
+ * getUsers(@Query('page') page: string) { return { page }; }
+ *
+ * @Get('/users')
+ * getUsers(@Query() query: Record<string, unknown>) { return query; }
+ * ```
+ */
+export declare const Query: (key?: string) => ParameterDecorator;
+/**
+ * @Param() decorator - Injects route parameters
+ *
+ * @example
+ * ```typescript
+ * @Get('/users/:id')
+ * getUser(@Param('id') id: string) { return { id }; }
+ * ```
+ */
+export declare const Param: (key?: string) => ParameterDecorator;
+/**
+ * @Headers() decorator - Injects request headers
+ *
+ * @example
+ * ```typescript
+ * @Get('/protected')
+ * getData(@Headers('authorization') auth: string) { return { auth }; }
+ * ```
+ */
+export declare const Headers: (key?: string) => ParameterDecorator;
+/**
+ * @Req() decorator - Injects the raw Fastify request object
+ */
+export declare const Req: (key?: string) => ParameterDecorator;
+export declare const Request: (key?: string) => ParameterDecorator;
+/**
+ * @Res() decorator - Injects the raw Fastify reply object
+ */
+export declare const Res: (key?: string) => ParameterDecorator;
+export declare const Reply: (key?: string) => ParameterDecorator;
+/**
+ * @Ctx() decorator - Injects the full route context
+ */
+export declare const Ctx: (key?: string) => ParameterDecorator;
+export declare const Context: (key?: string) => ParameterDecorator;
+//# sourceMappingURL=param.decorator.d.ts.map

package/dist/core/decorators/param.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA2BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,SAjCD,MAAM,KAAG,kBAiC+B,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,SA/CF,MAAM,KAAG,kBA+CiC,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,SA1DF,MAAM,KAAG,kBA0DiC,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,SArEJ,MAAM,KAAG,kBAqEqC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,GAAG,SA1EA,MAAM,KAAG,kBA0EiC,CAAC;AAC3D,eAAO,MAAM,OAAO,SA3EJ,MAAM,KAAG,kBA2EC,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,GAAG,SAhFA,MAAM,KAAG,kBAgF+B,CAAC;AACzD,eAAO,MAAM,KAAK,SAjFF,MAAM,KAAG,kBAiFD,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,GAAG,SAtFA,MAAM,KAAG,kBAsFiC,CAAC;AAC3D,eAAO,MAAM,OAAO,SAvFJ,MAAM,KAAG,kBAuFC,CAAC"}

package/dist/core/decorators/param.decorator.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = exports.Ctx = exports.Reply = exports.Res = exports.Request = exports.Req = exports.Headers = exports.Param = exports.Query = exports.Body = void 0;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Creates a parameter decorator
+ */
+function createParamDecorator(type) {
+    return (key) => {
+        return (target, propertyKey, parameterIndex) => {
+            if (propertyKey === undefined)
+                return;
+            // Get existing params or initialize empty array
+            const existingParams = Reflect.getMetadata(constants_1.PARAM_METADATA, target.constructor, propertyKey) ?? [];
+            // Add this param
+            existingParams.push({
+                index: parameterIndex,
+                type,
+                key,
+            });
+            // Store updated params
+            Reflect.defineMetadata(constants_1.PARAM_METADATA, existingParams, target.constructor, propertyKey);
+        };
+    };
+}
+/**
+ * @Body() decorator - Injects the request body
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * createUser(@Body({ schema: CreateUserDto }) data) { return data; }
+ *
+ * @Post('/users')
+ * createUser(@Body('name') name: string) { return { name }; }
+ * ```
+ */
+exports.Body = createParamDecorator(constants_1.ParamType.BODY);
+/**
+ * @Query() decorator - Injects query parameters
+ *
+ * @example
+ * ```typescript
+ * @Get('/users')
+ * getUsers(@Query('page') page: string) { return { page }; }
+ *
+ * @Get('/users')
+ * getUsers(@Query() query: Record<string, unknown>) { return query; }
+ * ```
+ */
+exports.Query = createParamDecorator(constants_1.ParamType.QUERY);
+/**
+ * @Param() decorator - Injects route parameters
+ *
+ * @example
+ * ```typescript
+ * @Get('/users/:id')
+ * getUser(@Param('id') id: string) { return { id }; }
+ * ```
+ */
+exports.Param = createParamDecorator(constants_1.ParamType.PARAM);
+/**
+ * @Headers() decorator - Injects request headers
+ *
+ * @example
+ * ```typescript
+ * @Get('/protected')
+ * getData(@Headers('authorization') auth: string) { return { auth }; }
+ * ```
+ */
+exports.Headers = createParamDecorator(constants_1.ParamType.HEADERS);
+/**
+ * @Req() decorator - Injects the raw Fastify request object
+ */
+exports.Req = createParamDecorator(constants_1.ParamType.REQUEST);
+exports.Request = exports.Req;
+/**
+ * @Res() decorator - Injects the raw Fastify reply object
+ */
+exports.Res = createParamDecorator(constants_1.ParamType.REPLY);
+exports.Reply = exports.Res;
+/**
+ * @Ctx() decorator - Injects the full route context
+ */
+exports.Ctx = createParamDecorator(constants_1.ParamType.CONTEXT);
+exports.Context = exports.Ctx;
+//# sourceMappingURL=param.decorator.js.map

package/dist/core/decorators/param.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAC1B,4CAAyD;AAWzD;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAe;IAC3C,OAAO,CAAC,GAAY,EAAsB,EAAE;QAC1C,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;YAC1F,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO;YAEtC,gDAAgD;YAChD,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,0BAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAE7E,iBAAiB;YACjB,cAAc,CAAC,IAAI,CAAC;gBAClB,KAAK,EAAE,cAAc;gBACrB,IAAI;gBACJ,GAAG;aACJ,CAAC,CAAC;YAEH,uBAAuB;YACvB,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC1F,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACU,QAAA,IAAI,GAAG,oBAAoB,CAAC,qBAAS,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;GAWG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACU,QAAA,OAAO,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC;AAE3B;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAC5C,QAAA,KAAK,GAAG,WAAG,CAAC;AAEzB;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC"}

package/dist/core/decorators/provider.decorator.d.ts

@@ -0,0 +1,64 @@
+import 'reflect-metadata';
+import { Token } from '../container/injection-token';
+/**
+ * Provider metadata stored on the class
+ */
+export interface ProviderMetadata {
+    token: Token;
+}
+/**
+ * @Provider() decorator
+ *
+ * Marks a class as a custom provider that will be auto-discovered.
+ * The class must implement a `provide()` method that returns the value.
+ *
+ * Providers can inject dependencies via constructor or @Autowired properties,
+ * making them perfect for complex factory logic.
+ *
+ * @param token - The injection token this provider supplies
+ *
+ * @example Simple value provider:
+ * ```typescript
+ * const APP_CONFIG = new InjectionToken<AppConfig>('app.config');
+ *
+ * @Provider(APP_CONFIG)
+ * export class AppConfigProvider {
+ *   provide(): AppConfig {
+ *     return {
+ *       name: 'My App',
+ *       version: '1.0.0',
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Provider with dependencies:
+ * ```typescript
+ * const LOGGER = new InjectionToken<Logger>('logger');
+ *
+ * @Provider(LOGGER)
+ * export class LoggerProvider {
+ *   constructor(@Autowired(APP_CONFIG) private config: AppConfig) {}
+ *
+ *   provide(): Logger {
+ *     return createLogger({
+ *       appName: this.config.name,
+ *       level: this.config.debug ? 'debug' : 'info',
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Async provider:
+ * ```typescript
+ * @Provider(DATABASE)
+ * export class DatabaseProvider {
+ *   async provide(): Promise<Database> {
+ *     const db = await connectToDatabase();
+ *     return db;
+ *   }
+ * }
+ * ```
+ */
+export declare function Provider(token: Token): ClassDecorator;
+//# sourceMappingURL=provider.decorator.d.ts.map