@valkyrianlabs/payload-markdown-docs 0.1.0-canary.0

package/dist/next/sidebar.js

@@ -0,0 +1,137 @@
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_MARKDOWN_FIELD_NAME } from '../constants.js';
+import { joinRouteSegments } from '../routing/index.js';
+import { isVisibleDocsRecord, toResolvedDocsRecord } from './records.js';
+const titleCaseSegment = (segment)=>segment.split(/[-_]+/).filter(Boolean).map((part)=>`${part.charAt(0).toUpperCase()}${part.slice(1)}`).join(' ');
+const getSidebarLabel = (record)=>record.overrides?.navTitle ?? record.navTitle ?? record.title ?? record.sourcePath;
+const getSourcePathSegments = (sourcePath)=>{
+    const withoutExtension = sourcePath.replace(/\.md$/i, '');
+    const segments = withoutExtension.split('/').filter(Boolean);
+    if (segments.at(-1) === 'index') {
+        return segments.slice(0, -1);
+    }
+    return segments;
+};
+const compareSidebarItems = (first, second)=>{
+    if (first.order !== second.order) {
+        return first.order - second.order;
+    }
+    return first.sourcePath.localeCompare(second.sourcePath);
+};
+const sortSidebarTree = (items)=>{
+    items.sort(compareSidebarItems);
+    for (const item of items){
+        if (item.children) {
+            sortSidebarTree(item.children);
+        }
+    }
+};
+const getOrCreateFolderNode = ({ currentItems, depth, docsSet, order, segment, sourcePath })=>{
+    const existing = currentItems.find((item)=>item.sourcePath === sourcePath);
+    if (existing) {
+        existing.order = Math.min(existing.order, order);
+        return existing;
+    }
+    const node = {
+        children: [],
+        depth,
+        label: titleCaseSegment(segment),
+        order,
+        route: docsSet ? joinRouteSegments(docsSet.routeBase, sourcePath) : `/${sourcePath}`,
+        sourcePath
+    };
+    currentItems.push(node);
+    return node;
+};
+const mergeLeafIntoTree = ({ docsSet, record, rootItems })=>{
+    const segments = getSourcePathSegments(record.sourcePath);
+    if (segments.length === 0) {
+        rootItems.push({
+            depth: 0,
+            label: getSidebarLabel(record),
+            order: record.order,
+            route: record.route,
+            sourcePath: record.sourcePath
+        });
+        return;
+    }
+    let currentItems = rootItems;
+    for (const [index, segment] of segments.entries()){
+        const sourcePath = segments.slice(0, index + 1).join('/');
+        const isLeaf = index === segments.length - 1;
+        if (isLeaf) {
+            const existing = currentItems.find((item)=>item.sourcePath === sourcePath);
+            if (existing) {
+                existing.label = getSidebarLabel(record);
+                existing.order = record.order;
+                existing.route = record.route;
+                existing.sourcePath = record.sourcePath;
+                existing.children ??= [];
+                return;
+            }
+            currentItems.push({
+                depth: index,
+                label: getSidebarLabel(record),
+                order: record.order,
+                route: record.route,
+                sourcePath: record.sourcePath
+            });
+            return;
+        }
+        const folder = getOrCreateFolderNode({
+            currentItems,
+            depth: index,
+            docsSet,
+            order: record.order,
+            segment,
+            sourcePath
+        });
+        folder.children ??= [];
+        currentItems = folder.children;
+    }
+};
+export const buildPayloadMarkdownDocsSidebar = (records, options = {})=>{
+    const sidebar = [];
+    const visibleRecords = records.filter((record)=>isVisibleDocsRecord({
+            includeDrafts: options.includeDrafts,
+            record
+        })).filter((record)=>record.overrides?.hideFromNav !== true).sort((first, second)=>{
+        if (first.order !== second.order) {
+            return first.order - second.order;
+        }
+        return first.sourcePath.localeCompare(second.sourcePath);
+    });
+    for (const record of visibleRecords){
+        mergeLeafIntoTree({
+            docsSet: options.docsSet,
+            record,
+            rootItems: sidebar
+        });
+    }
+    sortSidebarTree(sidebar);
+    return sidebar;
+};
+export const getPayloadMarkdownDocsSidebar = async ({ collections, docsSet, includeDrafts = false, markdownField = DEFAULT_MARKDOWN_FIELD_NAME, // Sidebar data reads plugin-owned generated docs server-side.
+// Access is overridden here, then nav visibility is enforced explicitly.
+overrideAccess = true, payload })=>{
+    const result = await payload.find({
+        collection: collections?.docs ?? DEFAULT_DOCS_COLLECTION_SLUG,
+        depth: 0,
+        limit: 1000,
+        overrideAccess,
+        where: {
+            docsSet: {
+                equals: docsSet.id
+            }
+        }
+    });
+    const records = result.docs.map((doc)=>toResolvedDocsRecord({
+            doc,
+            markdownField
+        })).filter((record)=>record !== undefined);
+    return buildPayloadMarkdownDocsSidebar(records, {
+        docsSet,
+        includeDrafts
+    });
+};
+
+//# sourceMappingURL=sidebar.js.map

