wynkjs 1.0.0

package/dist/database.js

@@ -0,0 +1,162 @@
+/**
+ * WynkJS Database Pattern - EXAMPLE ONLY
+ *
+ * ⚠️ This file is NOT exported from WynkJS core.
+ * It's just an example pattern you can COPY to your project and customize.
+ *
+ * WHY NOT INCLUDED IN CORE?
+ * - Keeps WynkJS lightweight and fast (20x faster than NestJS!)
+ * - Gives you freedom to use ANY database library (Drizzle, Prisma, TypeORM, Mongoose, etc.)
+ * - No vendor lock-in
+ * - No unnecessary dependencies
+ *
+ * RECOMMENDED APPROACH:
+ * Use initializeDatabase() and getDatabase() from database.decorators.ts
+ * They're lightweight helpers already included in WynkJS core.
+ *
+ * BUT IF YOU PREFER A CLASS PATTERN, COPY THIS TO YOUR PROJECT:
+ */
+export const DATABASE_CLASS_EXAMPLE = `
+// src/db/database.ts (COPY THIS TO YOUR PROJECT)
+
+import { Pool } from "pg";
+import { drizzle } from "drizzle-orm/node-postgres";
+import { userTable, otpTable } from '../users/tables';
+
+const schema = { userTable, otpTable };
+
+export class Database {
+  private static instance: any;
+  private static pool: Pool;
+
+  public static getInstance() {
+    if (!this.instance) {
+      this.pool = new Pool({
+        connectionString: process.env.DATABASE_URL!,
+        max: 20,
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 2000,
+        ssl: { rejectUnauthorized: false },
+      });
+
+      this.instance = drizzle(this.pool, {
+        schema,
+        logger: true,
+      });
+
+      console.log("✅ Database connected");
+    }
+    return this.instance;
+  }
+
+  public static async close() {
+    if (this.pool) {
+      await this.pool.end();
+      this.instance = null;
+      console.log("Database connection closed");
+    }
+  }
+}
+
+// Usage in your index.ts:
+// import { Database } from './db/database';
+// const db = Database.getInstance();
+
+// Usage in your services:
+// import { Database } from '../db/database';
+// const db = Database.getInstance();
+// const users = await db.select().from(userTable);
+`;
+/**
+ * Example for other database libraries
+ */
+export const PRISMA_EXAMPLE = `
+// With Prisma (COPY TO YOUR PROJECT)
+
+import { PrismaClient } from '@prisma/client';
+
+export class Database {
+  private static instance: PrismaClient;
+
+  public static getInstance() {
+    if (!this.instance) {
+      this.instance = new PrismaClient();
+      console.log("✅ Prisma connected");
+    }
+    return this.instance;
+  }
+
+  public static async close() {
+    if (this.instance) {
+      await this.instance.$disconnect();
+      console.log("Prisma disconnected");
+    }
+  }
+}
+`;
+export const TYPEORM_EXAMPLE = `
+// With TypeORM (COPY TO YOUR PROJECT)
+
+import { DataSource } from 'typeorm';
+import { User, Post } from './entities';
+
+export class Database {
+  private static instance: DataSource;
+
+  public static async getInstance() {
+    if (!this.instance) {
+      this.instance = new DataSource({
+        type: 'postgres',
+        url: process.env.DATABASE_URL,
+        entities: [User, Post],
+        synchronize: false,
+      });
+      await this.instance.initialize();
+      console.log("✅ TypeORM connected");
+    }
+    return this.instance;
+  }
+
+  public static async close() {
+    if (this.instance?.isInitialized) {
+      await this.instance.destroy();
+      console.log("TypeORM disconnected");
+    }
+  }
+}
+`;
+export const MONGOOSE_EXAMPLE = `
+// With Mongoose (COPY TO YOUR PROJECT)
+
+import mongoose from 'mongoose';
+
+export class Database {
+  public static async connect() {
+    if (mongoose.connection.readyState === 0) {
+      await mongoose.connect(process.env.MONGODB_URL!, {
+        maxPoolSize: 10,
+      });
+      console.log("✅ MongoDB connected");
+    }
+  }
+
+  public static async close() {
+    await mongoose.connection.close();
+    console.log("MongoDB disconnected");
+  }
+
+  public static getConnection() {
+    return mongoose.connection;
+  }
+}
+`;
+/**
+ * README: How to use this file
+ *
+ * 1. Copy one of the examples above to your project (e.g., src/db/database.ts)
+ * 2. Customize it to your needs (connection string, pool config, etc.)
+ * 3. Import and use it in your services
+ *
+ * That's it! WynkJS doesn't force you to use any specific pattern.
+ * We give you the freedom to choose what works best for your project.
+ */

package/dist/decorators/database.decorators.d.ts

