sb-mig 6.0.0 → 6.1.0-beta.1

package/dist/api/contentHubApi.js

@@ -1,15 +1,25 @@
 import Logger from "../utils/logger.js";
+import { buildUrl } from "../utils/url-utils.js";
 const getAllStories = async (args, config) => {
     const { spaceId, storiesFilename } = args;
     Logger.warning("Trying to get all stories from Content Hub...");
-    const queryParams = `spaceId=${spaceId}&storiesFilename=${storiesFilename}`;
-    const url = `${config.contentHubOriginUrl}/getStories?${queryParams}`;
+    if (!config.contentHubOriginUrl) {
+        throw new Error("contentHubOriginUrl is required to fetch stories.");
+    }
+    const url = buildUrl({
+        baseUrl: config.contentHubOriginUrl,
+        pathname: "getStories",
+        searchParams: {
+            spaceId,
+            ...(storiesFilename ? { storiesFilename } : {}),
+        },
+    });
     const authorizationToken = config.contentHubAuthorizationToken;
     if (config.debug) {
-        console.log("This is url: ", url);
+        console.log("This is url: ", url.toString());
     }
     try {
-        const response = await fetch(url, {
+        const response = await fetch(url.toString(), {
             method: "GET",
             headers: {
                 Authorization: authorizationToken,

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

@@ -48,6 +48,7 @@ interface MigrateItems {
     publishLanguages?: PublishLanguagesOption;
     fromFilePath?: string;
     fileName?: string;
+    languagePublishStatePath?: string;
     preparedMigrationConfigs?: PreparedMigrationConfig[];
 }
 export type MapperDefinition = (data: any) => any;
@@ -70,8 +71,8 @@ export declare const runMigrationPipelineInMemory: ({ itemType, itemsToMigrate,
     itemsToMigrate: any[];
     preparedMigrationConfigs: PreparedMigrationConfig[];
 }) => MigrationPipelineResult;
-export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
-export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, fileName, }: {
+export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, languagePublishStatePath, migrationComponentAliases, migrationComponentOverrides, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
+export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, fileName, languagePublishStatePath, }: {
     itemType?: "story" | "preset";
     from: string;
     itemsToMigrate: any[];
@@ -84,6 +85,7 @@ export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migratio
     migrateFrom: MigrateFrom;
     fromFilePath?: string;
     fileName?: string;
+    languagePublishStatePath?: string;
 }, config: RequestBaseConfig) => Promise<void>;
-export declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
+export declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, languagePublishStatePath, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
 export {};

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

@@ -7,6 +7,7 @@ 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 { loadLanguagePublishStateMap } from "../stories/language-publish-state.js";
 import { buildPreMigrationBackupBaseName, resolveOutputFileBaseName, shouldUseDatestampForArtifacts, } from "./file-naming.js";
 import { extendMigrationMapperWithAliases, resolveMigrationComponentsToMigrate, } from "./migration-component-scope.js";
 import { saveMigrationRunLog } from "./migration-run-log.js";
@@ -295,7 +296,7 @@ export const runMigrationPipelineInMemory = ({ itemType, itemsToMigrate, prepare
         totalItems: workingItems.length,
     };
 };
-const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemType, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, pipelineResult, }, config) => {
+const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemType, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, }, config) => {
     await createAndSaveToFile({
         datestamp: useDatestamp,
         ext: "json",
@@ -307,6 +308,7 @@ const savePipelineSummary = async ({ artifactBaseName, useDatestamp, from, itemT
                 migrateFrom,
                 from,
                 fromFilePath: fromFilePath || null,
+                languagePublishStatePath: languagePublishStatePath || null,
             },
             writeMode: itemType === "story" && publish ? "publish" : "save",
             publishLanguages: itemType === "story" && publish
@@ -384,7 +386,7 @@ const loadItemsToMigrate = async ({ itemType, migrateFrom, from, filters, fromFi
         spaceId: from,
     });
 };
-export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, migrationComponentAliases, migrationComponentOverrides, }, config) => {
+export const migrateAllComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, languagePublishStatePath, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     Logger.warning(`Trying to migrate all ${itemType} from ${migrateFrom}, ${from} to ${to}...`);
     const preparedMigrationConfigs = prepareMigrationConfigs({
         migrationConfig,
@@ -407,10 +409,11 @@ export const migrateAllComponentsDataInStories = async ({ itemType, migrationCon
         publishLanguages,
         fromFilePath,
         fileName,
+        languagePublishStatePath,
         preparedMigrationConfigs,
     }, config);
 };
-export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, fileName, }, config) => {
+export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publish, publishLanguages, migrateFrom, fromFilePath, fileName, languagePublishStatePath, }, config) => {
     const preparedMigrationConfigs = migrationConfigs ||
         prepareMigrationConfigs({
             migrationConfig: migrationConfig || [],
@@ -484,6 +487,7 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         publishLanguages,
         migrateFrom,
         fromFilePath,
+        languagePublishStatePath,
         pipelineResult,
     }, config);
     if (dryRun) {
@@ -500,6 +504,9 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
     }
     let writeResults = [];
     let resolvedPublishLanguages;
+    const languagePublishStateMap = languagePublishStatePath
+        ? loadLanguagePublishStateMap(languagePublishStatePath)
+        : undefined;
     if (itemType === "story") {
         if (publish && publishLanguages !== undefined) {
             resolvedPublishLanguages =
@@ -515,6 +522,7 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
                 publish: Boolean(publish),
                 publishLanguages: resolvedPublishLanguages,
                 preservePublishState: Boolean(publish),
+                languagePublishStateMap,
             },
         }, config);
     }
@@ -539,6 +547,7 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
             resolvedPublishLanguages,
             migrateFrom,
             fromFilePath,
+            languagePublishStatePath,
             pipelineResult,
             writeResults,
             writeSummary,
@@ -570,7 +579,7 @@ const saveBackupToFile = async ({ itemType, res, folder, filename }, config) =>
         res: res,
     }, config);
 };
