@elsikora/nestjs-crud-config 1.0.1 → 1.1.0-dev.2

package/dist/esm/modules/config/migration/entity/entity.js

@@ -0,0 +1,137 @@
+import { ApiPropertyDescribe, EApiPropertyDescribeType, EApiPropertyDateIdentifier, EApiPropertyDateType, EApiPropertyStringType } from '@elsikora/nestjs-crud-automator';
+import { API_PROPERTY_CONSTANT } from '../../../../shared/constant/api-property.constant.js';
+import { CONFIG_MIGRATION_CONSTANT } from '../../../../shared/constant/config/migration.constant.js';
+import { createDynamicEntityClass } from '../../../../shared/utility/create-dynamic/entity.utility.js';
+import '../../../../external/tslib/tslib.es6.js';
+import '@nestjs/common';
+import '@nestjs/typeorm';
+import { UpdateDateColumn, CreateDateColumn } from 'typeorm';
+import '../../../../shared/utility/crypto.utility.js';
+import '../../../../shared/utility/logger.utility.js';
+
+/**
+ * Creates a dynamic ConfigMigration entity with TypeORM decorators
+ * @param {object} options - Configuration options for the entity
+ * @param {number} options.maxNameLength - Maximum length for migration name field
+ * @param {string} options.tableName - Name of the database table
+ * @returns {TDynamicEntity} Dynamically created ConfigMigration entity class
+ */
+function createConfigMigrationEntity(options) {
+    return createDynamicEntityClass({
+        columns: {
+            createdAt: {
+                default: () => "CURRENT_TIMESTAMP",
+                nullable: false,
+                type: "timestamp",
+            },
+            executedAt: {
+                nullable: true,
+                type: "timestamp",
+            },
+            failedAt: {
+                nullable: true,
+                type: "timestamp",
+            },
+            name: {
+                length: options.maxNameLength,
+                nullable: false,
+                type: "varchar",
+            },
+            startedAt: {
+                nullable: true,
+                type: "timestamp",
+            },
+            status: {
+                default: "PENDING",
+                enum: ["PENDING", "RUNNING", "COMPLETED", "FAILED", "STUCK"],
+                nullable: false,
+                type: "enum",
+            },
+            updatedAt: {
+                default: () => "CURRENT_TIMESTAMP",
+                nullable: false,
+                type: "timestamp",
+            },
+        },
+        decorators: {
+            createdAt: [
+                CreateDateColumn(),
+                ApiPropertyDescribe({
+                    format: EApiPropertyDateType.DATE_TIME,
+                    identifier: EApiPropertyDateIdentifier.CREATED_AT,
+                    type: EApiPropertyDescribeType.DATE,
+                }),
+            ],
+            executedAt: [
+                ApiPropertyDescribe({
+                    format: EApiPropertyDateType.DATE_TIME,
+                    identifier: EApiPropertyDateIdentifier.CREATED_AT,
+                    isNullable: true,
+                    type: EApiPropertyDescribeType.DATE,
+                }),
+            ],
+            failedAt: [
+                ApiPropertyDescribe({
+                    format: EApiPropertyDateType.DATE_TIME,
+                    identifier: EApiPropertyDateIdentifier.CREATED_AT,
+                    isNullable: true,
+                    type: EApiPropertyDescribeType.DATE,
+                }),
+            ],
+            id: [
+                ApiPropertyDescribe({
+                    type: EApiPropertyDescribeType.UUID,
+                }),
+            ],
+            name: [
+                ApiPropertyDescribe({
+                    description: "Migration name",
+                    exampleValue: "001_initial_config_setup",
+                    format: EApiPropertyStringType.STRING,
+                    maxLength: options.maxNameLength,
+                    minLength: API_PROPERTY_CONSTANT.MIN_NAME_LENGTH,
+                    pattern: `/^[A-Za-z0-9_-]{1,${options.maxNameLength}}/`,
+                    type: EApiPropertyDescribeType.STRING,
+                }),
+            ],
+            startedAt: [
+                ApiPropertyDescribe({
+                    format: EApiPropertyDateType.DATE_TIME,
+                    identifier: EApiPropertyDateIdentifier.CREATED_AT,
+                    isNullable: true,
+                    type: EApiPropertyDescribeType.DATE,
+                }),
+            ],
+            status: [
+                ApiPropertyDescribe({
+                    description: "Migration execution status",
+                    exampleValue: "COMPLETED",
+                    format: EApiPropertyStringType.STRING,
+                    maxLength: CONFIG_MIGRATION_CONSTANT.MAX_STATUS_LENGTH,
+                    minLength: API_PROPERTY_CONSTANT.MIN_NAME_LENGTH,
+                    pattern: `/^[A-Z_]{1,${CONFIG_MIGRATION_CONSTANT.MAX_STATUS_LENGTH}}/`,
+                    type: EApiPropertyDescribeType.STRING,
+                }),
+            ],
+            updatedAt: [
+                UpdateDateColumn(),
+                ApiPropertyDescribe({
+                    format: EApiPropertyDateType.DATE_TIME,
+                    identifier: EApiPropertyDateIdentifier.UPDATED_AT,
+                    type: EApiPropertyDescribeType.DATE,
+                }),
+            ],
+        },
+        indexes: [
+            { columns: ["status"], name: "idx_config_migration_status" },
+            { columns: ["startedAt"], name: "idx_config_migration_started_at" },
+            { columns: ["createdAt"], name: "idx_config_migration_created_at" },
+        ],
+        name: "ConfigMigration",
+        tableName: options.tableName,
+        uniques: [["name"]],
+    });
+}
+
+export { createConfigMigrationEntity };
+//# sourceMappingURL=entity.js.map

