@nitrogenbuilder/connector-payload 1.1.1 → 1.2.0

package/dist/collections/NitrogenTemplates.js

@@ -93,5 +93,13 @@ export const NitrogenTemplates = {
                 },
             ],
         },
+        {
+            name: 'nitrogenTranslationStatus',
+            type: 'json',
+            admin: {
+                hidden: true,
+                description: 'Per-language translation coverage, computed by Nitrogen on save',
+            },
+        },
     ],
 };

package/dist/endpoints/all.js

@@ -1,5 +1,6 @@
 import { getDocumentPermalink, getDocumentRelativePermalink, getNitrogenSettings, } from './helpers.js';
 import { resolveCollection } from '../collection-registry.js';
+import { getRequestLanguage, resolveLocaleOptions } from '../localization.js';
 export const allEndpoints = [
     // GET /api/nitrogen/v1/all — List all items with filtering
     {
@@ -17,6 +18,7 @@ export const allEndpoints = [
             const paged = parseInt(url.searchParams.get('paged') || '1', 10);
             const perPage = parseInt(url.searchParams.get('per_page') || '20', 10);
             const statuses = statusParam.split(',').map((s) => s.trim());
+            const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
             const collection = resolveCollection(postType);
             const where = {};
             if (!statuses.includes('any')) {
@@ -29,6 +31,7 @@ export const allEndpoints = [
                     page: paged,
                     limit: perPage,
                     depth: 0,
+                    ...localeOptions,
                 });
                 const items = result.docs.map((doc) => {
                     const document = doc;

package/dist/endpoints/batch.js

@@ -1,5 +1,6 @@
 import { resolveCollection } from "../collection-registry.js";
 import { getNitrogenSettings, buildDynamicData, buildPageResponse, getDocumentPermalink, getDocumentRelativePermalink, } from "./helpers.js";
+import { getRequestLanguage, resolveLocaleOptions } from "../localization.js";
 function toArray(value) {
     if (Array.isArray(value)) {
         return value.map((item) => String(item).trim()).filter(Boolean);
@@ -98,6 +99,9 @@ export const batchEndpoints = [
             }
             const settings = await getNitrogenSettings(payload);
             const results = {};
+            // Request-level language (?lang=/?locale=) applies to every batched
+            // query; a per-request `lang`/`locale` param overrides it.
+            const requestLang = getRequestLanguage(req);
             // Dedup: group identical (endpoint, params) requests and run each group's
             // query once via its first ("representative") request; fan the result out
             // to the duplicate keys afterward.
@@ -285,6 +289,10 @@ export const batchEndpoints = [
                             };
                         }
                     }
+                    const lang = (typeof params.lang === "string" && params.lang) ||
+                        (typeof params.locale === "string" && params.locale) ||
+                        requestLang;
+                    const localeOptions = resolveLocaleOptions(payload, lang);
                     const result = await payload.find({
                         collection: collectionSlug,
                         where,
@@ -292,6 +300,7 @@ export const batchEndpoints = [
                         limit,
                         sort,
                         depth,
+                        ...localeOptions,
                     });
                     let data;
                     if (raw) {

package/dist/endpoints/collection-endpoints.js

@@ -1,5 +1,6 @@
 import { getNitrogenSettings, buildDynamicData, buildResolvedPageResponse, buildResolvedListItemResponse, getTemplateForType, requireAuth, canServeDocument, } from './helpers.js';
 import { resolveTemplateForDocument } from './templateConditions.js';
+import { buildDynamicDataMeta, computeDocTranslationStatus, fetchLocaleAllDoc, getDefaultLocaleTitle, getLocalizationSettings, getPayloadLocalization, getRequestLanguage, resolveLocaleOptions, } from '../localization.js';
 /**
  * Creates a complete set of CRUD endpoints for a given Payload collection.
  *
@@ -19,6 +20,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 const url = new URL(req.url || '', 'http://localhost');
                 const statusParam = url.searchParams.get('post_status') || 'published';
                 const statuses = statusParam.split(',').map((s) => s.trim());
+                const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
                 const where = {};
                 if (!statuses.includes('any')) {
                     where._status = { in: statuses };
@@ -28,6 +30,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                     where,
                     limit: 0,
                     depth: 1,
+                    ...localeOptions,
                 });
                 const items = await Promise.all(result.docs.map((doc) => buildResolvedListItemResponse(payload, doc, settings, collectionSlug)));
                 return Response.json(items);
@@ -67,9 +70,10 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
             handler: async (req) => {
                 const { payload, routeParams } = req;
                 const id = routeParams?.id;
+                const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
                 try {
                     const [doc, settings, headerTemplate, footerTemplate] = await Promise.all([
-                        payload.findByID({ collection, id, depth: 1 }),
+                        payload.findByID({ collection, id, depth: 1, ...localeOptions }),
                         getNitrogenSettings(payload),
                         getTemplateForType(payload, 'header'),
                         getTemplateForType(payload, 'footer'),
@@ -79,9 +83,22 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                     }
                     const pageTemplate = await resolveTemplateForDocument(payload, doc, collectionSlug, settings);
                     const dynamicData = buildDynamicData(doc, settings);
+                    // When a language was requested, the top-level `title` must stay
+                    // the default-locale one — the editor edits default-language field
+                    // data only and PATCHes `title` back on save. Only dynamic_data is
+                    // locale-resolved. One locale:'all' fetch serves title + meta.
+                    const localeAllDoc = localeOptions.locale
+                        ? await fetchLocaleAllDoc(payload, collectionSlug, id)
+                        : undefined;
+                    const dynamicDataMeta = await buildDynamicDataMeta(payload, collectionSlug, id, localeAllDoc);
+                    const titleOverride = localeOptions.locale
+                        ? getDefaultLocaleTitle(payload, localeAllDoc ?? null)
+                        : null;
                     const response = await buildResolvedPageResponse(payload, doc, settings, dynamicData, collectionSlug);
                     return Response.json({
                         ...response,
+                        ...(titleOverride !== null ? { title: titleOverride } : {}),
+                        ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
                         template: pageTemplate,
                         headerTemplate,
                         footerTemplate,
@@ -92,6 +109,36 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 }
             },
         },
+        // GET /api/nitrogen/v1/{prefix}/:id/dynamic-data — Dynamic data (+ meta)
+        // for one item, optionally in a specific language (?lang=es). Used by the
+        // editor on language switch, without reloading the whole page.
+        {
+            path: `/nitrogen/v1/${endpointPrefix}/:id/dynamic-data`,
+            method: 'get',
+            handler: async (req) => {
+                const { payload, routeParams } = req;
+                const id = routeParams?.id;
+                const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
+                try {
+                    const [doc, settings] = await Promise.all([
+                        payload.findByID({ collection, id, depth: 1, ...localeOptions }),
+                        getNitrogenSettings(payload),
+                    ]);
+                    if (!canServeDocument(req, doc, settings)) {
+                        return Response.json({ error: 'Not found' }, { status: 404 });
+                    }
+                    const dynamicData = buildDynamicData(doc, settings);
+                    const dynamicDataMeta = await buildDynamicDataMeta(payload, collectionSlug, id);
+                    return Response.json({
+                        dynamic_data: dynamicData,
+                        ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
+                    });
+                }
+                catch {
+                    return Response.json({ error: 'Not found' }, { status: 404 });
+                }
+            },
+        },
         // PATCH /api/nitrogen/v1/{prefix}/:id — Update an item
         {
             path: `/nitrogen/v1/${endpointPrefix}/:id`,
@@ -145,6 +192,34 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 if (data.settings !== undefined) {
                     updateData.pageSettings = data.settings;
                 }
+                // Localization enabled → recompute per-language translation status
+                // from the saved module tree. Advisory only — never blocks the save.
+                if (updateData.nitrogenData !== undefined) {
+                    try {
+                        const settings = await getNitrogenSettings(payload);
+                        const localization = getLocalizationSettings(settings);
+                        if (localization) {
+                            const translationStatus = await computeDocTranslationStatus({
+                                payload,
+                                collectionSlug,
+                                docId: id,
+                                nitrogenData: updateData.nitrogenData,
+                                localization,
+                            });
+                            if (translationStatus) {
+                                updateData.nitrogenTranslationStatus = translationStatus;
+                            }
+                        }
+                    }
+                    catch {
+                        // Status is advisory — never block the save.
+                    }
+                }
+                // The editor edits default-language field data only — pin the write
+                // to the default locale. Without this, Payload's createLocalReq falls
+                // back to req.locale / req.query.locale, so a stray `?locale=` on the
+                // request would silently retarget localized fields (title).
+                const payloadLocalization = getPayloadLocalization(payload);
                 try {
                     await payload.update({
                         collection,
@@ -152,6 +227,9 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                         data: updateData,
                         depth: 0,
                         overrideAccess: true,
+                        ...(payloadLocalization
+                            ? { locale: payloadLocalization.defaultLocale }
+                            : {}),
                         req,
                     });
                 }
@@ -183,8 +261,16 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 if (!slug) {
                     return Response.json({ error: 'Slug is required' }, { status: 400 });
                 }
+                const lang = body?.lang || body?.data?.lang || getRequestLanguage(req);
+                const localeOptions = resolveLocaleOptions(payload, lang);
                 const [result, settings, headerTemplate, footerTemplate] = await Promise.all([
-                    payload.find({ collection, where: { slug: { equals: slug } }, limit: 1, depth: 1 }),
+                    payload.find({
+                        collection,
+                        where: { slug: { equals: slug } },
+                        limit: 1,
+                        depth: 1,
+                        ...localeOptions,
+                    }),
                     getNitrogenSettings(payload),
                     getTemplateForType(payload, 'header'),
                     getTemplateForType(payload, 'footer'),
@@ -198,9 +284,19 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 }
                 const pageTemplate = await resolveTemplateForDocument(payload, doc, collectionSlug, settings);
                 const dynamicData = buildDynamicData(doc, settings);
+                // See GET /:id — keep the round-tripped `title` at the default locale.
+                const localeAllDoc = localeOptions.locale
+                    ? await fetchLocaleAllDoc(payload, collectionSlug, doc.id)
+                    : undefined;
+                const dynamicDataMeta = await buildDynamicDataMeta(payload, collectionSlug, doc.id, localeAllDoc);
+                const titleOverride = localeOptions.locale
+                    ? getDefaultLocaleTitle(payload, localeAllDoc ?? null)
+                    : null;
                 const response = await buildResolvedPageResponse(payload, doc, settings, dynamicData, collectionSlug);
                 return Response.json({
                     ...response,
+                    ...(titleOverride !== null ? { title: titleOverride } : {}),
+                    ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
                     template: pageTemplate,
                     headerTemplate,
                     footerTemplate,
@@ -214,8 +310,18 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
             handler: async (req) => {
                 const { payload, routeParams } = req;
                 const slug = routeParams?.slug;
+                // When the host collection's slug field is localized, the locale-aware
+                // query matches the localized slug (falling back to the default
+                // locale's slug via fallbackLocale).
+                const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
                 const [result, settings, headerTemplate, footerTemplate] = await Promise.all([
-                    payload.find({ collection, where: { slug: { equals: slug } }, limit: 1, depth: 1 }),
+                    payload.find({
+                        collection,
+                        where: { slug: { equals: slug } },
+                        limit: 1,
+                        depth: 1,
+                        ...localeOptions,
+                    }),
                     getNitrogenSettings(payload),
                     getTemplateForType(payload, 'header'),
                     getTemplateForType(payload, 'footer'),
@@ -229,9 +335,19 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 }
                 const pageTemplate = await resolveTemplateForDocument(payload, doc, collectionSlug, settings);
                 const dynamicData = buildDynamicData(doc, settings);
+                // See GET /:id — keep the round-tripped `title` at the default locale.
+                const localeAllDoc = localeOptions.locale
+                    ? await fetchLocaleAllDoc(payload, collectionSlug, doc.id)
+                    : undefined;
+                const dynamicDataMeta = await buildDynamicDataMeta(payload, collectionSlug, doc.id, localeAllDoc);
+                const titleOverride = localeOptions.locale
+                    ? getDefaultLocaleTitle(payload, localeAllDoc ?? null)
+                    : null;
                 const response = await buildResolvedPageResponse(payload, doc, settings, dynamicData, collectionSlug);
                 return Response.json({
                     ...response,
+                    ...(titleOverride !== null ? { title: titleOverride } : {}),
+                    ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
                     template: pageTemplate,
                     headerTemplate,
                     footerTemplate,

package/dist/endpoints/helpers.js

@@ -30,7 +30,8 @@ export function buildDynamicData(doc, globalSettings) {
     const rawDoc = doc;
     const docData = Object.fromEntries(Object.entries(rawDoc).filter(([key]) => key !== 'nitrogenData' &&
         key !== 'pageSettings' &&
-        key !== 'templateSettings'));
+        key !== 'templateSettings' &&
+        key !== 'nitrogenTranslationStatus'));
     const rawContent = typeof rawDoc.content === 'string'
         ? rawDoc.content
         : '';

package/dist/endpoints/menu.js

@@ -2,6 +2,8 @@ export const menuEndpoints = [
     // POST /api/nitrogen/v1/menu — Get menu items (stub)
     // WordPress nav menus are WP-specific. Returns empty array.
     // Implement with a NavigationMenus collection if menus are needed.
+    // `?lang=` is accepted (and trivially honored) — thread it through
+    // resolveLocaleOptions if this stub gains a real menu query.
     {
         path: '/nitrogen/v1/menu',
         method: 'post',

package/dist/endpoints/sitemap.js

@@ -12,6 +12,7 @@
  */
 import { buildRelativePermalink, getRegisteredCollections, resolveCollection, } from '../collection-registry.js';
 import { findAllDocs } from '../inventory/indexing.js';
+import { getPayloadLocalization, } from '../localization.js';
 /** Internal Nitrogen collections that must never appear in the sitemap. */
 const EXCLUDED_COLLECTIONS = new Set([
     'nitrogen-templates',
@@ -24,18 +25,30 @@ const EXCLUDED_COLLECTIONS = new Set([
  * Payload collections may or may not have drafts enabled (the `_status`
  * field). We first try filtering by `_status: 'published'`; if that throws
  * (collection has no `_status`), we fall back to fetching all docs.
+ *
+ * With localization configured, docs are fetched at `locale: 'all'` so a
+ * localized slug field yields every locale's slug in one query.
  */
-async function fetchPublishedSitemapDocs(payload, collection) {
+async function fetchPublishedSitemapDocs(payload, collection, localization) {
     const select = { slug: true, updatedAt: true };
+    const locale = localization ? 'all' : undefined;
     try {
         return await findAllDocs(payload, collection, {
             where: { _status: { equals: 'published' } },
             select,
+            locale,
         });
     }
     catch {
-        return findAllDocs(payload, collection, { select });
+        return findAllDocs(payload, collection, { select, locale });
+    }
+}
+/** Resolve a (possibly locale-keyed) slug value for one locale. */
+function slugForLocale(slug, locale, defaultLocale) {
+    if (slug && typeof slug === 'object' && !Array.isArray(slug)) {
+        return String(slug[locale] ?? slug[defaultLocale] ?? '');
     }
+    return String(slug ?? '');
 }
 /** Coerce a doc's updatedAt into an ISO-8601 string, or null when absent. */
 function toIsoString(value) {
@@ -89,17 +102,44 @@ export const sitemapEndpoints = [
             if (EXCLUDED_COLLECTIONS.has(collection)) {
                 return Response.json({ error: 'Post type not eligible for sitemap' }, { status: 404 });
             }
+            const localization = getPayloadLocalization(payload);
             let docs;
             try {
-                docs = await fetchPublishedSitemapDocs(payload, collection);
+                docs = await fetchPublishedSitemapDocs(payload, collection, localization);
             }
             catch {
                 return Response.json({ error: 'No URLs for this post type' }, { status: 404 });
             }
-            const urls = docs.map((doc) => ({
-                loc: buildRelativePermalink(postType, String(doc.slug || '')),
-                lastmod: toIsoString(doc.updatedAt),
-            }));
+            // With localization configured, each doc emits its canonical
+            // default-locale URL plus one `/{lang}/`-prefixed entry per non-default
+            // locale, using the localized slug when present (falling back to the
+            // default locale's slug otherwise).
+            const urls = docs.flatMap((doc) => {
+                const lastmod = toIsoString(doc.updatedAt);
+                if (!localization) {
+                    return [
+                        {
+                            loc: buildRelativePermalink(postType, String(doc.slug || '')),
+                            lastmod,
+                        },
+                    ];
+                }
+                const { locales, defaultLocale } = localization;
+                const defaultSlug = slugForLocale(doc.slug, defaultLocale, defaultLocale);
+                const entries = [
+                    { loc: buildRelativePermalink(postType, defaultSlug), lastmod },
+                ];
+                for (const locale of locales) {
+                    if (locale === defaultLocale)
+                        continue;
+                    const localizedSlug = slugForLocale(doc.slug, locale, defaultLocale);
+                    entries.push({
+                        loc: `/${locale}${buildRelativePermalink(postType, localizedSlug)}`,
+                        lastmod,
+                    });
+                }
+                return entries;
+            });
             if (urls.length === 0) {
                 return Response.json({ error: 'No URLs for this post type' }, { status: 404 });
             }

package/dist/endpoints/templates.js

@@ -1,4 +1,5 @@
 import { getNitrogenSettings, buildDynamicData, buildResolvedPageResponse, buildResolvedListItemResponse, getDocumentPermalink, getDocumentRelativePermalink, getTemplateForType, requireAuth, } from './helpers.js';
+import { buildDynamicDataMeta, computeDocTranslationStatus, fetchLocaleAllDoc, getDefaultLocaleTitle, getLocalizationSettings, getPayloadLocalization, getRequestLanguage, resolveLocaleOptions, } from '../localization.js';
 function isContentTemplateCollection(collection) {
     return !!collection && collection !== 'header' && collection !== 'footer';
 }
@@ -25,6 +26,7 @@ export const templatesEndpoints = [
         handler: async (req) => {
             const { payload, routeParams } = req;
             const slug = routeParams?.slug;
+            const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
             try {
                 const [result, headerTemplate, footerTemplate] = await Promise.all([
                     payload.find({
@@ -32,6 +34,7 @@ export const templatesEndpoints = [
                         where: { slug: { equals: slug } },
                         limit: 1,
                         depth: 1,
+                        ...localeOptions,
                     }),
                     getTemplateForType(payload, 'header'),
                     getTemplateForType(payload, 'footer'),
@@ -50,6 +53,7 @@ export const templatesEndpoints = [
                             collection: associatedCollection,
                             limit: 1,
                             depth: 1,
+                            ...localeOptions,
                         });
                         if (associated.docs.length) {
                             associatedDoc = associated.docs[0];
@@ -61,9 +65,24 @@ export const templatesEndpoints = [
                     }
                 }
                 const response = await buildResolvedPageResponse(payload, doc, settings, dynamicData);
+                // When a language was requested, the top-level `title` must stay the
+                // default-locale one — the editor edits default-language field data
+                // only and PATCHes `title` back on save. The meta may describe the
+                // associated doc, but the round-tripped title is the template's own.
+                const templateAllDoc = localeOptions.locale
+                    ? await fetchLocaleAllDoc(payload, 'nitrogen-templates', doc.id)
+                    : undefined;
+                const dynamicDataMeta = associatedDoc
+                    ? await buildDynamicDataMeta(payload, associatedCollection, associatedDoc.id)
+                    : await buildDynamicDataMeta(payload, 'nitrogen-templates', doc.id, templateAllDoc);
+                const titleOverride = localeOptions.locale
+                    ? getDefaultLocaleTitle(payload, templateAllDoc ?? null)
+                    : null;
                 const previewTarget = getTemplatePreviewTarget(doc, settings, associatedCollection, associatedDoc);
                 return Response.json({
                     ...response,
+                    ...(titleOverride !== null ? { title: titleOverride } : {}),
+                    ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
                     slug: previewTarget.slug,
                     permalink: previewTarget.permalink,
                     relative_permalink: previewTarget.relative_permalink,
@@ -87,6 +106,7 @@ export const templatesEndpoints = [
             const settings = await getNitrogenSettings(payload);
             const url = new URL(req.url || '', 'http://localhost');
             const templateType = url.searchParams.get('templateType');
+            const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
             const where = {
                 status: { equals: 'published' },
             };
@@ -98,6 +118,7 @@ export const templatesEndpoints = [
                 where,
                 limit: 0,
                 depth: 1,
+                ...localeOptions,
             });
             const items = await Promise.all(result.docs.map(async (doc) => {
                 const response = await buildResolvedListItemResponse(payload, doc, settings);
@@ -118,12 +139,14 @@ export const templatesEndpoints = [
         handler: async (req) => {
             const { payload, routeParams } = req;
             const id = routeParams?.id;
+            const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
             try {
                 const [doc, headerTemplate, footerTemplate] = await Promise.all([
                     payload.findByID({
                         collection: 'nitrogen-templates',
                         id,
                         depth: 1,
+                        ...localeOptions,
                     }),
                     getTemplateForType(payload, 'header'),
                     getTemplateForType(payload, 'footer'),
@@ -140,6 +163,7 @@ export const templatesEndpoints = [
                             collection: associatedCollection,
                             limit: 1,
                             depth: 1,
+                            ...localeOptions,
                         });
                         if (associated.docs.length) {
                             associatedDoc = associated.docs[0];
@@ -151,9 +175,22 @@ export const templatesEndpoints = [
                     }
                 }
                 const response = await buildResolvedPageResponse(payload, doc, settings, dynamicData);
+                // See GET slug/:slug — keep the round-tripped `title` at the default
+                // locale.
+                const templateAllDoc = localeOptions.locale
+                    ? await fetchLocaleAllDoc(payload, 'nitrogen-templates', doc.id)
+                    : undefined;
+                const dynamicDataMeta = associatedDoc
+                    ? await buildDynamicDataMeta(payload, associatedCollection, associatedDoc.id)
+                    : await buildDynamicDataMeta(payload, 'nitrogen-templates', doc.id, templateAllDoc);
+                const titleOverride = localeOptions.locale
+                    ? getDefaultLocaleTitle(payload, templateAllDoc ?? null)
+                    : null;
                 const previewTarget = getTemplatePreviewTarget(doc, settings, associatedCollection, associatedDoc);
                 return Response.json({
                     ...response,
+                    ...(titleOverride !== null ? { title: titleOverride } : {}),
+                    ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
                     slug: previewTarget.slug,
                     permalink: previewTarget.permalink,
                     relative_permalink: previewTarget.relative_permalink,
@@ -168,6 +205,56 @@ export const templatesEndpoints = [
             }
         },
     },
+    // GET /api/nitrogen/v1/nitrogen-templates/:id/dynamic-data — Dynamic data
+    // (+ meta) for a template, optionally in a specific language (?lang=es).
+    {
+        path: '/nitrogen/v1/nitrogen-templates/:id/dynamic-data',
+        method: 'get',
+        handler: async (req) => {
+            const { payload, routeParams } = req;
+            const id = routeParams?.id;
+            const localeOptions = resolveLocaleOptions(payload, getRequestLanguage(req));
+            try {
+                const doc = (await payload.findByID({
+                    collection: 'nitrogen-templates',
+                    id,
+                    depth: 1,
+                    ...localeOptions,
+                }));
+                const settings = await getNitrogenSettings(payload);
+                let dynamicData = buildDynamicData(doc, settings);
+                let associatedDoc;
+                const associatedCollection = doc.associatedCollection;
+                if (isContentTemplateCollection(associatedCollection)) {
+                    try {
+                        const associated = await payload.find({
+                            collection: associatedCollection,
+                            limit: 1,
+                            depth: 1,
+                            ...localeOptions,
+                        });
+                        if (associated.docs.length) {
+                            associatedDoc = associated.docs[0];
+                            dynamicData = buildDynamicData(associatedDoc, settings);
+                        }
+                    }
+                    catch {
+                        // Collection may not exist — use template's own data
+                    }
+                }
+                const dynamicDataMeta = associatedDoc
+                    ? await buildDynamicDataMeta(payload, associatedCollection, associatedDoc.id)
+                    : await buildDynamicDataMeta(payload, 'nitrogen-templates', doc.id);
+                return Response.json({
+                    dynamic_data: dynamicData,
+                    ...(dynamicDataMeta ? { dynamic_data_meta: dynamicDataMeta } : {}),
+                });
+            }
+            catch {
+                return Response.json({ error: 'Not found' }, { status: 404 });
+            }
+        },
+    },
     // PATCH /api/nitrogen/v1/templates/:id — Update a template
     {
         path: '/nitrogen/v1/nitrogen-templates/:id',
@@ -206,10 +293,39 @@ export const templatesEndpoints = [
             if (Object.keys(updateData).length === 0) {
                 return Response.json({ error: 'No update data provided' }, { status: 400 });
             }
+            // Localization enabled → recompute per-language translation status from
+            // the saved module tree. Advisory only — never blocks the save.
+            if (updateData.nitrogenData !== undefined) {
+                try {
+                    const settings = await getNitrogenSettings(payload);
+                    const localization = getLocalizationSettings(settings);
+                    if (localization) {
+                        const translationStatus = await computeDocTranslationStatus({
+                            payload,
+                            collectionSlug: 'nitrogen-templates',
+                            docId: id,
+                            nitrogenData: updateData.nitrogenData,
+                            localization,
+                        });
+                        if (translationStatus) {
+                            updateData.nitrogenTranslationStatus = translationStatus;
+                        }
+                    }
+                }
+                catch {
+                    // Status is advisory — never block the save.
+                }
+            }
+            // The editor edits default-language field data only — pin the write to
+            // the default locale so it can never target a request-derived locale.
+            const payloadLocalization = getPayloadLocalization(payload);
             await payload.update({
                 collection: 'nitrogen-templates',
                 id,
                 data: updateData,
+                ...(payloadLocalization
+                    ? { locale: payloadLocalization.defaultLocale }
+                    : {}),
             });
             return Response.json({ success: true });
         },

package/dist/endpoints/translation-status.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Translation status route — lists per-language translation coverage for
+ * every Nitrogen-enabled document and template, for the editor's translation
+ * dashboard.
+ *
+ * The status is computed and stored (in `nitrogenTranslationStatus`) by the
+ * save handlers; this route reads the stored value and only computes on the
+ * fly for docs that have never been saved since localization was enabled.
+ */
+import type { Endpoint } from 'payload';
+export declare function createTranslationStatusEndpoints(collections: string[]): Endpoint[];