-export const migrateProvidedComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }, config) => {
+export const migrateProvidedComponentsDataInStories = async ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publish, publishLanguages, fromFilePath, fileName, languagePublishStatePath, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }, config) => {
     const resolvedMigrationConfigs = preparedMigrationConfigs ||
         prepareMigrationConfigs({
             migrationConfig,
@@ -610,5 +619,6 @@ export const migrateProvidedComponentsDataInStories = async ({ itemType, migrati
         migrateFrom,
         fromFilePath,
         fileName,
+        languagePublishStatePath,
     }, config);
 };

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

@@ -12,6 +12,7 @@ export interface MigrationRunLogRecord {
         migrateFrom: MigrateFrom;
         from: string;
         fromFilePath: string | null;
+        languagePublishStatePath?: string | null;
     };
     target: {
         to: string;
@@ -67,11 +68,12 @@ interface SaveMigrationRunLogArgs {
     resolvedPublishLanguages?: string[];
     migrateFrom: MigrateFrom;
     fromFilePath?: string;
+    languagePublishStatePath?: string;
     pipelineResult: MigrationPipelineResult;
     writeResults: PromiseSettledResult<MutationWriteResult>[];
     writeSummary: MutationWriteSummary;
 }
-export declare const buildMigrationRunLogRecords: ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, pipelineResult, writeResults, writeSummary, }: Omit<SaveMigrationRunLogArgs, "artifactBaseName" | "useDatestamp">) => MigrationRunLogRecord[];
+export declare const buildMigrationRunLogRecords: ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, 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

@@ -31,7 +31,7 @@ const resolveWriteResultValue = (result) => {
         error: result.reason,
     };
 };
