nestjs-ddd-cli 2.2.0 → 3.2.1

package/dist/utils/schema.utils.js

@@ -0,0 +1,419 @@
+"use strict";
+/**
+ * Type-Safe Field Schema System
+ * Provides structured field definitions with validation guarantees
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFieldString = parseFieldString;
+exports.parseFieldStrings = parseFieldStrings;
+exports.fieldToTypeScript = fieldToTypeScript;
+exports.fieldToTypeORMDecorator = fieldToTypeORMDecorator;
+exports.fieldToValidatorDecorators = fieldToValidatorDecorators;
+exports.validateEntitySchema = validateEntitySchema;
+exports.createEntitySchema = createEntitySchema;
+exports.schemaToJSON = schemaToJSON;
+exports.schemaFromJSON = schemaFromJSON;
+/**
+ * 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)
+ */
+function parseFieldString(fieldStr) {
+    const parts = fieldStr.split(':');
+    const name = parts[0];
+    let typeStr = parts[1] || 'string';
+    const modifierStrs = parts.slice(2);
+    // Parse type with parameters
+    let type = 'string';
+    let enumValues;
+    let length;
+    let precision;
+    let scale;
+    const enumMatch = typeStr.match(/^enum\(([^)]+)\)$/i);
+    const decimalMatch = typeStr.match(/^decimal\((\d+),(\d+)\)$/i);
+    const stringMatch = typeStr.match(/^string\((\d+)\)$/i);
+    if (enumMatch) {
+        type = 'enum';
+        enumValues = enumMatch[1].split(',').map(v => v.trim());
+    }
+    else if (decimalMatch) {
+        type = 'decimal';
+        precision = parseInt(decimalMatch[1], 10);
+        scale = parseInt(decimalMatch[2], 10);
+    }
+    else if (stringMatch) {
+        type = 'string';
+        length = parseInt(stringMatch[1], 10);
+    }
+    else {
+        type = normalizeFieldType(typeStr);
+    }
+    // Parse modifiers
+    const modifiers = [];
+    const validation = { required: true };
+    for (const mod of modifierStrs) {
+        const normalizedMod = mod.toLowerCase();
+        if (isFieldModifier(normalizedMod)) {
+            modifiers.push(normalizedMod);
+            if (normalizedMod === 'optional' || normalizedMod === 'nullable') {
+                validation.required = false;
+            }
+        }
+        // Parse validation modifiers
+        const minLenMatch = mod.match(/^minLength\((\d+)\)$/i);
+        const maxLenMatch = mod.match(/^maxLength\((\d+)\)$/i);
+        const minMatch = mod.match(/^min\((\d+)\)$/i);
+        const maxMatch = mod.match(/^max\((\d+)\)$/i);
+        const patternMatch = mod.match(/^pattern\(([^)]+)\)$/i);
+        if (minLenMatch)
+            validation.minLength = parseInt(minLenMatch[1], 10);
+        if (maxLenMatch)
+            validation.maxLength = parseInt(maxLenMatch[1], 10);
+        if (minMatch)
+            validation.min = parseInt(minMatch[1], 10);
+        if (maxMatch)
+            validation.max = parseInt(maxMatch[1], 10);
+        if (patternMatch)
+            validation.pattern = patternMatch[1];
+    }
+    // Auto-set validation based on type
+    if (type === 'email')
+        validation.email = true;
+    if (type === 'url')
+        validation.url = true;
+    if (type === 'uuid')
+        validation.uuid = true;
+    if (enumValues)
+        validation.enum = enumValues;
+    return {
+        name,
+        type,
+        modifiers,
+        validation,
+        enumValues,
+        length,
+        precision,
+        scale,
+    };
+}
+/**
+ * Parse multiple field strings
+ */
+function parseFieldStrings(fieldsStr) {
+    if (!fieldsStr)
+        return [];
+    return fieldsStr
+        .split(/\s+/)
+        .filter(f => f.trim())
+        .map(parseFieldString);
+}
+/**
+ * Normalize type string to FieldType
+ */
+function normalizeFieldType(typeStr) {
+    const typeMap = {
+        'string': 'string',
+        'str': 'string',
+        'varchar': 'string',
+        'char': 'string',
+        'number': 'number',
+        'num': 'number',
+        'int': 'integer',
+        'integer': 'integer',
+        'bigint': 'bigint',
+        'float': 'float',
+        'double': 'float',
+        'decimal': 'decimal',
+        'boolean': 'boolean',
+        'bool': 'boolean',
+        'date': 'date',
+        'datetime': 'datetime',
+        'timestamp': 'datetime',
+        'text': 'text',
+        'json': 'json',
+        'jsonb': 'json',
+        'uuid': 'uuid',
+        'email': 'email',
+        'url': 'url',
+        'enum': 'enum',
+    };
+    return typeMap[typeStr.toLowerCase()] || 'string';
+}
+/**
+ * Check if string is a valid field modifier
+ */
+function isFieldModifier(str) {
+    const modifiers = [
+        'optional', 'unique', 'index', 'primary',
+        'generated', 'nullable', 'readonly'
+    ];
+    return modifiers.includes(str);
+}
+/**
+ * Convert FieldSchema to TypeScript type
+ */
+function fieldToTypeScript(field) {
+    const typeMap = {
+        'string': 'string',
+        'number': 'number',
+        'boolean': 'boolean',
+        'date': 'Date',
+        'datetime': 'Date',
+        'text': 'string',
+        'json': 'Record<string, any>',
+        'uuid': 'string',
+        'email': 'string',
+        'url': 'string',
+        'enum': field.enumValues ? field.enumValues.map(v => `'${v}'`).join(' | ') : 'string',
+        'decimal': 'number',
+        'float': 'number',
+        'integer': 'number',
+        'bigint': 'bigint',
+    };
+    let tsType = typeMap[field.type] || 'any';
+    if (!field.validation.required) {
+        tsType += ' | null';
+    }
+    return tsType;
+}
+/**
+ * Convert FieldSchema to TypeORM column decorator
+ */
+function fieldToTypeORMDecorator(field) {
+    const options = [];
+    // Type mapping
+    const typeMap = {
+        'string': 'varchar',
+        'number': 'int',
+        'boolean': 'boolean',
+        'date': 'date',
+        'datetime': 'timestamp',
+        'text': 'text',
+        'json': 'jsonb',
+        'uuid': 'uuid',
+        'email': 'varchar',
+        'url': 'varchar',
+        'enum': 'enum',
+        'decimal': 'decimal',
+        'float': 'float',
+        'integer': 'int',
+        'bigint': 'bigint',
+    };
+    const dbType = typeMap[field.type];
+    options.push(`type: '${dbType}'`);
+    if (field.length)
+        options.push(`length: ${field.length}`);
+    if (field.precision)
+        options.push(`precision: ${field.precision}`);
+    if (field.scale)
+        options.push(`scale: ${field.scale}`);
+    if (field.enumValues)
+        options.push(`enum: [${field.enumValues.map(v => `'${v}'`).join(', ')}]`);
+    if (!field.validation.required)
+        options.push('nullable: true');
+    if (field.modifiers.includes('unique'))
+        options.push('unique: true');
+    if (field.defaultValue !== undefined) {
+        const defaultVal = typeof field.defaultValue === 'string'
+            ? `'${field.defaultValue}'`
+            : field.defaultValue;
+        options.push(`default: ${defaultVal}`);
+    }
+    return `@Column({ ${options.join(', ')} })`;
+}
+/**
+ * Convert FieldSchema to class-validator decorators
+ */
+function fieldToValidatorDecorators(field) {
+    const decorators = [];
+    const v = field.validation;
+    if (v.required) {
+        decorators.push('@IsNotEmpty()');
+    }
+    else {
+        decorators.push('@IsOptional()');
+    }
+    switch (field.type) {
+        case 'string':
+        case 'text':
+            decorators.push('@IsString()');
+            if (v.minLength)
+                decorators.push(`@MinLength(${v.minLength})`);
+            if (v.maxLength)
+                decorators.push(`@MaxLength(${v.maxLength})`);
+            if (v.pattern)
+                decorators.push(`@Matches(/${v.pattern}/)`);
+            break;
+        case 'email':
+            decorators.push('@IsEmail()');
+            break;
+        case 'url':
+            decorators.push('@IsUrl()');
+            break;
+        case 'uuid':
+            decorators.push('@IsUUID()');
+            break;
+        case 'number':
+        case 'integer':
+        case 'float':
+        case 'decimal':
+            decorators.push('@IsNumber()');
+            if (v.min !== undefined)
+                decorators.push(`@Min(${v.min})`);
+            if (v.max !== undefined)
+                decorators.push(`@Max(${v.max})`);
+            break;
+        case 'boolean':
+            decorators.push('@IsBoolean()');
+            break;
+        case 'date':
+        case 'datetime':
+            decorators.push('@IsDate()');
+            decorators.push('@Type(() => Date)');
+            break;
+        case 'enum':
+            if (v.enum) {
+                decorators.push(`@IsIn([${v.enum.map(e => `'${e}'`).join(', ')}])`);
+            }
+            break;
+        case 'json':
+            decorators.push('@IsObject()');
+            break;
+    }
+    return decorators;
+}
+/**
+ * Validate an EntitySchema
+ */
+function validateEntitySchema(schema) {
+    const errors = [];
+    const warnings = [];
+    // Validate entity name
+    if (!schema.name) {
+        errors.push({ path: 'name', message: 'Entity name is required', code: 'MISSING_NAME' });
+    }
+    else if (!/^[A-Z][a-zA-Z0-9]*$/.test(schema.name)) {
+        errors.push({ path: 'name', message: 'Entity name must be PascalCase', code: 'INVALID_NAME' });
+    }
+    // Validate fields
+    const fieldNames = new Set();
+    for (let i = 0; i < schema.fields.length; i++) {
+        const field = schema.fields[i];
+        const path = `fields[${i}]`;
+        if (!field.name) {
+            errors.push({ path: `${path}.name`, message: 'Field name is required', code: 'MISSING_FIELD_NAME' });
+        }
+        else {
+            if (fieldNames.has(field.name)) {
+                errors.push({ path: `${path}.name`, message: `Duplicate field name: ${field.name}`, code: 'DUPLICATE_FIELD' });
+            }
+            fieldNames.add(field.name);
+            if (!/^[a-z][a-zA-Z0-9]*$/.test(field.name)) {
+                warnings.push({
+                    path: `${path}.name`,
+                    message: `Field name should be camelCase: ${field.name}`,
+                    suggestion: toCamelCase(field.name)
+                });
+            }
+        }
+        // Validate enum fields have values
+        if (field.type === 'enum' && (!field.enumValues || field.enumValues.length === 0)) {
+            errors.push({ path: `${path}.type`, message: 'Enum fields must have enumValues', code: 'MISSING_ENUM_VALUES' });
+        }
+        // Validate decimal fields have precision
+        if (field.type === 'decimal' && !field.precision) {
+            warnings.push({
+                path: `${path}.type`,
+                message: 'Decimal fields should specify precision and scale',
+                suggestion: 'Use decimal(10,2) format'
+            });
+        }
+    }
+    // Validate relations
+    for (let i = 0; i < schema.relations.length; i++) {
+        const relation = schema.relations[i];
+        const path = `relations[${i}]`;
+        if (!relation.name) {
+            errors.push({ path: `${path}.name`, message: 'Relation name is required', code: 'MISSING_RELATION_NAME' });
+        }
+        if (!relation.target) {
+            errors.push({ path: `${path}.target`, message: 'Relation target is required', code: 'MISSING_RELATION_TARGET' });
+        }
+        // Check for missing inverse side
+        if ((relation.type === 'one-to-many' || relation.type === 'many-to-many') && !relation.inverseSide) {
+            warnings.push({
+                path: `${path}.inverseSide`,
+                message: `${relation.type} relations should specify inverseSide`,
+                suggestion: `Add inverseSide property pointing to the relation on ${relation.target}`
+            });
+        }
+    }
+    // Check for common issues
+    if (!schema.fields.some(f => f.modifiers.includes('primary'))) {
+        warnings.push({
+            path: 'fields',
+            message: 'No primary key field defined',
+            suggestion: 'Add a field with "primary" modifier or use "id:uuid:primary:generated"'
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Generate complete EntitySchema from field strings
+ */
+function createEntitySchema(name, fieldsStr, options = {}) {
+    const fields = parseFieldStrings(fieldsStr);
+    // Add id field if not present
+    if (!fields.some(f => f.modifiers.includes('primary'))) {
+        fields.unshift({
+            name: 'id',
+            type: 'uuid',
+            modifiers: ['primary', 'generated'],
+            validation: { required: true },
+        });
+    }
+    // Add timestamp fields
+    if (options.timestamps !== false) {
+        fields.push({ name: 'createdAt', type: 'datetime', modifiers: ['readonly'], validation: { required: true } }, { name: 'updatedAt', type: 'datetime', modifiers: ['readonly'], validation: { required: true } });
+    }
+    // Add soft delete field
+    if (options.softDelete) {
+        fields.push({ name: 'deletedAt', type: 'datetime', modifiers: ['nullable'], validation: { required: false } });
+    }
+    // Add audit fields
+    if (options.audit) {
+        fields.push({ name: 'createdBy', type: 'string', modifiers: ['nullable'], validation: { required: false } }, { name: 'updatedBy', type: 'string', modifiers: ['nullable'], validation: { required: false } });
+    }
+    return {
+        name,
+        fields,
+        relations: options.relations || [],
+        timestamps: options.timestamps !== false,
+        softDelete: options.softDelete,
+        audit: options.audit,
+    };
+}
+function toCamelCase(str) {
+    return str.replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '').replace(/^(.)/, c => c.toLowerCase());
+}
+/**
+ * Export schema to JSON format
+ */
+function schemaToJSON(schema) {
+    return JSON.stringify(schema, null, 2);
+}
+/**
+ * Import schema from JSON
+ */
+function schemaFromJSON(json) {
+    return JSON.parse(json);
+}
+//# sourceMappingURL=schema.utils.js.map

package/dist/utils/schema.utils.js.map

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

package/dist/utils/security.utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Security utilities for the CLI
+ * Implements OWASP-recommended practices for input validation and path safety
+ */
+/**
+ * Validates that a path does not escape the base directory
+ * Prevents path traversal attacks (OWASP A01:2021)
+ */
+export declare function validateSafePath(basePath: string, targetPath: string): string;
+/**
+ * Sanitizes entity/module names for safe file system operations
+ * Prevents directory traversal and special character injection
+ */
+export declare function sanitizeEntityName(name: string): string;
+/**
+ * Validates that field names are safe for use in SQL/ORM queries
+ * Only allows alphanumeric characters and underscores, starting with letter
+ */
+export declare function validateFieldName(fieldName: string, allowedFields?: string[]): string;
+/**
+ * Sanitizes input for use in shell commands
+ * Implements whitelist approach - only allows safe characters
+ */
+export declare function sanitizeShellInput(input: string): string;
+/**
+ * Validates numeric input is within safe bounds
+ */
+export declare function validateNumericInput(value: number, options?: {
+    min?: number;
+    max?: number;
+    allowNegative?: boolean;
+    allowZero?: boolean;
+}): number;
+/**
+ * Sanitizes string for safe HTML output
+ * Prevents XSS attacks (OWASP A03:2021)
+ */
+export declare function sanitizeHtmlOutput(input: string): string;
+/**
+ * Masks sensitive data in strings (API keys, passwords, etc.)
+ * For safe logging
+ */
+export declare function maskSensitiveData(input: string): string;
+/**
+ * Validates URL is safe and uses allowed protocols
+ */
+export declare function validateUrl(url: string, allowedProtocols?: string[]): string;
+/**
+ * Creates a rate limit key from request data
+ * Sanitizes to prevent key injection
+ */
+export declare function createRateLimitKey(prefix: string, identifier: string): string;
+/**
+ * Validates JSON input for safe parsing
+ * Prevents prototype pollution
+ */
+export declare function safeJsonParse<T>(input: string): T;