@blinkk/root-cms 2.5.7 → 2.5.9

package/dist/app.js

@@ -1,6 +1,6 @@
 import {
   getServerVersion
-} from "./chunk-LAHFBC64.js";
+} from "./chunk-SW3UAKP5.js";
 import {
   getCollectionSchema,
   getProjectSchemas
@@ -122,7 +122,13 @@ async function renderApp(req, res, options) {
     experiments: cmsConfig.experiments,
     preview: {
       channel: cmsConfig.preview?.channel ?? false
-    }
+    },
+    checks: (cmsConfig.checks || []).map((c) => ({
+      id: c.id,
+      label: c.label,
+      description: c.description,
+      collections: c.collections
+    }))
   };
   const projectName = cmsConfig.name || cmsConfig.id || "";
   const title = getCmsTitle(projectName, cmsConfig.minimalBranding);

package/dist/{chunk-7LT3ZBCG.js → chunk-5N2KLMQH.js}

@@ -1238,6 +1238,13 @@ ${errorMessages}`);
       await batch.commit();
     }
     console.log(`published ${publishedDocs.length} docs!`);
+    for (const doc of publishedDocs) {
+      const scheduledBy = doc.data?.sys?.scheduledBy || "system";
+      await this.logAction("doc.scheduled_publish", {
+        by: scheduledBy,
+        metadata: { docId: doc.id }
+      });
+    }
     return publishedDocs;
   }
   /**
@@ -1271,6 +1278,14 @@ ${errorMessages}`);
         batch,
         releaseId: release.id
       });
+      await this.logAction("release.scheduled_publish", {
+        by: publishedBy,
+        metadata: {
+          releaseId: release.id,
+          docIds: release.docIds || [],
+          dataSourceIds: release.dataSourceIds || []
+        }
+      });
     }
   }
   /**

package/dist/{chunk-A5DEI2QQ.js → chunk-AFL5KJ4E.js}

@@ -1,7 +1,7 @@
 import {
   RootCMSClient,
   getCmsPlugin
-} from "./chunk-7LT3ZBCG.js";
+} from "./chunk-5N2KLMQH.js";
 
 // core/versions.ts
 import path from "path";

package/dist/{chunk-LAHFBC64.js → chunk-SW3UAKP5.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@blinkk/root-cms",
-  version: "2.5.7",
+  version: "2.5.9",
   author: "s@blinkk.com",
   license: "MIT",
   engines: {
@@ -169,7 +169,7 @@ var package_default = {
     yjs: "13.6.27"
   },
   peerDependencies: {
-    "@blinkk/root": "2.5.7",
+    "@blinkk/root": "2.5.9",
     "firebase-admin": ">=11",
     "firebase-functions": ">=4",
     preact: ">=10",

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   RootCMSClient,
   getCmsPlugin,
   unmarshalData
-} from "./chunk-7LT3ZBCG.js";
+} from "./chunk-5N2KLMQH.js";
 import "./chunk-MLKGABMK.js";
 
 // cli/cli.ts

package/dist/{client-TgoRyFWJ.d.ts → client-BUnrUs3a.d.ts}

@@ -1,4 +1,4 @@
-import { Plugin, Request, RootConfig } from '@blinkk/root';
+import { RootConfig, Plugin, Request } from '@blinkk/root';
 import { App } from 'firebase-admin/app';
 import { Firestore, WriteBatch, Timestamp, Query } from 'firebase-admin/firestore';
 import { C as Collection } from './schema-Bht24XmU.js';
@@ -8,6 +8,65 @@ import { C as Collection } from './schema-Bht24XmU.js';
  */
 type RootAiModel = 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | 'gemini-2.5-flash' | 'gemini-2.0-pro' | string;
 
