nestjs-ddd-cli 2.2.1 → 3.2.1

package/dist/utils/rollback.utils.d.ts

@@ -0,0 +1,49 @@
+export interface FileOperation {
+    type: 'create' | 'modify' | 'delete';
+    path: string;
+    originalContent?: string;
+    newContent?: string;
+    timestamp: number;
+}
+export interface Transaction {
+    id: string;
+    name: string;
+    startedAt: Date;
+    operations: FileOperation[];
+    status: 'pending' | 'committed' | 'rolled_back' | 'failed';
+}
+declare class TransactionManager {
+    private currentTransaction;
+    private transactionHistory;
+    private enabled;
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    begin(name: string): string;
+    recordCreate(filePath: string): void;
+    recordModify(filePath: string, originalContent: string): void;
+    recordDelete(filePath: string, originalContent: string): void;
+    commit(): Promise<void>;
+    rollback(reason?: string): Promise<void>;
+    private cleanEmptyDirs;
+    getHistory(): Transaction[];
+    getCurrentTransaction(): Transaction | null;
+    printHistory(): void;
+}
+export declare const txn: TransactionManager;
+export declare function withTransaction<T>(name: string, fn: () => Promise<T>): Promise<T>;
+export declare function createFileWithRollback(filePath: string, content: string): void;
+export declare function modifyFileWithRollback(filePath: string, content: string): void;
+export declare function deleteFileWithRollback(filePath: string): void;
+export interface RecoveryPoint {
+    id: string;
+    name: string;
+    createdAt: Date;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export declare function createRecoveryPoint(basePath: string, name: string, patterns: string[]): RecoveryPoint;
+export declare function restoreFromRecoveryPoint(point: RecoveryPoint): void;
+export {};

package/dist/utils/rollback.utils.js

@@ -0,0 +1,306 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.txn = void 0;
+exports.withTransaction = withTransaction;
+exports.createFileWithRollback = createFileWithRollback;
+exports.modifyFileWithRollback = modifyFileWithRollback;
+exports.deleteFileWithRollback = deleteFileWithRollback;
+exports.createRecoveryPoint = createRecoveryPoint;
+exports.restoreFromRecoveryPoint = restoreFromRecoveryPoint;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+class TransactionManager {
+    constructor() {
+        this.currentTransaction = null;
+        this.transactionHistory = [];
+        this.enabled = false;
+    }
+    enable() {
+        this.enabled = true;
+    }
+    disable() {
+        this.enabled = false;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    begin(name) {
+        if (!this.enabled)
+            return '';
+        if (this.currentTransaction) {
+            throw new Error('Transaction already in progress. Commit or rollback first.');
+        }
+        const id = `txn_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        this.currentTransaction = {
+            id,
+            name,
+            startedAt: new Date(),
+            operations: [],
+            status: 'pending',
+        };
+        console.log(chalk_1.default.gray(`  [Transaction: ${name}]`));
+        return id;
+    }
+    recordCreate(filePath) {
+        if (!this.enabled || !this.currentTransaction)
+            return;
+        this.currentTransaction.operations.push({
+            type: 'create',
+            path: filePath,
+            timestamp: Date.now(),
+        });
+    }
+    recordModify(filePath, originalContent) {
+        if (!this.enabled || !this.currentTransaction)
+            return;
+        // Check if we already recorded this file
+        const existing = this.currentTransaction.operations.find(op => op.path === filePath && op.type === 'modify');
+        if (!existing) {
+            this.currentTransaction.operations.push({
+                type: 'modify',
+                path: filePath,
+                originalContent,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    recordDelete(filePath, originalContent) {
+        if (!this.enabled || !this.currentTransaction)
+            return;
+        this.currentTransaction.operations.push({
+            type: 'delete',
+            path: filePath,
+            originalContent,
+            timestamp: Date.now(),
+        });
+    }
+    async commit() {
+        if (!this.enabled || !this.currentTransaction)
+            return;
+        this.currentTransaction.status = 'committed';
+        this.transactionHistory.push(this.currentTransaction);
+        const opCount = this.currentTransaction.operations.length;
+        console.log(chalk_1.default.green(`  ✓ Committed: ${opCount} file operations`));
+        this.currentTransaction = null;
+    }
+    async rollback(reason) {
+        if (!this.currentTransaction) {
+            console.log(chalk_1.default.yellow('No active transaction to rollback.'));
+            return;
+        }
+        console.log(chalk_1.default.yellow(`\n⚠️  Rolling back transaction: ${this.currentTransaction.name}`));
+        if (reason) {
+            console.log(chalk_1.default.yellow(`   Reason: ${reason}`));
+        }
+        const operations = [...this.currentTransaction.operations].reverse();
+        let rolledBack = 0;
+        let failed = 0;
+        for (const op of operations) {
+            try {
+                switch (op.type) {
+                    case 'create':
+                        // Delete created file
+                        if (fs.existsSync(op.path)) {
+                            fs.unlinkSync(op.path);
+                            // Try to remove empty parent directories
+                            this.cleanEmptyDirs(path.dirname(op.path));
+                        }
+                        break;
+                    case 'modify':
+                        // Restore original content
+                        if (op.originalContent !== undefined) {
+                            fs.writeFileSync(op.path, op.originalContent);
+                        }
+                        break;
+                    case 'delete':
+                        // Recreate deleted file
+                        if (op.originalContent !== undefined) {
+                            const dir = path.dirname(op.path);
+                            if (!fs.existsSync(dir)) {
+                                fs.mkdirSync(dir, { recursive: true });
+                            }
+                            fs.writeFileSync(op.path, op.originalContent);
+                        }
+                        break;
+                }
+                rolledBack++;
+            }
+            catch (error) {
+                failed++;
+                console.log(chalk_1.default.red(`   Failed to rollback: ${op.path}`));
+            }
+        }
+        this.currentTransaction.status = 'rolled_back';
+        this.transactionHistory.push(this.currentTransaction);
+        console.log(chalk_1.default.yellow(`   Rolled back ${rolledBack} operations${failed > 0 ? `, ${failed} failed` : ''}`));
+        this.currentTransaction = null;
+    }
+    cleanEmptyDirs(dir) {
+        try {
+            const entries = fs.readdirSync(dir);
+            if (entries.length === 0) {
+                fs.rmdirSync(dir);
+                // Recursively check parent
+                const parent = path.dirname(dir);
+                if (parent !== dir) {
+                    this.cleanEmptyDirs(parent);
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    getHistory() {
+        return [...this.transactionHistory];
+    }
+    getCurrentTransaction() {
+        return this.currentTransaction;
+    }
+    printHistory() {
+        if (this.transactionHistory.length === 0) {
+            console.log(chalk_1.default.gray('No transaction history.'));
+            return;
+        }
+        console.log(chalk_1.default.bold.blue('\n📜 Transaction History\n'));
+        for (const txn of this.transactionHistory.slice(-10)) {
+            const statusIcon = txn.status === 'committed' ? '✓' :
+                txn.status === 'rolled_back' ? '↩' : '✗';
+            const statusColor = txn.status === 'committed' ? chalk_1.default.green :
+                txn.status === 'rolled_back' ? chalk_1.default.yellow : chalk_1.default.red;
+            console.log(statusColor(`  ${statusIcon} ${txn.name}`));
+            console.log(chalk_1.default.gray(`    ${txn.operations.length} operations at ${txn.startedAt.toISOString()}`));
+        }
+    }
+}
+// Singleton instance
+exports.txn = new TransactionManager();
+// Wrapper for file operations with automatic rollback support
+async function withTransaction(name, fn) {
+    exports.txn.begin(name);
+    try {
+        const result = await fn();
+        await exports.txn.commit();
+        return result;
+    }
+    catch (error) {
+        await exports.txn.rollback(error instanceof Error ? error.message : 'Unknown error');
+        throw error;
+    }
+}
+// Enhanced file utilities with transaction support
+function createFileWithRollback(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, content);
+    exports.txn.recordCreate(filePath);
+}
+function modifyFileWithRollback(filePath, content) {
+    let originalContent = '';
+    if (fs.existsSync(filePath)) {
+        originalContent = fs.readFileSync(filePath, 'utf-8');
+    }
+    fs.writeFileSync(filePath, content);
+    exports.txn.recordModify(filePath, originalContent);
+}
+function deleteFileWithRollback(filePath) {
+    if (!fs.existsSync(filePath))
+        return;
+    const originalContent = fs.readFileSync(filePath, 'utf-8');
+    fs.unlinkSync(filePath);
+    exports.txn.recordDelete(filePath, originalContent);
+}
+function createRecoveryPoint(basePath, name, patterns) {
+    const point = {
+        id: `rp_${Date.now()}`,
+        name,
+        createdAt: new Date(),
+        files: [],
+    };
+    function scanDir(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                    scanDir(fullPath);
+                }
+            }
+            else {
+                const matches = patterns.some(p => {
+                    const regex = new RegExp(p.replace(/\*/g, '.*'));
+                    return regex.test(fullPath);
+                });
+                if (matches) {
+                    point.files.push({
+                        path: fullPath,
+                        content: fs.readFileSync(fullPath, 'utf-8'),
+                    });
+                }
+            }
+        }
+    }
+    scanDir(basePath);
+    console.log(chalk_1.default.green(`✓ Recovery point created: ${name} (${point.files.length} files)`));
+    return point;
+}
+function restoreFromRecoveryPoint(point) {
+    console.log(chalk_1.default.yellow(`\n⚠️  Restoring from recovery point: ${point.name}`));
+    let restored = 0;
+    for (const file of point.files) {
+        try {
+            const dir = path.dirname(file.path);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(file.path, file.content);
+            restored++;
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`   Failed to restore: ${file.path}`));
+        }
+    }
+    console.log(chalk_1.default.green(`   Restored ${restored}/${point.files.length} files`));
+}
+//# sourceMappingURL=rollback.utils.js.map

package/dist/utils/rollback.utils.js.map

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

package/dist/utils/schema.utils.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Type-Safe Field Schema System
+ * Provides structured field definitions with validation guarantees
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'text' | 'json' | 'uuid' | 'email' | 'url' | 'enum' | 'decimal' | 'float' | 'integer' | 'bigint';
+export type FieldModifier = 'optional' | 'unique' | 'index' | 'primary' | 'generated' | 'nullable' | 'readonly';
+export type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+export interface FieldValidation {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    pattern?: string;
+    email?: boolean;
+    url?: boolean;
+    uuid?: boolean;
+    enum?: string[];
+    custom?: string;
+}
+export interface FieldSchema {
+    name: string;
+    type: FieldType;
+    modifiers: FieldModifier[];
+    validation: FieldValidation;
+    description?: string;
+    defaultValue?: string | number | boolean;
+    enumValues?: string[];
+    length?: number;
+    precision?: number;
+    scale?: number;
+}
+export interface RelationSchema {
+    name: string;
+    type: RelationType;
+    target: string;
+    inverseSide?: string;
+    joinColumn?: string;
+    joinTable?: string;
+    cascade?: ('insert' | 'update' | 'remove' | 'soft-remove' | 'recover')[];
+    eager?: boolean;
+    nullable?: boolean;
+    onDelete?: 'CASCADE' | 'SET NULL' | 'NO ACTION' | 'RESTRICT';
+    onUpdate?: 'CASCADE' | 'SET NULL' | 'NO ACTION' | 'RESTRICT';
+}
+export interface EntitySchema {
+    name: string;
+    tableName?: string;
+    fields: FieldSchema[];
+    relations: RelationSchema[];
+    indexes?: IndexSchema[];
+    timestamps?: boolean;
+    softDelete?: boolean;
+    audit?: boolean;
+}
+export interface IndexSchema {
+    name?: string;
+    columns: string[];
+    unique?: boolean;
+    where?: string;
+}
+export interface SchemaValidationResult {
+    valid: boolean;
+    errors: SchemaError[];
+    warnings: SchemaWarning[];
+}
+export interface SchemaError {
+    path: string;
+    message: string;
+    code: string;
+}
+export interface SchemaWarning {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Parse field string into structured FieldSchema
+ * Format: name:type:modifier1:modifier2
+ * Examples:
+ *   - email:string:unique
+ *   - age:number:optional
+ *   - status:enum(active,inactive,pending)
+ *   - price:decimal(10,2)
+ */
+export declare function parseFieldString(fieldStr: string): FieldSchema;
+/**
+ * Parse multiple field strings
+ */
+export declare function parseFieldStrings(fieldsStr: string): FieldSchema[];
+/**
+ * Convert FieldSchema to TypeScript type
+ */
+export declare function fieldToTypeScript(field: FieldSchema): string;
+/**
+ * Convert FieldSchema to TypeORM column decorator
+ */
+export declare function fieldToTypeORMDecorator(field: FieldSchema): string;
+/**
+ * Convert FieldSchema to class-validator decorators
+ */
+export declare function fieldToValidatorDecorators(field: FieldSchema): string[];
+/**
+ * Validate an EntitySchema
+ */
+export declare function validateEntitySchema(schema: EntitySchema): SchemaValidationResult;
+/**
+ * Generate complete EntitySchema from field strings
+ */
+export declare function createEntitySchema(name: string, fieldsStr: string, options?: {
+    timestamps?: boolean;
+    softDelete?: boolean;
+    audit?: boolean;
+    relations?: RelationSchema[];
+}): EntitySchema;
+/**
+ * Export schema to JSON format
+ */
+export declare function schemaToJSON(schema: EntitySchema): string;
+/**
+ * Import schema from JSON
+ */
+export declare function schemaFromJSON(json: string): EntitySchema;