sb-mig 5.7.0 → 5.8.0

package/dist/api/roles/roles.js

@@ -75,13 +75,16 @@ export const getRole = async (roleName, config) => {
     })
         .catch((err) => Logger.error(err));
 };
-export const syncRolesData = async ({ roles }, config) => {
+export const syncRolesData = async ({ roles, dryRun }, config) => {
     const result = {
         created: [],
         updated: [],
         skipped: [],
         errors: [],
     };
+    if (dryRun) {
+        Logger.warning("[dry-run] Role sync will only read remote data and report planned changes.");
+    }
     const space_roles_raw = await getAllRoles(config);
     const space_roles = Array.isArray(space_roles_raw) ? space_roles_raw : [];
     const rolesToUpdate = [];
@@ -99,17 +102,27 @@ export const syncRolesData = async ({ roles }, config) => {
             rolesToCreate.push(role);
         }
     }
-    const updateResults = await Promise.allSettled(rolesToUpdate.map((role) => updateRole(role, config)));
+    const updateResults = dryRun
+        ? rolesToUpdate.map(() => ({ status: "fulfilled" }))
+        : await Promise.allSettled(rolesToUpdate.map((role) => updateRole(role, config)));
     updateResults.forEach((r, idx) => {
         const name = String(rolesToUpdate[idx]?.role ?? "unknown");
+        if (dryRun) {
+            Logger.warning(`[dry-run] Would update role '${name}'.`);
+        }
         if (r.status === "fulfilled")
             result.updated.push(name);
         else
             result.errors.push({ name, message: String(r.reason) });
     });
-    const createResults = await Promise.allSettled(rolesToCreate.map((role) => createRole(role, config)));
+    const createResults = dryRun
+        ? rolesToCreate.map(() => ({ status: "fulfilled" }))
+        : await Promise.allSettled(rolesToCreate.map((role) => createRole(role, config)));
     createResults.forEach((r, idx) => {
         const name = String(rolesToCreate[idx]?.role ?? "unknown");
+        if (dryRun) {
+            Logger.warning(`[dry-run] Would create role '${name}'.`);
+        }
         if (r.status === "fulfilled")
             result.created.push(name);
         else

package/dist/api/roles/roles.sync.js

@@ -1,6 +1,6 @@
 import { getFileContentWithRequire } from "../../utils/files.js";
 import { syncRolesData } from "./roles.js";
-export const syncRoles = async ({ specifiedRoles }, config) => {
+export const syncRoles = async ({ specifiedRoles, dryRun }, config) => {
     const specifiedRolesContent = await Promise.all(specifiedRoles.map((roles) => getFileContentWithRequire({ file: roles.p })));
-    await syncRolesData({ roles: specifiedRolesContent }, config);
+    await syncRolesData({ roles: specifiedRolesContent, dryRun }, config);
 };

package/dist/api/roles/roles.types.d.ts

@@ -1,13 +1,16 @@
 import type { OneFileElement } from "../../utils/path-utils.js";
+import type { SyncOptions } from "../sync/sync.types.js";
 import type { RequestBaseConfig } from "../utils/request.js";
 export type GetRole = (roleName: string | undefined, config: RequestBaseConfig) => Promise<void>;
 export type GetAllRoles = (config: RequestBaseConfig) => Promise<any>;
 export type CreateRole = (role: any, config: RequestBaseConfig) => void;
 export type UpdateRole = (role: any, config: RequestBaseConfig) => void;
-export type SyncRoles = ({ specifiedRoles }: {
+export type SyncRoles = ({ specifiedRoles, dryRun, }: {
     specifiedRoles: OneFileElement[];
+    dryRun?: boolean;
 }, config: RequestBaseConfig) => Promise<void>;
-export type SyncAllRoles = (config: RequestBaseConfig) => Promise<void>;
-export type SyncProvidedRoles = ({ roles }: {
+export type SyncAllRoles = (config: RequestBaseConfig, options?: SyncOptions) => Promise<void>;
+export type SyncProvidedRoles = ({ roles, dryRun }: {
     roles: string[];
+    dryRun?: boolean;
 }, config: RequestBaseConfig) => Promise<void>;

package/dist/api/stories/stories.js

@@ -2,6 +2,24 @@ import chalk from "chalk";
 import Logger from "../../utils/logger.js";
 import { notNullish } from "../../utils/object-utils.js";
 import { getAllItemsWithPagination } from "../utils/request.js";
+const resolveStoryLabel = (content, storyId) => content?.full_slug || content?.slug || content?.name || String(storyId);
+const resolveStoryblokErrorResponse = (err) => {
+    if (typeof err?.response === "string" && err.response.trim().length > 0) {
+        return err.response.trim();
+    }
+    if (typeof err?.response?.data === "string" &&
+        err.response.data.trim().length > 0) {
+        return err.response.data.trim();
+    }
+    if (typeof err?.response?.message === "string" &&
+        err.response.message.trim().length > 0) {
+        return err.response.message.trim();
+    }
+    if (typeof err?.message === "string" && err.message.trim().length > 0) {
+        return err.message.trim();
+    }
+    return undefined;
+};
 export const removeStory = (args, config) => {
     const { storyId } = args;
     const { spaceId, sbApi } = config;
@@ -106,6 +124,7 @@ export const createStory = (content, config) => {
 // UPDATE
 export const updateStory = (content, storyId, options, config) => {
     const { spaceId, sbApi } = config;
+    const storyLabel = resolveStoryLabel(content, storyId);
     Logger.warning("Trying to update Story...");
     Logger.log(`Updating story with name: ${content.name} in space: ${spaceId}`);
     // console.log("THis is content to update: ");
@@ -127,12 +146,21 @@ export const updateStory = (content, storyId, options, config) => {
         };
     })
         .catch((err) => {
-        console.error(err);
+        const status = err?.status || err?.response?.status;
+        const responseMessage = resolveStoryblokErrorResponse(err);
+        const statusLabel = status ? `status ${status}` : "unknown status";
+        const responseLabel = responseMessage
+            ? ` Response: ${responseMessage}`
+            : "";
+        Logger.error(`Failed to update story '${storyLabel}' in space '${spaceId}' (${statusLabel}).${responseLabel}`);
         return {
             ok: false,
             id: storyId,
             name: content?.name,
             slug: content?.full_slug || content?.slug,
+            spaceId,
+            status,
+            response: responseMessage,
             error: err,
         };
     });

package/dist/api/sync/sync.types.d.ts

@@ -8,6 +8,9 @@ export interface SyncResult {
     skipped: string[];
     errors: SyncError[];
 }
+export interface SyncOptions {
+    dryRun?: boolean;
+}
 /**
  * Progress event emitted during sync operations
  */

package/dist/api-v2/sync/index.js

@@ -5,105 +5,20 @@ import { syncRolesData } from "../../api/roles/roles.js";
 import { toRequestConfig } from "../requestConfig.js";
 export async function syncComponents(client, args) {
     const presets = args.presets ?? false;
-    if (args.dryRun) {
-        // minimal dry-run: compare names against remote
-        const remote = await client.sbApi.get(`spaces/${client.spaceId}/components/`, {
-            per_page: 100,
-            page: 1,
-        });
-        const remoteNames = new Set(remote.data?.components?.map((c) => c.name) ?? []);
-        const created = [];
-        const updated = [];
-        const skipped = [];
-        for (const c of args.components) {
-            const name = String(c?.name ?? "unknown");
-            if (!c?.name) {
-                skipped.push(name);
-                continue;
-            }
-            if (remoteNames.has(c.name))
-                updated.push(name);
-            else
-                created.push(name);
-        }
-        return { created, updated, skipped, errors: [] };
-    }
     return (await syncComponentsData({
         components: args.components,
         presets,
         ssot: args.ssot,
+        dryRun: args.dryRun,
         onProgress: args.onProgress,
     }, toRequestConfig(client)));
 }
 export async function syncDatasources(client, args) {
-    if (args.dryRun) {
-        const remote = await client.sbApi.get(`spaces/${client.spaceId}/datasources/`);
-        const remoteNames = new Set(remote.data?.datasources?.map((d) => d.name) ?? []);
-        const created = [];
-        const updated = [];
-        const skipped = [];
-        for (const d of args.datasources) {
-            const name = String(d?.name ?? "unknown");
-            if (!d?.name) {
-                skipped.push(name);
-                continue;
-            }
-            if (remoteNames.has(d.name))
-                updated.push(name);
-            else
-                created.push(name);
-        }
-        return { created, updated, skipped, errors: [] };
-    }
-    return (await syncDatasourcesData({ datasources: args.datasources }, toRequestConfig(client)));
+    return (await syncDatasourcesData({ datasources: args.datasources, dryRun: args.dryRun }, toRequestConfig(client)));
 }
 export async function syncRoles(client, args) {
-    if (args.dryRun) {
-        const remote = await client.sbApi.get(`spaces/${client.spaceId}/space_roles/`, {
-            per_page: 100,
-            page: 1,
-        });
-        const remoteNames = new Set(remote.data?.space_roles?.map((r) => r.role) ?? []);
-        const created = [];
-        const updated = [];
-        const skipped = [];
-        for (const r of args.roles) {
-            const name = String(r?.role ?? "unknown");
-            if (!r?.role) {
-                skipped.push(name);
-                continue;
-            }
-            if (remoteNames.has(r.role))
-                updated.push(name);
-            else
-                created.push(name);
-        }
-        return { created, updated, skipped, errors: [] };
-    }
-    return (await syncRolesData({ roles: args.roles }, toRequestConfig(client)));
+    return (await syncRolesData({ roles: args.roles, dryRun: args.dryRun }, toRequestConfig(client)));
 }
 export async function syncPlugins(client, args) {
-    if (args.dryRun) {
-        const remote = await client.sbApi.get("field_types", {
-            per_page: 100,
-            page: 1,
-        });
-        const remoteNames = new Set(remote.data?.field_types?.map((p) => p.name) ?? []);
-        const created = [];
-        const updated = [];
-        const skipped = [];
-        for (const p of args.plugins) {
-            const name = String(p?.name ?? "unknown");
-            if (!p?.name) {
-                skipped.push(name);
-                continue;
-            }
-            if (remoteNames.has(p.name))
-                updated.push(name);
-            else
-                created.push(name);
-        }
-        return { created, updated, skipped, errors: [] };
-    }
-    return (await syncPluginsData({ plugins: args.plugins }, toRequestConfig(client)));
+    return (await syncPluginsData({ plugins: args.plugins, dryRun: args.dryRun }, toRequestConfig(client)));
 }

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

@@ -1,5 +1,5 @@
 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 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 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";

package/dist/cli/cli-descriptions.js

@@ -31,6 +31,7 @@ export const syncDescription = `
     FLAGS
         --all           - Sync all components, roles, datasources                            [components, roles, datasources]
         --presets       - Pass it, if u want to sync also with presets (will take longer)    [components only]
+        --dry-run       - Preview planned changes without making writes                      [components, roles, datasources, plugins, content]
         
         --yes           - Skip ask for confirmation (dangerous, but useful in CI/CD)         [content only]
         --from          - Space ID from which you want to sync content                       [content only]
@@ -40,13 +41,16 @@ export const syncDescription = `
     
     EXAMPLES
         $ sb-mig sync components --all
+        $ sb-mig sync components --all --dry-run
         $ sb-mig sync components --all --presets
         $ sb-mig sync components accordion accordion-item
         $ sb-mig sync components accordion accordion-item --presets
         
         $ sb-mig sync roles --all
+        $ sb-mig sync roles --all --dry-run
         
         $ sb-mig sync datasources --all
+        $ sb-mig sync datasources --all --dry-run
         
         $ sb-mig sync plugins my-awesome-plugin - (you have to be in catalog which has ./dist/export.js file with compiled plugin)
         

package/dist/cli/commands/sync.js

@@ -17,6 +17,7 @@ const SYNC_COMMANDS = {
 export const sync = async (props) => {
     const { input, flags } = props;
     const command = input[1];
+    const dryRun = Boolean(flags["dryRun"]);
     const rules = {
         all: ["all"],
         assets: ["assets"],
@@ -34,6 +35,7 @@ export const sync = async (props) => {
         "presets",
         "packageName",
         "yes",
+        "dryRun",
     ]);
     switch (command) {
         case SYNC_COMMANDS.components:
@@ -41,53 +43,65 @@ export const sync = async (props) => {
             if (isIt("all")) {
                 Logger.log(`Syncing ALL components with ${storyblokConfig.schemaFileExt} extension...`);
                 const presets = flags["presets"] || false;
-                await syncAllComponents(presets, apiConfig);
-                await setComponentDefaultPreset({
-                    presets: Boolean(flags.presets),
-                    apiConfig,
-                });
+                await syncAllComponents(presets, apiConfig, { dryRun });
+                if (!dryRun) {
+                    await setComponentDefaultPreset({
+                        presets: Boolean(flags.presets),
+                        apiConfig,
+                    });
+                }
             }
             if (isIt("empty")) {
                 Logger.warning("Synchronizing PROVIDED components...");
                 const componentsToSync = unpackElements(input);
-                await syncProvidedComponents(Boolean(flags.presets), componentsToSync, flags.packageName, apiConfig);
-                await setComponentDefaultPreset({
-                    presets: Boolean(flags.presets),
-                    componentsToSync,
-                    apiConfig,
-                });
+                await syncProvidedComponents(Boolean(flags.presets), componentsToSync, flags.packageName, apiConfig, { dryRun });
+                if (!dryRun) {
+                    await setComponentDefaultPreset({
+                        presets: Boolean(flags.presets),
+                        componentsToSync,
+                        apiConfig,
+                    });
+                }
             }
             if (isIt("allWithSSOT")) {
                 Logger.warning("Synchronizing ALL components as Single Source of Truth...");
                 const presets = flags["presets"] || false;
-                await askForConfirmation("Are you sure you want to use Single Source of truth? It will remove all your components added in GUI and replace them 1 to 1 with code versions.", async () => {
-                    await removeAllComponents(apiConfig);
-                    await syncAllComponents(presets, apiConfig);
-                }, () => {
-                    Logger.success("Syncing components aborted.");
-                }, flags["yes"]);
+                if (dryRun) {
+                    await syncAllComponents(presets, apiConfig, {
+                        dryRun,
+                        ssot: true,
+                    });
+                }
+                else {
+                    await askForConfirmation("Are you sure you want to use Single Source of truth? It will remove all your components added in GUI and replace them 1 to 1 with code versions.", async () => {
+                        await removeAllComponents(apiConfig);
+                        await syncAllComponents(presets, apiConfig);
+                    }, () => {
+                        Logger.success("Syncing components aborted.");
+                    }, flags["yes"]);
+                }
             }
             break;
         case SYNC_COMMANDS.roles:
             if (isIt("all")) {
                 Logger.log("Syncing all roles...");
-                await syncAllRoles(apiConfig);
+                await syncAllRoles(apiConfig, { dryRun });
             }
             if (isIt("empty")) {
                 Logger.log("Syncing provided roles...");
                 const rolesToSync = unpackElements(input);
-                await syncProvidedRoles({ roles: rolesToSync }, apiConfig);
+                await syncProvidedRoles({ roles: rolesToSync, dryRun }, apiConfig);
             }
             break;
         case SYNC_COMMANDS.datasources:
             if (isIt("all")) {
-                Logger.log("Syncing all datasources with extension...");
-                await syncAllDatasources(apiConfig);
+                Logger.log(`${dryRun ? "[dry-run] " : ""}Syncing all datasources with extension...`);
+                await syncAllDatasources(apiConfig, { dryRun });
             }
             if (!flags["all"]) {
-                Logger.log("Syncing provided datasources with extension...");
+                Logger.log(`${dryRun ? "[dry-run] " : ""}Syncing provided datasources with extension...`);
                 const datasourcesToSync = unpackElements(input);
-                await syncProvidedDatasources({ datasources: datasourcesToSync }, apiConfig);
+                await syncProvidedDatasources({ datasources: datasourcesToSync, dryRun }, apiConfig);
             }
             break;
         case SYNC_COMMANDS.content:
@@ -107,36 +121,52 @@ export const sync = async (props) => {
             if (syncDirection) {
                 if (isIt("all")) {
                     if (syncDirection !== "fromSpaceToFile") {
-                        await askForConfirmation("Are you sure you want to delete all content (stories) in your space and then apply new ones ?", async () => {
-                            Logger.warning("Deleting all stories in your space and then applying migrated ones...");
-                            // Backup all stories to file
-                            await syncContent({
-                                type: "stories",
-                                transmission: {
-                                    from: to,
-                                    to: `${to}_stories-backup`,
-                                },
-                                syncDirection: "fromSpaceToFile",
-                            }, apiConfig);
-                            // Remove all stories from 'to' space
-                            await managementApi.stories.removeAllStories({
-                                ...apiConfig,
-                                spaceId: to,
-                            });
-                            // Sync stories from 'from' space to 'to' space
+                        if (dryRun) {
                             await syncContent({
                                 type: "stories",
                                 transmission: { from, to },
                                 syncDirection,
+                                dryRun,
                             }, apiConfig);
                             await syncContent({
                                 type: "assets",
                                 transmission: { from, to },
                                 syncDirection,
+                                dryRun,
                             }, apiConfig);
-                        }, () => {
-                            Logger.success("Stories not deleted, exiting the program...");
-                        }, flags["yes"]);
+                        }
+                        else {
+                            await askForConfirmation("Are you sure you want to delete all content (stories) in your space and then apply new ones ?", async () => {
+                                Logger.warning("Deleting all stories in your space and then applying migrated ones...");
+                                // Backup all stories to file
+                                await syncContent({
+                                    type: "stories",
+                                    transmission: {
+                                        from: to,
+                                        to: `${to}_stories-backup`,
+                                    },
+                                    syncDirection: "fromSpaceToFile",
+                                }, apiConfig);
+                                // Remove all stories from 'to' space
+                                await managementApi.stories.removeAllStories({
+                                    ...apiConfig,
+                                    spaceId: to,
+                                });
+                                // Sync stories from 'from' space to 'to' space
+                                await syncContent({
+                                    type: "stories",
+                                    transmission: { from, to },
+                                    syncDirection,
+                                }, apiConfig);
+                                await syncContent({
+                                    type: "assets",
+                                    transmission: { from, to },
+                                    syncDirection,
+                                }, apiConfig);
+                            }, () => {
+                                Logger.success("Stories not deleted, exiting the program...");
+                            }, flags["yes"]);
+                        }
                     }
                     else {
                         await syncContent({
@@ -144,11 +174,13 @@ export const sync = async (props) => {
                             transmission: { from, to },
                             syncDirection,
                             filename: flags.to,
+                            dryRun,
                         }, apiConfig);
                         await syncContent({
                             type: "assets",
                             transmission: { from, to },
                             syncDirection,
+                            dryRun,
                         }, apiConfig);
                     }
                 }
@@ -158,37 +190,48 @@ export const sync = async (props) => {
                         type: "assets",
                         transmission: { from, to },
                         syncDirection,
+                        dryRun,
                     }, apiConfig);
                 }
                 else if (isIt("stories")) {
                     Logger.warning(`Syncing using sync direction: ${syncDirection}`);
                     if (syncDirection !== "fromSpaceToFile") {
-                        await askForConfirmation("Are you sure you want to delete all stories in your space and then apply new ones ?", async () => {
-                            Logger.warning("Deleting all stories in your space and then applying test ones...");
-                            // Backup all stories to file
-                            await syncContent({
-                                type: "stories",
-                                transmission: {
-                                    from: to,
-                                    to: `${to}_stories-backup`,
-                                },
-                                syncDirection: "fromSpaceToFile",
-                            }, apiConfig);
-                            // Remove all stories from 'to' space
-                            await managementApi.stories.removeAllStories({
-                                ...apiConfig,
-                                spaceId: to,
-                            });
-                            //
-                            // Sync stories to 'to' space
+                        if (dryRun) {
                             await syncContent({
                                 type: "stories",
                                 transmission: { from, to },
                                 syncDirection,
+                                dryRun,
                             }, apiConfig);
-                        }, () => {
-                            Logger.success("Stories not deleted, exiting the program...");
-                        }, flags["yes"]);
+                        }
+                        else {
+                            await askForConfirmation("Are you sure you want to delete all stories in your space and then apply new ones ?", async () => {
+                                Logger.warning("Deleting all stories in your space and then applying test ones...");
+                                // Backup all stories to file
+                                await syncContent({
+                                    type: "stories",
+                                    transmission: {
+                                        from: to,
+                                        to: `${to}_stories-backup`,
+                                    },
+                                    syncDirection: "fromSpaceToFile",
+                                }, apiConfig);
+                                // Remove all stories from 'to' space
+                                await managementApi.stories.removeAllStories({
+                                    ...apiConfig,
+                                    spaceId: to,
+                                });
+                                //
+                                // Sync stories to 'to' space
+                                await syncContent({
+                                    type: "stories",
+                                    transmission: { from, to },
+                                    syncDirection,
+                                }, apiConfig);
+                            }, () => {
+                                Logger.success("Stories not deleted, exiting the program...");
+                            }, flags["yes"]);
+                        }
                     }
                     else {
                         // Sync stories to 'to' space
@@ -196,6 +239,7 @@ export const sync = async (props) => {
                             type: "stories",
                             transmission: { from, to },
                             syncDirection,
+                            dryRun,
                         }, apiConfig);
                     }
                 }
@@ -216,6 +260,7 @@ export const sync = async (props) => {
                 const pluginsToSync = unpackElements(input);
                 await managementApi.plugins.syncProvidedPlugins({
                     plugins: pluginsToSync,
+                    dryRun,
                 }, apiConfig);
             }
             break;

package/dist/cli/datasources/sync.js

@@ -1,7 +1,7 @@
 import { managementApi } from "../../api/managementApi.js";
 import { compare, discoverDatasources, discoverManyDatasources, LOOKUP_TYPE, SCOPE, } from "../utils/discover.js";
 export const syncProvidedDatasources = async (args, config) => {
-    const { datasources } = args;
+    const { datasources, dryRun } = args;
     const allLocalDatasources = await discoverManyDatasources({
         scope: SCOPE.local,
         type: LOOKUP_TYPE.fileName,
@@ -19,9 +19,11 @@ export const syncProvidedDatasources = async (args, config) => {
     });
     await managementApi.datasources.syncDatasources({
         providedDatasources: [...local, ...external],
+        dryRun,
     }, config);
 };
-export const syncAllDatasources = async (config) => {
+export const syncAllDatasources = async (config, args = {}) => {
+    const { dryRun } = args;
     const allLocalDatasources = await discoverDatasources({
         scope: SCOPE.local,
         type: LOOKUP_TYPE.fileName,
@@ -36,5 +38,6 @@ export const syncAllDatasources = async (config) => {
     });
     await managementApi.datasources.syncDatasources({
         providedDatasources: [...local, ...external],
+        dryRun,
     }, config);
 };

package/dist/cli/roles/sync.js

@@ -1,6 +1,6 @@
 import { managementApi } from "../../api/managementApi.js";
 import { compare, discoverManyRoles, discoverRoles, LOOKUP_TYPE, SCOPE, } from "../utils/discover.js";
-export const syncAllRoles = async (config) => {
+export const syncAllRoles = async (config, options = {}) => {
     // #1: discover all external .roles.sb.js files
     const allLocalSbComponentsSchemaFiles = await discoverRoles({
         scope: SCOPE.local,
@@ -17,9 +17,9 @@ export const syncAllRoles = async (config) => {
         external: allExternalSbComponentsSchemaFiles,
     });
     // #4: sync - do all stuff already done (groups resolving, and so on)
-    await managementApi.roles.syncRoles({ specifiedRoles: [...local, ...external] }, config);
+    await managementApi.roles.syncRoles({ specifiedRoles: [...local, ...external], dryRun: options.dryRun }, config);
 };
-export const syncProvidedRoles = async ({ roles }, config) => {
+export const syncProvidedRoles = async ({ roles, dryRun }, config) => {
     // #1: discover all external .sb.js files
     const allLocalSbComponentsSchemaFiles = await discoverManyRoles({
         scope: SCOPE.local,
@@ -38,5 +38,5 @@ export const syncProvidedRoles = async ({ roles }, config) => {
         external: allExternalSbComponentsSchemaFiles,
     });
     // #4: sync - do all stuff already done (groups resolving, and so on)
-    await managementApi.roles.syncRoles({ specifiedRoles: [...local, ...external] }, config);
+    await managementApi.roles.syncRoles({ specifiedRoles: [...local, ...external], dryRun }, config);
 };