package/dist/esm/modules/config/migration/entity/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sources":["../../../../../../../src/modules/config/migration/entity/entity.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/modules/config/migration/entity/index.d.ts

@@ -0,0 +1 @@
+export { createConfigMigrationEntity } from './entity';

package/dist/esm/modules/config/migration/enum/index.d.ts

@@ -0,0 +1 @@
+export { EConfigMigrationStatus } from './status';

package/dist/esm/modules/config/migration/enum/status.d.ts

@@ -0,0 +1,7 @@
+export declare enum EConfigMigrationStatus {
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    PENDING = "PENDING",
+    RUNNING = "RUNNING",
+    STUCK = "STUCK"
+}

package/dist/esm/modules/config/migration/enum/status.js

@@ -0,0 +1,11 @@
+var EConfigMigrationStatus;
+(function (EConfigMigrationStatus) {
+    EConfigMigrationStatus["COMPLETED"] = "COMPLETED";
+    EConfigMigrationStatus["FAILED"] = "FAILED";
+    EConfigMigrationStatus["PENDING"] = "PENDING";
+    EConfigMigrationStatus["RUNNING"] = "RUNNING";
+    EConfigMigrationStatus["STUCK"] = "STUCK";
+})(EConfigMigrationStatus || (EConfigMigrationStatus = {}));
+
+export { EConfigMigrationStatus };
+//# sourceMappingURL=status.js.map

package/dist/esm/modules/config/migration/enum/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sources":["../../../../../../../src/modules/config/migration/enum/status.ts"],"sourcesContent":[null],"names":[],"mappings":"IAAY;AAAZ,CAAA,UAAY,sBAAsB,EAAA;AACjC,IAAA,sBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,sBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,sBAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,sBAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,sBAAA,CAAA,OAAA,CAAA,GAAA,OAAe;AAChB,CAAC,EANW,sBAAsB,KAAtB,sBAAsB,GAAA,EAAA,CAAA,CAAA;;;;"}

package/dist/esm/modules/config/migration/index.d.ts

@@ -0,0 +1,5 @@
+export * from './entity/index';
+export * from './enum/index';
+export type * from './interface/index';
+export { ConfigMigrationRunnerService } from './migration-runner.service';
+export { ConfigMigrationService } from './migration.service';

