@albertoielpo/ielpify 0.1.0 → 0.2.0

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

@@ -1,7 +1,46 @@
+/**
+ * Marks a class as a singleton service for dependency injection.
+ * Classes decorated with @Injectable() will have a single instance
+ * shared across all consumers.
+ * @returns A class decorator
+ */
 export declare function Injectable(): ClassDecorator;
+/**
+ * Checks if a class is decorated with @Injectable().
+ * @param target - The class to check
+ * @returns True if the class is injectable, false otherwise
+ */
 export declare function isInjectable(target: new () => object): boolean;
+/**
+ * Registers a service in the DI container.
+ * If the service is not already registered, it will be instantiated.
+ * @param serviceClass - The service class to register
+ */
 export declare function registerService<T extends object>(serviceClass: new () => T): void;
+/**
+ * Resolves a service from the DI container.
+ * Creates a new instance if the service is not already registered.
+ * @param serviceClass - The service class to resolve
+ * @returns The singleton instance of the service
+ * @throws Error if the class is not decorated with @Injectable()
+ */
 export declare function resolveService<T extends object>(serviceClass: new () => T): T;
+/**
+ * Marks a constructor parameter for dependency injection.
+ * @param serviceClass - The service class to inject
+ * @returns A parameter decorator
+ */
 export declare function Inject(serviceClass: new () => object): ParameterDecorator;
+/**
+ * Creates an instance of a class with its dependencies automatically injected.
+ * @param targetClass - The class to instantiate
+ * @returns A new instance with all @Inject() dependencies resolved
+ */
 export declare function createWithInjection<T extends object>(targetClass: new (...args: any[]) => T): T;
+/**
+ * Returns all instances currently stored in the DI container.
+ * Useful for applying lifecycle operations to all services.
+ * @returns An array of all registered service instances
+ */
+export declare function getContainerInstances(): object[];
 //# sourceMappingURL=injectable.decorator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,MAAM,GAAG,OAAO,CAE9D;AAGD,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC5C,YAAY,EAAE,UAAU,CAAC,GAC1B,IAAI,CAIN;AAGD,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAU7E;AAGD,wBAAgB,MAAM,CAAC,YAAY,EAAE,UAAU,MAAM,GAAG,kBAAkB,CAOzE;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAEhD,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACvC,CAAC,CAWH"}
+{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC5C,YAAY,EAAE,UAAU,CAAC,GAC1B,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAU7E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,UAAU,MAAM,GAAG,kBAAkB,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAChD,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACvC,CAAC,CAWH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}

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

@@ -6,21 +6,45 @@ exports.registerService = registerService;
 exports.resolveService = resolveService;
 exports.Inject = Inject;
 exports.createWithInjection = createWithInjection;
+exports.getContainerInstances = getContainerInstances;
+// DI Container - stores singleton instances
 const container = new Map();
+// Metadata key for marking classes as injectable
 const INJECTABLE_METADATA = Symbol("injectable");
+/**
+ * Marks a class as a singleton service for dependency injection.
+ * Classes decorated with @Injectable() will have a single instance
+ * shared across all consumers.
+ * @returns A class decorator
+ */
 function Injectable() {
     return (target) => {
         Reflect.defineMetadata(INJECTABLE_METADATA, true, target);
     };
 }
+/**
+ * Checks if a class is decorated with @Injectable().
+ * @param target - The class to check
+ * @returns True if the class is injectable, false otherwise
+ */
 function isInjectable(target) {
     return Reflect.getMetadata(INJECTABLE_METADATA, target) === true;
 }
+/**
+ * Registers a service in the DI container.
+ * If the service is not already registered, it will be instantiated.
+ * @param serviceClass - The service class to register
+ */
 function registerService(serviceClass) {
-    if (!container.has(serviceClass)) {
-        container.set(serviceClass, new serviceClass());
-    }
+    resolveService(serviceClass);
 }
