@delmaredigital/payload-puck 0.4.0 → 0.6.1

package/dist/ai/collections/AiContext.js

@@ -0,0 +1,87 @@
+/**
+ * AI Context Collection
+ *
+ * Stores business context entries for the AI chat interface.
+ * These context entries are concatenated and sent to the AI system prompt
+ * to help it understand your brand, tone, and requirements.
+ *
+ * @example Creating context entries in Payload admin:
+ * - "Brand Guidelines" - Colors, fonts, brand voice
+ * - "Tone of Voice" - How to communicate
+ * - "Product Information" - What you sell/offer
+ * - "Industry Context" - Your market and audience
+ */
+export const AiContextCollection = {
+    slug: 'puck-ai-context',
+    labels: {
+        singular: 'AI Context',
+        plural: 'AI Contexts',
+    },
+    admin: {
+        group: 'Puck',
+        useAsTitle: 'name',
+        defaultColumns: ['name', 'category', 'enabled', 'order', 'updatedAt'],
+        hidden: false, // Visible in admin for context management
+        description: 'Business context for AI page generation. Add entries for brand guidelines, tone of voice, product info, etc.',
+    },
+    access: {
+        // Default: authenticated users can manage context
+        read: ({ req }) => Boolean(req.user),
+        create: ({ req }) => Boolean(req.user),
+        update: ({ req }) => Boolean(req.user),
+        delete: ({ req }) => Boolean(req.user),
+    },
+    fields: [
+        {
+            name: 'name',
+            type: 'text',
+            required: true,
+            admin: {
+                description: 'Name for this context block (e.g., "Brand Guidelines", "Tone of Voice")',
+            },
+        },
+        {
+            name: 'content',
+            type: 'textarea',
+            required: true,
+            admin: {
+                description: 'The context content in markdown format. Use headers (##) to organize, lists for guidelines, etc.',
+                rows: 12,
+            },
+        },
+        {
+            name: 'category',
+            type: 'select',
+            options: [
+                { label: 'Brand Guidelines', value: 'brand' },
+                { label: 'Tone of Voice', value: 'tone' },
+                { label: 'Product Information', value: 'product' },
+                { label: 'Industry Context', value: 'industry' },
+                { label: 'Technical Requirements', value: 'technical' },
+                { label: 'Page Patterns', value: 'patterns' },
+                { label: 'Other', value: 'other' },
+            ],
+            admin: {
+                description: 'Category for organizing context blocks',
+            },
+        },
+        {
+            name: 'enabled',
+            type: 'checkbox',
+            defaultValue: true,
+            admin: {
+                description: 'Include this context in AI prompts. Uncheck to temporarily disable.',
+            },
+        },
+        {
+            name: 'order',
+            type: 'number',
+            defaultValue: 0,
+            admin: {
+                description: 'Order in the context (lower numbers appear earlier in the prompt)',
+            },
+        },
+    ],
+    timestamps: true,
+};
+//# sourceMappingURL=AiContext.js.map

package/dist/ai/collections/AiContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiContext.js","sourceRoot":"","sources":["../../../src/ai/collections/AiContext.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE;QACN,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,aAAa;KACtB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,MAAM;QAClB,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC;QACrE,MAAM,EAAE,KAAK,EAAE,0CAA0C;QACzD,WAAW,EACT,8GAA8G;KACjH;IACD,MAAM,EAAE;QACN,kDAAkD;QAClD,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACpC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;KACvC;IACD,MAAM,EAAE;QACN;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,yEAAyE;aACvF;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EACT,kGAAkG;gBACpG,IAAI,EAAE,EAAE;aACT;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC7C,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE;gBACzC,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE;gBAClD,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE;gBAChD,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;gBACvD,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE;gBAC7C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;aACnC;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,wCAAwC;aACtD;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE;gBACL,WAAW,EAAE,qEAAqE;aACnF;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,CAAC;YACf,KAAK,EAAE;gBACL,WAAW,EAAE,mEAAmE;aACjF;SACF;KACF;IACD,UAAU,EAAE,IAAI;CACjB,CAAA"}

package/dist/ai/collections/AiPrompts.d.ts

@@ -0,0 +1,10 @@
+import type { CollectionConfig } from 'payload';
+/**
+ * AI Prompts Collection
+ *
+ * Stores example prompts for the AI chat interface.
+ * These prompts are displayed in the Puck editor for users to quickly
+ * start common AI generation tasks.
+ */
+export declare const AiPromptsCollection: CollectionConfig;
+//# sourceMappingURL=AiPrompts.d.ts.map