package/dist/esm/modules/config/migration/interface/index.d.ts

@@ -0,0 +1,3 @@
+export type { IConfigMigration } from './interface';
+export type { IConfigMigrationDefinition } from './migration-definition.interface';
+export type { IConfigMigrationOptions } from './migration-options.interface';

package/dist/esm/modules/config/migration/interface/interface.d.ts

@@ -0,0 +1,11 @@
+import type { EConfigMigrationStatus } from '../enum/index';
+export interface IConfigMigration {
+    createdAt: Date;
+    executedAt?: Date;
+    failedAt?: Date;
+    id: string;
+    name: string;
+    startedAt?: Date;
+    status: EConfigMigrationStatus;
+    updatedAt: Date;
+}

package/dist/esm/modules/config/migration/interface/migration-definition.interface.d.ts

@@ -0,0 +1,29 @@
+import type { CrudConfigService } from '../../config.service';
+import type { EntityManager } from "typeorm";
+/**
+ * Interface for defining a migration
+ */
+export interface IConfigMigrationDefinition {
+    /**
+     * Description of what this migration does
+     */
+    description?: string;
+    /**
+     * Optional rollback function (for future use)
+     * @param {CrudConfigService} configService - The config service for managing configurations
+     * @param {EntityManager} [entityManager] - Optional entity manager for transactions
+     * @returns {Promise<void>} Promise that resolves when rollback is complete
+     */
+    down?: (configService: CrudConfigService, entityManager?: EntityManager) => Promise<void>;
+    /**
+     * Unique name of the migration (should be sortable, e.g., "001_initial_config")
+     */
+    name: string;
+    /**
+     * The migration function that will be executed
+     * @param {CrudConfigService} configService - The config service for managing configurations
+     * @param {EntityManager} [entityManager] - Optional entity manager for transactions
+     * @returns {Promise<void>} Promise that resolves when migration is complete
+     */
+    up: (configService: CrudConfigService, entityManager?: EntityManager) => Promise<void>;
+}

package/dist/esm/modules/config/migration/interface/migration-options.interface.d.ts

@@ -0,0 +1,34 @@
+import type { IConfigMigrationDefinition } from './migration-definition.interface';
+/**
+ * Interface for migration configuration options
+ */
+export interface IConfigMigrationOptions {
+    /**
+     * Whether migrations are enabled
+     */
+    isEnabled?: boolean;
+    /**
+     * Maximum length for migration name field
+     */
+    maxNameLength?: number;
+    /**
+     * Array of migration definitions to execute
+     */
+    migrations?: Array<IConfigMigrationDefinition>;
+    /**
+     * Whether to run migrations automatically on application startup
+     */
+    shouldRunOnStartup?: boolean;
+    /**
+     * Timeout in minutes for stuck migration cleanup (default: 30)
+     */
+    stuckMigrationTimeoutMinutes?: number;
+    /**
+     * Table name for storing migration history
+     */
+    tableName?: string;
+    /**
+     * Whether to run migrations in transaction
+     */
+    useTransaction?: boolean;
+}

package/dist/esm/modules/config/migration/migration-runner.service.d.ts

@@ -0,0 +1,22 @@
+import type { IConfigOptions } from '../../../shared/interface/config/index';
+import { OnApplicationBootstrap } from "@nestjs/common";
+import { ConfigMigrationService } from './migration.service';
+/**
+ * Service that runs migrations on application startup
+ */
+export declare class ConfigMigrationRunnerService implements OnApplicationBootstrap {
+    private readonly migrationService;
+    private readonly options;
+    private readonly LOGGER;
+    constructor(migrationService: ConfigMigrationService, options: IConfigOptions);
+    /**
+     * Called when the application is fully bootstrapped
+     * Runs migrations if enabled and configured to run on startup
+     */
+    onApplicationBootstrap(): Promise<void>;
+    /**
+     * Manually run migrations (for testing or manual execution)
+     * @returns {Promise<void>} Promise that resolves when migrations are complete
+     */
+    runMigrations(): Promise<void>;
+}

