vslides 1.0.26 → 1.0.28

package/dist/cli.js

@@ -3467,6 +3467,24 @@ async function getLibraryImportBundle(id) {
 async function getLibraryTags() {
   return request("/api/library/tags", { skipAuthCheck: true });
 }
+async function supersedeLibraryItem(token, oldId, newId) {
+  return request(`/api/library/${oldId}/supersede`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-CLI-Auth-Token": token
+    },
+    body: JSON.stringify({ supersededBy: newId })
+  });
+}
+async function removeSupersession(token, id) {
+  return request(`/api/library/${id}/supersede`, {
+    method: "DELETE",
+    headers: {
+      "X-CLI-Auth-Token": token
+    }
+  });
+}
 
 // src/lib/config.ts
 var import_node_fs2 = require("node:fs");
@@ -5069,7 +5087,7 @@ function writeLibraryConfig(config) {
   const configPath = (0, import_node_path7.join)(process.cwd(), LIBRARY_CONFIG_FILE);
   (0, import_node_fs8.writeFileSync)(configPath, JSON.stringify(config, null, 2) + "\n");
 }
-async function libraryImport(id) {
+async function libraryImport(id, options = {}) {
   info(`Fetching library item: ${id}`);
   const result = await getLibraryImportBundle(id);
   if (!result.ok) {
@@ -5080,7 +5098,23 @@ async function libraryImport(id) {
     }
     process.exit(ExitCode.NetworkError);
   }
-  const bundle = result.data;
+  let bundle = result.data;
+  if (bundle.supersededBy && bundle.latestId && options.followSupersede !== false) {
+    warning(`This item has been superseded by "${bundle.supersededBy.name}"`);
+    info(`  Importing latest: ${bundle.latestId}`);
+    newline();
+    const latestResult = await getLibraryImportBundle(bundle.latestId);
+    if (!latestResult.ok) {
+      error("Failed to fetch latest item");
+      process.exit(ExitCode.NetworkError);
+    }
+    bundle = latestResult.data;
+    id = bundle.id;
+  } else if (bundle.supersededBy && options.followSupersede === false) {
+    warning(`This item has been superseded by "${bundle.supersededBy.name}"`);
+    info("  Importing original as requested (--no-follow-supersede)");
+    newline();
+  }
   const libraryDir = (0, import_node_path7.join)(process.cwd(), "library");
   if (!(0, import_node_fs8.existsSync)(libraryDir)) {
     (0, import_node_fs8.mkdirSync)(libraryDir, { recursive: true });
@@ -5102,7 +5136,7 @@ async function libraryImport(id) {
   newline();
   info("Import complete!");
   newline();
-  info("Add to your slides.md:");
+  info("Add to your slides.md (after your title slide):");
   info(`  ---`);
   info(`  src: ./library/${filename}`);
   info(`  ---`);
@@ -5138,6 +5172,14 @@ async function libraryStatus() {
       continue;
     }
     const item = result.data;
+    if (item.supersededByItem) {
+      info(`${item.name} (${id})`);
+      info(`  [SUPERSEDED] Replaced by "${item.supersededByItem.name}" (${item.supersededByItem.id})`);
+      info(`  Local: ${info2.localPath}`);
+      info(`  Run: vslides library upgrade ${id}`);
+      newline();
+      continue;
+    }
     const isUpToDate = item.version === info2.version;
     const status2 = isUpToDate ? `v${info2.version} (current)` : `v${info2.version} -> v${item.version} available`;
     info(`${item.name} (${id})`);
@@ -5176,6 +5218,7 @@ async function libraryUpgrade(id, options) {
   }
   let upgraded = 0;
   let skipped = 0;
+  let superseded = 0;
   for (const itemId of idsToUpgrade) {
     const info2 = config.imports[itemId];
     const itemResult = await getLibraryItem(itemId);
@@ -5184,6 +5227,50 @@ async function libraryUpgrade(id, options) {
       continue;
     }
     const item = itemResult.data;
+    if (item.supersededByItem && options.followSupersede !== false) {
+      const latestResult = await getLibraryImportBundle(item.supersededByItem.id);
+      if (!latestResult.ok) {
+        error(`Failed to fetch superseding item ${item.supersededByItem.id}`);
+        continue;
+      }
+      const latestBundle = latestResult.data;
+      const latestId = latestBundle.latestId || item.supersededByItem.id;
+      let finalBundle = latestBundle;
+      if (latestBundle.latestId && latestBundle.latestId !== item.supersededByItem.id) {
+        const finalResult = await getLibraryImportBundle(latestBundle.latestId);
+        if (finalResult.ok) {
+          finalBundle = finalResult.data;
+        } else {
+          warning(`Could not fetch final chain item ${latestBundle.latestId}, using ${item.supersededByItem.id}`);
+        }
+      }
+      info(`${item.name} (${itemId})`);
+      info(`  [SUPERSEDED] Replaced by "${finalBundle.name}" (${latestId})`);
+      info(`  Upgrading: ${itemId} -> ${latestId}`);
+      const newSlug = finalBundle.name.toLowerCase().replace(/\s+/g, "-");
+      const newLocalPath = `library/${newSlug}.md`;
+      const dir = (0, import_node_path9.dirname)((0, import_node_path9.join)(process.cwd(), newLocalPath));
+      if (!(0, import_node_fs10.existsSync)(dir)) {
+        (0, import_node_fs10.mkdirSync)(dir, { recursive: true });
+      }
+      (0, import_node_fs10.writeFileSync)((0, import_node_path9.join)(process.cwd(), newLocalPath), finalBundle.markdown);
+      delete config.imports[itemId];
+      config.imports[latestId] = {
+        version: finalBundle.version,
+        importedAt: Date.now(),
+        localPath: newLocalPath
+      };
+      success(`Upgraded to "${finalBundle.name}" v${finalBundle.version}`);
+      info(`  New local path: ${newLocalPath}`);
+      info(`  Update your slides.md: src: ./${newLocalPath}`);
+      superseded++;
+      continue;
+    }
+    if (item.supersededByItem && options.followSupersede === false) {
+      info(`${item.name}: superseded by "${item.supersededByItem.name}" (use default to follow)`);
+      skipped++;
+      continue;
+    }
     if (item.version === info2.version) {
       info(`${item.name}: already up to date (v${item.version})`);
       skipped++;
@@ -5204,7 +5291,11 @@ async function libraryUpgrade(id, options) {
   }
   (0, import_node_fs10.writeFileSync)(configPath, JSON.stringify(config, null, 2) + "\n");
   newline();
-  info(`Upgraded: ${upgraded}, Skipped: ${skipped}`);
+  if (superseded > 0) {
+    info(`Upgraded: ${upgraded}, Superseded: ${superseded}, Skipped: ${skipped}`);
+  } else {
+    info(`Upgraded: ${upgraded}, Skipped: ${skipped}`);
+  }
 }
 
 // src/commands/library-tags.ts
@@ -5246,7 +5337,12 @@ async function libraryInfo(id) {
 ${item.name}
 `);
   info(`ID: ${item.id}`);
-  info(`Status: ${item.status}`);
+  if (item.supersededByItem) {
+    info(`Status: ${item.status} (superseded)`);
+    warning(`Superseded by: ${item.supersededByItem.name} (${item.supersededByItem.id})`);
+  } else {
+    info(`Status: ${item.status}`);
+  }
   info(`Version: ${item.version}`);
   info(`Department: ${item.department.name}`);
   info(`Audiences: ${item.audiences.map((a) => a.name).join(", ")}`);
@@ -5259,14 +5355,94 @@ ${item.name}
   if (item.lastVerified) {
     info(`Last Verified: ${new Date(item.lastVerified).toLocaleDateString()}`);
   }
+  if (item.supersedesItems && item.supersedesItems.length > 0) {
+    newline();
+    info(`Supersedes:`);
+    for (const superseded of item.supersedesItems) {
+      info(`  - ${superseded.name} (${superseded.id})`);
+    }
+  }
   if (item.description) {
     newline();
     info(`Description:
 ${item.description}`);
   }
   newline();
-  info(`Import: vslides library import ${item.id}`);
+  if (item.supersededByItem) {
+    info(`Import latest: vslides library import ${item.supersededByItem.id}`);
+    info(`Import this:   vslides library import ${item.id} --no-follow-supersede`);
+  } else {
+    info(`Import: vslides library import ${item.id}`);
+  }
+  newline();
+}
+
+// src/commands/library-supersede.ts
+async function librarySupersede(id, options) {
+  const auth = getCachedAuth();
+  if (!auth) {
+    error("Not logged in");
+    instructions(["Run `vslides login` to authenticate"]);
+    process.exit(ExitCode.AuthRequired);
+  }
+  if (!isAuthValid(auth)) {
+    error("Login expired");
+    instructions(["Run `vslides login` to re-authenticate"]);
+    process.exit(ExitCode.AuthRequired);
+  }
+  if (options.remove) {
+    const result2 = await removeSupersession(auth.token, id);
+    if (!result2.ok) {
+      const errorData = result2.data;
+      error(errorData.message || "Failed to remove supersession");
+      if (result2.status === 401 || result2.status === 403) {
+        process.exit(ExitCode.AuthRequired);
+      } else if (result2.status === 400 || result2.status === 404) {
+        process.exit(ExitCode.ValidationError);
+      } else {
+        process.exit(ExitCode.NetworkError);
+      }
+    }
+    const data2 = result2.data;
+    success(data2.message);
+    return;
+  }
+  if (!options.by) {
+    error("Missing required option: --by <new-id>");
+    instructions([
+      "Usage: vslides library supersede <old-id> --by <new-id>",
+      "       vslides library supersede <id> --remove"
+    ]);
+    process.exit(ExitCode.UsageError);
+  }
+  const oldItemResult = await getLibraryItem(id);
+  if (!oldItemResult.ok) {
+    error(`Item not found: ${id}`);
+    process.exit(ExitCode.ValidationError);
+  }
+  const newItemResult = await getLibraryItem(options.by);
+  if (!newItemResult.ok) {
+    error(`Superseding item not found: ${options.by}`);
+    process.exit(ExitCode.ValidationError);
+  }
+  info(`Superseding "${oldItemResult.data.name}" with "${newItemResult.data.name}"...`);
+  const result = await supersedeLibraryItem(auth.token, id, options.by);
+  if (!result.ok) {
+    const errorData = result.data;
+    error(errorData.message || "Failed to supersede item");
+    if (result.status === 401 || result.status === 403) {
+      process.exit(ExitCode.AuthRequired);
+    } else if (result.status === 400 || result.status === 404) {
+      process.exit(ExitCode.ValidationError);
+    } else {
+      process.exit(ExitCode.NetworkError);
+    }
+  }
+  const data = result.data;
+  success(data.message);
   newline();
+  info(`"${oldItemResult.data.name}" is now superseded by "${data.supersededBy.name}"`);
+  info("Users with existing imports will be prompted to upgrade.");
 }
 
 // src/cli.ts
@@ -5319,9 +5495,10 @@ var library = program.command("library").description("Manage slide library");
 library.command("list").description("List library items").option("-d, --department <name>", "Filter by department").option("-a, --audience <name>", "Filter by audience").option("-p, --product <name>", "Filter by product").option("--all", "Include drafts and deprecated").option("-l, --limit <number>", "Number of results", "20").action(wrapCommand((options) => libraryList(options)));
 library.command("search <query>").description("Search library items").option("-l, --limit <number>", "Number of results", "20").action(wrapCommand((query, options) => librarySearch(query, options)));
 library.command("publish").description("Publish current presentation to library").option("-n, --name <name>", "Library item name").option("-d, --description <desc>", "Description").option("--department <name>", "Department").option("--audience <name...>", "Audiences").option("--product <name...>", "Products").option("--update <id>", "Update existing library item").option("--draft", "Create as draft (do not publish)").action(wrapCommand((options) => libraryPublish(options)));
-library.command("import <id>").description("Import library item into current project").action(wrapCommand((id) => libraryImport(id)));
+library.command("import <id>").description("Import library item into current project").option("--no-follow-supersede", "Do not follow supersession chain").action(wrapCommand((id, options) => libraryImport(id, options)));
 library.command("status").description("Check status of imported library items").action(wrapCommand(libraryStatus));
-library.command("upgrade [id]").description("Upgrade imported library items").option("--all", "Upgrade all imports").action(wrapCommand((id, options) => libraryUpgrade(id, options)));
+library.command("upgrade [id]").description("Upgrade imported library items").option("--all", "Upgrade all imports").option("--no-follow-supersede", "Do not follow supersession chain").action(wrapCommand((id, options) => libraryUpgrade(id, options)));
 library.command("tags").description("List available taxonomy values").action(wrapCommand(libraryTags));
 library.command("info <id>").description("Show details of a library item").action(wrapCommand((id) => libraryInfo(id)));
+library.command("supersede <id>").description("Mark a library item as superseded by another").option("--by <new-id>", "ID of the item that supersedes this one").option("--remove", "Remove the supersession").action(wrapCommand((id, options) => librarySupersede(id, options)));
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vslides",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "CLI for Vercel Slides API",
   "license": "MIT",
   "author": "Vercel",