spiceflow 1.13.3 → 1.14.1

package/README.md

@@ -1,4 +1,4 @@
-# DO NOT EDIT: This file is auto-generated from root README.md
+<!-- DO NOT EDIT: This file is auto-generated from root README.md -->
 
 <div align='center' className='w-full'>
     <br/>
@@ -239,6 +239,68 @@ async function exampleUsage() {
 }
 ```
 
+
+### Path Matching - Supported Features
+
+- **Named parameters**: `:param` - Captures dynamic segments like `/users/:id` or `/api/:version/users/:userId`
+- **Wildcards**: `*` - Matches any remaining path segments like `/files/*` or `/proxy/*`
+
+### Path Matching - Unsupported Features
+
+- **Optional parameters**: `/:param?` - Use separate routes instead - IS NOT SUPPORTED
+- **Named wildcards**: `/files/*name` - Use unnamed `*` only - IS NOT SUPPORTED
+- **Partial parameters**: `/:param-suffix` or `/prefix-:param` - Use full segment parameters only - IS NOT SUPPORTED
+- **Regex patterns**: `/users/(\\d+)` - Use string parameters with validation in handlers - IS NOT SUPPORTED
+- **Multiple wildcards**: `/*/files/*` - Use single wildcard only - IS NOT SUPPORTED
+
+## Storing Spiceflow in Class Instances
+
+If you need to store a Spiceflow router as a property in a class instance, use the `AnySpiceflow` type:
+
+**Important**: Do not use `this` inside route handlers to reference the parent class. The `this` context inside handlers always refers to the Spiceflow instance, not your class instance. Instead, capture the parent class reference in a variable outside the handlers:
+
+```ts
+import { Spiceflow, AnySpiceflow } from 'spiceflow'
+
+export class ChatDurableObject {
+  private router: AnySpiceflow
+  private state: DurableObjectState
+
+  constructor(state: DurableObjectState, env: Env) {
+    this.state = state
+    const self = this // Capture parent class reference - IMPORTANT!
+
+    this.router = new Spiceflow()
+      .route({
+        method: 'GET',
+        path: '/messages',
+        async handler() {
+          // Use 'self' instead of 'this' to access parent class
+          // this.state would NOT work here - 'this' refers to Spiceflow instance
+          const messages = await self.state.storage.get('messages') || []
+          return { messages }
+        },
+      })
+      .route({
+        method: 'POST',
+        path: '/messages',
+        async handler({ request }) {
+          const { message } = await request.json()
+          // Use 'self' to access parent class properties
+          const messages = await self.state.storage.get('messages') || []
+          messages.push({ id: Date.now(), text: message })
+          await self.state.storage.put('messages', messages)
+          return { success: true }
+        },
+      })
+  }
+
+  fetch(request: Request) {
+    return this.router.handle(request)
+  }
+}
+```
+
 ## Safe Path Building
 
 The `safePath` method provides a type-safe way to build URLs with parameters. It helps prevent runtime errors by ensuring all required parameters are provided and properly substituted into the path.
@@ -269,7 +331,7 @@ const userPath = app.safePath('/users/:id', { id: '123' })
 // Building URLs with required parameters
 const userPostPath = app.safePath('/users/:id/posts/:postId', {
   id: '456',
-  postId: 'abc'
+  postId: 'abc',
 })
 // Result: '/users/456/posts/abc'
 ```
@@ -294,7 +356,7 @@ const app = new Spiceflow()
         provider,
         userId,
         authCode: code,
-        state
+        state,
       }
     },
   })
@@ -309,13 +371,14 @@ const app = new Spiceflow()
       const callbackUrl = new URL(
         app.safePath('/auth/callback/:provider/:userId', {
           provider,
-          userId
+          userId,
         }),
-        'https://myapp.com'
+        'https://myapp.com',
       ).toString()
 
       // Redirect to OAuth provider with callback URL
-      const oauthUrl = `https://accounts.google.com/oauth/authorize?` +
+      const oauthUrl =
+        `https://accounts.google.com/oauth/authorize?` +
         `client_id=your-client-id&` +
         `redirect_uri=${encodeURIComponent(callbackUrl)}&` +
         `response_type=code&` +
@@ -327,6 +390,7 @@ const app = new Spiceflow()
 ```
 
 In this example:
+
 - The callback URL is built safely using `safePath` with type checking
 - Required parameters like `provider` and `userId` must be provided
 - The resulting URL is guaranteed to be properly formatted
@@ -942,7 +1006,7 @@ interface Env {
 }
 
 const app = new Spiceflow()
-  .state('env', null as Env | null)
+  .state('env', {} as Env)
   .route({
     method: 'GET',
     path: '/kv/:key',
@@ -964,7 +1028,7 @@ const app = new Spiceflow()
 export default {
   fetch(request: Request, env: Env, ctx: ExecutionContext) {
     // Pass the env bindings to the app
-    return app.handle(request, { env })
+    return app.handle(request, { state: { env } })
   },
 }
 ```
@@ -993,71 +1057,207 @@ const response = await sdk.getUsers()
 console.log('Users:', response)
 ```
 
-## Background tasks with waitUntil
+## Working with Cookies
 
-Spiceflow provides a `waitUntil` function in the handler context that allows you to schedule tasks in the background in a cross platform way. It will use the Cloudflare workers waitUntil if present. It's currently a no op in Node.js.
-
-### Basic Usage
+Spiceflow works with standard Request and Response objects, so you can use any cookie library like the `cookie` npm package to handle cookies:
 
 ```ts
 import { Spiceflow } from 'spiceflow'
+import { parse, serialize } from 'cookie'
 
 const app = new Spiceflow()
+  .route({
+    method: 'GET',
+    path: '/set-cookie',
+    handler({ request }) {
+      // Read existing cookies from the request
+      const cookies = parse(request.headers.get('Cookie') || '')
+
+      // Create response with a new cookie
+      const response = new Response(
+        JSON.stringify({
+          message: 'Cookie set!',
+          existingCookies: cookies,
+        }),
+        {
+          headers: {
+            'Content-Type': 'application/json',
+          },
+        },
+      )
+
+      // Set a new cookie
+      response.headers.set(
+        'Set-Cookie',
+        serialize('session', 'abc123', {
+          httpOnly: true,
+          secure: true,
+          sameSite: 'strict',
+          maxAge: 60 * 60 * 24 * 7, // 7 days
+          path: '/',
+        }),
+      )
+
+      return response
+    },
+  })
+  .route({
+    method: 'GET',
+    path: '/get-cookie',
+    handler({ request }) {
+      // Parse cookies from the request
+      const cookies = parse(request.headers.get('Cookie') || '')
+
+      return {
+        sessionId: cookies.session || null,
+        allCookies: cookies,
+      }
+    },
+  })
   .route({
     method: 'POST',
-    path: '/process',
-    async handler({ request, waitUntil }) {
-      const data = await request.json()
-
-      // Schedule background task
-      waitUntil(
-        fetch('https://analytics.example.com/track', {
-          method: 'POST',
-          body: JSON.stringify({ event: 'data_processed', data }),
-        })
+    path: '/clear-cookie',
+    handler({ request }) {
+      const response = new Response(
+        JSON.stringify({ message: 'Cookie cleared!' }),
+        {
+          headers: {
+            'Content-Type': 'application/json',
+          },
+        },
       )
 
-      // Return response immediately
-      return { success: true, id: Math.random().toString(36) }
+      // Clear a cookie by setting it with an expired date
+      response.headers.set(
+        'Set-Cookie',
+        serialize('session', '', {
+          httpOnly: true,
+          secure: true,
+          sameSite: 'strict',
+          expires: new Date(0),
+          path: '/',
+        }),
+      )
+
+      return response
     },
   })
-```
 
-### Cloudflare Workers Integration
+app.listen(3000)
+```
 
-In Cloudflare Workers, `waitUntil` is automatically detected from the global context:
+You can also use cookies in middleware for authentication or session handling:
 
 ```ts
 import { Spiceflow } from 'spiceflow'
+import { parse, serialize } from 'cookie'
 
 const app = new Spiceflow()
-  .route({
-    method: 'POST',
-    path: '/webhook',
-    async handler({ request, waitUntil }) {
-      const payload = await request.json()
-
-      // Process webhook data in background
-      waitUntil(
-        processWebhookData(payload)
-          .then(() => console.log('Webhook processed'))
-          .catch(err => console.error('Webhook processing failed:', err))
+  .state('userId', null as string | null)
+  .use(async ({ request, state }, next) => {
+    // Parse cookies from incoming request
+    const cookies = parse(request.headers.get('Cookie') || '')
+
+    // Extract user ID from session cookie
+    if (cookies.session) {
+      // In a real app, you'd verify the session token
+      state.userId = cookies.session
+    }
+
+    const response = await next()
+
+    // Optionally refresh the session cookie
+    if (state.userId && response) {
+      response.headers.set(
+        'Set-Cookie',
+        serialize('session', state.userId, {
+          httpOnly: true,
+          secure: true,
+          sameSite: 'strict',
+          maxAge: 60 * 60 * 24, // 24 hours
+          path: '/',
+        }),
       )
+    }
+
+    return response
+  })
+  .route({
+    method: 'GET',
+    path: '/profile',
+    handler({ state }) {
+      if (!state.userId) {
+        return new Response('Unauthorized', { status: 401 })
+      }
 
-      // Respond immediately to webhook sender
-      return new Response('OK', { status: 200 })
+      return { userId: state.userId, message: 'Welcome back!' }
     },
   })
+```
+
+## Background tasks with waitUntil
+
+Spiceflow provides a `waitUntil` function in the handler context that allows you to schedule tasks in the background in a cross platform way. It will use the Cloudflare workers waitUntil if present. It's currently a no op in Node.js.
+
+### Basic Usage
+
+```ts
+import { Spiceflow } from 'spiceflow'
+
+const app = new Spiceflow().route({
+  method: 'POST',
+  path: '/process',
+  async handler({ request, waitUntil }) {
+    const data = await request.json()
+
+    // Schedule background task
+    waitUntil(
+      fetch('https://analytics.example.com/track', {
+        method: 'POST',
+        body: JSON.stringify({ event: 'data_processed', data }),
+      }),
+    )
+
+    // Return response immediately
+    return { success: true, id: Math.random().toString(36) }
+  },
+})
+```
+
+### Cloudflare Workers Integration
+
+In Cloudflare Workers, `waitUntil` is automatically detected from the global context:
+
+```ts
+import { Spiceflow } from 'spiceflow'
+
+const app = new Spiceflow().route({
+  method: 'POST',
+  path: '/webhook',
+  async handler({ request, waitUntil }) {
+    const payload = await request.json()
+
+    // Process webhook data in background
+    waitUntil(
+      processWebhookData(payload)
+        .then(() => console.log('Webhook processed'))
+        .catch((err) => console.error('Webhook processing failed:', err)),
+    )
+
+    // Respond immediately to webhook sender
+    return new Response('OK', { status: 200 })
+  },
+})
 
 async function processWebhookData(payload: any) {
   // Simulate time-consuming processing
-  await new Promise(resolve => setTimeout(resolve, 1000))
+  await new Promise((resolve) => setTimeout(resolve, 1000))
   // Save to database, send notifications, etc.
 }
 
 export default {
   fetch(request: Request, env: any, ctx: ExecutionContext) {
-    return app.handle(request)
+    return app.handle(request, { state: { env } })
   },
 }
 ```
@@ -1072,21 +1272,18 @@ import { Spiceflow } from 'spiceflow'
 const app = new Spiceflow({
   waitUntil: (promise) => {
     // Custom implementation for non-Cloudflare environments
-    promise.catch(err => console.error('Background task failed:', err))
-  }
-})
-  .route({
-    method: 'GET',
-    path: '/analytics',
-    async handler({ waitUntil }) {
-      // Schedule analytics tracking
-      waitUntil(
-        trackPageView('/analytics')
-      )
+    promise.catch((err) => console.error('Background task failed:', err))
+  },
+}).route({
+  method: 'GET',
+  path: '/analytics',
+  async handler({ waitUntil }) {
+    // Schedule analytics tracking
+    waitUntil(trackPageView('/analytics'))
 
-      return { message: 'Analytics page loaded' }
-    },
-  })
+    return { message: 'Analytics page loaded' }
+  },
+})
 
 async function trackPageView(path: string) {
   // Track page view in analytics system

package/dist/_node-server.d.ts

@@ -1,6 +1,9 @@
 import { type Server, type IncomingMessage, type ServerResponse } from 'node:http';
 import { AnySpiceflow } from './spiceflow.ts';
-export declare function listenForNode(app: AnySpiceflow, port: number, hostname?: string): Promise<Server<typeof IncomingMessage, typeof ServerResponse>>;
+export declare function listenForNode(app: AnySpiceflow, port: number, hostname?: string): Promise<{
+    port: number;
+    server: Server<typeof IncomingMessage, typeof ServerResponse>;
+}>;
 export declare function handleForNode(app: AnySpiceflow, req: IncomingMessage, res: ServerResponse, context?: {
     state?: {} | undefined;
 }): Promise<void>;

package/dist/_node-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_node-server.d.ts","sourceRoot":"","sources":["../src/_node-server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,YAAY,EAAoC,MAAM,gBAAgB,CAAA;AAE/E,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,eAAe,EAAE,OAAO,cAAc,CAAC,CAAC,CAkBhE;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,EAAE,GAAG,SAAS,CAAA;CAAO,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Ef"}
+{"version":3,"file":"_node-server.d.ts","sourceRoot":"","sources":["../src/_node-server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,YAAY,EAAoC,MAAM,gBAAgB,CAAA;AAE/E,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAkB,GAC3B,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,OAAO,eAAe,EAAE,OAAO,cAAc,CAAC,CAAA;CAAC,CAAC,CAmBxF;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,EAAE,GAAG,SAAS,CAAA;CAAO,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Ef"}

package/dist/_node-server.js

@@ -14,7 +14,8 @@ export async function listenForNode(app, port, hostname = '0.0.0.0') {
             resolve(null);
         });
     });
-    return server;
+    const actualPort = server.address().port;
+    return { port: actualPort, server };
 }
 export async function handleForNode(app, req, res, context = {}) {
     if (req?.['body']) {

package/dist/_node-server.js.map

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

package/dist/mcp.d.ts

@@ -1,5 +1,10 @@
 import { SSEServerTransportSpiceflow } from './mcp-transport.ts';
 import { Spiceflow } from './spiceflow.ts';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function addMcpTools({ mcpServer, app, }: {
+    mcpServer: Server;
+    app: Spiceflow;
+}): Promise<Server>;
 export declare const mcp: <Path extends string = "/mcp">({ path, name, version, transports, }?: {
     path?: Path | undefined;
     name?: string | undefined;

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAGhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI1C,eAAO,MAAM,GAAG,GAAI,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE;;;;;CAQ5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAiFL,CAAA"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAGhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAIlE,wBAAsB,WAAW,CAAC,EAChC,SAAS,EACT,GAAG,GACJ,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,SAAS,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,eAAO,MAAM,GAAG,GAAI,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE;;;;;CAQ5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgFL,CAAA"}

package/dist/mcp.js

@@ -3,6 +3,38 @@ import { createMCPServer } from "./openapi-to-mcp.js";
 import { openapi } from "./openapi.js";
 import { Spiceflow } from "./spiceflow.js";
 const defaultTransports = new Map();
+export async function addMcpTools({ mcpServer, app, }) {
+    const basePath = app.topLevelApp?.basePath || '';
+    const [openapi, mcpConfig] = await Promise.all([
+        app
+            .topLevelApp.handle(new Request(`http://localhost${basePath}/_mcp_openapi`))
+            .then((r) => r.json()),
+        app
+            .topLevelApp.handle(new Request(`http://localhost${basePath}/_mcp_config`))
+            .then((r) => r.json()),
+    ]);
+    const mcpPath = mcpConfig?.path;
+    if (!mcpPath) {
+        throw new Error('Missing MCP path from app, make sure to use the mcp() Spiceflow plugin');
+    }
+    const { server: configuredServer } = createMCPServer({
+        name: mcpConfig.name,
+        version: mcpConfig.version,
+        server: mcpServer,
+        ignorePaths: [
+            '/_mcp_openapi',
+            '/_mcp_config',
+            mcpPath,
+            mcpPath + '/message',
+        ],
+        fetch: (url, init) => {
+            const req = new Request(url, init);
+            return app.handle(req);
+        },
+        openapi,
+    });
+    return configuredServer;
+}
 export const mcp = ({ path = '/mcp', name = 'spiceflow', version = '1.0.0', 
 /**
  * Map to get a transport from a sessionId and
@@ -53,7 +85,7 @@ transports = defaultTransports, } = {}) => {
                 '/_mcp_openapi',
                 '/_mcp_config',
                 mcpPath,
-                mcpPath + '/message', //
+                mcpPath + '/message',
             ],
             fetch: (url, init) => {
                 const req = new Request(url, init);

package/dist/mcp.js.map

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

package/dist/openapi-to-mcp.d.ts

@@ -1,11 +1,12 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { OpenAPIV3 } from 'openapi-types';
 type Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-export declare function createMCPServer({ name, version, openapi, fetch, paths, ignorePaths, baseUrl, }: {
+export declare function createMCPServer({ name, version, openapi, server, fetch, paths, ignorePaths, baseUrl, }: {
     name?: string;
     version?: string;
-    fetch?: Fetch;
     openapi: OpenAPIV3.Document;
+    server?: Server;
+    fetch?: Fetch;
     paths?: string[];
     ignorePaths?: string[];
     baseUrl?: string;

package/dist/openapi-to-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-to-mcp.d.ts","sourceRoot":"","sources":["../src/openapi-to-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AASlE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA8JzC,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAGhF,wBAAgB,eAAe,CAAC,EAC9B,IAAkB,EAClB,OAAiB,EACjB,OAAO,EAEP,KAAoB,EACpB,KAAK,EACL,WAAW,EACX,OAAY,GACb,EAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;;;;;;;;;;;;;;;;;;;;;;;;EA4OA"}
+{"version":3,"file":"openapi-to-mcp.d.ts","sourceRoot":"","sources":["../src/openapi-to-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AASlE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA8JzC,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAGhF,wBAAgB,eAAe,CAAC,EAC9B,IAAkB,EAClB,OAAiB,EACjB,OAAO,EACP,MAAM,EACN,KAAoB,EACpB,KAAK,EACL,WAAW,EACX,OAAY,GACb,EAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;;;;;;;;;;;;;;;;;;;;;;;;EA4OA"}

package/dist/openapi-to-mcp.js

@@ -133,8 +133,8 @@ function getAuthHeaders(openapi, operation) {
     return headers;
 }
 const defaultFetch = fetch;
-export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi, fetch = defaultFetch, paths, ignorePaths, baseUrl = '', }) {
-    const server = new Server({ name, version }, {
+export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi, server, fetch = defaultFetch, paths, ignorePaths, baseUrl = '', }) {
+    const mcpServer = server || new Server({ name, version }, {
         capabilities: {
             tools: {},
             resources: {},
@@ -176,7 +176,7 @@ export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi
             headers: finalHeaders,
         });
     }
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
+    mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
         const filteredPaths = Object.entries(openapi.paths).filter(([path]) => {
             if (ignorePaths?.includes(path))
                 return false;
@@ -227,7 +227,7 @@ export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi
         }));
         return { tools };
     });
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         const toolName = request.params.name;
         let { path, method } = getPathFromToolName(toolName);
         const pathObj = openapi.paths[path];
@@ -288,7 +288,7 @@ export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi
             };
         }
     });
-    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    mcpServer.setRequestHandler(ListResourcesRequestSchema, async () => {
         const resources = [];
         for (const [path, pathObj] of Object.entries(openapi.paths)) {
             if (path.startsWith('/mcp')) {
@@ -311,10 +311,10 @@ export function createMCPServer({ name = 'spiceflow', version = '1.0.0', openapi
         }
         return { resources: [] };
     });
-    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    mcpServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
         throw new Error('Resources are not supported - use tools instead');
     });
-    return { server };
+    return { server: mcpServer };
 }
 function getRouteName({ method, path, }) {
     return formatToolName(`${method.toUpperCase()} ${path}`, method, path);