@x12i/youtube-video-uploader-cli 1.4.0 → 1.6.1

package/src/update.js

@@ -4,11 +4,50 @@ import { google } from 'googleapis';
 import { loadMetadata } from './metadata.js';
 import { UploadState } from './state.js';
 import { authenticate } from './auth.js';
+import { listPlaylistItems } from './playlist/reorder.js';
 
 export const QUOTA_PER_VIDEO_UPDATE = 50;
 export const QUOTA_PER_PLAYLIST_UPDATE = 50;
 export const QUOTA_PER_LIST = 1;
 
+/**
+ * Apply a find/replace to a string.
+ * @param {string} text
+ * @param {string} pattern
+ * @param {string} [replacement]
+ * @param {boolean} [literal=false]
+ */
+export function applyTextReplace(text, pattern, replacement = '', literal = false) {
+  if (!pattern || text == null) return text;
+  const value = String(text);
+  if (literal) {
+    return value.split(pattern).join(replacement);
+  }
+  return value.replace(new RegExp(pattern, 'g'), replacement);
+}
+
+/**
+ * Deep-replace matching strings anywhere in a JSON-serializable object.
+ * @param {unknown} value
+ * @param {string} pattern
+ * @param {string} [replacement]
+ * @param {boolean} [literal=false]
+ */
+export function deepReplaceInObject(value, pattern, replacement = '', literal = false) {
+  if (typeof value === 'string') {
+    return applyTextReplace(value, pattern, replacement, literal);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => deepReplaceInObject(item, pattern, replacement, literal));
+  }
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, item]) => [key, deepReplaceInObject(item, pattern, replacement, literal)])
+    );
+  }
+  return value;
+}
+
 /**
  * Update snippet fields of a YouTube video while preserving other metadata.
  *
@@ -132,6 +171,9 @@ export async function updatePlaylistTitle(youtube, playlistId, newTitle) {
  * @param {string} [options.playlistTitle] - Override playlist title
  * @param {string} [options.replacePattern] - Regex or substring to find in titles
  * @param {string} [options.replaceWith] - Replacement string
+ * @param {boolean} [options.replaceLiteral=false] - Treat replacePattern as a plain substring
+ * @param {boolean} [options.replaceInSnippet=false] - Also replace in descriptions/tags on YouTube
+ * @param {string} [options.includePlaylistId] - Include every video in this playlist (e.g. overview prefix videos)
  * @param {string} [options.metadataFile] - Custom path to metadata.json
  * @param {boolean} [options.updateLocalMetadata=true] - Update metadata.json on disk
  * @param {boolean} [options.syncMetadata=false] - Push titles from metadata.json directly to YouTube
@@ -156,6 +198,14 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
   const dryRun = Boolean(options.dryRun);
   const onEvent = options.onEvent || (() => {});
   const updateLocal = options.updateLocalMetadata !== false;
+  const replaceLiteral = Boolean(options.replaceLiteral);
+  const replaceInSnippet = Boolean(options.replaceInSnippet);
+  const includePlaylistId = options.includePlaylistId || null;
+
+  const replaceText = (text) => {
+    if (!options.replacePattern) return text;
+    return applyTextReplace(text, options.replacePattern, options.replaceWith || '', replaceLiteral);
+  };
 
   const metadataPath = options.metadataFile
     ? path.resolve(options.metadataFile)
@@ -175,10 +225,30 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
   const cachedPlaylist = state.getPlaylist(playlistKey);
   const playlistId = options.singlePlaylistId || rawMetadata?.playlistId || rawMetadata?.playlist?.playlistId || cachedPlaylist?.playlistId || state.getPlaylist('gray_to_light')?.playlistId || null;
 
+  let youtube = null;
+  const needsYoutubeForPlan = Boolean(includePlaylistId && options.replacePattern);
+  if (needsYoutubeForPlan) {
+    const auth = await authenticate({
+      tokenFile: options.tokenFile,
+      clientSecretsFile: options.clientSecretsFile,
+      clientId: options.clientId,
+      clientSecret: options.clientSecret,
+    });
+    youtube = google.youtube({ version: 'v3', auth });
+  }
+
   // Build playlist plan
   let playlistPlan = null;
   if (playlistId) {
     let currentTitle = rawMetadata?.playlist?.youtube?.snippet?.title || rawMetadata?.playlist?.snippet?.title || '';
+    if (!currentTitle && youtube) {
+      try {
+        const { data } = await youtube.playlists.list({ part: ['snippet'], id: [playlistId] });
+        currentTitle = data.items?.[0]?.snippet?.title || '';
+      } catch {
+        // Non-fatal during planning
+      }
+    }
     let newTitle = currentTitle;
 
     if (options.syncMetadata) {
@@ -192,8 +262,7 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
     }
 
     if (options.replacePattern) {
-      const reg = new RegExp(options.replacePattern, 'g');
-      newTitle = newTitle.replace(reg, options.replaceWith || '');
+      newTitle = replaceText(newTitle);
     }
 
     if (currentTitle || newTitle || options.playlistPostfix) {
@@ -207,6 +276,7 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
   }
 
   // Build video plans
+  /** @type {Array<{ filename: string, videoId: string, oldTitle: string, newTitle: string, changed: boolean, snippetUpdates?: object }>} */
   const videoPlans = [];
   const songsObj = rawMetadata?.songs || {};
   const orderedKeys = Array.isArray(rawMetadata?.playlist?.orderedSongKeys)
