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

package/dist/next/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/markdown.ts"],"sourcesContent":["import type {\n  DocsAiExportManifest,\n  DocsValidationIssue,\n} from '../sync/index.js'\nimport type {\n  PayloadMarkdownDocsCollectionSlugs,\n  PayloadMarkdownDocsReadPayload,\n  ResolvedPayloadMarkdownDocsRecord,\n  ResolvedPayloadMarkdownDocsSet,\n  ResolvePayloadMarkdownDocsRouteOptions,\n} from './types.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n  DEFAULT_MARKDOWN_FIELD_NAME,\n} from '../constants.js'\nimport { normalizeRoutePath } from '../routing/index.js'\nimport {\n  isExcludedFromAiExport,\n} from '../sync/index.js'\nimport {\n  isVisibleDocsRecord,\n  toResolvedDocsRecord,\n  toResolvedDocsSet,\n} from './records.js'\n\nexport type ResolvedPayloadMarkdownDocsMarkdownRoute = {\n  contentType: 'text/markdown; charset=utf-8'\n  docsSet: ResolvedPayloadMarkdownDocsSet\n  markdown: string\n  output: string\n  route: string\n  type: 'markdown'\n  warnings: DocsValidationIssue[]\n}\n\nexport type ResolvePayloadMarkdownDocsMarkdownRouteOptions =\n  ResolvePayloadMarkdownDocsRouteOptions\n\ntype ResolvedCollectionSlugs = {\n  docs: string\n  docsGroups: string\n  docsSets: string\n}\n\nconst resolveCollectionSlugs = (\n  collections?: PayloadMarkdownDocsCollectionSlugs,\n): ResolvedCollectionSlugs => ({\n  docs: collections?.docs ?? DEFAULT_DOCS_COLLECTION_SLUG,\n  docsGroups: collections?.docsGroups ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  docsSets: collections?.docsSets ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n})\n\nconst getRoutePath = ({\n  slug,\n  path,\n}: Pick<ResolvePayloadMarkdownDocsRouteOptions, 'path' | 'slug'>): string => {\n  if (path !== undefined) {\n    return normalizeRoutePath(path)\n  }\n\n  if (Array.isArray(slug)) {\n    return normalizeRoutePath(slug.length === 0 ? '/' : slug.join('/'))\n  }\n\n  if (typeof slug === 'string') {\n    return normalizeRoutePath(slug)\n  }\n\n  return '/'\n}\n\nconst stripMarkdownRouteSuffix = (route: string): string | undefined =>\n  route.toLowerCase().endsWith('.md') ? route.slice(0, -3) : undefined\n\nconst findDocsSetByRouteBase = async ({\n  collections,\n  overrideAccess,\n  payload,\n  routeBase,\n}: {\n  collections: ResolvedCollectionSlugs\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  routeBase: string\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1,\n    overrideAccess,\n    where: {\n      routeBase: {\n        equals: routeBase,\n      },\n    },\n  })\n\n  return result.docs\n    .map(toResolvedDocsSet)\n    .find((docsSet) => docsSet?.routeBase === routeBase)\n}\n\nconst findDocsSetByAiExportOutput = async ({\n  collections,\n  output,\n  overrideAccess,\n  payload,\n}: {\n  collections: ResolvedCollectionSlugs\n  output: string\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n  })\n\n  return result.docs\n    .map(toResolvedDocsSet)\n    .find((docsSet) => docsSet?.aiExport?.output === output)\n}\n\nconst findDocsSetForMarkdownRoute = async ({\n  collections,\n  overrideAccess,\n  payload,\n  route,\n}: {\n  collections: ResolvedCollectionSlugs\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  route: string\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const routeBase = stripMarkdownRouteSuffix(route)\n\n  if (!routeBase) {\n    return undefined\n  }\n\n  const docsSet = await findDocsSetByRouteBase({\n    collections,\n    overrideAccess,\n    payload,\n    routeBase,\n  })\n\n  return (\n    docsSet ??\n    findDocsSetByAiExportOutput({\n      collections,\n      output: route,\n      overrideAccess,\n      payload,\n    })\n  )\n}\n\nconst getDocsRecords = async ({\n  collections,\n  docsSet,\n  includeDrafts,\n  markdownField,\n  overrideAccess,\n  payload,\n}: {\n  collections: ResolvedCollectionSlugs\n  docsSet: ResolvedPayloadMarkdownDocsSet\n  includeDrafts: boolean\n  markdownField: string\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n}): Promise<ResolvedPayloadMarkdownDocsRecord[]> => {\n  const result = await payload.find({\n    collection: collections.docs,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n    where: {\n      docsSet: {\n        equals: docsSet.id,\n      },\n    },\n  })\n\n  return result.docs\n    .map((doc) =>\n      toResolvedDocsRecord({\n        doc,\n        markdownField,\n      }),\n    )\n    .filter(\n      (record): record is ResolvedPayloadMarkdownDocsRecord =>\n        record !== undefined &&\n        isVisibleDocsRecord({\n          includeDrafts,\n          record,\n        }),\n    )\n}\n\nconst compareDocsRecords = (\n  first: ResolvedPayloadMarkdownDocsRecord,\n  second: ResolvedPayloadMarkdownDocsRecord,\n): number => {\n  if (first.order !== second.order) {\n    return first.order - second.order\n  }\n\n  const titleCompare = first.title.localeCompare(second.title)\n\n  if (titleCompare !== 0) {\n    return titleCompare\n  }\n\n  const pathCompare = first.sourcePath.localeCompare(second.sourcePath)\n\n  return pathCompare !== 0 ? pathCompare : first.id.localeCompare(second.id)\n}\n\nconst getDefaultAiExportManifest = (\n  docsSet: ResolvedPayloadMarkdownDocsSet,\n): DocsAiExportManifest => ({\n  canonical: docsSet.routeBase,\n  exclude: [],\n  headingMode: 'normalize',\n  order: [],\n  orphans: 'append',\n  output: `${docsSet.routeBase}.md`,\n  sourcePath: 'fallback',\n  title: docsSet.title,\n  version: 1,\n})\n\nconst orderDocsRecords = ({\n  manifest,\n  records,\n}: {\n  manifest: DocsAiExportManifest\n  records: ResolvedPayloadMarkdownDocsRecord[]\n}): {\n  ordered: ResolvedPayloadMarkdownDocsRecord[]\n  warnings: DocsValidationIssue[]\n} => {\n  const recordsBySourcePath = new Map(records.map((record) => [record.sourcePath, record]))\n  const listedRecords: ResolvedPayloadMarkdownDocsRecord[] = []\n  const listedSourcePaths = new Set<string>()\n  const warnings: DocsValidationIssue[] = []\n\n  for (const orderedPath of manifest.order) {\n    listedSourcePaths.add(orderedPath)\n    const record = recordsBySourcePath.get(orderedPath)\n\n    if (!record) {\n      warnings.push({\n        code: 'missing_ai_export_order_path',\n        message: `AI export manifest order path \"${orderedPath}\" does not exist in the generated docs records.`,\n        path: manifest.sourcePath,\n      })\n      continue\n    }\n\n    listedRecords.push(record)\n  }\n\n  if (manifest.orphans === 'ignore') {\n    return {\n      ordered: listedRecords,\n      warnings,\n    }\n  }\n\n  const orphans = records\n    .filter((record) => !listedSourcePaths.has(record.sourcePath))\n    .sort(compareDocsRecords)\n\n  return {\n    ordered: [...listedRecords, ...orphans],\n    warnings,\n  }\n}\n\nconst shiftMarkdownHeadings = (markdown: string): string =>\n  markdown.replace(/^(#{1,6})(\\s+)/gm, (match, hashes: string, whitespace: string) =>\n    hashes.length >= 5 ? `${'#'.repeat(6)}${whitespace}` : `${hashes}##${whitespace}`,\n  )\n\nconst sectionTitle = (record: ResolvedPayloadMarkdownDocsRecord): string =>\n  record.title.trim() || record.sourcePath\n\nconst renderMarkdownExport = ({\n  docsSet,\n  manifest,\n  records,\n}: {\n  docsSet: ResolvedPayloadMarkdownDocsSet\n  manifest: DocsAiExportManifest\n  records: ResolvedPayloadMarkdownDocsRecord[]\n}): string => {\n  const lines: string[] = []\n  const title = manifest.title ?? docsSet.title\n  const canonical = manifest.canonical ?? docsSet.routeBase\n  const output = manifest.output ?? `${docsSet.routeBase}.md`\n\n  lines.push(`# ${title}`)\n  lines.push('')\n  lines.push(`Canonical: ${canonical}`)\n  lines.push(`Output: ${output}`)\n\n  if (manifest.description) {\n    lines.push('', manifest.description.trim())\n  }\n\n  if (manifest.preamble) {\n    lines.push('', manifest.preamble.trim())\n  }\n\n  for (const record of records) {\n    const content = record.content?.trim()\n\n    if (!content) {\n      continue\n    }\n\n    if (manifest.headingMode === 'preserve') {\n      lines.push('', content)\n      continue\n    }\n\n    lines.push('', `## ${sectionTitle(record)}`, '', shiftMarkdownHeadings(content))\n  }\n\n  return `${lines.join('\\n').replace(/\\n{4,}/g, '\\n\\n\\n').trimEnd()}\\n`\n}\n\nexport const resolvePayloadMarkdownDocsMarkdownRoute = async ({\n  slug,\n  collections: collectionOptions,\n  includeDrafts = false,\n  markdownField = DEFAULT_MARKDOWN_FIELD_NAME,\n  // Route adapter reads plugin-owned generated docs collections server-side.\n  // Access is overridden here, then public visibility and manifest exclusions are enforced.\n  overrideAccess = true,\n  path,\n  payload,\n}: ResolvePayloadMarkdownDocsMarkdownRouteOptions): Promise<\n  null | ResolvedPayloadMarkdownDocsMarkdownRoute\n> => {\n  const route = getRoutePath({\n    slug,\n    path,\n  })\n  const collections = resolveCollectionSlugs(collectionOptions)\n  const docsSet = await findDocsSetForMarkdownRoute({\n    collections,\n    overrideAccess,\n    payload,\n    route,\n  })\n\n  if (!docsSet) {\n    return null\n  }\n\n  const manifest = docsSet.aiExport ?? getDefaultAiExportManifest(docsSet)\n  const records = (\n    await getDocsRecords({\n      collections,\n      docsSet,\n      includeDrafts,\n      markdownField,\n      overrideAccess,\n      payload,\n    })\n  ).filter(\n    (record) =>\n      !isExcludedFromAiExport({\n        exclude: manifest.exclude,\n        sourcePath: record.sourcePath,\n      }),\n  )\n  const ordered = orderDocsRecords({\n    manifest,\n    records,\n  })\n\n  return {\n    type: 'markdown',\n    contentType: 'text/markdown; charset=utf-8',\n    docsSet,\n    markdown: renderMarkdownExport({\n      docsSet,\n      manifest,\n      records: ordered.ordered,\n    }),\n    output: manifest.output ?? `${docsSet.routeBase}.md`,\n    route,\n    warnings: ordered.warnings,\n  }\n}\n\nexport const createPayloadMarkdownDocsMarkdownResponse = async (\n  options: ResolvePayloadMarkdownDocsMarkdownRouteOptions,\n): Promise<null | Response> => {\n  const resolved = await resolvePayloadMarkdownDocsMarkdownRoute(options)\n\n  if (!resolved) {\n    return null\n  }\n\n  return new Response(resolved.markdown, {\n    headers: {\n      'Content-Type': resolved.contentType,\n    },\n    status: 200,\n  })\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_GROUPS_COLLECTION_SLUG","DEFAULT_DOCS_SETS_COLLECTION_SLUG","DEFAULT_MARKDOWN_FIELD_NAME","normalizeRoutePath","isExcludedFromAiExport","isVisibleDocsRecord","toResolvedDocsRecord","toResolvedDocsSet","resolveCollectionSlugs","collections","docs","docsGroups","docsSets","getRoutePath","slug","path","undefined","Array","isArray","length","join","stripMarkdownRouteSuffix","route","toLowerCase","endsWith","slice","findDocsSetByRouteBase","overrideAccess","payload","routeBase","result","find","collection","depth","limit","where","equals","map","docsSet","findDocsSetByAiExportOutput","output","aiExport","findDocsSetForMarkdownRoute","getDocsRecords","includeDrafts","markdownField","id","doc","filter","record","compareDocsRecords","first","second","order","titleCompare","title","localeCompare","pathCompare","sourcePath","getDefaultAiExportManifest","canonical","exclude","headingMode","orphans","version","orderDocsRecords","manifest","records","recordsBySourcePath","Map","listedRecords","listedSourcePaths","Set","warnings","orderedPath","add","get","push","code","message","ordered","has","sort","shiftMarkdownHeadings","markdown","replace","match","hashes","whitespace","repeat","sectionTitle","trim","renderMarkdownExport","lines","description","preamble","content","trimEnd","resolvePayloadMarkdownDocsMarkdownRoute","collectionOptions","type","contentType","createPayloadMarkdownDocsMarkdownResponse","options","resolved","Response","headers","status"],"mappings":"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"}

