@veloxts/cli 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @veloxts/cli
 
+## 0.7.3
+
+### Patch Changes
+
+- feat(cli): auto-populate Zod schemas from Prisma model fields
+- Updated dependencies
+  - @veloxts/auth@0.7.3
+  - @veloxts/core@0.7.3
+  - @veloxts/orm@0.7.3
+  - @veloxts/router@0.7.3
+  - @veloxts/validation@0.7.3
+
+## 0.7.2
+
+### Patch Changes
+
+- fix(cli): replace require() with readFileSync in MCP tests
+- simplify code for clarity and maintainability
+- Updated dependencies
+  - @veloxts/core@0.7.2
+
 ## 0.7.1
 
 ### Patch Changes

package/dist/commands/introspect.js

@@ -10,28 +10,33 @@
  */
 import { existsSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
+import { join } from 'node:path';
 import { discoverProceduresVerbose, getRouteSummary, isDiscoveryError, } from '@veloxts/router';
 import { Command } from 'commander';
-import { config as loadEnv } from 'dotenv';
 import pc from 'picocolors';
 import { getErrorsByCategory } from '../errors/index.js';
+import { loadEnvironment } from '../utils/paths.js';
 import { extractSchemaNames, extractSchemaTypes } from '../utils/schema-patterns.js';
 // ============================================================================
 // Constants
 // ============================================================================
 /** Default API prefix for REST routes */
 const DEFAULT_API_PREFIX = '/api';
-// ============================================================================
-// Helper Functions
-// ============================================================================
 /**
- * Load environment variables from .env file if present
+ * Get picocolors color function for an HTTP method
  */
-function loadEnvironment() {
-    const envPath = resolve(process.cwd(), '.env');
-    if (existsSync(envPath)) {
-        loadEnv({ path: envPath });
+function getMethodColor(method) {
+    switch (method) {
+        case 'GET':
+            return pc.green;
+        case 'POST':
+            return pc.yellow;
+        case 'PUT':
+            return pc.blue;
+        case 'PATCH':
+            return pc.cyan;
+        default:
+            return pc.red;
     }
 }
 /**
@@ -139,9 +144,9 @@ function getErrorIntrospection() {
     for (const prefix of categories) {
         const categoryErrors = getErrorsByCategory(prefix);
         const categoryName = categoryNames[prefix] ?? 'Unknown';
-        for (const [code, def] of Object.entries(categoryErrors)) {
+        for (const def of categoryErrors) {
             errors.push({
-                code,
+                code: def.code,
                 name: def.name,
                 message: def.message,
                 fix: def.fix,
@@ -172,15 +177,7 @@ function printProcedures(procedures) {
             console.log(pc.bold(pc.cyan(`/${currentNs}`)));
         }
         const method = proc.route?.method ?? (proc.type === 'query' ? 'GET' : 'POST');
-        const methodColor = method === 'GET'
-            ? pc.green
-            : method === 'POST'
-                ? pc.yellow
-                : method === 'PUT'
-                    ? pc.blue
-                    : method === 'PATCH'
-                        ? pc.cyan
-                        : pc.red;
+        const methodColor = getMethodColor(method);
         const schemas = [];
         if (proc.hasInput)
             schemas.push('in');
@@ -226,15 +223,7 @@ function printRoutes(routes) {
     console.log(pc.bold('REST Routes'));
     console.log(pc.dim('─'.repeat(60)));
     for (const route of routes) {
-        const methodColor = route.method === 'GET'
-            ? pc.green
-            : route.method === 'POST'
-                ? pc.yellow
-                : route.method === 'PUT'
-                    ? pc.blue
-                    : route.method === 'PATCH'
-                        ? pc.cyan
-                        : pc.red;
+        const methodColor = getMethodColor(route.method);
         console.log(`  ${methodColor(route.method.padEnd(7))} ${route.path}`);
         console.log(pc.dim(`          → ${route.namespace}.${route.procedure}`));
     }

package/dist/commands/mcp.js

@@ -95,8 +95,7 @@ async function readClaudeConfig(configPath) {
         return null;
     }
     try {
-        const config = await readJsonFile(configPath);
-        return config;
+        return await readJsonFile(configPath);
     }
     catch (err) {
         throw new Error(`Failed to parse Claude Desktop configuration: ${err instanceof Error ? err.message : String(err)}`);
@@ -301,7 +300,7 @@ async function runMcpInit(options) {
             process.exit(1);
         }
         // Success!
-        const action = isAlreadyConfigured ? 'updated' : configExists ? 'updated' : 'created';
+        const action = configExists ? 'updated' : 'created';
         const result = {
             success: true,
             action,

package/dist/commands/openapi.js

@@ -11,18 +11,9 @@ import { createServer } from 'node:http';
 import { dirname, extname, resolve } from 'node:path';
 import { discoverProceduresVerbose, generateOpenApiSpec, generateSwaggerUIHtml, isDiscoveryError, validateOpenApiSpec, } from '@veloxts/router';
 import { Command } from 'commander';
-import { config as loadEnv } from 'dotenv';
 import pc from 'picocolors';
 import YAML from 'yaml';
-/**
- * Load environment variables from .env file if present
- */
-function loadEnvironment() {
-    const envPath = resolve(process.cwd(), '.env');
-    if (existsSync(envPath)) {
-        loadEnv({ path: envPath });
-    }
-}
+import { loadEnvironment } from '../utils/paths.js';
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/dist/commands/procedures.js

@@ -4,21 +4,10 @@
  * Provides subcommands for managing procedures:
  * - procedures:list - List all discovered procedures
  */
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
 import { discoverProceduresVerbose, isDiscoveryError, } from '@veloxts/router';
 import { Command } from 'commander';
-import { config as loadEnv } from 'dotenv';
 import pc from 'picocolors';
-/**
- * Load environment variables from .env file if present
- */
-function loadEnvironment() {
-    const envPath = resolve(process.cwd(), '.env');
-    if (existsSync(envPath)) {
-        loadEnv({ path: envPath });
-    }
-}
+import { loadEnvironment } from '../utils/paths.js';
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/dist/dev/error-parser.js

@@ -264,9 +264,6 @@ function generateSuggestion(type, errorText) {
             if (moduleName.startsWith('.') || moduleName.startsWith('/')) {
                 suggestion = `Check that the file '${moduleName}' exists and the path is correct relative to the importing file.`;
             }
-            else if (moduleName.startsWith('@')) {
-                suggestion = `Install the package: pnpm add ${moduleName}`;
-            }
             else {
                 suggestion = `Install the package: pnpm add ${moduleName}`;
             }

package/dist/generators/fields/types.d.ts

@@ -88,6 +88,13 @@ export declare function validateEnumName(name: string): string | undefined;
  * Validate enum values format (UPPER_CASE)
  */
 export declare function validateEnumValues(values: string[]): string | undefined;
+/**
+ * Map a Prisma schema type string to a FieldType
+ *
+ * Used when reading fields from an existing Prisma model to convert them
+ * into FieldDefinition objects for code generation.
+ */
+export declare function prismaTypeToFieldType(prismaType: string): FieldType;
 /**
  * Parse comma-separated enum values
  */

package/dist/generators/fields/types.js

@@ -138,6 +138,35 @@ export function validateEnumValues(values) {
     }
     return undefined;
 }
+// ============================================================================
+// Prisma Type Mapping
+// ============================================================================
+/**
+ * Map a Prisma schema type string to a FieldType
+ *
+ * Used when reading fields from an existing Prisma model to convert them
+ * into FieldDefinition objects for code generation.
+ */
+export function prismaTypeToFieldType(prismaType) {
+    switch (prismaType) {
+        case 'String':
+            return 'string';
+        case 'Int':
+            return 'int';
+        case 'Float':
+        case 'Decimal':
+        case 'BigInt':
+            return 'float';
+        case 'Boolean':
+            return 'boolean';
+        case 'DateTime':
+            return 'datetime';
+        case 'Json':
+            return 'json';
+        default:
+            return 'string';
+    }
+}
 /**
  * Parse comma-separated enum values
  */

package/dist/generators/generators/namespace.js

@@ -14,7 +14,7 @@
 import { BaseGenerator } from '../base.js';
 import { getNamespaceInstructions, getNamespaceProcedurePath, getNamespaceSchemaPath, getNamespaceTestPath, namespaceSchemaTemplate, namespaceTemplate, namespaceTestTemplate, } from '../templates/namespace.js';
 import { deriveEntityNames } from '../utils/naming.js';
-import { analyzePrismaSchema, findPrismaSchema, getModelRelations, hasModel, } from '../utils/prisma-schema.js';
+import { analyzePrismaSchema, findPrismaSchema, getModelFields, getModelRelations, hasModel, } from '../utils/prisma-schema.js';
 import { detectRouterPattern, isProcedureRegistered, registerProcedures, } from '../utils/router-integration.js';
 // ============================================================================
 // Generator Implementation
@@ -113,10 +113,15 @@ Examples:
                             hasMany: [...modelRelations.hasMany],
                         };
                     }
+                    // Extract scalar fields for Zod schema generation
+                    const scalarFields = getModelFields(schemaAnalysis, entity.pascal);
+                    if (scalarFields.length > 0) {
+                        enrichedOptions.fields = scalarFields;
+                    }
                 }
             }
             catch {
-                // Schema parsing failed — proceed without relations
+                // Schema parsing failed — proceed without relations or fields
             }
         }
         const enrichedConfig = { ...config, options: enrichedOptions };

