@vurb/core 3.2.0 → 3.2.2

package/dist/cli/templates/core.js

@@ -1,186 +1,186 @@
 /** 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';
-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';
-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 — manual setup required (startServer is stdio-only)
-    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 { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { createServer } from 'node:http';
-import { autoDiscover, PromptRegistry } from 'vurb';
-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);
-
-// ── Server ───────────────────────────────────────────────
-const server = new McpServer(
-    { name: '${config.name}', version: '0.1.0' },
-);
-
-registry.attachToServer(server, {
-    contextFactory: () => createContext(),
-    prompts,
-});
-
-// ── Transport ────────────────────────────────────────────
-const PORT = Number(process.env['PORT'] ?? 3001);
-const sessions = new Map<string, StreamableHTTPServerTransport>();
-
-const httpServer = createServer(async (req, res) => {
-    try {
-        const url = new URL(req.url ?? '/', \`http://localhost:\${PORT}\`);
-
-        if (url.pathname !== '/mcp') {
-            res.writeHead(404).end();
-            return;
-        }
-
-        if (req.method === 'POST') {
-            // Parse JSON body
-            const chunks: Buffer[] = [];
-            for await (const chunk of req) chunks.push(chunk as Buffer);
-            const body = JSON.parse(Buffer.concat(chunks).toString());
-
-            const sessionId = req.headers['mcp-session-id'] as string | undefined;
-
-            // Existing session — route to its transport
-            if (sessionId && sessions.has(sessionId)) {
-                const transport = sessions.get(sessionId)!;
-                await transport.handleRequest(req, res, body);
-                return;
-            }
-
-            // New session — create transport
-            const transport = new StreamableHTTPServerTransport({
-                sessionIdGenerator: () => crypto.randomUUID(),
-                onsessioninitialized: (id) => {
-                    sessions.set(id, transport);
-                },
-            });
-            transport.onclose = () => {
-                const id = [...sessions.entries()].find(([, t]) => t === transport)?.[0];
-                if (id) sessions.delete(id);
-            };
-            await server.connect(transport);
-            await transport.handleRequest(req, res, body);
-        } else if (req.method === 'GET') {
-            const sessionId = req.headers['mcp-session-id'] as string | undefined;
-            if (sessionId && sessions.has(sessionId)) {
-                const transport = sessions.get(sessionId)!;
-                await transport.handleRequest(req, res);
-            } else {
-                res.writeHead(400).end('Missing or invalid session');
-            }
-        } else if (req.method === 'DELETE') {
-            const sessionId = req.headers['mcp-session-id'] as string | undefined;
-            if (sessionId && sessions.has(sessionId)) {
-                const transport = sessions.get(sessionId)!;
-                await transport.handleRequest(req, res);
-            } else {
-                res.writeHead(400).end('Missing or invalid session');
-            }
-        } else {
-            res.writeHead(405).end();
-        }
-    } catch (err) {
-        console.error('[Vurb] Unhandled error in HTTP handler:', err);
-        if (!res.headersSent) res.writeHead(500).end();
-    }
-});
-
-httpServer.listen(PORT, () => {
-    console.error(\`⚡ Vurb server on http://localhost:\${PORT}/mcp\`);
-});
+    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 { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from 'node:http';
+import { autoDiscover, PromptRegistry } 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);
+
+// ── Server ───────────────────────────────────────────────
+const server = new McpServer(
+    { name: '${config.name}', version: '0.1.0' },
+);
+
+registry.attachToServer(server, {
+    contextFactory: () => createContext(),
+    prompts,
+});
+
+// ── Transport ────────────────────────────────────────────
+const PORT = Number(process.env['PORT'] ?? 3001);
+const sessions = new Map<string, StreamableHTTPServerTransport>();
+
+const httpServer = createServer(async (req, res) => {
+    try {
+        const url = new URL(req.url ?? '/', \`http://localhost:\${PORT}\`);
+
+        if (url.pathname !== '/mcp') {
+            res.writeHead(404).end();
+            return;
+        }
+
+        if (req.method === 'POST') {
+            // Parse JSON body
+            const chunks: Buffer[] = [];
+            for await (const chunk of req) chunks.push(chunk as Buffer);
+            const body = JSON.parse(Buffer.concat(chunks).toString());
+
+            const sessionId = req.headers['mcp-session-id'] as string | undefined;
+
+            // Existing session — route to its transport
+            if (sessionId && sessions.has(sessionId)) {
+                const transport = sessions.get(sessionId)!;
+                await transport.handleRequest(req, res, body);
+                return;
+            }
+
+            // New session — create transport
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => crypto.randomUUID(),
+                onsessioninitialized: (id) => {
+                    sessions.set(id, transport);
+                },
+            });
+            transport.onclose = () => {
+                const id = [...sessions.entries()].find(([, t]) => t === transport)?.[0];
+                if (id) sessions.delete(id);
+            };
+            await server.connect(transport);
+            await transport.handleRequest(req, res, body);
+        } else if (req.method === 'GET') {
+            const sessionId = req.headers['mcp-session-id'] as string | undefined;
+            if (sessionId && sessions.has(sessionId)) {
+                const transport = sessions.get(sessionId)!;
+                await transport.handleRequest(req, res);
+            } else {
+                res.writeHead(400).end('Missing or invalid session');
+            }
+        } else if (req.method === 'DELETE') {
+            const sessionId = req.headers['mcp-session-id'] as string | undefined;
+            if (sessionId && sessions.has(sessionId)) {
+                const transport = sessions.get(sessionId)!;
+                await transport.handleRequest(req, res);
+            } else {
+                res.writeHead(400).end('Missing or invalid session');
+            }
+        } else {
+            res.writeHead(405).end();
+        }
+    } catch (err) {
+        console.error('[Vurb] Unhandled error in HTTP handler:', err);
+        if (!res.headersSent) res.writeHead(500).end();
+    }
+});
+
+httpServer.listen(PORT, () => {
+    console.error(\`⚡ Vurb server on http://localhost:\${PORT}/mcp\`);
+});
 `;
 }
 //# 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';
-
-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/presenter.js

@@ -19,7 +19,7 @@ export function systemPresenterTs() {
         ' * - ui.markdown() server-rendered UI blocks',
         ' * - suggestActions() for HATEOAS-style affordances',
         ' */',
