oc2token 0.1.0

package/dist/src/dashboard/scheduler/refresh-scheduler.js

@@ -0,0 +1,137 @@
+export const DEFAULT_REFRESH_INTERVAL_SECONDS = 300;
+export const DEFAULT_REFRESH_INTERVAL_MS = DEFAULT_REFRESH_INTERVAL_SECONDS * 1000;
+const systemTimers = {
+    setTimeout(callback, delayMilliseconds) {
+        const handle = setTimeout(callback, delayMilliseconds);
+        // Do not keep a non-interactive process alive solely for a dashboard timer.
+        if (typeof handle === "object" && handle !== null && "unref" in handle) {
+            handle.unref();
+        }
+        return handle;
+    },
+    clearTimeout(handle) {
+        clearTimeout(handle);
+    },
+};
+/**
+ * Monotonic, one-shot refresh scheduler.
+ *
+ * There is only ever one armed timer. Resetting it invalidates the old timer
+ * callback as well as clearing it, which protects fake timer implementations
+ * and hosts that deliver a callback after clearTimeout.
+ */
+export class RefreshScheduler {
+    clock;
+    onRequest;
+    timers;
+    intervalMilliseconds;
+    running = false;
+    deadline;
+    timerHandle;
+    timerToken = 0;
+    constructor(options) {
+        if (!Number.isFinite(options.refreshIntervalSeconds ?? DEFAULT_REFRESH_INTERVAL_SECONDS)) {
+            throw new RangeError("refreshIntervalSeconds must be finite");
+        }
+        const intervalSeconds = options.refreshIntervalSeconds ?? DEFAULT_REFRESH_INTERVAL_SECONDS;
+        if (intervalSeconds < 0) {
+            throw new RangeError("refreshIntervalSeconds must be non-negative");
+        }
+        this.clock = options.clock;
+        this.onRequest = options.onRequest;
+        this.timers = options.timers ?? systemTimers;
+        this.intervalMilliseconds = intervalSeconds * 1000;
+    }
+    get refreshIntervalSeconds() {
+        return this.intervalMilliseconds / 1000;
+    }
+    setRefreshIntervalSeconds(seconds) {
+        if (!Number.isFinite(seconds)) {
+            throw new RangeError("refreshIntervalSeconds must be finite");
+        }
+        if (seconds < 0 || !Number.isSafeInteger(seconds)) {
+            throw new RangeError("refreshIntervalSeconds must be a non-negative integer");
+        }
+        const nextMilliseconds = seconds * 1000;
+        if (nextMilliseconds === this.intervalMilliseconds)
+            return;
+        this.intervalMilliseconds = nextMilliseconds;
+        if (this.running) {
+            this.resetDeadline();
+        }
+    }
+    get isRunning() {
+        return this.running;
+    }
+    start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.resetDeadline();
+    }
+    stop() {
+        this.running = false;
+        this.deadline = undefined;
+        this.timerToken += 1;
+        this.clearTimer();
+    }
+    /** Trigger an immediate refresh and restart the automatic cadence. */
+    manual() {
+        if (!this.running) {
+            return;
+        }
+        this.resetDeadline();
+        this.onRequest("manual");
+    }
+    /** Treat wake as one invalidation, never as one callback per missed tick. */
+    wake() {
+        if (!this.running) {
+            return;
+        }
+        this.resetDeadline();
+        this.onRequest("wake");
+    }
+    nextRefreshAt() {
+        return this.deadline;
+    }
+    countdownSeconds() {
+        if (!this.running || this.deadline === undefined) {
+            return undefined;
+        }
+        return Math.max(0, Math.ceil((this.deadline - this.clock.monotonicNow()) / 1000));
+    }
+    /** Reset the cadence after a completed refresh or an externally detected wake. */
+    reset() {
+        if (this.running) {
+            this.resetDeadline();
+        }
+    }
+    resetDeadline() {
+        this.timerToken += 1;
+        this.clearTimer();
+        if (this.intervalMilliseconds === 0) {
+            this.deadline = undefined;
+            return;
+        }
+        this.deadline = this.clock.monotonicNow() + this.intervalMilliseconds;
+        const token = this.timerToken;
+        this.timerHandle = this.timers.setTimeout(() => {
+            if (!this.running || token !== this.timerToken) {
+                return;
+            }
+            this.timerHandle = undefined;
+            // Schedule from the current monotonic instant. This collapses delayed
+            // callbacks after sleep instead of replaying every missed interval.
+            this.resetDeadline();
+            this.onRequest("timer");
+        }, this.intervalMilliseconds);
+    }
+    clearTimer() {
+        if (this.timerHandle !== undefined) {
+            this.timers.clearTimeout(this.timerHandle);
+            this.timerHandle = undefined;
+        }
+    }
+}
+//# sourceMappingURL=refresh-scheduler.js.map

