alado 1.11.0 → 2.0.0

package/README.md

@@ -5,12 +5,524 @@ Its main difference from most similar well-known frameworks is that with a minim
 it provides out-of-the-box such fully-functioning features as routing, CORS, automatic API documentation (Open API 3.0),
 parsing query and path parameters, and the request body, file uploading, request authentication, etc.
 
+# Documentation for version 2.0.0 and above:
+Version 2.0.0 comes with decorators that simplify the project structure and minimize the amount of code you need to write.
+
+
+There is an example of the API creating with Alado (version >= 2.0.0):
+[https://github.com/databikers/alado-decorators-api-example](https://github.com/databikers/alado-decorators-api-example)
+
+## Use inside controllers the next decorators:
+
+### HTTP Method Decorators
+
+```ts
+get(path: string, options: HttpDecoratorOptions = {})
+post(path: string, options: HttpDecoratorOptions = {})
+put(path: string, options: HttpDecoratorOptions = {})
+patch(path: string, options: HttpDecoratorOptions = {})
+del(path: string, options: HttpDecoratorOptions = {})
+head(path: string, options: HttpDecoratorOptions = {})
+```
+
+#### Arguments
+- **path**: Route string (e.g., `/users/:id`).
+- **options**: `HttpDecoratorOptions` object, may include:
+  - `appId`: Identifier of the application instance.
+  - `title`: A descriptive name of the endpoint.
+  - `description`: Documentation text for the endpoint.
+  - `tags`: Array of tags for grouping in OpenAPI docs.
+  - `isHidden`: Boolean flag to hide the endpoint from OpenAPI output
+
+---
+
+### `defineRequest` decorator
+
+```ts
+defineRequest(request: Partial<Record<keyof [Request](#request), AnyClass>>)
+```
+
+#### Arguments
+- **request**: A partial mapping of keys from [Request](#request) to your DTO classes.
+  - Keys can include:
+    - `headers`, `query`, `path`, `body`: each a record of property definitions.
+    - `files`: mapping of [FilePropertyDefinition](#filepropertydefinition).
+    - `auth`: authentication data mapping.
+  - Each value points to a class that uses specific DTO decorators to define how that part of the request should be validated and documented.
+
+#### `Request`
+
+```ts
+interface Request {
+  request: IncomingMessage;
+  ip?: string;
+  origin?: string;
+  method?: HttpMethod;
+  url?: string;
+  auth?: Record<string, any>;
+  path?: Record<string, string>;
+  headers?: IncomingHttpHeaders;
+  query?: Record<string, any>;
+  body?: Record<string, any>;
+  rawBody?: string;
+  files?: Record<string, { stream: Readable; size: number; mimetype: string }>;
+}
+```
+
+---
+
+### `defineResponse` decorator
+
+```ts
+defineResponse(response: [Response](#response)<any>)
+```
+
+#### Arguments
+- **response**: Response schema definition, including:
+  - `title`: Short descriptive title.
+  - `description`: Explanation of the response.
+  - `statusCode`: HTTP status code.
+  - `headers`: Mapping of header names to values.
+  - `body`: Response body object (may be an instance of some DTO or class).
+
+#### `Response`
+
+```ts
+interface Response<T> {
+  title?: string;
+  description?: string;
+  statusCode: number;
+  headers?: Record<string, string>;
+  body?: T;
+}
+```
+---
+
+### `withAuth` decorator
+
+```ts
+withAuth(requestAuthentication: [RequestAuthentication](#requestauthentication))
+```
+
+#### Arguments
+- **requestAuthentication**: Defines authentication requirements, including:
+  - `inputProperty`: Field name in request used for auth input.
+  - `outputProperty`: Field name in request to store auth result.
+  - `handler`: Function to transform/verify authentication value.
+  - `handlerContext`: Optional context object passed to handler.
+  - `required`: Boolean indicating if authentication is mandatory.
+  - `error`: Error object to use when authentication fails.
+
+#### `RequestAuthentication`
+
+```ts
+interface RequestAuthentication {
+  inputProperty: string;
+  outputProperty: string;
+  handler: (value: any) => any | Promise<any>;
+  handlerContext?: any;
+  required: boolean;
+  error: AladoServerError;
+}
+```
+
+
+```typescript
+import { RequestAuthentication } from 'alado';
+import { DataStore } from '@data-store';
+
+export const bearerAuth: RequestAuthentication = {
+  required: true,
+  inputProperty: 'headers.x-api-key',
+  outputProperty: 'auth.user',
+  handler(value: string) {
+    return DataStore.bearerAuth(value);
+  },
+  error: {
+    statusCode: 401,
+    message: 'Unauthorized',
+  },
+};
+
+```
+
+#### `AladoServerError`
+
+```ts
+type AladoServerError = {
+  statusCode: number;
+  message: string;
+};
+```
+---
+
+Example of controller:
+
+
+```ts
+export class UserController {
+  @post('/user', { tags: ['User'] })
+  @defineResponse({
+    statusCode: 201,
+    title: 'User',
+    headers: { 'Content-Type': 'application/json' },
+    body: exampleUserDto,
+  })
+  @defineRequest({ body: CredentialsDto })
+  public async create(req: Request) {
+    const { body } = req;
+    const user = DataStore.signUp(body as CredentialsDto);
+    return {
+      statusCode: 201,
+      headers: { 'Content-Type': 'application/json' },
+      body: user,
+    };
+  }
+  
+  @patch('/user/:id', { tags: ['User'] })
+  @withAuth(bearerAuth)
+  @defineResponse({
+    statusCode: 200,
+    title: 'User',
+    headers: { 'Content-Type': 'application/json' },
+    body: exampleUserDto,
+  })
+  @defineRequest({ body: UserDto, path: Id })
+  public async update(req: Request) {
+    const isMyId = this.isMyId(req);
+    if (!isMyId) {
+      return {
+        statusCode: 403,
+        headers: { 'Content-Type': 'application/json' },
+        body: { message: 'Access denied' },
+      };
+    }
+    const { path, body } = req;
+    const user = DataStore.getUser(path.id);
+    if (user) {
+      DataStore.setUser(path.id, body as UserDto);
+    }
+    return {
+      statusCode: user ? 200 : 404,
+      headers: { 'Content-Type': 'application/json' },
+      body: DataStore.getUser(path.id) || { message: 'Not Found' },
+    };
+  }
+
+  @post('/user/:id/avatar', { tags: ['User'] })
+  @withAuth(bearerAuth)
+  @defineResponse({
+    statusCode: 200,
+    title: 'User',
+    headers: { 'Content-Type': 'application/json' },
+    body: exampleUserDto,
+  })
+  @defineRequest({ path: Id, files: UserFilesDto })
+  public setAvatar(req: Request) {
+    const isMyId = this.isMyId(req);
+    if (!isMyId) {
+      return {
+        statusCode: 403,
+        headers: { 'Content-Type': 'application/json' },
+        body: { message: 'Access denied' },
+      };
+    }
+    const { path, files } = req;
+    const user = DataStore.getUser(path.id);
+    if (!user) {
+      return {
+        statusCode: 404,
+        headers: { 'Content-Type': 'application/json' },
+        body: { message: 'Not Found' },
+      };
+    }
+    const { avatar } = files;
+    const writeStream = createWriteStream(`${process.cwd()}/uploads/user-${path.id}-avatar.png`, {
+      encoding: 'latin1',
+    });
+    avatar.stream.pipe(writeStream);
+    return {
+      statusCode: 202,
+      headers: { 'Content-Type': 'application/json' },
+      body: {},
+    };
+  }
+
+}
+```
+
+---
+
+## Use these decorators inside DTO classes:
+
+### `fileUploadProperty`
+
+```ts
+fileUploadProperty(filePropertyDefinition: [FilePropertyDefinition](#filepropertydefinition))
+```
+
+#### Arguments
+- **filePropertyDefinition**: Object describing file upload rules, including:
+  - `mimetypes`: Array of allowed MIME types.
+  - `maxSize`: Maximum file size (bytes).
+  - `required`: Whether the file must be provided.
+  - `mimetypeError`, `maxSizeError`, `requiredError`: Error objects describing validation failures.
+
+#### `FilePropertyDefinition`
+
+```ts
+interface FilePropertyDefinition {
+  mimetypes: string[];
+  maxSize: number;
+  required: boolean;
+  mimetypeError: AladoServerError;
+  maxSizeError: AladoServerError;
+  requiredError: AladoServerError;
+}
+```
+
+---
+
+### `documentProperty`
+
+```ts
+documentProperty(propertyDocumentation: [PropertyDocumentation](#propertydocumentation))
+```
+
+#### Arguments
+- **propertyDocumentation**: Documentation metadata for a property, including:
+  - `schema`: JSON Schema–like definition (`type`, `format`, validation structure).
+  - `description`: Human-readable explanation.
+  - `example`: Example value.
+
+#### `PropertyDocumentation`
+
+```ts
+interface PropertyDocumentation {
+  schema: PropertyDefinitionSchema;
+  description?: string;
+  example?: any;
+}
+```
+
+#### `PropertyDefinitionSchema`
+
+```ts
+interface PropertyDefinitionSchema {
+  type?: string;
+  format?: string;
+  default?: any;
+  $ref?: string;
+  nullable?: boolean;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  deprecated?: boolean;
+  enum?: any[];
+  oneOf?: Array<PropertyDefinitionSchema>;
+  anyOf?: Array<PropertyDefinitionSchema>;
+  allOf?: Array<PropertyDefinitionSchema>;
+  not?: Array<PropertyDefinitionSchema>;
+  properties?: Record<string, PropertyDefinitionSchema>;
+  additionalProperties?: PropertyDefinitionSchema;
+  minProperties?: number;
+  maxProperties?: number;
+  minimum?: number;
+  maximum?: number;
+  exclusiveMinimum?: number;
+  exclusiveMaximum?: number;
+  multipleOf?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  items?: PropertyDefinitionSchema;
+  minItems?: number;
+  maxItems?: number;
+  uniqueItems?: boolean;
+}
+```
+
+---
+
+### `validateProperty`
+
+```ts
+validateProperty(propertyValidation: [PropertyValidation](#propertyvalidation))
+```
+
+#### Arguments
+- **propertyValidation**: Validation rules, including:
+  - `required`: Whether the property is mandatory.
+  - `handler`: Function to validate the property value (sync or async).
+  - `error`: Error object returned when validation fails.
+
+#### `PropertyValidation`
+
+```ts
+interface PropertyValidation {
+  required?: boolean;
+  handler: (value: any) => boolean | Promise<boolean>; // throws error when returns false
+  error: AladoServerError;
+}
+```
+
+---
+DTOs examples:
+
+```typescript
+import { validateProperty, documentProperty } from 'alado';
+
+export class Id {
+  @validateProperty({
+    required: true,
+    handler: async (value: any) => idValidator(value),
+    error: {
+      statusCode: 400,
+      message: 'Invalid id',
+    },
+  })
+  @documentProperty({
+    schema: {
+      type: 'string',
+    },
+    example: '7ef5ed25-53b1-432f-96ec-8e35d830eb9c',
+    description: 'User Id',
+  })
+  id: string = '7ef5ed25-53b1-432f-96ec-8e35d830eb9c';
+}
+
+```
+
+
+```typescript
+import { fileUploadProperty } from 'alado';
+
+export class UserFilesDto {
+  @fileUploadProperty({
+    mimetypes: ['image/png'],
+    maxSize: 1048576,
+    required: true,
+    maxSizeError: {
+      statusCode: 413,
+      message: 'The avatar should not be larger than 1MB',
+    },
+    mimetypeError: {
+      statusCode: 415,
+      message: 'The avatar should be a PNG image',
+    },
+    requiredError: {
+      statusCode: 400,
+      message: 'The avatar file is required',
+    },
+  })
+  avatar: string = '/path/to/image.png';
+}
+
+```
+
+```typescript
+import { validateProperty, documentProperty } from 'alado';
+
+export class CredentialsDto {
+  @validateProperty({
+    required: true,
+    handler: async (value: any) => emailValidator(value),
+    error: {
+      statusCode: 400,
+      message: 'Invalid email',
+    },
+  })
+  @documentProperty({
+    schema: {
+      type: 'string',
+    },
+    example: 'example@example.com',
+    description: 'User email',
+  })
+  email: string = 'example@example.com';
+
+  @validateProperty({
+    required: true,
+    handler: async (value: any) => passwordValidator(value),
+    error: {
+      statusCode: 400,
+      message: 'Invalid password',
+    },
+  })
+  @documentProperty({
+    schema: {
+      type: 'string',
+    },
+    example: 'securePassword',
+    description: 'User password',
+  })
+  password: string = 'securePassword';
+}
+
+export const credentialsDto = new CredentialsDto();
+
+```
+
+---
+
+## Initialize the application
+
+Finally, use the `initializeApplication` function to get an instance you would like to run:
+
+```ts
+import { initializeApplication } from 'alado';
+import { aladoServerOptions } from '@config';
+import { UserController } from '@user';
+
+export const app = initializeApplication({
+  serverOptions: aladoServerOptions,
+  controllers: [UserController]
+});
+
+app.start(() => console.log('Application has been successfully started'));
+
+```
+
+#### Arguments
+- **initializeApplicationOptions**: Object containing:
+  - **serverOptions** ([AladoServerOptions](#aladoserveroptions)): Configuration for starting the server (e.g., `appId`, port, logger).
+  - **controllers**: Array of controller classes to initialize at startup.
+
+#### `InitializeApplicationOptions`
+
+```ts
+interface InitializeApplicationOptions {
+  serverOptions: AladoServerOptions;
+  controllers: AnyClass[];
+}
+```
+
+#### `AladoServerOptions`
+
+```ts
+interface AladoServerOptions {
+  appId?: string;
+  port?: number;
+  logger?: AladoServerLogger;
+}
+```
+
+#### `AladoServerLogger`
+
+```ts
+interface AladoServerLogger {
+  log: (...args: any[]) => void;
+  error: (error: Error) => void;
+}
+```
+
+
+
+There is an example of the API creating with Alado (version < 2.0.0):
+
 The basis of use is a combination of interface simplicity and separation of the “routine” part of writing API
 from business logic implementation - due to a declarative approach to describing all request parameters
 in the form of static reusable structures.
 
-There is an example of the API creating with Alado:
-
 [https://github.com/databikers/alado-api-example](https://github.com/databikers/alado-api-example)
 
 1. Installation
@@ -32,7 +544,7 @@ const app: AladoServer = new AladoServer({
     allowedHeaders: ['Authorization'],
     exposeHeaders: ['x-total-count'],
   },
-  openApiDoc: {
+  documentProperty: {
     enable: true,
     route: '/open-api',
     info: {
@@ -42,6 +554,7 @@ const app: AladoServer = new AladoServer({
     },
   },
   verbose: true,
+  maxBodySizeBytes: 1024,
 });
 ```
 
@@ -84,6 +597,7 @@ const app = new AladoServer({
     },
   },
   verbose: true,
+  maxBodySizeBytes: 1024,
 });
 ```
 
@@ -150,7 +664,7 @@ const bearerAuth: RequestAuthentication = {
   inputProperty: 'headers.authorization',
   outputProperty: 'auth.user',
   handler: async (bearer: string) => {
-    // validate header, return user
+    // validateProperty header, return user
     return {
       name: 'John Doe',
       id: 1,
@@ -213,7 +727,7 @@ const bearerAuth: RequestAuthentication = {
 ```typescript
 interface ContextOptions {
   allowUnknownFields?: boolean;
-  openApiDoc?: {
+  documentProperty?: {
     description?: string;
     operationId: string;
     tags?: string[];
@@ -223,7 +737,7 @@ interface ContextOptions {
 
 Setting "allowUnknownFields" to false protects your application from receiving unexpected properties in the request body, query, and files. It does not affect request.path, as path variables are defined at the routing level, nor does it affect request headers. Conversely, you can receive { name: 'John Doe', role: 'Admin' } when only expecting name.
 
-The "openApiDoc" property is part of the Open API route definition and is optional.
+The "documentProperty" property is part of the Open API route definition and is optional.
 
 3.2.3 Context.request
 
@@ -246,7 +760,7 @@ There's an example for request with path property only:
 const request: ContextRequest = {
   path: {
     id: {
-      openApiDoc: {
+      documentProperty: {
         schema: {
           type: 'string',
         },
@@ -282,7 +796,7 @@ The execution context of validation.handler (and validation transform) is the re
 const request: ContextRequest = {
   body: {
     role: {
-      openApiDoc: {
+      documentProperty: {
         schema: {
           type: 'string',
         },
@@ -315,7 +829,7 @@ is set to false, all non-described request properties (or non-described nested p
 const request: ContextRequest = {
   query: {
     sortBy: {
-      openApiDoc: {
+      documentProperty: {
         schema: {
           type: 'string',
         },
@@ -337,7 +851,7 @@ const request: ContextRequest = {
       },
     },
     sortOrder: {
-      openApiDoc: {
+      documentProperty: {
         schema: {
           type: 'string',
         },
@@ -514,4 +1028,4 @@ app.start(() => console.log('Your awesome application has been successfully laun
 app.stop(() => console.log('Your awesome application has been successfully launched'));
 ```
 
-Don't forget to check swagger at the defined above options.openApiDoc.route
+Don't forget to check swagger at the defined above options.documentProperty.route

package/dist/alado-server/alado-server.d.ts

@@ -3,6 +3,7 @@ import { Server } from 'http';
 import { AladoServerOptions } from '../options';
 import { Context, Response } from '../dto';
 export declare class AladoServer {
+    private readonly appId;
     private readonly router;
     private readonly server;
     private readonly openApiDocObject;

package/dist/alado-server/alado-server.js

@@ -6,6 +6,7 @@ const _router_1 = require("../router");
 const _factory_1 = require("../factory");
 const _helper_1 = require("../helpers");
 class AladoServer {
+    appId;
     router;
     server;
     openApiDocObject;
@@ -15,6 +16,7 @@ class AladoServer {
     logger;
     constructor(options) {
         (0, _helper_1.validateAladoOptions)(options);
+        this.appId = options.appId || _const_1.DEFAULT_ID;
         if (options.openApiDoc?.route) {
             options.openApiDoc.route = `${(0, _helper_1.clearRoutePath)(options.openApiDoc.route)}`;
         }

package/dist/alado-server/alado-server.js.map

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

package/dist/constants/default-id.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_ID: string;

package/dist/constants/default-id.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ID = void 0;
+exports.DEFAULT_ID = 'defaultApp';
+//# sourceMappingURL=default-id.js.map

package/dist/constants/default-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-id.js","sourceRoot":"","sources":["../../src/constants/default-id.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAW,YAAY,CAAC"}

package/dist/constants/index.d.ts

@@ -4,3 +4,4 @@ export * from './http-method';
 export * from './http-server';
 export * from './http-status';
 export * from './reg-exp';
+export * from './default-id';

package/dist/constants/index.js

@@ -20,4 +20,5 @@ __exportStar(require("./http-method"), exports);
 __exportStar(require("./http-server"), exports);
 __exportStar(require("./http-status"), exports);
 __exportStar(require("./reg-exp"), exports);
+__exportStar(require("./default-id"), exports);
 //# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,uDAAqC;AACrC,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,uDAAqC;AACrC,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,4CAA0B;AAC1B,+CAA6B"}

package/dist/decorators/define-request.d.ts

@@ -0,0 +1,3 @@
+import { Request } from '../dto';
+import { AnyClass } from '../options';
+export declare function defineRequest(request: Partial<Record<keyof Request, AnyClass>>): (...args: any[]) => void;