package/dist/next/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/sidebar.ts"],"sourcesContent":["import type {\n  PayloadMarkdownDocsCollectionSlugs,\n  PayloadMarkdownDocsReadPayload,\n  PayloadMarkdownDocsSidebarItem,\n  ResolvedPayloadMarkdownDocsRecord,\n  ResolvedPayloadMarkdownDocsSet,\n} from './types.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_MARKDOWN_FIELD_NAME,\n} from '../constants.js'\nimport { joinRouteSegments } from '../routing/index.js'\nimport {\n  isVisibleDocsRecord,\n  toResolvedDocsRecord,\n} from './records.js'\n\nexport type BuildPayloadMarkdownDocsSidebarOptions = {\n  docsSet?: ResolvedPayloadMarkdownDocsSet\n  includeDrafts?: boolean\n}\n\nexport type GetPayloadMarkdownDocsSidebarOptions = {\n  collections?: PayloadMarkdownDocsCollectionSlugs\n  docsSet: ResolvedPayloadMarkdownDocsSet\n  includeDrafts?: boolean\n  markdownField?: string\n  overrideAccess?: boolean\n  payload: PayloadMarkdownDocsReadPayload\n}\n\nconst titleCaseSegment = (segment: string): string =>\n  segment\n    .split(/[-_]+/)\n    .filter(Boolean)\n    .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)\n    .join(' ')\n\nconst getSidebarLabel = (record: ResolvedPayloadMarkdownDocsRecord): string =>\n  record.overrides?.navTitle ?? record.navTitle ?? record.title ?? record.sourcePath\n\nconst getSourcePathSegments = (sourcePath: string): string[] => {\n  const withoutExtension = sourcePath.replace(/\\.md$/i, '')\n  const segments = withoutExtension.split('/').filter(Boolean)\n\n  if (segments.at(-1) === 'index') {\n    return segments.slice(0, -1)\n  }\n\n  return segments\n}\n\nconst compareSidebarItems = (\n  first: PayloadMarkdownDocsSidebarItem,\n  second: PayloadMarkdownDocsSidebarItem,\n): number => {\n  if (first.order !== second.order) {\n    return first.order - second.order\n  }\n\n  return first.sourcePath.localeCompare(second.sourcePath)\n}\n\nconst sortSidebarTree = (items: PayloadMarkdownDocsSidebarItem[]) => {\n  items.sort(compareSidebarItems)\n\n  for (const item of items) {\n    if (item.children) {\n      sortSidebarTree(item.children)\n    }\n  }\n}\n\nconst getOrCreateFolderNode = ({\n  currentItems,\n  depth,\n  docsSet,\n  order,\n  segment,\n  sourcePath,\n}: {\n  currentItems: PayloadMarkdownDocsSidebarItem[]\n  depth: number\n  docsSet?: ResolvedPayloadMarkdownDocsSet\n  order: number\n  segment: string\n  sourcePath: string\n}): PayloadMarkdownDocsSidebarItem => {\n  const existing = currentItems.find((item) => item.sourcePath === sourcePath)\n\n  if (existing) {\n    existing.order = Math.min(existing.order, order)\n    return existing\n  }\n\n  const node: PayloadMarkdownDocsSidebarItem = {\n    children: [],\n    depth,\n    label: titleCaseSegment(segment),\n    order,\n    route: docsSet ? joinRouteSegments(docsSet.routeBase, sourcePath) : `/${sourcePath}`,\n    sourcePath,\n  }\n\n  currentItems.push(node)\n\n  return node\n}\n\nconst mergeLeafIntoTree = ({\n  docsSet,\n  record,\n  rootItems,\n}: {\n  docsSet?: ResolvedPayloadMarkdownDocsSet\n  record: ResolvedPayloadMarkdownDocsRecord\n  rootItems: PayloadMarkdownDocsSidebarItem[]\n}) => {\n  const segments = getSourcePathSegments(record.sourcePath)\n\n  if (segments.length === 0) {\n    rootItems.push({\n      depth: 0,\n      label: getSidebarLabel(record),\n      order: record.order,\n      route: record.route,\n      sourcePath: record.sourcePath,\n    })\n    return\n  }\n\n  let currentItems = rootItems\n\n  for (const [index, segment] of segments.entries()) {\n    const sourcePath = segments.slice(0, index + 1).join('/')\n    const isLeaf = index === segments.length - 1\n\n    if (isLeaf) {\n      const existing = currentItems.find((item) => item.sourcePath === sourcePath)\n\n      if (existing) {\n        existing.label = getSidebarLabel(record)\n        existing.order = record.order\n        existing.route = record.route\n        existing.sourcePath = record.sourcePath\n        existing.children ??= []\n        return\n      }\n\n      currentItems.push({\n        depth: index,\n        label: getSidebarLabel(record),\n        order: record.order,\n        route: record.route,\n        sourcePath: record.sourcePath,\n      })\n      return\n    }\n\n    const folder = getOrCreateFolderNode({\n      currentItems,\n      depth: index,\n      docsSet,\n      order: record.order,\n      segment,\n      sourcePath,\n    })\n\n    folder.children ??= []\n    currentItems = folder.children\n  }\n}\n\nexport const buildPayloadMarkdownDocsSidebar = (\n  records: ResolvedPayloadMarkdownDocsRecord[],\n  options: BuildPayloadMarkdownDocsSidebarOptions = {},\n): PayloadMarkdownDocsSidebarItem[] => {\n  const sidebar: PayloadMarkdownDocsSidebarItem[] = []\n  const visibleRecords = records\n    .filter((record) =>\n      isVisibleDocsRecord({\n        includeDrafts: options.includeDrafts,\n        record,\n      }),\n    )\n    .filter((record) => record.overrides?.hideFromNav !== true)\n    .sort((first, second) => {\n      if (first.order !== second.order) {\n        return first.order - second.order\n      }\n\n      return first.sourcePath.localeCompare(second.sourcePath)\n    })\n\n  for (const record of visibleRecords) {\n    mergeLeafIntoTree({\n      docsSet: options.docsSet,\n      record,\n      rootItems: sidebar,\n    })\n  }\n\n  sortSidebarTree(sidebar)\n\n  return sidebar\n}\n\nexport const getPayloadMarkdownDocsSidebar = async ({\n  collections,\n  docsSet,\n  includeDrafts = false,\n  markdownField = DEFAULT_MARKDOWN_FIELD_NAME,\n  // Sidebar data reads plugin-owned generated docs server-side.\n  // Access is overridden here, then nav visibility is enforced explicitly.\n  overrideAccess = true,\n  payload,\n}: GetPayloadMarkdownDocsSidebarOptions): Promise<PayloadMarkdownDocsSidebarItem[]> => {\n  const result = await payload.find({\n    collection: collections?.docs ?? DEFAULT_DOCS_COLLECTION_SLUG,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n    where: {\n      docsSet: {\n        equals: docsSet.id,\n      },\n    },\n  })\n\n  const records = result.docs\n    .map((doc) =>\n      toResolvedDocsRecord({\n        doc,\n        markdownField,\n      }),\n    )\n    .filter(\n      (record): record is ResolvedPayloadMarkdownDocsRecord => record !== undefined,\n    )\n\n  return buildPayloadMarkdownDocsSidebar(records, {\n    docsSet,\n    includeDrafts,\n  })\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_MARKDOWN_FIELD_NAME","joinRouteSegments","isVisibleDocsRecord","toResolvedDocsRecord","titleCaseSegment","segment","split","filter","Boolean","map","part","charAt","toUpperCase","slice","join","getSidebarLabel","record","overrides","navTitle","title","sourcePath","getSourcePathSegments","withoutExtension","replace","segments","at","compareSidebarItems","first","second","order","localeCompare","sortSidebarTree","items","sort","item","children","getOrCreateFolderNode","currentItems","depth","docsSet","existing","find","Math","min","node","label","route","routeBase","push","mergeLeafIntoTree","rootItems","length","index","entries","isLeaf","folder","buildPayloadMarkdownDocsSidebar","records","options","sidebar","visibleRecords","includeDrafts","hideFromNav","getPayloadMarkdownDocsSidebar","collections","markdownField","overrideAccess","payload","result","collection","docs","limit","where","equals","id","doc","undefined"],"mappings":"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"}