package/dist/ai/collections/AiPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiPrompts.d.ts","sourceRoot":"","sources":["../../../src/ai/collections/AiPrompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAsDjC,CAAA"}

package/dist/ai/collections/AiPrompts.js

@@ -0,0 +1,63 @@
+/**
+ * AI Prompts Collection
+ *
+ * Stores example prompts for the AI chat interface.
+ * These prompts are displayed in the Puck editor for users to quickly
+ * start common AI generation tasks.
+ */
+export const AiPromptsCollection = {
+    slug: 'puck-ai-prompts',
+    labels: {
+        singular: 'AI Prompt',
+        plural: 'AI Prompts',
+    },
+    admin: {
+        group: 'Puck',
+        useAsTitle: 'label',
+        defaultColumns: ['label', 'category', 'order', 'updatedAt'],
+        hidden: false, // Visible in admin for prompt management
+    },
+    access: {
+        // Default: authenticated users can manage prompts
+        read: ({ req }) => Boolean(req.user),
+        create: ({ req }) => Boolean(req.user),
+        update: ({ req }) => Boolean(req.user),
+        delete: ({ req }) => Boolean(req.user),
+    },
+    fields: [
+        {
+            name: 'label',
+            type: 'text',
+            required: true,
+            admin: {
+                description: 'Display label for the prompt (e.g., "Landing page")',
+            },
+        },
+        {
+            name: 'prompt',
+            type: 'textarea',
+            required: true,
+            admin: {
+                description: 'The actual prompt text sent to the AI',
+                rows: 4,
+            },
+        },
+        {
+            name: 'category',
+            type: 'text',
+            admin: {
+                description: 'Optional category for grouping prompts (e.g., "Marketing", "Product")',
+            },
+        },
+        {
+            name: 'order',
+            type: 'number',
+            defaultValue: 0,
+            admin: {
+                description: 'Display order (lower numbers appear first)',
+            },
+        },
+    ],
+    timestamps: true,
+};
+//# sourceMappingURL=AiPrompts.js.map

package/dist/ai/collections/AiPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiPrompts.js","sourceRoot":"","sources":["../../../src/ai/collections/AiPrompts.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE;QACN,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,YAAY;KACrB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,OAAO;QACnB,cAAc,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC;QAC3D,MAAM,EAAE,KAAK,EAAE,yCAAyC;KACzD;IACD,MAAM,EAAE;QACN,kDAAkD;QAClD,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACpC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;KACvC;IACD,MAAM,EAAE;QACN;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,uCAAuC;gBACpD,IAAI,EAAE,CAAC;aACR;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE;gBACL,WAAW,EAAE,uEAAuE;aACrF;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,CAAC;YACf,KAAK,EAAE;gBACL,WAAW,EAAE,4CAA4C;aAC1D;SACF;KACF;IACD,UAAU,EAAE,IAAI;CACjB,CAAA"}

package/dist/ai/createAiApiRoutes.d.ts

