@a11ign/screenreader-fleet 0.5.2 → 0.6.0

package/dist/worker-code-check.d.mts

@@ -1,54 +0,0 @@
-/**
- * The hash every worker is expected to be serving, and WHERE IT CAME FROM. ONE function, asked by `a11ign-worker-code` and by
- * `assertFleetRunsThisCheckout` alike, so the two cannot be given different hashers again (a11ign/a11ign#3781).
- *
- * With a layer clone present it is the CLONE's: the clone's own `code-version.mjs` over the clone's `src/`, which is what
- * `layerCodeVersion("nvda-worker")` computes for the deploy and the lab, and what a guest is told to be on (`--layer-ref`). Asking the
- * installed package instead made every worker read stale the first time a guest was deployed at a sha whose `.mjs` differed from the
- * release, with a remedy ("redeploy") that could not clear it.
- *
- * With none it is the installed package's (a11ign/a11ign#3740: the one the package was RELEASED with, `codeVersion()` and no
- * directory, because the built package's `workerSourceDir()` is `dist/` and holds none of the files a guest runs), and `source` and
- * `note` say so, so a reading is never silent about which it was.
- *
- * ASYNC because the clone's hasher can only be imported dynamically, as `layerCodeVersion` does.
- *
- * @param {{ checkoutRoot?: string }} [options]
- * @returns {Promise<{ code: string, source: "clone" | "installed", sourceDir: string, note: string }>}
- */
-export function resolveExpectedWorkerCode({ checkoutRoot }?: {
-    checkoutRoot?: string;
-}): Promise<{
-    code: string;
-    source: "clone" | "installed";
-    sourceDir: string;
-    note: string;
-}>;
-/**
- * Refuse to capture with a fleet that is not running this checkout.
- *
- * Called at the boundary of every capture entry point, for the reason `assertWorkerUrl` is: the
- * alternative is discovering it in the evidence weeks later, where a stale worker looks like a page that
- * changed. **Both entry points, not one** — a remedy that reaches one of several paths is the shape this
- * repo has paid for three times over (`anchorToTop`, `ensureSpeechChannel`, `waitForAnnouncement`), and
- * `capture-preflight.test.ts` pins that both call it.
- *
- * A thin wrapper over `assertWorkersServe`, supplying the one thing only this file can compute: the hash.
- *
- * @param {string[]} workers
- * @param {{when?: string, allow?: boolean, read?: (url: string) => Promise<string|null>, bareMetalUrls?: string[], checkoutRoot?: string}} options
- */
-export function assertFleetRunsThisCheckout(workers: string[], options?: {
-    when?: string;
-    allow?: boolean;
-    read?: (url: string) => Promise<string | null>;
-    bareMetalUrls?: string[];
-    checkoutRoot?: string;
-}): Promise<void>;
-import { codeDrift } from "./code-drift.mjs";
-import { describeCodeDrift } from "./code-drift.mjs";
-import { describeEmptyPool } from "./code-drift.mjs";
-import { readWorkerCode } from "./code-drift.mjs";
-import { remedyLines } from "./code-drift.mjs";
-import { workerSourceDirty } from "./code-drift.mjs";
-export { codeDrift, describeCodeDrift, describeEmptyPool, readWorkerCode, remedyLines, workerSourceDirty };