storyblok 4.15.0 → 4.15.2

package/dist/index.mjs

@@ -1,17 +1,16 @@
 #!/usr/bin/env node
 import 'dotenv/config';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { resolve, dirname, isAbsolute, relative as relative$1, join as join$1 } from 'pathe';
+import { resolve, dirname, join, parse, extname, relative, isAbsolute, basename } from 'pathe';
 import { existsSync, mkdirSync, appendFileSync, writeFileSync, readdirSync, unlinkSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { loadConfig as loadConfig$1, SUPPORTED_EXTENSIONS } from 'c12';
 import chalk from 'chalk';
 import { readPackageUp } from 'read-package-up';
 import { Command } from 'commander';
-import path, { join, resolve as resolve$1, parse, dirname as dirname$1, extname, relative, basename } from 'node:path';
 import { MultiBar, Presets } from 'cli-progress';
 import { Spinner } from '@topcli/spinner';
-import fs, { mkdir, writeFile, readFile as readFile$1, appendFile, access, constants, readdir, unlink, stat } from 'node:fs/promises';
+import fs, { mkdir, writeFile, readFile as readFile$1, appendFile, access, constants, readdir, unlink } from 'node:fs/promises';
 import filenamify from 'filenamify';
 import { ManagementApiClient } from '@storyblok/management-api-client';
 import { RateLimit, Sema } from 'async-sema';
@@ -103,6 +102,44 @@ const regionNames = {
 ({
   SB_Agent_Version: process.env.npm_package_version || "4.x"
 });
+const SUPPORTED_ASSET_EXTENSIONS = /* @__PURE__ */ new Set([
+  // Images: image/png, image/x-png, image/gif, image/jpeg, image/avif, image/svg+xml, image/webp
+  ".jpg",
+  ".jpeg",
+  ".png",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".svg",
+  // Video: video/*, application/mp4, application/x-mpegurl, application/vnd.apple.mpegurl
+  ".mp4",
+  ".mov",
+  ".avi",
+  ".webm",
+  ".wmv",
+  ".mkv",
+  ".flv",
+  ".ogv",
+  ".3gp",
+  ".m4v",
+  ".mpg",
+  ".mpeg",
+  ".m3u8",
+  // Audio: audio/*
+  ".mp3",
+  ".wav",
+  ".ogg",
+  ".aac",
+  ".flac",
+  ".wma",
+  ".m4a",
+  ".opus",
+  // Documents: application/msword, text/plain, application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".txt"
+]);
 const directories = {
   assets: "assets",
   components: "components",
@@ -651,25 +688,38 @@ const API_ACTIONS = {
 const API_ERRORS = {
   unauthorized: "The user is not authorized to access the API",
   network_error: "No response from server, please check if you are correctly connected to internet",
+  server_error: "The server returned an error",
   invalid_credentials: "The provided credentials are invalid",
   timeout: "The API request timed out",
   generic: "Error fetching data from the API",
   not_found: "The requested resource was not found",
   unprocessable_entity: "The request was well-formed but was unable to be followed due to semantic errors"
 };
+function getErrorId(status) {
+  switch (status) {
+    case 401:
+      return "unauthorized";
+    case 404:
+      return "not_found";
+    case 422:
+      return "unprocessable_entity";
+    default:
+      return status >= 500 ? "server_error" : "generic";
+  }
+}
 function handleAPIError(action, error, customMessage) {
   if (error instanceof FetchError) {
-    const status = error.response.status;
-    switch (status) {
-      case 401:
-        throw new APIError("unauthorized", action, error, customMessage);
-      case 404:
-        throw new APIError("not_found", action, error, customMessage);
-      case 422:
-        throw new APIError("unprocessable_entity", action, error, customMessage);
-      default:
-        throw new APIError("network_error", action, error, customMessage);
-    }
+    const errorId = getErrorId(error.response.status);
+    throw new APIError(errorId, action, error, customMessage);
+  }
+  const response = error?.response;
+  if (response?.status) {
+    const wrappedError = new FetchError(
+      response.statusText ?? error.message,
+      { status: response.status, statusText: response.statusText ?? "", data: response.data }
+    );
+    const errorId = getErrorId(response.status);
+    throw new APIError(errorId, action, wrappedError, customMessage);
   }
   throw new APIError("generic", action, error, customMessage);
 }
@@ -1258,7 +1308,7 @@ const deduplicateManifest = async (manifestFile) => {
 };
 const resolvePath = (path, folder) => {
   const basePath = path ?? DEFAULT_STORAGE_DIR;
-  return resolve$1(process.cwd(), basePath, folder);
+  return resolve(process.cwd(), basePath, folder);
 };
 function resolveCommandPath(commandPath, space, baseDir) {
   if (space) {
@@ -1370,7 +1420,7 @@ class Reporter {
     if (this.maxFiles === void 0) {
       return;
     }
-    const dir = dirname$1(this.filePath);
+    const dir = dirname(this.filePath);
     const ext = extname(this.filePath);
     Reporter.pruneReportFiles(dir, this.maxFiles, ext);
   }
@@ -1428,7 +1478,7 @@ class FileTransport {
     if (this.maxFiles === void 0) {
       return;
     }
-    const dir = dirname$1(this.filePath);
+    const dir = dirname(this.filePath);
     const ext = extname(this.filePath);
     FileTransport.pruneLogFiles(dir, this.maxFiles, ext);
   }
@@ -1827,7 +1877,7 @@ function getProgram() {
           options.path
         );
         const logFilename = `${commandPieces.join("-")}-${runId}.jsonl`;
-        logFilePath = path.join(logsPath, logFilename);
+        logFilePath = join(logsPath, logFilename);
         transports.push(
           new FileTransport({
             filePath: logFilePath,
@@ -1851,7 +1901,7 @@ function getProgram() {
           options.path
         );
         const reportFilename = `${commandPieces.join("-")}-${runId}.json`;
-        const reportFilePath = path.join(reportPath, reportFilename);
+        const reportFilePath = join(reportPath, reportFilename);
         const reporter = getReporter({
           enabled: true,
           filePath: reportFilePath,
@@ -1888,34 +1938,10 @@ const getUser = async (token, region) => {
     });
     return data?.user;
   } catch (error) {
-    if (error instanceof FetchError) {
-      const status = error.response.status;
-      switch (status) {
-        case 401:
-          throw new APIError("unauthorized", "get_user", error, `The token provided ${chalk.bold(maskToken(token))} is invalid.
-        Please make sure you are using the correct token and try again.`);
-        default:
-          throw new APIError("network_error", "get_user", error);
-      }
-    }
-    if (typeof error === "string" && error === "Unauthorized") {
-      const mockFetchError = new FetchError("Non-JSON response", {
-        status: 401,
-        statusText: "Unauthorized",
-        data: null
-      });
-      throw new APIError("unauthorized", "get_user", mockFetchError, `The token provided ${chalk.bold(maskToken(token))} is invalid.
-        Please make sure you are using the correct token and try again.`);
-    }
-    if (typeof error === "object" && error !== null && Object.keys(error).length === 0) {
-      const mockFetchError = new FetchError("Network Error", {
-        status: 500,
-        statusText: "Internal Server Error",
-        data: null
-      });
-      throw new APIError("network_error", "get_user", mockFetchError);
-    }
-    throw new APIError("generic", "get_user", error);
+    const status = error?.response?.status;
+    const customMessage = status === 401 ? `The token provided ${chalk.bold(maskToken(token))} is invalid.
+        Please make sure you are using the correct token and try again.` : void 0;
+    handleAPIError("get_user", error, customMessage);
   }
 };
 
@@ -1926,17 +1952,7 @@ const loginWithToken = async (token, region) => {
     if (error instanceof APIError) {
       throw error;
     }
-    if (error instanceof FetchError) {
-      const status = error.response.status;
-      switch (status) {
-        case 401:
-          throw new APIError("unauthorized", "login_with_token", error, `The token provided ${chalk.bold(maskToken(token))} is invalid.
-        Please make sure you are using the correct token and try again.`);
-        default:
-          throw new APIError("network_error", "login_with_token", error);
-      }
-    }
-    throw new APIError("generic", "login_with_token", error, "The provided credentials are invalid");
+    handleAPIError("login_with_token", error);
   }
 };
 const loginWithEmailAndPassword = async (email, password, region) => {
@@ -2322,7 +2338,7 @@ const fetchComponentInternalTags = async (spaceId) => {
 const saveComponentsToFiles = async (space, spaceData, options) => {
   const { components = [], groups = [], presets = [], internalTags = [] } = spaceData;
   const { filename = DEFAULT_COMPONENTS_FILENAME, suffix, path, separateFiles } = options;
-  const resolvedPath = path ? resolve$1(process.cwd(), path, "components", space) : resolvePath(path, `components/${space}`);
+  const resolvedPath = path ? resolve(process.cwd(), path, "components", space) : resolvePath(path, `components/${space}`);
   try {
     if (separateFiles) {
       for (const component of components) {
@@ -2696,17 +2712,17 @@ pullCmd$4.action(async (componentName, options, command) => {
         konsola.warn(`The --filename option is ignored when using --separate-files`);
       }
       const filePath = `${componentsOutputDir}/`;
-      const displayPath = path && isAbsolute(path) ? filePath : `${relative$1(process.cwd(), componentsOutputDir)}/`;
+      const displayPath = path && isAbsolute(path) ? filePath : `${relative(process.cwd(), componentsOutputDir)}/`;
       konsola.ok(`Components downloaded successfully to ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     } else if (componentName) {
       const fileName = suffix ? `${actualFilename}.${suffix}.json` : `${componentName}.json`;
-      const filePath = join$1(componentsOutputDir, fileName);
-      const displayPath = path && isAbsolute(path) ? filePath : relative$1(process.cwd(), filePath);
+      const filePath = join(componentsOutputDir, fileName);
+      const displayPath = path && isAbsolute(path) ? filePath : relative(process.cwd(), filePath);
       konsola.ok(`Component ${chalk.hex(colorPalette.PRIMARY)(componentName)} downloaded successfully in ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     } else {
       const fileName = suffix ? `${actualFilename}.${suffix}.json` : `${actualFilename}.json`;
-      const filePath = join$1(componentsOutputDir, fileName);
-      const displayPath = path && isAbsolute(path) ? filePath : relative$1(process.cwd(), filePath);
+      const filePath = join(componentsOutputDir, fileName);
+      const displayPath = path && isAbsolute(path) ? filePath : relative(process.cwd(), filePath);
       konsola.ok(`Components downloaded successfully to ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     }
     konsola.br();
@@ -3889,8 +3905,8 @@ pullCmd$3.action(async (options, command) => {
     });
     const languagesOutputDir = resolveCommandPath("languages", space, path);
     const fileName = suffix ? `${filename}.${suffix}.json` : `${filename}.json`;
-    const filePath = join$1(languagesOutputDir, fileName);
-    const displayPath = path && isAbsolute(path) ? filePath : relative$1(process.cwd(), filePath);
+    const filePath = join(languagesOutputDir, fileName);
+    const displayPath = path && isAbsolute(path) ? filePath : relative(process.cwd(), filePath);
     spinner.succeed();
     konsola.ok(`Languages schema downloaded successfully at ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`, true);
   } catch (error) {
@@ -3920,7 +3936,7 @@ const getMigrationTemplate = () => {
 `;
 };
 const generateMigration = async (space, path, component, suffix) => {
-  const resolvedPath = path ? resolve$1(process.cwd(), path, "migrations", space) : resolvePath(path, `migrations/${space}`);
+  const resolvedPath = path ? resolve(process.cwd(), path, "migrations", space) : resolvePath(path, `migrations/${space}`);
   const fileName = suffix ? `${component.name}.${suffix}.js` : `${component.name}.js`;
   const migrationPath = join(resolvedPath, fileName);
   try {
@@ -4025,13 +4041,13 @@ const createStory = async (spaceId, payload) => {
       },
       body: {
         story: payload.story,
-        publish: payload.publish
+        ...payload.publish ? { publish: payload.publish } : {}
       },
       throwOnError: true
     });
     return data?.story;
-  } catch (maybeError) {
-    handleAPIError("create_story", toError(maybeError));
+  } catch (error) {
+    handleAPIError("create_story", error);
   }
 };
 const updateStory = async (spaceId, storyId, payload) => {
@@ -4045,18 +4061,20 @@ const updateStory = async (spaceId, storyId, payload) => {
       body: {
         story: payload.story,
         force_update: payload.force_update === "1" ? "1" : "0",
-        publish: payload.publish
+        ...payload.publish ? { publish: payload.publish } : {}
       },
       throwOnError: true
     });
-    const { story } = data;
+    const story = data?.story;
     if (!story) {
       throw new Error("Failed to update story");
     }
     return story;
-  } catch (maybeError) {
-    handleAPIError("update_story", toError(maybeError));
-    throw maybeError;
+  } catch (error) {
+    if (error instanceof Error && error.message === "Failed to update story") {
+      throw error;
+    }
+    handleAPIError("update_story", error);
   }
 };
 
@@ -4526,8 +4544,8 @@ const findComponentSchemas = async (directoryPath) => {
     }
     throw error;
   });
-  const fileContents = files.filter((f) => path.extname(f) === ".json").map((f) => {
-    const filePath = path.join(directoryPath, f);
+  const fileContents = files.filter((f) => extname(f) === ".json").map((f) => {
+    const filePath = join(directoryPath, f);
     const fileContent = readFileSync(filePath, "utf-8");
     return JSON.parse(fileContent);
   });
@@ -5592,7 +5610,7 @@ const getComponentPropertiesTypeAnnotations = async (component, options, spaceDa
 };
 const loadCustomFieldsParser = async (path) => {
   try {
-    const customFieldsParser = await import(resolve$1(path));
+    const customFieldsParser = await import(pathToFileURL(resolve(path)).href);
     return customFieldsParser.default;
   } catch (error) {
     handleError(error);
@@ -5601,7 +5619,7 @@ const loadCustomFieldsParser = async (path) => {
 };
 async function loadCompilerOptions(path) {
   if (path) {
-    const compilerOptions = await import(resolve$1(path));
+    const compilerOptions = await import(pathToFileURL(resolve(path)).href);
     return compilerOptions.default;
   }
   return {};
@@ -5751,7 +5769,7 @@ const generateTypes = async (spaceData, options = {
 };
 const saveTypesToComponentsFile = async (space, typedefData, options) => {
   const { filename = DEFAULT_COMPONENT_FILENAME, path, separateFiles } = options;
-  const resolvedPath = path ? resolve$1(process.cwd(), path, "types", space) : resolvePath(path, `types/${space}`);
+  const resolvedPath = path ? resolve(process.cwd(), path, "types", space) : resolvePath(path, `types/${space}`);
   try {
     if (separateFiles && Array.isArray(typedefData)) {
       for (const { name, content } of typedefData) {
@@ -5767,7 +5785,7 @@ const saveTypesToComponentsFile = async (space, typedefData, options) => {
 const generateStoryblokTypes = async (options = {}) => {
   const { path } = options;
   try {
-    const storyblokTypesPath = resolve$1(__dirname, "./index.d.ts");
+    const storyblokTypesPath = resolve(__dirname, "./index.d.ts");
     const storyblokTypesContent = readFileSync(storyblokTypesPath, "utf-8");
     const typeDefs = [
       "// This file was generated by the Storyblok CLI.",
@@ -5775,7 +5793,7 @@ const generateStoryblokTypes = async (options = {}) => {
       `import type { ${STORY_TYPE} } from '@storyblok/js';`,
       storyblokTypesContent
     ].join("\n");
-    const resolvedPath = path ? resolve$1(process.cwd(), path, "types") : resolvePath(path, "types");
+    const resolvedPath = path ? resolve(process.cwd(), path, "types") : resolvePath(path, "types");
     await saveToFile(join(resolvedPath, `storyblok.d.ts`), typeDefs);
     return true;
   } catch (error) {
@@ -6094,7 +6112,7 @@ const fetchDatasource = async (spaceId, datasourceName) => {
 };
 const saveDatasourcesToFiles = async (space, datasources, options) => {
   const { filename = DEFAULT_DATASOURCES_FILENAME, suffix, path, separateFiles } = options;
-  const resolvedPath = path ? resolve$1(process.cwd(), path, "datasources", space) : resolvePath(path, `datasources/${space}`);
+  const resolvedPath = path ? resolve(process.cwd(), path, "datasources", space) : resolvePath(path, `datasources/${space}`);
   try {
     if (separateFiles) {
       for (const datasource of datasources) {
@@ -6162,17 +6180,17 @@ pullCmd$2.action(async (datasourceName, options, command) => {
         konsola.warn(`The --filename option is ignored when using --separate-files`);
       }
       const filePath = `${datasourcesOutputDir}/`;
-      const displayPath = path && isAbsolute(path) ? filePath : `${relative$1(process.cwd(), datasourcesOutputDir)}/`;
+      const displayPath = path && isAbsolute(path) ? filePath : `${relative(process.cwd(), datasourcesOutputDir)}/`;
       konsola.ok(`Datasources downloaded successfully to ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     } else if (datasourceName) {
       const fileName = suffix ? `${actualFilename}.${suffix}.json` : `${datasourceName}.json`;
-      const filePath = join$1(datasourcesOutputDir, fileName);
-      const displayPath = path && isAbsolute(path) ? filePath : relative$1(process.cwd(), filePath);
+      const filePath = join(datasourcesOutputDir, fileName);
+      const displayPath = path && isAbsolute(path) ? filePath : relative(process.cwd(), filePath);
       konsola.ok(`Datasource ${chalk.hex(colorPalette.PRIMARY)(datasourceName)} downloaded successfully in ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     } else {
       const fileName = suffix ? `${actualFilename}.${suffix}.json` : `${actualFilename}.json`;
-      const filePath = join$1(datasourcesOutputDir, fileName);
-      const displayPath = path && isAbsolute(path) ? filePath : relative$1(process.cwd(), filePath);
+      const filePath = join(datasourcesOutputDir, fileName);
+      const displayPath = path && isAbsolute(path) ? filePath : relative(process.cwd(), filePath);
       konsola.ok(`Datasources downloaded successfully to ${chalk.hex(colorPalette.PRIMARY)(displayPath)}`);
     }
     konsola.br();
@@ -6381,7 +6399,7 @@ const createOctokit = (token) => {
 
 const generateProject = async (blueprint, projectName, targetPath = process.cwd()) => {
   try {
-    const projectPath = path.join(targetPath, projectName);
+    const projectPath = join(targetPath, projectName);
     const templateRepo = `storyblok/blueprint-core-${blueprint}`;
     try {
       await fs.access(projectPath);
@@ -6418,7 +6436,7 @@ const generateProject = async (blueprint, projectName, targetPath = process.cwd(
 };
 const createEnvFile = async (projectPath, storyblokVars, additionalVars) => {
   try {
-    const envPath = path.join(projectPath, ".env");
+    const envPath = join(projectPath, ".env");
     let envContent = `# Storyblok Configuration
 ${Object.entries(storyblokVars).map(([key, value]) => `${key}=${value}`).join("\n")}
 `;
@@ -6636,7 +6654,7 @@ program$5.command(`${commands.CREATE} [project-path]`).alias("c").description(`S
           if (!value.trim()) {
             return "Project path is required";
           }
-          const projectName2 = path.basename(value);
+          const projectName2 = basename(value);
           if (!/^[\w-]+$/.test(projectName2)) {
             return "Project name (last part of the path) can only contain letters, numbers, hyphens, and underscores";
           }
@@ -6644,9 +6662,9 @@ program$5.command(`${commands.CREATE} [project-path]`).alias("c").description(`S
         }
       });
     }
-    const resolvedPath = path.resolve(finalProjectPath);
-    const targetDirectory = path.dirname(resolvedPath);
-    const projectName = path.basename(resolvedPath);
+    const resolvedPath = resolve(finalProjectPath);
+    const targetDirectory = dirname(resolvedPath);
+    const projectName = basename(resolvedPath);
     konsola.br();
     konsola.info(`Scaffolding your project using the ${chalk.hex(colorPalette.CREATE)(technologyTemplate)} template...`);
     await generateProject(technologyTemplate, projectName, targetDirectory);
@@ -7106,7 +7124,7 @@ const parseAssetData = (raw) => {
   }
 };
 const getSidecarFilename = (assetBinaryPath) => {
-  return join(dirname$1(assetBinaryPath), `${basename(assetBinaryPath, extname(assetBinaryPath))}.json`);
+  return join(dirname(assetBinaryPath), `${basename(assetBinaryPath, extname(assetBinaryPath))}.json`);
 };
 const loadSidecarAssetData = async (assetBinaryPath) => {
   const sidecarPath = getSidecarFilename(assetBinaryPath);
@@ -7460,31 +7478,25 @@ const readLocalAssetsStream = ({
   const iterator = async function* readAssets() {
     try {
       const files = await readdir(directoryPath);
-      const metadataFiles = files.filter((file) => file.endsWith(".json") && file !== "manifest.jsonl");
-      setTotalAssets?.(metadataFiles.length);
-      for (const file of metadataFiles) {
-        const filePath = join(directoryPath, file);
+      const binaryFiles = files.filter((f) => SUPPORTED_ASSET_EXTENSIONS.has(extname(f).toLowerCase()));
+      setTotalAssets?.(binaryFiles.length);
+      for (const file of binaryFiles) {
+        const binaryFilePath = join(directoryPath, file);
         try {
-          const statResult = await stat(filePath);
-          if (!statResult.isFile()) {
-            continue;
-          }
-          const metadataContent = await readFile$1(filePath, "utf8");
-          const assetRaw = JSON.parse(metadataContent);
+          const sidecar = await loadSidecarAssetData(binaryFilePath);
+          const shortFilename = sidecar.short_filename || (sidecar.filename ? basename(sidecar.filename) : void 0) || file;
           const asset = {
-            ...assetRaw,
-            short_filename: assetRaw.short_filename || basename(assetRaw.filename)
+            ...sidecar,
+            short_filename: shortFilename
           };
-          const baseName = parse(file).name;
-          const extFromMetadata = extname(asset.short_filename || asset.filename) || "";
-          const assetBinaryPath = join(directoryPath, `${baseName}${extFromMetadata}`);
-          const fileBuffer = await readFile$1(assetBinaryPath);
+          const fileBuffer = await readFile$1(binaryFilePath);
+          const sidecarPath = getSidecarFilename(binaryFilePath);
           yield {
             asset,
             context: {
               fileBuffer,
-              assetBinaryPath,
-              assetPath: filePath
+              assetBinaryPath: binaryFilePath,
+              assetPath: sidecarPath
             }
           };
         } catch (maybeError) {
@@ -7868,6 +7880,9 @@ const traverseAndMapBySchema = (data, {
   processedFields,
   missingSchemas
 }) => {
+  if (!data?.component) {
+    return data ?? {};
+  }
   const schema = schemas[data.component];
   if (!schema) {
     missingSchemas.add(data.component);
@@ -7911,7 +7926,7 @@ const traverseAndMapRichtextDoc = (data, {
     }));
   }
   if (data && typeof data === "object") {
-    if (data.type === "link" && data.attrs.linktype === "story") {
+    if (data.type === "link" && data.attrs?.linktype === "story") {
       return {
         ...data,
         attrs: {
@@ -7925,7 +7940,7 @@ const traverseAndMapRichtextDoc = (data, {
         ...data,
         attrs: {
           ...data.attrs,
-          body: data.attrs.body.map((d) => traverseAndMapBySchema(d, {
+          body: (data.attrs?.body ?? []).map((d) => traverseAndMapBySchema(d, {
             schemas,
             maps,
             fieldRefMappers: fieldRefMappers2,
@@ -7967,7 +7982,7 @@ const multilinkFieldRefMapper = (data, { maps }) => {
 };
 const bloksFieldRefMapper = (data, { schemas, maps, fieldRefMappers: fieldRefMappers2, processedFields, missingSchemas }) => {
   if (!Array.isArray(data)) {
-    throw new TypeError("Invalid data!");
+    throw new TypeError(`Invalid bloks field: expected an array, but received ${JSON.stringify(data)}. Please make sure your bloks field value is an array of components (e.g. [{ component: "my_blok", ... }]).`);
   }
   return data.map((d) => traverseAndMapBySchema(d, {
     schemas,
@@ -7986,7 +8001,7 @@ const assetFieldRefMapper = (data, { maps }) => {
 };
 const multiassetFieldRefMapper = (data, options) => {
   if (!Array.isArray(data)) {
-    throw new TypeError("Invalid data!");
+    throw new TypeError(`Invalid multiasset field: expected an array, but received ${JSON.stringify(data)}. Please make sure your multiasset field value is an array of asset objects (e.g. [{ filename: "...", id: 123 }]).`);
   }
   return data.map((d) => assetFieldRefMapper(d, options));
 };
@@ -8009,23 +8024,23 @@ const storyRefMapper = (story, { schemas, maps }) => {
   const missingSchemas = /* @__PURE__ */ new Set();
   const alternates = story.alternates ? story.alternates.map((a) => ({
     ...a,
-    id: maps.stories?.get(a.id) || a.id,
-    parent_id: maps.stories?.get(a.parent_id) || a.parent_id
+    id: maps.stories?.get(a.id) ?? a.id,
+    parent_id: maps.stories?.get(a.parent_id) ?? a.parent_id
   })) : story.alternates;
-  const parentId = maps.stories?.get(story.parent_id) || story.parent_id;
+  const parentId = maps.stories?.get(story.parent_id) ?? story.parent_id;
   const mappedStory = {
     ...story,
-    content: traverseAndMapBySchema(story.content, {
+    content: story.content?.component ? traverseAndMapBySchema(story.content, {
       schemas,
       maps,
       fieldRefMappers,
       processedFields,
       missingSchemas
-    }),
-    id: Number(maps.stories?.get(story.id) || story.id),
-    uuid: String(maps.stories?.get(story.uuid) || story.uuid),
+    }) : story.content,
+    id: Number(maps.stories?.get(story.id) ?? story.id),
+    uuid: String(maps.stories?.get(story.uuid) ?? story.uuid),
     // @ts-expect-error Our types are wrong.
-    parent_id: parentId ? Number(parentId) : null,
+    parent_id: parentId != null ? Number(parentId) : null,
     alternates
   };
   return {
@@ -8187,14 +8202,14 @@ const getRemoteStory = async ({ spaceId, storyId }) => {
   return data?.story;
 };
 const makeCreateStoryAPITransport = ({ spaceId }) => async (localStory) => {
-  const { id: _id, uuid: _uuid, content, parent_id: _p, ...newStoryData } = localStory;
+  const { id: _id, uuid: _uuid, parent_id: _parentId, content, ...newStoryData } = localStory;
+  if (!localStory.is_folder && !content?.component) {
+    throw new Error(`Story "${localStory.slug}" is missing a content type (content.component). Every story must define a content field with a valid component.`);
+  }
   const remoteStory = await createStory(spaceId, {
     story: {
       ...newStoryData,
-      content: {
-        _uid: "",
-        component: "__tmp__"
-      }
+      ...content?.component ? { content: { _uid: "", component: "__migration_artifact__" } } : {}
     },
     publish: 0
   });
@@ -8265,12 +8280,12 @@ const createStoryPlaceholderStream = ({
   });
 };
 const makeWriteStoryFSTransport = ({ directoryPath }) => async (story) => {
-  await saveToFile(resolve$1(directoryPath, getStoryFilename(story)), JSON.stringify(story, null, 2));
+  await saveToFile(resolve(directoryPath, getStoryFilename(story)), JSON.stringify(story, null, 2));
   return story;
 };
 const makeWriteStoryAPITransport = ({ spaceId, publish }) => (mappedLocalStory) => updateStory(spaceId, mappedLocalStory.id, {
   story: mappedLocalStory,
-  publish: publish ?? (mappedLocalStory.published ? 1 : 0)
+  publish: publish ?? (isStoryPublishedWithoutChanges(mappedLocalStory) ? 1 : 0)
 });
 const makeCleanupStoryFSTransport = ({ directoryPath, maps }) => async (mappedStory) => {
   const mapEntry = maps.stories?.entries().find(([_, v]) => v === mappedStory.uuid);
@@ -8279,7 +8294,7 @@ const makeCleanupStoryFSTransport = ({ directoryPath, maps }) => async (mappedSt
     slug: mappedStory.slug,
     uuid: originalUuid
   });
-  const storyFilePath = resolve$1(directoryPath, storyFilename);
+  const storyFilePath = resolve(directoryPath, storyFilename);
   await unlink(storyFilePath);
 };
 const writeStoryStream = ({
@@ -8896,14 +8911,14 @@ pushCmd.action(async (options, command) => {
           processProgress.setTotal(total);
           updateProgress.setTotal(total);
         },
-        onStoryError(error) {
+        onStoryError(error, filename) {
           summary.creationResults.failed += 1;
           summary.processResults.total -= 1;
           summary.updateResults.total -= 1;
           processProgress.setTotal(summary.processResults.total);
           updateProgress.setTotal(summary.updateResults.total);
           creationProgress.increment();
-          handleError(error, verbose);
+          handleError(error, verbose, { storyFile: filename });
         }
       }),
       // Create remote stories.
@@ -8912,7 +8927,6 @@ pushCmd.action(async (options, command) => {
         spaceId: space,
         transports: {
           createStory: options.dryRun ? async (story) => story : makeCreateStoryAPITransport({
-            maps,
             spaceId: space
           }),
           appendStoryManifest: options.dryRun ? () => Promise.resolve() : makeAppendToManifestFSTransport({
@@ -8937,13 +8951,13 @@ pushCmd.action(async (options, command) => {
           logger.info("Skipped creating story", { storyId: localStory.uuid });
           summary.creationResults.skipped += 1;
         },
-        onStoryError(error) {
+        onStoryError(error, localStory) {
           summary.creationResults.failed += 1;
           summary.processResults.total -= 1;
           summary.updateResults.total -= 1;
           processProgress.setTotal(summary.processResults.total);
           updateProgress.setTotal(summary.updateResults.total);
-          handleError(error, verbose);
+          handleError(error, verbose, { storyId: localStory?.uuid });
         },
         onIncrement() {
           creationProgress.increment();
@@ -8963,13 +8977,13 @@ pushCmd.action(async (options, command) => {
           processProgress.setTotal(total);
           updateProgress.setTotal(total);
         },
-        onStoryError(error) {
+        onStoryError(error, filename) {
           summary.creationResults.failed += 1;
           summary.processResults.total -= 1;
           summary.updateResults.total -= 1;
           processProgress.setTotal(summary.processResults.total);
           updateProgress.setTotal(summary.updateResults.total);
-          handleError(error, verbose);
+          handleError(error, verbose, { storyFile: filename });
         }
       }),
       // Map all references to numeric ids and uuids.