ton-provider-system 0.1.10 → 0.1.12

package/dist/index.d.cts

@@ -59,6 +59,8 @@ interface ProviderConfig {
     enabled: boolean;
     /** Whether this provider requires dynamic endpoint discovery (e.g., Orbs) */
     isDynamic?: boolean;
+    /** Whether this provider is compatible with browser environments (default: true) */
+    browserCompatible?: boolean;
     /** Optional description or notes */
     description?: string;
 }
@@ -114,6 +116,8 @@ interface ResolvedProvider {
     priority: number;
     /** Whether dynamic discovery is needed */
     isDynamic: boolean;
+    /** Whether this provider is compatible with browser environments */
+    browserCompatible: boolean;
 }
 /**
  * Provider health check result
@@ -139,6 +143,8 @@ interface ProviderHealthResult {
     cachedEndpoint?: string;
     /** Error message if failed */
     error?: string;
+    /** Whether this provider is compatible with browser environments */
+    browserCompatible: boolean;
 }
 /**
  * Provider state for runtime tracking
@@ -357,6 +363,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     enabled: z.ZodDefault<z.ZodBoolean>;
     isDynamic: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    browserCompatible: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -374,6 +381,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     isDynamic: boolean;
     keyEnvVar?: string | undefined;
     apiKeyEnvVar?: string | undefined;
+    browserCompatible?: boolean | undefined;
     description?: string | undefined;
 }, {
     type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -391,6 +399,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     priority?: number | undefined;
     enabled?: boolean | undefined;
     isDynamic?: boolean | undefined;
+    browserCompatible?: boolean | undefined;
     description?: string | undefined;
 }>;
 /**
@@ -435,6 +444,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         isDynamic: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        browserCompatible: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -452,6 +462,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }, {
         type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -469,6 +480,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>>;
     defaults: z.ZodObject<{
@@ -499,6 +511,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -523,6 +536,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -549,6 +563,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -573,6 +588,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -1039,6 +1055,15 @@ declare class HealthChecker {
      */
     private callGetMasterchainInfo;
     private sleep;
+    /**
+     * Detect CORS errors (browser compatibility issues)
+     *
+     * CORS errors occur when:
+     * - Request header field is not allowed by Access-Control-Allow-Headers
+     * - Specifically, x-ton-client-version header is blocked by some providers
+     * - Error message contains "CORS", "Access-Control", or "x-ton-client-version"
+     */
+    private isCorsError;
 }
 /**
  * Create a health checker with default configuration
@@ -1078,12 +1103,13 @@ declare class ProviderSelector {
     private healthChecker;
     private config;
     private logger;
+    private adapter;
     private selectedProviderId;
     private autoSelect;
     private customEndpoint;
     private bestProviderByNetwork;
     private activeProviderByNetwork;
-    constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger);
+    constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger, adapter?: 'node' | 'browser');
     /**
      * Get the best provider for a network
      */
@@ -1166,11 +1192,19 @@ declare class ProviderSelector {
      * Create a pseudo-provider for custom endpoint
      */
     private createCustomProvider;
+    /**
+     * Filter providers to only include browser-compatible ones
+     *
+     * Checks both:
+     * 1. Provider config browserCompatible flag
+     * 2. Health check result browserCompatible flag (if health check was performed)
+     */
+    private filterBrowserCompatible;
 }
 /**
  * Create a provider selector
  */
-declare function createSelector(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger): ProviderSelector;
+declare function createSelector(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger, adapter?: 'node' | 'browser'): ProviderSelector;
 
 /**
  * Unified Provider System - Provider Manager

package/dist/index.d.ts

@@ -59,6 +59,8 @@ interface ProviderConfig {
     enabled: boolean;
     /** Whether this provider requires dynamic endpoint discovery (e.g., Orbs) */
     isDynamic?: boolean;
+    /** Whether this provider is compatible with browser environments (default: true) */
+    browserCompatible?: boolean;
     /** Optional description or notes */
     description?: string;
 }
@@ -114,6 +116,8 @@ interface ResolvedProvider {
     priority: number;
     /** Whether dynamic discovery is needed */
     isDynamic: boolean;
+    /** Whether this provider is compatible with browser environments */
+    browserCompatible: boolean;
 }
 /**
  * Provider health check result
@@ -139,6 +143,8 @@ interface ProviderHealthResult {
     cachedEndpoint?: string;
     /** Error message if failed */
     error?: string;