package/dist/next/metadata.d.ts

@@ -0,0 +1,3 @@
+import type { PayloadMarkdownDocsMetadata, ResolvedPayloadMarkdownDocsRoute, ResolvePayloadMarkdownDocsRouteOptions } from './types.js';
+export declare const getPayloadMarkdownDocsMetadata: (resolved: ResolvedPayloadMarkdownDocsRoute) => PayloadMarkdownDocsMetadata;
+export declare const generatePayloadMarkdownDocsMetadata: (options: ResolvePayloadMarkdownDocsRouteOptions) => Promise<null | PayloadMarkdownDocsMetadata>;

package/dist/next/metadata.js

@@ -0,0 +1,33 @@
+import { resolvePayloadMarkdownDocsRoute } from './route.js';
+const compactMetadata = (metadata)=>Object.fromEntries(Object.entries(metadata).filter(([, value])=>value !== undefined && value !== ''));
+export const getPayloadMarkdownDocsMetadata = (resolved)=>{
+    if (resolved.type === 'docsGroupIndex') {
+        return compactMetadata({
+            description: resolved.group.description,
+            title: resolved.group.navTitle ?? resolved.group.title
+        });
+    }
+    if (resolved.type === 'docsSetIndex' && !resolved.doc) {
+        return compactMetadata({
+            description: resolved.docsSet.defaults?.seoDescription ?? resolved.docsSet.description,
+            title: resolved.docsSet.defaults?.seoTitle ?? resolved.docsSet.defaults?.heroTitle ?? resolved.docsSet.navTitle ?? resolved.docsSet.title
+        });
+    }
+    const doc = resolved.doc;
+    if (!doc) {
+        return compactMetadata({
+            description: resolved.docsSet.defaults?.seoDescription ?? resolved.docsSet.description,
+            title: resolved.docsSet.defaults?.seoTitle ?? resolved.docsSet.defaults?.heroTitle ?? resolved.docsSet.navTitle ?? resolved.docsSet.title
+        });
+    }
+    return compactMetadata({
+        description: doc.overrides?.seoDescription ?? doc.overrides?.heroDescription ?? doc.description ?? resolved.docsSet.defaults?.seoDescription ?? resolved.docsSet.description,
+        title: doc.overrides?.seoTitle ?? doc.overrides?.heroTitle ?? doc.title ?? resolved.docsSet.defaults?.seoTitle ?? resolved.docsSet.title
+    });
+};
+export const generatePayloadMarkdownDocsMetadata = async (options)=>{
+    const resolved = await resolvePayloadMarkdownDocsRoute(options);
+    return resolved ? getPayloadMarkdownDocsMetadata(resolved) : null;
+};
+
+//# sourceMappingURL=metadata.js.map

