@forumone/throughline 1.3.0 → 1.4.0-next-a7a9a8c

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @forumone/throughline
 
+## 1.4.0-next-a7a9a8c
+
+### Minor Changes
+
+- a7a9a8c: Adds `insert_block`, `update_block`, `move_block` and `remove_block` to the content tools. They change one block of a draft's blocks field, either `layout` or a field inside a group such as a case study's `approach.blocks`, without resending the layout. A new or changed block is checked against the blocks the field offers and against its own field validation, which a draft save would otherwise skip. The field is then checked against the composition rules before saving, with the same lock check and audit record as `update_draft`.
+
+  **Upgrading: a migration.** The key collection gains four checkbox columns. Run `migrate:create` and apply it before deploying.
+
+- 7f42a5d: Adds `create_draft` and `update_draft` to the content tools. Both write drafts only and refuse `_status`, publishing dates, the approval policy and any field off the site's allow-list. They refuse a document someone has open in the admin, naming the person (even when it's the key's own person, whose tab would autosave over the change). They also refuse a block the field doesn't offer, a layout that breaks the composition rules, and a slug that's taken, including one held in the trash. Each write is recorded in the audit log with the caller's `_meta`.
+
+  **Upgrading: a migration.** The key collection gains two checkbox columns, one per new tool. Run `migrate:create` and apply it before deploying.
+
+### Patch Changes
+
+- @forumone/throughline-design-system@1.4.0-next-a7a9a8c
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/content/blocks.d.ts

