@mini2/core 2.0.0 → 2.0.1-beta.2

package/Readme.MD

@@ -6,10 +6,14 @@
 
 - 🚀 **Decorator-Based Routing**: Easy route definition with decorators like `@get`, `@post`
 - 📝 **Automatic Swagger Documentation**: API documentation generated automatically
+- 🧪 **Example-Driven OpenAPI**: Generate request/response schemas and examples from `RouteOptions.examples`
+- 🧰 **Postman-Friendly Metadata**: Attach `@preRequestScript` / `@testScript` to operations via OpenAPI vendor extensions
 - 🔧 **Dependency Injection**: Powerful DI container based on InversifyJS
 - 🛡️ **Security Middlewares**: Authentication, authorization, and validation
+- 🔒 **Swagger Basic Auth**: Optionally protect Swagger UI and JSON spec endpoints with Basic Authentication
 - 📦 **Full TypeScript Support**: Type-safe API development
 - 🎯 **Response Builder**: Consistent API responses
+- 🧭 **Autoload Controllers/Injectables**: Optional filesystem-based autoload to discover modules automatically
 - ⚡ **Quick Setup**: Minimal configuration required
 
 ## 📦 Installation
@@ -264,6 +268,43 @@ async downloadFile(@req() req: Request, @res() res: Response) {
 }
 ```
 
+#### **@body() / @query() / @params() / @headers()**
+
+Inject validated/normalized request data into method parameters. When validation is enabled via `@validate(...)`, these decorators prefer the validated instance (class-transformer + class-validator) and fall back to raw Express data.
+
+```typescript
+@put('/:id')
+@validate({
+  params: IdParamsDto,
+  query: SearchQueryDto,
+  body: UpdateDto,
+  headers: MyHeadersDto,
+})
+async update(
+  @params() params: IdParamsDto,
+  @query() query: SearchQueryDto,
+  @body() body: UpdateDto,
+  @headers() headers: MyHeadersDto,
+) {
+  return new ResponseBuilder().ok({ params, query, body, headers });
+}
+```
+
+#### **@next()**
+
+Injects Express `next` into your handler (useful for `next(err)` patterns when you want to delegate error handling).
+
+```typescript
+@get('/health')
+health(@next() next: NextFunction) {
+  try {
+    // ...
+  } catch (e) {
+    next(e);
+  }
+}
+```
+
 ### 🛡️ Security Decorators
 
 #### **@authenticated()**
@@ -314,6 +355,16 @@ async getReports(@req() req: Request) {
 - Uses OR logic: user needs ANY of the specified permissions
 - Throws `ForbiddenException` if insufficient permissions
 
+#### **Default Header-Based Auth (for local/test setups)**
+
+The built-in `authenticatedMiddleware` and `authorizedMiddleware` support a simple header-based flow that is convenient for local development and tests:
+
+- `x-authenticated`: `"true" | "1" | "yes" | "y"` (required for authenticated routes)
+- `x-user-id`: user identifier (optional)
+- `x-user-permissions`: comma-separated permissions (optional, e.g. `"admin,reader"`)
+
+If authentication fails, an `UnauthorizedException` is thrown; if authorization fails, a `ForbiddenException` is thrown.
+
 ### ✅ Validation Decorators
 
 #### **@validate(options: ValidationOptions)**
@@ -340,6 +391,7 @@ async createUser(@req() req: Request) {
 - `body`: DTO class for request body validation
 - `params`: DTO class for URL parameters validation
 - `query`: DTO class for query parameters validation
+- `headers`: DTO class for header validation
 
 **Example DTO Classes:**
 
@@ -604,6 +656,16 @@ async createUser(@req() req: Request) {
 - `body` - Request body validation
 - `params` - URL parameters validation
 - `query` - Query parameters validation
+- `headers` - Request header validation
+
+**Advanced options (via `@validate`)**
+
+Each validation entry can be configured with:
+
+- `transformOptions`: class-transformer options
+- `validatorOptions`: class-validator options
+- `logging`: debug logs for source/transformed payloads
+- `customHttpError`: override the default 400 response with a custom `HttpException`
 
 #### **authenticatedMiddleware**
 
@@ -855,6 +917,58 @@ const swaggerOptions = {
 };
 ```
 
