ton-provider-system 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -70,6 +70,7 @@ var ProviderConfigSchema = zod.z.object({
   priority: zod.z.number().int().nonnegative().default(10),
   enabled: zod.z.boolean().default(true),
   isDynamic: zod.z.boolean().optional().default(false),
+  browserCompatible: zod.z.boolean().optional(),
   description: zod.z.string().optional()
 });
 var NetworkDefaultsSchema = zod.z.object({
@@ -217,7 +218,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) {
@@ -776,7 +778,8 @@ var HealthChecker = class {
       latencyMs: null,
       seqno: null,
       blocksBehind: 0,
-      lastTested: null
+      lastTested: null,
+      browserCompatible: provider.browserCompatible
     };
     this.results.set(key, testingResult);
     try {
@@ -836,7 +839,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(
@@ -847,6 +851,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");
@@ -861,6 +866,7 @@ var HealthChecker = class {
       } else if (isTimeout) {
         status = "offline";
       }
+      const browserCompatible = isCorsError ? false : provider.browserCompatible;
       const result = {
         id: provider.id,
         network: provider.network,
@@ -870,7 +876,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}`);
@@ -956,7 +963,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,
@@ -967,7 +975,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);
   }
@@ -983,7 +993,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,
@@ -993,7 +1004,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);
   }
@@ -1125,6 +1138,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);
@@ -1569,7 +1600,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;
@@ -1581,6 +1612,7 @@ var ProviderSelector = class {
     this.healthChecker = healthChecker;
     this.config = { ...DEFAULT_CONFIG2, ...config };
     this.logger = logger || consoleLogger4;
+    this.adapter = adapter;
   }
   // ========================================================================
   // Selection Methods
@@ -1621,9 +1653,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) => ({
@@ -1704,7 +1746,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)
@@ -1714,7 +1759,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)
@@ -1905,12 +1953,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
@@ -2017,7 +2092,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();
@@ -2284,7 +2360,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
@@ -2330,7 +2419,8 @@ var _ProviderManager = class _ProviderManager {
             latencyMs: null,
             seqno: null,
             blocksBehind: 0,
-            lastTested: null
+            lastTested: null,
+            browserCompatible: provider.browserCompatible
           },
           rateLimit: rateLimit || {
             tokens: 0,