storyblok 4.20.0 → 4.21.0

package/dist/index.mjs

@@ -714,6 +714,7 @@ const API_ACTIONS = {
   update_story: "Failed to update story",
   pull_asset: "Failed to pull asset",
   pull_assets: "Failed to pull assets",
+  transfer_enumerate_assets: "Failed to enumerate assets for transfer",
   pull_asset_folder: "Failed to pull asset folder",
   pull_asset_folders: "Failed to pull asset folders",
   push_asset_folder: "Failed to push asset folder",
@@ -7476,6 +7477,27 @@ const fetchAssets = async ({ spaceId, params }) => {
     handleAPIError("pull_assets", toError(maybeError));
   }
 };
+const fetchAllSpaceAssetIds = async (spaceId, params) => {
+  try {
+    const client = getMapiClient();
+    const assets = await fetchAllPages(
+      (page) => client.assets.list({
+        path: { space_id: Number(spaceId) },
+        query: { ...params, page, per_page: 100 },
+        throwOnError: true
+      }),
+      (data) => data?.assets ?? []
+    );
+    return assets.reduce((ids, asset) => {
+      if (typeof asset?.id === "number") {
+        ids.push(asset.id);
+      }
+      return ids;
+    }, []);
+  } catch (maybeError) {
+    handleAPIError("transfer_enumerate_assets", toError(maybeError));
+  }
+};
 const fetchAssetInternalTagsByName = async (spaceId) => {
   try {
     const client = getMapiClient();
@@ -7651,22 +7673,32 @@ const transferAsset = async (spaceId, assetId, folderId) => {
     );
   }
 };