+/**
+ * Resolves a service from the DI container.
+ * Creates a new instance if the service is not already registered.
+ * @param serviceClass - The service class to resolve
+ * @returns The singleton instance of the service
+ * @throws Error if the class is not decorated with @Injectable()
+ */
 function resolveService(serviceClass) {
     if (!isInjectable(serviceClass)) {
         throw new Error(`${serviceClass.name} is not injectable. Add @Injectable() decorator.`);
@@ -30,6 +54,11 @@ function resolveService(serviceClass) {
     }
     return container.get(serviceClass);
 }
+/**
+ * Marks a constructor parameter for dependency injection.
+ * @param serviceClass - The service class to inject
+ * @returns A parameter decorator
+ */
 function Inject(serviceClass) {
     return (target, propertyKey, parameterIndex) => {
         const existingInjections = Reflect.getMetadata("injections", target) || new Map();
@@ -37,12 +66,26 @@ function Inject(serviceClass) {
         Reflect.defineMetadata("injections", existingInjections, target);
     };
 }
+/**
+ * Creates an instance of a class with its dependencies automatically injected.
+ * @param targetClass - The class to instantiate
+ * @returns A new instance with all @Inject() dependencies resolved
+ */
 function createWithInjection(targetClass) {
     const injections = Reflect.getMetadata("injections", targetClass) || new Map();
+    // Build constructor arguments from injections
     const args = [];
     injections.forEach((serviceClass, index) => {
         args[index] = resolveService(serviceClass);
     });
     return new targetClass(...args);
 }
+/**
+ * Returns all instances currently stored in the DI container.
+ * Useful for applying lifecycle operations to all services.
+ * @returns An array of all registered service instances
+ */
+function getContainerInstances() {
+    return Array.from(container.values());
+}
 //# sourceMappingURL=injectable.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":";;AAOA,gCAIC;AAGD,oCAEC;AAGD,0CAMC;AAGD,wCAUC;AAGD,wBAOC;AAGD,kDAcC;AAhED,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAGtD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAGjD,SAAgB,UAAU;IACtB,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,YAAY,CAAC,MAAwB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACrE,CAAC;AAGD,SAAgB,eAAe,CAC3B,YAAyB;IAEzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;AACL,CAAC;AAGD,SAAgB,cAAc,CAAmB,YAAyB;IACtE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,GAAG,YAAY,CAAC,IAAI,kDAAkD,CACzE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,YAAY,CAAM,CAAC;AAC5C,CAAC;AAGD,SAAgB,MAAM,CAAC,YAA8B;IACjD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC3D,kBAAkB,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,mBAAmB,CAE/B,WAAsC;IAEtC,MAAM,UAAU,GACZ,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAGhE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":";;AAYA,gCAIC;AAOD,oCAEC;AAOD,0CAIC;AASD,wCAUC;AAOD,wBAOC;AAOD,kDAaC;AAOD,sDAEC;AAlGD,4CAA4C;AAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEtD,iDAAiD;AACjD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,SAAgB,UAAU;IACtB,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,MAAwB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAC3B,YAAyB;IAEzB,cAAc,CAAC,YAAY,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAmB,YAAyB;IACtE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,GAAG,YAAY,CAAC,IAAI,kDAAkD,CACzE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,YAAY,CAAM,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,YAA8B;IACjD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC3D,kBAAkB,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAC/B,WAAsC;IAEtC,MAAM,UAAU,GACZ,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEhE,8CAA8C;IAC9C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cjs/decorators/route.decorator.d.ts

@@ -1,11 +1,53 @@
 import { FastifyInstance } from "fastify";
+/**
+ * Marks a class as a controller with an optional route prefix.
+ * @param prefix - The base path prefix for all routes in this controller
+ * @returns A class decorator
+ */
 export declare function Controller(prefix?: string): ClassDecorator;
+/**
+ * Marks a method as a GET route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Get: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a POST route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Post: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a PUT route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Put: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a DELETE route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Delete: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a PATCH route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Patch: (path?: string) => MethodDecorator;
 type ControllerClass = new (...args: any[]) => object;
+/**
+ * Registers a controller with a Fastify instance.
+ * Creates the controller with dependency injection and sets up all routes.
+ * @param fastify - The Fastify instance
+ * @param controllerClass - The controller class to register
+ */
 export declare function registerController(fastify: FastifyInstance, controllerClass: ControllerClass): void;
+/**
+ * Returns all registered controller instances.
+ * Useful for applying lifecycle operations to all controllers.
+ * @returns An array of all registered controller instances
+ */
+export declare function getControllerInstances(): object[];
 export {};
 //# sourceMappingURL=route.decorator.d.ts.map

package/dist/cjs/decorators/route.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAwBxE,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAW9D;AA0BD,eAAO,MAAM,GAAG,UAtBE,MAAM,KAAQ,eAsBe,CAAC;AAChD,eAAO,MAAM,IAAI,UAvBC,MAAM,KAAQ,eAuBiB,CAAC;AAClD,eAAO,MAAM,GAAG,UAxBE,MAAM,KAAQ,eAwBe,CAAC;AAChD,eAAO,MAAM,MAAM,UAzBD,MAAM,KAAQ,eAyBqB,CAAC;AACtD,eAAO,MAAM,KAAK,UA1BA,MAAM,KAAQ,eA0BmB,CAAC;AAIpD,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;AAGtD,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,eAAe,GACjC,IAAI,CAeN"}
+{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAuBxE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAW9D;AAyBD;;;;GAIG;AACH,eAAO,MAAM,GAAG,UA1BE,MAAM,KAAQ,eA0Be,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,IAAI,UAjCC,MAAM,KAAQ,eAiCiB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,GAAG,UAxCE,MAAM,KAAQ,eAwCe,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,MAAM,UA/CD,MAAM,KAAQ,eA+CqB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,KAAK,UAtDA,MAAM,KAAQ,eAsDmB,CAAC;AAGpD,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;AAKtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,eAAe,GACjC,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}

package/dist/cjs/decorators/route.decorator.js

@@ -3,14 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = void 0;
 exports.Controller = Controller;
 exports.registerController = registerController;
+exports.getControllerInstances = getControllerInstances;
 const injectable_decorator_1 = require("./injectable.decorator");
+// Metadata keys
 const ROUTES_METADATA = Symbol("routes");
 const CONTROLLER_PREFIX = Symbol("controller_prefix");
+// Normalize path to ensure it starts with "/"
 function normalizePath(path) {
     if (!path)
         return "";
     return path.startsWith("/") ? path : `/${path}`;
 }
+/**
+ * Marks a class as a controller with an optional route prefix.
+ * @param prefix - The base path prefix for all routes in this controller
+ * @returns A class decorator
+ */
 function Controller(prefix = "") {
     return (target) => {
         Reflect.defineMetadata(CONTROLLER_PREFIX, normalizePath(prefix), target);
@@ -19,6 +27,7 @@ function Controller(prefix = "") {
         }
     };
 }
+// Factory for HTTP method decorators
 function createMethodDecorator(method) {
     return (path = "") => {
         return (target, propertyKey) => {
@@ -35,13 +44,47 @@ function createMethodDecorator(method) {
         };
     };
 }
+/**
+ * Marks a method as a GET route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Get = createMethodDecorator("get");
+/**
+ * Marks a method as a POST route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Post = createMethodDecorator("post");
+/**
+ * Marks a method as a PUT route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Put = createMethodDecorator("put");
+/**
+ * Marks a method as a DELETE route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Delete = createMethodDecorator("delete");
+/**
+ * Marks a method as a PATCH route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Patch = createMethodDecorator("patch");
+// Store registered controller instances
+const controllerInstances = [];
+/**
+ * Registers a controller with a Fastify instance.
+ * Creates the controller with dependency injection and sets up all routes.
+ * @param fastify - The Fastify instance
+ * @param controllerClass - The controller class to register
+ */
 function registerController(fastify, controllerClass) {
     const controller = (0, injectable_decorator_1.createWithInjection)(controllerClass);
+    controllerInstances.push(controller);
     const prefix = Reflect.getMetadata(CONTROLLER_PREFIX, controllerClass) || "";
     const routes = Reflect.getMetadata(ROUTES_METADATA, controllerClass) || [];
     for (const route of routes) {
@@ -50,4 +93,12 @@ function registerController(fastify, controllerClass) {
         fastify[route.method](fullPath, handler);
     }
 }
+/**
+ * Returns all registered controller instances.
+ * Useful for applying lifecycle operations to all controllers.
+ * @returns An array of all registered controller instances
+ */
+function getControllerInstances() {
+    return controllerInstances;
+}
 //# sourceMappingURL=route.decorator.js.map

package/dist/cjs/decorators/route.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":";;;AAwBA,gCAWC;AAqCD,gDAkBC;AAzFD,iEAA6D;AAG7D,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAMtD,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAUD,SAAgB,UAAU,CAAC,SAAiB,EAAE;IAC1C,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAClB,iBAAiB,EACjB,aAAa,CAAC,MAAM,CAAC,EACrB,MAAM,CACT,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAGD,SAAS,qBAAqB,CAAC,MAAiC;IAC5D,OAAO,CAAC,OAAe,EAAE,EAAmB,EAAE;QAC1C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACvC,MAAM,MAAM,GAAsB,OAAO,CAAC,WAAW,CACjD,eAAe,EACf,WAAW,CACd;gBACG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC;gBACnD,CAAC,CAAC,EAAE,CAAC;YAET,MAAM,CAAC,IAAI,CAAC;gBACR,MAAM;gBACN,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;aACnC,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAGY,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACnC,QAAA,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACrC,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACnC,QAAA,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACzC,QAAA,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAOpD,SAAgB,kBAAkB,CAC9B,OAAwB,EACxB,eAAgC;IAEhC,MAAM,UAAU,GAAG,IAAA,0CAAmB,EAAC,eAAe,CAAC,CAAC;IACxD,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAEhE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC;QACjD,MAAM,OAAO,GAAI,UAA2C,CACxD,KAAK,CAAC,WAAW,CACpB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACL,CAAC"}
+{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":"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"}

package/dist/cjs/decorators/timeout.decorator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Options for the @Timeout decorator.
+ */
+export type TimeoutOptions = {
+    /** Delay in milliseconds between each execution. */
+    ms: number;
+    /**
+     * Number of times to execute the method.
+     * Use -1 for infinite executions.
+     * @default 1
+     */
+    times?: number;
+};
+/**
+ * Schedules a method to run repeatedly with a delay.
+ * The method will be executed after the initial delay, then repeat based on the times option.
+ * @param options - Configuration options for the timeout
+ * @returns A method decorator
+ */
+export declare function Timeout(options: TimeoutOptions): MethodDecorator;
+/**
+ * Starts all @Timeout decorated methods on an instance.
+ * Call this after instantiating a class to begin scheduled executions.
+ * @param instance - The object instance containing @Timeout decorated methods
+ */
+export declare function startTimeouts(instance: object): void;
+//# sourceMappingURL=timeout.decorator.d.ts.map

package/dist/cjs/decorators/timeout.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/timeout.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwBpD"}

package/dist/cjs/decorators/timeout.decorator.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timeout = Timeout;
+exports.startTimeouts = startTimeouts;
+const TIMEOUT_METADATA = Symbol("timeout");
+/**
+ * Schedules a method to run repeatedly with a delay.
+ * The method will be executed after the initial delay, then repeat based on the times option.
+ * @param options - Configuration options for the timeout
+ * @returns A method decorator
+ */
+function Timeout(options) {
+    return (target, propertyKey, descriptor) => {
+        const existingTimeouts = Reflect.getMetadata(TIMEOUT_METADATA, target.constructor) || [];
+        existingTimeouts.push({ propertyKey, options });
+        Reflect.defineMetadata(TIMEOUT_METADATA, existingTimeouts, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Starts all @Timeout decorated methods on an instance.
+ * Call this after instantiating a class to begin scheduled executions.
+ * @param instance - The object instance containing @Timeout decorated methods
+ */
+function startTimeouts(instance) {
+    const timeouts = Reflect.getMetadata(TIMEOUT_METADATA, instance.constructor) || [];
+    for (const { propertyKey, options } of timeouts) {
+        const method = instance[propertyKey];
+        if (typeof method === "function") {
+            const times = options.times ?? 1;
+            let executionCount = 0;
+            const execute = () => {
+                if (times === -1 || executionCount < times) {
+                    executionCount++;
+                    method.call(instance);
+                    if (times === -1 || executionCount < times) {
+                        setTimeout(execute, options.ms);
+                    }
+                }
+            };
+            setTimeout(execute, options.ms);
+        }
+    }
+}
+//# sourceMappingURL=timeout.decorator.js.map

package/dist/cjs/decorators/timeout.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.decorator.js","sourceRoot":"","sources":["../../../src/decorators/timeout.decorator.ts"],"names":[],"mappings":";;AA2BA,0BAQC;AAOD,sCAwBC;AApDD,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAO3C;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAAuB;IAC3C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAA8B,EAAE,EAAE;QAC3D,MAAM,gBAAgB,GAClB,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACpE,gBAAgB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/E,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GACV,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAEtE,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAI,QAA6C,CAAC,WAAW,CAAC,CAAC;QAC3E,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,IAAI,cAAc,GAAG,CAAC,CAAC;YAEvB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACjB,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,KAAK,EAAE,CAAC;oBACzC,cAAc,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAEtB,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,KAAK,EAAE,CAAC;wBACzC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;oBACpC,CAAC;gBACL,CAAC;YACL,CAAC,CAAC;YAEF,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/cjs/index.d.ts

@@ -1,4 +1,5 @@
 import "reflect-metadata";
-export { createWithInjection, Inject, Injectable, isInjectable, registerService, resolveService } from "./decorators/injectable.decorator.js";
-export { Controller, Delete, Get, Patch, Post, Put, registerController } from "./decorators/route.decorator.js";
+export { createWithInjection, getContainerInstances, Inject, Injectable, isInjectable, registerService, resolveService } from "./decorators/injectable.decorator.js";
+export { startTimeouts, Timeout, TimeoutOptions } from "./decorators/timeout.decorator.js";
+export { Controller, Delete, Get, getControllerInstances, Patch, Post, Put, registerController } from "./decorators/route.decorator.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EACH,mBAAmB,EACnB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACH,UAAU,EACV,MAAM,EACN,GAAG,EACH,KAAK,EACL,IAAI,EACJ,GAAG,EACH,kBAAkB,EACrB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACH,aAAa,EACb,OAAO,EACP,cAAc,EACjB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACH,UAAU,EACV,MAAM,EACN,GAAG,EACH,sBAAsB,EACtB,KAAK,EACL,IAAI,EACJ,GAAG,EACH,kBAAkB,EACrB,MAAM,iCAAiC,CAAC"}

package/dist/cjs/index.js

@@ -1,18 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerController = exports.Put = exports.Post = exports.Patch = exports.Get = exports.Delete = exports.Controller = exports.resolveService = exports.registerService = exports.isInjectable = exports.Injectable = exports.Inject = exports.createWithInjection = void 0;
+exports.registerController = exports.Put = exports.Post = exports.Patch = exports.getControllerInstances = exports.Get = exports.Delete = exports.Controller = exports.Timeout = exports.startTimeouts = exports.resolveService = exports.registerService = exports.isInjectable = exports.Injectable = exports.Inject = exports.getContainerInstances = exports.createWithInjection = void 0;
 require("reflect-metadata");
+// Dependency Injection
 var injectable_decorator_js_1 = require("./decorators/injectable.decorator.js");
 Object.defineProperty(exports, "createWithInjection", { enumerable: true, get: function () { return injectable_decorator_js_1.createWithInjection; } });
+Object.defineProperty(exports, "getContainerInstances", { enumerable: true, get: function () { return injectable_decorator_js_1.getContainerInstances; } });
 Object.defineProperty(exports, "Inject", { enumerable: true, get: function () { return injectable_decorator_js_1.Inject; } });
 Object.defineProperty(exports, "Injectable", { enumerable: true, get: function () { return injectable_decorator_js_1.Injectable; } });
 Object.defineProperty(exports, "isInjectable", { enumerable: true, get: function () { return injectable_decorator_js_1.isInjectable; } });
 Object.defineProperty(exports, "registerService", { enumerable: true, get: function () { return injectable_decorator_js_1.registerService; } });
 Object.defineProperty(exports, "resolveService", { enumerable: true, get: function () { return injectable_decorator_js_1.resolveService; } });
+var timeout_decorator_js_1 = require("./decorators/timeout.decorator.js");
+Object.defineProperty(exports, "startTimeouts", { enumerable: true, get: function () { return timeout_decorator_js_1.startTimeouts; } });
+Object.defineProperty(exports, "Timeout", { enumerable: true, get: function () { return timeout_decorator_js_1.Timeout; } });
+// Routing
 var route_decorator_js_1 = require("./decorators/route.decorator.js");
 Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return route_decorator_js_1.Controller; } });
 Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return route_decorator_js_1.Delete; } });
 Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return route_decorator_js_1.Get; } });
