ossclip 0.1.31 → 0.1.34

package/src/program.ts

@@ -3,13 +3,20 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { Command, InvalidArgumentError } from "commander";
 import { z } from "zod/v4";
-import { CleanupLevelSchema, COVER_MAX_WORDS, SceneComponentIdSchema } from "@ossclip/core";
+import {
+  CleanupLevelSchema,
+  COVER_MAX_WORDS,
+  RESOLUTION_CHOICES,
+  ResolutionChoiceSchema,
+  SceneComponentIdSchema,
+} from "@ossclip/core";
 import { STUDIO_ENTRY } from "@ossclip/renderer";
 import { loadEnvFiles } from "./env";
 import { ExportFormatSchema, runAnalyze } from "./analyze";
 import { expandHome } from "./paths";
 import { phaseBucketProps } from "./phase-timing";
 import { dictionaryFlag, jumpCutsFlag, produce, reviewFlag } from "./produce";
+import { accountsFlag, atFlag, deliveryFlag, platformsFlag, youtubePrivacyFlag } from "./publish";
 // The one interactive import that is STATIC rather than `await import()`: the
 // `resetInputSource()` run boundary in `buildProgram` has to run synchronously
 // while the program is being built, and `buildProgram` cannot await. The graph
@@ -299,6 +306,22 @@ export function buildProgram(): Command {
       "output shape: 9:16 (vertical, default) or 16:9 (landscape, 1920x1080)",
       "9:16",
     )
