@veloxts/cli 0.4.2 → 0.4.3

package/dist/seeding/runner.js

@@ -0,0 +1,254 @@
+/**
+ * Seeder Runner
+ *
+ * Executes seeders with dependency resolution, logging, and error handling.
+ */
+import { executionFailed, seederDatabaseError, truncationFailed } from './errors.js';
+import { createFactoryRegistry } from './factory.js';
+// ============================================================================
+// Seeder Runner
+// ============================================================================
+/**
+ * Seeder execution runner.
+ *
+ * Handles running seeders in correct dependency order with proper
+ * context, logging, and error handling.
+ *
+ * @example
+ * ```typescript
+ * const runner = new SeederRunner(prisma, registry);
+ *
+ * // Run all seeders
+ * const result = await runner.runAll();
+ *
+ * // Run specific seeders
+ * const result = await runner.run(['UserSeeder', 'PostSeeder']);
+ *
+ * // Fresh seed (truncate first)
+ * const result = await runner.fresh();
+ * ```
+ */
+export class SeederRunner {
+    prisma;
+    registry;
+    factoryRegistry;
+    constructor(prisma, registry) {
+        this.prisma = prisma;
+        this.registry = registry;
+        this.factoryRegistry = createFactoryRegistry(prisma);
+    }
+    // ==========================================================================
+    // Public API
+    // ==========================================================================
+    /**
+     * Run all registered seeders in dependency order.
+     *
+     * @param options - Run options
+     * @returns Batch result with individual seeder results
+     */
+    async runAll(options = {}) {
+        const environment = options.environment ?? this.detectEnvironment();
+        const seeders = this.registry.getInOrder(environment);
+        return this.executeSeeders(seeders, options);
+    }
+    /**
+     * Run specific seeders by name (includes their dependencies).
+     *
+     * @param names - Seeder names to run
+     * @param options - Run options
+     * @returns Batch result with individual seeder results
+     */
+    async run(names, options = {}) {
+        const environment = options.environment ?? this.detectEnvironment();
+        const seeders = this.registry.getByNames(names, environment);
+        return this.executeSeeders(seeders, options);
+    }
+    /**
+     * Run seeders with fresh (truncate tables first).
+     *
+     * Calls truncate() on each seeder in reverse order, then runs them.
+     *
+     * @param options - Run options
+     * @returns Batch result with individual seeder results
+     */
+    async fresh(options = {}) {
+        const environment = options.environment ?? this.detectEnvironment();
+        const seeders = this.registry.getInOrder(environment);
+        // Truncate in reverse order (dependents first)
+        if (!options.dryRun) {
+            await this.truncateSeeders([...seeders].reverse(), options);
+        }
+        return this.executeSeeders(seeders, options);
+    }
+    // ==========================================================================
+    // Execution
+    // ==========================================================================
+    /**
+     * Execute a list of seeders in order.
+     */
+    async executeSeeders(seeders, options) {
+        const startTime = Date.now();
+        const results = [];
+        let successful = 0;
+        let failed = 0;
+        for (const seeder of seeders) {
+            const result = await this.executeSeeder(seeder, options);
+            results.push(result);
+            if (result.success) {
+                successful++;
+            }
+            else {
+                failed++;
+                // Stop on first failure to prevent cascading errors
+                break;
+            }
+        }
+        // Calculate skipped as seeders that weren't executed due to early failure
+        const skipped = seeders.length - results.length;
+        return {
+            results,
+            total: seeders.length,
+            successful,
+            failed,
+            skipped,
+            duration: Date.now() - startTime,
+        };
+    }
+    /**
+     * Execute a single seeder.
+     */
+    async executeSeeder(seeder, options) {
+        const startTime = Date.now();
+        // Dry run - just report what would run
+        if (options.dryRun) {
+            return {
+                name: seeder.name,
+                success: true,
+                duration: 0,
+            };
+        }
+        // Create context for this seeder
+        const context = this.createContext(seeder, options);
+        try {
+            await seeder.run(context);
+            return {
+                name: seeder.name,
+                success: true,
+                duration: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            return {
+                name: seeder.name,
+                success: false,
+                duration: Date.now() - startTime,
+                error: err.message,
+            };
+        }
+    }
+    /**
+     * Truncate tables for seeders that implement truncate().
+     */
+    async truncateSeeders(seeders, options) {
+        for (const seeder of seeders) {
+            if (seeder.truncate) {
+                const context = this.createContext(seeder, options);
+                try {
+                    await seeder.truncate(context);
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    throw truncationFailed(seeder.name, err);
+                }
+            }
+        }
+    }
+    // ==========================================================================
+    // Context Creation
+    // ==========================================================================
+    /**
+     * Create execution context for a seeder.
+     */
+    createContext(seeder, options) {
+        const environment = options.environment ?? this.detectEnvironment();
+        const log = this.createLogger(seeder.name, options);
+        // Capture `this` for runSeeder closure
+        const runner = this;
+        return {
+            db: this.prisma,
+            factory: this.factoryRegistry,
+            environment,
+            log,
+            async runSeeder(innerSeeder) {
+                const innerContext = runner.createContext(innerSeeder, options);
+                try {
+                    await innerSeeder.run(innerContext);
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    throw executionFailed(innerSeeder.name, err);
+                }
+            },
+        };
+    }
+    /**
+     * Create logger for a seeder.
+     */
+    createLogger(seederName, options) {
+        const prefix = `[${seederName}]`;
+        const verbose = options.verbose ?? false;
+        return {
+            info(message) {
+                console.log(`${prefix} ${message}`);
+            },
+            success(message) {
+                console.log(`${prefix} \u2714 ${message}`);
+            },
+            warning(message) {
+                console.log(`${prefix} \u26A0 ${message}`);
+            },
+            error(message) {
+                console.error(`${prefix} \u2718 ${message}`);
+            },
+            debug(message) {
+                if (verbose) {
+                    console.log(`${prefix} [debug] ${message}`);
+                }
+            },
+        };
+    }
+    // ==========================================================================
+    // Helpers
+    // ==========================================================================
+    /**
+     * Detect current environment from NODE_ENV.
+     */
+    detectEnvironment() {
+        const env = process.env.NODE_ENV;
+        switch (env) {
+            case 'production':
+                return 'production';
+            case 'test':
+                return 'test';
+            default:
+                return 'development';
+        }
+    }
+    /**
+     * Test database connection.
+     *
+     * @throws SeederError if connection fails
+     */
+    async testConnection() {
+        try {
+            // Execute a simple query to test connection
+            await this.prisma.$queryRaw `SELECT 1`;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            throw seederDatabaseError('connection test', err);
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/seeding/runner.js.map

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

package/dist/seeding/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Seeding Types
+ *
+ * Core type definitions for the VeloxTS database seeding system.
+ */
+import type { PrismaClientLike } from '../migrations/types.js';
+export type { PrismaClientLike };
+/**
+ * Valid environment names for seeder filtering
+ */
+export type Environment = 'development' | 'production' | 'test';
+/**
+ * Logger interface for seeder output
+ */
+export interface SeederLogger {
+    /** Log informational message */
+    info(message: string): void;
+    /** Log success message */
+    success(message: string): void;
+    /** Log warning message */
+    warning(message: string): void;
+    /** Log error message */
+    error(message: string): void;
+    /** Log debug message (only in verbose mode) */
+    debug(message: string): void;
+}
+/**
+ * Factory interface for creating model instances with fake data.
+ *
+ * @template TInput - The input type for creating records
+ * @template TOutput - The output type returned from database (defaults to TInput)
+ *
+ * @example
+ * ```typescript
+ * const users = await factory.get(UserFactory).create(10);
+ * const admin = await factory.get(UserFactory).state('admin').create();
+ * ```
+ */
+export interface Factory<TInput extends Record<string, unknown>, TOutput = TInput> {
+    /** Model name for Prisma operations (e.g., 'user', 'post') */
+    readonly modelName: string;
+    /** Define default attributes for new instances */
+    definition(): TInput;
+    /**
+     * Create a single instance in the database
+     * @param overrides - Attributes to override defaults
+     */
+    create(overrides?: Partial<TInput>): Promise<TOutput>;
+    /**
+     * Create multiple instances in the database
+     * @param count - Number of instances to create
+     * @param overrides - Attributes to override defaults for all instances
+     */
+    createMany(count: number, overrides?: Partial<TInput>): Promise<TOutput[]>;
+    /**
+     * Make a single instance without persisting to database
+     * @param overrides - Attributes to override defaults
+     */
+    make(overrides?: Partial<TInput>): TInput;
+    /**
+     * Make multiple instances without persisting to database
+     * @param count - Number of instances to make
+     * @param overrides - Attributes to override defaults for all instances
+     */
+    makeMany(count: number, overrides?: Partial<TInput>): TInput[];
+    /**
+     * Apply a named state modifier
+     * @param name - State name to apply
+     * @returns New factory instance with state applied
+     */
+    state(name: string): Factory<TInput, TOutput>;
+    /**
+     * Get list of available state names
+     */
+    getAvailableStates(): ReadonlyArray<string>;
+}
+/**
+ * State modifier function type
+ */
+export type StateModifier<TInput> = (attrs: TInput) => Partial<TInput>;
+/**
+ * Factory constructor type for registry
+ */
+export interface FactoryConstructor<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = TInput> {
+    new (prisma: PrismaClientLike): Factory<TInput, TOutput>;
+}
+/**
+ * Registry for managing factory instances
+ */
+export interface FactoryRegistry {
+    /**
+     * Get or create a factory instance
+     * @param FactoryClass - The factory constructor class
+     */
+    get<TInput extends Record<string, unknown>, TOutput = TInput>(FactoryClass: FactoryConstructor<TInput, TOutput>): Factory<TInput, TOutput>;
+    /**
+     * Clear all cached factory instances
+     */
+    clear(): void;
+}
+/**
+ * Context passed to seeders during execution.
+ *
+ * Provides access to database, factories, and logging utilities.
+ */
+export interface SeederContext {
+    /** Prisma client for database operations */
+    readonly db: PrismaClientLike;
+    /** Factory registry for creating fake data */
+    readonly factory: FactoryRegistry;
+    /** Current environment (development, production, test) */
+    readonly environment: Environment;
+    /** Logger for seeder output */
+    readonly log: SeederLogger;
+    /**
+     * Run another seeder (for composition)
+     * @param seeder - Seeder to run
+     */
+    runSeeder(seeder: Seeder): Promise<void>;
+}
+/**
+ * Base seeder interface - all seeders implement this.
+ *
+ * @example
+ * ```typescript
+ * export const UserSeeder: Seeder = {
+ *   name: 'UserSeeder',
+ *   dependencies: ['RoleSeeder'],
+ *
+ *   async run({ db, factory, log }) {
+ *     await factory.get(UserFactory).createMany(10);
+ *     log.success('Created 10 users');
+ *   },
+ * };
+ * ```
+ */
+export interface Seeder {
+    /** Unique seeder name (e.g., 'UserSeeder') */
+    readonly name: string;
+    /**
+     * Seeders that must run before this one.
+     * Used for dependency resolution and execution ordering.
+     */
+    readonly dependencies?: ReadonlyArray<string>;
+    /**
+     * Environments this seeder runs in.
+     * If not specified, runs in all environments.
+     */
+    readonly environments?: ReadonlyArray<Environment>;
+    /**
+     * Run the seeder - populate data.
+     * @param context - Seeder execution context
+     */
+    run(context: SeederContext): Promise<void>;
+    /**
+     * Optional: Truncate related tables before seeding.
+     * Called when running with --fresh flag.
+     * @param context - Seeder execution context
+     */
+    truncate?(context: SeederContext): Promise<void>;
+}
+/**
+ * Result of seeder execution
+ */
+export interface SeederResult {
+    /** Seeder name */
+    readonly name: string;
+    /** Whether execution succeeded */
+    readonly success: boolean;
+    /** Duration in milliseconds */
+    readonly duration: number;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Number of records created (if tracked) */
+    readonly recordsCreated?: number;
+}
+/**
+ * Result of batch seeder execution
+ */
+export interface BatchSeederResult {
+    /** Individual seeder results */
+    readonly results: ReadonlyArray<SeederResult>;
+    /** Total seeders executed */
+    readonly total: number;
+    /** Number of successful seeders */
+    readonly successful: number;
+    /** Number of failed seeders */
+    readonly failed: number;
+    /** Number of skipped seeders */
+    readonly skipped: number;
+    /** Total duration in milliseconds */
+    readonly duration: number;
+}
+/**
+ * Options for db:seed command
+ */
+export interface SeedCommandOptions {
+    /** Run truncate before seeding (fresh seed) */
+    readonly fresh?: boolean;
+    /** Run specific seeder class by name */
+    readonly class?: string;
+    /** Skip confirmation in production */
+    readonly force?: boolean;
+    /** Show what would run without executing */
+    readonly dryRun?: boolean;
+    /** Output as JSON */
+    readonly json?: boolean;
+    /** Verbose output */
+    readonly verbose?: boolean;
+}
+/**
+ * Options for seeder runner
+ */
+export interface SeederRunOptions {
+    /** Run truncate before seeding */
+    readonly fresh?: boolean;
+    /** Specific seeders to run (by name) */
+    readonly only?: ReadonlyArray<string>;
+    /** Show what would run without executing */
+    readonly dryRun?: boolean;
+    /** Verbose output */
+    readonly verbose?: boolean;
+    /** Current environment */
+    readonly environment?: Environment;
+}
+/**
+ * Loaded seeder from filesystem
+ */
+export interface LoadedSeeder {
+    /** Seeder instance */
+    readonly seeder: Seeder;
+    /** File path where seeder was loaded from */
+    readonly filePath: string;
+}
+/**
+ * Result of loading seeders from filesystem
+ */
+export interface SeederLoadResult {
+    /** Successfully loaded seeders */
+    readonly seeders: ReadonlyArray<LoadedSeeder>;
+    /** Files that failed to load */
+    readonly errors: ReadonlyArray<{
+        readonly filePath: string;
+        readonly error: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/seeding/types.d.ts.map

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

package/dist/seeding/types.js

@@ -0,0 +1,7 @@
+/**
+ * Seeding Types
+ *
+ * Core type definitions for the VeloxTS database seeding system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/seeding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/seeding/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/cli",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Developer tooling and CLI commands for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -34,11 +34,11 @@
     "picocolors": "1.1.1",
     "pluralize": "8.0.0",
     "tsx": "4.21.0",
-    "@veloxts/auth": "0.4.2",
-    "@veloxts/core": "0.4.2",
-    "@veloxts/orm": "0.4.2",
-    "@veloxts/router": "0.4.2",
-    "@veloxts/validation": "0.4.2"
+    "@veloxts/auth": "0.4.3",
+    "@veloxts/core": "0.4.3",
+    "@veloxts/orm": "0.4.3",
+    "@veloxts/router": "0.4.3",
+    "@veloxts/validation": "0.4.3"
   },
   "peerDependencies": {
     "@prisma/client": ">=5.0.0"