@delmaredigital/payload-puck 0.4.0 → 0.6.0

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"}

package/dist/ai/hooks/useAiContext.d.ts

@@ -0,0 +1,63 @@
+import type { AiContext } from '../types.js';
+/** Event name for context updates */
+export declare const AI_CONTEXT_UPDATED_EVENT = "puck:ai-context-updated";
+/**
+ * Dispatches an event to notify that AI context has been updated
+ * Call this after creating, editing, or deleting a context entry
+ */
+export declare function dispatchContextUpdated(): void;
+export interface UseAiContextOptions {
+    /**
+     * API endpoint to fetch context from
+     * @default '/api/puck/ai-context'
+     */
+    apiEndpoint?: string;
+    /**
+     * Whether to enable fetching
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Whether to include disabled entries
+     * @default false
+     */
+    includeDisabled?: boolean;
+}
+export interface UseAiContextReturn {
+    /** Array of context entries */
+    context: AiContext[];
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Refetch context entries */
+    refetch: () => Promise<void>;
+    /** Create a new context entry */
+    create: (data: Omit<AiContext, 'id' | 'createdAt' | 'updatedAt'>) => Promise<AiContext | null>;
+    /** Update an existing context entry */
+    update: (id: string, data: Partial<AiContext>) => Promise<AiContext | null>;
+    /** Delete a context entry */
+    remove: (id: string) => Promise<boolean>;
+}
+/**
+ * Hook to fetch and manage AI context entries client-side
+ *
+ * When context is updated via the context editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @example
+ * ```tsx
+ * const { context, loading, create, update, remove } = useAiContext()
+ *
+ * // Create a new context entry
+ * await create({ name: 'Brand Guidelines', content: '...', enabled: true })
+ *
+ * // Update an entry
+ * await update(context[0].id, { content: 'Updated content' })
+ *
+ * // Delete an entry
+ * await remove(context[0].id)
+ * ```
+ */
+export declare function useAiContext(options?: UseAiContextOptions): UseAiContextReturn;
+//# sourceMappingURL=useAiContext.d.ts.map

package/dist/ai/hooks/useAiContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiContext.d.ts","sourceRoot":"","sources":["../../../src/ai/hooks/useAiContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,4BAA4B,CAAA;AAEjE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,iCAAiC;IACjC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC9F,uCAAuC;IACvC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3E,6BAA6B;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA4IlF"}

package/dist/ai/hooks/useAiContext.js

@@ -0,0 +1,146 @@
+'use client';
+import { useState, useEffect, useCallback } from 'react';
+/** Event name for context updates */
+export const AI_CONTEXT_UPDATED_EVENT = 'puck:ai-context-updated';
+/**
+ * Dispatches an event to notify that AI context has been updated
+ * Call this after creating, editing, or deleting a context entry
+ */
+export function dispatchContextUpdated() {
+    if (typeof window !== 'undefined') {
+        window.dispatchEvent(new CustomEvent(AI_CONTEXT_UPDATED_EVENT));
+    }
+}
+/**
+ * Hook to fetch and manage AI context entries client-side
+ *
+ * When context is updated via the context editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @example
+ * ```tsx
+ * const { context, loading, create, update, remove } = useAiContext()
+ *
+ * // Create a new context entry
+ * await create({ name: 'Brand Guidelines', content: '...', enabled: true })
+ *
+ * // Update an entry
+ * await update(context[0].id, { content: 'Updated content' })
+ *
+ * // Delete an entry
+ * await remove(context[0].id)
+ * ```
+ */
+export function useAiContext(options = {}) {
+    const { apiEndpoint = '/api/puck/ai-context', enabled = true, includeDisabled = false, } = options;
+    const [context, setContext] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetchContext = useCallback(async () => {
+        if (!enabled) {
+            setLoading(false);
+            return;
+        }
+        try {
+            setLoading(true);
+            setError(null);
+            const url = includeDisabled ? `${apiEndpoint}?all=true` : apiEndpoint;
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error('Failed to fetch context');
+            }
+            const data = await response.json();
+            setContext(data.docs || []);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to load context');
+            setContext([]);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [apiEndpoint, enabled, includeDisabled]);
+    // Create a new context entry
+    const create = useCallback(async (data) => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                throw new Error('Failed to create context entry');
+            }
+            const newEntry = await response.json();
+            dispatchContextUpdated();
+            return newEntry;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to create context entry');
+            return null;
+        }
+    }, [apiEndpoint]);
+    // Update an existing context entry
+    const update = useCallback(async (id, data) => {
+        try {
+            const response = await fetch(`${apiEndpoint}/${id}`, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                throw new Error('Failed to update context entry');
+            }
+            const updatedEntry = await response.json();
+            dispatchContextUpdated();
+            return updatedEntry;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to update context entry');
+            return null;
+        }
+    }, [apiEndpoint]);
+    // Delete a context entry
+    const remove = useCallback(async (id) => {
+        try {
+            const response = await fetch(`${apiEndpoint}/${id}`, {
+                method: 'DELETE',
+            });
+            if (!response.ok) {
+                throw new Error('Failed to delete context entry');
+            }
+            dispatchContextUpdated();
+            return true;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to delete context entry');
+            return false;
+        }
+    }, [apiEndpoint]);
+    // Initial fetch
+    useEffect(() => {
+        fetchContext();
+    }, [fetchContext]);
+    // Listen for context updates
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const handleUpdate = () => {
+            fetchContext();
+        };
+        window.addEventListener(AI_CONTEXT_UPDATED_EVENT, handleUpdate);
+        return () => {
+            window.removeEventListener(AI_CONTEXT_UPDATED_EVENT, handleUpdate);
+        };
+    }, [enabled, fetchContext]);
+    return {
+        context,
+        loading,
+        error,
+        refetch: fetchContext,
+        create,
+        update,
+        remove,
+    };
+}
+//# sourceMappingURL=useAiContext.js.map