@veloxts/cli 0.7.2 → 0.7.4

package/dist/sync/prompter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sync Prompter
+ *
+ * Interactive prompts for the `velox sync` command.
+ * Collects user choices for each Prisma model: action, CRUD operations,
+ * output strategy, relation inclusion, and field visibility.
+ */
+import type { ExistingCodeMap, ModelChoices, SyncModelInfo } from './types.js';
+/**
+ * Run the full interactive flow for all models.
+ * Returns null if user cancels at any point.
+ */
+export declare function promptAllModels(models: readonly SyncModelInfo[], existing: ExistingCodeMap): Promise<readonly ModelChoices[] | null>;
+/**
+ * Run interactive prompts for a single model.
+ * Returns null if user cancels (Ctrl+C).
+ */
+export declare function promptForModel(model: SyncModelInfo, existing: ExistingCodeMap): Promise<ModelChoices | null>;

package/dist/sync/prompter.js

@@ -0,0 +1,312 @@
+/**
+ * Sync Prompter
+ *
+ * Interactive prompts for the `velox sync` command.
+ * Collects user choices for each Prisma model: action, CRUD operations,
+ * output strategy, relation inclusion, and field visibility.
+ */
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Models that default to resource output strategy */
+const RESOURCE_DEFAULT_MODELS = new Set(['User', 'Message']);
+/** Horizontal rule width for model headers */
+const HEADER_WIDTH = 54;
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Run the full interactive flow for all models.
+ * Returns null if user cancels at any point.
+ */
+export async function promptAllModels(models, existing) {
+    const results = [];
+    for (const model of models) {
+        const choices = await promptForModel(model, existing);
+        if (choices === null) {
+            return null;
+        }
+        results.push(choices);
+    }
+    return results;
+}
+/**
+ * Run interactive prompts for a single model.
+ * Returns null if user cancels (Ctrl+C).
+ */
+export async function promptForModel(model, existing) {
+    // Step 1: Display model header
+    displayModelHeader(model, existing);
+    // Step 2: Action selection
+    const action = await promptAction(model, existing);
+    if (action === null)
+        return null;
+    if (action === 'skip') {
+        return buildSkipChoices(model.name);
+    }
+    // Step 3: Output strategy
+    const outputStrategy = await promptOutputStrategy(model);
+    if (outputStrategy === null)
+        return null;
+    // Step 4: CRUD operations
+    const crud = await promptCrudOperations(model);
+    if (crud === null)
+        return null;
+    // Step 5: Schema relations (only if model has relations)
+    let schemaRelations = [];
+    if (model.relations.length > 0) {
+        const selected = await promptSchemaRelations(model);
+        if (selected === null)
+            return null;
+        schemaRelations = selected;
+    }
+    // Step 6: Include relations (only if schema relations were selected)
+    let includeRelations = [];
+    if (schemaRelations.length > 0) {
+        const selected = await promptIncludeRelations(schemaRelations);
+        if (selected === null)
+            return null;
+        includeRelations = selected;
+    }
+    // Step 7: Field visibility (only if resource strategy)
+    let fieldVisibility;
+    if (outputStrategy === 'resource') {
+        const visibility = await promptFieldVisibility(model);
+        if (visibility === null)
+            return null;
+        fieldVisibility = visibility;
+    }
+    return {
+        model: model.name,
+        action,
+        outputStrategy,
+        crud,
+        schemaRelations,
+        includeRelations,
+        fieldVisibility,
+    };
+}
+// ============================================================================
+// Step 1: Model Header
+// ============================================================================
+/**
+ * Display a formatted header for the model being prompted.
+ */
+function displayModelHeader(model, existing) {
+    const titlePart = `── ${model.name} `;
+    const remainingWidth = Math.max(0, HEADER_WIDTH - titlePart.length);
+    const ruler = titlePart + '─'.repeat(remainingWidth);
+    const nonAutoFields = model.fields.filter((f) => !f.isAutoManaged);
+    const fieldNames = nonAutoFields.map((f) => f.name).join(', ');
+    const relationLabels = model.relations.map((r) => formatRelationLabel(r)).join(', ');
+    const lines = [pc.bold(ruler), `   Fields: ${fieldNames || pc.dim('(none)')}`];
+    if (model.relations.length > 0) {
+        lines.push(`   Relations: ${relationLabels}`);
+    }
+    const existingPath = existing.procedures.get(model.name);
+    if (existingPath) {
+        lines.push(`   Existing: ${pc.dim(existingPath)}`);
+    }
+    p.log.info(lines.join('\n'));
+}
+/**
+ * Format a relation for display: `name(->RelatedModel)` or `name(->RelatedModel[])`.
+ */
+function formatRelationLabel(relation) {
+    const suffix = relation.kind === 'hasMany' ? '[]' : '';
+    return `${relation.name}(→${relation.relatedModel}${suffix})`;
+}
+// ============================================================================
+// Step 2: Action Selection
+// ============================================================================
+/**
+ * Prompt the user for the action to take on a model.
+ * Returns 'generate', 'regenerate', or 'skip', or null if cancelled.
+ */
+async function promptAction(model, existing) {
+    const hasExisting = existing.procedures.has(model.name);
+    if (hasExisting) {
+        const action = await p.select({
+            message: `Action for ${model.name}?`,
+            options: [
+                { value: 'skip', label: 'Skip (keep existing)' },
+                { value: 'regenerate', label: 'Regenerate (overwrite)' },
+            ],
+        });
+        if (p.isCancel(action))
+            return null;
+        return action;
+    }
+    const action = await p.select({
+        message: `Generate procedures for ${model.name}?`,
+        options: [
+            { value: 'generate', label: 'Yes, generate' },
+            { value: 'skip', label: 'Skip' },
+        ],
+    });
+    if (p.isCancel(action))
+        return null;
+    return action;
+}
+// ============================================================================
+// Step 3: Output Strategy
+// ============================================================================
+/**
+ * Prompt for output strategy (plain .output() vs resource schema).
+ */
+async function promptOutputStrategy(model) {
+    const hasSensitiveFields = model.fields.some((f) => f.isSensitive);
+    const defaultToResource = hasSensitiveFields || RESOURCE_DEFAULT_MODELS.has(model.name);
+    const outputStrategy = await p.select({
+        message: 'Output strategy?',
+        options: [
+            { value: 'output', label: '.output() \u2014 Same fields for all users' },
+            { value: 'resource', label: '.resource() \u2014 Different fields per access level' },
+        ],
+        initialValue: defaultToResource ? 'resource' : 'output',
+    });
+    if (p.isCancel(outputStrategy))
+        return null;
+    return outputStrategy;
+}
+/**
+ * Prompt for which CRUD operations to generate.
+ */
+async function promptCrudOperations(model) {
+    const allOps = ['get', 'list', 'create', 'update', 'delete'];
+    const crudOps = await p.multiselect({
+        message: 'CRUD operations:',
+        options: [
+            { value: 'get', label: 'get' },
+            { value: 'list', label: 'list' },
+            { value: 'create', label: 'create' },
+            { value: 'update', label: 'update' },
+            { value: 'delete', label: 'delete' },
+        ],
+        initialValues: model.isJoinTable ? ['create', 'delete'] : allOps,
+        required: true,
+    });
+    if (p.isCancel(crudOps))
+        return null;
+    const selected = new Set(crudOps);
+    return {
+        get: selected.has('get'),
+        list: selected.has('list'),
+        create: selected.has('create'),
+        update: selected.has('update'),
+        delete: selected.has('delete'),
+    };
+}
+// ============================================================================
+// Step 5: Schema Relations
+// ============================================================================
+/**
+ * Prompt for which relations to include in the Zod schema.
+ */
+async function promptSchemaRelations(model) {
+    const schemaRelations = await p.multiselect({
+        message: 'Include relations in Zod schema?',
+        options: model.relations.map((r) => ({
+            value: r.name,
+            label: `${r.name} (→${r.relatedModel}${r.kind === 'hasMany' ? '[]' : ''})`,
+        })),
+        initialValues: model.relations.filter((r) => r.kind === 'belongsTo').map((r) => r.name),
+        required: false,
+    });
+    if (p.isCancel(schemaRelations))
+        return null;
+    return schemaRelations;
+}
+// ============================================================================
+// Step 6: Include Relations
+// ============================================================================
+/**
+ * Prompt for which of the selected schema relations to also fetch via Prisma includes.
+ */
+async function promptIncludeRelations(schemaRelations) {
+    const includeRelations = await p.multiselect({
+        message: 'Fetch relations in queries? (Prisma includes)',
+        options: schemaRelations.map((name) => ({
+            value: name,
+            label: name,
+        })),
+        initialValues: [...schemaRelations],
+        required: false,
+    });
+    if (p.isCancel(includeRelations))
+        return null;
+    return includeRelations;
+}
+/**
+ * Prompt for field visibility configuration (resource strategy only).
+ * Returns a map of field name -> visibility level for ALL non-auto fields.
+ */
+async function promptFieldVisibility(model) {
+    const nonAutoFields = model.fields.filter((f) => !f.isAutoManaged);
+    const fieldsToRestrict = await p.multiselect({
+        message: 'Any fields to restrict from public access?',
+        options: nonAutoFields.map((f) => ({
+            value: f.name,
+            label: f.name,
+            hint: f.isSensitive ? 'sensitive' : undefined,
+        })),
+        initialValues: nonAutoFields.filter((f) => f.isSensitive).map((f) => f.name),
+        required: false,
+    });
+    if (p.isCancel(fieldsToRestrict))
+        return null;
+    const restrictedSet = new Set(fieldsToRestrict);
+    // For each restricted field, ask for visibility level
+    const restrictedLevels = new Map();
+    for (const fieldName of fieldsToRestrict) {
+        const level = await p.select({
+            message: `Visibility for "${fieldName}"?`,
+            options: [
+                { value: 'authenticated', label: 'authenticated \u2014 Logged-in users' },
+                { value: 'admin', label: 'admin \u2014 Admin only' },
+            ],
+        });
+        if (p.isCancel(level))
+            return null;
+        restrictedLevels.set(fieldName, level);
+    }
+    // Build full visibility map: restricted fields get their level, others get 'public'
+    const visibility = new Map();
+    for (const field of nonAutoFields) {
+        if (restrictedSet.has(field.name)) {
+            const level = restrictedLevels.get(field.name);
+            if (level !== undefined) {
+                visibility.set(field.name, level);
+            }
+        }
+        else {
+            visibility.set(field.name, 'public');
+        }
+    }
+    return visibility;
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Build a ModelChoices object for a skipped model.
+ */
+function buildSkipChoices(modelName) {
+    return {
+        model: modelName,
+        action: 'skip',
+        outputStrategy: 'output',
+        crud: {
+            get: false,
+            list: false,
+            create: false,
+            update: false,
+            delete: false,
+        },
+        schemaRelations: [],
+        includeRelations: [],
+        fieldVisibility: undefined,
+    };
+}

package/dist/sync/schema-generator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sync Schema Generator
+ *
+ * Generates complete TypeScript source for Zod schema files from a
+ * `SchemaFilePlan`. Supports two output strategies:
+ *
+ * - `output`: Plain `z.object()` schemas with optional `WithRelationsSchema`
+ * - `resource`: `resourceSchema()` builder with visibility tiers
+ *
+ * Both strategies generate Create, Update, and List input schemas.
+ */
+import type { SchemaFilePlan } from './types.js';
+/**
+ * Generate a complete TypeScript source string for a Zod schema file.
+ *
+ * The output is a syntactically valid TypeScript module containing:
+ * - Imports (zod, optionally resourceSchema from @veloxts/router)
+ * - Base/resource schema for all non-sensitive fields
+ * - WithRelationsSchema (output strategy only, when relations exist)
+ * - CreateSchema (excludes auto-managed, sensitive, and user FK fields)
+ * - UpdateSchema (same fields as Create, all optional)
+ * - ListSchema (page + perPage with defaults)
+ */
+export declare function generateSchemaFile(plan: SchemaFilePlan): string;

package/dist/sync/schema-generator.js

@@ -0,0 +1,213 @@
+/**
+ * Sync Schema Generator
+ *
+ * Generates complete TypeScript source for Zod schema files from a
+ * `SchemaFilePlan`. Supports two output strategies:
+ *
+ * - `output`: Plain `z.object()` schemas with optional `WithRelationsSchema`
+ * - `resource`: `resourceSchema()` builder with visibility tiers
+ *
+ * Both strategies generate Create, Update, and List input schemas.
+ */
+import { deriveEntityNames } from '../generators/utils/naming.js';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Generate a complete TypeScript source string for a Zod schema file.
+ *
+ * The output is a syntactically valid TypeScript module containing:
+ * - Imports (zod, optionally resourceSchema from @veloxts/router)
+ * - Base/resource schema for all non-sensitive fields
+ * - WithRelationsSchema (output strategy only, when relations exist)
+ * - CreateSchema (excludes auto-managed, sensitive, and user FK fields)
+ * - UpdateSchema (same fields as Create, all optional)
+ * - ListSchema (page + perPage with defaults)
+ */
+export function generateSchemaFile(plan) {
+    const names = deriveEntityNames(plan.model.name);
+    const lines = [];
+    // ── Imports ──────────────────────────────────────────
+    lines.push(generateImports(plan));
+    lines.push('');
+    // ── Base / Resource Schema ──────────────────────────
+    if (plan.outputStrategy === 'resource') {
+        lines.push(generateResourceSchema(plan, names.pascal));
+    }
+    else {
+        lines.push(generateBaseSchema(plan, names.pascal));
+    }
+    // ── WithRelationsSchema (output strategy only) ──────
+    if (plan.outputStrategy === 'output' && plan.relations.length > 0) {
+        lines.push('');
+        lines.push(generateWithRelationsSchema(plan.relations, names.pascal));
+    }
+    // ── Input Schemas ───────────────────────────────────
+    lines.push('');
+    lines.push(generateInputSchemas(plan, names.pascal, names.pascalPlural));
+    // Ensure trailing newline
+    return `${lines.join('\n')}\n`;
+}
+// ============================================================================
+// Import Generation
+// ============================================================================
+function generateImports(plan) {
+    const imports = ["import { z } from 'zod';"];
+    if (plan.outputStrategy === 'resource') {
+        imports.push("import { resourceSchema } from '@veloxts/router';");
+    }
+    return imports.join('\n');
+}
+// ============================================================================
+// Base Schema (output strategy)
+// ============================================================================
+function generateBaseSchema(plan, pascal) {
+    const nonSensitiveFields = plan.allFields.filter((f) => !f.isSensitive);
+    const fieldEntries = nonSensitiveFields.map((f) => `  ${f.name}: ${fieldToZod(f)},`);
+    const lines = [];
+    lines.push(`// ${SECTION_CHAR} Base Schema ${SECTION_PAD}`);
+    lines.push(`export const ${pascal}Schema = z.object({`);
+    lines.push(...fieldEntries);
+    lines.push('});');
+    return lines.join('\n');
+}
+// ============================================================================
+// Resource Schema (resource strategy)
+// ============================================================================
+function generateResourceSchema(plan, pascal) {
+    const nonSensitiveFields = plan.allFields.filter((f) => !f.isSensitive);
+    const lines = [];
+    lines.push(`// ${SECTION_CHAR} Resource Schema ${SECTION_PAD}`);
+    lines.push(`export const ${pascal}Schema = resourceSchema()`);
+    for (const field of nonSensitiveFields) {
+        const level = getVisibilityLevel(field.name, plan.fieldVisibility);
+        lines.push(`  .${level}('${field.name}', ${fieldToZod(field)})`);
+    }
+    lines.push('  .build();');
+    return lines.join('\n');
+}
+// ============================================================================
+// WithRelationsSchema
+// ============================================================================
+function generateWithRelationsSchema(relations, pascal) {
+    const relEntries = relations.map((r) => {
+        if (r.kind === 'hasMany') {
+            return `  ${r.name}: z.array(z.object({ id: z.string() })),`;
+        }
+        return `  ${r.name}: z.object({ id: z.string() }),`;
+    });
+    const lines = [];
+    lines.push(`// ${SECTION_CHAR} With Relations Schema ${SECTION_PAD}`);
+    lines.push(`export const ${pascal}WithRelationsSchema = ${pascal}Schema.extend({`);
+    lines.push(...relEntries);
+    lines.push('});');
+    return lines.join('\n');
+}
+// ============================================================================
+// Input Schemas (Create, Update, List)
+// ============================================================================
+function generateInputSchemas(plan, pascal, pascalPlural) {
+    const inputFields = plan.fields.filter((f) => !f.isUserForeignKey);
+    const lines = [];
+    lines.push(`// ${SECTION_CHAR} Input Schemas ${SECTION_PAD}`);
+    // ── CreateSchema ──
+    const createEntries = inputFields.map((f) => `  ${f.name}: ${fieldToCreateZod(f)},`);
+    lines.push(`export const Create${pascal}Schema = z.object({`);
+    lines.push(...createEntries);
+    lines.push('});');
+    lines.push('');
+    // ── UpdateSchema ──
+    const updateEntries = inputFields.map((f) => `  ${f.name}: ${fieldToUpdateZod(f)},`);
+    lines.push(`export const Update${pascal}Schema = z.object({`);
+    lines.push(...updateEntries);
+    lines.push('});');
+    lines.push('');
+    // ── ListSchema ──
+    lines.push(`export const List${pascalPlural}Schema = z.object({`);
+    lines.push('  page: z.number().int().positive().optional().default(1),');
+    lines.push('  perPage: z.number().int().min(1).max(100).optional().default(20),');
+    lines.push('});');
+    return lines.join('\n');
+}
+// ============================================================================
+// Prisma-to-Zod Type Mapping
+// ============================================================================
+/** Map a field to its base Zod schema string (for output/resource schemas). */
+function fieldToZod(field) {
+    let zod = prismaTypeToZod(field);
+    if (field.isOptional) {
+        zod += '.nullable()';
+    }
+    return zod;
+}
+/** Map a field to its Create input Zod schema string. */
+function fieldToCreateZod(field) {
+    let zod = prismaTypeToZod(field);
+    if (!field.isOptional && field.type === 'String' && !field.isId && !isEmailField(field)) {
+        zod += '.min(1)';
+    }
+    if (field.isOptional) {
+        zod += '.nullable().optional()';
+    }
+    return zod;
+}
+/** Map a field to its Update input Zod schema string. */
+function fieldToUpdateZod(field) {
+    let zod = prismaTypeToZod(field);
+    if (!field.isOptional && field.type === 'String' && !field.isId && !isEmailField(field)) {
+        zod += '.min(1)';
+    }
+    if (field.isOptional) {
+        zod += '.nullable().optional()';
+    }
+    else {
+        zod += '.optional()';
+    }
+    return zod;
+}
+/** Convert a Prisma type to the base Zod schema call. */
+function prismaTypeToZod(field) {
+    switch (field.type) {
+        case 'String': {
+            if (field.isId && field.defaultValue === 'uuid()') {
+                return 'z.string().uuid()';
+            }
+            if (isEmailField(field)) {
+                return 'z.string().email()';
+            }
+            return 'z.string()';
+        }
+        case 'Int':
+            return 'z.number().int()';
+        case 'Float':
+        case 'Decimal':
+        case 'BigInt':
+            return 'z.number()';
+        case 'Boolean':
+            return 'z.boolean()';
+        case 'DateTime':
+            return 'z.date()';
+        case 'Json':
+            return 'z.record(z.string(), z.unknown())';
+        default:
+            return 'z.string()';
+    }
+}
+/** Check if a field should use `.email()` validation. */
+function isEmailField(field) {
+    return field.name.toLowerCase().includes('email') && field.isUnique;
+}
+// ============================================================================
+// Visibility Helpers
+// ============================================================================
+function getVisibilityLevel(fieldName, visibility) {
+    if (!visibility) {
+        return 'public';
+    }
+    return visibility.get(fieldName) ?? 'public';
+}
+// ============================================================================
+// Section Comment Constants
+// ============================================================================
+const SECTION_CHAR = '\u2500\u2500';
+const SECTION_PAD = '\u2500'.repeat(40);