+const TRANSFER_CHUNK_SIZE = 500;
 const transferAssets = async (spaceId, assetIds, folderId, callbacks = {}) => {
   const lock = createPipelineBackpressureLock();
-  return Promise.all(assetIds.map(async (assetId) => {
-    await lock.acquire();
-    try {
-      const asset = await transferAsset(spaceId, assetId, folderId);
-      callbacks.onSuccess?.({ assetId, filename: asset.filename });
-      return { assetId, status: "transferred", filename: asset.filename };
-    } catch (maybeError) {
-      const error = toError(maybeError);
-      callbacks.onError?.(error, assetId);
-      return { assetId, status: "failed", reason: error.message };
-    } finally {
-      lock.release();
-    }
-  }));
+  const results = [];
+  let completed = 0;
+  for (let start = 0; start < assetIds.length; start += TRANSFER_CHUNK_SIZE) {
+    const chunk = assetIds.slice(start, start + TRANSFER_CHUNK_SIZE);
+    const chunkResults = await Promise.all(chunk.map(async (assetId) => {
+      await lock.acquire();
+      try {
+        const asset = await transferAsset(spaceId, assetId, folderId);
+        callbacks.onSuccess?.({ assetId, filename: asset.filename });
+        return { assetId, status: "transferred", filename: asset.filename };
+      } catch (maybeError) {
+        const error = toError(maybeError);
+        callbacks.onError?.(error, assetId);
+        return { assetId, status: "failed", reason: error.message };
+      } finally {
+        lock.release();
+        completed += 1;
+        callbacks.onProgress?.(completed, assetIds.length);
+      }
+    }));
+    results.push(...chunkResults);
+  }
+  return results;
 };
 const fetchSharedAssets = async ({ spaceId, libraryId, params }) => {
   try {
@@ -10174,7 +10206,7 @@ pushCmd$1.action(async (assetInput, options, command) => {
   }
 });
 
-const transferCmd = assetsCommand.command("transfer <asset-id...>").option("-s, --space <space>", "space ID").option("--folder-id <folderId>", "destination asset folder ID in the shared library").option("-d, --dry-run", "Preview changes without applying them to Storyblok").description(`Transfer space assets into the organization's shared asset library.`);
+const transferCmd = assetsCommand.command("transfer [asset-id...]").option("-s, --space <space>", "space ID").option("--folder-id <folderId>", "destination asset folder ID in the shared library").option("--all", "Transfer every asset in the space to the shared library").option("-q, --query <query>", 'Transfer every asset in the space matching a Storyblok filter query. Example: --query="search=my-file.jpg&with_tags=tag1,tag2"').option("-d, --dry-run", "Preview changes without applying them to Storyblok").description(`Transfer space assets into the organization's shared asset library.`);
 transferCmd.action(async (assetIds, options, command) => {
   const ui = getUI();
   const logger = getLogger();
@@ -10203,12 +10235,43 @@ transferCmd.action(async (assetIds, options, command) => {
     process.exitCode = 2;
     return;
   }
-  const ids = assetIds.map((id) => Number(id)).filter((id) => !Number.isNaN(id));
-  if (ids.length === 0) {
-    handleError(new CommandError(`Please provide at least one valid asset ID.`), verbose);
+  if (options.all && options.query) {
+    handleError(new CommandError(`Cannot combine --all with --query. Use --all to transfer every asset, or --query to transfer a filtered subset.`), verbose);
+    process.exitCode = 2;
+    return;
+  }
+  const bulk = Boolean(options.all || options.query);
+  if (bulk && assetIds.length > 0) {
+    handleError(new CommandError(`Cannot combine explicit asset IDs with --all or --query.`), verbose);
     process.exitCode = 2;
     return;
   }
+  let ids;
+  if (bulk) {
+    const params = options.query ? Object.fromEntries(new URLSearchParams(options.query)) : void 0;
+    logger.info("Enumerating space assets", { space, query: options.query });
+    try {
+      ids = await fetchAllSpaceAssetIds(space, params);
+    } catch (maybeError) {
+      handleError(toError(maybeError), verbose);
+      process.exitCode = 2;
+      return;
+    }
+    logger.info("Enumerated space assets", { count: ids.length });
+    if (ids.length === 0) {
+      ui.info(options.query ? `No assets in space ${space} match the query. Nothing to transfer.` : `No assets found in space ${space}. Nothing to transfer.`);
+      logger.info("Transferring assets finished (no assets found)");
+      process.exitCode = 0;
+      return;
+    }
+  } else {
+    ids = assetIds.map((id) => Number(id)).filter((id) => !Number.isNaN(id));
+    if (ids.length === 0) {
+      handleError(new CommandError(`Please provide at least one valid asset ID, or use --all.`), verbose);
+      process.exitCode = 2;
+      return;
+    }
+  }
   if (options.dryRun) {
     const summary2 = { total: ids.length, succeeded: 0, failed: 0 };
     ui.info(`Transfer plan: ${ids.length} asset(s) to folder ${folderId}`);
@@ -10219,14 +10282,33 @@ transferCmd.action(async (assetIds, options, command) => {
     process.exitCode = 0;
     return;
   }
+  const progress = ui.createProgressBar({ title: "Transferring assets..." });
+  progress.setTotal(ids.length);
   const results = await transferAssets(space, ids, folderId, {
     onSuccess: ({ assetId, filename }) => logger.info("Transferred asset", { assetId, filename }),
-    onError: (error, assetId) => logOnlyError(error, { assetId })
+    onError: (error, assetId) => logOnlyError(error, { assetId }),
+    onProgress: () => progress.increment()
   });
+  ui.stopAllProgressBars();
   const succeeded = results.filter((result) => result.status === "transferred").length;
   const summary = { total: results.length, succeeded, failed: results.length - succeeded };
-  ui.info(`Transfer results: ${summary.total} processed, ${summary.failed} failed`);
-  ui.list(results.map((result) => result.status === "transferred" ? `${result.assetId}  \u2713 transferred -> ${result.filename}` : `${result.assetId}  \u2717 failed: ${result.reason}`));
+  ui.info(`Transfer results: ${summary.succeeded} transferred, ${summary.failed} failed (of ${summary.total}).`);
+  if (summary.failed > 0) {
+    const countsByReason = /* @__PURE__ */ new Map();
+    for (const result of results) {
+      if (result.status === "failed") {
+        const reason = result.reason ?? "Unknown error";
+        countsByReason.set(reason, (countsByReason.get(reason) ?? 0) + 1);
+      }
+    }
+    const byReason = [...countsByReason.entries()].sort((a, b) => b[1] - a[1]);
+    const MAX_REASONS = 10;
+    const lines = byReason.slice(0, MAX_REASONS).map(([reason, count]) => `\u2717 ${reason} (${count})`);
+    if (byReason.length > MAX_REASONS) {
+      lines.push(`\u2026 and ${byReason.length - MAX_REASONS} more failure reason(s)`);
+    }
+    ui.list(lines);
+  }
   reporter.addSummary("transferResults", summary);
   reporter.finalize();
   logger.info("Transferring assets finished", { summary });