package/dist/next/types.d.ts

@@ -0,0 +1,117 @@
+import type { DocsAiExportManifest } from '../sync/index.js';
+export type PayloadMarkdownDocsFindArgs = {
+    collection: string;
+    depth?: number;
+    limit?: number;
+    overrideAccess?: boolean;
+    sort?: string;
+    where?: unknown;
+};
+export type PayloadMarkdownDocsReadPayload = {
+    find: (args: PayloadMarkdownDocsFindArgs) => Promise<{
+        docs: unknown[];
+    }>;
+};
+export type PayloadMarkdownDocsCollectionSlugs = {
+    docs?: string;
+    docsGroups?: string;
+    docsSets?: string;
+};
+export type ResolvePayloadMarkdownDocsRouteOptions = {
+    collections?: PayloadMarkdownDocsCollectionSlugs;
+    includeDrafts?: boolean;
+    markdownField?: string;
+    overrideAccess?: boolean;
+    path?: string;
+    payload: PayloadMarkdownDocsReadPayload;
+    slug?: string | string[];
+};
+export type PayloadMarkdownDocsDefaults = {
+    heroDescription?: string;
+    heroEyebrow?: string;
+    heroTitle?: string;
+    seoDescription?: string;
+    seoTitle?: string;
+    sidebarMode?: 'auto' | 'hidden' | 'manual';
+    theme?: string;
+};
+export type PayloadMarkdownDocsOverrides = {
+    heroDescription?: string;
+    heroEyebrow?: string;
+    heroTitle?: string;
+    hideFromNav?: boolean;
+    navTitle?: string;
+    seoDescription?: string;
+    seoTitle?: string;
+    theme?: string;
+};
+export type ResolvedPayloadMarkdownDocsSet = {
+    aiExport?: DocsAiExportManifest;
+    defaults?: PayloadMarkdownDocsDefaults;
+    description?: string;
+    id: string;
+    navTitle?: string;
+    order: number;
+    routeBase: string;
+    slug?: string;
+    sourceId?: string;
+    sourceRoot?: string;
+    title: string;
+};
+export type ResolvedPayloadMarkdownDocsGroup = {
+    description?: string;
+    id: string;
+    navTitle?: string;
+    order: number;
+    routePath: string;
+    serveIndex: boolean;
+    slug?: string;
+    title: string;
+};
+export type ResolvedPayloadMarkdownDocsRecord = {
+    archived: boolean;
+    content?: string;
+    depth: number;
+    description?: string;
+    docsSetId?: string;
+    id: string;
+    navTitle?: string;
+    order: number;
+    overrides?: PayloadMarkdownDocsOverrides;
+    route: string;
+    sourceHash?: string;
+    sourcePath: string;
+    status?: 'draft' | 'published';
+    title: string;
+};
+export type PayloadMarkdownDocsSidebarItem = {
+    children?: PayloadMarkdownDocsSidebarItem[];
+    depth: number;
+    hidden?: boolean;
+    label: string;
+    order: number;
+    route: string;
+    sourcePath: string;
+};
+export type ResolvedPayloadMarkdownDocsRoute = {
+    doc: ResolvedPayloadMarkdownDocsRecord;
+    docsSet: ResolvedPayloadMarkdownDocsSet;
+    route: string;
+    sidebar: PayloadMarkdownDocsSidebarItem[];
+    type: 'doc';
+} | {
+    doc?: ResolvedPayloadMarkdownDocsRecord;
+    docsSet: ResolvedPayloadMarkdownDocsSet;
+    route: string;
+    sidebar: PayloadMarkdownDocsSidebarItem[];
+    type: 'docsSetIndex';
+} | {
+    docsSets: ResolvedPayloadMarkdownDocsSet[];
+    group: ResolvedPayloadMarkdownDocsGroup;
+    route: string;
+    type: 'docsGroupIndex';
+};
+export type PayloadMarkdownDocsMetadata = {
+    description?: string;
+    title?: string;
+};

