@workbenchcrm/sdk 1.2.1 → 1.3.0

package/dist/index.d.mts

@@ -612,6 +612,137 @@ interface NotificationResult {
     /** Error messages if any failures occurred */
     errors?: string[];
 }
+/**
+ * Integration status values
+ */
+type IntegrationStatus = 'draft' | 'pending_review' | 'published' | 'rejected' | 'suspended';
+/**
+ * Integration category values
+ */
+type IntegrationCategory = 'accounting' | 'analytics' | 'automation' | 'communication' | 'crm' | 'ecommerce' | 'marketing' | 'payments' | 'productivity' | 'scheduling' | 'other';
+/**
+ * OAuth scope information
+ */
+interface IntegrationScope {
+    /** Scope identifier (e.g., 'clients:read') */
+    scope: string;
+    /** Human-readable description of what the scope allows */
+    description: string;
+    /** Whether this scope is required for the integration */
+    required: boolean;
+}
+/**
+ * Published integration in the marketplace
+ */
+interface Integration {
+    id: string;
+    /** URL-friendly identifier */
+    slug: string;
+    name: string;
+    /** Short description (max 200 chars) */
+    short_description: string;
+    /** Full description with markdown support */
+    description: string;
+    /** Category for filtering/discovery */
+    category: IntegrationCategory;
+    /** URL to integration icon/logo */
+    icon_url: string | null;
+    /** URL to integration website */
+    website_url: string | null;
+    /** Support email for the integration */
+    support_email: string | null;
+    /** Privacy policy URL */
+    privacy_policy_url: string | null;
+    /** Terms of service URL */
+    terms_url: string | null;
+    /** OAuth scopes required by the integration */
+    scopes: IntegrationScope[];
+    /** Webhook events the integration subscribes to */
+    webhook_events: WebhookEvent[];
+    /** Number of businesses using this integration */
+    install_count: number;
+    /** Average rating (1-5) */
+    average_rating: number | null;
+    /** Number of reviews */
+    review_count: number;
+    /** Developer/company information */
+    developer: {
+        id: string;
+        name: string;
+        website: string | null;
+        verified: boolean;
+    };
+    /** When the integration was published */
+    published_at: string;
+    created_at: string;
+    updated_at: string | null;
+}
+/**
+ * Integration review from a user
+ */
+interface IntegrationReview {
+    id: string;
+    integration_id: string;
+    /** Rating 1-5 */
+    rating: number;
+    /** Review title */
+    title: string | null;
+    /** Review body */
+    content: string | null;
+    /** Reviewer display name */
+    reviewer_name: string;
+    /** When the review was submitted */
+    created_at: string;
+}
+/**
+ * Options for listing integrations
+ */
+interface ListIntegrationsOptions extends ListOptions {
+    /** Filter by category */
+    category?: IntegrationCategory;
+    /** Filter by scope (returns integrations that request this scope) */
+    scope?: string;
+    /** Sort by: 'popular' | 'recent' | 'rating' | 'name' */
+    sort_by?: 'popular' | 'recent' | 'rating' | 'name';
+}
+/**
+ * Options for listing integration reviews
+ */
+interface ListIntegrationReviewsOptions extends ListOptions {
+    /** Minimum rating to filter by */
+    min_rating?: number;
+}
+/**
+ * Installed integration on a business account
+ */
+interface InstalledIntegration {
+    id: string;
+    integration_id: string;
+    integration: Integration;
+    /** OAuth access token (masked for security) */
+    access_token_prefix: string;
+    /** Scopes that were granted */
+    granted_scopes: string[];
+    /** When the integration was installed */
+    installed_at: string;
+    /** User who installed the integration */
+    installed_by: string | null;
+    /** Whether the integration is currently active */
+    is_active: boolean;
+}
+/**
+ * Options for installing an integration
+ */
+interface InstallIntegrationOptions {
+    /** Integration ID to install */
+    integration_id: string;
+    /** Scopes to grant (must be subset of integration's requested scopes) */
+    scopes: string[];
+    /** OAuth authorization code (from consent flow) */
+    authorization_code: string;
+    /** PKCE code verifier */
+    code_verifier: string;
+}
 
 /**
  * @file resources/clients.ts
@@ -1628,6 +1759,235 @@ declare class NotificationsResource {
     sendCustom(options: SendCustomNotificationOptions): Promise<ApiResponse<NotificationResult>>;
 }
 
+/**
+ * @file resources/integrations.ts
+ * @description Integration marketplace resource for browsing and managing integrations
+ *
+ * The IntegrationsResource provides methods for:
+ * - Browsing the public integration marketplace
+ * - Viewing integration details and reviews
+ * - Managing installed integrations on your business account
+ */
+
+/**
+ * Integration marketplace resource
+ *
+ * Provides access to the Workbench integration marketplace, allowing you to
+ * browse published integrations, view reviews, and manage installations.
+ *
+ * @example
+ * ```typescript
+ * // Browse marketplace
+ * const { data: integrations } = await workbench.integrations.list({
+ *   category: 'accounting',
+ *   sort_by: 'popular'
+ * });
+ *
+ * // Get integration details
+ * const { data: integration } = await workbench.integrations.get('quickbooks');
+ *
+ * // List installed integrations
+ * const { data: installed } = await workbench.integrations.listInstalled();
+ * ```
+ */
+declare class IntegrationsResource {
+    private readonly client;
+    constructor(client: WorkbenchClient);
+    /**
+     * List published integrations in the marketplace
+     *
+     * Returns a paginated list of published integrations available for installation.
+     * This endpoint is publicly accessible.
+     *
+     * @param options - List options (pagination, filtering, sorting)
+     * @returns Paginated list of integrations
+     *
+     * @example
+     * ```typescript
+     * // List all integrations
+     * const { data, pagination } = await workbench.integrations.list();
+     *
+     * // Filter by category
+     * const { data } = await workbench.integrations.list({
+     *   category: 'accounting',
+     *   sort_by: 'popular',
+     *   per_page: 10
+     * });
+     *
+     * // Search integrations
+     * const { data } = await workbench.integrations.list({
+     *   search: 'quickbooks'
+     * });
+     * ```
+     */
+    list(options?: ListIntegrationsOptions): Promise<ListResponse<Integration>>;
+    /**
+     * Get an integration by ID or slug
+     *
+     * Returns detailed information about a specific integration.
+     *
+     * @param idOrSlug - Integration UUID or URL slug
+     * @returns Integration details
+     *
+     * @example
+     * ```typescript
+     * // Get by slug
+     * const { data: integration } = await workbench.integrations.get('quickbooks');
+     *
+     * // Get by ID
+     * const { data: integration } = await workbench.integrations.get('123e4567-e89b-12d3-a456-426614174000');
+     *
+     * console.log(`${integration.name} by ${integration.developer.name}`);
+     * console.log(`Installs: ${integration.install_count}`);
+     * ```
+     */
+    get(idOrSlug: string): Promise<ApiResponse<Integration>>;
+    /**
+     * Get reviews for an integration
+     *
+     * Returns a paginated list of user reviews for a specific integration.
+     *
+     * @param integrationId - Integration UUID or slug
+     * @param options - List options (pagination, filtering)
+     * @returns Paginated list of reviews
+     *
+     * @example
+     * ```typescript
+     * const { data: reviews, pagination } = await workbench.integrations.getReviews('quickbooks', {
+     *   min_rating: 4,
+     *   per_page: 10
+     * });
+     *
+     * for (const review of reviews) {
+     *   console.log(`${review.rating}/5 - ${review.title}`);
+     * }
+     * ```
+     */
+    getReviews(integrationId: string, options?: ListIntegrationReviewsOptions): Promise<ListResponse<IntegrationReview>>;
+    /**
+     * List installed integrations on your business account
+     *
+     * Returns all integrations that have been installed on the authenticated
+     * business account.
+     *
+     * @returns List of installed integrations
+     *
+     * @example
+     * ```typescript
+     * const { data: installed } = await workbench.integrations.listInstalled();
+     *
+     * for (const install of installed) {
+     *   console.log(`${install.integration.name} - Active: ${install.is_active}`);
+     *   console.log(`Scopes: ${install.granted_scopes.join(', ')}`);
+     * }
+     * ```
+     */
+    listInstalled(): Promise<ListResponse<InstalledIntegration>>;
+    /**
+     * Get an installed integration by ID
+     *
+     * @param installationId - Installation UUID
+     * @returns Installed integration details
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.getInstalled('install-uuid');
+     * console.log(`Installed on: ${install.installed_at}`);
+     * ```
+     */
+    getInstalled(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Install an integration on your business account
+     *
+     * Completes the OAuth flow and installs an integration. This requires an
+     * authorization code obtained from the user consent flow.
+     *
+     * @param options - Installation options including authorization code
+     * @returns Installed integration details
+     *
+     * @example
+     * ```typescript
+     * // After user completes OAuth consent flow:
+     * const { data: install } = await workbench.integrations.install({
+     *   integration_id: 'integration-uuid',
+     *   scopes: ['clients:read', 'invoices:read'],
+     *   authorization_code: 'code_from_oauth_flow',
+     *   code_verifier: 'pkce_code_verifier'
+     * });
+     *
+     * console.log(`Installed! Token prefix: ${install.access_token_prefix}`);
+     * ```
+     */
+    install(options: InstallIntegrationOptions): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Uninstall an integration from your business account
+     *
+     * Revokes all access tokens and removes the integration. This action
+     * cannot be undone.
+     *
+     * @param installationId - Installation UUID
+     *
+     * @example
+     * ```typescript
+     * await workbench.integrations.uninstall('install-uuid');
+     * console.log('Integration uninstalled');
+     * ```
+     */
+    uninstall(installationId: string): Promise<void>;
+    /**
+     * Temporarily disable an installed integration
+     *
+     * Pauses the integration without uninstalling it. The integration can
+     * be re-enabled later.
+     *
+     * @param installationId - Installation UUID
+     * @returns Updated installation
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.disable('install-uuid');
+     * console.log(`Active: ${install.is_active}`); // false
+     * ```
+     */
+    disable(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Re-enable a disabled integration
+     *
+     * @param installationId - Installation UUID
+     * @returns Updated installation
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.enable('install-uuid');
+     * console.log(`Active: ${install.is_active}`); // true
+     * ```
+     */
+    enable(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Submit a review for an installed integration
+     *
+     * You can only review integrations that are installed on your business account.
+     *
+     * @param integrationId - Integration UUID
+     * @param review - Review data
+     * @returns Created review
+     *
+     * @example
+     * ```typescript
+     * const { data: review } = await workbench.integrations.submitReview('integration-uuid', {
+     *   rating: 5,
+     *   title: 'Great integration!',
+     *   content: 'This integration saved us hours of manual work...'
+     * });
+     * ```
+     */
+    submitReview(integrationId: string, review: {
+        rating: number;
+        title?: string;
+        content?: string;
+    }): Promise<ApiResponse<IntegrationReview>>;
+}
+
 /**
  * @file client.ts
  * @description Main Workbench API client class
@@ -1718,6 +2078,8 @@ declare class WorkbenchClient {
     readonly webhooks: WebhooksResource;
     /** Notifications resource */
     readonly notifications: NotificationsResource;
+    /** Integrations marketplace resource */
+    readonly integrations: IntegrationsResource;
     /**
      * Create a new Workbench client
      *
@@ -1899,4 +2261,4 @@ declare function constructWebhookEvent<T = Record<string, unknown>>(payload: str
     timestamp: string;
 };
 
-export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, RequestsResource, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };
+export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type InstallIntegrationOptions, type InstalledIntegration, type Integration, type IntegrationCategory, type IntegrationReview, type IntegrationScope, type IntegrationStatus, IntegrationsResource, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListIntegrationReviewsOptions, type ListIntegrationsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, RequestsResource, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };

package/dist/index.d.ts

@@ -612,6 +612,137 @@ interface NotificationResult {
     /** Error messages if any failures occurred */
     errors?: string[];
 }
+/**
+ * Integration status values
+ */
+type IntegrationStatus = 'draft' | 'pending_review' | 'published' | 'rejected' | 'suspended';
+/**
+ * Integration category values
+ */
+type IntegrationCategory = 'accounting' | 'analytics' | 'automation' | 'communication' | 'crm' | 'ecommerce' | 'marketing' | 'payments' | 'productivity' | 'scheduling' | 'other';
+/**
+ * OAuth scope information
+ */
+interface IntegrationScope {
+    /** Scope identifier (e.g., 'clients:read') */
+    scope: string;
+    /** Human-readable description of what the scope allows */
+    description: string;
+    /** Whether this scope is required for the integration */
+    required: boolean;
+}
+/**
+ * Published integration in the marketplace
+ */
+interface Integration {
+    id: string;
+    /** URL-friendly identifier */
+    slug: string;
+    name: string;
+    /** Short description (max 200 chars) */
+    short_description: string;
+    /** Full description with markdown support */
+    description: string;
+    /** Category for filtering/discovery */
+    category: IntegrationCategory;
+    /** URL to integration icon/logo */
+    icon_url: string | null;
+    /** URL to integration website */
+    website_url: string | null;
+    /** Support email for the integration */
+    support_email: string | null;
+    /** Privacy policy URL */
+    privacy_policy_url: string | null;
+    /** Terms of service URL */
+    terms_url: string | null;
+    /** OAuth scopes required by the integration */
+    scopes: IntegrationScope[];
+    /** Webhook events the integration subscribes to */
+    webhook_events: WebhookEvent[];
+    /** Number of businesses using this integration */
+    install_count: number;
+    /** Average rating (1-5) */
+    average_rating: number | null;
+    /** Number of reviews */
+    review_count: number;
+    /** Developer/company information */
+    developer: {
+        id: string;
+        name: string;
+        website: string | null;
+        verified: boolean;
+    };
+    /** When the integration was published */
+    published_at: string;
+    created_at: string;
+    updated_at: string | null;
+}
+/**
+ * Integration review from a user
+ */
+interface IntegrationReview {
+    id: string;
+    integration_id: string;
+    /** Rating 1-5 */
+    rating: number;
+    /** Review title */
+    title: string | null;
+    /** Review body */
+    content: string | null;
+    /** Reviewer display name */
+    reviewer_name: string;
+    /** When the review was submitted */
+    created_at: string;
+}
+/**
+ * Options for listing integrations
+ */
+interface ListIntegrationsOptions extends ListOptions {
+    /** Filter by category */
+    category?: IntegrationCategory;
+    /** Filter by scope (returns integrations that request this scope) */
+    scope?: string;
+    /** Sort by: 'popular' | 'recent' | 'rating' | 'name' */
+    sort_by?: 'popular' | 'recent' | 'rating' | 'name';
+}
+/**
+ * Options for listing integration reviews
+ */
+interface ListIntegrationReviewsOptions extends ListOptions {
+    /** Minimum rating to filter by */
+    min_rating?: number;
+}
+/**
+ * Installed integration on a business account
+ */
+interface InstalledIntegration {
+    id: string;
+    integration_id: string;
+    integration: Integration;
+    /** OAuth access token (masked for security) */
+    access_token_prefix: string;
+    /** Scopes that were granted */
+    granted_scopes: string[];
+    /** When the integration was installed */
+    installed_at: string;
+    /** User who installed the integration */
+    installed_by: string | null;
+    /** Whether the integration is currently active */
+    is_active: boolean;
+}
+/**
+ * Options for installing an integration
+ */
+interface InstallIntegrationOptions {
+    /** Integration ID to install */
+    integration_id: string;
+    /** Scopes to grant (must be subset of integration's requested scopes) */
+    scopes: string[];
+    /** OAuth authorization code (from consent flow) */
+    authorization_code: string;
+    /** PKCE code verifier */
+    code_verifier: string;
+}
 
 /**
  * @file resources/clients.ts
@@ -1628,6 +1759,235 @@ declare class NotificationsResource {
     sendCustom(options: SendCustomNotificationOptions): Promise<ApiResponse<NotificationResult>>;
 }
 
+/**
+ * @file resources/integrations.ts
+ * @description Integration marketplace resource for browsing and managing integrations
+ *
+ * The IntegrationsResource provides methods for:
+ * - Browsing the public integration marketplace
+ * - Viewing integration details and reviews
+ * - Managing installed integrations on your business account
+ */
+
+/**
+ * Integration marketplace resource
+ *
+ * Provides access to the Workbench integration marketplace, allowing you to
+ * browse published integrations, view reviews, and manage installations.
+ *
+ * @example
+ * ```typescript
+ * // Browse marketplace
+ * const { data: integrations } = await workbench.integrations.list({
+ *   category: 'accounting',
+ *   sort_by: 'popular'
+ * });
+ *
+ * // Get integration details
+ * const { data: integration } = await workbench.integrations.get('quickbooks');
+ *
+ * // List installed integrations
+ * const { data: installed } = await workbench.integrations.listInstalled();
+ * ```
+ */
+declare class IntegrationsResource {
+    private readonly client;
+    constructor(client: WorkbenchClient);
+    /**
+     * List published integrations in the marketplace
+     *
+     * Returns a paginated list of published integrations available for installation.
+     * This endpoint is publicly accessible.
+     *
+     * @param options - List options (pagination, filtering, sorting)
+     * @returns Paginated list of integrations
+     *
+     * @example
+     * ```typescript
+     * // List all integrations
+     * const { data, pagination } = await workbench.integrations.list();
+     *
+     * // Filter by category
+     * const { data } = await workbench.integrations.list({
+     *   category: 'accounting',
+     *   sort_by: 'popular',
+     *   per_page: 10
+     * });
+     *
+     * // Search integrations
+     * const { data } = await workbench.integrations.list({
+     *   search: 'quickbooks'
+     * });
+     * ```
+     */
+    list(options?: ListIntegrationsOptions): Promise<ListResponse<Integration>>;
+    /**
+     * Get an integration by ID or slug
+     *
+     * Returns detailed information about a specific integration.
+     *
+     * @param idOrSlug - Integration UUID or URL slug
+     * @returns Integration details
+     *
+     * @example
+     * ```typescript
+     * // Get by slug
+     * const { data: integration } = await workbench.integrations.get('quickbooks');
+     *
+     * // Get by ID
+     * const { data: integration } = await workbench.integrations.get('123e4567-e89b-12d3-a456-426614174000');
+     *
+     * console.log(`${integration.name} by ${integration.developer.name}`);
+     * console.log(`Installs: ${integration.install_count}`);
+     * ```
+     */
+    get(idOrSlug: string): Promise<ApiResponse<Integration>>;
+    /**
+     * Get reviews for an integration
+     *
+     * Returns a paginated list of user reviews for a specific integration.
+     *
+     * @param integrationId - Integration UUID or slug
+     * @param options - List options (pagination, filtering)
+     * @returns Paginated list of reviews
+     *
+     * @example
+     * ```typescript
+     * const { data: reviews, pagination } = await workbench.integrations.getReviews('quickbooks', {
+     *   min_rating: 4,
+     *   per_page: 10
+     * });
+     *
+     * for (const review of reviews) {
+     *   console.log(`${review.rating}/5 - ${review.title}`);
+     * }
+     * ```
+     */
+    getReviews(integrationId: string, options?: ListIntegrationReviewsOptions): Promise<ListResponse<IntegrationReview>>;
+    /**
+     * List installed integrations on your business account
+     *
+     * Returns all integrations that have been installed on the authenticated
+     * business account.
+     *
+     * @returns List of installed integrations
+     *
+     * @example
+     * ```typescript
+     * const { data: installed } = await workbench.integrations.listInstalled();
+     *
+     * for (const install of installed) {
+     *   console.log(`${install.integration.name} - Active: ${install.is_active}`);
+     *   console.log(`Scopes: ${install.granted_scopes.join(', ')}`);
+     * }
+     * ```
+     */
+    listInstalled(): Promise<ListResponse<InstalledIntegration>>;
+    /**
+     * Get an installed integration by ID
+     *
+     * @param installationId - Installation UUID
+     * @returns Installed integration details
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.getInstalled('install-uuid');
+     * console.log(`Installed on: ${install.installed_at}`);
+     * ```
+     */
+    getInstalled(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Install an integration on your business account
+     *
+     * Completes the OAuth flow and installs an integration. This requires an
+     * authorization code obtained from the user consent flow.
+     *
+     * @param options - Installation options including authorization code
+     * @returns Installed integration details
+     *
+     * @example
+     * ```typescript
+     * // After user completes OAuth consent flow:
+     * const { data: install } = await workbench.integrations.install({
+     *   integration_id: 'integration-uuid',
+     *   scopes: ['clients:read', 'invoices:read'],
+     *   authorization_code: 'code_from_oauth_flow',
+     *   code_verifier: 'pkce_code_verifier'
+     * });
+     *
+     * console.log(`Installed! Token prefix: ${install.access_token_prefix}`);
+     * ```
+     */
+    install(options: InstallIntegrationOptions): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Uninstall an integration from your business account
+     *
+     * Revokes all access tokens and removes the integration. This action
+     * cannot be undone.
+     *
+     * @param installationId - Installation UUID
+     *
+     * @example
+     * ```typescript
+     * await workbench.integrations.uninstall('install-uuid');
+     * console.log('Integration uninstalled');
+     * ```
+     */
+    uninstall(installationId: string): Promise<void>;
+    /**
+     * Temporarily disable an installed integration
+     *
+     * Pauses the integration without uninstalling it. The integration can
+     * be re-enabled later.
+     *
+     * @param installationId - Installation UUID
+     * @returns Updated installation
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.disable('install-uuid');
+     * console.log(`Active: ${install.is_active}`); // false
+     * ```
+     */
+    disable(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Re-enable a disabled integration
+     *
+     * @param installationId - Installation UUID
+     * @returns Updated installation
+     *
+     * @example
+     * ```typescript
+     * const { data: install } = await workbench.integrations.enable('install-uuid');
+     * console.log(`Active: ${install.is_active}`); // true
+     * ```
+     */
+    enable(installationId: string): Promise<ApiResponse<InstalledIntegration>>;
+    /**
+     * Submit a review for an installed integration
+     *
+     * You can only review integrations that are installed on your business account.
+     *
+     * @param integrationId - Integration UUID
+     * @param review - Review data
+     * @returns Created review
+     *
+     * @example
+     * ```typescript
+     * const { data: review } = await workbench.integrations.submitReview('integration-uuid', {
+     *   rating: 5,
+     *   title: 'Great integration!',
+     *   content: 'This integration saved us hours of manual work...'
+     * });
+     * ```
+     */
+    submitReview(integrationId: string, review: {
+        rating: number;
+        title?: string;
+        content?: string;
+    }): Promise<ApiResponse<IntegrationReview>>;
+}
+
 /**
  * @file client.ts
  * @description Main Workbench API client class
@@ -1718,6 +2078,8 @@ declare class WorkbenchClient {
     readonly webhooks: WebhooksResource;
     /** Notifications resource */
     readonly notifications: NotificationsResource;
+    /** Integrations marketplace resource */
+    readonly integrations: IntegrationsResource;
     /**
      * Create a new Workbench client
      *
@@ -1899,4 +2261,4 @@ declare function constructWebhookEvent<T = Record<string, unknown>>(payload: str
     timestamp: string;
 };
 
-export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, RequestsResource, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };
+export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type InstallIntegrationOptions, type InstalledIntegration, type Integration, type IntegrationCategory, type IntegrationReview, type IntegrationScope, type IntegrationStatus, IntegrationsResource, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListIntegrationReviewsOptions, type ListIntegrationsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, RequestsResource, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ClientsResource: () => ClientsResource,
+  IntegrationsResource: () => IntegrationsResource,
   InvoicesResource: () => InvoicesResource,
   JobsResource: () => JobsResource,
   NotificationsResource: () => NotificationsResource,
@@ -1013,6 +1014,258 @@ var NotificationsResource = class {
   }
 };
 
+// src/resources/integrations.ts
+var IntegrationsResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  // ===========================================
+  // MARKETPLACE (Public)
+  // ===========================================
+  /**
+   * List published integrations in the marketplace
+   *
+   * Returns a paginated list of published integrations available for installation.
+   * This endpoint is publicly accessible.
+   *
+   * @param options - List options (pagination, filtering, sorting)
+   * @returns Paginated list of integrations
+   *
+   * @example
+   * ```typescript
+   * // List all integrations
+   * const { data, pagination } = await workbench.integrations.list();
+   *
+   * // Filter by category
+   * const { data } = await workbench.integrations.list({
+   *   category: 'accounting',
+   *   sort_by: 'popular',
+   *   per_page: 10
+   * });
+   *
+   * // Search integrations
+   * const { data } = await workbench.integrations.list({
+   *   search: 'quickbooks'
+   * });
+   * ```
+   */
+  async list(options = {}) {
+    return this.client.get("/v1/integrations", {
+      page: options.page,
+      per_page: options.per_page,
+      search: options.search,
+      category: options.category,
+      scope: options.scope,
+      sort_by: options.sort_by
+    });
+  }
+  /**
+   * Get an integration by ID or slug
+   *
+   * Returns detailed information about a specific integration.
+   *
+   * @param idOrSlug - Integration UUID or URL slug
+   * @returns Integration details
+   *
+   * @example
+   * ```typescript
+   * // Get by slug
+   * const { data: integration } = await workbench.integrations.get('quickbooks');
+   *
+   * // Get by ID
+   * const { data: integration } = await workbench.integrations.get('123e4567-e89b-12d3-a456-426614174000');
+   *
+   * console.log(`${integration.name} by ${integration.developer.name}`);
+   * console.log(`Installs: ${integration.install_count}`);
+   * ```
+   */
+  async get(idOrSlug) {
+    return this.client.get(`/v1/integrations/${idOrSlug}`);
+  }
+  /**
+   * Get reviews for an integration
+   *
+   * Returns a paginated list of user reviews for a specific integration.
+   *
+   * @param integrationId - Integration UUID or slug
+   * @param options - List options (pagination, filtering)
+   * @returns Paginated list of reviews
+   *
+   * @example
+   * ```typescript
+   * const { data: reviews, pagination } = await workbench.integrations.getReviews('quickbooks', {
+   *   min_rating: 4,
+   *   per_page: 10
+   * });
+   *
+   * for (const review of reviews) {
+   *   console.log(`${review.rating}/5 - ${review.title}`);
+   * }
+   * ```
+   */
+  async getReviews(integrationId, options = {}) {
+    return this.client.get(
+      `/v1/integrations/${integrationId}/reviews`,
+      {
+        page: options.page,
+        per_page: options.per_page,
+        min_rating: options.min_rating
+      }
+    );
+  }
+  // ===========================================
+  // INSTALLED INTEGRATIONS (Authenticated)
+  // ===========================================
+  /**
+   * List installed integrations on your business account
+   *
+   * Returns all integrations that have been installed on the authenticated
+   * business account.
+   *
+   * @returns List of installed integrations
+   *
+   * @example
+   * ```typescript
+   * const { data: installed } = await workbench.integrations.listInstalled();
+   *
+   * for (const install of installed) {
+   *   console.log(`${install.integration.name} - Active: ${install.is_active}`);
+   *   console.log(`Scopes: ${install.granted_scopes.join(', ')}`);
+   * }
+   * ```
+   */
+  async listInstalled() {
+    return this.client.get("/v1/integrations/installed");
+  }
+  /**
+   * Get an installed integration by ID
+   *
+   * @param installationId - Installation UUID
+   * @returns Installed integration details
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.getInstalled('install-uuid');
+   * console.log(`Installed on: ${install.installed_at}`);
+   * ```
+   */
+  async getInstalled(installationId) {
+    return this.client.get(
+      `/v1/integrations/installed/${installationId}`
+    );
+  }
+  /**
+   * Install an integration on your business account
+   *
+   * Completes the OAuth flow and installs an integration. This requires an
+   * authorization code obtained from the user consent flow.
+   *
+   * @param options - Installation options including authorization code
+   * @returns Installed integration details
+   *
+   * @example
+   * ```typescript
+   * // After user completes OAuth consent flow:
+   * const { data: install } = await workbench.integrations.install({
+   *   integration_id: 'integration-uuid',
+   *   scopes: ['clients:read', 'invoices:read'],
+   *   authorization_code: 'code_from_oauth_flow',
+   *   code_verifier: 'pkce_code_verifier'
+   * });
+   *
+   * console.log(`Installed! Token prefix: ${install.access_token_prefix}`);
+   * ```
+   */
+  async install(options) {
+    return this.client.post(
+      "/v1/integrations/install",
+      options
+    );
+  }
+  /**
+   * Uninstall an integration from your business account
+   *
+   * Revokes all access tokens and removes the integration. This action
+   * cannot be undone.
+   *
+   * @param installationId - Installation UUID
+   *
+   * @example
+   * ```typescript
+   * await workbench.integrations.uninstall('install-uuid');
+   * console.log('Integration uninstalled');
+   * ```
+   */
+  async uninstall(installationId) {
+    await this.client.delete(`/v1/integrations/installed/${installationId}`);
+  }
+  /**
+   * Temporarily disable an installed integration
+   *
+   * Pauses the integration without uninstalling it. The integration can
+   * be re-enabled later.
+   *
+   * @param installationId - Installation UUID
+   * @returns Updated installation
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.disable('install-uuid');
+   * console.log(`Active: ${install.is_active}`); // false
+   * ```
+   */
+  async disable(installationId) {
+    return this.client.post(
+      `/v1/integrations/installed/${installationId}/disable`
+    );
+  }
+  /**
+   * Re-enable a disabled integration
+   *
+   * @param installationId - Installation UUID
+   * @returns Updated installation
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.enable('install-uuid');
+   * console.log(`Active: ${install.is_active}`); // true
+   * ```
+   */
+  async enable(installationId) {
+    return this.client.post(
+      `/v1/integrations/installed/${installationId}/enable`
+    );
+  }
+  // ===========================================
+  // REVIEWS (Authenticated)
+  // ===========================================
+  /**
+   * Submit a review for an installed integration
+   *
+   * You can only review integrations that are installed on your business account.
+   *
+   * @param integrationId - Integration UUID
+   * @param review - Review data
+   * @returns Created review
+   *
+   * @example
+   * ```typescript
+   * const { data: review } = await workbench.integrations.submitReview('integration-uuid', {
+   *   rating: 5,
+   *   title: 'Great integration!',
+   *   content: 'This integration saved us hours of manual work...'
+   * });
+   * ```
+   */
+  async submitReview(integrationId, review) {
+    return this.client.post(
+      `/v1/integrations/${integrationId}/reviews`,
+      review
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.tryworkbench.app";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1054,6 +1307,8 @@ var WorkbenchClient = class {
   webhooks;
   /** Notifications resource */
   notifications;
+  /** Integrations marketplace resource */
+  integrations;
   /**
    * Create a new Workbench client
    *
@@ -1076,6 +1331,7 @@ var WorkbenchClient = class {
     this.requests = new RequestsResource(this);
     this.webhooks = new WebhooksResource(this);
     this.notifications = new NotificationsResource(this);
+    this.integrations = new IntegrationsResource(this);
   }
   /**
    * Build URL with query parameters
@@ -1288,6 +1544,7 @@ function constructWebhookEvent(payload, signature, secret, options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ClientsResource,
+  IntegrationsResource,
   InvoicesResource,
   JobsResource,
   NotificationsResource,

package/dist/index.mjs

@@ -974,6 +974,258 @@ var NotificationsResource = class {
   }
 };
 
+// src/resources/integrations.ts
+var IntegrationsResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  // ===========================================
+  // MARKETPLACE (Public)
+  // ===========================================
+  /**
+   * List published integrations in the marketplace
+   *
+   * Returns a paginated list of published integrations available for installation.
+   * This endpoint is publicly accessible.
+   *
+   * @param options - List options (pagination, filtering, sorting)
+   * @returns Paginated list of integrations
+   *
+   * @example
+   * ```typescript
+   * // List all integrations
+   * const { data, pagination } = await workbench.integrations.list();
+   *
+   * // Filter by category
+   * const { data } = await workbench.integrations.list({
+   *   category: 'accounting',
+   *   sort_by: 'popular',
+   *   per_page: 10
+   * });
+   *
+   * // Search integrations
+   * const { data } = await workbench.integrations.list({
+   *   search: 'quickbooks'
+   * });
+   * ```
+   */
+  async list(options = {}) {
+    return this.client.get("/v1/integrations", {
+      page: options.page,
+      per_page: options.per_page,
+      search: options.search,
+      category: options.category,
+      scope: options.scope,
+      sort_by: options.sort_by
+    });
+  }
+  /**
+   * Get an integration by ID or slug
+   *
+   * Returns detailed information about a specific integration.
+   *
+   * @param idOrSlug - Integration UUID or URL slug
+   * @returns Integration details
+   *
+   * @example
+   * ```typescript
+   * // Get by slug
+   * const { data: integration } = await workbench.integrations.get('quickbooks');
+   *
+   * // Get by ID
+   * const { data: integration } = await workbench.integrations.get('123e4567-e89b-12d3-a456-426614174000');
+   *
+   * console.log(`${integration.name} by ${integration.developer.name}`);
+   * console.log(`Installs: ${integration.install_count}`);
+   * ```
+   */
+  async get(idOrSlug) {
+    return this.client.get(`/v1/integrations/${idOrSlug}`);
+  }
+  /**
+   * Get reviews for an integration
+   *
+   * Returns a paginated list of user reviews for a specific integration.
+   *
+   * @param integrationId - Integration UUID or slug
+   * @param options - List options (pagination, filtering)
+   * @returns Paginated list of reviews
+   *
+   * @example
+   * ```typescript
+   * const { data: reviews, pagination } = await workbench.integrations.getReviews('quickbooks', {
+   *   min_rating: 4,
+   *   per_page: 10
+   * });
+   *
+   * for (const review of reviews) {
+   *   console.log(`${review.rating}/5 - ${review.title}`);
+   * }
+   * ```
+   */
+  async getReviews(integrationId, options = {}) {
+    return this.client.get(
+      `/v1/integrations/${integrationId}/reviews`,
+      {
+        page: options.page,
+        per_page: options.per_page,
+        min_rating: options.min_rating
+      }
+    );
+  }
+  // ===========================================
+  // INSTALLED INTEGRATIONS (Authenticated)
+  // ===========================================
+  /**
+   * List installed integrations on your business account
+   *
+   * Returns all integrations that have been installed on the authenticated
+   * business account.
+   *
+   * @returns List of installed integrations
+   *
+   * @example
+   * ```typescript
+   * const { data: installed } = await workbench.integrations.listInstalled();
+   *
+   * for (const install of installed) {
+   *   console.log(`${install.integration.name} - Active: ${install.is_active}`);
+   *   console.log(`Scopes: ${install.granted_scopes.join(', ')}`);
+   * }
+   * ```
+   */
+  async listInstalled() {
+    return this.client.get("/v1/integrations/installed");
+  }
+  /**
+   * Get an installed integration by ID
+   *
+   * @param installationId - Installation UUID
+   * @returns Installed integration details
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.getInstalled('install-uuid');
+   * console.log(`Installed on: ${install.installed_at}`);
+   * ```
+   */
+  async getInstalled(installationId) {
+    return this.client.get(
+      `/v1/integrations/installed/${installationId}`
+    );
+  }
+  /**
+   * Install an integration on your business account
+   *
+   * Completes the OAuth flow and installs an integration. This requires an
+   * authorization code obtained from the user consent flow.
+   *
+   * @param options - Installation options including authorization code
+   * @returns Installed integration details
+   *
+   * @example
+   * ```typescript
+   * // After user completes OAuth consent flow:
+   * const { data: install } = await workbench.integrations.install({
+   *   integration_id: 'integration-uuid',
+   *   scopes: ['clients:read', 'invoices:read'],
+   *   authorization_code: 'code_from_oauth_flow',
+   *   code_verifier: 'pkce_code_verifier'
+   * });
+   *
+   * console.log(`Installed! Token prefix: ${install.access_token_prefix}`);
+   * ```
+   */
+  async install(options) {
+    return this.client.post(
+      "/v1/integrations/install",
+      options
+    );
+  }
+  /**
+   * Uninstall an integration from your business account
+   *
+   * Revokes all access tokens and removes the integration. This action
+   * cannot be undone.
+   *
+   * @param installationId - Installation UUID
+   *
+   * @example
+   * ```typescript
+   * await workbench.integrations.uninstall('install-uuid');
+   * console.log('Integration uninstalled');
+   * ```
+   */
+  async uninstall(installationId) {
+    await this.client.delete(`/v1/integrations/installed/${installationId}`);
+  }
+  /**
+   * Temporarily disable an installed integration
+   *
+   * Pauses the integration without uninstalling it. The integration can
+   * be re-enabled later.
+   *
+   * @param installationId - Installation UUID
+   * @returns Updated installation
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.disable('install-uuid');
+   * console.log(`Active: ${install.is_active}`); // false
+   * ```
+   */
+  async disable(installationId) {
+    return this.client.post(
+      `/v1/integrations/installed/${installationId}/disable`
+    );
+  }
+  /**
+   * Re-enable a disabled integration
+   *
+   * @param installationId - Installation UUID
+   * @returns Updated installation
+   *
+   * @example
+   * ```typescript
+   * const { data: install } = await workbench.integrations.enable('install-uuid');
+   * console.log(`Active: ${install.is_active}`); // true
+   * ```
+   */
+  async enable(installationId) {
+    return this.client.post(
+      `/v1/integrations/installed/${installationId}/enable`
+    );
+  }
+  // ===========================================
+  // REVIEWS (Authenticated)
+  // ===========================================
+  /**
+   * Submit a review for an installed integration
+   *
+   * You can only review integrations that are installed on your business account.
+   *
+   * @param integrationId - Integration UUID
+   * @param review - Review data
+   * @returns Created review
+   *
+   * @example
+   * ```typescript
+   * const { data: review } = await workbench.integrations.submitReview('integration-uuid', {
+   *   rating: 5,
+   *   title: 'Great integration!',
+   *   content: 'This integration saved us hours of manual work...'
+   * });
+   * ```
+   */
+  async submitReview(integrationId, review) {
+    return this.client.post(
+      `/v1/integrations/${integrationId}/reviews`,
+      review
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.tryworkbench.app";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1015,6 +1267,8 @@ var WorkbenchClient = class {
   webhooks;
   /** Notifications resource */
   notifications;
+  /** Integrations marketplace resource */
+  integrations;
   /**
    * Create a new Workbench client
    *
@@ -1037,6 +1291,7 @@ var WorkbenchClient = class {
     this.requests = new RequestsResource(this);
     this.webhooks = new WebhooksResource(this);
     this.notifications = new NotificationsResource(this);
+    this.integrations = new IntegrationsResource(this);
   }
   /**
    * Build URL with query parameters
@@ -1248,6 +1503,7 @@ function constructWebhookEvent(payload, signature, secret, options = {}) {
 }
 export {
   ClientsResource,
+  IntegrationsResource,
   InvoicesResource,
   JobsResource,
   NotificationsResource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbenchcrm/sdk",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Official Node.js SDK for the Workbench CRM API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",