integrate-sdk 0.7.10 → 0.7.12

package/dist/adapters/solid-start.js

@@ -1735,9 +1735,9 @@ class MCPClient {
   }
 }
 // src/server.ts
-function toSolidStartHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
     const handler2 = async (event) => {
       return baseHandler(event.request);
     };
@@ -1749,7 +1749,20 @@ function toSolidStartHandler(handlerOrOptions) {
       DELETE: handler2
     };
   }
-  const options = handlerOrOptions;
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
+    const handler2 = async (event) => {
+      return baseHandler(event.request);
+    };
+    return {
+      GET: handler2,
+      POST: handler2,
+      PATCH: handler2,
+      PUT: handler2,
+      DELETE: handler2
+    };
+  }
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSolidStartHandler requires either a handler function or a providers config object");
   }
@@ -1788,15 +1801,22 @@ function toSolidStartHandler(handlerOrOptions) {
     DELETE: handler
   };
 }
-function toSvelteKitHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSvelteKitHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    return async (event) => {
+      const all = event.params?.all;
+      return baseHandler(event.request, { params: { all } });
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     return async (event) => {
       const all = event.params?.all;
       return baseHandler(event.request, { params: { all } });
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSvelteKitHandler requires either a handler function or a providers config object");
   }

package/dist/adapters/svelte-kit.js

@@ -1735,9 +1735,9 @@ class MCPClient {
   }
 }
 // src/server.ts
-function toSolidStartHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
     const handler2 = async (event) => {
       return baseHandler(event.request);
     };
@@ -1749,7 +1749,20 @@ function toSolidStartHandler(handlerOrOptions) {
       DELETE: handler2
     };
   }
-  const options = handlerOrOptions;
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
+    const handler2 = async (event) => {
+      return baseHandler(event.request);
+    };
+    return {
+      GET: handler2,
+      POST: handler2,
+      PATCH: handler2,
+      PUT: handler2,
+      DELETE: handler2
+    };
+  }
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSolidStartHandler requires either a handler function or a providers config object");
   }
@@ -1788,15 +1801,22 @@ function toSolidStartHandler(handlerOrOptions) {
     DELETE: handler
   };
 }
-function toSvelteKitHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSvelteKitHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    return async (event) => {
+      const all = event.params?.all;
+      return baseHandler(event.request, { params: { all } });
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     return async (event) => {
       const all = event.params?.all;
       return baseHandler(event.request, { params: { all } });
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSvelteKitHandler requires either a handler function or a providers config object");
   }

package/dist/index.js

@@ -2378,6 +2378,9 @@ function createMCPServer(config) {
       return Response.json({ error: `Method ${method} not allowed` }, { status: 405 });
     }
   };
