nestjs-ddd-cli 2.2.1 → 3.2.2

package/dist/utils/file.utils.js

@@ -43,12 +43,51 @@ exports.writeFile = writeFile;
 exports.readTemplate = readTemplate;
 exports.compileTemplate = compileTemplate;
 exports.generateFromTemplate = generateFromTemplate;
+exports.resetDryRunFiles = resetDryRunFiles;
+exports.getDryRunFiles = getDryRunFiles;
+exports.addDryRunFile = addDryRunFile;
+exports.writeGeneratedFile = writeGeneratedFile;
+exports.updateBarrelFile = updateBarrelFile;
 exports.getModulePath = getModulePath;
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
 const handlebars_1 = __importDefault(require("handlebars"));
 const naming_utils_1 = require("./naming.utils");
-function prepareTemplateData(entityName, moduleName) {
+const field_utils_1 = require("./field.utils");
+// Register Handlebars helpers
+handlebars_1.default.registerHelper('eq', function (a, b) {
+    return a === b;
+});
+handlebars_1.default.registerHelper('lowercase', function (str) {
+    return typeof str === 'string' ? str.toLowerCase() : str;
+});
+handlebars_1.default.registerHelper('uppercase', function (str) {
+    return typeof str === 'string' ? str.toUpperCase() : str;
+});
+handlebars_1.default.registerHelper('pascalCase', function (str) {
+    return typeof str === 'string' ? (0, naming_utils_1.toPascalCase)(str) : str;
+});
+handlebars_1.default.registerHelper('camelCase', function (str) {
+    return typeof str === 'string' ? (0, naming_utils_1.toCamelCase)(str) : str;
+});
+handlebars_1.default.registerHelper('kebabCase', function (str) {
+    return typeof str === 'string' ? (0, naming_utils_1.toKebabCase)(str) : str;
+});
+function prepareTemplateData(entityName, moduleName, fieldsString) {
+    const parsedFields = fieldsString ? (0, field_utils_1.parseFields)(fieldsString) : null;
+    const fieldsTemplateData = parsedFields?.fields.length
+        ? (0, field_utils_1.generateFieldsTemplateData)(parsedFields.fields)
+        : null;
+    // Check for relations and generate imports
+    const relationFields = parsedFields?.fields.filter((f) => f.isRelation) || [];
+    const hasRelations = relationFields.length > 0;
+    // Generate unique relation imports
+    const relationTargets = [...new Set(relationFields.map((f) => f.relationTarget).filter(Boolean))];
+    const relationImports = relationTargets.length > 0
+        ? relationTargets
+            .map((target) => `import { ${target}OrmEntity } from "./${(0, naming_utils_1.toKebabCase)(target)}.orm-entity";`)
+            .join('\n')
+        : '';
     return {
         entityName,
         entityNamePascal: (0, naming_utils_1.toPascalCase)(entityName),
@@ -56,17 +95,78 @@ function prepareTemplateData(entityName, moduleName) {
         entityNameKebab: (0, naming_utils_1.toKebabCase)(entityName),
         entityNameSnake: (0, naming_utils_1.toSnakeCase)(entityName),
         entityNamePlural: (0, naming_utils_1.toPlural)((0, naming_utils_1.toPascalCase)(entityName)),
+        entityNamePluralPascal: (0, naming_utils_1.toPlural)((0, naming_utils_1.toPascalCase)(entityName)),
+        entityNamePluralCamel: (0, naming_utils_1.toCamelCase)((0, naming_utils_1.toPlural)(entityName)),
         entityNamePluralKebab: (0, naming_utils_1.toKebabCase)((0, naming_utils_1.toPlural)(entityName)),
         tableName: (0, naming_utils_1.toTableName)(entityName),
-        moduleName,
+        moduleName: (0, naming_utils_1.toPascalCase)(moduleName),
         moduleNameKebab: (0, naming_utils_1.toKebabCase)(moduleName),
+        moduleNamePascal: (0, naming_utils_1.toPascalCase)(moduleName),
+        // Field-aware properties
+        fields: parsedFields?.fields || [],
+        hasFields: (parsedFields?.fields.length || 0) > 0,
+        entityProperties: fieldsTemplateData?.entityProperties || '',
+        entityPropsInterface: fieldsTemplateData?.entityPropsInterface || '',
+        dtoProperties: fieldsTemplateData?.dtoProperties || '',
+        ormColumns: fieldsTemplateData?.ormColumns || '',
+        migrationColumns: fieldsTemplateData?.migrationColumns || '',
+        responseProperties: fieldsTemplateData?.responseProperties || '',
+        // Relation properties
+        hasRelations,
+        relationImports,
     };
 }
+/**
+ * Validate that a path is safe and within allowed bounds
+ * Prevents path traversal attacks (OWASP A01:2021)
+ */
+function validatePath(targetPath, basePath) {
+    if (!targetPath || typeof targetPath !== 'string') {
+        throw new Error('Path must be a non-empty string');
+    }
+    // Check for null bytes (can bypass security checks)
+    if (targetPath.includes('\0')) {
+        throw new Error('Path contains null byte');
+    }
+    // Check for path traversal patterns
+    const normalizedPath = path.normalize(targetPath);
+    if (normalizedPath.includes('..')) {
+        // After normalization, if .. still exists, it's going above root
+        const resolvedPath = path.resolve(targetPath);
+        const cwdPath = basePath || process.cwd();
+        if (!resolvedPath.startsWith(cwdPath)) {
+            throw new Error('Path traversal detected: path escapes base directory');
+        }
+    }
+    // Block access to sensitive system directories
+    const blockedPatterns = [
+        /^\/etc\//i,
+        /^\/proc\//i,
+        /^\/sys\//i,
+        /^\/dev\//i,
+        /^\/root\//i,
+        /^C:\\Windows/i,
+        /^C:\\Program Files/i,
+        /\.env$/i,
+        /\.git\//i,
+        /\.ssh\//i,
+        /id_rsa/i,
+        /\.pem$/i,
+        /\.key$/i,
+    ];
+    for (const pattern of blockedPatterns) {
+        if (pattern.test(normalizedPath)) {
+            throw new Error(`Access to path is blocked: ${normalizedPath}`);
+        }
+    }
+}
 async function ensureDir(dirPath) {
+    validatePath(dirPath);
     await fs.ensureDir(dirPath);
 }
 async function fileExists(filePath) {
     try {
+        validatePath(filePath);
         await fs.access(filePath);
         return true;
     }
@@ -75,20 +175,152 @@ async function fileExists(filePath) {
     }
 }
 async function writeFile(filePath, content) {
+    validatePath(filePath);
+    // Validate content size (prevent DoS via huge files)
+    validateContentSize(content);
     await ensureDir(path.dirname(filePath));
     await fs.writeFile(filePath, content, 'utf-8');
 }
+function validateContentSize(content) {
+    const maxContentSize = 10 * 1024 * 1024; // 10MB max
+    if (content && content.length > maxContentSize) {
+        throw new Error(`Content exceeds maximum size of ${maxContentSize} bytes`);
+    }
+}
 async function readTemplate(templatePath) {
+    validatePath(templatePath);
+    // Get file stats to check size before reading
+    try {
+        const stats = await fs.stat(templatePath);
+        const maxTemplateSize = 1024 * 1024; // 1MB max for templates
+        if (stats.size > maxTemplateSize) {
+            throw new Error(`Template file exceeds maximum size of ${maxTemplateSize} bytes`);
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Template file not found: ${templatePath}`);
+        }
+        throw error;
+    }
     return fs.readFile(templatePath, 'utf-8');
 }
 function compileTemplate(template, data) {
-    const compiledTemplate = handlebars_1.default.compile(template);
+    const compiledTemplate = handlebars_1.default.compile(template, { noEscape: true });
     return compiledTemplate(data);
 }
-async function generateFromTemplate(templatePath, outputPath, data) {
+async function generateFromTemplate(templatePath, outputPath, data, dryRun = false) {
     const template = await readTemplate(templatePath);
     const content = compileTemplate(template, data);
-    await writeFile(outputPath, content);
+    await writeGeneratedFile(outputPath, content, dryRun);
+    return outputPath;
+}
+let dryRunFiles = [];
+function resetDryRunFiles() {
+    dryRunFiles = [];
+}
+function getDryRunFiles() {
+    return [...dryRunFiles];
+}
+function addDryRunFile(filePath, action = 'create') {
+    if (dryRunFiles.some((change) => change.filePath === filePath)) {
+        return;
+    }
+    dryRunFiles.push({ filePath, action });
+}
+async function writeGeneratedFile(filePath, content, dryRun = false) {
+    validatePath(filePath);
+    validateContentSize(content);
+    if (dryRun) {
+        addDryRunFile(filePath, (await fileExists(filePath)) ? 'update' : 'create');
+        return;
+    }
+    await writeFile(filePath, content);
+}
+async function updateBarrelFile(filePath, update) {
+    validatePath(filePath);
+    let content = '';
+    if (await fileExists(filePath)) {
+        content = await fs.readFile(filePath, 'utf-8');
+    }
+    const originalContent = content;
+    content = appendUniqueLines(content, update.exports || [], update.arrayName);
+    content = appendUniqueLines(content, update.imports || [], update.arrayName);
+    if (update.arrayName && update.arrayItems?.length) {
+        content = mergeExportedArray(content, update.arrayName, update.arrayItems);
+    }
+    content = normalizeFileContent(content);
+    if (content !== normalizeFileContent(originalContent)) {
+        await writeGeneratedFile(filePath, content, !!update.dryRun);
+    }
+}
+function appendUniqueLines(content, lines, beforeArrayName) {
+    const existingLines = new Set(content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean));
+    const missingLines = lines
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !existingLines.has(line));
+    if (!missingLines.length) {
+        return content;
+    }
+    const insertion = `${missingLines.join('\n')}\n`;
+    if (beforeArrayName) {
+        const arrayPattern = new RegExp(`export const ${escapeRegExp(beforeArrayName)}(:[^=]+)?\\s*=\\s*\\[`);
+        const arrayMatch = arrayPattern.exec(content);
+        if (arrayMatch?.index !== undefined) {
+            const beforeArray = content.slice(0, arrayMatch.index).trimEnd();
+            const afterArray = content.slice(arrayMatch.index);
+            const prefix = beforeArray.length > 0 ? `${beforeArray}\n` : '';
+            return `${prefix}${insertion}${afterArray}`;
+        }
+    }
+    const trimmedContent = content.trimEnd();
+    const prefix = trimmedContent.length > 0 ? `${trimmedContent}\n` : '';
+    return `${prefix}${insertion}`;
+}
+function mergeExportedArray(content, arrayName, arrayItems) {
+    const uniqueItems = [...new Set(arrayItems.map((item) => item.trim()).filter(Boolean))];
+    const escapedArrayName = escapeRegExp(arrayName);
+    const arrayPattern = new RegExp(`export const ${escapedArrayName}(:[^=]+)?\\s*=\\s*\\[([\\s\\S]*?)\\];`);
+    const match = arrayPattern.exec(content);
+    if (!match) {
+        const arrayContent = uniqueItems.map((item) => `  ${item},`).join('\n');
+        return appendUniqueLines(content, [`export const ${arrayName} = [\n${arrayContent}\n];`]);
+    }
+    const typeAnnotation = match[1] || '';
+    const body = match[2] || '';
+    const missingItems = uniqueItems.filter((item) => !hasArrayItem(body, item));
+    if (!missingItems.length) {
+        return content;
+    }
+    const nextBody = appendArrayItems(body, missingItems);
+    const nextArray = `export const ${arrayName}${typeAnnotation} = [${nextBody}];`;
+    return content.replace(match[0], nextArray);
+}
+function hasArrayItem(body, item) {
+    return new RegExp(`(^|[^A-Za-z0-9_$])${escapeRegExp(item)}([^A-Za-z0-9_$]|$)`).test(body);
+}
+function appendArrayItems(body, missingItems) {
+    const linesToAdd = missingItems.map((item) => `  ${item},`).join('\n');
+    const trimmedBody = body.trim();
+    if (!trimmedBody) {
+        return `\n${linesToAdd}\n`;
+    }
+    if (!body.includes('\n')) {
+        return `\n  ${trimmedBody.replace(/,\s*$/, '')},\n${linesToAdd}\n`;
+    }
+    const bodyWithTrailingComma = /,\s*$/.test(body.trimEnd())
+        ? body.trimEnd()
+        : `${body.trimEnd()},`;
+    return `${bodyWithTrailingComma}\n${linesToAdd}\n`;
+}
+function normalizeFileContent(content) {
+    return content.trimEnd() ? `${content.trimEnd()}\n` : '';
+}
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 function getModulePath(basePath, moduleName) {
     return path.join(basePath, 'src', 'modules', (0, naming_utils_1.toKebabCase)(moduleName));

package/dist/utils/file.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,kDAaC;AAED,8BAEC;AAED,gCAOC;AAED,8BAGC;AAED,oCAEC;AAED,0CAGC;AAED,oDAQC;AAED,sCAEC;AA9ED,6CAA+B;AAC/B,2CAA6B;AAC7B,4DAAoC;AACpC,iDAA4G;AAqB5G,SAAgB,mBAAmB,CAAC,UAAkB,EAAE,UAAkB;IACxE,OAAO;QACL,UAAU;QACV,gBAAgB,EAAE,IAAA,2BAAY,EAAC,UAAU,CAAC;QAC1C,eAAe,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC;QACxC,eAAe,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC;QACxC,eAAe,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC;QACxC,gBAAgB,EAAE,IAAA,uBAAQ,EAAC,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC;QACpD,qBAAqB,EAAE,IAAA,0BAAW,EAAC,IAAA,uBAAQ,EAAC,UAAU,CAAC,CAAC;QACxD,SAAS,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC;QAClC,UAAU;QACV,eAAe,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC;KACzC,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,OAAO,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,eAAe,CAAC,QAAgB,EAAE,IAAkB;IAClE,MAAM,gBAAgB,GAAG,oBAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,YAAoB,EACpB,UAAkB,EAClB,IAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,aAAa,CAAC,QAAgB,EAAE,UAAkB;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAA,0BAAW,EAAC,UAAU,CAAC,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/idempotency.utils.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Idempotency & Consistency System
+ * Tracks generated files and ensures safe re-generation
+ */
+export interface GenerationManifest {
+    version: string;
+    generatedAt: string;
+    lastModified: string;
+    generator: string;
+    entities: EntityManifest[];
+    files: FileManifest[];
+    checksums: Record<string, string>;
+}
+export interface EntityManifest {
+    name: string;
+    module: string;
+    fields: string[];
+    relations: string[];
+    generatedFiles: string[];
+    hash: string;
+    generatedAt: string;
+}
+export interface FileManifest {
+    path: string;
+    type: 'entity' | 'dto' | 'service' | 'controller' | 'repository' | 'module' | 'test' | 'other';
+    entity?: string;
+    module?: string;
+    hash: string;
+    generatedAt: string;
+    modifiedAt?: string;
+    isModified: boolean;
+    mergeStrategy: MergeStrategy;
+}
+export type MergeStrategy = 'overwrite' | 'skip' | 'merge' | 'backup' | 'prompt';
+export interface GenerationPlan {
+    create: FileOperation[];
+    update: FileOperation[];
+    skip: FileOperation[];
+    conflict: FileOperation[];
+}
+export interface FileOperation {
+    path: string;
+    action: 'create' | 'update' | 'skip' | 'conflict' | 'backup';
+    reason?: string;
+    content?: string;
+    existingHash?: string;
+    newHash?: string;
+}
+/**
+ * Load or create generation manifest
+ */
+export declare function loadManifest(basePath: string): GenerationManifest;
+/**
+ * Create an empty manifest
+ */
+export declare function createEmptyManifest(): GenerationManifest;
+/**
+ * Save manifest to disk
+ */
+export declare function saveManifest(basePath: string, manifest: GenerationManifest): void;
+/**
+ * Calculate file hash
+ */
+export declare function calculateHash(content: string): string;
+/**
+ * Check if a file has been manually modified
+ */
+export declare function isFileModified(filePath: string, manifest: GenerationManifest): boolean;
+/**
+ * Plan generation operations with conflict detection
+ */
+export declare function planGeneration(basePath: string, filesToGenerate: Array<{
+    path: string;
+    content: string;
+    type: FileManifest['type'];
+}>, manifest: GenerationManifest, options?: {
+    mergeStrategy?: MergeStrategy;
+    force?: boolean;
+}): GenerationPlan;
+/**
+ * Execute a generation plan
+ */
+export declare function executePlan(basePath: string, plan: GenerationPlan, manifest: GenerationManifest): {
+    success: boolean;
+    created: number;
+    updated: number;
+    skipped: number;
+    errors: string[];
+};
+/**
+ * Backup a file before overwriting
+ */
+export declare function backupFile(basePath: string, filePath: string): string;
+/**
+ * Restore a file from backup
+ */
+export declare function restoreFile(basePath: string, filePath: string, backupTimestamp?: string): boolean;
+/**
+ * Register an entity in the manifest
+ */
+export declare function registerEntity(manifest: GenerationManifest, entity: {
+    name: string;
+    module: string;
+    fields: string[];
+    relations: string[];
+    generatedFiles: string[];
+}): void;
+/**
+ * Check if an entity was previously generated
+ */
+export declare function wasEntityGenerated(manifest: GenerationManifest, entityName: string, moduleName: string): boolean;
+/**
+ * Get entity manifest
+ */
+export declare function getEntityManifest(manifest: GenerationManifest, entityName: string, moduleName: string): EntityManifest | undefined;
+/**
+ * Clean up old backups (keep last N)
+ */
+export declare function cleanupBackups(basePath: string, keepLast?: number): number;
+/**
+ * Generate a summary of what will change
+ */
+export declare function summarizePlan(plan: GenerationPlan): string;