bootifyjs 0.1.1 → 1.1.0

package/README.md

@@ -1,423 +0,0 @@
-# BootifyJS
-
-A Spring Boot inspired Node.js framework with TypeScript, Dependency Injection, and Validation.
-
-## Features
-
-- **Dependency Injection**: Automatic constructor injection with `@Injectable`, `@Service`, and `@Repository` decorators
-- **REST API**: Easy controller definition with `@Controller`, `@Get`, `@Post`, etc.
-- **Validation**: Request validation with Zod schemas
-- **Configuration**: Environment-based configuration with automatic mapping
-- **OpenAPI**: Automatic OpenAPI documentation generation
-- **Logging**: Comprehensive logging system with context tracking
-- **Event System**: Type-safe event system with middleware support
-
-## Installation
-
-```bash
-npm install bootifyjs
-```
-
-## Quick Start
-
-```typescript
-import { createBootifyApp, Controller, Get, Service } from 'bootifyjs';
-
-@Service()
-class GreetingService {
-  getGreeting(name: string) {
-    return `Hello, ${name}!`;
-  }
-}
-
-@Controller('/api')
-class GreetingController {
-  constructor(private greetingService: GreetingService) {}
-  
-  @Get('/hello')
-  sayHello() {
-    return { message: this.greetingService.getGreeting('World') };
-  }
-}
-
-async function main() {
-  const { start } = await createBootifyApp({
-    port: 3000,
-    controllers: [GreetingController],
-    enableSwagger: true
-  });
-  
-  await start();
-  console.log('Server running at http://localhost:3000');
-}
-
-main().catch(console.error);
-```
-
-## Core Concepts
-
-### Controllers
-
-Controllers handle HTTP requests and define your API endpoints.
-
-```typescript
-import { Controller, Get, Post, Put, Delete, Param, Body, Query } from 'bootifyjs';
-
-@Controller('/users')
-export class UserController {
-  constructor(private userService: UserService) {}
-  
-  @Get('/')
-  getAllUsers(@Query('limit') limit?: string) {
-    return this.userService.getAllUsers(limit ? parseInt(limit) : undefined);
-  }
-  
-  @Get('/:id')
-  getUserById(@Param('id') id: string) {
-    return this.userService.getUserById(id);
-  }
-  
-  @Post('/')
-  createUser(@Body() userData: CreateUserDto) {
-    return this.userService.createUser(userData);
-  }
-  
-  @Put('/:id')
-  updateUser(@Param('id') id: string, @Body() userData: UpdateUserDto) {
-    return this.userService.updateUser(id, userData);
-  }
-  
-  @Delete('/:id')
-  deleteUser(@Param('id') id: string) {
-    return this.userService.deleteUser(id);
-  }
-}
-```
-
-### Services
-
-Services contain your business logic and can be injected into controllers or other services.
-
-```typescript
-import { Service } from 'bootifyjs';
-
-@Service()
-export class UserService {
-  constructor(private userRepository: UserRepository) {}
-  
-  getAllUsers(limit?: number) {
-    return this.userRepository.findAll(limit);
-  }
-  
-  getUserById(id: string) {
-    return this.userRepository.findById(id);
-  }
-  
-  // More methods...
-}
-```
-
-### Repositories
-
-Repositories handle data access and can be injected into services.
-
-```typescript
-import { Repository } from 'bootifyjs';
-
-@Repository()
-export class UserRepository {
-  private users = []; // In a real app, this would be a database connection
-  
-  findAll(limit?: number) {
-    if (limit) {
-      return this.users.slice(0, limit);
-    }
-    return this.users;
-  }
-  
-  findById(id: string) {
-    return this.users.find(user => user.id === id);
-  }
-  
-  // More methods...
-}
-```
-
-### Validation
-
-Use Zod schemas to validate request data.
-
-```typescript
-import { z } from 'zod';
-import { Controller, Post, Body, ValidateBody } from 'bootifyjs';
-
-const createUserSchema = z.object({
-  email: z.string().email(),
-  name: z.string().min(2).max(100),
-  age: z.number().min(18).optional()
-});
-
-@Controller('/users')
-export class UserController {
-  @Post('/')
-  @ValidateBody(createUserSchema)
-  createUser(@Body() userData: z.infer<typeof createUserSchema>) {
-    // userData is now validated and typed
-    return this.userService.createUser(userData);
-  }
-}
-```
-
-### Configuration
-
-Define your configuration structure and automatically map environment variables.
-
-```typescript
-import { Config, getConfigInstance } from 'bootifyjs';
-
-@Config('APP')
-export class AppConfig {
-  SERVICE_NAME: string = 'my-service';
-  
-  server: {
-    port: number;
-    host: string;
-  } = {
-    port: 3000,
-    host: 'localhost'
-  };
-  
-  database: {
-    url: string;
-    poolSize: number;
-  } = {
-    url: 'postgres://localhost:5432/mydb',
-    poolSize: 10
-  };
-}
-
-// Environment variables like APP_SERVER_PORT=8080 will be automatically mapped
-const config = getConfigInstance(AppConfig);
-console.log(config.server.port); // 8080
-```
-
-### Event System
-
-Create a type-safe event system for decoupled communication.
-
-```typescript
-import { Event, EventEmitter, EventListener, EventHandler } from 'bootifyjs';
-
-// Define an event
-@Event('user.created')
-class UserCreatedEvent {
-  id: string;
-  email: string;
-  timestamp: Date = new Date();
-}
-
-// Emit events from services
-@Service()
-@EventEmitter()
-class UserService {
-  private eventBus; // Injected by @EventEmitter
-  
-  async createUser(userData) {
-    const user = await this.userRepository.create(userData);
-    
-    // Emit event
-    await this.eventBus.emit('user.created', {
-      id: user.id,
-      email: user.email
-    });
-    
-    return user;
-  }
-}
-
-// Handle events
-@EventListener()
-class UserEventHandlers {
-  @EventHandler('user.created')
-  async onUserCreated(event: UserCreatedEvent) {
-    console.log(`User created: ${event.email}`);
-    // Send welcome email, update analytics, etc.
-  }
-}
-```
-
-### Logging
-
-Comprehensive logging system with context tracking.
-
-```typescript
-import { Logger, Log } from 'bootifyjs';
-
-@Service()
-@Logger('UserService')
-export class UserService {
-  private logger; // Injected by @Logger
-  
-  @Log({ logArgs: true, logDuration: true })
-  async createUser(userData) {
-    this.logger.info('Creating new user', { email: userData.email });
-    
-    // Business logic...
-    
-    this.logger.info('User created successfully');
-    return user;
-  }
-}
-```
-
-## Bootstrapping Your Application
-
-There are two ways to bootstrap your application:
-
-### 1. Using createBootifyApp (Recommended)
-
-```typescript
-import { createBootifyApp } from 'bootifyjs';
-import { UserController } from './controllers/user.controller';
-
-async function main() {
-  const { app, start, stop } = await createBootifyApp({
-    port: 3000,
-    controllers: [UserController],
-    enableSwagger: true,
-    enableCors: true
-  });
-  
-  await start();
-  console.log('Server running at http://localhost:3000');
-  console.log('API docs available at http://localhost:3000/api-docs');
-}
-
-main().catch(console.error);
-```
-
-### 2. Manual Bootstrap
-
-```typescript
-import { 
-  Application, 
-  configureLogging, 
-  configureEventSystem,
-  corsMiddleware,
-  contextMiddleware,
-  createRequestLoggingMiddleware,
-  swaggerMiddleware,
-  OpenAPIGenerator
-} from 'bootifyjs';
-import { UserController } from './controllers/user.controller';
-
-async function bootstrap() {
-  // Initialize logging
-  const { logger, startupLogger } = configureLogging();
-  
-  // Initialize event system
-  const eventBus = configureEventSystem();
-  
-  // Generate OpenAPI documentation
-  const openApiGenerator = new OpenAPIGenerator({
-    title: 'My API',
-    version: '1.0.0',
-    description: 'My API description'
-  });
-  
-  const controllers = [UserController];
-  openApiGenerator.addControllers(controllers);
-  const openApiSpec = openApiGenerator.getSpec();
-  
-  // Create application
-  const app = new Application({
-    controllers,
-    middlewares: [
-      contextMiddleware,
-      corsMiddleware,
-      createRequestLoggingMiddleware(),
-      swaggerMiddleware(openApiSpec)
-    ],
-    port: 3000,
-    hostname: 'localhost'
-  });
-  
-  await app.start();
-  logger.info('Server started');
-}
-
-bootstrap().catch(console.error);
-```
-
-## Middleware
-
-Create custom middleware to handle cross-cutting concerns.
-
-```typescript
-import { Middleware } from 'bootifyjs';
-
-export const loggingMiddleware: Middleware = async (req, res, next) => {
-  const start = Date.now();
-  console.log(`${req.method} ${req.url} - Request started`);
-  
-  await next();
-  
-  const duration = Date.now() - start;
-  console.log(`${req.method} ${req.url} - Request completed in ${duration}ms`);
-};
-```
-
-## OpenAPI Documentation
-
-BootifyJS automatically generates OpenAPI documentation for your API.
-
-```typescript
-import { Controller, Get, ApiTags, ApiOperation, ApiResponse } from 'bootifyjs';
-
-@Controller('/health')
-@ApiTags('Health')
-export class HealthController {
-  @Get('/')
-  @ApiOperation({
-    summary: 'Health check',
-    description: 'Check if the API is running'
-  })
-  @ApiResponse(200, {
-    description: 'API is healthy',
-    schema: healthResponseSchema
-  })
-  health() {
-    return { status: 'OK', timestamp: new Date().toISOString() };
-  }
-}
-```
-
-## Error Handling
-
-BootifyJS provides built-in error classes for common HTTP errors.
-
-```typescript
-import { NotFoundError, ValidationError } from 'bootifyjs';
-
-@Service()
-export class UserService {
-  getUserById(id: string) {
-    const user = this.userRepository.findById(id);
-    if (!user) {
-      throw new NotFoundError(`User with id ${id} not found`);
-    }
-    return user;
-  }
-  
-  createUser(userData) {
-    if (!userData.email) {
-      throw new ValidationError('Email is required');
-    }
-    // ...
-  }
-}
-```
-
-## License
-
-MIT