+/** The result status of a check. */
+type CheckStatus = 'success' | 'warning' | 'error';
+/** Result returned by a check function after execution. */
+interface CheckResult {
+    /** Whether the check succeeded, warned, or failed. */
+    status: CheckStatus;
+    /** A message describing the result. Supports markdown. */
+    message: string;
+    /** Optional metadata to include with the result. */
+    metadata?: Record<string, any>;
+}
+/** Context passed to a check function during execution. */
+interface CheckContext {
+    /** The Root.js config. */
+    rootConfig: RootConfig;
+    /** The Root CMS client for accessing the database. */
+    cmsClient: RootCMSClient;
+    /** The document ID, e.g. `Pages/index`. */
+    docId: string;
+    /** The collection ID, e.g. `Pages`. */
+    collectionId: string;
+    /** The slug, e.g. `index`. */
+    slug: string;
+    /** The collection schema. */
+    collectionSchema: Collection | null;
+}
+/** Configuration for defining a CMS check. */
+interface CMSCheck {
+    /** Unique ID for the check. */
+    id: string;
+    /** Human-readable label displayed in the UI. */
+    label: string;
+    /** Optional description explaining what the check does. */
+    description?: string;
+    /**
+     * Optional list of collection IDs to restrict this check to. When set, the
+     * check is only shown and runnable for documents belonging to one of the
+     * listed collections. When omitted, the check applies to all collections.
+     */
+    collections?: string[];
+    /**
+     * Function that runs the check on the server-side and returns a result.
+     */
+    run: (ctx: CheckContext) => Promise<CheckResult>;
+}
+
+interface TranslationsCheckOptions {
+    /**
+     * Optional list of collection IDs to restrict this check to. When set, the
+     * check is only shown and runnable for documents in these collections.
+     */
+    collections?: string[];
+}
+/**
+ * A first-party CMS check that verifies all translatable strings in a document
+ * have translations for each of the document's enabled locales.
+ */
+declare function translationsCheck(options?: TranslationsCheckOptions): CMSCheck;
+
 /**
  * Built-in sidebar tools that can be toggled on/off in the CMS UI.
  */
@@ -168,6 +227,30 @@ type CMSPluginOptions = {
          */
         channel: boolean | 'to-preview' | 'from-preview';
     };
