@elsikora/nestjs-typeorm-aws-connector 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ElsiKora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,213 @@
+<p align="center">
+  <h1 align="center">NestJS TypeORM AWS Connector</h1>
+</p>
+
+<p align="center">
+	<img src="https://img.shields.io/github/license/ElsiKora/NestJS-TypeORM-AWS-Connector?style=for-the-badge&logo=opensourceinitiative&logoColor=white&color=0080ff" alt="license">
+	<img src="https://img.shields.io/github/last-commit/ElsiKora/NestJS-TypeORM-AWS-Connector?style=for-the-badge&logo=git&logoColor=white&color=0080ff" alt="last-commit">
+	<img src="https://img.shields.io/github/languages/top/ElsiKora/NestJS-TypeORM-AWS-Connector?style=for-the-badge&color=0080ff" alt="repo-top-language">
+	<img src="https://img.shields.io/github/languages/count/ElsiKora/NestJS-TypeORM-AWS-Connector?style=for-the-badge&color=0080ff" alt="repo-language-count">
+</p>
+
+<p align="center">
+    <em>Developed with the software and tools below.</em>
+</p>
+
+<p align="center">
+    <a aria-label="ElsiKora logo" href="https://elsikora.com">
+        <img src="https://img.shields.io/badge/MADE%20BY%20ElsiKora-212121.svg?style=for-the-badge">
+    </a>
+	<img src="https://img.shields.io/badge/Prettier-F7B93E.svg?style=for-the-badge&logo=Prettier&logoColor=black" alt="Prettier">
+	<img src="https://img.shields.io/badge/ESLint-4B32C3.svg?style=for-the-badge&logo=ESLint&logoColor=white" alt="ESLint">
+	<img src="https://img.shields.io/badge/TypeScript-3178C6.svg?style=for-the-badge&logo=TypeScript&logoColor=white" alt="TypeScript">
+	<img src="https://img.shields.io/badge/NestJS-E0234E.svg?style=for-the-badge&logo=NestJS&logoColor=white" alt="NestJS">
+	<img src="https://img.shields.io/badge/TypeORM-FE0902.svg?style=for-the-badge&logo=TypeORM&logoColor=white" alt="TypeORM">
+</p>
+
+## Overview
+
+NestJS-TypeORM-AWS-Connector is a powerful integration module that provides seamless database connectivity for NestJS applications using TypeORM with AWS infrastructure. It supports automatic connection management, connection pooling, and rotation features specifically designed for AWS environments. The module simplifies database configuration and management while providing robust options for customization and optimization.
+
+## Features
+
+|    | Feature                | Description                                                                                                        |
+|----|------------------------|--------------------------------------------------------------------------------------------------------------------|
+| 🔄 | **Connection Rotation** | Automatic connection rotation to prevent stale connections and ensure optimal database performance                   |
+| 🏊 | **Connection Pooling**  | Configurable connection pool with customizable size and timeout settings                                            |
+| ⚡️ | **Performance**        | Optimized database connections with configurable timeouts and idle connection management                            |
+| 🔧 | **Easy Configuration** | Flexible configuration options through both static and async module registration                                     |
+| 🎯 | **Type Safety**        | Full TypeScript support with strong typing for all configuration options                                            |
+| 📊 | **Multiple Databases** | Support for different database types (PostgreSQL, MySQL, etc.) through EDatabaseType enum                           |
+| 🔍 | **Verbose Logging**    | Optional verbose mode for detailed logging of database operations                                                    |
+| 🔄 | **Auto-Sync Schema**   | Optional automatic schema synchronization with database                                                             |
+
+## Installation
+
+```bash
+npm install @elsikora/nestjs-typeorm-aws-connector
+```
+
+## Usage
+
+### Async Configuration
+
+```typescript
+import { DatabaseModule } from '@elsikora/nestjs-typeorm-aws-connector';
+import { EDatabaseType } from '@elsikora/nestjs-typeorm-aws-connector/dist/shared/enum/database/type.enum';
+
+@Module({
+  imports: [
+    DatabaseModule.registerAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: async () => ({
+        connectionTimeoutMs: 30_000,
+        databaseName: "app",
+        entities: [Bank],
+        idleTimeoutMs: 30_000,
+        isVerbose: true,
+        poolSize: 10,
+        port: 5432,
+        rotation: {
+          intervalMs: 5000,
+          isEnabled: true,
+        },
+        shouldSynchronize: true,
+        type: EDatabaseType.POSTGRES,
+      }),
+    }),
+  ]
+})
+export class AppModule {}
+```
+
+### Static Configuration
+
+```typescript
+import { DatabaseModule } from '@elsikora/nestjs-typeorm-aws-connector';
+import { EDatabaseType } from '@elsikora/nestjs-typeorm-aws-connector/dist/shared/enum/database/type.enum';
+
+@Module({
+  imports: [
+    DatabaseModule.register({
+      connectionTimeoutMs: 30_000,
+      databaseName: "app",
+      entities: [Bank],
+      idleTimeoutMs: 30_000,
+      isVerbose: true,
+      poolSize: 10,
+      port: 5432,
+      rotation: {
+        intervalMs: 5000,
+        isEnabled: true,
+      },
+      shouldSynchronize: true,
+      type: EDatabaseType.POSTGRES,
+    }),
+  ]
+})
+export class AppModule {}
+```
+
+### Integration with TypeORM
+
+```typescript
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { DatabaseService } from '@elsikora/nestjs-typeorm-aws-connector';
+
+@Module({
+  imports: [
+    TypeOrmModule.forRootAsync({
+      inject: [DatabaseService],
+      useFactory: async (databaseService: DatabaseService) => {
+        const options = await databaseService.getTypeOrmOptions();
+        return {
+          ...options,
+        };
+      },
+    }),
+  ]
+})
+export class AppModule {}
+```
+
+## Configuration Options
+
+| Option              | Type      | Required | Default | Description                                                    |
+|--------------------|-----------|----------|---------|----------------------------------------------------------------|
+| type               | EDatabaseType | Yes      | -       | Database type (POSTGRES, MYSQL, etc.)                          |
+| databaseName       | string    | Yes      | -       | Name of the database to connect to                             |
+| port               | number    | Yes      | -       | Database port number                                           |
+| entities           | Entity[]  | Yes      | -       | Array of entity classes to be loaded                           |
+| poolSize           | number    | No       | 10      | Maximum number of connections in the pool                      |
+| connectionTimeoutMs| number    | No       | 30000   | Connection timeout in milliseconds                             |
+| idleTimeoutMs      | number    | No       | 30000   | Idle connection timeout in milliseconds                        |
+| isVerbose          | boolean   | No       | false   | Enable verbose logging                                         |
+| shouldSynchronize  | boolean   | No       | false   | Automatically synchronize database schema                      |
+| rotation.isEnabled | boolean   | No       | false   | Enable connection rotation                                     |
+| rotation.intervalMs| number    | No       | 5000    | Connection rotation interval in milliseconds                   |
+
+## Database Types
+
+The module supports multiple database types through the `EDatabaseType` enum:
+
+```typescript
+enum EDatabaseType {
+  POSTGRES = 'postgres',
+  MYSQL = 'mysql',
+}
+```
+
+## Services
+
+### DatabaseService
+
+The `DatabaseService` provides methods for managing database connections and configurations:
+
+- `getTypeOrmOptions()`: Returns TypeORM configuration options
+- Other utility methods for connection management
+
+## Error Handling
+
+The module includes built-in error handling for common database connection issues:
+
+- Connection timeout handling
+- Pool overflow management
+- Rotation failures
+- Authentication errors
+
+## Best Practices
+
+1. **Connection Pooling**
+    - Set appropriate `poolSize` based on your application's needs
+    - Monitor pool usage in production
+
+2. **Connection Rotation**
+    - Enable rotation for long-running applications
+    - Adjust `rotation.intervalMs` based on your workload
+
+3. **Timeouts**
+    - Set reasonable `connectionTimeoutMs` and `idleTimeoutMs`
+    - Consider your application's specific requirements
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+For support, please open an issue in the GitHub repository or contact the maintainers directly.
+
+---
+
+Made with ♥ by [ElsiKora](https://elsikora.com)

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./modules/database";
+export * from "./shared/constant/database/constant";
+export type * from "./shared/interface/database/config.interface";
+export * from "./shared/provider/database/database.provider";
+export type * from "./shared/type/database/config-rotation.type";

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./modules/database"), exports);
+__exportStar(require("./shared/constant/database/constant"), exports);
+__exportStar(require("./shared/provider/database/database.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,sEAAoD;AAEpD,+EAA6D"}

package/dist/modules/database/database.module.d.ts

@@ -0,0 +1,7 @@
+import { DynamicModule } from "@nestjs/common";
+import { IDatabaseModuleAsyncOptions } from "../../shared/interface/database/module-async-options.interface";
+import { IDatabaseModuleOptions } from "../../shared/interface/database/module-options.interface";
+export declare class DatabaseModule {
+    static register(config: IDatabaseModuleOptions): DynamicModule;
+    static registerAsync(options: IDatabaseModuleAsyncOptions): Promise<DynamicModule>;
+}

package/dist/modules/database/database.module.js

@@ -0,0 +1,63 @@
+"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 DatabaseModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseModule = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const database_service_1 = require("./database.service");
+const rotator_service_1 = require("./rotator/rotator.service");
+const database_provider_1 = require("../../shared/provider/database/database.provider");
+let DatabaseModule = DatabaseModule_1 = class DatabaseModule {
+    static register(config) {
+        const providers = [
+            {
+                provide: database_provider_1.DATABASE_CONFIG_PROVIDER,
+                useValue: config,
+            },
+            database_service_1.DatabaseService,
+        ];
+        const isRotationEnabled = config.rotation?.isEnabled;
+        const imports = [];
+        if (isRotationEnabled) {
+            imports.push(schedule_1.ScheduleModule.forRoot());
+            providers.push({
+                provide: rotator_service_1.RotatorService,
+                useClass: rotator_service_1.RotatorService,
+            });
+        }
+        return {
+            module: DatabaseModule_1,
+            imports,
+            providers,
+            exports: [database_service_1.DatabaseService, ...(isRotationEnabled ? [rotator_service_1.RotatorService] : [])],
+        };
+    }
+    static async registerAsync(options) {
+        const providers = [(0, database_provider_1.createDatabaseConfigProvider)(options), database_service_1.DatabaseService];
+        const imports = [...(options.imports || [])];
+        const config = await options.useFactory(...(options.inject || []));
+        const isRotationEnabled = config.rotation?.isEnabled;
+        if (isRotationEnabled) {
+            imports.push(schedule_1.ScheduleModule.forRoot());
+            providers.push(rotator_service_1.RotatorService);
+        }
+        return {
+            module: DatabaseModule_1,
+            imports,
+            providers,
+            exports: [database_service_1.DatabaseService, ...(isRotationEnabled ? [rotator_service_1.RotatorService] : [])],
+        };
+    }
+};
+exports.DatabaseModule = DatabaseModule;
+exports.DatabaseModule = DatabaseModule = DatabaseModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], DatabaseModule);
+//# sourceMappingURL=database.module.js.map

