sb-mig 6.0.0-beta.2 → 6.0.0-beta.4

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

@@ -43,6 +43,7 @@ interface MigrateItems {
         startsWith?: string;
     };
     dryRun?: boolean;
+    publish?: boolean;
     fromFilePath?: string;
     fileName?: string;
     preparedMigrationConfigs?: PreparedMigrationConfig[];
@@ -67,8 +68,8 @@ export declare const runMigrationPipelineInMemory: ({ itemType, itemsToMigrate,
     itemsToMigrate: any[];
     preparedMigrationConfigs: PreparedMigrationConfig[];
 }) => MigrationPipelineResult;
-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, }: {
+export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
+export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, migrateFrom, fromFilePath, fileName, }: {
     itemType?: "story" | "preset";
     from: string;
     itemsToMigrate: any[];
@@ -76,9 +77,10 @@ export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migratio
     migrationConfigs?: PreparedMigrationConfig[];
     to: string;
     dryRun?: boolean;
+    publish?: boolean;
     migrateFrom: MigrateFrom;
     fromFilePath?: string;
     fileName?: string;
 }, 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 declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
 export {};

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

@@ -9,6 +9,7 @@ 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 { saveMigrationRunLog } from "./migration-run-log.js";
 import { discoverMigrationValidatorForMigrationFile, MigrationValidationFailedError, runPreparedMigrationValidator, } from "./migration-validation.js";
 import { summarizeMutationWriteResults } from "./write-summary.js";
 export const normalizeMigrationConfigNames = (migrationConfig) => {
@@ -295,7 +296,7 @@ export const runMigrationPipelineInMemory = ({ itemType, itemsToMigrate, prepare
         totalItems: workingItems.length,
     };
 };
-const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemType, dryRun, migrateFrom, fromFilePath, pipelineResult, }, config) => {
+const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemType, dryRun, publish, migrateFrom, fromFilePath, pipelineResult, }, config) => {
     await createAndSaveToFile({
         datestamp: useDatestamp,
         ext: "json",
@@ -308,6 +309,7 @@ const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemT
                 from,
                 fromFilePath: fromFilePath || null,
             },
+            writeMode: itemType === "story" && publish ? "publish" : "save",
             totalItems: pipelineResult.totalItems,
             totalChangedItems: pipelineResult.changedItems.length,
             steps: pipelineResult.stepReports,
@@ -378,7 +380,7 @@ const loadItemsToMigrate = async ({ itemType, migrateFrom, from, filters, fromFi
         spaceId: from,
     });
 };
-export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }, config) => {
+export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     Logger.warning(`Trying to migrate all ${itemType} from ${migrateFrom}, ${from} to ${to}...`);
     const preparedMigrationConfigs = prepareMigrationConfigs({
         migrationConfig,
@@ -397,12 +399,13 @@ export const migrateAllComponentsDataInStories = async ({ itemType, migrationCon
         to,
         filters,
         dryRun,
+        publish,
         fromFilePath,
         fileName,
         preparedMigrationConfigs,
     }, config);
 };
-export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, migrateFrom, fromFilePath, fileName, }, config) => {
+export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, migrateFrom, fromFilePath, fileName, }, config) => {
     const preparedMigrationConfigs = migrationConfigs ||
         prepareMigrationConfigs({
             migrationConfig: migrationConfig || [],
@@ -472,6 +475,7 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         from,
         itemType,
         dryRun,
+        publish,
         migrateFrom,
         fromFilePath,
         pipelineResult,
@@ -493,7 +497,7 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         writeResults = await managementApi.stories.updateStories({
             stories: pipelineResult.changedItems,
             spaceId: to,
-            options: { publish: false },
+            options: { publish: Boolean(publish) },
         }, config);
     }
     else if (itemType === "preset") {
@@ -504,6 +508,25 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         }, config);
     }
     const writeSummary = summarizeMutationWriteResults(writeResults);
