@nitrogenbuilder/connector-payload 1.1.1 → 1.2.1

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/ctrlLinkResolver.js

@@ -106,6 +106,35 @@ function resolveMediaUrl(url, settings) {
     const relativeUrl = url.startsWith('/') ? url : `/${url}`;
     return baseUrl ? `${baseUrl}${relativeUrl}` : relativeUrl;
 }
+const MEDIA_PATH_MARKER = 'api/media/file/';
+// The editor's wysiwyg (TinyMCE) rewrites same-origin media URLs to relative
+// paths on save (e.g. `../../api/media/file/x.pdf`), which 404 on the frontend
+// host. Re-anchor anything that is only `./`/`../` hops away from the media
+// path back to the Payload origin; other relative URLs are left untouched.
+function resolveInlineMediaUrl(url, settings) {
+    if (/^https?:\/\//i.test(url))
+        return url;
+    const index = url.indexOf(MEDIA_PATH_MARKER);
+    if (index === -1)
+        return url;
+    const prefix = url.slice(0, index);
+    if (!/^[./]*$/.test(prefix))
+        return url;
+    return resolveMediaUrl(`/${url.slice(index)}`, settings);
+}
+function resolveInlineMediaUrls(value, settings) {
+    if (!value.includes(MEDIA_PATH_MARKER))
+        return value;
+    if (!value.includes('<')) {
+        const trimmed = value.trim();
+        const resolved = resolveInlineMediaUrl(trimmed, settings);
+        return resolved === trimmed ? value : resolved;
+    }
+    return value.replace(/((?:href|src)=)(["'])([^"']*)\2/gi, (match, attr, quote, url) => {
+        const resolved = resolveInlineMediaUrl(url, settings);
+        return resolved === url ? match : `${attr}${quote}${resolved}${quote}`;
+    });
+}
 async function findInternalTarget(context, link, internalRef) {
     const entryId = getId(internalRef.entryId);
     if (entryId === null)
@@ -205,13 +234,25 @@ async function resolveLinkRecord(context, link) {
 }
 async function walk(context, value) {
     if (Array.isArray(value)) {
-        await Promise.all(value.map((item) => walk(context, item)));
+        await Promise.all(value.map(async (item, index) => {
+            if (typeof item === 'string') {
+                value[index] = resolveInlineMediaUrls(item, context.settings);
+                return;
+            }
+            await walk(context, item);
+        }));
         return;
     }
     if (!isRecord(value))
         return;
     await resolveLinkRecord(context, value);
-    await Promise.all(Object.values(value).map((item) => walk(context, item)));
+    await Promise.all(Object.entries(value).map(async ([key, item]) => {
+        if (typeof item === 'string') {
+            value[key] = resolveInlineMediaUrls(item, context.settings);
+            return;
+        }
+        await walk(context, item);
+    }));
 }
 export async function resolveCtrlLinksInNitrogenData(payload, value, settings) {
     if (!value)

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 });
             }