@@ -0,0 +1,55 @@
+import "reflect-metadata";
+/**
+ * Inject a table into constructor parameter
+ *
+ * @example
+ * ```typescript
+ * @injectable()
+ * class UserService {
+ *   constructor(@InjectTable(userTable) private table: typeof userTable) {}
+ * }
+ * ```
+ */
+export declare function InjectTable(table: any): ParameterDecorator;
+/**
+ * Inject a model into constructor parameter
+ *
+ * @example
+ * ```typescript
+ * @injectable()
+ * class UserService {
+ *   constructor(@InjectModel(User) private userModel: typeof User) {}
+ * }
+ * ```
+ */
+export declare function InjectModel(model: any): ParameterDecorator;
+/**
+ * Register multiple tables at once
+ * Call this at application startup
+ *
+ * @example
+ * ```typescript
+ * registerTables({
+ *   userTable,
+ *   postTable,
+ *   commentTable,
+ * });
+ * ```
+ */
+export declare function registerTables(tables: Record<string, any>): void;
+/**
+ * Register multiple models at once
+ * Call this at application startup
+ *
+ * @example
+ * ```typescript
+ * registerModels({
+ *   User,
+ *   Post,
+ *   Comment,
+ * });
+ * ```
+ */
+export declare function registerModels(models: Record<string, any>): void;
+export { injectable, inject, singleton, container } from "tsyringe";
+//# sourceMappingURL=database.decorators.d.ts.map

package/dist/decorators/database.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/database.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAoE1B;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,kBAAkB,CAG1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,kBAAkB,CAG1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAOhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAOhE;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/decorators/database.decorators.js

@@ -0,0 +1,131 @@
+import "reflect-metadata";
+import { container, inject } from "tsyringe";
+/**
+ * WynkJS Database Decorators
+ *
+ * Simple and lightweight decorators using tsyringe DI container.
+ * Works with ANY database pattern:
+ * - Drizzle ORM
+ * - Mongoose ODM
+ * - Prisma
+ * - TypeORM
+ * - Custom Database classes
+ *
+ * Usage:
+ * ```typescript
+ * @injectable()
+ * class UserService {
+ *   constructor(@InjectTable(userTable) private table: typeof userTable) {}
+ * }
+ * ```
+ */
+const TABLE_TOKEN_PREFIX = "TABLE_";
+const MODEL_TOKEN_PREFIX = "MODEL_";
+const TABLE_REGISTRY = new Map();
+const MODEL_REGISTRY = new Map();
+/**
+ * Create or get a unique token for a table
+ */
+function getOrCreateTableToken(table) {
+    if (TABLE_REGISTRY.has(table)) {
+        return TABLE_REGISTRY.get(table);
+    }
+    // Generate a unique token
+    const token = TABLE_TOKEN_PREFIX + TABLE_REGISTRY.size;
+    TABLE_REGISTRY.set(table, token);
+    // Register the table immediately
+    if (!container.isRegistered(token)) {
+        container.register(token, { useValue: table });
+    }
+    return token;
+}
+/**
+ * Create or get a unique token for a model
+ */
+function getOrCreateModelToken(model) {
+    if (MODEL_REGISTRY.has(model)) {
+        return MODEL_REGISTRY.get(model);
+    }
+    // Generate a unique token
+    const token = MODEL_TOKEN_PREFIX + MODEL_REGISTRY.size;
+    MODEL_REGISTRY.set(model, token);
+    // Register the model immediately
+    if (!container.isRegistered(token)) {
+        container.register(token, { useValue: model });
+    }
+    return token;
+}
+/**
+ * Inject a table into constructor parameter
+ *
+ * @example
+ * ```typescript
+ * @injectable()
+ * class UserService {
+ *   constructor(@InjectTable(userTable) private table: typeof userTable) {}
+ * }
+ * ```
+ */
+export function InjectTable(table) {
+    const token = getOrCreateTableToken(table);
+    return inject(token);
+}
+/**
+ * Inject a model into constructor parameter
+ *
+ * @example
+ * ```typescript
+ * @injectable()
+ * class UserService {
+ *   constructor(@InjectModel(User) private userModel: typeof User) {}
+ * }
+ * ```
+ */
+export function InjectModel(model) {
+    const token = getOrCreateModelToken(model);
+    return inject(token);
+}
+/**
+ * Register multiple tables at once
+ * Call this at application startup
+ *
+ * @example
+ * ```typescript
+ * registerTables({
+ *   userTable,
+ *   postTable,
+ *   commentTable,
+ * });
+ * ```
+ */
+export function registerTables(tables) {
+    for (const [name, table] of Object.entries(tables)) {
+        const token = getOrCreateTableToken(table);
+        if (!container.isRegistered(token)) {
+            container.register(token, { useValue: table });
+        }
+    }
+}
+/**
+ * Register multiple models at once
+ * Call this at application startup
+ *
+ * @example
+ * ```typescript
+ * registerModels({
+ *   User,
+ *   Post,
+ *   Comment,
+ * });
+ * ```
+ */
+export function registerModels(models) {
+    for (const [name, model] of Object.entries(models)) {
+        const token = getOrCreateModelToken(model);
+        if (!container.isRegistered(token)) {
+            container.register(token, { useValue: model });
+        }
+    }
+}
+// Re-export tsyringe decorators for convenience
+export { injectable, inject, singleton, container } from "tsyringe";

