@vinkius-core/mcp-fusion 2.13.1 → 2.14.1

package/dist/cli/fusion.js

@@ -107,41 +107,41 @@ export class ProgressTracker {
 /** @internal exported for testing */
 export const MCP_FUSION_VERSION = '1.1.0';
 /** @internal exported for testing */
-export const HELP = `
-fusion — MCP Fusion CLI
-
-USAGE
-  fusion create <name>                Scaffold a new MCP Fusion server
-  fusion dev --server <entry>         Start HMR dev server with auto-reload
-  fusion lock                         Generate or update ${LOCKFILE_NAME}
-  fusion lock --check                 Verify lockfile is up to date (CI gate)
-
-CREATE OPTIONS
-  --transport <stdio|sse>  Transport layer (default: stdio)
-  --vector <type>          Ingestion vector: vanilla, prisma, n8n, openapi, oauth
-  --testing                Include test suite (default: true)
-  --no-testing             Skip test suite
-  --yes, -y                Skip prompts, use defaults
-
-DEV OPTIONS
-  --server, -s <path>      Path to server entrypoint (default: auto-detect)
-  --dir, -d <path>         Directory to watch for changes (default: auto-detect from server)
-
-LOCK OPTIONS
-  --server, -s <path>      Path to server entrypoint
-  --name, -n <name>        Server name for lockfile header
-  --cwd <dir>              Project root directory
-
-GLOBAL
-  --help, -h               Show this help message
-
-EXAMPLES
-  fusion create my-server
-  fusion create my-server -y
-  fusion create my-server --vector prisma --transport sse
-  fusion dev --server ./src/server.ts
-  fusion dev --server ./src/server.ts --dir ./src/tools
-  fusion lock --server ./src/server.ts
+export const HELP = `
+fusion — MCP Fusion CLI
+
+USAGE
+  fusion create <name>                Scaffold a new MCP Fusion server
+  fusion dev --server <entry>         Start HMR dev server with auto-reload
+  fusion lock                         Generate or update ${LOCKFILE_NAME}
+  fusion lock --check                 Verify lockfile is up to date (CI gate)
+
+CREATE OPTIONS
+  --transport <stdio|sse>  Transport layer (default: stdio)
+  --vector <type>          Ingestion vector: vanilla, prisma, n8n, openapi, oauth
+  --testing                Include test suite (default: true)
+  --no-testing             Skip test suite
+  --yes, -y                Skip prompts, use defaults
+
+DEV OPTIONS
+  --server, -s <path>      Path to server entrypoint (default: auto-detect)
+  --dir, -d <path>         Directory to watch for changes (default: auto-detect from server)
+
+LOCK OPTIONS
+  --server, -s <path>      Path to server entrypoint
+  --name, -n <name>        Server name for lockfile header
+  --cwd <dir>              Project root directory
+
+GLOBAL
+  --help, -h               Show this help message
+
+EXAMPLES
+  fusion create my-server
+  fusion create my-server -y
+  fusion create my-server --vector prisma --transport sse
+  fusion dev --server ./src/server.ts
+  fusion dev --server ./src/server.ts --dir ./src/tools
+  fusion lock --server ./src/server.ts
 `.trim();
 /** @internal exported for testing */
 export function parseArgs(argv) {

package/dist/cli/templates/config.js

@@ -85,47 +85,47 @@ export function tsconfig() {
 }
 /** Generate `.gitignore` */
 export function gitignore() {
-    return `node_modules/
-dist/
-*.tsbuildinfo
-.env
-.env.local
-coverage/
+    return `node_modules/
+dist/
+*.tsbuildinfo
+.env
+.env.local
+coverage/
 `;
 }
 /** Generate `.env.example` with vector-specific vars */
 export function envExample(config) {
-    let env = `# ── MCP Fusion Server Environment ─────────────────────
-# Copy this to .env and fill in your values.
-
-# Server
-NODE_ENV=development
+    let env = `# ── MCP Fusion Server Environment ─────────────────────
+# Copy this to .env and fill in your values.
+
+# Server
+NODE_ENV=development
 `;
     if (config.vector === 'prisma') {
-        env += `
-# Database (Prisma)
-DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
+        env += `
+# Database (Prisma)
+DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
 `;
     }
     if (config.vector === 'n8n') {
-        env += `
-# n8n Workflow Automation
-N8N_BASE_URL=http://localhost:5678
-N8N_API_KEY=your-api-key-here
+        env += `
+# n8n Workflow Automation
+N8N_BASE_URL=http://localhost:5678
+N8N_API_KEY=your-api-key-here
 `;
     }
     if (config.vector === 'oauth') {
-        env += `
-# OAuth Device Flow (RFC 8628)
-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
+        env += `
+# OAuth Device Flow (RFC 8628)
+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
 `;
     }
     if (config.transport === 'sse') {
-        env += `
-# SSE Transport
-PORT=3001
+        env += `
+# SSE Transport
+PORT=3001
 `;
     }
     return env;

package/dist/cli/templates/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,6DAA6D;AAC7D,wBAAgB,QAAQ,IAAI,MAAM,CAajC;AAED,qEAAqE;AACrE,wBAAgB,SAAS,IAAI,MAAM,CA8BlC;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkFtD"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,6DAA6D;AAC7D,wBAAgB,QAAQ,IAAI,MAAM,CAajC;AAED,qEAAqE;AACrE,wBAAgB,SAAS,IAAI,MAAM,CA8BlC;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA+EtD"}

package/dist/cli/templates/core.js

@@ -1,130 +1,127 @@
 /** Generate `src/fusion.ts` — The one-file context center */
 export function fusionTs() {
-    return `/**
- * Fusion 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 { initFusion } from '@vinkius-core/mcp-fusion';
-import type { AppContext } from './context.js';
-
-export const f = initFusion<AppContext>();
+    return `/**
+ * Fusion 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 { initFusion } from '@vinkius-core/mcp-fusion';
+import type { AppContext } from './context.js';
+
+export const f = initFusion<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) {
     const transportImport = config.transport === 'stdio'
         ? `import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';`
-        : `import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+        : `import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import { createServer } from 'node:http';`;
     const transportSetup = config.transport === 'stdio'
-        ? `
-// ── Transport ────────────────────────────────────────────
-const transport = new StdioServerTransport();
-await server.connect(transport);
+        ? `
+// ── Transport ────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
 console.error('⚡ MCP Fusion server running on stdio');`
-        : `
-// ── Transport ────────────────────────────────────────────
-const PORT = Number(process.env['PORT'] ?? 3001);
-const transports = new Map<string, SSEServerTransport>();
-
-const httpServer = createServer(async (req, res) => {
-    if (req.method === 'GET' && req.url === '/sse') {
-        const sseTransport = new SSEServerTransport('/mcp/messages', res);
-        transports.set(sseTransport.sessionId, sseTransport);
-        res.on('close', () => transports.delete(sseTransport.sessionId));
-        await server.connect(sseTransport);
-    } else if (req.method === 'POST' && req.url?.startsWith('/mcp/messages')) {
-        const url = new URL(req.url, \`http://localhost:\${PORT}\`);
-        const sessionId = url.searchParams.get('sessionId') ?? '';
-        const transport = transports.get(sessionId);
-        if (transport) {
-            await transport.handlePostMessage(req, res);
-        } else {
-            res.writeHead(400).end('Unknown session');
-        }
-    } else {
-        res.writeHead(404).end();
-    }
-});
-
-httpServer.listen(PORT, () => {
-    console.error(\`⚡ MCP Fusion SSE server on http://localhost:\${PORT}/sse\`);
+        : `
+// ── Transport ────────────────────────────────────────────
+const PORT = Number(process.env['PORT'] ?? 3001);
+const transports = new Map<string, SSEServerTransport>();
+
+const httpServer = createServer(async (req, res) => {
+    if (req.method === 'GET' && req.url === '/sse') {
+        const sseTransport = new SSEServerTransport('/mcp/messages', res);
+        transports.set(sseTransport.sessionId, sseTransport);
+        res.on('close', () => transports.delete(sseTransport.sessionId));
+        await server.connect(sseTransport);
+    } else if (req.method === 'POST' && req.url?.startsWith('/mcp/messages')) {
+        const url = new URL(req.url, \`http://localhost:\${PORT}\`);
+        const sessionId = url.searchParams.get('sessionId') ?? '';
+        const transport = transports.get(sessionId);
+        if (transport) {
+            await transport.handlePostMessage(req, res);
+        } else {
+            res.writeHead(400).end('Unknown session');
+        }
+    } else {
+        res.writeHead(404).end();
+    }
+});
+
+httpServer.listen(PORT, () => {
+    console.error(\`⚡ MCP Fusion SSE server on http://localhost:\${PORT}/sse\`);
 });`;
-    return `/**
- * Server Bootstrap — MCP Fusion with autoDiscover
- *
- * Tools are auto-discovered from src/tools/ — drop a file,
- * it becomes a tool. No manual imports or registration needed.
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-${transportImport}
-import { ToolRegistry, autoDiscover, PromptRegistry } from '@vinkius-core/mcp-fusion';
-import type { AppContext } from './context.js';
-import { createContext } from './context.js';
-import { f } from './fusion.js';
-import { GreetPrompt } from './prompts/greet.js';
-
-// ── Registries ───────────────────────────────────────────
-const registry = f.registry();
-const prompts = new PromptRegistry<AppContext>();
-
-// ── Auto-Discover Tools ──────────────────────────────────
-const discovered = await autoDiscover(registry, new URL('./tools', import.meta.url).pathname);
-console.error(\`📦 Discovered \${discovered.length} tool file(s)\`);
-
-// ── Register Prompts ─────────────────────────────────────
-prompts.register(GreetPrompt);
-console.error(\`💬 Registered \${prompts.size} prompt(s)\`);
-
-// ── Server ───────────────────────────────────────────────
-const server = new Server(
-    { name: '${config.name}', version: '0.1.0' },
-    { capabilities: { tools: {}, prompts: {} } },
-);
-
-registry.attachToServer(server, {
-    contextFactory: () => createContext(),
-});
-
-prompts.attachToServer(server, {
-    contextFactory: () => createContext(),
-});
-${transportSetup}
+    return `/**
+ * Server Bootstrap — MCP Fusion with autoDiscover
+ *
+ * Tools are auto-discovered from src/tools/ — drop a file,
+ * it becomes a tool. No manual imports or registration needed.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+${transportImport}
+import { ToolRegistry, autoDiscover, PromptRegistry } from '@vinkius-core/mcp-fusion';
+import type { AppContext } from './context.js';
+import { createContext } from './context.js';
+import { f } from './fusion.js';
+import { GreetPrompt } from './prompts/greet.js';
+
+// ── Registries ───────────────────────────────────────────
+const registry = f.registry();
+const prompts = new PromptRegistry<AppContext>();
+
+// ── Auto-Discover Tools ──────────────────────────────────
+const discovered = await autoDiscover(registry, new URL('./tools', import.meta.url).pathname);
+console.error(\`📦 Discovered \${discovered.length} tool file(s)\`);
+
+// ── Register Prompts ─────────────────────────────────────
+prompts.register(GreetPrompt);
+console.error(\`💬 Registered \${prompts.size} prompt(s)\`);
+
+// ── Server ───────────────────────────────────────────────
+const server = new Server(
+    { name: '${config.name}', version: '0.1.0' },
+    { capabilities: { tools: {}, prompts: {} } },
+);
+
+registry.attachToServer(server, {
+    contextFactory: () => createContext(),
+    prompts,
+});
+${transportSetup}
 `;
 }
 //# sourceMappingURL=core.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/cli/templates/core.ts"],"names":[],"mappings":"AAQA,6DAA6D;AAC7D,MAAM,UAAU,QAAQ;IACpB,OAAO;;;;;;;;;;;CAWV,CAAC;AACF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS;IACrB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BV,CAAC;AACF,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,MAAqB;IAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO;QAChD,CAAC,CAAC,mFAAmF;QACrF,CAAC,CAAC;0CACgC,CAAC;IAEvC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO;QAC/C,CAAC,CAAC;;;;uDAI6C;QAC/C,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BN,CAAC;IAED,OAAO;;;;;;;EAOT,eAAe;;;;;;;;;;;;;;;;;;;;;eAqBF,MAAM,CAAC,IAAI;;;;;;;;;;;EAWxB,cAAc;CACf,CAAC;AACF,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/cli/templates/core.ts"],"names":[],"mappings":"AAQA,6DAA6D;AAC7D,MAAM,UAAU,QAAQ;IACpB,OAAO;;;;;;;;;;;CAWV,CAAC;AACF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS;IACrB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BV,CAAC;AACF,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,MAAqB;IAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO;QAChD,CAAC,CAAC,mFAAmF;QACrF,CAAC,CAAC;0CACgC,CAAC;IAEvC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO;QAC/C,CAAC,CAAC;;;;uDAI6C;QAC/C,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BN,CAAC;IAED,OAAO;;;;;;;EAOT,eAAe;;;;;;;;;;;;;;;;;;;;;eAqBF,MAAM,CAAC,IAAI;;;;;;;;EAQxB,cAAc;CACf,CAAC;AACF,CAAC"}

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 '../fusion.js';
-import { error } from '@vinkius-core/mcp-fusion';
-
-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 '../fusion.js';
+import { error } from '@vinkius-core/mcp-fusion';
+
+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