package/dist/next/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/next/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/types.ts"],"sourcesContent":["import type { DocsAiExportManifest } from '../sync/index.js'\n\nexport type PayloadMarkdownDocsFindArgs = {\n  collection: string\n  depth?: number\n  limit?: number\n  overrideAccess?: boolean\n  sort?: string\n  where?: unknown\n}\n\nexport type PayloadMarkdownDocsReadPayload = {\n  find: (args: PayloadMarkdownDocsFindArgs) => Promise<{\n    docs: unknown[]\n  }>\n}\n\nexport type PayloadMarkdownDocsCollectionSlugs = {\n  docs?: string\n  docsGroups?: string\n  docsSets?: string\n}\n\nexport type ResolvePayloadMarkdownDocsRouteOptions = {\n  collections?: PayloadMarkdownDocsCollectionSlugs\n  includeDrafts?: boolean\n  markdownField?: string\n  overrideAccess?: boolean\n  path?: string\n  payload: PayloadMarkdownDocsReadPayload\n  slug?: string | string[]\n}\n\nexport type PayloadMarkdownDocsDefaults = {\n  heroDescription?: string\n  heroEyebrow?: string\n  heroTitle?: string\n  seoDescription?: string\n  seoTitle?: string\n  sidebarMode?: 'auto' | 'hidden' | 'manual'\n  theme?: string\n}\n\nexport type PayloadMarkdownDocsOverrides = {\n  heroDescription?: string\n  heroEyebrow?: string\n  heroTitle?: string\n  hideFromNav?: boolean\n  navTitle?: string\n  seoDescription?: string\n  seoTitle?: string\n  theme?: string\n}\n\nexport type ResolvedPayloadMarkdownDocsSet = {\n  aiExport?: DocsAiExportManifest\n  defaults?: PayloadMarkdownDocsDefaults\n  description?: string\n  id: string\n  navTitle?: string\n  order: number\n  routeBase: string\n  slug?: string\n  sourceId?: string\n  sourceRoot?: string\n  title: string\n}\n\nexport type ResolvedPayloadMarkdownDocsGroup = {\n  description?: string\n  id: string\n  navTitle?: string\n  order: number\n  routePath: string\n  serveIndex: boolean\n  slug?: string\n  title: string\n}\n\nexport type ResolvedPayloadMarkdownDocsRecord = {\n  archived: boolean\n  content?: string\n  depth: number\n  description?: string\n  docsSetId?: string\n  id: string\n  navTitle?: string\n  order: number\n  overrides?: PayloadMarkdownDocsOverrides\n  route: string\n  sourceHash?: string\n  sourcePath: string\n  status?: 'draft' | 'published'\n  title: string\n}\n\nexport type PayloadMarkdownDocsSidebarItem = {\n  children?: PayloadMarkdownDocsSidebarItem[]\n  depth: number\n  hidden?: boolean\n  label: string\n  order: number\n  route: string\n  sourcePath: string\n}\n\nexport type ResolvedPayloadMarkdownDocsRoute =\n  | {\n      doc: ResolvedPayloadMarkdownDocsRecord\n      docsSet: ResolvedPayloadMarkdownDocsSet\n      route: string\n      sidebar: PayloadMarkdownDocsSidebarItem[]\n      type: 'doc'\n    }\n  | {\n      doc?: ResolvedPayloadMarkdownDocsRecord\n      docsSet: ResolvedPayloadMarkdownDocsSet\n      route: string\n      sidebar: PayloadMarkdownDocsSidebarItem[]\n      type: 'docsSetIndex'\n    }\n  | {\n      docsSets: ResolvedPayloadMarkdownDocsSet[]\n      group: ResolvedPayloadMarkdownDocsGroup\n      route: string\n      type: 'docsGroupIndex'\n    }\n\nexport type PayloadMarkdownDocsMetadata = {\n  description?: string\n  title?: string\n}\n"],"names":[],"mappings":"AAgIA,WAGC"}

package/dist/payload/applyDocsSync.d.ts

