@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/api/createPuckApiRoutes.js

@@ -0,0 +1,193 @@
+import { NextResponse } from 'next/server';
+import { getPayload } from 'payload';
+/**
+ * Default Puck data for new pages
+ */
+const DEFAULT_PUCK_DATA = {
+    root: {
+        props: {
+            title: '',
+        },
+    },
+    content: [],
+    zones: {},
+};
+/**
+ * Create API route handlers for /api/puck/pages
+ *
+ * Provides GET (list pages) and POST (create page) handlers
+ * with configurable authentication and authorization.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/puck/pages/route.ts
+ * import { createPuckApiRoutes } from '@delmaredigital/payload-puck/api'
+ * import config from '@payload-config'
+ *
+ * export const { GET, POST } = createPuckApiRoutes({
+ *   collection: 'pages',
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await getSession(request)
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *     canCreate: async (user) => {
+ *       return { allowed: user.role === 'admin' || user.role === 'editor' }
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export function createPuckApiRoutes(routeConfig) {
+    const { collection = 'pages', payloadConfig, auth, defaultPuckData = DEFAULT_PUCK_DATA, enableDrafts = true, onError, } = routeConfig;
+    /**
+     * GET /api/puck/pages
+     * List all pages with optional filtering
+     *
+     * Query Parameters:
+     * - page: Page number (default: 1)
+     * - limit: Items per page (default: 10)
+     * - search: Search in title field
+     * - status: Filter by _status ('draft', 'published', 'all')
+     * - editorVersion: Filter by editorVersion field
+     * - sort: Sort field (default: '-updatedAt')
+     */
+    async function GET(request, _context) {
+        try {
+            // Authenticate
+            const authResult = await auth.authenticate(request);
+            if (!authResult.authenticated || !authResult.user) {
+                return NextResponse.json({ error: authResult.error || 'Unauthorized' }, { status: 401 });
+            }
+            // Check list permission
+            if (auth.canList) {
+                const permission = await auth.canList(authResult.user);
+                if (!permission.allowed) {
+                    return NextResponse.json({ error: permission.error || 'Forbidden' }, { status: 403 });
+                }
+            }
+            // Parse query parameters
+            const { searchParams } = new URL(request.url);
+            const page = parseInt(searchParams.get('page') || '1', 10);
+            const limit = Math.min(parseInt(searchParams.get('limit') || '10', 10), 100);
+            const search = searchParams.get('search') || '';
+            const status = searchParams.get('status');
+            const editorVersion = searchParams.get('editorVersion');
+            const sort = searchParams.get('sort') || '-updatedAt';
+            // Get Payload instance with provided config
+            const config = await payloadConfig;
+            const payload = await getPayload({ config });
+            // Build where clause
+            const conditions = [];
+            if (search) {
+                conditions.push({ title: { contains: search } });
+            }
+            if (status && status !== 'all') {
+                conditions.push({ _status: { equals: status } });
+            }
+            if (editorVersion && editorVersion !== 'all') {
+                conditions.push({ editorVersion: { equals: editorVersion } });
+            }
+            const where = conditions.length > 0
+                ? conditions.length === 1
+                    ? conditions[0]
+                    : { and: conditions }
+                : undefined;
+            const result = await payload.find({
+                collection,
+                page,
+                limit,
+                sort,
+                where,
+            });
+            return NextResponse.json(result);
+        }
+        catch (error) {
+            if (onError) {
+                onError(error, { operation: 'list', request });
+            }
+            console.error('Error listing pages:', error);
+            return NextResponse.json({ error: 'Failed to list pages' }, { status: 500 });
+        }
+    }
+    /**
+     * POST /api/puck/pages
+     * Create a new page with Puck data
+     *
+     * Request Body:
+     * - title: string (required)
+     * - slug: string (required)
+     * - puckData?: PuckData (optional, uses default if not provided)
+     * - status?: 'draft' | 'published' (default: 'draft')
+     */
+    async function POST(request, _context) {
+        try {
+            // Authenticate
+            const authResult = await auth.authenticate(request);
+            if (!authResult.authenticated || !authResult.user) {
+                return NextResponse.json({ error: authResult.error || 'Unauthorized' }, { status: 401 });
+            }
+            // Check create permission
+            if (auth.canCreate) {
+                const permission = await auth.canCreate(authResult.user);
+                if (!permission.allowed) {
+                    return NextResponse.json({ error: permission.error || 'Forbidden' }, { status: 403 });
+                }
+            }
+            // Parse request body
+            const body = (await request.json());
+            const { title, slug, puckData, status = 'draft' } = body;
+            // Validate required fields
+            if (!title || !slug) {
+                return NextResponse.json({ error: 'Title and slug are required' }, { status: 400 });
+            }
+            // Get Payload instance with provided config
+            const config = await payloadConfig;
+            const payload = await getPayload({ config });
+            // Check if slug already exists
+            const existing = await payload.find({
+                collection,
+                where: { slug: { equals: slug } },
+                limit: 1,
+            });
+            if (existing.docs.length > 0) {
+                return NextResponse.json({ error: 'A page with this slug already exists' }, { status: 409 });
+            }
+            // Prepare initial Puck data with title in root.props
+            const initialPuckData = puckData || {
+                ...defaultPuckData,
+                root: {
+                    ...defaultPuckData.root,
+                    props: {
+                        ...defaultPuckData.root?.props,
+                        title,
+                    },
+                },
+            };
+            // Create the page
+            const newPage = await payload.create({
+                collection,
+                draft: enableDrafts,
+                data: {
+                    title,
+                    slug,
+                    editorVersion: 'puck',
+                    puckData: initialPuckData,
+                    _status: status,
+                },
+            });
+            return NextResponse.json({ doc: newPage }, { status: 201 });
+        }
+        catch (error) {
+            if (onError) {
+                onError(error, { operation: 'create', request });
+            }
+            console.error('Error creating page:', error);
+            return NextResponse.json({ error: 'Failed to create page' }, { status: 500 });
+        }
+    }
+    return { GET, POST };
+}
+//# sourceMappingURL=createPuckApiRoutes.js.map