package/dist/modules/database/database.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.module.js","sourceRoot":"","sources":["../../../src/modules/database/database.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,+CAAkD;AAElD,yDAAqE;AACrE,+DAA2E;AAC3E,wFAAqH;AAK9G,IAAM,cAAc,sBAApB,MAAM,cAAc;IAC1B,MAAM,CAAC,QAAQ,CAAC,MAA8B;QAC7C,MAAM,SAAS,GAAoB;YAClC;gBACC,OAAO,EAAE,4CAAwB;gBACjC,QAAQ,EAAE,MAAM;aAChB;YACD,kCAAe;SACf,CAAC;QAEF,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;QACrD,MAAM,OAAO,GAAe,EAAE,CAAC;QAE/B,IAAI,iBAAiB,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,yBAAc,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,SAAS,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,gCAAc;gBACvB,QAAQ,EAAE,gCAAc;aACxB,CAAC,CAAC;QACJ,CAAC;QAED,OAAO;YACN,MAAM,EAAE,gBAAc;YACtB,OAAO;YACP,SAAS;YACT,OAAO,EAAE,CAAC,kCAAe,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,gCAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC1E,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAoC;QAC9D,MAAM,SAAS,GAAG,CAAC,IAAA,gDAA4B,EAAC,OAAO,CAAC,EAAE,kCAAe,CAAC,CAAC;QAE3E,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;QAErD,IAAI,iBAAiB,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,yBAAc,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,SAAS,CAAC,IAAI,CAAC,gCAAc,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;YACN,MAAM,EAAE,gBAAc;YACtB,OAAO;YACP,SAAS;YACT,OAAO,EAAE,CAAC,kCAAe,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,gCAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC1E,CAAC;IACH,CAAC;CACD,CAAA;AAjDY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAiD1B"}

