@nitrogenbuilder/connector-payload 0.1.27 → 0.1.29

package/dist/collection-registry.d.ts

@@ -3,5 +3,8 @@
  *
  * The plugin registers collections at init time via `registerCollection()`.
  */
-export declare function registerCollection(alias: string, collectionSlug: string): void;
+export declare function registerCollection(alias: string, collectionSlug: string, routePattern?: string): void;
 export declare function resolveCollection(postType: string): string;
+export declare function resolveCollectionRoutePattern(postType: string): string | undefined;
+export declare function buildRelativePermalink(postType: string, slug: string): string;
+export declare function buildPermalink(postType: string, slug: string, frontendUrl?: string): string;

package/dist/collection-registry.js

@@ -4,9 +4,40 @@
  * The plugin registers collections at init time via `registerCollection()`.
  */
 const registeredCollections = new Map();
-export function registerCollection(alias, collectionSlug) {
-    registeredCollections.set(alias, collectionSlug);
+function normalizeRoutePattern(routePattern) {
+    if (!routePattern)
+        return undefined;
+    return routePattern.startsWith('/') ? routePattern : `/${routePattern}`;
+}
+function buildRelativePath(routePattern, slug) {
+    if (routePattern) {
+        if (routePattern.includes('[...slug]')) {
+            return routePattern.replace('[...slug]', slug);
+        }
+        if (routePattern.includes('[slug]')) {
+            return routePattern.replace('[slug]', slug);
+        }
+        return routePattern.endsWith('/') ? `${routePattern}${slug}` : routePattern;
+    }
+    return `/${slug}`;
+}
+export function registerCollection(alias, collectionSlug, routePattern) {
+    registeredCollections.set(alias, {
+        collectionSlug,
+        routePattern: normalizeRoutePattern(routePattern),
+    });
 }
 export function resolveCollection(postType) {
-    return registeredCollections.get(postType) || postType;
+    return registeredCollections.get(postType)?.collectionSlug || postType;
+}
+export function resolveCollectionRoutePattern(postType) {
+    return registeredCollections.get(postType)?.routePattern;
+}
+export function buildRelativePermalink(postType, slug) {
+    return buildRelativePath(resolveCollectionRoutePattern(postType), slug);
+}
+export function buildPermalink(postType, slug, frontendUrl) {
+    const relativePermalink = buildRelativePermalink(postType, slug);
+    const baseUrl = (frontendUrl || '').replace(/\/$/, '');
+    return baseUrl ? `${baseUrl}${relativePermalink}` : relativePermalink;
 }

package/dist/components/NitrogenEditButtonRuntime.js

@@ -70,7 +70,11 @@ export const NitrogenEditButtonRuntime = ({ collection }) => {
         return null;
     const editorBase = instanceUrl ?? '';
     const isDevelopmentMode = isLocalAdminHost();
-    const editHref = `${editorBase}/nitrogen-editor?token=${encodeURIComponent(token)}&collection=${encodeURIComponent(collection)}&pageId=${id}&authorId=${encodeURIComponent(authorId)}${isDevelopmentMode ? '&development=true' : ''}`;
+    const encodedAuthorId = encodeURIComponent(authorId);
+    const developmentFlags = isDevelopmentMode
+        ? '&development=true&editorDevelopment=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,10 @@ export function createNitrogenEditorPage(config) {
             cssInjection: nitrogenConfig.cssInjection || "",
         };
         const editId = params.pageId;
-        const isEditorDev = isDevelopment && !!settings.instanceUrl;
+        // Keep editor HMR opt-in separate from preview-target selection so a
+        // deployed Payload instance can still preview against a local frontend.
+        const isEditorDevelopment = params.editorDevelopment === "true";
+        const isEditorDev = isEditorDevelopment && !!settings.instanceUrl;
         const editorOrigin = settings.instanceUrl?.replace(/\/$/, "") || "";
         const editorAssetsBase = isEditorDev
             ? editorOrigin
@@ -103,8 +108,8 @@ export function createNitrogenEditorPage(config) {
                         __html: [
                             `window.nitrogenConfig = ${JSON.stringify(builderConfig)};`,
                             `window.nitrogenEditId = "${editId}";`,
-                            // Inject authorId into the URL so the editor can read it from window.location.search
-                            `(function(){var u=new URL(window.location.href);if(!u.searchParams.has("authorId")){u.searchParams.set("authorId",${JSON.stringify(String(user.id))});window.history.replaceState(null,"",u.toString())}})();`,
+                            // Keep both legacy and current author params present for editor builds.
+                            `(function(){var u=new URL(window.location.href),a=${JSON.stringify(String(user.id))},changed=false;if(!u.searchParams.has("authorId")){u.searchParams.set("authorId",a);changed=true}if(!u.searchParams.has("author")){u.searchParams.set("author",a);changed=true}if(changed){window.history.replaceState(null,"",u.toString())}})();`,
                         ].join(""),
                     } }), _jsxs("div", { id: "root", children: [_jsx("div", { style: {
                                 position: "fixed",

package/dist/endpoints/all.js

@@ -1,5 +1,5 @@
 import { getNitrogenSettings } from './helpers';
-import { resolveCollection } from '../collection-registry';
+import { buildPermalink, buildRelativePermalink, resolveCollection, } from '../collection-registry';
 export const allEndpoints = [
     // GET /api/nitrogen/v1/all — List all items with filtering
     {
@@ -34,8 +34,8 @@ export const allEndpoints = [
                     id: doc.id,
                     title: String(doc.title || ''),
                     slug: String(doc.slug || ''),
-                    permalink: `${settings.frontendUrl || ''}/${String(doc.slug || '')}`,
-                    relative_permalink: `/${String(doc.slug || '')}`,
+                    permalink: buildPermalink(postType, String(doc.slug || ''), settings.frontendUrl),
+                    relative_permalink: buildRelativePermalink(postType, String(doc.slug || '')),
                     type: collection,
                 }));
                 return Response.json(items);

package/dist/endpoints/batch.js

@@ -1,4 +1,4 @@
-import { resolveCollection } from "../collection-registry";
+import { buildPermalink, buildRelativePermalink, resolveCollection, } from "../collection-registry";
 import { getNitrogenSettings, buildDynamicData, buildPageResponse, } from "./helpers";
 function toArray(value) {
     if (Array.isArray(value)) {
@@ -189,18 +189,19 @@ export const batchEndpoints = [
                     else if (params.embed) {
                         data = result.docs.map((doc) => {
                             const dynamicData = buildDynamicData(doc, settings);
-                            return buildPageResponse(doc, settings, dynamicData);
+                            return buildPageResponse(doc, settings, dynamicData, collectionSlug);
                         });
                     }
                     else {
                         data = result.docs.map((doc) => {
                             const d = doc;
+                            const slug = String(d.slug || "");
                             return {
                                 id: d.id,
                                 title: String(d.title || ""),
-                                slug: String(d.slug || ""),
-                                permalink: `${settings.frontendUrl || ""}/${String(d.slug || "")}`,
-                                relative_permalink: `/${String(d.slug || "")}`,
+                                slug,
+                                permalink: buildPermalink(endpoint, slug, settings.frontendUrl),
+                                relative_permalink: buildRelativePermalink(endpoint, slug),
                             };
                         });
                     }

package/dist/endpoints/collection-endpoints.js

@@ -28,7 +28,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                     limit: 0,
                     depth: 1,
                 });
-                const items = result.docs.map((doc) => buildListItemResponse(doc, settings));
+                const items = result.docs.map((doc) => buildListItemResponse(doc, settings, collectionSlug));
                 return Response.json(items);
             },
         },
@@ -76,7 +76,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                     ]);
                     const dynamicData = buildDynamicData(doc, settings);
                     return Response.json({
-                        ...buildPageResponse(doc, settings, dynamicData),
+                        ...buildPageResponse(doc, settings, dynamicData, collectionSlug),
                         template: pageTemplate,
                         headerTemplate,
                         footerTemplate,
@@ -146,7 +146,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 const doc = result.docs[0];
                 const dynamicData = buildDynamicData(doc, settings);
                 return Response.json({
-                    ...buildPageResponse(doc, settings, dynamicData),
+                    ...buildPageResponse(doc, settings, dynamicData, collectionSlug),
                     template: pageTemplate,
                     headerTemplate,
                     footerTemplate,
@@ -173,7 +173,7 @@ export function createCollectionEndpoints(collectionSlug, endpointPrefix) {
                 const doc = result.docs[0];
                 const dynamicData = buildDynamicData(doc, settings);
                 return Response.json({
-                    ...buildPageResponse(doc, settings, dynamicData),
+                    ...buildPageResponse(doc, settings, dynamicData, collectionSlug),
                     template: pageTemplate,
                     headerTemplate,
                     footerTemplate,

package/dist/endpoints/helpers.d.ts

@@ -6,7 +6,7 @@ export interface TemplateRef {
 }
 export declare function formatDate(date: string | Date): string;
 export declare function buildDynamicData(doc: NitrogenPageDoc | NitrogenTemplateDoc, globalSettings?: NitrogenSettingsGlobal): JsonObject;
-export declare function buildPageResponse(doc: NitrogenPageDoc | NitrogenTemplateDoc, settings: NitrogenSettingsGlobal, dynamicData: JsonObject): {
+export declare function buildPageResponse(doc: NitrogenPageDoc | NitrogenTemplateDoc, settings: NitrogenSettingsGlobal, dynamicData: JsonObject, collectionSlug?: string): {
     id: string | number;
     token: string;
     title: string;
@@ -29,7 +29,7 @@ export declare function buildPageResponse(doc: NitrogenPageDoc | NitrogenTemplat
         wysiwygColors: {};
     };
 };
-export declare function buildListItemResponse(doc: NitrogenPageDoc | NitrogenTemplateDoc, settings: NitrogenSettingsGlobal): {
+export declare function buildListItemResponse(doc: NitrogenPageDoc | NitrogenTemplateDoc, settings: NitrogenSettingsGlobal, collectionSlug?: string): {
     id: string | number;
     title: string;
     slug: string;

package/dist/endpoints/helpers.js

@@ -1,3 +1,4 @@
+import { buildPermalink, buildRelativePermalink } from '../collection-registry';
 export function formatDate(date) {
     const d = new Date(date);
     const pad = (n) => String(n).padStart(2, '0');
@@ -49,17 +50,18 @@ export function buildDynamicData(doc, globalSettings) {
     }
     return dynamicData;
 }
-export function buildPageResponse(doc, settings, dynamicData) {
+export function buildPageResponse(doc, settings, dynamicData, collectionSlug = 'pages') {
     const pageSettings = 'pageSettings' in doc ? doc.pageSettings : undefined;
     const templateSettings = 'templateSettings' in doc ? doc.templateSettings : undefined;
+    const slug = String(doc.slug || '');
     return {
         id: doc.id,
         token: settings.licenseKey || '',
         title: doc.title,
         author: doc.author && typeof doc.author === 'object' ? doc.author.id : (doc.author || ''),
-        slug: doc.slug,
-        permalink: `${settings.frontendUrl || ''}/${doc.slug}`,
-        relative_permalink: `/${doc.slug}`,
+        slug,
+        permalink: buildPermalink(collectionSlug, slug, settings.frontendUrl),
+        relative_permalink: buildRelativePermalink(collectionSlug, slug),
         content: doc.nitrogenData ? JSON.stringify(doc.nitrogenData) : '[]',
         dynamic_data: dynamicData,
         settings: pageSettings || templateSettings || {
@@ -72,15 +74,16 @@ export function buildPageResponse(doc, settings, dynamicData) {
         },
     };
 }
-export function buildListItemResponse(doc, settings) {
+export function buildListItemResponse(doc, settings, collectionSlug = 'pages') {
     const pageSettings = 'pageSettings' in doc ? doc.pageSettings : undefined;
     const templateSettings = 'templateSettings' in doc ? doc.templateSettings : undefined;
+    const slug = String(doc.slug || '');
     return {
         id: doc.id,
         title: doc.title,
-        slug: doc.slug,
-        permalink: `${settings.frontendUrl || ''}/${doc.slug}`,
-        relative_permalink: `/${doc.slug}`,
+        slug,
+        permalink: buildPermalink(collectionSlug, slug, settings.frontendUrl),
+        relative_permalink: buildRelativePermalink(collectionSlug, slug),
         content: doc.nitrogenData ? JSON.stringify(doc.nitrogenData) : '[]',
         settings: pageSettings || templateSettings || {},
         nitrogen_settings: {

package/dist/endpoints/templates.js

@@ -1,4 +1,4 @@
-import { getNitrogenSettings, buildDynamicData, buildPageResponse, buildListItemResponse, requireAuth, } from './helpers';
+import { getNitrogenSettings, buildDynamicData, buildPageResponse, buildListItemResponse, getTemplateForType, requireAuth, } from './helpers';
 export const templatesEndpoints = [
     // GET /api/nitrogen/v1/nitrogen-templates/slug/:slug — Get a single template by slug
     {
@@ -8,12 +8,16 @@ export const templatesEndpoints = [
             const { payload, routeParams } = req;
             const slug = routeParams?.slug;
             try {
-                const result = await payload.find({
-                    collection: 'nitrogen-templates',
-                    where: { slug: { equals: slug } },
-                    limit: 1,
-                    depth: 1,
-                });
+                const [result, headerTemplate, footerTemplate] = await Promise.all([
+                    payload.find({
+                        collection: 'nitrogen-templates',
+                        where: { slug: { equals: slug } },
+                        limit: 1,
+                        depth: 1,
+                    }),
+                    getTemplateForType(payload, 'header'),
+                    getTemplateForType(payload, 'footer'),
+                ]);
                 const doc = result.docs[0];
                 if (!doc) {
                     return Response.json({ error: 'Not found' }, { status: 404 });
@@ -46,6 +50,12 @@ export const templatesEndpoints = [
                     permalink: frontendBase ? `${frontendBase}${relativePermalink}` : relativePermalink,
                     relative_permalink: relativePermalink,
                     postType: associatedCollection || '',
+                    headerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
+                        ? headerTemplate
+                        : null,
+                    footerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
+                        ? footerTemplate
+                        : null,
                 });
             }
             catch {
@@ -91,11 +101,15 @@ export const templatesEndpoints = [
             const { payload, routeParams } = req;
             const id = routeParams?.id;
             try {
-                const doc = await payload.findByID({
-                    collection: 'nitrogen-templates',
-                    id,
-                    depth: 1,
-                });
+                const [doc, headerTemplate, footerTemplate] = await Promise.all([
+                    payload.findByID({
+                        collection: 'nitrogen-templates',
+                        id,
+                        depth: 1,
+                    }),
+                    getTemplateForType(payload, 'header'),
+                    getTemplateForType(payload, 'footer'),
+                ]);
                 const settings = await getNitrogenSettings(payload);
                 // Build dynamic data from the first document of the associated collection
                 // so the template preview has real data to bind to
@@ -126,6 +140,12 @@ export const templatesEndpoints = [
                     permalink: frontendBase ? `${frontendBase}${relativePermalink}` : relativePermalink,
                     relative_permalink: relativePermalink,
                     postType: associatedCollection || '',
+                    headerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
+                        ? headerTemplate
+                        : null,
+                    footerTemplate: associatedCollection !== 'header' && associatedCollection !== 'footer'
+                        ? footerTemplate
+                        : null,
                 });
             }
             catch {

package/dist/index.d.ts

@@ -10,6 +10,14 @@ export interface NitrogenConnectorPluginOptions {
      * Example: `collections: ['pages', 'blog-posts']`
      */
     collections?: string[];
+    /**
+     * Optional frontend route patterns for collections whose public URLs do not
+     * match the raw collection slug.
+     *
+     * Example:
+     * `collectionRoutes: { posts: '/blog/[slug]', patent: '/patents/[slug]' }`
+     */
+    collectionRoutes?: Record<string, string>;
 }
 export declare const nitrogenConnectorPlugin: (options?: NitrogenConnectorPluginOptions) => Plugin;
 export { NitrogenTemplates } from "./collections/NitrogenTemplates";

package/dist/index.js

@@ -53,11 +53,12 @@ export const nitrogenConnectorPlugin = (options = {}) => (incomingConfig) => {
         ...batchEndpoints,
     ];
     // Register templates collection
-    registerCollection("nitrogen-templates", "nitrogen-templates");
-    registerCollection("nitrogen_template", "nitrogen-templates");
+    registerCollection("nitrogen-templates", "nitrogen-templates", "/nitrogen-templates/[slug]");
+    registerCollection("nitrogen_template", "nitrogen-templates", "/nitrogen-templates/[slug]");
     // Process collections
     const additionalCollections = options.collections || [];
     for (const slug of additionalCollections) {
+        const routePattern = options.collectionRoutes?.[slug];
         // Find the existing collection in the config
         const existingIndex = (config.collections || []).findIndex((col) => col.slug === slug);
         if (existingIndex === -1) {
@@ -125,7 +126,7 @@ export const nitrogenConnectorPlugin = (options = {}) => (incomingConfig) => {
         const collectionEndpoints = createCollectionEndpoints(slug, slug);
         config.endpoints = [...(config.endpoints || []), ...collectionEndpoints];
         // Register in the collection registry for the `all` endpoint
-        registerCollection(slug, slug);
+        registerCollection(slug, slug, routePattern);
     }
     return config;
 };

package/package.json

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