@flow-player/test-streams 0.6.0 → 0.6.2

package/dist/cli/serve.js

@@ -0,0 +1,644 @@
+#!/usr/bin/env node
+
+// src/cli/serve.ts
+import { dirname, resolve as resolve3 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/config.ts
+var DEFAULT_PORT = 4177;
+var DEFAULT_HOST = "127.0.0.1";
+var DEFAULT_FIXTURE_DIR = "fixtures";
+var ALL_CODECS = ["h264", "hevc"];
+var ALL_FORMATS = ["flv", "hls", "mp4", "fmp4", "ts"];
+
+// src/server/server.ts
+import { createReadStream as createReadStream2, readFileSync as readFileSync3 } from "node:fs";
+import {
+  createServer as createHttpServer
+} from "node:http";
+import { createServer as createHttpsServer } from "node:https";
+import { extname, resolve as resolve2, sep } from "node:path";
+
+// src/fixtures/catalog.ts
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+function loadManifest(fixtureDir) {
+  const path = resolve(fixtureDir, "manifest.json");
+  if (!existsSync(path)) return null;
+  const raw = JSON.parse(readFileSync(path, "utf8"));
+  return raw;
+}
+function summarizeCatalog(fixtureDir) {
+  const manifest = loadManifest(fixtureDir);
+  if (!manifest) {
+    return {
+      codecs: ALL_CODECS,
+      formats: ALL_FORMATS,
+      fixtureCount: 0,
+      exists: false,
+      reason: `manifest.json not found at ${resolve(fixtureDir, "manifest.json")}`
+    };
+  }
+  let total = 0;
+  for (const item of manifest.fixtures) total += item.entries.length;
+  return {
+    codecs: ALL_CODECS,
+    formats: ALL_FORMATS,
+    fixtureCount: total,
+    exists: true
+  };
+}
+
+// src/server/static.ts
+import { createReadStream, statSync as statSync2 } from "node:fs";
+function applyCors(res) {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "GET, HEAD, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Range, Content-Type, If-None-Match");
+}
+function writeJson(res, status, body) {
+  const text = JSON.stringify(body);
+  res.writeHead(status, {
+    "Content-Type": "application/json; charset=utf-8",
+    "Content-Length": Buffer.byteLength(text),
+    "Cache-Control": "no-store"
+  });
+  res.end(text);
+}
+function writeNotFound(res) {
+  res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+  res.end("Not Found\n");
+}
+function writeBadRequest(res, message) {
+  res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
+  res.end(`${message}
+`);
+}
+function setRangeHeaders(req, res, fullPath, mime) {
+  const stat = statSync2(fullPath);
+  const total = stat.size;
+  res.setHeader("Accept-Ranges", "bytes");
+  const range = req.headers.range;
+  if (!range) {
+    res.setHeader("Content-Length", total);
+    res.setHeader("Content-Type", mime);
+    return null;
+  }
+  const match = /^bytes=(\d*)-(\d*)$/.exec(range);
+  if (!match) {
+    res.setHeader("Content-Length", total);
+    res.setHeader("Content-Type", mime);
+    return null;
+  }
+  const startRaw = match[1];
+  const endRaw = match[2];
+  let start = startRaw === "" ? Math.max(0, total - Number(endRaw || 0)) : Number(startRaw);
+  let end = endRaw === "" ? total - 1 : Number(endRaw);
+  if (!Number.isFinite(start) || !Number.isFinite(end) || start > end || end >= total) {
+    res.setHeader("Content-Range", `bytes */${total}`);
+    res.writeHead(416);
+    res.end();
+    return { alreadyServed: true };
+  }
+  start = Math.max(0, start);
+  end = Math.min(total - 1, end);
+  res.setHeader("Content-Range", `bytes ${start}-${end}/${total}`);
+  res.setHeader("Content-Length", end - start + 1);
+  res.setHeader("Content-Type", mime);
+  res.statusCode = 206;
+  return { start, end };
+}
+
+// src/server/routes.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { join } from "node:path";
+var FORMAT_SET = Object.fromEntries(ALL_FORMATS.map((f) => [f, true]));
+var CODEC_SET = Object.fromEntries(ALL_CODECS.map((c) => [c, true]));
+var HLS_FMP4 = { hls: true, fmp4: true };
+var SINGLE = /^\/streams\/([a-z0-9]+)\/([a-z0-9]+)\/?$/;
+var PLAYLIST = /^\/streams\/(hls|fmp4)\/([a-z0-9]+)\/(.+)$/;
+var VOD = /^\/streams\/vod\/([a-zA-Z0-9._-]+)\/?$/;
+function resolveRoute(path) {
+  const single = SINGLE.exec(path);
+  if (single) {
+    const [, formatRaw, codecRaw] = single;
+    if (!FORMAT_SET[formatRaw] || !CODEC_SET[codecRaw]) return null;
+    if (HLS_FMP4[formatRaw]) return null;
+    const format = formatRaw;
+    const codec = codecRaw;
+    return join(format, `${codec}.${format}`);
+  }
+  const playlist = PLAYLIST.exec(path);
+  if (playlist) {
+    const [, formatRaw, codecRaw, rest] = playlist;
+    if (!FORMAT_SET[formatRaw] || !CODEC_SET[codecRaw]) return null;
+    return join(formatRaw, codecRaw, rest);
+  }
+  const vod = VOD.exec(path);
+  if (vod) {
+    const [, name] = vod;
+    return join("vod", name);
+  }
+  return null;
+}
+function handleHealth(res, manifest, fixtureDir) {
+  const summary = summarizeCatalog(fixtureDir);
+  const status = manifest ? 200 : 503;
+  writeJson(res, status, {
+    status: summary.exists ? "ok" : "down",
+    codecs: summary.codecs,
+    formats: summary.formats,
+    fixtures: summary.fixtureCount,
+    reason: manifest ? void 0 : summary.reason
+  });
+}
+function handleList(res, manifest) {
+  if (!manifest) {
+    writeJson(res, 503, { error: "manifest not found" });
+    return;
+  }
+  writeJson(res, 200, manifest);
+}
+function handleVodList(res, manifest, fixtureDir) {
+  const vodListPath = join(fixtureDir, "vod", "vod-list.json");
+  if (existsSync2(vodListPath)) {
+    try {
+      const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
+      const segMs = manifest?.durationSeconds ? manifest.durationSeconds * 1e3 : 0;
+      const segments = raw.entries.map((e, i) => ({
+        url: `/streams/${e.path}`,
+        startTimestamp: i * segMs,
+        endTimestamp: (i + 1) * segMs,
+        timeLen: segMs,
+        fileSize: e.size,
+        channelID: 1,
+        RecordType: 1
+      }));
+      writeJson(res, 200, { segments });
+      return;
+    } catch {
+    }
+  }
+  if (!manifest) {
+    writeJson(res, 503, { error: "manifest not found" });
+    return;
+  }
+  const h264mp4 = manifest.fixtures.find((f) => f.codec === "h264" && f.format === "mp4");
+  const fileSize = h264mp4?.entries[0]?.size ?? 0;
+  const durMs = manifest.durationSeconds * 1e3;
+  writeJson(res, 200, {
+    segments: [
+      {
+        url: "/streams/vod/sample-1.mp4",
+        startTimestamp: 0,
+        endTimestamp: durMs,
+        timeLen: durMs,
+        fileSize,
+        channelID: 1,
+        RecordType: 1
+      },
+      {
+        url: "/streams/vod/sample-2.mp4",
+        startTimestamp: durMs,
+        endTimestamp: durMs * 2,
+        timeLen: durMs,
+        fileSize,
+        channelID: 1,
+        RecordType: 1
+      }
+    ]
+  });
+}
+
+// src/server/live.ts
+import { spawn } from "node:child_process";
+
+// src/fixtures/codec.ts
+var CODEC_SPEC = {
+  h264: {
+    codec: "h264",
+    encoder: "libx264",
+    videoArgs: ["-profile:v", "high", "-preset", "veryfast"],
+    audioArgs: ["-c:a", "aac", "-b:a", "128k"],
+    pixelFormat: "yuv420p"
+  },
+  hevc: {
+    codec: "hevc",
+    encoder: "libx265",
+    // 注意:FLV / TS 容器用 enhanced-rtmp 1cvh tag,不能强行写 hvc1;
+    // MP4 / fMP4 / HLS 走 hvc1。containerArgs 在 buildPlan 时按 format 决定。
+    videoArgs: ["-preset", "veryfast"],
+    audioArgs: ["-c:a", "aac", "-b:a", "128k"],
+    pixelFormat: "yuv420p"
+  }
+};
+
+// src/server/live.ts
+var LIVE_MIME = {
+  flv: "video/x-flv",
+  hls: "application/vnd.apple.mpegurl",
+  mp4: "video/mp4",
+  fmp4: "video/iso.segment",
+  ts: "video/mp2t"
+};
+var CODEC_SET2 = { h264: true, hevc: true };
+var FORMAT_SET2 = { flv: true, hls: true, mp4: true, fmp4: true, ts: true };
+var LIVE_PATTERN = /^\/streams\/live\/([a-z0-9]+)\/([a-z0-9]+)\/?$/;
+function matchLivePath(path) {
+  const match = LIVE_PATTERN.exec(path);
+  if (!match) return null;
+  const [, formatRaw, codecRaw] = match;
+  if (!FORMAT_SET2[formatRaw] || !CODEC_SET2[codecRaw]) return null;
+  return { format: formatRaw, codec: codecRaw };
+}
+function handleLiveStream(req, res, format, codec, options = {}) {
+  if (req.method !== "GET" && req.method !== "HEAD") {
+    res.writeHead(405, { Allow: "GET, HEAD, OPTIONS" });
+    res.end("Method Not Allowed\n");
+    return;
+  }
+  if (format === "hls") {
+    writeJson(res, 501, {
+      error: "HLS live streaming not yet supported in this build",
+      reason: "use /streams/live/flv/hevc etc. for non-HLS live, or /streams/hls/hevc/master.m3u8 for VOD HLS"
+    });
+    return;
+  }
+  const ffmpegPath = options.ffmpegPath ?? "ffmpeg";
+  const width = options.width ?? 1280;
+  const height = options.height ?? 720;
+  const fps = options.fps ?? 25;
+  const bitrate = options.bitrate ?? "1500k";
+  const spec = CODEC_SPEC[codec];
+  const mime = LIVE_MIME[format];
+  const ffmpegArgs = buildLiveFfmpegArgs(format, codec, spec, {
+    width,
+    height,
+    fps,
+    bitrate
+  });
+  if (req.method === "HEAD") {
+    res.writeHead(200, {
+      "Content-Type": mime,
+      "Access-Control-Allow-Origin": "*",
+      "X-Live-Source": "ffmpeg-stream-loop"
+    });
+    res.end();
+    return;
+  }
+  let proc;
+  try {
+    proc = spawn(ffmpegPath, ffmpegArgs, { stdio: ["ignore", "pipe", "pipe"] });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    writeJson(res, 503, { error: "ffmpeg spawn failed", reason: message });
+    return;
+  }
+  proc.once("error", (err) => {
+    if (!res.headersSent) {
+      writeJson(res, 503, { error: "ffmpeg failed to start", reason: err.message });
+      return;
+    }
+    res.destroy(err);
+  });
+  proc.stdout.once("data", () => {
+    if (!res.headersSent) {
+      res.writeHead(200, {
+        "Content-Type": mime,
+        "Access-Control-Allow-Origin": "*",
+        "Transfer-Encoding": "chunked",
+        "X-Live-Source": "ffmpeg-stream-loop"
+      });
+    }
+  });
+  proc.stdout.pipe(res);
+  const cleanup = () => {
+    if (!proc.killed) proc.kill("SIGKILL");
+  };
+  req.once("close", cleanup);
+  res.once("close", cleanup);
+}
+function buildLiveFfmpegArgs(format, codec, spec, opts) {
+  const gop = String(opts.fps);
+  const videoInput = `testsrc2=size=${opts.width}x${opts.height}:rate=${opts.fps},format=yuv420p`;
+  const audioInput = `sine=frequency=1000:sample_rate=44100`;
+  const hevcTag = codec === "hevc" && format === "mp4" ? ["-tag:v", "hvc1"] : [];
+  const baseArgs = [
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-fflags",
+    "+genpts",
+    "-re",
+    "-stream_loop",
+    "-1",
+    "-f",
+    "lavfi",
+    "-i",
+    videoInput,
+    "-f",
+    "lavfi",
+    "-i",
+    audioInput,
+    "-c:v",
+    spec.encoder,
+    ...spec.videoArgs,
+    ...liveLowLatencyVideoArgs(codec),
+    "-pix_fmt",
+    spec.pixelFormat,
+    "-g",
+    gop,
+    "-keyint_min",
+    gop,
+    "-sc_threshold",
+    "0",
+    "-b:v",
+    opts.bitrate,
+    ...hevcTag,
+    ...spec.audioArgs
+  ];
+  if (format === "flv") {
+    return [...baseArgs, "-f", "flv", "-flvflags", "no_sequence_end", "-"];
+  }
+  if (format === "mp4") {
+    return [
+      ...baseArgs,
+      "-f",
+      "mp4",
+      "-movflags",
+      "+faststart+frag_keyframe+empty_moov+default_base_moof",
+      "-"
+    ];
+  }
+  if (format === "fmp4") {
+    return [
+      ...baseArgs,
+      "-f",
+      "mp4",
+      "-movflags",
+      "frag_keyframe+empty_moov+default_base_moof",
+      "-frag_duration",
+      "2000000",
+      "-"
+    ];
+  }
+  if (format === "ts") {
+    return [...baseArgs, "-f", "mpegts", "-"];
+  }
+  throw new Error(`Unknown format: ${String(format)}`);
+}
+function liveLowLatencyVideoArgs(codec) {
+  if (codec === "h264" || codec === "hevc") {
+    return ["-tune", "zerolatency"];
+  }
+  return [];
+}
+
+// src/server/server.ts
+function createStreamsServer(options) {
+  const host = options.host ?? DEFAULT_HOST;
+  const port = options.port ?? DEFAULT_PORT;
+  const fixtureDir = resolve2(options.fixtureDir);
+  const ctx = {
+    manifest: loadManifest(fixtureDir),
+    fixtureDir
+  };
+  const refreshManifest = () => {
+    ctx.manifest = loadManifest(fixtureDir);
+    return ctx.manifest;
+  };
+  const handler = (req, res) => {
+    applyCors(res);
+    if (req.method === "OPTIONS") {
+      res.writeHead(204, {
+        "Access-Control-Allow-Methods": "GET, HEAD, OPTIONS",
+        "Access-Control-Allow-Headers": "Range, Content-Type, If-None-Match"
+      });
+      res.end();
+      return;
+    }
+    if (req.method !== "GET" && req.method !== "HEAD") {
+      res.writeHead(405, { Allow: "GET, HEAD, OPTIONS" });
+      res.end("Method Not Allowed\n");
+      return;
+    }
+    try {
+      const path = decodePath(req.url ?? "/");
+      if (path.includes("..")) {
+        writeBadRequest(res, "Path traversal not allowed");
+        return;
+      }
+      if (path === "/streams/health" || path === "/streams/health/") {
+        handleHealth(res, ctx.manifest, fixtureDir);
+        return;
+      }
+      if (path === "/streams/list" || path === "/streams/list/") {
+        handleList(res, ctx.manifest);
+        return;
+      }
+      if (path === "/streams/vod-list" || path === "/streams/vod-list/") {
+        handleVodList(res, ctx.manifest, ctx.fixtureDir);
+        return;
+      }
+      const resolved = resolveRoute(path);
+      if (resolved) {
+        serveEntry(req, res, fixtureDir, resolved);
+        return;
+      }
+      const liveMatch = matchLivePath(path);
+      if (liveMatch) {
+        handleLiveStream(req, res, liveMatch.format, liveMatch.codec);
+        return;
+      }
+      writeNotFound(res);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      if (!res.headersSent) {
+        res.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end(`Internal Error: ${message}
+`);
+      } else {
+        res.destroy(err instanceof Error ? err : new Error(message));
+      }
+    }
+  };
+  const server = options.cert && options.key ? createHttpsServer(
+    {
+      cert: readFileSync3(resolve2(options.cert)),
+      key: readFileSync3(resolve2(options.key))
+    },
+    handler
+  ) : createHttpServer(handler);
+  return {
+    server,
+    port,
+    host,
+    close: () => new Promise((resolveClose, rejectClose) => {
+      server.close((err) => err ? rejectClose(err) : resolveClose());
+    }),
+    refreshManifest
+  };
+}
+async function listen(server) {
+  const { promise, resolve: resolve4, reject } = Promise.withResolvers();
+  server.server.once("error", reject);
+  server.server.listen(server.port, server.host, () => {
+    const addr = server.server.address();
+    if (!addr) {
+      reject(new Error("server.address() returned null after listen"));
+      return;
+    }
+    server.port = addr.port;
+    resolve4(server);
+  });
+  return promise;
+}
+var FIXTURE_MIME = {
+  ".flv": "video/x-flv",
+  ".mp4": "video/mp4",
+  ".m4s": "video/iso.segment",
+  ".ts": "video/mp2t",
+  ".m3u8": "application/vnd.apple.mpegurl",
+  ".json": "application/json; charset=utf-8",
+  ".aac": "audio/aac"
+};
+function serveEntry(req, res, fixtureDir, relPath) {
+  const abs = resolve2(fixtureDir, relPath);
+  const rel = relativePosix(fixtureDir, abs);
+  if (rel === "" || rel.startsWith("..") || rel.includes(`..${sep}`)) {
+    writeNotFound(res);
+    return;
+  }
+  const mime = FIXTURE_MIME[extname(abs).toLowerCase()] ?? "application/octet-stream";
+  const rangeInfo = setRangeHeaders(req, res, abs, mime);
+  if (rangeInfo && "alreadyServed" in rangeInfo) return;
+  if (req.method === "HEAD") {
+    res.end();
+    return;
+  }
+  const startEnd = rangeInfo && "start" in rangeInfo ? rangeInfo : null;
+  const stream = startEnd ? createReadStream2(abs, { start: startEnd.start, end: startEnd.end }) : createReadStream2(abs);
+  stream.on("error", (err) => res.destroy(err));
+  stream.pipe(res);
+}
+function relativePosix(root, abs) {
+  if (abs === root) return "";
+  if (abs.startsWith(root + sep)) return abs.slice(root.length + 1);
+  if (abs.startsWith(root)) return abs.slice(root.length);
+  return abs;
+}
+function decodePath(rawTarget) {
+  const stripped = rawTarget.split(/[?#]/, 1)[0] || "/";
+  try {
+    return decodeURIComponent(stripped);
+  } catch {
+    return stripped;
+  }
+}
+
+// src/cli/serve.ts
+var here = dirname(fileURLToPath(import.meta.url));
+function parseArgs(argv) {
+  const parsed = {
+    port: DEFAULT_PORT,
+    fixtureDir: resolve3(here, "..", "..", DEFAULT_FIXTURE_DIR),
+    help: false
+  };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    switch (arg) {
+      case "--port": {
+        const v = Number(argv[++i]);
+        if (!Number.isInteger(v) || v < 1 || v > 65535)
+          throw new Error(`--port invalid: ${argv[i]}`);
+        parsed.port = v;
+        break;
+      }
+      case "--host":
+        parsed.host = argv[++i];
+        break;
+      case "--fixture-dir":
+        parsed.fixtureDir = resolve3(argv[++i] ?? "");
+        break;
+      case "--cert":
+        parsed.cert = argv[++i];
+        break;
+      case "--key":
+        parsed.key = argv[++i];
+        break;
+      case "--help":
+      case "-h":
+        parsed.help = true;
+        break;
+      default:
+        throw new Error(`Unknown option: ${arg}`);
+    }
+  }
+  return parsed;
+}
+var USAGE = `Usage:
+  pnpm --filter @flow-player/test-streams run serve [-- <args>]
+
+Options:
+  --port <port>                 Listen port (default: 4177)
+  --host <host>                 Bind host (default: 127.0.0.1)
+  --fixture-dir <path>          Fixture root (default: packages/test-streams/fixtures)
+  --cert <path>                 TLS cert (with --key, enables HTTPS)
+  --key <path>                  TLS private key (with --cert, enables HTTPS)
+  --help, -h                    Show this help
+`;
+async function main() {
+  let args;
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (err) {
+    process.stderr.write(`${err.message}
+${USAGE}`);
+    return 1;
+  }
+  if (args.help) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
+  const server = createStreamsServer({
+    port: args.port,
+    host: args.host,
+    // parseArgs guarantees a default; treat as string.
+    fixtureDir: args.fixtureDir,
+    cert: args.cert,
+    key: args.key
+  });
+  const listening = await listen(server);
+  const protocol = args.cert && args.key ? "https" : "http";
+  process.stdout.write(
+    `streams server listening on ${protocol}://${listening.host}:${listening.port}
+`
+  );
+  process.stdout.write(
+    `  health:  ${protocol}://${listening.host}:${listening.port}/streams/health
+`
+  );
+  process.stdout.write(`  fixture: ${resolve3(args.fixtureDir ?? "")}
+`);
+  const { promise, resolve: resolveWait } = Promise.withResolvers();
+  const shutdown = (code) => {
+    process.stdout.write("\nshutting down streams server...\n");
+    listening.close().finally(() => resolveWait(code));
+  };
+  process.once("SIGINT", () => shutdown(0));
+  process.once("SIGTERM", () => shutdown(0));
+  process.once("uncaughtException", (err) => {
+    process.stderr.write(`uncaught: ${err.stack ?? err.message}
+`);
+    shutdown(1);
+  });
+  return promise;
+}
+void main().then(
+  (code) => process.exit(code),
+  (err) => {
+    process.stderr.write(`${err.message}
+`);
+    process.exit(1);
+  }
+);

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_PORT = 4177;
+export declare const DEFAULT_HOST = "127.0.0.1";
+export declare const DEFAULT_FIXTURE_DIR = "fixtures";
+export declare const DEFAULT_DURATION_SECONDS = 5;
+export declare const DEFAULT_VIDEO_WIDTH = 1280;
+export declare const DEFAULT_VIDEO_HEIGHT = 720;
+export declare const DEFAULT_VIDEO_FPS = 25;
+export declare const DEFAULT_GOP_SECONDS = 1;
+export declare const DEFAULT_HLS_SEGMENT_SECONDS = 2;
+export type GenerateOptions = {
+    codecs?: ReadonlyArray<CodecId>;
+    formats?: ReadonlyArray<FormatId>;
+    durationSeconds?: number;
+    fixtureDir?: string;
+    overwrite?: boolean;
+    ffmpegPath?: string;
+    quiet?: boolean;
+};
+export type ServeOptions = {
+    port?: number;
+    host?: string;
+    fixtureDir?: string;
+    cert?: string;
+    key?: string;
+};
+export type CodecId = "h264" | "hevc";
+export type FormatId = "flv" | "hls" | "mp4" | "fmp4" | "ts";
+export declare const ALL_CODECS: ReadonlyArray<CodecId>;
+export declare const ALL_FORMATS: ReadonlyArray<FormatId>;

package/dist/fixtures/catalog.d.ts

@@ -0,0 +1,37 @@
+import { type CodecId, type FormatId } from "../config.js";
+export type ManifestEntry = {
+    path: string;
+    size: number;
+    sha256: string;
+};
+export type ManifestItem = {
+    codec: CodecId;
+    format: FormatId;
+    entries: ReadonlyArray<ManifestEntry>;
+};
+export type Manifest = {
+    version: 1;
+    generatedAt: string;
+    durationSeconds: number;
+    fixtures: ReadonlyArray<ManifestItem>;
+};
+export type FixtureLookup = {
+    files: ReadonlyArray<ManifestEntry>;
+    mainFile: ManifestEntry | null;
+    exists: boolean;
+};
+export declare function loadManifest(fixtureDir: string): Manifest | null;
+export declare function lookupFixture(manifest: Manifest | null, codec: CodecId, format: FormatId): FixtureLookup;
+export type CatalogSummary = {
+    codecs: ReadonlyArray<CodecId>;
+    formats: ReadonlyArray<FormatId>;
+    fixtureCount: number;
+    exists: boolean;
+    reason?: string;
+};
+export declare function summarizeCatalog(fixtureDir: string): CatalogSummary;
+export declare function verifyEntryOnDisk(fixtureDir: string, entry: ManifestEntry): {
+    ok: boolean;
+    size: number;
+    reason?: string;
+};