@delmaredigital/payload-puck 0.6.10 → 0.6.13

package/dist/editor/plugins/versionHistoryPlugin.js

@@ -1,7 +1,7 @@
 'use client';
 import { createElement } from 'react';
 import { History } from 'lucide-react';
-import { VersionHistoryPanel } from './VersionHistoryPanel';
+import { VersionHistoryPanel } from './VersionHistoryPanel.js';
 /**
  * Creates a Puck plugin for version history
  *
@@ -20,17 +20,19 @@ import { VersionHistoryPanel } from './VersionHistoryPanel';
  *
  * <Puck plugins={[versionPlugin]} />
  * ```
- */
-export function createVersionHistoryPlugin(options) {
+ */ export function createVersionHistoryPlugin(options) {
     return {
         name: 'version-history',
         label: 'History',
-        icon: createElement(History, { size: 20 }),
-        render: () => createElement(VersionHistoryPanel, {
-            pageId: options.pageId,
-            apiEndpoint: options.apiEndpoint,
-            onRestoreSuccess: options.onRestoreSuccess,
+        icon: /*#__PURE__*/ createElement(History, {
+            size: 20
         }),
+        render: ()=>/*#__PURE__*/ createElement(VersionHistoryPanel, {
+                pageId: options.pageId,
+                apiEndpoint: options.apiEndpoint,
+                onRestoreSuccess: options.onRestoreSuccess
+            })
     };
 }
+
 //# sourceMappingURL=versionHistoryPlugin.js.map

package/dist/editor/plugins/versionHistoryPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"versionHistoryPlugin.js","sourceRoot":"","sources":["../../../src/editor/plugins/versionHistoryPlugin.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAkB3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,EAAE,CACX,aAAa,CAAC,mBAAmB,EAAE;YACjC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC;KACL,CAAA;AACH,CAAC"}
+{"version":3,"sources":["../../../src/editor/plugins/versionHistoryPlugin.tsx"],"sourcesContent":["'use client'\n\nimport { createElement } from 'react'\nimport { History } from 'lucide-react'\nimport type { Plugin } from '@puckeditor/core'\nimport { VersionHistoryPanel } from './VersionHistoryPanel.js'\n\nexport interface VersionHistoryPluginOptions {\n  /**\n   * Page ID to fetch versions for\n   */\n  pageId: string\n  /**\n   * API endpoint base path\n   * @default '/api/puck/pages'\n   */\n  apiEndpoint?: string\n  /**\n   * Callback after successful restore (e.g., to mark editor as clean)\n   */\n  onRestoreSuccess?: () => void\n}\n\n/**\n * Creates a Puck plugin for version history\n *\n * Adds a \"History\" button to the plugin rail that opens a panel\n * showing version history with the ability to restore previous versions.\n *\n * @example\n * ```tsx\n * import { createVersionHistoryPlugin } from '@delmaredigital/payload-puck/editor'\n *\n * const versionPlugin = createVersionHistoryPlugin({\n *   pageId: 'page-123',\n *   apiEndpoint: '/api/puck/pages',\n *   onRestoreSuccess: () => markEditorClean(),\n * })\n *\n * <Puck plugins={[versionPlugin]} />\n * ```\n */\nexport function createVersionHistoryPlugin(options: VersionHistoryPluginOptions): Plugin {\n  return {\n    name: 'version-history',\n    label: 'History',\n    icon: createElement(History, { size: 20 }),\n    render: () =>\n      createElement(VersionHistoryPanel, {\n        pageId: options.pageId,\n        apiEndpoint: options.apiEndpoint,\n        onRestoreSuccess: options.onRestoreSuccess,\n      }),\n  }\n}\n"],"names":["createElement","History","VersionHistoryPanel","createVersionHistoryPlugin","options","name","label","icon","size","render","pageId","apiEndpoint","onRestoreSuccess"],"mappings":"AAAA;AAEA,SAASA,aAAa,QAAQ,QAAO;AACrC,SAASC,OAAO,QAAQ,eAAc;AAEtC,SAASC,mBAAmB,QAAQ,2BAA0B;AAkB9D;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,2BAA2BC,OAAoC;IAC7E,OAAO;QACLC,MAAM;QACNC,OAAO;QACPC,oBAAMP,cAAcC,SAAS;YAAEO,MAAM;QAAG;QACxCC,QAAQ,kBACNT,cAAcE,qBAAqB;gBACjCQ,QAAQN,QAAQM,MAAM;gBACtBC,aAAaP,QAAQO,WAAW;gBAChCC,kBAAkBR,QAAQQ,gBAAgB;YAC5C;IACJ;AACF"}

package/dist/editor/utils/detectPageTree.js

@@ -8,8 +8,7 @@
  * @param config - The Puck config to check
  * @param explicitProp - Optional explicit hasPageTree prop value
  * @returns Whether page-tree fields should be injected
- */
-export function detectPageTree(config, explicitProp) {
+ */ export function detectPageTree(config, explicitProp) {
     // Explicit prop takes precedence
     if (explicitProp !== undefined) {
         return explicitProp;
@@ -20,7 +19,8 @@ export function detectPageTree(config, explicitProp) {
     const hasPageTreeFields = 'folder' in rootFields && 'pageSegment' in rootFields;
     // If fields already exist, page-tree is already configured (via preset)
     // Return false to avoid re-injecting
-    return false && hasPageTreeFields; // Never auto-inject - require explicit opt-in
+    return false && hasPageTreeFields // Never auto-inject - require explicit opt-in
+    ;
 }
 /**
  * Checks if a config already has page-tree fields configured.
@@ -28,9 +28,9 @@ export function detectPageTree(config, explicitProp) {
  *
  * @param config - The Puck config to check
  * @returns Whether the config already has page-tree fields
- */
-export function hasPageTreeFields(config) {
+ */ export function hasPageTreeFields(config) {
     const rootFields = config.root?.fields || {};
     return 'folder' in rootFields && 'pageSegment' in rootFields;
 }
+
 //# sourceMappingURL=detectPageTree.js.map

package/dist/editor/utils/detectPageTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"detectPageTree.js","sourceRoot":"","sources":["../../../src/editor/utils/detectPageTree.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,YAAsB;IACvE,iCAAiC;IACjC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,8EAA8E;IAC9E,8DAA8D;IAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAA;IAC5C,MAAM,iBAAiB,GAAG,QAAQ,IAAI,UAAU,IAAI,aAAa,IAAI,UAAU,CAAA;IAE/E,wEAAwE;IACxE,qCAAqC;IACrC,OAAO,KAAK,IAAI,iBAAiB,CAAA,CAAC,8CAA8C;AAClF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAA;IAC5C,OAAO,QAAQ,IAAI,UAAU,IAAI,aAAa,IAAI,UAAU,CAAA;AAC9D,CAAC"}
+{"version":3,"sources":["../../../src/editor/utils/detectPageTree.ts"],"sourcesContent":["import type { Config as PuckConfig } from '@puckeditor/core'\n\n/**\n * Detects whether page-tree integration should be enabled.\n *\n * Detection priority:\n * 1. Explicit prop takes precedence (true/false)\n * 2. Auto-detect from config: checks if root.fields has both 'folder' and 'pageSegment'\n *\n * @param config - The Puck config to check\n * @param explicitProp - Optional explicit hasPageTree prop value\n * @returns Whether page-tree fields should be injected\n */\nexport function detectPageTree(config: PuckConfig, explicitProp?: boolean): boolean {\n  // Explicit prop takes precedence\n  if (explicitProp !== undefined) {\n    return explicitProp\n  }\n\n  // Auto-detect from config: if root.fields already has folder and pageSegment,\n  // the user is using pageTreeRoot preset - don't double-inject\n  const rootFields = config.root?.fields || {}\n  const hasPageTreeFields = 'folder' in rootFields && 'pageSegment' in rootFields\n\n  // If fields already exist, page-tree is already configured (via preset)\n  // Return false to avoid re-injecting\n  return false && hasPageTreeFields // Never auto-inject - require explicit opt-in\n}\n\n/**\n * Checks if a config already has page-tree fields configured.\n * Useful for determining if injectPageTreeFields would be redundant.\n *\n * @param config - The Puck config to check\n * @returns Whether the config already has page-tree fields\n */\nexport function hasPageTreeFields(config: PuckConfig): boolean {\n  const rootFields = config.root?.fields || {}\n  return 'folder' in rootFields && 'pageSegment' in rootFields\n}\n"],"names":["detectPageTree","config","explicitProp","undefined","rootFields","root","fields","hasPageTreeFields"],"mappings":"AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASA,eAAeC,MAAkB,EAAEC,YAAsB;IACvE,iCAAiC;IACjC,IAAIA,iBAAiBC,WAAW;QAC9B,OAAOD;IACT;IAEA,8EAA8E;IAC9E,8DAA8D;IAC9D,MAAME,aAAaH,OAAOI,IAAI,EAAEC,UAAU,CAAC;IAC3C,MAAMC,oBAAoB,YAAYH,cAAc,iBAAiBA;IAErE,wEAAwE;IACxE,qCAAqC;IACrC,OAAO,SAASG,kBAAkB,8CAA8C;;AAClF;AAEA;;;;;;CAMC,GACD,OAAO,SAASA,kBAAkBN,MAAkB;IAClD,MAAMG,aAAaH,OAAOI,IAAI,EAAEC,UAAU,CAAC;IAC3C,OAAO,YAAYF,cAAc,iBAAiBA;AACpD"}

package/dist/editor/utils/index.js

@@ -1,3 +1,4 @@
 export { injectPageTreeFields } from './injectPageTreeFields.js';
 export { detectPageTree, hasPageTreeFields } from './detectPageTree.js';
+
 //# sourceMappingURL=index.js.map

package/dist/editor/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"sources":["../../../src/editor/utils/index.ts"],"sourcesContent":["export { injectPageTreeFields } from './injectPageTreeFields.js'\nexport { detectPageTree, hasPageTreeFields } from './detectPageTree.js'\n"],"names":["injectPageTreeFields","detectPageTree","hasPageTreeFields"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,4BAA2B;AAChE,SAASC,cAAc,EAAEC,iBAAiB,QAAQ,sBAAqB"}

package/dist/editor/utils/injectPageTreeFields.js

@@ -7,16 +7,19 @@ import { createSlugPreviewField } from '../../fields/SlugPreviewField.js';
  *
  * @param config - The base Puck config to enhance
  * @returns A new config with page-tree fields injected into root.fields
- */
-export function injectPageTreeFields(config) {
+ */ export function injectPageTreeFields(config) {
     // Create page-tree specific fields
     const pageTreeFields = {
-        folder: createFolderPickerField({ label: 'Folder' }),
-        pageSegment: createLockedPageSegmentField({ label: 'Page Segment' }),
+        folder: createFolderPickerField({
+            label: 'Folder'
+        }),
+        pageSegment: createLockedPageSegmentField({
+            label: 'Page Segment'
+        }),
         slug: createSlugPreviewField({
             label: 'URL Slug',
-            hint: 'Auto-generated from folder + page segment',
-        }),
+            hint: 'Auto-generated from folder + page segment'
+        })
     };
     // Merge page-tree fields into root config, replacing existing slug field
     const existingRootFields = config.root?.fields || {};
@@ -27,9 +30,10 @@ export function injectPageTreeFields(config) {
             ...config.root,
             fields: {
                 ...otherFields,
-                ...pageTreeFields,
-            },
-        },
+                ...pageTreeFields
+            }
+        }
     };
 }
+
 //# sourceMappingURL=injectPageTreeFields.js.map

package/dist/editor/utils/injectPageTreeFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectPageTreeFields.js","sourceRoot":"","sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,mCAAmC;IACnC,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACpD,WAAW,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACpE,IAAI,EAAE,sBAAsB,CAAC;YAC3B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,2CAA2C;SAClD,CAAC;KACH,CAAA;IAED,yEAAyE;IACzE,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAA;IACpD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,kBAA6C,CAAA;IAE7F,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,MAAM,CAAC,IAAI;YACd,MAAM,EAAE;gBACN,GAAG,WAAW;gBACd,GAAG,cAAc;aAClB;SACF;KACY,CAAA;AACjB,CAAC"}
+{"version":3,"sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"sourcesContent":["import type { Config as PuckConfig } from '@puckeditor/core'\nimport { createFolderPickerField } from '../../fields/FolderPickerField.js'\nimport { createLockedPageSegmentField } from '../../fields/PageSegmentField.js'\nimport { createSlugPreviewField } from '../../fields/SlugPreviewField.js'\n\n/**\n * Injects page-tree fields (folder, pageSegment, slug) into a Puck config's root fields.\n * Replaces any existing slug field with the page-tree slug preview.\n *\n * @param config - The base Puck config to enhance\n * @returns A new config with page-tree fields injected into root.fields\n */\nexport function injectPageTreeFields(config: PuckConfig): PuckConfig {\n  // Create page-tree specific fields\n  const pageTreeFields = {\n    folder: createFolderPickerField({ label: 'Folder' }),\n    pageSegment: createLockedPageSegmentField({ label: 'Page Segment' }),\n    slug: createSlugPreviewField({\n      label: 'URL Slug',\n      hint: 'Auto-generated from folder + page segment',\n    }),\n  }\n\n  // Merge page-tree fields into root config, replacing existing slug field\n  const existingRootFields = config.root?.fields || {}\n  const { slug: _existingSlug, ...otherFields } = existingRootFields as Record<string, unknown>\n\n  return {\n    ...config,\n    root: {\n      ...config.root,\n      fields: {\n        ...otherFields,\n        ...pageTreeFields,\n      },\n    },\n  } as PuckConfig\n}\n"],"names":["createFolderPickerField","createLockedPageSegmentField","createSlugPreviewField","injectPageTreeFields","config","pageTreeFields","folder","label","pageSegment","slug","hint","existingRootFields","root","fields","_existingSlug","otherFields"],"mappings":"AACA,SAASA,uBAAuB,QAAQ,oCAAmC;AAC3E,SAASC,4BAA4B,QAAQ,mCAAkC;AAC/E,SAASC,sBAAsB,QAAQ,mCAAkC;AAEzE;;;;;;CAMC,GACD,OAAO,SAASC,qBAAqBC,MAAkB;IACrD,mCAAmC;IACnC,MAAMC,iBAAiB;QACrBC,QAAQN,wBAAwB;YAAEO,OAAO;QAAS;QAClDC,aAAaP,6BAA6B;YAAEM,OAAO;QAAe;QAClEE,MAAMP,uBAAuB;YAC3BK,OAAO;YACPG,MAAM;QACR;IACF;IAEA,yEAAyE;IACzE,MAAMC,qBAAqBP,OAAOQ,IAAI,EAAEC,UAAU,CAAC;IACnD,MAAM,EAAEJ,MAAMK,aAAa,EAAE,GAAGC,aAAa,GAAGJ;IAEhD,OAAO;QACL,GAAGP,MAAM;QACTQ,MAAM;YACJ,GAAGR,OAAOQ,IAAI;YACdC,QAAQ;gBACN,GAAGE,WAAW;gBACd,GAAGV,cAAc;YACnB;QACF;IACF;AACF"}

package/dist/endpoints/ai.js

@@ -2,39 +2,40 @@ import { pagePatternSystemContext } from '../ai/presets/index.js';
 /**
  * Collection slug for AI context
  * Matches the auto-generated collection from createPuckPlugin
- */
-const AI_CONTEXT_COLLECTION = 'puck-ai-context';
+ */ const AI_CONTEXT_COLLECTION = 'puck-ai-context';
 /**
  * Fetches dynamic context entries from the database
  * @param req - The Payload request object
  * @returns Concatenated context string or undefined if no entries
- */
-async function fetchDynamicContext(req) {
+ */ async function fetchDynamicContext(req) {
     try {
         // Check if the context collection exists (it's optional)
         const collections = req.payload.config.collections;
-        const hasContextCollection = collections?.some((c) => c.slug === AI_CONTEXT_COLLECTION);
+        const hasContextCollection = collections?.some((c)=>c.slug === AI_CONTEXT_COLLECTION);
         if (!hasContextCollection) {
             return undefined;
         }
         // Fetch enabled context entries, sorted by order
         const result = await req.payload.find({
             collection: AI_CONTEXT_COLLECTION,
-            where: { enabled: { equals: true } },
+            where: {
+                enabled: {
+                    equals: true
+                }
+            },
             sort: 'order',
-            limit: 100, // Reasonable limit for context entries
+            limit: 100
         });
         if (!result.docs || result.docs.length === 0) {
             return undefined;
         }
         // Format each context entry with its name as a header
-        const contextBlocks = result.docs.map((doc) => {
+        const contextBlocks = result.docs.map((doc)=>{
             const header = doc.category ? `## ${doc.name} (${doc.category})` : `## ${doc.name}`;
             return `${header}\n\n${doc.content}`;
         });
         return contextBlocks.join('\n\n---\n\n');
-    }
-    catch (e) {
+    } catch (e) {
         // Log but don't fail - context is optional
         console.warn('[payload-puck] Failed to fetch dynamic AI context:', e);
         return undefined;
@@ -55,27 +56,37 @@ async function fetchDynamicContext(req) {
  *     context: 'You build pages for Acme Corp...',
  *   },
  * })
- */
-export function createAiEndpointHandler(options = {}) {
-    return async (req) => {
+ */ export function createAiEndpointHandler(options = {}) {
+    return async (req)=>{
         // 1. Require authentication - AI features are admin-only
         if (!req.user) {
-            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
         }
         // 2. Lazy import to avoid bundle bloat (like PostCSS pattern in styles.ts)
         let puckHandler;
         try {
             const cloudClient = await import('@puckeditor/cloud-client');
             puckHandler = cloudClient.puckHandler;
-        }
-        catch (e) {
+        } catch (e) {
             console.error('[payload-puck] Failed to load @puckeditor/cloud-client:', e);
-            return Response.json({ error: 'AI requires @puckeditor/cloud-client. This should be bundled with the plugin.' }, { status: 500 });
+            return Response.json({
+                error: 'AI requires @puckeditor/cloud-client. This should be bundled with the plugin.'
+            }, {
+                status: 500
+            });
         }
         // 3. Check for API key
         const apiKey = process.env.PUCK_API_KEY;
         if (!apiKey) {
-            return Response.json({ error: 'PUCK_API_KEY environment variable is not set' }, { status: 500 });
+            return Response.json({
+                error: 'PUCK_API_KEY environment variable is not set'
+            }, {
+                status: 500
+            });
         }
         // 4. Forward to Puck Cloud handler
         // puckHandler expects a standard Web Request object with specific pathname
@@ -92,25 +103,31 @@ export function createAiEndpointHandler(options = {}) {
             // BUT: if field has AI instructions, don't exclude it (we want AI to use it)
             // This handles fields added by page-tree or user customization
             if (body?.config?.root?.fields) {
-                for (const [fieldName, field] of Object.entries(body.config.root.fields)) {
+                for (const [fieldName, field] of Object.entries(body.config.root.fields)){
                     const f = field;
                     // Only exclude if: is custom, doesn't have exclude set, AND doesn't have instructions
                     if (f.type === 'custom' && !f.ai?.exclude && !f.ai?.instructions) {
-                        f.ai = { ...f.ai, exclude: true };
+                        f.ai = {
+                            ...f.ai,
+                            exclude: true
+                        };
                     }
                 }
             }
             // Auto-exclude custom fields in components that don't have ai.exclude set
             // BUT: if field has AI instructions, don't exclude it (we want AI to use it)
             if (body?.config?.components) {
-                for (const [, comp] of Object.entries(body.config.components)) {
+                for (const [, comp] of Object.entries(body.config.components)){
                     const c = comp;
                     if (c.fields) {
-                        for (const [, field] of Object.entries(c.fields)) {
+                        for (const [, field] of Object.entries(c.fields)){
                             const f = field;
                             // Only exclude if: is custom, doesn't have exclude set, AND doesn't have instructions
                             if (f.type === 'custom' && !f.ai?.exclude && !f.ai?.instructions) {
-                                f.ai = { ...f.ai, exclude: true };
+                                f.ai = {
+                                    ...f.ai,
+                                    exclude: true
+                                };
                             }
                         }
                     }
@@ -118,7 +135,11 @@ export function createAiEndpointHandler(options = {}) {
             }
             // Validate required fields - puckHandler expects config and pageData
             if (!body) {
-                return Response.json({ error: 'Request body is required' }, { status: 400 });
+                return Response.json({
+                    error: 'Request body is required'
+                }, {
+                    status: 400
+                });
             }
             // Ensure config exists (puckHandler needs this)
             if (!body.config) {
@@ -140,7 +161,7 @@ export function createAiEndpointHandler(options = {}) {
             const webRequest = new Request(url, {
                 method: 'POST',
                 headers,
-                body: JSON.stringify(body),
+                body: JSON.stringify(body)
             });
             // Build AI options, only including properties that have values
             // (passing `tools: undefined` explicitly prevents the default from applying)
@@ -171,24 +192,24 @@ export function createAiEndpointHandler(options = {}) {
             if (options.tools && Object.keys(options.tools).length > 0) {
                 const toolContext = {
                     payload: req.payload,
-                    user: req.user,
+                    user: req.user
                 };
                 // Create wrapped tools that inject the context
                 const wrappedTools = {};
-                for (const [name, tool] of Object.entries(options.tools)) {
+                for (const [name, tool] of Object.entries(options.tools)){
                     wrappedTools[name] = {
                         name: tool.name,
                         description: tool.description,
                         inputSchema: tool.inputSchema,
                         // Wrap execute to inject Payload context
-                        execute: (input) => tool.execute(input, toolContext),
+                        execute: (input)=>tool.execute(input, toolContext)
                     };
                 }
                 aiOptions.tools = wrappedTools;
             }
             const response = await puckHandler(webRequest, {
                 ai: aiOptions,
-                apiKey,
+                apiKey
             });
             if (!response.ok) {
                 // Try to get more info from error response
@@ -196,18 +217,21 @@ export function createAiEndpointHandler(options = {}) {
                 try {
                     const errorBody = await clonedResponse.json();
                     console.error('[payload-puck] Puck Cloud error body:', errorBody);
-                }
-                catch {
+                } catch  {
                     const errorText = await clonedResponse.text();
                     console.error('[payload-puck] Puck Cloud error text:', errorText);
                 }
             }
             return response;
-        }
-        catch (e) {
+        } catch (e) {
             console.error('[payload-puck] AI handler error:', e);
-            return Response.json({ error: e instanceof Error ? e.message : 'AI request failed' }, { status: 500 });
+            return Response.json({
+                error: e instanceof Error ? e.message : 'AI request failed'
+            }, {
+                status: 500
+            });
         }
     };
 }
+
 //# sourceMappingURL=ai.js.map

package/dist/endpoints/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../src/endpoints/ai.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport type { AiTool, AiToolContext, AiContext } from '../ai/types.js'\nimport { pagePatternSystemContext } from '../ai/presets/index.js'\n\n// Re-export for convenience\nexport type { AiTool, AiToolContext }\n\n/**\n * Collection slug for AI context\n * Matches the auto-generated collection from createPuckPlugin\n */\nconst AI_CONTEXT_COLLECTION = 'puck-ai-context'\n\n/**\n * Fetches dynamic context entries from the database\n * @param req - The Payload request object\n * @returns Concatenated context string or undefined if no entries\n */\nasync function fetchDynamicContext(req: PayloadRequest): Promise<string | undefined> {\n  try {\n    // Check if the context collection exists (it's optional)\n    const collections = req.payload.config.collections\n    const hasContextCollection = collections?.some((c) => c.slug === AI_CONTEXT_COLLECTION)\n\n    if (!hasContextCollection) {\n      return undefined\n    }\n\n    // Fetch enabled context entries, sorted by order\n    const result = await req.payload.find({\n      collection: AI_CONTEXT_COLLECTION,\n      where: { enabled: { equals: true } },\n      sort: 'order',\n      limit: 100, // Reasonable limit for context entries\n    })\n\n    if (!result.docs || result.docs.length === 0) {\n      return undefined\n    }\n\n    // Format each context entry with its name as a header\n    const contextBlocks = (result.docs as AiContext[]).map((doc) => {\n      const header = doc.category ? `## ${doc.name} (${doc.category})` : `## ${doc.name}`\n      return `${header}\\n\\n${doc.content}`\n    })\n\n    return contextBlocks.join('\\n\\n---\\n\\n')\n  } catch (e) {\n    // Log but don't fail - context is optional\n    console.warn('[payload-puck] Failed to fetch dynamic AI context:', e)\n    return undefined\n  }\n}\n\n/**\n * Options for the AI endpoint handler\n */\nexport interface AiEndpointOptions {\n  /**\n   * Business context for AI generation\n   * Helps the AI understand your brand, tone, and requirements\n   */\n  context?: string\n  /**\n   * Custom tools for AI to use during generation\n   * These allow AI to perform actions like database lookups, API calls, etc.\n   */\n  tools?: Record<string, AiTool>\n}\n\n/**\n * Creates a Payload endpoint handler for Puck AI\n *\n * This handler wraps @puckeditor/cloud-client's puckHandler with\n * Payload authentication. It's auto-registered by createPuckPlugin\n * when `ai.enabled: true`.\n *\n * @example\n * // Automatically registered at /api/puck/ai when:\n * createPuckPlugin({\n *   ai: {\n *     enabled: true,\n *     context: 'You build pages for Acme Corp...',\n *   },\n * })\n */\nexport function createAiEndpointHandler(options: AiEndpointOptions = {}): PayloadHandler {\n  return async (req) => {\n    // 1. Require authentication - AI features are admin-only\n    if (!req.user) {\n      return Response.json({ error: 'Unauthorized' }, { status: 401 })\n    }\n\n    // 2. Lazy import to avoid bundle bloat (like PostCSS pattern in styles.ts)\n    let puckHandler: typeof import('@puckeditor/cloud-client').puckHandler\n    try {\n      const cloudClient = await import('@puckeditor/cloud-client')\n      puckHandler = cloudClient.puckHandler\n    } catch (e) {\n      console.error('[payload-puck] Failed to load @puckeditor/cloud-client:', e)\n      return Response.json(\n        { error: 'AI requires @puckeditor/cloud-client. This should be bundled with the plugin.' },\n        { status: 500 }\n      )\n    }\n\n    // 3. Check for API key\n    const apiKey = process.env.PUCK_API_KEY\n    if (!apiKey) {\n      return Response.json(\n        { error: 'PUCK_API_KEY environment variable is not set' },\n        { status: 500 }\n      )\n    }\n\n    // 4. Forward to Puck Cloud handler\n    // puckHandler expects a standard Web Request object with specific pathname\n    // The handler internally routes based on pathname - it expects /api/puck/chat\n    // See: @puckeditor/cloud-client/src/routes.ts - routeRegistry['/api/puck/chat']\n    try {\n      // Get the request body\n      const body = await req.json?.()\n\n      // NOTE: We previously removed null values from defaultProps here, but this\n      // was preventing the AI from knowing about optional styling fields.\n      // Per Puck docs: \"All fields in defaultProps are considered required by the agent\"\n      // Fields with null values still need to be present so the AI knows they exist.\n\n      // Auto-exclude custom fields in root that don't have ai.exclude set\n      // BUT: if field has AI instructions, don't exclude it (we want AI to use it)\n      // This handles fields added by page-tree or user customization\n      if (body?.config?.root?.fields) {\n        for (const [fieldName, field] of Object.entries(body.config.root.fields)) {\n          const f = field as any\n          // Only exclude if: is custom, doesn't have exclude set, AND doesn't have instructions\n          if (f.type === 'custom' && !f.ai?.exclude && !f.ai?.instructions) {\n            f.ai = { ...f.ai, exclude: true }\n          }\n        }\n      }\n\n      // Auto-exclude custom fields in components that don't have ai.exclude set\n      // BUT: if field has AI instructions, don't exclude it (we want AI to use it)\n      if (body?.config?.components) {\n        for (const [, comp] of Object.entries(body.config.components)) {\n          const c = comp as any\n          if (c.fields) {\n            for (const [, field] of Object.entries(c.fields)) {\n              const f = field as any\n              // Only exclude if: is custom, doesn't have exclude set, AND doesn't have instructions\n              if (f.type === 'custom' && !f.ai?.exclude && !f.ai?.instructions) {\n                f.ai = { ...f.ai, exclude: true }\n              }\n            }\n          }\n        }\n      }\n\n      // Validate required fields - puckHandler expects config and pageData\n      if (!body) {\n        return Response.json({ error: 'Request body is required' }, { status: 400 })\n      }\n\n      // Ensure config exists (puckHandler needs this)\n      if (!body.config) {\n        console.warn('[payload-puck] AI request missing config, this may cause issues')\n      }\n\n      // Construct URL with the pathname puckHandler expects\n      // Our Payload endpoint is /api/puck/ai but puckHandler routes to /api/puck/chat\n      const protocol = req.headers.get('x-forwarded-proto') || 'http'\n      const host = req.headers.get('host') || 'localhost'\n      const url = `${protocol}://${host}/api/puck/chat`\n\n      // Create new headers without content-length (will be recalculated)\n      const headers = new Headers()\n      headers.set('content-type', 'application/json')\n      // Copy auth headers\n      const authHeader = req.headers.get('authorization')\n      if (authHeader) {\n        headers.set('authorization', authHeader)\n      }\n\n      const webRequest = new Request(url, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(body),\n      })\n\n      // Build AI options, only including properties that have values\n      // (passing `tools: undefined` explicitly prevents the default from applying)\n      const aiOptions: { context?: string; tools?: Record<string, any> } = {}\n\n      // Build context from multiple sources:\n      // 1. Static context from plugin config\n      // 2. Dynamic context from database (puck-ai-context collection)\n      // 3. Page pattern system context (composition guidance)\n      const contextParts: string[] = []\n\n      // Add static context from plugin config\n      if (options.context) {\n        contextParts.push(options.context)\n      }\n\n      // Fetch and add dynamic context from database\n      const dynamicContext = await fetchDynamicContext(req)\n      if (dynamicContext) {\n        contextParts.push('# Business Context\\n\\n' + dynamicContext)\n      }\n\n      // Always add page pattern system context for better composition\n      if (pagePatternSystemContext) {\n        contextParts.push(pagePatternSystemContext)\n      }\n\n      // Combine all context parts\n      if (contextParts.length > 0) {\n        aiOptions.context = contextParts.join('\\n\\n---\\n\\n')\n      }\n\n      // Wrap tools to inject Payload context into execute functions\n      if (options.tools && Object.keys(options.tools).length > 0) {\n        const toolContext: AiToolContext = {\n          payload: req.payload,\n          user: req.user,\n        }\n\n        // Create wrapped tools that inject the context\n        const wrappedTools: Record<string, any> = {}\n        for (const [name, tool] of Object.entries(options.tools)) {\n          wrappedTools[name] = {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.inputSchema,\n            // Wrap execute to inject Payload context\n            execute: (input: any) => tool.execute(input, toolContext),\n          }\n        }\n        aiOptions.tools = wrappedTools\n      }\n\n      const response = await puckHandler(webRequest, {\n        ai: aiOptions,\n        apiKey,\n      })\n\n      if (!response.ok) {\n        // Try to get more info from error response\n        const clonedResponse = response.clone()\n        try {\n          const errorBody = await clonedResponse.json()\n          console.error('[payload-puck] Puck Cloud error body:', errorBody)\n        } catch {\n          const errorText = await clonedResponse.text()\n          console.error('[payload-puck] Puck Cloud error text:', errorText)\n        }\n      }\n\n      return response\n    } catch (e) {\n      console.error('[payload-puck] AI handler error:', e)\n      return Response.json(\n        { error: e instanceof Error ? e.message : 'AI request failed' },\n        { status: 500 }\n      )\n    }\n  }\n}\n"],"names":["pagePatternSystemContext","AI_CONTEXT_COLLECTION","fetchDynamicContext","req","collections","payload","config","hasContextCollection","some","c","slug","undefined","result","find","collection","where","enabled","equals","sort","limit","docs","length","contextBlocks","map","doc","header","category","name","content","join","e","console","warn","createAiEndpointHandler","options","user","Response","json","error","status","puckHandler","cloudClient","apiKey","process","env","PUCK_API_KEY","body","root","fields","fieldName","field","Object","entries","f","type","ai","exclude","instructions","components","comp","protocol","headers","get","host","url","Headers","set","authHeader","webRequest","Request","method","JSON","stringify","aiOptions","contextParts","context","push","dynamicContext","tools","keys","toolContext","wrappedTools","tool","description","inputSchema","execute","input","response","ok","clonedResponse","clone","errorBody","errorText","text","Error","message"],"mappings":"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"}

package/dist/endpoints/context.js

@@ -1,19 +1,21 @@
 /**
  * Collection slug for AI context
  * Matches the auto-generated collection from createPuckPlugin
- */
-const COLLECTION = 'puck-ai-context';
+ */ const COLLECTION = 'puck-ai-context';
 /**
  * List all AI context entries, sorted by order
  * Only returns enabled entries by default
  *
  * GET /api/puck/ai-context
  * Query: ?all=true to include disabled entries
- */
-export function createContextListHandler() {
-    return async (req) => {
+ */ export function createContextListHandler() {
+    return async (req)=>{
         if (!req.user) {
-            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
         }
         try {
             // Check if we should include all entries (including disabled)
@@ -21,14 +23,21 @@ export function createContextListHandler() {
             const result = await req.payload.find({
                 collection: COLLECTION,
                 sort: 'order',
-                limit: 100, // Reasonable limit for context entries
-                where: includeAll ? {} : { enabled: { equals: true } },
+                limit: 100,
+                where: includeAll ? {} : {
+                    enabled: {
+                        equals: true
+                    }
+                }
             });
             return Response.json(result);
-        }
-        catch (e) {
+        } catch (e) {
             console.error('[payload-puck] Error listing context:', e);
-            return Response.json({ error: e instanceof Error ? e.message : 'Failed to list context' }, { status: 500 });
+            return Response.json({
+                error: e instanceof Error ? e.message : 'Failed to list context'
+            }, {
+                status: 500
+            });
         }
     };
 }
@@ -37,26 +46,36 @@ export function createContextListHandler() {
  *
  * POST /api/puck/ai-context
  * Body: { name: string, content: string, category?: string, enabled?: boolean, order?: number }
- */
-export function createContextCreateHandler() {
-    return async (req) => {
+ */ export function createContextCreateHandler() {
+    return async (req)=>{
         if (!req.user) {
-            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
         }
         try {
             const data = await req.json?.();
             if (!data) {
-                return Response.json({ error: 'Request body is required' }, { status: 400 });
+                return Response.json({
+                    error: 'Request body is required'
+                }, {
+                    status: 400
+                });
             }
             const doc = await req.payload.create({
                 collection: COLLECTION,
-                data,
+                data
             });
             return Response.json(doc);
-        }
-        catch (e) {
+        } catch (e) {
             console.error('[payload-puck] Error creating context:', e);
-            return Response.json({ error: e instanceof Error ? e.message : 'Failed to create context' }, { status: 500 });
+            return Response.json({
+                error: e instanceof Error ? e.message : 'Failed to create context'
+            }, {
+                status: 500
+            });
         }
     };
 }
@@ -65,31 +84,45 @@ export function createContextCreateHandler() {
  *
  * PATCH /api/puck/ai-context/:id
  * Body: { name?: string, content?: string, category?: string, enabled?: boolean, order?: number }
- */
-export function createContextUpdateHandler() {
-    return async (req) => {
+ */ export function createContextUpdateHandler() {
+    return async (req)=>{
         if (!req.user) {
-            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
         }
         const id = req.routeParams?.id;
         if (!id) {
-            return Response.json({ error: 'Context ID is required' }, { status: 400 });
+            return Response.json({
+                error: 'Context ID is required'
+            }, {
+                status: 400
+            });
         }
         try {
             const data = await req.json?.();
             if (!data) {
-                return Response.json({ error: 'Request body is required' }, { status: 400 });
+                return Response.json({
+                    error: 'Request body is required'
+                }, {
+                    status: 400
+                });
             }
             const doc = await req.payload.update({
                 collection: COLLECTION,
                 id,
-                data,
+                data
             });
             return Response.json(doc);
-        }
-        catch (e) {
+        } catch (e) {
             console.error('[payload-puck] Error updating context:', e);
-            return Response.json({ error: e instanceof Error ? e.message : 'Failed to update context' }, { status: 500 });
+            return Response.json({
+                error: e instanceof Error ? e.message : 'Failed to update context'
+            }, {
+                status: 500
+            });
         }
     };
 }
@@ -97,27 +130,40 @@ export function createContextUpdateHandler() {
  * Delete an AI context entry
  *
  * DELETE /api/puck/ai-context/:id
- */
-export function createContextDeleteHandler() {
-    return async (req) => {
+ */ export function createContextDeleteHandler() {
+    return async (req)=>{
         if (!req.user) {
-            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+            return Response.json({
+                error: 'Unauthorized'
+            }, {
+                status: 401
+            });
         }
         const id = req.routeParams?.id;
         if (!id) {
-            return Response.json({ error: 'Context ID is required' }, { status: 400 });
+            return Response.json({
+                error: 'Context ID is required'
+            }, {
+                status: 400
+            });
         }
         try {
             await req.payload.delete({
                 collection: COLLECTION,
-                id,
+                id
             });
-            return Response.json({ success: true });
-        }
-        catch (e) {
+            return Response.json({
+                success: true
+            });
+        } catch (e) {
             console.error('[payload-puck] Error deleting context:', e);
-            return Response.json({ error: e instanceof Error ? e.message : 'Failed to delete context' }, { status: 500 });
+            return Response.json({
+                error: e instanceof Error ? e.message : 'Failed to delete context'
+            }, {
+                status: 500
+            });
         }
     };
 }
+
 //# sourceMappingURL=context.js.map