bootifyjs 1.1.9 → 1.2.1

package/dist/examples/events/buffered-event-example.js

@@ -0,0 +1,182 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderEventHandler = exports.UserEventHandler = exports.EventProcessingDemoService = exports.OrderProcessedEvent = exports.UserRegisteredEvent = void 0;
+exports.runBufferedEventExample = runBufferedEventExample;
+const decorators_1 = require("../../core/decorators");
+const decorators_2 = require("../../events/decorators");
+const events_1 = require("../../events");
+/**
+ * Example events for demonstrating buffered processing
+ */
+class UserRegisteredEvent {
+    constructor(userId, email, timestamp = Date.now(), correlationId) {
+        this.userId = userId;
+        this.email = email;
+        this.timestamp = timestamp;
+        this.correlationId = correlationId;
+        this.type = 'user.registered';
+    }
+    get payload() {
+        return {
+            userId: this.userId,
+            email: this.email,
+            timestamp: this.timestamp
+        };
+    }
+}
+exports.UserRegisteredEvent = UserRegisteredEvent;
+class OrderProcessedEvent {
+    constructor(orderId, userId, amount, timestamp = Date.now(), correlationId) {
+        this.orderId = orderId;
+        this.userId = userId;
+        this.amount = amount;
+        this.timestamp = timestamp;
+        this.correlationId = correlationId;
+        this.type = 'order.processed';
+    }
+    get payload() {
+        return {
+            orderId: this.orderId,
+            userId: this.userId,
+            amount: this.amount,
+            timestamp: this.timestamp
+        };
+    }
+}
+exports.OrderProcessedEvent = OrderProcessedEvent;
+/**
+ * Service demonstrating both regular and buffered event processing
+ */
+let EventProcessingDemoService = class EventProcessingDemoService {
+    constructor(eventBus, bufferedEventBus) {
+        this.eventBus = eventBus;
+        this.bufferedEventBus = bufferedEventBus;
+    }
+    /**
+     * Emit events using regular event bus (synchronous processing)
+     */
+    async emitRegularEvents() {
+        console.log('🔄 Emitting events via regular EventBus...');
+        // These will be processed synchronously on the main thread
+        this.eventBus.emit(new UserRegisteredEvent('user-123', 'user@example.com'));
+        this.eventBus.emit(new OrderProcessedEvent('order-456', 'user-123', 99.99));
+        console.log('✅ Regular events emitted');
+    }
+    /**
+     * Emit events using buffered event bus (asynchronous worker processing)
+     */
+    async emitBufferedEvents() {
+        if (!this.bufferedEventBus) {
+            console.log('⚠️ Buffered event bus not available');
+            return;
+        }
+        console.log('🔄 Emitting events via BufferedEventBus...');
+        // These will be processed asynchronously by worker threads
+        const result1 = await this.bufferedEventBus.emitEvent('user.registered', { userId: 'user-789', email: 'buffered@example.com' }, { priority: 'normal' });
+        const result2 = await this.bufferedEventBus.emitEvent('order.processed', { orderId: 'order-101', userId: 'user-789', amount: 149.99 }, { priority: 'critical' });
+        console.log('✅ Buffered events emitted:', { result1, result2 });
+    }
+    /**
+     * Get metrics from buffered event processing
+     */
+    getBufferedEventMetrics() {
+        if (!this.bufferedEventBus) {
+            return null;
+        }
+        return this.bufferedEventBus.getMetrics();
+    }
+    /**
+     * Get health status of buffered event processing
+     */
+    async getBufferedEventHealth() {
+        if (!this.bufferedEventBus) {
+            return null;
+        }
+        return await this.bufferedEventBus.getHealthStatus();
+    }
+};
+exports.EventProcessingDemoService = EventProcessingDemoService;
+exports.EventProcessingDemoService = EventProcessingDemoService = __decorate([
+    (0, decorators_1.Service)(),
+    __param(0, (0, decorators_1.Autowired)()),
+    __param(1, (0, decorators_1.Autowired)()),
+    __metadata("design:paramtypes", [events_1.EventBusService,
+        events_1.BufferedEventBusService])
+], EventProcessingDemoService);
+/**
+ * Event handlers that will process both regular and buffered events
+ */
+let UserEventHandler = class UserEventHandler {
+    async handleUserRegistered(event) {
+        console.log(`📧 Processing user registration for ${event.email} (ID: ${event.userId})`);
+        // Simulate some processing time
+        await new Promise(resolve => setTimeout(resolve, 100));
+        console.log(`✅ Welcome email sent to ${event.email}`);
+    }
+};
+exports.UserEventHandler = UserEventHandler;
+__decorate([
+    (0, decorators_2.OnEvent)('user.registered'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [UserRegisteredEvent]),
+    __metadata("design:returntype", Promise)
+], UserEventHandler.prototype, "handleUserRegistered", null);
+exports.UserEventHandler = UserEventHandler = __decorate([
+    (0, decorators_2.EventListener)()
+], UserEventHandler);
+let OrderEventHandler = class OrderEventHandler {
+    async handleOrderProcessed(event) {
+        console.log(`📦 Processing order ${event.orderId} for user ${event.userId} ($${event.amount})`);
+        // Simulate some processing time
+        await new Promise(resolve => setTimeout(resolve, 200));
+        console.log(`✅ Order ${event.orderId} processed successfully`);
+    }
+};
+exports.OrderEventHandler = OrderEventHandler;
+__decorate([
+    (0, decorators_2.OnEvent)('order.processed'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [OrderProcessedEvent]),
+    __metadata("design:returntype", Promise)
+], OrderEventHandler.prototype, "handleOrderProcessed", null);
+exports.OrderEventHandler = OrderEventHandler = __decorate([
+    (0, decorators_2.EventListener)()
+], OrderEventHandler);
+/**
+ * Example usage function
+ */
+async function runBufferedEventExample() {
+    console.log('\n🚀 Buffered Event Processing Example\n');
+    // This would typically be injected via DI
+    const demoService = new EventProcessingDemoService(new events_1.EventBusService());
+    // Emit regular events
+    await demoService.emitRegularEvents();
+    // Wait a bit
+    await new Promise(resolve => setTimeout(resolve, 500));
+    // Emit buffered events (if available)
+    await demoService.emitBufferedEvents();
+    // Show metrics (if available)
+    const metrics = demoService.getBufferedEventMetrics();
+    if (metrics) {
+        console.log('📊 Buffered Event Metrics:', metrics);
+    }
+    // Show health status (if available)
+    const health = await demoService.getBufferedEventHealth();
+    if (health) {
+        console.log('🏥 Buffered Event Health:', health);
+    }
+    console.log('\n✅ Example completed\n');
+}
+//# sourceMappingURL=buffered-event-example.js.map

