@veloxts/cli 0.4.2 → 0.4.4

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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"}

package/dist/seeding/registry.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Seeder Registry
+ *
+ * Manages seeder registration and dependency resolution with topological sorting.
+ */
+import type { Environment, Seeder } from './types.js';
+/**
+ * Registry for managing seeders with dependency resolution.
+ *
+ * Handles seeder registration, retrieval, and ordering based on dependencies
+ * using topological sorting.
+ *
+ * @example
+ * ```typescript
+ * const registry = new SeederRegistry();
+ *
+ * registry.register(UserSeeder);
+ * registry.register(PostSeeder);  // depends on UserSeeder
+ *
+ * // Get seeders in correct execution order
+ * const ordered = registry.getInOrder();
+ * ```
+ */
+export declare class SeederRegistry {
+    private seeders;
+    /**
+     * Register a seeder in the registry.
+     *
+     * @param seeder - Seeder to register
+     * @throws Error if seeder with same name already exists
+     */
+    register(seeder: Seeder): void;
+    /**
+     * Register multiple seeders.
+     *
+     * @param seeders - Seeders to register
+     */
+    registerMany(seeders: Seeder[]): void;
+    /**
+     * Get a seeder by name.
+     *
+     * @param name - Seeder name
+     * @returns Seeder if found, undefined otherwise
+     */
+    get(name: string): Seeder | undefined;
+    /**
+     * Get a seeder by name, throwing if not found.
+     *
+     * @param name - Seeder name
+     * @returns Seeder
+     * @throws SeederError if not found
+     */
+    getOrThrow(name: string): Seeder;
+    /**
+     * Check if a seeder exists.
+     *
+     * @param name - Seeder name
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered seeder names.
+     */
+    getNames(): string[];
+    /**
+     * Get all registered seeders.
+     */
+    getAll(): Seeder[];
+    /**
+     * Get seeder count.
+     */
+    get size(): number;
+    /**
+     * Clear all registered seeders.
+     */
+    clear(): void;
+    /**
+     * Validate all seeder dependencies exist and there are no circular dependencies.
+     *
+     * @throws SeederError if dependencies are invalid
+     */
+    validateDependencies(): void;
+    /**
+     * Get all seeders in dependency order (topological sort).
+     *
+     * Seeders with no dependencies come first, then seeders that depend on them, etc.
+     *
+     * @param environment - Optional environment filter
+     * @returns Seeders in execution order
+     * @throws SeederError if circular dependency detected
+     */
+    getInOrder(environment?: Environment): Seeder[];
+    /**
+     * Get seeders filtered by names in dependency order.
+     *
+     * @param names - Seeder names to include (and their dependencies)
+     * @param environment - Optional environment filter
+     */
+    getByNames(names: string[], environment?: Environment): Seeder[];
+    /**
+     * Check if seeder should run in given environment.
+     */
+    private shouldRunInEnvironment;
+    /**
+     * Detect circular dependencies using DFS.
+     */
+    private detectCircularDependencies;
+    /**
+     * DFS helper for cycle detection.
+     */
+    private detectCycleDFS;
+    /**
+     * Find and return a cycle starting from the given node.
+     */
+    private findCycle;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/seeding/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMtD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO9B;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQhC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,oBAAoB,IAAI,IAAI;IAc5B;;;;;;;;OAQG;IACH,UAAU,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE;IAmE/C;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE;IAgChE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,SAAS;CAgClB"}