@flow-player/test-streams 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flow-player/test-streams",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "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",
@@ -15,24 +15,37 @@
   ],
   "license": "MIT",
   "type": "module",
+  "bin": {
+    "test-streams": "./dist/cli/serve.js",
+    "test-streams-generate": "./dist/cli/generate.js"
+  },
   "exports": {
-    ".": "./src/index.ts",
-    "./server": "./src/server/server.ts",
-    "./fixtures/generate": "./src/fixtures/generate.ts",
-    "./fixtures/catalog": "./src/fixtures/catalog.ts",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/server.d.ts",
+      "default": "./dist/server/server.js"
+    },
+    "./fixtures/generate": {
+      "types": "./dist/fixtures/generate.d.ts",
+      "default": "./dist/fixtures/generate.js"
+    },
+    "./fixtures/catalog": {
+      "types": "./dist/fixtures/catalog.d.ts",
+      "default": "./dist/fixtures/catalog.js"
+    },
     "./vite-plugin": {
-      "types": "./src/vite-plugin.d.ts",
-      "default": "./src/vite-plugin.ts"
+      "types": "./dist/vite-plugin.d.ts",
+      "default": "./dist/vite-plugin.js"
     }
   },
   "files": [
     "README.md",
     "LICENSE",
-    "src/"
+    "dist/"
   ],
-  "engines": {
-    "node": ">=24.0.0"
-  },
   "dependencies": {},
   "publishConfig": {
     "access": "public",

package/src/cli/generate.ts

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-  ALL_CODECS,
-  ALL_FORMATS,
-  DEFAULT_DURATION_SECONDS,
-  DEFAULT_FIXTURE_DIR,
-  type CodecId,
-  type FormatId,
-} from "../config.ts";
-import { generateFixtures } from "../fixtures/generate.ts";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const repoRoot = resolve(here, "..", "..", "..");
-
-const CODEC_SET: Record<string, true> = { h264: true, hevc: true };
-const FORMAT_SET: Record<string, true> = { flv: true, hls: true, mp4: true, fmp4: true, ts: true };
-
-type ParsedArgs = {
-  codecs: ReadonlyArray<CodecId>;
-  formats: ReadonlyArray<FormatId>;
-  durationSeconds: number;
-  fixtureDir: string;
-  overwrite: boolean;
-  help: boolean;
-};
-
-function parseArgs(argv: ReadonlyArray<string>): ParsedArgs {
-  const parsed: ParsedArgs = {
-    codecs: ALL_CODECS,
-    formats: ALL_FORMATS,
-    durationSeconds: DEFAULT_DURATION_SECONDS,
-    fixtureDir: resolve(here, "..", "..", DEFAULT_FIXTURE_DIR),
-    overwrite: false,
-    help: false,
-  };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    switch (arg) {
-      case "--codecs": {
-        const value = argv[++i] ?? "";
-        const list = value
-          .split(",")
-          .map((s) => s.trim())
-          .filter((s): s is CodecId => CODEC_SET[s] === true);
-        if (list.length === 0) throw new Error(`--codecs invalid: ${value}`);
-        parsed.codecs = list;
-        break;
-      }
-      case "--formats": {
-        const value = argv[++i] ?? "";
-        const list = value
-          .split(",")
-          .map((s) => s.trim())
-          .filter((s): s is FormatId => FORMAT_SET[s] === true);
-        if (list.length === 0) throw new Error(`--formats invalid: ${value}`);
-        parsed.formats = list;
-        break;
-      }
-      case "--duration": {
-        const value = Number(argv[++i]);
-        if (!Number.isFinite(value) || value <= 0)
-          throw new Error(`--duration must be positive, got ${argv[i]}`);
-        parsed.durationSeconds = value;
-        break;
-      }
-      case "--fixture-dir": {
-        parsed.fixtureDir = resolve(argv[++i] ?? "");
-        break;
-      }
-      case "--overwrite":
-        parsed.overwrite = true;
-        break;
-      case "--help":
-      case "-h":
-        parsed.help = true;
-        break;
-      default:
-        throw new Error(`Unknown option: ${arg}`);
-    }
-  }
-  return parsed;
-}
-
-const USAGE = `Usage:
-  pnpm --filter @flow-player/test-streams run generate [-- <args>]
-
-Options:
-  --codecs <h264,hevc>          Codecs to generate (default: h264,hevc)
-  --formats <flv,hls,mp4,fmp4,ts>
-                                Container formats to generate (default: all 5)
-  --duration <seconds>          Per-fixture duration (default: 5)
-  --fixture-dir <path>          Output directory (default: packages/test-streams/fixtures)
-  --overwrite                   Re-run ffmpeg even if output exists
-  --help, -h                    Show this help
-`;
-
-async function main(): Promise<number> {
-  let args: ParsedArgs;
-  try {
-    args = parseArgs(process.argv.slice(2));
-  } catch (err) {
-    process.stderr.write(`${(err as Error).message}\n${USAGE}`);
-    return 1;
-  }
-  if (args.help) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  const result = await generateFixtures({
-    codecs: args.codecs,
-    formats: args.formats,
-    durationSeconds: args.durationSeconds,
-    fixtureDir: args.fixtureDir,
-    overwrite: args.overwrite,
-  });
-  if (result.ffmpegMissing) {
-    process.stderr.write(
-      "ffmpeg not found in PATH. Install ffmpeg (brew install ffmpeg) and re-run.\n",
-    );
-    return 0;
-  }
-  process.stdout.write(
-    `Generated ${result.generated} fixture(s) under ${result.fixtureDir}\n` +
-      `Manifest: ${resolve(result.fixtureDir, "manifest.json")}\n`,
-  );
-  return 0;
-}
-
-void repoRoot;
-main().then(
-  (code) => process.exit(code),
-  (err) => {
-    process.stderr.write(`${(err as Error).message}\n`);
-    process.exit(1);
-  },
-);

