@wji.ai/cli 0.9.0 → 0.9.1

package/README.md

@@ -215,6 +215,7 @@ wji backreel create "Harbour" -d @synopsis.txt --cover <assetId>
 wji backreel credit add <postId> --npc @mika --role "飾 阿明" --job appearance
 wji backreel image poster.png --slot portrait --post <postId>   # size check + upload + set
 wji backreel episode add <postId> E01.mp4 -t "第一集"            # VOD upload
+wji backreel episode subs add <postId> 1 E01.zh-Hant.srt        # subtitles, one per language
 wji backreel check <postId>
 wji backreel publish <postId>
 wji backreel enquiry list --unread

package/dist/index.js

@@ -281,6 +281,8 @@ var MIME_TYPES = {
   mp3: "audio/mpeg",
   wav: "audio/wav",
   m4a: "audio/mp4",
+  srt: "application/x-subrip",
+  vtt: "text/vtt",
   pdf: "application/pdf",
   csv: "text/csv",
   txt: "text/plain",
@@ -6348,8 +6350,9 @@ async function uploadToVod(token, file, onProgress) {
 var MAX_EPISODES = 30;
 var VIDEO_EXTS = [".mp4", ".mov", ".m4v", ".webm"];
 var ASSET_VIDEO_MAX_BYTES = 200 * 1024 * 1024;
+var subtitlesOf = (e) => (e.subtitles || []).map((s) => ({ id: s.id, lang: s.lang, ...s.label ? { label: s.label } : {} }));
 function toDto(e, order) {
-  const base = { title: e.title, order, tier: e.tier || "public" };
+  const base = { title: e.title, order, tier: e.tier || "public", subtitles: subtitlesOf(e) };
   return e.vodVid ? { ...base, vodVid: e.vodVid } : { ...base, video: idOf2(e.video) };
 }
 async function loadEpisodes(client, postId) {
@@ -6393,9 +6396,62 @@ function printEpisodes(post) {
     { header: "tier", value: (e) => e.tier },
     { header: "source", value: (e) => e.vodVid ? `vod ${e.vodVid}` : e.video ? `asset ${idOf2(e.video)}` : "-" },
     { header: "status", value: (e) => e.vodVid ? e.vodStatus || "?" : e.video ? "ready" : "" },
-    { header: "duration", value: (e) => e.durationSec ? `${Math.round(e.durationSec)}s` : "" }
+    { header: "duration", value: (e) => e.durationSec ? `${Math.round(e.durationSec)}s` : "" },
+    { header: "subs", value: (e) => (e.subtitles || []).map((s) => s.lang).join(" ") }
   ]);
 }
+var MAX_SUBTITLES = 8;
+var SUBTITLE_EXTS = [".srt", ".vtt"];
+var LANG_RE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$/;
+function guessSubtitleLang(fileName) {
+  const padded = `.${basename6(fileName).toLowerCase().replace(/\.(srt|vtt)$/, "")}.`;
+  const hints = [
+    [/(zh[-_]?(hant|tw|hk)|繁|cht)/, "zh-Hant"],
+    [/(zh[-_]?(hans|cn)|简|chs)/, "zh-Hans"],
+    [/(yue|粵|粤)/, "yue"],
+    [/[._ -](en|eng|english)[._ -]/, "en"],
+    [/[._ -](ja|jp|jpn)[._ -]/, "ja"],
+    [/[._ -](ko|kr|kor)[._ -]/, "ko"],
+    [/[._ -](th|tha)[._ -]/, "th"],
+    [/[._ -](vi|vie)[._ -]/, "vi"]
+  ];
+  return hints.find(([re]) => re.test(padded))?.[1];
+}
+function printSubtitles(episode) {
+  const subs = episode.subtitles || [];
+  if (!subs.length) return info(`Episode ${(episode.order ?? 0) + 1} has no subtitles`);
+  table(subs, [
+    { header: "lang", value: (s) => s.lang },
+    { header: "label", value: (s) => s.label || "" },
+    { header: "default", value: (s) => s === subs[0] ? color.green("\u2605") : "" },
+    { header: "id", value: (s) => color.dim(s.id) }
+  ]);
+}
+async function saveSubtitles(client, postId, episodes, i, message) {
+  const updated = await saveEpisodes(client, postId, episodes);
+  const episode = [...updated.episodes || []].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i];
+  render(episode?.subtitles || [], () => {
+    success(message);
+    printSubtitles(episode);
+  });
+}
+function findTrack(subs, lang, i) {
+  const at = subs.findIndex((s) => s.lang.toLowerCase() === lang.toLowerCase());
+  if (at < 0) {
+    const have = subs.map((s) => s.lang).join(", ") || "none";
+    throw new Error(`Episode ${i + 1} has no ${lang} subtitles (has: ${have})`);
+  }
+  return at;
+}
+function pickRendition(renditions, want) {
+  const w = want.toLowerCase();
+  const hit = renditions.find((r) => String(r.definition || "").toLowerCase() === w) || renditions.find((r) => r.height && String(r.height) === w.replace(/p$/, ""));
+  if (!hit) {
+    const have = renditions.map((r) => r.definition || `${r.height}p`).join(", ") || "only the default";
+    throw new Error(`No ${want} rendition (available: ${have})`);
+  }
+  return hit;
+}
 var sourceOptions = (cmd) => cmd.option("--vid <vid>", "a Vid already in the Backreel VOD space").option("--asset <assetId>", "an uploaded WJI video asset (legacy path, public URL)").option("--legacy", "upload the file as a WJI asset (\u2264200 MB) instead of VOD");
 function episodeCommand(globals2) {
   const ep = new Command19("episode").aliases(["episodes", "ep"]).description("Episodes of a showcase post: upload, reorder, gate by tier, check transcoding");
@@ -6417,7 +6473,7 @@ function episodeCommand(globals2) {
     const at = opts.at === void 0 ? episodes.length : episodeIndex(opts.at, episodes.length + 1);
     const source = await resolveSource(client, opts, postId, file);
     if (!source) throw new Error("Give the video: a file, --vid <vid> or --asset <assetId>");
-    episodes.splice(at, 0, { title: opts.title, order: at, tier, ...source });
+    episodes.splice(at, 0, { title: opts.title, order: at, tier, subtitles: [], ...source });
     const updated = await saveEpisodes(client, postId, episodes);
     render(updated.episodes, () => {
       success(`Added episode ${at + 1} "${opts.title}" to "${updated.title}"`);
@@ -6433,12 +6489,21 @@ function episodeCommand(globals2) {
     const i = episodeIndex(n, episodes.length);
     const source = await resolveSource(client, { ...opts, title: opts.title || episodes[i].title }, postId, file);
     if (!opts.title && !opts.tier && !source) throw new Error("Nothing to change \u2014 pass --title, --tier or a new video");
-    const next = { title: opts.title || episodes[i].title, order: i, tier: opts.tier ? oneOf2(opts.tier, TIERS, "--tier") : episodes[i].tier };
+    const next = {
+      title: opts.title || episodes[i].title,
+      order: i,
+      tier: opts.tier ? oneOf2(opts.tier, TIERS, "--tier") : episodes[i].tier,
+      // a new cut of the same episode usually keeps its timing, so the tracks stay
+      subtitles: episodes[i].subtitles
+    };
     episodes[i] = source ? { ...next, ...source } : { ...episodes[i], ...next };
     const updated = await saveEpisodes(client, postId, episodes);
     render(updated.episodes, () => {
       success(`Updated episode ${i + 1}`);
       printEpisodes(updated);
+      if (source && next.subtitles.length) {
+        info(color.dim(`Kept ${next.subtitles.length} subtitle track(s) \u2014 \`wji br episode subs rm\` any that no longer line up`));
+      }
     });
   });
   ep.command("rm <postId> <n...>").description("Remove episodes (later ones move up)").option("-y, --yes", "skip confirmation").action(async (postId, ns, opts) => {
@@ -6513,18 +6578,99 @@ function episodeCommand(globals2) {
       if (rows.some((r) => r.status === "failed")) warn("A failed transcode needs a new upload: `episode set <post> <n> <file>`");
     });
   });
-  ep.command("play <postId> <n>").description("Print a short-lived play URL for episode n (as the owner)").action(async (postId, n) => {
+  ep.command("play <postId> <n>").description("Print a short-lived play URL for episode n (as the owner) \u2014 the best quality unless --quality").option("-q, --quality <q>", "a rendition such as 720p or 480p").option("--qualities", "list every rendition instead of printing one URL").action(async (postId, n, opts) => {
     const client = backreelClient(globals2);
     const post = await loadPost(client, postId);
     const i = episodeIndex(n, (post.episodes || []).length);
     const order = [...post.episodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i].order ?? i;
     const play = await client.get(`${POSTS}/list/${postId}/episodes/${order}/play`);
-    render(play, (p) => {
+    const renditions = play.renditions || [];
+    if (opts.qualities) {
+      return render(renditions, (rows) => {
+        if (!rows.length) return info("Only one version (legacy asset, or VOD returned no renditions)");
+        table(rows, [
+          { header: "quality", value: (r) => r.definition || "" },
+          { header: "size", value: (r) => r.width && r.height ? `${r.width}\xD7${r.height}` : "" },
+          { header: "bitrate", value: (r) => r.bitrate ? `${Math.round(r.bitrate / 1e3)} kbps` : "" }
+        ]);
+        if (play.expiresAt) info(color.dim(`URLs expire ${play.expiresAt} \u2014 --json to get them`));
+      });
+    }
+    const url = opts.quality ? pickRendition(renditions, opts.quality).url : play.url;
+    render({ ...play, url }, (p) => {
       process.stdout.write(`${p.url}
 `);
       if (p.expiresAt) info(color.dim(`expires ${p.expiresAt}`));
     });
   });
+  const subs = ep.command("subs").aliases(["subtitles", "sub"]).description("Subtitle tracks of an episode: .srt / .vtt, one per language, \u22648, the first is the default");
+  subs.command("list <postId> <n>", { isDefault: true }).description("List episode n's subtitle tracks").action(async (postId, n) => {
+    const client = backreelClient(globals2);
+    const post = await loadPost(client, postId);
+    const i = episodeIndex(n, (post.episodes || []).length);
+    const episode = [...post.episodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i];
+    render(episode.subtitles || [], () => printSubtitles(episode));
+  });
+  subs.command("add <postId> <n> <file>").description("Upload a .srt / .vtt and attach it to episode n").option("-l, --lang <lang>", "BCP 47 language: en, ja, ko, zh-Hant, zh-Hans, yue\u2026 (guessed from the file name if omitted)").option("--label <label>", "name shown in the player (default: the language's own name)").option("--default", "make it the default track (first in the list)").option("--replace", "replace the episode's existing track in that language").action(async (postId, n, file, opts) => {
+    const client = backreelClient(globals2);
+    const ext = extname2(file).toLowerCase();
+    if (!SUBTITLE_EXTS.includes(ext)) throw new Error(`${basename6(file)}: subtitles must be .srt or .vtt`);
+    if ((await stat5(file)).size > 1024 * 1024) throw new Error(`${basename6(file)} is over 1 MB`);
+    const lang = opts.lang || guessSubtitleLang(file);
+    if (!lang) throw new Error(`Can't tell the language from "${basename6(file)}" \u2014 pass --lang (e.g. en, zh-Hant)`);
+    if (!LANG_RE.test(lang)) throw new Error(`--lang ${lang} isn't a language code like en, ja or zh-Hant`);
+    const label = opts.label ? String(opts.label).trim() : void 0;
+    if (label && label.length > 40) throw new Error("--label is at most 40 characters");
+    const { post, episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const duration = [...post.episodes].sort((x, y) => (x.order ?? 0) - (y.order ?? 0))[i]?.durationSec;
+    const list = [...episodes[i].subtitles];
+    const existing = list.findIndex((s) => s.lang.toLowerCase() === lang.toLowerCase());
+    if (existing >= 0 && !opts.replace) {
+      throw new Error(`Episode ${i + 1} already has ${lang} subtitles \u2014 add --replace to swap them`);
+    }
+    if (existing < 0 && list.length >= MAX_SUBTITLES) {
+      throw new Error(`Episode ${i + 1} already has ${MAX_SUBTITLES} subtitle tracks`);
+    }
+    const uploaded = await client.upload("/backreel/subtitle/upload", file, {});
+    const keptLabel = label ?? (existing >= 0 ? list[existing].label : void 0);
+    const track = { id: uploaded.id, lang, ...keptLabel ? { label: keptLabel } : {} };
+    if (existing >= 0) list.splice(existing, 1, track);
+    else list.push(track);
+    if (opts.default) list.unshift(...list.splice(list.indexOf(track), 1));
+    episodes[i].subtitles = list;
+    await saveSubtitles(client, postId, episodes, i, `${existing >= 0 ? "Replaced" : "Added"} ${lang} subtitles on episode ${i + 1} (${uploaded.cueCount} lines)`);
+    if (duration && uploaded.lastCueSec > duration + 2) {
+      warn(`The last line is at ${Math.round(uploaded.lastCueSec)}s but the episode is ${Math.round(duration)}s \u2014 is this the right file?`);
+    }
+  });
+  subs.command("rm <postId> <n> <lang...>").description("Remove episode n's tracks in these languages").action(async (postId, n, langs) => {
+    const client = backreelClient(globals2);
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const drop = new Set(langs.map((l) => findTrack(episodes[i].subtitles, l, i)));
+    episodes[i].subtitles = episodes[i].subtitles.filter((_, at) => !drop.has(at));
+    await saveSubtitles(client, postId, episodes, i, `Removed ${langs.join(", ")} from episode ${i + 1}`);
+  });
+  subs.command("default <postId> <n> <lang>").description("Make a track the default (moves it first)").action(async (postId, n, lang) => {
+    const client = backreelClient(globals2);
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const list = [...episodes[i].subtitles];
+    list.unshift(...list.splice(findTrack(list, lang, i), 1));
+    episodes[i].subtitles = list;
+    await saveSubtitles(client, postId, episodes, i, `${list[0].lang} is now episode ${i + 1}'s default`);
+  });
+  subs.command("label <postId> <n> <lang> [label]").description("Set the name the player shows for a track (omit it to go back to the language name)").action(async (postId, n, lang, label) => {
+    const client = backreelClient(globals2);
+    if (label && label.trim().length > 40) throw new Error("A label is at most 40 characters");
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const at = findTrack(episodes[i].subtitles, lang, i);
+    const { label: _old, ...rest } = episodes[i].subtitles[at];
+    episodes[i].subtitles[at] = label?.trim() ? { ...rest, label: label.trim() } : rest;
+    await saveSubtitles(client, postId, episodes, i, `Updated the ${rest.lang} label on episode ${i + 1}`);
+  });
   return ep;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wji.ai/cli",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Command line interface for the WJI AI platform",
   "license": "UNLICENSED",
   "author": "WJI AI",

package/skill/backreel/SKILL.md

@@ -97,6 +97,10 @@ wji br episode set <postId> 3 E03_v2.mp4               # replace the video
 wji br episode move <postId> 4 2
 wji br episode rm <postId> 6 -y
 wji br episode play <postId> 1        # short-lived URL to watch it yourself
+wji br episode play <postId> 1 --qualities   # renditions VOD made (1080p / 720p / …)
+wji br episode subs add <postId> 1 E01.zh-Hant.srt      # language guessed from the name
+wji br episode subs add <postId> 1 E01_en.vtt --lang en --default
+wji br episode subs <postId> 1        # list tracks; the first is the default
 ```
 
 Episodes exist on **showcase** posts only (≤30). A local file goes straight
@@ -105,7 +109,7 @@ nothing on the page can be copied and shared. Transcoding takes a few minutes;
 an episode stays `processing` until then and viewers get "still
 transcoding". Numbers on the command line are 1-based positions. Read
 [reference/episodes.md](reference/episodes.md) for the trailer, the legacy
-asset path, tier strategy and failure handling.
+asset path, tier strategy, subtitles and failure handling.
 
 ## 4. Crowdfunding and donations
 

package/skill/backreel/reference/episodes.md

@@ -78,6 +78,44 @@ wji br episode rm <postId> 7 8 -y
 Removing an episode does not delete the video from VOD; re-adding it later
 with `--vid` works.
 
+## Subtitles
+
+Each episode takes up to 8 subtitle tracks, one per language, from `.srt` or
+`.vtt` files (≤1 MB). The server cleans them into plain WebVTT — italics,
+colours and `{\an8}` positioning are dropped. The **first** track is the
+default; viewers who never chose one get the track matching the site's
+language, else the default.
+
+```bash
+wji br episode subs add <postId> 2 E02.zh-Hant.srt       # zh-Hant guessed from the name
+wji br episode subs add <postId> 2 E02.srt --lang en --label "English (CC)"
+wji br episode subs add <postId> 2 E02_en_v2.srt --lang en --replace
+wji br episode subs default <postId> 2 en
+wji br episode subs label <postId> 2 en                  # back to the language name
+wji br episode subs rm <postId> 2 ja ko
+wji br episode subs <postId> 2
+```
+
+Languages are BCP 47 tags: `zh-Hant`, `zh-Hans`, `yue`, `en`, `ja`, `ko`,
+`th`, `vi`, `id`, `ms`, `es`, `pt`, `fr`, `de` (others are accepted, but the
+player shows the raw code). A file the server can't read fails at upload,
+before the episode changes. `add` warns when the last line runs past the
+episode's length — usually the wrong episode's file.
+
+Subtitles follow the episode's tier: a locked episode never serves its text.
+Replacing the video (`episode set <post> <n> new.mp4`) keeps the tracks; remove
+them if the new cut changed the timing.
+
+## Quality
+
+VOD transcodes each upload into the renditions its template defines. The
+player offers Auto plus each one; with a single rendition the menu hides.
+
+```bash
+wji br episode play <postId> 1 --qualities   # what VOD made
+wji br episode play <postId> 1 -q 720p       # URL of one rendition
+```
+
 ## Who can watch: tiers
 
 `public` anyone · `member` signed in · `supporter` has donated to this post ·