package/dist/modules/database/database.service.d.ts

@@ -0,0 +1,28 @@
+import { ConfigService } from "@nestjs/config";
+import { ParameterStoreConfigService } from "@elsikora/nestjs-aws-parameter-store-config";
+import { IDatabaseConfig } from "../../shared/interface/database/config.interface";
+import { IAwsSecretsManagerItem } from "../../shared/interface/aws/secrets-manager/item.interface";
+export declare class DatabaseService {
+    private readonly configService;
+    private readonly parameterStoreConfigService;
+    private readonly databaseConfig;
+    private readonly logger;
+    constructor(configService: ConfigService, parameterStoreConfigService: ParameterStoreConfigService, databaseConfig: IDatabaseConfig);
+    getCredentials(): Promise<IAwsSecretsManagerItem>;
+    getTypeOrmOptions(): Promise<{
+        type: any;
+        host: string;
+        port: number;
+        username: string;
+        password: string;
+        database: string;
+        logging: boolean;
+        synchronize: boolean;
+        extra: {
+            connectionTimeoutMillis: number;
+            idleTimeoutMillis: number;
+            max: number;
+        };
+        entities: import("typeorm").MixedList<string | Function | import("typeorm").EntitySchema<any>>;
+    }>;
+}

package/dist/modules/database/database.service.js

