integrate-sdk 0.7.24 → 0.7.26

package/dist/adapters/auto-routes.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Auto-generated OAuth Routes
+ * Automatically creates the correct route handlers based on framework detection
+ */
+import { type OAuthHandlerConfig } from './base-handler.js';
+/**
+ * Set the global OAuth configuration
+ * Called internally by createMCPClient
+ */
+export declare function setGlobalOAuthConfig(config: OAuthHandlerConfig): void;
+/**
+ * Get the global OAuth configuration
+ */
+export declare function getGlobalOAuthConfig(): OAuthHandlerConfig | null;
+/**
+ * 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';
+ * ```
+ */
+/**
+ * Universal POST handler
+ * Handles authorize, callback, and disconnect actions
+ */
+export declare function POST(req: any, context?: {
+    params: {
+        action: string;
+    };
+}): Promise<any>;
+/**
+ * Universal GET handler
+ * Handles status action
+ */
+export declare function GET(req: any, context?: {
+    params: {
+        action: string;
+    };
+}): Promise<any>;
+//# sourceMappingURL=auto-routes.d.ts.map

package/dist/adapters/auto-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-routes.d.ts","sourceRoot":"","sources":["../../../src/adapters/auto-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQ1E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,GAAG,IAAI,CAEhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AAkBH;;;GAGG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvC,OAAO,CAAC,GAAG,CAAC,CAgDd;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvC,OAAO,CAAC,GAAG,CAAC,CAoCd"}

package/dist/adapters/auto-routes.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
-// src/adapters/base-handler.ts
+// base-handler.ts
 class OAuthHandler {
   config;
   serverUrl;
@@ -175,7 +175,7 @@ class OAuthHandler {
 }
 var MCP_SERVER_URL = "https://mcp.integrate.dev/api/v1/mcp";
 
-// src/adapters/auto-routes.ts
+// auto-routes.ts
 var globalOAuthConfig = null;
 function setGlobalOAuthConfig(config) {
   globalOAuthConfig = config;

package/dist/adapters/base-handler.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Base OAuth Handler
+ * Framework-agnostic OAuth route logic for secure server-side token management
+ */
+/**
+ * OAuth handler configuration
+ * OAuth credentials for each provider
+ */
+export interface OAuthHandlerConfig {
+    /** OAuth configurations by provider */
+    providers: Record<string, {
+        /** OAuth client ID from environment variables */
+        clientId: string;
+        /** OAuth client secret from environment variables */
+        clientSecret: string;
+        /** Optional redirect URI override */
+        redirectUri?: string;
+    }>;
+    /**
+     * MCP Server URL
+     * @default 'https://mcp.integrate.dev/api/v1/mcp'
+     */
+    serverUrl?: string;
+    /**
+     * API Key for authentication and usage tracking (SERVER-SIDE ONLY)
+     * Sent as X-API-KEY header with all OAuth requests to the MCP server
+     */
+    apiKey?: string;
+}
+/**
+ * Request body for authorize endpoint
+ */
+export interface AuthorizeRequest {
+    provider: string;
+    scopes: string[];
+    state: string;
+    codeChallenge: string;
+    codeChallengeMethod: string;
+    redirectUri?: string;
+}
+/**
+ * Response from authorize endpoint
+ */
+export interface AuthorizeResponse {
+    authorizationUrl: string;
+}
+/**
+ * Request body for callback endpoint
+ */
+export interface CallbackRequest {
+    provider: string;
+    code: string;
+    codeVerifier: string;
+    state: string;
+}
+/**
+ * Response from callback endpoint
+ */
+export interface CallbackResponse {
+    accessToken: string;
+    refreshToken?: string;
+    tokenType: string;
+    expiresIn: number;
+    expiresAt?: string;
+    scopes?: string[];
+}
+/**
+ * Response from status endpoint
+ */
+export interface StatusResponse {
+    authorized: boolean;
+    scopes?: string[];
+    expiresAt?: string;
+}
+/**
+ * Request body for disconnect endpoint
+ */
+export interface DisconnectRequest {
+    provider: string;
+}
+/**
+ * Response from disconnect endpoint
+ */
+export interface DisconnectResponse {
+    success: boolean;
+    provider: string;
+}
+/**
+ * Request body for MCP tool call endpoint
+ */
+export interface ToolCallRequest {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+/**
+ * Response from MCP tool call endpoint
+ * Matches MCPToolCallResponse structure
+ */
+export interface ToolCallResponse {
+    content: Array<{
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: string;
+        mimeType?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * OAuth Handler
+ * Handles OAuth authorization flows by proxying requests to MCP server
+ * with server-side OAuth credentials from environment variables
+ */
+export declare class OAuthHandler {
+    private config;
+    private readonly serverUrl;
+    private readonly apiKey?;
+    constructor(config: OAuthHandlerConfig);
+    /**
+     * Get headers with API key if configured
+     */
+    private getHeaders;
+    /**
+     * Handle authorization URL request
+     * Gets authorization URL from MCP server with full OAuth credentials
+     *
+     * @param request - Authorization request from client
+     * @returns Authorization URL to redirect/open for user
+     *
+     * @throws Error if provider is not configured
+     * @throws Error if MCP server request fails
+     */
+    handleAuthorize(request: AuthorizeRequest): Promise<AuthorizeResponse>;
+    /**
+     * Handle OAuth callback
+     * Exchanges authorization code for access token
+     *
+     * @param request - Callback request with authorization code
+     * @returns Access token and authorization details
+     *
+     * @throws Error if provider is not configured
+     * @throws Error if MCP server request fails
+     */
+    handleCallback(request: CallbackRequest): Promise<CallbackResponse>;
+    /**
+     * Handle authorization status check
+     * Checks if a provider access token is valid
+     *
+     * @param provider - Provider to check
+     * @param accessToken - Access token from client
+     * @returns Authorization status
+     *
+     * @throws Error if MCP server request fails
+     */
+    handleStatus(provider: string, accessToken: string): Promise<StatusResponse>;
+    /**
+     * Handle provider disconnection
+     * Revokes authorization for a specific provider
+     *
+     * @param request - Disconnect request with provider name
+     * @param accessToken - Access token from client
+     * @returns Disconnect response
+     *
+     * @throws Error if no access token provided
+     * @throws Error if MCP server request fails
+     */
+    handleDisconnect(request: DisconnectRequest, accessToken: string): Promise<DisconnectResponse>;
+    /**
+     * Handle MCP tool call
+     * Forwards tool call requests to MCP server with API key and provider token
+     *
+     * @param request - Tool call request with name and arguments
+     * @param authHeader - Authorization header from client (Bearer token)
+     * @returns Tool call response
+     *
+     * @throws Error if MCP server request fails
+     */
+    handleToolCall(request: ToolCallRequest, authHeader: string | null): Promise<ToolCallResponse>;
+}
+//# sourceMappingURL=base-handler.d.ts.map

package/dist/adapters/base-handler.d.ts.map

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

package/dist/adapters/base-handler.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
-// src/adapters/base-handler.ts
+// base-handler.ts
 class OAuthHandler {
   config;
   serverUrl;

package/dist/adapters/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapters for various frameworks
+ *
+ * Re-exports all adapter modules for convenient access
+ */
+export * from "./nextjs.js";
+export * from "./node.js";
+export * from "./solid-start.js";
+export * from "./svelte-kit.js";
+export * from "./tanstack-start.js";
+export * from "./base-handler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}