@veloxts/cli 0.4.1 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +23 -144
  2. package/dist/cli.js +4 -0
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/db.d.ts +12 -0
  5. package/dist/commands/db.d.ts.map +1 -0
  6. package/dist/commands/db.js +18 -0
  7. package/dist/commands/db.js.map +1 -0
  8. package/dist/commands/procedures.d.ts +12 -0
  9. package/dist/commands/procedures.d.ts.map +1 -0
  10. package/dist/commands/procedures.js +153 -0
  11. package/dist/commands/procedures.js.map +1 -0
  12. package/dist/generators/generators/factory.d.ts +36 -0
  13. package/dist/generators/generators/factory.d.ts.map +1 -0
  14. package/dist/generators/generators/factory.js +85 -0
  15. package/dist/generators/generators/factory.js.map +1 -0
  16. package/dist/generators/generators/index.d.ts +2 -0
  17. package/dist/generators/generators/index.d.ts.map +1 -1
  18. package/dist/generators/generators/index.js +8 -0
  19. package/dist/generators/generators/index.js.map +1 -1
  20. package/dist/generators/generators/seeder.d.ts +36 -0
  21. package/dist/generators/generators/seeder.d.ts.map +1 -0
  22. package/dist/generators/generators/seeder.js +99 -0
  23. package/dist/generators/generators/seeder.js.map +1 -0
  24. package/dist/generators/templates/factory.d.ts +26 -0
  25. package/dist/generators/templates/factory.d.ts.map +1 -0
  26. package/dist/generators/templates/factory.js +125 -0
  27. package/dist/generators/templates/factory.js.map +1 -0
  28. package/dist/generators/templates/seeder.d.ts +34 -0
  29. package/dist/generators/templates/seeder.d.ts.map +1 -0
  30. package/dist/generators/templates/seeder.js +129 -0
  31. package/dist/generators/templates/seeder.js.map +1 -0
  32. package/dist/index.d.ts +5 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +5 -0
  35. package/dist/index.js.map +1 -1
  36. package/dist/migrations/rollback-runner.d.ts.map +1 -1
  37. package/dist/migrations/rollback-runner.js +13 -1
  38. package/dist/migrations/rollback-runner.js.map +1 -1
  39. package/dist/seeding/commands/seed.d.ts +11 -0
  40. package/dist/seeding/commands/seed.d.ts.map +1 -0
  41. package/dist/seeding/commands/seed.js +268 -0
  42. package/dist/seeding/commands/seed.js.map +1 -0
  43. package/dist/seeding/errors.d.ts +119 -0
  44. package/dist/seeding/errors.d.ts.map +1 -0
  45. package/dist/seeding/errors.js +191 -0
  46. package/dist/seeding/errors.js.map +1 -0
  47. package/dist/seeding/factory.d.ts +162 -0
  48. package/dist/seeding/factory.d.ts.map +1 -0
  49. package/dist/seeding/factory.js +250 -0
  50. package/dist/seeding/factory.js.map +1 -0
  51. package/dist/seeding/index.d.ts +31 -0
  52. package/dist/seeding/index.d.ts.map +1 -0
  53. package/dist/seeding/index.js +41 -0
  54. package/dist/seeding/index.js.map +1 -0
  55. package/dist/seeding/loader.d.ts +41 -0
  56. package/dist/seeding/loader.d.ts.map +1 -0
  57. package/dist/seeding/loader.js +210 -0
  58. package/dist/seeding/loader.js.map +1 -0
  59. package/dist/seeding/registry.d.ts +116 -0
  60. package/dist/seeding/registry.d.ts.map +1 -0
  61. package/dist/seeding/registry.js +298 -0
  62. package/dist/seeding/registry.js.map +1 -0
  63. package/dist/seeding/runner.d.ts +88 -0
  64. package/dist/seeding/runner.d.ts.map +1 -0
  65. package/dist/seeding/runner.js +254 -0
  66. package/dist/seeding/runner.js.map +1 -0
  67. package/dist/seeding/types.d.ts +247 -0
  68. package/dist/seeding/types.d.ts.map +1 -0
  69. package/dist/seeding/types.js +7 -0
  70. package/dist/seeding/types.js.map +1 -0
  71. package/package.json +6 -6