@@ -0,0 +1,54 @@
+import type { DocsDeleteBehavior, DocsSyncPlan, ValidatedDocsManifest } from '../sync/index.js';
+import type { DocsSyncConflict } from './docsConflicts.js';
+import type { DocsPublishMode } from './docsData.js';
+import type { ExistingPayloadDocsRecord } from './existingDocs.js';
+export type ApplyDocsSyncPayloadOperations = {
+    create: (args: {
+        collection: string;
+        data: Record<string, unknown>;
+        overrideAccess?: boolean;
+    }) => Promise<Record<string, unknown>>;
+    delete?: (args: {
+        collection: string;
+        id: string;
+        overrideAccess?: boolean;
+    }) => Promise<Record<string, unknown>>;
+    update: (args: {
+        collection: string;
+        data: Record<string, unknown>;
+        id: string;
+        overrideAccess?: boolean;
+    }) => Promise<Record<string, unknown>>;
+};
+export type ApplyDocsSyncResult = {
+    conflicts: DocsSyncConflict[];
+    ok: false;
+} | {
+    ok: true;
+    writes: {
+        archive: number;
+        create: number;
+        delete: number;
+        draft: number;
+        reactivate: number;
+        update: number;
+    };
+};
+export declare const assertApplyDeleteBehaviorSupported: (deleteBehavior: DocsDeleteBehavior, { allowHardDelete, docsEnableDrafts, }?: {
+    allowHardDelete?: boolean;
+    docsEnableDrafts?: boolean;
+}) => boolean;
+export declare const applyDocsSync: ({ collectionSlug, deleteBehavior, docsEnableDrafts, docsSetId, existing, manifest, markdownFieldName, now, payload, plan, publishMode, syncRunId, }: {
+    collectionSlug: string;
+    deleteBehavior: DocsDeleteBehavior;
+    docsEnableDrafts: boolean;
+    docsSetId?: number | string;
+    existing: ExistingPayloadDocsRecord[];
+    manifest: ValidatedDocsManifest;
+    markdownFieldName: string;
+    now: Date;
+    payload: ApplyDocsSyncPayloadOperations;
+    plan: DocsSyncPlan;
+    publishMode: DocsPublishMode;
+    syncRunId?: number | string;
+}) => Promise<ApplyDocsSyncResult>;

package/dist/payload/applyDocsSync.js

@@ -0,0 +1,176 @@
+import { findDocsSyncConflicts } from './docsConflicts.js';
+import { buildArchiveData, buildDocsData } from './docsData.js';
+export const assertApplyDeleteBehaviorSupported = (deleteBehavior, { allowHardDelete = false, docsEnableDrafts = false } = {})=>{
+    if (deleteBehavior === 'archive' || deleteBehavior === 'ignore') {
+        return true;
+    }
+    if (deleteBehavior === 'draft') {
+        return docsEnableDrafts;
+    }
+    return allowHardDelete;
+};
+export const applyDocsSync = async ({ collectionSlug, deleteBehavior, docsEnableDrafts, docsSetId, existing, manifest, markdownFieldName, now, payload, plan, publishMode, syncRunId })=>{
+    const existingBySourcePath = new Map(existing.map((record)=>[
+            record.sourcePath,
+            record
+        ]));
+    const reactivations = plan.unchanged.filter((change)=>change.current?.archived);
+    const conflicts = findDocsSyncConflicts({
+        existingBySourcePath,
+        plannedChanges: [
+            ...plan.update,
+            ...plan.archive,
+            ...plan.draft,
+            ...plan.delete,
+            ...reactivations
+        ]
+    });
+    if (conflicts.length > 0) {
+        return {
+            conflicts,
+            ok: false
+        };
+    }
+    const writes = {
+        archive: 0,
+        create: 0,
+        delete: 0,
+        draft: 0,
+        reactivate: 0,
+        update: 0
+    };
+    for (const change of plan.create){
+        if (!change.desired) {
+            continue;
+        }
+        await payload.create({
+            collection: collectionSlug,
+            data: buildDocsData({
+                desired: change.desired,
+                docsEnableDrafts,
+                docsSetId,
+                manifest,
+                markdownFieldName,
+                now,
+                publishMode,
+                syncRunId
+            }),
+            overrideAccess: true
+        });
+        writes.create += 1;
+    }
+    for (const change of plan.update){
+        if (!change.desired) {
+            continue;
+        }
+        const current = existingBySourcePath.get(change.sourcePath);
+        if (!current) {
+            continue;
+        }
+        await payload.update({
+            id: current.id,
+            collection: collectionSlug,
+            data: buildDocsData({
+                current,
+                desired: change.desired,
+                docsEnableDrafts,
+                docsSetId,
+                manifest,
+                markdownFieldName,
+                now,
+                publishMode,
+                syncRunId
+            }),
+            overrideAccess: true
+        });
+        writes.update += 1;
+    }
+    for (const change of reactivations){
+        if (!change.desired) {
+            continue;
+        }
+        const current = existingBySourcePath.get(change.sourcePath);
+        if (!current) {
+            continue;
+        }
+        await payload.update({
+            id: current.id,
+            collection: collectionSlug,
+            data: buildDocsData({
+                current,
+                desired: change.desired,
+                docsEnableDrafts,
+                docsSetId,
+                manifest,
+                markdownFieldName,
+                now,
+                publishMode,
+                syncRunId
+            }),
+            overrideAccess: true
+        });
+        writes.reactivate += 1;
+    }
+    if (deleteBehavior === 'archive') {
+        for (const change of plan.archive){
+            const current = existingBySourcePath.get(change.sourcePath);
+            if (!current) {
+                continue;
+            }
+            await payload.update({
+                id: current.id,
+                collection: collectionSlug,
+                data: buildArchiveData({
+                    docsEnableDrafts,
+                    now,
+                    syncRunId
+                }),
+                overrideAccess: true
+            });
+            writes.archive += 1;
+        }
+    }
+    if (deleteBehavior === 'draft') {
+        for (const change of plan.draft){
+            const current = existingBySourcePath.get(change.sourcePath);
+            if (!current) {
+                continue;
+            }
+            await payload.update({
+                id: current.id,
+                collection: collectionSlug,
+                data: buildArchiveData({
+                    docsEnableDrafts,
+                    draftMissing: true,
+                    now,
+                    syncRunId
+                }),
+                overrideAccess: true
+            });
+            writes.draft += 1;
+        }
+    }
+    if (deleteBehavior === 'delete') {
+        if (!payload.delete) {
+            throw new Error('Payload delete operation is required for hard delete.');
+        }
+        for (const change of plan.delete){
+            const current = existingBySourcePath.get(change.sourcePath);
+            if (!current) {
+                continue;
+            }
+            await payload.delete({
+                id: current.id,
+                collection: collectionSlug,
+                overrideAccess: true
+            });
+            writes.delete += 1;
+        }
+    }
+    return {
+        ok: true,
+        writes
+    };
+};
+
+//# sourceMappingURL=applyDocsSync.js.map