package/dist/next/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/metadata.ts"],"sourcesContent":["import type {\n  PayloadMarkdownDocsMetadata,\n  ResolvedPayloadMarkdownDocsRoute,\n  ResolvePayloadMarkdownDocsRouteOptions,\n} from './types.js'\n\nimport { resolvePayloadMarkdownDocsRoute } from './route.js'\n\nconst compactMetadata = (\n  metadata: PayloadMarkdownDocsMetadata,\n): PayloadMarkdownDocsMetadata =>\n  Object.fromEntries(\n    Object.entries(metadata).filter(([, value]) => value !== undefined && value !== ''),\n  ) as PayloadMarkdownDocsMetadata\n\nexport const getPayloadMarkdownDocsMetadata = (\n  resolved: ResolvedPayloadMarkdownDocsRoute,\n): PayloadMarkdownDocsMetadata => {\n  if (resolved.type === 'docsGroupIndex') {\n    return compactMetadata({\n      description: resolved.group.description,\n      title: resolved.group.navTitle ?? resolved.group.title,\n    })\n  }\n\n  if (resolved.type === 'docsSetIndex' && !resolved.doc) {\n    return compactMetadata({\n      description:\n        resolved.docsSet.defaults?.seoDescription ?? resolved.docsSet.description,\n      title:\n        resolved.docsSet.defaults?.seoTitle ??\n        resolved.docsSet.defaults?.heroTitle ??\n        resolved.docsSet.navTitle ??\n        resolved.docsSet.title,\n    })\n  }\n\n  const doc = resolved.doc\n\n  if (!doc) {\n    return compactMetadata({\n      description:\n        resolved.docsSet.defaults?.seoDescription ?? resolved.docsSet.description,\n      title:\n        resolved.docsSet.defaults?.seoTitle ??\n        resolved.docsSet.defaults?.heroTitle ??\n        resolved.docsSet.navTitle ??\n        resolved.docsSet.title,\n    })\n  }\n\n  return compactMetadata({\n    description:\n      doc.overrides?.seoDescription ??\n      doc.overrides?.heroDescription ??\n      doc.description ??\n      resolved.docsSet.defaults?.seoDescription ??\n      resolved.docsSet.description,\n    title:\n      doc.overrides?.seoTitle ??\n      doc.overrides?.heroTitle ??\n      doc.title ??\n      resolved.docsSet.defaults?.seoTitle ??\n      resolved.docsSet.title,\n  })\n}\n\nexport const generatePayloadMarkdownDocsMetadata = async (\n  options: ResolvePayloadMarkdownDocsRouteOptions,\n): Promise<null | PayloadMarkdownDocsMetadata> => {\n  const resolved = await resolvePayloadMarkdownDocsRoute(options)\n\n  return resolved ? getPayloadMarkdownDocsMetadata(resolved) : null\n}\n"],"names":["resolvePayloadMarkdownDocsRoute","compactMetadata","metadata","Object","fromEntries","entries","filter","value","undefined","getPayloadMarkdownDocsMetadata","resolved","type","description","group","title","navTitle","doc","docsSet","defaults","seoDescription","seoTitle","heroTitle","overrides","heroDescription","generatePayloadMarkdownDocsMetadata","options"],"mappings":"AAMA,SAASA,+BAA+B,QAAQ,aAAY;AAE5D,MAAMC,kBAAkB,CACtBC,WAEAC,OAAOC,WAAW,CAChBD,OAAOE,OAAO,CAACH,UAAUI,MAAM,CAAC,CAAC,GAAGC,MAAM,GAAKA,UAAUC,aAAaD,UAAU;AAGpF,OAAO,MAAME,iCAAiC,CAC5CC;IAEA,IAAIA,SAASC,IAAI,KAAK,kBAAkB;QACtC,OAAOV,gBAAgB;YACrBW,aAAaF,SAASG,KAAK,CAACD,WAAW;YACvCE,OAAOJ,SAASG,KAAK,CAACE,QAAQ,IAAIL,SAASG,KAAK,CAACC,KAAK;QACxD;IACF;IAEA,IAAIJ,SAASC,IAAI,KAAK,kBAAkB,CAACD,SAASM,GAAG,EAAE;QACrD,OAAOf,gBAAgB;YACrBW,aACEF,SAASO,OAAO,CAACC,QAAQ,EAAEC,kBAAkBT,SAASO,OAAO,CAACL,WAAW;YAC3EE,OACEJ,SAASO,OAAO,CAACC,QAAQ,EAAEE,YAC3BV,SAASO,OAAO,CAACC,QAAQ,EAAEG,aAC3BX,SAASO,OAAO,CAACF,QAAQ,IACzBL,SAASO,OAAO,CAACH,KAAK;QAC1B;IACF;IAEA,MAAME,MAAMN,SAASM,GAAG;IAExB,IAAI,CAACA,KAAK;QACR,OAAOf,gBAAgB;YACrBW,aACEF,SAASO,OAAO,CAACC,QAAQ,EAAEC,kBAAkBT,SAASO,OAAO,CAACL,WAAW;YAC3EE,OACEJ,SAASO,OAAO,CAACC,QAAQ,EAAEE,YAC3BV,SAASO,OAAO,CAACC,QAAQ,EAAEG,aAC3BX,SAASO,OAAO,CAACF,QAAQ,IACzBL,SAASO,OAAO,CAACH,KAAK;QAC1B;IACF;IAEA,OAAOb,gBAAgB;QACrBW,aACEI,IAAIM,SAAS,EAAEH,kBACfH,IAAIM,SAAS,EAAEC,mBACfP,IAAIJ,WAAW,IACfF,SAASO,OAAO,CAACC,QAAQ,EAAEC,kBAC3BT,SAASO,OAAO,CAACL,WAAW;QAC9BE,OACEE,IAAIM,SAAS,EAAEF,YACfJ,IAAIM,SAAS,EAAED,aACfL,IAAIF,KAAK,IACTJ,SAASO,OAAO,CAACC,QAAQ,EAAEE,YAC3BV,SAASO,OAAO,CAACH,KAAK;IAC1B;AACF,EAAC;AAED,OAAO,MAAMU,sCAAsC,OACjDC;IAEA,MAAMf,WAAW,MAAMV,gCAAgCyB;IAEvD,OAAOf,WAAWD,+BAA+BC,YAAY;AAC/D,EAAC"}

package/dist/next/records.d.ts

