@nitrogenbuilder/connector-payload 0.1.28 → 0.1.30

package/dist/components/NitrogenEditButtonRuntime.js

@@ -71,7 +71,8 @@ export const NitrogenEditButtonRuntime = ({ collection }) => {
     const editorBase = instanceUrl ?? '';
     const isDevelopmentMode = isLocalAdminHost();
     const encodedAuthorId = encodeURIComponent(authorId);
-    const editHref = `${editorBase}/nitrogen-editor?token=${encodeURIComponent(token)}&collection=${encodeURIComponent(collection)}&pageId=${id}&authorId=${encodedAuthorId}&author=${encodedAuthorId}${isDevelopmentMode ? '&development=true' : ''}`;
+    const developmentFlags = isDevelopmentMode ? '&development=true' : '';
+    const editHref = `${editorBase}/nitrogen-editor?token=${encodeURIComponent(token)}&collection=${encodeURIComponent(collection)}&pageId=${id}&authorId=${encodedAuthorId}&author=${encodedAuthorId}${developmentFlags}`;
     const viewHref = collection === 'nitrogen-templates'
         ? `${frontendUrl}/nitrogen-templates/${slug}`
         : `${frontendUrl}/${slug}`;

package/dist/editor/NitrogenEditorPage.d.ts

@@ -3,6 +3,7 @@ interface NitrogenEditorSearchParams {
     pageId?: string;
     collection?: string;
     development?: string;
+    editorDevelopment?: string;
 }
 /**
  * Creates a standalone editor page that loads the Nitrogen builder.

package/dist/editor/NitrogenEditorPage.js

@@ -73,8 +73,10 @@ export function createNitrogenEditorPage(config) {
         const settings = (await payload.findGlobal({
             slug: "nitrogen-settings",
         }));
-        const isDevelopment = params.development === "true";
-        const siteUrl = getSiteUrl(settings, isDevelopment);
+        // `development=true` selects the preview target (`developmentUrl`) without
+        // requiring the editor shell itself to come from a local Vite server.
+        const isPreviewDevelopment = params.development === "true";
+        const siteUrl = getSiteUrl(settings, isPreviewDevelopment);
         const nitrogenConfig = settings.nitrogenConfig || {};
         if (!params.pageId || !params.collection) {
             return redirect("/admin");
@@ -84,7 +86,7 @@ export function createNitrogenEditorPage(config) {
             licenseKey: settings.licenseKey || "",
             provider: {
                 type: "payload",
-                apiUrl: getNitrogenApiUrl(isDevelopment),
+                apiUrl: getNitrogenApiUrl(isPreviewDevelopment),
                 collection: params.collection,
             },
             siteUrl: siteUrl || "",
@@ -93,7 +95,18 @@ export function createNitrogenEditorPage(config) {
             cssInjection: nitrogenConfig.cssInjection || "",
         };
         const editId = params.pageId;
-        const isEditorDev = isDevelopment && !!settings.instanceUrl;
+        // Preserve the old localhost flow: `development=true` should still imply
+        // local editor HMR when the editor page itself is served from localhost.
+        // Deployed hosts stay on the built editor unless explicitly opted in.
+        const requestHost = headersList.get("host") || "";
+        const requestHostname = requestHost.split(":")[0];
+        const isLocalRequestHost = requestHostname === "localhost" ||
+            requestHostname === "127.0.0.1" ||
+            requestHostname === "[::1]";
+        const isEditorDevelopment = params.editorDevelopment === "true";
+        const isEditorDev = !!settings.instanceUrl &&
+            (isEditorDevelopment ||
+                (isPreviewDevelopment && isLocalRequestHost));
         const editorOrigin = settings.instanceUrl?.replace(/\/$/, "") || "";
         const editorAssetsBase = isEditorDev
             ? editorOrigin

package/dist/endpoints/templates.js

@@ -1,4 +1,19 @@
 import { getNitrogenSettings, buildDynamicData, buildPageResponse, buildListItemResponse, getTemplateForType, requireAuth, } from './helpers';
+import { buildPermalink, buildRelativePermalink } from '../collection-registry';
+function isContentTemplateCollection(collection) {
+    return !!collection && collection !== 'header' && collection !== 'footer';
+}
+function getTemplatePreviewTarget(doc, settings, associatedCollection, associatedDoc) {
+    const previewCollection = associatedDoc && isContentTemplateCollection(associatedCollection)
+        ? associatedCollection
+        : 'nitrogen-templates';
+    const previewSlug = String(associatedDoc?.slug || doc.slug || '');
+    return {
+        slug: previewSlug,
+        permalink: buildPermalink(previewCollection, previewSlug, settings.frontendUrl),
+        relative_permalink: buildRelativePermalink(previewCollection, previewSlug),
+    };
+}
 export const templatesEndpoints = [
     // GET /api/nitrogen/v1/nitrogen-templates/slug/:slug — Get a single template by slug
     {
@@ -24,10 +39,9 @@ export const templatesEndpoints = [
                 }
                 const settings = await getNitrogenSettings(payload);
                 let dynamicData = buildDynamicData(doc, settings);
+                let associatedDoc;
                 const associatedCollection = doc.associatedCollection;
-                if (associatedCollection &&
-                    associatedCollection !== 'header' &&
-                    associatedCollection !== 'footer') {
+                if (isContentTemplateCollection(associatedCollection)) {
                     try {
                         const associated = await payload.find({
                             collection: associatedCollection,
@@ -35,7 +49,8 @@ export const templatesEndpoints = [
                             depth: 1,
                         });
                         if (associated.docs.length) {
-                            dynamicData = buildDynamicData(associated.docs[0], settings);
+                            associatedDoc = associated.docs[0];
+                            dynamicData = buildDynamicData(associatedDoc, settings);
                         }
                     }
                     catch {
@@ -43,19 +58,15 @@ export const templatesEndpoints = [
                     }
                 }
                 const response = buildPageResponse(doc, settings, dynamicData);
-                const relativePermalink = `/nitrogen-templates/${doc.slug}`;
-                const frontendBase = (settings.frontendUrl || '').replace(/\/$/, '');
+                const previewTarget = getTemplatePreviewTarget(doc, settings, associatedCollection, associatedDoc);
                 return Response.json({
                     ...response,
-                    permalink: frontendBase ? `${frontendBase}${relativePermalink}` : relativePermalink,
-                    relative_permalink: relativePermalink,
+                    slug: previewTarget.slug,
+                    permalink: previewTarget.permalink,
+                    relative_permalink: previewTarget.relative_permalink,
                     postType: associatedCollection || '',
-                    headerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
-                        ? headerTemplate
-                        : null,
-                    footerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
-                        ? footerTemplate
-                        : null,
+                    headerTemplate: isContentTemplateCollection(associatedCollection) ? headerTemplate : null,
+                    footerTemplate: isContentTemplateCollection(associatedCollection) ? footerTemplate : null,
                 });
             }
             catch {
@@ -114,10 +125,9 @@ export const templatesEndpoints = [
                 // Build dynamic data from the first document of the associated collection
                 // so the template preview has real data to bind to
                 let dynamicData = buildDynamicData(doc, settings);
+                let associatedDoc;
                 const associatedCollection = doc.associatedCollection;
-                if (associatedCollection &&
-                    associatedCollection !== 'header' &&
-                    associatedCollection !== 'footer') {
+                if (isContentTemplateCollection(associatedCollection)) {
                     try {
                         const associated = await payload.find({
                             collection: associatedCollection,
@@ -125,7 +135,8 @@ export const templatesEndpoints = [
                             depth: 1,
                         });
                         if (associated.docs.length) {
-                            dynamicData = buildDynamicData(associated.docs[0], settings);
+                            associatedDoc = associated.docs[0];
+                            dynamicData = buildDynamicData(associatedDoc, settings);
                         }
                     }
                     catch {
@@ -133,19 +144,15 @@ export const templatesEndpoints = [
                     }
                 }
                 const response = buildPageResponse(doc, settings, dynamicData);
-                const relativePermalink = `/nitrogen-templates/${doc.slug}`;
-                const frontendBase = (settings.frontendUrl || '').replace(/\/$/, '');
+                const previewTarget = getTemplatePreviewTarget(doc, settings, associatedCollection, associatedDoc);
                 return Response.json({
                     ...response,
-                    permalink: frontendBase ? `${frontendBase}${relativePermalink}` : relativePermalink,
-                    relative_permalink: relativePermalink,
+                    slug: previewTarget.slug,
+                    permalink: previewTarget.permalink,
+                    relative_permalink: previewTarget.relative_permalink,
                     postType: associatedCollection || '',
-                    headerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
-                        ? headerTemplate
-                        : null,
-                    footerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
-                        ? footerTemplate
-                        : null,
+                    headerTemplate: isContentTemplateCollection(associatedCollection) ? headerTemplate : null,
+                    footerTemplate: isContentTemplateCollection(associatedCollection) ? footerTemplate : null,
                 });
             }
             catch {

package/dist/index.js

@@ -55,6 +55,11 @@ export const nitrogenConnectorPlugin = (options = {}) => (incomingConfig) => {
     // Register templates collection
     registerCollection("nitrogen-templates", "nitrogen-templates", "/nitrogen-templates/[slug]");
     registerCollection("nitrogen_template", "nitrogen-templates", "/nitrogen-templates/[slug]");
+    // Register route patterns for non-editable collections too so templates can
+    // preview against real frontend URLs for their associated collections.
+    for (const [slug, routePattern] of Object.entries(options.collectionRoutes || {})) {
+        registerCollection(slug, slug, routePattern);
+    }
     // Process collections
     const additionalCollections = options.collections || [];
     for (const slug of additionalCollections) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitrogenbuilder/connector-payload",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Nitrogen page builder connector plugin for Payload CMS 3.x",
   "author": "Leonardo Dentzien <leo@torchmedia.ca>",
   "type": "module",