package/dist/generators/templates/namespace.d.ts

@@ -5,6 +5,7 @@
  * Unlike the procedure generator, this creates a minimal scaffold ready for
  * custom procedures rather than pre-defined CRUD operations.
  */
+import type { FieldDefinition } from '../fields/types.js';
 import type { TemplateContext, TemplateFunction } from '../types.js';
 /**
  * Relation info for code generation (shared with resource template)
@@ -24,6 +25,8 @@ export interface NamespaceOptions {
     withTests: boolean;
     /** Detected relations from Prisma schema */
     relations?: RelationInfo;
+    /** Scalar fields extracted from Prisma model */
+    fields?: FieldDefinition[];
 }
 /**
  * Generate namespace procedure file

package/dist/generators/templates/namespace.js

@@ -5,6 +5,8 @@
  * Unlike the procedure generator, this creates a minimal scaffold ready for
  * custom procedures rather than pre-defined CRUD operations.
  */
+import { FIELD_TYPES } from '../fields/types.js';
+import { fieldToZod } from '../templates/resource.js';
 // ============================================================================
 // Relation Helpers
 // ============================================================================
@@ -170,7 +172,89 @@ export const ${entity.camel}Procedures = procedures('${entity.plural}', {
  * Generate schema file for the namespace
  */
 export function namespaceSchemaTemplate(ctx) {
-    const { entity } = ctx;
+    const { entity, options } = ctx;
+    const fields = options.fields;
+    if (fields && fields.length > 0) {
+        return generateSchemaWithFields(entity, fields);
+    }
+    return generateSchemaPlaceholder(entity);
+}
+/**
+ * Generate schema with actual fields from Prisma model
+ */
+function generateSchemaWithFields(entity, fields) {
+    // Base schema: all fields
+    const baseFields = fields.map(fieldToZod).join('\n');
+    // Create input: non-auto-generated fields (those without @default or @updatedAt)
+    const createFields = fields.filter((f) => !f.attributes.hasDefault);
+    const createFieldLines = createFields.map((f) => {
+        // In create input, optional fields use .optional() instead of .nullable()
+        return fieldToZodForInput(f);
+    });
+    const createContent = createFieldLines.join('\n');
+    return `/**
+ * ${entity.pascal} Schemas
+ *
+ * Zod validation schemas for ${entity.humanReadable} entities.
+ */
+
+import { z } from 'zod';
+
+// ============================================================================
+// Base Schema
+// ============================================================================
+
+/**
+ * ${entity.pascal} entity schema
+ */
+export const ${entity.pascal}Schema = z.object({
+  id: z.string().uuid(),
+${baseFields}
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
+});
+
+export type ${entity.pascal} = z.infer<typeof ${entity.pascal}Schema>;
+
+// ============================================================================
+// Input Schemas
+// ============================================================================
+
+/**
+ * Create ${entity.pascal} input
+ */
+export const Create${entity.pascal}Input = z.object({
+${createContent}
+});
+
+export type Create${entity.pascal}InputType = z.infer<typeof Create${entity.pascal}Input>;
+
+/**
+ * Update ${entity.pascal} input
+ */
+export const Update${entity.pascal}Input = z.object({
+${createContent}
+}).partial();
+
+export type Update${entity.pascal}InputType = z.infer<typeof Update${entity.pascal}Input>;
+`;
+}
+/**
+ * Convert a field to Zod for input schemas (optional → .optional() instead of .nullable())
+ */
+function fieldToZodForInput(field) {
+    // Create a copy with optional mapped to .optional() suffix
+    const typeInfo = FIELD_TYPES.find((t) => t.type === field.type);
+    let zodType = typeInfo?.zodSchema ?? 'z.string()';
+    if (field.attributes.optional) {
+        zodType += '.optional()';
+    }
+    return `  ${field.name}: ${zodType},`;
+}
+/**
+ * Generate schema with TODO placeholders (no Prisma model found)
+ */
+function generateSchemaPlaceholder(entity) {
     return `/**
  * ${entity.pascal} Schemas
  *

package/dist/generators/utils/prisma-schema.d.ts

@@ -4,6 +4,7 @@
  * Parses Prisma schema files to find models/enums and enables safe injection
  * of new definitions without breaking existing code.
  */
+import type { FieldDefinition } from '../fields/types.js';
 /**
  * Parsed information about a single field in a Prisma model
  */
@@ -18,6 +19,10 @@ export interface PrismaFieldInfo {
     readonly isArray: boolean;
     /** The related model name, if this is a relation field */
     readonly relatedModel: string | undefined;
+    /** Whether this field has a `?` modifier (nullable/optional) */
+    readonly isOptional: boolean;
+    /** Whether this field has `@default(...)` or `@updatedAt` */
+    readonly hasDefault: boolean;
 }
 /**
  * Detailed information about a Prisma model including its fields
@@ -129,6 +134,19 @@ export declare function injectIntoSchema(analysis: PrismaSchemaAnalysis, models:
  * Throws if any model or enum already exists (prevents accidental overwrites)
  */
 export declare function validateNoConflicts(analysis: PrismaSchemaAnalysis, models: PrismaModelDefinition[], enums?: PrismaEnumDefinition[]): void;
+/**
+ * Convert a PrismaFieldInfo to a FieldDefinition for code generation
+ *
+ * Returns null for fields that should be skipped (relations, reserved names).
+ */
+export declare function prismaFieldToFieldDefinition(field: PrismaFieldInfo): FieldDefinition | null;
+/**
+ * Get scalar, non-auto-generated fields from a Prisma model as FieldDefinitions
+ *
+ * Filters out relation fields, reserved fields (id, createdAt, updatedAt, deletedAt),
+ * and fields with @id annotation.
+ */
+export declare function getModelFields(analysis: PrismaSchemaAnalysis, modelName: string): FieldDefinition[];
 /**
  * Generate a minimal Prisma model string
  */

package/dist/generators/utils/prisma-schema.js

@@ -5,6 +5,7 @@
  * of new definitions without breaking existing code.
  */
 import { existsSync, readFileSync } from 'node:fs';
+import { prismaTypeToFieldType, RESERVED_FIELD_NAMES } from '../fields/types.js';
 import { GeneratorError, GeneratorErrorCode } from '../types.js';
 // ============================================================================
 // Schema Parsing
@@ -156,13 +157,15 @@ function parseModelFields(body, modelNames) {
             continue;
         }
         // Parse field: name Type[?][] [@annotations...]
-        // Match: fieldName  TypeName  optional modifiers
-        const fieldMatch = trimmed.match(/^(\w+)\s+(\w+)(\[\])?\??/);
+        // Match: fieldName  TypeName  optional array and optional modifiers
+        const fieldMatch = trimmed.match(/^(\w+)\s+(\w+)(\[\])?(\?)?/);
         if (!fieldMatch)
             continue;
         const name = fieldMatch[1];
         const baseType = fieldMatch[2];
         const isArray = fieldMatch[3] === '[]';
+        const isOptional = fieldMatch[4] === '?';
+        const hasDefault = /@default\(/.test(trimmed) || /@updatedAt/.test(trimmed);
         // Check if this is a relation field (type matches a known model)
         const isRelation = modelNames.has(baseType);
         if (!isRelation) {
@@ -172,6 +175,8 @@ function parseModelFields(body, modelNames) {
                 isRelation: false,
                 isArray: false,
                 relatedModel: undefined,
+                isOptional,
+                hasDefault,
             });
             continue;
         }
@@ -188,6 +193,8 @@ function parseModelFields(body, modelNames) {
             isRelation: true,
             isArray,
             relatedModel: baseType,
+            isOptional,
+            hasDefault,
         });
     }
     return fields;
@@ -311,6 +318,50 @@ export function validateNoConflicts(analysis, models, enums = []) {
     }
 }
 // ============================================================================
+// Field Conversion
+// ============================================================================
+/**
+ * Convert a PrismaFieldInfo to a FieldDefinition for code generation
+ *
+ * Returns null for fields that should be skipped (relations, reserved names).
+ */
+export function prismaFieldToFieldDefinition(field) {
+    // Skip relation fields
+    if (field.isRelation)
+        return null;
+    // Skip reserved fields (id, createdAt, updatedAt, deletedAt)
+    if (RESERVED_FIELD_NAMES.includes(field.name))
+        return null;
+    return {
+        name: field.name,
+        type: prismaTypeToFieldType(field.type),
+        attributes: {
+            optional: field.isOptional,
+            unique: false, // Not tracked in PrismaFieldInfo
+            hasDefault: field.hasDefault,
+        },
+    };
+}
+/**
+ * Get scalar, non-auto-generated fields from a Prisma model as FieldDefinitions
+ *
+ * Filters out relation fields, reserved fields (id, createdAt, updatedAt, deletedAt),
+ * and fields with @id annotation.
+ */
+export function getModelFields(analysis, modelName) {
+    const modelInfo = analysis.modelDetails.get(modelName);
+    if (!modelInfo)
+        return [];
+    const fields = [];
+    for (const field of modelInfo.fields) {
+        const converted = prismaFieldToFieldDefinition(field);
+        if (converted) {
+            fields.push(converted);
+        }
+    }
+    return fields;
+}
+// ============================================================================
 // Helpers
 // ============================================================================
 /**

package/dist/utils/paths.d.ts

@@ -101,3 +101,7 @@ export declare function writeJsonFile(filePath: string, data: unknown): Promise<
  * Create a directory recursively
  */
 export declare function createDirectory(dirPath: string): void;
+/**
+ * Load environment variables from .env file if present
+ */
+export declare function loadEnvironment(cwd?: string): void;

package/dist/utils/paths.js

@@ -4,6 +4,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { config as loadEnv } from 'dotenv';
 /** Common entry point file names, ordered by preference */
 const ENTRY_POINT_PATTERNS = [
     'src/index.ts',
@@ -252,8 +253,7 @@ export async function isVeloxProject(cwd = process.cwd()) {
         return false;
     }
     try {
-        const fs = await import('node:fs/promises');
-        const content = await fs.readFile(packageJsonPath, 'utf-8');
+        const content = await readFile(packageJsonPath, 'utf-8');
         const pkg = JSON.parse(content);
         // Check if any @veloxts packages are in dependencies
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -289,8 +289,7 @@ export async function detectProjectType(cwd = process.cwd()) {
         return result;
     }
     try {
-        const fs = await import('node:fs/promises');
-        const content = await fs.readFile(packageJsonPath, 'utf-8');
+        const content = await readFile(packageJsonPath, 'utf-8');
         const pkg = JSON.parse(content);
         // Collect all dependencies
         result.dependencies = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -328,3 +327,12 @@ export async function writeJsonFile(filePath, data) {
 export function createDirectory(dirPath) {
     mkdirSync(dirPath, { recursive: true });
 }
+/**
+ * Load environment variables from .env file if present
+ */
+export function loadEnvironment(cwd = process.cwd()) {
+    const envPath = path.resolve(cwd, '.env');
+    if (existsSync(envPath)) {
+        loadEnv({ path: envPath });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/cli",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Developer tooling and CLI commands for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -41,11 +41,11 @@
     "pluralize": "8.0.0",
     "tsx": "4.21.0",
     "yaml": "2.8.2",
-    "@veloxts/core": "0.7.1",
-    "@veloxts/router": "0.7.1",
-    "@veloxts/validation": "0.7.1",
-    "@veloxts/orm": "0.7.1",
-    "@veloxts/auth": "0.7.1"
+    "@veloxts/auth": "0.7.3",
+    "@veloxts/orm": "0.7.3",
+    "@veloxts/core": "0.7.3",
+    "@veloxts/router": "0.7.3",
+    "@veloxts/validation": "0.7.3"
   },
   "peerDependencies": {
     "@prisma/client": ">=7.0.0"