sb-mig 5.6.2-beta.1 → 5.7.0

package/README.md

@@ -189,6 +189,49 @@ This command will look for `row.sb.js` and `column.sb.js` files inside a directo
 
 ## Syncing datasources
 
+## Migrating content
+
+Use `sb-mig migrate content` to run one or more migration configs against
+stories from a space or from a file.
+
+```bash
+sb-mig migrate content --all --from 12345 --to 12345 --migration itemsToContent
+```
+
+### Extending migration component scope
+
+Migration files export a mapper keyed by component name. By default, `sb-mig`
+runs a migration only for the component keys exported by that migration file.
+
+Use these flags when a consuming app has wrapper components that should reuse an
+existing migration function:
+
+- `--migrationComponentAlias`
+  Format: `<migration>:<source>=<alias1>,<alias2>`
+- `--migrationComponents`
+  Format: `<migration>:<component1>,<component2>`
+
+`--migrationComponentAlias` extends the migration mapper at runtime by reusing
+the source component's migration function for extra component names.
+
+`--migrationComponents` overrides the exact component scope for that migration.
+
+Example:
+
+```bash
+sb-mig migrate content --all \
+  --from 12345 \
+  --to 12345 \
+  --migration colorPickerModeValues \
+  --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button \
+  --migrationComponentAlias colorPickerModeValues:sb-section=sb-tour-page-section \
+  --migrationComponents colorPickerModeValues:sb-button,sb-open-drift-button,sb-section,sb-tour-page-section
+```
+
+This runs `colorPickerModeValues` for the normal Backpack keys and also for the
+two wrapper component names by aliasing them onto the existing `sb-button` and
+`sb-section` migration handlers.
+
 You can also sync your `datasources`.
 
 Add `datasourceExt: "your-own-extension",` to your `storyblok.config.js`. If u will not add it, will be used default one (`sb.datasource.js`)

package/dist/api/data-migration/component-data-migration.d.ts

@@ -1,4 +1,5 @@
 import type { RequestBaseConfig } from "../utils/request.js";