package/dist/config/app.config.d.ts

@@ -1,29 +0,0 @@
-export declare class AppConfig {
-    SERVICE_NAME: string;
-    server: {
-        port: number;
-        host: string;
-        name?: string;
-    };
-    database: {
-        host: string;
-        port: number;
-        name: string;
-        username: string;
-        password: string;
-    };
-    logging: {
-        level: string;
-        enabled: boolean;
-    };
-    api: {
-        version: string;
-    };
-    cors: {
-        enabled: boolean;
-    };
-    jwt: {
-        secret: string;
-        expiresIn: number;
-    };
-}

package/dist/config/app.config.js

@@ -1,55 +0,0 @@
-"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.AppConfig = void 0;
-const config_1 = require("../core/config");
-let AppConfig = class AppConfig {
-    constructor() {
-        // Service configuration
-        this.SERVICE_NAME = 'bootifyjs-app';
-        // Server configuration - will be populated from BOOTIFY_SERVER_* env vars
-        this.server = {
-            port: 3000,
-            host: 'localhost'
-        };
-        // Database configuration - will be populated from BOOTIFY_DATABASE_* env vars
-        this.database = {
-            host: 'localhost',
-            port: 5432,
-            name: 'bootifyjs',
-            username: 'admin',
-            password: 'password'
-        };
-        // Logging configuration - will be populated from BOOTIFY_LOGGING_* env vars
-        this.logging = {
-            level: 'info',
-            enabled: true
-        };
-        // Any other configuration can be added here
-        // The @Config decorator will automatically map environment variables
-        // based on the property structure
-        // API Configuration - will be populated from BOOTIFY_API_* env vars
-        this.api = {
-            version: 'v1'
-        };
-        // CORS Configuration - will be populated from BOOTIFY_CORS_* env vars
-        this.cors = {
-            enabled: true
-        };
-        // JWT Configuration - will be populated from BOOTIFY_JWT_* env vars
-        this.jwt = {
-            secret: 'default-secret',
-            expiresIn: 3600
-        };
-    }
-};
-exports.AppConfig = AppConfig;
-exports.AppConfig = AppConfig = __decorate([
-    (0, config_1.Config)('BOOTIFY')
-], AppConfig);
-//# sourceMappingURL=app.config.js.map