@@ -0,0 +1,230 @@
+import { z } from 'zod';
+import type { Field } from 'payload';
+import type { McpToolDefinition } from '../plugin-contract/index.js';
+import type { McpToolDescriptor } from '../mcp/collector.js';
+import { type ContentWriteDeps } from './write.js';
+export declare const CONTENT_BLOCK_TOOLS: {
+    readonly insertBlock: {
+        readonly name: "insert_block";
+        readonly description: "Adds one block to a blocks field of a draft — `layout`, or a field inside a group such as `approach.blocks` — at the end, at the start, or after a given block. The block is { blockType, ...its fields } as get_contract describes it, and is checked against the blocks the field offers, its own validation and the composition rules before anything is saved. Returns the new block's id.";
+    };
+    readonly updateBlock: {
+        readonly name: "update_block";
+        readonly description: "Changes fields of one block in a draft, by the block's id from get_document. A group inside the block is merged; an array is replaced. The block type cannot change: remove it and insert another.";
+    };
+    readonly moveBlock: {
+        readonly name: "move_block";
+        readonly description: "Moves one block within its blocks field: to the start, to the end, or after another block. Checked against the composition rules, which care about order.";
+    };
+    readonly removeBlock: {
+        readonly name: "remove_block";
+        readonly description: "Removes one block from a draft's blocks field, by its id. Checked against the composition rules, since a block may be another's required sibling.";
+    };
+};
+export declare const CONTENT_BLOCK_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+type BlocksField = Extract<Field, {
+    type: 'blocks';
+}>;
+/**
+ * Every blocks field an author may change, by path: a top-level one by its
+ * name, and one inside an allow-listed group as `group.field`.
+ */
+export declare function blockFieldPaths(fields: readonly Field[]): Map<string, BlocksField>;
+/** Block ids Payload would accept: 24 hex characters, as its own are. */
+export declare function newBlockId(): string;
+declare const insertInput: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    block: z.ZodObject<{
+        blockType: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        blockType: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        blockType: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    field: z.ZodString;
+} & {
+    _meta: z.ZodOptional<z.ZodObject<{
+        userPrompt: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        changesSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    block: {
+        blockType: string;
+    } & {
+        [k: string]: unknown;
+    };
+    id: string | number;
+    field: string;
+    position?: "start" | "end" | undefined;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+    after?: string | undefined;
+}, {
+    collection: string;
+    block: {
+        blockType: string;
+    } & {
+        [k: string]: unknown;
+    };
+    id: string | number;
+    field: string;
+    position?: "start" | "end" | undefined;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+    after?: string | undefined;
+}>;
+declare const updateInput: z.ZodObject<{
+    blockId: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    field: z.ZodString;
+} & {
+    _meta: z.ZodOptional<z.ZodObject<{
+        userPrompt: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        changesSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    id: string | number;
+    patch: Record<string, unknown>;
+    field: string;
+    blockId: string;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}, {
+    collection: string;
+    id: string | number;
+    patch: Record<string, unknown>;
+    field: string;
+    blockId: string;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}>;
+declare const moveInput: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    blockId: z.ZodString;
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    field: z.ZodString;
+} & {
+    _meta: z.ZodOptional<z.ZodObject<{
+        userPrompt: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        changesSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    id: string | number;
+    field: string;
+    blockId: string;
+    position?: "start" | "end" | undefined;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+    after?: string | undefined;
+}, {
+    collection: string;
+    id: string | number;
+    field: string;
+    blockId: string;
+    position?: "start" | "end" | undefined;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+    after?: string | undefined;
+}>;
+declare const removeInput: z.ZodObject<{
+    blockId: z.ZodString;
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    field: z.ZodString;
+} & {
+    _meta: z.ZodOptional<z.ZodObject<{
+        userPrompt: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        changesSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    id: string | number;
+    field: string;
+    blockId: string;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}, {
+    collection: string;
+    id: string | number;
+    field: string;
+    blockId: string;
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}>;
+export declare function createInsertBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof insertInput>;
+export declare function createUpdateBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof updateInput>;
+export declare function createMoveBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof moveInput>;
+export declare function createRemoveBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof removeInput>;
+export declare function createContentBlockTools(deps: ContentWriteDeps): McpToolDefinition[];
+export {};
+//# sourceMappingURL=blocks.d.ts.map

package/dist/content/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/content/blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAyB,KAAK,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAY5D,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAe3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAqBsB,CAAA;AAEtD,eAAO,MAAM,8BAA8B,EAAE,SAAS,iBAAiB,EACnC,CAAA;AAEpC,KAAK,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAWlF;AAqBD,yEAAyE;AACzE,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAyBD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIf,CAAA;AACF,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIb,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAA;AAmHF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAmBnG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CA2BnG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAqB/F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAgBnG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAOnF"}

package/dist/content/blocks.js

@@ -0,0 +1,295 @@
+import { randomBytes } from 'node:crypto';
+import { z } from 'zod';
+import { withMeta } from '../mcp/meta.js';
+import { writableFields } from './describe.js';
+import { compositionErrors, disallowedBlocks, mergePatch } from './guards.js';
+import { blockRegistry, defaultCanUse, refusal, requestAs, unknownCollection, } from './tools.js';
+import { validateBlock } from './validate.js';
+import { openForWrite, saveDraft } from './write.js';
+/*
+One block at a time: insert, change, move or remove a block in a blocks field,
+without resending the whole layout.
+
+A blocks field is named by its path: `layout`, or `approach.blocks` for one
+inside a group, as a case study's buckets are. Each operation reads the current
+draft, makes its one change, and checks the result before saving it: a new
+block against the blocks the field offers, a new or changed block against its
+own validation (which a draft save would skip), and the field as a whole
+against the composition rules. Then it saves the draft as `update_draft` does —
+the same lock check, the same audit.
+*/
+export const CONTENT_BLOCK_TOOLS = {
+    insertBlock: {
+        name: 'insert_block',
+        description: 'Adds one block to a blocks field of a draft — `layout`, or a field inside a group such as `approach.blocks` — at the end, at the start, or after a given block. The block is { blockType, ...its fields } as get_contract describes it, and is checked against the blocks the field offers, its own validation and the composition rules before anything is saved. Returns the new block\'s id.',
+    },
+    updateBlock: {
+        name: 'update_block',
+        description: 'Changes fields of one block in a draft, by the block\'s id from get_document. A group inside the block is merged; an array is replaced. The block type cannot change: remove it and insert another.',
+    },
+    moveBlock: {
+        name: 'move_block',
+        description: 'Moves one block within its blocks field: to the start, to the end, or after another block. Checked against the composition rules, which care about order.',
+    },
+    removeBlock: {
+        name: 'remove_block',
+        description: 'Removes one block from a draft\'s blocks field, by its id. Checked against the composition rules, since a block may be another\'s required sibling.',
+    },
+};
+export const CONTENT_BLOCK_TOOL_DESCRIPTORS = Object.values(CONTENT_BLOCK_TOOLS);
+/**
+ * Every blocks field an author may change, by path: a top-level one by its
+ * name, and one inside an allow-listed group as `group.field`.
+ */
+export function blockFieldPaths(fields) {
+    const out = new Map();
+    for (const field of fields) {
+        if (field.type === 'blocks')
+            out.set(field.name, field);
+        if (field.type === 'group' && 'name' in field && typeof field.name === 'string') {
+            for (const inner of field.fields) {
+                if (inner.type === 'blocks')
+                    out.set(`${field.name}.${inner.name}`, inner);
+            }
+        }
+    }
+    return out;
+}
+function rowsAt(doc, path) {
+    const [head, tail] = path.split('.');
+    const container = tail ? doc[head] : doc;
+    const rows = container?.[tail ?? head];
+    return Array.isArray(rows) ? rows : [];
+}
+/** The top-level change that puts `rows` at `path`, keeping the rest of a group. */
+function dataFor(current, path, rows) {
+    const [head, tail] = path.split('.');
+    if (!tail)
+        return { [head]: rows };
+    const group = current[head] ?? {};
+    return { [head]: { ...group, [tail]: rows } };
+}
+/** Block ids Payload would accept: 24 hex characters, as its own are. */
+export function newBlockId() {
+    return randomBytes(12).toString('hex');
+}
+function blockConfig(field, slug, registry) {
+    return (field.blocks?.find((block) => block.slug === slug) ??
+        field.blockReferences
+            ?.map((ref) => (typeof ref === 'string' ? registry.get(ref) : ref))
+            .find((block) => block?.slug === slug));
+}
+const target = {
+    collection: z.string().describe('The content type\'s slug, e.g. "pages".'),
+    id: z.union([z.string(), z.number()]).describe('The document id.'),
+    field: z.string().describe('The blocks field: "layout", or e.g. "approach.blocks".'),
+};
+const placement = {
+    after: z.string().optional().describe('The id of the block to put it after.'),
+    position: z.enum(['start', 'end']).optional().describe('Where, when not after a block. Default: end.'),
+};
+const insertInput = withMeta({
+    ...target,
+    block: z
+        .object({ blockType: z.string() })
+        .passthrough()
+        .describe('The block: { blockType, ...fields }.'),
+    ...placement,
+});
+const updateInput = withMeta({
+    ...target,
+    blockId: z.string().describe('The block\'s id, from get_document.'),
+    patch: z.record(z.string(), z.unknown()).describe('The block fields to change.'),
+});
+const moveInput = withMeta({
+    ...target,
+    blockId: z.string().describe('The block\'s id, from get_document.'),
+    ...placement,
+});
+const removeInput = withMeta({
+    ...target,
+    blockId: z.string().describe('The block\'s id, from get_document.'),
+});
+/**
+ * What every block tool does around its one change: who may, which field,
+ * read the draft, check the result, save it.
+ */
+async function operate(deps, ctx, input, tool, change) {
+    const refused = refusal(ctx, deps.canUse ?? defaultCanUse);
+    if (refused)
+        return refused;
+    const options = deps.collections[input.collection];
+    const config = deps.payload.collections[input.collection]?.config;
+    if (!options || !config)
+        return unknownCollection(deps, input.collection);
+    const fields = blockFieldPaths(writableFields(config.fields, options.fields));
+    const field = fields.get(input.field);
+    if (!field) {
+        return {
+            error: `"${input.field}" is not a blocks field you can change in ${input.collection}. Blocks fields: ${[...fields.keys()].join(', ') || 'none'}.`,
+        };
+    }
+    const opened = await openForWrite(deps, ctx, input.collection, input.id);
+    if ('error' in opened)
+        return opened;
+    const { current } = opened;
+    const before = rowsAt(current, input.field);
+    const changed = await change(before, field);
+    if ('error' in changed)
+        return changed;
+    const req = await requestAs(deps.payload, ctx);
+    const registry = blockRegistry(deps.payload);
+    if (changed.added) {
+        const disallowed = await disallowedBlocks(field, [changed.added], before, registry, req);
+        if (disallowed.length > 0) {
+            return {
+                error: `${input.field} does not accept ${disallowed.join(', ')}. describe_content_type lists the blocks it does.`,
+                disallowed,
+            };
+        }
+        const config = blockConfig(field, String(changed.added['blockType']), registry);
+        const problems = config
+            ? await validateBlock(config.fields, changed.added, {
+                data: { ...current, ...dataFor(current, input.field, changed.rows) },
+                req,
+                collection: input.collection,
+                id: input.id,
+            })
+            : [];
+        if (problems.length > 0) {
+            return {
+                error: `The ${String(changed.added['blockType'])} block is not valid. Nothing was saved.`,
+                problems,
+            };
+        }
+    }
+    const issues = await compositionErrors(deps.payload, changed.rows);
+    if (issues && issues.length > 0) {
+        return {
+            error: `${input.field} would break ${issues.length} composition rule${issues.length === 1 ? '' : 's'}. Nothing was saved.`,
+            issues,
+        };
+    }
+    const saved = await saveDraft(deps, ctx, {
+        collection: input.collection,
+        id: input.id,
+        data: dataFor(current, input.field, changed.rows),
+        tool,
+        changed: [input.field],
+        meta: input._meta ?? { changesSummary: changed.summary },
+    });
+    return 'error' in saved ? saved : { ...saved, field: input.field, blockId: changed.blockId };
+}
+function indexOf(rows, blockId) {
+    return rows.findIndex((row) => row['id'] === blockId);
+}
+function notFound(field, blockId) {
+    return { error: `There is no block "${blockId}" in ${field}. get_document lists the blocks and their ids.` };
+}
+/** Where a block goes: after another, or at an end. `-1` when `after` names no block. */
+function placeAt(rows, placement) {
+    if (placement.after !== undefined) {
+        const at = indexOf(rows, placement.after);
+        return at === -1 ? -1 : at + 1;
+    }
+    return placement.position === 'start' ? 0 : rows.length;
+}
+/* ------------------------------------------------------------------------ */
+export function createInsertBlockTool(deps) {
+    return {
+        ...CONTENT_BLOCK_TOOLS.insertBlock,
+        inputSchema: insertInput,
+        requiredScope: 'content.write',
+        handler: (input, ctx) => operate(deps, ctx, input, CONTENT_BLOCK_TOOLS.insertBlock.name, async (rows) => {
+            const at = placeAt(rows, input);
+            if (at === -1)
+                return notFound(input.field, input.after);
+            const { id: _ignored, ...fields } = input.block;
+            const added = { ...fields, id: newBlockId() };
+            return {
+                rows: [...rows.slice(0, at), added, ...rows.slice(at)],
+                added,
+                blockId: added.id,
+                summary: `Inserted a ${input.block.blockType} block into ${input.field}.`,
+            };
+        }),
+    };
+}
+export function createUpdateBlockTool(deps) {
+    return {
+        ...CONTENT_BLOCK_TOOLS.updateBlock,
+        inputSchema: updateInput,
+        requiredScope: 'content.write',
+        handler: (input, ctx) => operate(deps, ctx, input, CONTENT_BLOCK_TOOLS.updateBlock.name, async (rows, field) => {
+            const at = indexOf(rows, input.blockId);
+            if (at === -1)
+                return notFound(input.field, input.blockId);
+            const row = rows[at];
+            if ('blockType' in input.patch && input.patch['blockType'] !== row['blockType']) {
+                return { error: 'A block\'s type cannot change. Remove it and insert another.' };
+            }
+            if ('id' in input.patch && input.patch['id'] !== row['id']) {
+                return { error: 'A block\'s id cannot change.' };
+            }
+            const config = blockConfig(field, String(row['blockType']), blockRegistry(deps.payload));
+            const updated = { ...row, ...mergePatch(row, input.patch, config?.fields ?? []) };
+            return {
+                rows: rows.map((r, i) => (i === at ? updated : r)),
+                // Checked whole, like a new one: a change can make it invalid.
+                added: updated,
+                blockId: input.blockId,
+                summary: `Changed ${Object.keys(input.patch).join(', ')} on a ${String(row['blockType'])} block in ${input.field}.`,
+            };
+        }),
+    };
+}
+export function createMoveBlockTool(deps) {
+    return {
+        ...CONTENT_BLOCK_TOOLS.moveBlock,
+        inputSchema: moveInput,
+        requiredScope: 'content.write',
+        handler: (input, ctx) => operate(deps, ctx, input, CONTENT_BLOCK_TOOLS.moveBlock.name, async (rows) => {
+            const from = indexOf(rows, input.blockId);
+            if (from === -1)
+                return notFound(input.field, input.blockId);
+            if (input.after === input.blockId)
+                return { error: 'A block cannot go after itself.' };
+            const moving = rows[from];
+            const rest = rows.filter((_, i) => i !== from);
+            const at = placeAt(rest, input);
+            if (at === -1)
+                return notFound(input.field, input.after);
+            return {
+                rows: [...rest.slice(0, at), moving, ...rest.slice(at)],
+                blockId: input.blockId,
+                summary: `Moved a ${String(moving['blockType'])} block in ${input.field}.`,
+            };
+        }),
+    };
+}
+export function createRemoveBlockTool(deps) {
+    return {
+        ...CONTENT_BLOCK_TOOLS.removeBlock,
+        inputSchema: removeInput,
+        requiredScope: 'content.write',
+        handler: (input, ctx) => operate(deps, ctx, input, CONTENT_BLOCK_TOOLS.removeBlock.name, async (rows) => {
+            const at = indexOf(rows, input.blockId);
+            if (at === -1)
+                return notFound(input.field, input.blockId);
+            return {
+                rows: rows.filter((_, i) => i !== at),
+                blockId: input.blockId,
+                summary: `Removed a ${String(rows[at]['blockType'])} block from ${input.field}.`,
+            };
+        }),
+    };
+}
+export function createContentBlockTools(deps) {
+    return [
+        createInsertBlockTool(deps),
+        createUpdateBlockTool(deps),
+        createMoveBlockTool(deps),
+        createRemoveBlockTool(deps),
+    ];
+}
+//# sourceMappingURL=blocks.js.map

package/dist/content/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../src/content/blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EACL,aAAa,EACb,aAAa,EACb,OAAO,EACP,SAAS,EACT,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAyB,MAAM,YAAY,CAAA;AAE3E;;;;;;;;;;;EAWE;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,iYAAiY;KACpY;IACD,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qMAAqM;KACxM;IACD,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,2JAA2J;KAC9J;IACD,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qJAAqJ;KACxJ;CACmD,CAAA;AAEtD,MAAM,CAAC,MAAM,8BAA8B,GACzC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;AAIpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACvD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,MAAM,CAAC,GAA4B,EAAE,IAAY;IACxD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAA;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,CAAyC,CAAC,CAAC,CAAC,GAAG,CAAA;IACjF,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAkC,CAAC,CAAC,CAAC,EAAE,CAAA;AACvE,CAAC;AAED,oFAAoF;AACpF,SAAS,OAAO,CACd,OAAgC,EAChC,IAAY,EACZ,IAA+B;IAE/B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAA;IACpE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;IAClC,MAAM,KAAK,GAAI,OAAO,CAAC,IAAI,CAAyC,IAAI,EAAE,CAAA;IAC1E,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAA;AAC/C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU;IACxB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,WAAW,CAClB,KAAkB,EAClB,IAAY,EACZ,QAAoC;IAEpC,OAAO,CACL,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAClD,KAAK,CAAC,eAAe;YACnB,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aAClE,IAAI,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC,CACzD,CAAA;AACH,CAAC;AAED,MAAM,MAAM,GAAG;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC1E,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CACrF,CAAA;AACD,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACvG,CAAA;AAED,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC3B,GAAG,MAAM;IACT,KAAK,EAAE,CAAC;SACL,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SACjC,WAAW,EAAE;SACb,QAAQ,CAAC,sCAAsC,CAAC;IACnD,GAAG,SAAS;CACb,CAAC,CAAA;AACF,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC3B,GAAG,MAAM;IACT,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACjF,CAAC,CAAA;AACF,MAAM,SAAS,GAAG,QAAQ,CAAC;IACzB,GAAG,MAAM;IACT,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACnE,GAAG,SAAS;CACb,CAAC,CAAA;AACF,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC3B,GAAG,MAAM;IACT,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACpE,CAAC,CAAA;AASF;;;GAGG;AACH,KAAK,UAAU,OAAO,CACpB,IAAsB,EACtB,GAAmB,EACnB,KAAgB,EAChB,IAAY,EACZ,MAMC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,CAAA;IAC1D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,UAA4B,CAAC,EAAE,MAAM,CAAA;IACnF,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;IAEzE,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,6CAA6C,KAAK,CAAC,UAAU,oBAAoB,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG;SAClJ,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACxE,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IACpC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAE3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3C,IAAI,OAAO,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAEtC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;QACxF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,oBAAoB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mDAAmD;gBACjH,UAAU;aACX,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC/E,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,MAAM,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;gBAChD,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;gBACpE,GAAG;gBACH,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;aACb,CAAC;YACJ,CAAC,CAAC,EAAE,CAAA;QACN,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,KAAK,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,yCAAyC;gBACzF,QAAQ;aACT,CAAA;QACH,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,gBAAgB,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,sBAAsB;YAC1H,MAAM;SACP,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;QACvC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC;QACjD,IAAI;QACJ,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;QACtB,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE;KACzD,CAAC,CAAA;IACF,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAA;AAC9F,CAAC;AAED,SAAS,OAAO,CAAC,IAA+B,EAAE,OAAe;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,OAAe;IAC9C,OAAO,EAAE,KAAK,EAAE,sBAAsB,OAAO,QAAQ,KAAK,gDAAgD,EAAE,CAAA;AAC9G,CAAC;AAED,yFAAyF;AACzF,SAAS,OAAO,CACd,IAA+B,EAC/B,SAAiF;IAEjF,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;QACzC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;AACzD,CAAC;AAED,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO;QACL,GAAG,mBAAmB,CAAC,WAAW;QAClC,WAAW,EAAE,WAAW;QACxB,aAAa,EAAE,eAAe;QAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC7E,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAC/B,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAM,CAAC,CAAA;YACzD,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,KAAgC,CAAA;YAC1E,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,CAAA;YAC7C,OAAO;gBACL,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACtD,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,OAAO,EAAE,cAAc,KAAK,CAAC,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,KAAK,GAAG;aAC1E,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO;QACL,GAAG,mBAAmB,CAAC,WAAW;QAClC,WAAW,EAAE,WAAW;QACxB,aAAa,EAAE,eAAe;QAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YACpF,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAE,CAAA;YACrB,IAAI,WAAW,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChF,OAAO,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAA;YAClF,CAAC;YACD,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAA;YAClD,CAAC;YACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;YACxF,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,CAAA;YACjF,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,+DAA+D;gBAC/D,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,aAAa,KAAK,CAAC,KAAK,GAAG;aACpH,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,OAAO;QACL,GAAG,mBAAmB,CAAC,SAAS;QAChC,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,eAAe;QAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YACzC,IAAI,IAAI,KAAK,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAC5D,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO;gBAAE,OAAO,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAA;YACtF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAE,CAAA;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;YAC9C,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAC/B,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAM,CAAC,CAAA;YACzD,OAAO;gBACL,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvD,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,WAAW,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,KAAK,CAAC,KAAK,GAAG;aAC3E,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO;QACL,GAAG,mBAAmB,CAAC,WAAW;QAClC,WAAW,EAAE,WAAW;QACxB,aAAa,EAAE,eAAe;QAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC7E,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1D,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;gBACrC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,aAAa,MAAM,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,WAAW,CAAC,CAAC,eAAe,KAAK,CAAC,KAAK,GAAG;aAClF,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAsB;IAC5D,OAAO;QACL,qBAAqB,CAAC,IAAI,CAAC;QAC3B,qBAAqB,CAAC,IAAI,CAAC;QAC3B,mBAAmB,CAAC,IAAI,CAAC;QACzB,qBAAqB,CAAC,IAAI,CAAC;KACM,CAAA;AACrC,CAAC"}

package/dist/content/guards.d.ts

@@ -0,0 +1,45 @@
+import type { Block, Field, Payload, PayloadRequest } from 'payload';
+export interface RefusedField {
+    field: string;
+    reason: string;
+}
+/** Every top-level key in `data` that is not on the allow-list, with why. */
+export declare function refusedFields(data: Record<string, unknown>, allowed: readonly string[]): RefusedField[];
+export declare function mergePatch(current: Record<string, unknown>, patch: Record<string, unknown>, fields: readonly Field[]): Record<string, unknown>;
+export interface LockHolder {
+    /** Who has it open: their name, else their email, else their id. */
+    user: string;
+    /** Whether that is the person the key belongs to. */
+    self: boolean;
+    /** When the lock was last refreshed. */
+    since: string;
+}
+export declare function lockHolder(payload: Payload, collection: string, id: number | string, self: unknown): Promise<LockHolder | undefined>;
+export declare function lockRefusal(collection: string, id: number | string, lock: LockHolder): {
+    error: string;
+    lockedBy: string;
+    since: string;
+};
+/**
+ * The blocks in `rows` that `field` would not let an editor add, asked the way
+ * the picker asks: with the document's current rows as sibling data, so a block
+ * a document already holds stays allowed (it is how `filterOptions` keeps old
+ * documents saveable).
+ */
+export declare function disallowedBlocks(field: Extract<Field, {
+    type: 'blocks';
+}>, rows: readonly unknown[], currentRows: readonly unknown[], registry: ReadonlyMap<string, Block>, req: PayloadRequest): Promise<string[]>;
+export interface CompositionIssue {
+    rule: string;
+    message: string;
+    /** Which row, when the rule is about one. */
+    index?: number;
+}
+/**
+ * The composition errors in a blocks field's rows, from the same validator the
+ * publish pipeline runs (attached by the components plugin). Warnings do not
+ * stop a publish and do not stop a draft. `undefined` when there is no
+ * validator, which is a site without the components plugin.
+ */
+export declare function compositionErrors(payload: Payload, rows: readonly unknown[]): Promise<CompositionIssue[] | undefined>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/content/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/content/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAkB,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AA8BpF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,YAAY,EAAE,CAUhB;AAQD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAoBD,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAWD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAqCjC;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,UAAU;;;;EAQpF;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EACzC,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EACpC,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAQD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,OAAO,EAAE,GACvB,OAAO,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAmBzC"}