+Object.defineProperty(exports, "getControllerInstances", { enumerable: true, get: function () { return route_decorator_js_1.getControllerInstances; } });
 Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return route_decorator_js_1.Patch; } });
 Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return route_decorator_js_1.Post; } });
 Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return route_decorator_js_1.Put; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAG1B,gFAO8C;AAN1C,8HAAA,mBAAmB,OAAA;AACnB,iHAAA,MAAM,OAAA;AACN,qHAAA,UAAU,OAAA;AACV,uHAAA,YAAY,OAAA;AACZ,0HAAA,eAAe,OAAA;AACf,yHAAA,cAAc,OAAA;AAIlB,sEAQyC;AAPrC,gHAAA,UAAU,OAAA;AACV,4GAAA,MAAM,OAAA;AACN,yGAAA,GAAG,OAAA;AACH,2GAAA,KAAK,OAAA;AACL,0GAAA,IAAI,OAAA;AACJ,yGAAA,GAAG,OAAA;AACH,wHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,uBAAuB;AACvB,gFAQ8C;AAP1C,8HAAA,mBAAmB,OAAA;AACnB,gIAAA,qBAAqB,OAAA;AACrB,iHAAA,MAAM,OAAA;AACN,qHAAA,UAAU,OAAA;AACV,uHAAA,YAAY,OAAA;AACZ,0HAAA,eAAe,OAAA;AACf,yHAAA,cAAc,OAAA;AAGlB,0EAI2C;AAHvC,qHAAA,aAAa,OAAA;AACb,+GAAA,OAAO,OAAA;AAIX,UAAU;AACV,sEASyC;AARrC,gHAAA,UAAU,OAAA;AACV,4GAAA,MAAM,OAAA;AACN,yGAAA,GAAG,OAAA;AACH,4HAAA,sBAAsB,OAAA;AACtB,2GAAA,KAAK,OAAA;AACL,0GAAA,IAAI,OAAA;AACJ,yGAAA,GAAG,OAAA;AACH,wHAAA,kBAAkB,OAAA"}

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

