@vurb/core 3.12.7 → 3.12.8

package/dist/cli/templates/core.js

@@ -1,113 +1,113 @@
 /** Generate `src/vurb.ts` — The one-file context center */
 export function vurbTs() {
-    return `/**
- * Vurb Instance — Context Initialization
- *
- * Define your context type ONCE. Every f.query(), f.mutation(),
- * f.presenter(), f.prompt(), and f.middleware() call inherits
- * AppContext — zero generic repetition anywhere in the codebase.
- */
-import { initVurb } from '@vurb/core';
-import type { AppContext } from './context.js';
-
-export const f = initVurb<AppContext>();
+    return `/**
+ * Vurb Instance — Context Initialization
+ *
+ * Define your context type ONCE. Every f.query(), f.mutation(),
+ * f.presenter(), f.prompt(), and f.middleware() call inherits
+ * AppContext — zero generic repetition anywhere in the codebase.
+ */
+import { initVurb } from '@vurb/core';
+import type { AppContext } from './context.js';
+
+export const f = initVurb<AppContext>();
 `;
 }
 /** Generate `src/context.ts` — Application context type + factory */
 export function contextTs() {
-    return `/**
- * Application Context — Shared State for Every Tool Handler
- *
- * Every f.query() / f.mutation() handler receives (input, ctx)
- * where ctx is this AppContext. Extend it with your own services
- * (DB client, auth, external APIs, etc.)
- */
-
-export interface AppContext {
-    /** Current user role for RBAC checks */
-    role: 'ADMIN' | 'USER' | 'GUEST';
-
-    /** Tenant identifier (multi-tenancy) */
-    tenantId: string;
-}
-
-/**
- * Create the application context for each tool invocation.
- *
- * In production, hydrate this from the MCP session metadata,
- * JWT tokens, or environment variables.
- */
-export function createContext(): AppContext {
-    return {
-        role: 'ADMIN',
-        tenantId: 'default',
-    };
-}
+    return `/**
+ * Application Context — Shared State for Every Tool Handler
+ *
+ * Every f.query() / f.mutation() handler receives (input, ctx)
+ * where ctx is this AppContext. Extend it with your own services
+ * (DB client, auth, external APIs, etc.)
+ */
+
+export interface AppContext {
+    /** Current user role for RBAC checks */
+    role: 'ADMIN' | 'USER' | 'GUEST';
+
+    /** Tenant identifier (multi-tenancy) */
+    tenantId: string;
+}
+
+/**
+ * Create the application context for each tool invocation.
+ *
+ * In production, hydrate this from the MCP session metadata,
+ * JWT tokens, or environment variables.
+ */
+export function createContext(): AppContext {
+    return {
+        role: 'ADMIN',
+        tenantId: 'default',
+    };
+}
 `;
 }
 /** Generate `src/server.ts` — Bootstrap with autoDiscover + transport */
 export function serverTs(config) {
     if (config.transport === 'stdio') {
         // Simplified: one-liner bootstrap via startServer()
-        return `/**
- * Server Bootstrap — Vurb
- *
- * Tools are auto-discovered from src/tools/.
- * Drop a file, it becomes a tool.
- */
-import { fileURLToPath } from 'node:url';
-import { autoDiscover, PromptRegistry, startServer } from '@vurb/core';
-import { createContext } from './context.js';
-import { f } from './vurb.js';
-import { GreetPrompt } from './prompts/greet.js';
-
-// ── Registry ─────────────────────────────────────────────
-const registry = f.registry();
-const prompts = new PromptRegistry();
-
-// ── Auto-Discover & Register ─────────────────────────────
-await autoDiscover(registry, fileURLToPath(new URL('./tools', import.meta.url)));
-prompts.register(GreetPrompt);
-
-// ── Start ────────────────────────────────────────────────
-await startServer({
-    name: '${config.name}',
-    registry,
-    prompts,
-    contextFactory: () => createContext(),
-});
+        return `/**
+ * Server Bootstrap — Vurb
+ *
+ * Tools are auto-discovered from src/tools/.
+ * Drop a file, it becomes a tool.
+ */
+import { fileURLToPath } from 'node:url';
+import { autoDiscover, PromptRegistry, startServer } from '@vurb/core';
+import { createContext } from './context.js';
+import { f } from './vurb.js';
+import { GreetPrompt } from './prompts/greet.js';
+
+// ── Registry ─────────────────────────────────────────────
+const registry = f.registry();
+const prompts = new PromptRegistry();
+
+// ── Auto-Discover & Register ─────────────────────────────
+await autoDiscover(registry, fileURLToPath(new URL('./tools', import.meta.url)));
+prompts.register(GreetPrompt);
+
+// ── Start ────────────────────────────────────────────────
+await startServer({
+    name: '${config.name}',
+    registry,
+    prompts,
+    contextFactory: () => createContext(),
+});
 `;
     }
     // Streamable HTTP transport — startServer handles all HTTP plumbing
-    return `/**
- * Server Bootstrap — Vurb with Streamable HTTP Transport
- *
- * Tools are auto-discovered from src/tools/.
- * Drop a file, it becomes a tool.
- */
-import { fileURLToPath } from 'node:url';
-import { autoDiscover, PromptRegistry, startServer } from '@vurb/core';
-import { createContext } from './context.js';
-import { f } from './vurb.js';
-import { GreetPrompt } from './prompts/greet.js';
-
-// ── Registry ─────────────────────────────────────────────
-const registry = f.registry();
-const prompts = new PromptRegistry();
-
-// ── Auto-Discover & Register ─────────────────────────────
-await autoDiscover(registry, fileURLToPath(new URL('./tools', import.meta.url)));
-prompts.register(GreetPrompt);
-
-// ── Start ────────────────────────────────────────────────
-await startServer({
-    name: '${config.name}',
-    registry,
-    prompts,
-    contextFactory: () => createContext(),
-    transport: 'http',
-    port: Number(process.env['PORT'] ?? 3001),
-});
+    return `/**
+ * Server Bootstrap — Vurb with Streamable HTTP Transport
+ *
+ * Tools are auto-discovered from src/tools/.
+ * Drop a file, it becomes a tool.
+ */
+import { fileURLToPath } from 'node:url';
+import { autoDiscover, PromptRegistry, startServer } from '@vurb/core';
+import { createContext } from './context.js';
+import { f } from './vurb.js';
+import { GreetPrompt } from './prompts/greet.js';
+
+// ── Registry ─────────────────────────────────────────────
+const registry = f.registry();
+const prompts = new PromptRegistry();
+
+// ── Auto-Discover & Register ─────────────────────────────
+await autoDiscover(registry, fileURLToPath(new URL('./tools', import.meta.url)));
+prompts.register(GreetPrompt);
+
+// ── Start ────────────────────────────────────────────────
+await startServer({
+    name: '${config.name}',
+    registry,
+    prompts,
+    contextFactory: () => createContext(),
+    transport: 'http',
+    port: Number(process.env['PORT'] ?? 3001),
+});
 `;
 }
 //# sourceMappingURL=core.js.map

package/dist/cli/templates/middleware.js

@@ -4,31 +4,31 @@
  */
 /** Generate `src/middleware/auth.ts` — RBAC middleware */
 export function authMiddlewareTs() {
-    return `/**
- * Auth Middleware — RBAC Guard (Fluent API)
- *
- * Demonstrates f.middleware() — tRPC-style context derivation.
- * Rejects GUEST requests with a structured error.
- *
- * Usage in tools:
- *   f.query('users.list')
- *     .use(withAuth)
- *     .handle(async (input, ctx) => {
- *       // ctx now has ctx.role guaranteed non-GUEST
- *     });
- *
- * In production, replace with JWT validation,
- * API key checks, or OAuth token verification.
- */
-import { f } from '../vurb.js';
-import { error } from '@vurb/core';
-
-export const withAuth = f.middleware(async (ctx) => {
-    if (ctx.role === 'GUEST') {
-        throw error('Access denied. Authentication required.');
-    }
-    return { verified: true as const };
-});
+    return `/**
+ * Auth Middleware — RBAC Guard (Fluent API)
+ *
+ * Demonstrates f.middleware() — tRPC-style context derivation.
+ * Rejects GUEST requests with a structured error.
+ *
+ * Usage in tools:
+ *   f.query('users.list')
+ *     .use(withAuth)
+ *     .handle(async (input, ctx) => {
+ *       // ctx now has ctx.role guaranteed non-GUEST
+ *     });
+ *
+ * In production, replace with JWT validation,
+ * API key checks, or OAuth token verification.
+ */
+import { f } from '../vurb.js';
+import { error } from '@vurb/core';
+
+export const withAuth = f.middleware(async (ctx) => {
+    if (ctx.role === 'GUEST') {
+        throw error('Access denied. Authentication required.');
+    }
+    return { verified: true as const };
+});
 `;
 }
 //# sourceMappingURL=middleware.js.map

package/dist/cli/templates/model.js

@@ -4,28 +4,28 @@
  */
 /** Generate `src/models/SystemModel.ts` */
 export function systemModelTs() {
-    return `/**
- * System Model — MVA Domain Layer (defineModel)
- *
- * Defines the shape of system health data using defineModel().
- * The Model provides:
- * - Field types with m.string(), m.number(), etc.
- * - .describe() annotations that become JIT system rules
- * - Validation and casting for the domain entity
- *
- * The Presenter references this Model instead of raw z.object(),
- * keeping a single source of truth for the data shape.
- */
-import { defineModel } from '@vurb/core';
-
-export const SystemModel = defineModel('SystemHealth', m => {
-    m.casts({
-        status:    m.string('Server operational status'),
-        uptime:    m.number('Uptime in seconds since process start'),
-        version:   m.string('Server version string'),
-        timestamp: m.string('ISO 8601 timestamp of this check'),
-    });
-});
+    return `/**
+ * System Model — MVA Domain Layer (defineModel)
+ *
+ * Defines the shape of system health data using defineModel().
+ * The Model provides:
+ * - Field types with m.string(), m.number(), etc.
+ * - .describe() annotations that become JIT system rules
+ * - Validation and casting for the domain entity
+ *
+ * The Presenter references this Model instead of raw z.object(),
+ * keeping a single source of truth for the data shape.
+ */
+import { defineModel } from '@vurb/core';
+
+export const SystemModel = defineModel('SystemHealth', m => {
+    m.casts({
+        status:    m.string('Server operational status'),
+        uptime:    m.number('Uptime in seconds since process start'),
+        version:   m.string('Server version string'),
+        timestamp: m.string('ISO 8601 timestamp of this check'),
+    });
+});
 `;
 }
 //# sourceMappingURL=model.js.map

package/dist/cli/templates/readme.js

@@ -11,162 +11,162 @@ export function readme(config) {
     const sseNote = config.transport === 'sse'
         ? `\n> **Note:** Streamable HTTP transport requires the server to be running first. Run \\\`npm start\\\` before connecting.`
         : '';
-    return `# ${config.name}
-
-MCP Server built with [Vurb.ts](https://vurb.vinkius.com/) — the TypeScript framework for MCP servers.
-
-## Quick Start
-
-\`\`\`bash
-npm install
-vurb dev
-\`\`\`
-${config.testing ? `
-## Testing
-
-\`\`\`bash
-npm test
-\`\`\`
-` : ''}
-## Project Structure
-
-\`\`\`
-src/
-├── vurb.ts          # initVurb<AppContext>() — context center
-├── context.ts         # AppContext type + factory
-├── server.ts          # Bootstrap with autoDiscover
-├── tools/             # Drop a file → it's a tool (autoDiscover)
-│   └── system/
-│       ├── health.ts  # Health check with Presenter
-│       └── echo.ts    # Echo for connectivity testing
-├── models/            # MVA Model Layer (defineModel)
-│   └── SystemModel.ts
-├── presenters/        # MVA View Layer (Egress Firewall)
-│   └── SystemPresenter.ts
-├── prompts/           # MCP Prompt Engine
-│   └── greet.ts
-└── middleware/        # RBAC guards
-    └── auth.ts
-\`\`\`
-
-## Client Configuration
-
-### Cursor Editor
-
-> **Already configured!** The \`.cursor/mcp.json\` file was generated automatically.
-> Just open this folder in Cursor and the server connects instantly.
-${sseNote}
-
-### Claude Desktop
-
-Add to your \`claude_desktop_config.json\`:
-
-\`\`\`json
-${clientConfig}
-\`\`\`
-${vectorReadmeSection(config)}
-## Adding New Tools
-
-Create a new file in \`src/tools/\`. It's automatically discovered:
-
-\`\`\`typescript
-// src/tools/my-domain/my-tool.ts
-import { f } from '../../vurb.js';
-
-export default f.query('my_domain.my_tool')
-    .describe('What this tool does')
-    .withString('query', 'Search query')
-    .handle(async (input, ctx) => {
-        return { result: input.query };
-    });
-\`\`\`
-
-No registration needed. The \`autoDiscover()\` system picks it up automatically.
-
-## Documentation
-
-- [Vurb Docs](https://vurb.vinkius.com/)
-- [Presenter — Egress Firewall](https://vurb.vinkius.com/presenter)
-- [DX Guide — initVurb()](https://vurb.vinkius.com/dx-guide)
-- [Testing](https://vurb.vinkius.com/testing)
+    return `# ${config.name}
+
+MCP Server built with [Vurb.ts](https://vurb.vinkius.com/) — the TypeScript framework for MCP servers.
+
+## Quick Start
+
+\`\`\`bash
+npm install
+vurb dev
+\`\`\`
+${config.testing ? `
+## Testing
+
+\`\`\`bash
+npm test
+\`\`\`
+` : ''}
+## Project Structure
+
+\`\`\`
+src/
+├── vurb.ts          # initVurb<AppContext>() — context center
+├── context.ts         # AppContext type + factory
+├── server.ts          # Bootstrap with autoDiscover
+├── tools/             # Drop a file → it's a tool (autoDiscover)
+│   └── system/
+│       ├── health.ts  # Health check with Presenter
+│       └── echo.ts    # Echo for connectivity testing
+├── models/            # MVA Model Layer (defineModel)
+│   └── SystemModel.ts
+├── presenters/        # MVA View Layer (Egress Firewall)
+│   └── SystemPresenter.ts
+├── prompts/           # MCP Prompt Engine
+│   └── greet.ts
+└── middleware/        # RBAC guards
+    └── auth.ts
+\`\`\`
+
+## Client Configuration
+
+### Cursor Editor
+
+> **Already configured!** The \`.cursor/mcp.json\` file was generated automatically.
+> Just open this folder in Cursor and the server connects instantly.
+${sseNote}
+
+### Claude Desktop
+
+Add to your \`claude_desktop_config.json\`:
+
+\`\`\`json
+${clientConfig}
+\`\`\`
+${vectorReadmeSection(config)}
+## Adding New Tools
+
+Create a new file in \`src/tools/\`. It's automatically discovered:
+
+\`\`\`typescript
+// src/tools/my-domain/my-tool.ts
+import { f } from '../../vurb.js';
+
+export default f.query('my_domain.my_tool')
+    .describe('What this tool does')
+    .withString('query', 'Search query')
+    .handle(async (input, ctx) => {
+        return { result: input.query };
+    });
+\`\`\`
+
+No registration needed. The \`autoDiscover()\` system picks it up automatically.
+
+## Documentation
+
+- [Vurb Docs](https://vurb.vinkius.com/)
+- [Presenter — Egress Firewall](https://vurb.vinkius.com/presenter)
+- [DX Guide — initVurb()](https://vurb.vinkius.com/dx-guide)
+- [Testing](https://vurb.vinkius.com/testing)
 `;
 }
 /** Vector-specific README section */
 function vectorReadmeSection(config) {
     switch (config.vector) {
         case 'prisma':
-            return `
-## Database Setup (Prisma)
-
-1. Configure your database URL in \`.env\`:
-   \`\`\`
-   DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
-   \`\`\`
-
-2. Edit \`prisma/schema.prisma\` to define your models
-
-3. Generate the Prisma client and Vurb tools:
-   \`\`\`bash
-   npm run db:generate
-   \`\`\`
-
-4. Push the schema to your database:
-   \`\`\`bash
-   npm run db:push
-   \`\`\`
-
-Use \`/// @vurb.hide\` on sensitive fields to strip them from the Egress Firewall.
+            return `
+## Database Setup (Prisma)
+
+1. Configure your database URL in \`.env\`:
+   \`\`\`
+   DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
+   \`\`\`
+
+2. Edit \`prisma/schema.prisma\` to define your models
+
+3. Generate the Prisma client and Vurb tools:
+   \`\`\`bash
+   npm run db:generate
+   \`\`\`
+
+4. Push the schema to your database:
+   \`\`\`bash
+   npm run db:push
+   \`\`\`
+
+Use \`/// @vurb.hide\` on sensitive fields to strip them from the Egress Firewall.
 `;
         case 'n8n':
-            return `
-## n8n Workflow Setup
-
-1. Configure your n8n instance in \`.env\`:
-   \`\`\`
-   N8N_BASE_URL=http://localhost:5678
-   N8N_API_KEY=your-api-key
-   \`\`\`
-
-2. The connector in \`src/n8n.ts\` auto-discovers webhook workflows
-   and registers them as MCP tools.
+            return `
+## n8n Workflow Setup
+
+1. Configure your n8n instance in \`.env\`:
+   \`\`\`
+   N8N_BASE_URL=http://localhost:5678
+   N8N_API_KEY=your-api-key
+   \`\`\`
+
+2. The connector in \`src/n8n.ts\` auto-discovers webhook workflows
+   and registers them as MCP tools.
 `;
         case 'openapi':
-            return `
-## OpenAPI Generator Setup
-
-1. Replace \`openapi.yaml\` with your actual OpenAPI 3.x spec
-
-2. Generate the MCP server from the spec:
-   \`\`\`bash
-   npx @vurb/openapi-gen ./openapi.yaml --outDir ./src/generated
-   \`\`\`
-
-3. Import and register the generated tools in \`src/server.ts\`
+            return `
+## OpenAPI Generator Setup
+
+1. Replace \`openapi.yaml\` with your actual OpenAPI 3.x spec
+
+2. Generate the MCP server from the spec:
+   \`\`\`bash
+   npx @vurb/openapi-gen ./openapi.yaml --outDir ./src/generated
+   \`\`\`
+
+3. Import and register the generated tools in \`src/server.ts\`
 `;
         case 'oauth':
-            return `
-## OAuth Device Flow Setup
-
-1. Configure your OAuth provider in \`.env\`:
-   \`\`\`
-   OAUTH_CLIENT_ID=your-client-id
-   OAUTH_AUTH_ENDPOINT=https://api.example.com/oauth/device/code
-   OAUTH_TOKEN_ENDPOINT=https://api.example.com/oauth/device/token
-   \`\`\`
-
-2. The auth tool in \`src/auth.ts\` is pre-configured with login, complete, status, and logout actions.
-
-3. Protect any tool with the \`withAuth\` middleware from \`src/middleware/auth.ts\`:
-   \`\`\`ts
-   import { withAuth } from '../middleware/auth.js';
-
-   export default f.query('protected.action')
-       .describe('A protected query')
-       .use(withAuth)
-       .handle(async (input, ctx) => {
-           // ctx is authenticated
-       });
-   \`\`\`
+            return `
+## OAuth Device Flow Setup
+
+1. Configure your OAuth provider in \`.env\`:
+   \`\`\`
+   OAUTH_CLIENT_ID=your-client-id
+   OAUTH_AUTH_ENDPOINT=https://api.example.com/oauth/device/code
+   OAUTH_TOKEN_ENDPOINT=https://api.example.com/oauth/device/token
+   \`\`\`
+
+2. The auth tool in \`src/auth.ts\` is pre-configured with login, complete, status, and logout actions.
+
+3. Protect any tool with the \`withAuth\` middleware from \`src/middleware/auth.ts\`:
+   \`\`\`ts
+   import { withAuth } from '../middleware/auth.js';
+
+   export default f.query('protected.action')
+       .describe('A protected query')
+       .use(withAuth)
+       .handle(async (input, ctx) => {
+           // ctx is authenticated
+       });
+   \`\`\`
 `;
         default:
             return '';