@veloxts/mcp 0.6.23

package/dist/prompts/templates.js

@@ -0,0 +1,442 @@
+/**
+ * Prompt Templates
+ *
+ * Reusable prompt templates for common VeloxTS tasks.
+ */
+// ============================================================================
+// Templates
+// ============================================================================
+/**
+ * Create procedure template
+ */
+export const CREATE_PROCEDURE = {
+    name: 'create-procedure',
+    description: 'Guide for creating a new VeloxTS procedure',
+    arguments: [
+        { name: 'entity', description: 'Entity name (e.g., User, Post)', required: true },
+        {
+            name: 'operations',
+            description: 'Operations to include (get, list, create, update, delete)',
+        },
+    ],
+    content: `# Creating a VeloxTS Procedure
+
+## Steps
+
+1. **Define the Zod schema** in \`src/schemas/{entity}.ts\`:
+   \`\`\`typescript
+   import { z } from '@veloxts/velox';
+
+   export const {Entity}Schema = z.object({
+     id: z.string().uuid(),
+     // Add your fields here
+     createdAt: z.date(),
+     updatedAt: z.date(),
+   });
+
+   export type {Entity} = z.infer<typeof {Entity}Schema>;
+
+   export const Create{Entity}Schema = {Entity}Schema.omit({
+     id: true,
+     createdAt: true,
+     updatedAt: true,
+   });
+
+   export type Create{Entity} = z.infer<typeof Create{Entity}Schema>;
+   \`\`\`
+
+2. **Create the procedure** in \`src/procedures/{entities}.ts\`:
+   \`\`\`typescript
+   import { defineProcedures, procedure, z } from '@veloxts/velox';
+   import { {Entity}Schema, Create{Entity}Schema } from '../schemas/{entity}.js';
+
+   export const {entity}Procedures = defineProcedures('{entities}', {
+     get{Entity}: procedure()
+       .input(z.object({ id: z.string().uuid() }))
+       .output({Entity}Schema)
+       .query(async ({ input, ctx }) => {
+         return ctx.db.{entity}.findUnique({ where: { id: input.id } });
+       }),
+
+     list{Entities}: procedure()
+       .output(z.array({Entity}Schema))
+       .query(async ({ ctx }) => {
+         return ctx.db.{entity}.findMany();
+       }),
+
+     create{Entity}: procedure()
+       .input(Create{Entity}Schema)
+       .output({Entity}Schema)
+       .mutation(async ({ input, ctx }) => {
+         return ctx.db.{entity}.create({ data: input });
+       }),
+   });
+   \`\`\`
+
+3. **Register in index** at \`src/procedures/index.ts\`:
+   \`\`\`typescript
+   export { {entity}Procedures } from './{entities}.js';
+   \`\`\`
+
+## Naming Conventions
+
+| Procedure Name | HTTP Method | Route |
+|----------------|-------------|-------|
+| get{Entity} | GET | /{entities}/:id |
+| list{Entities} | GET | /{entities} |
+| create{Entity} | POST | /{entities} |
+| update{Entity} | PUT | /{entities}/:id |
+| delete{Entity} | DELETE | /{entities}/:id |
+`,
+};
+/**
+ * Add validation template
+ */
+export const ADD_VALIDATION = {
+    name: 'add-validation',
+    description: 'Guide for adding Zod validation to procedures',
+    content: `# Adding Validation with Zod
+
+## Common Validation Patterns
+
+### String Validation
+\`\`\`typescript
+z.string()
+  .min(1, 'Required')
+  .max(255, 'Too long')
+  .email('Invalid email')
+  .url('Invalid URL')
+  .uuid('Invalid UUID')
+  .regex(/pattern/, 'Invalid format')
+\`\`\`
+
+### Number Validation
+\`\`\`typescript
+z.number()
+  .int('Must be integer')
+  .positive('Must be positive')
+  .min(0, 'Must be >= 0')
+  .max(100, 'Must be <= 100')
+\`\`\`
+
+### Object Validation
+\`\`\`typescript
+z.object({
+  required: z.string(),
+  optional: z.string().optional(),
+  nullable: z.string().nullable(),
+  defaulted: z.string().default('value'),
+})
+\`\`\`
+
+### Array Validation
+\`\`\`typescript
+z.array(z.string())
+  .min(1, 'At least one item')
+  .max(10, 'Too many items')
+  .nonempty('Cannot be empty')
+\`\`\`
+
+### Enum Validation
+\`\`\`typescript
+z.enum(['active', 'inactive', 'pending'])
+z.nativeEnum(StatusEnum)
+\`\`\`
+
+### Union & Intersection
+\`\`\`typescript
+// Union: one of multiple types
+z.union([z.string(), z.number()])
+
+// Discriminated union
+z.discriminatedUnion('type', [
+  z.object({ type: z.literal('a'), value: z.string() }),
+  z.object({ type: z.literal('b'), count: z.number() }),
+])
+\`\`\`
+
+### Transform & Refine
+\`\`\`typescript
+// Transform input
+z.string().transform(s => s.toLowerCase())
+
+// Custom validation
+z.string().refine(
+  (val) => isValidSlug(val),
+  { message: 'Invalid slug format' }
+)
+\`\`\`
+
+## Best Practices
+
+1. **Reuse schemas** - Create base schemas and derive others
+2. **Use .omit()/.pick()** - Create partial schemas from complete ones
+3. **Add error messages** - Always provide clear validation messages
+4. **Export types** - Use \`z.infer<typeof Schema>\` for type exports
+`,
+};
+/**
+ * Setup authentication template
+ */
+export const SETUP_AUTH = {
+    name: 'setup-auth',
+    description: 'Guide for setting up authentication in VeloxTS',
+    content: `# Setting Up Authentication
+
+## JWT Authentication
+
+### 1. Environment Variables
+\`\`\`bash
+# .env
+JWT_SECRET=<64+ character secret>
+JWT_REFRESH_SECRET=<64+ character secret>
+\`\`\`
+
+Generate secrets:
+\`\`\`bash
+openssl rand -base64 64
+\`\`\`
+
+### 2. Configure Auth Plugin
+\`\`\`typescript
+import { authPlugin, jwtManager } from '@veloxts/auth';
+
+const jwt = jwtManager({
+  secret: process.env.JWT_SECRET!,
+  refreshSecret: process.env.JWT_REFRESH_SECRET!,
+  accessTokenExpiry: '15m',
+  refreshTokenExpiry: '7d',
+});
+
+await app.register(authPlugin(jwt));
+\`\`\`
+
+### 3. Protect Procedures with Guards
+\`\`\`typescript
+import { authenticated, hasRole, hasPermission } from '@veloxts/auth';
+
+// Require authentication
+const getProfile = procedure()
+  .guard(authenticated)
+  .query(({ ctx }) => ctx.user);
+
+// Require specific role
+const adminDashboard = procedure()
+  .guard(hasRole('admin'))
+  .query(({ ctx }) => { /* ... */ });
+
+// Require permission
+const deletePost = procedure()
+  .guard(hasPermission('posts.delete'))
+  .mutation(({ ctx, input }) => { /* ... */ });
+\`\`\`
+
+### 4. Auth Endpoints
+\`\`\`typescript
+export const authProcedures = defineProcedures('auth', {
+  register: procedure()
+    .input(RegisterSchema)
+    .output(UserSchema)
+    .mutation(async ({ input, ctx }) => {
+      const hashedPassword = await hash(input.password);
+      return ctx.db.user.create({
+        data: { ...input, password: hashedPassword },
+      });
+    }),
+
+  login: procedure()
+    .input(LoginSchema)
+    .output(TokensSchema)
+    .mutation(async ({ input, ctx }) => {
+      const user = await ctx.db.user.findUnique({
+        where: { email: input.email },
+      });
+      if (!user || !await verify(input.password, user.password)) {
+        throw VeloxError.unauthorized('Invalid credentials');
+      }
+      return jwt.generateTokens(user);
+    }),
+});
+\`\`\`
+
+## Available Guards
+
+| Guard | Description |
+|-------|-------------|
+| \`authenticated\` | Requires logged-in user |
+| \`emailVerified\` | Requires verified email |
+| \`hasRole(role)\` | Checks user role |
+| \`hasPermission(perm)\` | Checks user permission |
+| \`allOf(guards)\` | All guards must pass |
+| \`anyOf(guards)\` | Any guard must pass |
+| \`not(guard)\` | Inverts guard result |
+`,
+};
+/**
+ * Error handling template
+ */
+export const ERROR_HANDLING = {
+    name: 'error-handling',
+    description: 'Guide for error handling in VeloxTS',
+    content: `# Error Handling in VeloxTS
+
+## Using VeloxError
+
+VeloxTS provides structured errors with codes, messages, and fix suggestions.
+
+### Factory Methods
+\`\`\`typescript
+import { VeloxError } from '@veloxts/core';
+
+// Not found (404)
+throw VeloxError.notFound('User', userId);
+
+// Validation error (400)
+throw VeloxError.validation('Invalid email format');
+
+// Unauthorized (401)
+throw VeloxError.unauthorized('Login required');
+
+// Forbidden (403)
+throw VeloxError.forbidden('Cannot access this resource');
+
+// Conflict (409)
+throw VeloxError.conflict('Email already registered');
+\`\`\`
+
+### Custom Errors
+\`\`\`typescript
+throw new VeloxError({
+  code: 'E1006',
+  message: 'Custom error message',
+  fix: 'Suggested fix for the user',
+  details: { additionalContext: 'value' },
+});
+\`\`\`
+
+## Error Code Categories
+
+| Range | Category |
+|-------|----------|
+| E1xxx | Core/Runtime |
+| E2xxx | Generator |
+| E3xxx | Seeding |
+| E4xxx | Migration |
+| E5xxx | Dev Server |
+| E6xxx | Validation |
+| E7xxx | Authentication |
+| E8xxx | Database |
+| E9xxx | Configuration |
+
+## Error Handling Patterns
+
+### In Procedures
+\`\`\`typescript
+const getUser = procedure()
+  .input(z.object({ id: z.string().uuid() }))
+  .query(async ({ ctx, input }) => {
+    const user = await ctx.db.user.findUnique({
+      where: { id: input.id },
+    });
+
+    if (!user) {
+      throw VeloxError.notFound('User', input.id);
+    }
+
+    return user;
+  });
+\`\`\`
+
+### Global Error Handler
+Fastify automatically catches errors and formats them based on the error type.
+
+### JSON Error Response
+\`\`\`json
+{
+  "success": false,
+  "error": {
+    "code": "E1001",
+    "message": "User not found",
+    "fix": "Check that the user ID is correct",
+    "docsUrl": "https://veloxts.dev/errors/E1001"
+  }
+}
+\`\`\`
+`,
+};
+// ============================================================================
+// Registry
+// ============================================================================
+/**
+ * All available prompt templates
+ */
+export const PROMPT_TEMPLATES = [
+    CREATE_PROCEDURE,
+    ADD_VALIDATION,
+    SETUP_AUTH,
+    ERROR_HANDLING,
+];
+/**
+ * Get a prompt template by name
+ */
+export function getPromptTemplate(name) {
+    return PROMPT_TEMPLATES.find((t) => t.name === name);
+}
+/**
+ * Render a prompt template with argument substitution
+ *
+ * Supports the following placeholder transformations:
+ * - {arg} - lowercase (e.g., "user")
+ * - {Arg} - PascalCase (e.g., "User")
+ * - {args} - lowercase plural (e.g., "users")
+ * - {Args} - PascalCase plural (e.g., "Users")
+ *
+ * @param name - Template name
+ * @param args - Argument values as key-value pairs
+ * @returns Rendered content or undefined if template not found
+ */
+export function renderPromptTemplate(name, args) {
+    const template = getPromptTemplate(name);
+    if (!template)
+        return undefined;
+    let content = template.content;
+    for (const [key, value] of Object.entries(args)) {
+        // Skip empty values
+        if (!value)
+            continue;
+        const lower = value.toLowerCase();
+        const pascal = value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();
+        // Simple pluralization (add 's' or 'es')
+        const pluralize = (s) => {
+            if (s.endsWith('s') ||
+                s.endsWith('x') ||
+                s.endsWith('z') ||
+                s.endsWith('ch') ||
+                s.endsWith('sh')) {
+                return `${s}es`;
+            }
+            return `${s}s`;
+        };
+        // Replace all variations of the placeholder
+        // {key} - lowercase
+        content = content.replace(new RegExp(`\\{${key}\\}`, 'g'), lower);
+        // {Key} - PascalCase
+        const pascalKey = key.charAt(0).toUpperCase() + key.slice(1);
+        content = content.replace(new RegExp(`\\{${pascalKey}\\}`, 'g'), pascal);
+        // {keys} - lowercase plural (when key ends without 's')
+        content = content.replace(new RegExp(`\\{${key}s\\}`, 'g'), pluralize(lower));
+        // {Keys} - PascalCase plural
+        content = content.replace(new RegExp(`\\{${pascalKey}s\\}`, 'g'), pluralize(pascal));
+    }
+    return content;
+}
+/**
+ * List all available prompts
+ */
+export function listPromptTemplates() {
+    return PROMPT_TEMPLATES.map((t) => ({
+        name: t.name,
+        description: t.description,
+    }));
+}
+//# sourceMappingURL=templates.js.map

