integrate-sdk 0.8.42-dev.0 → 0.8.42

package/dist/src/plugins/gmail-client.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Gmail Plugin Client Types
+ * Fully typed interface for Gmail plugin methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Gmail Email Message
+ */
+export interface GmailMessage {
+    id: string;
+    threadId: string;
+    labelIds?: string[];
+    snippet?: string;
+    payload?: {
+        headers?: Array<{
+            name: string;
+            value: string;
+        }>;
+        body?: {
+            data?: string;
+            size?: number;
+        };
+        parts?: Array<{
+            mimeType?: string;
+            body?: {
+                data?: string;
+                size?: number;
+            };
+        }>;
+    };
+    sizeEstimate?: number;
+    historyId?: string;
+    internalDate?: string;
+}
+/**
+ * Gmail Label
+ */
+export interface GmailLabel {
+    id: string;
+    name: string;
+    type?: "system" | "user";
+    messageListVisibility?: "show" | "hide";
+    labelListVisibility?: "labelShow" | "labelShowIfUnread" | "labelHide";
+    color?: {
+        textColor?: string;
+        backgroundColor?: string;
+    };
+}
+/**
+ * Gmail Draft
+ */
+export interface GmailDraft {
+    id: string;
+    message: GmailMessage;
+}
+/**
+ * Gmail Plugin Client Interface
+ * Provides type-safe methods for all Gmail operations
+ */
+export interface GmailPluginClient {
+    /**
+     * Send a message
+     */
+    sendMessage(params: {
+        to: string | string[];
+        subject: string;
+        body: string;
+        cc?: string | string[];
+        bcc?: string | string[];
+        from?: string;
+        replyTo?: string;
+        html?: boolean;
+        attachments?: Array<{
+            filename: string;
+            content: string;
+            encoding?: string;
+        }>;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List messages in the mailbox
+     */
+    listMessages(params?: {
+        maxResults?: number;
+        pageToken?: string;
+        q?: string;
+        labelIds?: string[];
+        includeSpamTrash?: boolean;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific message by ID
+     */
+    getMessage(params: {
+        id: string;
+        format?: "minimal" | "full" | "raw" | "metadata";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Search messages with query
+     */
+    searchMessages(params: {
+        query: string;
+        maxResults?: number;
+        pageToken?: string;
+        includeSpamTrash?: boolean;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=gmail-client.d.ts.map

package/dist/src/plugins/gmail-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/gmail-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;QACH,IAAI,CAAC,EAAE;YACL,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,IAAI,CAAC,EAAE;gBACL,IAAI,CAAC,EAAE,MAAM,CAAC;gBACd,IAAI,CAAC,EAAE,MAAM,CAAC;aACf,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,mBAAmB,CAAC,EAAE,WAAW,GAAG,mBAAmB,GAAG,WAAW,CAAC;IACtE,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,WAAW,CAAC,EAAE,KAAK,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;KACJ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjC;;OAEG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;KAClD,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClC"}

package/dist/src/plugins/gmail.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Gmail Plugin
+ * Enables Gmail tools with OAuth configuration
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * Gmail plugin configuration
+ *
+ * SERVER-SIDE: Automatically reads GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from environment.
+ * You can override by providing explicit clientId and clientSecret values.
+ * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
+ */
+export interface GmailPluginConfig {
+    /** Google OAuth client ID (defaults to GMAIL_CLIENT_ID env var) */
+    clientId?: string;
+    /** Google OAuth client secret (defaults to GMAIL_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: Gmail API scopes) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default Gmail tools that this plugin enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const GMAIL_TOOLS: readonly ["gmail_send_message", "gmail_list_messages", "gmail_get_message", "gmail_search_messages"];
+/**
+ * Gmail Plugin
+ *
+ * Enables Gmail integration with OAuth authentication.
+ *
+ * By default, reads GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from environment variables.
+ * You can override these by providing explicit values in the config.
+ *
+ * @example Server-side (minimal - uses env vars):
+ * ```typescript
+ * import { createMCPServer, gmailPlugin } from 'integrate-sdk/server';
+ *
+ * // Automatically uses GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from env
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     gmailPlugin({
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Server-side (with explicit override):
+ * ```typescript
+ * import { createMCPServer, gmailPlugin } from 'integrate-sdk/server';
+ *
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     gmailPlugin({
+ *       clientId: process.env.CUSTOM_GMAIL_ID!,
+ *       clientSecret: process.env.CUSTOM_GMAIL_SECRET!,
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Client-side (without secrets):
+ * ```typescript
+ * import { createMCPClient, gmailPlugin } from 'integrate-sdk';
+ *
+ * const client = createMCPClient({
+ *   plugins: [
+ *     gmailPlugin({
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function gmailPlugin(config?: GmailPluginConfig): MCPPlugin;
+/**
+ * Export tool names for type inference
+ */
+export type GmailTools = typeof GMAIL_TOOLS[number];
+/**
+ * Export Gmail client types
+ */
+export type { GmailPluginClient } from "./gmail-client.js";
+//# sourceMappingURL=gmail.d.ts.map

package/dist/src/plugins/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../src/plugins/gmail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,sGAKP,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,iBAAsB,GAAG,SAAS,CA4BrE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/plugins/server-client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server Plugin Client Types
+ * Fully typed interface for server-level tools that don't belong to a specific plugin
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Server Plugin Client Interface
+ * Provides type-safe methods for server-level operations
+ */
+export interface ServerPluginClient {
+    /**
+     * List all tools available for a specific integration
+     */
+    listToolsByIntegration(params: {
+        integration: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=server-client.d.ts.map

package/dist/src/plugins/server-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/server-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Plugin System Types
+ * Inspired by BetterAuth's provider pattern
+ */
+import type { MCPClient } from "../client.js";
+/**
+ * OAuth Configuration for a plugin
+ *
+ * CLIENT-SIDE: You no longer need to provide clientId/clientSecret in the browser.
+ * These should be kept server-side in your OAuth API routes for security.
+ *
+ * SERVER-SIDE: OAuth credentials are provided via API route configuration
+ * using createNextOAuthHandler() or createTanStackOAuthHandler().
+ */
+export interface OAuthConfig {
+    /** OAuth provider identifier (e.g., 'github', 'google') */
+    provider: string;
+    /**
+     * OAuth client ID (optional - only needed for legacy direct MCP server calls)
+     * @deprecated Keep client ID server-side in OAuth API route configuration
+     */
+    clientId?: string | undefined;
+    /**
+     * OAuth client secret (optional - only needed for legacy direct MCP server calls)
+     * @deprecated Keep client secret server-side in OAuth API route configuration
+     */
+    clientSecret?: string | undefined;
+    /** Required OAuth scopes */
+    scopes: string[];
+    /** Redirect URI for OAuth flow */
+    redirectUri?: string;
+    /** Provider-specific configuration */
+    config?: unknown;
+}
+/**
+ * MCP Plugin Interface
+ *
+ * Plugins enable specific tools and configure OAuth providers
+ */
+export interface MCPPlugin {
+    /** Unique plugin identifier */
+    id: string;
+    /** List of tool names this plugin enables */
+    tools: string[];
+    /** OAuth configuration for this plugin */
+    oauth?: OAuthConfig;
+    /** Called when the plugin is initialized with the client */
+    onInit?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called before the client connects to the server */
+    onBeforeConnect?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called after the client successfully connects */
+    onAfterConnect?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called when the client disconnects */
+    onDisconnect?: (client: MCPClient<any>) => Promise<void> | void;
+}
+/**
+ * Helper type to extract plugin IDs from an array of plugins
+ */
+export type ExtractPluginIds<T extends readonly MCPPlugin[]> = T[number]["id"];
+/**
+ * Helper type to extract tools from an array of plugins
+ */
+export type ExtractPluginTools<T extends readonly MCPPlugin[]> = T[number]["tools"][number];
+/**
+ * Type guard to check if a plugin has OAuth configuration
+ */
+export declare function hasOAuthConfig(plugin: MCPPlugin): plugin is MCPPlugin & {
+    oauth: OAuthConfig;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE1D,sDAAsD;IACtD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnE,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElE,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,GAChB,MAAM,IAAI,SAAS,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAE9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.8.42-dev.0",
+  "version": "0.8.42",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",
@@ -126,4 +126,4 @@
   "simple-git-hooks": {
     "pre-commit": "./scripts/check-version.sh"
   }
-}
+}