package/dist/esm/modules/config/migration/migration-runner.service.js

@@ -0,0 +1,85 @@
+import { __decorate, __param, __metadata } from '../../../external/tslib/tslib.es6.js';
+import { Injectable, Inject } from '@nestjs/common';
+import { CONFIG_MIGRATION_CONSTANT } from '../../../shared/constant/config/migration.constant.js';
+import { TOKEN_CONSTANT } from '../../../shared/constant/token.constant.js';
+import 'typeorm';
+import '@elsikora/nestjs-crud-automator';
+import '@nestjs/typeorm';
+import '../../../shared/utility/crypto.utility.js';
+import { LoggerUtility } from '../../../shared/utility/logger.utility.js';
+import { EConfigMigrationStatus } from './enum/status.js';
+import { ConfigMigrationService } from './migration.service.js';
+
+/**
+ * Service that runs migrations on application startup
+ */
+let ConfigMigrationRunnerService = class ConfigMigrationRunnerService {
+    migrationService;
+    options;
+    LOGGER = LoggerUtility.getLogger("ConfigMigrationRunnerService");
+    constructor(migrationService, options) {
+        this.migrationService = migrationService;
+        this.options = options;
+    }
+    /**
+     * Called when the application is fully bootstrapped
+     * Runs migrations if enabled and configured to run on startup
+     */
+    async onApplicationBootstrap() {
+        const migrationOptions = this.options.migrationOptions;
+        if (!migrationOptions?.isEnabled) {
+            this.LOGGER.verbose("Migrations are disabled");
+            return;
+        }
+        if (!migrationOptions.shouldRunOnStartup) {
+            this.LOGGER.verbose("Migrations configured to not run on startup");
+            return;
+        }
+        if (!migrationOptions.migrations || migrationOptions.migrations.length === 0) {
+            this.LOGGER.verbose("No migrations configured");
+            return;
+        }
+        try {
+            this.LOGGER.verbose("Starting migration runner");
+            // Check for failed and stuck migrations from previous runs
+            const allMigrations = await this.migrationService.getExecutedMigrations();
+            const failedMigrations = allMigrations.filter((m) => m.status === EConfigMigrationStatus.FAILED);
+            if (failedMigrations.length > 0) {
+                this.LOGGER.warn(`Found ${failedMigrations.length} failed migration(s) from previous runs: ${failedMigrations.map((m) => m.name).join(", ")}`);
+                this.LOGGER.warn("Consider reviewing and cleaning up failed migrations before proceeding");
+            }
+            // Clean up stuck migrations with configured timeout
+            const timeoutMinutes = migrationOptions.stuckMigrationTimeoutMinutes ??
+                CONFIG_MIGRATION_CONSTANT.DEFAULT_STUCK_MIGRATION_TIMEOUT_MINUTES;
+            await this.migrationService.cleanupStuckMigrations(timeoutMinutes);
+            await this.migrationService.executeMigrations(migrationOptions.migrations, migrationOptions.useTransaction ?? true);
+            this.LOGGER.verbose("Migration runner completed successfully");
+        }
+        catch (error) {
+            this.LOGGER.error("Migration runner failed:", error);
+            throw error;
+        }
+    }
+    /**
+     * Manually run migrations (for testing or manual execution)
+     * @returns {Promise<void>} Promise that resolves when migrations are complete
+     */
+    async runMigrations() {
+        const migrationOptions = this.options.migrationOptions;
+        if (!migrationOptions?.isEnabled) {
+            throw new Error("Migrations are not enabled");
+        }
+        if (!migrationOptions.migrations || migrationOptions.migrations.length === 0) {
+            throw new Error("No migrations configured");
+        }
+        await this.migrationService.executeMigrations(migrationOptions.migrations, migrationOptions.useTransaction ?? true);
+    }
+};
+ConfigMigrationRunnerService = __decorate([
+    Injectable(),
+    __param(1, Inject(TOKEN_CONSTANT.CONFIG_OPTIONS)),
+    __metadata("design:paramtypes", [ConfigMigrationService, Object])
+], ConfigMigrationRunnerService);
+
+export { ConfigMigrationRunnerService };
+//# sourceMappingURL=migration-runner.service.js.map