package/dist/config/app.config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"app.config.js","sourceRoot":"","sources":["../../src/config/app.config.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAGjC,IAAM,SAAS,GAAf,MAAM,SAAS;IAAf;QACL,wBAAwB;QACxB,iBAAY,GAAW,eAAe,CAAC;QAEvC,0EAA0E;QAC1E,WAAM,GAIF;YACF,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,WAAW;SAClB,CAAC;QAEF,8EAA8E;QAC9E,aAAQ,GAMJ;YACF,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,UAAU;SACrB,CAAC;QAEF,4EAA4E;QAC5E,YAAO,GAGH;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,4CAA4C;QAC5C,qEAAqE;QACrE,kCAAkC;QAElC,oEAAoE;QACpE,QAAG,GAEC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,sEAAsE;QACtE,SAAI,GAEA;YACF,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,oEAAoE;QACpE,QAAG,GAGC;YACF,MAAM,EAAE,gBAAgB;YACxB,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;CAAA,CAAA;AAhEY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,SAAS,CAAC;GACL,SAAS,CAgErB"}

package/dist/controllers/config.controller.d.ts

@@ -1,16 +0,0 @@
-import { AppConfig } from '../config/app.config';
-import { ConfigDemoService } from '../services/config-demo.service';
-export declare class ConfigController {
-    private config;
-    private configDemoService;
-    constructor(config: AppConfig, configDemoService: ConfigDemoService);
-    getConfigInfo(): AppConfig;
-    getServerUrl(): {
-        url: string;
-        message: string;
-    };
-    runConfigDemo(): {
-        message: string;
-        timestamp: string;
-    };
-}

