@roxybrowser/openapi 1.0.1

package/lib/proxy/proxy-validator.js

@@ -0,0 +1,273 @@
+/**
+ * Proxy Validation Utilities
+ *
+ * Advanced proxy validation and testing tools for RoxyBrowser MCP
+ */
+import { ProxyManager } from './proxy-manager.js';
+export class ProxyValidator {
+    /**
+     * Validate a list of proxies
+     */
+    static validateProxyList(proxies) {
+        const validProxies = [];
+        const invalidProxies = [];
+        for (const proxy of proxies) {
+            const validation = ProxyManager.validateProxy(proxy);
+            if (validation.valid) {
+                validProxies.push(proxy);
+            }
+            else {
+                invalidProxies.push({ proxy, errors: validation.errors });
+            }
+        }
+        const validCount = validProxies.length;
+        const invalidCount = invalidProxies.length;
+        const totalCount = proxies.length;
+        const summary = `${validCount}/${totalCount} proxies are valid (${((validCount / totalCount) * 100).toFixed(1)}%)`;
+        return {
+            validProxies,
+            invalidProxies,
+            totalCount,
+            validCount,
+            invalidCount,
+            summary,
+        };
+    }
+    /**
+     * Parse and validate proxy string in various formats
+     */
+    static parseAndValidateProxyString(proxyString) {
+        try {
+            // Try to parse proxy string
+            const proxy = ProxyManager.parseProxyUrl(proxyString);
+            if (!proxy) {
+                // Try alternative formats
+                const altProxy = this.parseAlternativeFormats(proxyString);
+                if (!altProxy) {
+                    return {
+                        proxy: null,
+                        validation: null,
+                        error: 'Unable to parse proxy string format',
+                    };
+                }
+                const validation = ProxyManager.validateProxy(altProxy);
+                return { proxy: altProxy, validation };
+            }
+            const validation = ProxyManager.validateProxy(proxy);
+            return { proxy, validation };
+        }
+        catch (error) {
+            return {
+                proxy: null,
+                validation: null,
+                error: error instanceof Error ? error.message : 'Unknown parsing error',
+            };
+        }
+    }
+    /**
+     * Test multiple proxies and rank by performance
+     */
+    static async benchmarkProxies(proxies, options = {}) {
+        const { timeout = 10000, retries = 1, testUrl = 'http://httpbin.org/ip' } = options;
+        const results = [];
+        for (const proxy of proxies) {
+            let bestResult = null;
+            for (let attempt = 0; attempt <= retries; attempt++) {
+                const startTime = Date.now();
+                try {
+                    // Simulate proxy test (in real implementation, you'd use actual HTTP requests)
+                    const testResult = await this.simulateProxyTest(proxy, testUrl, timeout);
+                    const responseTime = Date.now() - startTime;
+                    const result = {
+                        proxy,
+                        responseTime,
+                        success: testResult.success,
+                        location: testResult.location,
+                        anonymityLevel: testResult.anonymityLevel,
+                    };
+                    if (!bestResult || (result.success && result.responseTime < bestResult.responseTime)) {
+                        bestResult = result;
+                    }
+                    if (result.success)
+                        break; // Stop retrying on success
+                }
+                catch (error) {
+                    bestResult = {
+                        proxy,
+                        responseTime: timeout,
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Test failed',
+                    };
+                }
+            }
+            if (bestResult) {
+                results.push(bestResult);
+            }
+        }
+        // Sort by success and response time
+        return results.sort((a, b) => {
+            if (a.success && !b.success)
+                return -1;
+            if (!a.success && b.success)
+                return 1;
+            return a.responseTime - b.responseTime;
+        });
+    }
+    /**
+     * Generate proxy health report
+     */
+    static generateProxyHealthReport(validationResult, benchmarkResults) {
+        let report = `## Proxy Health Report\n\n`;
+        report += `**Total Proxies:** ${validationResult.totalCount}\n`;
+        report += `**Valid:** ${validationResult.validCount}\n`;
+        report += `**Invalid:** ${validationResult.invalidCount}\n`;
+        report += `**Success Rate:** ${((validationResult.validCount / validationResult.totalCount) * 100).toFixed(1)}%\n\n`;
+        if (validationResult.invalidCount > 0) {
+            report += `### ❌ Invalid Proxies (${validationResult.invalidCount})\n\n`;
+            validationResult.invalidProxies.forEach((invalid, index) => {
+                const proxy = invalid.proxy;
+                report += `${index + 1}. **${proxy.host}:${proxy.port}** (${proxy.proxyCategory})\n`;
+                invalid.errors.forEach(error => {
+                    report += `   • ${error}\n`;
+                });
+                report += '\n';
+            });
+        }
+        if (benchmarkResults && benchmarkResults.length > 0) {
+            report += `### 🚀 Performance Results\n\n`;
+            const workingProxies = benchmarkResults.filter(r => r.success);
+            const failedProxies = benchmarkResults.filter(r => !r.success);
+            if (workingProxies.length > 0) {
+                report += `**✅ Working Proxies (${workingProxies.length}):**\n\n`;
+                workingProxies.slice(0, 10).forEach((result, index) => {
+                    report += `${index + 1}. **${result.proxy.host}:${result.proxy.port}** - ${result.responseTime}ms`;
+                    if (result.location)
+                        report += ` (${result.location})`;
+                    if (result.anonymityLevel)
+                        report += ` [${result.anonymityLevel}]`;
+                    report += '\n';
+                });
+                report += '\n';
+            }
+            if (failedProxies.length > 0) {
+                report += `**❌ Failed Proxies (${failedProxies.length}):**\n\n`;
+                failedProxies.slice(0, 5).forEach((result, index) => {
+                    report += `${index + 1}. **${result.proxy.host}:${result.proxy.port}** - ${result.error}\n`;
+                });
+                if (failedProxies.length > 5) {
+                    report += `... and ${failedProxies.length - 5} more\n`;
+                }
+            }
+        }
+        return report;
+    }
+    /**
+     * Get proxy recommendations based on use case
+     */
+    static getProxyRecommendations(useCase) {
+        const recommendations = {
+            social_media: {
+                recommendedTypes: ['SOCKS5', 'HTTP'],
+                settings: {
+                    proxyMethod: 'custom',
+                    ipType: 'IPV4',
+                    checkChannel: 'IP-API',
+                },
+                tips: [
+                    'Use residential proxies for better success rates',
+                    'Rotate proxies frequently to avoid detection',
+                    'Ensure proxy location matches target audience',
+                    'Test proxy anonymity level regularly',
+                ],
+            },
+            ecommerce: {
+                recommendedTypes: ['HTTP', 'HTTPS'],
+                settings: {
+                    proxyMethod: 'custom',
+                    ipType: 'IPV4',
+                    checkChannel: 'IPRust.io',
+                },
+                tips: [
+                    'Use dedicated proxies for account security',
+                    'Prefer HTTPS proxies for sensitive operations',
+                    'Test proxy stability before bulk operations',
+                    'Keep proxy sessions long for shopping carts',
+                ],
+            },
+            scraping: {
+                recommendedTypes: ['SOCKS5', 'HTTP'],
+                settings: {
+                    proxyMethod: 'custom',
+                    ipType: 'IPV4',
+                    checkChannel: 'IP123.in',
+                },
+                tips: [
+                    'Use high-anonymity proxies',
+                    'Implement proxy rotation strategy',
+                    'Monitor proxy ban rates',
+                    'Use different proxy pools for different sites',
+                ],
+            },
+            general: {
+                recommendedTypes: ['HTTP', 'SOCKS5'],
+                settings: {
+                    proxyMethod: 'custom',
+                    ipType: 'IPV4',
+                    checkChannel: 'IP-API',
+                },
+                tips: [
+                    'Test proxy speed and reliability',
+                    'Use geographically relevant proxies',
+                    'Keep backup proxies available',
+                    'Monitor proxy uptime statistics',
+                ],
+            },
+        };
+        return recommendations[useCase] || recommendations.general;
+    }
+    /**
+     * Private helper methods
+     */
+    static parseAlternativeFormats(proxyString) {
+        // Format: host:port:username:password
+        const parts = proxyString.split(':');
+        if (parts.length >= 2) {
+            const [host, port, username, password] = parts;
+            return {
+                proxyMethod: 'custom',
+                proxyCategory: 'HTTP',
+                protocol: 'HTTP',
+                ipType: 'IPV4',
+                host,
+                port,
+                proxyUserName: username,
+                proxyPassword: password,
+            };
+        }
+        return null;
+    }
+    static async simulateProxyTest(proxy, testUrl, timeout) {
+        // Simulate proxy test with basic validation
+        const isValid = proxy.host && proxy.port && proxy.proxyCategory !== 'noproxy';
+        if (!isValid) {
+            throw new Error('Invalid proxy configuration');
+        }
+        // Simulate network delay
+        await new Promise(resolve => setTimeout(resolve, Math.random() * 1000));
+        // Simulate success/failure based on proxy configuration quality
+        const hasAuth = !!(proxy.proxyUserName && proxy.proxyPassword);
+        const isGoodType = ['SOCKS5', 'HTTPS'].includes(proxy.proxyCategory || '');
+        const successRate = hasAuth ? 0.9 : 0.7;
+        const typeBonus = isGoodType ? 0.1 : 0;
+        const success = Math.random() < (successRate + typeBonus);
+        if (!success) {
+            throw new Error('Proxy connection failed');
+        }
+        return {
+            success: true,
+            location: 'Simulated Location',
+            anonymityLevel: hasAuth ? 'elite' : 'anonymous',
+        };
+    }
+}
+//# sourceMappingURL=proxy-validator.js.map

