nestjs-ddd-cli 2.2.1 → 3.2.1

package/dist/utils/error.utils.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Unified Error & Exception Framework
+ * Provides centralized exception handling for CLI and generated code
+ */
+/**
+ * Base CLI Error with error codes
+ */
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, any>;
+    readonly suggestion?: string;
+    readonly cause?: Error;
+    constructor(message: string, code: string, options?: {
+        details?: Record<string, any>;
+        suggestion?: string;
+        cause?: Error;
+    });
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        details: Record<string, any>;
+        suggestion: string;
+    };
+}
+export declare class ValidationError extends CliError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class FileNotFoundError extends CliError {
+    constructor(filePath: string);
+}
+export declare class FileExistsError extends CliError {
+    constructor(filePath: string);
+}
+export declare class ModuleNotFoundError extends CliError {
+    constructor(moduleName: string);
+}
+export declare class EntityNotFoundError extends CliError {
+    constructor(entityName: string, moduleName?: string);
+}
+export declare class InvalidFieldError extends CliError {
+    constructor(fieldStr: string, reason: string);
+}
+export declare class DuplicateEntityError extends CliError {
+    constructor(entityName: string, existingPath: string);
+}
+export declare class CircularDependencyError extends CliError {
+    constructor(chain: string[]);
+}
+export declare class TemplateError extends CliError {
+    constructor(templateName: string, reason: string);
+}
+export declare class ConfigurationError extends CliError {
+    constructor(message: string, configKey?: string);
+}
+export declare class RelationError extends CliError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class SchemaError extends CliError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class GenerationError extends CliError {
+    constructor(message: string, details?: Record<string, any>);
+}
+/**
+ * Error codes for structured error handling
+ */
+export declare const ErrorCodes: {
+    readonly VALIDATION_ERROR: "E1000";
+    readonly INVALID_FIELD: "E1001";
+    readonly INVALID_NAME: "E1002";
+    readonly INVALID_TYPE: "E1003";
+    readonly MISSING_REQUIRED: "E1004";
+    readonly SCHEMA_INVALID: "E1005";
+    readonly FILE_NOT_FOUND: "E2000";
+    readonly FILE_EXISTS: "E2001";
+    readonly FILE_WRITE_ERROR: "E2002";
+    readonly FILE_READ_ERROR: "E2003";
+    readonly DIRECTORY_NOT_FOUND: "E2004";
+    readonly ENTITY_NOT_FOUND: "E3000";
+    readonly DUPLICATE_ENTITY: "E3001";
+    readonly ENTITY_INVALID: "E3002";
+    readonly MODULE_NOT_FOUND: "E4000";
+    readonly DUPLICATE_MODULE: "E4001";
+    readonly MODULE_INVALID: "E4002";
+    readonly RELATION_ERROR: "E5000";
+    readonly CIRCULAR_DEPENDENCY: "E5001";
+    readonly INVALID_RELATION_TYPE: "E5002";
+    readonly MISSING_INVERSE_SIDE: "E5003";
+    readonly TEMPLATE_ERROR: "E6000";
+    readonly TEMPLATE_NOT_FOUND: "E6001";
+    readonly TEMPLATE_PARSE_ERROR: "E6002";
+    readonly CONFIGURATION_ERROR: "E7000";
+    readonly CONFIG_NOT_FOUND: "E7001";
+    readonly CONFIG_INVALID: "E7002";
+    readonly GENERATION_ERROR: "E8000";
+    readonly GENERATION_FAILED: "E8001";
+    readonly ROLLBACK_FAILED: "E8002";
+};
+/**
+ * Error handler for consistent error output
+ */
+export interface ErrorHandler {
+    handle(error: Error): void;
+    format(error: Error): string;
+}
+/**
+ * Default error handler with chalk output
+ */
+export declare function createErrorHandler(options?: {
+    verbose?: boolean;
+}): ErrorHandler;
+/**
+ * Domain Exception Templates
+ * These are templates for generated domain exceptions
+ * SECURITY: Designed to prevent information disclosure (OWASP A01:2021)
+ */
+export declare const DomainExceptionTemplates: {
+    entityNotFound: (entityName: string) => string;
+    entityAlreadyExists: (entityName: string) => string;
+    validationFailed: (entityName: string) => string;
+    operationFailed: (entityName: string) => string;
+    domainException: (entityName: string) => string;
+};
+/**
+ * Generate domain exceptions for an entity
+ */
+export declare function generateDomainExceptions(entityName: string): string;
+/**
+ * Error result type for operations that can fail
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export declare function ok<T>(data: T): Result<T, never>;
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Try-catch wrapper returning Result type
+ */
+export declare function tryAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;
+export declare function trySync<T>(fn: () => T): Result<T, Error>;

