@flow-player/test-streams 0.6.3 → 0.7.0

package/dist/cli/extend-vod.js

@@ -24,7 +24,8 @@ function parseArgs(argv) {
     gopSeconds: 1,
     width: 1280,
     height: 720,
-    fps: 25
+    fps: 25,
+    codec: "h264"
   };
   let help = false;
   for (let i = 0; i < argv.length; i += 1) {
@@ -44,6 +45,12 @@ function parseArgs(argv) {
       opts.height = Number(argv[++i]);
     } else if (a === "--fps") {
       opts.fps = Number(argv[++i]);
+    } else if (a === "--codec") {
+      const codec = argv[++i];
+      if (codec !== "h264" && codec !== "hevc") {
+        throw new Error(`[extend-vod] unsupported --codec "${codec}" (expected h264|hevc)`);
+      }
+      opts.codec = codec;
     }
   }
   return { ...opts, help };
@@ -58,6 +65,7 @@ Options:
   --gop <seconds>          GOP interval (default: 1)
   --width <px>             Video width (default: 1280)
   --height <px>            Video height (default: 720)
+  --codec <h264|hevc>      Video codec (default: h264; hevc \u8F93\u51FA\u5230 vod-hevc/ \u5B50\u76EE\u5F55)
  `;
 function hashFile(abs) {
   return createHash("sha256").update(readFileSync(abs)).digest("hex");
@@ -98,11 +106,12 @@ async function main() {
     return 1;
   }
   const fixtureDir = resolve(args.fixtureDir);
-  const vodDir = join(fixtureDir, "vod");
+  const vodDirName = args.codec === "hevc" ? "vod-hevc" : "vod";
+  const vodDir = join(fixtureDir, vodDirName);
   mkdirSync(vodDir, { recursive: true });
   const gop = String(args.gopSeconds * args.fps);
   process.stdout.write(
-    `[extend-vod] generating ${args.segmentCount} segments x ${args.segmentSeconds}s ${args.width}x${args.height}@${args.fps} mp4 h264+aac, gop=${gop} frames (${args.gopSeconds}s); total VOD=${args.segmentCount * args.segmentSeconds}s
+    `[extend-vod] generating ${args.segmentCount} segments x ${args.segmentSeconds}s ${args.width}x${args.height}@${args.fps} mp4 ${args.codec}+aac, gop=${gop} frames (${args.gopSeconds}s); total VOD=${args.segmentCount * args.segmentSeconds}s
 `
   );
   const segments = [];