@@ -0,0 +1,14 @@
+import type { ResolvedPayloadMarkdownDocsGroup, ResolvedPayloadMarkdownDocsRecord, ResolvedPayloadMarkdownDocsSet } from './types.js';
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const getRecordId: (doc: Record<string, unknown>) => string | undefined;
+export declare const getRelationshipId: (value: unknown) => string | undefined;
+export declare const toResolvedDocsSet: (doc: unknown) => ResolvedPayloadMarkdownDocsSet | undefined;
+export declare const toResolvedDocsGroup: (doc: unknown) => ResolvedPayloadMarkdownDocsGroup | undefined;
+export declare const toResolvedDocsRecord: ({ doc, markdownField, }: {
+    doc: unknown;
+    markdownField: string;
+}) => ResolvedPayloadMarkdownDocsRecord | undefined;
+export declare const isVisibleDocsRecord: ({ includeDrafts, record, }: {
+    includeDrafts?: boolean;
+    record: ResolvedPayloadMarkdownDocsRecord;
+}) => boolean;

package/dist/next/records.js

@@ -0,0 +1,146 @@
+import { normalizeRoutePath } from '../routing/index.js';
+import { isAiMarkdownExportManifestPath, validateDocsAiExportManifest } from '../sync/index.js';
+export const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+export const getRecordId = (doc)=>{
+    if (typeof doc.id === 'string' || typeof doc.id === 'number') {
+        return String(doc.id);
+    }
+    return undefined;
+};
+export const getRelationshipId = (value)=>{
+    if (typeof value === 'string' || typeof value === 'number') {
+        return String(value);
+    }
+    if (isRecord(value)) {
+        return getRecordId(value);
+    }
+    return undefined;
+};
+const getOptionalString = (doc, key)=>typeof doc[key] === 'string' ? doc[key] : undefined;
+const getOptionalNumber = (doc, key)=>typeof doc[key] === 'number' ? doc[key] : undefined;
+const getOptionalBoolean = (doc, key)=>typeof doc[key] === 'boolean' ? doc[key] : undefined;
+const cleanObject = (input)=>Object.fromEntries(Object.entries(input).filter(([, value])=>value !== undefined && value !== null));
+const toDefaults = (value)=>{
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const sidebarMode = value.sidebarMode === 'auto' || value.sidebarMode === 'hidden' || value.sidebarMode === 'manual' ? value.sidebarMode : undefined;
+    const defaults = cleanObject({
+        heroDescription: getOptionalString(value, 'heroDescription'),
+        heroEyebrow: getOptionalString(value, 'heroEyebrow'),
+        heroTitle: getOptionalString(value, 'heroTitle'),
+        seoDescription: getOptionalString(value, 'seoDescription'),
+        seoTitle: getOptionalString(value, 'seoTitle'),
+        sidebarMode,
+        theme: getOptionalString(value, 'theme')
+    });
+    return Object.keys(defaults).length > 0 ? defaults : undefined;
+};
+const toOverrides = (value)=>{
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const overrides = cleanObject({
+        heroDescription: getOptionalString(value, 'heroDescription'),
+        heroEyebrow: getOptionalString(value, 'heroEyebrow'),
+        heroTitle: getOptionalString(value, 'heroTitle'),
+        hideFromNav: getOptionalBoolean(value, 'hideFromNav'),
+        navTitle: getOptionalString(value, 'navTitle'),
+        seoDescription: getOptionalString(value, 'seoDescription'),
+        seoTitle: getOptionalString(value, 'seoTitle'),
+        theme: getOptionalString(value, 'theme')
+    });
+    return Object.keys(overrides).length > 0 ? overrides : undefined;
+};
+export const toResolvedDocsSet = (doc)=>{
+    if (!isRecord(doc)) {
+        return undefined;
+    }
+    const id = getRecordId(doc);
+    const routeBase = getOptionalString(doc, 'routeBase');
+    const title = getOptionalString(doc, 'title');
+    if (!id || !routeBase || !title) {
+        return undefined;
+    }
+    const aiExportValidation = doc.aiExport === undefined || doc.aiExport === null ? undefined : validateDocsAiExportManifest(doc.aiExport);
+    return {
+        ...aiExportValidation?.ok ? {
+            aiExport: aiExportValidation.manifest
+        } : {},
+        id,
+        slug: getOptionalString(doc, 'slug'),
+        defaults: toDefaults(doc.defaults),
+        description: getOptionalString(doc, 'description'),
+        navTitle: getOptionalString(doc, 'navTitle'),
+        order: getOptionalNumber(doc, 'order') ?? 0,
+        routeBase: normalizeRoutePath(routeBase),
+        sourceId: getOptionalString(doc, 'sourceId'),
+        sourceRoot: getOptionalString(doc, 'sourceRoot'),
+        title
+    };
+};
+export const toResolvedDocsGroup = (doc)=>{
+    if (!isRecord(doc)) {
+        return undefined;
+    }
+    const id = getRecordId(doc);
+    const routePath = getOptionalString(doc, 'routePath');
+    const title = getOptionalString(doc, 'title');
+    if (!id || !routePath || !title) {
+        return undefined;
+    }
+    return {
+        id,
+        slug: getOptionalString(doc, 'slug'),
+        description: getOptionalString(doc, 'description'),
+        navTitle: getOptionalString(doc, 'navTitle'),
+        order: getOptionalNumber(doc, 'order') ?? 0,
+        routePath: normalizeRoutePath(routePath),
+        serveIndex: getOptionalBoolean(doc, 'serveIndex') ?? false,
+        title
+    };
+};
+export const toResolvedDocsRecord = ({ doc, markdownField })=>{
+    if (!isRecord(doc)) {
+        return undefined;
+    }
+    const id = getRecordId(doc);
+    const route = getOptionalString(doc, 'route');
+    const sourcePath = getOptionalString(doc, 'sourcePath');
+    const title = getOptionalString(doc, 'title');
+    if (!id || !route || !sourcePath || !title) {
+        return undefined;
+    }
+    const sync = isRecord(doc.sync) ? doc.sync : undefined;
+    const status = doc._status === 'draft' || doc._status === 'published' ? doc._status : undefined;
+    return {
+        id,
+        archived: getOptionalBoolean(sync ?? {}, 'archived') ?? false,
+        content: typeof doc[markdownField] === 'string' ? doc[markdownField] : undefined,
+        depth: getOptionalNumber(doc, 'depth') ?? 0,
+        description: getOptionalString(doc, 'description'),
+        docsSetId: getRelationshipId(doc.docsSet),
+        navTitle: getOptionalString(doc, 'navTitle'),
+        order: getOptionalNumber(doc, 'order') ?? 0,
+        overrides: toOverrides(doc.overrides),
+        route: normalizeRoutePath(route),
+        sourceHash: getOptionalString(doc, 'sourceHash'),
+        sourcePath,
+        status,
+        title
+    };
+};
+export const isVisibleDocsRecord = ({ includeDrafts = false, record })=>{
+    if (record.archived) {
+        return false;
+    }
+    if (isAiMarkdownExportManifestPath(record.sourcePath)) {
+        return false;
+    }
+    if (!includeDrafts && record.status === 'draft') {
+        return false;
+    }
+    return true;
+};
+
+//# sourceMappingURL=records.js.map

