@riktajs/core 0.1.0

package/dist/core/lifecycle/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/event-bus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrC,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,eAAe,EAAE;QAAE,QAAQ,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,eAAe,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,kBAAkB,EAAE;QAAE,QAAQ,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,aAAa,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC;AAEhD,KAAK,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,aAAa,CAAyC;IAE9D;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IACzE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAU1F;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IACrE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAQtF;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IACjF,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjE;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAIrC"}

package/dist/core/lifecycle/event-bus.js

@@ -0,0 +1,91 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBus = void 0;
+const injectable_decorator_1 = require("../decorators/injectable.decorator");
+/**
+ * EventBus - Central event system for lifecycle and custom events
+ *
+ * Provides a flexible pub/sub mechanism that works alongside
+ * the interface-based lifecycle hooks.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MonitoringService {
+ *   constructor(private events: EventBus) {
+ *     events.on('app:listen', ({ address }) => {
+ *       console.log(`Server started at ${address}`);
+ *     });
+ *   }
+ * }
+ * ```
+ */
+let EventBus = class EventBus {
+    listeners = new Map();
+    onceListeners = new Map();
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(listener);
+        return () => this.listeners.get(event)?.delete(listener);
+    }
+    once(event, listener) {
+        if (!this.onceListeners.has(event)) {
+            this.onceListeners.set(event, new Set());
+        }
+        this.onceListeners.get(event).add(listener);
+    }
+    async emit(event, payload) {
+        // Call regular listeners
+        const listeners = this.listeners.get(event);
+        if (listeners) {
+            for (const listener of listeners) {
+                await listener(payload);
+            }
+        }
+        // Call and remove once listeners
+        const onceListeners = this.onceListeners.get(event);
+        if (onceListeners) {
+            for (const listener of onceListeners) {
+                await listener(payload);
+            }
+            this.onceListeners.delete(event);
+        }
+    }
+    waitFor(event) {
+        return new Promise(resolve => this.once(event, resolve));
+    }
+    /**
+     * Remove all listeners for an event
+     */
+    off(event) {
+        this.listeners.delete(event);
+        this.onceListeners.delete(event);
+    }
+    /**
+     * Remove all listeners
+     */
+    clear() {
+        this.listeners.clear();
+        this.onceListeners.clear();
+    }
+    /**
+     * Get listener count for an event
+     */
+    listenerCount(event) {
+        return (this.listeners.get(event)?.size ?? 0) +
+            (this.onceListeners.get(event)?.size ?? 0);
+    }
+};
+exports.EventBus = EventBus;
+exports.EventBus = EventBus = __decorate([
+    (0, injectable_decorator_1.Injectable)()
+], EventBus);
+//# sourceMappingURL=event-bus.js.map

package/dist/core/lifecycle/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../../src/core/lifecycle/event-bus.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6EAAgE;AAsBhE;;;;;;;;;;;;;;;;;GAiBG;AAEI,IAAM,QAAQ,GAAd,MAAM,QAAQ;IACX,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;IAQ9D,EAAE,CAAC,KAAa,EAAE,QAAoD;QACpE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAOD,IAAI,CAAC,KAAa,EAAE,QAAoD;QACtE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAOD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAAgB;QACxC,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAOD,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAc,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa;QACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa;QACzB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;CACF,CAAA;AAvFY,4BAAQ;mBAAR,QAAQ;IADpB,IAAA,iCAAU,GAAE;GACA,QAAQ,CAuFpB"}

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

@@ -0,0 +1,4 @@
+export * from './event-bus';
+export * from './on.decorator';
+export * from './interfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/core/lifecycle/index.js