@@ -111,6 +120,18 @@ async function main() {
     const file = join(vodDir, `seg-${String(index).padStart(3, "0")}.mp4`);
     const startSec = i * args.segmentSeconds;
     const frequency = 220 + i * 40;
+    const videoArgs = args.codec === "hevc" ? ["-c:v", "libx265", "-preset", "veryfast", "-tag:v", "hvc1", "-pix_fmt", "yuv420p"] : [
+      "-c:v",
+      "libx264",
+      "-profile:v",
+      "high",
+      "-bf",
+      "0",
+      "-preset",
+      "veryfast",
+      "-pix_fmt",
+      "yuv420p"
+    ];
     const ffmpegArgs = [
       "-y",
       "-f",
@@ -123,16 +144,7 @@ async function main() {
       `sine=frequency=${frequency}:sample_rate=44100`,
       "-t",
       String(args.segmentSeconds),
-      "-c:v",
-      "libx264",
-      "-profile:v",
-      "high",
-      "-bf",
-      "0",
-      "-preset",
-      "veryfast",
-      "-pix_fmt",
-      "yuv420p",
+      ...videoArgs,
       "-g",
       gop,
       "-keyint_min",
@@ -156,11 +168,17 @@ async function main() {
     const code = await runFfmpeg(ffmpegPath, ffmpegArgs);
     const size = statSync(file).size;
     const sha256 = hashFile(file);
-    segments.push({ index, path: `vod/seg-${String(index).padStart(3, "0")}.mp4`, size, sha256 });
+    segments.push({
+      index,
+      path: `${vodDirName}/seg-${String(index).padStart(3, "0")}.mp4`,
+      size,
+      sha256
+    });
   }
   const vodList = {
     version: 1,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    codec: args.codec,
     segmentSeconds: args.segmentSeconds,
     segmentCount: args.segmentCount,
     gopSeconds: args.gopSeconds,

package/dist/cli/serve.js

@@ -55,6 +55,10 @@ 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");
+  res.setHeader(
+    "Access-Control-Expose-Headers",
+    "Content-Range, Accept-Ranges, Content-Length, Content-Type"
+  );
 }
 function writeJson(res, status, body) {
   const text = JSON.stringify(body);
@@ -118,6 +122,7 @@ 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._-]+)\/?$/;
+var VOD_HEVC = /^\/streams\/vod-hevc\/([a-zA-Z0-9._-]+)\/?$/;
 function resolveRoute(path) {
   const single = SINGLE.exec(path);
   if (single) {
@@ -139,6 +144,11 @@ function resolveRoute(path) {
     const [, name] = vod;
     return join("vod", name);
   }
+  const vodHevc = VOD_HEVC.exec(path);
+  if (vodHevc) {
+    const [, name] = vodHevc;
+    return join("vod-hevc", name);
+  }
   return null;
 }
 function handleHealth(res, manifest, fixtureDir) {
@@ -159,8 +169,8 @@ function handleList(res, manifest) {
   }
   writeJson(res, 200, manifest);
 }
-function handleVodList(res, manifest, fixtureDir) {
-  const vodListPath = join(fixtureDir, "vod", "vod-list.json");
+function handleVodList(res, manifest, fixtureDir, codec = "h264") {
+  const vodListPath = codec === "hevc" ? join(fixtureDir, "vod-hevc", "vod-list.json") : join(fixtureDir, "vod", "vod-list.json");
   if (existsSync2(vodListPath)) {
     try {
       const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
@@ -179,6 +189,10 @@ function handleVodList(res, manifest, fixtureDir) {
     } catch {
     }
   }
+  if (codec === "hevc") {
+    writeJson(res, 404, { error: "vod-hevc list not found (run extend-vod --codec hevc first)" });
+    return;
+  }
   if (!manifest) {
     writeJson(res, 503, { error: "manifest not found" });
     return;
@@ -311,7 +325,22 @@ function handleLiveStream(req, res, format, codec, options = {}) {
       });
     }
   });
-  proc.stdout.pipe(res);
+  let stderrTail = "";
+  proc.stderr.setEncoding("utf8");
+  proc.stderr.on("data", (chunk) => {
+    stderrTail = (stderrTail + chunk).slice(-2e3);
+  });
+  proc.stdout.pipe(res, { end: false });
+  proc.once("close", (code) => {
+    if (!res.headersSent && code !== 0) {
+      const hint = codec === "hevc" && (format === "flv" || format === "ts") ? " (HEVC in FLV/TS requires ffmpeg >= 6 with enhanced-rtmp support)" : "";
+      writeJson(res, 503, {
+        error: "ffmpeg exited before producing output",
+        reason: `${stderrTail.trim().split("\n").at(-1) ?? "unknown"}${hint}`,
+        exitCode: code
+      });
+    }
+  });
   const cleanup = () => {
     if (!proc.killed) proc.kill("SIGKILL");
   };
@@ -440,6 +469,10 @@ function createStreamsServer(options) {
         handleVodList(res, ctx.manifest, ctx.fixtureDir);
         return;
       }
+      if (path === "/streams/vod-list-hevc" || path === "/streams/vod-list-hevc/") {
+        handleVodList(res, ctx.manifest, ctx.fixtureDir, "hevc");
+        return;
+      }
       const resolved = resolveRoute(path);
       if (resolved) {
         serveEntry(req, res, fixtureDir, resolved);

package/dist/index.js

@@ -257,6 +257,10 @@ 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");
+  res.setHeader(
+    "Access-Control-Expose-Headers",
+    "Content-Range, Accept-Ranges, Content-Length, Content-Type"
+  );
 }
 function writeJson(res, status, body) {
   const text = JSON.stringify(body);
@@ -320,6 +324,7 @@ 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._-]+)\/?$/;
+var VOD_HEVC = /^\/streams\/vod-hevc\/([a-zA-Z0-9._-]+)\/?$/;
 function resolveRoute(path) {
   const single = SINGLE.exec(path);
   if (single) {
@@ -341,6 +346,11 @@ function resolveRoute(path) {
     const [, name] = vod;
     return join3("vod", name);
   }
+  const vodHevc = VOD_HEVC.exec(path);
+  if (vodHevc) {
+    const [, name] = vodHevc;
+    return join3("vod-hevc", name);
+  }
   return null;
 }
 function handleHealth(res, manifest, fixtureDir) {
@@ -361,8 +371,8 @@ function handleList(res, manifest) {
   }
   writeJson(res, 200, manifest);
 }
-function handleVodList(res, manifest, fixtureDir) {
-  const vodListPath = join3(fixtureDir, "vod", "vod-list.json");
+function handleVodList(res, manifest, fixtureDir, codec = "h264") {
+  const vodListPath = codec === "hevc" ? join3(fixtureDir, "vod-hevc", "vod-list.json") : join3(fixtureDir, "vod", "vod-list.json");
   if (existsSync2(vodListPath)) {
     try {
       const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
@@ -381,6 +391,10 @@ function handleVodList(res, manifest, fixtureDir) {
     } catch {
     }
   }
+  if (codec === "hevc") {
+    writeJson(res, 404, { error: "vod-hevc list not found (run extend-vod --codec hevc first)" });
+    return;
+  }
   if (!manifest) {
     writeJson(res, 503, { error: "manifest not found" });
     return;
@@ -491,7 +505,22 @@ function handleLiveStream(req, res, format, codec, options = {}) {
       });
     }
   });
-  proc.stdout.pipe(res);
+  let stderrTail = "";
+  proc.stderr.setEncoding("utf8");
+  proc.stderr.on("data", (chunk) => {
+    stderrTail = (stderrTail + chunk).slice(-2e3);
+  });
+  proc.stdout.pipe(res, { end: false });
+  proc.once("close", (code) => {
+    if (!res.headersSent && code !== 0) {
+      const hint = codec === "hevc" && (format === "flv" || format === "ts") ? " (HEVC in FLV/TS requires ffmpeg >= 6 with enhanced-rtmp support)" : "";
+      writeJson(res, 503, {
+        error: "ffmpeg exited before producing output",
+        reason: `${stderrTail.trim().split("\n").at(-1) ?? "unknown"}${hint}`,
+        exitCode: code
+      });
+    }
+  });
   const cleanup = () => {
     if (!proc.killed) proc.kill("SIGKILL");
   };
@@ -620,6 +649,10 @@ function createStreamsServer(options) {
         handleVodList(res, ctx.manifest, ctx.fixtureDir);
         return;
       }
+      if (path === "/streams/vod-list-hevc" || path === "/streams/vod-list-hevc/") {
+        handleVodList(res, ctx.manifest, ctx.fixtureDir, "hevc");
+        return;
+      }
       const resolved = resolveRoute(path);
       if (resolved) {
         serveEntry(req, res, fixtureDir, resolved);

package/dist/server/routes.d.ts

@@ -15,4 +15,4 @@ export type VodSegmentDescriptor = {
 export type VodListResponse = {
     segments: ReadonlyArray<VodSegmentDescriptor>;
 };
-export declare function handleVodList(res: ServerResponse, manifest: Manifest | null, fixtureDir: string): void;
+export declare function handleVodList(res: ServerResponse, manifest: Manifest | null, fixtureDir: string, codec?: "h264" | "hevc"): void;

package/dist/server/server.js

@@ -48,6 +48,10 @@ 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");
+  res.setHeader(
+    "Access-Control-Expose-Headers",
+    "Content-Range, Accept-Ranges, Content-Length, Content-Type"
+  );
 }
 function writeJson(res, status, body) {
   const text = JSON.stringify(body);
@@ -111,6 +115,7 @@ 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._-]+)\/?$/;
+var VOD_HEVC = /^\/streams\/vod-hevc\/([a-zA-Z0-9._-]+)\/?$/;
 function resolveRoute(path) {
   const single = SINGLE.exec(path);
   if (single) {
@@ -132,6 +137,11 @@ function resolveRoute(path) {
     const [, name] = vod;
     return join("vod", name);
   }
+  const vodHevc = VOD_HEVC.exec(path);
+  if (vodHevc) {
+    const [, name] = vodHevc;
+    return join("vod-hevc", name);
+  }
   return null;
 }
 function handleHealth(res, manifest, fixtureDir) {
@@ -152,8 +162,8 @@ function handleList(res, manifest) {
   }
   writeJson(res, 200, manifest);
 }
-function handleVodList(res, manifest, fixtureDir) {
-  const vodListPath = join(fixtureDir, "vod", "vod-list.json");
+function handleVodList(res, manifest, fixtureDir, codec = "h264") {
+  const vodListPath = codec === "hevc" ? join(fixtureDir, "vod-hevc", "vod-list.json") : join(fixtureDir, "vod", "vod-list.json");
   if (existsSync2(vodListPath)) {
     try {
       const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
@@ -172,6 +182,10 @@ function handleVodList(res, manifest, fixtureDir) {
     } catch {
     }
   }
+  if (codec === "hevc") {
+    writeJson(res, 404, { error: "vod-hevc list not found (run extend-vod --codec hevc first)" });
+    return;
+  }
   if (!manifest) {
     writeJson(res, 503, { error: "manifest not found" });
     return;
@@ -304,7 +318,22 @@ function handleLiveStream(req, res, format, codec, options = {}) {
       });
     }
   });
-  proc.stdout.pipe(res);
+  let stderrTail = "";
+  proc.stderr.setEncoding("utf8");
+  proc.stderr.on("data", (chunk) => {
+    stderrTail = (stderrTail + chunk).slice(-2e3);
+  });
+  proc.stdout.pipe(res, { end: false });
+  proc.once("close", (code) => {
+    if (!res.headersSent && code !== 0) {
+      const hint = codec === "hevc" && (format === "flv" || format === "ts") ? " (HEVC in FLV/TS requires ffmpeg >= 6 with enhanced-rtmp support)" : "";
+      writeJson(res, 503, {
+        error: "ffmpeg exited before producing output",
+        reason: `${stderrTail.trim().split("\n").at(-1) ?? "unknown"}${hint}`,
+        exitCode: code
+      });
+    }
+  });
   const cleanup = () => {
     if (!proc.killed) proc.kill("SIGKILL");
   };
@@ -433,6 +462,10 @@ function createStreamsServer(options) {
         handleVodList(res, ctx.manifest, ctx.fixtureDir);
         return;
       }
+      if (path === "/streams/vod-list-hevc" || path === "/streams/vod-list-hevc/") {
+        handleVodList(res, ctx.manifest, ctx.fixtureDir, "hevc");
+        return;
+      }
       const resolved = resolveRoute(path);
       if (resolved) {
         serveEntry(req, res, fixtureDir, resolved);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flow-player/test-streams",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "ffmpeg-driven local test stream service for Flow Player integration testing: generates and serves H.264/HEVC × HTTP-FLV / HLS / fMP4 / MP4 / MPEG-TS fixtures on 127.0.0.1:4177 (live infinite-loop + 5s VOD fixtures).",
   "keywords": [
     "esm",