@valkyrianlabs/payload-markdown-docs 0.3.1 → 0.4.1

package/README.md

@@ -3,42 +3,24 @@
 Git-backed Markdown documentation sync for Payload CMS, powered by
 `@valkyrianlabs/payload-markdown`.
 
-This package has two sides:
+The default workflow is intentionally small:
 
-- The docs repo keeps Markdown files in source control and uses the CLI to
-  validate, plan, and push them.
-- The Payload server installs the plugin, verifies signed or GitHub OIDC
-  requests, and writes generated docs records into Payload-owned collections.
-
-The sync endpoint is not the human docs route. If your Payload site is deployed
-at `https://docs.valkyrianlabs.com`, the default sync endpoint is:
-
-```text
-https://docs.valkyrianlabs.com/api/payload-markdown-docs/sync
-```
-
-The human docs route is whatever docs set route base you configure, for example:
-
-```text
-https://docs.valkyrianlabs.com/plugins/payload-markdown-docs
-```
+1. Install the plugin in your Payload app.
+2. Create a docs set with a title and slug.
+3. Add a trusted GitHub owner once.
+4. Push Markdown from GitHub Actions.
+5. Render generated docs in your Next route.
 
 ## Install
 
-Install this package in the Payload app that will receive and render docs:
-
 ```bash
 pnpm add @valkyrianlabs/payload-markdown-docs @valkyrianlabs/payload-markdown
 ```
 
-Install the same package in any repo whose CI will run the
+Install the same package in any repository that runs the
 `payload-markdown-docs` CLI.
 
-## 1. Configure The Payload Server
-
-Add the plugin to `payload.config.ts`. Keep source authorization in Payload
-Admin docs sets; the plugin config should define the endpoint, collections, and
-sync lifecycle behavior.
+## Configure Payload
 
 ```ts
 import { payloadMarkdownDocs } from '@valkyrianlabs/payload-markdown-docs'
@@ -47,74 +29,49 @@ import { buildConfig } from 'payload'
 export default buildConfig({
   plugins: [
     payloadMarkdownDocs({
-      enabled: true,
-
-      // Optional default OIDC audience. Repository/workflow/environment
-      // allowlists belong on the docs set in Payload Admin.
       auth: {
-        githubOidc: {
-          audience: 'payload-markdown-docs',
-        },
+        githubOidc: true,
       },
-
       target: {
-        type: 'docsCollection',
         enableDrafts: true,
       },
-
       sync: {
         allowWrites: true,
         allowPublish: true,
-        allowHardDelete: false,
-        defaultPublishMode: 'draft',
-        deleteBehavior: 'archive',
       },
     }),
   ],
 })
 ```
 
-What this does:
+This adds `Docs Globals` admin collections:
+
+- `Sets`: docs packages. The set `slug` is the sync source and OIDC audience.
+- `Groups`: optional route nesting. Routes are derived from group slugs.
+- `Keys`: global Ed25519 public keys for local or non-GitHub publishing.
+- `Trusted`: global GitHub owners trusted for OIDC publishing.
 
-- Adds docs groups, docs sets, generated docs, sync run, and nonce collections.
-- Registers the default Payload custom endpoint at
-  `/api/payload-markdown-docs/sync`.
-- Accepts Ed25519 signed requests or GitHub OIDC bearer requests on the same
-  endpoint when the matched docs set has those auth policies.
-- Uses docs sets in Payload Admin as the source allow-list. `sources` still
-  exists as a legacy fallback, but it is not the recommended path.
-- Allows sync writes and publish requests, while archiving removed docs instead
-  of hard-deleting them.
+The sync endpoint is `/api/payload-markdown-docs/sync`.
 
-If you configure `allowedRefs` on a docs set, remember release workflows run on
-tag refs like `refs/tags/v0.1.0-canary.1`. The first pass uses exact string
-matches, not glob patterns. For release publishing, constrain by repository and
-workflow unless you want to list exact tag refs.
+## Create Admin Records
 
-## 2. Create The Docs Set
+Create a docs set:
 
-In Payload Admin, create a docs set with values that match the CLI and server
-config:
+- title: `Payload Markdown Docs`
+- slug: `payload-markdown-docs`
+- branch: `main`
+- optional group: for example `plugins`, which makes the route
+  `/plugins/payload-markdown-docs`
 