@@ -233,6 +303,9 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
 
       let currentTitle = songData.youtube?.snippet?.title || path.basename(filename, path.extname(filename));
       let newTitle = currentTitle;
+      const snippet = songData.youtube?.snippet || {};
+      let newDescription = snippet.description || '';
+      let newTags = Array.isArray(snippet.tags) ? [...snippet.tags] : [];
 
       if (options.syncMetadata) {
         newTitle = currentTitle;
@@ -250,8 +323,20 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
       }
 
       if (options.replacePattern) {
-        const reg = new RegExp(options.replacePattern, 'g');
-        newTitle = newTitle.replace(reg, options.replaceWith || '');
+        newTitle = replaceText(newTitle);
+        if (replaceInSnippet) {
+          newDescription = replaceText(newDescription);
+          newTags = newTags.map((tag) => replaceText(tag));
+        }
+      }
+
+      const snippetUpdates = {};
+      if (newTitle !== currentTitle) snippetUpdates.title = newTitle;
+      if (replaceInSnippet && newDescription !== (snippet.description || '')) {
+        snippetUpdates.description = newDescription;
+      }
+      if (replaceInSnippet && JSON.stringify(newTags) !== JSON.stringify(snippet.tags || [])) {
+        snippetUpdates.tags = newTags;
       }
 
       videoPlans.push({
@@ -259,7 +344,8 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
         videoId,
         oldTitle: currentTitle,
         newTitle,
-        changed: (newTitle !== currentTitle),
+        changed: Object.keys(snippetUpdates).length > 0,
+        snippetUpdates: Object.keys(snippetUpdates).length > 0 ? snippetUpdates : undefined,
       });
     }
 
@@ -278,8 +364,7 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
           }
         }
         if (options.replacePattern) {
-          const reg = new RegExp(options.replacePattern, 'g');
-          newTitle = newTitle.replace(reg, options.replaceWith || '');
+          newTitle = replaceText(newTitle);
         }
         videoPlans.push({
           filename: upload.filename,
@@ -287,6 +372,41 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
           oldTitle: currentTitle,
           newTitle,
           changed: (newTitle !== currentTitle),
+          snippetUpdates: newTitle !== currentTitle ? { title: newTitle } : undefined,
+        });
+      }
+    }
+  }
+
+  if (includePlaylistId && youtube && options.replacePattern) {
+    const items = await listPlaylistItems(youtube, includePlaylistId);
+    const plannedIds = new Set(videoPlans.map((plan) => plan.videoId));
+    const missingIds = items.map((item) => item.videoId).filter((videoId) => videoId && !plannedIds.has(videoId));
+    for (let i = 0; i < missingIds.length; i += 50) {
+      const chunk = missingIds.slice(i, i + 50);
+      const { data } = await youtube.videos.list({ part: ['snippet'], id: chunk });
+      for (const item of data.items || []) {
+        const currentTitle = item.snippet?.title || '';
+        const newTitle = replaceText(currentTitle);
+        const snippetUpdates = {};
+        if (newTitle !== currentTitle) snippetUpdates.title = newTitle;
+        if (replaceInSnippet) {
+          const newDescription = replaceText(item.snippet?.description || '');
+          const newTags = (item.snippet?.tags || []).map((tag) => replaceText(tag));
+          if (newDescription !== (item.snippet?.description || '')) {
+            snippetUpdates.description = newDescription;
+          }
+          if (JSON.stringify(newTags) !== JSON.stringify(item.snippet?.tags || [])) {
+            snippetUpdates.tags = newTags;
+          }
+        }
+        videoPlans.push({
+          filename: item.id,
+          videoId: item.id,
+          oldTitle: currentTitle,
+          newTitle,
+          changed: Object.keys(snippetUpdates).length > 0,
+          snippetUpdates: Object.keys(snippetUpdates).length > 0 ? snippetUpdates : undefined,
         });
       }
     }
@@ -325,14 +445,15 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
   }
 
   // Authenticate
