storyblok 4.5.0 → 4.6.0

package/dist/index.mjs

@@ -8,6 +8,7 @@ import { readPackageUp } from 'read-package-up';
 import { Spinner } from '@topcli/spinner';
 import { select, password, input, confirm } from '@inquirer/prompts';
 import { ManagementApiClient } from '@storyblok/management-api-client';
+import { RateLimit, Sema } from 'async-sema';
 import fs, { mkdir, writeFile, readFile as readFile$1, access, readdir } from 'node:fs/promises';
 import path, { join, parse, resolve } from 'node:path';
 import filenamify from 'filenamify';
@@ -15,7 +16,9 @@ import { exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import { getRegion } from '@storyblok/region-helper';
 import { minimatch } from 'minimatch';
+import { Readable, pipeline, Transform, Writable } from 'node:stream';
 import { hash } from 'ohash';
+import { MultiBar, Presets } from 'cli-progress';
 import { compile } from 'json-schema-to-typescript';
 import { readFileSync } from 'node:fs';
 import open from 'open';
@@ -409,12 +412,13 @@ function requireAuthentication(state, verbose = false) {
   return true;
 }
 
-const toPascalCase = (str) => {
-  return str.replace(/(?:^|_)(\w)/g, (_, char) => char.toUpperCase());
-};
 const toCamelCase = (str) => {
   return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase()).replace(/_/g, "").replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()).replace(/[^a-z0-9]([a-z])/gi, (_, letter) => letter.toUpperCase()).replace(/[^a-z0-9]/gi, "");
 };
+const toPascalCase = (str) => {
+  const camelCase = toCamelCase(str);
+  return camelCase ? camelCase[0].toUpperCase() + camelCase.slice(1) : camelCase;
+};
 const capitalize = (str) => {
   return str.charAt(0).toUpperCase() + str.slice(1);
 };