+    /**
+     * Checks that can be run on-demand from the CMS UI to validate document
+     * content. Each check defines a server-side function that returns a
+     * success/warning/error result with a markdown message.
+     *
+     * Example:
+     * ```ts
+     * cmsPlugin({
+     *   checks: [
+     *     {
+     *       id: 'my-check',
+     *       label: 'My Check',
+     *       run: async (ctx) => {
+     *         return {status: 'success', message: 'All good!'};
+     *       },
+     *     },
+     *   ],
+     * });
+     * ```
+     *
+     * NOTE: The checks feature is considered a "beta" feature, its interface
+     * may change from version to version as we add new features.
+     */
+    checks?: CMSCheck[];
 };
 type CMSPlugin = Plugin & {
     name: 'root-cms';
@@ -1021,4 +1104,4 @@ declare class BatchResponse {
     private getTranslationsMap;
 }
 
-export { type CMSPluginOptions as $, type Action as A, type BatchRequestOptions as B, BatchRequest as C, type DocMode as D, BatchResponse as E, type Locale as F, type GetDocOptions as G, type HttpMethod as H, type SourceString as I, type TranslatedString as J, type TranslationsDocMode as K, type LoadTranslationsOptions as L, type TranslationsLocaleDocHashMap as M, type TranslationsLocaleDocEntry as N, type MultiLocaleTranslationsMap as O, type SingleLocaleTranslationsMap as P, TranslationsManager as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, buildTranslationsDbPath as V, buildTranslationsLocaleDocDbPath as W, type CMSBuiltInSidebarTool as X, type CMSUser as Y, type CMSAIConfig as Z, type CMSSidebarTool as _, type LocaleTranslations as a, type CMSPlugin as a0, cmsPlugin as a1, type Doc as b, type DataSource as c, type DataSourceData as d, type DataSourceMode as e, type SaveDraftOptions as f, type UpdateDraftOptions as g, type ListDocsOptions as h, type GetCountOptions as i, type Translation as j, type Release as k, type ListActionsOptions as l, isRichTextData as m, getCmsPlugin as n, marshalData as o, normalizeData as p, type ArrayObject as q, marshalArray as r, unmarshalArray as s, toArrayObject as t, unmarshalData as u, translationsForLocale as v, parseDocId as w, type BatchRequestQuery as x, type BatchRequestQueryOptions as y, type TranslationsDoc as z };
+export { type CMSPluginOptions as $, type Action as A, type BatchRequestOptions as B, BatchRequest as C, type DocMode as D, BatchResponse as E, type Locale as F, type GetDocOptions as G, type HttpMethod as H, type SourceString as I, type TranslatedString as J, type TranslationsDocMode as K, type LoadTranslationsOptions as L, type TranslationsLocaleDocHashMap as M, type TranslationsLocaleDocEntry as N, type MultiLocaleTranslationsMap as O, type SingleLocaleTranslationsMap as P, TranslationsManager as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, buildTranslationsDbPath as V, buildTranslationsLocaleDocDbPath as W, type CMSBuiltInSidebarTool as X, type CMSUser as Y, type CMSAIConfig as Z, type CMSSidebarTool as _, type LocaleTranslations as a, type CMSPlugin as a0, cmsPlugin as a1, type CMSCheck as a2, type CheckResult as a3, type CheckContext as a4, type CheckStatus as a5, translationsCheck as a6, type TranslationsCheckOptions as a7, type Doc as b, type DataSource as c, type DataSourceData as d, type DataSourceMode as e, type SaveDraftOptions as f, type UpdateDraftOptions as g, type ListDocsOptions as h, type GetCountOptions as i, type Translation as j, type Release as k, type ListActionsOptions as l, isRichTextData as m, getCmsPlugin as n, marshalData as o, normalizeData as p, type ArrayObject as q, marshalArray as r, unmarshalArray as s, toArrayObject as t, unmarshalData as u, translationsForLocale as v, parseDocId as w, type BatchRequestQuery as x, type BatchRequestQueryOptions as y, type TranslationsDoc as z };

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-export { A as Action, q as ArrayObject, C as BatchRequest, B as BatchRequestOptions, x as BatchRequestQuery, y as BatchRequestQueryOptions, E as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, D as DocMode, i as GetCountOptions, G as GetDocOptions, H as HttpMethod, l as ListActionsOptions, h as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, k as Release, R as RootCMSClient, f as SaveDraftOptions, S as SetDocOptions, j as Translation, z as TranslationsDoc, T as TranslationsMap, g as UpdateDraftOptions, U as UserRole, n as getCmsPlugin, m as isRichTextData, r as marshalArray, o as marshalData, p as normalizeData, w as parseDocId, t as toArrayObject, v as translationsForLocale, s as unmarshalArray, u as unmarshalData } from './client-TgoRyFWJ.js';
+export { A as Action, q as ArrayObject, C as BatchRequest, B as BatchRequestOptions, x as BatchRequestQuery, y as BatchRequestQueryOptions, E as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, D as DocMode, i as GetCountOptions, G as GetDocOptions, H as HttpMethod, l as ListActionsOptions, h as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, k as Release, R as RootCMSClient, f as SaveDraftOptions, S as SetDocOptions, j as Translation, z as TranslationsDoc, T as TranslationsMap, g as UpdateDraftOptions, U as UserRole, n as getCmsPlugin, m as isRichTextData, r as marshalArray, o as marshalData, p as normalizeData, w as parseDocId, t as toArrayObject, v as translationsForLocale, s as unmarshalArray, u as unmarshalData } from './client-BUnrUs3a.js';
 import './schema-Bht24XmU.js';

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-7LT3ZBCG.js";
+} from "./chunk-5N2KLMQH.js";
 import "./chunk-MLKGABMK.js";
 export {
   BatchRequest,

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { R as RootCMSClient, D as DocMode, L as LoadTranslationsOptions, T as TranslationsMap, a as LocaleTranslations } from './client-TgoRyFWJ.js';
-export { A as Action, q as ArrayObject, C as BatchRequest, B as BatchRequestOptions, x as BatchRequestQuery, y as BatchRequestQueryOptions, E as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, i as GetCountOptions, G as GetDocOptions, H as HttpMethod, l as ListActionsOptions, h as ListDocsOptions, F as Locale, O as MultiLocaleTranslationsMap, k as Release, f as SaveDraftOptions, S as SetDocOptions, P as SingleLocaleTranslationsMap, I as SourceString, J as TranslatedString, j as Translation, z as TranslationsDoc, K as TranslationsDocMode, N as TranslationsLocaleDocEntry, M as TranslationsLocaleDocHashMap, Q as TranslationsManager, g as UpdateDraftOptions, U as UserRole, V as buildTranslationsDbPath, W as buildTranslationsLocaleDocDbPath, n as getCmsPlugin, m as isRichTextData, r as marshalArray, o as marshalData, p as normalizeData, w as parseDocId, t as toArrayObject, v as translationsForLocale, s as unmarshalArray, u as unmarshalData } from './client-TgoRyFWJ.js';
+import { R as RootCMSClient, D as DocMode, L as LoadTranslationsOptions, T as TranslationsMap, a as LocaleTranslations } from './client-BUnrUs3a.js';
+export { A as Action, q as ArrayObject, C as BatchRequest, B as BatchRequestOptions, x as BatchRequestQuery, y as BatchRequestQueryOptions, E as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, i as GetCountOptions, G as GetDocOptions, H as HttpMethod, l as ListActionsOptions, h as ListDocsOptions, F as Locale, O as MultiLocaleTranslationsMap, k as Release, f as SaveDraftOptions, S as SetDocOptions, P as SingleLocaleTranslationsMap, I as SourceString, J as TranslatedString, j as Translation, z as TranslationsDoc, K as TranslationsDocMode, N as TranslationsLocaleDocEntry, M as TranslationsLocaleDocHashMap, Q as TranslationsManager, g as UpdateDraftOptions, U as UserRole, V as buildTranslationsDbPath, W as buildTranslationsLocaleDocDbPath, n as getCmsPlugin, m as isRichTextData, r as marshalArray, o as marshalData, p as normalizeData, w as parseDocId, t as toArrayObject, v as translationsForLocale, s as unmarshalArray, u as unmarshalData } from './client-BUnrUs3a.js';
 import { Request, RootConfig, Response, RouteParams, GetStaticProps, GetStaticPaths } from '@blinkk/root';
 import { Query } from 'firebase-admin/firestore';
 export { s as schema } from './schema-Bht24XmU.js';

package/dist/core.js

@@ -16,7 +16,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-7LT3ZBCG.js";
+} from "./chunk-5N2KLMQH.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";

