@se-studio/contentful-cms 3.13.1 → 3.14.0

package/dist/publish/plan.js

@@ -0,0 +1,361 @@
+import { attributeChange } from './attribution.js';
+import { cascadeNote, classifyContentType, isSharedTemplate } from './classify.js';
+export const PLAN_TTL_MS = 30 * 60 * 1000;
+export const MAX_TARGETS = 50;
+export const MAX_UPSTREAM = 50;
+export function needsPublish(node) {
+    if (node.archived)
+        return false;
+    if (node.publishedVersion == null)
+        return true;
+    return node.version > node.publishedVersion + 1;
+}
+export function isPublishedClean(node) {
+    if (node.archived || node.publishedVersion == null)
+        return false;
+    return node.version === node.publishedVersion + 1;
+}
+export function assertPlannedVersion(current, expected) {
+    if (current !== expected) {
+        throw new Error(`This entry changed after the plan was made (now version ${current}, plan saw ${expected}). Run plan again.`);
+    }
+}
+export function assertStillClean(version, publishedVersion) {
+    if (publishedVersion == null || version !== publishedVersion + 1) {
+        throw new Error('This entry is no longer a clean published version. Run plan again.');
+    }
+}
+function itemFor(node, role, depth, userId, steps, draftParents = []) {
+    const attribution = steps.includes('touch')
+        ? 'clean'
+        : attributeChange({
+            userId,
+            version: node.version,
+            publishedVersion: node.publishedVersion,
+            updatedById: node.updatedById,
+            createdById: node.createdById,
+        });
+    return {
+        entityId: node.id,
+        kind: node.kind,
+        contentType: node.contentType,
+        label: node.label,
+        version: node.version,
+        publishedVersion: node.publishedVersion,
+        attribution,
+        role,
+        depth,
+        steps,
+        slug: node.slug,
+        draftParents,
+    };
+}
+/** Roots and webhook types refresh production. They publish after the drafts they depend on. */
+function publishesLast(item, extraRoots) {
+    if (item.role === 'touch')
+        return true;
+    const contentClass = classifyContentType(item.contentType, extraRoots);
+    return contentClass === 'root' || contentClass === 'webhook';
+}
+function sortItems(items, extraRoots) {
+    return [...items].sort((a, b) => {
+        const aLast = publishesLast(a, extraRoots) ? 1 : 0;
+        const bLast = publishesLast(b, extraRoots) ? 1 : 0;
+        if (aLast !== bLast)
+            return aLast - bLast;
+        if (a.depth !== b.depth)
+            return b.depth - a.depth;
+        if (a.kind !== b.kind)
+            return a.kind === 'asset' ? -1 : 1;
+        return a.label.localeCompare(b.label);
+    });
+}
+export function buildPublishPlan(input) {
+    const extraRoots = input.extraRoots;
+    const nodes = input.nodes;
+    const targetIds = input.targetIds.slice(0, MAX_TARGETS);
+    const targetSet = new Set(targetIds);
+    const depth = new Map();
+    const fromTarget = new Map();
+    const seen = new Set();
+    const blocked = [];
+    const queue = targetIds.map((id) => ({ id, depth: 0, fromTarget: id }));
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current || seen.has(current.id))
+            continue;
+        fromTarget.set(current.id, current.fromTarget);
+        const node = nodes.get(current.id);
+        if (!node) {
+            blocked.push({ id: current.id, reason: 'Entry or asset could not be loaded.' });
+            continue;
+        }
+        if (node.contentType === 'redirect') {
+            blocked.push({
+                id: node.id,
+                contentType: 'redirect',
+                label: node.label,
+                reason: 'Redirects go live on the next deploy, not when an entry is published.',
+            });
+            continue;
+        }
+        seen.add(current.id);
+        depth.set(current.id, current.depth);
+        if (node.kind === 'asset')
+            continue;
+        for (const link of node.links) {
+            if (seen.has(link.id))
+                continue;
+            const child = nodes.get(link.id);
+            if (!child) {
+                blocked.push({ id: link.id, reason: 'Linked entry or asset could not be loaded.' });
+                continue;
+            }
+            if (child.contentType === 'redirect') {
+                blocked.push({
+                    id: child.id,
+                    contentType: 'redirect',
+                    label: child.label,
+                    reason: 'Redirects go live on the next deploy, not when an entry is published.',
+                });
+                continue;
+            }
+            if (child.kind === 'entry' && !targetSet.has(child.id)) {
+                const childClass = classifyContentType(child.contentType, extraRoots);
+                if (childClass === 'root') {
+                    if (child.publishedVersion == null) {
+                        blocked.push({
+                            id: child.id,
+                            contentType: child.contentType,
+                            label: child.label,
+                            reason: `Referenced ${child.contentType ?? 'entry'} is not published. It is not included in this publish.`,
+                        });
+                    }
+                    else if (needsPublish(child)) {
+                        blocked.push({
+                            id: child.id,
+                            contentType: child.contentType,
+                            label: child.label,
+                            reason: `Referenced ${child.contentType ?? 'entry'} has unpublished changes. It is not included in this publish.`,
+                        });
+                    }
+                    continue;
+                }
+                if (isSharedTemplate(child.contentType))
+                    continue;
+            }
+            queue.push({
+                id: link.id,
+                depth: current.depth + 1,
+                fromTarget: current.fromTarget,
+            });
+        }
+    }
+    const items = [];
+    const dirtyIds = new Set();
+    for (const id of seen) {
+        const node = nodes.get(id);
+        if (!node || !needsPublish(node))
+            continue;
+        dirtyIds.add(id);
+        const parents = input.parentsByEntryId?.get(id) ?? [];
+        const draftParents = parents
+            .filter((parent) => parent.draftLinks && parent.publishedLinks === false)
+            .map((parent) => ({
+            id: parent.id,
+            contentType: parent.contentType,
+            label: parent.label,
+        }));
+        items.push(itemFor(node, targetSet.has(id) ? 'target' : 'dependency', depth.get(id) ?? 0, input.userId, ['publish'], draftParents));
+    }
+    for (const id of targetIds) {
+        const node = nodes.get(id);
+        if (!node || dirtyIds.has(id) || node.kind === 'asset')
+            continue;
+        const contentClass = classifyContentType(node.contentType, extraRoots);
+        if (contentClass !== 'root' && contentClass !== 'embedded')
+            continue;
+        const hasDirtyDescendant = items.some((item) => item.entityId !== id && fromTarget.get(item.entityId) === id);
+        if (!hasDirtyDescendant || !isPublishedClean(node))
+            continue;
+        items.push(itemFor(node, 'touch', 0, input.userId, ['touch']));
+    }
+    const upstream = [];
+    for (const rootId of (input.upstreamRootIds ?? []).slice(0, MAX_UPSTREAM)) {
+        const root = nodes.get(rootId);
+        if (!root)
+            continue;
+        upstream.push({ id: root.id, contentType: root.contentType, label: root.label });
+        if (targetSet.has(root.id) || items.some((item) => item.entityId === root.id))
+            continue;
+        if (needsPublish(root)) {
+            items.push(itemFor(root, 'target', -1, input.userId, ['publish']));
+        }
+        else if (isPublishedClean(root)) {
+            items.push(itemFor(root, 'touch', -1, input.userId, ['touch']));
+        }
+    }
+    const notes = [];
+    const notedTypes = new Set();
+    for (const id of targetIds) {
+        const node = nodes.get(id);
+        const note = cascadeNote(node?.contentType);
+        if (note && node?.contentType && !notedTypes.has(node.contentType)) {
+            const contentClass = classifyContentType(node.contentType, extraRoots);
+            if (contentClass === 'webhook') {
+                notedTypes.add(node.contentType);
+                notes.push(note);
+            }
+        }
+    }
+    for (const parent of upstream) {
+        if (classifyContentType(parent.contentType, extraRoots) !== 'webhook')
+            continue;
+        const note = cascadeNote(parent.contentType);
+        if (note && parent.contentType && !notedTypes.has(parent.contentType)) {
+            notedTypes.add(parent.contentType);
+            notes.push(note);
+        }
+    }
+    for (const item of items) {
+        for (const parent of item.draftParents) {
+            notes.push(`${item.label} is linked from unpublished ${parent.contentType} "${parent.label}". Publishing the ${item.contentType ?? 'entry'} does not add it to the live page.`);
+        }
+    }
+    if ((input.upstreamRootIds?.length ?? 0) > MAX_UPSTREAM) {
+        notes.push(`Upstream pages are capped at ${MAX_UPSTREAM}.`);
+    }
+    if (input.upstreamTruncated) {
+        notes.push('Parent lookup stopped early. Some pages that use this content may be missing.');
+    }
+    if (input.truncated || input.targetIds.length > MAX_TARGETS) {
+        notes.push(`Only the first ${MAX_TARGETS} targets are in this plan.`);
+    }
+    const conflicts = items.filter((item) => item.attribution === 'theirs' || item.attribution === 'mixed');
+    if (conflicts.length > 0) {
+        notes.push('Someone else also changed part of this publish. Choose all (publish those entries too) or mine (skip them). One entry cannot be split by field.');
+    }
+    const createdAt = input.now.toISOString();
+    return {
+        id: input.id,
+        userId: input.userId,
+        spaceId: input.spaceId,
+        action: 'publish',
+        createdAt,
+        expiresAt: new Date(input.now.getTime() + PLAN_TTL_MS).toISOString(),
+        scope: conflicts.length > 0 ? null : 'all',
+        awaitingChoice: conflicts.length > 0,
+        items: sortItems(items, extraRoots),
+        blocked,
+        upstream,
+        notes,
+        truncated: input.truncated === true ||
+            input.upstreamTruncated === true ||
+            input.targetIds.length > MAX_TARGETS,
+    };
+}
+export function buildEntryActionPlan(input) {
+    const items = input.nodes.map((node) => {
+        const published = node.publishedVersion != null && !node.archived;
+        const steps = input.action === 'archive'
+            ? published
+                ? ['unpublish', 'archive']
+                : ['archive']
+            : ['unpublish'];
+        return {
+            entityId: node.id,
+            kind: node.kind,
+            contentType: node.contentType,
+            label: node.label,
+            version: node.version,
+            publishedVersion: node.publishedVersion,
+            attribution: 'mine',
+            role: 'target',
+            depth: 0,
+            steps,
+            slug: node.slug,
+            draftParents: [],
+        };
+    });
+    const notes = [];
+    if (input.upstream.length > 0) {
+        notes.push('These entries are still linked from other content. Unpublishing them removes them from the live site everywhere they are used. Child entries are not unpublished.');
+    }
+    if (input.action === 'archive') {
+        notes.push('A published entry is unpublished first, then archived.');
+    }
+    return {
+        id: input.id,
+        userId: input.userId,
+        spaceId: input.spaceId,
+        action: input.action,
+        createdAt: input.now.toISOString(),
+        expiresAt: new Date(input.now.getTime() + PLAN_TTL_MS).toISOString(),
+        scope: 'all',
+        awaitingChoice: false,
+        items,
+        blocked: [],
+        upstream: input.upstream,
+        notes,
+        truncated: false,
+    };
+}
+export function buildRevalidatePlan(input) {
+    return {
+        id: input.id,
+        userId: input.userId,
+        spaceId: input.spaceId,
+        action: 'revalidate',
+        createdAt: input.now.toISOString(),
+        expiresAt: new Date(input.now.getTime() + PLAN_TTL_MS).toISOString(),
+        scope: 'all',
+        awaitingChoice: false,
+        items: input.nodes.map((node) => ({
+            entityId: node.id,
+            kind: 'entry',
+            contentType: node.contentType,
+            label: node.label,
+            version: node.version,
+            publishedVersion: node.publishedVersion,
+            attribution: 'clean',
+            role: 'target',
+            depth: 0,
+            steps: ['revalidate'],
+            slug: node.slug,
+            draftParents: [],
+        })),
+        blocked: [],
+        upstream: [],
+        notes: [
+            'This refreshes production cache for these pages. It does not publish Contentful drafts.',
+        ],
+        truncated: false,
+    };
+}
+export function choosePlanScope(plan, scope) {
+    if (!plan.awaitingChoice) {
+        throw new Error('This plan has no conflict to choose.');
+    }
+    return { ...plan, scope, awaitingChoice: false };
+}
+export function itemsForScope(plan) {
+    if (plan.scope === 'mine') {
+        return plan.items.filter((item) => item.attribution === 'mine' || item.attribution === 'clean');
+    }
+    return plan.items;
+}
+export function assertPlanApplicable(plan, userId, now) {
+    if (plan.userId !== userId) {
+        throw new Error('This plan belongs to a different Contentful user.');
+    }
+    if (Date.parse(plan.expiresAt) <= now.getTime()) {
+        throw new Error('This plan has expired. Run plan again.');
+    }
+    if (plan.awaitingChoice || plan.scope == null) {
+        throw new Error('Someone else changed entries in this plan. Choose all or mine, then apply only after the user says yes.');
+    }
+    if (plan.appliedAt) {
+        throw new Error('This plan was already applied.');
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/publish/plan.js.map

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

package/dist/publish/revalidate-request.d.ts

@@ -0,0 +1,29 @@
+export interface RevalidateEntryPayload {
+    sys: {
+        type: 'Entry';
+        id: string;
+        contentType: {
+            sys: {
+                type: 'Link';
+                linkType: 'ContentType';
+                id: string;
+            };
+        };
+    };
+    fields: Record<string, Record<string, string>>;
+}
+export interface RevalidateRequest {
+    url: string;
+    headers: Record<string, string>;
+    body: RevalidateEntryPayload;
+}
+export declare function buildRevalidateRequest(input: {
+    productionSiteUrl: string;
+    secret: string;
+    bypassToken?: string;
+    entryId: string;
+    contentType: string;
+    slug?: string;
+    locale: string;
+}): RevalidateRequest;
+//# sourceMappingURL=revalidate-request.d.ts.map

package/dist/publish/revalidate-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-request.d.ts","sourceRoot":"","sources":["../../src/publish/revalidate-request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE;QACH,IAAI,EAAE,OAAO,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE;YAAE,GAAG,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,aAAa,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC;KAC7E,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,CAuBpB"}

package/dist/publish/revalidate-request.js

@@ -0,0 +1,26 @@
+export function buildRevalidateRequest(input) {
+    const base = input.productionSiteUrl.replace(/\/$/, '');
+    const headers = {
+        'content-type': 'application/json',
+        REVALIDATION_SECRET: input.secret,
+    };
+    if (input.bypassToken) {
+        headers['x-vercel-protection-bypass'] = input.bypassToken;
+    }
+    const fields = {};
+    if (input.slug)
+        fields['slug'] = { [input.locale]: input.slug };
+    return {
+        url: `${base}/api/revalidate`,
+        headers,
+        body: {
+            sys: {
+                type: 'Entry',
+                id: input.entryId,
+                contentType: { sys: { type: 'Link', linkType: 'ContentType', id: input.contentType } },
+            },
+            fields,
+        },
+    };
+}
+//# sourceMappingURL=revalidate-request.js.map

package/dist/publish/revalidate-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-request.js","sourceRoot":"","sources":["../../src/publish/revalidate-request.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,sBAAsB,CAAC,KAQtC;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,mBAAmB,EAAE,KAAK,CAAC,MAAM;KAClC,CAAC;IACF,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,OAAO,CAAC,4BAA4B,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAChE,OAAO;QACL,GAAG,EAAE,GAAG,IAAI,iBAAiB;QAC7B,OAAO;QACP,IAAI,EAAE;YACJ,GAAG,EAAE;gBACH,IAAI,EAAE,OAAO;gBACb,EAAE,EAAE,KAAK,CAAC,OAAO;gBACjB,WAAW,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE;aACvF;YACD,MAAM;SACP;KACF,CAAC;AACJ,CAAC"}

package/dist/publish/store.d.ts

@@ -0,0 +1,13 @@
+import type { RedisClient } from '../session/session-store.js';
+import { type ReleasePlan } from './plan.js';
+export interface PlanStore {
+    save(plan: ReleasePlan): Promise<void>;
+    load(userId: string, planId: string): Promise<ReleasePlan | null>;
+    /** Stamp appliedAt only if this caller wins. False means another apply already claimed it. */
+    claim(plan: ReleasePlan): Promise<boolean>;
+}
+export declare function memoryPlanStore(): PlanStore;
+export declare function filePlanStore(root?: string): PlanStore;
+export declare function redisPlanStore(redis: RedisClient): PlanStore;
+export declare function getPlanStore(): PlanStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/publish/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/publish/store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAClE,8FAA8F;IAC9F,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAQD,wBAAgB,eAAe,IAAI,SAAS,CAgB3C;AAED,wBAAgB,aAAa,CAAC,IAAI,SAAuB,GAAG,SAAS,CA+BpE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CA8B5D;AAED,wBAAgB,YAAY,IAAI,SAAS,CAOxC"}

package/dist/publish/store.js

@@ -0,0 +1,102 @@
+import { mkdir, open, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getCmsEditDataRoot } from '../config/data-root.js';
+import { getRuntimeContext } from '../runtime/context.js';
+import { PLAN_TTL_MS } from './plan.js';
+const memoryPlans = new Map();
+function memoryKey(userId, planId) {
+    return `${userId}:${planId}`;
+}
+export function memoryPlanStore() {
+    return {
+        async save(plan) {
+            memoryPlans.set(memoryKey(plan.userId, plan.id), plan);
+        },
+        async load(userId, planId) {
+            return memoryPlans.get(memoryKey(userId, planId)) ?? null;
+        },
+        async claim(plan) {
+            const key = memoryKey(plan.userId, plan.id);
+            const existing = memoryPlans.get(key);
+            if (!existing || existing.appliedAt)
+                return false;
+            memoryPlans.set(key, plan);
+            return true;
+        },
+    };
+}
+export function filePlanStore(root = getCmsEditDataRoot()) {
+    const dir = path.join(root, '.cms-edit', 'plans');
+    return {
+        async save(plan) {
+            await mkdir(dir, { recursive: true });
+            const file = path.join(dir, `${plan.userId}-${plan.id}.json`);
+            await writeFile(file, JSON.stringify(plan));
+        },
+        async load(userId, planId) {
+            try {
+                const raw = await readFile(path.join(dir, `${userId}-${planId}.json`), 'utf8');
+                return JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+        },
+        async claim(plan) {
+            await mkdir(dir, { recursive: true });
+            const lock = path.join(dir, `${plan.userId}-${plan.id}.applied`);
+            try {
+                const handle = await open(lock, 'wx');
+                await handle.writeFile(plan.appliedAt ?? 'applied');
+                await handle.close();
+            }
+            catch (err) {
+                if (err.code === 'EEXIST')
+                    return false;
+                throw err;
+            }
+            await writeFile(path.join(dir, `${plan.userId}-${plan.id}.json`), JSON.stringify(plan));
+            return true;
+        },
+    };
+}
+export function redisPlanStore(redis) {
+    const keyFor = (userId, planId) => `cms-edit:plan:${userId}:${planId}`;
+    return {
+        async save(plan) {
+            await redis.set(keyFor(plan.userId, plan.id), JSON.stringify(plan), {
+                ex: Math.ceil(PLAN_TTL_MS / 1000),
+            });
+        },
+        async load(userId, planId) {
+            const raw = await redis.get(keyFor(userId, planId));
+            if (raw == null)
+                return null;
+            if (typeof raw === 'string')
+                return JSON.parse(raw);
+            return raw;
+        },
+        async claim(plan) {
+            const won = await redis.set(`${keyFor(plan.userId, plan.id)}:applied`, plan.appliedAt ?? 'applied', {
+                nx: true,
+                ex: Math.ceil(PLAN_TTL_MS / 1000),
+            });
+            if (won !== true)
+                return false;
+            await redis.set(keyFor(plan.userId, plan.id), JSON.stringify(plan), {
+                ex: Math.ceil(PLAN_TTL_MS / 1000),
+            });
+            return true;
+        },
+    };
+}
+export function getPlanStore() {
+    const fromContext = getRuntimeContext()?.planStore;
+    if (fromContext)
+        return fromContext;
+    if (process.env['VERCEL'] === '1') {
+        throw new Error('Publish plans need Redis on the hosted cms-edit deployment.');
+    }
+    return filePlanStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/publish/store.js.map

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

package/dist/runtime/context.d.ts

@@ -2,6 +2,7 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 import type { CmsEditConfig } from '../config/types.js';
 import type { IndexCacheStore } from '../index/cache-store.js';
 import type { MediaPipelineJobStore } from '../media-pipeline/job-store.js';
+import type { PlanStore } from '../publish/store.js';
 import type { SessionStore } from '../session/session-store.js';
 import type { StagedUploadStore } from '../staged-upload/store.js';
 export interface ContentfulUserIdentity {
@@ -17,6 +18,10 @@ export interface CmsEditRuntimeContext {
     indexCacheStore?: IndexCacheStore;
     /** Contentful user for session key isolation in hosted mode. */
     user?: ContentfulUserIdentity;
+    /** Publish / unpublish / archive / revalidate plans. Redis on hosted. */
+    planStore?: PlanStore;
+    /** Site roots beyond the default routable types (project.json publish.extraRootContentTypes). */
+    extraRootContentTypes?: string[];
     /** Staged file uploads for hosted asset upload (Redis). */
     stagedUploadStore?: StagedUploadStore;
     /** Media pipeline job ownership + rate limits (Redis on hosted). */

package/dist/runtime/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,cAAc,0CAAiD,CAAC;AAE7E,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iGAAiG;IACjG,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,cAAc,0CAAiD,CAAC;AAE7E,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB"}

package/dist/runtime/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA+BrD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAE7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA8B,EAC9B,EAAwB;IAExB,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAoCrD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAE7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA8B,EAC9B,EAAwB;IAExB,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/docs/FUNCTIONAL_SPEC.md

@@ -149,6 +149,7 @@ Each resolved entry is assigned a stable `@ref` label (`@c0` = the root, `@c1`,
 | `create taxonomy-from-json --file <path>` | Batch-create tagType, articleType, and tag entries from JSON |
 | `create tag-type --slug <slug> --name "X"` | Create a tagType entry (draft) |
 | `create article-type --slug <slug> --name "X"` | Create an articleType entry (draft) |
+| `create person-type --slug <slug> --name "X" [--person-template-id <id>] [--indexed true\|false] [--hidden true\|false]` | Create a personType entry (draft). Indexed defaults on, Hidden off. |
 | `create tag --slug <slug> --name "X" --tag-type <slug>` | Create a tag entry (draft); `--tag-type-slug`, `--tag-type-name`; `--description`, `--featured-image`; cmsLabel auto `"<tagType> — <name>"` |
 | `create tag-type\|tag\|article-type … --if-not-exists` | Idempotent taxonomy create (returns existing entry when slug matches) |
 | `add <entry-type> --content-type <ct>` | Create a new child entry of a given content type, link it into the current open entry's content array, and assign it a @ref |
@@ -246,21 +247,23 @@ If a version conflict cannot be resolved cleanly, an error is returned and the e
 
 ## 10. Permission Constraints
 
-The tool enforces a hard boundary between editing and publishing:
+`save` still writes drafts only. Publish, unpublish, and archive are separate commands.
 
-**Permitted:**
+**Permitted when the signed-in Contentful role allows it:**
 - Read entries and assets
 - Create draft entries
 - Update draft and published entries (saving as new draft versions)
 - Delete draft-only entries (never-published)
+- `publish plan` then `publish apply --plan <id>` after the user says yes
+- `unpublish` and `archive` with the same plan-then-yes flow
+- `revalidate plan` then `revalidate apply` to refresh production cache without publishing
 
-**Not permitted (not exposed by the tool):**
-- Publish entries
-- Unpublish entries
-- Archive entries
+**Not permitted:**
 - Delete published entries
+- Scheduled publish
+- Applying a plan without an explicit yes, or when the Contentful role does not allow that action
 
-This boundary is enforced at two levels: the tool exposes no publish/unpublish/archive/delete commands, and the expected Contentful management token role should not have those permissions either.
+The Contentful role is checked before a plan is saved. If the role policies cannot be read, the command stops. AI Editor (no publish) cannot publish. A role that can publish, unpublish, or archive can do those actions through cms-edit.
 
 ---