package/dist/payload/applyDocsSync.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/payload/applyDocsSync.ts"],"sourcesContent":["import type {\n  DocsDeleteBehavior,\n  DocsSyncPlan,\n  ValidatedDocsManifest,\n} from '../sync/index.js'\nimport type { DocsSyncConflict } from './docsConflicts.js'\nimport type { DocsPublishMode } from './docsData.js'\nimport type { ExistingPayloadDocsRecord } from './existingDocs.js'\n\nimport { findDocsSyncConflicts } from './docsConflicts.js'\nimport { buildArchiveData, buildDocsData } from './docsData.js'\n\nexport type ApplyDocsSyncPayloadOperations = {\n  create: (args: {\n    collection: string\n    data: Record<string, unknown>\n    overrideAccess?: boolean\n  }) => Promise<Record<string, unknown>>\n  delete?: (args: {\n    collection: string\n    id: string\n    overrideAccess?: boolean\n  }) => Promise<Record<string, unknown>>\n  update: (args: {\n    collection: string\n    data: Record<string, unknown>\n    id: string\n    overrideAccess?: boolean\n  }) => Promise<Record<string, unknown>>\n}\n\nexport type ApplyDocsSyncResult =\n  | {\n      conflicts: DocsSyncConflict[]\n      ok: false\n    }\n  | {\n      ok: true\n      writes: {\n        archive: number\n        create: number\n        delete: number\n        draft: number\n        reactivate: number\n        update: number\n      }\n    }\n\nexport const assertApplyDeleteBehaviorSupported = (\n  deleteBehavior: DocsDeleteBehavior,\n  {\n    allowHardDelete = false,\n    docsEnableDrafts = false,\n  }: {\n    allowHardDelete?: boolean\n    docsEnableDrafts?: boolean\n  } = {},\n): boolean => {\n  if (deleteBehavior === 'archive' || deleteBehavior === 'ignore') {\n    return true\n  }\n\n  if (deleteBehavior === 'draft') {\n    return docsEnableDrafts\n  }\n\n  return allowHardDelete\n}\n\nexport const applyDocsSync = async ({\n  collectionSlug,\n  deleteBehavior,\n  docsEnableDrafts,\n  docsSetId,\n  existing,\n  manifest,\n  markdownFieldName,\n  now,\n  payload,\n  plan,\n  publishMode,\n  syncRunId,\n}: {\n  collectionSlug: string\n  deleteBehavior: DocsDeleteBehavior\n  docsEnableDrafts: boolean\n  docsSetId?: number | string\n  existing: ExistingPayloadDocsRecord[]\n  manifest: ValidatedDocsManifest\n  markdownFieldName: string\n  now: Date\n  payload: ApplyDocsSyncPayloadOperations\n  plan: DocsSyncPlan\n  publishMode: DocsPublishMode\n  syncRunId?: number | string\n}): Promise<ApplyDocsSyncResult> => {\n  const existingBySourcePath = new Map(\n    existing.map((record) => [record.sourcePath, record]),\n  )\n  const reactivations = plan.unchanged.filter((change) => change.current?.archived)\n  const conflicts = findDocsSyncConflicts({\n    existingBySourcePath,\n    plannedChanges: [\n      ...plan.update,\n      ...plan.archive,\n      ...plan.draft,\n      ...plan.delete,\n      ...reactivations,\n    ],\n  })\n\n  if (conflicts.length > 0) {\n    return {\n      conflicts,\n      ok: false,\n    }\n  }\n\n  const writes = {\n    archive: 0,\n    create: 0,\n    delete: 0,\n    draft: 0,\n    reactivate: 0,\n    update: 0,\n  }\n\n  for (const change of plan.create) {\n    if (!change.desired) {\n      continue\n    }\n\n    await payload.create({\n      collection: collectionSlug,\n      data: buildDocsData({\n        desired: change.desired,\n        docsEnableDrafts,\n        docsSetId,\n        manifest,\n        markdownFieldName,\n        now,\n        publishMode,\n        syncRunId,\n      }),\n      overrideAccess: true,\n    })\n    writes.create += 1\n  }\n\n  for (const change of plan.update) {\n    if (!change.desired) {\n      continue\n    }\n\n    const current = existingBySourcePath.get(change.sourcePath)\n\n    if (!current) {\n      continue\n    }\n\n    await payload.update({\n      id: current.id,\n      collection: collectionSlug,\n      data: buildDocsData({\n        current,\n        desired: change.desired,\n        docsEnableDrafts,\n        docsSetId,\n        manifest,\n        markdownFieldName,\n        now,\n        publishMode,\n        syncRunId,\n      }),\n      overrideAccess: true,\n    })\n    writes.update += 1\n  }\n\n  for (const change of reactivations) {\n    if (!change.desired) {\n      continue\n    }\n\n    const current = existingBySourcePath.get(change.sourcePath)\n\n    if (!current) {\n      continue\n    }\n\n    await payload.update({\n      id: current.id,\n      collection: collectionSlug,\n      data: buildDocsData({\n        current,\n        desired: change.desired,\n        docsEnableDrafts,\n        docsSetId,\n        manifest,\n        markdownFieldName,\n        now,\n        publishMode,\n        syncRunId,\n      }),\n      overrideAccess: true,\n    })\n    writes.reactivate += 1\n  }\n\n  if (deleteBehavior === 'archive') {\n    for (const change of plan.archive) {\n      const current = existingBySourcePath.get(change.sourcePath)\n\n      if (!current) {\n        continue\n      }\n\n      await payload.update({\n        id: current.id,\n        collection: collectionSlug,\n        data: buildArchiveData({\n          docsEnableDrafts,\n          now,\n          syncRunId,\n        }),\n        overrideAccess: true,\n      })\n      writes.archive += 1\n    }\n  }\n\n  if (deleteBehavior === 'draft') {\n    for (const change of plan.draft) {\n      const current = existingBySourcePath.get(change.sourcePath)\n\n      if (!current) {\n        continue\n      }\n\n      await payload.update({\n        id: current.id,\n        collection: collectionSlug,\n        data: buildArchiveData({\n          docsEnableDrafts,\n          draftMissing: true,\n          now,\n          syncRunId,\n        }),\n        overrideAccess: true,\n      })\n      writes.draft += 1\n    }\n  }\n\n  if (deleteBehavior === 'delete') {\n    if (!payload.delete) {\n      throw new Error('Payload delete operation is required for hard delete.')\n    }\n\n    for (const change of plan.delete) {\n      const current = existingBySourcePath.get(change.sourcePath)\n\n      if (!current) {\n        continue\n      }\n\n      await payload.delete({\n        id: current.id,\n        collection: collectionSlug,\n        overrideAccess: true,\n      })\n      writes.delete += 1\n    }\n  }\n\n  return {\n    ok: true,\n    writes,\n  }\n}\n"],"names":["findDocsSyncConflicts","buildArchiveData","buildDocsData","assertApplyDeleteBehaviorSupported","deleteBehavior","allowHardDelete","docsEnableDrafts","applyDocsSync","collectionSlug","docsSetId","existing","manifest","markdownFieldName","now","payload","plan","publishMode","syncRunId","existingBySourcePath","Map","map","record","sourcePath","reactivations","unchanged","filter","change","current","archived","conflicts","plannedChanges","update","archive","draft","delete","length","ok","writes","create","reactivate","desired","collection","data","overrideAccess","get","id","draftMissing","Error"],"mappings":"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"}