@@ -0,0 +1,72 @@
+"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); }
+};
+var DatabaseService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const nestjs_aws_parameter_store_config_1 = require("@elsikora/nestjs-aws-parameter-store-config");
+const client_secrets_manager_1 = require("@aws-sdk/client-secrets-manager");
+const database_provider_1 = require("../../shared/provider/database/database.provider");
+let DatabaseService = DatabaseService_1 = class DatabaseService {
+    constructor(configService, parameterStoreConfigService, databaseConfig) {
+        this.configService = configService;
+        this.parameterStoreConfigService = parameterStoreConfigService;
+        this.databaseConfig = databaseConfig;
+        this.logger = new common_1.Logger(DatabaseService_1.name);
+    }
+    async getCredentials() {
+        this.logger.debug("Asking credentials from AWS Secrets Manager...");
+        const region = this.configService.get("AWS_REGION");
+        const client = new client_secrets_manager_1.SecretsManagerClient({ region });
+        const secretId = this.parameterStoreConfigService.get(`/${this.configService.get("APPLICATION")}/elastic-beanstalk/${this.configService.get("APPLICATION")}-reaper-api/aws-secrets-manager/database-credentials-secret-id`);
+        console.log("SECRETID", secretId, `/${this.configService.get("APPLICATION")}/elastic-beanstalk/${this.configService.get("APPLICATION")}-reaper-api/aws-secrets-manager/database-credentials-secret-id`);
+        const response = await client.send(new client_secrets_manager_1.GetSecretValueCommand({
+            SecretId: secretId,
+            VersionStage: "AWSCURRENT",
+        }));
+        this.logger.debug("Secrets was successfully loaded");
+        return JSON.parse(response.SecretString ?? "{}");
+    }
+    async getTypeOrmOptions() {
+        const credentials = await this.getCredentials();
+        const host = this.parameterStoreConfigService.get(`/${this.configService.get("APPLICATION")}/elastic-beanstalk/${this.configService.get("APPLICATION")}-reaper-api/aws-rds/host`);
+        const options = {
+            type: this.databaseConfig.type,
+            host,
+            port: this.databaseConfig.port,
+            username: credentials.username,
+            password: credentials.password,
+            database: this.databaseConfig.databaseName,
+            logging: this.databaseConfig.isVerbose || false,
+            synchronize: this.databaseConfig.shouldSynchronize || false,
+            extra: {
+                connectionTimeoutMillis: this.databaseConfig.connectionTimeoutMs || 30000,
+                idleTimeoutMillis: this.databaseConfig.idleTimeoutMs || 30000,
+                max: this.databaseConfig.poolSize || 10,
+            },
+            entities: this.databaseConfig.entities,
+        };
+        this.logger.debug(`TypeORM options сформированы: ${JSON.stringify(options)}`);
+        return options;
+    }
+};
+exports.DatabaseService = DatabaseService;
+exports.DatabaseService = DatabaseService = DatabaseService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)(database_provider_1.DATABASE_CONFIG_PROVIDER)),
+    __metadata("design:paramtypes", [config_1.ConfigService,
+        nestjs_aws_parameter_store_config_1.ParameterStoreConfigService, Object])
+], DatabaseService);
+//# sourceMappingURL=database.service.js.map

