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

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

@@ -0,0 +1,327 @@
+/**
+ * Figma Integration Client Types
+ * Fully typed interface for Figma integration methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Figma File
+ */
+export interface FigmaFile {
+    name: string;
+    lastModified: string;
+    thumbnailUrl: string;
+    version: string;
+    role: string;
+    editorType: string;
+    linkAccess: string;
+    document?: {
+        id: string;
+        name: string;
+        type: string;
+        children: any[];
+    };
+    components?: Record<string, {
+        key: string;
+        name: string;
+        description: string;
+    }>;
+    schemaVersion: number;
+    styles?: Record<string, any>;
+}
+/**
+ * Figma Node
+ */
+export interface FigmaNode {
+    id: string;
+    name: string;
+    type: string;
+    visible?: boolean;
+    locked?: boolean;
+    children?: FigmaNode[];
+    backgroundColor?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    absoluteBoundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    constraints?: {
+        vertical: string;
+        horizontal: string;
+    };
+}
+/**
+ * Figma Comment
+ */
+export interface FigmaComment {
+    id: string;
+    file_key: string;
+    parent_id?: string;
+    user: {
+        id: string;
+        handle: string;
+        img_url: string;
+    };
+    created_at: string;
+    resolved_at?: string;
+    message: string;
+    client_meta: {
+        x?: number;
+        y?: number;
+        node_id?: string;
+        node_offset?: {
+            x: number;
+            y: number;
+        };
+    };
+    order_id?: string;
+}
+/**
+ * Figma Project
+ */
+export interface FigmaProject {
+    id: string;
+    name: string;
+}
+/**
+ * Figma Project File
+ */
+export interface FigmaProjectFile {
+    key: string;
+    name: string;
+    thumbnail_url: string;
+    last_modified: string;
+}
+/**
+ * Figma File Version
+ */
+export interface FigmaFileVersion {
+    id: string;
+    created_at: string;
+    label?: string;
+    description?: string;
+    user: {
+        id: string;
+        handle: string;
+        img_url: string;
+    };
+}
+/**
+ * Figma Component
+ */
+export interface FigmaComponent {
+    key: string;
+    file_key: string;
+    node_id: string;
+    thumbnail_url: string;
+    name: string;
+    description: string;
+    created_at: string;
+    updated_at: string;
+    user: {
+        id: string;
+        handle: string;
+        img_url: string;
+    };
+    containing_frame?: {
+        name: string;
+        nodeId: string;
+    };
+}
+/**
+ * Figma Integration Client Interface
+ * Provides type-safe methods for all Figma operations
+ */
+export interface FigmaIntegrationClient {
+    /**
+     * Get a Figma file by key
+     *
+     * @example
+     * ```typescript
+     * const file = await client.figma.getFile({
+     *   file_key: "abc123"
+     * });
+     * ```
+     */
+    getFile(params: {
+        /** Figma file key */
+        file_key: string;
+        /** Comma-separated list of version IDs */
+        version?: string;
+        /** Comma-separated list of node IDs */
+        ids?: string;
+        /** Depth to traverse (1 or 2) */
+        depth?: number;
+        /** Geometry format */
+        geometry?: "paths" | "svg";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get specific nodes from a file
+     *
+     * @example
+     * ```typescript
+     * const nodes = await client.figma.getFileNodes({
+     *   file_key: "abc123",
+     *   ids: "1:5,1:6"
+     * });
+     * ```
+     */
+    getFileNodes(params: {
+        /** Figma file key */
+        file_key: string;
+        /** Comma-separated list of node IDs */
+        ids: string;
+        /** Version ID */
+        version?: string;
+        /** Depth to traverse */
+        depth?: number;
+        /** Geometry format */
+        geometry?: "paths" | "svg";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Export images from a file
+     *
+     * @example
+     * ```typescript
+     * const images = await client.figma.getImages({
+     *   file_key: "abc123",
+     *   ids: "1:5,1:6",
+     *   format: "png",
+     *   scale: 2
+     * });
+     * ```
+     */
+    getImages(params: {
+        /** Figma file key */
+        file_key: string;
+        /** Comma-separated list of node IDs */
+        ids: string;
+        /** Image format */
+        format?: "jpg" | "png" | "svg" | "pdf";
+        /** Scale factor (0.01 to 4) */
+        scale?: number;
+        /** SVG rendering options */
+        svg_include_id?: boolean;
+        svg_simplify_stroke?: boolean;
+        /** Use absolute bounds */
+        use_absolute_bounds?: boolean;
+        /** Version ID */
+        version?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get comments on a file
+     *
+     * @example
+     * ```typescript
+     * const comments = await client.figma.getComments({
+     *   file_key: "abc123"
+     * });
+     * ```
+     */
+    getComments(params: {
+        /** Figma file key */
+        file_key: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Post a comment on a file
+     *
+     * @example
+     * ```typescript
+     * await client.figma.postComment({
+     *   file_key: "abc123",
+     *   message: "Great design!",
+     *   client_meta: { x: 100, y: 200 }
+     * });
+     * ```
+     */
+    postComment(params: {
+        /** Figma file key */
+        file_key: string;
+        /** Comment message */
+        message: string;
+        /** Position metadata */
+        client_meta?: {
+            /** X coordinate */
+            x?: number;
+            /** Y coordinate */
+            y?: number;
+            /** Node ID */
+            node_id?: string;
+            /** Node offset */
+            node_offset?: {
+                x: number;
+                y: number;
+            };
+        };
+        /** Parent comment ID (for replies) */
+        comment_id?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List projects in a team
+     *
+     * @example
+     * ```typescript
+     * const projects = await client.figma.listProjects({
+     *   team_id: "123456"
+     * });
+     * ```
+     */
+    listProjects(params: {
+        /** Team ID */
+        team_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get files in a project
+     *
+     * @example
+     * ```typescript
+     * const files = await client.figma.getProjectFiles({
+     *   project_id: "123456"
+     * });
+     * ```
+     */
+    getProjectFiles(params: {
+        /** Project ID */
+        project_id: string;
+        /** Branch data filter */
+        branch_data?: "include" | "exclude";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get version history of a file
+     *
+     * @example
+     * ```typescript
+     * const versions = await client.figma.getFileVersions({
+     *   file_key: "abc123"
+     * });
+     * ```
+     */
+    getFileVersions(params: {
+        /** Figma file key */
+        file_key: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get published components for a team
+     *
+     * @example
+     * ```typescript
+     * const components = await client.figma.getTeamComponents({
+     *   team_id: "123456"
+     * });
+     * ```
+     */
+    getTeamComponents(params: {
+        /** Team ID */
+        team_id: string;
+        /** Page size */
+        page_size?: number;
+        /** Pagination cursor */
+        cursor?: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=figma-client.d.ts.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Figma Integration
+ * Enables Figma tools with OAuth configuration
+ */
+import type { MCPIntegration } from "./types.js";
+/**
+ * Figma integration configuration
+ *
+ * SERVER-SIDE: Automatically reads FIGMA_CLIENT_ID and FIGMA_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 FigmaIntegrationConfig {
+    /** Figma OAuth client ID (defaults to FIGMA_CLIENT_ID env var) */
+    clientId?: string;
+    /** Figma OAuth client secret (defaults to FIGMA_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: ['files:read', 'file_comments:write']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default Figma tools that this integration enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const FIGMA_TOOLS: readonly ["figma_get_file", "figma_get_file_nodes", "figma_get_images", "figma_get_comments", "figma_post_comment", "figma_list_projects", "figma_get_project_files", "figma_get_file_versions", "figma_get_team_components"];
+export declare function figmaIntegration(config?: FigmaIntegrationConfig): MCPIntegration<"figma">;
+/**
+ * Export tool names for type inference
+ */
+export type FigmaTools = typeof FIGMA_TOOLS[number];
+/**
+ * Export Figma client types
+ */
+export type { FigmaIntegrationClient } from "./figma-client.js";
+//# sourceMappingURL=figma.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figma.d.ts","sourceRoot":"","sources":["../../../src/integrations/figma.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,+NAUP,CAAC;AAGX,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,sBAA2B,GAAG,cAAc,CAAC,OAAO,CAAC,CAyB7F;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}