integrate-sdk 0.8.39 → 0.8.41-dev.0

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

@@ -1,106 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,87 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,70 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}