package/dist/api/createPuckApiRoutes.js.map

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

package/dist/api/createPuckApiRoutesVersions.d.ts

@@ -0,0 +1,28 @@
+import type { PuckApiRoutesConfig, PuckApiVersionsRouteHandlers } from './types';
+/**
+ * Create API route handlers for /api/puck/pages/[id]/versions
+ *
+ * Provides GET (list versions) and POST (restore version) handlers
+ * for managing page version history.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/puck/pages/[id]/versions/route.ts
+ * import { createPuckApiRoutesVersions } from '@delmaredigital/payload-puck/api'
+ * import config from '@payload-config'
+ *
+ * export const { GET, POST } = createPuckApiRoutesVersions({
+ *   collection: 'pages',
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await getSession(request)
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export declare function createPuckApiRoutesVersions(routeConfig: PuckApiRoutesConfig): PuckApiVersionsRouteHandlers;
+//# sourceMappingURL=createPuckApiRoutesVersions.d.ts.map

package/dist/api/createPuckApiRoutesVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPuckApiRoutesVersions.d.ts","sourceRoot":"","sources":["../../src/api/createPuckApiRoutesVersions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,4BAA4B,EAE7B,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,GAC/B,4BAA4B,CAyK9B"}

package/dist/api/createPuckApiRoutesVersions.js

@@ -0,0 +1,144 @@
+import { NextResponse } from 'next/server';
+import { getPayload } from 'payload';
+/**
+ * Create API route handlers for /api/puck/pages/[id]/versions
+ *
+ * Provides GET (list versions) and POST (restore version) handlers
+ * for managing page version history.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/puck/pages/[id]/versions/route.ts
+ * import { createPuckApiRoutesVersions } from '@delmaredigital/payload-puck/api'
+ * import config from '@payload-config'
+ *
+ * export const { GET, POST } = createPuckApiRoutesVersions({
+ *   collection: 'pages',
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await getSession(request)
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export function createPuckApiRoutesVersions(routeConfig) {
+    const { collection = 'pages', payloadConfig, auth, onError, } = routeConfig;
+    /**
+     * GET /api/puck/pages/[id]/versions
+     * Fetch version history for a page
+     */
+    async function GET(request, context) {
+        try {
+            // Get page ID from params
+            const params = await context.params;
+            const id = params.id;
+            if (!id) {
+                return NextResponse.json({ error: 'Page ID is required' }, { status: 400 });
+            }
+            // Authenticate
+            const authResult = await auth.authenticate(request);
+            if (!authResult.authenticated || !authResult.user) {
+                return NextResponse.json({ error: authResult.error || 'Unauthorized' }, { status: 401 });
+            }
+            // Check view permission
+            if (auth.canView) {
+                const permission = await auth.canView(authResult.user, id);
+                if (!permission.allowed) {
+                    return NextResponse.json({ error: permission.error || 'Forbidden' }, { status: 403 });
+                }
+            }
+            // Get Payload instance with provided config
+            const config = await payloadConfig;
+            const payload = await getPayload({ config });
+            // Parse query params for pagination
+            const url = new URL(request.url);
+            const limit = parseInt(url.searchParams.get('limit') || '20', 10);
+            const page = parseInt(url.searchParams.get('page') || '1', 10);
+            // Fetch versions for this page
+            const versions = await payload.findVersions({
+                collection,
+                where: {
+                    parent: { equals: id },
+                },
+                sort: '-updatedAt',
+                limit,
+                page,
+            });
+            return NextResponse.json({
+                docs: versions.docs,
+                totalDocs: versions.totalDocs,
+                totalPages: versions.totalPages,
+                page: versions.page,
+                limit: versions.limit,
+                hasPrevPage: versions.hasPrevPage,
+                hasNextPage: versions.hasNextPage,
+            });
+        }
+        catch (error) {
+            const params = await context.params;
+            if (onError) {
+                onError(error, { operation: 'listVersions', request, pageId: params.id });
+            }
+            console.error('Error fetching versions:', error);
+            return NextResponse.json({ error: 'Failed to fetch versions' }, { status: 500 });
+        }
+    }
+    /**
+     * POST /api/puck/pages/[id]/versions
+     * Restore a specific version
+     *
+     * Request Body:
+     * - versionId: string - The version ID to restore
+     */
+    async function POST(request, context) {
+        try {
+            // Get page ID from params
+            const params = await context.params;
+            const id = params.id;
+            if (!id) {
+                return NextResponse.json({ error: 'Page ID is required' }, { status: 400 });
+            }
+            // Authenticate
+            const authResult = await auth.authenticate(request);
+            if (!authResult.authenticated || !authResult.user) {
+                return NextResponse.json({ error: authResult.error || 'Unauthorized' }, { status: 401 });
+            }
+            // Check edit permission
+            if (auth.canEdit) {
+                const permission = await auth.canEdit(authResult.user, id);
+                if (!permission.allowed) {
+                    return NextResponse.json({ error: permission.error || 'Forbidden' }, { status: 403 });
+                }
+            }
+            // Parse request body
+            const body = await request.json();
+            const { versionId } = body;
+            if (!versionId) {
+                return NextResponse.json({ error: 'Version ID is required' }, { status: 400 });
+            }
+            // Get Payload instance with provided config
+            const config = await payloadConfig;
+            const payload = await getPayload({ config });
+            // Restore the version
+            const restoredDoc = await payload.restoreVersion({
+                collection,
+                id: versionId,
+            });
+            return NextResponse.json({ doc: restoredDoc });
+        }
+        catch (error) {
+            const params = await context.params;
+            if (onError) {
+                onError(error, { operation: 'restoreVersion', request, pageId: params.id });
+            }
+            console.error('Error restoring version:', error);
+            return NextResponse.json({ error: 'Failed to restore version' }, { status: 500 });
+        }
+    }
+    return { GET, POST };
+}
+//# sourceMappingURL=createPuckApiRoutesVersions.js.map