package/dist/functions.js

@@ -1,7 +1,7 @@
 import {
   runCronJobs
-} from "./chunk-A5DEI2QQ.js";
-import "./chunk-7LT3ZBCG.js";
+} from "./chunk-AFL5KJ4E.js";
+import "./chunk-5N2KLMQH.js";
 import "./chunk-MLKGABMK.js";
 
 // core/functions.ts

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-export { Z as CMSAIConfig, X as CMSBuiltInSidebarTool, a0 as CMSPlugin, $ as CMSPluginOptions, _ as CMSSidebarTool, Y as CMSUser, a1 as cmsPlugin } from './client-TgoRyFWJ.js';
+export { Z as CMSAIConfig, X as CMSBuiltInSidebarTool, a2 as CMSCheck, a0 as CMSPlugin, $ as CMSPluginOptions, _ as CMSSidebarTool, Y as CMSUser, a4 as CheckContext, a3 as CheckResult, a5 as CheckStatus, a7 as TranslationsCheckOptions, a1 as cmsPlugin, a6 as translationsCheck } from './client-BUnrUs3a.js';
 import './schema-Bht24XmU.js';

package/dist/plugin.js

@@ -4,15 +4,15 @@ import {
 } from "./chunk-T5UK2H24.js";
 import {
   getServerVersion
-} from "./chunk-LAHFBC64.js";
+} from "./chunk-SW3UAKP5.js";
 import {
   runCronJobs
-} from "./chunk-A5DEI2QQ.js";
+} from "./chunk-AFL5KJ4E.js";
 import {
   RootCMSClient,
   parseDocId,
   unmarshalData
-} from "./chunk-7LT3ZBCG.js";
+} from "./chunk-5N2KLMQH.js";
 import "./chunk-MLKGABMK.js";
 
 // core/plugin.ts