-        "import { definePresenter, ui } from 'vurb';",
+        "import { definePresenter, ui } from '@vurb/core';",
         "import { z } from 'zod';",
         '',
         'export const SystemPresenter = definePresenter({',

package/dist/cli/templates/presenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../../src/cli/templates/presenter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,UAAU,iBAAiB;IAC7B,OAAO;QACH,KAAK;QACL,wDAAwD;QACxD,IAAI;QACJ,wDAAwD;QACxD,0DAA0D;QAC1D,sDAAsD;QACtD,kCAAkC;QAClC,IAAI;QACJ,2BAA2B;QAC3B,wCAAwC;QACxC,4EAA4E;QAC5E,8CAA8C;QAC9C,qDAAqD;QACrD,KAAK;QACL,6CAA6C;QAC7C,0BAA0B;QAC1B,EAAE;QACF,kDAAkD;QAClD,2BAA2B;QAC3B,wBAAwB;QACxB,mEAAmE;QACnE,+EAA+E;QAC/E,gEAAgE;QAChE,6EAA6E;QAC7E,SAAS;QACT,gFAAgF;QAChF,qBAAqB;QACrB,sBAAsB;QACtB,uGAAuG;QACvG,YAAY;QACZ,QAAQ;QACR,yDAAyD;QACzD,kFAAkF;QAClF,eAAe;QACf,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../../src/cli/templates/presenter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,UAAU,iBAAiB;IAC7B,OAAO;QACH,KAAK;QACL,wDAAwD;QACxD,IAAI;QACJ,wDAAwD;QACxD,0DAA0D;QAC1D,sDAAsD;QACtD,kCAAkC;QAClC,IAAI;QACJ,2BAA2B;QAC3B,wCAAwC;QACxC,4EAA4E;QAC5E,8CAA8C;QAC9C,qDAAqD;QACrD,KAAK;QACL,mDAAmD;QACnD,0BAA0B;QAC1B,EAAE;QACF,kDAAkD;QAClD,2BAA2B;QAC3B,wBAAwB;QACxB,mEAAmE;QACnE,+EAA+E;QAC/E,gEAAgE;QAChE,6EAA6E;QAC7E,SAAS;QACT,gFAAgF;QAChF,qBAAqB;QACrB,sBAAsB;QACtB,uGAAuG;QACvG,YAAY;QACZ,QAAQ;QACR,yDAAyD;QACzD,kFAAkF;QAClF,eAAe;QACf,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/templates/prompt.js

@@ -15,7 +15,7 @@ export function greetPromptTs() {
         ' * - MCP prompts/list + prompts/get',
         ' */',
         "import { f } from '../vurb.js';",
-        "import { PromptMessage } from 'vurb';",
+        "import { PromptMessage } from '@vurb/core';",
         '',
         "export const GreetPrompt = f.prompt('greet', {",
         "    description: 'Generate a personalized greeting for a user',",

package/dist/cli/templates/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/cli/templates/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,UAAU,aAAa;IACzB,OAAO;QACH,KAAK;QACL,yCAAyC;QACzC,IAAI;QACJ,kBAAkB;QAClB,+CAA+C;QAC/C,gDAAgD;QAChD,oDAAoD;QACpD,qCAAqC;QACrC,KAAK;QACL,iCAAiC;QACjC,uCAAuC;QACvC,EAAE;QACF,gDAAgD;QAChD,iEAAiE;QACjE,aAAa;QACb,+EAA+E;QAC/E,kBAAkB;QAClB,4DAA4D;QAC5D,4CAA4C;QAC5C,YAAY;QACZ,iBAAiB;QACjB,kDAAkD;QAClD,qBAAqB;QACrB,mCAAmC;QACnC,wFAAwF;QACxF,iDAAiD;QACjD,gBAAgB;QAChB,0DAA0D;QAC1D,YAAY;QACZ,SAAS;QACT,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/cli/templates/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,UAAU,aAAa;IACzB,OAAO;QACH,KAAK;QACL,yCAAyC;QACzC,IAAI;QACJ,kBAAkB;QAClB,+CAA+C;QAC/C,gDAAgD;QAChD,oDAAoD;QACpD,qCAAqC;QACrC,KAAK;QACL,iCAAiC;QACjC,6CAA6C;QAC7C,EAAE;QACF,gDAAgD;QAChD,iEAAiE;QACjE,aAAa;QACb,+EAA+E;QAC/E,kBAAkB;QAClB,4DAA4D;QAC5D,4CAA4C;QAC5C,YAAY;QACZ,iBAAiB;QACjB,kDAAkD;QAClD,qBAAqB;QACrB,mCAAmC;QACnC,wFAAwF;QACxF,iDAAiD;QACjD,gBAAgB;QAChB,0DAA0D;QAC1D,YAAY;QACZ,SAAS;QACT,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}