@veloxts/cli 0.4.2 → 0.4.3

package/dist/seeding/factory.js

@@ -0,0 +1,250 @@
+/**
+ * Factory System
+ *
+ * Base factory class and registry for generating fake data.
+ */
+import { factoryCreateFailed, stateNotFound } from './errors.js';
+// ============================================================================
+// Base Factory
+// ============================================================================
+/**
+ * Abstract base class for model factories.
+ *
+ * Provides a fluent API for creating model instances with fake data
+ * and named state variations.
+ *
+ * @template TInput - The input type for creating records
+ * @template TOutput - The output type returned from database (defaults to TInput)
+ *
+ * @example
+ * ```typescript
+ * import { BaseFactory } from '@veloxts/cli';
+ * import { faker } from '@faker-js/faker';
+ *
+ * interface UserInput {
+ *   email: string;
+ *   name: string;
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * export class UserFactory extends BaseFactory<UserInput> {
+ *   modelName = 'user';
+ *
+ *   definition(): UserInput {
+ *     return {
+ *       email: faker.internet.email(),
+ *       name: faker.person.fullName(),
+ *       role: 'user',
+ *     };
+ *   }
+ *
+ *   admin(): this {
+ *     return this.state('admin');
+ *   }
+ *
+ *   constructor(prisma: PrismaClientLike) {
+ *     super(prisma);
+ *     this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+ *   }
+ * }
+ * ```
+ */
+export class BaseFactory {
+    /** Map of registered state modifiers */
+    states = new Map();
+    /** Currently active state names */
+    activeStates = [];
+    /** Prisma client for database operations */
+    prisma;
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    // ==========================================================================
+    // State Management
+    // ==========================================================================
+    /**
+     * Register a named state modifier.
+     *
+     * @param name - State name (e.g., 'admin', 'verified')
+     * @param modifier - Function that modifies attributes
+     * @returns this for chaining during construction
+     *
+     * @example
+     * ```typescript
+     * constructor(prisma: PrismaClientLike) {
+     *   super(prisma);
+     *   this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+     *   this.registerState('unverified', (attrs) => ({ ...attrs, emailVerified: null }));
+     * }
+     * ```
+     */
+    registerState(name, modifier) {
+        this.states.set(name, modifier);
+        return this;
+    }
+    /**
+     * Apply a named state modifier.
+     * Returns a new factory instance with the state applied.
+     *
+     * @param name - State name to apply
+     * @returns New factory instance with state active (preserves subclass type)
+     *
+     * @example
+     * ```typescript
+     * // Create an admin user
+     * await factory.get(UserFactory).state('admin').create();
+     *
+     * // Chain multiple states
+     * await factory.get(UserFactory).state('admin').state('verified').create();
+     *
+     * // Subclass methods preserved after state()
+     * const factory = new UserFactory(prisma);
+     * await factory.state('verified').admin().create(); // admin() still accessible
+     * ```
+     */
+    state(name) {
+        if (!this.states.has(name)) {
+            throw stateNotFound(this.constructor.name, name, Array.from(this.states.keys()));
+        }
+        // Create a shallow clone with the state added
+        const clone = Object.create(Object.getPrototypeOf(this));
+        Object.assign(clone, this);
+        clone.states = new Map(this.states);
+        clone.activeStates = [...this.activeStates, name];
+        return clone;
+    }
+    /**
+     * Get list of available state names.
+     */
+    getAvailableStates() {
+        return Array.from(this.states.keys());
+    }
+    // ==========================================================================
+    // Make (without persisting)
+    // ==========================================================================
+    /**
+     * Make a single instance without persisting to database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Generated attributes
+     */
+    make(overrides) {
+        return this.buildAttributes(overrides);
+    }
+    /**
+     * Make multiple instances without persisting to database.
+     *
+     * @param count - Number of instances to make
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of generated attributes
+     */
+    makeMany(count, overrides) {
+        return Array.from({ length: count }, () => this.buildAttributes(overrides));
+    }
+    // ==========================================================================
+    // Create (persist to database)
+    // ==========================================================================
+    /**
+     * Create a single instance in the database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Created database record
+     */
+    async create(overrides) {
+        const data = this.buildAttributes(overrides);
+        try {
+            // Access Prisma model dynamically with type-safe casting
+            // We use unknown as intermediate to avoid any, then cast to our defined type
+            const prismaWithModels = this.prisma;
+            const model = prismaWithModels[this.modelName];
+            if (!model || typeof model.create !== 'function') {
+                throw new Error(`Model '${this.modelName}' not found on Prisma client`);
+            }
+            return await model.create({ data });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            throw factoryCreateFailed(this.modelName, err);
+        }
+    }
+    /**
+     * Create multiple instances in the database.
+     *
+     * @param count - Number of instances to create
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of created database records
+     */
+    async createMany(count, overrides) {
+        const results = [];
+        // Create individually to get all returned records
+        // (createMany doesn't return created records in some databases)
+        for (let i = 0; i < count; i++) {
+            const record = await this.create(overrides);
+            results.push(record);
+        }
+        return results;
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    /**
+     * Build attributes by applying definition, states, and overrides.
+     */
+    buildAttributes(overrides) {
+        // Start with definition
+        let attrs = this.definition();
+        // Apply active states in order
+        for (const stateName of this.activeStates) {
+            const modifier = this.states.get(stateName);
+            if (modifier) {
+                attrs = { ...attrs, ...modifier(attrs) };
+            }
+        }
+        // Apply overrides last
+        if (overrides) {
+            attrs = { ...attrs, ...overrides };
+        }
+        return attrs;
+    }
+}
+// ============================================================================
+// Factory Registry
+// ============================================================================
+/**
+ * Create a factory registry for managing factory instances.
+ *
+ * The registry caches factory instances and provides type-safe access.
+ *
+ * @param prisma - Prisma client to inject into factories
+ * @returns Factory registry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createFactoryRegistry(prisma);
+ *
+ * // Get or create factory instance
+ * const userFactory = registry.get(UserFactory);
+ * await userFactory.create();
+ * ```
+ */
+export function createFactoryRegistry(prisma) {
+    // Use unknown for type-erased storage, similar to AnyGenerator pattern
+    const instances = new Map();
+    return {
+        get(FactoryClass) {
+            // Check cache first
+            let instance = instances.get(FactoryClass);
+            if (!instance) {
+                // Create new instance
+                instance = new FactoryClass(prisma);
+                instances.set(FactoryClass, instance);
+            }
+            // Type safety is maintained by the generic constraints on FactoryClass
+            return instance;
+        },
+        clear() {
+            instances.clear();
+        },
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/seeding/factory.js.map

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

package/dist/seeding/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @veloxts/cli - Database Seeding Module
+ *
+ * Laravel-inspired database seeding system with factories and seeders.
+ *
+ * @example
+ * ```typescript
+ * // In a seeder file (src/database/seeders/UserSeeder.ts)
+ * import type { Seeder, SeederContext } from '@veloxts/cli';
+ * import { UserFactory } from '../factories/UserFactory.js';
+ *
+ * export const UserSeeder: Seeder = {
+ *   name: 'UserSeeder',
+ *   dependencies: [],
+ *
+ *   async run({ db, factory, log }) {
+ *     await factory.get(UserFactory).createMany(10);
+ *     log.success('Created 10 users');
+ *   },
+ * };
+ * ```
+ *
+ * @module @veloxts/cli/seeding
+ */
+export type { BatchSeederResult, Environment, Factory, FactoryConstructor, FactoryRegistry, LoadedSeeder, PrismaClientLike, SeedCommandOptions, Seeder, SeederContext, SeederLoadResult, SeederLogger, SeederResult, SeederRunOptions, StateModifier, } from './types.js';
+export { circularDependency, dependencyNotFound, executionFailed, FactoryError, factoryCreateFailed, factoryNotFound, filesystemError, invalidExport, noSeedersFound, SeederError, SeederErrorCode, seederDatabaseError, seederNotFound, stateNotFound, truncationFailed, } from './errors.js';
+export { BaseFactory, createFactoryRegistry } from './factory.js';
+export { loadSeeders, seedersDirectoryExists } from './loader.js';
+export { SeederRegistry } from './registry.js';
+export { SeederRunner } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,YAAY,EACV,iBAAiB,EAEjB,WAAW,EAEX,OAAO,EACP,kBAAkB,EAClB,eAAe,EAEf,YAAY,EAEZ,gBAAgB,EAEhB,kBAAkB,EAElB,MAAM,EACN,aAAa,EACb,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB,EAEnB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMlE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/seeding/index.js

@@ -0,0 +1,41 @@
+/**
+ * @veloxts/cli - Database Seeding Module
+ *
+ * Laravel-inspired database seeding system with factories and seeders.
+ *
+ * @example
+ * ```typescript
+ * // In a seeder file (src/database/seeders/UserSeeder.ts)
+ * import type { Seeder, SeederContext } from '@veloxts/cli';
+ * import { UserFactory } from '../factories/UserFactory.js';
+ *
+ * export const UserSeeder: Seeder = {
+ *   name: 'UserSeeder',
+ *   dependencies: [],
+ *
+ *   async run({ db, factory, log }) {
+ *     await factory.get(UserFactory).createMany(10);
+ *     log.success('Created 10 users');
+ *   },
+ * };
+ * ```
+ *
+ * @module @veloxts/cli/seeding
+ */
+// ============================================================================
+// Errors
+// ============================================================================
+export { circularDependency, dependencyNotFound, executionFailed, FactoryError, factoryCreateFailed, factoryNotFound, filesystemError, invalidExport, noSeedersFound, SeederError, SeederErrorCode, seederDatabaseError, 
+// Error factory functions
+seederNotFound, stateNotFound, truncationFailed, } from './errors.js';
+// ============================================================================
+// Factory System
+// ============================================================================
+export { BaseFactory, createFactoryRegistry } from './factory.js';
+// ============================================================================
+// Seeder Infrastructure
+// ============================================================================
+export { loadSeeders, seedersDirectoryExists } from './loader.js';
+export { SeederRegistry } from './registry.js';
+export { SeederRunner } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/seeding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA+BH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB;AACnB,0BAA0B;AAC1B,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAElE,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/seeding/loader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Seeder Loader
+ *
+ * Load seeder files from the filesystem.
+ */
+import type { Seeder, SeederLoadResult } from './types.js';
+/**
+ * Default path for seeders relative to project root
+ */
+export declare const DEFAULT_SEEDERS_PATH = "src/database/seeders";
+/**
+ * Check if seeders directory exists.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export declare function seedersDirectoryExists(cwd: string, seedersPath?: string): Promise<boolean>;
+/**
+ * Load all seeders from the filesystem.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns Load result with seeders and any errors
+ */
+export declare function loadSeeders(cwd: string, seedersPath?: string): Promise<SeederLoadResult>;
+/**
+ * Load the main DatabaseSeeder entry point.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns DatabaseSeeder if found, null otherwise
+ */
+export declare function loadDatabaseSeeder(cwd: string, seedersPath?: string): Promise<Seeder | null>;
+/**
+ * Get all seeder file paths from directory.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export declare function getSeederFiles(cwd: string, seedersPath?: string): Promise<string[]>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/seeding/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAgB,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMzE;;GAEG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAgB3D;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAiGD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB"}

package/dist/seeding/loader.js

@@ -0,0 +1,210 @@
+/**
+ * Seeder Loader
+ *
+ * Load seeder files from the filesystem.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { filesystemError, invalidExport } from './errors.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Default path for seeders relative to project root
+ */
+export const DEFAULT_SEEDERS_PATH = 'src/database/seeders';
+/**
+ * File patterns that indicate a seeder file
+ */
+const SEEDER_FILE_PATTERNS = [/Seeder\.(ts|js)$/, /\.seeder\.(ts|js)$/];
+/**
+ * Files to skip
+ */
+const SKIP_FILES = ['index.ts', 'index.js', 'DatabaseSeeder.ts', 'DatabaseSeeder.js'];
+// ============================================================================
+// Loader Functions
+// ============================================================================
+/**
+ * Check if seeders directory exists.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export async function seedersDirectoryExists(cwd, seedersPath = DEFAULT_SEEDERS_PATH) {
+    const fullPath = path.join(cwd, seedersPath);
+    try {
+        const stat = await fs.stat(fullPath);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Load all seeders from the filesystem.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns Load result with seeders and any errors
+ */
+export async function loadSeeders(cwd, seedersPath = DEFAULT_SEEDERS_PATH) {
+    const fullPath = path.join(cwd, seedersPath);
+    const seeders = [];
+    const errors = [];
+    // Check directory exists
+    if (!(await seedersDirectoryExists(cwd, seedersPath))) {
+        return { seeders: [], errors: [] };
+    }
+    // List files
+    let files;
+    try {
+        files = await fs.readdir(fullPath);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        throw filesystemError('reading seeders directory', fullPath, err);
+    }
+    // Filter to seeder files
+    const seederFiles = files.filter((file) => {
+        // Skip non-seeder files
+        if (SKIP_FILES.includes(file))
+            return false;
+        // Check if matches seeder pattern
+        return SEEDER_FILE_PATTERNS.some((pattern) => pattern.test(file));
+    });
+    // Load each seeder
+    for (const file of seederFiles) {
+        const filePath = path.join(fullPath, file);
+        try {
+            const seeder = await loadSeederFile(filePath);
+            seeders.push({ seeder, filePath });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push({ filePath, error: err.message });
+        }
+    }
+    return { seeders, errors };
+}
+/**
+ * Load the main DatabaseSeeder entry point.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ * @returns DatabaseSeeder if found, null otherwise
+ */
+export async function loadDatabaseSeeder(cwd, seedersPath = DEFAULT_SEEDERS_PATH) {
+    const fullPath = path.join(cwd, seedersPath);
+    // Try both .ts and .js extensions
+    for (const ext of ['ts', 'js']) {
+        const filePath = path.join(fullPath, `DatabaseSeeder.${ext}`);
+        try {
+            const stat = await fs.stat(filePath);
+            if (stat.isFile()) {
+                return await loadSeederFile(filePath);
+            }
+        }
+        catch {
+            // File doesn't exist, try next
+        }
+    }
+    return null;
+}
+/**
+ * Load a single seeder file.
+ *
+ * @param filePath - Absolute path to seeder file
+ * @returns Loaded seeder
+ */
+async function loadSeederFile(filePath) {
+    // Convert to file URL for dynamic import
+    const fileUrl = pathToFileURL(filePath).href;
+    // Dynamic import
+    let module;
+    try {
+        module = (await import(fileUrl));
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        throw invalidExport(filePath, `Failed to import: ${err.message}`);
+    }
+    // Look for seeder export
+    const seeder = findSeederExport(module);
+    if (!seeder) {
+        throw invalidExport(filePath, 'No valid seeder export found. Export a const named *Seeder or use default export.');
+    }
+    // Validate seeder shape
+    validateSeeder(seeder, filePath);
+    return seeder;
+}
+/**
+ * Find a seeder export in a module.
+ */
+function findSeederExport(module) {
+    // Check default export first
+    if (module.default && isSeederLike(module.default)) {
+        return module.default;
+    }
+    // Look for named export ending in 'Seeder'
+    for (const [key, value] of Object.entries(module)) {
+        if (key.endsWith('Seeder') && isSeederLike(value)) {
+            return value;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a value looks like a seeder.
+ */
+function isSeederLike(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    return typeof obj.name === 'string' && typeof obj.run === 'function';
+}
+/**
+ * Validate a seeder has the required shape.
+ */
+function validateSeeder(seeder, filePath) {
+    if (!seeder || typeof seeder !== 'object') {
+        throw invalidExport(filePath, 'Seeder must be an object');
+    }
+    const obj = seeder;
+    if (typeof obj.name !== 'string' || obj.name.length === 0) {
+        throw invalidExport(filePath, "Seeder must have a non-empty 'name' property");
+    }
+    if (typeof obj.run !== 'function') {
+        throw invalidExport(filePath, "Seeder must have a 'run' function");
+    }
+    if (obj.dependencies !== undefined && !Array.isArray(obj.dependencies)) {
+        throw invalidExport(filePath, "'dependencies' must be an array of strings");
+    }
+    if (obj.environments !== undefined && !Array.isArray(obj.environments)) {
+        throw invalidExport(filePath, "'environments' must be an array");
+    }
+    if (obj.truncate !== undefined && typeof obj.truncate !== 'function') {
+        throw invalidExport(filePath, "'truncate' must be a function");
+    }
+}
+/**
+ * Get all seeder file paths from directory.
+ *
+ * @param cwd - Project root directory
+ * @param seedersPath - Path to seeders directory (relative to cwd)
+ */
+export async function getSeederFiles(cwd, seedersPath = DEFAULT_SEEDERS_PATH) {
+    const fullPath = path.join(cwd, seedersPath);
+    if (!(await seedersDirectoryExists(cwd, seedersPath))) {
+        return [];
+    }
+    const files = await fs.readdir(fullPath);
+    return files
+        .filter((file) => {
+        if (SKIP_FILES.includes(file))
+            return false;
+        return SEEDER_FILE_PATTERNS.some((pattern) => pattern.test(file));
+    })
+        .map((file) => path.join(fullPath, file));
+}
+//# sourceMappingURL=loader.js.map

package/dist/seeding/loader.js.map

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