@@ -0,0 +1,40 @@
+import type { PuckAiRoutesConfig, PuckAiRouteHandlers } from './types.js';
+/**
+ * Creates API route handlers for /api/puck/[...all]
+ *
+ * Wraps @puckeditor/cloud-client's puckHandler with authentication
+ * and custom context/tools support.
+ *
+ * @example
+ * ```typescript
+ * // app/api/puck/[...all]/route.ts
+ * import { createPuckAiApiRoutes } from '@delmaredigital/payload-puck/ai'
+ * import config from '@payload-config'
+ * import { z } from 'zod'
+ *
+ * export const POST = createPuckAiApiRoutes({
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await auth.api.getSession({ headers: request.headers })
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *   },
+ *   ai: {
+ *     context: 'We are Acme Corp. You build our landing pages.',
+ *     tools: {
+ *       getProducts: {
+ *         description: 'Get a list of products',
+ *         inputSchema: z.object({}),
+ *         execute: async () => {
+ *           return await payload.find({ collection: 'products' })
+ *         },
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export declare function createPuckAiApiRoutes(config: PuckAiRoutesConfig): PuckAiRouteHandlers;
+//# sourceMappingURL=createAiApiRoutes.d.ts.map

package/dist/ai/createAiApiRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiApiRoutes.d.ts","sourceRoot":"","sources":["../../src/ai/createAiApiRoutes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,mBAAmB,CAkFrF"}

package/dist/ai/createAiApiRoutes.js

@@ -0,0 +1,106 @@
+/**
+ * Creates API route handlers for /api/puck/[...all]
+ *
+ * Wraps @puckeditor/cloud-client's puckHandler with authentication
+ * and custom context/tools support.
+ *
+ * @example
+ * ```typescript
+ * // app/api/puck/[...all]/route.ts
+ * import { createPuckAiApiRoutes } from '@delmaredigital/payload-puck/ai'
+ * import config from '@payload-config'
+ * import { z } from 'zod'
+ *
+ * export const POST = createPuckAiApiRoutes({
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await auth.api.getSession({ headers: request.headers })
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *   },
+ *   ai: {
+ *     context: 'We are Acme Corp. You build our landing pages.',
+ *     tools: {
+ *       getProducts: {
+ *         description: 'Get a list of products',
+ *         inputSchema: z.object({}),
+ *         execute: async () => {
+ *           return await payload.find({ collection: 'products' })
+ *         },
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export function createPuckAiApiRoutes(config) {
+    const { auth, ai, onError } = config;
+    return {
+        POST: async (request) => {
+            try {
+                // 1. Authenticate the request
+                const authResult = await auth.authenticate(request);
+                if (!authResult.authenticated) {
+                    return new Response(JSON.stringify({ error: authResult.error || 'Unauthorized' }), {
+                        status: 401,
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                }
+                // 2. Lazy import @puckeditor/cloud-client to avoid errors if not installed
+                let puckHandler;
+                let tool;
+                try {
+                    const cloudClient = await import('@puckeditor/cloud-client');
+                    puckHandler = cloudClient.puckHandler;
+                    tool = cloudClient.tool;
+                }
+                catch (e) {
+                    return new Response(JSON.stringify({
+                        error: 'AI features require @puckeditor/cloud-client. Please install it.',
+                    }), {
+                        status: 500,
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                }
+                // 3. Convert our tool format to Puck's tool format
+                const puckTools = {};
+                if (ai?.tools) {
+                    for (const [name, toolDef] of Object.entries(ai.tools)) {
+                        puckTools[name] = tool({
+                            description: toolDef.description,
+                            inputSchema: toolDef.inputSchema,
+                            execute: toolDef.execute,
+                            name: toolDef.name,
+                        });
+                    }
+                }
+                // 4. Call puckHandler with our configuration
+                return puckHandler(request, {
+                    apiKey: ai?.apiKey,
+                    host: ai?.host,
+                    ai: {
+                        context: ai?.context,
+                        tools: Object.keys(puckTools).length > 0 ? puckTools : undefined,
+                    },
+                });
+            }
+            catch (error) {
+                // Call custom error handler if provided
+                if (onError) {
+                    onError(error, { operation: 'ai-chat', request });
+                }
+                console.error('[Puck AI] Error handling request:', error);
+                return new Response(JSON.stringify({
+                    error: 'Internal server error',
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                }), {
+                    status: 500,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=createAiApiRoutes.js.map

package/dist/ai/createAiApiRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiApiRoutes.js","sourceRoot":"","sources":["../../src/ai/createAiApiRoutes.ts"],"names":[],"mappings":"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"}

package/dist/ai/createAiGenerate.d.ts

@@ -0,0 +1,65 @@
+import type { AiGenerateConfig, AiGenerateFunction } from './types.js';
+/**
+ * Creates a headless AI page generation function
+ *
+ * Use this to generate Puck pages programmatically without the editor UI.
+ * Useful for batch generation, automated workflows, or API-driven page creation.
+ *
+ * @example Basic generation
+ * ```typescript
+ * import { createAiGenerate } from '@delmaredigital/payload-puck/ai'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ * import config from '@payload-config'
+ *
+ * const generatePage = createAiGenerate({
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (req) => {
+ *       // Authenticate the request
+ *       return { authenticated: true, user: { id: 'system' } }
+ *     },
+ *   },
+ *   ai: {
+ *     context: 'We are Acme Corp. You build our marketing pages.',
+ *   },
+ * })
+ *
+ * // Generate a new page
+ * const pageData = await generatePage({
+ *   prompt: 'Create a landing page for our new product launch',
+ *   puckConfig: editorConfig,
+ * })
+ *
+ * // Save to Payload
+ * await payload.create({
+ *   collection: 'pages',
+ *   data: {
+ *     title: 'New Product Launch',
+ *     slug: 'new-product',
+ *     puckData: pageData,
+ *   },
+ * })
+ * ```
+ *
+ * @example Updating an existing page
+ * ```typescript
+ * // Fetch existing page
+ * const page = await payload.findByID({ collection: 'pages', id: 'abc123' })
+ *
+ * // Update with AI
+ * const updatedData = await generatePage({
+ *   prompt: 'Add a testimonials section after the hero',
+ *   puckConfig: editorConfig,
+ *   pageData: page.puckData, // Pass existing data
+ * })
+ *
+ * // Save the update
+ * await payload.update({
+ *   collection: 'pages',
+ *   id: 'abc123',
+ *   data: { puckData: updatedData },
+ * })
+ * ```
+ */
+export declare function createAiGenerate(config: AiGenerateConfig): AiGenerateFunction;
+//# sourceMappingURL=createAiGenerate.d.ts.map