package/dist/esm/modules/config/migration/migration-runner.service.js.map

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

package/dist/esm/modules/config/migration/migration.service.d.ts

@@ -0,0 +1,68 @@
+import type { IConfigOptions } from '../../../shared/interface/config/index';
+import type { IConfigMigration, IConfigMigrationDefinition } from './interface/index';
+import { CrudConfigService } from '../config.service';
+import { type OnModuleInit } from "@nestjs/common";
+import { DataSource } from "typeorm";
+export declare class ConfigMigrationService implements OnModuleInit {
+    private readonly dataSource;
+    private readonly options;
+    private readonly configService;
+    private readonly LOGGER;
+    private migrationService;
+    constructor(dataSource: DataSource, options: IConfigOptions, configService: CrudConfigService);
+    /**
+     * Cleans up failed migrations
+     * @param {string} [migrationName] - Optional migration name to clean up
+     * @returns {Promise<void>} Promise that resolves when cleanup is complete
+     */
+    cleanupFailedMigrations(migrationName?: string): Promise<void>;
+    /**
+     * Cleans up stuck migrations (running for too long)
+     * @param {number} [timeoutMinutes] - Minutes after which a RUNNING migration is considered stuck
+     * @returns {Promise<void>} Promise that resolves when cleanup is complete
+     */
+    cleanupStuckMigrations(timeoutMinutes?: number): Promise<void>;
+    /**
+     * Executes pending migrations
+     * @param {Array<IConfigMigrationDefinition>} migrations - Array of migration definitions
+     * @param {boolean} [useTransaction] - Whether to run migrations in a transaction
+     * @returns {Promise<void>} Promise that resolves when all migrations are executed
+     */
+    executeMigrations(migrations: Array<IConfigMigrationDefinition>, useTransaction?: boolean): Promise<void>;
+    /**
+     * Gets list of executed migration names
+     * @returns {Promise<string[]>} Promise that resolves to list of executed migration names
+     */
+    getExecutedMigrationList(): Promise<Array<string>>;
+    /**
+     * Gets list of executed migrations
+     * @returns {Promise<IConfigMigration[]>} Promise that resolves to list of executed migrations
+     */
+    getExecutedMigrations(): Promise<Array<IConfigMigration>>;
+    /**
+     * Checks if a migration has been executed
+     * @param {string} migrationName - The name of the migration to check
+     * @returns {Promise<boolean>} Promise that resolves to true if migration is executed
+     */
+    isMigrationExecuted(migrationName: string): Promise<boolean>;
+    onModuleInit(): void;
+    /**
+     * Rolls back a migration
+     * @param {string} migrationName - The name of the migration to roll back
+     * @param {Array<IConfigMigrationDefinition>} migrations - Array of migration definitions
+     * @returns {Promise<void>} Promise that resolves when rollback is complete
+     */
+    rollbackMigration(migrationName: string, migrations: Array<IConfigMigrationDefinition>): Promise<void>;
+    /**
+     * Executes a single migration
+     * @param {IConfigMigrationDefinition} migration - Migration definition
+     * @param {EntityManager} [transactionalEntityManager] - Optional transaction manager
+     * @returns {Promise<void>} Promise that resolves when migration is executed
+     */
+    private executeSingleMigration;
+    /**
+     * Validates migrations for duplicates and naming issues
+     * @param {Array<IConfigMigrationDefinition>} migrations - Array of migration definitions
+     */
+    private validateMigrations;
+}