+  client.handler = handler;
+  client.POST = POST;
+  client.GET = GET;
   return {
     client,
     POST,
@@ -2405,28 +2408,48 @@ var GET = async (req, context) => {
   const routes = handler.createRoutes();
   return routes.GET(req, context);
 };
-function toNextJsHandler(options) {
+function toNextJsHandler(clientOrOptions, redirectOptions) {
+  let config;
+  let redirectUrl;
+  let errorRedirectUrl;
+  if (!clientOrOptions) {
+    config = globalServerConfig;
+    redirectUrl = redirectOptions?.redirectUrl;
+    errorRedirectUrl = redirectOptions?.errorRedirectUrl;
+  } else if (clientOrOptions.__oauthConfig) {
+    config = clientOrOptions.__oauthConfig;
+    redirectUrl = redirectOptions?.redirectUrl;
+    errorRedirectUrl = redirectOptions?.errorRedirectUrl;
+  } else if (typeof clientOrOptions === "object" && clientOrOptions.providers) {
+    config = {
+      providers: clientOrOptions.providers,
+      serverUrl: clientOrOptions.serverUrl,
+      apiKey: clientOrOptions.apiKey
+    };
+    redirectUrl = clientOrOptions.redirectUrl;
+    errorRedirectUrl = clientOrOptions.errorRedirectUrl;
+  } else {
+    config = null;
+  }
+  if (!config) {
+    throw new Error(`toNextJsHandler requires either:
+  1. A client instance from createMCPServer()
+  2. A config object with providers property
+  3. No arguments (uses global config from createMCPServer)`);
+  }
   const POST2 = async (req, context) => {
-    const config = options.config || options.client?.__oauthConfig;
-    if (!config) {
-      return Response.json({ error: 'OAuth not configured. You must pass either "client" (from createMCPServer) or "config" to toNextJsHandler().' }, { status: 500 });
-    }
     const handler = createNextOAuthHandler(config);
     const routes = handler.toNextJsHandler({
-      redirectUrl: options.redirectUrl,
-      errorRedirectUrl: options.errorRedirectUrl
+      redirectUrl,
+      errorRedirectUrl
     });
     return routes.POST(req, context);
   };
   const GET2 = async (req, context) => {
-    const config = options.config || options.client?.__oauthConfig;
-    if (!config) {
-      return Response.json({ error: 'OAuth not configured. You must pass either "client" (from createMCPServer) or "config" to toNextJsHandler().' }, { status: 500 });
-    }
     const handler = createNextOAuthHandler(config);
     const routes = handler.toNextJsHandler({
-      redirectUrl: options.redirectUrl,
-      errorRedirectUrl: options.errorRedirectUrl
+      redirectUrl,
+      errorRedirectUrl
     });
     return routes.GET(req, context);
   };
@@ -2484,9 +2507,22 @@ function toAstroHandler(baseHandler, options) {
     return wrappedHandler(ctx.request, { params: { all: ctx.params.all } });
   };
 }
-function toSolidStartHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    const handler2 = async (event) => {
+      return baseHandler(event.request);
+    };
+    return {
+      GET: handler2,
+      POST: handler2,
+      PATCH: handler2,
+      PUT: handler2,
+      DELETE: handler2
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     const handler2 = async (event) => {
       return baseHandler(event.request);
     };
@@ -2498,7 +2534,7 @@ function toSolidStartHandler(handlerOrOptions) {
       DELETE: handler2
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSolidStartHandler requires either a handler function or a providers config object");
   }
@@ -2537,15 +2573,22 @@ function toSolidStartHandler(handlerOrOptions) {
     DELETE: handler
   };
 }
-function toSvelteKitHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSvelteKitHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    return async (event) => {
+      const all = event.params?.all;
+      return baseHandler(event.request, { params: { all } });
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     return async (event) => {
       const all = event.params?.all;
       return baseHandler(event.request, { params: { all } });
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSvelteKitHandler requires either a handler function or a providers config object");
   }

package/dist/server.js

@@ -2204,6 +2204,9 @@ function createMCPServer(config) {
       return Response.json({ error: `Method ${method} not allowed` }, { status: 405 });
     }
   };
+  client.handler = handler;
+  client.POST = POST;
+  client.GET = GET;
   return {
     client,
     POST,
@@ -2231,28 +2234,48 @@ var GET = async (req, context) => {
   const routes = handler.createRoutes();
   return routes.GET(req, context);
 };
-function toNextJsHandler(options) {
+function toNextJsHandler(clientOrOptions, redirectOptions) {
+  let config;
+  let redirectUrl;
+  let errorRedirectUrl;
+  if (!clientOrOptions) {
+    config = globalServerConfig;
+    redirectUrl = redirectOptions?.redirectUrl;
+    errorRedirectUrl = redirectOptions?.errorRedirectUrl;
+  } else if (clientOrOptions.__oauthConfig) {
+    config = clientOrOptions.__oauthConfig;
+    redirectUrl = redirectOptions?.redirectUrl;
+    errorRedirectUrl = redirectOptions?.errorRedirectUrl;
+  } else if (typeof clientOrOptions === "object" && clientOrOptions.providers) {
+    config = {
+      providers: clientOrOptions.providers,
+      serverUrl: clientOrOptions.serverUrl,
+      apiKey: clientOrOptions.apiKey
+    };
+    redirectUrl = clientOrOptions.redirectUrl;
+    errorRedirectUrl = clientOrOptions.errorRedirectUrl;
+  } else {
+    config = null;
+  }
+  if (!config) {
+    throw new Error(`toNextJsHandler requires either:
+  1. A client instance from createMCPServer()
+  2. A config object with providers property
+  3. No arguments (uses global config from createMCPServer)`);
+  }
   const POST2 = async (req, context) => {
-    const config = options.config || options.client?.__oauthConfig;
-    if (!config) {
-      return Response.json({ error: 'OAuth not configured. You must pass either "client" (from createMCPServer) or "config" to toNextJsHandler().' }, { status: 500 });
-    }
     const handler = createNextOAuthHandler(config);
     const routes = handler.toNextJsHandler({
-      redirectUrl: options.redirectUrl,
-      errorRedirectUrl: options.errorRedirectUrl
+      redirectUrl,
+      errorRedirectUrl
     });
     return routes.POST(req, context);
   };
   const GET2 = async (req, context) => {
-    const config = options.config || options.client?.__oauthConfig;
-    if (!config) {
-      return Response.json({ error: 'OAuth not configured. You must pass either "client" (from createMCPServer) or "config" to toNextJsHandler().' }, { status: 500 });
-    }
     const handler = createNextOAuthHandler(config);
     const routes = handler.toNextJsHandler({
-      redirectUrl: options.redirectUrl,
-      errorRedirectUrl: options.errorRedirectUrl
+      redirectUrl,
+      errorRedirectUrl
     });
     return routes.GET(req, context);
   };
@@ -2310,9 +2333,22 @@ function toAstroHandler(baseHandler, options) {
     return wrappedHandler(ctx.request, { params: { all: ctx.params.all } });
   };
 }
-function toSolidStartHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    const handler2 = async (event) => {
+      return baseHandler(event.request);
+    };
+    return {
+      GET: handler2,
+      POST: handler2,
+      PATCH: handler2,
+      PUT: handler2,
+      DELETE: handler2
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     const handler2 = async (event) => {
       return baseHandler(event.request);
     };
@@ -2324,7 +2360,7 @@ function toSolidStartHandler(handlerOrOptions) {
       DELETE: handler2
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSolidStartHandler requires either a handler function or a providers config object");
   }
@@ -2363,15 +2399,22 @@ function toSolidStartHandler(handlerOrOptions) {
     DELETE: handler
   };
 }
-function toSvelteKitHandler(handlerOrOptions) {
-  if (typeof handlerOrOptions === "function") {
-    const baseHandler = handlerOrOptions;
+function toSvelteKitHandler(clientOrHandlerOrOptions, _redirectOptions) {
+  if (clientOrHandlerOrOptions && clientOrHandlerOrOptions.handler && typeof clientOrHandlerOrOptions.handler === "function") {
+    const baseHandler = clientOrHandlerOrOptions.handler;
+    return async (event) => {
+      const all = event.params?.all;
+      return baseHandler(event.request, { params: { all } });
+    };
+  }
+  if (typeof clientOrHandlerOrOptions === "function") {
+    const baseHandler = clientOrHandlerOrOptions;
     return async (event) => {
       const all = event.params?.all;
       return baseHandler(event.request, { params: { all } });
     };
   }
-  const options = handlerOrOptions;
+  const options = clientOrHandlerOrOptions;
   if (!options.providers || Object.keys(options.providers).length === 0) {
     throw new Error("toSvelteKitHandler requires either a handler function or a providers config object");
   }

package/dist/src/server.d.ts

@@ -14,6 +14,8 @@ import type { MCPPlugin } from './plugins/types.js';
  * The redirectUri can be specified globally and will be used for all plugins.
  * If not provided, it will auto-detect from INTEGRATE_URL or VERCEL_URL
  *
+ * The returned client has `handler`, `POST`, and `GET` attached for easy access.
+ *
  * ⚠️ SECURITY: The API key should NEVER be exposed to client-side code.
  * Use environment variables WITHOUT the NEXT_PUBLIC_ prefix.
  *
@@ -43,14 +45,17 @@ import type { MCPPlugin } from './plugins/types.js';
  * });
  * ```
  *
- * Then in your route file:
+ * Then use the handler directly from the client:
  * ```typescript
- * // app/api/integrate/oauth/[action]/route.ts
- * export { POST, GET } from 'integrate-sdk/server';
+ * // routes/api/integrate/[...all]/+server.ts (SvelteKit)
+ * import { serverClient } from '$lib/integrate-server';
+ *
+ * export const POST = serverClient.handler;
+ * export const GET = serverClient.handler;
  * ```
  */
 export declare function createMCPServer<TPlugins extends readonly MCPPlugin[]>(config: MCPServerConfig<TPlugins>): {
-    /** Server-side MCP client instance with auto-connection */
+    /** Server-side MCP client instance with auto-connection and attached handler */
     client: MCPClient<TPlugins>;
     /** OAuth POST handler - export this from your route file */
     POST: (req: any, context: {
@@ -122,15 +127,18 @@ export declare const GET: (req: any, context: {
     }>;
 }) => Promise<any>;
 /**
- * Create catch-all route handlers from the global server configuration
+ * Create catch-all route handlers for Next.js
  *
- * This is a helper function to create POST and GET handlers for catch-all routes
- * that use the configuration from createMCPServer().
+ * Supports two usage patterns:
+ * 1. Pass a client instance from createMCPServer
+ * 2. Pass config object directly (for inline configuration)
  *
- * @param redirectConfig - Optional configuration for OAuth redirect behavior
+ * @param clientOrOptions - Client instance from createMCPServer, or config options
+ * @param redirectOptions - Redirect URL configuration (when first param is a client)
  * @returns Object with POST and GET handlers for Next.js catch-all routes
  *
  * @example
+ * **Pattern 1: Using client from createMCPServer (Recommended)**
  * ```typescript
  * // lib/integrate-server.ts
  * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
@@ -146,45 +154,52 @@ export declare const GET: (req: any, context: {
  * });
  *
  * // app/api/integrate/[...all]/route.ts
- *
- * // RECOMMENDED: Import serverClient from your server setup file
  * import { serverClient } from '@/lib/integrate-server';
  * import { toNextJsHandler } from 'integrate-sdk/server';
  *
- * export const { POST, GET } = toNextJsHandler({
- *   client: serverClient,  // Pass the client from createMCPServer
+ * export const { POST, GET } = toNextJsHandler(serverClient, {
  *   redirectUrl: '/dashboard',
+ *   errorRedirectUrl: '/auth-error',
  * });
+ * ```
+ *
+ * @example
+ * **Pattern 2: Inline configuration**
+ * ```typescript
+ * // app/api/integrate/[...all]/route.ts
+ * import { toNextJsHandler } from 'integrate-sdk/server';
  *
- * // Alternative: Provide config inline
  * export const { POST, GET } = toNextJsHandler({
- *   config: {
- *     providers: {
- *       github: {
- *         clientId: process.env.GITHUB_CLIENT_ID!,
- *         clientSecret: process.env.GITHUB_CLIENT_SECRET!,
- *       },
+ *   providers: {
+ *     github: {
+ *       clientId: process.env.GITHUB_CLIENT_ID!,
+ *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
  *     },
  *   },
  *   redirectUrl: '/dashboard',
+ *   errorRedirectUrl: '/auth-error',
  * });
  * ```
  */
-export declare function toNextJsHandler(options: {
-    /** Server client instance from createMCPServer (extracts config automatically) */
-    client?: any;
-    /** Custom OAuth handler config (provide inline) */
-    config?: {
-        providers: Record<string, {
-            clientId: string;
-            clientSecret: string;
-            redirectUri?: string;
-        }>;
-        serverUrl?: string;
-    };
-    /** URL to redirect to after successful OAuth */
+export declare function toNextJsHandler(clientOrOptions?: any | {
+    /** OAuth provider configurations */
+    providers?: Record<string, {
+        clientId: string;
+        clientSecret: string;
+        redirectUri?: string;
+    }>;
+    /** Server URL for MCP server */
+    serverUrl?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** URL to redirect to after successful OAuth callback (default: '/') */
+    redirectUrl?: string;
+    /** URL to redirect to on OAuth error (default: '/auth-error') */
+    errorRedirectUrl?: string;
+}, redirectOptions?: {
+    /** URL to redirect to after successful OAuth callback (default: '/') */
     redirectUrl?: string;
-    /** URL to redirect to on OAuth error */
+    /** URL to redirect to on OAuth error (default: '/auth-error') */
     errorRedirectUrl?: string;
 }): {
     POST: (req: any, context: {
@@ -216,7 +231,7 @@ export declare function toNextJsHandler(options: {
  * // lib/integrate-server.ts
  * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
  *
- * export const { handler } = createMCPServer({
+ * export const { client: serverClient } = createMCPServer({
  *   plugins: [
  *     githubPlugin({
  *       clientId: import.meta.env.GITHUB_CLIENT_ID!,
@@ -227,9 +242,9 @@ export declare function toNextJsHandler(options: {
  *
  * // pages/api/integrate/[...all].ts
  * import { toAstroHandler } from 'integrate-sdk/server';
- * import { handler } from '@/lib/integrate-server';
+ * import { serverClient } from '@/lib/integrate-server';
  *
- * export const ALL = toAstroHandler(handler, {
+ * export const ALL = toAstroHandler(serverClient.handler, {
  *   redirectUrl: '/dashboard',
  *   errorRedirectUrl: '/auth-error',
  * });
@@ -263,12 +278,12 @@ export declare function toAstroHandler(baseHandler: (request: Request, context?:
  * @returns Object with GET, POST, PATCH, PUT, DELETE handlers
  *
  * @example
- * **Pattern 1: Using handler from createMCPServer (Recommended)**
+ * **Pattern 1: Using serverClient from createMCPServer (Recommended)**
  * ```typescript
  * // lib/integrate-server.ts
  * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
  *
- * export const { handler } = createMCPServer({
+ * export const { client: serverClient } = createMCPServer({
  *   plugins: [
  *     githubPlugin({
  *       clientId: process.env.GITHUB_CLIENT_ID!,
@@ -279,9 +294,9 @@ export declare function toAstroHandler(baseHandler: (request: Request, context?:
  *
  * // src/routes/api/integrate/[...all].ts
  * import { toSolidStartHandler } from 'integrate-sdk/server';
- * import { handler } from '@/lib/integrate-server';
+ * import { serverClient } from '@/lib/integrate-server';
  *
- * const handlers = toSolidStartHandler(handler, {
+ * const handlers = toSolidStartHandler(serverClient, {
  *   redirectUrl: '/dashboard',
  *   errorRedirectUrl: '/auth-error',
  * });
@@ -309,7 +324,7 @@ export declare function toAstroHandler(baseHandler: (request: Request, context?:
  * export const { GET, POST, PATCH, PUT, DELETE } = handlers;
  * ```
  */
-export declare function toSolidStartHandler(handlerOrOptions: ((request: Request, context?: {
+export declare function toSolidStartHandler(clientOrHandlerOrOptions: any | ((request: Request, context?: {
     params?: {
         action?: string;
         all?: string | string[];
@@ -329,6 +344,11 @@ export declare function toSolidStartHandler(handlerOrOptions: ((request: Request
     redirectUrl?: string;
     /** URL to redirect to on OAuth error (default: '/auth-error') */
     errorRedirectUrl?: string;
+}, _redirectOptions?: {
+    /** URL to redirect to after successful OAuth callback (default: '/') */
+    redirectUrl?: string;
+    /** URL to redirect to on OAuth error (default: '/auth-error') */
+    errorRedirectUrl?: string;
 }): {
     GET: (event: {
         request: Request;
@@ -358,12 +378,12 @@ export declare function toSolidStartHandler(handlerOrOptions: ((request: Request
  * @returns Handler function for SvelteKit routes
  *
  * @example
- * **Pattern 1: Using handler from createMCPServer (Recommended)**
+ * **Pattern 1: Using serverClient from createMCPServer (Recommended)**
  * ```typescript
  * // lib/integrate-server.ts
  * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
  *
- * export const { handler } = createMCPServer({
+ * export const { client: serverClient } = createMCPServer({
  *   plugins: [
  *     githubPlugin({
  *       clientId: process.env.GITHUB_CLIENT_ID!,
@@ -374,9 +394,9 @@ export declare function toSolidStartHandler(handlerOrOptions: ((request: Request
  *
  * // routes/api/integrate/[...all]/+server.ts
  * import { toSvelteKitHandler } from 'integrate-sdk/server';
- * import { handler } from '$lib/integrate-server';
+ * import { serverClient } from '$lib/integrate-server';
  *
- * const svelteKitRoute = toSvelteKitHandler(handler, {
+ * const svelteKitRoute = toSvelteKitHandler(serverClient, {
  *   redirectUrl: '/dashboard',
  *   errorRedirectUrl: '/auth-error',
  * });
@@ -406,7 +426,7 @@ export declare function toSolidStartHandler(handlerOrOptions: ((request: Request
  * export const GET = handler;
  * ```
  */
-export declare function toSvelteKitHandler(handlerOrOptions: ((request: Request, context?: {
+export declare function toSvelteKitHandler(clientOrHandlerOrOptions: any | ((request: Request, context?: {
     params?: {
         action?: string;
         all?: string | string[];
@@ -426,5 +446,10 @@ export declare function toSvelteKitHandler(handlerOrOptions: ((request: Request,
     redirectUrl?: string;
     /** URL to redirect to on OAuth error (default: '/auth-error') */
     errorRedirectUrl?: string;
+}, _redirectOptions?: {
+    /** URL to redirect to after successful OAuth callback (default: '/') */
+    redirectUrl?: string;
+    /** URL to redirect to on OAuth error (default: '/auth-error') */
+    errorRedirectUrl?: string;
 }): (event: any) => Promise<Response>;
 //# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.7.10",
+  "version": "0.7.12",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",