integrate-sdk 0.5.8 → 0.6.0

package/README.md

@@ -28,6 +28,19 @@ bun add integrate-sdk
 
 ## Quick Start (2 Files Only!)
 
+### 0. Configure OAuth Redirect URI
+
+⚠️ **Important**: Configure your OAuth apps with this redirect URI:
+
+```
+http://localhost:3000/api/integrate/oauth/callback
+```
+
+- **GitHub**: Settings → Developer settings → OAuth Apps → Authorization callback URL
+- **Google/Gmail**: Google Cloud Console → Credentials → Authorized redirect URIs
+
+For production, use: `https://yourdomain.com/api/integrate/oauth/callback`
+
 ### 1. Create Server Config
 
 Define your OAuth providers once:
@@ -62,14 +75,16 @@ That's it! Just import and export:
 
 ```typescript
 // app/api/integrate/[...all]/route.ts
+import { serverClient } from "@/lib/integrate-server";
 import { toNextJsHandler } from "integrate-sdk/server";
 
 export const { POST, GET } = toNextJsHandler({
+  client: serverClient, // Pass the client
   redirectUrl: "/dashboard",
 });
 ```
 
-This automatically uses your config from step 1 and handles ALL OAuth operations (authorize, callback, status, disconnect) in one file!
+This imports your config from step 1 and handles ALL OAuth operations (authorize, callback, status, disconnect) in one file!
 
 ### 3. Use in Your App
 

package/dist/index.js