package/dist/prompts/templates.js.map

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

package/dist/resources/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Errors Resource
+ *
+ * Exposes the VeloxTS error catalog to AI tools.
+ */
+/**
+ * Error information for MCP response
+ */
+export interface ErrorInfo {
+    code: string;
+    name: string;
+    message: string;
+    fix?: string;
+    docsUrl?: string;
+    category: string;
+}
+/**
+ * Errors resource response
+ */
+export interface ErrorsResourceResponse {
+    errors: ErrorInfo[];
+    categories: {
+        prefix: string;
+        name: string;
+        count: number;
+    }[];
+    totalCount: number;
+}
+/**
+ * Get all errors from the catalog
+ */
+export declare function getErrors(): ErrorsResourceResponse;
+/**
+ * Get errors for a specific category
+ */
+export declare function getErrorsByPrefix(prefix: string): ErrorInfo[];
+/**
+ * Search errors by keyword
+ */
+export declare function searchErrors(query: string): ErrorInfo[];
+/**
+ * Format errors response as text
+ */
+export declare function formatErrorsAsText(response: ErrorsResourceResponse): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/resources/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,UAAU,EAAE,MAAM,CAAC;CACpB;AA+BD;;GAEG;AACH,wBAAgB,SAAS,IAAI,sBAAsB,CAqBlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAU7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAmBvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CA6B3E"}