package/dist/next/records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/records.ts"],"sourcesContent":["import type {\n  PayloadMarkdownDocsDefaults,\n  PayloadMarkdownDocsOverrides,\n  ResolvedPayloadMarkdownDocsGroup,\n  ResolvedPayloadMarkdownDocsRecord,\n  ResolvedPayloadMarkdownDocsSet,\n} from './types.js'\n\nimport { normalizeRoutePath } from '../routing/index.js'\nimport {\n  isAiMarkdownExportManifestPath,\n  validateDocsAiExportManifest,\n} from '../sync/index.js'\n\nexport const isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nexport const getRecordId = (doc: Record<string, unknown>): string | undefined => {\n  if (typeof doc.id === 'string' || typeof doc.id === 'number') {\n    return String(doc.id)\n  }\n\n  return undefined\n}\n\nexport const getRelationshipId = (value: unknown): string | undefined => {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return String(value)\n  }\n\n  if (isRecord(value)) {\n    return getRecordId(value)\n  }\n\n  return undefined\n}\n\nconst getOptionalString = (\n  doc: Record<string, unknown>,\n  key: string,\n): string | undefined => (typeof doc[key] === 'string' ? doc[key] : undefined)\n\nconst getOptionalNumber = (\n  doc: Record<string, unknown>,\n  key: string,\n): number | undefined => (typeof doc[key] === 'number' ? doc[key] : undefined)\n\nconst getOptionalBoolean = (\n  doc: Record<string, unknown>,\n  key: string,\n): boolean | undefined => (typeof doc[key] === 'boolean' ? doc[key] : undefined)\n\nconst cleanObject = <T extends Record<string, unknown>>(input: T): Partial<T> =>\n  Object.fromEntries(\n    Object.entries(input).filter(([, value]) => value !== undefined && value !== null),\n  ) as Partial<T>\n\nconst toDefaults = (value: unknown): PayloadMarkdownDocsDefaults | undefined => {\n  if (!isRecord(value)) {\n    return undefined\n  }\n\n  const sidebarMode: PayloadMarkdownDocsDefaults['sidebarMode'] =\n    value.sidebarMode === 'auto' ||\n    value.sidebarMode === 'hidden' ||\n    value.sidebarMode === 'manual'\n      ? value.sidebarMode\n      : undefined\n  const defaults = cleanObject({\n    heroDescription: getOptionalString(value, 'heroDescription'),\n    heroEyebrow: getOptionalString(value, 'heroEyebrow'),\n    heroTitle: getOptionalString(value, 'heroTitle'),\n    seoDescription: getOptionalString(value, 'seoDescription'),\n    seoTitle: getOptionalString(value, 'seoTitle'),\n    sidebarMode,\n    theme: getOptionalString(value, 'theme'),\n  } satisfies PayloadMarkdownDocsDefaults)\n\n  return Object.keys(defaults).length > 0\n    ? (defaults as PayloadMarkdownDocsDefaults)\n    : undefined\n}\n\nconst toOverrides = (value: unknown): PayloadMarkdownDocsOverrides | undefined => {\n  if (!isRecord(value)) {\n    return undefined\n  }\n\n  const overrides = cleanObject({\n    heroDescription: getOptionalString(value, 'heroDescription'),\n    heroEyebrow: getOptionalString(value, 'heroEyebrow'),\n    heroTitle: getOptionalString(value, 'heroTitle'),\n    hideFromNav: getOptionalBoolean(value, 'hideFromNav'),\n    navTitle: getOptionalString(value, 'navTitle'),\n    seoDescription: getOptionalString(value, 'seoDescription'),\n    seoTitle: getOptionalString(value, 'seoTitle'),\n    theme: getOptionalString(value, 'theme'),\n  })\n\n  return Object.keys(overrides).length > 0 ? overrides : undefined\n}\n\nexport const toResolvedDocsSet = (\n  doc: unknown,\n): ResolvedPayloadMarkdownDocsSet | undefined => {\n  if (!isRecord(doc)) {\n    return undefined\n  }\n\n  const id = getRecordId(doc)\n  const routeBase = getOptionalString(doc, 'routeBase')\n  const title = getOptionalString(doc, 'title')\n\n  if (!id || !routeBase || !title) {\n    return undefined\n  }\n\n  const aiExportValidation =\n    doc.aiExport === undefined || doc.aiExport === null\n      ? undefined\n      : validateDocsAiExportManifest(doc.aiExport)\n\n  return {\n    ...(aiExportValidation?.ok ? { aiExport: aiExportValidation.manifest } : {}),\n    id,\n    slug: getOptionalString(doc, 'slug'),\n    defaults: toDefaults(doc.defaults),\n    description: getOptionalString(doc, 'description'),\n    navTitle: getOptionalString(doc, 'navTitle'),\n    order: getOptionalNumber(doc, 'order') ?? 0,\n    routeBase: normalizeRoutePath(routeBase),\n    sourceId: getOptionalString(doc, 'sourceId'),\n    sourceRoot: getOptionalString(doc, 'sourceRoot'),\n    title,\n  }\n}\n\nexport const toResolvedDocsGroup = (\n  doc: unknown,\n): ResolvedPayloadMarkdownDocsGroup | undefined => {\n  if (!isRecord(doc)) {\n    return undefined\n  }\n\n  const id = getRecordId(doc)\n  const routePath = getOptionalString(doc, 'routePath')\n  const title = getOptionalString(doc, 'title')\n\n  if (!id || !routePath || !title) {\n    return undefined\n  }\n\n  return {\n    id,\n    slug: getOptionalString(doc, 'slug'),\n    description: getOptionalString(doc, 'description'),\n    navTitle: getOptionalString(doc, 'navTitle'),\n    order: getOptionalNumber(doc, 'order') ?? 0,\n    routePath: normalizeRoutePath(routePath),\n    serveIndex: getOptionalBoolean(doc, 'serveIndex') ?? false,\n    title,\n  }\n}\n\nexport const toResolvedDocsRecord = ({\n  doc,\n  markdownField,\n}: {\n  doc: unknown\n  markdownField: string\n}): ResolvedPayloadMarkdownDocsRecord | undefined => {\n  if (!isRecord(doc)) {\n    return undefined\n  }\n\n  const id = getRecordId(doc)\n  const route = getOptionalString(doc, 'route')\n  const sourcePath = getOptionalString(doc, 'sourcePath')\n  const title = getOptionalString(doc, 'title')\n\n  if (!id || !route || !sourcePath || !title) {\n    return undefined\n  }\n\n  const sync = isRecord(doc.sync) ? doc.sync : undefined\n  const status =\n    doc._status === 'draft' || doc._status === 'published' ? doc._status : undefined\n\n  return {\n    id,\n    archived: getOptionalBoolean(sync ?? {}, 'archived') ?? false,\n    content:\n      typeof doc[markdownField] === 'string' ? doc[markdownField] : undefined,\n    depth: getOptionalNumber(doc, 'depth') ?? 0,\n    description: getOptionalString(doc, 'description'),\n    docsSetId: getRelationshipId(doc.docsSet),\n    navTitle: getOptionalString(doc, 'navTitle'),\n    order: getOptionalNumber(doc, 'order') ?? 0,\n    overrides: toOverrides(doc.overrides),\n    route: normalizeRoutePath(route),\n    sourceHash: getOptionalString(doc, 'sourceHash'),\n    sourcePath,\n    status,\n    title,\n  }\n}\n\nexport const isVisibleDocsRecord = ({\n  includeDrafts = false,\n  record,\n}: {\n  includeDrafts?: boolean\n  record: ResolvedPayloadMarkdownDocsRecord\n}): boolean => {\n  if (record.archived) {\n    return false\n  }\n\n  if (isAiMarkdownExportManifestPath(record.sourcePath)) {\n    return false\n  }\n\n  if (!includeDrafts && record.status === 'draft') {\n    return false\n  }\n\n  return true\n}\n"],"names":["normalizeRoutePath","isAiMarkdownExportManifestPath","validateDocsAiExportManifest","isRecord","value","Array","isArray","getRecordId","doc","id","String","undefined","getRelationshipId","getOptionalString","key","getOptionalNumber","getOptionalBoolean","cleanObject","input","Object","fromEntries","entries","filter","toDefaults","sidebarMode","defaults","heroDescription","heroEyebrow","heroTitle","seoDescription","seoTitle","theme","keys","length","toOverrides","overrides","hideFromNav","navTitle","toResolvedDocsSet","routeBase","title","aiExportValidation","aiExport","ok","manifest","slug","description","order","sourceId","sourceRoot","toResolvedDocsGroup","routePath","serveIndex","toResolvedDocsRecord","markdownField","route","sourcePath","sync","status","_status","archived","content","depth","docsSetId","docsSet","sourceHash","isVisibleDocsRecord","includeDrafts","record"],"mappings":"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"}

