Method tryRefresh

src/browser/utils/RefreshController.ts:241–306

* Attempt refresh, respecting pause conditions.

(options?: {
    bypassPause?: boolean;
    bypassHidden?: boolean;
    bypassMinInterval?: boolean;
    trigger?: RefreshTrigger;
  })

   * Attempt refresh, respecting pause conditions.
   */
  private tryRefresh(options?: {
    bypassPause?: boolean;
    bypassHidden?: boolean;
    bypassMinInterval?: boolean;
    trigger?: RefreshTrigger;
  }): void {
    if (this.disposed) return;

    const trigger = options?.trigger ?? this.pendingTrigger ?? "scheduled";
    const bypassHidden = (options?.bypassHidden ?? false) || trigger === "manual";
    const bypassPause = (options?.bypassPause ?? false) || trigger === "manual";
    const bypassMinInterval = (options?.bypassMinInterval ?? false) || trigger === "manual";

    // Hidden → queue for visibility (unless bypassed)
    if (!bypassHidden && typeof document !== "undefined" && document.hidden) {
      this.pendingBecauseHidden = true;
      this.updatePendingTrigger(trigger);
      return;
    }

    // Custom pause (e.g., user interacting) → queue for unpause
    // Bypassed for manual refresh (user explicitly requested)
    if (!bypassPause && this.isPaused?.()) {
      this.pendingBecausePaused = true;
      this.updatePendingTrigger(trigger);
      return;
    }

    // In-flight → queue for completion
    if (this.inFlight) {
      this.pendingBecauseInFlight = true;
      this.updatePendingTrigger(trigger);
      return;
    }

    // Hard guard: enforce minimum interval between refresh starts.
    // Rather than dropping the request, schedule it for the earliest allowed time.
    // Bypassed for manual refresh (user/component explicitly requested).
    if (!bypassMinInterval && this.lastRefreshStartMs > 0) {
      const now = Date.now();
      const elapsed = now - this.lastRefreshStartMs;
      if (elapsed < MIN_REFRESH_INTERVAL_MS) {
        this.updatePendingTrigger(trigger);

        if (this.cooldownTimer) {
          this.debug("cooldown timer running, coalescing");
          return;
        }

        const delayMs = MIN_REFRESH_INTERVAL_MS - elapsed;
        const t = this.pendingTrigger ?? trigger;
        this.debug(`cooldown: delaying ${delayMs}ms (${t})`);

        this.cooldownTimer = setTimeout(() => {
          this.cooldownTimer = null;
          const cooldownTrigger = this.pendingTrigger ?? t;
          this.pendingTrigger = null;
          this.tryRefresh({ trigger: cooldownTrigger });