@@ -1,7 +1,46 @@
+/**
+ * Marks a class as a singleton service for dependency injection.
+ * Classes decorated with @Injectable() will have a single instance
+ * shared across all consumers.
+ * @returns A class decorator
+ */
 export declare function Injectable(): ClassDecorator;
+/**
+ * Checks if a class is decorated with @Injectable().
+ * @param target - The class to check
+ * @returns True if the class is injectable, false otherwise
+ */
 export declare function isInjectable(target: new () => object): boolean;
+/**
+ * Registers a service in the DI container.
+ * If the service is not already registered, it will be instantiated.
+ * @param serviceClass - The service class to register
+ */
 export declare function registerService<T extends object>(serviceClass: new () => T): void;
+/**
+ * Resolves a service from the DI container.
+ * Creates a new instance if the service is not already registered.
+ * @param serviceClass - The service class to resolve
+ * @returns The singleton instance of the service
+ * @throws Error if the class is not decorated with @Injectable()
+ */
 export declare function resolveService<T extends object>(serviceClass: new () => T): T;
+/**
+ * Marks a constructor parameter for dependency injection.
+ * @param serviceClass - The service class to inject
+ * @returns A parameter decorator
+ */
 export declare function Inject(serviceClass: new () => object): ParameterDecorator;