package/dist/next/route.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedPayloadMarkdownDocsRoute, ResolvePayloadMarkdownDocsRouteOptions } from './types.js';
+export declare const getPayloadMarkdownDocsRoutePath: ({ slug, path, }: {
+    path?: string;
+    slug?: string | string[];
+}) => string;
+export declare const resolvePayloadMarkdownDocsRoute: ({ slug, collections: collectionOptions, includeDrafts, markdownField, overrideAccess, path, payload, }: ResolvePayloadMarkdownDocsRouteOptions) => Promise<null | ResolvedPayloadMarkdownDocsRoute>;

package/dist/next/route.js

@@ -0,0 +1,271 @@
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_GROUPS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG, DEFAULT_MARKDOWN_FIELD_NAME } from '../constants.js';
+import { isRouteDescendant, joinRouteSegments, normalizeRoutePath } from '../routing/index.js';
+import { getRelationshipId, isRecord, isVisibleDocsRecord, toResolvedDocsGroup, toResolvedDocsRecord, toResolvedDocsSet } from './records.js';
+import { getPayloadMarkdownDocsSidebar } from './sidebar.js';
+const resolveCollectionSlugs = (collections)=>({
+        docs: collections?.docs ?? DEFAULT_DOCS_COLLECTION_SLUG,
+        docsGroups: collections?.docsGroups ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,
+        docsSets: collections?.docsSets ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG
+    });
+export const getPayloadMarkdownDocsRoutePath = ({ slug, path })=>{
+    if (path !== undefined) {
+        return normalizeRoutePath(path);
+    }
+    if (Array.isArray(slug)) {
+        return slug.length === 0 ? '/' : joinRouteSegments(...slug);
+    }
+    if (typeof slug === 'string') {
+        return normalizeRoutePath(slug);
+    }
+    return '/';
+};
+const findDocsSetById = async ({ id, collections, overrideAccess, payload })=>{
+    const result = await payload.find({
+        collection: collections.docsSets,
+        depth: 0,
+        limit: 1,
+        overrideAccess,
+        where: {
+            id: {
+                equals: id
+            }
+        }
+    });
+    return toResolvedDocsSet(result.docs[0]);
+};
+const findDocsSetByRouteBase = async ({ collections, overrideAccess, payload, route })=>{
+    const result = await payload.find({
+        collection: collections.docsSets,
+        depth: 0,
+        limit: 1,
+        overrideAccess,
+        where: {
+            routeBase: {
+                equals: route
+            }
+        }
+    });
+    return result.docs.map(toResolvedDocsSet).find((docsSet)=>docsSet?.routeBase === route);
+};
+const findDocsSetByRoutePrefix = async ({ collections, overrideAccess, payload, route })=>{
+    const result = await payload.find({
+        collection: collections.docsSets,
+        depth: 0,
+        limit: 1000,
+        overrideAccess
+    });
+    return result.docs.map(toResolvedDocsSet).filter((docsSet)=>{
+        if (!docsSet) {
+            return false;
+        }
+        return docsSet.routeBase === route || isRouteDescendant(docsSet.routeBase, route);
+    }).sort((first, second)=>second.routeBase.length - first.routeBase.length)[0];
+};
+const getRelatedDocsSet = (doc)=>{
+    if (!isRecord(doc) || !isRecord(doc.docsSet)) {
+        return undefined;
+    }
+    return toResolvedDocsSet(doc.docsSet);
+};
+const findDocsSetForRecord = async ({ collections, doc, overrideAccess, payload, record })=>{
+    const relatedDocsSet = getRelatedDocsSet(doc);
+    if (relatedDocsSet) {
+        return relatedDocsSet;
+    }
+    if (record.docsSetId) {
+        const docsSetById = await findDocsSetById({
+            id: record.docsSetId,
+            collections,
+            overrideAccess,
+            payload
+        });
+        if (docsSetById) {
+            return docsSetById;
+        }
+    }
+    return findDocsSetByRoutePrefix({
+        collections,
+        overrideAccess,
+        payload,
+        route: record.route
+    });
+};
+const findDocsRecordByRoute = async ({ collections, includeDrafts, markdownField, overrideAccess, payload, route })=>{
+    const result = await payload.find({
+        collection: collections.docs,
+        depth: 1,
+        limit: 5,
+        overrideAccess,
+        where: {
+            route: {
+                equals: route
+            }
+        }
+    });
+    for (const doc of result.docs){
+        const record = toResolvedDocsRecord({
+            doc,
+            markdownField
+        });
+        if (record && record.route === route && isVisibleDocsRecord({
+            includeDrafts,
+            record
+        })) {
+            return {
+                doc,
+                record
+            };
+        }
+    }
+    return undefined;
+};
+const findDocsSetIndexRecord = async ({ collections, docsSet, includeDrafts, markdownField, overrideAccess, payload })=>{
+    const result = await findDocsRecordByRoute({
+        collections,
+        includeDrafts,
+        markdownField,
+        overrideAccess,
+        payload,
+        route: docsSet.routeBase
+    });
+    if (!result) {
+        return undefined;
+    }
+    if (result.record.docsSetId && result.record.docsSetId !== docsSet.id) {
+        return undefined;
+    }
+    if (isRecord(result.doc)) {
+        const relatedDocsSetId = getRelationshipId(result.doc.docsSet);
+        if (relatedDocsSetId && relatedDocsSetId !== docsSet.id) {
+            return undefined;
+        }
+    }
+    return result.record;
+};
+const findGroupIndexRoute = async ({ collections, overrideAccess, payload, route })=>{
+    const result = await payload.find({
+        collection: collections.docsGroups,
+        depth: 0,
+        limit: 5,
+        overrideAccess,
+        where: {
+            routePath: {
+                equals: route
+            }
+        }
+    });
+    const group = result.docs.map(toResolvedDocsGroup).find((candidate)=>candidate?.routePath === route && candidate.serveIndex);
+    if (!group) {
+        return undefined;
+    }
+    const docsSetsResult = await payload.find({
+        collection: collections.docsSets,
+        depth: 0,
+        limit: 1000,
+        overrideAccess,
+        where: {
+            group: {
+                equals: group.id
+            }
+        }
+    });
+    const docsSets = docsSetsResult.docs.map(toResolvedDocsSet).filter((docsSet)=>docsSet !== undefined).sort((first, second)=>{
+        if (first.order !== second.order) {
+            return first.order - second.order;
+        }
+        return first.routeBase.localeCompare(second.routeBase);
+    });
+    return {
+        type: 'docsGroupIndex',
+        docsSets,
+        group,
+        route
+    };
+};
+export const resolvePayloadMarkdownDocsRoute = async ({ slug, collections: collectionOptions, includeDrafts = false, markdownField = DEFAULT_MARKDOWN_FIELD_NAME, // Route adapter reads plugin-owned generated docs collections server-side.
+// Access is overridden here, then public visibility is enforced explicitly.
+overrideAccess = true, path, payload })=>{
+    const route = getPayloadMarkdownDocsRoutePath({
+        slug,
+        path
+    });
+    const collections = resolveCollectionSlugs(collectionOptions);
+    const docsSet = await findDocsSetByRouteBase({
+        collections,
+        overrideAccess,
+        payload,
+        route
+    });
+    if (docsSet) {
+        const [doc, sidebar] = await Promise.all([
+            findDocsSetIndexRecord({
+                collections,
+                docsSet,
+                includeDrafts,
+                markdownField,
+                overrideAccess,
+                payload
+            }),
+            getPayloadMarkdownDocsSidebar({
+                collections: collectionOptions,
+                docsSet,
+                includeDrafts,
+                markdownField,
+                overrideAccess,
+                payload
+            })
+        ]);
+        return {
+            ...doc ? {
+                doc
+            } : {},
+            type: 'docsSetIndex',
+            docsSet,
+            route,
+            sidebar
+        };
+    }
+    const docResult = await findDocsRecordByRoute({
+        collections,
+        includeDrafts,
+        markdownField,
+        overrideAccess,
+        payload,
+        route
+    });
+    if (docResult) {
+        const resolvedDocsSet = await findDocsSetForRecord({
+            collections,
+            doc: docResult.doc,
+            overrideAccess,
+            payload,
+            record: docResult.record
+        });
+        if (resolvedDocsSet) {
+            const sidebar = await getPayloadMarkdownDocsSidebar({
+                collections: collectionOptions,
+                docsSet: resolvedDocsSet,
+                includeDrafts,
+                markdownField,
+                overrideAccess,
+                payload
+            });
+            return {
+                type: 'doc',
+                doc: docResult.record,
+                docsSet: resolvedDocsSet,
+                route,
+                sidebar
+            };
+        }
+    }
+    const groupRoute = await findGroupIndexRoute({
+        collections,
+        overrideAccess,
+        payload,
+        route
+    });
+    return groupRoute ?? null;
+};
+
+//# sourceMappingURL=route.js.map