package/dist/controllers/config.controller.js

@@ -1,66 +0,0 @@
-"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.ConfigController = void 0;
-const decorators_1 = require("../core/decorators");
-const app_config_1 = require("../config/app.config");
-const config_demo_service_1 = require("../services/config-demo.service");
-let ConfigController = class ConfigController {
-    constructor(config, configDemoService) {
-        this.config = config;
-        this.configDemoService = configDemoService;
-    }
-    getConfigInfo() {
-        return this.config;
-    }
-    getServerUrl() {
-        return {
-            url: this.configDemoService.getServerUrl(),
-            message: 'Current server URL based on configuration'
-        };
-    }
-    runConfigDemo() {
-        this.configDemoService.demonstrateConfig();
-        return {
-            message: 'Configuration demo completed. Check the logs for details.',
-            timestamp: new Date().toISOString()
-        };
-    }
-};
-exports.ConfigController = ConfigController;
-__decorate([
-    (0, decorators_1.Get)('/info'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", void 0)
-], ConfigController.prototype, "getConfigInfo", null);
-__decorate([
-    (0, decorators_1.Get)('/server-url'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", void 0)
-], ConfigController.prototype, "getServerUrl", null);
-__decorate([
-    (0, decorators_1.Get)('/demo'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", void 0)
-], ConfigController.prototype, "runConfigDemo", null);
-exports.ConfigController = ConfigController = __decorate([
-    (0, decorators_1.Controller)('/config'),
-    __param(0, (0, decorators_1.InjectConfig)(app_config_1.AppConfig)),
-    __metadata("design:paramtypes", [app_config_1.AppConfig,
-        config_demo_service_1.ConfigDemoService])
-], ConfigController);
-//# sourceMappingURL=config.controller.js.map

package/dist/controllers/config.controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.controller.js","sourceRoot":"","sources":["../../src/controllers/config.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,mDAAmE;AACnE,qDAAiD;AACjD,yEAAoE;AAG7D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YACmC,MAAiB,EAC1C,iBAAoC;QADX,WAAM,GAAN,MAAM,CAAW;QAC1C,sBAAiB,GAAjB,iBAAiB,CAAmB;IAC3C,CAAC;IAGJ,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAGD,YAAY;QACV,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE;YAC1C,OAAO,EAAE,2CAA2C;SACrD,CAAC;IACJ,CAAC;IAGD,aAAa;QACX,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,2DAA2D;YACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;CACF,CAAA;AA3BY,4CAAgB;AAO3B;IADC,IAAA,gBAAG,EAAC,OAAO,CAAC;;;;qDAGZ;AAGD;IADC,IAAA,gBAAG,EAAC,aAAa,CAAC;;;;oDAMlB;AAGD;IADC,IAAA,gBAAG,EAAC,OAAO,CAAC;;;;qDAOZ;2BA1BU,gBAAgB;IAD5B,IAAA,uBAAU,EAAC,SAAS,CAAC;IAGjB,WAAA,IAAA,yBAAY,EAAC,sBAAS,CAAC,CAAA;qCAAiB,sBAAS;QACvB,uCAAiB;GAHnC,gBAAgB,CA2B5B"}

package/dist/controllers/events.controller.d.ts

@@ -1,66 +0,0 @@
-import { BaseEvent } from '../events/types/event.types';
-export declare class EventsController {
-    private eventBus;
-    private registry;
-    private eventStore;
-    constructor();
-    getEventMetrics(): {
-        busMetrics: import("../events").EventMetrics;
-        registryStats: {
-            totalEventTypes: number;
-            totalSubscriptions: number;
-            subscriptionsByType: Record<string, number>;
-            activeSubscriptions: number;
-        };
-        storeStats: {
-            totalEvents: number;
-            eventsByType: Record<string, number>;
-            aggregateCount: number;
-            oldestEvent?: Date;
-            newestEvent?: Date;
-        };
-    };
-    getEventTypes(): {
-        registeredTypes: string[];
-        totalTypes: number;
-    };
-    getSubscriptions(): Record<string, any[]>;
-    getEventSystemHealth(): {
-        healthy: boolean;
-        metrics: import("../events").EventMetrics;
-        timestamp: string;
-    };
-    emitEvent(eventData: {
-        type: string;
-        data: any;
-    }): Promise<{
-        success: boolean;
-        message: string;
-        timestamp: string;
-    }>;
-    getEventHistory(eventType?: string, limit?: string): Promise<{
-        events: BaseEvent[];
-        total: number;
-        filtered: boolean;
-    }>;
-    getEventStats(): {
-        system: {
-            healthy: boolean;
-            uptime: number;
-        };
-        registry: {
-            totalEventTypes: number;
-            totalSubscriptions: number;
-            subscriptionsByType: Record<string, number>;
-            activeSubscriptions: number;
-        };
-        bus: import("../events").EventMetrics;
-        store: {
-            totalEvents: number;
-            eventsByType: Record<string, number>;
-            aggregateCount: number;
-            oldestEvent?: Date;
-            newestEvent?: Date;
-        };
-    };
-}