@claxedo/workspace-relay 0.7.0 → 0.10.0

package/dist/synthetic.d.ts

@@ -1,60 +0,0 @@
-/**
- * T10: Synthetic end-to-end probe.
- *
- * Liveness depends on metrics; metrics can lie. A synthetic probe periodically
- * exercises the relay's HTTP path and records RTT so we have an independent
- * signal that the data path actually works.
- *
- * Implementation notes
- * --------------------
- * - The probe targets `${relayUrl}/health` rather than minting a Runtime
- *   Access Token and hitting `/workspaces/<id>/...`. `/health` validates HTTP
- *   connectivity end-to-end without pretending the Relay owns Control Plane
- *   token issuance.
- * - All clocks, timers and `fetch` are injectable so tests stay deterministic.
- * - "Loud" logs after 3 consecutive failures use `console.error` by default;
- *   pageability (PagerDuty / equivalent) is wired separately.
- */
-export type SyntheticProbeStats = {
-    successCount: number;
-    failureCount: number;
-    consecutiveFailures: number;
-    /** RTT (ms) of the most recent probe attempt. Undefined before the first probe completes. */
-    lastRttMs?: number;
-    /** p50 / p99 over the rolling RTT window. Undefined if no successes yet. */
-    p50?: number;
-    p99?: number;
-    /** Number of RTTs currently in the rolling window. */
-    windowSize: number;
-};
-export type SyntheticProbe = {
-    stop(): void;
-    stats(): SyntheticProbeStats;
-};
-export type SyntheticProbeOptions = {
-    /** Base URL of the relay, e.g. `http://127.0.0.1:7777`. No trailing slash required. */
-    relayUrl: string;
-    /** Probe cadence. Default 60_000 (60 s). */
-    intervalMs?: number;
-    /** Summary log cadence (p50/p99). Default 300_000 (5 min). */
-    summaryIntervalMs?: number;
-    /** Path to probe. Default `/health`. */
-    probePath?: string;
-    /** Rolling window size for RTT percentile calculation. Default 100. */
-    rttWindowSize?: number;
-    /** Number of consecutive failures that triggers a loud log. Default 3. */
-    loudFailureThreshold?: number;
-    /** Override `fetch`. Defaults to global `fetch`. */
-    fetch?: typeof fetch;
-    /** Override clock for tests. Defaults to `Date.now`. */
-    now?: () => number;
-    /** Override `setInterval` for tests. Defaults to global `setInterval`. */
-    setInterval?: typeof setInterval;
-    /** Override `clearInterval` for tests. Defaults to global `clearInterval`. */
-    clearInterval?: typeof clearInterval;
-    /** Loud-failure logger. Defaults to `console.error`. */
-    logError?: (msg: string, fields?: Record<string, unknown>) => void;
-    /** Periodic summary logger (p50/p99). Defaults to `console.log`. */
-    logSummary?: (msg: string, fields?: Record<string, unknown>) => void;
-};
-export declare function startSyntheticProbe(options: SyntheticProbeOptions): SyntheticProbe;