+#### **🧪 Example-Driven OpenAPI (Schemas + Examples)**
+
+You can provide concrete request/response examples per route. If `examples` are present, Swagger generation prefers them to:
+
+- Build request body schemas and attach `example`
+- Generate path/query/header parameters (with examples when available)
+- Generate **all response status codes** with `example` and `examples.default` for compatibility
+
+Example (simplified):
+
+```typescript
+@post('/create', 'Create', {
+  examples: [{
+    request: {
+      body: { title: 'Test Item', order: 1 },
+      params: { id: '123' },
+      query: { page: 1 },
+      headers: { 'x-echo': 'hello' },
+    },
+    response: {
+      201: { description: 'Created', data: { ok: true } },
+      400: { description: 'Validation error', data: { error: 'Validation failed' } },
+    },
+  }],
+})
+create() { /* ... */ }
+```
+
+#### **🧰 Postman Scripts via OpenAPI Vendor Extensions**
+
+Attach Postman-compatible scripts to a route:
+
+- `@preRequestScript(script: string)` → `x-postman-prerequest`
+- `@testScript(script: string)` → `x-postman-test`
+
+Swagger/OpenAPI will include them as vendor extensions on the operation, and also as a combined `x-postman-events` list (when present). This is useful for tooling that can import OpenAPI and preserve Postman behaviors.
+
+#### **🔒 Protect Swagger with Basic Auth**
+
+To protect Swagger UI and the raw OpenAPI JSON spec, set `swaggerBasicAuth` in `IConfig`:
+
+```typescript
+await app.init({
+  host: 'localhost',
+  port: 3000,
+  applicationName: 'Protected API',
+  swaggerBasicAuth: { username: 'admin', password: 'secret123' },
+});
+```
+
+This will protect both `docsPath` and `jsonPath` endpoints (defaults: `/api-docs` and `/api-docs.json`).
+
 #### **🔐 Security Documentation**
 
 Security decorators automatically add authentication requirements:
