gt-sanity 2.0.15 → 2.0.17

package/dist/index.cjs

@@ -43,7 +43,7 @@ class GTConfig {
   additionalDeserializers;
   additionalBlockDeserializers;
   static instance;
-  constructor(secretsNamespace, languageField, sourceLocale, locales, singletons, singletonMapping, ignoreFields, dedupeFields, skipFields, translateDocuments, additionalStopTypes = [], additionalSerializers = {}, additionalDeserializers = {}, additionalBlockDeserializers = []) {
+  constructor(secretsNamespace, languageField, sourceLocale, locales, singletons, singletonMapping, ignoreFields, dedupeFields, skipFields, translateDocuments, additionalStopTypes = [], additionalSerializers = {}, additionalDeserializers = { types: {} }, additionalBlockDeserializers = []) {
     this.secretsNamespace = secretsNamespace, this.languageField = languageField, this.sourceLocale = sourceLocale, this.locales = locales, this.singletons = singletons, this.singletonMapping = singletonMapping, this.ignoreFields = ignoreFields, this.dedupeFields = dedupeFields, this.skipFields = skipFields, this.translateDocuments = translateDocuments, this.additionalStopTypes = additionalStopTypes, this.additionalSerializers = additionalSerializers, this.additionalDeserializers = additionalDeserializers, this.additionalBlockDeserializers = additionalBlockDeserializers;
   }
   static getInstance() {
@@ -59,12 +59,12 @@ class GTConfig {
       [],
       [],
       [],
-      {},
+      { types: {} },
       {},
       []
     )), this.instance;
   }
-  init(secretsNamespace, languageField, sourceLocale, locales, singletons, singletonMapping, ignoreFields, dedupeFields, skipFields, translateDocuments, additionalStopTypes = [], additionalSerializers = {}, additionalDeserializers = {}, additionalBlockDeserializers = []) {
+  init(secretsNamespace, languageField, sourceLocale, locales, singletons, singletonMapping, ignoreFields, dedupeFields, skipFields, translateDocuments, additionalStopTypes = [], additionalSerializers = {}, additionalDeserializers = { types: {} }, additionalBlockDeserializers = []) {
     this.secretsNamespace = secretsNamespace, this.languageField = languageField, this.sourceLocale = sourceLocale, this.locales = locales, this.singletons = singletons, this.singletonMapping = singletonMapping, this.ignoreFields = ignoreFields, this.dedupeFields = dedupeFields, this.skipFields = skipFields, this.translateDocuments = translateDocuments, this.additionalStopTypes = additionalStopTypes, this.additionalSerializers = additionalSerializers, this.additionalDeserializers = additionalDeserializers, this.additionalBlockDeserializers = additionalBlockDeserializers;
   }
   getSecretsNamespace() {
@@ -122,31 +122,37 @@ const pluginConfig = GTConfig.getInstance(), theme = theme$1.buildTheme(), BaseT
     !loadingSecrets && secrets && children
   ] });
   return /* @__PURE__ */ jsxRuntime.jsx(ui.ThemeProvider, { theme, children: /* @__PURE__ */ jsxRuntime.jsx(ui.ToastProvider, { paddingY: 7, children: showContainer ? /* @__PURE__ */ jsxRuntime.jsx(ui.Box, { padding, children: content }) : content }) });