@@ -0,0 +1,268 @@
1
+ /**
2
+ * db:seed Command
3
+ *
4
+ * Run database seeders.
5
+ */
6
+ import path from 'node:path';
7
+ import * as p from '@clack/prompts';
8
+ import { Command } from 'commander';
9
+ import pc from 'picocolors';
10
+ import { createPrismaClient } from '../../migrations/types.js';
11
+ import { error, info, success, warning } from '../../utils/output.js';
12
+ import { fileExists } from '../../utils/paths.js';
13
+ import { SeederError } from '../errors.js';
14
+ import { loadSeeders, seedersDirectoryExists } from '../loader.js';
15
+ import { SeederRegistry } from '../registry.js';
16
+ import { SeederRunner } from '../runner.js';
17
+ // ============================================================================
18
+ // Command Factory
19
+ // ============================================================================
20
+ /**
21
+ * Create the db:seed command
22
+ */
23
+ export function createSeedCommand() {
24
+ return new Command('seed')
25
+ .description('Run database seeders')
26
+ .argument('[seeder]', 'Specific seeder to run (e.g., UserSeeder)')
27
+ .option('--fresh', 'Truncate tables before seeding')
28
+ .option('--class <name>', 'Run specific seeder class')
29
+ .option('--force', 'Run in production without confirmation')
30
+ .option('--dry-run', 'Show what would run without executing')
31
+ .option('--verbose', 'Show detailed output')
32
+ .option('--json', 'Output as JSON')
33
+ .action(async (seederArg, options) => {
34
+ await runSeedCommand(seederArg, options);
35
+ });
36
+ }
37
+ // ============================================================================
38
+ // Command Implementation
39
+ // ============================================================================
40
+ /**
41
+ * Run the db:seed command
42
+ */
43
+ async function runSeedCommand(seederArg, options) {
44
+ const cwd = process.cwd();
45
+ const s = p.spinner();
46
+ try {
47
+ // Check if Prisma schema exists
48
+ const schemaPath = path.join(cwd, 'prisma', 'schema.prisma');
49
+ if (!fileExists(schemaPath)) {
50
+ if (options.json) {
51
+ console.log(JSON.stringify({ error: 'Prisma schema not found' }));
52
+ }
53
+ else {
54
+ error('Prisma schema not found.');
55
+ console.log(` ${pc.dim('Expected: prisma/schema.prisma')}`);
56
+ }
57
+ process.exit(1);
58
+ }
59
+ // Check if seeders directory exists
60
+ if (!(await seedersDirectoryExists(cwd))) {
61
+ if (options.json) {
62
+ console.log(JSON.stringify({ error: 'No seeders found' }));
63
+ }
64
+ else {
65
+ info('No seeders found.');
66
+ console.log(` ${pc.dim('Create one with: velox generate seeder <name>')}`);
67
+ }
68
+ return;
69
+ }
70
+ // Production safety check
71
+ if (process.env.NODE_ENV === 'production' && !options.force) {
72
+ if (options.json) {
73
+ console.log(JSON.stringify({ error: 'Cannot seed in production without --force' }));
74
+ process.exit(1);
75
+ }
76
+ const confirmed = await p.confirm({
77
+ message: pc.yellow('Running seeders in production. Are you sure?'),
78
+ });
79
+ if (p.isCancel(confirmed) || !confirmed) {
80
+ info('Seeding cancelled.');
81
+ return;
82
+ }
83
+ }
84
+ // Load seeders
85
+ if (!options.json) {
86
+ s.start('Loading seeders...');
87
+ }
88
+ const loadResult = await loadSeeders(cwd);
89
+ if (loadResult.errors.length > 0 && !options.json) {
90
+ s.stop('Seeders loaded with errors');
91
+ for (const err of loadResult.errors) {
92
+ warning(`Failed to load ${path.basename(err.filePath)}: ${err.error}`);
93
+ }
94
+ }
95
+ if (loadResult.seeders.length === 0) {
96
+ if (!options.json) {
97
+ s.stop('No seeders found');
98
+ info('No seeders found.');
99
+ console.log(` ${pc.dim('Create one with: velox generate seeder <name>')}`);
100
+ }
101
+ else {
102
+ console.log(JSON.stringify({ error: 'No seeders found' }));
103
+ }
104
+ return;
105
+ }
106
+ if (!options.json) {
107
+ s.stop(`Loaded ${loadResult.seeders.length} seeder${loadResult.seeders.length > 1 ? 's' : ''}`);
108
+ }
109
+ // Build registry
110
+ const registry = new SeederRegistry();
111
+ for (const loaded of loadResult.seeders) {
112
+ registry.register(loaded.seeder);
113
+ }
114
+ // Determine which seeders to run
115
+ const seederName = seederArg ?? options.class;
116
+ let seedersToRun;
117
+ if (seederName) {
118
+ if (!registry.has(seederName)) {
119
+ if (options.json) {
120
+ console.log(JSON.stringify({ error: `Seeder '${seederName}' not found` }));
121
+ }
122
+ else {
123
+ error(`Seeder '${seederName}' not found.`);
124
+ console.log(` ${pc.dim('Available seeders:')}`);
125
+ for (const name of registry.getNames()) {
126
+ console.log(` ${pc.dim('•')} ${name}`);
127
+ }
128
+ }
129
+ process.exit(1);
130
+ }
131
+ seedersToRun = [seederName];
132
+ }
133
+ // Show what will run
134
+ if (!options.json && !options.dryRun) {
135
+ console.log('');
136
+ const ordered = seedersToRun ? registry.getByNames(seedersToRun) : registry.getInOrder();
137
+ if (options.fresh) {
138
+ info(`Will ${pc.bold('truncate')} and seed ${ordered.length} seeder${ordered.length > 1 ? 's' : ''}:`);
139
+ }
140
+ else {
141
+ info(`Running ${ordered.length} seeder${ordered.length > 1 ? 's' : ''}:`);
142
+ }
143
+ console.log('');
144
+ for (const seeder of ordered) {
145
+ const deps = seeder.dependencies?.length
146
+ ? pc.dim(` (depends on: ${seeder.dependencies.join(', ')})`)
147
+ : '';
148
+ console.log(` ${pc.dim('→')} ${seeder.name}${deps}`);
149
+ }
150
+ console.log('');
151
+ }
152
+ // Dry run
153
+ if (options.dryRun) {
154
+ const ordered = seedersToRun ? registry.getByNames(seedersToRun) : registry.getInOrder();
155
+ if (options.json) {
156
+ console.log(JSON.stringify({
157
+ dryRun: true,
158
+ fresh: options.fresh ?? false,
159
+ seeders: ordered.map((s) => ({
160
+ name: s.name,
161
+ dependencies: s.dependencies ?? [],
162
+ })),
163
+ count: ordered.length,
164
+ }, null, 2));
165
+ }
166
+ else {
167
+ warning('Dry run mode - no changes made.');
168
+ console.log(` ${pc.dim('Remove --dry-run to execute seeders.')}`);
169
+ }
170
+ return;
171
+ }
172
+ // Create Prisma client
173
+ if (!options.json) {
174
+ s.start('Connecting to database...');
175
+ }
176
+ const prisma = await createPrismaClient();
177
+ if (!options.json) {
178
+ s.stop('Connected to database');
179
+ }
180
+ // Create runner
181
+ const runner = new SeederRunner(prisma, registry);
182
+ // Execute seeders
183
+ if (!options.json) {
184
+ console.log('');
185
+ s.start(options.fresh ? 'Truncating and seeding...' : 'Seeding...');
186
+ }
187
+ let result;
188
+ if (options.fresh) {
189
+ result = await runner.fresh({
190
+ only: seedersToRun,
191
+ verbose: options.verbose,
192
+ dryRun: false,
193
+ });
194
+ }
195
+ else if (seedersToRun) {
196
+ result = await runner.run(seedersToRun, {
197
+ verbose: options.verbose,
198
+ dryRun: false,
199
+ });
200
+ }
201
+ else {
202
+ result = await runner.runAll({
203
+ verbose: options.verbose,
204
+ dryRun: false,
205
+ });
206
+ }
207
+ // Disconnect
208
+ await prisma.$disconnect();
209
+ // Output results
210
+ if (options.json) {
211
+ console.log(JSON.stringify({
212
+ success: result.failed === 0,
213
+ total: result.total,
214
+ successful: result.successful,
215
+ failed: result.failed,
216
+ skipped: result.skipped,
217
+ duration: result.duration,
218
+ results: result.results,
219
+ }, null, 2));
220
+ }
221
+ else {
222
+ s.stop(result.failed === 0 ? 'Seeding complete' : 'Seeding finished with errors');
223
+ console.log('');
224
+ if (result.failed === 0) {
225
+ success(`Ran ${result.successful} seeder${result.successful !== 1 ? 's' : ''} successfully!`);
226
+ }
227
+ else {
228
+ error(`${result.failed} seeder${result.failed !== 1 ? 's' : ''} failed.`);
229
+ for (const r of result.results) {
230
+ if (!r.success) {
231
+ console.log(` ${pc.red('✗')} ${r.name}: ${pc.dim(r.error ?? 'Unknown error')}`);
232
+ }
233
+ }
234
+ }
235
+ console.log(` ${pc.dim(`Duration: ${result.duration}ms`)}`);
236
+ console.log('');
237
+ }
238
+ if (result.failed > 0) {
239
+ process.exit(1);
240
+ }
241
+ }
242
+ catch (err) {
243
+ s.stop('Seeding failed');
244
+ if (options.json) {
245
+ if (err instanceof SeederError) {
246
+ console.log(JSON.stringify({ error: err.toJSON() }));
247
+ }
248
+ else {
249
+ console.log(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
250
+ }
251
+ }
252
+ else {
253
+ console.log('');
254
+ if (err instanceof SeederError) {
255
+ error(err.message);
256
+ if (err.fix) {
257
+ console.log(` ${pc.dim('Fix:')} ${err.fix}`);
258
+ }
259
+ }
260
+ else {
261
+ error(err instanceof Error ? err.message : String(err));
262
+ }
263
+ console.log('');
264
+ }
265
+ process.exit(1);
266
+ }
267
+ }
268
+ //# sourceMappingURL=seed.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../src/seeding/commands/seed.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,119 @@
1
+ /**
2
+ * Seeding Errors
3
+ *
4
+ * Structured error classes for the VeloxTS database seeding system.
5
+ */
6
+ /**
7
+ * Error codes for seeding errors (for AI/tooling integration)
8
+ */
9
+ export declare enum SeederErrorCode {
10
+ /** Seeder not found in registry */
11
+ SEEDER_NOT_FOUND = "E3001",
12
+ /** Circular dependency detected between seeders */
13
+ CIRCULAR_DEPENDENCY = "E3002",
14
+ /** Seeder execution failed */
15
+ EXECUTION_FAILED = "E3003",
16
+ /** Truncation failed */
17
+ TRUNCATION_FAILED = "E3004",
18
+ /** Invalid seeder configuration */
19
+ INVALID_CONFIG = "E3005",
20
+ /** Seeder dependency not found */
21
+ DEPENDENCY_NOT_FOUND = "E3006",
22
+ /** No seeders found in project */
23
+ NO_SEEDERS_FOUND = "E3007",
24
+ /** Database connection failed */
25
+ DATABASE_ERROR = "E3008",
26
+ /** Factory not found in registry */
27
+ FACTORY_NOT_FOUND = "E3010",
28
+ /** Factory state not found */
29
+ STATE_NOT_FOUND = "E3011",
30
+ /** Factory creation failed */
31
+ FACTORY_CREATE_FAILED = "E3012",
32
+ /** Invalid factory configuration */
33
+ INVALID_FACTORY = "E3013",
34
+ /** File system error during seeder loading */
35
+ FILESYSTEM_ERROR = "E3020",
36
+ /** Invalid seeder export */
37
+ INVALID_EXPORT = "E3021"
38
+ }
39
+ /**
40
+ * Structured error for seeding operations
41
+ */
42
+ export declare class SeederError extends Error {
43
+ readonly code: SeederErrorCode;
44
+ readonly fix?: string | undefined;
45
+ constructor(code: SeederErrorCode, message: string, fix?: string | undefined);
46
+ /**
47
+ * Format error for display
48
+ */
49
+ format(): string;
50
+ /**
51
+ * Convert to JSON for --json output
52
+ */
53
+ toJSON(): Record<string, unknown>;
54
+ }
55
+ /**
56
+ * Structured error for factory operations
57
+ */
58
+ export declare class FactoryError extends Error {
59
+ readonly code: SeederErrorCode;
60
+ readonly fix?: string | undefined;
61
+ constructor(code: SeederErrorCode, message: string, fix?: string | undefined);
62
+ /**
63
+ * Format error for display
64
+ */
65
+ format(): string;
66
+ /**
67
+ * Convert to JSON for --json output
68
+ */
69
+ toJSON(): Record<string, unknown>;
70
+ }
71
+ /**
72
+ * Create error for seeder not found
73
+ */
74
+ export declare function seederNotFound(name: string): SeederError;
75
+ /**
76
+ * Create error for circular dependency
77
+ */
78
+ export declare function circularDependency(cycle: string[]): SeederError;
79
+ /**
80
+ * Create error for seeder execution failure
81
+ */
82
+ export declare function executionFailed(name: string, cause: Error): SeederError;
83
+ /**
84
+ * Create error for truncation failure
85
+ */
86
+ export declare function truncationFailed(name: string, cause: Error): SeederError;
87
+ /**
88
+ * Create error for dependency not found
89
+ */
90
+ export declare function dependencyNotFound(seederName: string, dependencyName: string): SeederError;
91
+ /**
92
+ * Create error for no seeders found
93
+ */
94
+ export declare function noSeedersFound(path: string): SeederError;
95
+ /**
96
+ * Create error for database connection issue
97
+ */
98
+ export declare function seederDatabaseError(operation: string, cause: Error): SeederError;
99
+ /**
100
+ * Create error for factory not found
101
+ */
102
+ export declare function factoryNotFound(name: string): FactoryError;
103
+ /**
104
+ * Create error for state not found
105
+ */
106
+ export declare function stateNotFound(factoryName: string, stateName: string, available: string[]): FactoryError;
107
+ /**
108
+ * Create error for factory creation failure
109
+ */
110
+ export declare function factoryCreateFailed(modelName: string, cause: Error): FactoryError;
111
+ /**
112
+ * Create error for invalid seeder export
113
+ */
114
+ export declare function invalidExport(filePath: string, reason: string): SeederError;
115
+ /**
116
+ * Create error for filesystem issue
117
+ */
118
+ export declare function filesystemError(operation: string, path: string, cause: Error): SeederError;
119
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/seeding/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,oBAAY,eAAe;IACzB,mCAAmC;IACnC,gBAAgB,UAAU;IAE1B,mDAAmD;IACnD,mBAAmB,UAAU;IAE7B,8BAA8B;IAC9B,gBAAgB,UAAU;IAE1B,wBAAwB;IACxB,iBAAiB,UAAU;IAE3B,mCAAmC;IACnC,cAAc,UAAU;IAExB,kCAAkC;IAClC,oBAAoB,UAAU;IAE9B,kCAAkC;IAClC,gBAAgB,UAAU;IAE1B,iCAAiC;IACjC,cAAc,UAAU;IAExB,oCAAoC;IACpC,iBAAiB,UAAU;IAE3B,8BAA8B;IAC9B,eAAe,UAAU;IAEzB,8BAA8B;IAC9B,qBAAqB,UAAU;IAE/B,oCAAoC;IACpC,eAAe,UAAU;IAEzB,8CAA8C;IAC9C,gBAAgB,UAAU;IAE1B,4BAA4B;IAC5B,cAAc,UAAU;CACzB;AAMD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,eAAe;aAErB,GAAG,CAAC,EAAE,MAAM;gBAFZ,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,EAAE,MAAM,YAAA;IAM9B;;OAEG;IACH,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAMD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAEnB,IAAI,EAAE,eAAe;aAErB,GAAG,CAAC,EAAE,MAAM;gBAFZ,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,EAAE,MAAM,YAAA;IAM9B;;OAEG;IACH,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CAM/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,CAM1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,CAMjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAM3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAM1F"}
@@ -0,0 +1,191 @@
1
+ /**
2
+ * Seeding Errors
3
+ *
4
+ * Structured error classes for the VeloxTS database seeding system.
5
+ */
6
+ // ============================================================================
7
+ // Error Codes
8
+ // ============================================================================
9
+ /**
10
+ * Error codes for seeding errors (for AI/tooling integration)
11
+ */
12
+ export var SeederErrorCode;
13
+ (function (SeederErrorCode) {
14
+ /** Seeder not found in registry */
15
+ SeederErrorCode["SEEDER_NOT_FOUND"] = "E3001";
16
+ /** Circular dependency detected between seeders */
17
+ SeederErrorCode["CIRCULAR_DEPENDENCY"] = "E3002";
18
+ /** Seeder execution failed */
19
+ SeederErrorCode["EXECUTION_FAILED"] = "E3003";
20
+ /** Truncation failed */
21
+ SeederErrorCode["TRUNCATION_FAILED"] = "E3004";
22
+ /** Invalid seeder configuration */
23
+ SeederErrorCode["INVALID_CONFIG"] = "E3005";
24
+ /** Seeder dependency not found */
25
+ SeederErrorCode["DEPENDENCY_NOT_FOUND"] = "E3006";
26
+ /** No seeders found in project */
27
+ SeederErrorCode["NO_SEEDERS_FOUND"] = "E3007";
28
+ /** Database connection failed */
29
+ SeederErrorCode["DATABASE_ERROR"] = "E3008";
30
+ /** Factory not found in registry */
31
+ SeederErrorCode["FACTORY_NOT_FOUND"] = "E3010";
32
+ /** Factory state not found */
33
+ SeederErrorCode["STATE_NOT_FOUND"] = "E3011";
34
+ /** Factory creation failed */
35
+ SeederErrorCode["FACTORY_CREATE_FAILED"] = "E3012";
36
+ /** Invalid factory configuration */
37
+ SeederErrorCode["INVALID_FACTORY"] = "E3013";
38
+ /** File system error during seeder loading */
39
+ SeederErrorCode["FILESYSTEM_ERROR"] = "E3020";
40
+ /** Invalid seeder export */
41
+ SeederErrorCode["INVALID_EXPORT"] = "E3021";
42
+ })(SeederErrorCode || (SeederErrorCode = {}));
43
+ // ============================================================================
44
+ // Seeder Error
45
+ // ============================================================================
46
+ /**
47
+ * Structured error for seeding operations
48
+ */
49
+ export class SeederError extends Error {
50
+ code;
51
+ fix;
52
+ constructor(code, message, fix) {
53
+ super(message);
54
+ this.code = code;
55
+ this.fix = fix;
56
+ this.name = 'SeederError';
57
+ }
58
+ /**
59
+ * Format error for display
60
+ */
61
+ format() {
62
+ let output = `SeederError[${this.code}]: ${this.message}`;
63
+ if (this.fix) {
64
+ output += `\n\n Fix: ${this.fix}`;
65
+ }
66
+ return output;
67
+ }
68
+ /**
69
+ * Convert to JSON for --json output
70
+ */
71
+ toJSON() {
72
+ return {
73
+ code: this.code,
74
+ message: this.message,
75
+ fix: this.fix,
76
+ };
77
+ }
78
+ }
79
+ // ============================================================================
80
+ // Factory Error
81
+ // ============================================================================
82
+ /**
83
+ * Structured error for factory operations
84
+ */
85
+ export class FactoryError extends Error {
86
+ code;
87
+ fix;
88
+ constructor(code, message, fix) {
89
+ super(message);
90
+ this.code = code;
91
+ this.fix = fix;
92
+ this.name = 'FactoryError';
93
+ }
94
+ /**
95
+ * Format error for display
96
+ */
97
+ format() {
98
+ let output = `FactoryError[${this.code}]: ${this.message}`;
99
+ if (this.fix) {
100
+ output += `\n\n Fix: ${this.fix}`;
101
+ }
102
+ return output;
103
+ }
104
+ /**
105
+ * Convert to JSON for --json output
106
+ */
107
+ toJSON() {
108
+ return {
109
+ code: this.code,
110
+ message: this.message,
111
+ fix: this.fix,
112
+ };
113
+ }
114
+ }
115
+ // ============================================================================
116
+ // Error Factory Functions
117
+ // ============================================================================
118
+ /**
119
+ * Create error for seeder not found
120
+ */
121
+ export function seederNotFound(name) {
122
+ return new SeederError(SeederErrorCode.SEEDER_NOT_FOUND, `Seeder '${name}' not found.`, `Check that the seeder exists in src/database/seeders/ and is properly exported.`);
123
+ }
124
+ /**
125
+ * Create error for circular dependency
126
+ */
127
+ export function circularDependency(cycle) {
128
+ return new SeederError(SeederErrorCode.CIRCULAR_DEPENDENCY, `Circular dependency detected: ${cycle.join(' -> ')}`, `Review seeder dependencies and remove the circular reference.`);
129
+ }
130
+ /**
131
+ * Create error for seeder execution failure
132
+ */
133
+ export function executionFailed(name, cause) {
134
+ return new SeederError(SeederErrorCode.EXECUTION_FAILED, `Seeder '${name}' failed: ${cause.message}`, `Check the seeder implementation and database state.`);
135
+ }
136
+ /**
137
+ * Create error for truncation failure
138
+ */
139
+ export function truncationFailed(name, cause) {
140
+ return new SeederError(SeederErrorCode.TRUNCATION_FAILED, `Truncation failed for seeder '${name}': ${cause.message}`, `Check for foreign key constraints that may prevent truncation.`);
141
+ }
142
+ /**
143
+ * Create error for dependency not found
144
+ */
145
+ export function dependencyNotFound(seederName, dependencyName) {
146
+ 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.`);
147
+ }
148
+ /**
149
+ * Create error for no seeders found
150
+ */
151
+ export function noSeedersFound(path) {
152
+ return new SeederError(SeederErrorCode.NO_SEEDERS_FOUND, `No seeders found in ${path}`, `Create a seeder with: velox generate seeder <name>`);
153
+ }
154
+ /**
155
+ * Create error for database connection issue
156
+ */
157
+ export function seederDatabaseError(operation, cause) {
158
+ return new SeederError(SeederErrorCode.DATABASE_ERROR, `Database error during ${operation}: ${cause.message}`, `Check your database connection and ensure it's running.`);
159
+ }
160
+ /**
161
+ * Create error for factory not found
162
+ */
163
+ export function factoryNotFound(name) {
164
+ return new FactoryError(SeederErrorCode.FACTORY_NOT_FOUND, `Factory '${name}' not found in registry.`, `Ensure the factory is properly instantiated before use.`);
165
+ }
166
+ /**
167
+ * Create error for state not found
168
+ */
169
+ export function stateNotFound(factoryName, stateName, available) {
170
+ const availableStr = available.length > 0 ? available.join(', ') : 'none';
171
+ return new FactoryError(SeederErrorCode.STATE_NOT_FOUND, `State '${stateName}' not found on factory '${factoryName}'.`, `Available states: ${availableStr}. Register states using registerState().`);
172
+ }
173
+ /**
174
+ * Create error for factory creation failure
175
+ */
176
+ export function factoryCreateFailed(modelName, cause) {
177
+ return new FactoryError(SeederErrorCode.FACTORY_CREATE_FAILED, `Failed to create '${modelName}': ${cause.message}`, `Check the factory definition and ensure all required fields are provided.`);
178
+ }
179
+ /**
180
+ * Create error for invalid seeder export
181
+ */
182
+ export function invalidExport(filePath, reason) {
183
+ 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.`);
184
+ }
185
+ /**
186
+ * Create error for filesystem issue
187
+ */
188
+ export function filesystemError(operation, path, cause) {
189
+ return new SeederError(SeederErrorCode.FILESYSTEM_ERROR, `Filesystem error during ${operation} at '${path}': ${cause.message}`, `Check file permissions and path validity.`);
190
+ }
191
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/seeding/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAN,IAAY,eA0CX;AA1CD,WAAY,eAAe;IACzB,mCAAmC;IACnC,6CAA0B,CAAA;IAE1B,mDAAmD;IACnD,gDAA6B,CAAA;IAE7B,8BAA8B;IAC9B,6CAA0B,CAAA;IAE1B,wBAAwB;IACxB,8CAA2B,CAAA;IAE3B,mCAAmC;IACnC,2CAAwB,CAAA;IAExB,kCAAkC;IAClC,iDAA8B,CAAA;IAE9B,kCAAkC;IAClC,6CAA0B,CAAA;IAE1B,iCAAiC;IACjC,2CAAwB,CAAA;IAExB,oCAAoC;IACpC,8CAA2B,CAAA;IAE3B,8BAA8B;IAC9B,4CAAyB,CAAA;IAEzB,8BAA8B;IAC9B,kDAA+B,CAAA;IAE/B,oCAAoC;IACpC,4CAAyB,CAAA;IAEzB,8CAA8C;IAC9C,6CAA0B,CAAA;IAE1B,4BAA4B;IAC5B,2CAAwB,CAAA;AAC1B,CAAC,EA1CW,eAAe,KAAf,eAAe,QA0C1B;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IAEA;IAHlB,YACkB,IAAqB,EACrC,OAAe,EACC,GAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAiB;QAErB,QAAG,GAAH,GAAG,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,MAAM,GAAG,eAAe,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAEnB;IAEA;IAHlB,YACkB,IAAqB,EACrC,OAAe,EACC,GAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAiB;QAErB,QAAG,GAAH,GAAG,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,MAAM,GAAG,gBAAgB,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,gBAAgB,EAChC,WAAW,IAAI,cAAc,EAC7B,iFAAiF,CAClF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,mBAAmB,EACnC,iCAAiC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EACrD,+DAA+D,CAChE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAY;IACxD,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,gBAAgB,EAChC,WAAW,IAAI,aAAa,KAAK,CAAC,OAAO,EAAE,EAC3C,qDAAqD,CACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAY;IACzD,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,iBAAiB,EACjC,iCAAiC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,EAC1D,gEAAgE,CACjE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,cAAsB;IAC3E,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,oBAAoB,EACpC,WAAW,UAAU,iBAAiB,cAAc,wBAAwB,EAC5E,WAAW,cAAc,sDAAsD,CAChF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,gBAAgB,EAChC,uBAAuB,IAAI,EAAE,EAC7B,oDAAoD,CACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAAY;IACjE,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,cAAc,EAC9B,yBAAyB,SAAS,KAAK,KAAK,CAAC,OAAO,EAAE,EACtD,yDAAyD,CAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,YAAY,CACrB,eAAe,CAAC,iBAAiB,EACjC,YAAY,IAAI,0BAA0B,EAC1C,yDAAyD,CAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,SAAiB,EACjB,SAAmB;IAEnB,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1E,OAAO,IAAI,YAAY,CACrB,eAAe,CAAC,eAAe,EAC/B,UAAU,SAAS,2BAA2B,WAAW,IAAI,EAC7D,qBAAqB,YAAY,0CAA0C,CAC5E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAAY;IACjE,OAAO,IAAI,YAAY,CACrB,eAAe,CAAC,qBAAqB,EACrC,qBAAqB,SAAS,MAAM,KAAK,CAAC,OAAO,EAAE,EACnD,2EAA2E,CAC5E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAc;IAC5D,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,cAAc,EAC9B,6BAA6B,QAAQ,MAAM,MAAM,EAAE,EACnD,iFAAiF,CAClF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,IAAY,EAAE,KAAY;IAC3E,OAAO,IAAI,WAAW,CACpB,eAAe,CAAC,gBAAgB,EAChC,2BAA2B,SAAS,QAAQ,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,EACrE,2CAA2C,CAC5C,CAAC;AACJ,CAAC"}