@@ -463,6 +463,57 @@ function api(server, options) {
       res.status(500).json({ success: false, error: err.message || "UNKNOWN" });
     }
   });
+  server.use("/cms/api/check.test", async (req, res) => {
+    if (req.method !== "POST" || !String(req.get("content-type")).startsWith("application/json")) {
+      res.status(400).json({ success: false, error: "BAD_REQUEST" });
+      return;
+    }
+    if (!req.user?.email) {
+      res.status(401).json({ success: false, error: "UNAUTHORIZED" });
+      return;
+    }
+    const reqBody = req.body || {};
+    const checkId = String(reqBody.check || "");
+    const docId = String(reqBody.docId || "");
+    if (!checkId || !docId) {
+      res.status(400).json({ success: false, error: "MISSING_REQUIRED_FIELD" });
+      return;
+    }
+    const checks = options.checks || [];
+    const check = checks.find((c) => c.id === checkId);
+    if (!check) {
+      res.status(404).json({ success: false, error: "CHECK_NOT_FOUND" });
+      return;
+    }
+    const { collection: collectionId, slug } = parseDocId(docId);
+    if (check.collections && !check.collections.includes(collectionId)) {
+      res.status(400).json({
+        success: false,
+        error: "CHECK_NOT_APPLICABLE"
+      });
+      return;
+    }
+    const cmsClient = new RootCMSClient(req.rootConfig);
+    let collectionSchema = null;
+    try {
+      collectionSchema = await getCollectionSchema(req, collectionId);
+    } catch (err) {
+    }
+    try {
+      const result = await check.run({
+        rootConfig: req.rootConfig,
+        cmsClient,
+        docId,
+        collectionId,
+        slug,
+        collectionSchema
+      });
+      res.status(200).json({ success: true, data: result });
+    } catch (err) {
+      console.error(err.stack || err);
+      res.status(500).json({ success: false, error: err.message || "UNKNOWN" });
+    }
+  });
 }
 
 // core/sse.ts
@@ -498,12 +549,29 @@ function sse(server) {
       { serverVersion: getServerVersion() }
     );
     res.write(connectedMessage);
-    req.on("close", () => {
+    const heartbeatInterval = setInterval(() => {
+      try {
+        res.write(":heartbeat\n\n");
+      } catch {
+        clearInterval(heartbeatInterval);
+      }
+    }, 3e4);
+    const maxConnectionTimer = setTimeout(() => {
+      clearInterval(heartbeatInterval);
+      try {
+        res.write("retry: 1000\n\n");
+        res.end();
+      } catch {
+      }
       sseClients.delete(res);
-    });
-    req.on("aborted", () => {
+    }, 9 * 6e4);
+    const cleanup = () => {
+      clearInterval(heartbeatInterval);
+      clearTimeout(maxConnectionTimer);
       sseClients.delete(res);
-    });
+    };
+    req.on("close", cleanup);
+    req.on("aborted", cleanup);
   });
   return { sseBroadcast };
 }
@@ -516,6 +584,232 @@ function formatMessage(event, data) {
   return message;
 }
 