+    /** Whether this provider is compatible with browser environments */
+    browserCompatible: boolean;
 }
 /**
  * Provider state for runtime tracking
@@ -357,6 +363,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     enabled: z.ZodDefault<z.ZodBoolean>;
     isDynamic: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    browserCompatible: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -374,6 +381,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     isDynamic: boolean;
     keyEnvVar?: string | undefined;
     apiKeyEnvVar?: string | undefined;
+    browserCompatible?: boolean | undefined;
     description?: string | undefined;
 }, {
     type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -391,6 +399,7 @@ declare const ProviderConfigSchema: z.ZodObject<{
     priority?: number | undefined;
     enabled?: boolean | undefined;
     isDynamic?: boolean | undefined;
+    browserCompatible?: boolean | undefined;
     description?: string | undefined;
 }>;
 /**
@@ -435,6 +444,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         isDynamic: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        browserCompatible: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -452,6 +462,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }, {
         type: "chainstack" | "quicknode" | "toncenter" | "orbs" | "onfinality" | "ankr" | "getblock" | "tatum" | "tonhub" | "custom";
@@ -469,6 +480,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>>;
     defaults: z.ZodObject<{
@@ -499,6 +511,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -523,6 +536,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -549,6 +563,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         isDynamic: boolean;
         keyEnvVar?: string | undefined;
         apiKeyEnvVar?: string | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -573,6 +588,7 @@ declare const RpcConfigSchema: z.ZodEffects<z.ZodObject<{
         priority?: number | undefined;
         enabled?: boolean | undefined;
         isDynamic?: boolean | undefined;
+        browserCompatible?: boolean | undefined;
         description?: string | undefined;
     }>;
     defaults: {
@@ -1039,6 +1055,15 @@ declare class HealthChecker {
      */
     private callGetMasterchainInfo;
     private sleep;
+    /**
+     * Detect CORS errors (browser compatibility issues)
+     *
+     * CORS errors occur when:
+     * - Request header field is not allowed by Access-Control-Allow-Headers
+     * - Specifically, x-ton-client-version header is blocked by some providers
+     * - Error message contains "CORS", "Access-Control", or "x-ton-client-version"
+     */
+    private isCorsError;
 }
 /**
  * Create a health checker with default configuration
@@ -1078,12 +1103,13 @@ declare class ProviderSelector {
     private healthChecker;
     private config;
     private logger;
+    private adapter;
     private selectedProviderId;
     private autoSelect;
     private customEndpoint;
     private bestProviderByNetwork;
     private activeProviderByNetwork;
-    constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger);
+    constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger, adapter?: 'node' | 'browser');
     /**
      * Get the best provider for a network
      */
@@ -1166,11 +1192,19 @@ declare class ProviderSelector {
      * Create a pseudo-provider for custom endpoint
      */
     private createCustomProvider;
+    /**
+     * Filter providers to only include browser-compatible ones
+     *
+     * Checks both:
+     * 1. Provider config browserCompatible flag
+     * 2. Health check result browserCompatible flag (if health check was performed)
+     */
+    private filterBrowserCompatible;
 }
 /**
  * Create a provider selector
  */
-declare function createSelector(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger): ProviderSelector;
+declare function createSelector(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger, adapter?: 'node' | 'browser'): ProviderSelector;
 
 /**
  * Unified Provider System - Provider Manager

package/dist/index.js

@@ -67,6 +67,7 @@ var ProviderConfigSchema = z.object({
   priority: z.number().int().nonnegative().default(10),
   enabled: z.boolean().default(true),
   isDynamic: z.boolean().optional().default(false),
+  browserCompatible: z.boolean().optional(),
   description: z.string().optional()
 });
 var NetworkDefaultsSchema = z.object({
@@ -214,7 +215,8 @@ function resolveProvider(id, config) {
     apiKey,
     rps: config.rps,
     priority: config.priority,
-    isDynamic: config.isDynamic || false
+    isDynamic: config.isDynamic || false,
+    browserCompatible: config.browserCompatible !== void 0 ? config.browserCompatible : true
   };
 }
 function resolveAllProviders(config) {
@@ -773,7 +775,8 @@ var HealthChecker = class {
       latencyMs: null,
       seqno: null,
       blocksBehind: 0,
-      lastTested: null
+      lastTested: null,
+      browserCompatible: provider.browserCompatible
     };
     this.results.set(key, testingResult);
     try {
@@ -833,7 +836,8 @@ var HealthChecker = class {
         seqno,
         blocksBehind,
         lastTested: /* @__PURE__ */ new Date(),
