tinacms 3.14.0 → 3.14.1

package/dist/client.browser.d.ts

@@ -0,0 +1 @@
+export * from './unifiedClient';

package/dist/client.browser.js

@@ -0,0 +1,175 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class AsyncLock {
+  constructor() {
+    __publicField(this, "queues", /* @__PURE__ */ new Map());
+  }
+  acquire(key, fn) {
+    const prev = this.queues.get(key) ?? Promise.resolve();
+    const next = prev.then(fn);
+    this.queues.set(
+      key,
+      next.then(
+        () => void 0,
+        () => void 0
+      )
+    );
+    return next;
+  }
+}
+const TINA_HOST = "content.tinajs.io";
+function replaceGithubPathSplit(url, replacement) {
+  const parts = url.split("github/");
+  if (parts.length > 1 && replacement) {
+    return parts[0] + "github/" + replacement;
+  } else {
+    return url;
+  }
+}
+function isEdgeRuntimeWithoutFs() {
+  if (typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers") {
+    return true;
+  }
+  if (typeof globalThis.EdgeRuntime !== "undefined") {
+    return true;
+  }
+  return false;
+}
+class TinaClient {
+  constructor({
+    token,
+    url,
+    queries,
+    errorPolicy,
+    cacheDir,
+    cache
+  }) {
+    __publicField(this, "apiUrl");
+    __publicField(this, "readonlyToken");
+    __publicField(this, "queries");
+    __publicField(this, "errorPolicy");
+    __publicField(this, "initialized", false);
+    __publicField(this, "cacheLock");
+    __publicField(this, "cacheDir");
+    __publicField(this, "cache");
+    __publicField(this, "cacheEnabled");
+    this.apiUrl = url;
+    this.readonlyToken = token == null ? void 0 : token.trim();
+    this.queries = queries(this);
+    this.errorPolicy = errorPolicy || "throw";
+    this.cacheDir = cacheDir || "";
+    this.cacheEnabled = cache !== false;
+  }
+  async init() {
+    if (this.initialized) {
+      return;
+    }
+    try {
+      if (this.cacheEnabled && this.cacheDir && typeof window === "undefined" && !isEdgeRuntimeWithoutFs()) {
+        this.cache = await this.createCache(this.cacheDir);
+        if (this.cache) {
+          this.cacheLock = new AsyncLock();
+        }
+      }
+    } catch (e) {
+      console.error(e);
+    }
+    this.initialized = true;
+  }
+  async createCache(_dir) {
+    return null;
+  }
+  async request({ errorPolicy, ...args }, options) {
+    var _a;
+    await this.init();
+    const errorPolicyDefined = errorPolicy || this.errorPolicy;
+    const headers = new Headers();
+    if (this.readonlyToken) {
+      headers.append("X-API-KEY", this.readonlyToken);
+    }
+    headers.append("Content-Type", "application/json");
+    if (options == null ? void 0 : options.fetchOptions) {
+      if ((_a = options == null ? void 0 : options.fetchOptions) == null ? void 0 : _a.headers) {
+        Object.entries(options.fetchOptions.headers).forEach(([key2, value]) => {
+          headers.append(key2, value);
+        });
+      }
+    }
+    const { headers: _, ...providedFetchOptions } = (options == null ? void 0 : options.fetchOptions) || {};
+    const bodyString = JSON.stringify({
+      query: args.query,
+      variables: (args == null ? void 0 : args.variables) || {}
+    });
+    const optionsObject = {
+      method: "POST",
+      headers,
+      body: bodyString,
+      redirect: "follow",
+      ...providedFetchOptions
+    };
+    const draftBranch = headers.get("x-branch");
+    const url = replaceGithubPathSplit((args == null ? void 0 : args.url) || this.apiUrl, draftBranch);
+    let key = "";
+    let result;
+    if (this.cache) {
+      key = this.cache.makeKey(bodyString);
+      await this.cacheLock.acquire(key, async () => {
+        result = await this.cache.get(key);
+        if (!result) {
+          result = await requestFromServer(
+            url,
+            args.query,
+            optionsObject,
+            errorPolicyDefined
+          );
+          await this.cache.set(key, result);
+        }
+      });
+    } else {
+      result = await requestFromServer(
+        url,
+        args.query,
+        optionsObject,
+        errorPolicyDefined
+      );
+    }
+    return result;
+  }
+}
+async function requestFromServer(url, query, optionsObject, errorPolicyDefined) {
+  const res = await fetch(url, optionsObject);
+  if (!res.ok) {
+    let additionalInfo = "";
+    if (res.status === 401) {
+      additionalInfo = "Please check that your client ID, URL and read only token are configured properly.";
+    }
+    throw new Error(
+      `Server responded with status code ${res.status}, ${res.statusText}. ${additionalInfo ? additionalInfo : ""} Please see our FAQ for more information: https://tina.io/docs/r/FAQ/`
+    );
+  }
+  const json = await res.json();
+  if (json.errors && errorPolicyDefined === "throw") {
+    throw new Error(
+      `Unable to fetch, please see our FAQ for more information: https://tina.io/docs/r/FAQ/
+      Errors: 
+	${json.errors.map((error) => error.message).join("\n")}`
+    );
+  }
+  const result = {
+    data: json == null ? void 0 : json.data,
+    errors: (json == null ? void 0 : json.errors) || null,
+    query
+  };
+  return result;
+}
+function createClient(args) {
+  const client = new TinaClient(args);
+  return client;
+}
+export {
+  AsyncLock,
+  TINA_HOST,
+  TinaClient,
+  createClient
+};

package/dist/client.d.ts

@@ -1,4 +1,7 @@
-/**
-
-*/
 export * from './unifiedClient';
+import { TinaClient as BaseTinaClient } from './unifiedClient';
+import type { TinaClientArgs } from './unifiedClient';
+export declare class TinaClient<GenQueries> extends BaseTinaClient<GenQueries> {
+    protected createCache(dir: string): Promise<import("./cache").Cache>;
+}
+export declare function createClient<GenQueries>(args: TinaClientArgs<GenQueries>): TinaClient<GenQueries>;

package/dist/client.js

