@veloxts/mcp 0.6.73 → 0.6.75

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @veloxts/mcp
 
+## 0.6.75
+
+### Patch Changes
+
+- feat(create): add --pm flag to skip package manager prompt
+- Updated dependencies
+  - @veloxts/cli@0.6.75
+  - @veloxts/router@0.6.75
+  - @veloxts/validation@0.6.75
+
+## 0.6.74
+
+### Patch Changes
+
+- docs: fix erroneous file paths and improve auth context documentation
+- Updated dependencies
+  - @veloxts/cli@0.6.74
+  - @veloxts/router@0.6.74
+  - @veloxts/validation@0.6.74
+
 ## 0.6.73
 
 ### Patch Changes

package/dist/server.js

@@ -96,6 +96,12 @@ export function createVeloxMCPServer(options = {}) {
                     description: 'VeloxTS project information and structure',
                     mimeType: 'text/plain',
                 },
+                {
+                    uri: 'velox://auth-context',
+                    name: 'Authentication Context Guide',
+                    description: 'How ctx.user is populated by userLoader and how to extend it',
+                    mimeType: 'text/plain',
+                },
             ],
         };
     });
@@ -181,6 +187,106 @@ export function createVeloxMCPServer(options = {}) {
                     ],
                 };
             }
+            case 'velox://auth-context': {
+                const text = `# Authentication Context (ctx.user)
+
+## Overview
+
+\`ctx.user\` is populated by the \`userLoader\` function, NOT directly from the database.
+Only fields you explicitly return from \`userLoader\` will be available on \`ctx.user\`.
+
+## How ctx.user Gets Populated
+
+1. JWT token is validated from cookie/header
+2. User ID is extracted from token payload
+3. Your \`userLoader(userId)\` function is called
+4. The returned object becomes \`ctx.user\`
+
+## Default userLoader Returns
+
+The scaffolded templates return:
+\`\`\`typescript
+{
+  id: string;
+  email: string;
+  name: string;
+  roles: string[];
+}
+\`\`\`
+
+## Where to Find userLoader
+
+- **API template (\`--auth\`)**: \`src/config/auth.ts\`
+- **RSC template (\`--rsc-auth\`)**: \`src/api/handler.ts\` (inline in \`createAuthConfig()\`)
+
+## Adding Fields to ctx.user
+
+### Step 1: Update userLoader
+
+\`\`\`typescript
+// In your userLoader function:
+async function userLoader(userId: string) {
+  const user = await db.user.findUnique({ where: { id: userId } });
+  if (!user) return null;
+
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    roles: parseUserRoles(user.roles),
+    organizationId: user.organizationId, // Add new field here
+  };
+}
+\`\`\`
+
+### Step 2: Extend TypeScript Type (Optional)
+
+\`\`\`typescript
+declare module '@veloxts/auth' {
+  interface User {
+    organizationId: string;
+  }
+}
+\`\`\`
+
+## Alternative: Fetch Full User
+
+If you only occasionally need extra fields, use the \`getFullUser\` helper:
+
+\`\`\`typescript
+import { getFullUser } from '@/utils/auth';
+
+// In a procedure:
+.query(async ({ ctx }) => {
+  const fullUser = await getFullUser(ctx);
+  return { organizationId: fullUser.organizationId };
+})
+\`\`\`
+
+## Common Mistake
+
+\`\`\`typescript
+// ❌ WRONG - undefined if not returned by userLoader
+const orgId = ctx.user.organizationId;
+
+// ✅ CORRECT - After adding to userLoader
+const orgId = ctx.user.organizationId;
+
+// ✅ ALTERNATIVE - Fetch full user when needed
+const fullUser = await getFullUser(ctx);
+const orgId = fullUser.organizationId;
+\`\`\`
+`;
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'text/plain',
+                            text,
+                        },
+                    ],
+                };
+            }
             default:
                 throw new Error(`Unknown resource: ${uri}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/mcp",
-  "version": "0.6.73",
+  "version": "0.6.75",
   "description": "Model Context Protocol server for VeloxTS - expose project context to AI tools",
   "type": "module",
   "main": "dist/index.js",
@@ -24,9 +24,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.25.1",
     "typescript": "5.9.3",
-    "@veloxts/cli": "0.6.73",
-    "@veloxts/validation": "0.6.73",
-    "@veloxts/router": "0.6.73"
+    "@veloxts/cli": "0.6.75",
+    "@veloxts/router": "0.6.75",
+    "@veloxts/validation": "0.6.75"
   },
   "peerDependencies": {
     "zod": ">=3.25.0"