package/dist/src/dashboard/scheduler/refresh-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-scheduler.js","sourceRoot":"","sources":["../../../../src/dashboard/scheduler/refresh-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/src/dashboard/settings/index.d.ts

@@ -0,0 +1,25 @@
+import { type ProviderKind } from "../../domain/index.js";
+export declare const SETTINGS_MIN_REFRESH_SECONDS = 60;
+export declare const SETTINGS_MAX_REFRESH_SECONDS: number;
+export declare const SETTINGS_DEFAULT_REFRESH_SECONDS = 300;
+export declare const ALL_PROVIDER_KINDS: readonly ProviderKind[];
+export interface DashboardSettings {
+    readonly enabledProviders: ReadonlyArray<ProviderKind>;
+    readonly refreshIntervalSeconds: number;
+}
+export declare function clampRefreshIntervalSeconds(value: number): number;
+export declare function normalizeRefreshIntervalSeconds(value: unknown): number;
+export declare function formatRefreshInterval(seconds: number): string;
+export declare function settingsToFilterProviders(settings: DashboardSettings): Set<ProviderKind> | undefined;
+export declare function filterProvidersToEnabled(filterProviders?: Set<ProviderKind>): ReadonlyArray<ProviderKind>;
+export declare function normalizeEnabledProviders(value: unknown): ReadonlyArray<ProviderKind>;
+export declare function normalizeSettings(value: unknown): DashboardSettings;
+export declare function settingsFilePath(cacheDirectory?: string): string;
+export declare function loadDashboardSettings(cacheDirectory?: string): Promise<DashboardSettings | undefined>;
+export declare function saveDashboardSettings(settings: DashboardSettings, cacheDirectory?: string): Promise<void>;
+export declare const REFRESH_INTERVAL_PRESETS: readonly number[];
+export declare function nearestPresetIndex(value: number): number;
+export declare function adjustRefreshIntervalByPreset(currentSeconds: number, deltaSteps: number): number;
+export declare function adjustRefreshInterval(currentSeconds: number, deltaSteps: number): number;
+export declare function refreshIntervalPresetIndex(value: number): number;
+export declare function refreshIntervalForPresetIndex(index: number): number;

package/dist/src/dashboard/settings/index.js