@@ -1,125 +1,3 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res, err) => function __init() {
-  if (err) throw err[0];
-  try {
-    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-  } catch (e) {
-    throw err = [e], e;
-  }
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/cache/node-cache.ts
-var node_cache_exports = {};
-__export(node_cache_exports, {
-  NodeCache: () => NodeCache,
-  makeCacheDir: () => makeCacheDir
-});
-var resolveModule, getRootPath, makeCacheDir, NodeCache;
-var init_node_cache = __esm({
-  "src/cache/node-cache.ts"() {
-    resolveModule = (mod) => {
-      if (mod && typeof mod === "object" && "default" in mod && mod.default) {
-        return mod.default;
-      }
-      return mod;
-    };
-    getRootPath = (pathParts, pathArg) => {
-      if (pathParts.length === 0) return null;
-      const isWindows = pathArg.sep === "\\";
-      const root = pathParts[0];
-      return isWindows ? `${root}${pathArg.sep}` : `${pathArg.sep}${root}`;
-    };
-    makeCacheDir = (dir, fsArg, pathArg, osArg) => {
-      const normalizedDir = pathArg.normalize(dir);
-      const pathParts = normalizedDir.split(pathArg.sep).filter(Boolean);
-      const cacheHash = pathParts[pathParts.length - 1];
-      const rootPath = getRootPath(pathParts, pathArg);
-      const rootExists = rootPath && fsArg.existsSync(rootPath);
-      const cacheDir = rootExists ? normalizedDir : pathArg.join(osArg.tmpdir(), cacheHash);
-      try {
-        fsArg.mkdirSync(cacheDir, { recursive: true });
-      } catch (error) {
-        console.warn(
-          `Warning: Failed to create cache directory: ${error.message}. Caching will be disabled.`
-        );
-        return null;
-      }
-      return cacheDir;
-    };
-    NodeCache = async (dir) => {
-      try {
-        const [fsModule, pathModule, osModule, cryptoModule] = await Promise.all([
-          import("node:fs"),
-          import("node:path"),
-          import("node:os"),
-          import("node:crypto")
-        ]);
-        const fs = resolveModule(fsModule);
-        const path = resolveModule(pathModule);
-        const os = resolveModule(osModule);
-        const crypto = resolveModule(cryptoModule);
-        if (typeof path?.join !== "function") {
-          console.warn(
-            "Warning: Node.js path module not available. Caching will be disabled."
-          );
-          return null;
-        }
-        const cacheDir = makeCacheDir(dir, fs, path, os);
-        if (cacheDir === null) {
-          return null;
-        }
-        return {
-          makeKey: (key) => {
-            const input = key && key instanceof Object ? JSON.stringify(key) : key || "";
-            return crypto.createHash("sha256").update(input).digest("hex");
-          },
-          get: async (key) => {
-            let readValue;
-            const cacheFilename = path.join(cacheDir, key);
-            try {
-              const data = await fs.promises.readFile(cacheFilename, "utf-8");
-              readValue = JSON.parse(data);
-            } catch (e) {
-              if (e.code !== "ENOENT") {
-                console.warn(
-                  `Warning: Failed to read cache file ${cacheFilename}: ${e.message}`
-                );
-              }
-            }
-            return readValue;
-          },
-          set: async (key, value) => {
-            const cacheFilename = path.join(cacheDir, key);
-            try {
-              await fs.promises.writeFile(cacheFilename, JSON.stringify(value), {
-                encoding: "utf-8",
-                flag: "wx"
-              });
-            } catch (e) {
-              if (e.code !== "EEXIST") {
-                console.warn(
-                  `Warning: Failed to write cache file ${cacheFilename}: ${e.message}`
-                );
-              }
-            }
-          }
-        };
-      } catch (e) {
-        console.warn(
-          "Warning: Failed to initialize cache. Caching will be disabled.",
-          e.message
-        );
-        return null;
-      }
-    };
-  }
-});
-
 // src/unifiedClient/asyncLock.ts
 var AsyncLock = class {
   queues = /* @__PURE__ */ new Map();
@@ -187,8 +65,7 @@ var TinaClient = class {
     }
     try {
       if (this.cacheEnabled && this.cacheDir && typeof window === "undefined" && !isEdgeRuntimeWithoutFs()) {
-        const { NodeCache: NodeCache2 } = await Promise.resolve().then(() => (init_node_cache(), node_cache_exports));
-        this.cache = await NodeCache2(this.cacheDir);
+        this.cache = await this.createCache(this.cacheDir);
         if (this.cache) {
           this.cacheLock = new AsyncLock();
         }
@@ -198,6 +75,9 @@ var TinaClient = class {
     }
     this.initialized = true;
   }
+  async createCache(_dir) {
+    return null;
+  }
   async request({ errorPolicy, ...args }, options) {
     await this.init();
     const errorPolicyDefined = errorPolicy || this.errorPolicy;
@@ -280,13 +160,116 @@ async function requestFromServer(url, query, optionsObject, errorPolicyDefined)
   };
   return result;
 }
+
+// src/cache/node-cache.ts
+var resolveModule = (mod) => {
+  if (mod && typeof mod === "object" && "default" in mod && mod.default) {
+    return mod.default;
+  }
+  return mod;
+};
+var getRootPath = (pathParts, pathArg) => {
+  if (pathParts.length === 0) return null;
+  const isWindows = pathArg.sep === "\\";
+  const root = pathParts[0];
+  return isWindows ? `${root}${pathArg.sep}` : `${pathArg.sep}${root}`;
+};
+var makeCacheDir = (dir, fsArg, pathArg, osArg) => {
+  const normalizedDir = pathArg.normalize(dir);
+  const pathParts = normalizedDir.split(pathArg.sep).filter(Boolean);
+  const cacheHash = pathParts[pathParts.length - 1];
+  const rootPath = getRootPath(pathParts, pathArg);
+  const rootExists = rootPath && fsArg.existsSync(rootPath);
+  const cacheDir = rootExists ? normalizedDir : pathArg.join(osArg.tmpdir(), cacheHash);
+  try {
+    fsArg.mkdirSync(cacheDir, { recursive: true });
+  } catch (error) {
+    console.warn(
+      `Warning: Failed to create cache directory: ${error.message}. Caching will be disabled.`
+    );
+    return null;
+  }
+  return cacheDir;
+};
+var NodeCache = async (dir) => {
+  try {
+    const [fsModule, pathModule, osModule, cryptoModule] = await Promise.all([
+      import("node:fs"),
+      import("node:path"),
+      import("node:os"),
+      import("node:crypto")
+    ]);
+    const fs = resolveModule(fsModule);
+    const path = resolveModule(pathModule);
+    const os = resolveModule(osModule);
+    const crypto = resolveModule(cryptoModule);
+    if (typeof path?.join !== "function") {
+      console.warn(
+        "Warning: Node.js path module not available. Caching will be disabled."
+      );
+      return null;
+    }
+    const cacheDir = makeCacheDir(dir, fs, path, os);
+    if (cacheDir === null) {
+      return null;
+    }
+    return {
+      makeKey: (key) => {
+        const input = key && key instanceof Object ? JSON.stringify(key) : key || "";
+        return crypto.createHash("sha256").update(input).digest("hex");
+      },
+      get: async (key) => {
+        let readValue;
+        const cacheFilename = path.join(cacheDir, key);
+        try {
+          const data = await fs.promises.readFile(cacheFilename, "utf-8");
+          readValue = JSON.parse(data);
+        } catch (e) {
+          if (e.code !== "ENOENT") {
+            console.warn(
+              `Warning: Failed to read cache file ${cacheFilename}: ${e.message}`
+            );
+          }
+        }
+        return readValue;
+      },
+      set: async (key, value) => {
+        const cacheFilename = path.join(cacheDir, key);
+        try {
+          await fs.promises.writeFile(cacheFilename, JSON.stringify(value), {
+            encoding: "utf-8",
+            flag: "wx"
+          });
+        } catch (e) {
+          if (e.code !== "EEXIST") {
+            console.warn(
+              `Warning: Failed to write cache file ${cacheFilename}: ${e.message}`
+            );
+          }
+        }
+      }
+    };
+  } catch (e) {
+    console.warn(
+      "Warning: Failed to initialize cache. Caching will be disabled.",
+      e.message
+    );
+    return null;
+  }
+};
+
+// src/client.ts
+var TinaClient2 = class extends TinaClient {
+  createCache(dir) {
+    return NodeCache(dir);
+  }
+};
 function createClient(args) {
-  const client = new TinaClient(args);
-  return client;
+  return new TinaClient2(args);
 }
 export {
   AsyncLock,
   TINA_HOST,
-  TinaClient,
+  TinaClient2 as TinaClient,
   createClient
 };

package/dist/index.js

@@ -32,7 +32,7 @@ import { useHTMLInputCursorState, useComboboxInput } from "@udecode/plate-combob
 import { useComboboxContext, Combobox as Combobox$1, useComboboxStore, ComboboxProvider, Portal, ComboboxPopover, ComboboxItem } from "@ariakit/react";
 import { filterWords } from "@udecode/plate-combobox";
 import { toggleList, unwrapList, getListItemEntry } from "@udecode/plate-list";
-import { normalizeHeadingLevels, ALL_HEADING_LEVELS, MEDIA_MIME_TYPES, extensionOf, resolveMediaAccept, ASYNC_POLLER_ERROR, MEDIA_CATEGORIES, canonicalPath, ERR_BRANCH_EXISTS, ERR_BRANCH_CONFLICT, isHeadingLevel, TinaSchema, addNamespaceToSchema, parseURL, ERR_HAS_REFERENCES, ERR_ALREADY_EXISTS, isValidRelativePath, RELATIVE_PATH_ALLOWED_CHARS_MESSAGE, resolveForm, RELATIVE_PATH_REGEX, normalizePath, ERR_NOT_INDEXED, validateSchema } from "@tinacms/schema-tools";
+import { normalizeHeadingLevels, ALL_HEADING_LEVELS, MEDIA_MIME_TYPES, extensionOf, resolveMediaAccept, ASYNC_POLLER_ERROR, ERR_BRANCH_EXISTS, ERR_BRANCH_CONFLICT, MEDIA_CATEGORIES, canonicalPath, isHeadingLevel, TinaSchema, addNamespaceToSchema, parseURL, ERR_HAS_REFERENCES, ERR_ALREADY_EXISTS, isValidRelativePath, RELATIVE_PATH_ALLOWED_CHARS_MESSAGE, resolveForm, RELATIVE_PATH_REGEX, normalizePath, ERR_NOT_INDEXED, validateSchema } from "@tinacms/schema-tools";
 import { NAMER, resolveField } from "@tinacms/schema-tools";
 import { useBlockSelected, BlockSelectionPlugin } from "@udecode/plate-selection/react";
 import "@udecode/plate-dnd";
@@ -5361,6 +5361,7 @@ const Toggle = ({
   disabled = false
 }) => {
   const checked = !!(input.value || input.checked);
+  const inputId = name2 ?? input.name;
   let labels = null;
   if (field.toggleLabels) {
     const fieldLabels = typeof field.toggleLabels === "object" && "true" in field.toggleLabels && "false" in field.toggleLabels && field.toggleLabels;
@@ -5375,7 +5376,7 @@ const Toggle = ({
       className: `text-sm ${!checked ? "text-blue-500 font-bold" : "text-gray-300"}`
     },
     labels.false
-  ), /* @__PURE__ */ React.createElement("div", { className: "relative w-12 h-7" }, /* @__PURE__ */ React.createElement(ToggleInput, { id: name2, type: "checkbox", ...input }), /* @__PURE__ */ React.createElement(
+  ), /* @__PURE__ */ React.createElement("div", { className: "relative w-12 h-7" }, /* @__PURE__ */ React.createElement(ToggleInput, { type: "checkbox", ...input, id: inputId }), /* @__PURE__ */ React.createElement(
     "label",
     {
       className: "bg-none p-0 outline-none w-12 h-7",
@@ -5383,7 +5384,7 @@ const Toggle = ({
         opacity: disabled ? 0.4 : 1,
         pointerEvents: disabled ? "none" : "inherit"
       },
-      htmlFor: name2,
+      htmlFor: inputId,
       role: "switch"
     },
     /* @__PURE__ */ React.createElement("div", { className: "relative w-[48px] h-7 rounded-3xl bg-white shadow-inner border border-gray-200 pointer-events-none -ml-0.5" }, /* @__PURE__ */ React.createElement(
@@ -8912,6 +8913,20 @@ function useLocalStorage(key, initialValue) {
   };
   return [storedValue, setValue];
 }
+const EditorialWorkflowErrorBox = ({
+  error
+}) => /* @__PURE__ */ React__default.createElement("div", { className: "flex items-start gap-1 text-red-700 py-2 px-3 mb-4 bg-red-50 border border-red-200 rounded" }, /* @__PURE__ */ React__default.createElement(CircleAlert, { className: "w-5 h-auto text-red-400 flex-shrink-0" }), /* @__PURE__ */ React__default.createElement("span", { className: "text-sm whitespace-pre-line" }, /* @__PURE__ */ React__default.createElement("b", null, "Error:"), " ", error.messageParts.map(
+  (part, index) => part.emphasis ? /* @__PURE__ */ React__default.createElement("b", { key: index }, part.text) : /* @__PURE__ */ React__default.createElement(React__default.Fragment, { key: index }, part.text)
+), error.link && /* @__PURE__ */ React__default.createElement(React__default.Fragment, null, " ", /* @__PURE__ */ React__default.createElement(
+  "a",
+  {
+    className: "underline text-tina-orange-dark font-medium",
+    href: error.link.url,
+    target: "_blank",
+    rel: "noreferrer"
+  },
+  error.link.label
+))));
 const Badge = ({
   children,
   calloutStyle = "warning",
@@ -10244,8 +10259,10 @@ const EDITORIAL_WORKFLOW_STATUS = {
 const EDITORIAL_WORKFLOW_ERROR = {
   BRANCH_EXISTS: "BRANCH_EXISTS",
   BRANCH_HIERARCHY_CONFLICT: "BRANCH_HIERARCHY_CONFLICT",
-  VALIDATION_FAILED: "VALIDATION_FAILED"
+  VALIDATION_FAILED: "VALIDATION_FAILED",
+  INDEXING_FAILED: "INDEXING_FAILED"
 };
+const EDITORIAL_WORKFLOW_EVENT_LOG_DOCS_URL = "https://tina.io/docs/tinacloud/dashboard/event-log#common-causes";
 const getEditorialWorkflowPrTitle = (branchName) => `${branchName.replace("tina/", "").replaceAll("-", " ")} (PR from TinaCMS)`;
 const TARGET_BRANCH_EXISTS_ERROR = "A branch with this name already exists";
 const checkBranchExists = async (tinaApi, branchName, debugLabel, branchType, fallback, signal) => {
@@ -10301,6 +10318,71 @@ const checkBranchGuard = async (tinaApi, baseBranch, targetBranch, debugLabel, s
     return { baseBranchExists: true, targetBranchExists: false };
   }
 };
+const plainMessage = (text) => [
+  { text }
+];
+const messageText = (parts) => parts.map((part) => part.text).join("");
+const pageNameFrom = (file) => {
+  var _a;
+  return ((_a = file.split("/").pop()) == null ? void 0 : _a.replace(/\.[^.]+$/, "")) || file;
+};
+const indexingFailureCopy = (file, collectionLabel) => {
+  const subject = file ? `“${pageNameFrom(file)}”` : "your content";
+  const messageParts = [
+    { text: "We couldn't save your changes, because there's a problem with " },
+    { text: subject, emphasis: true },
+    ...collectionLabel ? [{ text: " in " }, { text: collectionLabel, emphasis: true }] : [],
+    { text: ".\n\nFix that page, then save again." }
+  ];
+  return {
+    messageParts,
+    link: {
+      url: EDITORIAL_WORKFLOW_EVENT_LOG_DOCS_URL,
+      label: "How to resolve this"
+    }
+  };
+};
+const collectionLabelResolver = (schema) => (file) => {
+  var _a;
+  try {
+    const collection = (_a = schema == null ? void 0 : schema.getCollectionByFullPath) == null ? void 0 : _a.call(schema, file);
+    return (collection == null ? void 0 : collection.label) || (collection == null ? void 0 : collection.name);
+  } catch {
+    return void 0;
+  }
+};
+const getEditorialWorkflowError = (e, resolveCollectionLabel) => {
+  let errMessage = "Branch operation failed. Talking to GitHub was unsuccessful, please try again. If the problem persists please contact support at https://tina.io/support 🦙";
+  const err = e;
+  if (err.errorCode) {
+    switch (err.errorCode) {
+      case EDITORIAL_WORKFLOW_ERROR.BRANCH_EXISTS:
+        errMessage = "A branch with this name already exists";
+        break;
+      case EDITORIAL_WORKFLOW_ERROR.BRANCH_HIERARCHY_CONFLICT:
+        errMessage = err.message || "Branch name conflicts with an existing branch";
+        break;
+      case EDITORIAL_WORKFLOW_ERROR.VALIDATION_FAILED:
+        errMessage = err.message || "Invalid branch name";
+        break;
+      case EDITORIAL_WORKFLOW_ERROR.INDEXING_FAILED:
+        return indexingFailureCopy(
+          err.file,
+          err.file ? resolveCollectionLabel == null ? void 0 : resolveCollectionLabel(err.file) : void 0
+        );
+      default:
+        errMessage = err.message || errMessage;
+        break;
+    }
+  } else if (err.message) {
+    if (err.message.toLowerCase().includes(ERR_BRANCH_EXISTS)) {
+      errMessage = "A branch with this name already exists";
+    } else if (err.message.toLowerCase().includes(ERR_BRANCH_CONFLICT)) {
+      errMessage = err.message;
+    }
+  }
+  return { messageParts: plainMessage(errMessage) };
+};
 const MEDIA_WORKFLOW_STEP = {
   BRANCH: 1,
   CONTENT: 2,
@@ -10604,7 +10686,8 @@ class TinaMediaStore {
   dispatchMediaWorkflowError(err) {
     this.cms.events.dispatch({
       type: "media:workflow:error",
-      message: err instanceof Error ? err.message : String(err)
+      message: err instanceof Error ? err.message : String(err),
+      error: err
     });
   }
   async runMediaOpWithWorkflow(decision, op) {
@@ -14222,12 +14305,12 @@ const FormModal = ({ plugin, close: close2 }) => {
 const name = "tinacms";
 const type = "module";
 const typings = "dist/index.d.ts";
-const version = "3.14.0";
+const version = "3.14.1";
 const main = "dist/index.js";
 const module$1 = "./dist/index.js";
-const exports$1 = { ".": "./dist/index.js", "./dist/client": "./dist/client.js", "./react": "./dist/react.js", "./dist/react": "./dist/react.js", "./tina-field": "./dist/tina-field.js", "./dist/tina-field": "./dist/tina-field.js", "./dist/rich-text": "./dist/rich-text/index.js", "./dist/rich-text/static": "./dist/rich-text/static.js", "./dist/rich-text/prism": "./dist/rich-text/prism.js" };
+const exports$1 = { ".": "./dist/index.js", "./dist/client": { "types": "./dist/client.d.ts", "browser": "./dist/client.browser.js", "default": "./dist/client.js" }, "./react": "./dist/react.js", "./dist/react": "./dist/react.js", "./tina-field": "./dist/tina-field.js", "./dist/tina-field": "./dist/tina-field.js", "./dist/rich-text": "./dist/rich-text/index.js", "./dist/rich-text/static": "./dist/rich-text/static.js", "./dist/rich-text/prism": "./dist/rich-text/prism.js" };
 const files = ["dist"];
-const buildConfig = { "entryPoints": ["src/index.ts", "src/rich-text/index.tsx", "src/rich-text/static.tsx", "src/rich-text/prism.tsx", "src/react.tsx", "src/tina-field.ts", { "name": "src/client.ts", "target": "node" }] };
+const buildConfig = { "entryPoints": ["src/index.ts", "src/rich-text/index.tsx", "src/rich-text/static.tsx", "src/rich-text/prism.tsx", "src/react.tsx", "src/tina-field.ts", { "name": "src/client.ts", "target": "node" }, "src/client.browser.ts"] };
 const license = "Apache-2.0";
 const scripts = { "types": "pnpm tsc && pnpm tsc-alias", "build": "tinacms-scripts build", "test": "vitest run", "test-watch": "vitest" };
 const dependencies = { "@ariakit/react": "catalog:", "@dnd-kit/core": "catalog:", "@dnd-kit/sortable": "catalog:", "@dnd-kit/utilities": "catalog:", "@floating-ui/dom": "catalog:", "@floating-ui/react-dom": "catalog:", "@graphql-inspector/core": "^6.2.1", "@radix-ui/react-dialog": "catalog:", "@radix-ui/react-dropdown-menu": "catalog:", "@radix-ui/react-popover": "catalog:", "@radix-ui/react-select": "catalog:", "@radix-ui/react-separator": "catalog:", "@radix-ui/react-slot": "catalog:", "@radix-ui/react-toolbar": "catalog:", "@radix-ui/react-tooltip": "catalog:", "@react-hook/window-size": "catalog:", "@tanstack/react-table": "^8.21.3", "@tinacms/bridge": "workspace:^", "@tinacms/mdx": "workspace:^", "@tinacms/schema-tools": "workspace:^", "@tinacms/search": "workspace:^", "@udecode/cmdk": "catalog:", "@udecode/cn": "catalog:", "@udecode/plate": "catalog:", "@udecode/plate-autoformat": "catalog:", "@udecode/plate-basic-marks": "catalog:", "@udecode/plate-block-quote": "catalog:", "@udecode/plate-break": "catalog:", "@udecode/plate-code-block": "catalog:", "@udecode/plate-combobox": "catalog:", "@udecode/plate-dnd": "catalog:", "@udecode/plate-floating": "catalog:", "@udecode/plate-heading": "catalog:", "@udecode/plate-highlight": "catalog:", "@udecode/plate-horizontal-rule": "catalog:", "@udecode/plate-indent-list": "catalog:", "@udecode/plate-link": "catalog:", "@udecode/plate-list": "catalog:", "@udecode/plate-node-id": "catalog:", "@udecode/plate-reset-node": "catalog:", "@udecode/plate-resizable": "catalog:", "@udecode/plate-selection": "catalog:", "@udecode/plate-slash-command": "catalog:", "@udecode/plate-table": "catalog:", "@udecode/plate-trailing-block": "catalog:", "class-variance-authority": "catalog:", "clsx": "catalog:", "cmdk": "catalog:", "color-string": "catalog:", "date-fns": "4.1.0", "es-toolkit": "^1.42.0", "final-form": "catalog:", "final-form-arrays": "catalog:", "final-form-set-field-data": "catalog:", "graphql": "15.8.0", "graphql-tag": "catalog:", "is-hotkey": "catalog:", "lucide-react": "catalog:", "mermaid": "catalog:", "posthog-js": "^1.347.1", "prism-react-renderer": "catalog:", "prop-types": "catalog:", "react-colorful": "catalog:", "react-day-picker": "^9.13.0", "react-dnd": "catalog:", "react-dnd-html5-backend": "catalog:", "react-dropzone": "catalog:", "react-final-form": "catalog:", "react-router-dom": "catalog:", "react-use": "catalog:", "tailwind-merge": "^2.6.0", "webfontloader": "catalog:", "yup": "^1.6.1", "zod": "catalog:" };
@@ -17277,39 +17360,12 @@ const formatTime = (seconds) => {
   const secs = seconds % 60;
   return `${mins}:${secs.toString().padStart(2, "0")}`;
 };
-const getEditorialWorkflowErrorMessage = (e) => {
-  let errMessage = "Branch operation failed. Talking to GitHub was unsuccessful, please try again. If the problem persists please contact support at https://tina.io/support 🦙";
-  const err = e;
-  if (err.errorCode) {
-    switch (err.errorCode) {
-      case EDITORIAL_WORKFLOW_ERROR.BRANCH_EXISTS:
-        errMessage = "A branch with this name already exists";
-        break;
-      case EDITORIAL_WORKFLOW_ERROR.BRANCH_HIERARCHY_CONFLICT:
-        errMessage = err.message || "Branch name conflicts with an existing branch";
-        break;
-      case EDITORIAL_WORKFLOW_ERROR.VALIDATION_FAILED:
-        errMessage = err.message || "Invalid branch name";
-        break;
-      default:
-        errMessage = err.message || errMessage;
-        break;
-    }
-  } else if (err.message) {
-    if (err.message.toLowerCase().includes(ERR_BRANCH_EXISTS)) {
-      errMessage = "A branch with this name already exists";
-    } else if (err.message.toLowerCase().includes(ERR_BRANCH_CONFLICT)) {
-      errMessage = err.message;
-    }
-  }
-  return errMessage;
-};
 function useEditorialWorkflow() {
   const cms = useCMS$1();
   const tinaApi = cms.api.tina;
   const { setCurrentBranch } = useBranchData();
   const [isExecuting, setIsExecuting] = React.useState(false);
-  const [errorMessage, setErrorMessage] = React.useState("");
+  const [error, setError] = React.useState(void 0);
   const [currentStep, setCurrentStep] = React.useState(0);
   const [elapsedTime, setElapsedTime] = React.useState(0);
   React.useEffect(() => {
@@ -17326,7 +17382,7 @@ function useEditorialWorkflow() {
     };
   }, [isExecuting, currentStep]);
   const reset = () => {
-    setErrorMessage("");
+    setError(void 0);
     setIsExecuting(false);
     setCurrentStep(0);
   };
@@ -17352,7 +17408,7 @@ function useEditorialWorkflow() {
       );
       if (signal == null ? void 0 : signal.aborted) return { success: false };
       if (targetBranchExists) {
-        setErrorMessage(TARGET_BRANCH_EXISTS_ERROR);
+        setError({ messageParts: plainMessage(TARGET_BRANCH_EXISTS_ERROR) });
         setIsExecuting(false);
         setCurrentStep(0);
         return { success: false, error: TARGET_BRANCH_EXISTS_ERROR };
@@ -17430,16 +17486,19 @@ function useEditorialWorkflow() {
       return { success: true };
     } catch (e) {
       console.error(e);
-      const errMessage = getEditorialWorkflowErrorMessage(e);
-      setErrorMessage(errMessage);
+      const copy = getEditorialWorkflowError(
+        e,
+        collectionLabelResolver(cms.api.tina.schema)
+      );
+      setError(copy);
       setIsExecuting(false);
       setCurrentStep(0);
-      return { success: false, error: errMessage };
+      return { success: false, error: messageText(copy.messageParts) };
     }
   };
   return {
     isExecuting,
-    errorMessage,
+    error,
     currentStep,
     elapsedTime,
     executeWorkflow,
@@ -17556,7 +17615,7 @@ const CreateBranchModal = ({
   const branchGuardAbortRef = React.useRef(null);
   const {
     isExecuting,
-    errorMessage,
+    error,
     currentStep,
     elapsedTime,
     executeWorkflow,
@@ -17598,7 +17657,7 @@ const CreateBranchModal = ({
       return;
     }
     setIsBranchGuardChecking(false);
-    const { success, error } = await executeWorkflow({
+    const { success, error: error2 } = await executeWorkflow({
       branchName: targetBranch,
       baseBranch,
       path,
@@ -17616,7 +17675,7 @@ const CreateBranchModal = ({
     captureEvent(EditorialWorkflowSaveEvent, {
       choice: isDraft ? "draft" : "review",
       success,
-      error
+      error: error2
     });
     if (success) {
       close2();
@@ -17640,7 +17699,7 @@ const CreateBranchModal = ({
         abortBranchGuard();
         close2();
       },
-      errorMessage,
+      error,
       disabled: normalizedBranchName === "" || isBranchGuardChecking,
       onBranchNameChange: (value) => {
         abortBranchGuard();
@@ -17691,7 +17750,7 @@ const CreateBranchPromptModal = ({
   branchName,
   close: close2,
   disabled,
-  errorMessage,
+  error,
   onBranchNameChange,
   onCreateBranch,
   onSaveToProtectedBranch,
@@ -17725,7 +17784,7 @@ const CreateBranchPromptModal = ({
   };
   const mainChoice = choices[main2] ?? choices.draft;
   const MainIcon = mainChoice.Icon;
-  return /* @__PURE__ */ React.createElement(Modal, { className: "flex" }, /* @__PURE__ */ React.createElement(PopupModal, { className: "w-auto" }, /* @__PURE__ */ React.createElement(ModalHeader, { close: close2 }, /* @__PURE__ */ React.createElement("div", { className: "flex items-center justify-between w-full" }, /* @__PURE__ */ React.createElement("div", { className: "flex items-center" }, "Save changes to new branch"))), /* @__PURE__ */ React.createElement(ModalBody, { padded: true }, /* @__PURE__ */ React.createElement("div", { className: "max-w-sm" }, errorMessage && /* @__PURE__ */ React.createElement("div", { className: "flex items-center gap-1 text-red-700 py-2 px-3 mb-4 bg-red-50 border border-red-200 rounded" }, /* @__PURE__ */ React.createElement(CircleAlert, { className: "w-5 h-auto text-red-400 flex-shrink-0" }), /* @__PURE__ */ React.createElement("span", { className: "text-sm" }, /* @__PURE__ */ React.createElement("b", null, "Error:"), " ", errorMessage)), /* @__PURE__ */ React.createElement("p", { className: "text-lg text-gray-700 font-bold mb-2" }, "First, let's create a copy"), /* @__PURE__ */ React.createElement("p", { className: "text-sm text-gray-700 mb-4 max-w-sm" }, "To make changes, you need to create a copy then get it approved and merged for it to go live.", /* @__PURE__ */ React.createElement("br", null), /* @__PURE__ */ React.createElement("br", null), /* @__PURE__ */ React.createElement("span", { className: "text-gray-500" }, "Learn more about "), /* @__PURE__ */ React.createElement(
+  return /* @__PURE__ */ React.createElement(Modal, { className: "flex" }, /* @__PURE__ */ React.createElement(PopupModal, { className: "w-auto" }, /* @__PURE__ */ React.createElement(ModalHeader, { close: close2 }, /* @__PURE__ */ React.createElement("div", { className: "flex items-center justify-between w-full" }, /* @__PURE__ */ React.createElement("div", { className: "flex items-center" }, "Save changes to new branch"))), /* @__PURE__ */ React.createElement(ModalBody, { padded: true }, /* @__PURE__ */ React.createElement("div", { className: "max-w-sm" }, error && /* @__PURE__ */ React.createElement(EditorialWorkflowErrorBox, { error }), /* @__PURE__ */ React.createElement("p", { className: "text-lg text-gray-700 font-bold mb-2" }, "First, let's create a copy"), /* @__PURE__ */ React.createElement("p", { className: "text-sm text-gray-700 mb-4 max-w-sm" }, "To make changes, you need to create a copy then get it approved and merged for it to go live.", /* @__PURE__ */ React.createElement("br", null), /* @__PURE__ */ React.createElement("br", null), /* @__PURE__ */ React.createElement("span", { className: "text-gray-500" }, "Learn more about "), /* @__PURE__ */ React.createElement(
     "a",
     {
       className: "underline text-tina-orange-dark font-medium",
@@ -17852,7 +17911,7 @@ const BranchDeletedModal = ({
   const baseBranch = tinaApi.protectedBranches[0] || cms.api.tina.schema.config.config.repoProvider.defaultBranchName || "main";
   const {
     isExecuting,
-    errorMessage,
+    error,
     currentStep,
     elapsedTime,
     executeWorkflow,
@@ -17882,7 +17941,7 @@ const BranchDeletedModal = ({
       className: "w-4 h-4 mt-0.5 flex-shrink-0 text-yellow-600",
       style: { fill: "none" }
     }
-  ), /* @__PURE__ */ React.createElement("span", null, "The branch", " ", /* @__PURE__ */ React.createElement("span", { className: "font-mono font-semibold" }, branchName), " ", "no longer exists. It may have been merged or deleted. Your changes cannot be pushed to it.")), /* @__PURE__ */ React.createElement("p", { className: "text-sm text-gray-700 mb-4" }, "Create a new branch from", " ", /* @__PURE__ */ React.createElement("span", { className: "font-mono font-semibold" }, baseBranch), " to continue editing, or cancel and switch to an existing branch from the branch menu."), errorMessage && /* @__PURE__ */ React.createElement("div", { className: "flex items-center gap-1 text-red-700 py-2 px-3 mb-4 bg-red-50 border border-red-200 rounded" }, /* @__PURE__ */ React.createElement(CircleAlert, { className: "w-5 h-auto text-red-400 flex-shrink-0" }), /* @__PURE__ */ React.createElement("span", { className: "text-sm" }, /* @__PURE__ */ React.createElement("b", null, "Error:"), " ", errorMessage)), /* @__PURE__ */ React.createElement(
+  ), /* @__PURE__ */ React.createElement("span", null, "The branch", " ", /* @__PURE__ */ React.createElement("span", { className: "font-mono font-semibold" }, branchName), " ", "no longer exists. It may have been merged or deleted. Your changes cannot be pushed to it.")), /* @__PURE__ */ React.createElement("p", { className: "text-sm text-gray-700 mb-4" }, "Create a new branch from", " ", /* @__PURE__ */ React.createElement("span", { className: "font-mono font-semibold" }, baseBranch), " to continue editing, or cancel and switch to an existing branch from the branch menu."), error && /* @__PURE__ */ React.createElement(EditorialWorkflowErrorBox, { error }), /* @__PURE__ */ React.createElement(
     PrefixedTextField,
     {
       name: "new-branch-name",
@@ -71665,12 +71724,15 @@ const MediaWorkflowOverlay = () => {
     const offComplete = cms.events.subscribe("media:workflow:complete", (event) => {
       setCurrentBranch(event.branchName);
     });
-    const offError = cms.events.subscribe(
-      "media:workflow:error",
-      (event) => {
-        setState({ phase: "error", message: event.message });
-      }
-    );
+    const offError = cms.events.subscribe("media:workflow:error", (event) => {
+      setState({
+        phase: "error",
+        error: event.error === void 0 ? { messageParts: plainMessage(event.message) } : getEditorialWorkflowError(
+          event.error,
+          collectionLabelResolver(cms.api.tina.schema)
+        )
+      });
+    });
     const offFinish = cms.events.subscribe("media:workflow:finish", () => {
       setState({ phase: "idle" });
     });
@@ -71704,7 +71766,7 @@ const MediaWorkflowOverlay = () => {
     setState({
       ...confirmState,
       isChecking: true,
-      errorMessage: ""
+      error: void 0
     });
     const { baseBranchExists, targetBranchExists } = await checkBranchGuard(
       cms.api.tina,
@@ -71722,7 +71784,11 @@ const MediaWorkflowOverlay = () => {
         ...confirmState,
         branchName,
         isChecking: false,
-        errorMessage: `The branch ${confirmState.baseBranch} no longer exists. It may have been merged or deleted. Your changes cannot be pushed to it.`
+        error: {
+          messageParts: plainMessage(
+            `The branch ${confirmState.baseBranch} no longer exists. It may have been merged or deleted. Your changes cannot be pushed to it.`
+          )
+        }
       });
       return;
     }
@@ -71734,7 +71800,7 @@ const MediaWorkflowOverlay = () => {
         ...confirmState,
         branchName,
         isChecking: false,
-        errorMessage: TARGET_BRANCH_EXISTS_ERROR
+        error: { messageParts: plainMessage(TARGET_BRANCH_EXISTS_ERROR) }
       });
       return;
     }
@@ -71750,7 +71816,10 @@ const MediaWorkflowOverlay = () => {
         ...confirmState,
         branchName,
         isChecking: false,
-        errorMessage: getEditorialWorkflowErrorMessage(e)
+        error: getEditorialWorkflowError(
+          e,
+          collectionLabelResolver(cms.api.tina.schema)
+        )
       });
     }
   };
@@ -71766,14 +71835,14 @@ const MediaWorkflowOverlay = () => {
           setState({ phase: "idle" });
         },
         disabled: normalizeBranchName(state.branchName) === "" || state.isChecking,
-        errorMessage: state.errorMessage,
+        error: state.error,
         onBranchNameChange: (branchName) => {
           abortPreflight();
           setState(
             (prev) => prev.phase === "confirming" ? {
               ...prev,
               branchName,
-              errorMessage: void 0,
+              error: void 0,
               isChecking: false
             } : prev
           );
@@ -71799,7 +71868,7 @@ const MediaWorkflowOverlay = () => {
     );
   }
   const dismissError = () => setState({ phase: "idle" });
-  return /* @__PURE__ */ React.createElement(Modal, { className: "flex" }, /* @__PURE__ */ React.createElement(PopupModal, { className: "w-auto" }, /* @__PURE__ */ React.createElement(ModalHeader, { close: dismissError }, "Branch creation failed"), /* @__PURE__ */ React.createElement(ModalBody, { padded: true }, /* @__PURE__ */ React.createElement("div", { className: "flex items-center gap-1 text-red-700 py-2 px-3 bg-red-50 border border-red-200 rounded max-w-sm" }, /* @__PURE__ */ React.createElement(CircleAlert, { className: "w-5 h-auto text-red-400 flex-shrink-0" }), /* @__PURE__ */ React.createElement("span", { className: "text-sm" }, /* @__PURE__ */ React.createElement("b", null, "Error:"), " ", state.message)))));
+  return /* @__PURE__ */ React.createElement(Modal, { className: "flex" }, /* @__PURE__ */ React.createElement(PopupModal, { className: "w-auto" }, /* @__PURE__ */ React.createElement(ModalHeader, { close: dismissError }, "Branch creation failed"), /* @__PURE__ */ React.createElement(ModalBody, { padded: true }, /* @__PURE__ */ React.createElement("div", { className: "max-w-sm" }, /* @__PURE__ */ React.createElement(EditorialWorkflowErrorBox, { error: state.error })))));
 };
 function asyncPoll(fn, pollInterval = 5 * 1e3, pollTimeout = 30 * 1e3) {
   const endTime = (/* @__PURE__ */ new Date()).getTime() + pollTimeout;
@@ -71968,6 +72037,7 @@ async function authenticate(clientId, identityApiUrl, frontendUrl) {
 const DefaultSessionProvider = ({
   children
 }) => /* @__PURE__ */ React__default.createElement(React__default.Fragment, null, children);
+const bearerToken = (token) => (token == null ? void 0 : token.id_token) ?? (token == null ? void 0 : token.access_token) ?? null;
 class AbstractAuthProvider {
   constructor() {
     /**
@@ -72003,8 +72073,7 @@ class AbstractAuthProvider {
     return res;
   }
   async getAccessToken() {
-    const token = await this.getToken();
-    return (token == null ? void 0 : token.access_token) ?? (token == null ? void 0 : token.id_token) ?? null;
+    return bearerToken(await this.getToken());
   }
   async authorize(context) {
     return this.getToken();
@@ -72409,7 +72478,7 @@ mutation addPendingDocumentMutation(
     const headers = {
       "Content-Type": "application/json"
     };
-    const accessToken = (token == null ? void 0 : token.id_token) ?? (token == null ? void 0 : token.access_token);
+    const accessToken = bearerToken(token);
     if (accessToken) {
       headers["Authorization"] = "Bearer " + accessToken;
     }
@@ -72755,6 +72824,9 @@ mutation addPendingDocumentMutation(
             statusResponseBody.message || "Editorial workflow failed"
           );
           error.errorCode = statusResponseBody.errorCode || "WORKFLOW_FAILED";
+          if (statusResponseBody.file) {
+            error.file = statusResponseBody.file;
+          }
           throw error;
         }
         if (statusResponse.status === 200) {
@@ -72795,6 +72867,9 @@ mutation addPendingDocumentMutation(
     if (responseBody == null ? void 0 : responseBody.conflictingBranch) {
       error.conflictingBranch = responseBody.conflictingBranch;
     }
+    if (responseBody == null ? void 0 : responseBody.file) {
+      error.file = responseBody.file;
+    }
     return error;
   }
   async postEditorialWorkflow(url, body, errorFallback) {

package/dist/internalClient/bearerToken.d.ts

@@ -0,0 +1,2 @@
+import type { TokenObject } from '@tinacms/schema-tools';
+export declare const bearerToken: (token: TokenObject | null | undefined) => string;

package/dist/toolkit/fields/components/toggle.d.ts

@@ -2,7 +2,7 @@ import { FC } from 'react';
 import * as React from 'react';
 import { Field } from '../../forms';
 export interface ToggleProps {
-    name: string;
+    name?: string;
     input: any;
     field: ToggleFieldDefinition;
     disabled?: boolean;
@@ -10,7 +10,7 @@ export interface ToggleProps {
     onChange?: <T>(_event: React.ChangeEvent<T> | any) => void;
     onFocus?: <T>(_event?: React.FocusEvent<T>) => void;
 }
-interface ToggleFieldDefinition extends Field {
+export interface ToggleFieldDefinition extends Field {
     component: 'toggle';
     toggleLabels?: boolean | FieldLabels;
 }

package/dist/toolkit/fields/plugins/toggle-field-plugin.d.ts

@@ -1,7 +1,7 @@
-export declare const ToggleField: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, {}>) => import("react").JSX.Element;
+export declare const ToggleField: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, import("..").ToggleFieldDefinition>) => import("react").JSX.Element;
 export declare const ToggleFieldPlugin: {
     name: string;
     type: string;
-    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, {}>) => import("react").JSX.Element;
+    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, import("..").ToggleFieldDefinition>) => import("react").JSX.Element;
     validate(value: any, values: any, meta: any, field: any): string;
 };

package/dist/toolkit/form-builder/create-branch-modal.d.ts

@@ -1,5 +1,6 @@
 import { Form } from '../forms';
 import * as React from 'react';
+import { type EditorialWorkflowErrorCopy } from './editorial-workflow-utils';
 import { type SaveChoice } from './save-options';
 export declare const CreateBranchModal: ({ close, safeSubmit, path, values, crudType, tinaForm, onBaseBranchDeleted, }: {
     safeSubmit: (editorialWorkflowChoice?: SaveChoice) => Promise<void>;
@@ -10,11 +11,11 @@ export declare const CreateBranchModal: ({ close, safeSubmit, path, values, crud
     tinaForm?: Form;
     onBaseBranchDeleted?: () => void;
 }) => React.JSX.Element;
-export declare const CreateBranchPromptModal: ({ branchName, close, disabled, errorMessage, onBranchNameChange, onCreateBranch, onSaveToProtectedBranch, showSaveOptions, disablePublish, allowSaveToProtectedBranch, }: {
+export declare const CreateBranchPromptModal: ({ branchName, close, disabled, error, onBranchNameChange, onCreateBranch, onSaveToProtectedBranch, showSaveOptions, disablePublish, allowSaveToProtectedBranch, }: {
     branchName: string;
     close: () => void;
     disabled?: boolean;
-    errorMessage?: string;
+    error?: EditorialWorkflowErrorCopy;
     onBranchNameChange: (value: string) => void;
     onCreateBranch: (isDraft: boolean) => void;
     onSaveToProtectedBranch: () => void;

package/dist/toolkit/form-builder/editorial-workflow-constants.d.ts

@@ -23,6 +23,7 @@ export declare const EDITORIAL_WORKFLOW_ERROR: {
     readonly BRANCH_EXISTS: "BRANCH_EXISTS";
     readonly BRANCH_HIERARCHY_CONFLICT: "BRANCH_HIERARCHY_CONFLICT";
     readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly INDEXING_FAILED: "INDEXING_FAILED";
 };
 export type EditorialWorkflowError = (typeof EDITORIAL_WORKFLOW_ERROR)[keyof typeof EDITORIAL_WORKFLOW_ERROR];
 /**
@@ -31,7 +32,9 @@ export type EditorialWorkflowError = (typeof EDITORIAL_WORKFLOW_ERROR)[keyof typ
 export type EditorialWorkflowErrorDetails = Error & {
     errorCode?: string;
     conflictingBranch?: string;
+    file?: string;
 };
+export declare const EDITORIAL_WORKFLOW_EVENT_LOG_DOCS_URL = "https://tina.io/docs/tinacloud/dashboard/event-log#common-causes";
 /**
  * Result from a completed editorial workflow operation
  */

package/dist/toolkit/form-builder/editorial-workflow-error-box.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { EditorialWorkflowErrorCopy } from './editorial-workflow-utils';
+export declare const EditorialWorkflowErrorBox: ({ error, }: {
+    error: EditorialWorkflowErrorCopy;
+}) => React.JSX.Element;

package/dist/toolkit/form-builder/editorial-workflow-utils.d.ts

@@ -1,3 +1,4 @@
+import { type TinaSchema } from '@tinacms/schema-tools';
 export interface MediaWorkflowConfirmBranchEvent {
     type: 'media:workflow:confirm-branch';
     branchName: string;
@@ -24,3 +25,19 @@ export declare const checkBranchGuard: (tinaApi: {
         signal?: AbortSignal;
     }) => Promise<Record<string, boolean>>;
 }, baseBranch: string, targetBranch: string, debugLabel: string, signal?: AbortSignal) => Promise<BranchGuardResult>;
+export interface EditorialWorkflowErrorLink {
+    url: string;
+    label: string;
+}
+export interface EditorialWorkflowMessagePart {
+    text: string;
+    emphasis?: boolean;
+}
+export interface EditorialWorkflowErrorCopy {
+    messageParts: EditorialWorkflowMessagePart[];
+    link?: EditorialWorkflowErrorLink;
+}
+export declare const plainMessage: (text: string) => EditorialWorkflowMessagePart[];
+export declare const messageText: (parts: EditorialWorkflowMessagePart[]) => string;
+export declare const collectionLabelResolver: (schema?: Pick<TinaSchema, "getCollectionByFullPath">) => (file: string) => string | undefined;
+export declare const getEditorialWorkflowError: (e: unknown, resolveCollectionLabel?: (file: string) => string | undefined) => EditorialWorkflowErrorCopy;

package/dist/toolkit/form-builder/use-editorial-workflow.d.ts

@@ -1,4 +1,6 @@
 import { Form } from '../forms';
+import { type EditorialWorkflowErrorCopy } from './editorial-workflow-utils';
+export { collectionLabelResolver, getEditorialWorkflowError, plainMessage, } from './editorial-workflow-utils';
 export declare const WORKFLOW_STEPS: {
     id: number;
     name: string;
@@ -18,7 +20,7 @@ export interface ExecuteWorkflowOptions {
 }
 export interface UseEditorialWorkflowResult {
     isExecuting: boolean;
-    errorMessage: string;
+    error?: EditorialWorkflowErrorCopy;
     currentStep: number;
     elapsedTime: number;
     /** Resolves with the outcome; on failure `error` holds the message. */
@@ -29,5 +31,4 @@ export interface UseEditorialWorkflowResult {
     /** Reset error/executing state so the form can be retried */
     reset: () => void;
 }
-export declare const getEditorialWorkflowErrorMessage: (e: unknown) => string;
 export declare function useEditorialWorkflow(): UseEditorialWorkflowResult;

package/dist/unifiedClient/index.d.ts

@@ -41,6 +41,7 @@ export declare class TinaClient<GenQueries> {
     cacheEnabled: boolean;
     constructor({ token, url, queries, errorPolicy, cacheDir, cache, }: TinaClientArgs<GenQueries>);
     init(): Promise<void>;
+    protected createCache(_dir: string): Promise<Cache | null>;
     request<DataType extends Record<string, any> = any>({ errorPolicy, ...args }: TinaClientRequestArgs, options: {
         fetchOptions?: Parameters<typeof fetch>[1];
     }): Promise<{

package/package.json

@@ -2,12 +2,16 @@
   "name": "tinacms",
   "type": "module",
   "typings": "dist/index.d.ts",
-  "version": "3.14.0",
+  "version": "3.14.1",
   "main": "dist/index.js",
   "module": "./dist/index.js",
   "exports": {
     ".": "./dist/index.js",
-    "./dist/client": "./dist/client.js",
+    "./dist/client": {
+      "types": "./dist/client.d.ts",
+      "browser": "./dist/client.browser.js",
+      "default": "./dist/client.js"
+    },
     "./react": "./dist/react.js",
     "./dist/react": "./dist/react.js",
     "./tina-field": "./dist/tina-field.js",
@@ -30,7 +34,8 @@
       {
         "name": "src/client.ts",
         "target": "node"
-      }
+      },
+      "src/client.browser.ts"
     ]
   },
   "license": "Apache-2.0",
@@ -107,8 +112,8 @@
     "zod": "^3.24.2",
     "@tinacms/bridge": "^0.3.1",
     "@tinacms/mdx": "^2.2.3",
-    "@tinacms/search": "^1.2.25",
-    "@tinacms/schema-tools": "^2.10.0"
+    "@tinacms/schema-tools": "^2.10.0",
+    "@tinacms/search": "^1.2.25"
   },
   "devDependencies": {
     "@graphql-tools/utils": "^10.8.1",