@@ -1063,7 +1063,7 @@ class MCPClient {
   }
   getDefaultRedirectUri(oauthApiBase) {
     if (typeof window === "undefined" || !window.location) {
-      return "http://localhost:3000/oauth/callback";
+      return "http://localhost:3000/api/integrate/oauth/callback";
     }
     const origin = window.location.origin;
     const normalizedPath = oauthApiBase.replace(/\/$/, "");

package/dist/server.js

@@ -1063,7 +1063,7 @@ class MCPClient {
   }
   getDefaultRedirectUri(oauthApiBase) {
     if (typeof window === "undefined" || !window.location) {
-      return "http://localhost:3000/oauth/callback";
+      return "http://localhost:3000/api/integrate/oauth/callback";
     }
     const origin = window.location.origin;
     const normalizedPath = oauthApiBase.replace(/\/$/, "");
@@ -1946,15 +1946,15 @@ function createSimplePlugin(config) {
 var globalServerConfig = null;
 function getDefaultRedirectUri() {
   if (typeof window !== "undefined") {
-    return `${window.location.origin}/oauth/callback`;
+    return `${window.location.origin}/api/integrate/oauth/callback`;
   }
   if (process.env.INTEGRATE_URL) {
-    return `${process.env.INTEGRATE_URL}/oauth/callback`;
+    return `${process.env.INTEGRATE_URL}/api/integrate/oauth/callback`;
   }
   if (process.env.VERCEL_URL) {
-    return `https://${process.env.VERCEL_URL}/oauth/callback`;
+    return `https://${process.env.VERCEL_URL}/api/integrate/oauth/callback`;
   }
-  return "http://localhost:3000/oauth/callback";
+  return "http://localhost:3000/api/integrate/oauth/callback";
 }
 function createMCPServer(config) {
   if (typeof window !== "undefined") {
@@ -1992,6 +1992,7 @@ function createMCPServer(config) {
     singleton: config.singleton ?? true
   };
   const client = new MCPClient(clientConfig);
+  client.__oauthConfig = { providers };
   const { POST, GET } = createOAuthRouteHandlers({ providers });
   return {
     client,
@@ -2019,21 +2020,29 @@ var GET = async (req, context) => {
   const routes = handler.createRoutes();
   return routes.GET(req, context);
 };
-function toNextJsHandler(redirectConfig) {
+function toNextJsHandler(options) {
   const POST2 = async (req, context) => {
-    if (!globalServerConfig) {
-      return Response.json({ error: "OAuth not configured. Call createMCPServer() in your server initialization file first." }, { status: 500 });
-    }
-    const handler = createNextOAuthHandler(globalServerConfig);
-    const routes = handler.toNextJsHandler(redirectConfig);
+    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
+    });
     return routes.POST(req, context);
   };
   const GET2 = async (req, context) => {
-    if (!globalServerConfig) {
-      return Response.json({ error: "OAuth not configured. Call createMCPServer() in your server initialization file first." }, { status: 500 });
-    }
-    const handler = createNextOAuthHandler(globalServerConfig);
-    const routes = handler.toNextJsHandler(redirectConfig);
+    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
+    });
     return routes.GET(req, context);
   };
   return { POST: POST2, GET: GET2 };

package/dist/src/config/types.d.ts

@@ -170,7 +170,7 @@ export interface MCPClientConfig<TPlugins extends readonly MCPPlugin[]> {
      * **Server-side (createMCPServer):** If not provided, auto-detects from environment:
      * - INTEGRATE_URL (primary)
      * - VERCEL_URL
-     * - Falls back to 'http://localhost:3000/oauth/callback'
+     * - Falls back to 'http://localhost:3000/api/integrate/oauth/callback'
      *
      * **Client-side (createMCPClient):** If not provided, auto-detects from:
      * - window.location.origin + oauthApiBase + '/callback'

package/dist/src/server.d.ts

@@ -23,7 +23,7 @@ import type { MCPPlugin } from './plugins/types.js';
  * export const { client: serverClient } = createMCPServer({
  *   redirectUri: process.env.INTEGRATE_URL
  *     ? `${process.env.INTEGRATE_URL}/oauth/callback`
- *     : 'http://localhost:3000/oauth/callback',
+ *     : 'http://localhost:3000/api/integrate/oauth/callback',
  *   plugins: [
  *     githubPlugin({
  *       clientId: process.env.GITHUB_CLIENT_ID!,
@@ -146,15 +146,44 @@ 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
+ *   redirectUrl: '/dashboard',
+ * });
+ *
+ * // Alternative: Provide config inline
+ * export const { POST, GET } = toNextJsHandler({
+ *   config: {
+ *     providers: {
+ *       github: {
+ *         clientId: process.env.GITHUB_CLIENT_ID!,
+ *         clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+ *       },
+ *     },
+ *   },
  *   redirectUrl: '/dashboard',
  * });
  * ```
  */
-export declare function toNextJsHandler(redirectConfig?: {
+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;
+        }>;
+    };
+    /** URL to redirect to after successful OAuth */
     redirectUrl?: string;
+    /** URL to redirect to on OAuth error */
     errorRedirectUrl?: string;
 }): {
     POST: (req: any, context: {

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAyCpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,SAAS,SAAS,EAAE,EACnE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;IAmE/B,2DAA2D;;IAG3D,4DAA4D;;;;;;;;IAG5D,2DAA2D;;;;;;;;EAG9D;AAYD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,GACf,KAAK,GAAG,EACR,SAAS;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,iBAYtE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,GAAG,GACd,KAAK,GAAG,EACR,SAAS;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,iBAYtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAAC,cAAc,CAAC,EAAE;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;gBAMQ,GAAG,WACC;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;eAmB9D,GAAG,WACC;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;EAetE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAyCpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,SAAS,SAAS,EAAE,EACnE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;IAsE/B,2DAA2D;;IAG3D,4DAA4D;;;;;;;;IAG5D,2DAA2D;;;;;;;;EAG9D;AAYD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,GACf,KAAK,GAAG,EACR,SAAS;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,iBAYtE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,GAAG,GACd,KAAK,GAAG,EACR,SAAS;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,iBAYtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,kFAAkF;IAClF,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,mDAAmD;IACnD,MAAM,CAAC,EAAE;QACP,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;YACxB,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;YACrB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC;IACF,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;gBAMQ,GAAG,WACC;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;eAwB9D,GAAG,WACC;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;EAoBtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.5.8",
+  "version": "0.6.0",
   "description": "Type-safe TypeScript SDK for MCP Client with plugin-based OAuth provider configuration",
   "type": "module",
   "main": "./dist/index.js",