Method executeRefresh

src/browser/utils/RefreshController.ts:311–392

* Execute the refresh, tracking in-flight state.

(trigger: RefreshTrigger)

   * Execute the refresh, tracking in-flight state.
   */
  private executeRefresh(trigger: RefreshTrigger): void {
    if (this.disposed) return;

    this.lastRefreshStartMs = Date.now();

    if (this.cooldownTimer) {
      clearTimeout(this.cooldownTimer);
      this.cooldownTimer = null;
    }

    this.inFlight = true;
    this.pendingTrigger = null;

    // Capture generation at start so dispose() can fence stale continuations.
    const runGeneration = this.lifecycleGeneration;
    const isRunStale = () => this.disposed || runGeneration !== this.lifecycleGeneration;

    // Shared cleanup: clear in-flight state and process any queued follow-up.
    const finalizeInFlight = () => {
      this.inFlight = false;
      if (this.pendingBecauseInFlight) {
        this.pendingBecauseInFlight = false;
        const followupTrigger = this.pendingTrigger ?? "in-flight-followup";
        this.pendingTrigger = null;
        this.scheduleWithDelay(this.debounceMs, followupTrigger);
      }
    };

    const handleSuccess = () => {
      const info: LastRefreshInfo = { timestamp: Date.now(), trigger };
      this._lastRefreshInfo = info;

      finalizeInFlight();

      try {
        this.onRefreshComplete?.(info);
      } catch (error) {
        console.error("[RefreshController] onRefreshComplete callback threw", error);
      }
    };

    const handleFailure = (error: unknown) => {
      const errorMessage = error instanceof Error ? error.message : String(error);
      this.debug(`onRefresh failed: ${errorMessage}`);
      // Do NOT mutate _lastRefreshInfo — failure must not look like success.
      const failureInfo: RefreshFailureInfo = { timestamp: Date.now(), trigger, errorMessage };

      finalizeInFlight();

      try {
        this.onRefreshError?.(failureInfo);
      } catch (callbackError) {
        console.error("[RefreshController] onRefreshError callback threw", callbackError);
      }
    };

    // Unified promise pipeline: normalizes sync throws and async rejections
    // into a single failure path so all errors are handled identically.