@a4anthony/proctorkit-sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -2,15 +2,20 @@ import { openDB, deleteDB } from "idb";
 class DeliveryReadinessError extends Error {
   code;
   status;
+  /** Structured operator diagnostics. Never render this object in candidate UI. */
+  details;
   constructor(code, message, options) {
     super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
     this.name = "DeliveryReadinessError";
     this.code = code;
     this.status = options?.status;
+    this.details = options?.details;
   }
 }
 const RECORDING_READINESS_TIMEOUT_MS = 1e4;
-const CANARY_BYTES = 1024;
+const DEFAULT_CANARY_BYTES = 1024;
+const MAX_CANARY_BYTES = 1e7;
+const DEFAULT_MEASUREMENT_SAMPLES = 3;
 async function verifyRecordingDelivery(config) {
   if (typeof fetch === "undefined") {
     throw new DeliveryReadinessError(
@@ -32,9 +37,9 @@ async function verifyRecordingDelivery(config) {
     const mode = await resolveUploadMode(baseUrl, controller.signal);
     phase = "media";
     if (mode === "direct" || mode === "segments") {
-      await verifyDirectPath(baseUrl, config, controller.signal);
+      await verifyDirectPath(baseUrl, config, DEFAULT_CANARY_BYTES, controller.signal, defaultNow$1);
     } else {
-      await verifyPostPath(baseUrl, config, controller.signal);
+      await verifyPostPath(baseUrl, config, DEFAULT_CANARY_BYTES, controller.signal, defaultNow$1);
     }
     return mode;
   } catch (error) {
@@ -55,6 +60,76 @@ async function verifyRecordingDelivery(config) {
     clearTimeout(timeout);
   }
 }
+async function measureRecordingDeliveryReadiness(config) {
+  const payloadBytes = normaliseCanaryBytes(config.payloadBytes);
+  const completionWindowMs = normaliseCompletionWindow(config.completionWindowMs);
+  const sampleCount = Math.min(
+    5,
+    Math.max(1, Math.floor(config.samples ?? DEFAULT_MEASUREMENT_SAMPLES))
+  );
+  const now2 = config.now ?? defaultNow$1;
+  const baseUrl = originOf$1(config.ingestUrl);
+  if (!baseUrl) {
+    throw new DeliveryReadinessError(
+      "upload-config-invalid",
+      "The ingest URL does not provide a valid recording upload origin."
+    );
+  }
+  const mode = await withReadinessTimeout(
+    RECORDING_READINESS_TIMEOUT_MS,
+    "config",
+    (signal) => resolveUploadMode(baseUrl, signal)
+  );
+  await runPathProbe(baseUrl, config, mode, DEFAULT_CANARY_BYTES, now2).catch(() => void 0);
+  const durations = [];
+  let lastError;
+  for (let attempt = 0; attempt < sampleCount; attempt += 1) {
+    try {
+      durations.push(await runPathProbe(baseUrl, config, mode, payloadBytes, now2));
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  const requiredSuccesses = Math.ceil(sampleCount / 2);
+  if (durations.length < requiredSuccesses) {
+    const details = measurementDetails(mode, payloadBytes, completionWindowMs, durations.length);
+    if (lastError instanceof DeliveryReadinessError) {
+      throw new DeliveryReadinessError(lastError.code, lastError.message, {
+        cause: lastError,
+        ...lastError.status !== void 0 ? { status: lastError.status } : {},
+        details
+      });
+    }
+    throw new DeliveryReadinessError(
+      "media-storage-unreachable",
+      "The recording storage path could not complete enough readiness uploads.",
+      { cause: lastError, details }
+    );
+  }
+  const medianCompletionMs = median(durations);
+  if (medianCompletionMs > completionWindowMs) {
+    throw new DeliveryReadinessError(
+      "media-storage-too-slow",
+      `The representative recording payload took ${Math.round(medianCompletionMs)} ms; the workload window is ${Math.round(completionWindowMs)} ms.`,
+      {
+        details: measurementDetails(
+          mode,
+          payloadBytes,
+          completionWindowMs,
+          durations.length,
+          medianCompletionMs
+        )
+      }
+    );
+  }
+  return {
+    mode,
+    payloadBytes,
+    completionWindowMs,
+    sampleDurationsMs: durations.map((duration) => Math.round(duration)),
+    medianCompletionMs: Math.round(medianCompletionMs)
+  };
+}
 async function resolveUploadMode(baseUrl, signal) {
   const response = await fetch(`${baseUrl}/public/upload-config`, {
     method: "GET",
@@ -87,29 +162,31 @@ async function resolveUploadMode(baseUrl, signal) {
   }
   return body.recordingUpload;
 }
-async function verifyDirectPath(baseUrl, config, signal) {
+async function verifyDirectPath(baseUrl, config, canaryBytes, signal, now2) {
   let canary = null;
   try {
     canary = await postJson(
       `${baseUrl}/uploads/readiness/direct/start`,
-      { sessionId: config.sessionId },
+      { sessionId: config.sessionId, bytes: canaryBytes },
       config.appId,
       signal
     );
-    if (!canary.canaryId || !canary.uploadId || !canary.url) {
+    if (!canary.canaryId || !canary.uploadId || !canary.url || canary.expectedBytes !== canaryBytes) {
       throw new DeliveryReadinessError(
         "media-storage-invalid-response",
         "The recording storage canary did not return an upload target."
       );
     }
+    const uploadStartedAt = now2();
     const put = await fetch(canary.url, {
       method: "PUT",
-      body: new Blob([new Uint8Array(CANARY_BYTES)], {
+      body: new Blob([new Uint8Array(canaryBytes)], {
         type: "application/octet-stream"
       }),
       credentials: "omit",
       signal
     });
+    const uploadDurationMs = Math.max(0.1, now2() - uploadStartedAt);
     if (!put.ok) {
       throw mediaHttpError(put.status, "The recording storage rejected the canary upload.");
     }
@@ -118,39 +195,43 @@ async function verifyDirectPath(baseUrl, config, signal) {
       {
         sessionId: config.sessionId,
         canaryId: canary.canaryId,
-        uploadId: canary.uploadId
+        uploadId: canary.uploadId,
+        expectedBytes: canaryBytes
       },
       config.appId,
       signal
     );
-    if (completed.ok !== true || Number(completed.receivedBytes) !== CANARY_BYTES) {
+    if (completed.ok !== true || Number(completed.receivedBytes) !== canaryBytes) {
       throw new DeliveryReadinessError(
         "media-storage-invalid-response",
         "The recording storage did not acknowledge the complete canary."
       );
     }
     canary = null;
+    return uploadDurationMs;
   } finally {
     if (canary) void abortDirectCanary(baseUrl, config, canary);
   }
 }
-async function verifyPostPath(baseUrl, config, signal) {
+async function verifyPostPath(baseUrl, config, canaryBytes, signal, now2) {
   const headers = {
     "content-type": "application/octet-stream"
   };
   if (config.appId) headers["x-app-id"] = config.appId;
+  const uploadStartedAt = now2();
   const response = await fetch(
     `${baseUrl}/uploads/readiness/post/${encodeURIComponent(config.sessionId)}`,
     {
       method: "POST",
       headers,
-      body: new Blob([new Uint8Array(CANARY_BYTES)], {
+      body: new Blob([new Uint8Array(canaryBytes)], {
         type: "application/octet-stream"
       }),
       credentials: "omit",
       signal
     }
   );
+  const uploadDurationMs = Math.max(0.1, now2() - uploadStartedAt);
   if (!response.ok) {
     throw mediaHttpError(response.status, "The recording relay rejected the canary upload.");
   }
@@ -164,12 +245,13 @@ async function verifyPostPath(baseUrl, config, signal) {
       { cause: error }
     );
   }
-  if (body.ok !== true || Number(body.receivedBytes) !== CANARY_BYTES) {
+  if (body.ok !== true || Number(body.receivedBytes) !== canaryBytes) {
     throw new DeliveryReadinessError(
       "media-storage-invalid-response",
       "The recording relay did not acknowledge the complete canary."
     );
   }
+  return uploadDurationMs;
 }
 async function postJson(url, body, appId, signal) {
   const headers = { "content-type": "application/json" };
@@ -203,7 +285,8 @@ async function abortDirectCanary(baseUrl, config, canary) {
       {
         sessionId: config.sessionId,
         canaryId: canary.canaryId,
-        uploadId: canary.uploadId
+        uploadId: canary.uploadId,
+        expectedBytes: canary.expectedBytes
       },
       config.appId,
       controller.signal
@@ -213,6 +296,72 @@ async function abortDirectCanary(baseUrl, config, canary) {
     clearTimeout(timeout);
   }
 }
+async function runPathProbe(baseUrl, config, mode, bytes, now2) {
+  return withReadinessTimeout(
+    RECORDING_READINESS_TIMEOUT_MS,
+    "media",
+    (signal) => mode === "direct" || mode === "segments" ? verifyDirectPath(baseUrl, config, bytes, signal, now2) : verifyPostPath(baseUrl, config, bytes, signal, now2)
+  );
+}
+async function withReadinessTimeout(timeoutMs, phase, run) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await run(controller.signal);
+  } catch (error) {
+    if (error instanceof DeliveryReadinessError) throw error;
+    if (controller.signal.aborted) {
+      throw new DeliveryReadinessError(
+        phase === "config" ? "upload-config-timeout" : "media-storage-timeout",
+        phase === "config" ? "Timed out while resolving the recording upload path." : "Timed out while verifying recording storage.",
+        { cause: error }
+      );
+    }
+    throw new DeliveryReadinessError(
+      phase === "config" ? "upload-config-unreachable" : "media-storage-unreachable",
+      phase === "config" ? "The recording upload configuration could not be reached." : "The recording storage path could not be reached.",
+      { cause: error }
+    );
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function normaliseCanaryBytes(value) {
+  if (!Number.isFinite(value) || value < 1) {
+    throw new DeliveryReadinessError(
+      "media-storage-invalid-response",
+      "The recording readiness payload size must be a positive number."
+    );
+  }
+  return Math.min(MAX_CANARY_BYTES, Math.max(1, Math.round(value)));
+}
+function normaliseCompletionWindow(value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new DeliveryReadinessError(
+      "media-storage-invalid-response",
+      "The recording readiness completion window must be positive."
+    );
+  }
+  return Math.max(100, Math.round(value));
+}
+function median(values) {
+  const sorted = [...values].sort((a, b) => a - b);
+  const middle = Math.floor(sorted.length / 2);
+  if (sorted.length % 2 === 1) return sorted[middle];
+  return (sorted[middle - 1] + sorted[middle]) / 2;
+}
+function measurementDetails(mode, payloadBytes, completionWindowMs, successfulSamples, medianCompletionMs) {
+  return {
+    recordingUploadMode: mode,
+    readinessPayloadBytes: payloadBytes,
+    readinessWindowMs: Math.round(completionWindowMs),
+    readinessSampleCount: successfulSamples,
+    ...medianCompletionMs !== void 0 ? { readinessMedianMs: Math.round(medianCompletionMs) } : {}
+  };
+}
+function defaultNow$1() {
+  return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
 function mediaHttpError(status, message) {
   return new DeliveryReadinessError(
     status >= 400 && status < 500 ? "media-storage-rejected" : "media-storage-unreachable",
@@ -3595,9 +3744,9 @@ class MediaFilePlayer {
     return {
       url: this.safeUrl,
       ...this.label ? { label: this.label } : {},
-      currentTime: finiteNumber(this.element.currentTime),
-      duration: finiteNumber(this.element.duration),
-      playbackRate: finiteNumber(this.element.playbackRate),
+      currentTime: finiteNumber$1(this.element.currentTime),
+      duration: finiteNumber$1(this.element.duration),
+      playbackRate: finiteNumber$1(this.element.playbackRate),
       ...extra
     };
   }
@@ -3610,7 +3759,7 @@ function getMediaDevices() {
   }
   return mediaDevices;
 }
-function finiteNumber(value) {
+function finiteNumber$1(value) {
   return Number.isFinite(value) ? value : null;
 }
 function safeMediaUrl(input) {
@@ -4133,8 +4282,8 @@ async function captureBaseline(selected, dependsOn) {
   if (dependsOn.camera) permissions.camera = await queryPermission("camera");
   return { permissions, devices: selected, display: probeDisplay() };
 }
-const SDK_VERSION = "0.1.0";
-const SDK_BUILD_SHA = "2f83563ce2595fe2fbdb29cbe3bf6945070b69b6";
+const SDK_VERSION = "0.2.0";
+const SDK_BUILD_SHA = "0e08674057f5d4f2e5c5fac34cd5feeaa40d97f4";
 const SDK_BUILD_INFO = Object.freeze({
   sdkVersion: SDK_VERSION,
   buildSha: SDK_BUILD_SHA
@@ -6131,17 +6280,6 @@ const applySpeedToResult = (speed, minMbps = MIN_SPEED_MBPS) => {
       }
     };
   }
-  if (speed < minMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `${speed} Mbps`
-      },
-      mbps: speed
-    };
-  }
   const band = connectionQualityBand(speed, minMbps);
   return {
     kind: "connection",
@@ -6170,37 +6308,14 @@ const applyConnectionQualityToResult = (result, minDownloadMbps = MIN_SPEED_MBPS
       ...fields
     };
   }
-  if (upload < minUploadMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `Upload ${result.uploadMbps ?? upload} Mbps`
-      },
-      ...fields
-    };
-  }
-  if (download < minDownloadMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `Download ${result.downloadMbps ?? download} Mbps`
-      },
-      ...fields
-    };
-  }
-  const band = worseBand(
-    connectionQualityBand(upload, minUploadMbps),
-    connectionQualityBand(download, minDownloadMbps)
-  );
+  const uploadBand = connectionQualityBand(upload, minUploadMbps);
+  const downloadBand = connectionQualityBand(download, minDownloadMbps);
+  const band = uploadBand && downloadBand ? worseBand(uploadBand, downloadBand) : null;
   return {
     kind: "connection",
     state: {
       kind: "pass",
-      detail: band ? BAND_LABELS[band] : `Up ${result.uploadMbps} · Down ${result.downloadMbps} Mbps`
+      detail: band ? BAND_LABELS[band] : "Connection available"
     },
     ...fields,
     ...band ? { band } : {}
@@ -6771,19 +6886,29 @@ const cameraReadyDetail = (video) => {
   return label && label.length > 0 ? label : "Ready";
 };
 const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-const BROWSER_CLASS_KINDS = [
-  "browser",
-  "device",
-  "layout",
-  "monitor",
-  "connection"
-];
-const MEDIA_KINDS = [
-  "microphone",
-  "speaker",
-  "camera",
-  "screen-share"
-];
+function readinessErrorDetails(error) {
+  if (!error || typeof error !== "object" || !("details" in error)) return {};
+  const details = error.details;
+  if (!details || typeof details !== "object") return {};
+  const values = details;
+  const mode = values["recordingUploadMode"];
+  const payloadBytes = finiteNumber(values["readinessPayloadBytes"]);
+  const medianMs = finiteNumber(values["readinessMedianMs"]);
+  const windowMs = finiteNumber(values["readinessWindowMs"]);
+  const sampleCount = finiteNumber(values["readinessSampleCount"]);
+  return {
+    ...mode === "direct" || mode === "segments" || mode === "post" ? { recordingUploadMode: mode } : {},
+    ...payloadBytes !== void 0 ? { readinessPayloadBytes: payloadBytes } : {},
+    ...medianMs !== void 0 ? { readinessMedianMs: medianMs } : {},
+    ...windowMs !== void 0 ? { readinessWindowMs: windowMs } : {},
+    ...sampleCount !== void 0 ? { readinessSampleCount: Math.max(0, Math.floor(sampleCount)) } : {}
+  };
+}
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+const BROWSER_CLASS_KINDS = ["browser", "device", "layout", "monitor", "connection"];
+const MEDIA_KINDS = ["microphone", "speaker", "camera", "screen-share"];
 const GATE_KINDS = ["browser", "device"];
 const GATED_SYSTEM_KINDS = ["layout", "monitor", "connection"];
 const THRESHOLD_DEFAULTS = {
@@ -6823,7 +6948,8 @@ class SystemCheck {
       thresholds: { ...THRESHOLD_DEFAULTS, ...options.thresholds ?? {} },
       overrides: options.overrides,
       deepCamera: options.deepCamera,
-      connectionTest: options.connectionTest
+      connectionTest: options.connectionTest,
+      connectionReadiness: options.connectionReadiness
     };
     this.rows = this.buildInitialRows();
   }
@@ -6900,11 +7026,9 @@ class SystemCheck {
           continue;
         }
         if (done) break;
-        const next = await new Promise(
-          (resolve) => {
-            resolveWaiter = resolve;
-          }
-        );
+        const next = await new Promise((resolve) => {
+          resolveWaiter = resolve;
+        });
         if (next === null) break;
         yield next;
       }
@@ -7011,17 +7135,46 @@ class SystemCheck {
       message: "Testing connection..."
     });
     const start = performance.now();
-    const result = this.options.connectionTest ? applyConnectionQualityToResult(
-      await measureConnectionQuality(
-        createHttpConnectionProbe(this.options.connectionTest),
-        this.options.connectionTest
-      ),
-      this.options.thresholds.minBandwidthMbps,
-      this.options.thresholds.minUploadBandwidthMbps
-    ) : applySpeedToResult(
-      await measureSpeed(),
-      this.options.thresholds.minBandwidthMbps
-    );
+    let result;
+    if (this.options.connectionReadiness) {
+      try {
+        const readiness = await this.options.connectionReadiness();
+        result = {
+          kind: "connection",
+          state: { kind: "pass", detail: "Connection available" },
+          recordingUploadMode: readiness.mode,
+          readinessPayloadBytes: readiness.payloadBytes,
+          readinessMedianMs: readiness.medianCompletionMs,
+          readinessWindowMs: readiness.completionWindowMs,
+          readinessSampleCount: readiness.sampleDurationsMs.length
+        };
+      } catch (error) {
+        const diagnostic = error && typeof error === "object" && "code" in error ? String(error.code) : "unavailable";
+        const details = readinessErrorDetails(error);
+        result = {
+          kind: "connection",
+          state: {
+            kind: "fail",
+            code: "speed-test-failed",
+            detail: `Connection readiness failed: ${diagnostic}`
+          },
+          ...details.recordingUploadMode !== void 0 ? { recordingUploadMode: details.recordingUploadMode } : {},
+          ...details.readinessPayloadBytes !== void 0 ? { readinessPayloadBytes: details.readinessPayloadBytes } : {},
+          ...details.readinessMedianMs !== void 0 ? { readinessMedianMs: details.readinessMedianMs } : {},
+          ...details.readinessWindowMs !== void 0 ? { readinessWindowMs: details.readinessWindowMs } : {},
+          ...details.readinessSampleCount !== void 0 ? { readinessSampleCount: details.readinessSampleCount } : {}
+        };
+      }
+    } else {
+      result = this.options.connectionTest ? applyConnectionQualityToResult(
+        await measureConnectionQuality(
+          createHttpConnectionProbe(this.options.connectionTest),
+          this.options.connectionTest
+        ),
+        this.options.thresholds.minBandwidthMbps,
+        this.options.thresholds.minUploadBandwidthMbps
+      ) : applySpeedToResult(await measureSpeed(), this.options.thresholds.minBandwidthMbps);
+    }
     const elapsed = performance.now() - start;
     if (elapsed < this.options.minSpeedTestMs) {
       await this.delay(this.options.minSpeedTestMs - elapsed);
@@ -7042,6 +7195,21 @@ class SystemCheck {
     if (result.band !== void 0) {
       this.setRowField("connection", "band", result.band);
     }
+    if (result.recordingUploadMode !== void 0) {
+      this.setRowField("connection", "recordingUploadMode", result.recordingUploadMode);
+    }
+    if (result.readinessPayloadBytes !== void 0) {
+      this.setRowField("connection", "readinessPayloadBytes", result.readinessPayloadBytes);
+    }
+    if (result.readinessMedianMs !== void 0) {
+      this.setRowField("connection", "readinessMedianMs", result.readinessMedianMs);
+    }
+    if (result.readinessWindowMs !== void 0) {
+      this.setRowField("connection", "readinessWindowMs", result.readinessWindowMs);
+    }
+    if (result.readinessSampleCount !== void 0) {
+      this.setRowField("connection", "readinessSampleCount", result.readinessSampleCount);
+    }
   }
   /**
    * Run just the system-class checks (browser → device → layout →
@@ -7091,9 +7259,7 @@ class SystemCheck {
   }
   /** True once a non-retryable gate check (browser/device) has failed. */
   gateTripped() {
-    return this.rows.some(
-      (r) => GATE_KINDS.includes(r.kind) && r.state.kind === "fail"
-    );
+    return this.rows.some((r) => GATE_KINDS.includes(r.kind) && r.state.kind === "fail");
   }
   /** Mark every still-pending row of the given kinds as skipped. */
   skipPending(kinds) {
@@ -7146,11 +7312,7 @@ class SystemCheck {
       message: "Checking permission..."
     });
     const perms = await queryPermissions({ mic: false, camera: true });
-    const camState = await this.resolveCameraState(
-      perms.camera,
-      deviceId,
-      existingStream
-    );
+    const camState = await this.resolveCameraState(perms.camera, deviceId, existingStream);
     this.setState("camera", camState.state);
     if (camState.photo) this.setRowField("camera", "photo", camState.photo);
     return { attempts: camState.attempts ?? [] };
@@ -10132,6 +10294,7 @@ export {
   isSafari,
   isSamsungBrowser,
   measureConnectionQuality,
+  measureRecordingDeliveryReadiness,
   measureSpeed,
   normalizeClipDropCode,
   normalizeClipStartErrorCode,

package/dist/preflight/checks.d.ts

@@ -64,6 +64,16 @@ export interface CheckRow {
     latencyMs?: number;
     /** Median variation between latency samples in milliseconds. Connection row only. */
     jitterMs?: number;
+    /** Server-selected recording upload mode verified by the readiness canary. */
+    recordingUploadMode?: "direct" | "segments" | "post";
+    /** Representative readiness payload size. Internal telemetry only. */
+    readinessPayloadBytes?: number;
+    /** Median representative upload completion time. Internal telemetry only. */
+    readinessMedianMs?: number;
+    /** Workload-derived completion window. Internal telemetry only. */
+    readinessWindowMs?: number;
+    /** Number of successful representative readiness samples. Internal telemetry only. */
+    readinessSampleCount?: number;
     /**
      * Plain-language quality bucket for a PASSING connection row (Fair / Good /
      * Excellent), relative to the configured floor. Absent on fail rows and on
@@ -88,19 +98,17 @@ export interface CheckOverrides {
     /** Override browser support for `getDisplayMedia`. */
     screenShareSupported?: boolean;
 }
-/** Minimum acceptable downlink speed in megabits/sec. */
+/** Default reference floor for downlink quality telemetry in megabits/sec. */
 export declare const MIN_SPEED_MBPS = 2;
 /**
- * Plain-language quality bucket shown to the candidate INSTEAD of a raw Mbps
- * figure. Below the floor is not a band — that's the `slow-connection` fail —
- * so a passing connection is always one of these three.
+ * Plain-language quality bucket for measured connection telemetry. A value
+ * below the reference floor has no band; measured Mbps never decides candidate
+ * eligibility.
  */
 export type ConnectionBand = "fair" | "good" | "excellent";
 /**
- * Bucket a measured speed into a {@link ConnectionBand} relative to the floor.
- * Returns null below the floor (the fail path owns that) or for a non-finite /
- * non-positive input or floor. Pure — the single source of truth for both the
- * application-path and legacy download-only rows.
+ * Bucket a measured speed into a {@link ConnectionBand} relative to the
+ * reference floor. Returns null below the floor or for invalid inputs.
  */
 export declare const connectionQualityBand: (mbps: number, floorMbps: number) => ConnectionBand | null;
 /** Supported browsers, surfaced on the wizard's "your browser isn't supported" alert. */
@@ -175,18 +183,15 @@ export declare const measureSpeed: () => Promise<number | null>;
  */
 export declare const checkConnection: (overrides?: CheckOverrides) => CheckRow | null;
 /**
- * Build the connection row from a measured speed (or null on
- * measurement failure). The `minMbps` threshold defaults to the
- * module-level `MIN_SPEED_MBPS` so existing call sites work
- * unchanged; the engine threads the policy override through when
- * present.
+ * Build the connection row from a measured speed (or null on measurement
+ * failure). Numeric speed is retained as telemetry, but never gates the
+ * candidate because short browser probes are dominated by request latency.
  */
 export declare const applySpeedToResult: (speed: number | null, minMbps?: number) => CheckRow;
 /**
- * Apply policy to the richer application-path result. Upload is evaluated
- * first because recordings must leave the browser faster than MediaRecorder
- * produces them. The existing `slow-connection` code remains the stable
- * public contract; direction-specific values are carried on the row.
+ * Preserve application-path measurements as internal diagnostics. A completed
+ * measurement passes regardless of the estimated Mbps; candidate eligibility
+ * is decided separately by the workload-aware recording-storage canary.
  */
 export declare const applyConnectionQualityToResult: (result: ConnectionQualityResult, minDownloadMbps?: number, minUploadMbps?: number) => CheckRow;
 //# sourceMappingURL=checks.d.ts.map

package/dist/preflight/checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/preflight/checks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/preflight/checks.ts"],"names":[],"mappings":"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"}