-export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, pipelineResult, writeResults, writeSummary, }) => {
+export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, writeResults, writeSummary, }) => {
     const timestamp = new Date().toISOString();
     const runId = `${itemType}-${timestamp}`;
     const baseRecord = {
@@ -42,6 +42,7 @@ export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publis
             migrateFrom,
             from,
             fromFilePath: fromFilePath || null,
+            languagePublishStatePath: languagePublishStatePath || null,
         },
         target: {
             to,

package/dist/api/managementApi.d.ts

@@ -1,3 +1,4 @@
+import * as stories from "./stories/index.js";
 export declare const managementApi: {
     assets: {
         getAllAssets: import("./assets/assets.types.js").GetAllAssets;
@@ -77,6 +78,19 @@ export declare const managementApi: {
         removeAllStories: import("./stories/stories.types.js").RemoveAllStories;
         upsertStory: import("./stories/stories.types.js").UpsertStory;
         backupStories: import("./stories/stories.types.js").BackupStories;
+        buildLanguagePublishStateMap: (args: import("./stories/language-publish-state.js").BuildLanguagePublishStateMapArgs, config: import("./utils/request.js").RequestBaseConfig) => Promise<{
+            generatedAt: string;
+            source: {
+                spaceId: string;
+                startsWith: string | null;
+                withSlug: string[] | null;
+            };
+            languages: string[];
+            storyCount: number;
+            statesByLanguage: Record<string, any>;
+            stories: any;
+        }>;
+        loadLanguagePublishStateMap: (languagePublishStatePath: string) => stories.LanguagePublishStateMap;
     };
     spaces: {
         getAllSpaces: import("./spaces/spaces.types.js").GetAllSpaces;

package/dist/api/stories/index.d.ts

@@ -1,2 +1,4 @@
 export { createStory, updateStory, getStoryById, removeStory, getStoryBySlug, updateStories, publishStoryLanguages, parsePublishLanguagesOption, resolvePublishLanguageCodes, getAllStories, removeAllStories, upsertStory, } from "./stories.js";
 export { backupStories } from "./backup.js";
+export { buildLanguagePublishStateMap, loadLanguagePublishStateMap, } from "./language-publish-state.js";
+export type { LanguagePublishState, LanguagePublishStateMap, LanguagePublishStateMapEntry, } from "./language-publish-state.js";

package/dist/api/stories/index.js

@@ -1,2 +1,3 @@
 export { createStory, updateStory, getStoryById, removeStory, getStoryBySlug, updateStories, publishStoryLanguages, parsePublishLanguagesOption, resolvePublishLanguageCodes, getAllStories, removeAllStories, upsertStory, } from "./stories.js";
 export { backupStories } from "./backup.js";
+export { buildLanguagePublishStateMap, loadLanguagePublishStateMap, } from "./language-publish-state.js";

package/dist/api/stories/language-publish-state.d.ts

@@ -0,0 +1,48 @@
+import type { RequestBaseConfig } from "../utils/request.js";
+export type LanguagePublishState = "published_clean" | "published_with_unpublished_changes" | "draft_never_published" | "unpublished_historical" | "draft_or_unpublished" | "missing" | "published_unknown" | "error";
+export interface BuildLanguagePublishStateMapArgs {
+    from: string;
+    accessToken?: string;
+    languages?: string;
+    startsWith?: string;
+    withSlug?: string[];
+    fileName?: string;
+    outputPath?: string;
+}
+export interface LanguagePublishStateMapEntry {
+    id?: number | string;
+    uuid?: string;
+    name?: string;
+    fullSlug?: string;
+    languages?: Record<string, {
+        state?: LanguagePublishState;
+        [key: string]: unknown;
+    }>;
+    cleanPublishedLanguages?: string[];
+    [key: string]: unknown;
+}
+export interface LanguagePublishStateMap {
+    generatedAt?: string;
+    source?: {
+        spaceId?: string;
+        startsWith?: string | null;
+        withSlug?: string[] | null;
+    };
+    languages?: string[];
+    storyCount?: number;
+    statesByLanguage?: Record<string, Record<string, number>>;
+    stories?: Record<string, LanguagePublishStateMapEntry>;
+}
+export declare const loadLanguagePublishStateMap: (languagePublishStatePath: string) => LanguagePublishStateMap;
+export declare const buildLanguagePublishStateMap: (args: BuildLanguagePublishStateMapArgs, config: RequestBaseConfig) => Promise<{
+    generatedAt: string;
+    source: {
+        spaceId: string;
+        startsWith: string | null;
+        withSlug: string[] | null;
+    };
+    languages: string[];
+    storyCount: number;
+    statesByLanguage: Record<string, any>;
+    stories: any;
+}>;

package/dist/api/stories/language-publish-state.js

@@ -0,0 +1,230 @@
+import { createHash } from "crypto";
+import fs from "fs";
+import path from "path";
+import { mapWithConcurrency } from "../../utils/async-utils.js";
+import { createAndSaveToFile } from "../../utils/files.js";
+import Logger from "../../utils/logger.js";
+import { getAllStories, getStoryBySlug } from "./stories.js";
+const DEFAULT_LANGUAGE = "[default]";
+const DELIVERY_CHECK_CONCURRENCY = 5;
+const cleanStoryblokContent = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(cleanStoryblokContent);
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.keys(value)
+            .filter((key) => key !== "_editable")
+            .sort()
+            .map((key) => [key, cleanStoryblokContent(value[key])]));
+    }
+    return value;
+};
+const hashContent = (value) => createHash("sha256")
+    .update(JSON.stringify(cleanStoryblokContent(value)))
+    .digest("hex");
+const normalizeLanguages = (languages) => {
+    if (!languages || languages.trim().length === 0) {
+        return "all";
+    }
+    if (languages.trim().toLowerCase() === "all") {
+        return "all";
+    }
+    const normalized = languages
+        .split(",")
+        .map((language) => language.trim())
+        .filter(Boolean)
+        .map((language) => language.toLowerCase() === "default" ? DEFAULT_LANGUAGE : language);
+    return Array.from(new Set(normalized));
+};
+const readSpaceLanguageCodes = (spaceResponse) => {
+    const space = spaceResponse?.data?.space || spaceResponse?.space || {};
+    const languages = space.languages;
+    if (!Array.isArray(languages)) {
+        return [];
+    }
+    return languages
+        .map((language) => typeof language === "string" ? language : language?.code)
+        .filter((language) => Boolean(language));
+};
+const resolveLanguages = async (languages, config) => {
+    const normalized = normalizeLanguages(languages);
+    if (normalized !== "all") {
+        return normalized;
+    }
+    const response = await config.sbApi.get(`spaces/${config.spaceId}`);
+    return [DEFAULT_LANGUAGE, ...readSpaceLanguageCodes(response)];
+};
+const classifyDefaultLanguageState = (story) => {
+    if (story?.published === true && story?.unpublished_changes === false) {
+        return "published_clean";
+    }
+    if (story?.published === true && story?.unpublished_changes === true) {
+        return "published_with_unpublished_changes";
+    }
+    if (story?.published === false && story?.published_at) {
+        return "unpublished_historical";
+    }
+    if (story?.published === false) {
+        return "draft_never_published";
+    }
+    return "published_unknown";
+};
+const classifyTranslatedLanguageState = ({ published, draft, }) => {
+    if (published.status === 200 && draft.status === 200) {
+        if (!published.contentHash || !draft.contentHash) {
+            return "published_unknown";
+        }
+        return published.contentHash === draft.contentHash
+            ? "published_clean"
+            : "published_with_unpublished_changes";
+    }
+    if (published.status === 404 && draft.status === 200) {
+        return "draft_or_unpublished";
+    }
+    if (published.status === 404 && draft.status === 404) {
+        return "missing";
+    }
+    if (published.status === 200) {
+        return "published_unknown";
+    }
+    return "error";
+};
+const fetchDeliveryStory = async ({ deliveryApiUrl, accessToken, slug, version, language, }) => {
+    const url = new URL(`${deliveryApiUrl.replace(/\/$/, "")}/cdn/stories/${slug}`);
+    url.searchParams.set("token", accessToken);
+    url.searchParams.set("version", version);
+    url.searchParams.set("cv", String(Date.now()));
+    if (language && language !== DEFAULT_LANGUAGE) {
+        url.searchParams.set("language", language);
+    }
+    const response = await fetch(url);
+    const data = await response.json().catch(() => null);
+    const story = data?.story;
+    return {
+        status: response.status,
+        ok: response.ok,
+        fullSlug: story?.full_slug || null,
+        publishedAt: story?.published_at || null,
+        contentHash: story?.content ? hashContent(story.content) : null,
+    };
+};
+const loadStoriesForLanguageState = async ({ startsWith, withSlug, }, config) => {
+    if (withSlug && withSlug.length > 0) {
+        const stories = await Promise.all(withSlug.map((slug) => getStoryBySlug(slug, config)));
+        return stories.filter(Boolean);
+    }
+    if (startsWith) {
+        return getAllStories({ options: { starts_with: startsWith } }, config);
+    }
+    return getAllStories({}, config);
+};
+export const loadLanguagePublishStateMap = (languagePublishStatePath) => {
+    const resolvedPath = path.isAbsolute(languagePublishStatePath)
+        ? languagePublishStatePath
+        : path.resolve(process.cwd(), languagePublishStatePath);
+    const fileContent = fs.readFileSync(resolvedPath, "utf8");
+    const parsed = JSON.parse(fileContent);
+    if (!parsed || typeof parsed !== "object" || !parsed.stories) {
+        throw new Error(`Language publish-state file '${languagePublishStatePath}' is missing a stories map.`);
+    }
+    return parsed;
+};
+export const buildLanguagePublishStateMap = async (args, config) => {
+    const accessToken = args.accessToken || config.accessToken;
+    if (!args.from) {
+        throw new Error("--from is required.");
+    }
+    if (!accessToken) {
+        throw new Error("--accessToken is required when config accessToken is empty.");
+    }
+    const sourceConfig = { ...config, spaceId: args.from };
+    const deliveryApiUrl = config.storyblokDeliveryApiUrl || "https://api.storyblok.com/v2";
+    const languages = await resolveLanguages(args.languages, sourceConfig);
+    const uniqueLanguages = Array.from(new Set(languages));
+    const stories = (await loadStoriesForLanguageState({
+        startsWith: args.startsWith,
+        withSlug: args.withSlug,
+    }, sourceConfig)).filter((item) => item?.story && item.story.is_folder !== true);
+    Logger.success(`Fetched ${stories.length} source stories from space '${args.from}'.`);
+    const storyEntries = await mapWithConcurrency(stories, DELIVERY_CHECK_CONCURRENCY, async (item) => {
+        const story = item.story;
+        const languagesByCode = {};
+        for (const language of uniqueLanguages) {
+            if (language === DEFAULT_LANGUAGE) {
+                languagesByCode[language] = {
+                    state: classifyDefaultLanguageState(story),
+                    source: "management",
+                    published: story.published,
+                    unpublishedChanges: story.unpublished_changes,
+                    publishedAt: story.published_at || null,
+                    firstPublishedAt: story.first_published_at || null,
+                };
+                continue;
+            }
+            const [published, draft] = await Promise.all([
+                fetchDeliveryStory({
+                    deliveryApiUrl,
+                    accessToken,
+                    slug: story.full_slug,
+                    version: "published",
+                    language,
+                }),
+                fetchDeliveryStory({
+                    deliveryApiUrl,
+                    accessToken,
+                    slug: story.full_slug,
+                    version: "draft",
+                    language,
+                }),
+            ]);
+            languagesByCode[language] = {
+                state: classifyTranslatedLanguageState({
+                    published,
+                    draft,
+                }),
+                source: "delivery",
+                published,
+                draft,
+            };
+        }
+        return {
+            id: story.id,
+            uuid: story.uuid,
+            name: story.name,
+            fullSlug: story.full_slug,
+            languages: languagesByCode,
+            cleanPublishedLanguages: Object.entries(languagesByCode)
+                .filter(([, value]) => value.state === "published_clean")
+                .map(([language]) => language),
+        };
+    });
+    const result = {
+        generatedAt: new Date().toISOString(),
+        source: {
+            spaceId: args.from,
+            startsWith: args.startsWith || null,
+            withSlug: args.withSlug || null,
+        },
+        languages: uniqueLanguages,
+        storyCount: storyEntries.length,
+        statesByLanguage: uniqueLanguages.reduce((acc, language) => {
+            acc[language] = storyEntries.reduce((stateAcc, story) => {
+                const state = story.languages[language]?.state || "missing";
+                stateAcc[state] = (stateAcc[state] || 0) + 1;
+                return stateAcc;
+            }, {});
+            return acc;
+        }, {}),
+        stories: Object.fromEntries(storyEntries.map((story) => [story.fullSlug, story])),
+    };
+    await createAndSaveToFile({
+        ext: "json",
+        datestamp: !args.fileName && !args.outputPath,
+        filename: args.fileName || `${args.from}---language-publish-state-map`,
+        folder: "language-publish-state",
+        path: args.outputPath,
+        res: result,
+    }, config);
+    Logger.success(`Language publish-state map created for ${storyEntries.length} stories.`);
+    return result;
+};

package/dist/api/stories/stories.js

@@ -121,6 +121,31 @@ export const resolvePublishLanguageCodes = async (publishLanguages, config) => {
         ...spaceLanguageCodes,
     ]);
 };
