@flow-player/test-streams 0.6.0 → 0.6.2

package/dist/index.js

@@ -0,0 +1,894 @@
+// src/fixtures/matrix.ts
+import { join as join2 } from "node:path";
+
+// src/config.ts
+var DEFAULT_PORT = 4177;
+var DEFAULT_HOST = "127.0.0.1";
+var DEFAULT_FIXTURE_DIR = "fixtures";
+var DEFAULT_DURATION_SECONDS = 5;
+var DEFAULT_HLS_SEGMENT_SECONDS = 2;
+var ALL_CODECS = ["h264", "hevc"];
+var ALL_FORMATS = ["flv", "hls", "mp4", "fmp4", "ts"];
+
+// 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"
+  }
+};
+function containerExtraArgs(format, codec) {
+  if (codec !== "hevc") return [];
+  if (format === "mp4") return ["-tag:v", "hvc1"];
+  return [];
+}
+
+// src/fixtures/format.ts
+import { join } from "node:path";
+function formatSpecific(format) {
+  if (format === "flv") return ["-f", "flv"];
+  if (format === "hls") {
+    return [
+      "-f",
+      "hls",
+      "-hls_time",
+      "2",
+      "-hls_playlist_type",
+      "vod",
+      "-hls_segment_type",
+      "mpegts",
+      "-hls_flags",
+      "independent_segments"
+    ];
+  }
+  if (format === "mp4") return ["-f", "mp4", "-movflags", "+faststart"];
+  if (format === "fmp4") {
+    return [
+      "-f",
+      "mp4",
+      "-movflags",
+      "frag_keyframe+empty_moov+default_base_moof",
+      "-frag_duration",
+      "2000000"
+    ];
+  }
+  if (format === "ts") return ["-f", "mpegts"];
+  throw new Error(`Unknown format: ${String(format)}`);
+}
+function layoutFor(codec, format) {
+  if (format === "hls") {
+    return {
+      format,
+      mime: "application/vnd.apple.mpegurl",
+      mainFileName: "master.m3u8",
+      containerArgs: formatSpecific(format),
+      isContainerDirectory: true,
+      sideFiles: ["seg-00000.ts", "seg-00001.ts", "seg-00002.ts"]
+    };
+  }
+  if (format === "fmp4") {
+    return {
+      format,
+      mime: "video/iso.segment",
+      mainFileName: "init.mp4",
+      containerArgs: formatSpecific(format),
+      isContainerDirectory: true,
+      sideFiles: ["seg-00000.m4s", "seg-00001.m4s", "seg-00002.m4s"]
+    };
+  }
+  if (format === "flv") {
+    return {
+      format,
+      mime: "video/x-flv",
+      mainFileName: `${codec}.flv`,
+      containerArgs: formatSpecific(format),
+      isContainerDirectory: false,
+      sideFiles: []
+    };
+  }
+  if (format === "mp4") {
+    return {
+      format,
+      mime: "video/mp4",
+      mainFileName: `${codec}.mp4`,
+      containerArgs: formatSpecific(format),
+      isContainerDirectory: false,
+      sideFiles: []
+    };
+  }
+  if (format === "ts") {
+    return {
+      format,
+      mime: "video/mp2t",
+      mainFileName: `${codec}.ts`,
+      containerArgs: formatSpecific(format),
+      isContainerDirectory: false,
+      sideFiles: []
+    };
+  }
+  throw new Error(`Unknown format: ${String(format)}`);
+}
+function singleFileRelative(codec, format) {
+  return join(format, `${codec}.${format}`);
+}
+function containerRelativeDir(codec, format) {
+  return join(format, codec);
+}
+function containerRelativePath(codec, format, name) {
+  return join(containerRelativeDir(codec, format), name);
+}
+
+// src/fixtures/matrix.ts
+function buildPlan(codec, format, durationSeconds) {
+  const layout = layoutFor(codec, format);
+  const spec = CODEC_SPEC[codec];
+  const gop = String(durationSeconds * 25);
+  const videoInput = `testsrc2=size=1280x720:rate=25,format=yuv420p`;
+  const audioInput = `sine=frequency=1000:sample_rate=44100`;
+  const ffmpegOutputArgs = [
+    "-y",
+    "-f",
+    "lavfi",
+    "-i",
+    videoInput,
+    "-f",
+    "lavfi",
+    "-i",
+    audioInput,
+    "-t",
+    String(durationSeconds),
+    "-c:v",
+    spec.encoder,
+    ...spec.videoArgs,
+    "-pix_fmt",
+    spec.pixelFormat,
+    "-g",
+    gop,
+    "-keyint_min",
+    gop,
+    "-sc_threshold",
+    "0",
+    ...containerExtraArgs(format, codec),
+    ...spec.audioArgs,
+    ...layout.containerArgs
+  ];
+  if (layout.isContainerDirectory) {
+    const containerDir2 = containerRelativeDir(codec, format);
+    const mainFile2 = containerRelativePath(codec, format, layout.mainFileName);
+    const files = [
+      mainFile2,
+      ...layout.sideFiles.map((s) => containerRelativePath(codec, format, s))
+    ];
+    return { codec, format, layout, containerDir: containerDir2, mainFile: mainFile2, files, ffmpegOutputArgs };
+  }
+  const mainFile = singleFileRelative(codec, format);
+  const containerDir = join2(mainFile.split("/").slice(0, -1).join("/"));
+  return { codec, format, layout, containerDir, mainFile, files: [mainFile], ffmpegOutputArgs };
+}
+function expandMatrix(opts) {
+  const codecs = opts?.codecs ?? ALL_CODECS;
+  const formats = opts?.formats ?? ALL_FORMATS;
+  const duration = opts?.durationSeconds ?? 5;
+  const plans = [];
+  for (const codec of codecs) {
+    for (const format of formats) {
+      plans.push(buildPlan(codec, format, duration));
+    }
+  }
+  return plans;
+}
+var VOD_SAMPLE_RELATIVE = "mp4/h264.mp4";
+
+// 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 lookupFixture(manifest, codec, format) {
+  if (!manifest) return { files: [], mainFile: null, exists: false };
+  const item = manifest.fixtures.find((f) => f.codec === codec && f.format === format);
+  if (!item) return { files: [], mainFile: null, exists: false };
+  const mainFile = item.entries[0] ?? null;
+  return { files: item.entries, mainFile, exists: true };
+}
+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
+  };
+}
+function verifyEntryOnDisk(fixtureDir, entry) {
+  const abs = resolve(fixtureDir, entry.path);
+  if (!existsSync(abs)) {
+    return { ok: false, size: 0, reason: `missing file: ${entry.path}` };
+  }
+  const size = statSync(abs).size;
+  if (size !== entry.size) {
+    return {
+      ok: false,
+      size,
+      reason: `size mismatch for ${entry.path}: manifest=${entry.size} disk=${size}`
+    };
+  }
+  return { ok: true, size };
+}
+
+// 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/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 as join3 } 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 join3(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 join3(formatRaw, codecRaw, rest);
+  }
+  const vod = VOD.exec(path);
+  if (vod) {
+    const [, name] = vod;
+    return join3("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 = join3(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";
+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
+  };
+}
+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/fixtures/generate.ts
+import { createHash } from "node:crypto";
+import {
+  existsSync as existsSync3,
+  mkdirSync,
+  readdirSync,
+  readFileSync as readFileSync4,
+  statSync as statSync3,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { spawn as spawn2 } from "node:child_process";
+import { join as join4, resolve as resolve3 } from "node:path";
+var FFMPEG_PROBE_ARGS = ["-version"];
+async function generateFixtures(opts = {}) {
+  const ffmpegPath = opts.ffmpegPath ?? await findFfmpeg();
+  if (!ffmpegPath) {
+    return {
+      fixtureDir: resolve3(opts.fixtureDir ?? DEFAULT_FIXTURE_DIR),
+      manifest: emptyManifest(opts.durationSeconds ?? DEFAULT_DURATION_SECONDS),
+      generated: 0,
+      skipped: 0,
+      ffmpegPath: "ffmpeg",
+      ffmpegMissing: true
+    };
+  }
+  const fixtureDir = resolve3(opts.fixtureDir ?? DEFAULT_FIXTURE_DIR);
+  mkdirSync(fixtureDir, { recursive: true });
+  const duration = opts.durationSeconds ?? DEFAULT_DURATION_SECONDS;
+  const plans = expandMatrix({
+    codecs: opts.codecs ?? ALL_CODECS,
+    formats: opts.formats ?? ALL_FORMATS,
+    durationSeconds: duration
+  });
+  const manifestItems = [];
+  let generated = 0;
+  let skipped = 0;
+  for (const plan of plans) {
+    const item = await generateOne(
+      plan,
+      fixtureDir,
+      ffmpegPath,
+      opts.quiet ?? false,
+      opts.overwrite ?? false
+    );
+    if (item) {
+      manifestItems.push(item);
+      generated += 1;
+    } else {
+      skipped += 1;
+    }
+  }
+  copyVodSamples(fixtureDir);
+  const manifest = {
+    version: 1,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    durationSeconds: duration,
+    fixtures: manifestItems
+  };
+  writeFileSync(join4(fixtureDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+  return { fixtureDir, manifest, generated, skipped, ffmpegPath, ffmpegMissing: false };
+}
+async function generateOne(plan, fixtureDir, ffmpegPath, quiet, overwrite) {
+  const outDir = join4(fixtureDir, plan.containerDir);
+  mkdirSync(outDir, { recursive: true });
+  const outFile = join4(fixtureDir, plan.mainFile);
+  if (!overwrite && existsSync3(outFile)) {
+    return collectExisting(plan, fixtureDir);
+  }
+  if (plan.layout.isContainerDirectory) {
+    for (const f of readdirSync(outDir)) {
+      if (f === plan.layout.mainFileName) continue;
+      rmIfExists(join4(outDir, f));
+    }
+  }
+  const args = plan.ffmpegOutputArgs.concat([outFile]);
+  if (!quiet) {
+    process.stdout.write(`[generate] ${plan.codec}/${plan.format} -> ${plan.mainFile}
+`);
+  }
+  const code = await runFfmpeg(ffmpegPath, args, quiet);
+  if (code !== 0) {
+    throw new Error(`ffmpeg exited with code ${code} for ${plan.codec}/${plan.format}`);
+  }
+  return collectExisting(plan, fixtureDir);
+}
+function collectExisting(plan, fixtureDir) {
+  const entries = [];
+  for (const rel of plan.files) {
+    const abs = join4(fixtureDir, rel);
+    if (!existsSync3(abs)) continue;
+    entries.push({ path: rel, size: statSync3(abs).size, sha256: hashFile(abs) });
+  }
+  if (plan.layout.isContainerDirectory) {
+    const absDir = join4(fixtureDir, plan.containerDir);
+    if (existsSync3(absDir)) {
+      for (const name of readdirSync(absDir).sort()) {
+        if (name === plan.layout.mainFileName) continue;
+        const rel = join4(plan.containerDir, name);
+        if (entries.find((e) => e.path === rel)) continue;
+        const abs = join4(absDir, name);
+        if (!statSync3(abs).isFile()) continue;
+        entries.push({ path: rel, size: statSync3(abs).size, sha256: hashFile(abs) });
+      }
+    }
+  }
+  return { codec: plan.codec, format: plan.format, entries };
+}
+function copyVodSamples(fixtureDir) {
+  const src = join4(fixtureDir, VOD_SAMPLE_RELATIVE);
+  if (!existsSync3(src)) return;
+  const vodDir = join4(fixtureDir, "vod");
+  mkdirSync(vodDir, { recursive: true });
+  for (const name of ["sample-1.mp4", "sample-2.mp4"]) {
+    const dst = join4(vodDir, name);
+    writeFileSync(dst, readFileSync4(src));
+  }
+}
+function rmIfExists(abs) {
+  if (!existsSync3(abs)) return;
+  try {
+    unlinkSync(abs);
+  } catch {
+  }
+}
+function runFfmpeg(ffmpegPath, args, quiet) {
+  const { promise, resolve: resolve4, reject } = Promise.withResolvers();
+  const proc = spawn2(ffmpegPath, args, {
+    stdio: quiet ? ["ignore", "ignore", "ignore"] : "inherit"
+  });
+  proc.once("error", reject);
+  proc.once("exit", (code) => resolve4(code ?? 1));
+  return promise;
+}
+async function findFfmpeg() {
+  const candidates = [
+    "ffmpeg",
+    "/opt/homebrew/bin/ffmpeg",
+    "/usr/local/bin/ffmpeg",
+    "/usr/bin/ffmpeg"
+  ];
+  for (const candidate of candidates) {
+    if (await canRun(candidate)) return candidate;
+  }
+  return null;
+}
+async function canRun(path) {
+  const { promise, resolve: resolve4 } = Promise.withResolvers();
+  const proc = spawn2(path, FFMPEG_PROBE_ARGS, { stdio: "ignore" });
+  proc.once("error", () => resolve4(false));
+  proc.once("exit", (code) => resolve4(code === 0));
+  return promise;
+}
+function hashFile(abs) {
+  const hash = createHash("sha256");
+  hash.update(readFileSync4(abs));
+  return hash.digest("hex");
+}
+function emptyManifest(duration) {
+  return {
+    version: 1,
+    generatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+    durationSeconds: duration,
+    fixtures: []
+  };
+}
+export {
+  ALL_CODECS,
+  ALL_FORMATS,
+  CODEC_SPEC,
+  DEFAULT_DURATION_SECONDS,
+  DEFAULT_FIXTURE_DIR,
+  DEFAULT_HLS_SEGMENT_SECONDS,
+  DEFAULT_HOST,
+  DEFAULT_PORT,
+  VOD_SAMPLE_RELATIVE,
+  buildPlan,
+  containerRelativeDir,
+  containerRelativePath,
+  createStreamsServer,
+  expandMatrix,
+  generateFixtures,
+  handleLiveStream,
+  layoutFor,
+  loadManifest,
+  lookupFixture,
+  matchLivePath,
+  summarizeCatalog,
+  verifyEntryOnDisk
+};