@socialized.dev/cli 0.2.0 → 0.3.0

package/README.md

@@ -45,7 +45,8 @@ publication. You can also pass an existing `asset_...` id to `--video` or `--cov
 
 YouTube targets take `--youtube-tags`, `--youtube-category`, `--youtube-language`,
 `--youtube-audio-language`, `--youtube-privacy`, `--youtube-made-for-kids`,
-`--youtube-synthetic-media` and `--youtube-publish-at` (schedule the release); run
+`--youtube-synthetic-media`, `--youtube-publish-at` (schedule the release), `--youtube-caption`
+and `--youtube-playlist`; run
 `socialized.dev publications create --help` for the full list.
 
 ## Brands

package/dist/bin.js

@@ -6,7 +6,7 @@ import { basename, extname, join } from "node:path";
 import { randomUUID } from "node:crypto";
 import { Readable } from "node:stream";
 //#region package.json
-var version = "0.2.0";
+var version = "0.3.0";
 //#endregion
 //#region src/api.ts
 var ApiError = class extends Error {
@@ -255,9 +255,27 @@ const parseDateTime = (value) => {
 	if (fields === void 0 || calendar.getUTCFullYear() !== year || calendar.getUTCMonth() !== month - 1 || calendar.getUTCDate() !== day || calendar.getUTCHours() !== hour || calendar.getUTCMinutes() !== minute || calendar.getUTCSeconds() !== second || Number.isNaN(date.getTime())) throw new UsageError(`Not a date-time: ${value} (e.g. 2026-10-01T09:00 or 2026-10-01T09:00Z)`);
 	return date.toISOString();
 };
-/** The YouTube target's `options` bag from the `--youtube-*` flags. Only set fields are sent, so the
-* API's defaults (public, not made for kids) and its validation stay the single source of truth. */
+/** `--youtube-caption <lang>[:<name>]=<path|asset_id>` — e.g. `en=./subs.srt`, `en:SDH=./sdh.vtt`.
+* Language tags never contain `:` or `=`, so the first of each splits unambiguously. */
+const parseCaption = (value) => {
+	const eq = value.indexOf("=");
+	const track = eq === -1 ? "" : value.slice(0, eq);
+	const source = eq === -1 ? "" : value.slice(eq + 1);
+	const colon = track.indexOf(":");
+	const language = colon === -1 ? track : track.slice(0, colon);
+	const name = colon === -1 ? void 0 : track.slice(colon + 1);
+	if (language === "" || source === "") throw new UsageError(`Not a caption: ${value} (e.g. en=./subs.srt or en:SDH=./sdh.vtt)`);
+	return {
+		language,
+		source,
+		...name ? { name } : {}
+	};
+};
+/** The YouTube target's `options` bag from the `--youtube-*` flags (captions join later, once their
+* files are uploaded). Only set fields are sent, so the API's defaults (public, not made for kids) and
+* its validation stay the single source of truth. */
 const youtubeOptions = (flags) => ({
+	...flags.youtubePlaylist?.length ? { playlistIds: flags.youtubePlaylist } : {},
 	...flags.youtubeTags !== void 0 ? { tags: flags.youtubeTags } : {},
 	...flags.youtubeCategory !== void 0 ? { categoryId: flags.youtubeCategory } : {},
 	...flags.youtubeLanguage !== void 0 ? { defaultLanguage: flags.youtubeLanguage } : {},
@@ -283,7 +301,11 @@ const resolveBrandId = async (ctx, flagBrand) => {
 const uploadAsset = async (ctx, filePath, kind, jsonMode) => {
 	const ext = extname(filePath).toLowerCase();
 	let contentType = "application/octet-stream";
-	if (kind === "video") {
+	if (kind === "caption") {
+		if (ext === ".srt") contentType = "application/x-subrip";
+		else if (ext === ".vtt") contentType = "text/vtt";
+		else throw new UsageError(`Caption files must be .srt or .vtt: ${filePath}`);
+	} else if (kind === "video") {
 		if (ext === ".mp4") contentType = "video/mp4";
 		else if (ext === ".mov") contentType = "video/quicktime";
 		else if (ext === ".m4v") contentType = "video/mp4";
@@ -343,12 +365,11 @@ const pollPublication = async (ctx, brandId, pubId, jsonMode) => {
 	while (true) {
 		const result = await ctx.api.getPublication(brandId, pubId);
 		const pub = result.publication;
-		if (jsonMode) {
-			err(ctx, `Status: ${pub.status}`);
-			for (const target of pub.targets) err(ctx, `  - ${target.platform}: ${target.status}${target.error ? ` (${target.error})` : ""}`);
-		} else {
-			out(ctx, `Status: ${pub.status}`);
-			for (const target of pub.targets) out(ctx, `  - ${target.platform}: ${target.status}${target.error ? ` (${target.error})` : ""}`);
+		const log = jsonMode ? err : out;
+		log(ctx, `Status: ${pub.status}`);
+		for (const target of pub.targets) {
+			log(ctx, `  - ${target.platform}: ${target.status}${target.error ? ` (${target.error})` : ""}`);
+			for (const warning of target.warnings ?? []) log(ctx, `      warning: ${warning}`);
 		}
 		if (pub.status === "done" || pub.status === "failed" || pub.status === "partial") return result;
 		await new Promise((resolve) => setTimeout(resolve, intervalMs));
@@ -364,7 +385,10 @@ const printPublicationSummary = (ctx, pub) => {
 	out(ctx, `Publication ID: ${pub.id}`);
 	out(ctx, `Status: ${pub.status}`);
 	out(ctx, "Targets:");
-	for (const target of pub.targets) out(ctx, `  - ${target.platform}: ${target.status}${target.externalUrl ? ` (${target.externalUrl})` : ""}${target.error ? ` - Error: ${target.error}` : ""}`);
+	for (const target of pub.targets) {
+		out(ctx, `  - ${target.platform}: ${target.status}${target.externalUrl ? ` (${target.externalUrl})` : ""}${target.error ? ` - Error: ${target.error}` : ""}`);
+		for (const warning of target.warnings ?? []) out(ctx, `      warning: ${warning}`);
+	}
 };
 const createCommand = buildCommand({
 	docs: { brief: "Create a publication, uploading local video/cover files as needed" },
@@ -446,6 +470,20 @@ const createCommand = buildCommand({
 			optional: true,
 			brief: "YouTube: disclose realistic altered or synthetic content"
 		},
+		youtubeCaption: {
+			kind: "parsed",
+			parse: parseCaption,
+			variadic: true,
+			optional: true,
+			brief: "YouTube: caption track <lang>[:<name>]=<.srt/.vtt path or asset id> (repeatable)"
+		},
+		youtubePlaylist: {
+			kind: "parsed",
+			parse: String,
+			variadic: true,
+			optional: true,
+			brief: "YouTube: add the video to this playlist id (repeatable)"
+		},
 		brand: {
 			kind: "parsed",
 			parse: String,
@@ -470,7 +508,17 @@ const createCommand = buildCommand({
 	async func(flags) {
 		requireAuth(this);
 		const youtube = youtubeOptions(flags);
-		if (Object.keys(youtube).length > 0 && !flags.to.includes("youtube")) throw new UsageError("`--youtube-*` flags need `youtube` in `--to`.");
+		const captionFlags = flags.youtubeCaption ?? [];
+		if ((Object.keys(youtube).length > 0 || captionFlags.length > 0) && !flags.to.includes("youtube")) throw new UsageError("`--youtube-*` flags need `youtube` in `--to`.");
+		const captions = [];
+		for (const { source, ...track } of captionFlags) {
+			const assetId = source.startsWith("asset_") ? source : await uploadAsset(this, source, "caption", flags.json);
+			captions.push({
+				assetId,
+				...track
+			});
+		}
+		if (captions.length > 0) youtube.captions = captions;
 		const brandId = await resolveBrandId(this, flags.brand);
 		let videoAssetId;
 		if (flags.video.startsWith("asset_")) videoAssetId = flags.video;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialized.dev/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "license": "MIT",
   "type": "module",