integrate-sdk 0.3.3 → 0.3.7

package/dist/index.js

@@ -296,7 +296,8 @@ function createNextOAuthHandler(config) {
     createRoutes() {
       return {
         async POST(req, context) {
-          const action = context.params.action;
+          const params = context.params instanceof Promise ? await context.params : context.params;
+          const action = params.action;
           if (action === "authorize") {
             return handlers.authorize(req);
           }
@@ -306,7 +307,8 @@ function createNextOAuthHandler(config) {
           return Response.json({ error: `Unknown action: ${action}` }, { status: 404 });
         },
         async GET(req, context) {
-          const action = context.params.action;
+          const params = context.params instanceof Promise ? await context.params : context.params;
+          const action = params.action;
           if (action === "status") {
             return handlers.status(req);
           }
@@ -596,6 +598,7 @@ function isBrowser() {
 class OAuthWindowManager {
   popupWindow = null;
   popupCheckInterval = null;
+  popupCheckTimeout = null;
   openPopup(url, options) {
     if (!isBrowser()) {
       throw new Error("OAuthWindowManager.openPopup() can only be used in browser environments");
@@ -651,6 +654,10 @@ class OAuthWindowManager {
       const messageHandler = (event) => {
         if (event.data && event.data.type === "oauth_callback") {
           clearTimeout(timeout);
+          if (this.popupCheckTimeout) {
+            clearTimeout(this.popupCheckTimeout);
+            this.popupCheckTimeout = null;
+          }
           window.removeEventListener("message", messageHandler);
           const { code, state, error } = event.data;
           if (error) {
@@ -668,15 +675,18 @@ class OAuthWindowManager {
         }
       };
       window.addEventListener("message", messageHandler);
-      this.popupCheckInterval = setInterval(() => {
-        if (this.popupWindow?.closed) {
-          clearTimeout(timeout);
-          clearInterval(this.popupCheckInterval);
-          window.removeEventListener("message", messageHandler);
-          this.cleanup();
-          reject(new Error("OAuth popup was closed by user"));
-        }
-      }, 500);
+      this.popupCheckTimeout = setTimeout(() => {
+        this.popupCheckTimeout = null;
+        this.popupCheckInterval = setInterval(() => {
+          if (this.popupWindow?.closed) {
+            clearTimeout(timeout);
+            clearInterval(this.popupCheckInterval);
+            window.removeEventListener("message", messageHandler);
+            this.cleanup();
+            reject(new Error("OAuth popup was closed by user"));
+          }
+        }, 500);
+      }, 2000);
     });
   }
   listenForRedirectCallback() {
@@ -685,10 +695,23 @@ class OAuthWindowManager {
     }
     return new Promise((resolve, reject) => {
       const params = new URLSearchParams(window.location.search);
-      const code = params.get("code");
-      const state = params.get("state");
-      const error = params.get("error");
-      const errorDescription = params.get("error_description");
+      let code = params.get("code");
+      let state = params.get("state");
+      let error = params.get("error");
+      let errorDescription = params.get("error_description");
+      if (!code && !error) {
+        try {
+          const stored = sessionStorage.getItem("oauth_callback_params");
+          if (stored) {
+            const parsed = JSON.parse(stored);
+            code = parsed.code;
+            state = parsed.state;
+            sessionStorage.removeItem("oauth_callback_params");
+          }
+        } catch (e) {
+          console.error("Failed to parse OAuth callback params from sessionStorage:", e);
+        }
+      }
       if (error) {
         const errorMsg = errorDescription || error;
         reject(new Error(`OAuth error: ${errorMsg}`));
@@ -710,6 +733,10 @@ class OAuthWindowManager {
       clearInterval(this.popupCheckInterval);
       this.popupCheckInterval = null;
     }
+    if (this.popupCheckTimeout) {
+      clearTimeout(this.popupCheckTimeout);
+      this.popupCheckTimeout = null;
+    }
   }
   close() {
     this.cleanup();

package/dist/server.js

@@ -296,7 +296,8 @@ function createNextOAuthHandler(config) {
     createRoutes() {
       return {
         async POST(req, context) {
-          const action = context.params.action;
+          const params = context.params instanceof Promise ? await context.params : context.params;
+          const action = params.action;
           if (action === "authorize") {
             return handlers.authorize(req);
           }
@@ -306,7 +307,8 @@ function createNextOAuthHandler(config) {
           return Response.json({ error: `Unknown action: ${action}` }, { status: 404 });
         },
         async GET(req, context) {
-          const action = context.params.action;
+          const params = context.params instanceof Promise ? await context.params : context.params;
+          const action = params.action;
           if (action === "status") {
             return handlers.status(req);
           }
@@ -596,6 +598,7 @@ function isBrowser() {
 class OAuthWindowManager {
   popupWindow = null;
   popupCheckInterval = null;
+  popupCheckTimeout = null;
   openPopup(url, options) {
     if (!isBrowser()) {
       throw new Error("OAuthWindowManager.openPopup() can only be used in browser environments");
@@ -651,6 +654,10 @@ class OAuthWindowManager {
       const messageHandler = (event) => {
         if (event.data && event.data.type === "oauth_callback") {
           clearTimeout(timeout);
+          if (this.popupCheckTimeout) {
+            clearTimeout(this.popupCheckTimeout);
+            this.popupCheckTimeout = null;
+          }
           window.removeEventListener("message", messageHandler);
           const { code, state, error } = event.data;
           if (error) {
@@ -668,15 +675,18 @@ class OAuthWindowManager {
         }
       };
       window.addEventListener("message", messageHandler);
-      this.popupCheckInterval = setInterval(() => {
-        if (this.popupWindow?.closed) {
-          clearTimeout(timeout);
-          clearInterval(this.popupCheckInterval);
-          window.removeEventListener("message", messageHandler);
-          this.cleanup();
-          reject(new Error("OAuth popup was closed by user"));
-        }
-      }, 500);
+      this.popupCheckTimeout = setTimeout(() => {
+        this.popupCheckTimeout = null;
+        this.popupCheckInterval = setInterval(() => {
+          if (this.popupWindow?.closed) {
+            clearTimeout(timeout);
+            clearInterval(this.popupCheckInterval);
+            window.removeEventListener("message", messageHandler);
+            this.cleanup();
+            reject(new Error("OAuth popup was closed by user"));
+          }
+        }, 500);
+      }, 2000);
     });
   }
   listenForRedirectCallback() {
@@ -685,10 +695,23 @@ class OAuthWindowManager {
     }
     return new Promise((resolve, reject) => {
       const params = new URLSearchParams(window.location.search);
-      const code = params.get("code");
-      const state = params.get("state");
-      const error = params.get("error");
-      const errorDescription = params.get("error_description");
+      let code = params.get("code");
+      let state = params.get("state");
+      let error = params.get("error");
+      let errorDescription = params.get("error_description");
+      if (!code && !error) {
+        try {
+          const stored = sessionStorage.getItem("oauth_callback_params");
+          if (stored) {
+            const parsed = JSON.parse(stored);
+            code = parsed.code;
+            state = parsed.state;
+            sessionStorage.removeItem("oauth_callback_params");
+          }
+        } catch (e) {
+          console.error("Failed to parse OAuth callback params from sessionStorage:", e);
+        }
+      }
       if (error) {
         const errorMsg = errorDescription || error;
         reject(new Error(`OAuth error: ${errorMsg}`));
@@ -710,6 +733,10 @@ class OAuthWindowManager {
       clearInterval(this.popupCheckInterval);
       this.popupCheckInterval = null;
     }
+    if (this.popupCheckTimeout) {
+      clearTimeout(this.popupCheckTimeout);
+      this.popupCheckTimeout = null;
+    }
   }
   close() {
     this.cleanup();

package/dist/src/adapters/nextjs-callback.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Next.js OAuth Callback Handler
+ * Provides a pre-built OAuth callback page component for Next.js App Router
+ *
+ * This eliminates the need for users to manually create callback pages.
+ */
+import type { OAuthCallbackHandlerConfig } from '../oauth/types.js';
+/**
+ * OAuth Callback Page Component
+ *
+ * This component:
+ * 1. Extracts OAuth callback parameters (code, state, error) from URL
+ * 2. Sends them to the opener window (for popup mode) via postMessage
+ * 3. Stores them in sessionStorage (for redirect mode)
+ * 4. Redirects to the configured URL
+ *
+ * @param config - Callback handler configuration
+ *
+ * @example
+ * ```tsx
+ * // app/oauth/callback/page.tsx
+ * import { OAuthCallbackPage } from 'integrate-sdk/oauth-callback';
+ *
+ * export default function CallbackPage() {
+ *   return <OAuthCallbackPage redirectUrl="/dashboard" />;
+ * }
+ * ```
+ */
+export declare function OAuthCallbackPage(config?: OAuthCallbackHandlerConfig): import("react/jsx-runtime").JSX.Element;
+/**
+ * Create a default export wrapper for easier usage
+ *
+ * @example
+ * ```tsx
+ * // app/oauth/callback/page.tsx
+ * import { createOAuthCallbackPage } from 'integrate-sdk/oauth-callback';
+ *
+ * export default createOAuthCallbackPage({
+ *   redirectUrl: '/dashboard',
+ * });
+ * ```
+ */
+export declare function createOAuthCallbackPage(config?: OAuthCallbackHandlerConfig): () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=nextjs-callback.d.ts.map

package/dist/src/adapters/nextjs-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-callback.d.ts","sourceRoot":"","sources":["../../../src/adapters/nextjs-callback.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,0BAA0B,2CA2GpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,0BAA0B,iDAI1E"}

package/dist/src/adapters/nextjs.d.ts

@@ -207,7 +207,9 @@ export declare function createNextOAuthHandler(config: OAuthHandlerConfig): {
         POST(req: NextRequest, context: {
             params: {
                 action: string;
-            };
+            } | Promise<{
+                action: string;
+            }>;
         }): Promise<NextResponse>;
         /**
          * GET handler for status action
@@ -215,7 +217,9 @@ export declare function createNextOAuthHandler(config: OAuthHandlerConfig): {
         GET(req: NextRequest, context: {
             params: {
                 action: string;
-            };
+            } | Promise<{
+                action: string;
+            }>;
         }): Promise<NextResponse>;
     };
 };

package/dist/src/adapters/nextjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../../src/adapters/nextjs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,KAAK,YAAY,GAAG,GAAG,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB;IAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;mBACkB,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAcxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;kBACiB,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAcvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;gBACe,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8BrD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;QAGC;;WAEG;kBAEI,WAAW,WACP;YAAE,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GACtC,OAAO,CAAC,YAAY,CAAC;QAiBxB;;WAEG;iBAEI,WAAW,WACP;YAAE,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GACtC,OAAO,CAAC,YAAY,CAAC;;EAiB/B"}
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../../src/adapters/nextjs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,KAAK,YAAY,GAAG,GAAG,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB;IAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;mBACkB,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAcxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;kBACiB,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAcvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;gBACe,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8BrD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;QAGC;;WAEG;kBAEI,WAAW,WACP;YAAE,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,GACpE,OAAO,CAAC,YAAY,CAAC;QAmBxB;;WAEG;iBAEI,WAAW,WACP;YAAE,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,GACpE,OAAO,CAAC,YAAY,CAAC;;EAmB/B"}

package/dist/src/index.d.ts

@@ -7,7 +7,7 @@ export type { ToolInvocationOptions } from "./client.js";
 export { OAuthManager } from "./oauth/manager.js";
 export { OAuthWindowManager, sendCallbackToOpener } from "./oauth/window-manager.js";
 export { generateCodeVerifier, generateCodeChallenge, generateState } from "./oauth/pkce.js";
-export type { OAuthFlowConfig, PopupOptions, AuthStatus, PendingAuth, AuthorizationUrlResponse, OAuthCallbackResponse, OAuthCallbackParams, } from "./oauth/types.js";
+export type { OAuthFlowConfig, PopupOptions, AuthStatus, PendingAuth, AuthorizationUrlResponse, OAuthCallbackResponse, OAuthCallbackParams, OAuthCallbackHandlerConfig, } from "./oauth/types.js";
 export { OAuthHandler } from "./adapters/base-handler.js";
 export type { OAuthHandlerConfig, AuthorizeRequest, AuthorizeResponse, CallbackRequest, CallbackResponse, StatusResponse, } from "./adapters/base-handler.js";
 export { createNextOAuthHandler } from "./adapters/nextjs.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG1E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,YAAY,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,cAAc,EACd,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG1E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,YAAY,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,cAAc,EACd,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC"}

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

@@ -81,4 +81,13 @@ export interface OAuthCallbackParams {
     /** State parameter for CSRF protection */
     state: string;
 }
+/**
+ * Configuration for OAuth callback route handler
+ */
+export interface OAuthCallbackHandlerConfig {
+    /** URL to redirect to after successful OAuth (default: '/') */
+    redirectUrl?: string;
+    /** URL to redirect to on OAuth error (default: '/auth-error') */
+    errorRedirectUrl?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/src/oauth/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/oauth/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,oDAAoD;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/oauth/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,oDAAoD;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/src/oauth/window-manager.d.ts

@@ -13,6 +13,7 @@ import type { PopupOptions, OAuthCallbackParams } from "./types.js";
 export declare class OAuthWindowManager {
     private popupWindow;
     private popupCheckInterval;
+    private popupCheckTimeout;
     /**
      * Open OAuth authorization in a popup window
      *
@@ -63,7 +64,7 @@ export declare class OAuthWindowManager {
      */
     private listenForPopupCallback;
     /**
-     * Parse callback parameters from current URL (for redirect flow)
+     * Parse callback parameters from current URL or sessionStorage (for redirect flow)
      */
     private listenForRedirectCallback;
     /**

package/dist/src/oauth/window-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window-manager.d.ts","sourceRoot":"","sources":["../../../src/oauth/window-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASpE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,kBAAkB,CAA+C;IAEzE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAwC7D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CACf,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAQ/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuD9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;OAEG;IACH,OAAO,CAAC,OAAO;IAYf;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,IAAI,CAwBP"}
+{"version":3,"file":"window-manager.d.ts","sourceRoot":"","sources":["../../../src/oauth/window-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASpE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,kBAAkB,CAA+C;IACzE,OAAO,CAAC,iBAAiB,CAA8C;IAEvE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAwC7D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CACf,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAQ/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkE9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA6CjC;;OAEG;IACH,OAAO,CAAC,OAAO;IAiBf;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,IAAI,CAwBP"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.3.3",
+  "version": "0.3.7",
   "description": "Type-safe TypeScript SDK for MCP Client with plugin-based OAuth provider configuration",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,16 +26,21 @@
     "./oauth": {
       "import": "./dist/oauth.js",
       "types": "./dist/oauth.d.ts"
+    },
+    "./oauth-callback": {
+      "import": "./src/adapters/nextjs-callback.tsx",
+      "types": "./dist/adapters/nextjs-callback.d.ts"
     }
   },
   "files": [
     "dist",
+    "src",
     "index.ts",
     "server.ts",
     "oauth.ts"
   ],
   "scripts": {
-    "build": "bun build index.ts server.ts oauth.ts --outdir dist --target node --format esm && bun run build:types",
+    "build": "bun build index.ts server.ts oauth.ts --outdir dist --target node --format esm --external react --external react/jsx-runtime && bun run build:types",
     "build:types": "tsc --emitDeclarationOnly --declaration --declarationMap",
     "dev": "bun --watch src/index.ts",
     "type-check": "tsc --noEmit",
@@ -58,11 +63,18 @@
   "license": "MIT",
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/react": "^18.0.0",
     "simple-git-hooks": "^2.13.1",
     "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   },
   "simple-git-hooks": {
     "pre-commit": "./scripts/check-version.sh"

package/src/adapters/auto-routes.ts

@@ -0,0 +1,217 @@
+/**
+ * Auto-generated OAuth Routes
+ * Automatically creates the correct route handlers based on framework detection
+ */
+
+import { OAuthHandler, type OAuthHandlerConfig } from './base-handler.js';
+
+/**
+ * Global OAuth configuration
+ * Set by createMCPClient when oauthConfig is provided
+ */
+let globalOAuthConfig: OAuthHandlerConfig | null = null;
+
+/**
+ * Set the global OAuth configuration
+ * Called internally by createMCPClient
+ */
+export function setGlobalOAuthConfig(config: OAuthHandlerConfig): void {
+  globalOAuthConfig = config;
+}
+
+/**
+ * Get the global OAuth configuration
+ */
+export function getGlobalOAuthConfig(): OAuthHandlerConfig | null {
+  return globalOAuthConfig;
+}
+
+/**
+ * Universal OAuth route handler
+ * Automatically detects framework and handles all OAuth actions
+ * 
+ * This is the magic function that makes everything "just work"
+ * 
+ * @example
+ * ```typescript
+ * // app/api/integrate/oauth/[action]/route.ts (Next.js)
+ * export * from 'integrate-sdk/oauth';
+ * ```
+ * 
+ * @example
+ * ```typescript
+ * // app/routes/api/integrate/oauth/[action].ts (TanStack Start)
+ * export * from 'integrate-sdk/oauth';
+ * ```
+ */
+
+// Framework detection helpers (unused but kept for future enhancements)
+// function isNextJS(request: any): boolean {
+//   return (
+//     request?.constructor?.name === 'NextRequest' ||
+//     typeof request?.nextUrl !== 'undefined' ||
+//     typeof (globalThis as any).NextResponse !== 'undefined'
+//   );
+// }
+
+// function isTanStackStart(request: any): boolean {
+//   return (
+//     request instanceof Request &&
+//     !isNextJS(request)
+//   );
+// }
+
+/**
+ * Universal POST handler
+ * Handles authorize and callback actions
+ */
+export async function POST(
+  req: any,
+  context?: { params: { action: string } }
+): Promise<any> {
+  if (!globalOAuthConfig) {
+    throw new Error(
+      'OAuth configuration not found. Did you configure oauthProviders in createMCPClient?'
+    );
+  }
+
+  const handler = new OAuthHandler(globalOAuthConfig);
+  const action = context?.params?.action;
+
+  if (!action) {
+    return createErrorResponse('Missing action parameter', 400);
+  }
+
+  try {
+    if (action === 'authorize') {
+      const body = await parseRequestBody(req);
+      const result = await handler.handleAuthorize(body);
+      return createSuccessResponse(result);
+    }
+
+    if (action === 'callback') {
+      const body = await parseRequestBody(req);
+      const result = await handler.handleCallback(body);
+      return createSuccessResponse(result);
+    }
+
+    return createErrorResponse(`Unknown action: ${action}`, 404);
+  } catch (error: any) {
+    console.error(`[OAuth ${action}] Error:`, error);
+    return createErrorResponse(error.message, 500);
+  }
+}
+
+/**
+ * Universal GET handler
+ * Handles status action
+ */
+export async function GET(
+  req: any,
+  context?: { params: { action: string } }
+): Promise<any> {
+  if (!globalOAuthConfig) {
+    throw new Error(
+      'OAuth configuration not found. Did you configure oauthProviders in createMCPClient?'
+    );
+  }
+
+  const handler = new OAuthHandler(globalOAuthConfig);
+  const action = context?.params?.action;
+
+  if (!action) {
+    return createErrorResponse('Missing action parameter', 400);
+  }
+
+  try {
+    if (action === 'status') {
+      const { provider, sessionToken } = parseQueryParams(req);
+
+      if (!provider || !sessionToken) {
+        return createErrorResponse(
+          'Missing provider or session token',
+          400
+        );
+      }
+
+      const result = await handler.handleStatus(provider, sessionToken);
+      return createSuccessResponse(result);
+    }
+
+    return createErrorResponse(`Unknown action: ${action}`, 404);
+  } catch (error: any) {
+    console.error(`[OAuth ${action}] Error:`, error);
+    return createErrorResponse(error.message, 500);
+  }
+}
+
+/**
+ * Parse request body (works for both Next.js and standard Request)
+ */
+async function parseRequestBody(req: any): Promise<any> {
+  if (typeof req.json === 'function') {
+    return await req.json();
+  }
+  throw new Error('Unable to parse request body');
+}
+
+/**
+ * Parse query parameters (works for both Next.js and standard Request)
+ */
+function parseQueryParams(req: any): { provider?: string; sessionToken?: string } {
+  let url: URL;
+
+  // Next.js
+  if (req.nextUrl) {
+    url = new URL(req.nextUrl);
+  }
+  // Standard Request
+  else if (req.url) {
+    url = new URL(req.url);
+  } else {
+    return {};
+  }
+
+  const provider = url.searchParams.get('provider') || undefined;
+  const sessionToken = req.headers?.get?.('x-session-token') || undefined;
+
+  return { provider, sessionToken };
+}
+
+/**
+ * Create success response (works for both frameworks)
+ */
+function createSuccessResponse(data: any): any {
+  // Try Next.js first
+  if (typeof (globalThis as any).NextResponse !== 'undefined') {
+    const NextResponse = (globalThis as any).NextResponse;
+    return NextResponse.json(data);
+  }
+
+  // Fallback to standard Response
+  return new Response(JSON.stringify(data), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' },
+  });
+}
+
+/**
+ * Create error response (works for both frameworks)
+ */
+function createErrorResponse(message: string, status: number): any {
+  // Try Next.js first
+  if (typeof (globalThis as any).NextResponse !== 'undefined') {
+    const NextResponse = (globalThis as any).NextResponse;
+    return NextResponse.json({ error: message }, { status });
+  }
+
+  // Fallback to standard Response
+  return new Response(
+    JSON.stringify({ error: message }),
+    {
+      status,
+      headers: { 'Content-Type': 'application/json' },
+    }
+  );
+}
+