+/**
+ * Creates an instance of a class with its dependencies automatically injected.
+ * @param targetClass - The class to instantiate
+ * @returns A new instance with all @Inject() dependencies resolved
+ */
 export declare function createWithInjection<T extends object>(targetClass: new (...args: any[]) => T): T;
+/**
+ * Returns all instances currently stored in the DI container.
+ * Useful for applying lifecycle operations to all services.
+ * @returns An array of all registered service instances
+ */
+export declare function getContainerInstances(): object[];
 //# sourceMappingURL=injectable.decorator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,MAAM,GAAG,OAAO,CAE9D;AAGD,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC5C,YAAY,EAAE,UAAU,CAAC,GAC1B,IAAI,CAIN;AAGD,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAU7E;AAGD,wBAAgB,MAAM,CAAC,YAAY,EAAE,UAAU,MAAM,GAAG,kBAAkB,CAOzE;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAEhD,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACvC,CAAC,CAWH"}
+{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC5C,YAAY,EAAE,UAAU,CAAC,GAC1B,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAU7E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,UAAU,MAAM,GAAG,kBAAkB,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAChD,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACvC,CAAC,CAWH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}

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

@@ -6,21 +6,45 @@ exports.registerService = registerService;
 exports.resolveService = resolveService;
 exports.Inject = Inject;
 exports.createWithInjection = createWithInjection;
+exports.getContainerInstances = getContainerInstances;
+// DI Container - stores singleton instances
 const container = new Map();
+// Metadata key for marking classes as injectable
 const INJECTABLE_METADATA = Symbol("injectable");
+/**
+ * Marks a class as a singleton service for dependency injection.
+ * Classes decorated with @Injectable() will have a single instance
+ * shared across all consumers.
+ * @returns A class decorator
+ */
 function Injectable() {
     return (target) => {
         Reflect.defineMetadata(INJECTABLE_METADATA, true, target);
     };
 }
+/**
+ * Checks if a class is decorated with @Injectable().
+ * @param target - The class to check
+ * @returns True if the class is injectable, false otherwise
+ */
 function isInjectable(target) {
     return Reflect.getMetadata(INJECTABLE_METADATA, target) === true;
 }
+/**
+ * Registers a service in the DI container.
+ * If the service is not already registered, it will be instantiated.
+ * @param serviceClass - The service class to register
+ */
 function registerService(serviceClass) {
-    if (!container.has(serviceClass)) {
-        container.set(serviceClass, new serviceClass());
-    }
+    resolveService(serviceClass);
 }