package/lib/proxy/proxy-validator.js.map

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

package/lib/roxy-client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * RoxyBrowser API Client
+ *
+ * HTTP client for RoxyBrowser REST API with authentication and error handling
+ */
+import { RoxyClientConfig, WorkspaceListResponse, BrowserListResponse, BrowserListParams, BrowserOpenParams, BrowserOpenResult, BrowserCloseParams, BrowserCreateConfig, BrowserCreateBatchResult } from './types.js';
+export declare class RoxyClient {
+    private readonly config;
+    constructor(config: RoxyClientConfig);
+    /**
+     * Make authenticated HTTP request to RoxyBrowser API
+     */
+    private makeRequest;
+    /**
+     * Get list of workspaces and projects
+     */
+    getWorkspaces(pageIndex?: number, pageSize?: number): Promise<WorkspaceListResponse>;
+    /**
+     * Get list of browsers in workspace/project
+     */
+    getBrowsers(params: BrowserListParams): Promise<BrowserListResponse>;
+    /**
+     * Open a single browser
+     */
+    openBrowser(params: BrowserOpenParams): Promise<BrowserOpenResult>;
+    /**
+     * Open multiple browsers in batch
+     */
+    openBrowsers(workspaceId: number, dirIds: string[], args?: string[]): Promise<BrowserOpenResult[]>;
+    /**
+     * Close a single browser
+     */
+    closeBrowser(params: BrowserCloseParams): Promise<void>;
+    /**
+     * Close multiple browsers in batch
+     */
+    closeBrowsers(dirIds: string[]): Promise<Array<{
+        dirId: string;
+        success: boolean;
+        error?: string;
+    }>>;
+    /**
+     * Create a single browser
+     */
+    createBrowser(config: BrowserCreateConfig): Promise<{
+        dirId: string;
+    }>;
+    /**
+     * Create multiple browsers in batch
+     */
+    createBrowsers(configs: BrowserCreateConfig[]): Promise<BrowserCreateBatchResult>;
+    /**
+     * Get browser details by ID
+     */
+    getBrowserDetail(workspaceId: number, dirId: string): Promise<any>;
+    /**
+     * Update/modify existing browser
+     */
+    updateBrowser(config: BrowserCreateConfig & {
+        dirId: string;
+    }): Promise<void>;
+    /**
+     * Delete browsers
+     */
+    deleteBrowsers(workspaceId: number, dirIds: string[]): Promise<void>;
+    /**
+     * Random fingerprint for browser
+     */
+    randomBrowserFingerprint(workspaceId: number, dirId: string): Promise<void>;
+    /**
+     * Clear browser local cache
+     */
+    clearBrowserLocalCache(dirIds: string[]): Promise<void>;
+    /**
+     * Clear browser server cache
+     */
+    clearBrowserServerCache(workspaceId: number, dirIds: string[]): Promise<void>;
+    /**
+     * Test API connectivity
+     */
+    testConnection(): Promise<boolean>;
+}
+//# sourceMappingURL=roxy-client.d.ts.map