+    .option(
+      "--resolution <height>",
+      "output height: 1080 (default), 1440, 2160, or auto (keep what the source has, " +
+        "capped at 2160). Config key: \"resolution\"",
+      (v: string) => {
+        // Parse, never coerce (CLAUDE.md): a typo'd `--resolution 2610` must
+        // not silently render 1080p, and `Number()` on "auto" is NaN.
+        const parsed = ResolutionChoiceSchema.safeParse(v.trim());
+        if (!parsed.success) {
+          throw new InvalidArgumentError(
+            `--resolution wants one of ${RESOLUTION_CHOICES.join(", ")}, got "${v}"`,
+          );
+        }
+        return parsed.data;
+      },
+    )
     .option("--produce", "run the LLM producer brain to plan title cards & graphics", false)
     .option(
       "--clip <seconds>",
@@ -356,6 +379,12 @@ export function buildProgram(): Command {
       "--whisper-language <code>",
       "transcription language code for a multilingual model, e.g. ur | de | auto (whisper defaults to en)",
     )
+    .option(
+      "--whisper-translate",
+      "translate the speech to ENGLISH captions instead of transcribing it verbatim " +
+        "(whisper's -tr; pair with --whisper-language for the SOURCE language)",
+      false,
+    )
     // COMMA-SEPARATED in one value, not variadic: a variadic option swallows
     // the optional positional [input] whenever the flag precedes the path,
     // and commander offers no way to give the positional priority.
@@ -406,6 +435,19 @@ export function buildProgram(): Command {
     .option("--no-watermark", "no wordmark, even when the config turns it on")
     // Same tri-state shape as --watermark above (positive declared first so
     // commander's default stays undefined = "not typed"): the config's
+    // `coverInVideo` key supplies the default (resolveCoverInVideo), and a
+    // typed --no-cover-in-video still beats a config-on. A separate key from
+    // --cover/--no-cover, which is about WRITING the cover file at all.
+    .option(
+      "--cover-in-video",
+      "overlay the cover image on the video's first frames, for the platforms that ignore " +
+        "an uploaded cover and use frame 1. Nothing is inserted — the overlay ends at the " +
+        "first spoken word (max 0.5s), so no timing moves " +
+        "(set it once with coverInVideo: true in ~/.ossclip/config.json)",
+    )
+    .option("--no-cover-in-video", "no cover overlay, even when the config turns it on")
+    // Same tri-state shape as --watermark above (positive declared first so
+    // commander's default stays undefined = "not typed"): the config's
     // `youtube` key supplies the default (resolveYoutube), and a typed
     // --no-youtube still beats a config-on.
     .option(
@@ -630,6 +672,7 @@ export function buildProgram(): Command {
           repair: opts.repair,
           whisperModel: opts.whisperModel,
           whisperLanguage,
+          whisperTranslate: opts.whisperTranslate === true,
           // Split/trim/drop-empties (dictionaryFlag) — undefined stays
           // undefined so the config's dictionary can supply the default.
           dictionary: dictionaryFlag(opts.dictionary),
@@ -644,6 +687,9 @@ export function buildProgram(): Command {
           zoom: opts.zoom,
           // undefined = "not typed", so produce can let the config decide.
           watermark: opts.watermark,
+          // The watermark's tri-state again, resolved by resolveCoverInVideo
+          // at the use site against the config's `coverInVideo`.
+          coverInVideo: opts.coverInVideo,
           // The same tri-state contract as watermark, resolved by
           // resolveYoutube at the use site; --portrait rides along untyped =
           // undefined so the config's path can supply it.
@@ -670,6 +716,9 @@ export function buildProgram(): Command {
           // Validated by concurrencyFlag at parse time; undefined = "not
           // typed", which is what lets the config supply it.
           concurrency: opts.concurrency,
+          // Same contract: validated by the flag's own parser, and undefined
+          // means "not typed" so the config's `resolution` can supply it.
+          resolution: opts.resolution,
         });
         // Counts, buckets and names only — the duration crosses the wire as a
         // bucket, and nothing here can carry a path (assertSafeProps enforces
@@ -741,6 +790,12 @@ export function buildProgram(): Command {
       "--whisper-language <code>",
       "transcription language code for a multilingual model, e.g. ur | de | auto (whisper defaults to en)",
     )
+    .option(
+      "--whisper-translate",
+      "translate the speech to ENGLISH captions instead of transcribing it verbatim " +
+        "(whisper's -tr; pair with --whisper-language for the SOURCE language)",
+      false,
+    )
     .action(async (input: string, opts) => {
       const cleanup = CleanupLevelSchema.parse(opts.cleanup);
       const result = await produce(input, {
@@ -752,6 +807,7 @@ export function buildProgram(): Command {
         noiseDb: opts.noiseDb,
         whisperModel: opts.whisperModel,
         // Same guard as produce's: empty must error, not become a bare `-l`.
+        whisperTranslate: opts.whisperTranslate === true,
         whisperLanguage:
           opts.whisperLanguage !== undefined
             ? z.string().trim().min(1, "--whisper-language needs a code, e.g. ur").parse(opts.whisperLanguage)
@@ -991,6 +1047,68 @@ export function buildProgram(): Command {
       });
     });
 
+  program
+    .command("publish")
+    .description(
+      "push the finished render to your social accounts through your own self-hosted " +
+        "Postiz instance — now, or scheduled with --at",
+    )
+    // Optional like `edit`'s and `cover`'s: no argument resolves the run
+    // under the CURRENT directory.
+    .argument("[workdir]", "a work directory, or the folder you produced in")
+    .option(
+      "--at <iso>",
+      "schedule instead of publishing now — an ISO-8601 time in the future " +
+        "(e.g. 2026-09-01T08:00:00+02:00)",
+      // Wrapped: commander's parseArg passes (value, previous), and atFlag's
+      // second parameter is its injectable clock — not a place for `previous`.
+      (v: string) => atFlag(v),
+    )
+    .option(
+      "--platforms <list>",
+      "only these platforms, comma-separated (linkedin,instagram,tiktok,x,facebook,youtube)",
+      platformsFlag,
+    )
+    .option("--accounts <ids>", "explicit Postiz integration ids, comma-separated (the no-TTY path)", accountsFlag)
+    .option("--all", "every connected account (after --platforms, when both are given)", false)
+    .option("--dry-run", "print the targets and the exact payload; send nothing", false)
+    .option("-y, --yes", "skip the confirmation prompt", false)
+    .option("--force", "publish again even though this workdir already has a publish receipt", false)
+    .option(
+      "--youtube-privacy <level>",
+      "YouTube visibility: private (default), unlisted or public",
+      youtubePrivacyFlag,
+    )
+    .option(
+      "--delivery <mode>",
+      "what to upload — auto: a ≤1080p ~10 Mbps delivery encode, built once and " +
+        "cached in the workdir; master: the untouched render",
+      deliveryFlag,
+      "auto",
+    )
+    .action(async (workdir: string | undefined, opts) => {
+      const { runPublish } = await import("./publish");
+      const target = await resolveWorkdirArgument(workdir ?? ".", "publish");
+      await runPublish(target, {
+        at: opts.at,
+        platforms: opts.platforms,
+        accounts: opts.accounts,
+        all: opts.all,
+        dryRun: opts.dryRun,
+        yes: opts.yes,
+        force: opts.force,
+        // Validated by youtubePrivacyFlag at parse time; undefined means the
+        // payload's own safe default (private).
+        youtubePrivacy: opts.youtubePrivacy,
+        delivery: opts.delivery,
+      });
+      telemetry.record("publish_run", {
+        scheduled: opts.at !== undefined,
+        dry_run: opts.dryRun === true,
+      });
+      await telemetry.flush();
+    });
+
   program
     .command("setup")
     .description(