+    try {
+        await saveMigrationRunLog({
+            artifactBaseName,
+            useDatestamp,
+            from,
+            to,
+            itemType,
+            dryRun,
+            publish,
+            migrateFrom,
+            fromFilePath,
+            pipelineResult,
+            writeResults,
+            writeSummary,
+        }, config);
+    }
+    catch (error) {
+        Logger.warning(`[MIGRATION] Could not write migration run log: ${error instanceof Error ? error.message : String(error)}`);
+    }
     if (writeSummary.failed === 0) {
         Logger.success(`[MIGRATION] Update complete. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully.`);
         return;
@@ -527,7 +550,7 @@ 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, migrationComponentAliases, migrationComponentOverrides, }, config) => {
+export const migrateProvidedComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     const resolvedMigrationConfigs = preparedMigrationConfigs ||
         prepareMigrationConfigs({
             migrationConfig,
@@ -562,6 +585,7 @@ export const migrateProvidedComponentsDataInStories = async ({ itemType, migrati
         from,
         to,
         dryRun,
+        publish,
         migrateFrom,
         fromFilePath,
         fileName,

package/dist/api/data-migration/migration-run-log.d.ts

@@ -0,0 +1,64 @@
+import type { MigrateFrom, MigrationPipelineResult } from "./component-data-migration.js";
+import type { MutationWriteResult, MutationWriteSummary } from "./write-summary.js";
+import type { RequestBaseConfig } from "../utils/request.js";
+type MigrationRunLogEvent = "update_success" | "update_failed" | "migration_write_summary";
+export interface MigrationRunLogRecord {
+    timestamp: string;
+    event: MigrationRunLogEvent;
+    runId: string;
+    itemType: "story" | "preset";
+    source: {
+        migrateFrom: MigrateFrom;
+        from: string;
+        fromFilePath: string | null;
+    };
+    target: {
+        to: string;
+    };
+    writeMode: "publish" | "save";
+    dryRun: boolean;
+    migrationConfigs: string[];
+    totalItems: number;
+    totalChangedItems: number;
+    writeSummary?: {
+        total: number;
+        successful: number;
+        failed: number;
+        failedItems: Array<{
+            id?: number | string;
+            name?: string;
+            slug?: string;
+            spaceId?: string;
+            status?: number | string;
+            response?: string | null;
+        }>;
+    };
+    item?: {
+        index: number;
+        id?: number | string;
+        name?: string;
+        slug?: string;
+        spaceId?: string;
+    };
+    status?: number | string | null;
+    response?: string | null;
+    error?: unknown;
+}
+interface SaveMigrationRunLogArgs {
+    artifactBaseName: string;
+    useDatestamp: boolean;
+    from: string;
+    to: string;
+    itemType: "story" | "preset";
+    dryRun?: boolean;
+    publish?: boolean;
+    migrateFrom: MigrateFrom;
+    fromFilePath?: string;
+    pipelineResult: MigrationPipelineResult;
+    writeResults: PromiseSettledResult<MutationWriteResult>[];
+    writeSummary: MutationWriteSummary;
+}
+export declare const buildMigrationRunLogRecords: ({ from, to, itemType, dryRun, publish, migrateFrom, fromFilePath, pipelineResult, writeResults, writeSummary, }: Omit<SaveMigrationRunLogArgs, "artifactBaseName" | "useDatestamp">) => MigrationRunLogRecord[];
+export declare const recordsToJsonl: (records: MigrationRunLogRecord[]) => string;
+export declare const saveMigrationRunLog: (args: SaveMigrationRunLogArgs, config: RequestBaseConfig) => Promise<void>;
+export {};

package/dist/api/data-migration/migration-run-log.js

@@ -0,0 +1,109 @@
+import { generateDatestamp } from "../../utils/date-utils.js";
+import { createDir, createJsonFile } from "../../utils/files.js";
+import Logger from "../../utils/logger.js";
+const serializeError = (error) => {
+    if (!error) {
+        return null;
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    try {
+        return JSON.parse(JSON.stringify(error));
+    }
+    catch {
+        return String(error);
+    }
+};
+const resolveChangedItemPayload = (item) => item?.story || item;
+const resolveWriteResultValue = (result) => {
+    if (result.status === "fulfilled") {
+        return (result.value || {
+            ok: false,
+        });
+    }
+    return {
+        ok: false,
+        error: result.reason,
+    };
+};
+export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publish, migrateFrom, fromFilePath, pipelineResult, writeResults, writeSummary, }) => {
+    const timestamp = new Date().toISOString();
+    const runId = `${itemType}-${timestamp}`;
+    const baseRecord = {
+        timestamp,
+        runId,
+        itemType,
+        source: {
+            migrateFrom,
+            from,
+            fromFilePath: fromFilePath || null,
+        },
+        target: {
+            to,
+        },
+        writeMode: itemType === "story" && publish ? "publish" : "save",
+        dryRun: Boolean(dryRun),
+        migrationConfigs: pipelineResult.stepReports.map((step) => step.migrationConfig),
+        totalItems: pipelineResult.totalItems,
+        totalChangedItems: pipelineResult.changedItems.length,
+    };
+    const updateRecords = writeResults.map((result, index) => {
+        const value = resolveWriteResultValue(result);
+        const changedItem = resolveChangedItemPayload(pipelineResult.changedItems[index]);
+        const event = value.ok
+            ? "update_success"
+            : "update_failed";
+        return {
+            ...baseRecord,
+            event,
+            item: {
+                index,
+                id: value.id || changedItem?.id,
+                name: value.name || changedItem?.name,
+                slug: value.slug ||
+                    changedItem?.full_slug ||
+                    changedItem?.slug,
+                spaceId: value.spaceId || to,
+            },
+            status: value.status || null,
+            response: value.response || null,
+            ...(value.ok ? {} : { error: serializeError(value.error) }),
+        };
+    });
+    const summaryRecord = {
+        ...baseRecord,
+        event: "migration_write_summary",
+        writeSummary: {
+            total: writeSummary.total,
+            successful: writeSummary.successful,
+            failed: writeSummary.failed,
+            failedItems: writeSummary.failedItems.map((item) => ({
+                id: item.id,
+                name: item.name,
+                slug: item.slug,
+                spaceId: item.spaceId,
+                status: item.status,
+                response: item.response || null,
+            })),
+        },
+    };
+    return [...updateRecords, summaryRecord];
+};
+export const recordsToJsonl = (records) => `${records.map((record) => JSON.stringify(record)).join("\n")}\n`;
+export const saveMigrationRunLog = async (args, config) => {
+    const { sbmigWorkingDirectory } = config;
+    const { artifactBaseName, useDatestamp, itemType, dryRun } = args;
+    const timestamp = generateDatestamp(new Date());
+    const finalFilename = `${dryRun ? "dry-run--" : ""}${artifactBaseName}---${itemType}-migration-run-log${useDatestamp ? `__${timestamp}` : ""}.jsonl`;
+    const folderPath = `${sbmigWorkingDirectory}/migrations/`;
+    const fullPath = `${folderPath}${finalFilename}`;
+    const records = buildMigrationRunLogRecords(args);
+    await createDir(folderPath);
+    await createJsonFile(recordsToJsonl(records), fullPath);
+    Logger.success(`Migration run log written to a file:  ${fullPath}`);
+};

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

@@ -3,6 +3,9 @@ export interface MutationWriteResult {
     id?: number | string;
     name?: string;
     slug?: string;
+    spaceId?: string;
+    status?: number | string;
+    response?: string | null;
     error?: unknown;
 }
 export interface MutationWriteSummary {

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        --dry-run       - Preview planned changes without making writes                      [components, roles, datasources, plugins, content]\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 --dry-run\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        $ sb-mig sync roles --all --dry-run\n        \n        $ sb-mig sync datasources --all\n        $ sb-mig sync datasources --all --dry-run\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        --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 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        --publish         - Publish changed stories immediately after migration. Default: save draft. [content only]\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 file-with-migration --publish --yes\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

@@ -98,6 +98,7 @@ export const migrateDescription = `
         --startsWith      - Filter stories by starts_with prefix
         --yes             - Skip ask for confirmation (dangerous, but useful in CI/CD)
         --dry-run         - Preview what would be migrated without making any API changes
+        --publish         - Publish changed stories immediately after migration. Default: save draft. [content only]
         --fileName        - Stable base name for migration output files (disables timestamp suffix for migration artifacts)
 
     EXAMPLES
@@ -107,6 +108,7 @@ export const migrateDescription = `
         $ 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 file-with-migration --publish --yes
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration v3toV4AllMigrations --dry-run --fileName brand-hub-v3-v4-run
         $ sb-mig migrate content --all --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration
         $ 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

package/dist/cli/commands/migrate.js

@@ -41,6 +41,7 @@ export const migrate = async (props) => {
         "withSlug",
         "startsWith",
         "dryRun",
+        "publish",
         "fileName",
     ]);
     Logger.warning(`This feature is in BETA. Use it at your own risk. The API might change in the future. (Probably in a standard Prisma like migration way)`);
@@ -60,6 +61,7 @@ export const migrate = async (props) => {
             const migrationComponentAliases = parseMigrationComponentAliasFlags(flags["migrationComponentAlias"]);
             const migrationComponentOverrides = parseMigrationComponentOverrideFlags(flags["migrationComponents"]);
             const dryRun = flags["dryRun"];
+            const publish = Boolean(flags["publish"]);
             const fileName = flags["fileName"];
             const withSlugFlag = flags["withSlug"];
             const withSlug = Array.isArray(withSlugFlag)
@@ -97,6 +99,7 @@ export const migrate = async (props) => {
                         migrationComponentOverrides,
                         filters: { withSlug, startsWith },
                         dryRun,
+                        publish,
                         fromFilePath,
                         fileName,
                     }, apiConfig);
@@ -124,6 +127,7 @@ export const migrate = async (props) => {
                         migrationComponentOverrides,
                         filters: { withSlug, startsWith },
                         dryRun,
+                        publish,
                         fromFilePath,
                         fileName,
                     }, apiConfig);
@@ -158,9 +162,13 @@ export const migrate = async (props) => {
                 fromFallback ||
                 getFrom(flags, apiConfig);
             const to = getTo(flags, apiConfig);
+            const publish = Boolean(flags["publish"]);
             if (migrationConfigs.length === 0) {
                 throw new Error("Missing migration config. Pass exactly one --migration value for presets.");
             }
+            if (publish) {
+                throw new Error("--publish is only supported for 'migrate content'. Presets cannot be published.");
+            }
             if (migrationConfigs.length > 1) {
                 throw new Error("Multiple --migration values are currently supported only for 'migrate content'. Presets support a single migration config.");
             }

package/dist/cli/index.js

@@ -80,6 +80,10 @@ app.migrate = () => ({
                 type: "boolean",
                 default: false,
             },
+            publish: {
+                type: "boolean",
+                default: false,
+            },
             fileName: {
                 type: "string",
             },

package/package.json

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