package/lib/roxy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roxy-client.d.ts","sourceRoot":"","sources":["../src/roxy-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gBAAgB,EAEhB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EAEnB,wBAAwB,EAIzB,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,MAAM,EAAE,gBAAgB;IAiBpC;;OAEG;YACW,WAAW;IA4DzB;;OAEG;IACG,aAAa,CAAC,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUjF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB1E;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOxE;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,CAAC,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAqC/B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoB1G;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO5E;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,EAAE,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAsDpC;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAUxE;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnF;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E;;OAEG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjF;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;OAEG;IACG,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CASzC"}

package/lib/roxy-client.js

@@ -0,0 +1,306 @@
+/**
+ * RoxyBrowser API Client
+ *
+ * HTTP client for RoxyBrowser REST API with authentication and error handling
+ */
+import { RoxyApiError, ConfigError, } from './types.js';
+export class RoxyClient {
+    config;
+    constructor(config) {
+        // Validate required configuration
+        if (!config.apiKey?.trim()) {
+            throw new ConfigError('API key is required');
+        }
+        if (!config.apiHost?.trim()) {
+            throw new ConfigError('API host is required');
+        }
+        this.config = {
+            apiHost: config.apiHost.replace(/\/$/, ''), // Remove trailing slash
+            apiKey: config.apiKey,
+            timeout: config.timeout ?? 30000,
+        };
+    }
+    /**
+     * Make authenticated HTTP request to RoxyBrowser API
+     */
+    async makeRequest(endpoint, options = {}) {
+        const url = `${this.config.apiHost}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'token': this.config.apiKey, // RoxyBrowser uses 'token' header
+                    ...options.headers,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new RoxyApiError(`HTTP ${response.status}: ${response.statusText}`, response.status, await response.text().catch(() => 'Unknown error'));
+            }
+            const data = await response.json();
+            // Check API response code
+            if (data.code !== 0) {
+                throw new RoxyApiError(data.msg || 'API request failed', data.code, data);
+            }
+            return data.data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof RoxyApiError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw new RoxyApiError(`Request timeout after ${this.config.timeout}ms`, 408);
+                }
+                throw new RoxyApiError(`Network error: ${error.message}`, 0, error);
+            }
+            throw new RoxyApiError('Unknown error occurred', 0, error);
+        }
+    }
+    /**
+     * Get list of workspaces and projects
+     */
+    async getWorkspaces(pageIndex = 1, pageSize = 15) {
+        const params = new URLSearchParams({
+            page_index: pageIndex.toString(),
+            page_size: pageSize.toString(),
+        });
+        return this.makeRequest(`/browser/workspace?${params}`, {
+            method: 'GET',
+        });
+    }
+    /**
+     * Get list of browsers in workspace/project
+     */
+    async getBrowsers(params) {
+        const searchParams = new URLSearchParams();
+        searchParams.append('workspaceId', params.workspaceId.toString());
+        if (params.dirIds)
+            searchParams.append('dirIds', params.dirIds);
+        if (params.windowName)
+            searchParams.append('windowName', params.windowName);
+        if (params.sortNums)
+            searchParams.append('sortNums', params.sortNums);
+        if (params.os)
+            searchParams.append('os', params.os);
+        if (params.projectIds)
+            searchParams.append('projectIds', params.projectIds);
+        if (params.windowRemark)
+            searchParams.append('windowRemark', params.windowRemark);
+        if (params.page_index)
+            searchParams.append('page_index', params.page_index.toString());
+        if (params.page_size)
+            searchParams.append('page_size', params.page_size.toString());
+        return this.makeRequest(`/browser/list_v3?${searchParams}`, {
+            method: 'GET',
+        });
+    }
+    /**
+     * Open a single browser
+     */
+    async openBrowser(params) {
+        return this.makeRequest('/browser/open', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Open multiple browsers in batch
+     */
+    async openBrowsers(workspaceId, dirIds, args) {
+        const results = [];
+        const errors = [];
+        // Open browsers in parallel with reasonable concurrency
+        const BATCH_SIZE = 5;
+        for (let i = 0; i < dirIds.length; i += BATCH_SIZE) {
+            const batch = dirIds.slice(i, i + BATCH_SIZE);
+            const batchPromises = batch.map(async (dirId) => {
+                try {
+                    const result = await this.openBrowser({ workspaceId, dirId, args });
+                    return { dirId, result };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+                    return { dirId, error: errorMsg };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            for (const item of batchResults) {
+                if ('result' in item && item.result) {
+                    results.push(item.result);
+                }
+                else if ('error' in item) {
+                    errors.push({ dirId: item.dirId, error: item.error });
+                }
+            }
+        }
+        if (errors.length > 0) {
+            console.warn('Some browsers failed to open:', errors);
+        }
+        return results;
+    }
+    /**
+     * Close a single browser
+     */
+    async closeBrowser(params) {
+        await this.makeRequest('/browser/close', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Close multiple browsers in batch
+     */
+    async closeBrowsers(dirIds) {
+        const results = [];
+        // Close browsers in parallel
+        const closePromises = dirIds.map(async (dirId) => {
+            try {
+                await this.closeBrowser({ dirId });
+                return { dirId, success: true };
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+                return { dirId, success: false, error: errorMsg };
+            }
+        });
+        const closeResults = await Promise.all(closePromises);
+        results.push(...closeResults);
+        return results;
+    }
+    /**
+     * Create a single browser
+     */
+    async createBrowser(config) {
+        return this.makeRequest('/browser/create', {
+            method: 'POST',
+            body: JSON.stringify(config),
+        });
+    }
+    /**
+     * Create multiple browsers in batch
+     */
+    async createBrowsers(configs) {
+        const results = [];
+        const errors = [];
+        // Create browsers in parallel with reasonable concurrency
+        const BATCH_SIZE = 3;
+        for (let i = 0; i < configs.length; i += BATCH_SIZE) {
+            const batch = configs.slice(i, i + BATCH_SIZE);
+            const batchPromises = batch.map(async (config, batchIndex) => {
+                try {
+                    const result = await this.createBrowser(config);
+                    return {
+                        dirId: result.dirId,
+                        windowName: config.windowName || `Browser-${i + batchIndex + 1}`,
+                        success: true,
+                    };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+                    errors.push({ config, error: errorMsg });
+                    return {
+                        dirId: '',
+                        windowName: config.windowName || `Browser-${i + batchIndex + 1}`,
+                        success: false,
+                        error: errorMsg,
+                    };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            results.push(...batchResults);
+            // Add small delay between batches to avoid overwhelming the API
+            if (i + BATCH_SIZE < configs.length) {
+                await new Promise(resolve => setTimeout(resolve, 1000));
+            }
+        }
+        const successCount = results.filter(r => r.success).length;
+        const failureCount = results.filter(r => !r.success).length;
+        // If there were errors and some successes, log warnings
+        if (errors.length > 0) {
+            console.warn(`${errors.length} browser creation(s) failed:`, errors);
+        }
+        return {
+            results,
+            successCount,
+            failureCount,
+            total: configs.length,
+        };
+    }
+    /**
+     * Get browser details by ID
+     */
+    async getBrowserDetail(workspaceId, dirId) {
+        const params = new URLSearchParams({
+            workspaceId: workspaceId.toString(),
+            dirId,
+        });
+        return this.makeRequest(`/browser/detail?${params}`, {
+            method: 'GET',
+        });
+    }
+    /**
+     * Update/modify existing browser
+     */
+    async updateBrowser(config) {
+        await this.makeRequest('/browser/mdf', {
+            method: 'POST',
+            body: JSON.stringify(config),
+        });
+    }
+    /**
+     * Delete browsers
+     */
+    async deleteBrowsers(workspaceId, dirIds) {
+        await this.makeRequest('/browser/delete', {
+            method: 'POST',
+            body: JSON.stringify({ workspaceId, dirIds }),
+        });
+    }
+    /**
+     * Random fingerprint for browser
+     */
+    async randomBrowserFingerprint(workspaceId, dirId) {
+        await this.makeRequest('/browser/random_env', {
+            method: 'POST',
+            body: JSON.stringify({ workspaceId, dirId }),
+        });
+    }
+    /**
+     * Clear browser local cache
+     */
+    async clearBrowserLocalCache(dirIds) {
+        await this.makeRequest('/browser/clear_local_cache', {
+            method: 'POST',
+            body: JSON.stringify({ dirIds }),
+        });
+    }
+    /**
+     * Clear browser server cache
+     */
+    async clearBrowserServerCache(workspaceId, dirIds) {
+        await this.makeRequest('/browser/clear_server_cache', {
+            method: 'POST',
+            body: JSON.stringify({ workspaceId, dirIds }),
+        });
+    }
+    /**
+     * Test API connectivity
+     */
+    async testConnection() {
+        try {
+            await this.makeRequest('/health');
+            return true;
+        }
+        catch (error) {
+            console.error('Connection test failed:', error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=roxy-client.js.map