+/**
+ * Resolves a service from the DI container.
+ * Creates a new instance if the service is not already registered.
+ * @param serviceClass - The service class to resolve
+ * @returns The singleton instance of the service
+ * @throws Error if the class is not decorated with @Injectable()
+ */
 function resolveService(serviceClass) {
     if (!isInjectable(serviceClass)) {
         throw new Error(`${serviceClass.name} is not injectable. Add @Injectable() decorator.`);
@@ -30,6 +54,11 @@ function resolveService(serviceClass) {
     }
     return container.get(serviceClass);
 }
+/**
+ * Marks a constructor parameter for dependency injection.
+ * @param serviceClass - The service class to inject
+ * @returns A parameter decorator
+ */
 function Inject(serviceClass) {
     return (target, propertyKey, parameterIndex) => {
         const existingInjections = Reflect.getMetadata("injections", target) || new Map();
@@ -37,12 +66,26 @@ function Inject(serviceClass) {
         Reflect.defineMetadata("injections", existingInjections, target);
     };
 }
+/**
+ * Creates an instance of a class with its dependencies automatically injected.
+ * @param targetClass - The class to instantiate
+ * @returns A new instance with all @Inject() dependencies resolved
+ */
 function createWithInjection(targetClass) {
     const injections = Reflect.getMetadata("injections", targetClass) || new Map();
+    // Build constructor arguments from injections
     const args = [];
     injections.forEach((serviceClass, index) => {
         args[index] = resolveService(serviceClass);
     });
     return new targetClass(...args);
 }
+/**
+ * Returns all instances currently stored in the DI container.
+ * Useful for applying lifecycle operations to all services.
+ * @returns An array of all registered service instances
+ */
+function getContainerInstances() {
+    return Array.from(container.values());
+}
 //# sourceMappingURL=injectable.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":";;AAOA,gCAIC;AAGD,oCAEC;AAGD,0CAMC;AAGD,wCAUC;AAGD,wBAOC;AAGD,kDAcC;AAhED,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAGtD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAGjD,SAAgB,UAAU;IACtB,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,YAAY,CAAC,MAAwB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACrE,CAAC;AAGD,SAAgB,eAAe,CAC3B,YAAyB;IAEzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;AACL,CAAC;AAGD,SAAgB,cAAc,CAAmB,YAAyB;IACtE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,GAAG,YAAY,CAAC,IAAI,kDAAkD,CACzE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,YAAY,CAAM,CAAC;AAC5C,CAAC;AAGD,SAAgB,MAAM,CAAC,YAA8B;IACjD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC3D,kBAAkB,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,mBAAmB,CAE/B,WAAsC;IAEtC,MAAM,UAAU,GACZ,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAGhE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/decorators/injectable.decorator.ts"],"names":[],"mappings":";;AAYA,gCAIC;AAOD,oCAEC;AAOD,0CAIC;AASD,wCAUC;AAOD,wBAOC;AAOD,kDAaC;AAOD,sDAEC;AAlGD,4CAA4C;AAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEtD,iDAAiD;AACjD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,SAAgB,UAAU;IACtB,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,MAAwB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAC3B,YAAyB;IAEzB,cAAc,CAAC,YAAY,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAmB,YAAyB;IACtE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,GAAG,YAAY,CAAC,IAAI,kDAAkD,CACzE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,YAAY,CAAM,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,YAA8B;IACjD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC3D,kBAAkB,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAC/B,WAAsC;IAEtC,MAAM,UAAU,GACZ,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEhE,8CAA8C;IAC9C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/esm/decorators/route.decorator.d.ts

@@ -1,11 +1,53 @@
 import { FastifyInstance } from "fastify";
+/**
+ * Marks a class as a controller with an optional route prefix.
+ * @param prefix - The base path prefix for all routes in this controller
+ * @returns A class decorator
+ */
 export declare function Controller(prefix?: string): ClassDecorator;
+/**
+ * Marks a method as a GET route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Get: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a POST route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Post: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a PUT route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Put: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a DELETE route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Delete: (path?: string) => MethodDecorator;
+/**
+ * Marks a method as a PATCH route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 export declare const Patch: (path?: string) => MethodDecorator;
 type ControllerClass = new (...args: any[]) => object;
+/**
+ * Registers a controller with a Fastify instance.
+ * Creates the controller with dependency injection and sets up all routes.
+ * @param fastify - The Fastify instance
+ * @param controllerClass - The controller class to register
+ */
 export declare function registerController(fastify: FastifyInstance, controllerClass: ControllerClass): void;
+/**
+ * Returns all registered controller instances.
+ * Useful for applying lifecycle operations to all controllers.
+ * @returns An array of all registered controller instances
+ */
+export declare function getControllerInstances(): object[];
 export {};
 //# sourceMappingURL=route.decorator.d.ts.map

package/dist/esm/decorators/route.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAwBxE,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAW9D;AA0BD,eAAO,MAAM,GAAG,UAtBE,MAAM,KAAQ,eAsBe,CAAC;AAChD,eAAO,MAAM,IAAI,UAvBC,MAAM,KAAQ,eAuBiB,CAAC;AAClD,eAAO,MAAM,GAAG,UAxBE,MAAM,KAAQ,eAwBe,CAAC;AAChD,eAAO,MAAM,MAAM,UAzBD,MAAM,KAAQ,eAyBqB,CAAC;AACtD,eAAO,MAAM,KAAK,UA1BA,MAAM,KAAQ,eA0BmB,CAAC;AAIpD,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;AAGtD,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,eAAe,GACjC,IAAI,CAeN"}
+{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAuBxE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAW9D;AAyBD;;;;GAIG;AACH,eAAO,MAAM,GAAG,UA1BE,MAAM,KAAQ,eA0Be,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,IAAI,UAjCC,MAAM,KAAQ,eAiCiB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,GAAG,UAxCE,MAAM,KAAQ,eAwCe,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,MAAM,UA/CD,MAAM,KAAQ,eA+CqB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,KAAK,UAtDA,MAAM,KAAQ,eAsDmB,CAAC;AAGpD,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;AAKtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,eAAe,GACjC,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}

package/dist/esm/decorators/route.decorator.js

@@ -3,14 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = void 0;
 exports.Controller = Controller;
 exports.registerController = registerController;
+exports.getControllerInstances = getControllerInstances;
 const injectable_decorator_1 = require("./injectable.decorator");
+// Metadata keys
 const ROUTES_METADATA = Symbol("routes");
 const CONTROLLER_PREFIX = Symbol("controller_prefix");
+// Normalize path to ensure it starts with "/"
 function normalizePath(path) {
     if (!path)
         return "";
     return path.startsWith("/") ? path : `/${path}`;
 }
+/**
+ * Marks a class as a controller with an optional route prefix.
+ * @param prefix - The base path prefix for all routes in this controller
+ * @returns A class decorator
+ */
 function Controller(prefix = "") {
     return (target) => {
         Reflect.defineMetadata(CONTROLLER_PREFIX, normalizePath(prefix), target);
@@ -19,6 +27,7 @@ function Controller(prefix = "") {
         }
     };
 }
+// Factory for HTTP method decorators
 function createMethodDecorator(method) {
     return (path = "") => {
         return (target, propertyKey) => {
@@ -35,13 +44,47 @@ function createMethodDecorator(method) {
         };
     };
 }
+/**
+ * Marks a method as a GET route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Get = createMethodDecorator("get");
+/**
+ * Marks a method as a POST route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Post = createMethodDecorator("post");
+/**
+ * Marks a method as a PUT route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Put = createMethodDecorator("put");
+/**
+ * Marks a method as a DELETE route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Delete = createMethodDecorator("delete");
+/**
+ * Marks a method as a PATCH route handler.
+ * @param path - The route path (optional)
+ * @returns A method decorator
+ */
 exports.Patch = createMethodDecorator("patch");
+// Store registered controller instances
+const controllerInstances = [];
+/**
+ * Registers a controller with a Fastify instance.
+ * Creates the controller with dependency injection and sets up all routes.
+ * @param fastify - The Fastify instance
+ * @param controllerClass - The controller class to register
+ */
 function registerController(fastify, controllerClass) {
     const controller = (0, injectable_decorator_1.createWithInjection)(controllerClass);
+    controllerInstances.push(controller);
     const prefix = Reflect.getMetadata(CONTROLLER_PREFIX, controllerClass) || "";
     const routes = Reflect.getMetadata(ROUTES_METADATA, controllerClass) || [];
     for (const route of routes) {
@@ -50,4 +93,12 @@ function registerController(fastify, controllerClass) {
         fastify[route.method](fullPath, handler);
     }
 }
+/**
+ * Returns all registered controller instances.
+ * Useful for applying lifecycle operations to all controllers.
+ * @returns An array of all registered controller instances
+ */
+function getControllerInstances() {
+    return controllerInstances;
+}
 //# sourceMappingURL=route.decorator.js.map

package/dist/esm/decorators/route.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":";;;AAwBA,gCAWC;AAqCD,gDAkBC;AAzFD,iEAA6D;AAG7D,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAMtD,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAUD,SAAgB,UAAU,CAAC,SAAiB,EAAE;IAC1C,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAClB,iBAAiB,EACjB,aAAa,CAAC,MAAM,CAAC,EACrB,MAAM,CACT,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAGD,SAAS,qBAAqB,CAAC,MAAiC;IAC5D,OAAO,CAAC,OAAe,EAAE,EAAmB,EAAE;QAC1C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACvC,MAAM,MAAM,GAAsB,OAAO,CAAC,WAAW,CACjD,eAAe,EACf,WAAW,CACd;gBACG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC;gBACnD,CAAC,CAAC,EAAE,CAAC;YAET,MAAM,CAAC,IAAI,CAAC;gBACR,MAAM;gBACN,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;aACnC,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAGY,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACnC,QAAA,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACrC,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACnC,QAAA,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACzC,QAAA,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAOpD,SAAgB,kBAAkB,CAC9B,OAAwB,EACxB,eAAgC;IAEhC,MAAM,UAAU,GAAG,IAAA,0CAAmB,EAAC,eAAe,CAAC,CAAC;IACxD,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAEhE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC;QACjD,MAAM,OAAO,GAAI,UAA2C,CACxD,KAAK,CAAC,WAAW,CACpB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACL,CAAC"}
+{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/decorators/route.decorator.ts"],"names":[],"mappings":";;;AA4BA,gCAWC;AAwED,gDAmBC;AAOD,wDAEC;AA1ID,iEAA6D;AAE7D,gBAAgB;AAChB,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAKtD,8CAA8C;AAC9C,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AASD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,SAAiB,EAAE;IAC1C,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAClB,iBAAiB,EACjB,aAAa,CAAC,MAAM,CAAC,EACrB,MAAM,CACT,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED,qCAAqC;AACrC,SAAS,qBAAqB,CAAC,MAAiC;IAC5D,OAAO,CAAC,OAAe,EAAE,EAAmB,EAAE;QAC1C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACvC,MAAM,MAAM,GAAsB,OAAO,CAAC,WAAW,CACjD,eAAe,EACf,WAAW,CACd;gBACG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC;gBACnD,CAAC,CAAC,EAAE,CAAC;YAET,MAAM,CAAC,IAAI,CAAC;gBACR,MAAM;gBACN,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;aACnC,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACU,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEhD;;;;GAIG;AACU,QAAA,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAElD;;;;GAIG;AACU,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEhD;;;;GAIG;AACU,QAAA,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAEtD;;;;GAIG;AACU,QAAA,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAKpD,wCAAwC;AACxC,MAAM,mBAAmB,GAAa,EAAE,CAAC;AAEzC;;;;;GAKG;AACH,SAAgB,kBAAkB,CAC9B,OAAwB,EACxB,eAAgC;IAEhC,MAAM,UAAU,GAAG,IAAA,0CAAmB,EAAC,eAAe,CAAC,CAAC;IACxD,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,MAAM,GACR,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;IAEhE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC;QACjD,MAAM,OAAO,GAAI,UAA2C,CACxD,KAAK,CAAC,WAAW,CACpB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB;IAClC,OAAO,mBAAmB,CAAC;AAC/B,CAAC"}

package/dist/esm/decorators/timeout.decorator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Options for the @Timeout decorator.
+ */
+export type TimeoutOptions = {
+    /** Delay in milliseconds between each execution. */
+    ms: number;
+    /**
+     * Number of times to execute the method.
+     * Use -1 for infinite executions.
+     * @default 1
+     */
+    times?: number;
+};
+/**
+ * Schedules a method to run repeatedly with a delay.
+ * The method will be executed after the initial delay, then repeat based on the times option.
+ * @param options - Configuration options for the timeout
+ * @returns A method decorator
+ */
+export declare function Timeout(options: TimeoutOptions): MethodDecorator;
+/**
+ * Starts all @Timeout decorated methods on an instance.
+ * Call this after instantiating a class to begin scheduled executions.
+ * @param instance - The object instance containing @Timeout decorated methods
+ */
+export declare function startTimeouts(instance: object): void;
+//# sourceMappingURL=timeout.decorator.d.ts.map

package/dist/esm/decorators/timeout.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/timeout.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwBpD"}

package/dist/esm/decorators/timeout.decorator.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timeout = Timeout;
+exports.startTimeouts = startTimeouts;
+const TIMEOUT_METADATA = Symbol("timeout");
+/**
+ * Schedules a method to run repeatedly with a delay.
+ * The method will be executed after the initial delay, then repeat based on the times option.
+ * @param options - Configuration options for the timeout
+ * @returns A method decorator
+ */
+function Timeout(options) {
+    return (target, propertyKey, descriptor) => {
+        const existingTimeouts = Reflect.getMetadata(TIMEOUT_METADATA, target.constructor) || [];
+        existingTimeouts.push({ propertyKey, options });
+        Reflect.defineMetadata(TIMEOUT_METADATA, existingTimeouts, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Starts all @Timeout decorated methods on an instance.
+ * Call this after instantiating a class to begin scheduled executions.
+ * @param instance - The object instance containing @Timeout decorated methods
+ */
+function startTimeouts(instance) {
+    const timeouts = Reflect.getMetadata(TIMEOUT_METADATA, instance.constructor) || [];
+    for (const { propertyKey, options } of timeouts) {
+        const method = instance[propertyKey];
+        if (typeof method === "function") {
+            const times = options.times ?? 1;
+            let executionCount = 0;
+            const execute = () => {
+                if (times === -1 || executionCount < times) {
+                    executionCount++;
+                    method.call(instance);
+                    if (times === -1 || executionCount < times) {
+                        setTimeout(execute, options.ms);
+                    }
+                }
+            };
+            setTimeout(execute, options.ms);
+        }
+    }
+}
+//# sourceMappingURL=timeout.decorator.js.map

package/dist/esm/decorators/timeout.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.decorator.js","sourceRoot":"","sources":["../../../src/decorators/timeout.decorator.ts"],"names":[],"mappings":";;AA2BA,0BAQC;AAOD,sCAwBC;AApDD,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAO3C;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAAuB;IAC3C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAA8B,EAAE,EAAE;QAC3D,MAAM,gBAAgB,GAClB,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACpE,gBAAgB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/E,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GACV,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAEtE,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAI,QAA6C,CAAC,WAAW,CAAC,CAAC;QAC3E,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,IAAI,cAAc,GAAG,CAAC,CAAC;YAEvB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACjB,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,KAAK,EAAE,CAAC;oBACzC,cAAc,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAEtB,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,KAAK,EAAE,CAAC;wBACzC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;oBACpC,CAAC;gBACL,CAAC;YACL,CAAC,CAAC;YAEF,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/esm/index.d.ts

@@ -1,4 +1,5 @@
 import "reflect-metadata";
-export { createWithInjection, Inject, Injectable, isInjectable, registerService, resolveService } from "./decorators/injectable.decorator.js";
-export { Controller, Delete, Get, Patch, Post, Put, registerController } from "./decorators/route.decorator.js";
+export { createWithInjection, getContainerInstances, Inject, Injectable, isInjectable, registerService, resolveService } from "./decorators/injectable.decorator.js";
+export { startTimeouts, Timeout, TimeoutOptions } from "./decorators/timeout.decorator.js";
+export { Controller, Delete, Get, getControllerInstances, Patch, Post, Put, registerController } from "./decorators/route.decorator.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EACH,mBAAmB,EACnB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACH,UAAU,EACV,MAAM,EACN,GAAG,EACH,KAAK,EACL,IAAI,EACJ,GAAG,EACH,kBAAkB,EACrB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACH,aAAa,EACb,OAAO,EACP,cAAc,EACjB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACH,UAAU,EACV,MAAM,EACN,GAAG,EACH,sBAAsB,EACtB,KAAK,EACL,IAAI,EACJ,GAAG,EACH,kBAAkB,EACrB,MAAM,iCAAiC,CAAC"}

package/dist/esm/index.js

@@ -1,18 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerController = exports.Put = exports.Post = exports.Patch = exports.Get = exports.Delete = exports.Controller = exports.resolveService = exports.registerService = exports.isInjectable = exports.Injectable = exports.Inject = exports.createWithInjection = void 0;
+exports.registerController = exports.Put = exports.Post = exports.Patch = exports.getControllerInstances = exports.Get = exports.Delete = exports.Controller = exports.Timeout = exports.startTimeouts = exports.resolveService = exports.registerService = exports.isInjectable = exports.Injectable = exports.Inject = exports.getContainerInstances = exports.createWithInjection = void 0;
 require("reflect-metadata");
+// Dependency Injection
 var injectable_decorator_js_1 = require("./decorators/injectable.decorator.js");
 Object.defineProperty(exports, "createWithInjection", { enumerable: true, get: function () { return injectable_decorator_js_1.createWithInjection; } });
+Object.defineProperty(exports, "getContainerInstances", { enumerable: true, get: function () { return injectable_decorator_js_1.getContainerInstances; } });
 Object.defineProperty(exports, "Inject", { enumerable: true, get: function () { return injectable_decorator_js_1.Inject; } });
 Object.defineProperty(exports, "Injectable", { enumerable: true, get: function () { return injectable_decorator_js_1.Injectable; } });
 Object.defineProperty(exports, "isInjectable", { enumerable: true, get: function () { return injectable_decorator_js_1.isInjectable; } });
 Object.defineProperty(exports, "registerService", { enumerable: true, get: function () { return injectable_decorator_js_1.registerService; } });
 Object.defineProperty(exports, "resolveService", { enumerable: true, get: function () { return injectable_decorator_js_1.resolveService; } });
+var timeout_decorator_js_1 = require("./decorators/timeout.decorator.js");
+Object.defineProperty(exports, "startTimeouts", { enumerable: true, get: function () { return timeout_decorator_js_1.startTimeouts; } });
+Object.defineProperty(exports, "Timeout", { enumerable: true, get: function () { return timeout_decorator_js_1.Timeout; } });
+// Routing
 var route_decorator_js_1 = require("./decorators/route.decorator.js");
 Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return route_decorator_js_1.Controller; } });
 Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return route_decorator_js_1.Delete; } });
 Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return route_decorator_js_1.Get; } });