@@ -898,6 +1012,36 @@ async createUser(@req() req: Request) {
 - OpenAPI JSON can be used with external documentation tools
 - All validation errors are automatically documented with examples
 
+### 🧭 Autoload (Filesystem Discovery)
+
+The framework can automatically discover and load controllers/injectables from a directory (useful for local dev, tests, and modular apps).
+
+```typescript
+await app.init(
+  { host: 'localhost', port: 3000, applicationName: 'My API' },
+  {
+    autoload: true,
+    workingDirectory: __dirname,
+    extensions: ['.ts', '.mts', '.cts'],
+    patterns: ['**/*.(ts|js)'],
+    logging: true,
+  }
+);
+```
+
+Notes:
+
+- Files starting with `//mini-dont-auto-load` are skipped.
+- In production you typically point `workingDirectory` to your compiled output (e.g. `dist`).
+
+### 🧪 Local Test Server + Postman Collection
+
+This repo includes a runnable demo server and an example Postman collection to quickly validate Swagger generation, examples, and Postman script extensions:
+
+- `local-test-server/index.ts`: starts the server with autoload enabled
+- `local-test-server/local-test-controller.ts`: demonstrates `examples`, `@preRequestScript`, and `@testScript`
+- `local-test-server/Local Test Server.postman_collection.json`: ready-to-import collection
+
 ### 📝 TypeScript Support
 
 Full TypeScript support with type-safe API development:
@@ -1016,6 +1160,39 @@ export class UserController {
 }
 ```
 
+### 🔎 DI Auto Discovery (`autoBind` + `bindDiscovered`)
+
+For modular apps, you can register bindings via decorators and then bind them in one shot.
+
+```typescript
+import { autoBind, bindDiscovered, MINI_TYPES } from '@mini2/core';
+
+@autoBind(MINI_TYPES.IController, { scope: 'Transient', priority: 10 })
+@controller('/api/users')
+export class UserController extends Controller {}
+
+// After loading modules (or using autoload), bind everything discovered:
+bindDiscovered();
+```
+
+Notes:
+
+- Supported scopes: `Singleton`, `Transient`, `Request`
+- `priority` controls binding order (lower first)
+
+### 🧩 Custom Route Metadata (`@custom`)
+
+If you want to attach arbitrary metadata to a route (e.g., for tooling), use `@custom(key, value)` which stores data in `RouteOptions.extraData`.
+
+```typescript
+@get('/reports')
+@custom('x-internal-owner', 'analytics')
+@custom('x-stability', 'beta')
+async reports() {
+  return new ResponseBuilder().ok({ ok: true });
+}
+```
+
 ## 📋 Complete Export List
 
 ```typescript

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAG9B,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAc,MAAM,WAAW,CAAC;AAKlD,OAAO,EAAmB,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEnE,cACM,GAAI,YAAW,IAAI;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAS;;IAOnC,eAAe,CAAC,sBAAsB,CAAC,EAAE,sBAAsB;IAQzD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,sBAAsB;IAI3E,oBAAoB,CAAC,MAAM,EAAE,OAAO;IA0BpC,MAAM;IAIA,SAAS,CAAC,oBAAoB,GAAE,OAAc;CAiBpD;AAED,eAAe,GAAG,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAG9B,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAc,MAAM,WAAW,CAAC;AAKlD,OAAO,EAAmB,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEnE,cACM,GAAI,YAAW,IAAI;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAS;;IAOnC,eAAe,CAAC,sBAAsB,CAAC,EAAE,sBAAsB;IAQzD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,sBAAsB;IAI3E,oBAAoB,CAAC,MAAM,EAAE,OAAO;IA2BpC,MAAM;IAIA,SAAS,CAAC,oBAAoB,GAAE,OAAc;CAiBpD;AAED,eAAe,GAAG,CAAC"}

package/dist/app.js

@@ -53,14 +53,15 @@ let App = class App {
             title: config.applicationName,
             description: `API documentation for ${config.applicationName}`,
             version: '1.0.0',
-            servers: [
+            servers: config.swaggerServers ?? [
                 {
                     url: `http://${config.host}:${config.port}`,
                     description: 'Development server',
                 },
             ],
-            docsPath: '/api-docs',
-            jsonPath: '/api-docs.json',
+            docsPath: config.swaggerDocsPath ?? '/api-docs',
+            jsonPath: config.swaggerJsonPath ?? '/api-docs.json',
+            ...(config.swaggerBasicAuth && { basicAuth: config.swaggerBasicAuth }),
         });
         this.controllers = container_1.container.getAll(types_1.MINI_TYPES.IController);
         swaggerIntegration.generateSwaggerSpec(this.controllers);

package/dist/app.js.map

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

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './notations/controller/middlewares/authorized.middleware';
 export * from './notations/controller/middlewares/validation.middleware';
 export * from './utils/array-unify';
 export * from './utils/math';
+export * from './utils/infer-schema';
 export * from './expections/http.expection';
 export { default as HttpException } from './expections/http.expection';
 export * from './types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,QAAA,MAAM,QAAQ,iBAAW,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2DAA2D,CAAC;AAC1E,cAAc,+BAA+B,CAAC;AAG9C,cAAc,6DAA6D,CAAC;AAC5E,cAAc,0DAA0D,CAAC;AACzE,cAAc,0DAA0D,CAAC;AAGzE,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAG7B,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGvE,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,QAAA,MAAM,QAAQ,iBAAW,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2DAA2D,CAAC;AAC1E,cAAc,+BAA+B,CAAC;AAG9C,cAAc,6DAA6D,CAAC;AAC5E,cAAc,0DAA0D,CAAC;AACzE,cAAc,0DAA0D,CAAC;AAGzE,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGvE,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./notations/controller/middlewares/validation.middleware")
 // Utils
 __exportStar(require("./utils/array-unify"), exports);
 __exportStar(require("./utils/math"), exports);
+__exportStar(require("./utils/infer-schema"), exports);
 // Exceptions
 __exportStar(require("./expections/http.expection"), exports);
 var http_expection_1 = require("./expections/http.expection");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,gDAAwB;AAaf,cAbF,aAAG,CAaE;AAZZ,2CAAkD;AAOzC,0FAPA,qBAAS,OAOA;AACT,yFARW,oBAAQ,OAQX;AANjB,mCAAqC;AAW5B,2FAXA,kBAAU,OAWA;AAVnB,yBAAyB;AAEzB,mCAAmC;AACnC,4CAA0B;AAG1B,MAAM,QAAQ,GAAG,oBAAQ,CAAC;AACjB,4BAAQ;AAKjB,aAAa;AACb,6DAA2C;AAC3C,4FAA0E;AAC1E,gEAA8C;AAE9C,cAAc;AACd,8FAA4E;AAC5E,2FAAyE;AACzE,2FAAyE;AAEzE,QAAQ;AACR,sDAAoC;AACpC,+CAA6B;AAE7B,aAAa;AACb,8DAA4C;AAC5C,8DAAuE;AAA9D,gIAAA,OAAO,OAAiB;AAEjC,QAAQ;AACR,0CAAwB;AAExB,mBAAmB;AACnB,qDAAmC;AAEnC,iBAAiB;AACjB,8CAA4B;AAE5B,sBAAsB;AACtB,4CAA0B;AAE1B,qBAAS,CAAC,IAAI,CAAO,kBAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,gDAAwB;AAaf,cAbF,aAAG,CAaE;AAZZ,2CAAkD;AAOzC,0FAPA,qBAAS,OAOA;AACT,yFARW,oBAAQ,OAQX;AANjB,mCAAqC;AAW5B,2FAXA,kBAAU,OAWA;AAVnB,yBAAyB;AAEzB,mCAAmC;AACnC,4CAA0B;AAG1B,MAAM,QAAQ,GAAG,oBAAQ,CAAC;AACjB,4BAAQ;AAKjB,aAAa;AACb,6DAA2C;AAC3C,4FAA0E;AAC1E,gEAA8C;AAE9C,cAAc;AACd,8FAA4E;AAC5E,2FAAyE;AACzE,2FAAyE;AAEzE,QAAQ;AACR,sDAAoC;AACpC,+CAA6B;AAC7B,uDAAqC;AAErC,aAAa;AACb,8DAA4C;AAC5C,8DAAuE;AAA9D,gIAAA,OAAO,OAAiB;AAEjC,QAAQ;AACR,0CAAwB;AAExB,mBAAmB;AACnB,qDAAmC;AAEnC,iBAAiB;AACjB,8CAA4B;AAE5B,sBAAsB;AACtB,4CAA0B;AAE1B,qBAAS,CAAC,IAAI,CAAO,kBAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC"}

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

@@ -1,6 +1,18 @@
+export interface ISwaggerServer {
+    url: string;
+    description: string;
+}
+export interface ISwaggerBasicAuth {
+    username: string;
+    password: string;
+}
 export interface IConfig {
     host: string;
     port: number;
     applicationName: string;
+    swaggerDocsPath?: string;
+    swaggerJsonPath?: string;
+    swaggerServers?: ISwaggerServer[];
+    swaggerBasicAuth?: ISwaggerBasicAuth;
 }
 //# sourceMappingURL=config.interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.interface.d.ts","sourceRoot":"","sources":["../../interfaces/config.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"config.interface.d.ts","sourceRoot":"","sources":["../../interfaces/config.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACrC"}

package/dist/local-test-server/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/local-test-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../local-test-server/index.ts"],"names":[],"mappings":""}

package/dist/local-test-server/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const app_1 = __importDefault(require("../app"));
+const app = new app_1.default();
+app
+    .init({
+    host: 'localhost',
+    port: 3000,
+    applicationName: 'Local Test Server',
+}, {
+    autoload: true,
+    workingDirectory: __dirname,
+    extensions: ['.ts', '.mts', '.cts'],
+    patterns: ['**/*.(ts|js)'],
+    logging: true,
+})
+    .then(() => {
+    console.log('Local Test Server is running on port 3000');
+});
+//# sourceMappingURL=index.js.map

package/dist/local-test-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../local-test-server/index.ts"],"names":[],"mappings":";;;;;AAAA,iDAAyB;AAEzB,MAAM,GAAG,GAAG,IAAI,aAAG,EAAE,CAAC;AACtB,GAAG;KACD,IAAI,CACJ;IACC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,eAAe,EAAE,mBAAmB;CACpC,EACD;IACC,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,cAAc,CAAC;IAC1B,OAAO,EAAE,IAAI;CACb,CACD;KACA,IAAI,CAAC,GAAG,EAAE;IACV,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC"}

package/dist/local-test-server/local-test-controller.d.ts

@@ -0,0 +1,7 @@
+import { Response } from 'express';
+import { Controller } from '../notations';
+export declare class LocalTestController extends Controller {
+    constructor();
+    root(res: Response): void;
+}
+//# sourceMappingURL=local-test-controller.d.ts.map

package/dist/local-test-server/local-test-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-test-controller.d.ts","sourceRoot":"","sources":["../../local-test-server/local-test-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAEN,UAAU,EAKV,MAAM,cAAc,CAAC;AAEtB,qBACa,mBAAoB,SAAQ,UAAU;;IAoC3C,IAAI,CAAQ,GAAG,EAAE,QAAQ,GAAG,IAAI;CAOvC"}

package/dist/local-test-server/local-test-controller.js

@@ -0,0 +1,71 @@
+"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.LocalTestController = void 0;
+const notations_1 = require("../notations");
+let LocalTestController = class LocalTestController extends notations_1.Controller {
+    constructor() {
+        super();
+    }
+    root(res) {
+        res.setHeader('x-handler', 'root');
+        res.json({
+            ok: true,
+            route: 'GET /local-test',
+        });
+    }
+};
+exports.LocalTestController = LocalTestController;
+__decorate([
+    (0, notations_1.get)('/', 'Root GET', {
+        examples: [
+            {
+                request: {
+                    body: {
+                        name: 'John Doe',
+                    },
+                },
+                response: {
+                    200: {
+                        description: 'OK',
+                        data: {
+                            name: 'John Doe',
+                        },
+                    },
+                    404: {
+                        description: 'Not Found',
+                        data: {
+                            message: 'Not Found',
+                        },
+                    },
+                },
+            },
+        ],
+    }),
+    (0, notations_1.preRequestScript)(`
+        console.log('Pre-request script');
+    `),
+    (0, notations_1.testScript)(`
+        console.log('Test script');
+    `),
+    __param(0, (0, notations_1.res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], LocalTestController.prototype, "root", null);
+exports.LocalTestController = LocalTestController = __decorate([
+    (0, notations_1.controller)('/local-test', 'Local Test Controller', 'Local Test Module'),
+    __metadata("design:paramtypes", [])
+], LocalTestController);
+//# sourceMappingURL=local-test-controller.js.map

package/dist/local-test-server/local-test-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-test-controller.js","sourceRoot":"","sources":["../../local-test-server/local-test-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,4CAOsB;AAGf,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,sBAAU;IAClD;QACC,KAAK,EAAE,CAAC;IACT,CAAC;IAiCM,IAAI,CAAQ,GAAa;QAC/B,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,iBAAiB;SACxB,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AA3CY,kDAAmB;AAoCxB;IA/BN,IAAA,eAAG,EAAC,GAAG,EAAE,UAAU,EAAE;QACrB,QAAQ,EAAE;YACT;gBACC,OAAO,EAAE;oBACR,IAAI,EAAE;wBACL,IAAI,EAAE,UAAU;qBAChB;iBACD;gBACD,QAAQ,EAAE;oBACT,GAAG,EAAE;wBACJ,WAAW,EAAE,IAAI;wBACjB,IAAI,EAAE;4BACL,IAAI,EAAE,UAAU;yBAChB;qBACD;oBACD,GAAG,EAAE;wBACJ,WAAW,EAAE,WAAW;wBACxB,IAAI,EAAE;4BACL,OAAO,EAAE,WAAW;yBACpB;qBACD;iBACD;aACD;SACD;KACD,CAAC;IACD,IAAA,4BAAgB,EAAC;;KAEd,CAAC;IACJ,IAAA,sBAAU,EAAC;;KAER,CAAC;IACQ,WAAA,IAAA,eAAG,GAAE,CAAA;;;;+CAMjB;8BA1CW,mBAAmB;IAD/B,IAAA,sBAAU,EAAC,aAAa,EAAE,uBAAuB,EAAE,mBAAmB,CAAC;;GAC3D,mBAAmB,CA2C/B"}

package/dist/notations/controller/index.d.ts

@@ -37,12 +37,14 @@ export declare function controller(path: string, name?: string, moduleName?: str
     new (...args: any[]): Controller;
 }>(constructor: T) => void | T;
 export declare function httpMethod(newOptions: RouteOptions): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare function get(path: string, name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare function post(path: string, name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare function put(path: string, name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare function del(path: string, name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare function patch(path: string, name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function get(path: string, name?: string, options?: Omit<RouteOptions, 'path' | 'method' | 'name'>): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function post(path: string, name?: string, options?: Omit<RouteOptions, 'path' | 'method' | 'name'>): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function put(path: string, name?: string, options?: Omit<RouteOptions, 'path' | 'method' | 'name'>): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function del(path: string, name?: string, options?: Omit<RouteOptions, 'path' | 'method' | 'name'>): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function patch(path: string, name?: string, options?: Omit<RouteOptions, 'path' | 'method' | 'name'>): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
 export declare function validate(options: IValidation | IValidation[]): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function preRequestScript(script: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare function testScript(script: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
 export declare function authenticated(value?: boolean): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
 export declare function authorized(value: string | string[]): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
 export declare function middleware(mw: RequestHandler, isPre?: boolean, order?: number): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;

package/dist/notations/controller/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../notations/controller/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../notations/controller/index.ts"],"names":[],"mappings":"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"}

package/dist/notations/controller/index.js

@@ -12,6 +12,8 @@ exports.put = put;
 exports.del = del;
 exports.patch = patch;
 exports.validate = validate;
+exports.preRequestScript = preRequestScript;
+exports.testScript = testScript;
 exports.authenticated = authenticated;
 exports.authorized = authorized;
 exports.middleware = middleware;
@@ -178,6 +180,9 @@ function httpMethod(newOptions) {
             : existingOptions.authenticated;
         const otherHttpMiddlewares = (0, array_unify_1.arrayUnify)((newOptions.otherHttpMiddlewares ?? []).concat(existingOptions.otherHttpMiddlewares ?? []));
         const name = newOptions.name ?? existingOptions.name;
+        const examples = (0, array_unify_1.arrayUnify)((newOptions.examples ?? []).concat(existingOptions.examples ?? []));
+        const preRequestScript = newOptions.preRequestScript ?? existingOptions.preRequestScript;
+        const testScript = newOptions.testScript ?? existingOptions.testScript;
         const extraData = existingOptions.extraData ?? new Map();
         if (newOptions.extraData) {
             const newOptionsExtraData = newOptions.extraData;
@@ -224,6 +229,12 @@ function httpMethod(newOptions) {
             mergedOptions.otherHttpMiddlewares = otherHttpMiddlewares;
         if (name !== undefined)
             mergedOptions.name = name;
+        if (examples.length)
+            mergedOptions.examples = examples;
+        if (preRequestScript !== undefined)
+            mergedOptions.preRequestScript = preRequestScript;
+        if (testScript !== undefined)
+            mergedOptions.testScript = testScript;
         if (extraData && extraData.size > 0)
             mergedOptions.extraData = extraData;
         // NOT: method/param dekoratör metadataları **prototype** üzerinde tutuluyor
@@ -247,26 +258,36 @@ function httpMethod(newOptions) {
     };
 }
 /* HTTP method sugar */
-function get(path, name) {
-    return httpMethod({ path, method: 'get', name: name ?? path });
+function get(path, name, options) {
+    return httpMethod({ path, method: 'get', name: name ?? path, ...options });
 }
-function post(path, name) {
-    return httpMethod({ path, method: 'post', name: name ?? path });
+function post(path, name, options) {
+    return httpMethod({ path, method: 'post', name: name ?? path, ...options });
 }
-function put(path, name) {
-    return httpMethod({ path, method: 'put', name: name ?? path });
+function put(path, name, options) {
+    return httpMethod({ path, method: 'put', name: name ?? path, ...options });
 }
-function del(path, name) {
-    return httpMethod({ path, method: 'delete', name: name ?? path });
+function del(path, name, options) {
+    return httpMethod({ path, method: 'delete', name: name ?? path, ...options });
 }
-function patch(path, name) {
-    return httpMethod({ path, method: 'patch', name: name ?? path });
+function patch(path, name, options) {
+    return httpMethod({ path, method: 'patch', name: name ?? path, ...options });
 }
 function validate(options) {
     return httpMethod({
         validations: Array.isArray(options) ? options : [options],
     });
 }
+function preRequestScript(script) {
+    return httpMethod({
+        preRequestScript: script,
+    });
+}
+function testScript(script) {
+    return httpMethod({
+        testScript: script,
+    });
+}
 function authenticated(value = true) {
     return httpMethod({ authenticated: value });
 }