@next-buildr/payload 0.0.0-stage → 2.0.1

package/dist/plugin/endpoints/data-schema.js

@@ -0,0 +1,21 @@
+import { dataSchemaResponseSchema } from '../../contract.js';
+import { schemaFromCollection } from '../../data/index.js';
+import { allowed, collectionOf, schemaEnv } from './context.js';
+import { fail, json } from './respond.js';
+/** `GET /api/buildr/data-schema/:collection`: what the bindings of this collection's documents can reach. */
+export const dataSchemaEndpoint = (env) => ({
+    path: '/buildr/data-schema/:collection',
+    method: 'get',
+    handler: async (req) => {
+        const collection = collectionOf(env, req);
+        if (!collection.ok)
+            return collection.response;
+        if (!(await allowed(env, 'edit', req)))
+            return fail(403, 'You may not edit with the builder.');
+        const { source, options } = schemaEnv(env, req);
+        const schema = schemaFromCollection(source, collection.value, options);
+        if (schema === undefined)
+            return fail(404, `The collection "${collection.value}" has no data.`);
+        return json(dataSchemaResponseSchema.parse(schema));
+    },
+});

package/dist/plugin/endpoints/data.d.ts

@@ -0,0 +1,10 @@
+import type { Endpoint } from 'payload';
+import { type EndpointEnv } from './context.ts';
+/**
+ * `POST /api/buildr/data/query {spec, locale?}`: what a `Query` binding resolves to in the canvas.
+ * Only allowlisted collections, fields and sort keys (`options.queryable`) can be asked for.
+ */
+export declare const dataQueryEndpoint: (env: EndpointEnv) => Endpoint;
+/** `POST /api/buildr/data/media {ids, locale?}`: media assets by id, as `{ [id]: MediaAsset }`. */
+export declare const dataMediaEndpoint: (env: EndpointEnv) => Endpoint;
+//# sourceMappingURL=data.d.ts.map

package/dist/plugin/endpoints/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/plugin/endpoints/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAC;AASxD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AA4BjE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAS,WAAW,KAAG,QAuBnD,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,QAAS,WAAW,KAAG,QAuBnD,CAAC"}

package/dist/plugin/endpoints/data.js