-- `sourceId`: `payload-markdown-docs`
-- `sourceRoot`: `docs`
-- `routeBase`: `/plugins/payload-markdown-docs`
-- `title`: Payload Markdown Docs
-- `auth.githubOidc.enabled`: checked
-- `auth.githubOidc.allowedRepositories`: `valkyrianlabs/payload-markdown-docs`
-- optionally restrict `auth.githubOidc.allowedWorkflows`,
-  `auth.githubOidc.allowedEnvironments`, or exact `auth.githubOidc.allowedRefs`
-- optionally add `auth.ed25519.keys` with `keyId` and `publicKey` for local
-  machines or non-GitHub CI
+Create a trusted GitHub owner:
 
-The CLI sends `source.id`. The server uses that id to find the docs set and
-decide where generated routes live and which credentials may update it. You can
-add a new docs source by creating a new docs set in Payload Admin; you should
-not need to redeploy the Payload app just to add another docs package.
+- owner: `valkyrianlabs`
+- `limitRepos`: off, unless you want to list specific repositories
 
-## 3. Render Docs In Next
+When `limitRepos` is off, any repository owned by that GitHub owner can publish
+to a matching docs set from the configured branch.
 
-The plugin writes docs records. Your Next route renders them.
+## Render In Next
 
 ```tsx
 import config from '@payload-config'
@@ -142,141 +99,92 @@ export default async function Page({
 }
 ```
 
-In a real app, fall back to your normal Pages lookup instead of calling
-`notFound()` immediately.
-
-## 4. Add Docs Source Files
-
-Keep docs in `docs/` and commit the AI Markdown Export manifest next to them.
-The manifest controls the generated raw Markdown export; it is not a human docs
-page and should not appear in human navigation.
-
-```text
-docs/
-  index.md
-  install.md
-  usage.md
-  index.ai.yml
-```
-
-Example `docs/index.ai.yml`:
-
-```yaml
-version: 1
-
-title: Payload Markdown Docs
-canonical: /plugins/payload-markdown-docs
-output: /plugins/payload-markdown-docs.md
+For header navigation, use the link helper:
 
-description: >
-  Consolidated AI-facing documentation export for Payload Markdown Docs.
-
-preamble: |
-  This file is intended for AI agents, editor tooling, Codex, ChatGPT,
-  and offline reference.
-
-order:
-  - ./index.md
-  - ./install.md
-  - ./usage.md
-
-exclude:
-  - ./drafts/**
+```ts
+import { getPayloadMarkdownDocsLinks } from '@valkyrianlabs/payload-markdown-docs/next'
 
-orphans: append
-headingMode: normalize
+const docsLinks = await getPayloadMarkdownDocsLinks({ payload })
+// [{ label: 'Payload Markdown Docs', url: '/plugins/payload-markdown-docs' }]
 ```
 
-## 5. Validate Locally
+## Validate Locally
 
-Validation does not contact the server:
+In an app or docs repository that has installed this package:
 
 ```bash
-pnpm exec payload-markdown-docs validate ./docs \
-  --source payload-markdown-docs \
-  --route-base /plugins/payload-markdown-docs
+pnpm exec payload-markdown-docs validate ./docs --source payload-markdown-docs
+pnpm exec payload-markdown-docs manifest ./docs --source payload-markdown-docs --pretty
+pnpm exec payload-markdown-docs plan ./docs --source payload-markdown-docs
 ```
 
-Preview the manifest or plan:
+From this package source checkout, use the local source CLI instead:
 
 ```bash
-pnpm exec payload-markdown-docs manifest ./docs \
-  --source payload-markdown-docs \
-  --route-base /plugins/payload-markdown-docs \
-  --pretty
-```
-
-```bash
-pnpm exec payload-markdown-docs plan ./docs \
-  --source payload-markdown-docs \
-  --route-base /plugins/payload-markdown-docs
+pnpm cli validate ./docs --source payload-markdown-docs
 ```
 
-## 6. Publish From GitHub Actions
+In GitHub Actions, `--source` can be omitted when the docs set slug matches the
+repository name. The CLI infers it from `GITHUB_REPOSITORY`.
 
-GitHub OIDC only works inside GitHub Actions. The workflow needs:
+## Publish From GitHub Actions
 
 ```yaml
 permissions:
   contents: read
   id-token: write
