@mini2/core 1.1.0 → 1.1.2

package/Readme.MD

@@ -756,15 +756,84 @@ const result = sum(5, 3); // 8
 
 ### 📖 Swagger Integration
 
-Automatic API documentation is generated based on your decorators and DTOs.
+@mini2/core automatically generates comprehensive API documentation using Swagger/OpenAPI 3.0 specification based on your decorators and DTOs.
+
+#### **📍 API Documentation Endpoints**
+
+When your application starts, Swagger documentation is automatically available at:
+
+```typescript
+// Interactive Swagger UI - Test your API directly in browser
+http://localhost:3000/api-docs
+
+// Raw OpenAPI JSON specification - For tools, imports, etc.
+http://localhost:3000/api-docs.json
+```
+
+#### **🔧 Automatic Documentation Features**
+
+- **Route Discovery**: All `@controller` and HTTP method decorators are automatically documented
+- **Request/Response Schemas**: DTO classes with `class-validator` decorators generate JSON schemas
+- **Security Requirements**: `@authenticated` and `@authorized` decorators add security info
+- **Parameter Documentation**: Path parameters, query parameters, and request bodies are documented
+- **HTTP Status Codes**: Response codes from `ResponseBuilder` and exceptions are included
+
+#### **📋 Example Generated Documentation**
+
+For this controller:
+
+```typescript
+@controller('/api/users')
+export class UserController {
+	@get('/:id')
+	@authenticated()
+	@authorized(['user:read'])
+	@validate({ params: UserParamsDto })
+	async getUser(@req() req: Request) {
+		const id = req.params.id;
+		const user = await this.userService.findById(id);
+		return new ResponseBuilder().ok(user);
+	}
+
+	@post('/')
+	@validate({ body: CreateUserDto })
+	async createUser(@req() req: Request) {
+		const userData = req.body;
+		const user = await this.userService.create(userData);
+		return new ResponseBuilder().created(user);
+	}
+}
+```
+
+Swagger will automatically generate:
+
+- **GET /api/users/{id}** - Requires authentication and authorization
+- **POST /api/users** - With CreateUserDto schema for request body
+- Parameter definitions, security requirements, and response schemas
+
+#### **🎯 DTO-Based Schema Generation**
+
+Class-validator decorators automatically create OpenAPI schemas:
 
 ```typescript
-// Swagger documentation available at:
-// http://localhost:3000/api-docs      - Swagger UI
-// http://localhost:3000/api-docs.json - OpenAPI JSON spec
+export class CreateUserDto {
+	@IsEmail()
+	email: string;
+
+	@IsString()
+	@MinLength(2)
+	name: string;
+
+	@IsOptional()
+	@IsNumber()
+	@Min(0)
+	age?: number;
+}
 ```
 
-**Swagger Configuration:**
+#### **⚙️ Swagger Configuration**
+
+Default configuration is applied automatically, but you can customize it:
 
 ```typescript
 const swaggerOptions = {
@@ -772,11 +841,63 @@ const swaggerOptions = {
 	description: `API documentation for ${config.applicationName}`,
 	version: '1.0.0',
 	servers: [{ url: `http://${config.host}:${config.port}` }],