@@ -0,0 +1,96 @@
+import { dataMediaRequestSchema, dataMediaResponseSchema, dataQueryRequestSchema, dataQueryResponseSchema, } from '../../contract.js';
+import { createPayloadDataSource, DataQueryError } from '../../data/index.js';
+import { chooseLocale } from '../locales.js';
+import { allowed, bodyOf } from './context.js';
+import { mutationGuard } from './guards.js';
+import { fail, json, unauthorized } from './respond.js';
+/** The canvas source: reads with the access of the editing user, drafts included. */
+function sourceOf(env, req) {
+    const contextNames = {};
+    for (const [slug, own] of Object.entries(env.options.collections)) {
+        contextNames[slug] = own.context;
+    }
+    return createPayloadDataSource({
+        payload: req.payload,
+        req,
+        queryable: env.options.queryable,
+        mediaCollection: env.options.media?.collection,
+        contextNames,
+    });
+}
+/** The checks both endpoints share; `undefined` when the request may go on. */
+async function guard(env, req) {
+    if (req.user === null || req.user === undefined)
+        return unauthorized();
+    const rejected = mutationGuard(req);
+    if (rejected !== undefined)
+        return rejected;
+    if (!(await allowed(env, 'edit', req)))
+        return fail(403, 'You may not edit with the builder.');
+    return undefined;
+}
+/**
+ * `POST /api/buildr/data/query {spec, locale?}`: what a `Query` binding resolves to in the canvas.
+ * Only allowlisted collections, fields and sort keys (`options.queryable`) can be asked for.
+ */
+export const dataQueryEndpoint = (env) => ({
+    path: '/buildr/data/query',
+    method: 'post',
+    handler: async (req) => {
+        const rejected = await guard(env, req);
+        if (rejected !== undefined)
+            return rejected;
+        const body = await bodyOf(req);
+        if (!body.ok)
+            return body.response;
+        const parsed = dataQueryRequestSchema.safeParse(body.value);
+        if (!parsed.success)
+            return fail(400, 'The request does not match the contract.');
+        const locale = chooseLocale(req, parsed.data.locale);
+        if (!locale.ok)
+            return locale.response;
+        try {
+            const result = await sourceOf(env, req).query(parsed.data.spec, {
+                locale: locale.locale ?? '',
+                mode: 'canvas',
+            });
+            return json(dataQueryResponseSchema.parse(result));
+        }
+        catch (error) {
+            if (error instanceof DataQueryError)
+                return fail(422, error.message);
+            throw error;
+        }
+    },
+});
+/** `POST /api/buildr/data/media {ids, locale?}`: media assets by id, as `{ [id]: MediaAsset }`. */
+export const dataMediaEndpoint = (env) => ({
+    path: '/buildr/data/media',
+    method: 'post',
+    handler: async (req) => {
+        const rejected = await guard(env, req);
+        if (rejected !== undefined)
+            return rejected;
+        const body = await bodyOf(req);
+        if (!body.ok)
+            return body.response;
+        const parsed = dataMediaRequestSchema.safeParse(body.value);
+        if (!parsed.success)
+            return fail(400, 'The request does not match the contract.');
+        const locale = chooseLocale(req, parsed.data.locale);
+        if (!locale.ok)
+            return locale.response;
+        try {
+            const found = await sourceOf(env, req).getMedia(parsed.data.ids, {
+                locale: locale.locale ?? '',
+                mode: 'canvas',
+            });
+            return json(dataMediaResponseSchema.parse(found));
+        }
+        catch (error) {
+            if (error instanceof DataQueryError)
+                return fail(422, error.message);
+            throw error;
+        }
+    },
+});

package/dist/plugin/endpoints/document.d.ts

@@ -0,0 +1,11 @@
+import type { Endpoint, PayloadRequest } from 'payload';
+import { type DocumentTarget, type EndpointEnv } from './context.ts';
+export declare const titleOf: (req: PayloadRequest, target: DocumentTarget, doc: Record<string, unknown>) => string;
+/** `GET /api/buildr/documents/:collection/:id`: the document the editor opens, migrated in memory. */
+export declare const getDocumentEndpoint: (env: EndpointEnv) => Endpoint;
+/**
+ * `GET /api/buildr/documents/:collection/:id/revision`: only the revision and who saved it, so
+ * the editor can poll for a save made elsewhere (PB-143) without loading the document.
+ */
+export declare const revisionEndpoint: (env: EndpointEnv) => Endpoint;
+//# sourceMappingURL=document.d.ts.map

package/dist/plugin/endpoints/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/plugin/endpoints/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAWxD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,WAAW,EAIjB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,OAAO,QACb,cAAc,UACX,cAAc,OACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAK7B,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,mBAAmB,QAAS,WAAW,KAAG,QAgDrD,CAAC;AA0BH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAS,WAAW,KAAG,QAsBlD,CAAC"}

package/dist/plugin/endpoints/document.js