-  const auth = await authenticate({
-    tokenFile: options.tokenFile,
-    clientSecretsFile: options.clientSecretsFile,
-    clientId: options.clientId,
-    clientSecret: options.clientSecret,
-  });
-
-  const youtube = google.youtube({ version: 'v3', auth });
+  if (!youtube) {
+    const auth = await authenticate({
+      tokenFile: options.tokenFile,
+      clientSecretsFile: options.clientSecretsFile,
+      clientId: options.clientId,
+      clientSecret: options.clientSecret,
+    });
+    youtube = google.youtube({ version: 'v3', auth });
+  }
 
   // Update Playlist
   if (playlistPlan && playlistPlan.changed) {
@@ -351,7 +472,11 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
     const v = changedVideos[i];
     onEvent({ type: 'video_update_start', item: v, index: i, total: changedVideos.length });
     try {
-      await updateVideoTitle(youtube, v.videoId, v.newTitle);
+      if (v.snippetUpdates && Object.keys(v.snippetUpdates).length > 0) {
+        await updateVideoSnippet(youtube, v.videoId, v.snippetUpdates);
+      } else {
+        await updateVideoTitle(youtube, v.videoId, v.newTitle);
+      }
       onEvent({ type: 'video_update_success', item: v, index: i, total: changedVideos.length });
     } catch (err) {
       onEvent({ type: 'video_update_error', item: v, error: err });
@@ -362,17 +487,32 @@ export async function batchUpdateMetadata(targetFolder, options = {}) {
   // Update metadata.json on disk if present and requested
   if (updateLocal && rawMetadata && fs.existsSync(metadataPath)) {
     try {
-      if (playlistPlan && playlistPlan.changed) {
-        if (rawMetadata.playlist?.youtube?.snippet) {
-          rawMetadata.playlist.youtube.snippet.title = playlistPlan.newTitle;
-        } else if (rawMetadata.playlist?.snippet) {
-          rawMetadata.playlist.snippet.title = playlistPlan.newTitle;
+      if (options.replacePattern) {
+        rawMetadata = deepReplaceInObject(
+          rawMetadata,
+          options.replacePattern,
+          options.replaceWith || '',
+          replaceLiteral
+        );
+      } else {
+        if (playlistPlan && playlistPlan.changed) {
+          if (rawMetadata.playlist?.youtube?.snippet) {
+            rawMetadata.playlist.youtube.snippet.title = playlistPlan.newTitle;
+          } else if (rawMetadata.playlist?.snippet) {
+            rawMetadata.playlist.snippet.title = playlistPlan.newTitle;
+          }
         }
-      }
 
-      for (const v of videoPlans) {
-        if (v.changed && rawMetadata.songs?.[v.filename]?.youtube?.snippet) {
-          rawMetadata.songs[v.filename].youtube.snippet.title = v.newTitle;
+        for (const v of videoPlans) {
+          if (v.changed && rawMetadata.songs?.[v.filename]?.youtube?.snippet) {
+            rawMetadata.songs[v.filename].youtube.snippet.title = v.newTitle;
+            if (v.snippetUpdates?.description) {
+              rawMetadata.songs[v.filename].youtube.snippet.description = v.snippetUpdates.description;
+            }
+            if (v.snippetUpdates?.tags) {
+              rawMetadata.songs[v.filename].youtube.snippet.tags = v.snippetUpdates.tags;
+            }
+          }
         }
       }