-```
-
-Then push docs to the Payload sync endpoint:
 
-```bash
-pnpm exec payload-markdown-docs push ./docs \
-  --endpoint "https://docs.valkyrianlabs.com/api/payload-markdown-docs/sync" \
-  --source payload-markdown-docs \
-  --route-base /plugins/payload-markdown-docs \
-  --repository "$GITHUB_REPOSITORY" \
-  --branch "$GITHUB_REF_NAME" \
-  --commit "$GITHUB_SHA" \
-  --github-oidc \
-  --oidc-audience payload-markdown-docs \
-  --sync \
-  --publish
+steps:
+  - uses: actions/checkout@v4
+  - uses: pnpm/action-setup@v4
+  - uses: actions/setup-node@v4
+    with:
+      node-version: 22
+      cache: pnpm
+  - run: pnpm install --frozen-lockfile
+  - run: pnpm exec payload-markdown-docs validate ./docs
+  - run: |
+      pnpm exec payload-markdown-docs push ./docs \
+        --endpoint "$DOCS_SYNC_ENDPOINT" \
+        --repository "$GITHUB_REPOSITORY" \
+        --branch "$GITHUB_REF_NAME" \
+        --commit "$GITHUB_SHA" \
+        --github-oidc \
+        --sync \
+        --publish
 ```
 
-`--sync` only works when the server has `sync.allowWrites: true`.
-`--publish` also requires `sync.allowPublish: true` and
-`target.enableDrafts: true`.
+`--sync` requires `sync.allowWrites: true`. `--publish` also requires
+`sync.allowPublish: true` and a draft-enabled generated docs collection.
 
-For non-GitHub CI, use Ed25519 keys instead of OIDC:
+## Local Ed25519 Push
+
+Generate a keypair, add the public key to `Docs Globals > Keys`, then push with
+the private key:
 
 ```bash
 pnpm exec payload-markdown-docs keygen --out .docs-sync
 pnpm exec payload-markdown-docs push ./docs \
   --endpoint "$DOCS_SYNC_ENDPOINT" \
   --source payload-markdown-docs \