package/dist/decorators/exception.advanced.d.ts

@@ -0,0 +1,160 @@
+import "reflect-metadata";
+import { WynkExceptionFilter } from "./exception.decorators";
+import { ExecutionContext } from "./guard.decorators";
+import { NotFoundException, BadRequestException, UnauthorizedException, ForbiddenException } from "./exception.decorators";
+/**
+ * Advanced Exception Filters for WynkJS Framework
+ * Specialized filters for different error scenarios
+ */
+/**
+ * Validation Exception Filter - Handles validation errors
+ * @example
+ * @UseFilters(ValidationExceptionFilter)
+ * @Post()
+ * async create(@Body() data: any) {}
+ */
+export declare class ValidationExceptionFilter implements WynkExceptionFilter<BadRequestException> {
+    catch(exception: BadRequestException, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        errors: any;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+ * Database Exception Filter - Handles database errors
+ * @example
+ * @UseFilters(DatabaseExceptionFilter)
+ * @Controller('/users')
+ * export class UserController {}
+ */
+export declare class DatabaseExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+ * Authentication Exception Filter - Handles auth errors
+ * @example
+ * @UseFilters(AuthenticationExceptionFilter)
+ * @Controller('/auth')
+ * export class AuthController {}
+ */
+export declare class AuthenticationExceptionFilter implements WynkExceptionFilter<UnauthorizedException> {
+    catch(exception: UnauthorizedException, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+        hint: string;
+    };
+}
+/**
+ * Authorization Exception Filter - Handles permission errors
+ * @example
+ * @UseFilters(AuthorizationExceptionFilter)
+ * @Controller('/admin')
+ * export class AdminController {}
+ */
+export declare class AuthorizationExceptionFilter implements WynkExceptionFilter<ForbiddenException> {
+    catch(exception: ForbiddenException, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+        requiredPermissions: any;
+    };
+}
+/**
+ * Not Found Exception Filter - Handles 404 errors
+ * @example
+ * @UseFilters(NotFoundExceptionFilter)
+ * @Get('/:id')
+ * async findOne(@Param('id') id: string) {}
+ */
+export declare class NotFoundExceptionFilter implements WynkExceptionFilter<NotFoundException> {
+    catch(exception: NotFoundException, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+        suggestion: string;
+    };
+}
+/**
+ * Rate Limit Exception Filter - Handles rate limit errors
+ * @example
+ * @UseFilters(RateLimitExceptionFilter)
+ * @Post()
+ * async create() {}
+ */
+export declare class RateLimitExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: any;
+        timestamp: string;
+        path: any;
+        retryAfter: any;
+        hint: string;
+    };
+}
+/**
+ * Business Logic Exception Filter - Handles business rule violations
+ * @example
+ * @UseFilters(BusinessLogicExceptionFilter)
+ * @Post('/transfer')
+ * async transfer(@Body() data: any) {}
+ */
+export declare class BusinessLogicExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: any;
+        error: string;
+        message: any;
+        timestamp: string;
+        path: any;
+        rule: any;
+        details: any;
+    };
+}
+/**
+ * File Upload Exception Filter - Handles file upload errors
+ * @example
+ * @UseFilters(FileUploadExceptionFilter)
+ * @Post('/upload')
+ * async upload(@UploadedFile() file: any) {}
+ */
+export declare class FileUploadExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        statusCode: number;
+        error: string;
+        message: string;
+        timestamp: string;
+        path: any;
+    };
+}
+/**
+ * Global Exception Filter - Catches all unhandled exceptions
+ * @example
+ * app.useGlobalFilters(new GlobalExceptionFilter());
+ */
+export declare class GlobalExceptionFilter implements WynkExceptionFilter {
+    catch(exception: any, context: ExecutionContext): {
+        stack?: any;
+        statusCode: any;
+        error: any;
+        message: any;
+        timestamp: string;
+        path: any;
+    };
+}
+//# sourceMappingURL=exception.advanced.d.ts.map

package/dist/decorators/exception.advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.advanced.d.ts","sourceRoot":"","sources":["../../core/decorators/exception.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AAEH;;;;;;GAMG;AACH,qBAAa,yBACX,YAAW,mBAAmB,CAAC,mBAAmB,CAAC;IAEnD,KAAK,CAAC,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CAahE;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;CAiChD;AAED;;;;;;GAMG;AACH,qBAAa,6BACX,YAAW,mBAAmB,CAAC,qBAAqB,CAAC;IAErD,KAAK,CAAC,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CAalE;AAED;;;;;;GAMG;AACH,qBAAa,4BACX,YAAW,mBAAmB,CAAC,kBAAkB,CAAC;IAElD,KAAK,CAAC,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CAe/D;AAED;;;;;;GAMG;AACH,qBAAa,uBACX,YAAW,mBAAmB,CAAC,iBAAiB,CAAC;IAEjD,KAAK,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CAa9D;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;CAchD;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,YAAW,mBAAmB;IACtE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;CAchD;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IACnE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;CAsBhD;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;CA2BhD"}