package/dist/payload/docsConflicts.d.ts

@@ -0,0 +1,12 @@
+import type { PlannedDocChange } from '../sync/index.js';
+import type { ExistingPayloadDocsRecord } from './existingDocs.js';
+export type DocsSyncConflictReason = 'current_content_hash_mismatch' | 'missing_current_record' | 'unmanaged_record';
+export type DocsSyncConflict = {
+    reason: DocsSyncConflictReason;
+    route?: string;
+    sourcePath: string;
+};
+export declare const findDocsSyncConflicts: ({ existingBySourcePath, plannedChanges, }: {
+    existingBySourcePath: Map<string, ExistingPayloadDocsRecord>;
+    plannedChanges: PlannedDocChange[];
+}) => DocsSyncConflict[];

package/dist/payload/docsConflicts.js

@@ -0,0 +1,34 @@
+import { MANAGED_BY } from '../constants.js';
+import { sha256Hex } from '../sync/index.js';
+export const findDocsSyncConflicts = ({ existingBySourcePath, plannedChanges })=>{
+    const conflicts = [];
+    for (const change of plannedChanges){
+        const current = existingBySourcePath.get(change.sourcePath);
+        if (!current) {
+            conflicts.push({
+                reason: 'missing_current_record',
+                sourcePath: change.sourcePath
+            });
+            continue;
+        }
+        if (current.sync?.managedBy !== MANAGED_BY) {
+            conflicts.push({
+                reason: 'unmanaged_record',
+                route: current.route,
+                sourcePath: current.sourcePath
+            });
+            continue;
+        }
+        const currentContentHash = sha256Hex(current.content ?? '');
+        if (currentContentHash !== current.sync.sourceHashAtLastSync) {
+            conflicts.push({
+                reason: 'current_content_hash_mismatch',
+                route: current.route,
+                sourcePath: current.sourcePath
+            });
+        }
+    }
+    return conflicts;
+};
+
+//# sourceMappingURL=docsConflicts.js.map

