@veloxts/cli 0.4.2 → 0.4.4

package/dist/seeding/errors.js

@@ -0,0 +1,191 @@
+/**
+ * Seeding Errors
+ *
+ * Structured error classes for the VeloxTS database seeding system.
+ */
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * Error codes for seeding errors (for AI/tooling integration)
+ */
+export var SeederErrorCode;
+(function (SeederErrorCode) {
+    /** Seeder not found in registry */
+    SeederErrorCode["SEEDER_NOT_FOUND"] = "E3001";
+    /** Circular dependency detected between seeders */
+    SeederErrorCode["CIRCULAR_DEPENDENCY"] = "E3002";
+    /** Seeder execution failed */
+    SeederErrorCode["EXECUTION_FAILED"] = "E3003";
+    /** Truncation failed */
+    SeederErrorCode["TRUNCATION_FAILED"] = "E3004";
+    /** Invalid seeder configuration */
+    SeederErrorCode["INVALID_CONFIG"] = "E3005";
+    /** Seeder dependency not found */
+    SeederErrorCode["DEPENDENCY_NOT_FOUND"] = "E3006";
+    /** No seeders found in project */
+    SeederErrorCode["NO_SEEDERS_FOUND"] = "E3007";
+    /** Database connection failed */
+    SeederErrorCode["DATABASE_ERROR"] = "E3008";
+    /** Factory not found in registry */
+    SeederErrorCode["FACTORY_NOT_FOUND"] = "E3010";
+    /** Factory state not found */
+    SeederErrorCode["STATE_NOT_FOUND"] = "E3011";
+    /** Factory creation failed */
+    SeederErrorCode["FACTORY_CREATE_FAILED"] = "E3012";
+    /** Invalid factory configuration */
+    SeederErrorCode["INVALID_FACTORY"] = "E3013";
+    /** File system error during seeder loading */
+    SeederErrorCode["FILESYSTEM_ERROR"] = "E3020";
+    /** Invalid seeder export */
+    SeederErrorCode["INVALID_EXPORT"] = "E3021";
+})(SeederErrorCode || (SeederErrorCode = {}));
+// ============================================================================
+// Seeder Error
+// ============================================================================
+/**
+ * Structured error for seeding operations
+ */
+export class SeederError extends Error {
+    code;
+    fix;
+    constructor(code, message, fix) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.name = 'SeederError';
+    }
+    /**
+     * Format error for display
+     */
+    format() {
+        let output = `SeederError[${this.code}]: ${this.message}`;
+        if (this.fix) {
+            output += `\n\n  Fix: ${this.fix}`;
+        }
+        return output;
+    }
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            fix: this.fix,
+        };
+    }
+}
+// ============================================================================
+// Factory Error
+// ============================================================================
+/**
+ * Structured error for factory operations
+ */
+export class FactoryError extends Error {
+    code;
+    fix;
+    constructor(code, message, fix) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.name = 'FactoryError';
+    }
+    /**
+     * Format error for display
+     */
+    format() {
+        let output = `FactoryError[${this.code}]: ${this.message}`;
+        if (this.fix) {
+            output += `\n\n  Fix: ${this.fix}`;
+        }
+        return output;
+    }
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            fix: this.fix,
+        };
+    }
+}
+// ============================================================================
+// Error Factory Functions
+// ============================================================================
+/**
+ * Create error for seeder not found
+ */
+export function seederNotFound(name) {
+    return new SeederError(SeederErrorCode.SEEDER_NOT_FOUND, `Seeder '${name}' not found.`, `Check that the seeder exists in src/database/seeders/ and is properly exported.`);
+}
+/**
+ * Create error for circular dependency
+ */
+export function circularDependency(cycle) {
+    return new SeederError(SeederErrorCode.CIRCULAR_DEPENDENCY, `Circular dependency detected: ${cycle.join(' -> ')}`, `Review seeder dependencies and remove the circular reference.`);
+}
+/**
+ * Create error for seeder execution failure
+ */
+export function executionFailed(name, cause) {
+    return new SeederError(SeederErrorCode.EXECUTION_FAILED, `Seeder '${name}' failed: ${cause.message}`, `Check the seeder implementation and database state.`);
+}
+/**
+ * Create error for truncation failure
+ */
+export function truncationFailed(name, cause) {
+    return new SeederError(SeederErrorCode.TRUNCATION_FAILED, `Truncation failed for seeder '${name}': ${cause.message}`, `Check for foreign key constraints that may prevent truncation.`);
+}
+/**
+ * Create error for dependency not found
+ */
+export function dependencyNotFound(seederName, dependencyName) {
+    return new SeederError(SeederErrorCode.DEPENDENCY_NOT_FOUND, `Seeder '${seederName}' depends on '${dependencyName}' which was not found.`, `Ensure '${dependencyName}' exists in src/database/seeders/ and is registered.`);
+}
+/**
+ * Create error for no seeders found
+ */
+export function noSeedersFound(path) {
+    return new SeederError(SeederErrorCode.NO_SEEDERS_FOUND, `No seeders found in ${path}`, `Create a seeder with: velox generate seeder <name>`);
+}
+/**
+ * Create error for database connection issue
+ */
+export function seederDatabaseError(operation, cause) {
+    return new SeederError(SeederErrorCode.DATABASE_ERROR, `Database error during ${operation}: ${cause.message}`, `Check your database connection and ensure it's running.`);
+}
+/**
+ * Create error for factory not found
+ */
+export function factoryNotFound(name) {
+    return new FactoryError(SeederErrorCode.FACTORY_NOT_FOUND, `Factory '${name}' not found in registry.`, `Ensure the factory is properly instantiated before use.`);
+}
+/**
+ * Create error for state not found
+ */
+export function stateNotFound(factoryName, stateName, available) {
+    const availableStr = available.length > 0 ? available.join(', ') : 'none';
+    return new FactoryError(SeederErrorCode.STATE_NOT_FOUND, `State '${stateName}' not found on factory '${factoryName}'.`, `Available states: ${availableStr}. Register states using registerState().`);
+}
+/**
+ * Create error for factory creation failure
+ */
+export function factoryCreateFailed(modelName, cause) {
+    return new FactoryError(SeederErrorCode.FACTORY_CREATE_FAILED, `Failed to create '${modelName}': ${cause.message}`, `Check the factory definition and ensure all required fields are provided.`);
+}
+/**
+ * Create error for invalid seeder export
+ */
+export function invalidExport(filePath, reason) {
+    return new SeederError(SeederErrorCode.INVALID_EXPORT, `Invalid seeder export in '${filePath}': ${reason}`, `Ensure the file exports a valid Seeder object with 'name' and 'run' properties.`);
+}
+/**
+ * Create error for filesystem issue
+ */
+export function filesystemError(operation, path, cause) {
+    return new SeederError(SeederErrorCode.FILESYSTEM_ERROR, `Filesystem error during ${operation} at '${path}': ${cause.message}`, `Check file permissions and path validity.`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/seeding/errors.js.map

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

package/dist/seeding/factory.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Factory System
+ *
+ * Base factory class and registry for generating fake data.
+ */
+import type { Factory, FactoryRegistry, PrismaClientLike, StateModifier } from './types.js';
+/**
+ * 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 declare abstract class BaseFactory<TInput extends Record<string, unknown>, TOutput = TInput> implements Factory<TInput, TOutput> {
+    /** Map of registered state modifiers */
+    protected states: Map<string, StateModifier<TInput>>;
+    /** Currently active state names */
+    protected activeStates: string[];
+    /** Prisma client for database operations */
+    protected readonly prisma: PrismaClientLike;
+    /**
+     * Model name for Prisma operations (e.g., 'user', 'post').
+     * Must match the lowercase model name in your Prisma schema.
+     */
+    abstract readonly modelName: string;
+    /**
+     * Define default attributes for new instances.
+     * Override this method to provide fake data generation.
+     */
+    abstract definition(): TInput;
+    constructor(prisma: PrismaClientLike);
+    /**
+     * 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 }));
+     * }
+     * ```
+     */
+    protected registerState(name: string, modifier: StateModifier<TInput>): 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: string): this;
+    /**
+     * Get list of available state names.
+     */
+    getAvailableStates(): ReadonlyArray<string>;
+    /**
+     * Make a single instance without persisting to database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Generated attributes
+     */
+    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
+     * @returns Array of generated attributes
+     */
+    makeMany(count: number, overrides?: Partial<TInput>): TInput[];
+    /**
+     * Create a single instance in the database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Created database record
+     */
+    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
+     * @returns Array of created database records
+     */
+    createMany(count: number, overrides?: Partial<TInput>): Promise<TOutput[]>;
+    /**
+     * Build attributes by applying definition, states, and overrides.
+     */
+    private buildAttributes;
+}
+/**
+ * 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 declare function createFactoryRegistry(prisma: PrismaClientLike): FactoryRegistry;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/seeding/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AA2BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,8BAAsB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CACxF,YAAW,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAa;IAEjE,mCAAmC;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAM;IAEtC,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,IAAI,MAAM;gBAEjB,MAAM,EAAE,gBAAgB;IAQpC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAK5E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAazB;;OAEG;IACH,kBAAkB,IAAI,aAAa,CAAC,MAAM,CAAC;IAQ3C;;;;;OAKG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAIzC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAQ9D;;;;;OAKG;IACG,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB3D;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBhF;;OAEG;IACH,OAAO,CAAC,eAAe;CAmBxB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAyB/E"}

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