package/dist/modules/database/database.service.js.map

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

package/dist/modules/database/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./database.module";
+export * from "./database.service";
+export * from "./rotator/rotator.service";

package/dist/modules/database/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./database.module"), exports);
+__exportStar(require("./database.service"), exports);
+__exportStar(require("./rotator/rotator.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/modules/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/database/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,qDAAmC;AACnC,4DAA0C"}

package/dist/modules/database/rotator/rotator.service.d.ts

@@ -0,0 +1,13 @@
+import { OnModuleInit } from "@nestjs/common";
+import { SchedulerRegistry } from "@nestjs/schedule";
+import { DataSource } from "typeorm";
+import { IDatabaseConfig } from "../../../shared/interface/database/config.interface";
+export declare class RotatorService implements OnModuleInit {
+    private readonly dataSource;
+    private readonly databaseConfig;
+    private readonly schedulerRegistry;
+    private readonly logger;
+    constructor(dataSource: DataSource, databaseConfig: IDatabaseConfig, schedulerRegistry: SchedulerRegistry);
+    onModuleInit(): void;
+    rotateDatabaseConnection(): Promise<void>;
+}

package/dist/modules/database/rotator/rotator.service.js

@@ -0,0 +1,61 @@
+"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); }
+};
+var RotatorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RotatorService = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const typeorm_1 = require("typeorm");
+const database_provider_1 = require("../../../shared/provider/database/database.provider");
+let RotatorService = RotatorService_1 = class RotatorService {
+    constructor(dataSource, databaseConfig, schedulerRegistry) {
+        this.dataSource = dataSource;
+        this.databaseConfig = databaseConfig;
+        this.schedulerRegistry = schedulerRegistry;
+        this.logger = new common_1.Logger(RotatorService_1.name);
+    }
+    onModuleInit() {
+        if (this.databaseConfig.rotation?.isEnabled) {
+            const intervalMs = this.databaseConfig.rotation.intervalMs;
+            const interval = setInterval(() => {
+                this.rotateDatabaseConnection();
+            }, intervalMs);
+            this.schedulerRegistry.addInterval("db-rotation", interval);
+            this.logger.log(`DB credentials rotation interval started: ${intervalMs} мс`);
+        }
+    }
+    async rotateDatabaseConnection() {
+        this.logger.log("Launching DB credentials rotation interval...");
+        const currentOptions = this.dataSource.options;
+        if (this.dataSource.isInitialized) {
+            await this.dataSource.destroy();
+        }
+        const newOptions = { ...currentOptions };
+        const newDataSource = new typeorm_1.DataSource(newOptions);
+        await newDataSource.initialize();
+        this.dataSource.subscribers.forEach((subscriber) => {
+            newDataSource.subscribers.push(subscriber);
+        });
+        this.dataSource.setOptions(newOptions);
+        this.dataSource.driver = newDataSource.driver;
+        this.logger.log("Rotation completed!");
+    }
+};
+exports.RotatorService = RotatorService;
+exports.RotatorService = RotatorService = RotatorService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(database_provider_1.DATABASE_CONFIG_PROVIDER)),
+    __metadata("design:paramtypes", [typeorm_1.DataSource, Object, schedule_1.SchedulerRegistry])
+], RotatorService);
+//# sourceMappingURL=rotator.service.js.map