-}, reconcileArray = (origArray, translatedArray) => {
+}, isRecord$4 = (value) => typeof value == "object" && value !== null && !Array.isArray(value), reconcileArray = (origArray, translatedArray) => {
   if (translatedArray && translatedArray.some((el) => typeof el == "string"))
     return translatedArray;
   const combined = JSON.parse(JSON.stringify(origArray));
-  return translatedArray.forEach((block) => {
-    if (!block._key)
+  return translatedArray.forEach((translatedItem) => {
+    if (!isRecord$4(translatedItem) || !translatedItem._key)
       return;
     const foundBlockIdx = origArray.findIndex(
-      (origBlock) => origBlock._key === block._key
+      (origBlock) => isRecord$4(origBlock) && origBlock._key === translatedItem._key
     );
     foundBlockIdx < 0 ? console.warn(
       `This block no longer exists on the original document. Was it removed? ${JSON.stringify(
-        block
+        translatedItem
       )}`
-    ) : origArray[foundBlockIdx]._type === "block" || origArray[foundBlockIdx]._type === "span" ? combined[foundBlockIdx] = block : Array.isArray(origArray[foundBlockIdx]) ? combined[foundBlockIdx] = reconcileArray(origArray[foundBlockIdx], block) : combined[foundBlockIdx] = reconcileObject(
+    ) : isRecord$4(origArray[foundBlockIdx]) && (origArray[foundBlockIdx]._type === "block" || origArray[foundBlockIdx]._type === "span") ? combined[foundBlockIdx] = translatedItem : isRecord$4(origArray[foundBlockIdx]) && (combined[foundBlockIdx] = reconcileObject(
       origArray[foundBlockIdx],
-      block
-    );
+      translatedItem
+    ));
   }), combined;
 }, reconcileObject = (origObject, translatedObject) => {
   if (typeof translatedObject != "object" || !Object.keys(translatedObject).length)
     return origObject;
   const updatedObj = JSON.parse(JSON.stringify(origObject));
   return Object.entries(translatedObject).forEach(([key, value]) => {
-    !value || key[0] === "_" || (typeof value == "string" ? updatedObj[key] = value : Array.isArray(value) ? updatedObj[key] = reconcileArray(origObject[key] ?? [], value) : updatedObj[key] = reconcileObject(origObject[key] ?? {}, value));
+    !value || key[0] === "_" || (typeof value == "string" ? updatedObj[key] = value : Array.isArray(value) ? updatedObj[key] = reconcileArray(
+      Array.isArray(origObject[key]) ? origObject[key] : [],
+      value
+    ) : isRecord$4(value) && (updatedObj[key] = reconcileObject(
+      isRecord$4(origObject[key]) ? origObject[key] : {},
+      value
+    )));
   }), updatedObj;
 }, fieldLevelMerge = (translatedFields, baseDoc, localeId, baseLang = "en") => {
   const merged = {};
@@ -161,8 +167,11 @@ const pluginConfig = GTConfig.getInstance(), theme = theme$1.buildTheme(), BaseT
       translatedFields
     )[0].value;
     let valToPatch;
-    typeof translatedVal == "string" ? valToPatch = translatedVal : Array.isArray(translatedVal) && translatedVal.length ? valToPatch = reconcileArray(origVal ?? [], translatedVal) : typeof translatedVal == "object" && Object.keys(translatedVal).length && (valToPatch = reconcileObject(
-      origVal ?? {},
+    typeof translatedVal == "string" ? valToPatch = translatedVal : Array.isArray(translatedVal) && translatedVal.length ? valToPatch = reconcileArray(
+      origVal ?? [],
+      translatedVal
+    ) : typeof translatedVal == "object" && Object.keys(translatedVal).length && (valToPatch = reconcileObject(
+      isRecord$4(origVal) ? origVal : {},
       translatedVal
     ));
     const destinationPath = [
@@ -173,7 +182,10 @@ const pluginConfig = GTConfig.getInstance(), theme = theme$1.buildTheme(), BaseT
     ];
     merged[mutator.arrayToJSONMatchPath(destinationPath)] = valToPatch;
   }), merged;
-}, documentLevelMerge = (translatedFields, baseDoc) => reconcileObject(baseDoc, translatedFields), BaseDocumentMerger = {
+}, documentLevelMerge = (translatedFields, baseDoc) => reconcileObject(
+  baseDoc,
+  translatedFields
+), BaseDocumentMerger = {
   fieldLevelMerge,
   documentLevelMerge,
   reconcileArray,
@@ -240,7 +252,7 @@ function decode(base64) {
     bytes[i] = binary.charCodeAt(i);
   return new TextDecoder().decode(bytes);
 }
-const defaultStopTypes = [
+const isRecord$3 = (value) => typeof value == "object" && value !== null && !Array.isArray(value), defaultStopTypes = [
   "reference",
   "date",
   "datetime",
@@ -283,13 +295,19 @@ const defaultStopTypes = [
 }, customDeserializers = { types: {} }, customBlockDeserializers = [
   // handle marks with data-gt-internal
   {
-    deserialize(el, next2) {
+    deserialize(node2, next2) {
+      if (node2.nodeType !== 1)
+        return;
+      const el = node2;
       if (!el.hasChildNodes() || !el.getAttribute("data-gt-internal"))
         return;
       const { html, data } = detachGTData(el.outerHTML), block = blockTools.htmlToBlocks(html, blockContentType)[0], children = next2(el.childNodes);
       let markDefs = [];
-      return "markDefs" in block && (markDefs = block.markDefs ?? []), data?.markDef && markDefs.push(data.markDef), children && children.forEach((child) => {
-        child.marks = data?.markDef?._key ? [...child.marks || [], data.markDef._key] : [...child.marks || []];
+      return "markDefs" in block && (markDefs = block.markDefs ?? []), data?.markDef && markDefs.push(data.markDef), Array.isArray(children) && children.forEach((child) => {
+        if (!isRecord$3(child))
+          return;
+        const marks = Array.isArray(child.marks) ? child.marks : [];
+        child.marks = data?.markDef?._key ? [...marks, data.markDef._key] : marks;
       }), {
         ...block,
         markDefs,
@@ -299,7 +317,10 @@ const defaultStopTypes = [
   },
   //handle undeclared styles
   {
-    deserialize(el, next2) {
+    deserialize(node2, next2) {
+      if (node2.nodeType !== 1)
+        return;
+      const el = node2;
       if (!el.hasChildNodes() || el.getAttribute("data-type") !== "unknown-block-style")
         return;
       const style = el.getAttribute("data-style") ?? "";
@@ -312,7 +333,10 @@ const defaultStopTypes = [
   },
   //handle list items
   {
-    deserialize(el, next2) {
+    deserialize(node2, next2) {
+      if (node2.nodeType !== 1)
+        return;
+      const el = node2;
       if (!el.hasChildNodes() || el.tagName.toLowerCase() !== "li")
         return;
       const tagsToStyle = {
@@ -346,7 +370,7 @@ const defaultStopTypes = [
       };
     }
   }
-], META_FIELDS$1 = ["_key", "_type", "_id"], languageObjectFieldFilter = (obj, baseLang) => {
+], META_FIELDS$1 = ["_key", "_type", "_id"], isRecord$2 = (value) => typeof value == "object" && value !== null && !Array.isArray(value), languageObjectFieldFilter = (obj, baseLang) => {
   const filterToLangField = (childObj) => {
     const filteredObj = {};
     return filteredObj[baseLang] = childObj[baseLang], META_FIELDS$1.forEach((field) => {
@@ -360,24 +384,29 @@ const defaultStopTypes = [
     for (const key in childObj)
       if (childObj.hasOwnProperty(key)) {
         const value = childObj[key];
-        if (value.hasOwnProperty(baseLang))
+        if (isRecord$2(value) && Object.hasOwn(value, baseLang))
           filteredObj[key] = filterToLangField(value);
         else if (Array.isArray(value) && value.length && typeof value[0] == "object") {
-          const validLangObjects = value.reduce((validArr, objInArray) => {
-            if (objInArray._type === "block")
-              validArr.push(objInArray);
-            else if (objInArray.hasOwnProperty(baseLang))
-              validArr.push(filterToLangField(objInArray));
-            else {
-              const filtered = findBaseLang(objInArray);
-              Object.keys(filtered).filter(
-                (objInArrayKey) => META_FIELDS$1.indexOf(objInArrayKey) === -1
-              ).length && validArr.push(filtered);
-            }
-            return validArr;
-          }, []);
+          const validLangObjects = value.reduce(
+            (validArr, objInArray) => {
+              if (!isRecord$2(objInArray))
+                return validArr;
+              if (objInArray._type === "block")
+                validArr.push(objInArray);
+              else if (Object.hasOwn(objInArray, baseLang))
+                validArr.push(filterToLangField(objInArray));
+              else {
+                const filtered = findBaseLang(objInArray);
+                Object.keys(filtered).filter(
+                  (objInArrayKey) => META_FIELDS$1.indexOf(objInArrayKey) === -1
+                ).length && validArr.push(filtered);
+              }
+              return validArr;
+            },
+            []
+          );
           validLangObjects.length && (filteredObj[key] = validLangObjects);
-        } else if (typeof value == "object") {
+        } else if (isRecord$2(value)) {
           const nestedLangObj = findBaseLang(value);
           Object.keys(nestedLangObj).filter(
             (nestedObjKey) => META_FIELDS$1.indexOf(nestedObjKey) === -1
@@ -388,18 +417,24 @@ const defaultStopTypes = [
   };
   return findBaseLang(obj);
 }, fieldFilter = (obj, objFields, stopTypes) => {
-  const filteredObj = { _type: obj._type }, fieldFilterFunc = (field) => field.localize === !1 ? !1 : field.type === "string" || field.type === "text" || Array.isArray(obj[field.name]) ? !0 : !stopTypes.includes(field.type);
+  const filteredObj = {
+    _type: typeof obj._type == "string" ? obj._type : ""
+  }, fieldFilterFunc = (field) => {
+    const fieldMetadata = field, fieldType = typeof fieldMetadata.type == "string" ? fieldMetadata.type : fieldMetadata.type?.name;
+    return fieldMetadata.localize === !1 ? !1 : fieldType === "string" || fieldType === "text" || Array.isArray(obj[field.name]) ? !0 : !!(fieldType && !stopTypes.includes(fieldType));
+  };
   return [
     ...META_FIELDS$1,
     ...objFields.filter(fieldFilterFunc).map((field) => field.name)
   ].forEach((field) => {
     obj[field] && (filteredObj[field] = obj[field]);
   }), filteredObj;
-}, META_FIELDS = ["_key", "_type", "_id", "_weak"], BaseDocumentSerializer = (schemas) => {
+}, META_FIELDS = ["_key", "_type", "_id", "_weak"], isRecord$1 = (value) => typeof value == "object" && value !== null && !Array.isArray(value), BaseDocumentSerializer = (schemas) => {
   const getSchema = (name) => schemas?._original?.types.find((s) => s.name === name), serializeObject = (obj, stopTypes, serializers) => {
     if (stopTypes.includes(obj._type))
       return "";
-    if (serializers.types && Object.keys(serializers.types).includes(obj._type))
+    const typeSerializers = isRecord$1(serializers.types) ? serializers.types : {};
+    if (Object.keys(typeSerializers).includes(obj._type))
       return toHtml.toHTML([obj], { components: serializers });
     if (obj._type === "span" || obj._type === "block")
       return toHtml.toHTML(obj, { components: serializers });
@@ -420,9 +455,9 @@ const defaultStopTypes = [
         else if (Array.isArray(value))
           htmlField = serializeArray(value, fieldName, stopTypes, {
             ...serializers,
-            types: { ...serializers.types }
+            types: { ...typeSerializers }
           });
-        else {
+        else if (isRecord$1(value)) {
           const embeddedObject = value, embeddedObjectSchema = getSchema(embeddedObject._type);
           let toTranslate = embeddedObject;
           embeddedObjectSchema && embeddedObjectSchema.fields && (toTranslate = fieldFilter(
@@ -432,7 +467,7 @@ const defaultStopTypes = [
           ));
           const objHTML = serializeObject(toTranslate, stopTypes, {
             ...serializers,
-            types: { ...serializers.types }
+            types: { ...typeSerializers }
           });
           htmlField = `<div class="${fieldName}" data-level="field">${objHTML}</div>`;
         }
@@ -450,7 +485,7 @@ const defaultStopTypes = [
         components: {
           ...serializers,
           types: {
-            ...serializers.types,
+            ...typeSerializers,
             ...newSerializationMethods
           }
         }
@@ -463,9 +498,13 @@ const defaultStopTypes = [
     return serializedBlock;
   }, serializeArray = (fieldContent, fieldName, stopTypes, serializers) => {
     const output = fieldContent.filter(
-      (block) => !stopTypes.includes(block._type)
+      (block) => typeof block == "string" || typeof block._type != "string" || !stopTypes.includes(block._type)
     ).map((block) => {
-      const schema2 = getSchema(block._type);
+      if (typeof block == "string")
+        return block;
+      const schema2 = getSchema(
+        typeof block._type == "string" ? block._type : ""
+      );
       return schema2 && schema2.fields ? fieldFilter(block, schema2.fields, stopTypes) : block;
     }).map((obj) => typeof obj == "string" ? `<span>${obj}</span>` : serializeObject(obj, stopTypes, serializers));
     return `<div class="${fieldName}" data-type="array">${output.join("")}</div>`;
@@ -483,12 +522,14 @@ const defaultStopTypes = [
           serializedFields[key] = value;
         else if (Array.isArray(value))
           serializedFields[key] = serializeArray(
-            value,
+            value.filter(
+              (item) => typeof item == "string" || isRecord$1(item)
+            ),
             key,
             stopTypes,
             serializers
           );
-        else if (value && !stopTypes.find((stopType) => stopType == value?._type)) {
+        else if (value && isRecord$1(value) && !stopTypes.find((stopType) => stopType == value?._type)) {
           const serialized = serializeObject(
             value,
             stopTypes,
@@ -534,13 +575,22 @@ const deserializeArray = (arrayHTML, deserializers = customDeserializers, blockD
   return Array.from(arrayHTML.children).forEach((child) => {
     let deserializedObject;
     try {
-      child.tagName?.toLowerCase() === "span" ? deserializedObject = preprocess(child.innerHTML) : child.className || child.getAttribute("data-type") === "object" ? (deserializedObject = deserializeObject(
-        child,
-        deserializers,
-        blockDeserializers
-      ), deserializedObject._key = child.id) : (deserializedObject = blockTools.htmlToBlocks(child.outerHTML, blockContentType, {
-        rules: blockDeserializers
-      }), deserializedObject = mergeBlocks(deserializedObject), deserializedObject._key = child.id);
+      if (child.tagName?.toLowerCase() === "span")
+        deserializedObject = preprocess(child.innerHTML);
+      else if (child.className || child.getAttribute("data-type") === "object")
+        deserializedObject = deserializeObject(
+          child,
+          deserializers,
+          blockDeserializers
+        ), deserializedObject && typeof deserializedObject == "object" && !Array.isArray(deserializedObject) && (deserializedObject._key = child.id);
+      else {
+        const blocks = blockTools.htmlToBlocks(child.outerHTML, blockContentType, {
+          rules: blockDeserializers
+        });
+        deserializedObject = mergeBlocks(
+          blocks
+        ), deserializedObject._key = child.id;
+      }
     } catch (e) {
       console.debug(
         `Tried to deserialize block: ${child.outerHTML} in an array but failed to identify it! Error: ${e}`
@@ -549,7 +599,7 @@ const deserializeArray = (arrayHTML, deserializers = customDeserializers, blockD
     output.push(deserializedObject);
   }), output;
 }, deserializeObject = (objectHTML, deserializers = customDeserializers, blockDeserializers = customBlockDeserializers) => {
-  const deserialize = deserializers.types[objectHTML.className];
+  const deserialize = deserializers.types?.[objectHTML.className];
   if (deserialize)
     return deserialize(objectHTML);
   const output = {};
@@ -576,7 +626,7 @@ const deserializeArray = (arrayHTML, deserializers = customDeserializers, blockD
   if (HTMLnode?.getAttribute("data-level") === "field" && (HTMLnode = HTMLnode.children[0]), !HTMLnode)
     return {};
   let output;
-  const deserialize = deserializers.types[HTMLnode.className];
+  const deserialize = deserializers.types?.[HTMLnode.className];
   return deserialize ? output = deserialize(HTMLnode) : HTMLnode.getAttribute("data-type") === "object" ? output = deserializeObject(HTMLnode, deserializers, blockDeserializers) : HTMLnode.getAttribute("data-type") === "array" ? output = deserializeArray(HTMLnode, deserializers, blockDeserializers) : (output = {}, console.debug(
     `Tried to deserialize block ${HTMLnode.outerHTML} but failed to identify it!`
   )), output;
@@ -615,7 +665,7 @@ function forEachMatchingField(documentId, document2, fields, callback) {
           });
           results && results.length > 0 && results.forEach(
             (result) => {
-              type !== void 0 ? typeof result.value == "object" && result.value !== null && result.value._type === type && callback(result) : callback(result);
+              type !== void 0 ? typeof result.value == "object" && result.value !== null && !Array.isArray(result.value) && result.value._type === type && callback(result) : callback(result);
             }
           );
         } catch (error) {
@@ -649,10 +699,17 @@ function applyDocuments(documentId, sourceDocument, targetDocument, ignore, skip
   }), deleteMatchingFields(documentId, mergedDocument, skip), mergedDocument;
 }
 function dedupeFieldValue(value, localeId) {
-  return localeId ? typeof value == "string" ? appendLocaleSuffix(value, localeId) : value && typeof value == "object" && !Array.isArray(value) && typeof value.current == "string" ? {
-    ...value,
-    current: appendLocaleSuffix(value.current, localeId)
-  } : value : value;
+  if (!localeId) return value;
+  if (typeof value == "string")
+    return appendLocaleSuffix(value, localeId);
+  if (value && typeof value == "object" && !Array.isArray(value) && typeof value.current == "string") {
+    const slug = value;
+    return {
+      ...slug,
+      current: appendLocaleSuffix(slug.current, localeId)
+    };
+  }
+  return value;
 }
 function appendLocaleSuffix(value, localeId) {
   if (!value) return value;
@@ -976,7 +1033,9 @@ const documentLevelPatch = async (docInfo, translatedFields, localeId, client, l
     baseDoc,
     client,
     baseLanguage
-  )).translations.find((translation) => translation.language === localeId)?.value?._ref;
+  )).translations.find(
+    (translation) => translation.language === localeId
+  )?.value?._ref;
   i18nDocId && (i18nDoc = await findLatestDraft(i18nDocId, client)), mergeWithTargetLocale && i18nDoc ? baseDoc = i18nDoc : docInfo.documentId && docInfo.versionId && (baseDoc = await findDocumentAtRevision(
     docInfo.documentId,
     docInfo.versionId,
@@ -1002,7 +1061,9 @@ const documentLevelPatch = async (docInfo, translatedFields, localeId, client, l
       baseDoc,
       client,
       baseLanguage
-    ), freshI18nDocId = freshTranslationMetadata.translations.find((translation) => translation.language === localeId)?.value?._ref;
+    ), freshI18nDocId = freshTranslationMetadata.translations.find(
+      (translation) => translation.language === localeId
+    )?.value?._ref;
     if (freshI18nDocId) {
       const freshI18nDoc = await findLatestDraft(freshI18nDocId, client);
       await patchI18nDoc(
@@ -1039,6 +1100,7 @@ async function importDocument(docInfo, localeId, document2, context, mergeWithTa
     mergeWithTargetLocale
   );
 }
+const isRecord = (value) => typeof value == "object" && value !== null && !Array.isArray(value), isReference = (value) => isRecord(value) && value._type === "reference" && typeof value._ref == "string";
 async function resolveRefs(doc, locale, client) {
   const references = findReferences(doc);
   if (references.length === 0)
@@ -1054,9 +1116,9 @@ function findReferences(obj, path = []) {
   if (!obj || typeof obj != "object")
     return [];
   const references = [];
-  return obj._ref && references.push({ ref: obj, path }), Array.isArray(obj) ? obj.forEach((item, index) => {
+  return isReference(obj) && references.push({ ref: obj, path }), Array.isArray(obj) ? obj.forEach((item, index) => {
     references.push(...findReferences(item, [...path, index.toString()]));
-  }) : Object.keys(obj).forEach((key) => {
+  }) : isRecord(obj) && Object.keys(obj).forEach((key) => {
     references.push(...findReferences(obj[key], [...path, key]));
   }), references;
 }
@@ -1080,7 +1142,7 @@ function updateDocumentReferences(doc, translatedRefs) {
 function updateReferencesRecursive(obj, translatedRefs) {
   if (!obj || typeof obj != "object")
     return obj;
-  if (obj._ref && translatedRefs.has(obj._ref))
+  if (isReference(obj) && translatedRefs.has(obj._ref))
     return {
       ...obj,
       _ref: translatedRefs.get(obj._ref)
@@ -1089,7 +1151,10 @@ function updateReferencesRecursive(obj, translatedRefs) {
     return obj.map((item) => updateReferencesRecursive(item, translatedRefs));
   const updated = {};
   return Object.keys(obj).forEach((key) => {
-    updated[key] = updateReferencesRecursive(obj[key], translatedRefs);
+    updated[key] = updateReferencesRecursive(
+      obj[key],
+      translatedRefs
+    );
   }), updated;
 }
 async function findTranslatedDocumentForLocale(sourceDocumentId, localeId, client) {
@@ -1202,16 +1267,19 @@ async function getReadyFilesForImport(translationStatuses, options = {}) {
 async function importTranslations(readyFiles, secrets, translationContext, options = {}) {
   if (readyFiles.length === 0)
     return { successCount: 0, failureCount: 0, successfulImports: [] };
-  const importItems = (await downloadTranslations(readyFiles, secrets)).map((file) => ({
-    docInfo: {
-      documentId: file.fileId,
-      versionId: file.versionId
-    },
-    locale: file.locale,
-    data: file.data,
-    translationContext,
-    key: `${file.branchId}:${file.fileId}:${file.versionId}:${file.locale}`
-  })), result = await processImportBatch(importItems, {
+  const importItems = (await downloadTranslations(readyFiles, secrets)).map((file) => {
+    const data = typeof file.data == "string" ? file.data : JSON.stringify(file.data ?? "");
+    return {
+      docInfo: {
+        documentId: file.fileId,
+        versionId: file.versionId
+      },
+      locale: file.locale,
+      data,
+      translationContext,
+      key: `${file.branchId}:${file.fileId}:${file.versionId}:${file.locale}`
+    };
+  }), result = await processImportBatch(importItems, {
     onProgress: options.onProgress,
     onItemSuccess: (item, key) => {
       options.onImportSuccess?.(key);
@@ -1297,7 +1365,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
       setDocuments(dedupeDocumentsPreferDraft(docs));
     } catch {
       toast.push({
-        title: "Error fetching documents",
+        title: "Documents could not be loaded. Check your Sanity connection and try refreshing.",
         status: "error",
         closable: !0
       });
@@ -1311,7 +1379,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         setLocales(availableLocales);
       } catch {
         toast.push({
-          title: "Error fetching locales",
+          title: "Locales could not be loaded. Check your General Translation credentials and try again.",
           status: "error",
           closable: !0
         });
@@ -1343,7 +1411,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         }), setExistingTranslations(existing);
       } catch (error) {
         console.error("Error fetching existing translations:", error), toast.push({
-          title: "Error fetching existing translations",
+          title: "Existing translations could not be loaded. Try refreshing before importing.",
           status: "error",
           closable: !0
         });
@@ -1379,7 +1447,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         });
       } catch {
         toast.push({
-          title: "Error creating translation tasks",
+          title: "Translation tasks could not be created. No documents were changed. Try again or check the console for details.",
           status: "error",
           closable: !0
         });
@@ -1435,7 +1503,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         });
       } catch (error) {
         console.error("Error importing translations:", error), toast.push({
-          title: "Error importing translations",
+          title: "Translations could not be imported. No documents were changed. Try again or check the console for details.",
           status: "error",
           closable: !0
         });
@@ -1537,7 +1605,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         });
       } catch (error) {
         console.error("Error importing missing translations:", error), toast.push({
-          title: "Error importing missing translations",
+          title: "Missing translations could not be imported. No documents were changed. Try again or check the console for details.",
           status: "error",
           closable: !0
         });
@@ -1623,7 +1691,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
         });
       } catch (error) {
         console.error("Error refreshing translation status:", error), toast.push({
-          title: "Error refreshing translation status",
+          title: "Translation status could not be refreshed. Try again before importing.",
           status: "error",
           closable: !0
         });
@@ -1698,7 +1766,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
             });
           } catch (importError) {
             console.error("Failed to import translation:", importError), toast.push({
-              title: `Failed to import translation for ${documentId} (${localeId})`,
+              title: `Translation for ${documentId} (${localeId}) could not be imported. This document was not changed.`,
               status: "error",
               closable: !0
             });
@@ -1711,7 +1779,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
           });
       } catch (error) {
         console.error("Error importing translation:", error), toast.push({
-          title: `Error importing translation for ${documentId}`,
+          title: `Translation for ${documentId} could not be imported. This document was not changed.`,
           status: "error",
           closable: !0
         });
@@ -1785,7 +1853,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
       }), patchedCount;
     } catch (error) {
       return console.error("Error patching document references:", error), toast.push({
-        title: "Error patching document references",
+        title: "Document references could not be updated. Imported translations may need to be linked manually.",
         status: "error",
         closable: !0
       }), 0;
@@ -1840,7 +1908,7 @@ const getLocales = async (_secrets) => pluginConfig.getLocales().map((locale) =>
       }), translatedDocumentIds.length;
     } catch (error) {
       return console.error("Error publishing translations:", error), toast.push({
-        title: "Error publishing translations",
+        title: "Translations could not be published. No unpublished source documents were changed.",
         status: "error",
         closable: !0
       }), 0;