+const isPublishLanguageStateClean = (languagePublishStateMap, story, language) => {
+    const storyEntry = languagePublishStateMap?.stories?.[story.full_slug];
+    const languageState = storyEntry?.languages?.[language]?.state;
+    if (!languageState) {
+        return undefined;
+    }
+    return languageState === "published_clean";
+};
+const resolvePublishLanguagesForStory = ({ story, publishState, publishLanguages, languagePublishStateMap, }) => {
+    if (!languagePublishStateMap) {
+        return publishState && !publishState.shouldPublish
+            ? []
+            : publishLanguages;
+    }
+    return publishLanguages.filter((language) => {
+        if (language === DEFAULT_PUBLISH_LANGUAGE) {
+            return !publishState || publishState.shouldPublish;
+        }
+        const languageStateAllowsPublish = isPublishLanguageStateClean(languagePublishStateMap, story, language);
+        if (languageStateAllowsPublish !== undefined) {
+            return languageStateAllowsPublish;
+        }
+        return !publishState || publishState.shouldPublish;
+    });
+};
 const resolveStoryblokErrorResponse = (err) => {
     if (typeof err?.response === "string" && err.response.trim().length > 0) {
         return err.response.trim();
@@ -348,33 +373,47 @@ export const updateStories = async (args, config) => {
         const publishState = shouldPreservePublishState
             ? resolveStoryPublishState(story)
             : undefined;
+        const storyPublishLanguages = publishLanguages
+            ? resolvePublishLanguagesForStory({
+                story,
+                publishState,
+                publishLanguages,
+                languagePublishStateMap: options.languagePublishStateMap,
+            })
+            : undefined;
         const shouldPublishStory = options.publish &&
-            (!publishState || publishState.shouldPublish);
+            (!publishState || publishState.shouldPublish) &&
+            (!shouldPublishLanguages ||
+                storyPublishLanguages?.includes(DEFAULT_PUBLISH_LANGUAGE));
         const updateResult = await updateStory(story, story.id, {
             publish: shouldPublishStory && !shouldPublishLanguages,
             force_update: options.force_update,
         }, { ...config, spaceId });
         if (options.publish &&
             updateResult?.ok &&
-            isSkippedStoryPublishState(publishState)) {
+            isSkippedStoryPublishState(publishState) &&
+            (!storyPublishLanguages || storyPublishLanguages.length === 0)) {
             return withSkippedPublish({
                 updateResult,
                 story,
                 storyId: story.id,
                 spaceId,
-                publishLanguages,
+                publishLanguages: options.languagePublishStateMap
+                    ? storyPublishLanguages
+                    : publishLanguages,
                 publishState,
             });
         }
         if (!shouldPublishLanguages ||
-            !publishLanguages ||
+            !storyPublishLanguages ||
+            storyPublishLanguages.length === 0 ||
             !updateResult?.ok) {
             return updateResult;
         }
         return publishStoryLanguages({
             storyId: story.id,
             story,
-            languages: publishLanguages,
+            languages: storyPublishLanguages,
         }, { ...config, spaceId });
     }));
 };

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

