@elsikora/nestjs-crud-automator 1.2.1 → 1.4.0

package/README.md

@@ -0,0 +1,322 @@
+# API Controller Configuration Documentation
+
+## Overview
+The API Controller configuration is a TypeScript-based configuration system that provides a comprehensive way to define API endpoints with authentication, request/response handling, validation, and data transformation capabilities.
+
+## Table of Contents
+- [Basic Configuration Structure](#basic-configuration-structure)
+- [Route Configuration](#route-configuration)
+- [Authentication](#authentication)
+- [Request Handling](#request-handling)
+- [Response Handling](#response-handling)
+- [Data Transformation](#data-transformation)
+- [Validation](#validation)
+- [Relations Management](#relations-management)
+- [Auto DTO Configuration](#auto-dto-configuration)
+
+## Basic Configuration Structure
+
+The base configuration object follows this interface:
+
+```typescript
+interface IApiControllerProperties<E> {
+    entity: IApiBaseEntity;
+    name?: string;
+    path?: string;
+    routes: {
+        [R in EApiRouteType]?: TApiControllerPropertiesRoute<E, R>;
+    };
+}
+```
+
+### Properties:
+- `entity`: The base entity class for the controller
+- `name`: Optional name for the controller
+- `path`: Optional URL path for the controller
+- `routes`: Object containing route configurations
+
+## Route Configuration
+
+Routes are defined using the `EApiRouteType` enum, which includes:
+- CREATE
+- GET
+- GET_LIST
+- UPDATE
+- PARTIAL_UPDATE
+- DELETE
+
+Each route can be configured with:
+- Authentication settings
+- Request handling
+- Response handling
+- Data transformations
+- Validation rules
+
+Example:
+```typescript
+{
+    [EApiRouteType.CREATE]: {
+        authentication: {...},
+        request: {...},
+        response: {...}
+    }
+}
+```
+
+## Authentication
+
+Authentication configuration allows you to specify:
+- Bearer token strategies
+- Security strategies
+- Authentication guards
+- Authentication type
+
+```typescript
+interface IApiControllerPropertiesRouteAuthentication {
+    bearerStrategies?: Array<string>;
+    guard: Type<IAuthGuard>;
+    securityStrategies?: Array<string>;
+    type: EApiAuthenticationType;
+}
+```
+
+Example:
+```typescript
+authentication: {
+    bearerStrategies: ["accountAuthorization"],
+    guard: AccountGuard,
+    securityStrategies: ["accountRequestSignature", "accountRequestTimestamp"],
+    type: EApiAuthenticationType.ACCOUNT
+}
+```
+
+## Request Handling
+
+Request configuration includes:
+- Relations loading
+- Data transformation
+- Request validation
+
+```typescript
+interface IApiControllerPropertiesRouteBaseRequest<E, R> {
+    relations?: TApiControllerPropertiesRouteBaseRequestRelations<E>;
+    transformers?: TApiControllerPropertiesRouteBaseRequestTransformers<E, R>;
+    validators?: Array<IApiRequestValidator<E>>;
+}
+```
+
+### Relations Loading Strategies
+
+Two strategies are available:
+1. **AUTO**: Automatically loads relations
+2. **MANUAL**: Manually specify relations to load
+
+```typescript
+relations: {
+    loadRelations: true,
+    relationsLoadStrategy: EApiControllerLoadRelationsStrategy.MANUAL,
+    relationsToLoad: ["bank"],
+    servicesLoadStrategy: EApiControllerLoadRelationsStrategy.MANUAL,
+    relationsServices: {
+        bank: "bankService"
+    }
+}
+```
+
+## Response Handling
+
+Response configuration allows you to:
+- Specify relations to include
+- Transform response data
+
+```typescript
+interface IApiControllerPropertiesRouteBaseResponse<E, R> {
+    relations?: FindOptionsRelations<E>;
+    transformers?: TApiControllerPropertiesRouteBaseResponseTransformers<E, R>;
+}
+```
+
+Example:
+```typescript
+response: {
+    relations: {
+        bank: true,
+        currency: true
+    },
+    transformers: {
+        [EApiDtoType.RESPONSE]: [
+            {
+                key: "user",
+                type: EApiControllerRequestTransformerType.DYNAMIC,
+                value: TRANSFORMER_VALUE_DTO_CONSTANT.REQUEST_IP
+            }
+        ]
+    }
+}
+```
+
+## Data Transformation
+
+Transformers can be configured for different DTO types:
+- BODY
+- QUERY
+- REQUEST
+- RESPONSE
+
+Two types of transformers are available:
+1. **DYNAMIC**: Uses predefined constants
+2. **STATIC**: Uses static values
+
+```typescript
+type TApiRequestTransformer<E> = {
+    key: keyof IApiGetListResponseResult<E> | keyof Partial<E> | keyof TApiFunctionGetListProperties<E>;
+} & (
+    | {
+        type: EApiControllerRequestTransformerType.DYNAMIC;
+        value: (typeof TRANSFORMER_VALUE_DTO_CONSTANT)[keyof typeof TRANSFORMER_VALUE_DTO_CONSTANT];
+    }
+    | {
+        type: EApiControllerRequestTransformerType.STATIC;
+        value: string;
+    }
+);
+```
+
+## Validation
+
+Validators can be configured for requests with:
+- Error type
+- Exception class
+- Validation function
+
+```typescript
+interface IApiRequestValidator<E> {
+    errorType: EErrorStringAction;
+    exception: TApiException;
+    validationFunction: (entity: DeepPartial<E> | Partial<E> | TApiFunctionGetListProperties<E>) => boolean | Promise<boolean>;
+}
+```
+
+Example:
+```typescript
+validators: [
+    {
+        errorType: EErrorStringAction.ADDRESS_NOT_MATCH_PATTERN,
+        exception: BadRequestException,
+        validationFunction: (account: Partial<Account>): boolean => 
+            (account.id?.includes("7") ? account.id.includes("AAAA") : true)
+    }
+]
+```
+
+## Auto DTO Configuration
+
+Auto DTO allows automatic Data Transfer Object configuration:
+
+```typescript
+autoDto?: {
+    [key in EApiDtoType]?: IApiControllerPropertiesRouteAutoDtoConfig;
+};
+```
+
+Example:
+```typescript
+autoDto: {
+    [EApiDtoType.REQUEST]: {
+        validators: [
+            {
+                constraintClass: HasAtLeastOneOfListedProperties,
+                options: ["hybrid", "currencyId"]
+            }
+        ]
+    }
+}
+```
+
+## Usage Example
+
+Here's a complete example of a route configuration:
+
+```typescript
+[EApiRouteType.CREATE]: {
+    authentication: {
+        bearerStrategies: ["accountAuthorization"],
+        guard: AccountGuard,
+        securityStrategies: ["accountRequestSignature", "accountRequestTimestamp"],
+        type: EApiAuthenticationType.ACCOUNT
+    },
+    request: {
+        relations: {
+            loadRelations: true,
+            relationsLoadStrategy: EApiControllerLoadRelationsStrategy.MANUAL,
+            relationsServices: {
+                bank: "bankService"
+            },
+            relationsToLoad: ["bank"],
+            servicesLoadStrategy: EApiControllerLoadRelationsStrategy.MANUAL
+        },
+        transformers: {
+            [EApiDtoType.BODY]: [
+                {
+                    key: "user",
+                    type: EApiControllerRequestTransformerType.DYNAMIC,
+                    value: TRANSFORMER_VALUE_DTO_CONSTANT.AUTHORIZED_ENTITY
+                }
+            ]
+        },
+        validators: [
+            {
+                errorType: EErrorStringAction.ADDRESS_NOT_MATCH_PATTERN,
+                exception: BadRequestException,
+                validationFunction: (account: Partial<Account>): boolean => 
+                    (account.id?.includes("7") ? account.id.includes("AAAA") : true)
+            }
+        ]
+    },
+    response: {
+        relations: {
+            bank: true,
+            currency: true
+        },
+        transformers: {
+            [EApiDtoType.RESPONSE]: [
+                {
+                    key: "user",
+                    type: EApiControllerRequestTransformerType.DYNAMIC,
+                    value: TRANSFORMER_VALUE_DTO_CONSTANT.REQUEST_IP
+                }
+            ]
+        }
+    }
+}
+```
+
+## Best Practices
+
+1. **Authentication**
+    - Always specify appropriate bearer and security strategies
+    - Use proper guards for route protection
+    - Choose the correct authentication type
+
+2. **Relations**
+    - Use MANUAL strategy when you need precise control over relation loading
+    - Use AUTO strategy for simpler cases
+    - Always specify required services when using MANUAL strategy
+
+3. **Validation**
+    - Implement comprehensive validation rules
+    - Use appropriate error types and exceptions
+    - Consider both sync and async validation functions
+
+4. **Transformation**
+    - Use DYNAMIC transformers for runtime values
+    - Use STATIC transformers for constant values
+    - Consider the DTO type when applying transformations
+
+## Notes
+
+- All configurations are type-safe with TypeScript
+- Relations loading can be controlled at a granular level
+- Transformers can be applied at multiple stages of request/response handling
+- Validation can be both synchronous and asynchronous
+- Auto DTO configuration provides a simplified way to handle data transfer objects

package/dist/class/api/index.d.ts

@@ -1 +1 @@
-export * from "./base-service.class";
+export * from "./service-base.class";

package/dist/class/api/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./base-service.class"), exports);
+__exportStar(require("./service-base.class"), exports);
 //# sourceMappingURL=index.js.map

package/dist/class/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from \"./base-service.class\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from \"./service-base.class\";\n"]}

package/dist/class/api/service-base.class.d.ts

@@ -0,0 +1,11 @@
+import type { IApiGetListResponseResult } from "../../interface";
+import type { TApiFunctionGetManyProperties, TApiFunctionUpdateCriteria } from "../../type";
+import type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetProperties, TApiFunctionUpdateProperties } from "../../type";
+export declare class ApiServiceBase<E> {
+    create(properties: TApiFunctionCreateProperties<E>): Promise<E>;
+    delete(criteria: TApiFunctionDeleteCriteria<E>): Promise<void>;
+    get(properties: TApiFunctionGetProperties<E>): Promise<E>;
+    getList(properties: TApiFunctionGetListProperties<E>): Promise<IApiGetListResponseResult<E>>;
+    getMany(properties: TApiFunctionGetManyProperties<E>): Promise<Array<E>>;
+    update(criteria: TApiFunctionUpdateCriteria<E>, properties: TApiFunctionUpdateProperties<E>): Promise<E>;
+}

package/dist/class/api/{base-service.class.js → service-base.class.js}

@@ -1,31 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseApiService = void 0;
-class BaseApiService {
+exports.ApiServiceBase = void 0;
+class ApiServiceBase {
     create(properties) {
         void properties;
         return Promise.resolve({});
     }
-    delete(id) {
-        void id;
+    delete(criteria) {
+        void criteria;
         return Promise.resolve();
     }
-    get(id, properties, relations) {
-        void id;
+    get(properties) {
         void properties;
-        void relations;
         return Promise.resolve({});
     }
-    getList(properties, relations) {
+    getList(properties) {
         void properties;
-        void relations;
         return Promise.resolve({ items: [], total: 0 });
     }
-    update(id, properties) {
-        void id;
+    getMany(properties) {
+        void properties;
+        return Promise.resolve([]);
+    }
+    update(criteria, properties) {
+        void criteria;
         void properties;
         return Promise.resolve({});
     }
 }
-exports.BaseApiService = BaseApiService;
-//# sourceMappingURL=base-service.class.js.map
+exports.ApiServiceBase = ApiServiceBase;
+//# sourceMappingURL=service-base.class.js.map

package/dist/class/api/service-base.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-base.class.js","sourceRoot":"/","sources":["class/api/service-base.class.ts"],"names":[],"mappings":";;;AAKA,MAAa,cAAc;IAC1B,MAAM,CAAC,UAA2C;QACjD,KAAK,UAAU,CAAC;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,QAAuC;QAC7C,KAAK,QAAQ,CAAC;QAEd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,UAAwC;QAC3C,KAAK,UAAU,CAAC;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAO,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,UAA4C;QACnD,KAAK,UAAU,CAAC;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAA6C,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO,CAAC,UAA4C;QACnD,KAAK,UAAU,CAAC;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,QAAuC,EAAE,UAA2C;QAC1F,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAO,CAAC,CAAC;IACjC,CAAC;CACD;AArCD,wCAqCC","sourcesContent":["import type { IApiGetListResponseResult } from \"../../interface\";\nimport type { TApiFunctionGetManyProperties, TApiFunctionUpdateCriteria } from \"../../type\";\n\nimport type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetProperties, TApiFunctionUpdateProperties } from \"../../type\";\n\nexport class ApiServiceBase<E> {\n\tcreate(properties: TApiFunctionCreateProperties<E>): Promise<E> {\n\t\tvoid properties;\n\n\t\treturn Promise.resolve({} as E);\n\t}\n\n\tdelete(criteria: TApiFunctionDeleteCriteria<E>): Promise<void> {\n\t\tvoid criteria;\n\n\t\treturn Promise.resolve();\n\t}\n\n\tget(properties: TApiFunctionGetProperties<E>): Promise<E> {\n\t\tvoid properties;\n\n\t\treturn Promise.resolve({} as E);\n\t}\n\n\tgetList(properties: TApiFunctionGetListProperties<E>): Promise<IApiGetListResponseResult<E>> {\n\t\tvoid properties;\n\n\t\treturn Promise.resolve({ items: [], total: 0 } as unknown as IApiGetListResponseResult<E>);\n\t}\n\n\tgetMany(properties: TApiFunctionGetManyProperties<E>): Promise<Array<E>> {\n\t\tvoid properties;\n\n\t\treturn Promise.resolve([]);\n\t}\n\n\tupdate(criteria: TApiFunctionUpdateCriteria<E>, properties: TApiFunctionUpdateProperties<E>): Promise<E> {\n\t\tvoid criteria;\n\t\tvoid properties;\n\n\t\treturn Promise.resolve({} as E);\n\t}\n}\n"]}

package/dist/class/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./api";
 export * from "./metadata-storage.class";
+export * from "./utility";

package/dist/class/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./api"), exports);
 __exportStar(require("./metadata-storage.class"), exports);
+__exportStar(require("./utility"), exports);
 //# sourceMappingURL=index.js.map

package/dist/class/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2DAAyC","sourcesContent":["export * from \"./api\";\nexport * from \"./metadata-storage.class\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2DAAyC;AACzC,4CAA0B","sourcesContent":["export * from \"./api\";\nexport * from \"./metadata-storage.class\";\nexport * from \"./utility\";\n"]}

package/dist/class/metadata-storage.class.d.ts

@@ -1,8 +1,12 @@
+import type { IMetadataEntry } from "../interface";
+import type { TMetadata } from "../type";
 export declare class MetadataStorage {
     private static instance;
     private readonly STORAGE;
     static getInstance(): MetadataStorage;
-    getAllEntitiesMetadata(): Record<string, Record<string, any>>;
-    getMetadata(entityName: string, propertyName?: string, key?: string): any;
-    setMetadata(entityName: string, propertyName: string, key: string, value: unknown): void;
+    getAllEntitiesMetadata(): Record<string, TMetadata>;
+    getMetadata(entityName: string): TMetadata | undefined;
+    getMetadata(entityName: string, propertyName: string): IMetadataEntry | undefined;
+    getMetadata<K extends keyof IMetadataEntry>(entityName: string, propertyName: string, key: K): IMetadataEntry[K] | undefined;
+    setMetadata<K extends keyof IMetadataEntry>(entityName: string, propertyName: string, key: K, value: IMetadataEntry[K]): void;
 }

package/dist/class/metadata-storage.class.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataStorage = void 0;
+const constant_1 = require("../constant");
 class MetadataStorage {
     static instance;
     STORAGE = new Map();
@@ -36,9 +37,10 @@ class MetadataStorage {
         }
         const entityMetadata = this.STORAGE.get(entityName);
         if (!entityMetadata.has(propertyName)) {
-            entityMetadata.set(propertyName, {});
+            entityMetadata.set(propertyName, { [constant_1.PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_PROPERTY_NAME]: {} });
         }
-        entityMetadata.get(propertyName)[key] = value;
+        const propertyMetadata = entityMetadata.get(propertyName);
+        propertyMetadata[key] = value;
     }
 }
 exports.MetadataStorage = MetadataStorage;

package/dist/class/metadata-storage.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-storage.class.js","sourceRoot":"/","sources":["class/metadata-storage.class.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAe;IACnB,MAAM,CAAC,QAAQ,CAAkB;IAExB,OAAO,GAAkC,IAAI,GAAG,EAA4B,CAAC;IAEvF,MAAM,CAAC,WAAW;QACxB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC/B,eAAe,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,eAAe,CAAC,QAAQ,CAAC;IACjC,CAAC;IAEM,sBAAsB;QAC5B,MAAM,MAAM,GAAwC,EAAE,CAAC;QAEvD,KAAK,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACnE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAEM,WAAW,CAAC,UAAkB,EAAE,YAAqB,EAAE,GAAY;QACzE,MAAM,cAAc,GAAiC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElF,IAAI,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QAEtC,IAAI,CAAC,YAAY;YAAE,OAAO,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,gBAAgB,GAAY,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEnE,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAC;QAExC,IAAI,CAAC,GAAG;YAAE,OAAO,gBAAgB,CAAC;QAIlC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEM,WAAW,CAAC,UAAkB,EAAE,YAAoB,EAAE,GAAW,EAAE,KAAc;QACvF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,cAAc,GAAqB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QAEvE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACvC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/C,CAAC;CACD;AApDD,0CAoDC","sourcesContent":["export class MetadataStorage {\n\tprivate static instance: MetadataStorage;\n\n\tprivate readonly STORAGE: Map<string, Map<string, any>> = new Map<string, Map<string, any>>();\n\n\tpublic static getInstance(): MetadataStorage {\n\t\tif (!MetadataStorage.instance) {\n\t\t\tMetadataStorage.instance = new MetadataStorage();\n\t\t}\n\n\t\treturn MetadataStorage.instance;\n\t}\n\n\tpublic getAllEntitiesMetadata(): Record<string, Record<string, any>> {\n\t\tconst result: Record<string, Record<string, any>> = {};\n\n\t\tfor (const [entityName, entityMetadata] of this.STORAGE.entries()) {\n\t\t\tresult[entityName] = Object.fromEntries(entityMetadata);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tpublic getMetadata(entityName: string, propertyName?: string, key?: string): any {\n\t\tconst entityMetadata: Map<string, any> | undefined = this.STORAGE.get(entityName);\n\n\t\tif (!entityMetadata) return undefined;\n\n\t\tif (!propertyName) return Object.fromEntries(entityMetadata);\n\t\tconst propertyMetadata: unknown = entityMetadata.get(propertyName);\n\n\t\tif (!propertyMetadata) return undefined;\n\n\t\tif (!key) return propertyMetadata;\n\n\t\t// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n\t\t// @ts-expect-error\n\t\treturn propertyMetadata[key];\n\t}\n\n\tpublic setMetadata(entityName: string, propertyName: string, key: string, value: unknown): void {\n\t\tif (!this.STORAGE.has(entityName)) {\n\t\t\tthis.STORAGE.set(entityName, new Map());\n\t\t}\n\t\tconst entityMetadata: Map<string, any> = this.STORAGE.get(entityName)!;\n\n\t\tif (!entityMetadata.has(propertyName)) {\n\t\t\tentityMetadata.set(propertyName, {});\n\t\t}\n\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n\t\tentityMetadata.get(propertyName)[key] = value;\n\t}\n}\n"]}
+{"version":3,"file":"metadata-storage.class.js","sourceRoot":"/","sources":["class/metadata-storage.class.ts"],"names":[],"mappings":";;;AAAA,0CAAuE;AAMvE,MAAa,eAAe;IACnB,MAAM,CAAC,QAAQ,CAAkB;IAExB,OAAO,GAA6C,IAAI,GAAG,EAAuC,CAAC;IAE7G,MAAM,CAAC,WAAW;QACxB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC/B,eAAe,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,eAAe,CAAC,QAAQ,CAAC;IACjC,CAAC;IAEM,sBAAsB;QAC5B,MAAM,MAAM,GAA8B,EAAE,CAAC;QAE7C,KAAK,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACnE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAKM,WAAW,CAAC,UAAkB,EAAE,YAAqB,EAAE,GAA0B;QACvF,MAAM,cAAc,GAA4C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE7F,IAAI,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QAEtC,IAAI,CAAC,YAAY;YAAE,OAAO,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,gBAAgB,GAA+B,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEtF,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAC;QAExC,IAAI,CAAC,GAAG;YAAE,OAAO,gBAAgB,CAAC;QAElC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEM,WAAW,CAAiC,UAAkB,EAAE,YAAoB,EAAE,GAAM,EAAE,KAAwB;QAC5H,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,cAAc,GAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QAElF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACvC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,mDAAwC,CAAC,sBAAsB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,gBAAgB,GAAmB,cAAc,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC;QAC3E,gBAAgB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;CACD;AAtDD,0CAsDC","sourcesContent":["import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from \"../constant\";\n\nimport type { IMetadataEntry } from \"../interface\";\n\nimport type { TMetadata } from \"../type\";\n\nexport class MetadataStorage {\n\tprivate static instance: MetadataStorage;\n\n\tprivate readonly STORAGE: Map<string, Map<string, IMetadataEntry>> = new Map<string, Map<string, IMetadataEntry>>();\n\n\tpublic static getInstance(): MetadataStorage {\n\t\tif (!MetadataStorage.instance) {\n\t\t\tMetadataStorage.instance = new MetadataStorage();\n\t\t}\n\n\t\treturn MetadataStorage.instance;\n\t}\n\n\tpublic getAllEntitiesMetadata(): Record<string, TMetadata> {\n\t\tconst result: Record<string, TMetadata> = {};\n\n\t\tfor (const [entityName, entityMetadata] of this.STORAGE.entries()) {\n\t\t\tresult[entityName] = Object.fromEntries(entityMetadata);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tpublic getMetadata(entityName: string): TMetadata | undefined;\n\tpublic getMetadata(entityName: string, propertyName: string): IMetadataEntry | undefined;\n\tpublic getMetadata<K extends keyof IMetadataEntry>(entityName: string, propertyName: string, key: K): IMetadataEntry[K] | undefined;\n\tpublic getMetadata(entityName: string, propertyName?: string, key?: keyof IMetadataEntry): IMetadataEntry | IMetadataEntry[keyof IMetadataEntry] | TMetadata | undefined {\n\t\tconst entityMetadata: Map<string, IMetadataEntry> | undefined = this.STORAGE.get(entityName);\n\n\t\tif (!entityMetadata) return undefined;\n\n\t\tif (!propertyName) return Object.fromEntries(entityMetadata);\n\t\tconst propertyMetadata: IMetadataEntry | undefined = entityMetadata.get(propertyName);\n\n\t\tif (!propertyMetadata) return undefined;\n\n\t\tif (!key) return propertyMetadata;\n\n\t\treturn propertyMetadata[key];\n\t}\n\n\tpublic setMetadata<K extends keyof IMetadataEntry>(entityName: string, propertyName: string, key: K, value: IMetadataEntry[K]): void {\n\t\tif (!this.STORAGE.has(entityName)) {\n\t\t\tthis.STORAGE.set(entityName, new Map());\n\t\t}\n\t\tconst entityMetadata: Map<string, IMetadataEntry> = this.STORAGE.get(entityName)!;\n\n\t\tif (!entityMetadata.has(propertyName)) {\n\t\t\tentityMetadata.set(propertyName, { [PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_PROPERTY_NAME]: {} });\n\t\t}\n\n\t\tconst propertyMetadata: IMetadataEntry = entityMetadata.get(propertyName)!;\n\t\tpropertyMetadata[key] = value;\n\t}\n}\n"]}

package/dist/class/utility/dto/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./strategy";
+export * from "./property";

package/dist/{decorator/api/route → class/utility/dto}/index.js

@@ -14,6 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./get.decorator"), exports);
-__exportStar(require("./decorator"), exports);
+__exportStar(require("./strategy"), exports);
+__exportStar(require("./property"), exports);
 //# sourceMappingURL=index.js.map

package/dist/class/utility/dto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/utility/dto/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B","sourcesContent":["export * from \"./strategy\";\nexport * from \"./property\";\n"]}

package/dist/class/utility/dto/property/factory/boolean.class.d.ts

@@ -0,0 +1,5 @@
+import type { IApiEntity, IDtoGenerateFactory } from "../../../../../interface";
+import type { TApiPropertyDescribeBooleanProperties, TApiPropertyDescribeDtoProperties } from "../../../../../type";
+export declare class DtoPropertyFactoryBoolean<E> implements IDtoGenerateFactory<E> {
+    create(metadata: TApiPropertyDescribeBooleanProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator;
+}

package/dist/class/utility/dto/property/factory/boolean.class.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DtoPropertyFactoryBoolean = void 0;
+const decorator_1 = require("../../../../../decorator");
+class DtoPropertyFactoryBoolean {
+    create(metadata, entity, config) {
+        return (0, decorator_1.ApiPropertyBoolean)({
+            description: metadata.description,
+            entity,
+            ...config,
+        });
+    }
+}
+exports.DtoPropertyFactoryBoolean = DtoPropertyFactoryBoolean;
+//# sourceMappingURL=boolean.class.js.map

package/dist/class/utility/dto/property/factory/boolean.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.class.js","sourceRoot":"/","sources":["class/utility/dto/property/factory/boolean.class.ts"],"names":[],"mappings":";;;AAAA,wDAA8D;AAK9D,MAAa,yBAAyB;IACrC,MAAM,CAAC,QAA+C,EAAE,MAAqB,EAAE,MAAyC;QACvH,OAAO,IAAA,8BAAkB,EAAC;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,MAAM;YACN,GAAG,MAAM;SACT,CAAC,CAAC;IACJ,CAAC;CACD;AARD,8DAQC","sourcesContent":["import { ApiPropertyBoolean } from \"../../../../../decorator\";\n\nimport type { IApiEntity, IDtoGenerateFactory } from \"../../../../../interface\";\nimport type { TApiPropertyDescribeBooleanProperties, TApiPropertyDescribeDtoProperties } from \"../../../../../type\";\n\nexport class DtoPropertyFactoryBoolean<E> implements IDtoGenerateFactory<E> {\n\tcreate(metadata: TApiPropertyDescribeBooleanProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator {\n\t\treturn ApiPropertyBoolean({\n\t\t\tdescription: metadata.description,\n\t\t\tentity,\n\t\t\t...config,\n\t\t});\n\t}\n}\n"]}

package/dist/class/utility/dto/property/factory/date.class.d.ts

@@ -0,0 +1,5 @@
+import type { IApiEntity, IDtoGenerateFactory } from "../../../../../interface";
+import type { TApiPropertyDescribeDateProperties, TApiPropertyDescribeDtoProperties } from "../../../../../type";
+export declare class DtoPropertyFactoryDate<E> implements IDtoGenerateFactory<E> {
+    create(metadata: TApiPropertyDescribeDateProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator;
+}

package/dist/class/utility/dto/property/factory/date.class.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DtoPropertyFactoryDate = void 0;
+const decorator_1 = require("../../../../../decorator");
+class DtoPropertyFactoryDate {
+    create(metadata, entity, config) {
+        return (0, decorator_1.ApiPropertyDate)({
+            entity,
+            ...config,
+            type: metadata.dataType,
+        });
+    }
+}
+exports.DtoPropertyFactoryDate = DtoPropertyFactoryDate;
+//# sourceMappingURL=date.class.js.map

package/dist/class/utility/dto/property/factory/date.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.class.js","sourceRoot":"/","sources":["class/utility/dto/property/factory/date.class.ts"],"names":[],"mappings":";;;AAAA,wDAA2D;AAK3D,MAAa,sBAAsB;IAClC,MAAM,CAAC,QAA4C,EAAE,MAAqB,EAAE,MAAyC;QACpH,OAAO,IAAA,2BAAe,EAAC;YACtB,MAAM;YACN,GAAG,MAAM;YACT,IAAI,EAAE,QAAQ,CAAC,QAAQ;SACvB,CAAC,CAAC;IACJ,CAAC;CACD;AARD,wDAQC","sourcesContent":["import { ApiPropertyDate } from \"../../../../../decorator\";\n\nimport type { IApiEntity, IDtoGenerateFactory } from \"../../../../../interface\";\nimport type { TApiPropertyDescribeDateProperties, TApiPropertyDescribeDtoProperties } from \"../../../../../type\";\n\nexport class DtoPropertyFactoryDate<E> implements IDtoGenerateFactory<E> {\n\tcreate(metadata: TApiPropertyDescribeDateProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator {\n\t\treturn ApiPropertyDate({\n\t\t\tentity,\n\t\t\t...config,\n\t\t\ttype: metadata.dataType,\n\t\t});\n\t}\n}\n"]}

package/dist/class/utility/dto/property/factory/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./uuid.class";
+export * from "./string.class";
+export * from "./object.class";
+export * from "./number.class";
+export * from "./boolean.class";
+export * from "./date.class";

package/dist/{dto/exception → class/utility/dto/property/factory}/index.js

@@ -14,11 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./bad-request.dto"), exports);
-__exportStar(require("./forbidden.dto"), exports);
-__exportStar(require("./not-found.dto"), exports);
-__exportStar(require("./unauthorized.dto"), exports);
-__exportStar(require("./too-many-requests.dto"), exports);
-__exportStar(require("./internal-server-error.dto"), exports);
-__exportStar(require("./conflict.dto"), exports);
+__exportStar(require("./uuid.class"), exports);
+__exportStar(require("./string.class"), exports);
+__exportStar(require("./object.class"), exports);
+__exportStar(require("./number.class"), exports);
+__exportStar(require("./boolean.class"), exports);
+__exportStar(require("./date.class"), exports);
 //# sourceMappingURL=index.js.map

package/dist/class/utility/dto/property/factory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["class/utility/dto/property/factory/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,iDAA+B;AAC/B,iDAA+B;AAC/B,iDAA+B;AAC/B,kDAAgC;AAChC,+CAA6B","sourcesContent":["export * from \"./uuid.class\";\nexport * from \"./string.class\";\nexport * from \"./object.class\";\nexport * from \"./number.class\";\nexport * from \"./boolean.class\";\nexport * from \"./date.class\";\n"]}

package/dist/class/utility/dto/property/factory/number.class.d.ts

@@ -0,0 +1,5 @@
+import type { IApiEntity, IDtoGenerateFactory } from "src/interface";
+import type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeNumberProperties } from "src/type";
+export declare class DtoPropertyFactoryNumber<E> implements IDtoGenerateFactory<E> {
+    create(metadata: TApiPropertyDescribeNumberProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator;
+}

package/dist/class/utility/dto/property/factory/number.class.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DtoPropertyFactoryNumber = void 0;
+const decorator_1 = require("../../../../../decorator");
+class DtoPropertyFactoryNumber {
+    create(metadata, entity, config) {
+        return (0, decorator_1.ApiPropertyNumber)({
+            description: metadata.description,
+            entity,
+            ...config,
+            maximum: metadata.maximum,
+            minimum: metadata.minimum,
+            multipleOf: metadata.multipleOf,
+            type: metadata.dataType,
+        });
+    }
+}
+exports.DtoPropertyFactoryNumber = DtoPropertyFactoryNumber;
+//# sourceMappingURL=number.class.js.map

package/dist/class/utility/dto/property/factory/number.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.class.js","sourceRoot":"/","sources":["class/utility/dto/property/factory/number.class.ts"],"names":[],"mappings":";;;AAAA,wDAA6D;AAK7D,MAAa,wBAAwB;IACpC,MAAM,CAAC,QAA8C,EAAE,MAAqB,EAAE,MAAyC;QACtH,OAAO,IAAA,6BAAiB,EAAC;YACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,MAAM;YACN,GAAG,MAAM;YACT,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,QAAQ,CAAC,QAAQ;SACvB,CAAC,CAAC;IACJ,CAAC;CACD;AAZD,4DAYC","sourcesContent":["import { ApiPropertyNumber } from \"../../../../../decorator\";\n\nimport type { IApiEntity, IDtoGenerateFactory } from \"src/interface\";\nimport type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeNumberProperties } from \"src/type\";\n\nexport class DtoPropertyFactoryNumber<E> implements IDtoGenerateFactory<E> {\n\tcreate(metadata: TApiPropertyDescribeNumberProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator {\n\t\treturn ApiPropertyNumber({\n\t\t\tdescription: metadata.description,\n\t\t\tentity,\n\t\t\t...config,\n\t\t\tmaximum: metadata.maximum,\n\t\t\tminimum: metadata.minimum,\n\t\t\tmultipleOf: metadata.multipleOf,\n\t\t\ttype: metadata.dataType,\n\t\t});\n\t}\n}\n"]}

package/dist/class/utility/dto/property/factory/object.class.d.ts

@@ -0,0 +1,5 @@
+import type { IApiEntity, IDtoGenerateFactory } from "../../../../../interface";
+import type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeObjectProperties } from "../../../../../type";
+export declare class DtoPropertyFactoryObject<E> implements IDtoGenerateFactory<E> {
+    create(metadata: TApiPropertyDescribeObjectProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator;
+}

package/dist/class/utility/dto/property/factory/object.class.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DtoPropertyFactoryObject = void 0;
+const decorator_1 = require("../../../../../decorator");
+class DtoPropertyFactoryObject {
+    create(metadata, entity, config) {
+        return (0, decorator_1.ApiPropertyObject)({
+            entity,
+            ...config,
+            enum: metadata.enum,
+            ...metadata,
+            type: metadata.dataType,
+        });
+    }
+}
+exports.DtoPropertyFactoryObject = DtoPropertyFactoryObject;
+//# sourceMappingURL=object.class.js.map

package/dist/class/utility/dto/property/factory/object.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.class.js","sourceRoot":"/","sources":["class/utility/dto/property/factory/object.class.ts"],"names":[],"mappings":";;;AAAA,wDAA6D;AAK7D,MAAa,wBAAwB;IACpC,MAAM,CAAC,QAA8C,EAAE,MAAqB,EAAE,MAAyC;QACtH,OAAO,IAAA,6BAAiB,EAAC;YACxB,MAAM;YACN,GAAG,MAAM;YACT,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,GAAG,QAAQ;YACX,IAAI,EAAE,QAAQ,CAAC,QAAQ;SACvB,CAAC,CAAC;IACJ,CAAC;CACD;AAVD,4DAUC","sourcesContent":["import { ApiPropertyObject } from \"../../../../../decorator\";\n\nimport type { IApiEntity, IDtoGenerateFactory } from \"../../../../../interface\";\nimport type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeObjectProperties } from \"../../../../../type\";\n\nexport class DtoPropertyFactoryObject<E> implements IDtoGenerateFactory<E> {\n\tcreate(metadata: TApiPropertyDescribeObjectProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties): PropertyDecorator {\n\t\treturn ApiPropertyObject({\n\t\t\tentity,\n\t\t\t...config,\n\t\t\tenum: metadata.enum,\n\t\t\t...metadata,\n\t\t\ttype: metadata.dataType,\n\t\t});\n\t}\n}\n"]}