package/dist/examples/events/buffered-event-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-event-example.js","sourceRoot":"","sources":["../../../src/examples/events/buffered-event-example.ts"],"names":[],"mappings":"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"}

package/dist/examples/events/integration-test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Integration test demonstrating buffered event processing
+ */
+export declare function runIntegrationTest(): Promise<void>;
+/**
+ * Performance test for buffered vs regular event processing
+ */
+export declare function runPerformanceComparison(): Promise<void>;
+export declare function runAllTests(): Promise<void>;
+//# sourceMappingURL=integration-test.d.ts.map

package/dist/examples/events/integration-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-test.d.ts","sourceRoot":"","sources":["../../../src/examples/events/integration-test.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,kBAAkB,kBAwEvC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,kBAqE7C;AAGD,wBAAsB,WAAW,kBAShC"}

package/dist/examples/events/integration-test.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIntegrationTest = runIntegrationTest;
+exports.runPerformanceComparison = runPerformanceComparison;
+exports.runAllTests = runAllTests;
+const bootstrap_1 = require("../../events/bootstrap");
+const buffered_event_config_1 = require("../../events/config/buffered-event-config");
+const buffered_event_example_1 = require("./buffered-event-example");
+/**
+ * Integration test demonstrating buffered event processing
+ */
+async function runIntegrationTest() {
+    console.log('🧪 Starting Buffered Event Processing Integration Test\n');
+    try {
+        // Bootstrap the event system with buffered processing enabled
+        console.log('🔧 Bootstrapping event system with buffered processing...');
+        const eventSystem = (0, bootstrap_1.bootstrapEventSystem)([], {
+            useBufferedProcessing: true,
+            bufferedEventConfig: {
+                ...buffered_event_config_1.defaultBufferedEventConfig,
+                enabled: true,
+                workerCount: 2, // Use fewer workers for testing
+                maxQueueSize: 1000,
+                maxMemoryMB: 10,
+                monitoring: {
+                    ...buffered_event_config_1.defaultBufferedEventConfig.monitoring,
+                    enabled: true,
+                    metricsInterval: 2000 // Check metrics every 2 seconds
+                }
+            }
+        });
+        console.log('✅ Event system bootstrapped successfully');
+        console.log(`📊 Regular EventBus: ${eventSystem.eventBus ? 'Available' : 'Not Available'}`);
+        console.log(`🔄 Buffered EventBus: ${eventSystem.bufferedEventBus ? 'Available' : 'Not Available'}`);
+        // Wait a moment for workers to initialize
+        console.log('⏳ Waiting for worker threads to initialize...');
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        // Run the example
+        await (0, buffered_event_example_1.runBufferedEventExample)();
+        // Show final metrics if buffered processing is available
+        if (eventSystem.bufferedEventBus) {
+            console.log('\n📈 Final System Metrics:');
+            const metrics = eventSystem.bufferedEventBus.getMetrics();
+            console.log('Queue Metrics:', {
+                size: metrics.queueMetrics.size,
+                utilization: `${(metrics.queueMetrics.utilization * 100).toFixed(1)}%`,
+                totalProcessed: metrics.queueMetrics.totalProcessed
+            });
+            const health = await eventSystem.bufferedEventBus.getHealthStatus();
+            console.log('Health Status:', {
+                status: health.status,
+                activeWorkers: health.activeWorkers,
+                queueDepth: health.queueDepth
+            });
+            const workerStats = eventSystem.bufferedEventBus.getWorkerStatistics();
+            console.log('Worker Statistics:', {
+                totalWorkers: workerStats.totalWorkers,
+                activeWorkers: workerStats.activeWorkers,
+                averageProcessingTime: `${workerStats.averageProcessingTime.toFixed(2)}ms`
+            });
+        }
+        // Graceful shutdown
+        console.log('\n🔄 Shutting down event system...');
+        if (eventSystem.bufferedEventBus) {
+            await eventSystem.bufferedEventBus.shutdown();
+        }
+        console.log('✅ Integration test completed successfully!\n');
+    }
+    catch (error) {
+        console.error('❌ Integration test failed:', error);
+        throw error;
+    }
+}
+/**
+ * Performance test for buffered vs regular event processing
+ */
+async function runPerformanceComparison() {
+    console.log('⚡ Performance Comparison: Regular vs Buffered Event Processing\n');
+    const eventCount = 1000;
+    const testEvents = Array.from({ length: eventCount }, (_, i) => ({
+        type: 'test.event',
+        payload: { id: i, data: `test-data-${i}` },
+        timestamp: Date.now()
+    }));
+    // Test regular event processing
+    console.log(`🔄 Testing regular event processing (${eventCount} events)...`);
+    const regularStart = Date.now();
+    const regularEventSystem = (0, bootstrap_1.bootstrapEventSystem)([], {
+        useBufferedProcessing: false
+    });
+    for (const event of testEvents) {
+        regularEventSystem.eventBus.emit(event);
+    }
+    const regularEnd = Date.now();
+    const regularTime = regularEnd - regularStart;
+    console.log(`✅ Regular processing completed in ${regularTime}ms`);
+    console.log(`📊 Regular throughput: ${(eventCount / regularTime * 1000).toFixed(0)} events/sec\n`);
+    // Test buffered event processing
+    console.log(`🔄 Testing buffered event processing (${eventCount} events)...`);
+    const bufferedStart = Date.now();
+    const bufferedEventSystem = (0, bootstrap_1.bootstrapEventSystem)([], {
+        useBufferedProcessing: true,
+        bufferedEventConfig: {
+            ...buffered_event_config_1.defaultBufferedEventConfig,
+            enabled: true,
+            workerCount: 4,
+            maxQueueSize: eventCount + 100
+        }
+    });
+    // Wait for workers to initialize
+    await new Promise(resolve => setTimeout(resolve, 500));
+    const emitPromises = testEvents.map(event => bufferedEventSystem.bufferedEventBus.emitEvent(event.type, event.payload, { priority: 'normal' }));
+    await Promise.all(emitPromises);
+    const bufferedEnd = Date.now();
+    const bufferedTime = bufferedEnd - bufferedStart;
+    console.log(`✅ Buffered processing completed in ${bufferedTime}ms`);
+    console.log(`📊 Buffered throughput: ${(eventCount / bufferedTime * 1000).toFixed(0)} events/sec`);
+    // Show comparison
+    const improvement = ((regularTime - bufferedTime) / regularTime * 100);
+    console.log(`\n📈 Performance improvement: ${improvement > 0 ? '+' : ''}${improvement.toFixed(1)}%`);
+    // Cleanup
+    await bufferedEventSystem.bufferedEventBus.shutdown();
+    console.log('\n✅ Performance comparison completed!\n');
+}
+// Export a function to run all tests
+async function runAllTests() {
+    try {
+        await runIntegrationTest();
+        await new Promise(resolve => setTimeout(resolve, 1000)); // Brief pause
+        await runPerformanceComparison();
+    }
+    catch (error) {
+        console.error('❌ Test suite failed:', error);
+        process.exit(1);
+    }
+}
+// If this file is run directly, execute all tests
+if (require.main === module) {
+    runAllTests().then(() => {
+        console.log('🎉 All tests completed successfully!');
+        process.exit(0);
+    }).catch((error) => {
+        console.error('💥 Test suite failed:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=integration-test.js.map

package/dist/examples/events/integration-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-test.js","sourceRoot":"","sources":["../../../src/examples/events/integration-test.ts"],"names":[],"mappings":";;AAOA,gDAwEC;AAKD,4DAqEC;AAGD,kCASC;AArKD,sDAA8D;AAC9D,qFAAuF;AACvF,qEAAmE;AAEnE;;GAEG;AACI,KAAK,UAAU,kBAAkB;IACtC,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IAExE,IAAI,CAAC;QACH,8DAA8D;QAC9D,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QAEzE,MAAM,WAAW,GAAG,IAAA,gCAAoB,EAAC,EAAE,EAAE;YAC3C,qBAAqB,EAAE,IAAI;YAC3B,mBAAmB,EAAE;gBACnB,GAAG,kDAA0B;gBAC7B,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,CAAC,EAAE,gCAAgC;gBAChD,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,EAAE;gBACf,UAAU,EAAE;oBACV,GAAG,kDAA0B,CAAC,UAAU;oBACxC,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,IAAI,CAAC,gCAAgC;iBACvD;aACF;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,wBAAwB,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5F,OAAO,CAAC,GAAG,CAAC,yBAAyB,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAErG,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAExD,kBAAkB;QAClB,MAAM,IAAA,gDAAuB,GAAE,CAAC;QAEhC,yDAAyD;QACzD,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAE1C,MAAM,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE;gBAC5B,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI;gBAC/B,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;gBACtE,cAAc,EAAE,OAAO,CAAC,YAAY,CAAC,cAAc;aACpD,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE;gBAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE;gBAChC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,qBAAqB,EAAE,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;aAC3E,CAAC,CAAC;QACL,CAAC;QAED,oBAAoB;QACpB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,WAAW,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAChD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAE9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,wBAAwB;IAC5C,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAEhF,MAAM,UAAU,GAAG,IAAI,CAAC;IACxB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE;QAC1C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC,CAAC;IAEJ,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,wCAAwC,UAAU,aAAa,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEhC,MAAM,kBAAkB,GAAG,IAAA,gCAAoB,EAAC,EAAE,EAAE;QAClD,qBAAqB,EAAE,KAAK;KAC7B,CAAC,CAAC;IAEH,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,qCAAqC,WAAW,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAEnG,iCAAiC;IACjC,OAAO,CAAC,GAAG,CAAC,yCAAyC,UAAU,aAAa,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEjC,MAAM,mBAAmB,GAAG,IAAA,gCAAoB,EAAC,EAAE,EAAE;QACnD,qBAAqB,EAAE,IAAI;QAC3B,mBAAmB,EAAE;YACnB,GAAG,kDAA0B;YAC7B,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,UAAU,GAAG,GAAG;SAC/B;KACF,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEvD,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAC1C,mBAAmB,CAAC,gBAAiB,CAAC,SAAS,CAC7C,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,OAAO,EACb,EAAE,QAAQ,EAAE,QAAQ,EAAE,CACvB,CACF,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;IAEjD,OAAO,CAAC,GAAG,CAAC,sCAAsC,YAAY,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEnG,kBAAkB;IAClB,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAErG,UAAU;IACV,MAAM,mBAAmB,CAAC,gBAAiB,CAAC,QAAQ,EAAE,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAED,qCAAqC;AAC9B,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc;QACvE,MAAM,wBAAwB,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACtB,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/examples/global-middleware-example.d.ts

@@ -0,0 +1,2 @@
+export declare function startAppWithGlobalMiddlewares(): Promise<void>;
+//# sourceMappingURL=global-middleware-example.d.ts.map

package/dist/examples/global-middleware-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-middleware-example.d.ts","sourceRoot":"","sources":["../../src/examples/global-middleware-example.ts"],"names":[],"mappings":"AA8DA,wBAAsB,6BAA6B,kBAkBlD"}

package/dist/examples/global-middleware-example.js

@@ -0,0 +1,94 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAppWithGlobalMiddlewares = startAppWithGlobalMiddlewares;
+const index_1 = require("../index");
+const decorators_1 = require("../core/decorators");
+// Example middleware implementations
+const authMiddleware = async (request, reply) => {
+    console.log('🔐 Auth middleware executed');
+    request.user = { id: 1, username: 'testuser' };
+};
+const rateLimitMiddleware = async (request, reply) => {
+    console.log('⏱️  Rate limit middleware executed');
+    // Add rate limiting logic here
+    // For example: check request count per IP, implement sliding window, etc.
+    // Example: Simple rate limiting check
+    const clientIP = request.ip;
+    console.log(`Rate limiting check for IP: ${clientIP}`);
+};
+const loggingMiddleware = async (request, reply) => {
+    console.log('📝 Custom logging middleware executed');
+    // Add custom logging logic here
+    // For example: log request details, performance metrics, etc.
+    console.log(`${request.method} ${request.url} - User-Agent: ${request.headers['user-agent']}`);
+};
+const corsMiddleware = async (request, reply) => {
+    console.log('🌐 CORS middleware executed');
+    // Add CORS headers
+    reply.header('Access-Control-Allow-Origin', '*');
+    reply.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
+    reply.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+};
+let UserController = class UserController {
+    getUsers() {
+        return {
+            message: 'Users retrieved successfully',
+            users: [
+                { id: 1, name: 'John Doe' },
+                { id: 2, name: 'Jane Smith' }
+            ]
+        };
+    }
+    getUserById() {
+        return {
+            message: 'User retrieved successfully',
+            user: { id: 1, name: 'John Doe' }
+        };
+    }
+};
+__decorate([
+    (0, decorators_1.Get)('/'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], UserController.prototype, "getUsers", null);
+__decorate([
+    (0, decorators_1.Get)('/:id'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], UserController.prototype, "getUserById", null);
+UserController = __decorate([
+    (0, decorators_1.Controller)('/api/users')
+], UserController);
+// Example usage of globalMiddlewares
+async function startAppWithGlobalMiddlewares() {
+    const app = await (0, index_1.createBootifyApp)({
+        controllers: [UserController],
+        port: 3000,
+        enableSwagger: true,
+        // Global middlewares execute in the order they are defined
+        globalMiddlewares: [
+            corsMiddleware, // Executes first - handles CORS
+            authMiddleware, // Executes second - handles authentication
+            rateLimitMiddleware, // Executes third - handles rate limiting
+            loggingMiddleware // Executes fourth - handles custom logging
+        ]
+    });
+    await app.start();
+    console.log('🚀 Server started with global middlewares!');
+    console.log('📖 API Documentation: http://localhost:3000/api-docs');
+    console.log('🔗 Test endpoint: http://localhost:3000/api/users');
+}
+// Uncomment to run this example
+// startAppWithGlobalMiddlewares().catch(console.error)
+//# sourceMappingURL=global-middleware-example.js.map

package/dist/examples/global-middleware-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-middleware-example.js","sourceRoot":"","sources":["../../src/examples/global-middleware-example.ts"],"names":[],"mappings":"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"}

package/dist/examples/index.d.ts

@@ -1,2 +1,3 @@
 import 'reflect-metadata';
+import '../cache/stores/redis-cache.store';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAA;AAazB,OAAO,mCAAmC,CAAA"}

package/dist/examples/index.js

@@ -3,44 +3,103 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-require("reflect-metadata");
 const dotenv_1 = __importDefault(require("dotenv"));
-dotenv_1.default.config();
+require("reflect-metadata");
 const api_1 = require("../api");
+const di_container_1 = require("../core/di-container");
+const bootstrap_1 = require("../events/bootstrap");
 const health_controller_1 = require("./controllers/health.controller");
 const todo_controller_1 = require("./controllers/todo.controller");
-const component_registry_1 = require("../core/component-registry");
-const bootstrap_1 = require("../events/bootstrap");
-const di_container_1 = require("../core/di-container");
-const todo_service_1 = require("./services/todo.service");
+dotenv_1.default.config();
+// import { bootstrapCache } from '../cache/bootstrap'
 const zod_1 = __importDefault(require("zod"));
-const AppConfig_1 = require("../config/AppConfig");
-// import { createBootifyApp } from './api'
-// import { HealthController } from './examples/controllers/health.controller'
-// import { TodoController } from './examples/controllers/todo.controller'
+const basic_usage_1 = require("../auth/examples/basic-usage");
+const cache_1 = require("../cache");
+// Import the RedisCacheStore to trigger @Service decorator registration
+require("../cache/stores/redis-cache.store");
 // --- Application Startup ---
+const envSchema = zod_1.default.object({
+    NODE_ENV: zod_1.default.string().min(1),
+    JWT_SECRET: zod_1.default.string().min(1),
+});
+// Global middleware implementations
+const corsMiddleware = async (request, reply) => {
+    console.log('🌐 CORS middleware executed');
+    reply.header('Access-Control-Allow-Origin', '*');
+    reply.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
+    reply.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+};
+const requestTimingMiddleware = async (request, reply) => {
+    const startTime = Date.now();
+    console.log(`⏱️  Request started: ${request.method} ${request.url}`);
+    request.startTime = startTime;
+    request.logTiming = () => {
+        const duration = Date.now() - startTime;
+        console.log(`⏱️  Request completed in ${duration}ms: ${request.method} ${request.url}`);
+    };
+};
+const securityHeadersMiddleware = async (request, reply) => {
+    console.log('🔒 Security headers middleware executed');
+    reply.header('X-Content-Type-Options', 'nosniff');
+    reply.header('X-Frame-Options', 'DENY');
+    reply.header('X-XSS-Protection', '1; mode=block');
+    reply.header('Strict-Transport-Security', 'max-age=31536000; includeSubDomains');
+};
+const requestLoggingMiddleware = async (request, reply) => {
+    const clientIP = request.ip;
+    const userAgent = request.headers['user-agent'] || 'Unknown';
+    console.log(`📝 Request: ${request.method} ${request.url} from ${clientIP} - ${userAgent}`);
+};
 async function main() {
     //   await intitializeLogging()
-    AppConfig_1.AppConfig.initialize(zod_1.default.object({
-        NODE_ENV: zod_1.default.string().min(1),
-    }));
-    const allComponents = Array.from(component_registry_1.registeredComponents);
-    await (0, bootstrap_1.bootstrapEventSystem)(allComponents);
-    // await bootstrapCache()
-    const { start } = await (0, api_1.createBootifyApp)({
+    const { middleware: jwtAuthMiddleware, authManager } = await (0, basic_usage_1.setupJwtAuth)();
+    // Register authManager in DI container for controller injection
+    di_container_1.container.register('AuthManager', { useFactory: () => authManager });
+    const allComponents = Array.from(di_container_1.container.getRegisteredComponents());
+    await (0, bootstrap_1.bootstrapEventSystem)(allComponents, { useBufferedProcessing: true });
+    await (0, cache_1.bootstrapCache)();
+    const { app, start } = await (0, api_1.createBootifyApp)({
         controllers: [health_controller_1.HealthController, todo_controller_1.TodoController],
         enableSwagger: true,
-        port: 3000,
-        configSchema: zod_1.default.object({
-            NODE_ENV: zod_1.default.string().min(1),
-        }),
+        port: 8080,
+        configSchema: envSchema,
+        globalMiddlewares: [
+            // jwtAuthMiddleware.authenticate({
+            //   strategies: ['jwt', 'api-key'],
+            //   skipPaths: ['/auth/login', '/auth/refresh', '/health']
+            // }),
+            corsMiddleware, // 1st: Handle CORS headers
+            securityHeadersMiddleware, // 2nd: Add security headers
+            requestTimingMiddleware, // 3rd: Start request timing
+            requestLoggingMiddleware // 4th: Log request details
+        ]
     });
-    console.log('All components:', di_container_1.container.getRegisteredComponents());
-    const animal = di_container_1.container.resolve('Animal');
-    //   console.log(animal)
-    const animalservice = di_container_1.container.resolve(todo_service_1.AnimalService);
-    console.log(animalservice.animal === animalservice.animal1);
-    console.log(animalservice.animal.name);
+    await (0, basic_usage_1.registerJWTAuthRoutes)(app, authManager, jwtAuthMiddleware);
+    // Setup context middleware with authentication
+    // app.addHook('onRequest', createContextMiddleware(authContextExtractor));
+    // console.log('All components:', container.getRegisteredComponents())
+    // const animal = container.resolve<Animal>('Animal')
+    // //   console.log(animal)
+    // const animalservice: AnimalService = container.resolve<AnimalService>(AnimalService)
+    // console.log(animalservice.animal === animalservice.animal1)
+    // console.log(animalservice.animal.name)
+    // console.log('🚀 BootifyJS Example Server starting...');
+    // console.log('🔧 Global middlewares enabled: CORS, Security Headers, Request Timing, Request Logging');
+    // console.log('📊 Available endpoints:');
+    // console.log('  GET /todos - List all todos (requires authentication)');
+    // console.log('  POST /todos - Create a new todo (requires authentication)');
+    // console.log('  GET /todos/:id - Get a specific todo (requires authentication)');
+    // console.log('  PUT /todos/:id - Update a todo (requires authentication)');
+    // console.log('  DELETE /todos/:id - Delete a todo (requires authentication)');
+    // console.log('  GET /animals - List all animals');
+    // console.log('  POST /animals - Create a new animal');
+    // console.log('🔐 Authentication endpoints:');
+    // console.log('  POST /auth/login - Login to get JWT token');
+    // console.log('  GET /auth/info - Check authentication status');
+    // console.log('💡 Use @UseMiddleware(authenticate()) decorator for protected routes!');
+    // console.log('🔑 Test credentials: admin/admin123, manager/manager123, user/user123');
+    // console.log('🌐 CORS enabled for all origins');
+    // console.log('🔒 Security headers automatically added to all responses');
     await start();
 }
 main();

package/dist/examples/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":";;;;;AAAA,4BAAyB;AACzB,oDAA2B;AAC3B,gBAAM,CAAC,MAAM,EAAE,CAAA;AACf,gCAAyC;AACzC,uEAAkE;AAClE,mEAA8D;AAC9D,mEAAiE;AACjE,mDAA0D;AAC1D,uDAAgD;AAChD,0DAA+D;AAG/D,8CAAmB;AACnB,mDAA+C;AAC/C,2CAA2C;AAC3C,8EAA8E;AAC9E,0EAA0E;AAE1E,8BAA8B;AAE9B,KAAK,UAAU,IAAI;IACjB,+BAA+B;IAC/B,qBAAS,CAAC,UAAU,CAClB,aAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5B,CAAC,CACH,CAAA;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,yCAAoB,CAAC,CAAA;IACtD,MAAM,IAAA,gCAAoB,EAAC,aAAa,CAAC,CAAA;IACzC,yBAAyB;IACzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,sBAAgB,EAAC;QACvC,WAAW,EAAE,CAAC,oCAAgB,EAAE,gCAAc,CAAC;QAC/C,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,aAAC,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC5B,CAAC;KACH,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,wBAAS,CAAC,uBAAuB,EAAE,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,wBAAS,CAAC,OAAO,CAAS,QAAQ,CAAC,CAAA;IAElD,wBAAwB;IACxB,MAAM,aAAa,GAAkB,wBAAS,CAAC,OAAO,CAAgB,4BAAa,CAAC,CAAA;IACpF,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3D,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEtC,MAAM,KAAK,EAAE,CAAA;AACf,CAAC;AAED,IAAI,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"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"}