package/src/cli/serve.ts

@@ -1,112 +0,0 @@
-#!/usr/bin/env node
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { DEFAULT_FIXTURE_DIR, DEFAULT_PORT, type ServeOptions } from "../config.ts";
-import { createStreamsServer, listen } from "../server/server.ts";
-
-const here = dirname(fileURLToPath(import.meta.url));
-
-type ParsedArgs = ServeOptions & { help: boolean };
-
-function parseArgs(argv: ReadonlyArray<string>): ParsedArgs {
-  const parsed: ParsedArgs = {
-    port: DEFAULT_PORT,
-    fixtureDir: resolve(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 > 65_535)
-          throw new Error(`--port invalid: ${argv[i]}`);
-        parsed.port = v;
-        break;
-      }
-      case "--host":
-        parsed.host = argv[++i];
-        break;
-      case "--fixture-dir":
-        parsed.fixtureDir = resolve(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;
-}
-
-const 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(): Promise<number> {
-  let args: ParsedArgs;
-  try {
-    args = parseArgs(process.argv.slice(2));
-  } catch (err) {
-    process.stderr.write(`${(err as Error).message}\n${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 as string,
-    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}\n`,
-  );
-  process.stdout.write(
-    `  health:  ${protocol}://${listening.host}:${listening.port}/streams/health\n`,
-  );
-  process.stdout.write(`  fixture: ${resolve(args.fixtureDir ?? "")}\n`);
-  // 等待 SIGINT / SIGTERM 或未捕获异常,再决定是否 exit。
-  const { promise, resolve: resolveWait } = Promise.withResolvers<number>();
-  const shutdown = (code: number): void => {
-    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}\n`);
-    shutdown(1);
-  });
-  return promise;
-}
-
-void main().then(
-  (code) => process.exit(code),
-  (err) => {
-    process.stderr.write(`${(err as Error).message}\n`);
-    process.exit(1);
-  },
-);

package/src/config.ts

@@ -1,34 +0,0 @@
-// Streams server / fixture defaults. Override per call when needed.
-export const DEFAULT_PORT = 4177;
-export const DEFAULT_HOST = "127.0.0.1";
-export const DEFAULT_FIXTURE_DIR = "fixtures";
-export const DEFAULT_DURATION_SECONDS = 5;
-export const DEFAULT_VIDEO_WIDTH = 1280;
-export const DEFAULT_VIDEO_HEIGHT = 720;
-export const DEFAULT_VIDEO_FPS = 25;
-export const DEFAULT_GOP_SECONDS = 1;
-export 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 const ALL_CODECS: ReadonlyArray<CodecId> = ["h264", "hevc"];
-export const ALL_FORMATS: ReadonlyArray<FormatId> = ["flv", "hls", "mp4", "fmp4", "ts"];

package/src/fixtures/catalog.ts

@@ -1,99 +0,0 @@
-// 读 manifest.json 并对外提供按 codec / format 维度的查询。
-// 不依赖 ffmpeg;generate.ts 负责写 manifest,catalog 负责读 + 过滤。
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { ALL_CODECS, ALL_FORMATS, type CodecId, type FormatId } from "../config.ts";
-
-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 function loadManifest(fixtureDir: string): Manifest | null {
-  const path = resolve(fixtureDir, "manifest.json");
-  if (!existsSync(path)) return null;
-  const raw = JSON.parse(readFileSync(path, "utf8")) as Manifest;
-  return raw;
-}
-
-export function lookupFixture(
-  manifest: Manifest | null,
-  codec: CodecId,
-  format: FormatId,
-): FixtureLookup {
-  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 };
-  // 主文件 = 第一个 entry(generate.ts 中 entries 顺序稳定:主文件优先)。
-  const mainFile = item.entries[0] ?? null;
-  return { files: item.entries, mainFile, exists: true };
-}
-
-export type CatalogSummary = {
-  codecs: ReadonlyArray<CodecId>;
-  formats: ReadonlyArray<FormatId>;
-  fixtureCount: number;
-  exists: boolean;
-  reason?: string;
-};
-
-export function summarizeCatalog(fixtureDir: string): CatalogSummary {
-  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,
-  };
-}
-
-// 用 manifest 的 sha256 重新对磁盘文件做核对;供 generate.ts 写完磁盘后自检。
-export function verifyEntryOnDisk(
-  fixtureDir: string,
-  entry: ManifestEntry,
-): { ok: boolean; size: number; reason?: string } {
-  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 };
-}

package/src/fixtures/codec.ts

@@ -1,43 +0,0 @@
-// Per-codec ffmpeg 参数集。Centralized so generate.ts and any future
-// probe code agree on a single source of truth。
-import type { CodecId } from "../config.ts";
-
-export type CodecSpec = {
-  codec: CodecId;
-  encoder: string;
-  // 通用视频参数(所有 format 都用)
-  videoArgs: ReadonlyArray<string>;
-  // 容器 tag(在 MP4 / fMP4 时需要 hvc1,FLV / TS 不需要)
-  audioArgs: ReadonlyArray<string>;
-  pixelFormat: string;
-};
-
-export const CODEC_SPEC: Record<CodecId, CodecSpec> = {
-  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",
-  },
-};
-
-export function containerExtraArgs(
-  format: "flv" | "hls" | "mp4" | "fmp4" | "ts",
-  codec: CodecId,
-): ReadonlyArray<string> {
-  if (codec !== "hevc") return [];
-  // HEVC + MP4 / fMP4 / HLS:fMP4/HLS 内部 ts 段走 mpegts 复用,不需要 tag;
-  // 单纯 MP4 文件需要 -tag:v hvc1 才会被 QuickTime/Safari 识别。
-  if (format === "mp4") return ["-tag:v", "hvc1"];
-  return [];
-}

package/src/fixtures/format.ts

@@ -1,118 +0,0 @@
-// Per-format output plan. ffmpeg 参数 + 相对 fixture 根的输出路径。
-// 单一事实源：matrix.ts 与 generate.ts 都从这份声明派生。
-// 文件布局约定:
-//   flv/mp4/ts  → {format}/{codec}.{format}      单文件,无 codec 子目录
-//   hls         → hls/{codec}/master.m3u8 + seg-NN.ts
-//   fmp4        → fmp4/{codec}/init.mp4 + seg-NN.m4s
-import { join } from "node:path";
-import type { CodecId, FormatId } from "../config.ts";
-
-export type FormatLayout = {
-  format: FormatId;
-  mime: string;
-  // 单文件格式:文件名(无父目录)。HLS/fMP4:目录内主文件名(master.m3u8/init.mp4)。
-  mainFileName: string;
-  // ffmpeg 参数,只描述容器层(不含 -c:v -c:a,见 codec.ts)。
-  containerArgs: ReadonlyArray<string>;
-  isContainerDirectory: boolean;
-  sideFiles: ReadonlyArray<string>;
-};
-
-function formatSpecific(format: FormatId): ReadonlyArray<string> {
-  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)}`);
-}
-
-export function layoutFor(codec: CodecId, format: FormatId): FormatLayout {
-  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)}`);
-}
-
-// 单文件格式的相对路径: {format}/{codec}.{format}
-export function singleFileRelative(codec: CodecId, format: FormatId): string {
-  return join(format, `${codec}.${format}`);
-}
-
-// HLS / fMP4 子目录的相对路径: {format}/{codec}/...
-export function containerRelativeDir(codec: CodecId, format: FormatId): string {
-  return join(format, codec);
-}
-
-export function containerRelativePath(codec: CodecId, format: FormatId, name: string): string {
-  return join(containerRelativeDir(codec, format), name);
-}