@buoy-gg/js-top 7.0.29 → 7.0.30

package/src/js-top/engine/JsTopController.ts

@@ -1,401 +0,0 @@
-/**
- * JsTopController — singleton orchestrating the task-accounting engine.
- *
- * Lifecycle mirrors PerfMonitorController: the engine runs only while
- * someone is looking (snapshot subscribers — the HUD/modal — or a desktop
- * dashboard's silent remote sampling). Patches install once on first start
- * and stay installed; stopping just clears the `active` gate and the probe,
- * so a closed tool costs one boolean per schedule and nothing else.
- */
-
-import { AppState } from "react-native";
-
-import {
-  BUCKET_MS,
-  WINDOW_BUCKETS,
-  SNAPSHOT_ROWS,
-  type JsTopOriginDetail,
-  type JsTopSnapshot,
-  type JsTopStatus,
-  type JsTopTiers,
-} from "../types";
-import { now } from "./now";
-import { setActive, isActive } from "./state";
-import { installTimerPatches } from "./patches/timers";
-import { installMicrotaskPatches } from "./patches/microtasks";
-import {
-  busyHistory,
-  resetAggregator,
-  windowAttributedMs,
-  windowBusyMs,
-  windowResidualBuckets,
-} from "./aggregator";
-import {
-  buildRows,
-  getOriginDetailBase,
-  resetOrigins,
-} from "./originRegistry";
-import { startBusyProbe, stopBusyProbe, suppressNextGap } from "./busyProbe";
-import { getOriginals } from "./state";
-import { loadJsTopPrefs, saveJsTopPrefs } from "../utils/preferences";
-
-declare const __DEV__: boolean;
-
-const NOTIFY_INTERVAL_MS = BUCKET_MS;
-
-type SnapshotSubscriber = (snapshot: JsTopSnapshot) => void;
-type EnabledSubscriber = (enabled: boolean) => void;
-type FreezeStatsFn = (now: number) => {
-  count: number;
-  worstMs: number;
-  byOrigin: Record<string, { count: number; maxMs: number }>;
-};
-
-class JsTopControllerImpl {
-  private enabled = false;
-  private enabledLoaded = false;
-  private paused = false;
-  private remoteSampling = false;
-  private engineRunning = false;
-  private tiers: JsTopTiers = {
-    timers: false,
-    promises: false,
-    bridge: false,
-    longtask: false,
-  };
-  private notifyHandle: ReturnType<typeof setInterval> | null = null;
-  private appStateSub: { remove(): void } | null = null;
-  private snapshot: JsTopSnapshot = this.buildSnapshot();
-  private subscribers = new Set<SnapshotSubscriber>();
-  private enabledSubscribers = new Set<EnabledSubscriber>();
-  /** Phase-2 seam: extra tier installers (promises/bridge/longtasks) register
-   * here so the controller stays ignorant of their internals. */
-  private tierInstallers: Array<() => Partial<JsTopTiers>> = [];
-  private longtaskProvider: (() => JsTopSnapshot["longtasks"]) | null = null;
-  private freezeStatsProvider: FreezeStatsFn | null = null;
-  private clearHooks: Array<() => void> = [];
-
-  constructor() {
-    void loadJsTopPrefs().then((prefs) => {
-      this.enabledLoaded = true;
-      if (prefs.enabled && !this.enabled) this.setEnabled(true);
-    });
-  }
-
-  // ── observation lifecycle ────────────────────────────────────────────────
-
-  subscribe(fn: SnapshotSubscriber): () => void {
-    this.subscribers.add(fn);
-    this.syncEngineState();
-    fn(this.snapshot);
-    return () => {
-      this.subscribers.delete(fn);
-      this.syncEngineState();
-    };
-  }
-
-  subscribeEnabled(fn: EnabledSubscriber): () => void {
-    this.enabledSubscribers.add(fn);
-    fn(this.enabled);
-    return () => {
-      this.enabledSubscribers.delete(fn);
-    };
-  }
-
-  /** HUD visibility toggle (persisted). Not required for the engine to run —
-   * the modal or a desktop watcher subscribing is what starts sampling. */
-  setEnabled(on: boolean): void {
-    if (this.enabled === on) return;
-    this.enabled = on;
-    if (this.enabledLoaded) void saveJsTopPrefs({ enabled: on });
-    this.enabledSubscribers.forEach((fn) => {
-      try {
-        fn(on);
-      } catch (err) {
-        if (__DEV__) {
-          // eslint-disable-next-line no-console
-          console.error("[js-top] enabled subscriber threw", err);
-        }
-      }
-    });
-    this.syncEngineState();
-  }
-
-  isEnabled(): boolean {
-    return this.enabled;
-  }
-
-  /** Silent sampling for a desktop viewer — engine runs, device HUD stays
-   * hidden (same contract as perf-monitor's setRemoteSampling). */
-  setRemoteSampling(on: boolean): void {
-    if (this.remoteSampling === on) return;
-    this.remoteSampling = on;
-    this.syncEngineState();
-  }
-
-  isRemoteSampling(): boolean {
-    return this.remoteSampling;
-  }
-
-  getStatus(): JsTopStatus {
-    if (!this.engineRunning) return "disabled";
-    return this.paused ? "paused" : "running";
-  }
-
-  // ── controls ─────────────────────────────────────────────────────────────
-
-  pause(): void {
-    if (this.paused) return;
-    this.paused = true;
-    setActive(false);
-    stopBusyProbe();
-    this.emitSnapshot();
-  }
-
-  resume(): void {
-    if (!this.paused) return;
-    this.paused = false;
-    if (this.engineRunning) {
-      setActive(true);
-      startBusyProbe();
-    }
-    this.emitSnapshot();
-  }
-
-  clear(): void {
-    resetOrigins();
-    resetAggregator();
-    for (const hook of this.clearHooks) {
-      try {
-        hook();
-      } catch {
-        // ignore
-      }
-    }
-    this.emitSnapshot();
-  }
-
-  registerClearHook(fn: () => void): void {
-    this.clearHooks.push(fn);
-  }
-
-  getSnapshot(): JsTopSnapshot {
-    return this.snapshot;
-  }
-
-  /**
-   * Full detail for one origin (tap-through view). Returns null when the
-   * origin was evicted or never existed. The pinned "unattributed" row gets
-   * a synthetic detail built from the probe residuals.
-   */
-  getOriginDetail(key: string): JsTopOriginDetail | null {
-    const t = now();
-    const busy = windowBusyMs(t);
-    const freezeStats = this.freezeStatsProvider?.(Date.now());
-    const freezes = freezeStats?.byOrigin[key];
-    if (key === "unattributed") {
-      const buckets = windowResidualBuckets(t);
-      const windowMs =
-        Math.round(buckets.reduce((sum, ms) => sum + ms, 0) * 10) / 10;
-      return {
-        key,
-        label: "unattributed (events / React / native call-ins)",
-        api: "unattributed",
-        promoted: false,
-        scheduleCount: 0,
-        calls: 0,
-        totalMs: 0,
-        avgMs: 0,
-        maxMs: 0,
-        windowMs,
-        pctOfBusy:
-          busy > 0
-            ? Math.min(100, Math.round((windowMs / busy) * 1000) / 10)
-            : 0,
-        lastSeenAgoMs: 0,
-        buckets,
-        freezes: freezes?.count ?? 0,
-        worstFreezeMs: Math.round(freezes?.maxMs ?? 0),
-      };
-    }
-    const base = getOriginDetailBase(key, t, busy);
-    if (!base) return null;
-    return {
-      ...base,
-      freezes: freezes?.count ?? 0,
-      worstFreezeMs: Math.round(freezes?.maxMs ?? 0),
-    };
-  }
-
-  /** Phase-2 registration seam for additional patch tiers. */
-  registerTierInstaller(install: () => Partial<JsTopTiers>): void {
-    this.tierInstallers.push(install);
-    if (this.engineRunning) {
-      Object.assign(this.tiers, this.runInstaller(install));
-    }
-  }
-
-  registerLongtaskProvider(fn: () => JsTopSnapshot["longtasks"]): void {
-    this.longtaskProvider = fn;
-  }
-
-  registerFreezeStatsProvider(fn: FreezeStatsFn): void {
-    this.freezeStatsProvider = fn;
-  }
-
-  // ── engine ───────────────────────────────────────────────────────────────
-
-  private shouldRun(): boolean {
-    return this.subscribers.size > 0 || this.remoteSampling;
-  }
-
-  private syncEngineState(): void {
-    const want = this.shouldRun();
-    if (want && !this.engineRunning) this.startEngine();
-    else if (!want && this.engineRunning) this.stopEngine();
-  }
-
-  private runInstaller(install: () => Partial<JsTopTiers>): Partial<JsTopTiers> {
-    try {
-      return install();
-    } catch (err) {
-      if (__DEV__) {
-        // eslint-disable-next-line no-console
-        console.error("[js-top] tier installer threw", err);
-      }
-      return {};
-    }
-  }
-
-  private startEngine(): void {
-    this.engineRunning = true;
-    installTimerPatches();
-    installMicrotaskPatches();
-    this.tiers = {
-      timers: true,
-      promises: false,
-      bridge: false,
-      longtask: false,
-    };
-    for (const install of this.tierInstallers) {
-      Object.assign(this.tiers, this.runInstaller(install));
-    }
-    setActive(!this.paused);
-    if (!this.paused) startBusyProbe();
-    try {
-      this.appStateSub = AppState.addEventListener("change", () => {
-        suppressNextGap();
-      });
-    } catch {
-      this.appStateSub = null;
-    }
-    // The notify tick uses the pre-patch setInterval: the engine must never
-    // list its own heartbeat as a task.
-    this.notifyHandle = getOriginals().setInterval(
-      () => this.emitSnapshot(),
-      NOTIFY_INTERVAL_MS,
-    );
-    this.emitSnapshot();
-  }
-
-  private stopEngine(): void {
-    this.engineRunning = false;
-    setActive(false);
-    stopBusyProbe();
-    if (this.notifyHandle != null) {
-      getOriginals().clearInterval(this.notifyHandle);
-      this.notifyHandle = null;
-    }
-    if (this.appStateSub) {
-      try {
-        this.appStateSub.remove();
-      } catch {
-        // ignore
-      }
-      this.appStateSub = null;
-    }
-  }
-
-  private buildSnapshot(): JsTopSnapshot {
-    const t = now();
-    const busy = windowBusyMs(t);
-    const attributed = windowAttributedMs(t);
-    const unattributed = Math.max(0, busy - attributed);
-    const rows = buildRows(t, busy, SNAPSHOT_ROWS);
-    if (unattributed >= 1) {
-      rows.push({
-        key: "unattributed",
-        label: "unattributed (events / React / native call-ins)",
-        api: "unattributed",
-        windowMs: Math.round(unattributed * 10) / 10,
-        pctOfBusy:
-          busy > 0
-            ? Math.min(100, Math.round((unattributed / busy) * 1000) / 10)
-            : 0,
-        totalMs: 0,
-        calls: 0,
-        avgMs: 0,
-        maxMs: 0,
-        lastSeenAgoMs: 0,
-        freezes: 0,
-        worstFreezeMs: 0,
-      });
-      rows.sort((a, b) => b.windowMs - a.windowMs || b.totalMs - a.totalMs);
-    }
-    // Decorate rows with freeze badges (unattributed freezes land on the
-    // pinned "unattributed" row, whose key matches SYSTEM_FREEZE_KEY).
-    const freezeStats = this.freezeStatsProvider?.(Date.now()) ?? {
-      count: 0,
-      worstMs: 0,
-      byOrigin: {},
-    };
-    for (const row of rows) {
-      const s = freezeStats.byOrigin[row.key];
-      if (s) {
-        row.freezes = s.count;
-        row.worstFreezeMs = Math.round(s.maxMs);
-      }
-    }
-    const windowSpanMs = WINDOW_BUCKETS * BUCKET_MS;
-    return {
-      ts: Date.now(),
-      paused: this.paused,
-      busyPct: Math.min(100, Math.round((busy / windowSpanMs) * 1000) / 10),
-      busyHistory: busyHistory(t),
-      tiers: { ...this.tiers },
-      rows,
-      totals: {
-        attributedWindowMs: Math.round(attributed * 10) / 10,
-        unattributedWindowMs: Math.round(unattributed * 10) / 10,
-        windowMs: windowSpanMs,
-      },
-      freezeSummary: {
-        count: freezeStats.count,
-        worstMs: Math.round(freezeStats.worstMs),
-      },
-      longtasks: this.longtaskProvider ? this.longtaskProvider() : [],
-    };
-  }
-
-  private emitSnapshot(): void {
-    this.snapshot = this.buildSnapshot();
-    this.subscribers.forEach((fn) => {
-      try {
-        fn(this.snapshot);
-      } catch (err) {
-        if (__DEV__) {
-          // eslint-disable-next-line no-console
-          console.error("[js-top] snapshot subscriber threw", err);
-        }
-      }
-    });
-  }
-
-  /** Engine active state, for diagnostics/tests. */
-  isEngineActive(): boolean {
-    return isActive();
-  }
-}
-
-export const JsTopController = new JsTopControllerImpl();
-export type { JsTopControllerImpl };