package/dist/resources/errors.js

@@ -0,0 +1,117 @@
+/**
+ * Errors Resource
+ *
+ * Exposes the VeloxTS error catalog to AI tools.
+ */
+import { ERROR_CATALOG, getErrorsByCategory } from '@veloxts/cli';
+// ============================================================================
+// Error Categories
+// ============================================================================
+const ERROR_CATEGORIES = [
+    { prefix: 'E1', name: 'Core/Runtime' },
+    { prefix: 'E2', name: 'Generator' },
+    { prefix: 'E3', name: 'Seeding' },
+    { prefix: 'E4', name: 'Migration' },
+    { prefix: 'E5', name: 'Dev Server' },
+    { prefix: 'E6', name: 'Validation' },
+    { prefix: 'E7', name: 'Authentication' },
+    { prefix: 'E8', name: 'Database' },
+    { prefix: 'E9', name: 'Configuration' },
+];
+// ============================================================================
+// Resource Handler
+// ============================================================================
+/**
+ * Get the category name for an error code
+ */
+function getErrorCategory(code) {
+    const prefix = code.substring(0, 2);
+    const category = ERROR_CATEGORIES.find((c) => c.prefix === prefix);
+    return category?.name ?? 'Unknown';
+}
+/**
+ * Get all errors from the catalog
+ */
+export function getErrors() {
+    const errors = Object.values(ERROR_CATALOG).map((def) => ({
+        code: def.code,
+        name: def.name,
+        message: def.message,
+        fix: def.fix,
+        docsUrl: def.docsUrl,
+        category: getErrorCategory(def.code),
+    }));
+    const categories = ERROR_CATEGORIES.map((cat) => ({
+        prefix: cat.prefix,
+        name: cat.name,
+        count: getErrorsByCategory(cat.prefix).length,
+    })).filter((cat) => cat.count > 0);
+    return {
+        errors,
+        categories,
+        totalCount: errors.length,
+    };
+}
+/**
+ * Get errors for a specific category
+ */
+export function getErrorsByPrefix(prefix) {
+    const defs = getErrorsByCategory(prefix);
+    return defs.map((def) => ({
+        code: def.code,
+        name: def.name,
+        message: def.message,
+        fix: def.fix,
+        docsUrl: def.docsUrl,
+        category: getErrorCategory(def.code),
+    }));
+}
+/**
+ * Search errors by keyword
+ */
+export function searchErrors(query) {
+    const lowerQuery = query.toLowerCase();
+    return Object.values(ERROR_CATALOG)
+        .filter((def) => def.code.toLowerCase().includes(lowerQuery) ||
+        def.name.toLowerCase().includes(lowerQuery) ||
+        def.message.toLowerCase().includes(lowerQuery) ||
+        def.fix?.toLowerCase().includes(lowerQuery))
+        .map((def) => ({
+        code: def.code,
+        name: def.name,
+        message: def.message,
+        fix: def.fix,
+        docsUrl: def.docsUrl,
+        category: getErrorCategory(def.code),
+    }));
+}
+/**
+ * Format errors response as text
+ */
+export function formatErrorsAsText(response) {
+    const lines = [
+        '# VeloxTS Error Catalog',
+        '',
+        `Total errors: ${response.totalCount}`,
+        '',
+        '## Categories',
+        '',
+    ];
+    for (const cat of response.categories) {
+        lines.push(`- ${cat.prefix}xxx: ${cat.name} (${cat.count} errors)`);
+    }
+    lines.push('', '## All Errors', '');
+    for (const error of response.errors) {
+        lines.push(`### ${error.code}: ${error.name}`);
+        lines.push(`**Message:** ${error.message}`);
+        if (error.fix) {
+            lines.push(`**Fix:** ${error.fix}`);
+        }
+        if (error.docsUrl) {
+            lines.push(`**Docs:** ${error.docsUrl}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=errors.js.map

package/dist/resources/errors.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Resources
+ *
+ * Resources expose read-only project context to AI tools.
+ */
+export type { ErrorInfo, ErrorsResourceResponse } from './errors.js';
+export { formatErrorsAsText, getErrors, getErrorsByPrefix, searchErrors, } from './errors.js';
+export type { ProcedureInfo, ProceduresResourceResponse } from './procedures.js';
+export { formatProceduresAsText, getProcedures, getProceduresByNamespace, getProceduresByType, } from './procedures.js';
+export type { RouteInfo, RoutesResourceResponse } from './routes.js';
+export { formatRoutesAsText, getRoutes, getRoutesByMethod, getRoutesByNamespace, } from './routes.js';
+export type { SchemaInfo, SchemasResourceResponse } from './schemas.js';
+export { formatSchemasAsText, getSchemas, searchSchemas, } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,10 @@
+/**
+ * MCP Resources
+ *
+ * Resources expose read-only project context to AI tools.
+ */
+export { formatErrorsAsText, getErrors, getErrorsByPrefix, searchErrors, } from './errors.js';
+export { formatProceduresAsText, getProcedures, getProceduresByNamespace, getProceduresByType, } from './procedures.js';
+export { formatRoutesAsText, getRoutes, getRoutesByMethod, getRoutesByNamespace, } from './routes.js';
+export { formatSchemasAsText, getSchemas, searchSchemas, } from './schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC"}