@roxybrowser/openapi 1.0.1

package/lib/browser/browser-creator.js

@@ -0,0 +1,286 @@
+/**
+ * Browser Creator Service
+ *
+ * Handles browser creation with different complexity levels and configuration building
+ */
+export class BrowserCreator {
+    /**
+     * Convert simple parameters to full browser configuration
+     */
+    static buildSimpleConfig(params) {
+        const config = {
+            workspaceId: params.workspaceId,
+        };
+        // Add optional basic fields
+        if (params.windowName)
+            config.windowName = params.windowName;
+        if (params.projectId)
+            config.projectId = params.projectId;
+        if (params.windowRemark)
+            config.windowRemark = params.windowRemark;
+        // Convert simple proxy parameters to ProxyInfo
+        if (params.proxyHost || params.proxyPort) {
+            config.proxyInfo = {
+                proxyMethod: 'custom',
+                proxyCategory: params.proxyType || 'HTTP',
+                protocol: params.proxyType || 'HTTP',
+                host: params.proxyHost,
+                port: params.proxyPort,
+                proxyUserName: params.proxyUserName,
+                proxyPassword: params.proxyPassword,
+                ipType: 'IPV4',
+            };
+        }
+        return config;
+    }
+    /**
+     * Convert standard parameters to full browser configuration
+     */
+    static buildStandardConfig(params) {
+        const config = {
+            workspaceId: params.workspaceId,
+        };
+        // Add all standard fields
+        if (params.windowName)
+            config.windowName = params.windowName;
+        if (params.projectId)
+            config.projectId = params.projectId;
+        if (params.windowRemark)
+            config.windowRemark = params.windowRemark;
+        if (params.os)
+            config.os = params.os;
+        if (params.osVersion)
+            config.osVersion = params.osVersion;
+        if (params.coreVersion)
+            config.coreVersion = params.coreVersion;
+        if (params.defaultOpenUrl)
+            config.defaultOpenUrl = params.defaultOpenUrl;
+        // Add proxy configuration
+        if (params.proxyInfo) {
+            config.proxyInfo = params.proxyInfo;
+        }
+        // Build fingerprint configuration for common settings
+        if (params.openWidth || params.openHeight || params.language || params.timeZone) {
+            config.fingerInfo = {};
+            if (params.openWidth)
+                config.fingerInfo.openWidth = params.openWidth;
+            if (params.openHeight)
+                config.fingerInfo.openHeight = params.openHeight;
+            if (params.language) {
+                config.fingerInfo.isLanguageBaseIp = false;
+                config.fingerInfo.language = params.language;
+            }
+            if (params.timeZone) {
+                config.fingerInfo.isTimeZone = false;
+                config.fingerInfo.timeZone = params.timeZone;
+            }
+        }
+        return config;
+    }
+    /**
+     * Advanced configuration - pass through as-is
+     */
+    static buildAdvancedConfig(params) {
+        return params;
+    }
+    /**
+     * Generate unique browser name
+     */
+    static generateBrowserName(prefix, index) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
+        const randomSuffix = Math.random().toString(36).substring(2, 8);
+        if (prefix && index !== undefined) {
+            return `${prefix}-${index + 1}-${timestamp}`;
+        }
+        else if (prefix) {
+            return `${prefix}-${timestamp}-${randomSuffix}`;
+        }
+        else {
+            return `Browser-${timestamp}-${randomSuffix}`;
+        }
+    }
+    /**
+     * Assign proxies from a list to multiple browser configurations
+     */
+    static assignProxiesToConfigs(configs, proxyList) {
+        if (!proxyList.length) {
+            return configs;
+        }
+        return configs.map((config, index) => ({
+            ...config,
+            proxyInfo: proxyList[index % proxyList.length], // Round-robin proxy assignment
+        }));
+    }
+    /**
+     * Validate browser configuration
+     */
+    static validateConfig(config) {
+        const errors = [];
+        // Required fields
+        if (!config.workspaceId) {
+            errors.push('workspaceId is required');
+        }
+        // Proxy validation
+        if (config.proxyInfo) {
+            const proxy = config.proxyInfo;
+            if (proxy.proxyCategory !== 'noproxy') {
+                if (!proxy.host)
+                    errors.push('Proxy host is required when proxy is enabled');
+                if (!proxy.port)
+                    errors.push('Proxy port is required when proxy is enabled');
+            }
+        }
+        // OS version compatibility
+        if (config.os && config.osVersion) {
+            const validVersions = this.getValidOSVersions(config.os);
+            if (validVersions && !validVersions.includes(config.osVersion)) {
+                errors.push(`Invalid OS version '${config.osVersion}' for OS '${config.os}'`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Get valid OS versions for a given operating system
+     */
+    static getValidOSVersions(os) {
+        const osVersionMap = {
+            Windows: ['11', '10', '8', '7'],
+            macOS: [
+                '15.3.2', '15.3.1', '15.3', '15.2', '15.1', '15.0.1', '15.0',
+                '14.7.4', '14.7.3', '14.7.2', '14.7.1', '14.7', '14.6.1', '14.6',
+                '14.5', '14.4.1', '14.4', '14.3.1', '14.3', '14.2.1', '14.2', '14.1',
+                '13.7.4', '13.7.3', '13.7.2', '13.7.1', '13.7'
+            ],
+            Android: ['14', '13', '12', '11', '10', '9'],
+            IOS: [
+                '18.2', '18.1', '18.0', '17.0', '16.6', '16.5', '16.4', '16.3', '16.2',
+                '16.1', '16.0', '15.7', '15.6', '15.5', '15.4', '15.3', '15.2', '15.1',
+                '15.0', '14.7', '14.6', '14.5', '14.4', '14.3', '14.2', '14.1', '14.0'
+            ],
+            Linux: [], // Linux versions are more flexible, skip validation
+        };
+        return osVersionMap[os] || null;
+    }
+    /**
+     * Apply smart defaults to configuration
+     */
+    static applyDefaults(config) {
+        const defaultConfig = {
+            os: 'Windows',
+            osVersion: '11',
+            coreVersion: '125',
+            searchEngine: 'Google',
+            // Default fingerprint settings
+            fingerInfo: {
+                isLanguageBaseIp: true,
+                isDisplayLanguageBaseIp: true,
+                isTimeZone: true,
+                position: 1,
+                isPositionBaseIp: true,
+                forbidAudio: true,
+                forbidImage: true,
+                forbidMedia: true,
+                openWidth: '1000',
+                openHeight: '1000',
+                openBookmarks: false,
+                positionSwitch: true,
+                isDisplayName: false,
+                syncBookmark: false,
+                syncHistory: false,
+                syncTab: true,
+                syncCookie: true,
+                syncExtensions: false,
+                syncPassword: true,
+                syncIndexedDb: false,
+                syncLocalStorage: false,
+                clearCacheFile: false,
+                clearCookie: false,
+                clearLocalStorage: false,
+                randomFingerprint: false,
+                forbidSavePassword: true,
+                stopOpenNet: false,
+                stopOpenIP: false,
+                stopOpenPosition: false,
+                openWorkbench: 1,
+                resolutionType: false,
+                fontType: false,
+                webRTC: 2,
+                webGL: true,
+                webGLInfo: true,
+                webGpu: 'webgl',
+                canvas: true,
+                audioContext: true,
+                speechVoices: true,
+                doNotTrack: true,
+                clientRects: true,
+                deviceInfo: true,
+                deviceNameSwitch: true,
+                macInfo: true,
+                disableSsl: false,
+                portScanProtect: true,
+                useGpu: true,
+                sandboxPermission: false,
+            },
+            // Default proxy settings
+            proxyInfo: {
+                proxyMethod: 'custom',
+                proxyCategory: 'noproxy',
+                ipType: 'IPV4',
+            },
+        };
+        // Deep merge configuration with defaults
+        const result = { ...defaultConfig, ...config };
+        // Merge fingerInfo and proxyInfo specifically
+        if (defaultConfig.fingerInfo && config.fingerInfo) {
+            result.fingerInfo = { ...defaultConfig.fingerInfo, ...config.fingerInfo };
+        }
+        if (defaultConfig.proxyInfo && config.proxyInfo) {
+            result.proxyInfo = { ...defaultConfig.proxyInfo, ...config.proxyInfo };
+        }
+        return result;
+    }
+    /**
+     * Create multiple browser configuration objects from template parameters
+     */
+    static buildConfigsFromTemplate(params, templateConfig) {
+        const count = params.count || 1;
+        const configs = [];
+        for (let i = 0; i < count; i++) {
+            const baseConfig = {
+                workspaceId: params.workspaceId,
+                projectId: params.projectId,
+                windowName: this.generateBrowserName(params.namePrefix, i),
+                ...templateConfig,
+                ...params.customConfig,
+            };
+            // Apply defaults and validate
+            const config = this.applyDefaults(baseConfig);
+            configs.push(config);
+        }
+        // Assign proxies if provided
+        if (params.proxyList && params.proxyList.length > 0) {
+            return this.assignProxiesToConfigs(configs, params.proxyList);
+        }
+        return configs;
+    }
+    /**
+     * Batch validate multiple configurations
+     */
+    static validateConfigs(configs) {
+        const allErrors = [];
+        configs.forEach((config, index) => {
+            const validation = this.validateConfig(config);
+            if (!validation.valid) {
+                allErrors.push({ index, errors: validation.errors });
+            }
+        });
+        return {
+            valid: allErrors.length === 0,
+            errors: allErrors,
+        };
+    }
+}
+//# sourceMappingURL=browser-creator.js.map

package/lib/browser/browser-creator.js.map

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

package/lib/browser/template-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Browser Template Manager
+ *
+ * Provides predefined browser templates for common use cases
+ */
+import { BrowserTemplate, BrowserTemplateType, BrowserCreateConfig, ProxyInfo } from '../types.js';
+export declare class TemplateManager {
+    private static templates;
+    /**
+     * Get available template names and descriptions
+     */
+    static getAvailableTemplates(): Array<{
+        name: BrowserTemplateType;
+        description: string;
+    }>;
+    /**
+     * Get template configuration by name
+     */
+    static getTemplate(templateName: BrowserTemplateType): BrowserTemplate | null;
+    /**
+     * Get template configuration merged with custom overrides
+     */
+    static getTemplateConfig(templateName: BrowserTemplateType, customConfig?: Partial<BrowserCreateConfig>): Partial<BrowserCreateConfig>;
+    /**
+     * Create a custom template
+     */
+    static createCustomTemplate(name: string, description: string, config: Partial<BrowserCreateConfig>): BrowserTemplate;
+    /**
+     * Get template optimized for specific proxy configuration
+     */
+    static getTemplateForProxy(templateName: BrowserTemplateType, proxyInfo: ProxyInfo): Partial<BrowserCreateConfig>;
+    /**
+     * Get template optimized for specific country/region
+     */
+    static getTemplateForRegion(templateName: BrowserTemplateType, countryCode: string, language?: string): Partial<BrowserCreateConfig>;
+    /**
+     * Get regional settings by country code
+     */
+    private static getRegionalSettings;
+    /**
+     * Validate template configuration
+     */
+    static validateTemplate(template: BrowserTemplate): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=template-manager.d.ts.map

package/lib/browser/template-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-manager.d.ts","sourceRoot":"","sources":["../../src/browser/template-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EAEV,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAqLtB;IAEF;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI;IAI7E;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,YAAY,EAAE,mBAAmB,EACjC,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC1C,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACnC,eAAe;IAQlB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,mBAAmB,EACjC,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAuB/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAqBlC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAsBzF"}

package/lib/browser/template-manager.js

@@ -0,0 +1,324 @@
+/**
+ * Browser Template Manager
+ *
+ * Provides predefined browser templates for common use cases
+ */
+export class TemplateManager {
+    static templates = {
+        gmail: {
+            name: 'gmail',
+            description: 'Optimized for Gmail and Google services automation',
+            defaultConfig: {
+                windowName: 'Gmail Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+                searchEngine: 'Google',
+                defaultOpenUrl: ['https://gmail.com'],
+                fingerInfo: {
+                    language: 'en-US',
+                    isLanguageBaseIp: false,
+                    displayLanguage: 'en-US',
+                    isDisplayLanguageBaseIp: false,
+                    openWidth: '1400',
+                    openHeight: '900',
+                    syncCookie: true,
+                    syncPassword: true,
+                    syncTab: true,
+                    clearCacheFile: false,
+                    clearCookie: false,
+                    randomFingerprint: true,
+                    forbidSavePassword: false, // Allow password saving for Gmail
+                    webRTC: 1, // Real WebRTC for Google services
+                    canvas: true,
+                    audioContext: true,
+                    doNotTrack: false, // Don't use DNT for better compatibility
+                },
+            },
+        },
+        facebook: {
+            name: 'facebook',
+            description: 'Optimized for Facebook and Meta platform automation',
+            defaultConfig: {
+                windowName: 'Facebook Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+                searchEngine: 'Google',
+                defaultOpenUrl: ['https://facebook.com'],
+                fingerInfo: {
+                    language: 'en-US',
+                    isLanguageBaseIp: false,
+                    displayLanguage: 'en-US',
+                    isDisplayLanguageBaseIp: false,
+                    openWidth: '1366',
+                    openHeight: '768',
+                    syncCookie: true,
+                    syncPassword: true,
+                    syncTab: true,
+                    clearCacheFile: false,
+                    clearCookie: false,
+                    randomFingerprint: true,
+                    forbidSavePassword: false,
+                    webRTC: 1, // Real WebRTC for video calls
+                    canvas: true,
+                    audioContext: true,
+                    deviceInfo: true, // Allow media devices
+                    forbidAudio: false, // Allow audio for Facebook features
+                    forbidMedia: false, // Allow video for Facebook features
+                    doNotTrack: false,
+                },
+            },
+        },
+        ecommerce: {
+            name: 'ecommerce',
+            description: 'Optimized for e-commerce platforms and shopping automation',
+            defaultConfig: {
+                windowName: 'Shopping Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+                searchEngine: 'Google',
+                defaultOpenUrl: ['https://amazon.com'],
+                fingerInfo: {
+                    language: 'en-US',
+                    isLanguageBaseIp: false,
+                    displayLanguage: 'en-US',
+                    isDisplayLanguageBaseIp: false,
+                    openWidth: '1920',
+                    openHeight: '1080',
+                    syncCookie: true,
+                    syncPassword: true,
+                    syncTab: false, // Don't sync tabs for privacy
+                    clearCacheFile: true, // Clear cache for fresh sessions
+                    clearCookie: false,
+                    randomFingerprint: true,
+                    forbidSavePassword: true, // Security for shopping
+                    webRTC: 2, // Disable WebRTC for privacy
+                    canvas: true,
+                    audioContext: true,
+                    deviceInfo: false, // Limit device fingerprinting
+                    doNotTrack: true, // Enable DNT for privacy
+                    portScanProtect: true, // Extra security
+                },
+            },
+        },
+        social_media: {
+            name: 'social_media',
+            description: 'General social media platforms automation',
+            defaultConfig: {
+                windowName: 'Social Media Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+                searchEngine: 'Google',
+                defaultOpenUrl: ['https://twitter.com'],
+                fingerInfo: {
+                    language: 'en-US',
+                    isLanguageBaseIp: true, // Follow IP for better geo-targeting
+                    displayLanguage: 'en-US',
+                    isDisplayLanguageBaseIp: true,
+                    isTimeZone: true, // Follow IP timezone
+                    openWidth: '1200',
+                    openHeight: '800',
+                    syncCookie: true,
+                    syncPassword: false, // Don't save passwords
+                    syncTab: true,
+                    clearCacheFile: false,
+                    clearCookie: false,
+                    randomFingerprint: true,
+                    forbidSavePassword: true,
+                    webRTC: 0, // Replace WebRTC
+                    canvas: true,
+                    audioContext: true,
+                    deviceInfo: true,
+                    forbidAudio: false,
+                    forbidMedia: false,
+                    doNotTrack: false,
+                },
+            },
+        },
+        general: {
+            name: 'general',
+            description: 'General-purpose browser configuration',
+            defaultConfig: {
+                windowName: 'General Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+                searchEngine: 'Google',
+                fingerInfo: {
+                    language: 'en-US',
+                    isLanguageBaseIp: true,
+                    displayLanguage: 'en-US',
+                    isDisplayLanguageBaseIp: true,
+                    isTimeZone: true,
+                    openWidth: '1024',
+                    openHeight: '768',
+                    syncCookie: true,
+                    syncPassword: true,
+                    syncTab: true,
+                    clearCacheFile: false,
+                    clearCookie: false,
+                    randomFingerprint: false, // Keep consistent fingerprint
+                    forbidSavePassword: true,
+                    webRTC: 2, // Disable for privacy
+                    canvas: true,
+                    audioContext: true,
+                    deviceInfo: true,
+                    doNotTrack: true,
+                },
+            },
+        },
+        custom: {
+            name: 'custom',
+            description: 'Empty template for custom configuration',
+            defaultConfig: {
+                windowName: 'Custom Browser',
+                os: 'Windows',
+                osVersion: '11',
+                coreVersion: '125',
+            },
+        },
+    };
+    /**
+     * Get available template names and descriptions
+     */
+    static getAvailableTemplates() {
+        return Object.values(this.templates).map(template => ({
+            name: template.name,
+            description: template.description,
+        }));
+    }
+    /**
+     * Get template configuration by name
+     */
+    static getTemplate(templateName) {
+        return this.templates[templateName] || null;
+    }
+    /**
+     * Get template configuration merged with custom overrides
+     */
+    static getTemplateConfig(templateName, customConfig) {
+        const template = this.getTemplate(templateName);
+        if (!template) {
+            throw new Error(`Template '${templateName}' not found`);
+        }
+        if (!customConfig) {
+            return template.defaultConfig;
+        }
+        // Deep merge template config with custom config
+        const mergedConfig = { ...template.defaultConfig, ...customConfig };
+        // Special handling for nested objects
+        if (template.defaultConfig.fingerInfo && customConfig.fingerInfo) {
+            mergedConfig.fingerInfo = {
+                ...template.defaultConfig.fingerInfo,
+                ...customConfig.fingerInfo,
+            };
+        }
+        if (template.defaultConfig.proxyInfo && customConfig.proxyInfo) {
+            mergedConfig.proxyInfo = {
+                ...template.defaultConfig.proxyInfo,
+                ...customConfig.proxyInfo,
+            };
+        }
+        if (template.defaultConfig.windowPlatformList && customConfig.windowPlatformList) {
+            mergedConfig.windowPlatformList = [
+                ...(template.defaultConfig.windowPlatformList || []),
+                ...(customConfig.windowPlatformList || []),
+            ];
+        }
+        return mergedConfig;
+    }
+    /**
+     * Create a custom template
+     */
+    static createCustomTemplate(name, description, config) {
+        return {
+            name: 'custom',
+            description,
+            defaultConfig: config,
+        };
+    }
+    /**
+     * Get template optimized for specific proxy configuration
+     */
+    static getTemplateForProxy(templateName, proxyInfo) {
+        const baseConfig = this.getTemplateConfig(templateName);
+        // Apply proxy-specific optimizations
+        const optimizedConfig = { ...baseConfig };
+        // If using proxy, adjust some settings for better anonymity
+        if (proxyInfo.proxyCategory !== 'noproxy') {
+            optimizedConfig.fingerInfo = {
+                ...optimizedConfig.fingerInfo,
+                isLanguageBaseIp: true, // Follow proxy IP for language
+                isDisplayLanguageBaseIp: true,
+                isTimeZone: true, // Follow proxy timezone
+                isPositionBaseIp: true, // Follow proxy geolocation
+                webRTC: 2, // Disable WebRTC to prevent IP leaks
+                doNotTrack: true, // Enable DNT for privacy
+            };
+        }
+        optimizedConfig.proxyInfo = proxyInfo;
+        return optimizedConfig;
+    }
+    /**
+     * Get template optimized for specific country/region
+     */
+    static getTemplateForRegion(templateName, countryCode, language) {
+        const baseConfig = this.getTemplateConfig(templateName);
+        const optimizedConfig = { ...baseConfig };
+        // Regional optimizations
+        const regionalSettings = this.getRegionalSettings(countryCode);
+        optimizedConfig.fingerInfo = {
+            ...optimizedConfig.fingerInfo,
+            isLanguageBaseIp: false,
+            language: language || regionalSettings.language,
+            isDisplayLanguageBaseIp: false,
+            displayLanguage: language || regionalSettings.language,
+            isTimeZone: false,
+            timeZone: regionalSettings.timeZone,
+        };
+        return optimizedConfig;
+    }
+    /**
+     * Get regional settings by country code
+     */
+    static getRegionalSettings(countryCode) {
+        const regionalMap = {
+            US: { language: 'en-US', timeZone: 'GMT-5:00 America/New_York' },
+            CN: { language: 'zh-CN', timeZone: 'GMT+8:00 Asia/Shanghai' },
+            JP: { language: 'ja-JP', timeZone: 'GMT+9:00 Asia/Tokyo' },
+            KR: { language: 'ko-KR', timeZone: 'GMT+9:00 Asia/Seoul' },
+            DE: { language: 'de-DE', timeZone: 'GMT+1:00 Europe/Berlin' },
+            FR: { language: 'fr-FR', timeZone: 'GMT+1:00 Europe/Paris' },
+            GB: { language: 'en-GB', timeZone: 'GMT+0:00 Europe/London' },
+            RU: { language: 'ru-RU', timeZone: 'GMT+3:00 Europe/Moscow' },
+            BR: { language: 'pt-BR', timeZone: 'GMT-3:00 America/Sao_Paulo' },
+            IN: { language: 'hi-IN', timeZone: 'GMT+5:30 Asia/Kolkata' },
+            // Add more regions as needed
+        };
+        return regionalMap[countryCode.toUpperCase()] || regionalMap.US;
+    }
+    /**
+     * Validate template configuration
+     */
+    static validateTemplate(template) {
+        const errors = [];
+        if (!template.name) {
+            errors.push('Template name is required');
+        }
+        if (!template.description) {
+            errors.push('Template description is required');
+        }
+        if (!template.defaultConfig) {
+            errors.push('Template default configuration is required');
+        }
+        // Additional validation can be added here
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=template-manager.js.map