-        cachedEndpoint: normalizedEndpoint
+        cachedEndpoint: normalizedEndpoint,
+        browserCompatible: provider.browserCompatible
       };
       this.results.set(key, result);
       this.logger.debug(
@@ -844,6 +848,7 @@ var HealthChecker = class {
       const endTime = performance.now();
       const latencyMs = Math.round(endTime - startTime);
       const errorMsg = error.message || String(error) || "Unknown error";
+      const isCorsError = this.isCorsError(error, errorMsg);
       const is429 = errorMsg.includes("429") || errorMsg.toLowerCase().includes("rate limit");
       const is404 = errorMsg.includes("404") || errorMsg.toLowerCase().includes("not found");
       const is503 = errorMsg.includes("503") || errorMsg.toLowerCase().includes("service unavailable");
@@ -858,6 +863,7 @@ var HealthChecker = class {
       } else if (isTimeout) {
         status = "offline";
       }
+      const browserCompatible = isCorsError ? false : provider.browserCompatible;
       const result = {
         id: provider.id,
         network: provider.network,
@@ -867,7 +873,8 @@ var HealthChecker = class {
         seqno: null,
         blocksBehind: 0,
         lastTested: /* @__PURE__ */ new Date(),
-        error: errorMsg
+        error: errorMsg,
+        browserCompatible
       };
       this.results.set(key, result);
       this.logger.warn(`Provider ${provider.id} health check failed: ${result.error}`);
@@ -953,7 +960,8 @@ var HealthChecker = class {
       // Degraded providers are still usable, just slower/rate-limited
       status: "degraded",
       error: error || "Marked as degraded",
-      lastTested: /* @__PURE__ */ new Date()
+      lastTested: /* @__PURE__ */ new Date(),
+      browserCompatible: existing.browserCompatible ?? true
     } : {
       id: providerId,
       network,
@@ -964,7 +972,9 @@ var HealthChecker = class {
       seqno: null,
       blocksBehind: 0,
       lastTested: /* @__PURE__ */ new Date(),
-      error: error || "Marked as degraded"
+      error: error || "Marked as degraded",
+      browserCompatible: true
+      // Default to compatible if unknown
     };
     this.results.set(key, result);
   }
@@ -980,7 +990,8 @@ var HealthChecker = class {
       success: false,
       // Ensure success is false for offline providers
       error: error || "Marked as offline",
-      lastTested: /* @__PURE__ */ new Date()
+      lastTested: /* @__PURE__ */ new Date(),
+      browserCompatible: existing.browserCompatible ?? true
     } : {
       id: providerId,
       network,
@@ -990,7 +1001,9 @@ var HealthChecker = class {
       seqno: null,
       blocksBehind: 0,
       lastTested: /* @__PURE__ */ new Date(),
-      error: error || "Marked as offline"
+      error: error || "Marked as offline",
+      browserCompatible: true
+      // Default to compatible if unknown
     };
     this.results.set(key, result);
   }
@@ -1122,6 +1135,24 @@ var HealthChecker = class {
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
+  /**
+   * Detect CORS errors (browser compatibility issues)
+   * 
+   * CORS errors occur when:
+   * - Request header field is not allowed by Access-Control-Allow-Headers
+   * - Specifically, x-ton-client-version header is blocked by some providers
+   * - Error message contains "CORS", "Access-Control", or "x-ton-client-version"
+   */
+  isCorsError(error, errorMsg) {
+    const msg = errorMsg.toLowerCase();
+    if (msg.includes("cors") || msg.includes("access-control") || msg.includes("x-ton-client-version") || msg.includes("not allowed by access-control-allow-headers") || msg.includes("blocked by cors policy")) {
+      return true;
+    }
+    if (error.name === "TypeError" && (msg.includes("failed to fetch") || msg.includes("network error"))) {
+      return false;
+    }
+    return false;
+  }
 };
 function createHealthChecker(config, logger, rateLimiter) {
   return new HealthChecker(config, logger, rateLimiter);
@@ -1566,7 +1597,7 @@ var DEFAULT_CONFIG2 = {
   minStatus: ["available", "degraded"]
 };
 var ProviderSelector = class {
-  constructor(registry, healthChecker, config, logger) {
+  constructor(registry, healthChecker, config, logger, adapter = "node") {
     // Selection state
     this.selectedProviderId = null;
     this.autoSelect = true;
@@ -1578,6 +1609,7 @@ var ProviderSelector = class {
     this.healthChecker = healthChecker;
     this.config = { ...DEFAULT_CONFIG2, ...config };
     this.logger = logger || consoleLogger4;
+    this.adapter = adapter;
   }
   // ========================================================================
   // Selection Methods
@@ -1618,9 +1650,19 @@ var ProviderSelector = class {
    * Find the best provider for a network (recalculates)
    */
   findBestProvider(network) {
-    const providers = this.registry.getProvidersForNetwork(network);
+    let providers = this.registry.getProvidersForNetwork(network);
+    if (this.adapter === "browser") {
+      const beforeCount = providers.length;
+      providers = this.filterBrowserCompatible(providers, network);
+      const filteredCount = beforeCount - providers.length;
+      if (filteredCount > 0) {
+        this.logger.debug(
+          `Filtered out ${filteredCount} browser-incompatible provider(s) for ${network}`
+        );
+      }
+    }
     if (providers.length === 0) {
-      this.logger.warn(`No providers available for ${network}`);
+      this.logger.warn(`No browser-compatible providers available for ${network}`);
       return null;
     }
     const scored = providers.map((provider) => ({
@@ -1701,7 +1743,10 @@ var ProviderSelector = class {
    * Get all available providers for a network, sorted by score
    */
   getAvailableProviders(network) {
-    const providers = this.registry.getProvidersForNetwork(network);
+    let providers = this.registry.getProvidersForNetwork(network);
+    if (this.adapter === "browser") {
+      providers = this.filterBrowserCompatible(providers, network);
+    }
     return providers.map((provider) => ({
       provider,
       score: this.scoreProvider(provider, network)
@@ -1711,7 +1756,10 @@ var ProviderSelector = class {
    * Get the next best provider (for failover)
    */
   getNextProvider(network, excludeIds) {
-    const providers = this.registry.getProvidersForNetwork(network);
+    let providers = this.registry.getProvidersForNetwork(network);
+    if (this.adapter === "browser") {
+      providers = this.filterBrowserCompatible(providers, network);
+    }
     const available = providers.filter((p) => !excludeIds.includes(p.id)).map((provider) => ({
       provider,
       score: this.scoreProvider(provider, network)
@@ -1902,12 +1950,39 @@ var ProviderSelector = class {
       endpointV2: this.customEndpoint,
       rps: 10,
       priority: 0,
-      isDynamic: false
+      isDynamic: false,
+      browserCompatible: true
+      // Custom endpoints are assumed compatible
     };
   }
+  /**
+   * Filter providers to only include browser-compatible ones
+   * 
+   * Checks both:
+   * 1. Provider config browserCompatible flag
+   * 2. Health check result browserCompatible flag (if health check was performed)
+   */
+  filterBrowserCompatible(providers, network) {
+    return providers.filter((provider) => {
+      if (!provider.browserCompatible) {
+        this.logger.debug(
+          `Provider ${provider.id} marked as browser-incompatible in config`
+        );
+        return false;
+      }
+      const health = this.healthChecker.getResult(provider.id, network);
+      if (health && health.browserCompatible === false) {
+        this.logger.debug(
+          `Provider ${provider.id} marked as browser-incompatible by health check (CORS error detected)`
+        );
+        return false;
+      }
+      return true;
+    });
+  }
 };
-function createSelector(registry, healthChecker, config, logger) {
-  return new ProviderSelector(registry, healthChecker, config, logger);
+function createSelector(registry, healthChecker, config, logger, adapter = "node") {
+  return new ProviderSelector(registry, healthChecker, config, logger, adapter);
 }
 
 // src/core/manager.ts
@@ -2014,7 +2089,8 @@ var _ProviderManager = class _ProviderManager {
       this.registry,
       this.healthChecker,
       void 0,
-      this.options.logger
+      this.options.logger,
+      this.options.adapter
     );
     this.initialized = true;
     this.notifyListeners();
@@ -2281,7 +2357,20 @@ var _ProviderManager = class _ProviderManager {
    */
   getProviders() {
     if (!this.initialized || !this.network) return [];
-    return this.registry.getProvidersForNetwork(this.network);
+    let providers = this.registry.getProvidersForNetwork(this.network);
+    if (this.options.adapter === "browser") {
+      providers = providers.filter((provider) => {
+        if (!provider.browserCompatible) {
+          return false;
+        }
+        const health = this.healthChecker.getResult(provider.id, this.network);
+        if (health && health.browserCompatible === false) {
+          return false;
+        }
+        return true;
+      });
+    }
+    return providers;
   }
   /**
    * Get provider health results for current network
@@ -2327,7 +2416,8 @@ var _ProviderManager = class _ProviderManager {
             latencyMs: null,
             seqno: null,
             blocksBehind: 0,
-            lastTested: null
+            lastTested: null,
+            browserCompatible: provider.browserCompatible
           },
           rateLimit: rateLimit || {
             tokens: 0,