@@ -0,0 +1,21 @@
+"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 });
+// Lifecycle exports
+__exportStar(require("./event-bus"), exports);
+__exportStar(require("./on.decorator"), exports);
+__exportStar(require("./interfaces"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/lifecycle/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oBAAoB;AACpB,8CAA4B;AAC5B,iDAA+B;AAC/B,+CAA6B"}

package/dist/core/lifecycle/interfaces.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Lifecycle Hook Interfaces
+ *
+ * These interfaces provide type-safe lifecycle hooks for providers.
+ * Implement these interfaces to receive callbacks at specific points
+ * in the application lifecycle.
+ */
+/**
+ * Called when a provider is initialized
+ *
+ * This is called after the provider is instantiated and all its
+ * dependencies are injected. Use this for async initialization.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class DatabaseService implements OnProviderInit {
+ *   async onProviderInit() {
+ *     await this.connect();
+ *     console.log('Database connected');
+ *   }
+ * }
+ * ```
+ */
+export interface OnProviderInit {
+    onProviderInit(): Promise<void> | void;
+}
+/**
+ * Called when a provider is being destroyed
+ *
+ * This is called during application shutdown, in reverse priority order.
+ * Use this for cleanup operations.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class DatabaseService implements OnProviderDestroy {
+ *   async onProviderDestroy() {
+ *     await this.connection.close();
+ *     console.log('Database disconnected');
+ *   }
+ * }
+ * ```
+ */
+export interface OnProviderDestroy {
+    onProviderDestroy(): Promise<void> | void;
+}
+/**
+ * Called after all providers are initialized
+ *
+ * This is called once after all providers have been initialized.
+ * The application is fully bootstrapped at this point.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class AppService implements OnApplicationBootstrap {
+ *   onApplicationBootstrap() {
+ *     console.log('Application is ready');
+ *   }
+ * }
+ * ```
+ */
+export interface OnApplicationBootstrap {
+    onApplicationBootstrap(): Promise<void> | void;
+}
+/**
+ * Called after the server starts listening
+ *
+ * This is called after app.listen() completes successfully.
+ * The address parameter contains the server URL.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class HealthService implements OnApplicationListen {
+ *   onApplicationListen(address: string) {
+ *     console.log(`Health checks active at ${address}/health`);
+ *   }
+ * }
+ * ```
+ */
+export interface OnApplicationListen {
+    onApplicationListen(address: string): Promise<void> | void;
+}
+/**
+ * Called when the application is shutting down
+ *
+ * This is called when app.close() is invoked.
+ * Use this for graceful shutdown operations.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MetricsService implements OnApplicationShutdown {
+ *   async onApplicationShutdown(signal?: string) {
+ *     console.log(`Shutting down due to ${signal}`);
+ *     await this.flushMetrics();
+ *   }
+ * }
+ * ```
+ */
+export interface OnApplicationShutdown {
+    onApplicationShutdown(signal?: string): Promise<void> | void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/core/lifecycle/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB;IACrC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D"}

package/dist/core/lifecycle/interfaces.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Lifecycle Hook Interfaces
+ *
+ * These interfaces provide type-safe lifecycle hooks for providers.
+ * Implement these interfaces to receive callbacks at specific points
+ * in the application lifecycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/core/lifecycle/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/core/lifecycle/interfaces.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/core/lifecycle/on.decorator.d.ts

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+import { LifecycleEvent } from './event-bus';
+export declare const ON_EVENT_METADATA: unique symbol;
+/**
+ * Metadata for @On() decorated methods
+ */
+export interface OnEventMetadata {
+    event: string;
+    methodName: string;
+    priority: number;
+}
+/**
+ * @On() decorator - Listen to lifecycle or custom events
+ *
+ * Marks a method to be called when a specific event is emitted.
+ * Can be used for built-in lifecycle events or custom events.
+ *
+ * @param event - The event name to listen for
+ * @param options - Optional configuration (priority)
+ *
+ * @example Built-in lifecycle events:
+ * ```typescript
+ * @Injectable()
+ * class MonitoringService {
+ *   @On('app:listen')
+ *   onServerStart({ address, port }: EventPayload['app:listen']) {
+ *     console.log(`Server listening on ${address}:${port}`);
+ *   }
+ *
+ *   @On('app:shutdown')
+ *   async onShutdown({ signal }: EventPayload['app:shutdown']) {
+ *     await this.flushMetrics();
+ *   }
+ * }
+ * ```
+ *
+ * @example Custom events:
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   @On('user:created')
+ *   async sendWelcome(user: User) {
+ *     await this.email.send(user.email, 'Welcome!');
+ *   }
+ * }
+ * ```
+ *
+ * @example With priority (higher = called first):
+ * ```typescript
+ * @Injectable()
+ * class CriticalService {
+ *   @On('app:shutdown', { priority: 100 })
+ *   async saveState() {
+ *     // Called before other shutdown handlers
+ *   }
+ * }
+ * ```
+ */
+export declare function On(event: LifecycleEvent | string, options?: {
+    priority?: number;
+}): MethodDecorator;
+//# sourceMappingURL=on.decorator.d.ts.map

package/dist/core/lifecycle/on.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/on.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,EAAE,CAChB,KAAK,EAAE,cAAc,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,eAAe,CAajB"}

package/dist/core/lifecycle/on.decorator.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ON_EVENT_METADATA = void 0;
+exports.On = On;
+require("reflect-metadata");
+exports.ON_EVENT_METADATA = Symbol('on:event:metadata');
+/**
+ * @On() decorator - Listen to lifecycle or custom events
+ *
+ * Marks a method to be called when a specific event is emitted.
+ * Can be used for built-in lifecycle events or custom events.
+ *
+ * @param event - The event name to listen for
+ * @param options - Optional configuration (priority)
+ *
+ * @example Built-in lifecycle events:
+ * ```typescript
+ * @Injectable()
+ * class MonitoringService {
+ *   @On('app:listen')
+ *   onServerStart({ address, port }: EventPayload['app:listen']) {
+ *     console.log(`Server listening on ${address}:${port}`);
+ *   }
+ *
+ *   @On('app:shutdown')
+ *   async onShutdown({ signal }: EventPayload['app:shutdown']) {
+ *     await this.flushMetrics();
+ *   }
+ * }
+ * ```
+ *
+ * @example Custom events:
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   @On('user:created')
+ *   async sendWelcome(user: User) {
+ *     await this.email.send(user.email, 'Welcome!');
+ *   }
+ * }
+ * ```
+ *
+ * @example With priority (higher = called first):
+ * ```typescript
+ * @Injectable()
+ * class CriticalService {
+ *   @On('app:shutdown', { priority: 100 })
+ *   async saveState() {
+ *     // Called before other shutdown handlers
+ *   }
+ * }
+ * ```
+ */
+function On(event, options) {
+    return (target, propertyKey) => {
+        const existing = Reflect.getMetadata(exports.ON_EVENT_METADATA, target.constructor) ?? [];
+        existing.push({
+            event,
+            methodName: String(propertyKey),
+            priority: options?.priority ?? 0,
+        });
+        Reflect.defineMetadata(exports.ON_EVENT_METADATA, existing, target.constructor);
+    };
+}
+//# sourceMappingURL=on.decorator.js.map

package/dist/core/lifecycle/on.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on.decorator.js","sourceRoot":"","sources":["../../../src/core/lifecycle/on.decorator.ts"],"names":[],"mappings":";;;AA6DA,gBAgBC;AA7ED,4BAA0B;AAGb,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAW7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,SAAgB,EAAE,CAChB,KAA8B,EAC9B,OAA+B;IAE/B,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,yBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEnE,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK;YACL,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC;YAC/B,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;SACjC,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,yBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,64 @@
+import { Constructor } from './types';
+/**
+ * Global Registry
+ *
+ * Stores references to all decorated classes for auto-discovery.
+ * Controllers and providers register themselves here via decorators.
+ */
+declare class Registry {
+    private static instance;
+    /** All registered controllers */
+    private controllers;
+    /** All registered providers (services via @Injectable) */
+    private providers;
+    /** All registered custom providers (via @Provider) */
+    private customProviders;
+    private constructor();
+    static getInstance(): Registry;
+    /**
+     * Reset the registry (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Register a controller
+     */
+    registerController(target: Constructor): void;
+    /**
+     * Register a provider
+     */
+    registerProvider(target: Constructor): void;
+    /**
+     * Get all registered controllers
+     */
+    getControllers(): Constructor[];
+    /**
+     * Get all registered providers
+     */
+    getProviders(): Constructor[];
+    /**
+     * Check if a controller is registered
+     */
+    hasController(target: Constructor): boolean;
+    /**
+     * Check if a provider is registered
+     */
+    hasProvider(target: Constructor): boolean;
+    /**
+     * Register a custom provider (@Provider)
+     */
+    registerCustomProvider(target: Constructor): void;
+    /**
+     * Get all registered custom providers
+     */
+    getCustomProviders(): Constructor[];
+    /**
+     * Check if a custom provider is registered
+     */
+    hasCustomProvider(target: Constructor): boolean;
+}
+/**
+ * Global registry instance
+ */
+export declare const registry: Registry;
+export { Registry };
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;GAKG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAW;IAElC,iCAAiC;IACjC,OAAO,CAAC,WAAW,CAA0B;IAE7C,0DAA0D;IAC1D,OAAO,CAAC,SAAS,CAA0B;IAE3C,sDAAsD;IACtD,OAAO,CAAC,eAAe,CAA0B;IAEjD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,QAAQ;IAO9B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAI7C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAI3C;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAI/B;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI3C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAIzC;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIjD;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAInC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CAGhD;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,UAAyB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/core/registry.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Registry = exports.registry = void 0;
+/**
+ * Global Registry
+ *
+ * Stores references to all decorated classes for auto-discovery.
+ * Controllers and providers register themselves here via decorators.
+ */
+class Registry {
+    static instance;
+    /** All registered controllers */
+    controllers = new Set();
+    /** All registered providers (services via @Injectable) */
+    providers = new Set();
+    /** All registered custom providers (via @Provider) */
+    customProviders = new Set();
+    constructor() { }
+    static getInstance() {
+        if (!Registry.instance) {
+            Registry.instance = new Registry();
+        }
+        return Registry.instance;
+    }
+    /**
+     * Reset the registry (useful for testing)
+     */
+    static reset() {
+        Registry.instance = new Registry();
+    }
+    /**
+     * Register a controller
+     */
+    registerController(target) {
+        this.controllers.add(target);
+    }
+    /**
+     * Register a provider
+     */
+    registerProvider(target) {
+        this.providers.add(target);
+    }
+    /**
+     * Get all registered controllers
+     */
+    getControllers() {
+        return [...this.controllers];
+    }
+    /**
+     * Get all registered providers
+     */
+    getProviders() {
+        return [...this.providers];
+    }
+    /**
+     * Check if a controller is registered
+     */
+    hasController(target) {
+        return this.controllers.has(target);
+    }
+    /**
+     * Check if a provider is registered
+     */
+    hasProvider(target) {
+        return this.providers.has(target);
+    }
+    /**
+     * Register a custom provider (@Provider)
+     */
+    registerCustomProvider(target) {
+        this.customProviders.add(target);
+    }
+    /**
+     * Get all registered custom providers
+     */
+    getCustomProviders() {
+        return [...this.customProviders];
+    }
+    /**
+     * Check if a custom provider is registered
+     */
+    hasCustomProvider(target) {
+        return this.customProviders.has(target);
+    }
+}
+exports.Registry = Registry;
+/**
+ * Global registry instance
+ */
+exports.registry = Registry.getInstance();
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAM,QAAQ;IACJ,MAAM,CAAC,QAAQ,CAAW;IAElC,iCAAiC;IACzB,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;IAE7C,0DAA0D;IAClD,SAAS,GAAG,IAAI,GAAG,EAAe,CAAC;IAE3C,sDAAsD;IAC9C,eAAe,GAAG,IAAI,GAAG,EAAe,CAAC;IAEjD,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,QAAQ,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,QAAQ,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAmB;QACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAmB;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAmB;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAmB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAmB;QACxC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAmB;QACnC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF;AAMQ,4BAAQ;AAJjB;;GAEG;AACU,QAAA,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC"}

package/dist/core/router/router.d.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { FastifyInstance } from 'fastify';
+import { Container } from '../container/container';
+import { Constructor } from '../types';
+/**
+ * Router class
+ *
+ * Responsible for:
+ * - Scanning controllers for route metadata
+ * - Registering routes with Fastify
+ * - Handling parameter injection
+ */
+export declare class Router {
+    private readonly server;
+    private readonly container;
+    private readonly globalPrefix;
+    constructor(server: FastifyInstance, container: Container, globalPrefix?: string);
+    /**
+     * Register all routes from a controller
+     */
+    registerController(controllerClass: Constructor): void;
+    /**
+     * Register a single route
+     */
+    private registerRoute;
+    /**
+     * Build the full route path
+     */
+    private buildPath;
+    /**
+     * Resolve handler parameters based on metadata
+     */
+    private resolveParams;
+    /**
+     * Resolve a single parameter
+     */
+    private resolveParam;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/core/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAQnD,OAAO,EAAE,WAAW,EAAiC,MAAM,UAAU,CAAC;AAGtE;;;;;;;GAOG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,MAAW;IAG5C;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,WAAW,GAAG,IAAI;IAuBtD;;OAEG;IACH,OAAO,CAAC,aAAa;IA+DrB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAmCrB"}