@socialized.dev/cli 0.1.0 → 0.2.0

package/README.md

@@ -8,10 +8,10 @@
 npm install -g @socialized.dev/cli
 ```
 
-Inside the monorepo:
+This installs the `socialized.dev` command:
 
 ```sh
-pnpm -F @socialized.dev/cli cli -- --help
+socialized.dev --help
 ```
 
 ## Auth
@@ -43,6 +43,11 @@ socialized.dev publications create \
 `publications create` uploads local video and cover files internally, then creates the
 publication. You can also pass an existing `asset_...` id to `--video` or `--cover`.
 
+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
+`socialized.dev publications create --help` for the full list.
+
 ## Brands
 
 If your account has multiple brands, you can switch between them:

package/dist/bin.d.ts

@@ -1 +1 @@
-export { };
+export {}

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.1.0";
+var version = "0.2.0";
 //#endregion
 //#region src/api.ts
 var ApiError = class extends Error {
@@ -45,7 +45,7 @@ const createApiClient = (config) => {
 		if (!res.ok) throw new ApiError(res.status, await res.text(), init.method ?? "GET", path);
 		return res;
 	};
-	const json = (path, init) => request(path, init).then((res) => res.json());
+	const json = async (path, init) => (await request(path, init)).json();
 	return {
 		listBrands: () => json("/brands"),
 		startAssetUpload: (body) => json("/assets", {
@@ -139,7 +139,8 @@ const loginCommand = buildCommand({
 		const piped = flags.key === void 0 && !process.stdin.isTTY ? (await readStdin()).trim() : void 0;
 		const key = (flags.key ?? piped)?.trim();
 		if (!key) throw new UsageError("Pass an API key with `--key sk_...` or pipe one to stdin.");
-		const { brands } = await createApiClient(resolveConfig({ apiKey: key })).listBrands();
+		const config = resolveConfig({ apiKey: key });
+		const { brands } = await createApiClient(config).listBrands();
 		saveConfig({
 			apiKey: key,
 			brandId: brands.length === 1 ? brands[0]?.id : void 0
@@ -187,43 +188,45 @@ const resolveBrand = (brands, selector) => {
 	if (matches.length > 1) throw new UsageError(`Brand name is ambiguous: ${selector}`);
 	throw new UsageError(`Brand not found: ${selector}`);
 };
+const listCommand = buildCommand({
+	docs: { brief: "List brands available to the API key" },
+	parameters: { flags: { json: {
+		kind: "boolean",
+		brief: "Print JSON output"
+	} } },
+	async func(flags) {
+		requireAuth(this);
+		const { brands } = await this.api.listBrands();
+		if (flags.json) return jsonOut(this, { brands });
+		if (brands.length === 0) {
+			out(this, "No brands found. Go to the web dashboard to create one.");
+			return;
+		}
+		for (const brand of brands) out(this, `${brand.id}\t${brand.name}\t${brand.connectedPlatforms.join(",") || "-"}`);
+	}
+});
+const useCommand = buildCommand({
+	docs: { brief: "Persist the default brand for publication commands" },
+	parameters: { positional: {
+		kind: "tuple",
+		parameters: [{
+			brief: "Brand id or exact brand name",
+			parse: String
+		}]
+	} },
+	async func(_flags, selector) {
+		requireAuth(this);
+		const { brands } = await this.api.listBrands();
+		if (brands.length === 0) throw new UsageError("No brands found. Go to the web dashboard to create one.");
+		const brand = resolveBrand(brands, selector);
+		saveConfig({ brandId: brand.id });
+		out(this, `Using ${brand.name} (${brand.id}).`);
+	}
+});
 const brandsRoutes = buildRouteMap({
 	routes: {
-		list: buildCommand({
-			docs: { brief: "List brands available to the API key" },
-			parameters: { flags: { json: {
-				kind: "boolean",
-				brief: "Print JSON output"
-			} } },
-			async func(flags) {
-				requireAuth(this);
-				const { brands } = await this.api.listBrands();
-				if (flags.json) return jsonOut(this, { brands });
-				if (brands.length === 0) {
-					out(this, "No brands found. Go to the web dashboard to create one.");
-					return;
-				}
-				for (const brand of brands) out(this, `${brand.id}\t${brand.name}\t${brand.connectedPlatforms.join(",") || "-"}`);
-			}
-		}),
-		use: buildCommand({
-			docs: { brief: "Persist the default brand for publication commands" },
-			parameters: { positional: {
-				kind: "tuple",
-				parameters: [{
-					brief: "Brand id or exact brand name",
-					parse: String
-				}]
-			} },
-			async func(_flags, selector) {
-				requireAuth(this);
-				const { brands } = await this.api.listBrands();
-				if (brands.length === 0) throw new UsageError("No brands found. Go to the web dashboard to create one.");
-				const brand = resolveBrand(brands, selector);
-				saveConfig({ brandId: brand.id });
-				out(this, `Using ${brand.name} (${brand.id}).`);
-			}
-		})
+		list: listCommand,
+		use: useCommand
 	},
 	docs: { brief: "Manage default brand selection" }
 });
@@ -240,6 +243,30 @@ const parseTargets = (value) => {
 	}
 	return targets;
 };
+const parseTags = (value) => value.split(",").map((tag) => tag.trim()).filter(Boolean);
+const ISO_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2})?$/;
+/** A date-time the user typed (an offset-less one reads as local time) → the UTC ISO string the API
+* takes. Strict: `Date` alone would silently roll 2026-02-30 over to March 2 — the wrong release day. */
+const parseDateTime = (value) => {
+	const fields = ISO_DATE_TIME.exec(value)?.slice(1, 7).map((field) => Number(field ?? "0"));
+	const [year = 0, month = 0, day = 0, hour = 0, minute = 0, second = 0] = fields ?? [];
+	const calendar = new Date(Date.UTC(year, month - 1, day, hour, minute, second));
+	const date = new Date(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. */
+const youtubeOptions = (flags) => ({
+	...flags.youtubeTags !== void 0 ? { tags: flags.youtubeTags } : {},
+	...flags.youtubeCategory !== void 0 ? { categoryId: flags.youtubeCategory } : {},
+	...flags.youtubeLanguage !== void 0 ? { defaultLanguage: flags.youtubeLanguage } : {},
+	...flags.youtubeAudioLanguage !== void 0 ? { defaultAudioLanguage: flags.youtubeAudioLanguage } : {},
+	...flags.youtubePrivacy !== void 0 ? { privacyStatus: flags.youtubePrivacy } : {},
+	...flags.youtubeMadeForKids !== void 0 ? { madeForKids: flags.youtubeMadeForKids } : {},
+	...flags.youtubePublishAt !== void 0 ? { publishAt: flags.youtubePublishAt } : {},
+	...flags.youtubeSyntheticMedia !== void 0 ? { containsSyntheticMedia: flags.youtubeSyntheticMedia } : {}
+});
 const resolveBrandId = async (ctx, flagBrand) => {
 	let brandId = flagBrand ?? ctx.config.brandId;
 	if (!brandId) {
@@ -256,12 +283,13 @@ 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 (ext === ".mp4") contentType = "video/mp4";
-	else if (ext === ".mov") contentType = "video/quicktime";
-	else if (ext === ".m4v") contentType = "video/mp4";
-	else if (ext === ".webm") contentType = "video/webm";
-	else contentType = "video/mp4";
-	else if (ext === ".jpg" || ext === ".jpeg") contentType = "image/jpeg";
+	if (kind === "video") {
+		if (ext === ".mp4") contentType = "video/mp4";
+		else if (ext === ".mov") contentType = "video/quicktime";
+		else if (ext === ".m4v") contentType = "video/mp4";
+		else if (ext === ".webm") contentType = "video/webm";
+		else contentType = "video/mp4";
+	} else if (ext === ".jpg" || ext === ".jpeg") contentType = "image/jpeg";
 	else if (ext === ".png") contentType = "image/png";
 	else if (ext === ".webp") contentType = "image/webp";
 	else contentType = "application/octet-stream";
@@ -338,161 +366,218 @@ const printPublicationSummary = (ctx, pub) => {
 	out(ctx, "Targets:");
 	for (const target of pub.targets) out(ctx, `  - ${target.platform}: ${target.status}${target.externalUrl ? ` (${target.externalUrl})` : ""}${target.error ? ` - Error: ${target.error}` : ""}`);
 };
-const publicationsRoutes = buildRouteMap({
-	routes: {
-		create: buildCommand({
-			docs: { brief: "Create a publication, uploading local video/cover files as needed" },
-			parameters: { flags: {
-				video: {
-					kind: "parsed",
-					parse: String,
-					brief: "Video file path or asset id"
-				},
-				cover: {
-					kind: "parsed",
-					parse: String,
-					optional: true,
-					brief: "Cover image path or asset id"
-				},
-				to: {
-					kind: "parsed",
-					parse: parseTargets,
-					brief: "Comma-separated platforms"
-				},
-				title: {
-					kind: "parsed",
-					parse: String,
-					brief: "Publication title"
-				},
-				description: {
-					kind: "parsed",
-					parse: String,
-					optional: true,
-					brief: "Publication description"
-				},
-				brand: {
-					kind: "parsed",
-					parse: String,
-					optional: true,
-					brief: "Brand id"
-				},
-				idempotencyKey: {
-					kind: "parsed",
-					parse: String,
-					optional: true,
-					brief: "Idempotency-Key value"
-				},
-				watch: {
-					kind: "boolean",
-					brief: "Poll until final status"
-				},
-				json: {
-					kind: "boolean",
-					brief: "Print JSON output"
-				}
-			} },
-			async func(flags) {
-				requireAuth(this);
-				const brandId = await resolveBrandId(this, flags.brand);
-				let videoAssetId;
-				if (flags.video.startsWith("asset_")) videoAssetId = flags.video;
-				else videoAssetId = await uploadAsset(this, flags.video, "video", flags.json);
-				let coverAssetId = null;
-				if (flags.cover) if (flags.cover.startsWith("asset_")) coverAssetId = flags.cover;
-				else coverAssetId = await uploadAsset(this, flags.cover, "cover", flags.json);
-				const idempotencyKey = flags.idempotencyKey ?? randomUUID();
-				const result = await this.api.createPublication(brandId, {
-					videoAssetId,
-					coverAssetId,
-					title: flags.title,
-					description: flags.description ?? "",
-					targets: flags.to.map((platform) => ({
-						platform,
-						options: {}
-					}))
-				}, idempotencyKey);
-				if (flags.watch) {
-					const finalResult = await pollPublication(this, brandId, result.publicationId, flags.json);
-					if (flags.json) return jsonOut(this, finalResult);
-					printPublicationSummary(this, finalResult.publication);
-				} else {
-					if (flags.json) return jsonOut(this, result);
-					printDispatchResult(this, result);
-				}
-			}
-		}),
-		get: buildCommand({
-			docs: { brief: "Read a publication" },
-			parameters: {
-				flags: {
-					brand: {
-						kind: "parsed",
-						parse: String,
-						optional: true,
-						brief: "Brand id"
-					},
-					json: {
-						kind: "boolean",
-						brief: "Print JSON output"
-					}
-				},
-				positional: {
-					kind: "tuple",
-					parameters: [{
-						brief: "Publication id",
-						parse: String
-					}]
-				}
+const createCommand = buildCommand({
+	docs: { brief: "Create a publication, uploading local video/cover files as needed" },
+	parameters: { flags: {
+		video: {
+			kind: "parsed",
+			parse: String,
+			brief: "Video file path or asset id"
+		},
+		cover: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "Cover image path or asset id"
+		},
+		to: {
+			kind: "parsed",
+			parse: parseTargets,
+			brief: "Comma-separated platforms"
+		},
+		title: {
+			kind: "parsed",
+			parse: String,
+			brief: "Publication title"
+		},
+		description: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "Publication description"
+		},
+		youtubeTags: {
+			kind: "parsed",
+			parse: parseTags,
+			optional: true,
+			brief: "YouTube: comma-separated tags (500 characters total)"
+		},
+		youtubeCategory: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "YouTube: numeric category id, e.g. 27 (Education)"
+		},
+		youtubeLanguage: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "YouTube: language of the title and description, e.g. en-GB"
+		},
+		youtubeAudioLanguage: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "YouTube: language spoken in the video, e.g. en"
+		},
+		youtubePrivacy: {
+			kind: "enum",
+			values: [
+				"public",
+				"unlisted",
+				"private"
+			],
+			optional: true,
+			brief: "YouTube: privacy status (default public)"
+		},
+		youtubeMadeForKids: {
+			kind: "boolean",
+			optional: true,
+			brief: "YouTube: declare the video made for kids"
+		},
+		youtubePublishAt: {
+			kind: "parsed",
+			parse: parseDateTime,
+			optional: true,
+			brief: "YouTube: upload now as private, go public at this time (local unless offset given)"
+		},
+		youtubeSyntheticMedia: {
+			kind: "boolean",
+			optional: true,
+			brief: "YouTube: disclose realistic altered or synthetic content"
+		},
+		brand: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "Brand id"
+		},
+		idempotencyKey: {
+			kind: "parsed",
+			parse: String,
+			optional: true,
+			brief: "Idempotency-Key value"
+		},
+		watch: {
+			kind: "boolean",
+			brief: "Poll until final status"
+		},
+		json: {
+			kind: "boolean",
+			brief: "Print JSON output"
+		}
+	} },
+	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 brandId = await resolveBrandId(this, flags.brand);
+		let videoAssetId;
+		if (flags.video.startsWith("asset_")) videoAssetId = flags.video;
+		else videoAssetId = await uploadAsset(this, flags.video, "video", flags.json);
+		let coverAssetId = null;
+		if (flags.cover) {
+			if (flags.cover.startsWith("asset_")) coverAssetId = flags.cover;
+			else coverAssetId = await uploadAsset(this, flags.cover, "cover", flags.json);
+		}
+		const idempotencyKey = flags.idempotencyKey ?? randomUUID();
+		const result = await this.api.createPublication(brandId, {
+			videoAssetId,
+			coverAssetId,
+			title: flags.title,
+			description: flags.description ?? "",
+			targets: flags.to.map((platform) => ({
+				platform,
+				options: platform === "youtube" ? youtube : {}
+			}))
+		}, idempotencyKey);
+		if (flags.watch) {
+			const finalResult = await pollPublication(this, brandId, result.publicationId, flags.json);
+			if (flags.json) return jsonOut(this, finalResult);
+			printPublicationSummary(this, finalResult.publication);
+		} else {
+			if (flags.json) return jsonOut(this, result);
+			printDispatchResult(this, result);
+		}
+	}
+});
+const getCommand = buildCommand({
+	docs: { brief: "Read a publication" },
+	parameters: {
+		flags: {
+			brand: {
+				kind: "parsed",
+				parse: String,
+				optional: true,
+				brief: "Brand id"
 			},
-			async func(flags, id) {
-				requireAuth(this);
-				const brandId = await resolveBrandId(this, flags.brand);
-				const result = await this.api.getPublication(brandId, id);
-				if (flags.json) return jsonOut(this, result);
-				printPublicationSummary(this, result.publication);
+			json: {
+				kind: "boolean",
+				brief: "Print JSON output"
 			}
-		}),
-		status: buildCommand({
-			docs: { brief: "Show publication status" },
-			parameters: {
-				flags: {
-					brand: {
-						kind: "parsed",
-						parse: String,
-						optional: true,
-						brief: "Brand id"
-					},
-					watch: {
-						kind: "boolean",
-						brief: "Poll until final status"
-					},
-					json: {
-						kind: "boolean",
-						brief: "Print JSON output"
-					}
-				},
-				positional: {
-					kind: "tuple",
-					parameters: [{
-						brief: "Publication id",
-						parse: String
-					}]
-				}
+		},
+		positional: {
+			kind: "tuple",
+			parameters: [{
+				brief: "Publication id",
+				parse: String
+			}]
+		}
+	},
+	async func(flags, id) {
+		requireAuth(this);
+		const brandId = await resolveBrandId(this, flags.brand);
+		const result = await this.api.getPublication(brandId, id);
+		if (flags.json) return jsonOut(this, result);
+		printPublicationSummary(this, result.publication);
+	}
+});
+const statusCommand = buildCommand({
+	docs: { brief: "Show publication status" },
+	parameters: {
+		flags: {
+			brand: {
+				kind: "parsed",
+				parse: String,
+				optional: true,
+				brief: "Brand id"
 			},
-			async func(flags, id) {
-				requireAuth(this);
-				const brandId = await resolveBrandId(this, flags.brand);
-				if (flags.watch) {
-					const result = await pollPublication(this, brandId, id, flags.json);
-					if (flags.json) return jsonOut(this, result);
-					printPublicationSummary(this, result.publication);
-				} else {
-					const result = await this.api.getPublication(brandId, id);
-					if (flags.json) return jsonOut(this, result);
-					printPublicationSummary(this, result.publication);
-				}
+			watch: {
+				kind: "boolean",
+				brief: "Poll until final status"
+			},
+			json: {
+				kind: "boolean",
+				brief: "Print JSON output"
 			}
-		})
+		},
+		positional: {
+			kind: "tuple",
+			parameters: [{
+				brief: "Publication id",
+				parse: String
+			}]
+		}
+	},
+	async func(flags, id) {
+		requireAuth(this);
+		const brandId = await resolveBrandId(this, flags.brand);
+		if (flags.watch) {
+			const result = await pollPublication(this, brandId, id, flags.json);
+			if (flags.json) return jsonOut(this, result);
+			printPublicationSummary(this, result.publication);
+		} else {
+			const result = await this.api.getPublication(brandId, id);
+			if (flags.json) return jsonOut(this, result);
+			printPublicationSummary(this, result.publication);
+		}
+	}
+});
+const publicationsRoutes = buildRouteMap({
+	routes: {
+		create: createCommand,
+		get: getCommand,
+		status: statusCommand
 	},
 	docs: { brief: "Create and inspect publications" }
 });
@@ -504,7 +589,7 @@ const text = {
 	exceptionWhileRunningCommand: cleanError,
 	commandErrorResult: cleanError
 };
-const app = buildApplication(buildRouteMap({
+const root = buildRouteMap({
 	routes: {
 		login: loginCommand,
 		logout: logoutCommand,
@@ -513,7 +598,8 @@ const app = buildApplication(buildRouteMap({
 		publications: publicationsRoutes
 	},
 	docs: { brief: "socialized.dev — publish videos from the terminal" }
-}), {
+});
+const app = buildApplication(root, {
 	name: "socialized.dev",
 	versionInfo: { currentVersion: version },
 	scanner: { caseStyle: "allow-kebab-for-camel" },

package/package.json

@@ -1,19 +1,11 @@
 {
   "name": "@socialized.dev/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "license": "MIT",
   "type": "module",
   "description": "socialized.dev CLI — publish a video once, everywhere, from the terminal.",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fishballapp/fishballapps.git",
-    "directory": "projects/socialized.dev/apps/cli"
-  },
   "homepage": "https://socialized.dev",
-  "bugs": {
-    "url": "https://github.com/fishballapp/fishballapps/issues"
-  },
   "bin": {
     "socialized.dev": "./dist/bin.js"
   },
@@ -25,12 +17,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@stricli/core": "^1.2.7"
+    "@stricli/core": "^1.3.0"
   },
   "devDependencies": {
-    "@types/node": "^24.0.0",
-    "tsdown": "^0.22.3",
-    "vitest": "^4.1.5"
+    "@types/node": "^24.13.4",
+    "tsdown": "^0.23.0",
+    "vitest": "^4.1.8"
   },
   "scripts": {
     "build": "tsdown",