+import { type MigrationComponentAliasesByMigration, type MigrationComponentOverridesByMigration } from "./migration-component-scope.js";
 import { type PreparedMigrationValidator } from "./migration-validation.js";
 export type MigrateFrom = "file" | "space";
 export interface PreparedMigrationConfig {
@@ -35,6 +36,8 @@ interface MigrateItems {
     migrateFrom: MigrateFrom;
     migrationConfig: string | string[];
     componentsToMigrate?: string[];
+    migrationComponentAliases?: MigrationComponentAliasesByMigration;
+    migrationComponentOverrides?: MigrationComponentOverridesByMigration;
     filters?: {
         withSlug?: string[];
         startsWith?: string;
@@ -50,9 +53,11 @@ export declare const prepareStoriesFromLocalFile: ({ from, fromFilePath, }: {
     from?: string;
     fromFilePath?: string;
 }) => any;
-export declare const prepareMigrationConfigs: ({ migrationConfig, componentsToMigrate, }: {
+export declare const prepareMigrationConfigs: ({ migrationConfig, componentsToMigrate, migrationComponentAliases, migrationComponentOverrides, }: {
     migrationConfig: string | string[];
     componentsToMigrate?: string[];
+    migrationComponentAliases?: MigrationComponentAliasesByMigration;
+    migrationComponentOverrides?: MigrationComponentOverridesByMigration;
 }) => PreparedMigrationConfig[];
 export declare const prepareMigrationConfig: ({ migrationConfig, }: {
     migrationConfig: string;
@@ -62,7 +67,7 @@ export declare const runMigrationPipelineInMemory: ({ itemType, itemsToMigrate,
     itemsToMigrate: any[];
     preparedMigrationConfigs: PreparedMigrationConfig[];
 }) => MigrationPipelineResult;
-export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, fromFilePath, fileName, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
+export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
 export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, migrateFrom, fromFilePath, fileName, }: {
     itemType?: "story" | "preset";
     from: string;
@@ -75,5 +80,5 @@ export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migratio
     fromFilePath?: string;
     fileName?: string;
 }, config: RequestBaseConfig) => Promise<void>;
-export declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, fromFilePath, fileName, preparedMigrationConfigs, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
+export declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
 export {};

package/dist/api/data-migration/component-data-migration.js

@@ -7,7 +7,10 @@ import Logger from "../../utils/logger.js";
 import { modifyOrCreateAppliedMigrationsFile } from "../../utils/migrations.js";
 import { isObjectEmpty } from "../../utils/object-utils.js";
 import { managementApi } from "../managementApi.js";
+import { buildPreMigrationBackupBaseName, resolveOutputFileBaseName, shouldUseDatestampForArtifacts, } from "./file-naming.js";
+import { extendMigrationMapperWithAliases, resolveMigrationComponentsToMigrate, } from "./migration-component-scope.js";
 import { discoverMigrationValidatorForMigrationFile, MigrationValidationFailedError, runPreparedMigrationValidator, } from "./migration-validation.js";
+import { summarizeMutationWriteResults } from "./write-summary.js";
 export const normalizeMigrationConfigNames = (migrationConfig) => {
     if (Array.isArray(migrationConfig)) {
         return migrationConfig.filter((name) => Boolean(name));
@@ -107,7 +110,7 @@ export const prepareStoriesFromLocalFile = ({ from, fromFilePath, }) => {
     }
     return storiesFileContent;
 };
-export const prepareMigrationConfigs = ({ migrationConfig, componentsToMigrate, }) => {
+export const prepareMigrationConfigs = ({ migrationConfig, componentsToMigrate, migrationComponentAliases, migrationComponentOverrides, }) => {
     const migrationConfigNames = normalizeMigrationConfigNames(migrationConfig);
     if (migrationConfigNames.length === 0) {
         throw new Error("Migration config is required. Pass at least one --migration value.");
@@ -138,13 +141,17 @@ export const prepareMigrationConfigs = ({ migrationConfig, componentsToMigrate,
         if (!validator) {
             Logger.warning(`[VALIDATION] No co-located validator found for migration '${migrationConfigName}'. Expected a sibling '*.validation.*' file.`);
         }
-        const resolvedComponentsToMigrate = componentsToMigrate && componentsToMigrate.length > 0
-            ? componentsToMigrate
-            : Object.keys(migrationConfigFileContent);
+        const aliasedMigrationConfigFileContent = extendMigrationMapperWithAliases(migrationConfigFileContent, migrationComponentAliases?.[migrationConfigName]);
+        const resolvedComponentsToMigrate = resolveMigrationComponentsToMigrate({
+            mapper: aliasedMigrationConfigFileContent,
+            migrationName: migrationConfigName,
+            globalComponentsToMigrate: componentsToMigrate,
+            perMigrationOverrides: migrationComponentOverrides,
+        });
         return {
             migrationConfigName,
             migrationConfigPath,
-            migrationConfigFileContent,
+            migrationConfigFileContent: aliasedMigrationConfigFileContent,
             componentsToMigrate: resolvedComponentsToMigrate,
             validator,
         };
@@ -162,23 +169,6 @@ export const prepareMigrationConfig = ({ migrationConfig, }) => {
 };
 const deepClone = (input) => JSON.parse(JSON.stringify(input));
 const sumValues = (obj) => Object.values(obj).reduce((sum, value) => sum + value, 0);
-const sanitizeOutputFileBaseName = (value) => {
-    const sanitized = value
-        .trim()
-        .replace(/[\\/]/g, "-")
-        .replace(/\s+/g, "-")
-        .replace(/[^a-zA-Z0-9._-]/g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^[-.]+|[-.]+$/g, "");
-    return sanitized || "migration-output";
-};
-const resolveOutputFileBaseName = ({ from, fileName, }) => {
-    if (typeof fileName === "string" && fileName.trim().length > 0) {
-        return sanitizeOutputFileBaseName(fileName);
-    }
-    return sanitizeOutputFileBaseName(from);
-};
-const shouldUseDatestampForArtifacts = (fileName) => !(typeof fileName === "string" && fileName.trim().length > 0);
 const applySingleMigrationToItems = ({ itemType, itemsToMigrate, preparedMigrationConfig, }) => {
     const arrayOfMaxDepths = [];
     const replacementsByComponent = {};
@@ -388,10 +378,12 @@ const loadItemsToMigrate = async ({ itemType, migrateFrom, from, filters, fromFi
         spaceId: from,
     });
 };
-export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, fromFilePath, fileName, }, config) => {
+export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     Logger.warning(`Trying to migrate all ${itemType} from ${migrateFrom}, ${from} to ${to}...`);
     const preparedMigrationConfigs = prepareMigrationConfigs({
         migrationConfig,
+        migrationComponentAliases,
+        migrationComponentOverrides,
     });
     if (storyblokConfig.debug) {
         Logger.warning("_________ Components in stories to migrate ___________");
@@ -496,20 +488,34 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
     if (pipelineResult.changedItems.length === 0) {
         return;
     }
+    let writeResults = [];
     if (itemType === "story") {
-        await managementApi.stories.updateStories({
+        writeResults = await managementApi.stories.updateStories({
             stories: pipelineResult.changedItems,
             spaceId: to,
             options: { publish: false },
         }, config);
     }
     else if (itemType === "preset") {
-        await managementApi.presets.updatePresets({
+        writeResults = await managementApi.presets.updatePresets({
             presets: pipelineResult.changedItems,
             spaceId: to,
             options: {},
         }, config);
     }
+    const writeSummary = summarizeMutationWriteResults(writeResults);
+    if (writeSummary.failed === 0) {
+        Logger.success(`[MIGRATION] Update complete. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully.`);
+        return;
+    }
+    Logger.warning(`[MIGRATION] Update complete with partial failures. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully, ${writeSummary.failed} failed.`);
+    writeSummary.failedItems.slice(0, 10).forEach((item) => {
+        const label = item.slug || item.name || item.id || "unknown";
+        Logger.error(`[MIGRATION] Failed ${itemType}: ${String(label)}`);
+    });
+    if (writeSummary.failedItems.length > 10) {
+        Logger.warning(`[MIGRATION] Showing first 10 failed ${itemType}(s) only.`);
+    }
 };
 const saveBackupToFile = async ({ itemType, res, folder, filename }, config) => {
     await createAndSaveToFile({
@@ -521,11 +527,13 @@ const saveBackupToFile = async ({ itemType, res, folder, filename }, config) =>
         res: res,
     }, config);
 };
-export const migrateProvidedComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, fromFilePath, fileName, preparedMigrationConfigs, }, config) => {
+export const migrateProvidedComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     const resolvedMigrationConfigs = preparedMigrationConfigs ||
         prepareMigrationConfigs({
             migrationConfig,
             componentsToMigrate,
+            migrationComponentAliases,
+            migrationComponentOverrides,
         });
     const itemsToMigrate = await loadItemsToMigrate({
         itemType,
@@ -536,12 +544,12 @@ export const migrateProvidedComponentsDataInStories = async ({ itemType, migrati
     }, config);
     if (migrateFrom === "space" && !dryRun) {
         const backupFolder = path.join("backup", itemType);
-        const migrationLabel = resolvedMigrationConfigs
-            .map((preparedMigrationConfig) => preparedMigrationConfig.migrationConfigName)
-            .join("__");
         await saveBackupToFile({
             itemType,
-            filename: `before__${migrationLabel}__${from}`,
+            filename: buildPreMigrationBackupBaseName({
+                from,
+                fileName,
+            }),
             folder: backupFolder,
             res: itemsToMigrate,
         }, config);

package/dist/api/data-migration/file-naming.d.ts

@@ -0,0 +1,14 @@
+export declare const sanitizeOutputFileBaseName: (value: string) => string;
+export declare const resolveOutputFileBaseName: ({ from, fileName, }: {
+    from: string;
+    fileName?: string;
+}) => string;
+export declare const shouldUseDatestampForArtifacts: (fileName?: string) => boolean;
+export declare const buildPreMigrationBackupBaseName: ({ from, fileName, }: {
+    from: string;
+    fileName?: string;
+}) => string;
+export declare const buildStoryBackupBaseName: ({ from, fileName, }: {
+    from: string;
+    fileName?: string;
+}) => string;

package/dist/api/data-migration/file-naming.js

@@ -0,0 +1,19 @@
+export const sanitizeOutputFileBaseName = (value) => {
+    const sanitized = value
+        .trim()
+        .replace(/[\\/]/g, "-")
+        .replace(/\s+/g, "-")
+        .replace(/[^a-zA-Z0-9._-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^[-.]+|[-.]+$/g, "");
+    return sanitized || "migration-output";
+};
+export const resolveOutputFileBaseName = ({ from, fileName, }) => {
+    if (typeof fileName === "string" && fileName.trim().length > 0) {
+        return sanitizeOutputFileBaseName(fileName);
+    }
+    return sanitizeOutputFileBaseName(from);
+};
+export const shouldUseDatestampForArtifacts = (fileName) => !(typeof fileName === "string" && fileName.trim().length > 0);
+export const buildPreMigrationBackupBaseName = ({ from, fileName, }) => `before__${resolveOutputFileBaseName({ from, fileName })}`;
+export const buildStoryBackupBaseName = ({ from, fileName, }) => `${resolveOutputFileBaseName({ from, fileName })}--backup-before-migration`;

package/dist/api/data-migration/migration-component-scope.d.ts

@@ -0,0 +1,12 @@
+import type { MapperDefinition } from "./component-data-migration.js";
+export type MigrationComponentAliasesByMigration = Record<string, Record<string, string[]>>;
+export type MigrationComponentOverridesByMigration = Record<string, string[]>;
+export declare const parseMigrationComponentAliasFlags: (value: string | string[] | undefined) => MigrationComponentAliasesByMigration;
+export declare const parseMigrationComponentOverrideFlags: (value: string | string[] | undefined) => MigrationComponentOverridesByMigration;
+export declare const extendMigrationMapperWithAliases: (mapper: Record<string, MapperDefinition>, aliases: Record<string, string[]> | undefined) => Record<string, MapperDefinition>;
+export declare const resolveMigrationComponentsToMigrate: ({ mapper, migrationName, globalComponentsToMigrate, perMigrationOverrides, }: {
+    mapper: Record<string, MapperDefinition>;
+    migrationName: string;
+    globalComponentsToMigrate?: string[];
+    perMigrationOverrides?: MigrationComponentOverridesByMigration;
+}) => string[];

package/dist/api/data-migration/migration-component-scope.js

@@ -0,0 +1,73 @@
+const normalizeFlagValues = (value) => {
+    if (Array.isArray(value)) {
+        return value.filter(Boolean);
+    }
+    if (typeof value === "string" && value.length > 0) {
+        return [value];
+    }
+    return [];
+};
+export const parseMigrationComponentAliasFlags = (value) => {
+    const result = {};
+    normalizeFlagValues(value).forEach((entry) => {
+        const [migrationName, mapping] = entry.split(":");
+        const [sourceComponent, aliasesRaw] = (mapping || "").split("=");
+        const aliases = (aliasesRaw || "")
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+        if (!migrationName || !sourceComponent || aliases.length === 0) {
+            throw new Error(`Invalid --migrationComponentAlias value '${entry}'. Expected '<migration>:<source>=<alias1>,<alias2>'.`);
+        }
+        result[migrationName] = result[migrationName] || {};
+        result[migrationName][sourceComponent] = [
+            ...(result[migrationName][sourceComponent] || []),
+            ...aliases,
+        ];
+    });
+    return result;
+};
+export const parseMigrationComponentOverrideFlags = (value) => {
+    const result = {};
+    normalizeFlagValues(value).forEach((entry) => {
+        const [migrationName, componentsRaw] = entry.split(":");
+        const components = (componentsRaw || "")
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+        if (!migrationName || components.length === 0) {
+            throw new Error(`Invalid --migrationComponents value '${entry}'. Expected '<migration>:<component1>,<component2>'.`);
+        }
+        result[migrationName] = components;
+    });
+    return result;
+};
+export const extendMigrationMapperWithAliases = (mapper, aliases) => {
+    if (!aliases) {
+        return mapper;
+    }
+    const extendedMapper = { ...mapper };
+    Object.entries(aliases).forEach(([sourceComponent, extraComponents]) => {
+        const sourceMapper = mapper[sourceComponent];
+        if (!sourceMapper) {
+            throw new Error(`Cannot alias migration component '${sourceComponent}' because it is not defined in the migration config.`);
+        }
+        extraComponents.forEach((extraComponent) => {
+            extendedMapper[extraComponent] = sourceMapper;
+        });
+    });
+    return extendedMapper;
+};
+export const resolveMigrationComponentsToMigrate = ({ mapper, migrationName, globalComponentsToMigrate, perMigrationOverrides, }) => {
+    const resolvedComponents = perMigrationOverrides?.[migrationName] &&
+        perMigrationOverrides[migrationName].length > 0
+        ? perMigrationOverrides[migrationName]
+        : globalComponentsToMigrate && globalComponentsToMigrate.length > 0
+            ? globalComponentsToMigrate
+            : Object.keys(mapper);
+    const missingComponents = resolvedComponents.filter((componentName) => !mapper[componentName]);
+    if (missingComponents.length > 0) {
+        throw new Error(`Migration '${migrationName}' cannot run for unknown components: ${missingComponents.join(", ")}. Add aliases first or adjust the component override list.`);
+    }
+    return resolvedComponents;
+};

package/dist/api/data-migration/write-summary.d.ts

@@ -0,0 +1,14 @@
+export interface MutationWriteResult {
+    ok: boolean;
+    id?: number | string;
+    name?: string;
+    slug?: string;
+    error?: unknown;
+}
+export interface MutationWriteSummary {
+    total: number;
+    successful: number;
+    failed: number;
+    failedItems: MutationWriteResult[];
+}
+export declare const summarizeMutationWriteResults: (results: PromiseSettledResult<MutationWriteResult>[]) => MutationWriteSummary;

package/dist/api/data-migration/write-summary.js

@@ -0,0 +1,26 @@
+export const summarizeMutationWriteResults = (results) => {
+    const failedItems = [];
+    let successful = 0;
+    for (const result of results) {
+        if (result.status === "fulfilled" && result.value?.ok) {
+            successful++;
+            continue;
+        }
+        if (result.status === "fulfilled") {
+            failedItems.push(result.value || {
+                ok: false,
+            });
+            continue;
+        }
+        failedItems.push({
+            ok: false,
+            error: result.reason,
+        });
+    }
+    return {
+        total: results.length,
+        successful,
+        failed: failedItems.length,
+        failedItems,
+    };
+};

package/dist/api/presets/presets.js

@@ -63,10 +63,21 @@ export const updatePreset = (args, config) => {
     })
         .then((res) => {
         Logger.warning(`Preset: '${p.preset.name}' with '${p.preset.id}' id has been updated.`);
-        return res;
+        return {
+            ok: true,
+            id: p.preset.id,
+            name: p.preset.name,
+            data: res,
+        };
     })
-        .catch(() => {
+        .catch((error) => {
         Logger.error(`Error happened. Preset: '${p.preset.name}' with '${p.preset.id}' id has been not updated.`);
+        return {
+            ok: false,
+            id: p.preset.id,
+            name: p.preset.name,
+            error,
+        };
     });
 };
 export const updatePresets = (args, config) => {

package/dist/api/stories/stories.js

@@ -118,9 +118,24 @@ export const updateStory = (content, storyId, options, config) => {
     })
         .then((res) => {
         console.log(`${chalk.green(res.data.story.full_slug)} updated.`);
-        return res.data;
+        return {
+            ok: true,
+            id: res.data.story.id,
+            name: res.data.story.name,
+            slug: res.data.story.full_slug,
+            data: res.data,
+        };
     })
-        .catch((err) => console.error(err));
+        .catch((err) => {
+        console.error(err);
+        return {
+            ok: false,
+            id: storyId,
+            name: content?.name,
+            slug: content?.full_slug || content?.slug,
+            error: err,
+        };
+    });
 };
 export const updateStories = (args, config) => {
     const { stories, options, spaceId } = args;

package/dist/cli/cli-descriptions.d.ts

@@ -1,7 +1,7 @@
 export declare const mainDescription = "\n    USAGE\n      $ sb-mig [command]\n    \n    COMMANDS\n        sync      Synchronize components, datasources, roles, stories, assets with Storyblok space.\n        discover  Discover components, migration configs and write to file or stdout.\n        backup    Command for backing up anything related to Storyblok\n        migrate   Migrate content from space to space, or from file to space.\n        debug     Output extra debugging information\n        help      This screen\n    \n    Examples\n      $ sb-mig sync components --all\n      $ sb-mig debug  \n";
 export declare const syncDescription = "\n    Usage\n        $ sb-mig sync [components|roles|datasources|plugins|content] [space separated file names] or --all\n        \n    Description\n        Synchronize components, roles, datasources, plugins, content with Storyblok space.\n        \n    COMMANDS\n        components      - sync components\n        roles           - sync roles\n        datasources     - sync datasources\n        plugins         - sync plugins\n        content         - sync content (stories, assets) - ! right now destructive, it will move content from 1 space to another, completelly overwriting it\n     \n    FLAGS\n        --all           - Sync all components, roles, datasources                            [components, roles, datasources]\n        --presets       - Pass it, if u want to sync also with presets (will take longer)    [components only]\n        \n        --yes           - Skip ask for confirmation (dangerous, but useful in CI/CD)         [content only]\n        --from          - Space ID from which you want to sync content                       [content only]\n        --to            - Space ID to which you want to sync content                         [content only]\n        --syncDirection [fromSpaceToFile|fromFileToSpace|fromSpaceToSpace|fromAWStoSpace]               \n                        - Sync direction (from, to)                                          [content only]\n    \n    EXAMPLES\n        $ sb-mig sync components --all\n        $ sb-mig sync components --all --presets\n        $ sb-mig sync components accordion accordion-item\n        $ sb-mig sync components accordion accordion-item --presets\n        \n        $ sb-mig sync roles --all\n        \n        $ sb-mig sync datasources --all\n        \n        $ sb-mig sync plugins my-awesome-plugin - (you have to be in catalog which has ./dist/export.js file with compiled plugin)\n        \n        $ sb-mig sync content --all --from 12345 --to 12345\n        $ sb-mig sync content --stories --from 12345 --to 12345\n        $ sb-mig sync content --assets --from 12345 --to 12345\n";
 export declare const copyDescription = "\n    Usage\n        $ sb-mig copy\n        \n    Description\n        Copy stuff\n        \n    COMMANDS\n        ?\n     \n    FLAGS\n        ?\n    \n    EXAMPLES\n        $ sb-mig copy ?\n";
-export declare const migrateDescription = "\n    Usage\n        $ sb-mig migrate [content] [space separated file names] or --all --from [spaceId] --to [spaceId] --migration [migration-config-filename]\n        $ sb-mig migrate content --all --migration migration-a --migration migration-b --migration migration-c\n        \n    Description\n        Migrate content from space to space, or from file to space. It's potentially dangerous command, so it will ask for confirmation.\n        Use with care.\n        \n    COMMANDS\n        content           - migrate content \n     \n    FLAGS\n        --from            - Space ID from which you want to migrate / or file name if passed '--migrate-from file'\n        --fromFilePath    - Direct path to stories JSON file when using '--migrate-from file'\n        --to              - Space ID to which you want to migrate\n        --migrate-from    - Migrate from (space, file) default: space\n        --migration       - File name of migration file (without extension). Can be repeated for ordered pipeline in content migration.\n        --withSlug        - Filter stories by full slug (can be repeated)\n        --startsWith      - Filter stories by starts_with prefix\n        --yes             - Skip ask for confirmation (dangerous, but useful in CI/CD)\n        --dry-run         - Preview what would be migrated without making any API changes\n        --fileName        - Stable base name for migration output files (disables timestamp suffix for migration artifacts)\n\n    EXAMPLES\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --withSlug blog/home --withSlug docs/getting-started\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --startsWith blog/\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration v3toV4AllMigrations --dry-run --fileName brand-hub-v3-v4-run\n        $ sb-mig migrate content --all --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --migrate-from file --fromFilePath sbmig/migrations/dry-run--123---story-to-migrate__2026-2-9_20-51.json --to 12345 --migration migration-a --migration migration-b\n        $ sb-mig migrate content my-component-1 my-component-2 --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate content my-component-1 my-component-2 --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration        \n";
+export declare const migrateDescription = "\n    Usage\n        $ sb-mig migrate [content] [space separated file names] or --all --from [spaceId] --to [spaceId] --migration [migration-config-filename]\n        $ sb-mig migrate content --all --migration migration-a --migration migration-b --migration migration-c\n        \n    Description\n        Migrate content from space to space, or from file to space. It's potentially dangerous command, so it will ask for confirmation.\n        Use with care.\n        \n    COMMANDS\n        content           - migrate content \n     \n    FLAGS\n        --from            - Space ID from which you want to migrate / or file name if passed '--migrate-from file'\n        --fromFilePath    - Direct path to stories JSON file when using '--migrate-from file'\n        --to              - Space ID to which you want to migrate\n        --migrate-from    - Migrate from (space, file) default: space\n        --migration       - File name of migration file (without extension). Can be repeated for ordered pipeline in content migration.\n        --migrationComponentAlias - Add extra component aliases for a migration. Repeatable. Format: <migration>:<source>=<alias1>,<alias2>\n        --migrationComponents - Override the exact component scope for a migration. Repeatable. Format: <migration>:<component1>,<component2>\n        --withSlug        - Filter stories by full slug (can be repeated)\n        --startsWith      - Filter stories by starts_with prefix\n        --yes             - Skip ask for confirmation (dangerous, but useful in CI/CD)\n        --dry-run         - Preview what would be migrated without making any API changes\n        --fileName        - Stable base name for migration output files (disables timestamp suffix for migration artifacts)\n\n    EXAMPLES\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-section=sb-tour-page-section --migrationComponents colorPickerModeValues:sb-section,sb-tour-page-section\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --withSlug blog/home --withSlug docs/getting-started\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --startsWith blog/\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration v3toV4AllMigrations --dry-run --fileName brand-hub-v3-v4-run\n        $ sb-mig migrate content --all --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --migrate-from file --fromFilePath sbmig/migrations/dry-run--123---story-to-migrate__2026-2-9_20-51.json --to 12345 --migration migration-a --migration migration-b\n        $ sb-mig migrate content my-component-1 my-component-2 --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate content my-component-1 my-component-2 --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration        \n";
 export declare const revertDescription = "\n    Usage\n        $ sb-mig revert [content] --migration\n        \n    Description\n        Revert content migration\n        \n    COMMANDS\n        content           - revert content migration \n     \n    FLAGS\n        --migration       - ???\n        --yes             - Skip ask for confirmation (dangerous, but useful in CI/CD) \n    \n    EXAMPLES\n        $ sb-mig revert content --migration        \n";
 export declare const discoverDescription = "\n    Usage\n        $ sb-mig discover [components|migrations] --all --write\n\n    Description\n        Discover all components or migration configs and write to file or stdout\n\n    COMMANDS\n        components     - discover components\n        migrations     - discover migration config files\n\n    FLAGS\n        --all          - Discover all components or migration configs\n        --write        - Write to file\n\n    EXAMPLES\n        $ sb-mig discover components --all\n        $ sb-mig discover components --all --write\n        $ sb-mig discover migrations --all\n";
 export declare const migrationsDescription = "\n    Usage\n        $ sb-mig migrations recognize\n        \n    Description\n        Recognize migrations you need to apply\n        \n    COMMANDS\n        recognize      - recognize migrations\n     \n    FLAGS \n    \n    EXAMPLES\n        $ sb-mig migrations recognize\n\n";

package/dist/cli/cli-descriptions.js

@@ -88,6 +88,8 @@ export const migrateDescription = `
         --to              - Space ID to which you want to migrate
         --migrate-from    - Migrate from (space, file) default: space
         --migration       - File name of migration file (without extension). Can be repeated for ordered pipeline in content migration.
+        --migrationComponentAlias - Add extra component aliases for a migration. Repeatable. Format: <migration>:<source>=<alias1>,<alias2>
+        --migrationComponents - Override the exact component scope for a migration. Repeatable. Format: <migration>:<component1>,<component2>
         --withSlug        - Filter stories by full slug (can be repeated)
         --startsWith      - Filter stories by starts_with prefix
         --yes             - Skip ask for confirmation (dangerous, but useful in CI/CD)
@@ -97,6 +99,8 @@ export const migrateDescription = `
     EXAMPLES
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c
+        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button
+        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-section=sb-tour-page-section --migrationComponents colorPickerModeValues:sb-section,sb-tour-page-section
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --withSlug blog/home --withSlug docs/getting-started
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --startsWith blog/
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration v3toV4AllMigrations --dry-run --fileName brand-hub-v3-v4-run

package/dist/cli/commands/migrate.js

@@ -1,5 +1,7 @@
 import path from "path";
 import { migrateAllComponentsDataInStories, migrateProvidedComponentsDataInStories, } from "../../api/data-migration/component-data-migration.js";
+import { buildStoryBackupBaseName } from "../../api/data-migration/file-naming.js";
+import { parseMigrationComponentAliasFlags, parseMigrationComponentOverrideFlags, } from "../../api/data-migration/migration-component-scope.js";
 import { managementApi } from "../../api/managementApi.js";
 import { backupStories } from "../../api/stories/backup.js";
 import { createAndSaveToFile } from "../../utils/files.js";
@@ -33,6 +35,8 @@ export const migrate = async (props) => {
         "fromFilePath",
         "pageId",
         "migration",
+        "migrationComponentAlias",
+        "migrationComponents",
         "yes",
         "withSlug",
         "startsWith",
@@ -53,6 +57,8 @@ export const migrate = async (props) => {
                 getFrom(flags, apiConfig);
             const to = getTo(flags, apiConfig);
             const migrationConfigs = normalizeMigrationFlags(flags["migration"]);
+            const migrationComponentAliases = parseMigrationComponentAliasFlags(flags["migrationComponentAlias"]);
+            const migrationComponentOverrides = parseMigrationComponentOverrideFlags(flags["migrationComponents"]);
             const dryRun = flags["dryRun"];
             const fileName = flags["fileName"];
             const withSlugFlag = flags["withSlug"];
@@ -72,7 +78,10 @@ export const migrate = async (props) => {
                     Logger.warning("Preparing to migrate...");
                     if (!dryRun) {
                         await backupStories({
-                            filename: `${from}--backup-before-migration___${migrationConfigs.join("__")}`,
+                            filename: buildStoryBackupBaseName({
+                                from,
+                                fileName,
+                            }),
                             suffix: ".sb.stories",
                             spaceId: from,
                         }, apiConfig);
@@ -84,6 +93,8 @@ export const migrate = async (props) => {
                         migrateFrom,
                         componentsToMigrate,
                         migrationConfig: migrationConfigs,
+                        migrationComponentAliases,
+                        migrationComponentOverrides,
                         filters: { withSlug, startsWith },
                         dryRun,
                         fromFilePath,
@@ -109,6 +120,8 @@ export const migrate = async (props) => {
                         to,
                         migrateFrom,
                         migrationConfig: migrationConfigs,
+                        migrationComponentAliases,
+                        migrationComponentOverrides,
                         filters: { withSlug, startsWith },
                         dryRun,
                         fromFilePath,
@@ -134,6 +147,8 @@ export const migrate = async (props) => {
         case MIGRATE_COMMANDS.presets: {
             Logger.log(`Migrating content with command: ${command}`);
             const migrationConfigs = normalizeMigrationFlags(flags["migration"]);
+            const migrationComponentAliases = parseMigrationComponentAliasFlags(flags["migrationComponentAlias"]);
+            const migrationComponentOverrides = parseMigrationComponentOverrideFlags(flags["migrationComponents"]);
             const fromFilePath = flags["fromFilePath"];
             const migrateFromFlag = flags["migrateFrom"];
             const fromFallback = migrateFromFlag === "file" && fromFilePath
@@ -169,6 +184,8 @@ export const migrate = async (props) => {
                         to,
                         migrateFrom,
                         migrationConfig: migrationConfigs[0],
+                        migrationComponentAliases,
+                        migrationComponentOverrides,
                         dryRun,
                         fromFilePath,
                         fileName,

package/dist/cli/helpers.js

@@ -19,18 +19,23 @@ export const askForConfirmation = async (message, resolveYes, resolveNo, ci) =>
         output: process.stdout,
         prompt: chalk.red(`${message} (y/n) > `),
     });
-    rl.prompt();
-    for await (const deletionConfirmation of rl) {
-        if (deletionConfirmation.trim() !== "y") {
-            await resolveNo();
-            process.exit(0);
-        }
-        else {
-            if (deletionConfirmation) {
-                await resolveYes();
-                break;
+    try {
+        rl.prompt();
+        for await (const deletionConfirmation of rl) {
+            if (deletionConfirmation.trim() !== "y") {
+                await resolveNo();
+                process.exit(0);
+            }
+            else {
+                if (deletionConfirmation) {
+                    await resolveYes();
+                    break;
+                }
             }
+            rl.prompt();
         }
-        rl.prompt();
+    }
+    finally {
+        rl.close();
     }
 };

package/dist/cli/index.js

@@ -61,6 +61,14 @@ app.migrate = () => ({
                 type: "string",
                 isMultiple: true,
             },
+            migrationComponentAlias: {
+                type: "string",
+                isMultiple: true,
+            },
+            migrationComponents: {
+                type: "string",
+                isMultiple: true,
+            },
             withSlug: {
                 type: "string",
                 isMultiple: true,

package/dist-cjs/api/presets/presets.js

@@ -72,10 +72,21 @@ const updatePreset = (args, config) => {
     })
         .then((res) => {
         logger_js_1.default.warning(`Preset: '${p.preset.name}' with '${p.preset.id}' id has been updated.`);
-        return res;
+        return {
+            ok: true,
+            id: p.preset.id,
+            name: p.preset.name,
+            data: res,
+        };
     })
-        .catch(() => {
+        .catch((error) => {
         logger_js_1.default.error(`Error happened. Preset: '${p.preset.name}' with '${p.preset.id}' id has been not updated.`);
+        return {
+            ok: false,
+            id: p.preset.id,
+            name: p.preset.name,
+            error,
+        };
     });
 };
 exports.updatePreset = updatePreset;

package/dist-cjs/api/stories/stories.js

@@ -130,9 +130,24 @@ const updateStory = (content, storyId, options, config) => {
     })
         .then((res) => {
         console.log(`${chalk_1.default.green(res.data.story.full_slug)} updated.`);
-        return res.data;
+        return {
+            ok: true,
+            id: res.data.story.id,
+            name: res.data.story.name,
+            slug: res.data.story.full_slug,
+            data: res.data,
+        };
     })
-        .catch((err) => console.error(err));
+        .catch((err) => {
+        console.error(err);
+        return {
+            ok: false,
+            id: storyId,
+            name: content?.name,
+            slug: content?.full_slug || content?.slug,
+            error: err,
+        };
+    });
 };
 exports.updateStory = updateStory;
 const updateStories = (args, config) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sb-mig",
-  "version": "5.6.2-beta.1",
+  "version": "5.7.0",
   "description": "CLI to rule the world. (and handle stuff related to Storyblok CMS)",
   "author": "Marcin Krawczyk <marckraw@icloud.com>",
   "license": "MIT",