package/dist/modules/database/rotator/rotator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotator.service.js","sourceRoot":"","sources":["../../../../src/modules/database/rotator/rotator.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA0E;AAC1E,+CAAqD;AACrD,qCAAmF;AAEnF,2FAAuF;AAGhF,IAAM,cAAc,sBAApB,MAAM,cAAc;IAG1B,YACkB,UAAsB,EAEvC,cAAgD,EAC/B,iBAAoC;QAHpC,eAAU,GAAV,UAAU,CAAY;QAEtB,mBAAc,GAAd,cAAc,CAAiB;QAC/B,sBAAiB,GAAjB,iBAAiB,CAAmB;QANrC,WAAM,GAAG,IAAI,eAAM,CAAC,gBAAc,CAAC,IAAI,CAAC,CAAC;IAOvD,CAAC;IAEJ,YAAY;QACX,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;YAE3D,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;gBACjC,IAAI,CAAC,wBAAwB,EAAE,CAAC;YACjC,CAAC,EAAE,UAAU,CAAC,CAAC;YAEf,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,6CAA6C,UAAU,KAAK,CAAC,CAAC;QAC/E,CAAC;IACF,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAEjE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAE/C,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,UAAU,GAAsB,EAAE,GAAG,cAAc,EAAE,CAAC;QAC5D,MAAM,aAAa,GAAG,IAAI,oBAAU,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC;QAEjC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAqC,EAAE,EAAE;YAC7E,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,UAAkB,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAEvD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACxC,CAAC;CACD,CAAA;AA7CY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAMV,WAAA,IAAA,eAAM,EAAC,4CAAwB,CAAC,CAAA;qCADJ,oBAAU,UAGH,4BAAiB;GAP1C,cAAc,CA6C1B"}

package/dist/shared/constant/database/constant.d.ts

@@ -0,0 +1,15 @@
+declare const CONFIG_CONSTANT: {
+    readonly DATABASE_CONNECTION_ROTAION_INTERVAL: number;
+    readonly DB_CONNECTION_TIMEOUT: number;
+    readonly DB_DATABASE_NAME: string;
+    readonly DB_IDLE_TIMEOUT: number;
+    readonly DB_LOGGING: boolean;
+    readonly DB_POOL_SIZE: number;
+    readonly DB_PORT: number;
+    readonly DB_RECONNECT_TIMEOUT: number;
+    readonly DB_RELATION_LOAD_STRATEGY: "join" | "query" | undefined;
+    readonly DB_SYNCHRONIZE: boolean;
+    readonly DB_TYPE: "postgres";
+    readonly SWAGGER_SAVE_SPACES: number;
+};
+export default CONFIG_CONSTANT;