@@ -8,8 +8,19 @@ interface ModifyStoryOptions {
     force_update?: boolean;
     publishLanguages?: PublishLanguagesOption;
     preservePublishState?: boolean;
+    languagePublishStateMap?: LanguagePublishStateMap;
 }
 export type PublishLanguagesOption = "default" | "all" | string[];
+export interface LanguagePublishStateMap {
+    stories?: Record<string, {
+        languages?: Record<string, {
+            state?: string;
+            [key: string]: unknown;
+        }>;
+        cleanPublishedLanguages?: string[];
+        [key: string]: unknown;
+    }>;
+}
 export type RemoveStory = (args: {
     storyId: string;
 }, config: RequestBaseConfig) => Promise<any>;

package/dist/api/testApi.d.ts

@@ -1,3 +1,4 @@
+import * as stories from "./stories/index.js";
 export declare const testApi: {
     assets: {
         getAllAssets: import("./assets/assets.types.js").GetAllAssets;
@@ -77,6 +78,19 @@ export declare const testApi: {
         removeAllStories: import("./stories/stories.types.js").RemoveAllStories;
         upsertStory: import("./stories/stories.types.js").UpsertStory;
         backupStories: import("./stories/stories.types.js").BackupStories;
+        buildLanguagePublishStateMap: (args: import("./stories/language-publish-state.js").BuildLanguagePublishStateMapArgs, config: import("./utils/request.js").RequestBaseConfig) => Promise<{
+            generatedAt: string;
+            source: {
+                spaceId: string;
+                startsWith: string | null;
+                withSlug: string[] | null;
+            };
+            languages: string[];
+            storyCount: number;
+            statesByLanguage: Record<string, any>;
+            stories: any;
+        }>;
+        loadLanguagePublishStateMap: (languagePublishStatePath: string) => stories.LanguagePublishStateMap;
     };
     spaces: {
         getAllSpaces: import("./spaces/spaces.types.js").GetAllSpaces;

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

@@ -1,7 +1,8 @@
-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 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        language-publish-state\n                  Build a read-only Storyblok story language publish-state map.\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 languagePublishStateDescription = "\n    Usage\n        $ sb-mig language-publish-state --from [spaceId]\n\n    Description\n        Read stories from a source Storyblok space and write a JSON map of default and translated language publication states.\n        This command is read-only against Storyblok. It uses Management API for story listing and default-language state, and Delivery API for translated language published/draft comparisons.\n\n    FLAGS\n        --from            - Source space ID to inspect\n        --accessToken     - Optional source space Delivery API access token override. Falls back to configured accessToken.\n        --languages       - Languages to inspect: all, default,fr,de. Default: all\n        --withSlug        - Exact story full_slug to inspect. Can be repeated.\n        --startsWith      - Filter stories by starts_with prefix\n        --fileName        - Stable output base name under sbmig/language-publish-state\n        --outputPath      - Explicit output path for the generated JSON file\n\n    EXAMPLES\n        $ sb-mig language-publish-state --from 12345 --startsWith about-ef --languages all --fileName about-ef-prod\n        $ sb-mig language-publish-state --from 12345 --accessToken xxx --withSlug about-ef/testimonials --languages default,fr\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        --publish         - Publish changed stories after migration only if they were clean-published before migration. Default: save draft. [content only]\n        --publishLanguages - Languages to publish when --publish is set. Values: default, all, or comma-separated Storyblok language codes. Skips stories that were draft-only or had unpublished changes before migration. [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 file-with-migration --publish --publishLanguages all --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publish --publishLanguages default,fr,de --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 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 after migration only if they were clean-published before migration. Default: save draft. [content only]\n        --publishLanguages - Languages to publish when --publish is set. Values: default, all, or comma-separated Storyblok language codes. Skips stories that were draft-only or had unpublished changes before migration. [content only]\n        --languagePublishStatePath - JSON file generated by 'language-publish-state'. Matching non-default language entries override language publishing; missing entries fall back to normal publish behavior. [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 file-with-migration --publish --publishLanguages all --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publish --publishLanguages all --languagePublishStatePath sbmig/language-publish-state/prod-language-state.json --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publish --publishLanguages default,fr,de --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

@@ -7,6 +7,8 @@ export const mainDescription = `
         discover  Discover components, migration configs and write to file or stdout.
         backup    Command for backing up anything related to Storyblok
         migrate   Migrate content from space to space, or from file to space.
+        language-publish-state
+                  Build a read-only Storyblok story language publish-state map.
         debug     Output extra debugging information
         help      This screen
     
@@ -14,6 +16,27 @@ export const mainDescription = `
       $ sb-mig sync components --all
       $ sb-mig debug  
 `;
+export const languagePublishStateDescription = `
+    Usage
+        $ sb-mig language-publish-state --from [spaceId]
+
+    Description
+        Read stories from a source Storyblok space and write a JSON map of default and translated language publication states.
+        This command is read-only against Storyblok. It uses Management API for story listing and default-language state, and Delivery API for translated language published/draft comparisons.
+
+    FLAGS
+        --from            - Source space ID to inspect
+        --accessToken     - Optional source space Delivery API access token override. Falls back to configured accessToken.
+        --languages       - Languages to inspect: all, default,fr,de. Default: all
+        --withSlug        - Exact story full_slug to inspect. Can be repeated.
+        --startsWith      - Filter stories by starts_with prefix
+        --fileName        - Stable output base name under sbmig/language-publish-state
+        --outputPath      - Explicit output path for the generated JSON file
+
+    EXAMPLES
+        $ sb-mig language-publish-state --from 12345 --startsWith about-ef --languages all --fileName about-ef-prod
+        $ sb-mig language-publish-state --from 12345 --accessToken xxx --withSlug about-ef/testimonials --languages default,fr
+`;
 export const syncDescription = `
     Usage
         $ sb-mig sync [components|roles|datasources|plugins|content] [space separated file names] or --all
@@ -100,6 +123,7 @@ export const migrateDescription = `
         --dry-run         - Preview what would be migrated without making any API changes
         --publish         - Publish changed stories after migration only if they were clean-published before migration. Default: save draft. [content only]
         --publishLanguages - Languages to publish when --publish is set. Values: default, all, or comma-separated Storyblok language codes. Skips stories that were draft-only or had unpublished changes before migration. [content only]
+        --languagePublishStatePath - JSON file generated by 'language-publish-state'. Matching non-default language entries override language publishing; missing entries fall back to normal publish behavior. [content only]
         --fileName        - Stable base name for migration output files (disables timestamp suffix for migration artifacts)
 
     EXAMPLES
@@ -111,6 +135,7 @@ export const migrateDescription = `
         $ 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 file-with-migration --publish --publishLanguages all --yes
+        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publish --publishLanguages all --languagePublishStatePath sbmig/language-publish-state/prod-language-state.json --yes
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publish --publishLanguages default,fr,de --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

package/dist/cli/commands/init.js

@@ -4,6 +4,7 @@ import { v4 as uuidv4 } from "uuid";
 import { managementApi } from "../../api/managementApi.js";
 import { storyblokApiMapping } from "../../config/constants.js";
 import Logger from "../../utils/logger.js";
+import { buildUrl } from "../../utils/url-utils.js";
 import { apiConfig } from "../api-config.js";
 const INIT_COMMANDS = {
     project: "project",
@@ -59,10 +60,18 @@ export const init = async (props) => {
                 console.log(e);
             }
             try {
+                const previewDomainUrl = buildUrl({
+                    baseUrl: "https://localhost:3000",
+                    pathname: "api/preview/preview",
+                    searchParams: {
+                        secret: STORYBLOK_PREVIEW_SECRET,
+                        slug: "",
+                    },
+                });
                 await managementApi.spaces.updateSpace({
                     spaceId,
                     params: {
-                        domain: `https://localhost:3000/api/preview/preview?secret=${STORYBLOK_PREVIEW_SECRET}&slug=`,
+                        domain: previewDomainUrl.toString(),
                     },
                 }, { ...apiConfig, sbApi: localSbApi });
                 Logger.success("Successfully updated space domain");

package/dist/cli/commands/language-publish-state.d.ts

@@ -0,0 +1,2 @@
+import type { CLIOptions } from "../../utils/interfaces.js";
+export declare const languagePublishState: ({ flags }: CLIOptions) => Promise<void>;

package/dist/cli/commands/language-publish-state.js

@@ -0,0 +1,19 @@
+import { managementApi } from "../../api/managementApi.js";
+import { apiConfig } from "../api-config.js";
+export const languagePublishState = async ({ flags }) => {
+    const withSlugFlag = flags["withSlug"];
+    const withSlug = Array.isArray(withSlugFlag)
+        ? withSlugFlag
+        : withSlugFlag
+            ? [withSlugFlag]
+            : undefined;
+    await managementApi.stories.buildLanguagePublishStateMap({
+        from: flags["from"],
+        accessToken: flags["accessToken"],
+        languages: flags["languages"],
+        startsWith: flags["startsWith"],
+        withSlug,
+        fileName: flags["fileName"],
+        outputPath: flags["outputPath"],
+    }, apiConfig);
+};

package/dist/cli/commands/migrate.js

@@ -44,6 +44,7 @@ export const migrate = async (props) => {
         "dryRun",
         "publish",
         "publishLanguages",
+        "languagePublishStatePath",
         "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)`);
@@ -65,6 +66,7 @@ export const migrate = async (props) => {
             const dryRun = flags["dryRun"];
             const publish = Boolean(flags["publish"]);
             const publishLanguagesFlag = flags["publishLanguages"];
+            const languagePublishStatePath = flags["languagePublishStatePath"];
             const publishLanguages = publishLanguagesFlag
                 ? parsePublishLanguagesOption(publishLanguagesFlag)
                 : undefined;
@@ -82,6 +84,10 @@ export const migrate = async (props) => {
             if (!publish && publishLanguagesFlag) {
                 throw new Error("--publishLanguages requires --publish for 'migrate content'.");
             }
+            if (languagePublishStatePath &&
+                (!publish || !publishLanguagesFlag)) {
+                throw new Error("--languagePublishStatePath requires --publish and --publishLanguages for 'migrate content'.");
+            }
             if (isIt("empty")) {
                 const componentsToMigrate = unpackElements(input) || [""];
                 const migrateFrom = "space";
@@ -112,6 +118,7 @@ export const migrate = async (props) => {
                         publishLanguages,
                         fromFilePath,
                         fileName,
+                        languagePublishStatePath,
                     }, apiConfig);
                 };
                 if (dryRun) {
@@ -141,6 +148,7 @@ export const migrate = async (props) => {
                         publishLanguages,
                         fromFilePath,
                         fileName,
+                        languagePublishStatePath,
                     }, apiConfig);
                 };
                 if (dryRun) {
@@ -175,6 +183,7 @@ export const migrate = async (props) => {
             const to = getTo(flags, apiConfig);
             const publish = Boolean(flags["publish"]);
             const publishLanguagesFlag = flags["publishLanguages"];
+            const languagePublishStatePath = flags["languagePublishStatePath"];
             if (migrationConfigs.length === 0) {
                 throw new Error("Missing migration config. Pass exactly one --migration value for presets.");
             }
@@ -184,6 +193,9 @@ export const migrate = async (props) => {
             if (publishLanguagesFlag) {
                 throw new Error("--publishLanguages is only supported for 'migrate content'. Presets cannot be published.");
             }
+            if (languagePublishStatePath) {
+                throw new Error("--languagePublishStatePath 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

@@ -1,11 +1,12 @@
 #! /usr/bin/env node
 import meow from "meow";
-import { backupDescription, debugDescription, mainDescription, syncDescription, removeDescription, initDescription, discoverDescription, migrateDescription, revertDescription, migrationsDescription, copyDescription, } from "./cli-descriptions.js";
+import { backupDescription, debugDescription, mainDescription, syncDescription, removeDescription, initDescription, discoverDescription, migrateDescription, languagePublishStateDescription, revertDescription, migrationsDescription, copyDescription, } from "./cli-descriptions.js";
 import { backup } from "./commands/backup.js";
 import { copyCommand } from "./commands/copy.js";
 import { debug } from "./commands/debug.js";
 import { discover } from "./commands/discover.js";
 import { init } from "./commands/init.js";
+import { languagePublishState } from "./commands/language-publish-state.js";
 import { migrate } from "./commands/migrate.js";
 import { migrations } from "./commands/migrations.js";
 import { remove } from "./commands/remove.js";
@@ -87,6 +88,9 @@ app.migrate = () => ({
             publishLanguages: {
                 type: "string",
             },
+            languagePublishStatePath: {
+                type: "string",
+            },
             fileName: {
                 type: "string",
             },
@@ -96,6 +100,38 @@ app.migrate = () => ({
         migrate(cli);
     },
 });
+app["language-publish-state"] = () => ({
+    cli: meow(languagePublishStateDescription, {
+        importMeta: import.meta,
+        booleanDefault: undefined,
+        flags: {
+            from: {
+                type: "string",
+            },
+            accessToken: {
+                type: "string",
+            },
+            languages: {
+                type: "string",
+                default: "all",
+            },
+            withSlug: {
+                type: "string",
+                isMultiple: true,
+            },
+            startsWith: {
+                type: "string",
+            },
+            fileName: {
+                type: "string",
+            },
+            outputPath: {
+                type: "string",
+            },
+        },
+    }),
+    action: (cli) => languagePublishState(cli),
+});
 app.revert = () => ({
     cli: meow(revertDescription, {
         importMeta: import.meta,

package/dist/config/defaultConfig.js

@@ -43,7 +43,8 @@ export const defaultConfig = (pkg, path, env) => {
         oauthToken: env["STORYBLOK_OAUTH_TOKEN"] ?? "",
         openaiToken: env["OPENAI_API_KEY"] ?? "",
         spaceId: env["STORYBLOK_SPACE_ID"] ?? "",
-        accessToken: env["GATSBY_STORYBLOK_ACCESS_TOKEN"] ||
+        accessToken: env["STORYBLOK_ACCESS_TOKEN"] ||
+            env["GATSBY_STORYBLOK_ACCESS_TOKEN"] ||
             env["NEXT_PUBLIC_STORYBLOK_ACCESS_TOKEN"] ||
             "",
         boilerplateSpaceId: "172677", // this is id of Content seed for nextjs boilerplate space

package/dist/utils/path-utils.js

@@ -22,6 +22,10 @@ export const extractComponentName = (filePath) => {
     const lastElement = normalized.substring(normalized.lastIndexOf("/") + 1);
     return lastElement.replace(/\.ts$/, "");
 };
+const getFileName = (filePath) => {
+    const normalized = filePath.replace(/\\/g, "/");
+    return normalized.substring(normalized.lastIndexOf("/") + 1);
+};
 /**
  * Normalizes an array of directory segments for glob pattern usage.
  * Handles the glob.sync quirk where single segments don't need braces,
@@ -102,13 +106,13 @@ export const exactFilesPatterns = ({ mainDirectory, componentDirectories, fileNa
 export const compare = (request) => {
     const { local, external } = request;
     const splittedLocal = local.map((p) => ({
-        name: path.basename(p),
+        name: getFileName(p),
         p,
     }));
     const localNames = new Set(splittedLocal.map((file) => file.name));
     const splittedExternal = external
         .map((p) => ({
-        name: path.basename(p),
+        name: getFileName(p),
         p,
     }))
         .filter((file) => {

package/dist/utils/url-utils.d.ts

@@ -0,0 +1,8 @@
+export type SearchParamValue = string | number | boolean | null | undefined;
+type BuildUrlArgs = {
+    baseUrl: string;
+    pathname?: string;
+    searchParams?: Record<string, SearchParamValue>;
+};
+export declare const buildUrl: ({ baseUrl, pathname, searchParams, }: BuildUrlArgs) => URL;
+export {};

package/dist/utils/url-utils.js

@@ -0,0 +1,12 @@
+const withTrailingSlash = (value) => value.endsWith("/") ? value : `${value}/`;
+const normalizePathname = (pathname = "") => pathname.replace(/^\/+/, "");
+export const buildUrl = ({ baseUrl, pathname, searchParams = {}, }) => {
+    const url = new URL(normalizePathname(pathname), withTrailingSlash(baseUrl));
+    for (const [key, value] of Object.entries(searchParams)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        url.searchParams.set(key, String(value));
+    }
+    return url;
+};

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

@@ -130,6 +130,31 @@ const resolvePublishLanguageCodes = async (publishLanguages, config) => {
     ]);
 };
 exports.resolvePublishLanguageCodes = resolvePublishLanguageCodes;
+const isPublishLanguageStateClean = (languagePublishStateMap, story, language) => {
+    const storyEntry = languagePublishStateMap?.stories?.[story.full_slug];
+    const languageState = storyEntry?.languages?.[language]?.state;
+    if (!languageState) {
+        return undefined;
+    }
+    return languageState === "published_clean";
+};
+const resolvePublishLanguagesForStory = ({ story, publishState, publishLanguages, languagePublishStateMap, }) => {
+    if (!languagePublishStateMap) {
+        return publishState && !publishState.shouldPublish
+            ? []
+            : publishLanguages;
+    }
+    return publishLanguages.filter((language) => {
+        if (language === DEFAULT_PUBLISH_LANGUAGE) {
+            return !publishState || publishState.shouldPublish;
+        }
+        const languageStateAllowsPublish = isPublishLanguageStateClean(languagePublishStateMap, story, language);
+        if (languageStateAllowsPublish !== undefined) {
+            return languageStateAllowsPublish;
+        }
+        return !publishState || publishState.shouldPublish;
+    });
+};
 const resolveStoryblokErrorResponse = (err) => {
     if (typeof err?.response === "string" && err.response.trim().length > 0) {
         return err.response.trim();
@@ -365,33 +390,47 @@ const updateStories = async (args, config) => {
         const publishState = shouldPreservePublishState
             ? (0, exports.resolveStoryPublishState)(story)
             : undefined;
+        const storyPublishLanguages = publishLanguages
+            ? resolvePublishLanguagesForStory({
+                story,
+                publishState,
+                publishLanguages,
+                languagePublishStateMap: options.languagePublishStateMap,
+            })
+            : undefined;
         const shouldPublishStory = options.publish &&
-            (!publishState || publishState.shouldPublish);
+            (!publishState || publishState.shouldPublish) &&
+            (!shouldPublishLanguages ||
+                storyPublishLanguages?.includes(DEFAULT_PUBLISH_LANGUAGE));
         const updateResult = await (0, exports.updateStory)(story, story.id, {
             publish: shouldPublishStory && !shouldPublishLanguages,
             force_update: options.force_update,
         }, { ...config, spaceId });
         if (options.publish &&
             updateResult?.ok &&
-            isSkippedStoryPublishState(publishState)) {
+            isSkippedStoryPublishState(publishState) &&
+            (!storyPublishLanguages || storyPublishLanguages.length === 0)) {
             return withSkippedPublish({
                 updateResult,
                 story,
                 storyId: story.id,
                 spaceId,
-                publishLanguages,
+                publishLanguages: options.languagePublishStateMap
+                    ? storyPublishLanguages
+                    : publishLanguages,
                 publishState,
             });
         }
         if (!shouldPublishLanguages ||
-            !publishLanguages ||
+            !storyPublishLanguages ||
+            storyPublishLanguages.length === 0 ||
             !updateResult?.ok) {
             return updateResult;
         }
         return (0, exports.publishStoryLanguages)({
             storyId: story.id,
             story,
-            languages: publishLanguages,
+            languages: storyPublishLanguages,
         }, { ...config, spaceId });
     }));
 };

package/dist-cjs/utils/path-utils.js

@@ -29,6 +29,10 @@ const extractComponentName = (filePath) => {
     return lastElement.replace(/\.ts$/, "");
 };
 exports.extractComponentName = extractComponentName;
+const getFileName = (filePath) => {
+    const normalized = filePath.replace(/\\/g, "/");
+    return normalized.substring(normalized.lastIndexOf("/") + 1);
+};
 /**
  * Normalizes an array of directory segments for glob pattern usage.
  * Handles the glob.sync quirk where single segments don't need braces,
@@ -112,13 +116,13 @@ exports.exactFilesPatterns = exactFilesPatterns;
 const compare = (request) => {
     const { local, external } = request;
     const splittedLocal = local.map((p) => ({
-        name: path_1.default.basename(p),
+        name: getFileName(p),
         p,
     }));
     const localNames = new Set(splittedLocal.map((file) => file.name));
     const splittedExternal = external
         .map((p) => ({
-        name: path_1.default.basename(p),
+        name: getFileName(p),
         p,
     }))
         .filter((file) => {

package/package.json

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