ton-provider-system 0.1.7 → 0.1.9

package/dist/index.d.cts

@@ -1082,6 +1082,7 @@ declare class ProviderSelector {
     private autoSelect;
     private customEndpoint;
     private bestProviderByNetwork;
+    private activeProviderByNetwork;
     constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger);
     /**
      * Get the best provider for a network
@@ -1137,8 +1138,9 @@ declare class ProviderSelector {
     isUsingCustomEndpoint(): boolean;
     /**
      * Clear cached best providers (forces recalculation)
+     * @param network - Optional network to clear cache for. If not provided, clears all networks.
      */
-    clearCache(): void;
+    clearCache(network?: Network): void;
     /**
      * Update best provider after health check
      */
@@ -1147,6 +1149,11 @@ declare class ProviderSelector {
      * Handle provider failure (switch to next best)
      */
     handleProviderFailure(providerId: string, network: Network): ResolvedProvider | null;
+    /**
+     * Get the currently active provider ID for a network
+     * (the one that was last selected and is being used)
+     */
+    getActiveProviderId(network: Network): string | null;
     /**
      * Get active provider info
      */
@@ -1248,8 +1255,10 @@ declare class ProviderManager {
      * Get endpoint with rate limiting
      *
      * Waits for rate limit token before returning endpoint.
+     *
+     * @param forceRefresh - If true, clears cache and forces re-selection
      */
-    getEndpointWithRateLimit(timeoutMs?: number): Promise<string>;
+    getEndpointWithRateLimit(timeoutMs?: number, forceRefresh?: boolean): Promise<string>;
     /**
      * Get current active provider
      */

package/dist/index.d.ts

@@ -1082,6 +1082,7 @@ declare class ProviderSelector {
     private autoSelect;
     private customEndpoint;
     private bestProviderByNetwork;
+    private activeProviderByNetwork;
     constructor(registry: ProviderRegistry, healthChecker: HealthChecker, config?: Partial<SelectionConfig>, logger?: Logger);
     /**
      * Get the best provider for a network
@@ -1137,8 +1138,9 @@ declare class ProviderSelector {
     isUsingCustomEndpoint(): boolean;
     /**
      * Clear cached best providers (forces recalculation)
+     * @param network - Optional network to clear cache for. If not provided, clears all networks.
      */
-    clearCache(): void;
+    clearCache(network?: Network): void;
     /**
      * Update best provider after health check
      */
@@ -1147,6 +1149,11 @@ declare class ProviderSelector {
      * Handle provider failure (switch to next best)
      */
     handleProviderFailure(providerId: string, network: Network): ResolvedProvider | null;
+    /**
+     * Get the currently active provider ID for a network
+     * (the one that was last selected and is being used)
+     */
+    getActiveProviderId(network: Network): string | null;
     /**
      * Get active provider info
      */
@@ -1248,8 +1255,10 @@ declare class ProviderManager {
      * Get endpoint with rate limiting
      *
      * Waits for rate limit token before returning endpoint.
+     *
+     * @param forceRefresh - If true, clears cache and forces re-selection
      */
-    getEndpointWithRateLimit(timeoutMs?: number): Promise<string>;
+    getEndpointWithRateLimit(timeoutMs?: number, forceRefresh?: boolean): Promise<string>;
     /**
      * Get current active provider
      */

package/dist/index.js

@@ -947,14 +947,25 @@ var HealthChecker = class {
   markDegraded(providerId, network, error) {
     const key = this.getResultKey(providerId, network);
     const existing = this.results.get(key);
-    if (existing) {
-      this.results.set(key, {
-        ...existing,
-        status: "degraded",
-        error: error || "Marked as degraded",
-        lastTested: /* @__PURE__ */ new Date()
-      });
-    }
+    const result = existing ? {
+      ...existing,
+      success: false,
+      // CRITICAL: Always set success: false for degraded providers
+      status: "degraded",
+      error: error || "Marked as degraded",
+      lastTested: /* @__PURE__ */ new Date()
+    } : {
+      id: providerId,
+      network,
+      success: false,
+      status: "degraded",
+      latencyMs: null,
+      seqno: null,
+      blocksBehind: 0,
+      lastTested: /* @__PURE__ */ new Date(),
+      error: error || "Marked as degraded"
+    };
+    this.results.set(key, result);
   }
   /**
    * Mark a provider as offline
@@ -962,14 +973,25 @@ var HealthChecker = class {
   markOffline(providerId, network, error) {
     const key = this.getResultKey(providerId, network);
     const existing = this.results.get(key);
-    if (existing) {
-      this.results.set(key, {
-        ...existing,
-        status: "offline",
-        error: error || "Marked as offline",
-        lastTested: /* @__PURE__ */ new Date()
-      });
-    }
+    const result = existing ? {
+      ...existing,
+      status: "offline",
+      success: false,
+      // Ensure success is false for offline providers
+      error: error || "Marked as offline",
+      lastTested: /* @__PURE__ */ new Date()
+    } : {
+      id: providerId,
+      network,
+      success: false,
+      status: "offline",
+      latencyMs: null,
+      seqno: null,
+      blocksBehind: 0,
+      lastTested: /* @__PURE__ */ new Date(),
+      error: error || "Marked as offline"
+    };
+    this.results.set(key, result);
   }
   // ========================================================================
   // Private Methods
@@ -1549,6 +1571,8 @@ var ProviderSelector = class {
     this.autoSelect = true;
     this.customEndpoint = null;
     this.bestProviderByNetwork = /* @__PURE__ */ new Map();
+    // Track currently active provider per network (the one actually being used)
+    this.activeProviderByNetwork = /* @__PURE__ */ new Map();
     this.registry = registry;
     this.healthChecker = healthChecker;
     this.config = { ...DEFAULT_CONFIG2, ...config };
@@ -1567,6 +1591,7 @@ var ProviderSelector = class {
     if (!this.autoSelect && this.selectedProviderId) {
       const provider = this.registry.getProvider(this.selectedProviderId);
       if (provider && provider.network === network) {
+        this.activeProviderByNetwork.set(network, provider.id);
         return provider;
       }
       this.logger.warn(
@@ -1577,8 +1602,13 @@ var ProviderSelector = class {
     if (cachedBestId) {
       const cached = this.registry.getProvider(cachedBestId);
       const health = this.healthChecker.getResult(cachedBestId, network);
-      if (cached && health && health.success !== false && this.config.minStatus.includes(health.status)) {
+      if (cached && health && health.success !== false && health.success !== void 0 && // Explicitly check for undefined
+      this.config.minStatus.includes(health.status)) {
+        this.activeProviderByNetwork.set(network, cachedBestId);
         return cached;
+      } else {
+        this.bestProviderByNetwork.delete(network);
+        this.activeProviderByNetwork.delete(network);
       }
     }
     return this.findBestProvider(network);
@@ -1600,10 +1630,17 @@ var ProviderSelector = class {
       const defaults = this.registry.getDefaultOrderForNetwork(network);
       for (const defaultProvider of defaults) {
         const health = this.healthChecker.getResult(defaultProvider.id, network);
-        if (!health || health.status === "untested" || health.success === true) {
+        if (!health || health.status === "untested") {
+          this.logger.warn(
+            `No healthy providers for ${network}, using untested default: ${defaultProvider.id}`
+          );
+          this.activeProviderByNetwork.set(network, defaultProvider.id);
+          return defaultProvider;
+        } else if (health.success === true) {
           this.logger.warn(
             `No healthy providers for ${network}, using default: ${defaultProvider.id}`
           );
+          this.activeProviderByNetwork.set(network, defaultProvider.id);
           return defaultProvider;
         }
       }
@@ -1613,6 +1650,7 @@ var ProviderSelector = class {
           this.logger.warn(
             `No tested healthy providers for ${network}, using untested: ${provider.id}`
           );
+          this.activeProviderByNetwork.set(network, provider.id);
           return provider;
         }
       }
@@ -1623,10 +1661,12 @@ var ProviderSelector = class {
     const bestHealth = this.healthChecker.getResult(best.id, network);
     if (bestHealth && bestHealth.success === true) {
       this.bestProviderByNetwork.set(network, best.id);
+      this.activeProviderByNetwork.set(network, best.id);
       this.logger.debug(
         `Best provider for ${network}: ${best.id} (score: ${scored[0].score.toFixed(2)})`
       );
     } else {
+      this.activeProviderByNetwork.set(network, best.id);
       this.logger.debug(
         `Best provider for ${network}: ${best.id} (score: ${scored[0].score.toFixed(2)}, untested)`
       );
@@ -1766,9 +1806,16 @@ var ProviderSelector = class {
   }
   /**
    * Clear cached best providers (forces recalculation)
+   * @param network - Optional network to clear cache for. If not provided, clears all networks.
    */
-  clearCache() {
-    this.bestProviderByNetwork.clear();
+  clearCache(network) {
+    if (network) {
+      this.bestProviderByNetwork.delete(network);
+      this.activeProviderByNetwork.delete(network);
+    } else {
+      this.bestProviderByNetwork.clear();
+      this.activeProviderByNetwork.clear();
+    }
   }
   /**
    * Update best provider after health check
@@ -1783,8 +1830,16 @@ var ProviderSelector = class {
     if (this.bestProviderByNetwork.get(network) === providerId) {
       this.bestProviderByNetwork.delete(network);
     }
+    this.activeProviderByNetwork.delete(network);
     return this.getNextProvider(network, [providerId]);
   }
+  /**
+   * Get the currently active provider ID for a network
+   * (the one that was last selected and is being used)
+   */
+  getActiveProviderId(network) {
+    return this.activeProviderByNetwork.get(network) || null;
+  }
   // ========================================================================
   // Info
   // ========================================================================
@@ -2021,6 +2076,7 @@ var _ProviderManager = class _ProviderManager {
       this.options.logger.warn("No providers available, using fallback");
       return this.getFallbackEndpoint();
     }
+    this.selector.getActiveProviderId(this.network) || this.selector.getBestProvider(this.network);
     if (provider.isDynamic && provider.type === "orbs") {
       try {
         const { getHttpEndpoint } = await import('@orbs-network/ton-access');
@@ -2036,9 +2092,14 @@ var _ProviderManager = class _ProviderManager {
    * Get endpoint with rate limiting
    *
    * Waits for rate limit token before returning endpoint.
+   * 
+   * @param forceRefresh - If true, clears cache and forces re-selection
    */
-  async getEndpointWithRateLimit(timeoutMs) {
+  async getEndpointWithRateLimit(timeoutMs, forceRefresh = false) {
     this.ensureInitialized();
+    if (forceRefresh) {
+      this.selector.clearCache(this.network);
+    }
     const provider = this.selector.getBestProvider(this.network);
     if (!provider) {
       return this.getFallbackEndpoint();
@@ -2090,15 +2151,33 @@ var _ProviderManager = class _ProviderManager {
    */
   reportError(error) {
     if (!this.initialized || !this.network) return;
-    const provider = this.selector.getBestProvider(this.network);
+    const activeProviderId = this.selector.getActiveProviderId(this.network);
+    let provider = null;
+    if (activeProviderId) {
+      provider = this.registry.getProvider(activeProviderId) || null;
+    }
+    if (!provider) {
+      provider = this.selector.getBestProvider(this.network);
+    }
     if (!provider) return;
-    const errorMsg = error instanceof Error ? error.message : error;
-    if (isRateLimitError(error)) {
+    const errorMsg = error instanceof Error ? error.message : String(error);
+    const errorMsgLower = errorMsg.toLowerCase();
+    const is429 = errorMsgLower.includes("429") || errorMsgLower.includes("rate limit");
+    const is503 = errorMsgLower.includes("503") || errorMsgLower.includes("service unavailable");
+    const is502 = errorMsgLower.includes("502") || errorMsgLower.includes("bad gateway");
+    const is404 = errorMsgLower.includes("404") || errorMsgLower.includes("not found");
+    const isTimeout = errorMsgLower.includes("timeout") || errorMsgLower.includes("abort");
+    if (isRateLimitError(error) || is429) {
       this.rateLimiter.reportRateLimitError(provider.id);
       this.healthChecker.markDegraded(provider.id, this.network, errorMsg);
+    } else if (is503 || is502 || is404 || isTimeout) {
+      this.rateLimiter.reportError(provider.id);
+      this.healthChecker.markOffline(provider.id, this.network, errorMsg);
     } else {
       this.rateLimiter.reportError(provider.id);
+      this.healthChecker.markDegraded(provider.id, this.network, errorMsg);
     }
+    this.selector.clearCache(this.network);
     this.selector.handleProviderFailure(provider.id, this.network);
     this.notifyListeners();
   }