@@ -533,17 +537,28 @@ const getStoryblokUrl = (region = "eu") => {
 
 let instance = null;
 let storedConfig = null;
+const lim = RateLimit(6, {
+  uniformDistribution: true
+});
 function configsAreEqual(config1, config2) {
   return JSON.stringify(config1) === JSON.stringify(config2);
 }
 function mapiClient(options) {
   if (!instance && options) {
     instance = new ManagementApiClient(options);
+    instance.interceptors.request.use(async (request) => {
+      await lim();
+      return request;
+    });
     storedConfig = options;
   } else if (!instance) {
     throw new Error("MAPI client not initialized. Call mapiClient with configuration first.");
   } else if (options && storedConfig && !configsAreEqual(options, storedConfig)) {
     instance = new ManagementApiClient(options);
+    instance.interceptors.request.use(async (request) => {
+      await lim();
+      return request;
+    });
     storedConfig = options;
   }
   return instance;
@@ -2854,63 +2869,6 @@ const fetchStories = async (spaceId, params) => {
     handleAPIError("pull_stories", error);
   }
 };
-const fetchAllStories = async (spaceId, params) => {
-  try {
-    const allStories = [];
-    let currentPage = 1;
-    let hasMorePages = true;
-    const perPage = 100;
-    while (hasMorePages) {
-      const result = await fetchStories(spaceId, {
-        ...params,
-        per_page: perPage,
-        page: currentPage
-      });
-      if (!result) {
-        break;
-      }
-      const { stories, headers } = result;
-      if (stories && stories.length > 0) {
-        allStories.push(...stories);
-        const total = headers.get("Total");
-        const perPageHeader = headers.get("Per-Page");
-        if (total && perPageHeader) {
-          const totalCount = Number(total);
-          const perPageCount = Number(perPageHeader);
-          const totalPages = Math.ceil(totalCount / perPageCount);
-          hasMorePages = currentPage < totalPages;
-        } else {
-          hasMorePages = stories.length === perPage;
-        }
-      } else {
-        hasMorePages = false;
-      }
-      currentPage++;
-    }
-    return allStories;
-  } catch (error) {
-    handleAPIError("pull_stories", error);
-  }
-};
-async function fetchAllStoriesByComponent(spaceOptions, filterOptions) {
-  const { spaceId } = spaceOptions;
-  const { componentName = "", query, starts_with } = filterOptions || {};
-  const params = {
-    ...starts_with && { starts_with }
-  };
-  if (componentName) {
-    params.contain_component = componentName;
-  }
-  if (query) {
-    params.filter_query = query.startsWith("filter_query") ? query : `filter_query${query}`;
-  }
-  try {
-    const stories = await fetchAllStories(spaceId, params);
-    return stories ?? [];
-  } catch (error) {
-    handleAPIError("pull_stories", error);
-  }
-}
 const fetchStory = async (spaceId, storyId) => {
   try {
     const client = mapiClient();
@@ -2947,6 +2905,98 @@ const updateStory = async (spaceId, storyId, payload) => {
   }
 };
 
+async function* storiesIterator(spaceId, params, onTotal) {
+  try {
+    let perPage = 500;
+    const transformedParams = {
+      ...params
+    };
+    if (params?.componentName && typeof params.componentName === "string") {
+      transformedParams.contain_component = params.componentName;
+      delete transformedParams.componentName;
+    }
+    if (params?.query && typeof params.query === "string") {
+      transformedParams.filter_query = params.query.startsWith("filter_query") ? params.query : `filter_query${params.query}`;
+      delete transformedParams.query;
+    }
+    const result = await fetchStories(spaceId, {
+      ...transformedParams,
+      per_page: perPage,
+      page: 1
+    });
+    if (!result) {
+      return;
+    }
+    const { headers } = result;
+    const total = Number(headers.get("Total"));
+    perPage = Number(headers.get("Per-Page"));
+    const totalPages = Math.ceil(Number(total) / perPage);
+    if (onTotal) {
+      onTotal(total);
+    }
+    for (let page = 1; page <= totalPages; page++) {
+      const result2 = await fetchStories(spaceId, {
+        ...transformedParams,
+        per_page: perPage,
+        page
+      });
+      if (!result2) {
+        return;
+      }
+      const { stories } = result2;
+      for (const story of stories) {
+        yield story;
+      }
+    }
+  } catch (error) {
+    handleAPIError("pull_stories", error);
+  }
+}
+class StoriesStream extends Transform {
+  constructor(spaceId, batchSize, onProgress) {
+    super({
+      objectMode: true
+    });
+    this.spaceId = spaceId;
+    this.batchSize = batchSize;
+    this.onProgress = onProgress;
+    this.semaphore = new Sema(this.batchSize, {
+      capacity: this.batchSize
+    });
+  }
+  semaphore;
+  async _transform(chunk, _encoding, callback) {
+    await this.semaphore.acquire();
+    fetchStory(this.spaceId, chunk.id.toString()).then((story) => {
+      this.push(story);
+      this.onProgress?.();
+    }).finally(() => {
+      this.semaphore.release();
+    });
+    callback();
+  }
+  _flush(callback) {
+    this.semaphore.drain().then(() => {
+      callback();
+    });
+  }
+}
+const createStoriesStream = async ({
+  spaceId,
+  params,
+  batchSize = 100,
+  onTotal,
+  onProgress
+}) => {
+  const iterator = storiesIterator(spaceId, params, onTotal);
+  const listStoriesStream = Readable.from(iterator);
+  return pipeline(listStoriesStream, new StoriesStream(spaceId, batchSize, onProgress), (err) => {
+    if (err) {
+      console.error(err);
+    }
+  });
+};
+
 async function readJavascriptFile(filePath) {
   try {
     const content = await readFile$1(filePath, "utf-8");
@@ -3098,149 +3148,283 @@ async function readRollbackFile({
   }
 }
 
-async function handleMigrations({
-  migrationFiles,
-  stories,
-  space,
-  path,
-  componentName
-}) {
-  const results = {
-    successful: [],
-    failed: [],
-    skipped: []
-  };
-  const relevantMigrations = componentName ? migrationFiles.filter((file) => {
-    const targetComponent = getComponentNameFromFilename(file.name);
-    return targetComponent.split(".")[0] === componentName;
-  }) : migrationFiles;
-  for (const migrationFile of relevantMigrations) {
-    const validStories = stories.filter((story) => story.content);
-    if (validStories.length === 0) {
-      continue;
-    }
-    await saveRollbackData({
-      space,
-      path,
-      stories: validStories,
-      migrationFile: migrationFile.name
+class MigrationStream extends Transform {
+  constructor(options) {
+    super({
+      objectMode: true
     });
-    const migrationFunction = await getMigrationFunction(migrationFile.name, space, path);
-    if (!migrationFunction) {
-      stories.forEach((story) => {
-        results.failed.push({
+    this.options = options;
+    this.results = {
+      successful: [],
+      failed: [],
+      skipped: [],
+      totalProcessed: 0
+    };
+  }
+  results;
+  migrationFunctions = /* @__PURE__ */ new Map();
+  totalProcessed = 0;
+  _transform(chunk, _encoding, callback) {
+    try {
+      this.processStory(chunk).then((results) => {
+        this.results.totalProcessed++;
+        this.options.onProgress?.(this.results.totalProcessed);
+        if (results.length > 0) {
+          this.totalProcessed += results.length;
+          this.options.onTotal?.(this.totalProcessed);
+          for (const result of results) {
+            this.push(result);
+          }
+        }
+      });
+      callback();
+    } catch (error) {
+      callback(error);
+    }
+  }
+  async processStory(story) {
+    if (!story.content) {
+      for (const migrationFile of this.options.migrationFiles) {
+        this.results.failed.push({
           storyId: story.id,
           migrationName: migrationFile.name,
-          error: new Error(`Failed to load migration function from file "${migrationFile.name}"`)
+          error: new Error("Story content is missing")
         });
-      });
-      continue;
+      }
+      return [];
+    }
+    const relevantMigrations = this.options.componentName ? this.options.migrationFiles.filter((file) => {
+      const targetComponent = getComponentNameFromFilename(file.name);
+      return targetComponent.split(".")[0] === this.options.componentName;
+    }) : this.options.migrationFiles;
+    const successfulResults = [];
+    for (const migrationFile of relevantMigrations) {
+      const result = await this.applyMigrationToStory(story, migrationFile);
+      if (result) {
+        successfulResults.push(result);
+      }
     }
-    const targetComponent = componentName || getComponentNameFromFilename(migrationFile.name);
-    for (const story of stories) {
-      if (!story.content) {
-        results.failed.push({
+    return successfulResults;
+  }
+  async applyMigrationToStory(story, migrationFile) {
+    try {
+      let migrationFunction = this.migrationFunctions.get(migrationFile.name);
+      if (!migrationFunction) {
+        migrationFunction = await getMigrationFunction(
+          migrationFile.name,
+          this.options.space,
+          this.options.path
+        );
+        this.migrationFunctions.set(migrationFile.name, migrationFunction);
+      }
+      if (!migrationFunction) {
+        this.results.failed.push({
           storyId: story.id,
           migrationName: migrationFile.name,
-          error: new Error("Story content is missing")
+          error: new Error(`Failed to load migration function from file "${migrationFile.name}"`)
         });
-        continue;
+        return null;
       }
+      await saveRollbackData({
+        space: this.options.space,
+        path: this.options.path,
+        stories: [{ id: story.id, name: story.name || "", content: story.content }],
+        migrationFile: migrationFile.name
+      });
       const storyContent = structuredClone(story.content);
       const originalContentHash = hash(story.content);
-      try {
-        const modified = applyMigrationToAllBlocks(storyContent, migrationFunction, targetComponent);
-        const newContentHash = hash(storyContent);
-        const contentChanged = originalContentHash !== newContentHash;
-        if (modified && contentChanged) {
-          const spinner = new Spinner({ verbose: !isVitest });
-          spinner.start(`Applying migration ${chalk.hex(colorPalette.MIGRATIONS)(migrationFile.name)} to story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}...`);
-          spinner.succeed(`Migration ${chalk.hex(colorPalette.MIGRATIONS)(migrationFile.name)} applied to story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())} - Completed in ${spinner.elapsedTime.toFixed(2)}ms`);
-          results.successful.push({
-            storyId: story.id,
-            name: story.name,
-            migrationName: migrationFile.name,
-            content: storyContent
-          });
-        } else if (modified && !contentChanged) {
-          results.skipped.push({
-            storyId: story.id,
-            name: story.name,
-            migrationName: migrationFile.name,
-            reason: "No changes detected after migration"
-          });
-        } else {
-          const baseComponent = targetComponent.split(".")[0];
-          results.skipped.push({
-            storyId: story.id,
-            name: story.name,
-            migrationName: migrationFile.name,
-            reason: baseComponent === componentName ? "No matching components found" : "Different component target"
-          });
-        }
-      } catch (error) {
-        const spinner = new Spinner({ verbose: !isVitest });
-        spinner.start(`Applying migration ${chalk.hex(colorPalette.MIGRATIONS)(migrationFile.name)} to story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}...`);
-        spinner.failed(`Failed to apply migration ${chalk.hex(colorPalette.MIGRATIONS)(migrationFile.name)} to story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}`);
-        results.failed.push({
+      const targetComponent = this.options.componentName || getComponentNameFromFilename(migrationFile.name);
+      const modified = applyMigrationToAllBlocks(storyContent, migrationFunction, targetComponent);
+      const newContentHash = hash(storyContent);
+      const contentChanged = originalContentHash !== newContentHash;
+      if (modified && contentChanged) {
+        this.results.successful.push({
+          storyId: story.id,
+          name: story.name,
+          migrationName: migrationFile.name,
+          content: storyContent
+        });
+        return {
+          storyId: story.id,
+          name: story.name,
+          content: storyContent
+        };
+      } else if (modified && !contentChanged) {
+        this.results.skipped.push({
+          storyId: story.id,
+          name: story.name,
+          migrationName: migrationFile.name,
+          reason: "No changes detected after migration"
+        });
+        return null;
+      } else {
+        const baseComponent = targetComponent.split(".")[0];
+        this.results.skipped.push({
           storyId: story.id,
+          name: story.name,
           migrationName: migrationFile.name,
-          error
+          reason: baseComponent === this.options.componentName ? "No matching components found" : "Different component target"
         });
+        return null;
       }
+    } catch (error) {
+      this.results.failed.push({
+        storyId: story.id,
+        migrationName: migrationFile.name,
+        error
+      });
+      return null;
     }
   }
-  return results;
-}
-function summarizeMigrationResults(results) {
-  const { successful, failed, skipped } = results;
-  const successfulStoryIds = new Set(successful.map((result) => result.storyId));
-  const failedStoryIds = new Set(failed.map((result) => result.storyId));
-  const successfulMigrations = new Set(successful.map((result) => result.migrationName));
-  konsola.br();
-  konsola.ok(`Successfully applied ${successfulMigrations.size} migrations to ${successfulStoryIds.size} stories`, true);
-  const skippedByReason = skipped.reduce((acc, item) => {
-    if (!acc[item.reason]) {
-      acc[item.reason] = [];
-    }
-    acc[item.reason].push(item);
-    return acc;
-  }, {});
-  if (Object.keys(skippedByReason).length > 0) {
-    konsola.info(`Skipped migrations:`);
-    for (const [reason, items] of Object.entries(skippedByReason)) {
-      const uniqueStories = new Set(items.map((item) => item.storyId));
-      konsola.info(`  \u2022 ${reason}: ${uniqueStories.size} stories`);
-    }
-  }
-  if (failed.length > 0) {
-    konsola.warn(`- Failed to apply migrations to ${failedStoryIds.size} stories`, true);
-    const failuresByStory = /* @__PURE__ */ new Map();
-    failed.forEach(({ storyId, migrationName, error }) => {
-      if (!failuresByStory.has(storyId)) {
-        failuresByStory.set(storyId, []);
-      }
-      failuresByStory.get(storyId)?.push({ migrationName, error });
-    });
-    failuresByStory.forEach((failures, storyId) => {
-      konsola.error(`Story ID ${storyId}:`);
-      failures.forEach(({ migrationName, error }) => {
-        konsola.error(`- Migration ${migrationName}: ${error.message}`);
-      });
-    });
-  } else {
-    konsola.ok(`No failures reported`);
+  _flush(callback) {
+    callback();
+  }
+  /**
+   * Get the migration results
+   */
+  getResults() {
+    return this.results;
+  }
+  /**
+   * Get a summary of the migration results
+   */
+  getSummary() {
+    const { successful, failed, skipped } = this.results;
+    const successfulStoryIds = new Set(successful.map((result) => result.storyId));
+    let summary = `Migration Results: ${successfulStoryIds.size} stories updated, ${skipped.length} stories skipped`;
+    if (skipped.length > 0) {
+      const skippedByReason = skipped.reduce((acc, item) => {
+        if (!acc[item.reason]) {
+          acc[item.reason] = 0;
+        }
+        acc[item.reason]++;
+        return acc;
+      }, {});
+      const skippedReasons = Object.entries(skippedByReason).map(([reason, count]) => `${reason}: ${count}`).join(", ");
+      summary += ` (${skippedReasons})`;
+    }
+    if (failed.length > 0) {
+      const failedStoryIds = new Set(failed.map((result) => result.storyId));
+      summary += `, ${failedStoryIds.size} stories failed`;
+    }
+    summary += `.`;
+    return summary;
   }
-  konsola.br();
 }
 
 const isStoryPublishedWithoutChanges = (story) => {
-  return story.published && !story.unpublished_changes;
+  return true;
 };
 const isStoryWithUnpublishedChanges = (story) => {
-  return story.published && story.unpublished_changes;
+  return story.unpublished_changes;
 };
 
+class UpdateStream extends Writable {
+  constructor(options) {
+    super({
+      objectMode: true
+    });
+    this.options = options;
+    this.batchSize = options.batchSize || 10;
+    this.results = {
+      successful: [],
+      failed: [],
+      totalProcessed: 0
+    };
+    this.semaphore = new Sema(this.batchSize, {
+      capacity: this.batchSize
+    });
+  }
+  results;
+  batchSize;
+  semaphore;
+  async _write(chunk, _encoding, callback) {
+    try {
+      await this.semaphore.acquire();
+      this.updateStory(chunk).finally(() => {
+        this.semaphore.release();
+      });
+      callback();
+    } catch (error) {
+      callback(error);
+    }
+  }
+  async updateStory(migrationResult) {
+    const { storyId, name, content } = migrationResult;
+    const storyName = name || storyId.toString();
+    try {
+      const payload = {
+        story: {
+          content,
+          id: storyId,
+          name: storyName
+        },
+        force_update: "1"
+      };
+      if (this.options.publish === "published" && isStoryPublishedWithoutChanges({ published: true, unpublished_changes: false })) {
+        payload.publish = 1;
+      } else if (this.options.publish === "published-with-changes" && isStoryWithUnpublishedChanges({ published: true, unpublished_changes: true })) {
+        payload.publish = 1;
+      } else if (this.options.publish === "all") {
+        payload.publish = 1;
+      }
+      const updatedStory = await updateStory(this.options.space, storyId, payload);
+      if (updatedStory) {
+        this.results.successful.push({ storyId, name: storyName });
+        this.results.totalProcessed++;
+        this.options.onProgress?.(this.results.totalProcessed);
+      } else {
+        this.results.failed.push({
+          storyId,
+          name: storyName,
+          error: new Error("Update returned null")
+        });
+        this.results.totalProcessed++;
+        this.options.onProgress?.(this.results.totalProcessed);
+      }
+    } catch (error) {
+      this.results.failed.push({
+        storyId,
+        name: storyName,
+        error
+      });
+      this.results.totalProcessed++;
+      this.options.onProgress?.(this.results.totalProcessed);
+    }
+  }
+  async _destroy(error, callback) {
+    try {
+      await this.semaphore.drain();
+      callback();
+    } catch (batchError) {
+      callback(batchError);
+      return;
+    }
+    callback(error);
+  }
+  /**
+   * Get the update results
+   */
+  getResults() {
+    return this.results;
+  }
+  /**
+   * Get a summary of the update results
+   */
+  getSummary() {
+    const { successful, failed, totalProcessed } = this.results;
+    if (totalProcessed === 0) {
+      return `No stories required updates.`;
+    }
+    let summary = `Update Results: ${successful.length} stories updated`;
+    if (failed.length > 0) {
+      summary += `, ${failed.length} stories failed`;
+    }
+    summary += `.`;
+    return summary;
+  }
+}
+
 const program$8 = getProgram();
 migrationsCommand.command("run [componentName]").description("Run migrations").option("--fi, --filter <filter>", "glob filter to apply to the components before pushing").option("-d, --dry-run", "Preview changes without applying them to Storyblok").option("-q, --query <query>", 'Filter stories by content attributes using Storyblok filter query syntax. Example: --query="[highlighted][in]=true"').option("--starts-with <path>", 'Filter stories by path. Example: --starts-with="/en/blog/"').option("--publish <publish>", "Options for publication mode: all | published | published-with-changes").action(async (componentName, options) => {
   konsola.title(`${commands.MIGRATIONS}`, colorPalette.MIGRATIONS, componentName ? `Running migrations for component ${componentName}...` : "Running migrations...");
@@ -3284,119 +3468,76 @@ migrationsCommand.command("run [componentName]").description("Run migrations").o
       return;
     }
     spinner.succeed(`Found ${filteredMigrations.length} migration files.`);
-    const storiesSpinner = new Spinner({ verbose: !isVitest }).start(`Fetching stories...`);
-    const stories = await fetchAllStoriesByComponent(
-      {
-        spaceId: space
-      },
-      // Filter options
-      {
+    const multiBar = new MultiBar({
+      clearOnComplete: false,
+      format: `${chalk.bold(" {title} ")} ${chalk.hex(colorPalette.PRIMARY)("[{bar}]")} {percentage}% | {eta_formatted} | {value}/{total} processed`,
+      etaBuffer: 60
+    }, Presets.rect);
+    const storiesProgress = multiBar.create(0, 0, {
+      title: "Fetching Stories...".padEnd(19)
+    });
+    const migrationsProgress = multiBar.create(0, 0, {
+      title: "Applying Migrations".padEnd(19)
+    });
+    const updateProgress = multiBar.create(0, 0, {
+      title: "Updating Stories...".padEnd(19)
+    });
+    const storiesStream = await createStoriesStream({
+      spaceId: space,
+      params: {
         componentName,
         query,
         starts_with: startsWith
+      },
+      batchSize: 100,
+      onTotal: (total) => {
+        storiesProgress.setTotal(total);
+        migrationsProgress.setTotal(total);
+      },
+      onProgress: () => {
+        storiesProgress.increment();
       }
-    );
-    if (!stories || stories.length === 0) {
-      storiesSpinner.failed(`No stories found${componentName ? ` for component "${componentName}"` : ""}.`);
-      return;
-    }
-    const storiesWithContent = await Promise.all(stories.map(async (story) => {
-      const fullStory = await fetchStory(space, story.id.toString());
-      return {
-        ...story,
-        content: fullStory?.content
-      };
-    }));
-    const validStories = storiesWithContent.filter((story) => story.content);
-    const filterParts = [];
-    if (componentName) {
-      filterParts.push(`component "${componentName}"`);
-    }
-    if (startsWith) {
-      filterParts.push(chalk.hex(colorPalette.PRIMARY)(`starts_with=${startsWith}`));
-    }
-    if (query) {
-      filterParts.push(chalk.hex(colorPalette.PRIMARY)(`filter_query=${query}`));
-    }
-    const filterMessage = filterParts.length > 0 ? ` (filtered by ${filterParts.join(" and ")})` : "";
-    storiesSpinner.succeed(`Fetched ${validStories.length} ${validStories.length === 1 ? "story" : "stories"} with related content${filterMessage}.`);
-    const processingSpinner = new Spinner({ verbose: !isVitest }).start(`Processing migrations...`);
-    processingSpinner.succeed(`Starting to process ${validStories.length} stories with ${filteredMigrations.length} migrations...`);
-    const migrationResults = await handleMigrations({
+    });
+    const migrationStream = new MigrationStream({
       migrationFiles: filteredMigrations,
-      stories: validStories,
       space,
       path,
       componentName,
-      password,
-      region
+      onTotal: (total) => {
+        updateProgress.setTotal(total);
+      },
+      onProgress: () => {
+        migrationsProgress.increment();
+      }
     });
-    summarizeMigrationResults(migrationResults);
-    if (migrationResults.successful.length > 0 && !dryRun) {
-      const updateSpinner = new Spinner({ verbose: !isVitest }).start(`Updating stories in Storyblok...`);
-      const storiesByIdMap = /* @__PURE__ */ new Map();
-      migrationResults.successful.forEach((result) => {
-        const originalStory = validStories.find((s) => s.id === result.storyId);
-        storiesByIdMap.set(result.storyId, {
-          id: result.storyId,
-          name: result.name || "",
-          content: result.content,
-          published: originalStory?.published,
-          published_at: originalStory?.published_at || void 0,
-          unpublished_changes: originalStory?.unpublished_changes
-        });
-      });
-      const storiesToUpdate = Array.from(storiesByIdMap.values());
-      if (storiesToUpdate.length === 0) {
-        updateSpinner.succeed(`No stories need to be updated in Storyblok.`);
-      } else {
-        updateSpinner.succeed(`Found ${storiesToUpdate.length} stories to update.`);
-        let successCount = 0;
-        let failCount = 0;
-        for (const story of storiesToUpdate) {
-          const storySpinner = new Spinner({ verbose: !isVitest }).start(`Updating story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}...`);
-          const payload = {
-            story: {
-              content: story.content,
-              id: story.id,
-              name: story.name
-            },
-            force_update: "1"
-          };
-          if (publish === "published" && isStoryPublishedWithoutChanges(story)) {
-            payload.publish = 1;
-          }
-          if (publish === "published-with-changes" && isStoryWithUnpublishedChanges(story)) {
-            payload.publish = 1;
-          }
-          if (publish === "all") {
-            payload.publish = 1;
-          }
-          try {
-            const updatedStory = await updateStory(space, story.id, payload);
-            if (updatedStory) {
-              successCount++;
-              storySpinner.succeed(`Updated story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())} - Completed in ${storySpinner.elapsedTime.toFixed(2)}ms`);
-            } else {
-              failCount++;
-              storySpinner.failed(`Failed to update story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}`);
-            }
-          } catch (error) {
-            failCount++;
-            storySpinner.failed(`Failed to update story ${chalk.hex(colorPalette.PRIMARY)(story.name || story.id.toString())}: ${error.message}`);
+    const updateStream = new UpdateStream({
+      space,
+      publish,
+      dryRun,
+      batchSize: 100,
+      onProgress: () => {
+        updateProgress.increment();
+      }
+    });
+    return new Promise((resolve, reject) => {
+      pipeline(
+        storiesStream,
+        migrationStream,
+        updateStream,
+        (err) => {
+          if (err) {
+            reject(err);
+            return;
           }
+          multiBar.stop();
+          const migrationSummary = migrationStream.getSummary();
+          konsola.info(migrationSummary);
+          const updateSummary = updateStream.getSummary();
+          konsola.info(updateSummary);
+          resolve();
         }
-        if (failCount > 0) {
-          konsola.warn(`Updated ${successCount} stories successfully, ${failCount} failed.`);
-        } else if (successCount > 0) {
-          konsola.ok(`Successfully updated ${successCount} stories in Storyblok.`, true);
-        }
-      }
-    } else if (dryRun) {
-      konsola.info(`Dry run mode: No stories were updated in Storyblok.`);
-    } else if (migrationResults.successful.length === 0) {
-      konsola.info(`No stories were modified by the migrations.`);
-    }
+      );
+    });
   } catch (error) {
     handleError(error, verbose);
   }
@@ -3949,7 +4090,7 @@ const getComponentType = (componentName, options) => {
   const prefix = options.typePrefix ?? "";
   const suffix = options.typeSuffix ?? "";
   const sanitizedName = componentName.replace(/[^a-z0-9]/gi, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
-  const componentType = toPascalCase(toCamelCase(`${prefix}_${sanitizedName}_${suffix}`));
+  const componentType = toPascalCase(`${prefix}_${sanitizedName}_${suffix}`);
   const isFirstCharacterNumber = !Number.isNaN(Number.parseInt(componentType.charAt(0)));
   return isFirstCharacterNumber ? `_${componentType}` : componentType;
 };
@@ -3975,7 +4116,7 @@ const getComponentPropertiesTypeAnnotations = async (component, options, spaceDa
       };
     }
     if (Array.from(storyblokSchemas.keys()).includes(propertyType)) {
-      const componentType = toPascalCase(toCamelCase(propertyType));
+      const componentType = toPascalCase(propertyType);
       propertyTypeAnnotation[key].tsType = `Storyblok${componentType}`;
     }
     if (propertyType === "multilink") {
@@ -3983,8 +4124,8 @@ const getComponentPropertiesTypeAnnotations = async (component, options, spaceDa
         ...!schema.email_link_type ? ['{ linktype?: "email" }'] : [],
         ...!schema.asset_link_type ? ['{ linktype?: "asset" }'] : []
       ];
-      const componentType = toPascalCase(toCamelCase(propertyType));
-      propertyTypeAnnotation[key].tsType = excludedLinktypes.length > 0 ? `Exclude<Storyblok${componentType}, ${excludedLinktypes.join(" | ")}>` : componentType;
+      const componentType = `Storyblok${toPascalCase(propertyType)}`;
+      propertyTypeAnnotation[key].tsType = excludedLinktypes.length > 0 ? `Exclude<${componentType}, ${excludedLinktypes.join(" | ")}>` : componentType;
     }
     if (propertyType === "bloks") {
       if (schema.restrict_components) {
@@ -4811,7 +4952,8 @@ const repositoryToTemplate = (repo) => {
     template: repo.clone_url,
     location: port ? `https://localhost:${port}/` : "https://localhost:3000/",
     description: repo.description,
-    updated_at: repo.updated_at
+    updated_at: repo.updated_at,
+    stars: repo.stargazers_count
   };
 };
 const fetchBlueprintRepositories = async () => {
@@ -4823,7 +4965,7 @@ const fetchBlueprintRepositories = async () => {
       order: "desc",
       per_page: 100
     });
-    const blueprints = data.items.filter((repo) => repo.name.startsWith("blueprint-core-")).map(repositoryToTemplate).sort((a, b) => a.name.localeCompare(b.name));
+    const blueprints = data.items.filter((repo) => repo.name.startsWith("blueprint-core-")).map(repositoryToTemplate).sort((a, b) => (b.stars || 0) - (a.stars || 0));
     return blueprints;
   } catch (error) {
     handleAPIError("fetch_blueprints", error, "Failed to fetch blueprints from GitHub");
@@ -5010,7 +5152,8 @@ program$1.command(`${commands.CREATE} [project-path]`).alias("c").description(`S
   cd ${finalProjectPath}
   npm install
   npm run dev
-`);
+        `);
+    konsola.info(`Or check the dedicated guide at: ${chalk.hex(colorPalette.PRIMARY)(`https://www.storyblok.com/docs/guides/${technologyTemplate}`)}`);
   } catch (error) {
     spinnerSpace.failed();
     spinnerBlueprints.failed();
@@ -5020,7 +5163,7 @@ program$1.command(`${commands.CREATE} [project-path]`).alias("c").description(`S
   konsola.br();
 });
 
-const version = "4.5.0";
+const version = "4.6.0";
 const pkg = {
 	version: version};