-	docsPath: '/api-docs',
-	jsonPath: '/api-docs.json',
+	docsPath: '/api-docs', // Swagger UI endpoint
+	jsonPath: '/api-docs.json', // OpenAPI JSON endpoint
+	components: {
+		securitySchemes: {
+			bearerAuth: {
+				type: 'http',
+				scheme: 'bearer',
+				bearerFormat: 'JWT',
+			},
+		},
+	},
 };
 ```
 
+#### **🔐 Security Documentation**
+
+Security decorators automatically add authentication requirements:
+
+```typescript
+@get('/profile')
+@authenticated()
+@authorized(['user:profile'])
+async getProfile(@req() req: Request) {
+  // Swagger will show:
+  // - 🔒 Authentication required
+  // - 🛡️ Requires 'user:profile' permission
+  // - 401 Unauthorized response possible
+  // - 403 Forbidden response possible
+}
+```
+
+#### **📊 Response Documentation**
+
+ResponseBuilder methods automatically document response types:
+
+```typescript
+@post('/users')
+async createUser(@req() req: Request) {
+  const user = await this.userService.create(req.body);
+
+  // Swagger documents:
+  // - 201 Created status
+  // - User object schema in response body
+  // - Location header if set
+  return new ResponseBuilder()
+    .created(user)
+    .setHeader('Location', `/users/${user.id}`);
+}
+```
+
+#### **🚀 Production Usage**
+
+- Swagger UI is automatically available in all environments
+- For production, consider disabling Swagger UI and keeping only JSON endpoint
+- OpenAPI JSON can be used with external documentation tools
+- All validation errors are automatically documented with examples
+
 ### 📝 TypeScript Support
 
 Full TypeScript support with type-safe API development:

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,SAAS,EAAe,MAAM,WAAW,CAAC;AAInD,cAAM,GAAI,YAAW,IAAI;IAIyB,OAAO,CAAC,WAAW;IAHpE,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;gBAEoC,WAAW,EAAE,GAAG,EAAE;IAKrE,IAAI,CAAC,MAAM,EAAE,OAAO;IA0BpB,SAAS;CAGf;AAED,eAAe,GAAG,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,SAAS,EAA2B,MAAM,WAAW,CAAC;AAI/D,cACM,GAAI,YAAW,IAAI;IAIyB,OAAO,CAAC,WAAW;IAHpE,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;gBAEoC,WAAW,EAAE,GAAG,EAAE;IAKrE,IAAI,CAAC,MAAM,EAAE,OAAO;IA0BpB,SAAS;CAGf;AAED,eAAe,GAAG,CAAC"}

package/dist/app.js

@@ -58,6 +58,7 @@ let App = class App {
     }
 };
 App = __decorate([
+    (0, inversify_1.injectable)(),
     __param(0, (0, inversify_1.multiInject)(types_1.MINI_TYPES.IController)),
     __metadata("design:paramtypes", [Array])
 ], App);

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sDAA2C;AAC3C,gDAAwB;AACxB,oDAA4B;AAG5B,iCAAkC;AAClC,yCAAmD;AACnD,uCAA+C;AAC/C,mCAAqC;AAErC,IAAM,GAAG,GAAT,MAAM,GAAG;IAIR,YAAyD,WAAkB;QAAlB,gBAAW,GAAX,WAAW,CAAO;QAC1E,IAAI,CAAC,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,GAAE,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,IAAI,4BAAkB,CAAC;YACjD,KAAK,EAAE,MAAM,CAAC,eAAe;YAC7B,WAAW,EAAE,yBAAyB,MAAM,CAAC,eAAe,EAAE;YAC9D,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE;gBACR;oBACC,GAAG,EAAE,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;oBAC3C,WAAW,EAAE,oBAAoB;iBACjC;aACD;YACD,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,gBAAgB;SAC1B,CAAC,CAAC;QACH,kBAAkB,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzD,kBAAkB,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAA,eAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,SAAS;QACd,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;CACD,CAAA;AAtCK,GAAG;IAIK,WAAA,IAAA,uBAAW,EAAC,kBAAU,CAAC,WAAW,CAAC,CAAA;;GAJ3C,GAAG,CAsCR;AAED,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sDAA2C;AAC3C,gDAAwB;AACxB,oDAA4B;AAG5B,iCAAkC;AAClC,yCAA+D;AAC/D,uCAA+C;AAC/C,mCAAqC;AAErC,IACM,GAAG,GADT,MACM,GAAG;IAIR,YAAyD,WAAkB;QAAlB,gBAAW,GAAX,WAAW,CAAO;QAC1E,IAAI,CAAC,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,GAAE,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,IAAI,4BAAkB,CAAC;YACjD,KAAK,EAAE,MAAM,CAAC,eAAe;YAC7B,WAAW,EAAE,yBAAyB,MAAM,CAAC,eAAe,EAAE;YAC9D,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE;gBACR;oBACC,GAAG,EAAE,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;oBAC3C,WAAW,EAAE,oBAAoB;iBACjC;aACD;YACD,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,gBAAgB;SAC1B,CAAC,CAAC;QACH,kBAAkB,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzD,kBAAkB,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAA,eAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,SAAS;QACd,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;CACD,CAAA;AAtCK,GAAG;IADR,IAAA,sBAAU,GAAE;IAKC,WAAA,IAAA,uBAAW,EAAC,kBAAU,CAAC,WAAW,CAAC,CAAA;;GAJ3C,GAAG,CAsCR;AAED,kBAAe,GAAG,CAAC"}

package/dist/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,QAAA,MAAM,SAAS,WAAkB,CAAC;AAGlC,eAAe,SAAS,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,QAAA,MAAM,SAAS,WAAkB,CAAC;AAGlC,eAAe,SAAS,CAAC"}

package/dist/container.js

@@ -5,7 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const inversify_1 = require("inversify");
 const app_1 = __importDefault(require("./app"));
+const types_1 = require("./types");
 const container = new inversify_1.Container();
-container.bind(app_1.default).toSelf();
+container.bind(types_1.MINI_TYPES.IApp).to(app_1.default).inSingletonScope();
 exports.default = container;
 //# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -1 +1 @@
-{"version":3,"file":"container.js","sourceRoot":"","sources":["../container.ts"],"names":[],"mappings":";;;;;AAAA,yCAAsC;AACtC,gDAAwB;AAExB,MAAM,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;AAClC,SAAS,CAAC,IAAI,CAAC,aAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAE7B,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../container.ts"],"names":[],"mappings":";;;;;AAAA,yCAAsC;AACtC,gDAAwB;AAExB,mCAAqC;AAErC,MAAM,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;AAClC,SAAS,CAAC,IAAI,CAAO,kBAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAEjE,kBAAe,SAAS,CAAC"}

package/dist/interfaces/repository.interface.d.ts

@@ -1,14 +1,9 @@
-export interface TimestampFields {
-    id: string;
-    createdAt: Date;
-    updatedAt: Date;
-}
 export interface IRepository<IdentifierType, ModelType> {
-    findAll(): Promise<(ModelType & TimestampFields)[]>;
-    findById(id: IdentifierType): Promise<(ModelType & TimestampFields) | null>;
-    create(item: ModelType): Promise<ModelType & TimestampFields>;
-    update(id: IdentifierType, item: Partial<ModelType>): Promise<ModelType & TimestampFields>;
+    findAll(): Promise<ModelType[]>;
+    findById(id: IdentifierType): Promise<ModelType | null>;
+    create(item: ModelType): Promise<ModelType>;
+    update(id: IdentifierType, item: Partial<ModelType>): Promise<ModelType>;
     delete(id: IdentifierType): Promise<void>;
-    findPaginated(query: Partial<ModelType>, page: number, limit: number): Promise<(ModelType & TimestampFields)[]>;
+    findPaginated(query: Partial<ModelType>, page: number, limit: number): Promise<ModelType[]>;
 }
 //# sourceMappingURL=repository.interface.d.ts.map

package/dist/interfaces/repository.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.interface.d.ts","sourceRoot":"","sources":["../../interfaces/repository.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CAChB;AAGD,MAAM,WAAW,WAAW,CAAC,cAAc,EAAE,SAAS;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IAC9D,MAAM,CACL,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GACtB,OAAO,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,aAAa,CACZ,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"repository.interface.d.ts","sourceRoot":"","sources":["../../interfaces/repository.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,WAAW,CAAC,cAAc,EAAE,SAAS;IACrD,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACzE,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,aAAa,CACZ,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACxB"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 export declare const MINI_TYPES: {
     IController: symbol;
+    IApp: symbol;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;CAEtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;CAGtB,CAAC"}

package/dist/types.js

@@ -3,5 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MINI_TYPES = void 0;
 exports.MINI_TYPES = {
     IController: Symbol.for('IController'),
+    IApp: Symbol.for('IApp'),
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;CACtC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;CACxB,CAAC"}

package/package.json

@@ -25,7 +25,7 @@
 	"license": "ISC",
 	"description": "Mini Express Framework - Lightweight and modular Express.js framework with TypeScript support",
 	"name": "@mini2/core",
-	"version": "1.1.0",
+	"version": "1.1.2",
 	"author": "Mustafa Çolakoglu <mustafacolakoglu94@gmail.com> (https://github.com/mustafa-colakoglu)",
 	"dependencies": {
 		"class-transformer": "^0.5.1",