+Object.defineProperty(exports, "getControllerInstances", { enumerable: true, get: function () { return route_decorator_js_1.getControllerInstances; } });
 Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return route_decorator_js_1.Patch; } });
 Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return route_decorator_js_1.Post; } });
 Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return route_decorator_js_1.Put; } });

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAG1B,gFAO8C;AAN1C,8HAAA,mBAAmB,OAAA;AACnB,iHAAA,MAAM,OAAA;AACN,qHAAA,UAAU,OAAA;AACV,uHAAA,YAAY,OAAA;AACZ,0HAAA,eAAe,OAAA;AACf,yHAAA,cAAc,OAAA;AAIlB,sEAQyC;AAPrC,gHAAA,UAAU,OAAA;AACV,4GAAA,MAAM,OAAA;AACN,yGAAA,GAAG,OAAA;AACH,2GAAA,KAAK,OAAA;AACL,0GAAA,IAAI,OAAA;AACJ,yGAAA,GAAG,OAAA;AACH,wHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,uBAAuB;AACvB,gFAQ8C;AAP1C,8HAAA,mBAAmB,OAAA;AACnB,gIAAA,qBAAqB,OAAA;AACrB,iHAAA,MAAM,OAAA;AACN,qHAAA,UAAU,OAAA;AACV,uHAAA,YAAY,OAAA;AACZ,0HAAA,eAAe,OAAA;AACf,yHAAA,cAAc,OAAA;AAGlB,0EAI2C;AAHvC,qHAAA,aAAa,OAAA;AACb,+GAAA,OAAO,OAAA;AAIX,UAAU;AACV,sEASyC;AARrC,gHAAA,UAAU,OAAA;AACV,4GAAA,MAAM,OAAA;AACN,yGAAA,GAAG,OAAA;AACH,4HAAA,sBAAsB,OAAA;AACtB,2GAAA,KAAK,OAAA;AACL,0GAAA,IAAI,OAAA;AACJ,yGAAA,GAAG,OAAA;AACH,wHAAA,kBAAkB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@albertoielpo/ielpify",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "A simplified way to build Fastify applications using decorators, inspired by NestJS",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
@@ -44,7 +44,7 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/ielpo/ielpify.git"
+        "url": "git+https://github.com/albertoielpo/ielpify.git"
     },
     "peerDependencies": {
         "fastify": ">=5.0.0",