package/dist/utils/error.utils.js

@@ -0,0 +1,422 @@
+"use strict";
+/**
+ * Unified Error & Exception Framework
+ * Provides centralized exception handling for CLI and generated code
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainExceptionTemplates = exports.ErrorCodes = exports.GenerationError = exports.SchemaError = exports.RelationError = exports.ConfigurationError = exports.TemplateError = exports.CircularDependencyError = exports.DuplicateEntityError = exports.InvalidFieldError = exports.EntityNotFoundError = exports.ModuleNotFoundError = exports.FileExistsError = exports.FileNotFoundError = exports.ValidationError = exports.CliError = void 0;
+exports.createErrorHandler = createErrorHandler;
+exports.generateDomainExceptions = generateDomainExceptions;
+exports.ok = ok;
+exports.err = err;
+exports.tryAsync = tryAsync;
+exports.trySync = trySync;
+/**
+ * Base CLI Error with error codes
+ */
+class CliError extends Error {
+    constructor(message, code, options) {
+        super(message);
+        this.name = 'CliError';
+        this.code = code;
+        this.details = options?.details;
+        this.suggestion = options?.suggestion;
+        this.cause = options?.cause;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            suggestion: this.suggestion,
+        };
+    }
+}
+exports.CliError = CliError;
+// Specific error classes
+class ValidationError extends CliError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', { details });
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class FileNotFoundError extends CliError {
+    constructor(filePath) {
+        super(`File not found: ${filePath}`, 'FILE_NOT_FOUND', {
+            details: { filePath },
+            suggestion: `Ensure the file exists at the specified path`,
+        });
+        this.name = 'FileNotFoundError';
+    }
+}
+exports.FileNotFoundError = FileNotFoundError;
+class FileExistsError extends CliError {
+    constructor(filePath) {
+        super(`File already exists: ${filePath}`, 'FILE_EXISTS', {
+            details: { filePath },
+            suggestion: `Use --force to overwrite or choose a different name`,
+        });
+        this.name = 'FileExistsError';
+    }
+}
+exports.FileExistsError = FileExistsError;
+class ModuleNotFoundError extends CliError {
+    constructor(moduleName) {
+        super(`Module not found: ${moduleName}`, 'MODULE_NOT_FOUND', {
+            details: { moduleName },
+            suggestion: `Create the module first with: ddd g module ${moduleName}`,
+        });
+        this.name = 'ModuleNotFoundError';
+    }
+}
+exports.ModuleNotFoundError = ModuleNotFoundError;
+class EntityNotFoundError extends CliError {
+    constructor(entityName, moduleName) {
+        super(`Entity not found: ${entityName}`, 'ENTITY_NOT_FOUND', {
+            details: { entityName, moduleName },
+            suggestion: moduleName
+                ? `Create the entity first with: ddd g entity ${entityName} -m ${moduleName}`
+                : `Create the entity first with: ddd g entity ${entityName}`,
+        });
+        this.name = 'EntityNotFoundError';
+    }
+}
+exports.EntityNotFoundError = EntityNotFoundError;
+class InvalidFieldError extends CliError {
+    constructor(fieldStr, reason) {
+        super(`Invalid field definition: ${fieldStr}`, 'INVALID_FIELD', {
+            details: { fieldStr, reason },
+            suggestion: `Use format: name:type:modifier (e.g., email:string:unique)`,
+        });
+        this.name = 'InvalidFieldError';
+    }
+}
+exports.InvalidFieldError = InvalidFieldError;
+class DuplicateEntityError extends CliError {
+    constructor(entityName, existingPath) {
+        super(`Entity already exists: ${entityName}`, 'DUPLICATE_ENTITY', {
+            details: { entityName, existingPath },
+            suggestion: `Use a different name or remove the existing entity first`,
+        });
+        this.name = 'DuplicateEntityError';
+    }
+}
+exports.DuplicateEntityError = DuplicateEntityError;
+class CircularDependencyError extends CliError {
+    constructor(chain) {
+        super(`Circular dependency detected: ${chain.join(' -> ')}`, 'CIRCULAR_DEPENDENCY', {
+            details: { chain },
+            suggestion: `Break the cycle by introducing an interface or restructuring the modules`,
+        });
+        this.name = 'CircularDependencyError';
+    }
+}
+exports.CircularDependencyError = CircularDependencyError;
+class TemplateError extends CliError {
+    constructor(templateName, reason) {
+        super(`Template error in ${templateName}: ${reason}`, 'TEMPLATE_ERROR', {
+            details: { templateName, reason },
+        });
+        this.name = 'TemplateError';
+    }
+}
+exports.TemplateError = TemplateError;
+class ConfigurationError extends CliError {
+    constructor(message, configKey) {
+        super(message, 'CONFIGURATION_ERROR', {
+            details: { configKey },
+            suggestion: `Check your .dddrc.json configuration file`,
+        });
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class RelationError extends CliError {
+    constructor(message, details) {
+        super(message, 'RELATION_ERROR', {
+            details,
+            suggestion: `Ensure both entities exist and relation types are compatible`,
+        });
+        this.name = 'RelationError';
+    }
+}
+exports.RelationError = RelationError;
+class SchemaError extends CliError {
+    constructor(message, details) {
+        super(message, 'SCHEMA_ERROR', { details });
+        this.name = 'SchemaError';
+    }
+}
+exports.SchemaError = SchemaError;
+class GenerationError extends CliError {
+    constructor(message, details) {
+        super(message, 'GENERATION_ERROR', { details });
+        this.name = 'GenerationError';
+    }
+}
+exports.GenerationError = GenerationError;
+/**
+ * Error codes for structured error handling
+ */
+exports.ErrorCodes = {
+    // Validation errors (1xxx)
+    VALIDATION_ERROR: 'E1000',
+    INVALID_FIELD: 'E1001',
+    INVALID_NAME: 'E1002',
+    INVALID_TYPE: 'E1003',
+    MISSING_REQUIRED: 'E1004',
+    SCHEMA_INVALID: 'E1005',
+    // File errors (2xxx)
+    FILE_NOT_FOUND: 'E2000',
+    FILE_EXISTS: 'E2001',
+    FILE_WRITE_ERROR: 'E2002',
+    FILE_READ_ERROR: 'E2003',
+    DIRECTORY_NOT_FOUND: 'E2004',
+    // Entity errors (3xxx)
+    ENTITY_NOT_FOUND: 'E3000',
+    DUPLICATE_ENTITY: 'E3001',
+    ENTITY_INVALID: 'E3002',
+    // Module errors (4xxx)
+    MODULE_NOT_FOUND: 'E4000',
+    DUPLICATE_MODULE: 'E4001',
+    MODULE_INVALID: 'E4002',
+    // Relation errors (5xxx)
+    RELATION_ERROR: 'E5000',
+    CIRCULAR_DEPENDENCY: 'E5001',
+    INVALID_RELATION_TYPE: 'E5002',
+    MISSING_INVERSE_SIDE: 'E5003',
+    // Template errors (6xxx)
+    TEMPLATE_ERROR: 'E6000',
+    TEMPLATE_NOT_FOUND: 'E6001',
+    TEMPLATE_PARSE_ERROR: 'E6002',
+    // Configuration errors (7xxx)
+    CONFIGURATION_ERROR: 'E7000',
+    CONFIG_NOT_FOUND: 'E7001',
+    CONFIG_INVALID: 'E7002',
+    // Generation errors (8xxx)
+    GENERATION_ERROR: 'E8000',
+    GENERATION_FAILED: 'E8001',
+    ROLLBACK_FAILED: 'E8002',
+};
+/**
+ * Default error handler with chalk output
+ */
+function createErrorHandler(options = {}) {
+    return {
+        handle(error) {
+            console.error(this.format(error));
+            if (options.verbose && error.stack) {
+                console.error(error.stack);
+            }
+        },
+        format(error) {
+            if (error instanceof CliError) {
+                let msg = `Error [${error.code}]: ${error.message}`;
+                if (error.suggestion) {
+                    msg += `\n  Suggestion: ${error.suggestion}`;
+                }
+                if (options.verbose && error.details) {
+                    msg += `\n  Details: ${JSON.stringify(error.details, null, 2)}`;
+                }
+                return msg;
+            }
+            return `Error: ${error.message}`;
+        },
+    };
+}
+/**
+ * Domain Exception Templates
+ * These are templates for generated domain exceptions
+ * SECURITY: Designed to prevent information disclosure (OWASP A01:2021)
+ */
+exports.DomainExceptionTemplates = {
+    entityNotFound: (entityName) => `
+import { NotFoundException, Logger } from '@nestjs/common';
+
+export class ${entityName}NotFoundException extends NotFoundException {
+  private readonly logger = new Logger(${entityName}NotFoundException.name);
+
+  constructor(id: string) {
+    // Don't expose internal IDs in production
+    const isProduction = process.env.NODE_ENV === 'production';
+    const message = isProduction
+      ? '${entityName} not found'
+      : \`${entityName} with id \${id} not found\`;
+
+    super(message);
+
+    // Log the actual ID for debugging
+    this.logger.debug(\`${entityName} not found: \${id}\`);
+  }
+}
+`,
+    entityAlreadyExists: (entityName) => `
+import { ConflictException, Logger } from '@nestjs/common';
+
+export class ${entityName}AlreadyExistsException extends ConflictException {
+  private readonly logger = new Logger(${entityName}AlreadyExistsException.name);
+
+  constructor(identifier: string) {
+    // Don't expose which field/value conflicts in production
+    const isProduction = process.env.NODE_ENV === 'production';
+    const message = isProduction
+      ? '${entityName} already exists'
+      : \`${entityName} with identifier \${identifier} already exists\`;
+
+    super(message);
+    this.logger.debug(\`${entityName} conflict: \${identifier}\`);
+  }
+}
+`,
+    validationFailed: (entityName) => `
+import { BadRequestException, Logger } from '@nestjs/common';
+
+export class ${entityName}ValidationException extends BadRequestException {
+  private readonly logger = new Logger(${entityName}ValidationException.name);
+
+  constructor(errors: string[]) {
+    // In production, provide generic message; in dev, show field errors
+    const isProduction = process.env.NODE_ENV === 'production';
+    const message = isProduction
+      ? { message: 'Validation failed', errorCount: errors.length }
+      : { message: '${entityName} validation failed', errors };
+
+    super(message);
+    this.logger.debug(\`Validation errors: \${errors.join(', ')}\`);
+  }
+}
+`,
+    operationFailed: (entityName) => `
+import { InternalServerErrorException, Logger } from '@nestjs/common';
+
+export class ${entityName}OperationFailedException extends InternalServerErrorException {
+  private readonly logger = new Logger(${entityName}OperationFailedException.name);
+
+  constructor(operation: string, reason?: string) {
+    // NEVER expose internal error details to client in production
+    const isProduction = process.env.NODE_ENV === 'production';
+    const clientMessage = isProduction
+      ? 'An error occurred processing your request'
+      : \`${entityName} \${operation} failed\`;
+
+    super(clientMessage);
+
+    // Log the actual reason for debugging
+    this.logger.error(\`${entityName} \${operation} failed: \${reason || 'unknown'}\`);
+  }
+}
+`,
+    domainException: (entityName) => `
+import { HttpException, HttpStatus, Logger } from '@nestjs/common';
+
+/**
+ * Base domain exception with secure error handling
+ * Does not expose internal details in production
+ */
+export abstract class ${entityName}DomainException extends HttpException {
+  protected readonly logger = new Logger(${entityName}DomainException.name);
+  protected readonly isProduction = process.env.NODE_ENV === 'production';
+
+  constructor(
+    publicMessage: string,
+    internalMessage: string,
+    status: HttpStatus = HttpStatus.BAD_REQUEST
+  ) {
+    // Use generic message in production
+    super(
+      process.env.NODE_ENV === 'production' ? publicMessage : internalMessage,
+      status
+    );
+
+    // Always log the internal message for debugging
+    this.logger.debug(internalMessage);
+  }
+}
+
+export class ${entityName}NotFoundException extends ${entityName}DomainException {
+  constructor(id: string) {
+    super(
+      '${entityName} not found',
+      \`${entityName} with id \${id} not found\`,
+      HttpStatus.NOT_FOUND
+    );
+  }
+}
+
+export class ${entityName}AlreadyExistsException extends ${entityName}DomainException {
+  constructor(field: string, value: string) {
+    super(
+      '${entityName} already exists',
+      \`${entityName} with \${field} '\${value}' already exists\`,
+      HttpStatus.CONFLICT
+    );
+  }
+}
+
+export class ${entityName}ValidationException extends ${entityName}DomainException {
+  constructor(errors: string[]) {
+    super(
+      'Validation failed',
+      \`Validation failed: \${errors.join(', ')}\`,
+      HttpStatus.BAD_REQUEST
+    );
+  }
+}
+
+export class ${entityName}InvalidStateException extends ${entityName}DomainException {
+  constructor(currentState: string, expectedState: string) {
+    super(
+      'Operation not allowed',
+      \`Cannot perform operation: ${entityName} is in '\${currentState}' state, expected '\${expectedState}'\`,
+      HttpStatus.UNPROCESSABLE_ENTITY
+    );
+  }
+}
+
+export class ${entityName}UnauthorizedException extends ${entityName}DomainException {
+  constructor(action: string) {
+    super(
+      'Unauthorized',
+      \`Unauthorized to \${action} ${entityName}\`,
+      HttpStatus.FORBIDDEN
+    );
+  }
+}
+`,
+};
+/**
+ * Generate domain exceptions for an entity
+ */
+function generateDomainExceptions(entityName) {
+    return exports.DomainExceptionTemplates.domainException(entityName);
+}
+function ok(data) {
+    return { success: true, data };
+}
+function err(error) {
+    return { success: false, error };
+}
+/**
+ * Try-catch wrapper returning Result type
+ */
+async function tryAsync(fn) {
+    try {
+        const data = await fn();
+        return ok(data);
+    }
+    catch (error) {
+        return err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+function trySync(fn) {
+    try {
+        const data = fn();
+        return ok(data);
+    }
+    catch (error) {
+        return err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+//# sourceMappingURL=error.utils.js.map

package/dist/utils/error.utils.js.map

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

package/dist/utils/field.utils.d.ts

@@ -0,0 +1,54 @@
+export interface FieldDefinition {
+    name: string;
+    camelCase: string;
+    snakeCase: string;
+    pascalCase: string;
+    type: string;
+    tsType: string;
+    dbType: string;
+    prismaType: string;
+    isRequired: boolean;
+    isOptional: boolean;
+    isUnique: boolean;
+    isArray: boolean;
+    validators: string[];
+    description: string;
+    example?: string;
+    defaultValue?: string;
+    enumValues?: string[];
+    isRelation: boolean;
+    relationType?: 'OneToOne' | 'OneToMany' | 'ManyToOne' | 'ManyToMany';
+    relationTarget?: string;
+    relationInverse?: string;
+}
+export interface ParsedFields {
+    fields: FieldDefinition[];
+    hasEmail: boolean;
+    hasDate: boolean;
+    hasEnum: boolean;
+    hasRelation: boolean;
+}
+/**
+ * Parse field definitions from CLI --fields flag
+ * Format: "name:type:modifier1:modifier2"
+ *
+ * Examples:
+ *   "name:string"                    -> required string
+ *   "email:string:unique"            -> required unique string with IsEmail
+ *   "age:number:optional"            -> optional number
+ *   "status:enum:active,inactive"    -> enum with values
+ *   "tags:string[]"                  -> string array
+ *   "userId:uuid:relation"           -> foreign key relation
+ */
+export declare function parseFields(fieldsString: string): ParsedFields;
+/**
+ * Generate field-aware template data
+ */
+export declare function generateFieldsTemplateData(fields: FieldDefinition[]): {
+    entityProperties: string;
+    entityPropsInterface: string;
+    dtoProperties: string;
+    ormColumns: string;
+    migrationColumns: string;
+    responseProperties: string;
+};