package/dist/ai/createAiGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiGenerate.d.ts","sourceRoot":"","sources":["../../src/ai/createAiGenerate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAkD7E"}

package/dist/ai/createAiGenerate.js

@@ -0,0 +1,106 @@
+/**
+ * Creates a headless AI page generation function
+ *
+ * Use this to generate Puck pages programmatically without the editor UI.
+ * Useful for batch generation, automated workflows, or API-driven page creation.
+ *
+ * @example Basic generation
+ * ```typescript
+ * import { createAiGenerate } from '@delmaredigital/payload-puck/ai'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ * import config from '@payload-config'
+ *
+ * const generatePage = createAiGenerate({
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (req) => {
+ *       // Authenticate the request
+ *       return { authenticated: true, user: { id: 'system' } }
+ *     },
+ *   },
+ *   ai: {
+ *     context: 'We are Acme Corp. You build our marketing pages.',
+ *   },
+ * })
+ *
+ * // Generate a new page
+ * const pageData = await generatePage({
+ *   prompt: 'Create a landing page for our new product launch',
+ *   puckConfig: editorConfig,
+ * })
+ *
+ * // Save to Payload
+ * await payload.create({
+ *   collection: 'pages',
+ *   data: {
+ *     title: 'New Product Launch',
+ *     slug: 'new-product',
+ *     puckData: pageData,
+ *   },
+ * })
+ * ```
+ *
+ * @example Updating an existing page
+ * ```typescript
+ * // Fetch existing page
+ * const page = await payload.findByID({ collection: 'pages', id: 'abc123' })
+ *
+ * // Update with AI
+ * const updatedData = await generatePage({
+ *   prompt: 'Add a testimonials section after the hero',
+ *   puckConfig: editorConfig,
+ *   pageData: page.puckData, // Pass existing data
+ * })
+ *
+ * // Save the update
+ * await payload.update({
+ *   collection: 'pages',
+ *   id: 'abc123',
+ *   data: { puckData: updatedData },
+ * })
+ * ```
+ */
+export function createAiGenerate(config) {
+    const { ai } = config;
+    return async (options) => {
+        const { prompt, puckConfig, pageData } = options;
+        // Lazy import @puckeditor/cloud-client
+        let generate;
+        let tool;
+        try {
+            const cloudClient = await import('@puckeditor/cloud-client');
+            generate = cloudClient.generate;
+            tool = cloudClient.tool;
+        }
+        catch (e) {
+            throw new Error('AI generation requires @puckeditor/cloud-client. Please install it with: pnpm add @puckeditor/cloud-client');
+        }
+        // Convert our tool format to Puck's tool format
+        const puckTools = {};
+        if (ai?.tools) {
+            for (const [name, toolDef] of Object.entries(ai.tools)) {
+                puckTools[name] = tool({
+                    description: toolDef.description,
+                    inputSchema: toolDef.inputSchema,
+                    execute: toolDef.execute,
+                    name: toolDef.name,
+                });
+            }
+        }
+        // Call the generate API
+        const result = await generate({
+            prompt,
+            config: puckConfig,
+            context: ai?.context,
+            apiKey: ai?.apiKey,
+            host: ai?.host,
+            pageData,
+            tools: Object.keys(puckTools).length > 0 ? puckTools : undefined,
+        });
+        if (!result) {
+            throw new Error('AI generation failed: no result returned');
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=createAiGenerate.js.map

package/dist/ai/createAiGenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiGenerate.js","sourceRoot":"","sources":["../../src/ai/createAiGenerate.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAA;IAErB,OAAO,KAAK,EAAE,OAA0B,EAAqB,EAAE;QAC7D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;QAEhD,uCAAuC;QACvC,IAAI,QAA4D,CAAA;QAChE,IAAI,IAAoD,CAAA;QAExD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;YAC5D,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAA;YAC/B,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;QACzB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAA;QACH,CAAC;QAED,gDAAgD;QAChD,MAAM,SAAS,GAA4C,EAAE,CAAA;QAC7D,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;oBACrB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;YAC5B,MAAM;YACN,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,EAAE,EAAE,OAAO;YACpB,MAAM,EAAE,EAAE,EAAE,MAAM;YAClB,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,QAAQ;YACR,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,MAAkB,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC"}

package/dist/ai/createAiPlugin.d.ts

@@ -0,0 +1,39 @@
+import type { Plugin as PuckPlugin } from '@puckeditor/core';
+import type { AiPluginOptions } from './types.js';
+/**
+ * Creates a Puck AI plugin for the editor
+ *
+ * Wraps @puckeditor/plugin-ai with sensible defaults for payload-puck.
+ * This factory allows for runtime-configurable prompts (from database, API, etc.).
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { createAiPlugin } from '@delmaredigital/payload-puck/ai'
+ *
+ * const aiPlugin = createAiPlugin({
+ *   host: '/api/puck',
+ *   examplePrompts: [
+ *     { label: 'Landing page', prompt: 'Create a landing page about our product' },
+ *   ],
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ *
+ * @example With runtime prompts from database
+ * ```tsx
+ * // Fetch prompts from Payload
+ * const prompts = await payload.find({ collection: 'puck-ai-prompts' })
+ *
+ * const aiPlugin = createAiPlugin({
+ *   examplePrompts: prompts.docs.map(p => ({
+ *     label: p.label,
+ *     prompt: p.prompt,
+ *   })),
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ */
+export declare function createAiPlugin(options?: AiPluginOptions): PuckPlugin;
+//# sourceMappingURL=createAiPlugin.d.ts.map

package/dist/ai/createAiPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiPlugin.d.ts","sourceRoot":"","sources":["../../src/ai/createAiPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CA2BxE"}

package/dist/ai/createAiPlugin.js

@@ -0,0 +1,61 @@
+'use client';
+/**
+ * Creates a Puck AI plugin for the editor
+ *
+ * Wraps @puckeditor/plugin-ai with sensible defaults for payload-puck.
+ * This factory allows for runtime-configurable prompts (from database, API, etc.).
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { createAiPlugin } from '@delmaredigital/payload-puck/ai'
+ *
+ * const aiPlugin = createAiPlugin({
+ *   host: '/api/puck',
+ *   examplePrompts: [
+ *     { label: 'Landing page', prompt: 'Create a landing page about our product' },
+ *   ],
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ *
+ * @example With runtime prompts from database
+ * ```tsx
+ * // Fetch prompts from Payload
+ * const prompts = await payload.find({ collection: 'puck-ai-prompts' })
+ *
+ * const aiPlugin = createAiPlugin({
+ *   examplePrompts: prompts.docs.map(p => ({
+ *     label: p.label,
+ *     prompt: p.prompt,
+ *   })),
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ */
+export function createAiPlugin(options = {}) {
+    const { host = '/api/puck', examplePrompts, onSubmit } = options;
+    // Dynamic import to avoid build errors if plugin-ai not installed
+    // Also allows for tree-shaking when AI is not used
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createAiPlugin: createPuckAiPlugin } = require('@puckeditor/plugin-ai');
+        return createPuckAiPlugin({
+            host,
+            chat: {
+                examplePrompts,
+                onSubmit,
+            },
+        });
+    }
+    catch (e) {
+        // Return a placeholder plugin if @puckeditor/plugin-ai is not installed
+        console.warn('[payload-puck] AI plugin requested but @puckeditor/plugin-ai not installed. ' +
+            'Install it with: pnpm add @puckeditor/plugin-ai');
+        return {
+            name: 'ai-placeholder',
+        };
+    }
+}
+//# sourceMappingURL=createAiPlugin.js.map

package/dist/ai/createAiPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiPlugin.js","sourceRoot":"","sources":["../../src/ai/createAiPlugin.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAKZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE;IAC1D,MAAM,EAAE,IAAI,GAAG,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IAEhE,kEAAkE;IAClE,mDAAmD;IACnD,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;QAE/E,OAAO,kBAAkB,CAAC;YACxB,IAAI;YACJ,IAAI,EAAE;gBACJ,cAAc;gBACd,QAAQ;aACT;SACF,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,wEAAwE;QACxE,OAAO,CAAC,IAAI,CACV,8EAA8E;YAC5E,iDAAiD,CACpD,CAAA;QAED,OAAO;YACL,IAAI,EAAE,gBAAgB;SACvB,CAAA;IACH,CAAC;AACH,CAAC"}