salesflare-mcp-server 1.0.0

package/dist/client/salesflare-client.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Salesflare API Client
+ *
+ * Provides a robust HTTP client for communicating with the Salesflare API.
+ * Features:
+ * - Automatic authentication via AuthProvider
+ * - Exponential backoff retry for rate limiting (429 responses)
+ * - Comprehensive error translation to SalesflareError
+ * - Type-safe HTTP methods with generics
+ *
+ * Per D-10, D-11: Verbose error responses with specific error codes.
+ * Per D-12: Includes retryable flag for LLM error handling.
+ *
+ * @module client/salesflare-client
+ */
+import { AxiosRequestConfig } from 'axios';
+import { AuthProvider } from '../auth/token-manager.js';
+/**
+ * Configuration options for SalesflareClient
+ */
+export interface SalesflareClientConfig {
+    /** Authentication provider for API requests */
+    authProvider: AuthProvider;
+    /** Base URL for Salesflare API (default: https://api.salesflare.com) */
+    baseURL?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum number of retries for rate-limited requests (default: 3) */
+    maxRetries?: number;
+}
+/**
+ * Salesflare API client with automatic retry and error handling
+ *
+ * Provides type-safe HTTP methods for communicating with the Salesflare API.
+ * Automatically handles authentication, rate limiting with exponential backoff,
+ * and error translation.
+ *
+ * @class
+ * @example
+ * ```typescript
+ * const client = new SalesflareClient({
+ *   authProvider: apiKeyAuth,
+ *   baseURL: 'https://api.salesflare.com',
+ *   timeout: 30000,
+ *   maxRetries: 3,
+ * });
+ *
+ * const contacts = await client.get<Contact[]>('/contacts');
+ * ```
+ */
+export declare class SalesflareClient {
+    /** Axios instance for HTTP requests */
+    private axios;
+    /** Client configuration */
+    private config;
+    /** Retry attempt counter for exponential backoff */
+    private retryCount;
+    /**
+     * Create a new SalesflareClient instance
+     *
+     * @param config - Client configuration including auth provider
+     */
+    constructor(config: SalesflareClientConfig);
+    /**
+     * Setup request interceptor to add authentication headers
+     *
+     * Automatically calls AuthProvider.getAuthHeaders() for each request
+     * and merges the headers into the request config.
+     *
+     * @private
+     */
+    private setupRequestInterceptor;
+    /**
+     * Setup response interceptor for error handling and retry logic
+     *
+     * Handles various HTTP errors and implements exponential backoff
+     * for rate-limited requests (429 responses).
+     *
+     * @private
+     */
+    private setupResponseInterceptor;
+    /**
+     * Handle rate limit errors with exponential backoff retry
+     *
+     * Implements exponential backoff with jitter for 429 responses.
+     * Maximum delay capped at 30 seconds.
+     *
+     * @param error - The Axios error for the rate-limited request
+     * @returns Promise that resolves after retry or rejects with error
+     * @private
+     */
+    private handleRateLimitError;
+    /**
+     * Delay execution for specified milliseconds
+     *
+     * @param ms - Milliseconds to delay
+     * @returns Promise that resolves after delay
+     * @private
+     */
+    private delay;
+    /**
+     * Extract error message from API response data
+     *
+     * @param data - Response data from API error
+     * @returns Extracted error message or undefined
+     * @private
+     */
+    private extractErrorMessage;
+    /**
+     * Make a GET request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts')
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const contacts = await client.get<Contact[]>('/contacts', {
+     *   params: { limit: 10 }
+     * });
+     * ```
+     */
+    get<T>(path: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a POST request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts')
+     * @param data - Request body data
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const newContact = await client.post<Contact>('/contacts', {
+     *   name: 'John Doe',
+     *   email: 'john@example.com'
+     * });
+     * ```
+     */
+    post<T>(path: string, data: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a PATCH request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts/123')
+     * @param data - Request body data with fields to update
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const updatedContact = await client.patch<Contact>('/contacts/123', {
+     *   name: 'Jane Doe'
+     * });
+     * ```
+     */
+    patch<T>(path: string, data: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a DELETE request to the Salesflare API
+     *
+     * @template T - Expected response type (often void or empty object)
+     * @param path - API endpoint path (e.g., '/contacts/123')
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication or API errors
+     *
+     * @example
+     * ```typescript
+     * await client.delete('/contacts/123');
+     * ```
+     */
+    delete<T>(path: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Wrap an unknown error in a SalesflareError
+     *
+     * @param error - The error to wrap
+     * @returns SalesflareError with appropriate code and message
+     * @private
+     */
+    private wrapError;
+    /**
+     * Get the current authentication provider
+     *
+     * @returns The AuthProvider instance
+     */
+    getAuthProvider(): AuthProvider;
+    /**
+     * Get the base URL for API requests
+     *
+     * @returns The configured base URL
+     */
+    getBaseURL(): string;
+}
+/**
+ * Factory function to create a configured SalesflareClient
+ *
+ * Convenience function for creating a new client instance with the given
+ * configuration. Validates required options and provides sensible defaults.
+ *
+ * @param config - Client configuration
+ * @returns Configured SalesflareClient instance
+ * @throws {SalesflareError} If required configuration is missing
+ *
+ * @example
+ * ```typescript
+ * const client = createSalesflareClient({
+ *   authProvider: apiKeyAuth,
+ *   timeout: 30000,
+ *   maxRetries: 3,
+ * });
+ * ```
+ */
+export declare function createSalesflareClient(config: SalesflareClientConfig): SalesflareClient;
+//# sourceMappingURL=salesflare-client.d.ts.map

package/dist/client/salesflare-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesflare-client.d.ts","sourceRoot":"","sources":["../../src/client/salesflare-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAc,EAEZ,kBAAkB,EAGnB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,YAAY,EAAE,YAAY,CAAC;IAC3B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAC3B,uCAAuC;IACvC,OAAO,CAAC,KAAK,CAAgB;IAC7B,2BAA2B;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,oDAAoD;IACpD,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;OAIG;gBACS,MAAM,EAAE,sBAAsB;IAmC1C;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IA+FhC;;;;;;;;;OASG;YACW,oBAAoB;IAmElC;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;;;;;;;;;;;;OAeG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYnE;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYnF;;;;;;;;;;;;;;;;OAgBG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYpF;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYtE;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAsBjB;;;;OAIG;IACH,eAAe,IAAI,YAAY;IAI/B;;;;OAIG;IACH,UAAU,IAAI,MAAM;CAGrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAEvF"}

package/dist/client/salesflare-client.js

@@ -0,0 +1,484 @@
+/**
+ * Salesflare API Client
+ *
+ * Provides a robust HTTP client for communicating with the Salesflare API.
+ * Features:
+ * - Automatic authentication via AuthProvider
+ * - Exponential backoff retry for rate limiting (429 responses)
+ * - Comprehensive error translation to SalesflareError
+ * - Type-safe HTTP methods with generics
+ *
+ * Per D-10, D-11: Verbose error responses with specific error codes.
+ * Per D-12: Includes retryable flag for LLM error handling.
+ *
+ * @module client/salesflare-client
+ */
+import axios from 'axios';
+import { SalesflareError, ErrorCode } from '../utils/errors.js';
+/**
+ * Salesflare API client with automatic retry and error handling
+ *
+ * Provides type-safe HTTP methods for communicating with the Salesflare API.
+ * Automatically handles authentication, rate limiting with exponential backoff,
+ * and error translation.
+ *
+ * @class
+ * @example
+ * ```typescript
+ * const client = new SalesflareClient({
+ *   authProvider: apiKeyAuth,
+ *   baseURL: 'https://api.salesflare.com',
+ *   timeout: 30000,
+ *   maxRetries: 3,
+ * });
+ *
+ * const contacts = await client.get<Contact[]>('/contacts');
+ * ```
+ */
+export class SalesflareClient {
+    /** Axios instance for HTTP requests */
+    axios;
+    /** Client configuration */
+    config;
+    /** Retry attempt counter for exponential backoff */
+    retryCount = 0;
+    /**
+     * Create a new SalesflareClient instance
+     *
+     * @param config - Client configuration including auth provider
+     */
+    constructor(config) {
+        this.config = {
+            baseURL: 'https://api.salesflare.com',
+            timeout: 30000,
+            maxRetries: 3,
+            ...config,
+        };
+        // Validate required auth provider
+        if (!this.config.authProvider) {
+            throw new SalesflareError({
+                code: ErrorCode.AUTH_REQUIRED,
+                message: 'AuthProvider is required for SalesflareClient',
+                fix: 'Provide an AuthProvider instance (ApiKeyAuth or OAuthAuth)',
+                retryable: false,
+            });
+        }
+        // Create axios instance with base configuration
+        this.axios = axios.create({
+            baseURL: this.config.baseURL,
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+        });
+        // Setup request interceptor for authentication
+        this.setupRequestInterceptor();
+        // Setup response interceptor for error handling
+        this.setupResponseInterceptor();
+    }
+    /**
+     * Setup request interceptor to add authentication headers
+     *
+     * Automatically calls AuthProvider.getAuthHeaders() for each request
+     * and merges the headers into the request config.
+     *
+     * @private
+     */
+    setupRequestInterceptor() {
+        this.axios.interceptors.request.use(async (config) => {
+            try {
+                const authHeaders = await this.config.authProvider.getAuthHeaders();
+                // Merge auth headers into request config
+                config.headers = config.headers || {};
+                Object.entries(authHeaders).forEach(([key, value]) => {
+                    config.headers[key] = value;
+                });
+                return config;
+            }
+            catch (error) {
+                // Handle auth header retrieval errors
+                if (error instanceof SalesflareError) {
+                    throw error;
+                }
+                throw new SalesflareError({
+                    code: ErrorCode.AUTH_INVALID,
+                    message: 'Failed to get authentication headers',
+                    fix: 'Check your authentication configuration',
+                    retryable: false,
+                });
+            }
+        }, (error) => Promise.reject(error));
+    }
+    /**
+     * Setup response interceptor for error handling and retry logic
+     *
+     * Handles various HTTP errors and implements exponential backoff
+     * for rate-limited requests (429 responses).
+     *
+     * @private
+     */
+    setupResponseInterceptor() {
+        this.axios.interceptors.response.use((response) => {
+            // Reset retry count on successful response
+            this.retryCount = 0;
+            return response;
+        }, async (error) => {
+            // Handle network errors (no response received)
+            if (!error.response) {
+                throw new SalesflareError({
+                    code: ErrorCode.NETWORK_ERROR,
+                    message: 'Network error: Unable to connect to Salesflare API',
+                    fix: 'Check your internet connection and try again',
+                    retryable: true,
+                });
+            }
+            const { status, data } = error.response;
+            const errorData = data;
+            // Handle specific HTTP status codes
+            switch (status) {
+                case 401:
+                    throw new SalesflareError({
+                        code: ErrorCode.AUTH_EXPIRED,
+                        message: 'Authentication expired or invalid',
+                        fix: 'Check your SALESFLARE_API_KEY environment variable or re-authenticate',
+                        retryable: false,
+                        statusCode: 401,
+                        details: errorData,
+                    });
+                case 403:
+                    throw new SalesflareError({
+                        code: ErrorCode.AUTH_INVALID,
+                        message: 'Access forbidden: insufficient permissions',
+                        fix: 'Verify your API key has the required permissions',
+                        retryable: false,
+                        statusCode: 403,
+                        details: errorData,
+                    });
+                case 404:
+                    throw new SalesflareError({
+                        code: ErrorCode.NOT_FOUND,
+                        message: `Resource not found: ${error.config?.url || 'unknown path'}`,
+                        fix: 'Verify the resource ID is correct and the resource exists',
+                        retryable: false,
+                        statusCode: 404,
+                        details: errorData,
+                    });
+                case 429:
+                    // Rate limit - implement exponential backoff retry
+                    return this.handleRateLimitError(error);
+                case 400:
+                case 422:
+                    throw new SalesflareError({
+                        code: ErrorCode.VALIDATION_ERROR,
+                        message: `Validation error: ${this.extractErrorMessage(errorData) || 'Invalid input'}`,
+                        fix: 'Check the input parameters against the API schema',
+                        retryable: false,
+                        statusCode: status,
+                        details: errorData,
+                    });
+                case 500:
+                case 502:
+                case 503:
+                case 504:
+                    throw new SalesflareError({
+                        code: ErrorCode.SERVER_ERROR,
+                        message: `Salesflare API server error (${status})`,
+                        fix: 'The Salesflare API is experiencing issues. Try again later',
+                        retryable: true,
+                        statusCode: status,
+                        details: errorData,
+                    });
+                default:
+                    throw new SalesflareError({
+                        code: ErrorCode.API_ERROR,
+                        message: `API error (${status}): ${this.extractErrorMessage(errorData) || 'Unknown error'}`,
+                        fix: 'Check the API documentation or try again later',
+                        retryable: status >= 500, // Server errors are retryable
+                        statusCode: status,
+                        details: errorData,
+                    });
+            }
+        });
+    }
+    /**
+     * Handle rate limit errors with exponential backoff retry
+     *
+     * Implements exponential backoff with jitter for 429 responses.
+     * Maximum delay capped at 30 seconds.
+     *
+     * @param error - The Axios error for the rate-limited request
+     * @returns Promise that resolves after retry or rejects with error
+     * @private
+     */
+    async handleRateLimitError(error) {
+        const maxRetries = this.config.maxRetries || 3;
+        if (this.retryCount >= maxRetries) {
+            this.retryCount = 0;
+            throw new SalesflareError({
+                code: ErrorCode.RATE_LIMIT,
+                message: 'Rate limit exceeded. Maximum retries reached.',
+                fix: 'Wait before retrying; consider reducing request frequency',
+                retryable: true,
+                statusCode: 429,
+            });
+        }
+        // Check for Retry-After header
+        const retryAfter = error.response?.headers['retry-after'];
+        let delayMs;
+        if (retryAfter) {
+            // Parse Retry-After header (can be seconds or HTTP date)
+            const retryAfterSeconds = parseInt(retryAfter, 10);
+            if (!isNaN(retryAfterSeconds)) {
+                delayMs = retryAfterSeconds * 1000;
+            }
+            else {
+                // Parse as HTTP date
+                const retryDate = new Date(retryAfter);
+                delayMs = retryDate.getTime() - Date.now();
+            }
+        }
+        else {
+            // Exponential backoff: 2^attempt * 1000ms + jitter
+            const baseDelay = Math.pow(2, this.retryCount) * 1000;
+            // Add random jitter (0-1000ms) to prevent thundering herd
+            const jitter = Math.floor(Math.random() * 1000);
+            delayMs = baseDelay + jitter;
+        }
+        // Cap delay at 30 seconds
+        const maxDelayMs = 30000;
+        delayMs = Math.min(delayMs, maxDelayMs);
+        this.retryCount++;
+        // Wait and retry
+        await this.delay(delayMs);
+        // Retry the request
+        const config = error.config;
+        if (!config) {
+            throw new SalesflareError({
+                code: ErrorCode.RATE_LIMIT,
+                message: 'Rate limit error: unable to retry request',
+                fix: 'Try the request again manually',
+                retryable: true,
+                statusCode: 429,
+            });
+        }
+        try {
+            const response = await this.axios.request(config);
+            this.retryCount = 0;
+            return response.data;
+        }
+        catch (retryError) {
+            // If retry also fails, the interceptor will handle it again
+            throw retryError;
+        }
+    }
+    /**
+     * Delay execution for specified milliseconds
+     *
+     * @param ms - Milliseconds to delay
+     * @returns Promise that resolves after delay
+     * @private
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Extract error message from API response data
+     *
+     * @param data - Response data from API error
+     * @returns Extracted error message or undefined
+     * @private
+     */
+    extractErrorMessage(data) {
+        if (!data)
+            return undefined;
+        // Common error message fields in API responses
+        if (typeof data.message === 'string')
+            return data.message;
+        if (typeof data.error === 'string')
+            return data.error;
+        if (typeof data.error_message === 'string')
+            return data.error_message;
+        if (Array.isArray(data.errors) && data.errors.length > 0) {
+            return data.errors.join(', ');
+        }
+        return undefined;
+    }
+    /**
+     * Make a GET request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts')
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const contacts = await client.get<Contact[]>('/contacts', {
+     *   params: { limit: 10 }
+     * });
+     * ```
+     */
+    async get(path, config) {
+        try {
+            const response = await this.axios.get(path, config);
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof SalesflareError) {
+                throw error;
+            }
+            throw this.wrapError(error);
+        }
+    }
+    /**
+     * Make a POST request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts')
+     * @param data - Request body data
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const newContact = await client.post<Contact>('/contacts', {
+     *   name: 'John Doe',
+     *   email: 'john@example.com'
+     * });
+     * ```
+     */
+    async post(path, data, config) {
+        try {
+            const response = await this.axios.post(path, data, config);
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof SalesflareError) {
+                throw error;
+            }
+            throw this.wrapError(error);
+        }
+    }
+    /**
+     * Make a PATCH request to the Salesflare API
+     *
+     * @template T - Expected response type
+     * @param path - API endpoint path (e.g., '/contacts/123')
+     * @param data - Request body data with fields to update
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication, validation, or API errors
+     *
+     * @example
+     * ```typescript
+     * const updatedContact = await client.patch<Contact>('/contacts/123', {
+     *   name: 'Jane Doe'
+     * });
+     * ```
+     */
+    async patch(path, data, config) {
+        try {
+            const response = await this.axios.patch(path, data, config);
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof SalesflareError) {
+                throw error;
+            }
+            throw this.wrapError(error);
+        }
+    }
+    /**
+     * Make a DELETE request to the Salesflare API
+     *
+     * @template T - Expected response type (often void or empty object)
+     * @param path - API endpoint path (e.g., '/contacts/123')
+     * @param config - Optional Axios request configuration
+     * @returns Promise resolving to typed response data
+     * @throws {SalesflareError} On authentication or API errors
+     *
+     * @example
+     * ```typescript
+     * await client.delete('/contacts/123');
+     * ```
+     */
+    async delete(path, config) {
+        try {
+            const response = await this.axios.delete(path, config);
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof SalesflareError) {
+                throw error;
+            }
+            throw this.wrapError(error);
+        }
+    }
+    /**
+     * Wrap an unknown error in a SalesflareError
+     *
+     * @param error - The error to wrap
+     * @returns SalesflareError with appropriate code and message
+     * @private
+     */
+    wrapError(error) {
+        if (error instanceof SalesflareError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new SalesflareError({
+                code: ErrorCode.API_ERROR,
+                message: error.message,
+                fix: 'Check the API documentation or try again later',
+                retryable: false,
+            });
+        }
+        return new SalesflareError({
+            code: ErrorCode.API_ERROR,
+            message: 'An unknown error occurred',
+            fix: 'Try again or contact support',
+            retryable: false,
+        });
+    }
+    /**
+     * Get the current authentication provider
+     *
+     * @returns The AuthProvider instance
+     */
+    getAuthProvider() {
+        return this.config.authProvider;
+    }
+    /**
+     * Get the base URL for API requests
+     *
+     * @returns The configured base URL
+     */
+    getBaseURL() {
+        return this.config.baseURL || 'https://api.salesflare.com';
+    }
+}
+/**
+ * Factory function to create a configured SalesflareClient
+ *
+ * Convenience function for creating a new client instance with the given
+ * configuration. Validates required options and provides sensible defaults.
+ *
+ * @param config - Client configuration
+ * @returns Configured SalesflareClient instance
+ * @throws {SalesflareError} If required configuration is missing
+ *
+ * @example
+ * ```typescript
+ * const client = createSalesflareClient({
+ *   authProvider: apiKeyAuth,
+ *   timeout: 30000,
+ *   maxRetries: 3,
+ * });
+ * ```
+ */
+export function createSalesflareClient(config) {
+    return new SalesflareClient(config);
+}