package/dist/next/route.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/route.ts"],"sourcesContent":["import type {\n  PayloadMarkdownDocsCollectionSlugs,\n  PayloadMarkdownDocsReadPayload,\n  ResolvedPayloadMarkdownDocsRecord,\n  ResolvedPayloadMarkdownDocsRoute,\n  ResolvedPayloadMarkdownDocsSet,\n  ResolvePayloadMarkdownDocsRouteOptions,\n} from './types.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n  DEFAULT_MARKDOWN_FIELD_NAME,\n} from '../constants.js'\nimport {\n  isRouteDescendant,\n  joinRouteSegments,\n  normalizeRoutePath,\n} from '../routing/index.js'\nimport {\n  getRelationshipId,\n  isRecord,\n  isVisibleDocsRecord,\n  toResolvedDocsGroup,\n  toResolvedDocsRecord,\n  toResolvedDocsSet,\n} from './records.js'\nimport { getPayloadMarkdownDocsSidebar } from './sidebar.js'\n\ntype ResolvedCollectionSlugs = {\n  docs: string\n  docsGroups: string\n  docsSets: string\n}\n\nconst resolveCollectionSlugs = (\n  collections?: PayloadMarkdownDocsCollectionSlugs,\n): ResolvedCollectionSlugs => ({\n  docs: collections?.docs ?? DEFAULT_DOCS_COLLECTION_SLUG,\n  docsGroups: collections?.docsGroups ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  docsSets: collections?.docsSets ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n})\n\nexport const getPayloadMarkdownDocsRoutePath = ({\n  slug,\n  path,\n}: {\n  path?: string\n  slug?: string | string[]\n}): string => {\n  if (path !== undefined) {\n    return normalizeRoutePath(path)\n  }\n\n  if (Array.isArray(slug)) {\n    return slug.length === 0 ? '/' : joinRouteSegments(...slug)\n  }\n\n  if (typeof slug === 'string') {\n    return normalizeRoutePath(slug)\n  }\n\n  return '/'\n}\n\nconst findDocsSetById = async ({\n  id,\n  collections,\n  overrideAccess,\n  payload,\n}: {\n  collections: ResolvedCollectionSlugs\n  id: string\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1,\n    overrideAccess,\n    where: {\n      id: {\n        equals: id,\n      },\n    },\n  })\n\n  return toResolvedDocsSet(result.docs[0])\n}\n\nconst findDocsSetByRouteBase = async ({\n  collections,\n  overrideAccess,\n  payload,\n  route,\n}: {\n  collections: ResolvedCollectionSlugs\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  route: string\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1,\n    overrideAccess,\n    where: {\n      routeBase: {\n        equals: route,\n      },\n    },\n  })\n\n  return result.docs\n    .map(toResolvedDocsSet)\n    .find((docsSet) => docsSet?.routeBase === route)\n}\n\nconst findDocsSetByRoutePrefix = async ({\n  collections,\n  overrideAccess,\n  payload,\n  route,\n}: {\n  collections: ResolvedCollectionSlugs\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  route: string\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n  })\n\n  return result.docs\n    .map(toResolvedDocsSet)\n    .filter((docsSet): docsSet is ResolvedPayloadMarkdownDocsSet => {\n      if (!docsSet) {\n        return false\n      }\n\n      return docsSet.routeBase === route || isRouteDescendant(docsSet.routeBase, route)\n    })\n    .sort((first, second) => second.routeBase.length - first.routeBase.length)[0]\n}\n\nconst getRelatedDocsSet = (doc: unknown): ResolvedPayloadMarkdownDocsSet | undefined => {\n  if (!isRecord(doc) || !isRecord(doc.docsSet)) {\n    return undefined\n  }\n\n  return toResolvedDocsSet(doc.docsSet)\n}\n\nconst findDocsSetForRecord = async ({\n  collections,\n  doc,\n  overrideAccess,\n  payload,\n  record,\n}: {\n  collections: ResolvedCollectionSlugs\n  doc: unknown\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  record: ResolvedPayloadMarkdownDocsRecord\n}): Promise<ResolvedPayloadMarkdownDocsSet | undefined> => {\n  const relatedDocsSet = getRelatedDocsSet(doc)\n\n  if (relatedDocsSet) {\n    return relatedDocsSet\n  }\n\n  if (record.docsSetId) {\n    const docsSetById = await findDocsSetById({\n      id: record.docsSetId,\n      collections,\n      overrideAccess,\n      payload,\n    })\n\n    if (docsSetById) {\n      return docsSetById\n    }\n  }\n\n  return findDocsSetByRoutePrefix({\n    collections,\n    overrideAccess,\n    payload,\n    route: record.route,\n  })\n}\n\nconst findDocsRecordByRoute = async ({\n  collections,\n  includeDrafts,\n  markdownField,\n  overrideAccess,\n  payload,\n  route,\n}: {\n  collections: ResolvedCollectionSlugs\n  includeDrafts: boolean\n  markdownField: string\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  route: string\n}): Promise<\n  | {\n      doc: unknown\n      record: ResolvedPayloadMarkdownDocsRecord\n    }\n  | undefined\n> => {\n  const result = await payload.find({\n    collection: collections.docs,\n    depth: 1,\n    limit: 5,\n    overrideAccess,\n    where: {\n      route: {\n        equals: route,\n      },\n    },\n  })\n\n  for (const doc of result.docs) {\n    const record = toResolvedDocsRecord({\n      doc,\n      markdownField,\n    })\n\n    if (\n      record &&\n      record.route === route &&\n      isVisibleDocsRecord({\n        includeDrafts,\n        record,\n      })\n    ) {\n      return {\n        doc,\n        record,\n      }\n    }\n  }\n\n  return undefined\n}\n\nconst findDocsSetIndexRecord = async ({\n  collections,\n  docsSet,\n  includeDrafts,\n  markdownField,\n  overrideAccess,\n  payload,\n}: {\n  collections: ResolvedCollectionSlugs\n  docsSet: ResolvedPayloadMarkdownDocsSet\n  includeDrafts: boolean\n  markdownField: string\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n}): Promise<ResolvedPayloadMarkdownDocsRecord | undefined> => {\n  const result = await findDocsRecordByRoute({\n    collections,\n    includeDrafts,\n    markdownField,\n    overrideAccess,\n    payload,\n    route: docsSet.routeBase,\n  })\n\n  if (!result) {\n    return undefined\n  }\n\n  if (result.record.docsSetId && result.record.docsSetId !== docsSet.id) {\n    return undefined\n  }\n\n  if (isRecord(result.doc)) {\n    const relatedDocsSetId = getRelationshipId(result.doc.docsSet)\n\n    if (relatedDocsSetId && relatedDocsSetId !== docsSet.id) {\n      return undefined\n    }\n  }\n\n  return result.record\n}\n\nconst findGroupIndexRoute = async ({\n  collections,\n  overrideAccess,\n  payload,\n  route,\n}: {\n  collections: ResolvedCollectionSlugs\n  overrideAccess: boolean\n  payload: PayloadMarkdownDocsReadPayload\n  route: string\n}): Promise<ResolvedPayloadMarkdownDocsRoute | undefined> => {\n  const result = await payload.find({\n    collection: collections.docsGroups,\n    depth: 0,\n    limit: 5,\n    overrideAccess,\n    where: {\n      routePath: {\n        equals: route,\n      },\n    },\n  })\n  const group = result.docs\n    .map(toResolvedDocsGroup)\n    .find((candidate) => candidate?.routePath === route && candidate.serveIndex)\n\n  if (!group) {\n    return undefined\n  }\n\n  const docsSetsResult = await payload.find({\n    collection: collections.docsSets,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n    where: {\n      group: {\n        equals: group.id,\n      },\n    },\n  })\n  const docsSets = docsSetsResult.docs\n    .map(toResolvedDocsSet)\n    .filter((docsSet): docsSet is ResolvedPayloadMarkdownDocsSet => docsSet !== undefined)\n    .sort((first, second) => {\n      if (first.order !== second.order) {\n        return first.order - second.order\n      }\n\n      return first.routeBase.localeCompare(second.routeBase)\n    })\n\n  return {\n    type: 'docsGroupIndex',\n    docsSets,\n    group,\n    route,\n  }\n}\n\nexport const resolvePayloadMarkdownDocsRoute = async ({\n  slug,\n  collections: collectionOptions,\n  includeDrafts = false,\n  markdownField = DEFAULT_MARKDOWN_FIELD_NAME,\n  // Route adapter reads plugin-owned generated docs collections server-side.\n  // Access is overridden here, then public visibility is enforced explicitly.\n  overrideAccess = true,\n  path,\n  payload,\n}: ResolvePayloadMarkdownDocsRouteOptions): Promise<null | ResolvedPayloadMarkdownDocsRoute> => {\n  const route = getPayloadMarkdownDocsRoutePath({\n    slug,\n    path,\n  })\n  const collections = resolveCollectionSlugs(collectionOptions)\n  const docsSet = await findDocsSetByRouteBase({\n    collections,\n    overrideAccess,\n    payload,\n    route,\n  })\n\n  if (docsSet) {\n    const [doc, sidebar] = await Promise.all([\n      findDocsSetIndexRecord({\n        collections,\n        docsSet,\n        includeDrafts,\n        markdownField,\n        overrideAccess,\n        payload,\n      }),\n      getPayloadMarkdownDocsSidebar({\n        collections: collectionOptions,\n        docsSet,\n        includeDrafts,\n        markdownField,\n        overrideAccess,\n        payload,\n      }),\n    ])\n\n    return {\n      ...(doc ? { doc } : {}),\n      type: 'docsSetIndex',\n      docsSet,\n      route,\n      sidebar,\n    }\n  }\n\n  const docResult = await findDocsRecordByRoute({\n    collections,\n    includeDrafts,\n    markdownField,\n    overrideAccess,\n    payload,\n    route,\n  })\n\n  if (docResult) {\n    const resolvedDocsSet = await findDocsSetForRecord({\n      collections,\n      doc: docResult.doc,\n      overrideAccess,\n      payload,\n      record: docResult.record,\n    })\n\n    if (resolvedDocsSet) {\n      const sidebar = await getPayloadMarkdownDocsSidebar({\n        collections: collectionOptions,\n        docsSet: resolvedDocsSet,\n        includeDrafts,\n        markdownField,\n        overrideAccess,\n        payload,\n      })\n\n      return {\n        type: 'doc',\n        doc: docResult.record,\n        docsSet: resolvedDocsSet,\n        route,\n        sidebar,\n      }\n    }\n  }\n\n  const groupRoute = await findGroupIndexRoute({\n    collections,\n    overrideAccess,\n    payload,\n    route,\n  })\n\n  return groupRoute ?? null\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_GROUPS_COLLECTION_SLUG","DEFAULT_DOCS_SETS_COLLECTION_SLUG","DEFAULT_MARKDOWN_FIELD_NAME","isRouteDescendant","joinRouteSegments","normalizeRoutePath","getRelationshipId","isRecord","isVisibleDocsRecord","toResolvedDocsGroup","toResolvedDocsRecord","toResolvedDocsSet","getPayloadMarkdownDocsSidebar","resolveCollectionSlugs","collections","docs","docsGroups","docsSets","getPayloadMarkdownDocsRoutePath","slug","path","undefined","Array","isArray","length","findDocsSetById","id","overrideAccess","payload","result","find","collection","depth","limit","where","equals","findDocsSetByRouteBase","route","routeBase","map","docsSet","findDocsSetByRoutePrefix","filter","sort","first","second","getRelatedDocsSet","doc","findDocsSetForRecord","record","relatedDocsSet","docsSetId","docsSetById","findDocsRecordByRoute","includeDrafts","markdownField","findDocsSetIndexRecord","relatedDocsSetId","findGroupIndexRoute","routePath","group","candidate","serveIndex","docsSetsResult","order","localeCompare","type","resolvePayloadMarkdownDocsRoute","collectionOptions","sidebar","Promise","all","docResult","resolvedDocsSet","groupRoute"],"mappings":"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"}