@@ -0,0 +1,162 @@
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { defaultCacheDirectory } from "../../application.js";
+import { isProviderKind } from "../../domain/records.js";
+export const SETTINGS_MIN_REFRESH_SECONDS = 60;
+export const SETTINGS_MAX_REFRESH_SECONDS = 4 * 60 * 60; // 14400
+export const SETTINGS_DEFAULT_REFRESH_SECONDS = 300;
+export const ALL_PROVIDER_KINDS = ["opencode", "codex", "antigravity"];
+export function clampRefreshIntervalSeconds(value) {
+    if (!Number.isFinite(value))
+        return SETTINGS_DEFAULT_REFRESH_SECONDS;
+    const floored = Math.floor(value);
+    return Math.max(SETTINGS_MIN_REFRESH_SECONDS, Math.min(SETTINGS_MAX_REFRESH_SECONDS, floored));
+}
+export function normalizeRefreshIntervalSeconds(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return SETTINGS_DEFAULT_REFRESH_SECONDS;
+    return clampRefreshIntervalSeconds(value);
+}
+export function formatRefreshInterval(seconds) {
+    const clamped = clampRefreshIntervalSeconds(seconds);
+    if (clamped % 3600 === 0) {
+        const h = clamped / 3600;
+        return `${h}h`;
+    }
+    if (clamped >= 3600) {
+        const h = Math.floor(clamped / 3600);
+        const m = Math.floor((clamped % 3600) / 60);
+        if (m === 0)
+            return `${h}h`;
+        return `${h}h ${m}m`;
+    }
+    if (clamped % 60 === 0) {
+        return `${clamped / 60}m`;
+    }
+    // For non-multiples of 60 (should still clamp but allow display)
+    const m = Math.floor(clamped / 60);
+    const s = clamped % 60;
+    if (m === 0)
+        return `${s}s`;
+    return `${m}m ${s}s`;
+}
+export function settingsToFilterProviders(settings) {
+    const enabled = settings.enabledProviders;
+    if (enabled.length === ALL_PROVIDER_KINDS.length) {
+        // All enabled => no filter (collect all)
+        return undefined;
+    }
+    if (enabled.length === 0) {
+        // Empty would mean nothing to collect; caller should prevent but map to empty set
+        return new Set();
+    }
+    return new Set(enabled);
+}
+export function filterProvidersToEnabled(filterProviders) {
+    if (filterProviders === undefined || filterProviders.size === 0) {
+        return [...ALL_PROVIDER_KINDS];
+    }
+    const result = [];
+    for (const kind of ALL_PROVIDER_KINDS) {
+        if (filterProviders.has(kind))
+            result.push(kind);
+    }
+    // Preserve order of ALL_PROVIDER_KINDS, ignore unknown
+    return result;
+}
+export function normalizeEnabledProviders(value) {
+    if (!Array.isArray(value))
+        return [...ALL_PROVIDER_KINDS];
+    const filtered = value.filter(isProviderKind);
+    // Dedupe preserve order
+    const seen = new Set();
+    const ordered = [];
+    for (const kind of ALL_PROVIDER_KINDS) {
+        if (filtered.includes(kind) && !seen.has(kind)) {
+            seen.add(kind);
+            ordered.push(kind);
+        }
+    }
+    // If input contained valid providers but not in order, include them
+    for (const kind of filtered) {
+        if (!seen.has(kind)) {
+            seen.add(kind);
+            ordered.push(kind);
+        }
+    }
+    if (ordered.length === 0)
+        return [...ALL_PROVIDER_KINDS];
+    return ordered;
+}
+export function normalizeSettings(value) {
+    if (typeof value !== "object" || value === null) {
+        return { enabledProviders: [...ALL_PROVIDER_KINDS], refreshIntervalSeconds: SETTINGS_DEFAULT_REFRESH_SECONDS };
+    }
+    const record = value;
+    const enabled = normalizeEnabledProviders(record.enabledProviders ?? record.providers ?? record.filterProviders);
+    const interval = normalizeRefreshIntervalSeconds(record.refreshIntervalSeconds);
+    return { enabledProviders: enabled, refreshIntervalSeconds: interval };
+}
+export function settingsFilePath(cacheDirectory) {
+    const directory = cacheDirectory ?? defaultCacheDirectory();
+    return join(directory, "settings.json");
+}
+export async function loadDashboardSettings(cacheDirectory) {
+    const path = settingsFilePath(cacheDirectory);
+    try {
+        const contents = await fs.readFile(path, "utf8");
+        const parsed = JSON.parse(contents);
+        return normalizeSettings(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function saveDashboardSettings(settings, cacheDirectory) {
+    const path = settingsFilePath(cacheDirectory);
+    const directory = cacheDirectory ?? defaultCacheDirectory();
+    try {
+        await fs.mkdir(directory, { recursive: true, mode: 0o700 });
+    }
+    catch { }
+    const payload = JSON.stringify({
+        version: 1,
+        enabledProviders: [...settings.enabledProviders],
+        refreshIntervalSeconds: clampRefreshIntervalSeconds(settings.refreshIntervalSeconds),
+    }, null, 2);
+    try {
+        await fs.writeFile(path, `${payload}\n`, "utf8");
+    }
+    catch { }
+}
+export const REFRESH_INTERVAL_PRESETS = [60, 120, 300, 600, 900, 1800, 3600, 7200, 14400];
+export function nearestPresetIndex(value) {
+    const clamped = clampRefreshIntervalSeconds(value);
+    let bestIndex = 0;
+    let bestDiff = Infinity;
+    for (let i = 0; i < REFRESH_INTERVAL_PRESETS.length; i += 1) {
+        const diff = Math.abs(REFRESH_INTERVAL_PRESETS[i] - clamped);
+        if (diff < bestDiff) {
+            bestDiff = diff;
+            bestIndex = i;
+        }
+    }
+    return bestIndex;
+}
+export function adjustRefreshIntervalByPreset(currentSeconds, deltaSteps) {
+    const idx = nearestPresetIndex(currentSeconds);
+    const nextIdx = Math.max(0, Math.min(REFRESH_INTERVAL_PRESETS.length - 1, idx + deltaSteps));
+    return REFRESH_INTERVAL_PRESETS[nextIdx];
+}
+export function adjustRefreshInterval(currentSeconds, deltaSteps) {
+    // Back-compat: delegate to preset stepping for consistent UI increments
+    return adjustRefreshIntervalByPreset(currentSeconds, deltaSteps);
+}
+export function refreshIntervalPresetIndex(value) {
+    return nearestPresetIndex(value);
+}
+export function refreshIntervalForPresetIndex(index) {
+    const clamped = Math.max(0, Math.min(REFRESH_INTERVAL_PRESETS.length - 1, Math.floor(index)));
+    return REFRESH_INTERVAL_PRESETS[clamped];
+}
+//# sourceMappingURL=index.js.map

package/dist/src/dashboard/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dashboard/settings/index.ts"],"names":[],"mappings":"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"}

package/dist/src/dashboard/state/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./refresh-coordinator.js";
+export * from "./types.js";

package/dist/src/dashboard/state/index.js

@@ -0,0 +1,3 @@
+export * from "./refresh-coordinator.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/dashboard/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dashboard/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC"}

package/dist/src/dashboard/state/refresh-coordinator.d.ts

@@ -0,0 +1,72 @@
+import { type UsageWindowKind } from "../../domain/windows.js";
+import { RefreshScheduler, type TimerDriver } from "../scheduler/refresh-scheduler.js";
+import type { Clock, DashboardNavigation, RefreshOutcome, RefreshReason, RefreshSchedulerLike, RefreshState, UsageSource } from "./types.js";
+import type { CollectionResult } from "../../domain/index.js";
+export interface RefreshCoordinatorOptions<Navigation = DashboardNavigation> {
+    readonly source: UsageSource;
+    readonly clock: Clock;
+    readonly timezone: string;
+    readonly project?: string;
+    readonly refreshIntervalSeconds?: number;
+    readonly timers?: TimerDriver;
+    readonly scheduler?: RefreshSchedulerLike;
+    readonly initialPeriod?: UsageWindowKind;
+    readonly initialNavigation?: Navigation;
+    /** Optional normalized cache snapshot shown while the first live refresh runs. */
+    readonly initialSnapshot?: CollectionResult;
+    readonly onStateChange?: (state: RefreshState<Navigation>) => void;
+    /** Maximum time to wait for a source that ignores AbortSignal during quit. */
+    readonly cleanupTimeoutMilliseconds?: number;
+}
+export type RefreshListener<Navigation> = (state: RefreshState<Navigation>) => void;
+/**
+ * Owns every visible refresh transition. Sources do not mutate dashboard
+ * state; they return one result which is committed only by its current
+ * generation.
+ */
+export declare class RefreshCoordinator<Navigation = DashboardNavigation> {
+    private readonly source;
+    private readonly clock;
+    private readonly timezone;
+    private readonly project;
+    private readonly listeners;
+    private readonly scheduler;
+    private readonly cleanupTimeoutMilliseconds;
+    private state;
+    private active;
+    private pendingReason;
+    private pendingWaiters;
+    private nextGeneration;
+    private started;
+    private quitting;
+    private startPromise;
+    private readonly configuredOnStateChange;
+    constructor(options: RefreshCoordinatorOptions<Navigation>);
+    get refreshScheduler(): RefreshSchedulerLike;
+    get isRefreshing(): boolean;
+    get isStopped(): boolean;
+    getState(): RefreshState<Navigation>;
+    subscribe(listener: RefreshListener<Navigation>): () => void;
+    setPeriod(period: UsageWindowKind): void;
+    setNavigation(navigation: Navigation): void;
+    get refreshIntervalSeconds(): number;
+    setRefreshIntervalSeconds(seconds: number): void;
+    /** Start the scheduler and immediately issue exactly one initial refresh. */
+    start(): Promise<RefreshOutcome>;
+    /** Request a refresh; concurrent requests are reduced to one pending reason. */
+    request(reason?: Exclude<RefreshReason, "initial"> | "initial"): Promise<RefreshOutcome>;
+    refresh(): Promise<RefreshOutcome>;
+    manualRefresh(): Promise<RefreshOutcome>;
+    wake(): Promise<RefreshOutcome>;
+    /**
+     * Stop scheduling, invalidate the current generation, abort network work,
+     * and wait only briefly for sources which honor cancellation.
+     */
+    quit(): Promise<void>;
+    private begin;
+    private mergePendingReason;
+    private handleScheduledRequest;
+    private waitForCleanup;
+    private emit;
+}
+export { RefreshScheduler };