package/dist/payload/docsConflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/payload/docsConflicts.ts"],"sourcesContent":["import type { PlannedDocChange } from '../sync/index.js'\nimport type { ExistingPayloadDocsRecord } from './existingDocs.js'\n\nimport { MANAGED_BY } from '../constants.js'\nimport { sha256Hex } from '../sync/index.js'\n\nexport type DocsSyncConflictReason =\n  | 'current_content_hash_mismatch'\n  | 'missing_current_record'\n  | 'unmanaged_record'\n\nexport type DocsSyncConflict = {\n  reason: DocsSyncConflictReason\n  route?: string\n  sourcePath: string\n}\n\nexport const findDocsSyncConflicts = ({\n  existingBySourcePath,\n  plannedChanges,\n}: {\n  existingBySourcePath: Map<string, ExistingPayloadDocsRecord>\n  plannedChanges: PlannedDocChange[]\n}): DocsSyncConflict[] => {\n  const conflicts: DocsSyncConflict[] = []\n\n  for (const change of plannedChanges) {\n    const current = existingBySourcePath.get(change.sourcePath)\n\n    if (!current) {\n      conflicts.push({\n        reason: 'missing_current_record',\n        sourcePath: change.sourcePath,\n      })\n      continue\n    }\n\n    if (current.sync?.managedBy !== MANAGED_BY) {\n      conflicts.push({\n        reason: 'unmanaged_record',\n        route: current.route,\n        sourcePath: current.sourcePath,\n      })\n      continue\n    }\n\n    const currentContentHash = sha256Hex(current.content ?? '')\n\n    if (currentContentHash !== current.sync.sourceHashAtLastSync) {\n      conflicts.push({\n        reason: 'current_content_hash_mismatch',\n        route: current.route,\n        sourcePath: current.sourcePath,\n      })\n    }\n  }\n\n  return conflicts\n}\n\n"],"names":["MANAGED_BY","sha256Hex","findDocsSyncConflicts","existingBySourcePath","plannedChanges","conflicts","change","current","get","sourcePath","push","reason","sync","managedBy","route","currentContentHash","content","sourceHashAtLastSync"],"mappings":"AAGA,SAASA,UAAU,QAAQ,kBAAiB;AAC5C,SAASC,SAAS,QAAQ,mBAAkB;AAa5C,OAAO,MAAMC,wBAAwB,CAAC,EACpCC,oBAAoB,EACpBC,cAAc,EAIf;IACC,MAAMC,YAAgC,EAAE;IAExC,KAAK,MAAMC,UAAUF,eAAgB;QACnC,MAAMG,UAAUJ,qBAAqBK,GAAG,CAACF,OAAOG,UAAU;QAE1D,IAAI,CAACF,SAAS;YACZF,UAAUK,IAAI,CAAC;gBACbC,QAAQ;gBACRF,YAAYH,OAAOG,UAAU;YAC/B;YACA;QACF;QAEA,IAAIF,QAAQK,IAAI,EAAEC,cAAcb,YAAY;YAC1CK,UAAUK,IAAI,CAAC;gBACbC,QAAQ;gBACRG,OAAOP,QAAQO,KAAK;gBACpBL,YAAYF,QAAQE,UAAU;YAChC;YACA;QACF;QAEA,MAAMM,qBAAqBd,UAAUM,QAAQS,OAAO,IAAI;QAExD,IAAID,uBAAuBR,QAAQK,IAAI,CAACK,oBAAoB,EAAE;YAC5DZ,UAAUK,IAAI,CAAC;gBACbC,QAAQ;gBACRG,OAAOP,QAAQO,KAAK;gBACpBL,YAAYF,QAAQE,UAAU;YAChC;QACF;IACF;IAEA,OAAOJ;AACT,EAAC"}

package/dist/payload/docsData.d.ts

@@ -0,0 +1,23 @@
+import type { ValidatedDocsManifest, ValidatedDocsManifestFile } from '../sync/index.js';
+import type { ExistingPayloadDocsRecord } from './existingDocs.js';
+export type BuildDocsDataInput = {
+    current?: ExistingPayloadDocsRecord;
+    desired: ValidatedDocsManifestFile;
+    docsEnableDrafts: boolean;
+    docsSetId?: number | string;
+    manifest: ValidatedDocsManifest;
+    markdownFieldName: string;
+    now: Date;
+    publishMode: DocsPublishMode;
+    syncRunId?: number | string;
+};
+export type DocsDraftStatus = 'draft' | 'published';
+export type DocsPublishMode = 'draft' | 'preserve' | 'published';
+export declare const getDocsDepth: (sourcePath: string) => number;
+export declare const buildDocsData: ({ current, desired, docsEnableDrafts, docsSetId, manifest, markdownFieldName, now, publishMode, syncRunId, }: BuildDocsDataInput) => Record<string, unknown>;
+export declare const buildArchiveData: ({ docsEnableDrafts, draftMissing, now, syncRunId, }: {
+    docsEnableDrafts?: boolean;
+    draftMissing?: boolean;
+    now: Date;
+    syncRunId?: number | string;
+}) => Record<string, unknown>;