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

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

@@ -0,0 +1,297 @@
+/**
+ * Polar Integration Client Types
+ * Fully typed interface for Polar integration methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Polar Product
+ */
+export interface PolarProduct {
+    id: string;
+    name: string;
+    description?: string;
+    is_recurring: boolean;
+    is_archived: boolean;
+    organization_id: string;
+    prices: Array<{
+        id: string;
+        created_at: string;
+        modified_at?: string;
+        amount_type: "fixed" | "custom";
+        price_amount?: number;
+        price_currency?: string;
+        recurring_interval?: "month" | "year";
+    }>;
+    benefits: Array<{
+        id: string;
+        type: string;
+        description: string;
+    }>;
+    medias: Array<{
+        id: string;
+        organization_id: string;
+        name: string;
+        path: string;
+        mime_type: string;
+        size: number;
+        public_url: string;
+    }>;
+    created_at: string;
+    modified_at?: string;
+}
+/**
+ * Polar Subscription
+ */
+export interface PolarSubscription {
+    id: string;
+    status: "incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "canceled" | "unpaid";
+    current_period_start: string;
+    current_period_end?: string;
+    cancel_at_period_end: boolean;
+    started_at?: string;
+    ended_at?: string;
+    customer_id: string;
+    product_id: string;
+    price_id: string;
+    created_at: string;
+    modified_at?: string;
+    user_id: string;
+    product: {
+        id: string;
+        name: string;
+    };
+    price: {
+        id: string;
+        price_amount?: number;
+        price_currency?: string;
+        recurring_interval?: "month" | "year";
+    };
+}
+/**
+ * Polar Customer
+ */
+export interface PolarCustomer {
+    id: string;
+    email: string;
+    email_verified: boolean;
+    name?: string;
+    billing_address?: {
+        country: string;
+    };
+    tax_id?: string;
+    organization_id?: string;
+    created_at: string;
+    modified_at?: string;
+}
+/**
+ * Polar Order
+ */
+export interface PolarOrder {
+    id: string;
+    amount: number;
+    tax_amount: number;
+    currency: string;
+    billing_reason: string;
+    customer_id: string;
+    product_id: string;
+    product_price_id: string;
+    subscription_id?: string;
+    created_at: string;
+    user_id: string;
+    product: {
+        id: string;
+        name: string;
+    };
+    product_price: {
+        id: string;
+        price_amount?: number;
+        price_currency?: string;
+    };
+}
+/**
+ * Polar Benefit
+ */
+export interface PolarBenefit {
+    id: string;
+    type: "custom" | "articles" | "discord" | "github_repository" | "downloadables" | "license_keys";
+    description: string;
+    selectable: boolean;
+    deletable: boolean;
+    organization_id: string;
+    properties: Record<string, any>;
+    created_at: string;
+    modified_at?: string;
+}
+/**
+ * Polar Integration Client Interface
+ * Provides type-safe methods for all Polar operations
+ */
+export interface PolarIntegrationClient {
+    /**
+     * List products
+     *
+     * @example
+     * ```typescript
+     * const products = await client.polar.listProducts({
+     *   organization_id: "org_123",
+     *   limit: 10
+     * });
+     * ```
+     */
+    listProducts(params?: {
+        /** Organization ID */
+        organization_id?: string;
+        /** Include archived products */
+        is_archived?: boolean;
+        /** Number of products to return */
+        limit?: number;
+        /** Pagination cursor */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get product details
+     *
+     * @example
+     * ```typescript
+     * const product = await client.polar.getProduct({
+     *   product_id: "prod_123"
+     * });
+     * ```
+     */
+    getProduct(params: {
+        /** Product ID */
+        product_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List subscriptions
+     *
+     * @example
+     * ```typescript
+     * const subscriptions = await client.polar.listSubscriptions({
+     *   organization_id: "org_123",
+     *   status: "active",
+     *   limit: 50
+     * });
+     * ```
+     */
+    listSubscriptions(params?: {
+        /** Organization ID */
+        organization_id?: string;
+        /** Product ID */
+        product_id?: string;
+        /** Filter by status */
+        status?: "incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "canceled" | "unpaid";
+        /** Number of subscriptions to return */
+        limit?: number;
+        /** Pagination cursor */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get subscription details
+     *
+     * @example
+     * ```typescript
+     * const subscription = await client.polar.getSubscription({
+     *   subscription_id: "sub_123"
+     * });
+     * ```
+     */
+    getSubscription(params: {
+        /** Subscription ID */
+        subscription_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List customers
+     *
+     * @example
+     * ```typescript
+     * const customers = await client.polar.listCustomers({
+     *   organization_id: "org_123",
+     *   limit: 50
+     * });
+     * ```
+     */
+    listCustomers(params?: {
+        /** Organization ID */
+        organization_id?: string;
+        /** Filter by email */
+        email?: string;
+        /** Number of customers to return */
+        limit?: number;
+        /** Pagination cursor */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get customer details
+     *
+     * @example
+     * ```typescript
+     * const customer = await client.polar.getCustomer({
+     *   customer_id: "cus_123"
+     * });
+     * ```
+     */
+    getCustomer(params: {
+        /** Customer ID */
+        customer_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List orders
+     *
+     * @example
+     * ```typescript
+     * const orders = await client.polar.listOrders({
+     *   organization_id: "org_123",
+     *   limit: 50
+     * });
+     * ```
+     */
+    listOrders(params?: {
+        /** Organization ID */
+        organization_id?: string;
+        /** Product ID */
+        product_id?: string;
+        /** Customer ID */
+        customer_id?: string;
+        /** Number of orders to return */
+        limit?: number;
+        /** Pagination cursor */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get order details
+     *
+     * @example
+     * ```typescript
+     * const order = await client.polar.getOrder({
+     *   order_id: "ord_123"
+     * });
+     * ```
+     */
+    getOrder(params: {
+        /** Order ID */
+        order_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List benefits
+     *
+     * @example
+     * ```typescript
+     * const benefits = await client.polar.listBenefits({
+     *   organization_id: "org_123",
+     *   limit: 50
+     * });
+     * ```
+     */
+    listBenefits(params?: {
+        /** Organization ID */
+        organization_id?: string;
+        /** Filter by type */
+        type?: "custom" | "articles" | "discord" | "github_repository" | "downloadables" | "license_keys";
+        /** Number of benefits to return */
+        limit?: number;
+        /** Pagination cursor */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=polar-client.d.ts.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * Polar Integration
+ * Enables Polar tools with OAuth configuration
+ */
+import type { MCPIntegration } from "./types.js";
+/**
+ * Polar integration configuration
+ *
+ * SERVER-SIDE: Automatically reads POLAR_CLIENT_ID and POLAR_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 PolarIntegrationConfig {
+    /** Polar OAuth client ID (defaults to POLAR_CLIENT_ID env var) */
+    clientId?: string;
+    /** Polar OAuth client secret (defaults to POLAR_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: ['products:read', 'subscriptions:read', 'customers:read', 'orders:read', 'benefits:read']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+    /** Polar API base URL (default: https://api.polar.sh) */
+    apiBaseUrl?: string;
+}
+/**
+ * Default Polar tools that this integration enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const POLAR_TOOLS: readonly ["polar_list_products", "polar_get_product", "polar_list_subscriptions", "polar_get_subscription", "polar_list_customers", "polar_get_customer", "polar_list_orders", "polar_get_order", "polar_list_benefits"];
+export declare function polarIntegration(config?: PolarIntegrationConfig): MCPIntegration<"polar">;
+/**
+ * Export tool names for type inference
+ */
+export type PolarTools = typeof POLAR_TOOLS[number];
+/**
+ * Export Polar client types
+ */
+export type { PolarIntegrationClient } from "./polar-client.js";
+//# sourceMappingURL=polar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polar.d.ts","sourceRoot":"","sources":["../../../src/integrations/polar.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,mIAAmI;IACnI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,0NAUP,CAAC;AAGX,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,sBAA2B,GAAG,cAAc,CAAC,OAAO,CAAC,CA0B7F;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,341 @@
+/**
+ * Ramp Integration Client Types
+ * Fully typed interface for Ramp integration methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Ramp Transaction
+ */
+export interface RampTransaction {
+    id: string;
+    amount: number;
+    merchant_id?: string;
+    merchant_name: string;
+    merchant_descriptor?: string;
+    merchant_category_code?: string;
+    merchant_category_code_description?: string;
+    card_id: string;
+    user_id: string;
+    state: "PENDING" | "SETTLED" | "DECLINED" | "CANCELED";
+    memo?: string;
+    sk_category_id?: string;
+    sk_category_name?: string;
+    receipts?: Array<{
+        id: string;
+        receipt_url: string;
+        created_at: string;
+    }>;
+    card_holder: {
+        id: string;
+        first_name: string;
+        last_name: string;
+        department_id?: string;
+    };
+    merchant_category?: string;
+    accounting_categories?: Array<{
+        id: string;
+        name: string;
+    }>;
+    disputes?: Array<{
+        id: string;
+        state: string;
+        reason_code: string;
+    }>;
+    policy_violations?: Array<{
+        id: string;
+        memo: string;
+    }>;
+    line_items?: Array<{
+        id: string;
+        amount: number;
+        accounting_category_id?: string;
+    }>;
+    created_at: string;
+    user_transaction_time: string;
+}
+/**
+ * Ramp Card
+ */
+export interface RampCard {
+    id: string;
+    last_four: string;
+    cardholder_id: string;
+    cardholder_name: string;
+    display_name?: string;
+    is_physical: boolean;
+    spending_restrictions?: {
+        amount: number;
+        interval: "DAILY" | "MONTHLY" | "YEARLY" | "TOTAL";
+        categories?: number[];
+        blocked_categories?: number[];
+        lock_date?: string;
+    };
+    fulfillment?: {
+        card_personalization?: {
+            text: {
+                name_line_1: string;
+            };
+        };
+        shipping?: {
+            recipient_first_name?: string;
+            recipient_last_name?: string;
+            address: {
+                address1: string;
+                address2?: string;
+                city: string;
+                state: string;
+                zip: string;
+                country: string;
+            };
+        };
+    };
+    state: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "TERMINATED";
+    has_chip: boolean;
+    created_at: string;
+}
+/**
+ * Ramp User
+ */
+export interface RampUser {
+    id: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    role: "CARD_HOLDER" | "BUSINESS_OWNER" | "BUSINESS_ADMIN" | "BOOKKEEPER";
+    department_id?: string;
+    direct_manager_id?: string;
+    location_id?: string;
+    phone?: string;
+    manager_id?: string;
+    is_manager?: boolean;
+}
+/**
+ * Ramp Department
+ */
+export interface RampDepartment {
+    id: string;
+    name: string;
+}
+/**
+ * Ramp Reimbursement
+ */
+export interface RampReimbursement {
+    id: string;
+    user_id: string;
+    amount: number;
+    currency: string;
+    merchant: string;
+    transaction_date: string;
+    receipts: Array<{
+        id: string;
+        receipt_url: string;
+        created_at: string;
+    }>;
+    memo?: string;
+    created_at: string;
+}
+/**
+ * Ramp Spend Limit
+ */
+export interface RampSpendLimit {
+    id: string;
+    display_name: string;
+    amount: number;
+    interval: "DAILY" | "MONTHLY" | "YEARLY" | "TOTAL";
+    owner_id: string;
+    owner_type: "USER" | "TEAM";
+    temporary?: boolean;
+    start_date?: string;
+    end_date?: string;
+    locked?: boolean;
+    categories?: Array<{
+        id: string;
+        name: string;
+    }>;
+    blocked_categories?: Array<{
+        id: string;
+        name: string;
+    }>;
+    transaction_amount_limit?: {
+        amount: number;
+    };
+}
+/**
+ * Ramp Integration Client Interface
+ * Provides type-safe methods for all Ramp operations
+ */
+export interface RampIntegrationClient {
+    /**
+     * List transactions
+     *
+     * @example
+     * ```typescript
+     * const transactions = await client.ramp.listTransactions({
+     *   from_date: "2024-01-01",
+     *   to_date: "2024-01-31",
+     *   page_size: 50
+     * });
+     * ```
+     */
+    listTransactions(params?: {
+        /** Filter by start date (YYYY-MM-DD) */
+        from_date?: string;
+        /** Filter by end date (YYYY-MM-DD) */
+        to_date?: string;
+        /** Filter by card ID */
+        card_id?: string;
+        /** Filter by user ID */
+        user_id?: string;
+        /** Filter by state */
+        state?: "PENDING" | "SETTLED" | "DECLINED" | "CANCELED";
+        /** Number of transactions to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get transaction details
+     *
+     * @example
+     * ```typescript
+     * const transaction = await client.ramp.getTransaction({
+     *   transaction_id: "txn_123456"
+     * });
+     * ```
+     */
+    getTransaction(params: {
+        /** Transaction ID */
+        transaction_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List cards
+     *
+     * @example
+     * ```typescript
+     * const cards = await client.ramp.listCards({
+     *   state: "ACTIVE",
+     *   page_size: 50
+     * });
+     * ```
+     */
+    listCards(params?: {
+        /** Filter by card state */
+        state?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "TERMINATED";
+        /** Filter by cardholder ID */
+        cardholder_id?: string;
+        /** Number of cards to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get card details
+     *
+     * @example
+     * ```typescript
+     * const card = await client.ramp.getCard({
+     *   card_id: "card_123456"
+     * });
+     * ```
+     */
+    getCard(params: {
+        /** Card ID */
+        card_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List users
+     *
+     * @example
+     * ```typescript
+     * const users = await client.ramp.listUsers({
+     *   page_size: 50
+     * });
+     * ```
+     */
+    listUsers(params?: {
+        /** Filter by role */
+        role?: "CARD_HOLDER" | "BUSINESS_OWNER" | "BUSINESS_ADMIN" | "BOOKKEEPER";
+        /** Filter by department ID */
+        department_id?: string;
+        /** Number of users to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get user details
+     *
+     * @example
+     * ```typescript
+     * const user = await client.ramp.getUser({
+     *   user_id: "user_123456"
+     * });
+     * ```
+     */
+    getUser(params: {
+        /** User ID */
+        user_id: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List departments
+     *
+     * @example
+     * ```typescript
+     * const departments = await client.ramp.listDepartments({
+     *   page_size: 50
+     * });
+     * ```
+     */
+    listDepartments(params?: {
+        /** Number of departments to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List reimbursements
+     *
+     * @example
+     * ```typescript
+     * const reimbursements = await client.ramp.listReimbursements({
+     *   from_date: "2024-01-01",
+     *   to_date: "2024-01-31",
+     *   page_size: 50
+     * });
+     * ```
+     */
+    listReimbursements(params?: {
+        /** Filter by start date (YYYY-MM-DD) */
+        from_date?: string;
+        /** Filter by end date (YYYY-MM-DD) */
+        to_date?: string;
+        /** Filter by user ID */
+        user_id?: string;
+        /** Number of reimbursements to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get spend limits
+     *
+     * @example
+     * ```typescript
+     * const spendLimits = await client.ramp.getSpendLimits({
+     *   owner_id: "user_123456",
+     *   owner_type: "USER"
+     * });
+     * ```
+     */
+    getSpendLimits(params?: {
+        /** Filter by owner ID */
+        owner_id?: string;
+        /** Filter by owner type */
+        owner_type?: "USER" | "TEAM";
+        /** Number of spend limits to return */
+        page_size?: number;
+        /** Pagination cursor */
+        start?: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=ramp-client.d.ts.map

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

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