integrate-sdk 0.8.29-dev.0 → 0.8.31-dev.0

package/dist/src/integrations/onedrive-client.d.ts

@@ -0,0 +1,338 @@
+/**
+ * OneDrive Integration Client Types
+ * Fully typed interface for OneDrive integration methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * OneDrive Drive Item
+ */
+export interface OneDriveDriveItem {
+    id: string;
+    name: string;
+    createdDateTime: string;
+    lastModifiedDateTime: string;
+    size?: number;
+    webUrl: string;
+    createdBy?: {
+        user?: {
+            displayName: string;
+            email?: string;
+        };
+    };
+    lastModifiedBy?: {
+        user?: {
+            displayName: string;
+            email?: string;
+        };
+    };
+    parentReference?: {
+        driveId: string;
+        driveType: string;
+        id: string;
+        path: string;
+    };
+    file?: {
+        mimeType: string;
+        hashes?: {
+            quickXorHash?: string;
+            sha1Hash?: string;
+        };
+    };
+    folder?: {
+        childCount: number;
+    };
+    fileSystemInfo?: {
+        createdDateTime: string;
+        lastModifiedDateTime: string;
+    };
+}
+/**
+ * OneDrive Permission
+ */
+export interface OneDrivePermission {
+    id: string;
+    roles: string[];
+    link?: {
+        type: "view" | "edit" | "embed";
+        scope: "anonymous" | "organization";
+        webUrl: string;
+    };
+    grantedTo?: {
+        user?: {
+            displayName: string;
+            email?: string;
+            id: string;
+        };
+    };
+    grantedToIdentities?: Array<{
+        user?: {
+            displayName: string;
+            email?: string;
+            id: string;
+        };
+    }>;
+    shareId?: string;
+}
+/**
+ * OneDrive Word Document Content
+ */
+export interface OneDriveWordContent {
+    content: string;
+    contentType: "text" | "html";
+}
+/**
+ * OneDrive Excel Worksheet
+ */
+export interface OneDriveExcelWorksheet {
+    id: string;
+    name: string;
+    position: number;
+    visibility: "visible" | "hidden" | "veryHidden";
+}
+/**
+ * OneDrive Excel Range
+ */
+export interface OneDriveExcelRange {
+    address: string;
+    addressLocal: string;
+    cellCount: number;
+    columnCount: number;
+    rowCount: number;
+    columnIndex: number;
+    rowIndex: number;
+    text?: string[][];
+    values?: any[][];
+    formulas?: string[][];
+    numberFormat?: string[][];
+}
+/**
+ * OneDrive PowerPoint Slide
+ */
+export interface OneDrivePowerPointSlide {
+    id: string;
+    slideIndex: number;
+}
+/**
+ * OneDrive Integration Client Interface
+ * Provides type-safe methods for all OneDrive operations
+ */
+export interface OneDriveIntegrationClient {
+    /**
+     * List files in a folder
+     *
+     * @example
+     * ```typescript
+     * const files = await client.onedrive.listFiles({
+     *   folder_id: "root",
+     *   order_by: "lastModifiedDateTime desc"
+     * });
+     * ```
+     */
+    listFiles(params?: {
+        /** Folder ID (default: "root") */
+        folder_id?: string;
+        /** Filter query */
+        filter?: string;
+        /** Order by field */
+        order_by?: string;
+        /** Number of items to return */
+        top?: number;
+        /** Number of items to skip */
+        skip?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get file metadata
+     *
+     * @example
+     * ```typescript
+     * const file = await client.onedrive.getFile({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF"
+     * });
+     * ```
+     */
+    getFile(params: {
+        /** File ID */
+        file_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Download file content
+     *
+     * @example
+     * ```typescript
+     * const content = await client.onedrive.downloadFile({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF"
+     * });
+     * ```
+     */
+    downloadFile(params: {
+        /** File ID */
+        file_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Upload a file
+     *
+     * @example
+     * ```typescript
+     * const file = await client.onedrive.uploadFile({
+     *   folder_id: "root",
+     *   file_name: "document.txt",
+     *   content: "Hello, World!",
+     *   conflict_behavior: "rename"
+     * });
+     * ```
+     */
+    uploadFile(params: {
+        /** Parent folder ID (default: "root") */
+        folder_id?: string;
+        /** File name */
+        file_name: string;
+        /** File content (base64 encoded for binary files) */
+        content: string;
+        /** Conflict behavior */
+        conflict_behavior?: "rename" | "replace" | "fail";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Delete a file
+     *
+     * @example
+     * ```typescript
+     * await client.onedrive.deleteFile({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF"
+     * });
+     * ```
+     */
+    deleteFile(params: {
+        /** File ID */
+        file_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Search for files
+     *
+     * @example
+     * ```typescript
+     * const results = await client.onedrive.searchFiles({
+     *   query: "presentation",
+     *   top: 20
+     * });
+     * ```
+     */
+    searchFiles(params: {
+        /** Search query */
+        query: string;
+        /** Number of items to return */
+        top?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Create a sharing link
+     *
+     * @example
+     * ```typescript
+     * const permission = await client.onedrive.shareFile({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF",
+     *   type: "view",
+     *   scope: "anonymous"
+     * });
+     * ```
+     */
+    shareFile(params: {
+        /** File ID */
+        file_id: string;
+        /** Link type */
+        type: "view" | "edit" | "embed";
+        /** Link scope */
+        scope: "anonymous" | "organization";
+        /** Expiration date (ISO 8601) */
+        expiration_date_time?: string;
+        /** Password protection */
+        password?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get Word document content
+     *
+     * @example
+     * ```typescript
+     * const content = await client.onedrive.wordGetContent({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF",
+     *   format: "text"
+     * });
+     * ```
+     */
+    wordGetContent(params: {
+        /** Word document file ID */
+        file_id: string;
+        /** Content format */
+        format?: "text" | "html";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get Excel worksheets
+     *
+     * @example
+     * ```typescript
+     * const worksheets = await client.onedrive.excelGetWorksheets({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF"
+     * });
+     * ```
+     */
+    excelGetWorksheets(params: {
+        /** Excel file ID */
+        file_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get Excel range data
+     *
+     * @example
+     * ```typescript
+     * const range = await client.onedrive.excelGetRange({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF",
+     *   worksheet_name: "Sheet1",
+     *   range_address: "A1:B10"
+     * });
+     * ```
+     */
+    excelGetRange(params: {
+        /** Excel file ID */
+        file_id: string;
+        /** Worksheet name or ID */
+        worksheet_name: string;
+        /** Range address (e.g., "A1:B10") */
+        range_address: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Update Excel range data
+     *
+     * @example
+     * ```typescript
+     * await client.onedrive.excelUpdateRange({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF",
+     *   worksheet_name: "Sheet1",
+     *   range_address: "A1:B2",
+     *   values: [["Name", "Age"], ["John", 30]]
+     * });
+     * ```
+     */
+    excelUpdateRange(params: {
+        /** Excel file ID */
+        file_id: string;
+        /** Worksheet name or ID */
+        worksheet_name: string;
+        /** Range address (e.g., "A1:B10") */
+        range_address: string;
+        /** Values to set */
+        values: any[][];
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get PowerPoint slides
+     *
+     * @example
+     * ```typescript
+     * const slides = await client.onedrive.powerpointGetSlides({
+     *   file_id: "01234567-89AB-CDEF-0123-456789ABCDEF"
+     * });
+     * ```
+     */
+    powerpointGetSlides(params: {
+        /** PowerPoint file ID */
+        file_id: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=onedrive-client.d.ts.map

package/dist/src/integrations/onedrive-client.d.ts.map

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

package/dist/src/integrations/onedrive.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OneDrive Integration
+ * Enables OneDrive tools with OAuth configuration
+ */
+import type { MCPIntegration } from "./types.js";
+/**
+ * OneDrive integration configuration
+ *
+ * SERVER-SIDE: Automatically reads ONEDRIVE_CLIENT_ID and ONEDRIVE_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 OneDriveIntegrationConfig {
+    /** OneDrive OAuth client ID (defaults to ONEDRIVE_CLIENT_ID env var) */
+    clientId?: string;
+    /** OneDrive OAuth client secret (defaults to ONEDRIVE_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: ['Files.Read', 'Files.ReadWrite', 'offline_access']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default OneDrive tools that this integration enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const ONEDRIVE_TOOLS: readonly ["onedrive_list_files", "onedrive_get_file", "onedrive_download_file", "onedrive_upload_file", "onedrive_delete_file", "onedrive_search_files", "onedrive_share_file", "onedrive_word_get_content", "onedrive_excel_get_worksheets", "onedrive_excel_get_range", "onedrive_excel_update_range", "onedrive_powerpoint_get_slides"];
+export declare function onedriveIntegration(config?: OneDriveIntegrationConfig): MCPIntegration<"onedrive">;
+/**
+ * Export tool names for type inference
+ */
+export type OneDriveTools = typeof ONEDRIVE_TOOLS[number];
+/**
+ * Export OneDrive client types
+ */
+export type { OneDriveIntegrationClient } from "./onedrive-client.js";
+//# sourceMappingURL=onedrive.d.ts.map

package/dist/src/integrations/onedrive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onedrive.d.ts","sourceRoot":"","sources":["../../../src/integrations/onedrive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,cAAc,4UAaV,CAAC;AAGX,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,yBAA8B,GAAG,cAAc,CAAC,UAAU,CAAC,CAyBtG;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}