@veloxts/cli 0.4.14 → 0.6.23

package/dist/errors/catalog.js

@@ -0,0 +1,421 @@
+/**
+ * VeloxTS Error Catalog
+ *
+ * Central registry of all error codes with messages, fixes, and documentation links.
+ * Error codes follow the pattern E[category][number]:
+ *
+ * E1xxx - Core/Runtime errors
+ * E2xxx - Generator errors
+ * E3xxx - Seeding errors
+ * E4xxx - Migration errors
+ * E5xxx - Dev server errors
+ * E6xxx - Validation errors
+ * E7xxx - Authentication errors
+ * E8xxx - Database errors
+ * E9xxx - Configuration errors
+ */
+// ============================================================================
+// Error Catalog
+// ============================================================================
+const DOCS_BASE = 'https://veloxts.dev/errors';
+/**
+ * Central error catalog containing all VeloxTS error definitions
+ */
+export const ERROR_CATALOG = {
+    // ==========================================================================
+    // E1xxx - Core/Runtime Errors
+    // ==========================================================================
+    E1001: {
+        code: 'E1001',
+        name: 'NOT_FOUND',
+        message: 'Resource not found',
+        fix: 'Check that the resource exists and the ID is correct.',
+        docsUrl: `${DOCS_BASE}/E1001`,
+    },
+    E1002: {
+        code: 'E1002',
+        name: 'VALIDATION_FAILED',
+        message: 'Input validation failed',
+        fix: 'Check the input data matches the expected schema.',
+        docsUrl: `${DOCS_BASE}/E1002`,
+    },
+    E1003: {
+        code: 'E1003',
+        name: 'UNAUTHORIZED',
+        message: 'Authentication required',
+        fix: 'Provide valid authentication credentials.',
+        docsUrl: `${DOCS_BASE}/E1003`,
+    },
+    E1004: {
+        code: 'E1004',
+        name: 'FORBIDDEN',
+        message: 'Access denied',
+        fix: 'Check that you have the required permissions for this action.',
+        docsUrl: `${DOCS_BASE}/E1004`,
+    },
+    E1005: {
+        code: 'E1005',
+        name: 'CONFLICT',
+        message: 'Resource conflict',
+        fix: 'The resource already exists or conflicts with existing data.',
+        docsUrl: `${DOCS_BASE}/E1005`,
+    },
+    E1006: {
+        code: 'E1006',
+        name: 'INTERNAL_ERROR',
+        message: 'Internal server error',
+        fix: 'Check server logs for more details.',
+        docsUrl: `${DOCS_BASE}/E1006`,
+    },
+    // ==========================================================================
+    // E2xxx - Generator Errors
+    // ==========================================================================
+    E2001: {
+        code: 'E2001',
+        name: 'NOT_IN_PROJECT',
+        message: 'Not in a VeloxTS project',
+        fix: 'Run this command from the root of your VeloxTS project (where package.json exists).',
+        docsUrl: `${DOCS_BASE}/E2001`,
+    },
+    E2002: {
+        code: 'E2002',
+        name: 'INVALID_ENTITY_NAME',
+        message: 'Invalid entity name',
+        fix: 'Entity names must be alphanumeric and start with a letter (e.g., User, BlogPost).',
+        docsUrl: `${DOCS_BASE}/E2002`,
+    },
+    E2003: {
+        code: 'E2003',
+        name: 'FILE_ALREADY_EXISTS',
+        message: 'File already exists',
+        fix: 'Use --force to overwrite existing files, or choose a different name.',
+        docsUrl: `${DOCS_BASE}/E2003`,
+    },
+    E2004: {
+        code: 'E2004',
+        name: 'INVALID_OPTION',
+        message: 'Invalid generator option',
+        fix: 'Run the command with --help to see available options.',
+        docsUrl: `${DOCS_BASE}/E2004`,
+    },
+    E2005: {
+        code: 'E2005',
+        name: 'GENERATION_FAILED',
+        message: 'Code generation failed',
+        fix: 'Check the error details above for more information.',
+        docsUrl: `${DOCS_BASE}/E2005`,
+    },
+    E2006: {
+        code: 'E2006',
+        name: 'CANCELED',
+        message: 'Operation canceled by user',
+        docsUrl: `${DOCS_BASE}/E2006`,
+    },
+    E2007: {
+        code: 'E2007',
+        name: 'PROJECT_STRUCTURE',
+        message: 'Invalid project structure',
+        fix: 'Ensure your project follows the VeloxTS directory conventions.',
+        docsUrl: `${DOCS_BASE}/E2007`,
+    },
+    E2008: {
+        code: 'E2008',
+        name: 'MIGRATION_FAILED',
+        message: 'Database migration failed',
+        fix: 'Run "npx prisma db push" manually to see detailed errors.',
+        docsUrl: `${DOCS_BASE}/E2008`,
+    },
+    // ==========================================================================
+    // E3xxx - Seeding Errors
+    // ==========================================================================
+    E3001: {
+        code: 'E3001',
+        name: 'SEEDER_NOT_FOUND',
+        message: 'Seeder not found',
+        fix: 'Check that the seeder exists in src/database/seeders/ and is properly exported.',
+        docsUrl: `${DOCS_BASE}/E3001`,
+    },
+    E3002: {
+        code: 'E3002',
+        name: 'CIRCULAR_DEPENDENCY',
+        message: 'Circular dependency detected between seeders',
+        fix: 'Review seeder dependencies and remove the circular reference.',
+        docsUrl: `${DOCS_BASE}/E3002`,
+    },
+    E3003: {
+        code: 'E3003',
+        name: 'EXECUTION_FAILED',
+        message: 'Seeder execution failed',
+        fix: 'Check the seeder implementation and database state.',
+        docsUrl: `${DOCS_BASE}/E3003`,
+    },
+    E3004: {
+        code: 'E3004',
+        name: 'TRUNCATION_FAILED',
+        message: 'Table truncation failed',
+        fix: 'Check for foreign key constraints that may prevent truncation.',
+        docsUrl: `${DOCS_BASE}/E3004`,
+    },
+    E3005: {
+        code: 'E3005',
+        name: 'INVALID_CONFIG',
+        message: 'Invalid seeder configuration',
+        fix: 'Ensure the seeder has required properties: name and run function.',
+        docsUrl: `${DOCS_BASE}/E3005`,
+    },
+    E3006: {
+        code: 'E3006',
+        name: 'DEPENDENCY_NOT_FOUND',
+        message: 'Seeder dependency not found',
+        fix: 'Ensure all dependencies exist in src/database/seeders/ and are registered.',
+        docsUrl: `${DOCS_BASE}/E3006`,
+    },
+    E3007: {
+        code: 'E3007',
+        name: 'NO_SEEDERS_FOUND',
+        message: 'No seeders found in project',
+        fix: 'Create a seeder with: velox make seeder <name>',
+        docsUrl: `${DOCS_BASE}/E3007`,
+    },
+    E3008: {
+        code: 'E3008',
+        name: 'DATABASE_ERROR',
+        message: 'Database error during seeding',
+        fix: 'Check your database connection and ensure it is running.',
+        docsUrl: `${DOCS_BASE}/E3008`,
+    },
+    E3010: {
+        code: 'E3010',
+        name: 'FACTORY_NOT_FOUND',
+        message: 'Factory not found in registry',
+        fix: 'Ensure the factory is properly instantiated before use.',
+        docsUrl: `${DOCS_BASE}/E3010`,
+    },
+    E3011: {
+        code: 'E3011',
+        name: 'STATE_NOT_FOUND',
+        message: 'Factory state not found',
+        fix: 'Register states using registerState() before calling state().',
+        docsUrl: `${DOCS_BASE}/E3011`,
+    },
+    E3012: {
+        code: 'E3012',
+        name: 'FACTORY_CREATE_FAILED',
+        message: 'Factory creation failed',
+        fix: 'Check the factory definition and ensure all required fields are provided.',
+        docsUrl: `${DOCS_BASE}/E3012`,
+    },
+    E3013: {
+        code: 'E3013',
+        name: 'INVALID_FACTORY',
+        message: 'Invalid factory configuration',
+        fix: 'Ensure the factory has a valid definition function.',
+        docsUrl: `${DOCS_BASE}/E3013`,
+    },
+    E3020: {
+        code: 'E3020',
+        name: 'FILESYSTEM_ERROR',
+        message: 'Filesystem error during seeder loading',
+        fix: 'Check file permissions and path validity.',
+        docsUrl: `${DOCS_BASE}/E3020`,
+    },
+    E3021: {
+        code: 'E3021',
+        name: 'INVALID_EXPORT',
+        message: 'Invalid seeder export',
+        fix: "Ensure the file exports a valid Seeder object with 'name' and 'run' properties.",
+        docsUrl: `${DOCS_BASE}/E3021`,
+    },
+    // ==========================================================================
+    // E4xxx - Migration Errors
+    // ==========================================================================
+    E4001: {
+        code: 'E4001',
+        name: 'PRISMA_NOT_FOUND',
+        message: 'Prisma CLI not found',
+        fix: 'Install Prisma: pnpm add @prisma/client prisma',
+        docsUrl: `${DOCS_BASE}/E4001`,
+    },
+    E4002: {
+        code: 'E4002',
+        name: 'MIGRATIONS_DIR_NOT_FOUND',
+        message: 'Migrations directory not found',
+        fix: 'Create a migration with: velox make migration create_users',
+        docsUrl: `${DOCS_BASE}/E4002`,
+    },
+    E4003: {
+        code: 'E4003',
+        name: 'MIGRATION_NOT_FOUND',
+        message: 'Migration not found',
+        fix: 'Run "velox migrate status" to see available migrations.',
+        docsUrl: `${DOCS_BASE}/E4003`,
+    },
+    E4004: {
+        code: 'E4004',
+        name: 'NO_ROLLBACK_FILE',
+        message: 'No down.sql file found for migration',
+        fix: 'Create a down.sql file in the migration folder, or use "velox migrate fresh" to reset.',
+        docsUrl: `${DOCS_BASE}/E4004`,
+    },
+    E4005: {
+        code: 'E4005',
+        name: 'ROLLBACK_FAILED',
+        message: 'Migration rollback failed',
+        fix: 'Check the down.sql file for syntax errors.',
+        docsUrl: `${DOCS_BASE}/E4005`,
+    },
+    E4006: {
+        code: 'E4006',
+        name: 'PRISMA_ERROR',
+        message: 'Prisma command failed',
+        fix: 'Run the Prisma command directly to see detailed error output.',
+        docsUrl: `${DOCS_BASE}/E4006`,
+    },
+    E4007: {
+        code: 'E4007',
+        name: 'MIGRATION_DATABASE_ERROR',
+        message: 'Database operation failed during migration',
+        fix: 'Check your database connection and ensure it is running.',
+        docsUrl: `${DOCS_BASE}/E4007`,
+    },
+    E4008: {
+        code: 'E4008',
+        name: 'NO_PENDING_MIGRATIONS',
+        message: 'No pending migrations to run',
+        fix: 'All migrations are up to date.',
+        docsUrl: `${DOCS_BASE}/E4008`,
+    },
+    E4009: {
+        code: 'E4009',
+        name: 'NO_APPLIED_MIGRATIONS',
+        message: 'No migrations have been applied',
+        fix: 'Run "velox migrate run" to apply migrations.',
+        docsUrl: `${DOCS_BASE}/E4009`,
+    },
+    E4010: {
+        code: 'E4010',
+        name: 'CHECKSUM_MISMATCH',
+        message: 'Migration checksum mismatch',
+        fix: 'The migration file was modified after being applied. Use "velox migrate fresh" to reset.',
+        docsUrl: `${DOCS_BASE}/E4010`,
+    },
+    // ==========================================================================
+    // E5xxx - Dev Server Errors
+    // ==========================================================================
+    E5001: {
+        code: 'E5001',
+        name: 'ENTRY_NOT_FOUND',
+        message: 'Application entry point not found',
+        fix: 'Specify entry with --entry flag or ensure src/index.ts exists.',
+        docsUrl: `${DOCS_BASE}/E5001`,
+    },
+    E5002: {
+        code: 'E5002',
+        name: 'PORT_IN_USE',
+        message: 'Port already in use',
+        fix: 'Stop other servers using this port, or use --port to specify a different port.',
+        docsUrl: `${DOCS_BASE}/E5002`,
+    },
+    E5003: {
+        code: 'E5003',
+        name: 'BUILD_ERROR',
+        message: 'Build error',
+        fix: 'Check the TypeScript compilation errors above.',
+        docsUrl: `${DOCS_BASE}/E5003`,
+    },
+    E5004: {
+        code: 'E5004',
+        name: 'RUNTIME_ERROR',
+        message: 'Runtime error',
+        fix: 'Check the stack trace for the error location.',
+        docsUrl: `${DOCS_BASE}/E5004`,
+    },
+    E5005: {
+        code: 'E5005',
+        name: 'MODULE_NOT_FOUND',
+        message: 'Module not found',
+        fix: 'Install the missing package with your package manager.',
+        docsUrl: `${DOCS_BASE}/E5005`,
+    },
+    E5006: {
+        code: 'E5006',
+        name: 'SYNTAX_ERROR',
+        message: 'Syntax error in source file',
+        fix: 'Check the indicated line for syntax issues.',
+        docsUrl: `${DOCS_BASE}/E5006`,
+    },
+    E5007: {
+        code: 'E5007',
+        name: 'TYPE_ERROR',
+        message: 'TypeScript type error',
+        fix: 'Fix the type error indicated in the message.',
+        docsUrl: `${DOCS_BASE}/E5007`,
+    },
+    E5008: {
+        code: 'E5008',
+        name: 'DATABASE_CONNECTION_FAILED',
+        message: 'Database connection failed',
+        fix: 'Check DATABASE_URL environment variable and ensure the database is running.',
+        docsUrl: `${DOCS_BASE}/E5008`,
+    },
+    E5009: {
+        code: 'E5009',
+        name: 'MISSING_ENV_VAR',
+        message: 'Required environment variable not set',
+        fix: 'Add the missing variable to your .env file.',
+        docsUrl: `${DOCS_BASE}/E5009`,
+    },
+    E5010: {
+        code: 'E5010',
+        name: 'STARTUP_TIMEOUT',
+        message: 'Server startup timed out',
+        fix: 'Check for blocking operations during server initialization.',
+        docsUrl: `${DOCS_BASE}/E5010`,
+    },
+    // ==========================================================================
+    // E9xxx - Configuration Errors
+    // ==========================================================================
+    E9001: {
+        code: 'E9001',
+        name: 'CONFIG_NOT_FOUND',
+        message: 'Configuration file not found',
+        fix: 'Create a velox.config.ts file in your project root.',
+        docsUrl: `${DOCS_BASE}/E9001`,
+    },
+    E9002: {
+        code: 'E9002',
+        name: 'INVALID_CONFIG',
+        message: 'Invalid configuration',
+        fix: 'Check your configuration file for syntax errors or invalid values.',
+        docsUrl: `${DOCS_BASE}/E9002`,
+    },
+    E9003: {
+        code: 'E9003',
+        name: 'PACKAGE_JSON_NOT_FOUND',
+        message: 'package.json not found',
+        fix: 'Run this command from your project root directory.',
+        docsUrl: `${DOCS_BASE}/E9003`,
+    },
+};
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Get an error definition from the catalog
+ */
+export function getErrorDefinition(code) {
+    return ERROR_CATALOG[code];
+}
+/**
+ * Check if an error code exists in the catalog
+ */
+export function isValidErrorCode(code) {
+    return code in ERROR_CATALOG;
+}
+/**
+ * Get all error codes for a category
+ */
+export function getErrorsByCategory(categoryPrefix) {
+    return Object.values(ERROR_CATALOG).filter((def) => def.code.startsWith(categoryPrefix));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/errors/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsBH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,6EAA6E;IAC7E,8BAA8B;IAC9B,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,oBAAoB;QAC7B,GAAG,EAAE,uDAAuD;QAC5D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,mDAAmD;QACxD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,2CAA2C;QAChD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,+DAA+D;QACpE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,mBAAmB;QAC5B,GAAG,EAAE,8DAA8D;QACnE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,uBAAuB;QAChC,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IAED,6EAA6E;IAC7E,2BAA2B;IAC3B,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,0BAA0B;QACnC,GAAG,EAAE,qFAAqF;QAC1F,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,mFAAmF;QACxF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,sEAAsE;QAC3E,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,0BAA0B;QACnC,GAAG,EAAE,uDAAuD;QAC5D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,qDAAqD;QAC1D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,2BAA2B;QACpC,GAAG,EAAE,gEAAgE;QACrE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,2BAA2B;QACpC,GAAG,EAAE,2DAA2D;QAChE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IAED,6EAA6E;IAC7E,yBAAyB;IACzB,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,kBAAkB;QAC3B,GAAG,EAAE,iFAAiF;QACtF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,8CAA8C;QACvD,GAAG,EAAE,+DAA+D;QACpE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,qDAAqD;QAC1D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,gEAAgE;QACrE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,8BAA8B;QACvC,GAAG,EAAE,mEAAmE;QACxE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,6BAA6B;QACtC,GAAG,EAAE,4EAA4E;QACjF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,6BAA6B;QACtC,GAAG,EAAE,gDAAgD;QACrD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,+BAA+B;QACxC,GAAG,EAAE,0DAA0D;QAC/D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,+BAA+B;QACxC,GAAG,EAAE,yDAAyD;QAC9D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,+DAA+D;QACpE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,yBAAyB;QAClC,GAAG,EAAE,2EAA2E;QAChF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,+BAA+B;QACxC,GAAG,EAAE,qDAAqD;QAC1D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,wCAAwC;QACjD,GAAG,EAAE,2CAA2C;QAChD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,uBAAuB;QAChC,GAAG,EAAE,iFAAiF;QACtF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IAED,6EAA6E;IAC7E,2BAA2B;IAC3B,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,sBAAsB;QAC/B,GAAG,EAAE,gDAAgD;QACrD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,gCAAgC;QACzC,GAAG,EAAE,4DAA4D;QACjE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,yDAAyD;QAC9D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,sCAAsC;QAC/C,GAAG,EAAE,wFAAwF;QAC7F,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,2BAA2B;QACpC,GAAG,EAAE,4CAA4C;QACjD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,uBAAuB;QAChC,GAAG,EAAE,+DAA+D;QACpE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,4CAA4C;QACrD,GAAG,EAAE,0DAA0D;QAC/D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,8BAA8B;QACvC,GAAG,EAAE,gCAAgC;QACrC,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,iCAAiC;QAC1C,GAAG,EAAE,8CAA8C;QACnD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,6BAA6B;QACtC,GAAG,EAAE,0FAA0F;QAC/F,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IAED,6EAA6E;IAC7E,4BAA4B;IAC5B,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,mCAAmC;QAC5C,GAAG,EAAE,gEAAgE;QACrE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,gFAAgF;QACrF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa;QACtB,GAAG,EAAE,gDAAgD;QACrD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,+CAA+C;QACpD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,kBAAkB;QAC3B,GAAG,EAAE,wDAAwD;QAC7D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,6BAA6B;QACtC,GAAG,EAAE,6CAA6C;QAClD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,uBAAuB;QAChC,GAAG,EAAE,8CAA8C;QACnD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,4BAA4B;QACrC,GAAG,EAAE,6EAA6E;QAClF,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,uCAAuC;QAChD,GAAG,EAAE,6CAA6C;QAClD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,0BAA0B;QACnC,GAAG,EAAE,6DAA6D;QAClE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IAED,6EAA6E;IAC7E,+BAA+B;IAC/B,6EAA6E;IAE7E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,8BAA8B;QACvC,GAAG,EAAE,qDAAqD;QAC1D,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,uBAAuB;QAChC,GAAG,EAAE,oEAAoE;QACzE,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,oDAAoD;QACzD,OAAO,EAAE,GAAG,SAAS,QAAQ;KAC9B;CACF,CAAC;AAEF,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,IAAI,aAAa,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,cAAsB;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * VeloxTS Error System
+ *
+ * Central error handling for the CLI with structured error codes,
+ * fix suggestions, and JSON serialization for AI tooling.
+ *
+ * @example
+ * ```typescript
+ * import { VeloxError, ERROR_CATALOG } from './errors/index.js';
+ *
+ * // Throw a structured error
+ * throw new VeloxError('E2001');
+ *
+ * // Use factory methods
+ * throw VeloxError.notFound('User', '123');
+ *
+ * // Format for display
+ * console.error(error.format());
+ *
+ * // Serialize for --json output
+ * console.log(JSON.stringify({ error: error.toJSON() }));
+ * ```
+ */
+export { ERROR_CATALOG, type ErrorDefinition, getErrorDefinition, getErrorsByCategory, isValidErrorCode, } from './catalog.js';
+export { type ErrorLocation, VeloxError, type VeloxErrorOptions } from './velox-error.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,aAAa,EACb,KAAK,eAAe,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,28 @@
+/**
+ * VeloxTS Error System
+ *
+ * Central error handling for the CLI with structured error codes,
+ * fix suggestions, and JSON serialization for AI tooling.
+ *
+ * @example
+ * ```typescript
+ * import { VeloxError, ERROR_CATALOG } from './errors/index.js';
+ *
+ * // Throw a structured error
+ * throw new VeloxError('E2001');
+ *
+ * // Use factory methods
+ * throw VeloxError.notFound('User', '123');
+ *
+ * // Format for display
+ * console.error(error.format());
+ *
+ * // Serialize for --json output
+ * console.log(JSON.stringify({ error: error.toJSON() }));
+ * ```
+ */
+// Error catalog and definitions
+export { ERROR_CATALOG, getErrorDefinition, getErrorsByCategory, isValidErrorCode, } from './catalog.js';
+// Base error class
+export { VeloxError } from './velox-error.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gCAAgC;AAChC,OAAO,EACL,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,mBAAmB;AACnB,OAAO,EAAsB,UAAU,EAA0B,MAAM,kBAAkB,CAAC"}

package/dist/errors/velox-error.d.ts

@@ -0,0 +1,122 @@
+/**
+ * VeloxError Base Class
+ *
+ * A structured error class with error codes, fix suggestions, and JSON serialization.
+ * All VeloxTS CLI errors extend this class.
+ */
+import { type ErrorDefinition } from './catalog.js';
+/**
+ * Location information for an error
+ */
+export interface ErrorLocation {
+    /** File path where the error occurred */
+    readonly file?: string;
+    /** Line number (1-indexed) */
+    readonly line?: number;
+    /** Column number (1-indexed) */
+    readonly column?: number;
+}
+/**
+ * Options for creating a VeloxError
+ */
+export interface VeloxErrorOptions {
+    /** Custom message (overrides catalog message) */
+    message?: string;
+    /** Suggested fix (overrides catalog fix) */
+    fix?: string;
+    /** Location where the error occurred */
+    location?: ErrorLocation;
+    /** Additional context/details */
+    details?: Record<string, unknown>;
+    /** Original error that caused this error */
+    cause?: Error;
+}
+/**
+ * Base error class for all VeloxTS CLI errors.
+ *
+ * Features:
+ * - Error codes from central catalog (E1001, E2001, etc.)
+ * - Optional fix suggestions
+ * - Optional location information
+ * - JSON serialization for --json output
+ * - Formatted console output with colors
+ *
+ * @example
+ * ```typescript
+ * // Using a catalog code
+ * throw new VeloxError('E2001');
+ *
+ * // With custom message and location
+ * throw new VeloxError('E5003', {
+ *   message: 'Failed to compile users.ts',
+ *   location: { file: 'src/procedures/users.ts', line: 42 }
+ * });
+ *
+ * // Using factory methods
+ * throw VeloxError.notFound('User', '123');
+ * ```
+ */
+export declare class VeloxError extends Error {
+    /** Error code (e.g., 'E2001') */
+    readonly code: string;
+    /** Error name from catalog (e.g., 'NOT_IN_PROJECT') */
+    readonly errorName: string;
+    /** Suggested fix for the error */
+    readonly fix?: string;
+    /** URL to documentation about this error */
+    readonly docsUrl?: string;
+    /** Location where the error occurred */
+    readonly location?: ErrorLocation;
+    /** Additional context/details */
+    readonly details?: Record<string, unknown>;
+    constructor(code: string, options?: VeloxErrorOptions);
+    /**
+     * Format error for console display with colors
+     */
+    format(): string;
+    /**
+     * Format error for console display without colors
+     */
+    formatPlain(): string;
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create a NOT_FOUND error (E1001)
+     */
+    static notFound(resource: string, id?: string): VeloxError;
+    /**
+     * Create a VALIDATION_FAILED error (E1002)
+     */
+    static validation(message: string, details?: Record<string, unknown>): VeloxError;
+    /**
+     * Create an UNAUTHORIZED error (E1003)
+     */
+    static unauthorized(message?: string): VeloxError;
+    /**
+     * Create a FORBIDDEN error (E1004)
+     */
+    static forbidden(message?: string): VeloxError;
+    /**
+     * Create a CONFLICT error (E1005)
+     */
+    static conflict(message: string, details?: Record<string, unknown>): VeloxError;
+    /**
+     * Create an INTERNAL_ERROR (E1006)
+     */
+    static internal(message: string, cause?: Error): VeloxError;
+    /**
+     * Check if an error is a VeloxError
+     */
+    static isVeloxError(error: unknown): error is VeloxError;
+    /**
+     * Get all available error codes
+     */
+    static getCodes(): string[];
+    /**
+     * Get error definition from catalog
+     */
+    static getDefinition(code: string): ErrorDefinition | undefined;
+}
+//# sourceMappingURL=velox-error.d.ts.map

package/dist/errors/velox-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"velox-error.d.ts","sourceRoot":"","sources":["../../src/errors/velox-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAiB,KAAK,eAAe,EAAsB,MAAM,cAAc,CAAC;AAMvF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,iCAAiC;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,uDAAuD;IACvD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,kCAAkC;IAClC,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;IAE7B,4CAA4C;IAC5C,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC,wCAAwC;IACxC,SAAgB,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzC,iCAAiC;IACjC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAmBrD;;OAEG;IACH,MAAM,IAAI,MAAM;IAyChB;;OAEG;IACH,WAAW,IAAI,MAAM;IAwCrB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgBjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IAQ1D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAIjF;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,SAA4B,GAAG,UAAU;IAIpE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,SAAkB,GAAG,UAAU;IAIvD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAI/E;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU;IAQ3D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU;IAIxD;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;CAGhE"}