-  --key-id github-actions-main \
-  --private-key-env DOCS_SYNC_PRIVATE_KEY \
-  --sync \
-  --publish
+  --key-id local-docs \
+  --private-key-file .docs-sync/docs-sync-private.pem \
+  --sync
 ```
 
-## This Repo
-
-This repo's release workflow publishes the npm package first, then pushes
-`./docs` to:
-
-```text
-https://docs.valkyrianlabs.com/api/payload-markdown-docs/sync
-```
+## Advanced Security
 
-using:
+You do not need this for normal docs publishing.
 
-- source id: `payload-markdown-docs`
-- route base: `/plugins/payload-markdown-docs`
-- auth: GitHub OIDC configured on the matching docs set
-- mode: sync and publish
+Each docs set has an advanced security section for exact GitHub workflow refs.
+Leave it disabled to allow any workflow from a trusted owner/repository on the
+configured branch. When enabled, add every allowed workflow ref explicitly; an
+empty list rejects all workflow publishing for that docs set.
 
 ## More Docs
 
-- [Installation](docs/getting-started/installation.md)
 - [Quick Start](docs/getting-started/quick-start.md)
 - [Plugin Config](docs/configuration/plugin-config.md)
-- [GitHub OIDC](docs/configuration/github-oidc.md)
 - [GitHub Actions](docs/workflow/ci-github-actions.md)
-- [Route Adapter](docs/frontend/route-adapter.md)
-- [Troubleshooting](docs/reference/troubleshooting.md)
+- [CLI](docs/reference/cli.md)
+- [Migration Notes](docs/reference/migration.md)

package/dist/admin/DocsSetManager.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG } from '../constants.js';
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_GROUPS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG } from '../constants.js';
 import { getDocsSetManagerData } from './docsSetManagerData.js';
 const getFieldCustom = (field)=>{
     const custom = 'custom' in field ? field.custom : undefined;
@@ -208,6 +208,7 @@ const Summary = ({ data })=>/*#__PURE__*/ _jsxs("dl", {
 export const DocsSetManager = async ({ id, field, payload, req })=>{
     const custom = getFieldCustom(field);
     const docsCollectionSlug = custom.docsCollectionSlug ?? DEFAULT_DOCS_COLLECTION_SLUG;
+    const docsGroupsCollectionSlug = custom.docsGroupsCollectionSlug ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG;
     const docsSetsCollectionSlug = custom.docsSetsCollectionSlug ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG;
     if (!id) {
         return /*#__PURE__*/ _jsxs("section", {
@@ -224,6 +225,7 @@ export const DocsSetManager = async ({ id, field, payload, req })=>{
     const data = await getDocsSetManagerData({
         adminRoute: req.payload.config.routes.admin,
         docsCollectionSlug,
+        docsGroupsCollectionSlug,
         docsSetId: String(id),
         docsSetsCollectionSlug,
         payload: payload
@@ -247,10 +249,10 @@ export const DocsSetManager = async ({ id, field, payload, req })=>{
             /*#__PURE__*/ _jsxs("section", {
                 children: [
                     /*#__PURE__*/ _jsx("h3", {
-                        children: "Route Base"
+                        children: "Effective Route"
                     }),
                     /*#__PURE__*/ _jsx("p", {
-                        children: data.docsSet.routeBase || 'No route base configured'
+                        children: data.docsSet.routeBase || 'No route available yet'
                     })
                 ]
             }),

package/dist/admin/DocsSetManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/admin/DocsSetManager.tsx"],"sourcesContent":["import type { UIFieldServerProps } from 'payload'\nimport type { ReactNode } from 'react'\n\nimport type {\n  DocsSetManagerData,\n  DocsSetManagerDocItem,\n  DocsSetManagerPayloadOperations,\n} from './docsSetManagerTypes.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n} from '../constants.js'\nimport { getDocsSetManagerData } from './docsSetManagerData.js'\n\ntype DocsSetManagerFieldCustom = {\n  docsCollectionSlug?: string\n  docsSetsCollectionSlug?: string\n}\n\nconst getFieldCustom = (\n  field: UIFieldServerProps['field'],\n): DocsSetManagerFieldCustom => {\n  const custom = 'custom' in field ? field.custom : undefined\n\n  if (!custom || typeof custom !== 'object') {\n    return {}\n  }\n\n  return custom as DocsSetManagerFieldCustom\n}\n\nconst formatDate = (value?: string): string => {\n  if (!value) {\n    return 'Never'\n  }\n\n  const date = new Date(value)\n\n  if (Number.isNaN(date.getTime())) {\n    return value\n  }\n\n  return date.toISOString()\n}\n\nconst StatusLabel = ({ item }: { item: DocsSetManagerDocItem }) => {\n  if (item.archived) {\n    return <span>archived</span>\n  }\n\n  if (item.draft) {\n    return <span>draft</span>\n  }\n\n  if (item.published) {\n    return <span>published</span>\n  }\n\n  return <span>synced</span>\n}\n\nconst OverrideSummary = ({ item }: { item: DocsSetManagerDocItem }) => {\n  if (item.overrideSummary.length === 0) {\n    return <span>none</span>\n  }\n\n  return <span>{item.overrideSummary.join(', ')}</span>\n}\n\nconst renderDocItem = (item: DocsSetManagerDocItem): ReactNode => {\n  if (item.kind === 'folder') {\n    return (\n      <details key={item.id}>\n        <summary>{item.title}</summary>\n        <div>\n          {item.children?.map((child) => renderDocItem(child))}\n        </div>\n      </details>\n    )\n  }\n\n  return (\n    <details key={item.id}>\n      <summary>{item.sourcePath}</summary>\n      <dl>\n        <div>\n          <dt>Route</dt>\n          <dd>{item.route || 'Missing route'}</dd>\n        </div>\n        <div>\n          <dt>Title</dt>\n          <dd>{item.title}</dd>\n        </div>\n        <div>\n          <dt>Status</dt>\n          <dd>\n            <StatusLabel item={item} />\n          </dd>\n        </div>\n        <div>\n          <dt>Overrides</dt>\n          <dd>\n            <OverrideSummary item={item} />\n          </dd>\n        </div>\n      </dl>\n      {item.adminURL ? <a href={item.adminURL}>Open generated doc</a> : null}\n    </details>\n  )\n}\n\nconst Summary = ({ data }: { data: DocsSetManagerData }) => (\n  <dl>\n    <div>\n      <dt>Docs</dt>\n      <dd>{data.summary.total}</dd>\n    </div>\n    <div>\n      <dt>Archived</dt>\n      <dd>{data.summary.archived}</dd>\n    </div>\n    <div>\n      <dt>Drafts</dt>\n      <dd>{data.summary.drafts}</dd>\n    </div>\n    <div>\n      <dt>Published</dt>\n      <dd>{data.summary.published}</dd>\n    </div>\n    <div>\n      <dt>Hidden from nav</dt>\n      <dd>{data.summary.hiddenFromNav}</dd>\n    </div>\n    <div>\n      <dt>With overrides</dt>\n      <dd>{data.summary.withOverrides}</dd>\n    </div>\n    <div>\n      <dt>Last sync</dt>\n      <dd>{formatDate(data.sync?.lastSyncedAt)}</dd>\n    </div>\n    <div>\n      <dt>Last status</dt>\n      <dd>{data.sync?.lastStatus ?? 'unknown'}</dd>\n    </div>\n  </dl>\n)\n\nexport const DocsSetManager = async ({\n  id,\n  field,\n  payload,\n  req,\n}: UIFieldServerProps) => {\n  const custom = getFieldCustom(field)\n  const docsCollectionSlug = custom.docsCollectionSlug ?? DEFAULT_DOCS_COLLECTION_SLUG\n  const docsSetsCollectionSlug =\n    custom.docsSetsCollectionSlug ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG\n\n  if (!id) {\n    return (\n      <section>\n        <h2>Generated Docs</h2>\n        <p>Save this docs set before reviewing generated docs records.</p>\n      </section>\n    )\n  }\n\n  const data = await getDocsSetManagerData({\n    adminRoute: req.payload.config.routes.admin,\n    docsCollectionSlug,\n    docsSetId: String(id),\n    docsSetsCollectionSlug,\n    payload: payload as DocsSetManagerPayloadOperations,\n  })\n\n  return (\n    <section>\n      <header>\n        <h2>Generated Docs</h2>\n        <p>\n          Review generated docs records for {data.docsSet.title}. Source docs remain\n          Git-backed; per-doc overrides can be edited by opening a generated doc.\n        </p>\n      </header>\n\n      <section>\n        <h3>Route Base</h3>\n        <p>{data.docsSet.routeBase || 'No route base configured'}</p>\n      </section>\n\n      <section>\n        <h3>Sync Summary</h3>\n        <Summary data={data} />\n      </section>\n\n      {data.warnings.length > 0 ? (\n        <section>\n          <h3>Warnings</h3>\n          <ul>\n            {data.warnings.map((warning) => (\n              <li key={`${warning.docId ?? 'docs-set'}:${warning.message}`}>\n                {warning.sourcePath ? `${warning.sourcePath}: ` : null}\n                {warning.message}\n              </li>\n            ))}\n          </ul>\n        </section>\n      ) : null}\n\n      <section>\n        <h3>Generated Docs</h3>\n        {data.tree.length > 0 ? (\n          <div>{data.tree.map((item) => renderDocItem(item))}</div>\n        ) : (\n          <p>No generated docs records are linked to this docs set yet.</p>\n        )}\n      </section>\n    </section>\n  )\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_SETS_COLLECTION_SLUG","getDocsSetManagerData","getFieldCustom","field","custom","undefined","formatDate","value","date","Date","Number","isNaN","getTime","toISOString","StatusLabel","item","archived","span","draft","published","OverrideSummary","overrideSummary","length","join","renderDocItem","kind","details","summary","title","div","children","map","child","id","sourcePath","dl","dt","dd","route","adminURL","a","href","Summary","data","total","drafts","hiddenFromNav","withOverrides","sync","lastSyncedAt","lastStatus","DocsSetManager","payload","req","docsCollectionSlug","docsSetsCollectionSlug","section","h2","p","adminRoute","config","routes","admin","docsSetId","String","header","docsSet","h3","routeBase","warnings","ul","warning","li","message","docId","tree"],"mappings":"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"}
+{"version":3,"sources":["../../src/admin/DocsSetManager.tsx"],"sourcesContent":["import type { UIFieldServerProps } from 'payload'\nimport type { ReactNode } from 'react'\n\nimport type {\n  DocsSetManagerData,\n  DocsSetManagerDocItem,\n  DocsSetManagerPayloadOperations,\n} from './docsSetManagerTypes.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n} from '../constants.js'\nimport { getDocsSetManagerData } from './docsSetManagerData.js'\n\ntype DocsSetManagerFieldCustom = {\n  docsCollectionSlug?: string\n  docsGroupsCollectionSlug?: string\n  docsSetsCollectionSlug?: string\n}\n\nconst getFieldCustom = (\n  field: UIFieldServerProps['field'],\n): DocsSetManagerFieldCustom => {\n  const custom = 'custom' in field ? field.custom : undefined\n\n  if (!custom || typeof custom !== 'object') {\n    return {}\n  }\n\n  return custom as DocsSetManagerFieldCustom\n}\n\nconst formatDate = (value?: string): string => {\n  if (!value) {\n    return 'Never'\n  }\n\n  const date = new Date(value)\n\n  if (Number.isNaN(date.getTime())) {\n    return value\n  }\n\n  return date.toISOString()\n}\n\nconst StatusLabel = ({ item }: { item: DocsSetManagerDocItem }) => {\n  if (item.archived) {\n    return <span>archived</span>\n  }\n\n  if (item.draft) {\n    return <span>draft</span>\n  }\n\n  if (item.published) {\n    return <span>published</span>\n  }\n\n  return <span>synced</span>\n}\n\nconst OverrideSummary = ({ item }: { item: DocsSetManagerDocItem }) => {\n  if (item.overrideSummary.length === 0) {\n    return <span>none</span>\n  }\n\n  return <span>{item.overrideSummary.join(', ')}</span>\n}\n\nconst renderDocItem = (item: DocsSetManagerDocItem): ReactNode => {\n  if (item.kind === 'folder') {\n    return (\n      <details key={item.id}>\n        <summary>{item.title}</summary>\n        <div>\n          {item.children?.map((child) => renderDocItem(child))}\n        </div>\n      </details>\n    )\n  }\n\n  return (\n    <details key={item.id}>\n      <summary>{item.sourcePath}</summary>\n      <dl>\n        <div>\n          <dt>Route</dt>\n          <dd>{item.route || 'Missing route'}</dd>\n        </div>\n        <div>\n          <dt>Title</dt>\n          <dd>{item.title}</dd>\n        </div>\n        <div>\n          <dt>Status</dt>\n          <dd>\n            <StatusLabel item={item} />\n          </dd>\n        </div>\n        <div>\n          <dt>Overrides</dt>\n          <dd>\n            <OverrideSummary item={item} />\n          </dd>\n        </div>\n      </dl>\n      {item.adminURL ? <a href={item.adminURL}>Open generated doc</a> : null}\n    </details>\n  )\n}\n\nconst Summary = ({ data }: { data: DocsSetManagerData }) => (\n  <dl>\n    <div>\n      <dt>Docs</dt>\n      <dd>{data.summary.total}</dd>\n    </div>\n    <div>\n      <dt>Archived</dt>\n      <dd>{data.summary.archived}</dd>\n    </div>\n    <div>\n      <dt>Drafts</dt>\n      <dd>{data.summary.drafts}</dd>\n    </div>\n    <div>\n      <dt>Published</dt>\n      <dd>{data.summary.published}</dd>\n    </div>\n    <div>\n      <dt>Hidden from nav</dt>\n      <dd>{data.summary.hiddenFromNav}</dd>\n    </div>\n    <div>\n      <dt>With overrides</dt>\n      <dd>{data.summary.withOverrides}</dd>\n    </div>\n    <div>\n      <dt>Last sync</dt>\n      <dd>{formatDate(data.sync?.lastSyncedAt)}</dd>\n    </div>\n    <div>\n      <dt>Last status</dt>\n      <dd>{data.sync?.lastStatus ?? 'unknown'}</dd>\n    </div>\n  </dl>\n)\n\nexport const DocsSetManager = async ({\n  id,\n  field,\n  payload,\n  req,\n}: UIFieldServerProps) => {\n  const custom = getFieldCustom(field)\n  const docsCollectionSlug = custom.docsCollectionSlug ?? DEFAULT_DOCS_COLLECTION_SLUG\n  const docsGroupsCollectionSlug =\n    custom.docsGroupsCollectionSlug ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG\n  const docsSetsCollectionSlug =\n    custom.docsSetsCollectionSlug ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG\n\n  if (!id) {\n    return (\n      <section>\n        <h2>Generated Docs</h2>\n        <p>Save this docs set before reviewing generated docs records.</p>\n      </section>\n    )\n  }\n\n  const data = await getDocsSetManagerData({\n    adminRoute: req.payload.config.routes.admin,\n    docsCollectionSlug,\n    docsGroupsCollectionSlug,\n    docsSetId: String(id),\n    docsSetsCollectionSlug,\n    payload: payload as DocsSetManagerPayloadOperations,\n  })\n\n  return (\n    <section>\n      <header>\n        <h2>Generated Docs</h2>\n        <p>\n          Review generated docs records for {data.docsSet.title}. Source docs remain\n          Git-backed; per-doc overrides can be edited by opening a generated doc.\n        </p>\n      </header>\n\n      <section>\n        <h3>Effective Route</h3>\n        <p>{data.docsSet.routeBase || 'No route available yet'}</p>\n      </section>\n\n      <section>\n        <h3>Sync Summary</h3>\n        <Summary data={data} />\n      </section>\n\n      {data.warnings.length > 0 ? (\n        <section>\n          <h3>Warnings</h3>\n          <ul>\n            {data.warnings.map((warning) => (\n              <li key={`${warning.docId ?? 'docs-set'}:${warning.message}`}>\n                {warning.sourcePath ? `${warning.sourcePath}: ` : null}\n                {warning.message}\n              </li>\n            ))}\n          </ul>\n        </section>\n      ) : null}\n\n      <section>\n        <h3>Generated Docs</h3>\n        {data.tree.length > 0 ? (\n          <div>{data.tree.map((item) => renderDocItem(item))}</div>\n        ) : (\n          <p>No generated docs records are linked to this docs set yet.</p>\n        )}\n      </section>\n    </section>\n  )\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_GROUPS_COLLECTION_SLUG","DEFAULT_DOCS_SETS_COLLECTION_SLUG","getDocsSetManagerData","getFieldCustom","field","custom","undefined","formatDate","value","date","Date","Number","isNaN","getTime","toISOString","StatusLabel","item","archived","span","draft","published","OverrideSummary","overrideSummary","length","join","renderDocItem","kind","details","summary","title","div","children","map","child","id","sourcePath","dl","dt","dd","route","adminURL","a","href","Summary","data","total","drafts","hiddenFromNav","withOverrides","sync","lastSyncedAt","lastStatus","DocsSetManager","payload","req","docsCollectionSlug","docsGroupsCollectionSlug","docsSetsCollectionSlug","section","h2","p","adminRoute","config","routes","admin","docsSetId","String","header","docsSet","h3","routeBase","warnings","ul","warning","li","message","docId","tree"],"mappings":"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"}

package/dist/admin/docsSetManagerData.d.ts

@@ -1,23 +1,24 @@
-import type { DocsSetManagerData, DocsSetManagerPayloadOperations, RawDocsRecord, RawDocsSetRecord } from './docsSetManagerTypes.js';
+import type { DocsSetManagerData, DocsSetManagerPayloadOperations, RawDocsGroupRecord, RawDocsRecord, RawDocsSetRecord } from './docsSetManagerTypes.js';
 export declare const getGeneratedDocAdminURL: ({ id, adminRoute, docsCollectionSlug, }: {
     adminRoute?: string;
     docsCollectionSlug: string;
     id: string;
 }) => string;
-export declare const buildDocsSetManagerData: ({ adminRoute, docs, docsCollectionSlug, docsSet, }: {
+export declare const buildDocsSetManagerData: ({ adminRoute, docs, docsCollectionSlug, docsGroups, docsSet, }: {
     adminRoute?: string;
     docs: RawDocsRecord[];
     docsCollectionSlug?: string;
+    docsGroups?: RawDocsGroupRecord[];
     docsSet: RawDocsSetRecord;
 }) => DocsSetManagerData;
-export declare const isDocsRecordForDocsSet: ({ doc, docsSetId, sourceId, }: {
+export declare const isDocsRecordForDocsSet: ({ doc, docsSetId, }: {
     doc: RawDocsRecord;
     docsSetId: string;
-    sourceId: string;
 }) => boolean;
-export declare const getDocsSetManagerData: ({ adminRoute, docsCollectionSlug, docsSetId, docsSetsCollectionSlug, overrideAccess, payload, }: {
+export declare const getDocsSetManagerData: ({ adminRoute, docsCollectionSlug, docsGroupsCollectionSlug, docsSetId, docsSetsCollectionSlug, overrideAccess, payload, }: {
     adminRoute?: string;
     docsCollectionSlug?: string;
+    docsGroupsCollectionSlug?: string;
     docsSetId: string;
     docsSetsCollectionSlug?: string;
     overrideAccess?: boolean;

package/dist/admin/docsSetManagerData.js

@@ -1,4 +1,5 @@
-import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG } from '../constants.js';
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_GROUPS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG } from '../constants.js';
+import { deriveDocsSetRouteBase, joinRouteSegments } from '../routing/index.js';
 const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
 const getRecordId = (doc)=>{
     if (!isRecord(doc)) {
@@ -35,15 +36,6 @@ const getOverrideSummary = (overrides)=>{
     if (overrides.hideFromNav === true) {
         summary.push('Hidden from nav');
     }
-    if (hasText(overrides.theme)) {
-        summary.push('Theme override');
-    }
-    if (hasText(overrides.heroEyebrow) || hasText(overrides.heroTitle) || hasText(overrides.heroDescription)) {
-        summary.push('Hero override');
-    }
-    if (hasText(overrides.seoTitle) || hasText(overrides.seoDescription)) {
-        summary.push('SEO override');
-    }
     return summary;
 };
 const getDocStatus = (doc)=>{
@@ -66,6 +58,44 @@ const getSourcePathSegments = (sourcePath)=>{
     }
     return segments;
 };
+const getGroupRoutePath = ({ groupId, groupsById, seen = new Set() })=>{
+    if (!groupId || seen.has(groupId)) {
+        return undefined;
+    }
+    const group = groupsById.get(groupId);
+    if (!group?.slug) {
+        return undefined;
+    }
+    return joinRouteSegments(getGroupRoutePath({
+        groupId: getRelationshipId(group.parent),
+        groupsById,
+        seen: new Set([
+            groupId,
+            ...seen
+        ])
+    }), group.slug);
+};
+const getDocsSetRouteBase = ({ docsGroups, docsSet })=>{
+    if (!docsSet.slug) {
+        return '';
+    }
+    const groupsById = new Map(docsGroups.flatMap((group)=>{
+        const id = getRecordId(group);
+        return id ? [
+            [
+                id,
+                group
+            ]
+        ] : [];
+    }));
+    return deriveDocsSetRouteBase({
+        docsSetSlug: docsSet.slug,
+        groupRoutePath: getGroupRoutePath({
+            groupId: getRelationshipId(docsSet.group),
+            groupsById
+        })
+    });
+};
 const titleCaseSegment = (segment)=>segment.split(/[-_]+/).filter(Boolean).map((part)=>`${part.charAt(0).toUpperCase()}${part.slice(1)}`).join(' ');
 const compareDocItems = (first, second)=>{
     if (first.order !== second.order) {
@@ -173,7 +203,7 @@ const toDocItem = ({ adminRoute, doc, docsCollectionSlug, index, warnings })=>{
         title
     };
 };
-export const buildDocsSetManagerData = ({ adminRoute, docs, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsSet })=>{
+export const buildDocsSetManagerData = ({ adminRoute, docs, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsGroups = [], docsSet })=>{
     const warnings = [];
     const docsSetId = getRecordId(docsSet) ?? 'unknown';
     const sortedDocs = docs.map((doc, index)=>toDocItem({
@@ -195,8 +225,11 @@ export const buildDocsSetManagerData = ({ adminRoute, docs, docsCollectionSlug =
         docs: sortedDocs,
         docsSet: {
             id: docsSetId,
-            routeBase: docsSet.routeBase ?? '',
-            sourceId: docsSet.sourceId ?? '',
+            slug: docsSet.slug ?? '',
+            routeBase: getDocsSetRouteBase({
+                docsGroups,
+                docsSet
+            }),
             title: docsSet.title ?? docsSetId
         },
         summary: {
@@ -216,14 +249,11 @@ export const buildDocsSetManagerData = ({ adminRoute, docs, docsCollectionSlug =
         warnings
     };
 };
-export const isDocsRecordForDocsSet = ({ doc, docsSetId, sourceId })=>{
+export const isDocsRecordForDocsSet = ({ doc, docsSetId })=>{
     const docDocsSetId = getRelationshipId(doc.docsSet);
-    if (docDocsSetId) {
-        return docDocsSetId === docsSetId;
-    }
-    return doc.sync?.sourceId === sourceId;
+    return docDocsSetId === docsSetId;
 };
-export const getDocsSetManagerData = async ({ adminRoute, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsSetId, docsSetsCollectionSlug = DEFAULT_DOCS_SETS_COLLECTION_SLUG, overrideAccess = true, payload })=>{
+export const getDocsSetManagerData = async ({ adminRoute, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsGroupsCollectionSlug = DEFAULT_DOCS_GROUPS_COLLECTION_SLUG, docsSetId, docsSetsCollectionSlug = DEFAULT_DOCS_SETS_COLLECTION_SLUG, overrideAccess = true, payload })=>{
     const docsSet = await payload.findByID({
         id: docsSetId,
         collection: docsSetsCollectionSlug,
@@ -236,29 +266,26 @@ export const getDocsSetManagerData = async ({ adminRoute, docsCollectionSlug = D
         limit: 1000,
         overrideAccess,
         where: {
-            or: [
-                {
-                    docsSet: {
-                        equals: docsSetId
-                    }
-                },
-                {
-                    'sync.sourceId': {
-                        equals: docsSet.sourceId
-                    }
-                }
-            ]
+            docsSet: {
+                equals: docsSetId
+            }
         }
     });
+    const docsGroupsResult = await payload.find({
+        collection: docsGroupsCollectionSlug,
+        depth: 0,
+        limit: 1000,
+        overrideAccess
+    });
     const docs = docsResult.docs.filter(isRecord).map((doc)=>doc).filter((doc)=>isDocsRecordForDocsSet({
             doc,
-            docsSetId,
-            sourceId: docsSet.sourceId ?? ''
+            docsSetId
         }));
     return buildDocsSetManagerData({
         adminRoute,
         docs,
         docsCollectionSlug,
+        docsGroups: docsGroupsResult.docs.filter(isRecord).map((group)=>group),
         docsSet
     });
 };