package/dist/shared/constant/database/constant.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const SWAGGER_SAVE_SPACES = 2;
+const DB_CONNECTION_TIMEOUT = 30_000;
+const DB_IDLE_TIMEOUT = 30_000;
+const DB_RECONNECT_TIMEOUT = 3000;
+const DB_POOL_SIZE = 10;
+const DB_PORT = 5432;
+const DB_RELATION_LOAD_STRATEGY = "query";
+const DB_SYNCHRONIZE = false;
+const DB_TYPE = "postgres";
+const DB_LOGGING = false;
+const DB_DATABASE_NAME = "my_default_database";
+const DATABASE_CONNECTION_ROTAION_INTERVAL = 1000 * 60 * 60; // 1 hour in milliseconds
+const CONFIG_CONSTANT = {
+    DATABASE_CONNECTION_ROTAION_INTERVAL,
+    DB_CONNECTION_TIMEOUT,
+    DB_DATABASE_NAME,
+    DB_IDLE_TIMEOUT,
+    DB_LOGGING,
+    DB_POOL_SIZE,
+    DB_PORT,
+    DB_RECONNECT_TIMEOUT,
+    DB_RELATION_LOAD_STRATEGY,
+    DB_SYNCHRONIZE,
+    DB_TYPE,
+    SWAGGER_SAVE_SPACES,
+};
+exports.default = CONFIG_CONSTANT;
+//# sourceMappingURL=constant.js.map

package/dist/shared/constant/database/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../../../src/shared/constant/database/constant.ts"],"names":[],"mappings":";;AAAA,MAAM,mBAAmB,GAAW,CAAC,CAAC;AACtC,MAAM,qBAAqB,GAAW,MAAM,CAAC;AAC7C,MAAM,eAAe,GAAW,MAAM,CAAC;AACvC,MAAM,oBAAoB,GAAW,IAAI,CAAC;AAC1C,MAAM,YAAY,GAAW,EAAE,CAAC;AAChC,MAAM,OAAO,GAAW,IAAI,CAAC;AAC7B,MAAM,yBAAyB,GAAiC,OAAO,CAAC;AACxE,MAAM,cAAc,GAAY,KAAK,CAAC;AACtC,MAAM,OAAO,GAAyB,UAAU,CAAC;AACjD,MAAM,UAAU,GAAY,KAAK,CAAC;AAClC,MAAM,gBAAgB,GAAW,qBAAqB,CAAC;AACvD,MAAM,oCAAoC,GAAW,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,yBAAyB;AAE9F,MAAM,eAAe,GAajB;IACH,oCAAoC;IACpC,qBAAqB;IACrB,gBAAgB;IAChB,eAAe;IACf,UAAU;IACV,YAAY;IACZ,OAAO;IACP,oBAAoB;IACpB,yBAAyB;IACzB,cAAc;IACd,OAAO;IACP,mBAAmB;CACV,CAAC;AAEX,kBAAe,eAAe,CAAC"}

package/dist/shared/enum/database/type.enum.d.ts

@@ -0,0 +1,4 @@
+export declare enum EDatabaseType {
+    MYSQL = "mysql",
+    POSTGRES = "postgres"
+}

package/dist/shared/enum/database/type.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDatabaseType = void 0;
+var EDatabaseType;
+(function (EDatabaseType) {
+    EDatabaseType["MYSQL"] = "mysql";
+    EDatabaseType["POSTGRES"] = "postgres";
+})(EDatabaseType || (exports.EDatabaseType = EDatabaseType = {}));
+//# sourceMappingURL=type.enum.js.map

package/dist/shared/enum/database/type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.enum.js","sourceRoot":"","sources":["../../../../src/shared/enum/database/type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAGX;AAHD,WAAY,aAAa;IACxB,gCAAe,CAAA;IACf,sCAAqB,CAAA;AACtB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB"}

package/dist/shared/interface/aws/secrets-manager/item.interface.d.ts

@@ -0,0 +1,4 @@
+export interface IAwsSecretsManagerItem {
+    username: string;
+    password: string;
+}