package/dist/api/createPuckApiRoutesVersions.js.map

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

package/dist/api/createPuckApiRoutesWithId.d.ts

@@ -0,0 +1,34 @@
+import type { PuckApiRoutesConfig, PuckApiRouteWithIdHandlers } from './types';
+/**
+ * Create API route handlers for /api/puck/pages/[id]
+ *
+ * Provides GET (fetch page), PATCH (update page), and DELETE (delete page)
+ * handlers with configurable authentication and authorization.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/puck/pages/[id]/route.ts
+ * import { createPuckApiRoutesWithId } from '@delmaredigital/payload-puck/api'
+ * import config from '@payload-config'
+ *
+ * export const { GET, PATCH, DELETE } = createPuckApiRoutesWithId({
+ *   collection: 'pages',
+ *   payloadConfig: config,
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await getSession(request)
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *     canPublish: async (user) => {
+ *       return { allowed: user.role === 'admin' }
+ *     },
+ *   },
+ *   rootPropsMapping: [
+ *     { from: 'customField', to: 'customPayloadField' },
+ *   ],
+ * })
+ * ```
+ */
+export declare function createPuckApiRoutesWithId(routeConfig: PuckApiRoutesConfig): PuckApiRouteWithIdHandlers;
+//# sourceMappingURL=createPuckApiRoutesWithId.d.ts.map

package/dist/api/createPuckApiRoutesWithId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPuckApiRoutesWithId.d.ts","sourceRoot":"","sources":["../../src/api/createPuckApiRoutesWithId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAG3B,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,mBAAmB,GAC/B,0BAA0B,CAyT5B"}