+// core/checks-translations.ts
+function extractTranslatableStrings(fields, data, types) {
+  const strings = /* @__PURE__ */ new Set();
+  function addString(text) {
+    const normalized = (text || "").trim();
+    if (normalized) {
+      strings.add(normalized);
+    }
+  }
+  function walkFields(fieldDefs, fieldData) {
+    for (const field of fieldDefs) {
+      if (!field.id) {
+        continue;
+      }
+      const value = fieldData[field.id];
+      if (!value) {
+        continue;
+      }
+      const metadataKey = `@${field.id}`;
+      const metadata = fieldData[metadataKey];
+      if (metadata?.disableTranslations) {
+        continue;
+      }
+      walkField(field, value);
+    }
+  }
+  function walkField(field, value) {
+    if (!value) {
+      return;
+    }
+    if (field.type === "string" || field.type === "select") {
+      if (field.translate) {
+        addString(value);
+      }
+    } else if (field.type === "multiselect") {
+      if (field.translate && Array.isArray(value)) {
+        for (const item of value) {
+          addString(item);
+        }
+      }
+    } else if (field.type === "image") {
+      if (field.translate && value.alt && field.alt !== false) {
+        addString(value.alt);
+      }
+    } else if (field.type === "richtext") {
+      if (field.translate) {
+        extractRichTextStrings(strings, value);
+      }
+    } else if (field.type === "object") {
+      walkFields(field.fields || [], value);
+    } else if (field.type === "array") {
+      const arrayKeys = value._array || [];
+      for (const arrayKey of arrayKeys) {
+        if (value[arrayKey]) {
+          walkField(field.of, value[arrayKey]);
+        }
+      }
+    } else if (field.type === "oneof") {
+      const fieldTypes = field.types || [];
+      let fieldValueType;
+      if (Array.isArray(fieldTypes) && typeof fieldTypes[0] === "string") {
+        if (fieldTypes.includes(value._type)) {
+          fieldValueType = types[value._type];
+        }
+      } else {
+        fieldValueType = fieldTypes.find(
+          (item) => item.name === value._type
+        );
+      }
+      if (fieldValueType) {
+        walkFields(fieldValueType.fields || [], value);
+      }
+    }
+  }
+  walkFields(fields, data);
+  return strings;
+}
+function extractRichTextStrings(strings, data) {
+  if (!data || !data.root || !data.root.children) {
+    return;
+  }
+  for (const block of data.root.children) {
+    extractRichTextBlock(strings, block);
+  }
+}
+function extractRichTextBlock(strings, block) {
+  if (!block) {
+    return;
+  }
+  if (block.type === "paragraph" || block.type === "heading") {
+    const text = extractRichTextNodeText(block);
+    if (text.trim()) {
+      strings.add(text.trim());
+    }
+  } else if (block.type === "list") {
+    for (const item of block.children || []) {
+      extractRichTextBlock(strings, item);
+    }
+  } else if (block.type === "listitem") {
+    const text = extractRichTextNodeText(block);
+    if (text.trim()) {
+      strings.add(text.trim());
+    }
+  }
+}
+function extractRichTextNodeText(node) {
+  if (!node) {
+    return "";
+  }
+  if (node.type === "text") {
+    return node.text || "";
+  }
+  if (node.children) {
+    return node.children.map(extractRichTextNodeText).join("");
+  }
+  return "";
+}
+function translationsCheck(options) {
+  return {
+    id: "root-cms/translations",
+    label: "Missing Translations",
+    description: "Checks that all translatable strings have translations for each enabled locale.",
+    collections: options?.collections,
+    run: async (ctx) => {
+      const { cmsClient, collectionId, slug, collectionSchema } = ctx;
+      const rawDoc = await cmsClient.getRawDoc(collectionId, slug, {
+        mode: "draft"
+      });
+      if (!rawDoc) {
+        return {
+          status: "error",
+          message: "Document not found."
+        };
+      }
+      if (!collectionSchema) {
+        return {
+          status: "warning",
+          message: "Could not load collection schema. Unable to check translations."
+        };
+      }
+      const fields = collectionSchema.fields || [];
+      const schemaTypes = collectionSchema.types || {};
+      const docFields = rawDoc.fields || {};
+      const sourceStrings = extractTranslatableStrings(
+        fields,
+        docFields,
+        schemaTypes
+      );
+      if (sourceStrings.size === 0) {
+        return {
+          status: "success",
+          message: "No translatable strings found in this document."
+        };
+      }
+      const locales = (rawDoc.sys?.locales || ["en"]).filter(
+        (l) => l !== "en"
+      );
+      if (locales.length === 0) {
+        return {
+          status: "success",
+          message: `Found **${sourceStrings.size}** translatable string(s), but no non-default locales are enabled.`
+        };
+      }
+      const docId = `${collectionId}/${slug}`;
+      const translationsMap = await cmsClient.loadTranslations({
+        tags: [docId]
+      });
+      const sourceToTranslations = /* @__PURE__ */ new Map();
+      for (const [, translation] of Object.entries(translationsMap)) {
+        const source = (translation.source || "").trim();
+        if (source) {
+          const localeMap = {};
+          for (const [key, value] of Object.entries(translation)) {
+            if (key !== "source" && key !== "tags" && typeof value === "string") {
+              localeMap[key] = value;
+            }
+          }
+          sourceToTranslations.set(source, localeMap);
+        }
+      }
+      const missingByLocale = {};
+      let totalMissing = 0;
+      for (const source of sourceStrings) {
+        const translations = sourceToTranslations.get(source);
+        for (const locale of locales) {
+          if (!translations || !translations[locale]) {
+            if (!missingByLocale[locale]) {
+              missingByLocale[locale] = [];
+            }
+            missingByLocale[locale].push(source);
+            totalMissing++;
+          }
+        }
+      }
+      if (totalMissing === 0) {
+        return {
+          status: "success",
+          message: `All **${sourceStrings.size}** translatable string(s) have translations for ${locales.length} locale(s).`
+        };
+      }
+      const lines = [];
+      lines.push(
+        `Found **${totalMissing}** missing translation(s) across **${Object.keys(missingByLocale).length}** locale(s):
+`
+      );
+      for (const [locale, missing] of Object.entries(missingByLocale)) {
+        lines.push(`**${locale}** \u2014 ${missing.length} missing:`);
+        const shown = missing.slice(0, 5);
+        for (const str of shown) {
+          const truncated = str.length > 80 ? str.substring(0, 80) + "..." : str;
+          lines.push(`- \`${truncated}\``);
+        }
+        if (missing.length > 5) {
+          lines.push(`- ...and ${missing.length - 5} more`);
+        }
+        lines.push("");
+      }
+      return {
+        status: totalMissing > 0 ? "warning" : "success",
+        message: lines.join("\n"),
+        metadata: { totalMissing, missingByLocale }
+      };
+    }
+  };
+}
+
 // core/plugin.ts
 var __dirname = path2.dirname(fileURLToPath(import.meta.url));
 async function writeCollectionSchemasToJson(rootConfig) {
@@ -765,6 +1059,19 @@ function cmsPlugin(options) {
      */
     configureServer: async (server, serverOptions) => {
       server.use(bodyParser.json());
+      server.use(
+        (err, req, res, next) => {
+          if (err.type === "entity.too.large" || err.status === 413) {
+            res.status(413).json({ error: "Payload too large" });
+            return;
+          }
+          if (err.type === "entity.parse.failed" || err.status === 400) {
+            res.status(400).json({ error: "Bad request" });
+            return;
+          }
+          next(err);
+        }
+      );
       async function getRenderer(req) {
         if (serverOptions.type === "dev") {
           const appFilePath = path2.resolve(__dirname, "./app.js");
@@ -854,7 +1161,7 @@ function cmsPlugin(options) {
       if (sseData.sseBroadcast) {
         sseBroadcast = sseData.sseBroadcast;
       }
-      api(server, { getRenderer });
+      api(server, { getRenderer, checks: options.checks });
       server.use("/cms", async (req, res) => {
         try {
           if (!req.user) {
@@ -911,5 +1218,6 @@ function fileExists(filepath) {
   return fs2.access(filepath).then(() => true).catch(() => false);
 }
 export {
-  cmsPlugin
+  cmsPlugin,
+  translationsCheck
 };