@@ -0,0 +1,119 @@
+import { documentQuerySchema, documentResponseSchema, revisionResponseSchema, } from '../../contract.js';
+import { resolveLayout } from '../../data/index.js';
+import { readLayout } from '../hooks/read-layout.js';
+import { chooseLocale } from '../locales.js';
+import { allowed, latestOf, revisionOf, targetOf, } from './context.js';
+import { fail, invalid, json } from './respond.js';
+export const titleOf = (req, target, doc) => {
+    const field = req.payload.collections[target.collection]?.config.admin?.useAsTitle ?? 'title';
+    const value = doc[field];
+    return typeof value === 'string' && value !== '' ? value : target.id;
+};
+/** `GET /api/buildr/documents/:collection/:id`: the document the editor opens, migrated in memory. */
+export const getDocumentEndpoint = (env) => ({
+    path: '/buildr/documents/:collection/:id',
+    method: 'get',
+    handler: async (req) => {
+        const target = targetOf(env, req);
+        if (!target.ok)
+            return target.response;
+        if (!(await allowed(env, 'edit', req)))
+            return fail(403, 'You may not edit with the builder.');
+        const query = documentQuerySchema.safeParse(Object.fromEntries(req.searchParams ?? []));
+        if (!query.success)
+            return fail(400, 'The query is not valid.');
+        const locale = chooseLocale(req, query.data.locale);
+        if (!locale.ok)
+            return locale.response;
+        const found = await latestOf(req, target.value, { localeArgs: locale.args });
+        if (!found.ok)
+            return found.response;
+        const doc = found.value;
+        const own = env.options.collections[target.value.collection];
+        const resolved = await resolveLayout({
+            payload: req.payload,
+            req,
+            collection: target.value.collection,
+            doc,
+            contextName: own?.context ?? target.value.collection,
+            draft: true,
+        });
+        // A blank canvas for a document nobody gave a layout: the built-in one is only a render fallback.
+        const layout = readLayout(resolved.source === 'builtin' ? undefined : resolved.layout, env.options);
+        if (!layout.ok)
+            return invalid(layout.diagnostics);
+        const path = own?.path;
+        const body = {
+            ref: target.value,
+            title: titleOf(req, target.value, doc),
+            slug: typeof doc['slug'] === 'string' ? doc['slug'] : null,
+            status: doc['_status'] === 'published' ? 'published' : 'draft',
+            updatedAt: String(doc['updatedAt'] ?? ''),
+            revision: revisionOf(doc),
+            document: layout.doc,
+            contextRef: `${target.value.collection}:${target.value.id}`,
+            layoutSource: resolved.source,
+            layoutRef: resolved.layoutRef,
+            previewPath: path === undefined ? null : path(doc),
+            ...(layout.readOnly ? { readOnly: true } : {}),
+        };
+        return json(documentResponseSchema.parse(body));
+    },
+});
+/** The label of the user a write was attributed to; empty when it cannot be told. */
+async function updaterLabel(req, ref) {
+    const at = ref;
+    if (typeof at?.relationTo !== 'string')
+        return undefined;
+    const value = at.value;
+    const id = typeof value === 'object' && value !== null ? value.id : value;
+    if (typeof id !== 'string' && typeof id !== 'number')
+        return undefined;
+    try {
+        // Only the name is read, on the server's authority: an editor may see who saved, not more.
+        const user = (await req.payload.findByID({
+            collection: at.relationTo,
+            id,
+            depth: 0,
+            overrideAccess: true,
+        }));
+        const name = user['name'];
+        const email = user['email'];
+        if (typeof name === 'string' && name !== '')
+            return name;
+        return typeof email === 'string' && email !== '' ? email : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * `GET /api/buildr/documents/:collection/:id/revision`: only the revision and who saved it, so
+ * the editor can poll for a save made elsewhere (PB-143) without loading the document.
+ */
+export const revisionEndpoint = (env) => ({
+    path: '/buildr/documents/:collection/:id/revision',
+    method: 'get',
+    handler: async (req) => {
+        const target = targetOf(env, req);
+        if (!target.ok)
+            return target.response;
+        if (!(await allowed(env, 'edit', req)))
+            return fail(403, 'You may not edit with the builder.');
+        const found = await latestOf(req, target.value, {
+            select: { buildrRevision: true, updatedAt: true, buildrUpdatedBy: true },
+        });
+        if (!found.ok)
+            return found.response;
+        const doc = found.value;
+        const by = env.options.mcp.enabled
+            ? await updaterLabel(req, doc['buildrUpdatedBy'])
+            : undefined;
+        const body = {
+            revision: revisionOf(doc),
+            updatedAt: String(doc['updatedAt'] ?? ''),
+            ...(by === undefined ? {} : { updatedBy: by }),
+        };
+        return json(revisionResponseSchema.parse(body));
+    },
+});

package/dist/plugin/endpoints/documents.d.ts

@@ -0,0 +1,10 @@
+import type { Endpoint } from 'payload';
+import { type EndpointEnv } from './context.ts';
+/** `GET /api/buildr/documents?collection&search&page`: the builder documents the user may read. */
+export declare const listDocumentsEndpoint: (env: EndpointEnv) => Endpoint;
+/**
+ * `POST /api/buildr/documents`: creates a draft in a builder collection (title, optional slug and
+ * template). Collection access decides; the document is never published, whoever asks.
+ */
+export declare const createDocumentEndpoint: (env: EndpointEnv) => Endpoint;
+//# sourceMappingURL=documents.d.ts.map

package/dist/plugin/endpoints/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/plugin/endpoints/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAyB,MAAM,SAAS,CAAC;AAW/D,OAAO,EAGL,KAAK,WAAW,EAMjB,MAAM,cAAc,CAAC;AAqDtB,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,QAAS,WAAW,KAAG,QAwCvD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAS,WAAW,KAAG,QAoDxD,CAAC"}

package/dist/plugin/endpoints/documents.js

@@ -0,0 +1,145 @@
+import { createDocumentRequestSchema, createDocumentResponseSchema, DOCUMENT_LIST_PAGE_SIZE, documentListQuerySchema, documentListResponseSchema, } from '../../contract.js';
+import { resolveLayout } from '../../data/index.js';
+import { isApiKeyRequest } from '../access.js';
+import { allowed, bodyOf, mcpMayUse, revisionOf, updatedBy, writeContext, writeLimit, } from './context.js';
+import { titleOf } from './document.js';
+import { mutationGuard } from './guards.js';
+import { fail, json, unauthorized } from './respond.js';
+const hasField = (req, collection, name) => req.payload.collections[collection]?.config.flattenedFields.some((field) => field.name === name) === true;
+async function summaryOf(env, req, collection, doc) {
+    const own = env.options.collections[collection];
+    const resolved = await resolveLayout({
+        payload: req.payload,
+        req,
+        collection,
+        doc,
+        contextName: own?.context ?? collection,
+        draft: true,
+    });
+    const id = doc['id'];
+    return {
+        ref: { collection, id },
+        title: titleOf(req, { collection, id: String(id) }, doc),
+        slug: typeof doc['slug'] === 'string' ? doc['slug'] : null,
+        status: doc['_status'] === 'published' ? 'published' : 'draft',
+        updatedAt: String(doc['updatedAt'] ?? ''),
+        revision: revisionOf(doc),
+        layoutSource: resolved.source,
+        previewPath: own?.path === undefined ? null : own.path(doc),
+    };
+}
+/** The response to send when the collection is not a builder collection or an agent may not use it. */
+function refuseCollection(env, req, collection) {
+    if (env.options.collections[collection] === undefined) {
+        return fail(404, `The collection "${collection}" was not found.`);
+    }
+    if (isApiKeyRequest(req) && !mcpMayUse(env, collection)) {
+        return fail(403, `Agents may not use the collection "${collection}".`);
+    }
+    return undefined;
+}
+/** `GET /api/buildr/documents?collection&search&page`: the builder documents the user may read. */
+export const listDocumentsEndpoint = (env) => ({
+    path: '/buildr/documents',
+    method: 'get',
+    handler: async (req) => {
+        if (req.user === null || req.user === undefined)
+            return unauthorized();
+        if (!(await allowed(env, 'edit', req)))
+            return fail(403, 'You may not edit with the builder.');
+        const query = documentListQuerySchema.safeParse(Object.fromEntries(req.searchParams ?? []));
+        if (!query.success)
+            return fail(400, 'The query is not valid.');
+        const { collection, search, page } = query.data;
+        const refused = refuseCollection(env, req, collection);
+        if (refused !== undefined)
+            return refused;
+        const titleField = req.payload.collections[collection]?.config.admin?.useAsTitle ?? 'title';
+        const fields = [titleField, ...(hasField(req, collection, 'slug') ? ['slug'] : [])];
+        const where = search === undefined || search === ''
+            ? undefined
+            : { or: fields.map((name) => ({ [name]: { like: search } })) };
+        const result = await req.payload.find({
+            collection,
+            draft: true,
+            depth: 0,
+            page,
+            limit: DOCUMENT_LIST_PAGE_SIZE,
+            sort: '-updatedAt',
+            req,
+            overrideAccess: false,
+            ...(where === undefined ? {} : { where }),
+        });
+        const items = await Promise.all(result.docs.map((doc) => summaryOf(env, req, collection, doc)));
+        return json(documentListResponseSchema.parse({
+            items,
+            page: result.page ?? page,
+            totalPages: result.totalPages,
+        }));
+    },
+});
+/**
+ * `POST /api/buildr/documents`: creates a draft in a builder collection (title, optional slug and
+ * template). Collection access decides; the document is never published, whoever asks.
+ */
+export const createDocumentEndpoint = (env) => ({
+    path: '/buildr/documents',
+    method: 'post',
+    handler: async (req) => {
+        if (req.user === null || req.user === undefined)
+            return unauthorized();
+        const rejected = mutationGuard(req);
+        if (rejected !== undefined)
+            return rejected;
+        if (!(await allowed(env, 'edit', req)))
+            return fail(403, 'You may not edit with the builder.');
+        const limited = await writeLimit(env, req);
+        if (limited !== undefined)
+            return limited;
+        const body = await bodyOf(req);
+        if (!body.ok)
+            return body.response;
+        const parsed = createDocumentRequestSchema.safeParse(body.value);
+        if (!parsed.success)
+            return fail(400, 'The request does not match the contract.');
+        const { collection, title, slug, template } = parsed.data;
+        const refused = refuseCollection(env, req, collection);
+        if (refused !== undefined)
+            return refused;
+        if (template !== undefined && env.options.collections[collection]?.templates !== true) {
+            return fail(400, `The collection "${collection}" does not take templates.`);
+        }
+        if (slug !== undefined && !hasField(req, collection, 'slug')) {
+            return fail(400, `The collection "${collection}" has no slug.`);
+        }
+        const titleField = req.payload.collections[collection]?.config.admin?.useAsTitle ?? 'title';
+        try {
+            const created = await req.payload.create({
+                collection,
+                data: {
+                    [titleField]: title,
+                    ...(slug === undefined ? {} : { slug }),
+                    ...(template === undefined ? {} : { template }),
+                    buildrRevision: 0,
+                    ...updatedBy(env, req),
+                },
+                draft: true,
+                depth: 0,
+                req,
+                overrideAccess: false,
+                context: writeContext(req),
+            });
+            const summary = await summaryOf(env, req, collection, created);
+            return json(createDocumentResponseSchema.parse(summary), 201);
+        }
+        catch (error) {
+            const status = error.status;
+            if (status === 403)
+                return fail(403, 'You may not create documents in this collection.');
+            if (status === 400) {
+                return fail(400, error instanceof Error ? error.message : 'The document is not valid.');
+            }
+            throw error;
+        }
+    },
+});

package/dist/plugin/endpoints/endpoints.test-kit.d.ts

@@ -0,0 +1,42 @@
+import { type BuilderDocument } from '@next-buildr/core';
+import { type CollectionConfig, type Config, type EmailAdapter, type Field, type GlobalConfig, type Payload } from 'payload';
+import type { BuildrPluginOptions } from '../options.ts';
+export declare const meta: import("@next-buildr/core").RegistryMeta;
+/** The widget renamed `label` to `title` in version 2. */
+export declare const migrations: never;
+/** A page with one child (a widget unless `type` says otherwise) carrying `props`. */
+export declare const withChild: (props: Record<string, unknown>, options?: {
+    version?: number;
+    type?: string;
+}) => BuilderDocument;
+export declare const title: (text: string) => {
+    title: import("@next-buildr/core").StaticValue<string>;
+};
+export interface Harness {
+    readonly payload: Payload;
+    readonly token: string;
+    /** A request to `/api{path}` as the logged-in user (or, with `token: null`, anonymously). */
+    readonly call: (method: string, path: string, options?: {
+        body?: unknown;
+        token?: string | null;
+        headers?: Record<string, string>;
+    }) => Promise<{
+        status: number;
+        body: any;
+    }>;
+    /** Creates a user and returns their token. */
+    readonly login: (email: string, role?: string) => Promise<string>;
+    readonly close: () => void;
+}
+/** One live Payload per test file: its schema push shares process-wide state. */
+export declare function boot(key: string, options?: Partial<BuildrPluginOptions>, extra?: {
+    readonly pageFields?: Field[];
+    /** Access control of the pages collection (default: Payload default, authenticated only). */
+    readonly pageAccess?: CollectionConfig['access'];
+    readonly collections?: CollectionConfig[];
+    readonly globals?: GlobalConfig[];
+    readonly email?: EmailAdapter;
+    /** Payload localization; the `title` of the pages is then localized. */
+    readonly localization?: Config['localization'];
+}): Promise<Harness>;
+//# sourceMappingURL=endpoints.test-kit.d.ts.map

package/dist/plugin/endpoints/endpoints.test-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.test-kit.d.ts","sourceRoot":"","sources":["../../../src/plugin/endpoints/endpoints.test-kit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,eAAe,EAKrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,YAAY,EAGjB,KAAK,OAAO,EACb,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AA8BzD,eAAO,MAAM,IAAI,0CAA0D,CAAC;AAC5E,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAgBlB,KAAK,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,SAAS,UACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACrB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3C,eAWF,CAAC;AACF,eAAO,MAAM,KAAK,SAAU,MAAM;IAAQ,KAAK;CAAY,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAClF,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,EAC1C,KAAK,GAAE;IACL,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;CAC3C,GACL,OAAO,CAAC,OAAO,CAAC,CAuElB"}

package/dist/plugin/endpoints/endpoints.test-kit.js

@@ -0,0 +1,141 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createRegistryMeta, p, s, } from '@next-buildr/core';
+import { sqliteAdapter } from '@payloadcms/db-sqlite';
+import { buildConfig, getPayload, handleEndpoints, } from 'payload';
+import { buildrPlugin } from '../index.js';
+const base = {
+    type: 'buildr/widget',
+    version: 2,
+    label: 'Widget',
+    category: 'content',
+    props: { title: p.text({ label: 'Title', default: 'Hello' }) },
+    contentCategories: ['flow'],
+    styles: { groups: [] },
+    runtime: 'shared',
+    slots: {},
+};
+const page = {
+    ...base,
+    type: 'buildr/page',
+    version: 1,
+    label: 'Page',
+    props: {},
+    capabilities: { root: true },
+    slots: { default: {} },
+};
+const image = {
+    ...base,
+    type: 'buildr/image',
+    version: 1,
+    label: 'Image',
+    props: { alt: p.text({ label: 'Alt', default: '' }) },
+};
+export const meta = createRegistryMeta({ components: [page, base, image] });
+/** The widget renamed `label` to `title` in version 2. */
+export const migrations = {
+    'buildr/page': { currentVersion: 1, steps: [] },
+    'buildr/image': { currentVersion: 1, steps: [] },
+    'buildr/widget': {
+        currentVersion: 2,
+        steps: [
+            {
+                from: 1,
+                to: 2,
+                migrate: (props) => {
+                    const { label, ...rest } = props ?? {};
+                    return { ...rest, title: label };
+                },
+            },
+        ],
+    },
+};
+/** A page with one child (a widget unless `type` says otherwise) carrying `props`. */
+export const withChild = (props, options = {}) => {
+    const type = options.type ?? 'buildr/widget';
+    return {
+        schemaVersion: 1,
+        root: 'root',
+        nodes: {
+            root: { id: 'root', type: 'buildr/page', slots: { default: ['child00001'] } },
+            child00001: { id: 'child00001', type, props },
+        },
+        components: { 'buildr/page': 1, [type]: options.version ?? (type === 'buildr/widget' ? 2 : 1) },
+    };
+};
+export const title = (text) => ({ title: s(text) });
+/** One live Payload per test file: its schema push shares process-wide state. */
+export async function boot(key, options = {}, extra = {}) {
+    const dir = mkdtempSync(join(tmpdir(), `buildr-payload-${key}-`));
+    const config = buildConfig({
+        secret: 'test-secret',
+        collections: [
+            {
+                slug: 'pages',
+                admin: { useAsTitle: 'title' },
+                fields: [
+                    { name: 'title', type: 'text', localized: extra.localization !== undefined },
+                    { name: 'slug', type: 'text' },
+                    ...(extra.pageFields ?? []),
+                ],
+                ...(extra.pageAccess === undefined ? {} : { access: extra.pageAccess }),
+                versions: { drafts: { autosave: true }, maxPerDoc: 50 },
+            },
+            ...(extra.collections ?? []),
+        ],
+        ...(extra.globals === undefined ? {} : { globals: extra.globals }),
+        ...(extra.email === undefined ? {} : { email: extra.email }),
+        ...(extra.localization === undefined ? {} : { localization: extra.localization }),
+        db: sqliteAdapter({ client: { url: `file:${join(dir, 'db.sqlite')}` } }),
+        plugins: [
+            buildrPlugin({
+                collections: { pages: { context: 'page', path: (doc) => `/${String(doc['slug'])}` } },
+                registry: { meta, migrations },
+                ...options,
+            }),
+        ],
+        typescript: { autoGenerate: false },
+    });
+    const payload = await getPayload({ config, key });
+    const login = async (email) => {
+        await payload.create({ collection: 'users', data: { email, password: 'secret-password' } });
+        const result = await payload.login({
+            collection: 'users',
+            data: { email, password: 'secret-password' },
+        });
+        return result.token;
+    };
+    const token = await login('editor@example.com');
+    const call = async (method, path, init = {}) => {
+        const authToken = init.token === undefined ? token : init.token;
+        const response = await handleEndpoints({
+            config: payload.config,
+            request: new Request(`http://localhost/api${path}`, {
+                method,
+                headers: {
+                    ...(init.body === undefined ? {} : { 'content-type': 'application/json' }),
+                    ...(authToken === null ? {} : { authorization: `JWT ${authToken}` }),
+                    ...init.headers,
+                },
+                ...(init.body === undefined ? {} : { body: JSON.stringify(init.body) }),
+            }),
+        });
+        const text = await response.text();
+        return { status: response.status, body: text === '' ? undefined : JSON.parse(text) };
+    };
+    return {
+        payload,
+        token,
+        call,
+        login,
+        close: () => {
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                // Windows keeps the database file open a moment longer.
+            }
+        },
+    };
+}

package/dist/plugin/endpoints/endpoints.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endpoints.test.d.ts.map

package/dist/plugin/endpoints/endpoints.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.test.d.ts","sourceRoot":"","sources":["../../../src/plugin/endpoints/endpoints.test.ts"],"names":[],"mappings":""}