package/dist/next/sidebar.d.ts

@@ -0,0 +1,15 @@
+import type { PayloadMarkdownDocsCollectionSlugs, PayloadMarkdownDocsReadPayload, PayloadMarkdownDocsSidebarItem, ResolvedPayloadMarkdownDocsRecord, ResolvedPayloadMarkdownDocsSet } from './types.js';
+export type BuildPayloadMarkdownDocsSidebarOptions = {
+    docsSet?: ResolvedPayloadMarkdownDocsSet;
+    includeDrafts?: boolean;
+};
+export type GetPayloadMarkdownDocsSidebarOptions = {
+    collections?: PayloadMarkdownDocsCollectionSlugs;
+    docsSet: ResolvedPayloadMarkdownDocsSet;
+    includeDrafts?: boolean;
+    markdownField?: string;
+    overrideAccess?: boolean;
+    payload: PayloadMarkdownDocsReadPayload;
+};
+export declare const buildPayloadMarkdownDocsSidebar: (records: ResolvedPayloadMarkdownDocsRecord[], options?: BuildPayloadMarkdownDocsSidebarOptions) => PayloadMarkdownDocsSidebarItem[];
+export declare const getPayloadMarkdownDocsSidebar: ({ collections, docsSet, includeDrafts, markdownField, overrideAccess, payload, }: GetPayloadMarkdownDocsSidebarOptions) => Promise<PayloadMarkdownDocsSidebarItem[]>;