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

package/dist/admin/docsSetManagerData.js

@@ -0,0 +1,266 @@
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_SETS_COLLECTION_SLUG } from '../constants.js';
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+const getRecordId = (doc)=>{
+    if (!isRecord(doc)) {
+        return undefined;
+    }
+    if (typeof doc.id === 'string' || typeof doc.id === 'number') {
+        return String(doc.id);
+    }
+    return undefined;
+};
+const getRelationshipId = (value)=>{
+    if (typeof value === 'string' || typeof value === 'number') {
+        return String(value);
+    }
+    return getRecordId(value);
+};
+const normalizeAdminRoute = (adminRoute = '/admin')=>{
+    const trimmed = adminRoute.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/admin';
+    }
+    return `/${trimmed}`.replace(/\/+/g, '/').replace(/\/+$/g, '');
+};
+export const getGeneratedDocAdminURL = ({ id, adminRoute, docsCollectionSlug })=>`${normalizeAdminRoute(adminRoute)}/collections/${docsCollectionSlug}/${encodeURIComponent(id)}`;
+const hasText = (value)=>typeof value === 'string' && value.trim().length > 0;
+const getOverrideSummary = (overrides)=>{
+    if (!overrides || !isRecord(overrides)) {
+        return [];
+    }
+    const summary = [];
+    if (hasText(overrides.navTitle)) {
+        summary.push('Nav title override');
+    }
+    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)=>{
+    if (doc.sync?.archived === true) {
+        return 'archived';
+    }
+    if (doc._status === 'draft') {
+        return 'draft';
+    }
+    if (doc._status === 'published') {
+        return 'published';
+    }
+    return 'synced';
+};
+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 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) {
+        return first.order - second.order;
+    }
+    if (first.sourcePath !== second.sourcePath) {
+        return first.sourcePath.localeCompare(second.sourcePath);
+    }
+    return first.route.localeCompare(second.route);
+};
+const getOrCreateFolder = ({ items, order, segment, sourcePath })=>{
+    const existing = items.find((item)=>item.kind === 'folder' && item.sourcePath === sourcePath);
+    if (existing) {
+        existing.order = Math.min(existing.order, order);
+        return existing;
+    }
+    const folder = {
+        id: `folder:${sourcePath}`,
+        children: [],
+        kind: 'folder',
+        order,
+        overrideSummary: [],
+        route: '',
+        sourcePath,
+        status: 'synced',
+        title: titleCaseSegment(segment)
+    };
+    items.push(folder);
+    return folder;
+};
+const insertIntoTree = ({ item, tree })=>{
+    const segments = getSourcePathSegments(item.sourcePath);
+    if (segments.length <= 1) {
+        tree.push(item);
+        return;
+    }
+    let currentItems = tree;
+    for (const [index, segment] of segments.slice(0, -1).entries()){
+        const sourcePath = segments.slice(0, index + 1).join('/');
+        const folder = getOrCreateFolder({
+            items: currentItems,
+            order: item.order,
+            segment,
+            sourcePath
+        });
+        folder.children ??= [];
+        currentItems = folder.children;
+    }
+    currentItems.push(item);
+};
+const sortTree = (items)=>{
+    items.sort(compareDocItems);
+    for (const item of items){
+        if (item.children) {
+            sortTree(item.children);
+        }
+    }
+};
+const toDocItem = ({ adminRoute, doc, docsCollectionSlug, index, warnings })=>{
+    const id = getRecordId(doc) ?? `unknown-${index}`;
+    const route = hasText(doc.route) ? doc.route : '';
+    const sourcePath = hasText(doc.sourcePath) ? doc.sourcePath : `missing-source-path-${id}`;
+    const title = hasText(doc.title) ? doc.title : sourcePath;
+    const status = getDocStatus(doc);
+    const overrideSummary = getOverrideSummary(doc.overrides);
+    if (!hasText(doc.route)) {
+        warnings.push({
+            docId: id,
+            message: 'Generated doc is missing a route.',
+            sourcePath
+        });
+    }
+    if (!hasText(doc.sourcePath)) {
+        warnings.push({
+            docId: id,
+            message: 'Generated doc is missing a source path.'
+        });
+    }
+    if (!hasText(doc.title)) {
+        warnings.push({
+            docId: id,
+            message: 'Generated doc is missing a title.',
+            sourcePath
+        });
+    }
+    return {
+        id,
+        ...adminRoute ? {
+            adminURL: getGeneratedDocAdminURL({
+                id,
+                adminRoute,
+                docsCollectionSlug
+            })
+        } : {},
+        archived: status === 'archived',
+        draft: status === 'draft',
+        hiddenFromNav: doc.overrides?.hideFromNav === true,
+        kind: 'doc',
+        order: typeof doc.order === 'number' ? doc.order : 0,
+        overrideSummary,
+        published: status === 'published',
+        route,
+        sourcePath,
+        status,
+        title
+    };
+};
+export const buildDocsSetManagerData = ({ adminRoute, docs, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsSet })=>{
+    const warnings = [];
+    const docsSetId = getRecordId(docsSet) ?? 'unknown';
+    const sortedDocs = docs.map((doc, index)=>toDocItem({
+            adminRoute,
+            doc,
+            docsCollectionSlug,
+            index,
+            warnings
+        })).sort(compareDocItems);
+    const tree = [];
+    for (const item of sortedDocs){
+        insertIntoTree({
+            item,
+            tree
+        });
+    }
+    sortTree(tree);
+    return {
+        docs: sortedDocs,
+        docsSet: {
+            id: docsSetId,
+            routeBase: docsSet.routeBase ?? '',
+            sourceId: docsSet.sourceId ?? '',
+            title: docsSet.title ?? docsSetId
+        },
+        summary: {
+            archived: sortedDocs.filter((doc)=>doc.archived).length,
+            drafts: sortedDocs.filter((doc)=>doc.draft).length,
+            hiddenFromNav: sortedDocs.filter((doc)=>doc.hiddenFromNav).length,
+            published: sortedDocs.filter((doc)=>doc.published).length,
+            total: sortedDocs.length,
+            withOverrides: sortedDocs.filter((doc)=>doc.overrideSummary.length > 0).length
+        },
+        sync: docsSet.sync ? {
+            docsCount: typeof docsSet.sync.docsCount === 'number' ? docsSet.sync.docsCount : undefined,
+            lastStatus: docsSet.sync.lastStatus ?? undefined,
+            lastSyncedAt: docsSet.sync.lastSyncedAt ?? undefined
+        } : undefined,
+        tree,
+        warnings
+    };
+};
+export const isDocsRecordForDocsSet = ({ doc, docsSetId, sourceId })=>{
+    const docDocsSetId = getRelationshipId(doc.docsSet);
+    if (docDocsSetId) {
+        return docDocsSetId === docsSetId;
+    }
+    return doc.sync?.sourceId === sourceId;
+};
+export const getDocsSetManagerData = async ({ adminRoute, docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG, docsSetId, docsSetsCollectionSlug = DEFAULT_DOCS_SETS_COLLECTION_SLUG, overrideAccess = true, payload })=>{
+    const docsSet = await payload.findByID({
+        id: docsSetId,
+        collection: docsSetsCollectionSlug,
+        depth: 0,
+        overrideAccess
+    });
+    const docsResult = await payload.find({
+        collection: docsCollectionSlug,
+        depth: 0,
+        limit: 1000,
+        overrideAccess,
+        where: {
+            or: [
+                {
+                    docsSet: {
+                        equals: docsSetId
+                    }
+                },
+                {
+                    'sync.sourceId': {
+                        equals: docsSet.sourceId
+                    }
+                }
+            ]
+        }
+    });
+    const docs = docsResult.docs.filter(isRecord).map((doc)=>doc).filter((doc)=>isDocsRecordForDocsSet({
+            doc,
+            docsSetId,
+            sourceId: docsSet.sourceId ?? ''
+        }));
+    return buildDocsSetManagerData({
+        adminRoute,
+        docs,
+        docsCollectionSlug,
+        docsSet
+    });
+};
+
+//# sourceMappingURL=docsSetManagerData.js.map

package/dist/admin/docsSetManagerData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/docsSetManagerData.ts"],"sourcesContent":["import type {\n  DocsSetManagerData,\n  DocsSetManagerDocItem,\n  DocsSetManagerPayloadOperations,\n  DocsSetManagerWarning,\n  RawDocsRecord,\n  RawDocsSetRecord,\n} from './docsSetManagerTypes.js'\n\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n} from '../constants.js'\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst getRecordId = (doc: unknown): string | undefined => {\n  if (!isRecord(doc)) {\n    return undefined\n  }\n\n  if (typeof doc.id === 'string' || typeof doc.id === 'number') {\n    return String(doc.id)\n  }\n\n  return undefined\n}\n\nconst getRelationshipId = (value: unknown): string | undefined => {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return String(value)\n  }\n\n  return getRecordId(value)\n}\n\nconst normalizeAdminRoute = (adminRoute = '/admin'): string => {\n  const trimmed = adminRoute.trim()\n\n  if (!trimmed || trimmed === '/') {\n    return '/admin'\n  }\n\n  return `/${trimmed}`.replace(/\\/+/g, '/').replace(/\\/+$/g, '')\n}\n\nexport const getGeneratedDocAdminURL = ({\n  id,\n  adminRoute,\n  docsCollectionSlug,\n}: {\n  adminRoute?: string\n  docsCollectionSlug: string\n  id: string\n}): string =>\n  `${normalizeAdminRoute(adminRoute)}/collections/${docsCollectionSlug}/${encodeURIComponent(id)}`\n\nconst hasText = (value: null | string | undefined): value is string =>\n  typeof value === 'string' && value.trim().length > 0\n\nconst getOverrideSummary = (overrides: RawDocsRecord['overrides']): string[] => {\n  if (!overrides || !isRecord(overrides)) {\n    return []\n  }\n\n  const summary: string[] = []\n\n  if (hasText(overrides.navTitle)) {\n    summary.push('Nav title override')\n  }\n\n  if (overrides.hideFromNav === true) {\n    summary.push('Hidden from nav')\n  }\n\n  if (hasText(overrides.theme)) {\n    summary.push('Theme override')\n  }\n\n  if (\n    hasText(overrides.heroEyebrow) ||\n    hasText(overrides.heroTitle) ||\n    hasText(overrides.heroDescription)\n  ) {\n    summary.push('Hero override')\n  }\n\n  if (hasText(overrides.seoTitle) || hasText(overrides.seoDescription)) {\n    summary.push('SEO override')\n  }\n\n  return summary\n}\n\nconst getDocStatus = (\n  doc: RawDocsRecord,\n): DocsSetManagerDocItem['status'] => {\n  if (doc.sync?.archived === true) {\n    return 'archived'\n  }\n\n  if (doc._status === 'draft') {\n    return 'draft'\n  }\n\n  if (doc._status === 'published') {\n    return 'published'\n  }\n\n  return 'synced'\n}\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 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 compareDocItems = (\n  first: DocsSetManagerDocItem,\n  second: DocsSetManagerDocItem,\n): number => {\n  if (first.order !== second.order) {\n    return first.order - second.order\n  }\n\n  if (first.sourcePath !== second.sourcePath) {\n    return first.sourcePath.localeCompare(second.sourcePath)\n  }\n\n  return first.route.localeCompare(second.route)\n}\n\nconst getOrCreateFolder = ({\n  items,\n  order,\n  segment,\n  sourcePath,\n}: {\n  items: DocsSetManagerDocItem[]\n  order: number\n  segment: string\n  sourcePath: string\n}): DocsSetManagerDocItem => {\n  const existing = items.find(\n    (item) => item.kind === 'folder' && item.sourcePath === sourcePath,\n  )\n\n  if (existing) {\n    existing.order = Math.min(existing.order, order)\n    return existing\n  }\n\n  const folder: DocsSetManagerDocItem = {\n    id: `folder:${sourcePath}`,\n    children: [],\n    kind: 'folder',\n    order,\n    overrideSummary: [],\n    route: '',\n    sourcePath,\n    status: 'synced',\n    title: titleCaseSegment(segment),\n  }\n\n  items.push(folder)\n\n  return folder\n}\n\nconst insertIntoTree = ({\n  item,\n  tree,\n}: {\n  item: DocsSetManagerDocItem\n  tree: DocsSetManagerDocItem[]\n}) => {\n  const segments = getSourcePathSegments(item.sourcePath)\n\n  if (segments.length <= 1) {\n    tree.push(item)\n    return\n  }\n\n  let currentItems = tree\n\n  for (const [index, segment] of segments.slice(0, -1).entries()) {\n    const sourcePath = segments.slice(0, index + 1).join('/')\n    const folder = getOrCreateFolder({\n      items: currentItems,\n      order: item.order,\n      segment,\n      sourcePath,\n    })\n\n    folder.children ??= []\n    currentItems = folder.children\n  }\n\n  currentItems.push(item)\n}\n\nconst sortTree = (items: DocsSetManagerDocItem[]) => {\n  items.sort(compareDocItems)\n\n  for (const item of items) {\n    if (item.children) {\n      sortTree(item.children)\n    }\n  }\n}\n\nconst toDocItem = ({\n  adminRoute,\n  doc,\n  docsCollectionSlug,\n  index,\n  warnings,\n}: {\n  adminRoute?: string\n  doc: RawDocsRecord\n  docsCollectionSlug: string\n  index: number\n  warnings: DocsSetManagerWarning[]\n}): DocsSetManagerDocItem => {\n  const id = getRecordId(doc) ?? `unknown-${index}`\n  const route = hasText(doc.route) ? doc.route : ''\n  const sourcePath = hasText(doc.sourcePath)\n    ? doc.sourcePath\n    : `missing-source-path-${id}`\n  const title = hasText(doc.title) ? doc.title : sourcePath\n  const status = getDocStatus(doc)\n  const overrideSummary = getOverrideSummary(doc.overrides)\n\n  if (!hasText(doc.route)) {\n    warnings.push({\n      docId: id,\n      message: 'Generated doc is missing a route.',\n      sourcePath,\n    })\n  }\n\n  if (!hasText(doc.sourcePath)) {\n    warnings.push({\n      docId: id,\n      message: 'Generated doc is missing a source path.',\n    })\n  }\n\n  if (!hasText(doc.title)) {\n    warnings.push({\n      docId: id,\n      message: 'Generated doc is missing a title.',\n      sourcePath,\n    })\n  }\n\n  return {\n    id,\n    ...(adminRoute\n      ? {\n          adminURL: getGeneratedDocAdminURL({\n            id,\n            adminRoute,\n            docsCollectionSlug,\n          }),\n        }\n      : {}),\n    archived: status === 'archived',\n    draft: status === 'draft',\n    hiddenFromNav: doc.overrides?.hideFromNav === true,\n    kind: 'doc',\n    order: typeof doc.order === 'number' ? doc.order : 0,\n    overrideSummary,\n    published: status === 'published',\n    route,\n    sourcePath,\n    status,\n    title,\n  }\n}\n\nexport const buildDocsSetManagerData = ({\n  adminRoute,\n  docs,\n  docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG,\n  docsSet,\n}: {\n  adminRoute?: string\n  docs: RawDocsRecord[]\n  docsCollectionSlug?: string\n  docsSet: RawDocsSetRecord\n}): DocsSetManagerData => {\n  const warnings: DocsSetManagerWarning[] = []\n  const docsSetId = getRecordId(docsSet) ?? 'unknown'\n  const sortedDocs = docs\n    .map((doc, index) =>\n      toDocItem({\n        adminRoute,\n        doc,\n        docsCollectionSlug,\n        index,\n        warnings,\n      }),\n    )\n    .sort(compareDocItems)\n  const tree: DocsSetManagerDocItem[] = []\n\n  for (const item of sortedDocs) {\n    insertIntoTree({\n      item,\n      tree,\n    })\n  }\n\n  sortTree(tree)\n\n  return {\n    docs: sortedDocs,\n    docsSet: {\n      id: docsSetId,\n      routeBase: docsSet.routeBase ?? '',\n      sourceId: docsSet.sourceId ?? '',\n      title: docsSet.title ?? docsSetId,\n    },\n    summary: {\n      archived: sortedDocs.filter((doc) => doc.archived).length,\n      drafts: sortedDocs.filter((doc) => doc.draft).length,\n      hiddenFromNav: sortedDocs.filter((doc) => doc.hiddenFromNav).length,\n      published: sortedDocs.filter((doc) => doc.published).length,\n      total: sortedDocs.length,\n      withOverrides: sortedDocs.filter((doc) => doc.overrideSummary.length > 0)\n        .length,\n    },\n    sync: docsSet.sync\n      ? {\n          docsCount:\n            typeof docsSet.sync.docsCount === 'number'\n              ? docsSet.sync.docsCount\n              : undefined,\n          lastStatus: docsSet.sync.lastStatus ?? undefined,\n          lastSyncedAt: docsSet.sync.lastSyncedAt ?? undefined,\n        }\n      : undefined,\n    tree,\n    warnings,\n  }\n}\n\nexport const isDocsRecordForDocsSet = ({\n  doc,\n  docsSetId,\n  sourceId,\n}: {\n  doc: RawDocsRecord\n  docsSetId: string\n  sourceId: string\n}): boolean => {\n  const docDocsSetId = getRelationshipId(doc.docsSet)\n\n  if (docDocsSetId) {\n    return docDocsSetId === docsSetId\n  }\n\n  return doc.sync?.sourceId === sourceId\n}\n\nexport const getDocsSetManagerData = async ({\n  adminRoute,\n  docsCollectionSlug = DEFAULT_DOCS_COLLECTION_SLUG,\n  docsSetId,\n  docsSetsCollectionSlug = DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n  overrideAccess = true,\n  payload,\n}: {\n  adminRoute?: string\n  docsCollectionSlug?: string\n  docsSetId: string\n  docsSetsCollectionSlug?: string\n  overrideAccess?: boolean\n  payload: DocsSetManagerPayloadOperations\n}): Promise<DocsSetManagerData> => {\n  const docsSet = (await payload.findByID({\n    id: docsSetId,\n    collection: docsSetsCollectionSlug,\n    depth: 0,\n    overrideAccess,\n  })) as RawDocsSetRecord\n\n  const docsResult = await payload.find({\n    collection: docsCollectionSlug,\n    depth: 0,\n    limit: 1000,\n    overrideAccess,\n    where: {\n      or: [\n        {\n          docsSet: {\n            equals: docsSetId,\n          },\n        },\n        {\n          'sync.sourceId': {\n            equals: docsSet.sourceId,\n          },\n        },\n      ],\n    },\n  })\n  const docs = docsResult.docs\n    .filter(isRecord)\n    .map((doc) => doc as RawDocsRecord)\n    .filter((doc) =>\n      isDocsRecordForDocsSet({\n        doc,\n        docsSetId,\n        sourceId: docsSet.sourceId ?? '',\n      }),\n    )\n\n  return buildDocsSetManagerData({\n    adminRoute,\n    docs,\n    docsCollectionSlug,\n    docsSet,\n  })\n}\n"],"names":["DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_SETS_COLLECTION_SLUG","isRecord","value","Array","isArray","getRecordId","doc","undefined","id","String","getRelationshipId","normalizeAdminRoute","adminRoute","trimmed","trim","replace","getGeneratedDocAdminURL","docsCollectionSlug","encodeURIComponent","hasText","length","getOverrideSummary","overrides","summary","navTitle","push","hideFromNav","theme","heroEyebrow","heroTitle","heroDescription","seoTitle","seoDescription","getDocStatus","sync","archived","_status","getSourcePathSegments","sourcePath","withoutExtension","segments","split","filter","Boolean","at","slice","titleCaseSegment","segment","map","part","charAt","toUpperCase","join","compareDocItems","first","second","order","localeCompare","route","getOrCreateFolder","items","existing","find","item","kind","Math","min","folder","children","overrideSummary","status","title","insertIntoTree","tree","currentItems","index","entries","sortTree","sort","toDocItem","warnings","docId","message","adminURL","draft","hiddenFromNav","published","buildDocsSetManagerData","docs","docsSet","docsSetId","sortedDocs","routeBase","sourceId","drafts","total","withOverrides","docsCount","lastStatus","lastSyncedAt","isDocsRecordForDocsSet","docDocsSetId","getDocsSetManagerData","docsSetsCollectionSlug","overrideAccess","payload","findByID","collection","depth","docsResult","limit","where","or","equals"],"mappings":"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"}

package/dist/admin/docsSetManagerTypes.d.ts

@@ -0,0 +1,103 @@
+export type RawDocsSetRecord = {
+    id?: number | string;
+    routeBase?: string;
+    sourceId?: string;
+    sync?: {
+        docsCount?: null | number;
+        lastStatus?: 'failed' | 'pending' | 'success' | null;
+        lastSyncedAt?: null | string;
+    };
+    title?: string;
+};
+export type RawDocsRecord = {
+    _status?: 'draft' | 'published';
+    description?: null | string;
+    docsSet?: {
+        id?: number | string;
+    } | null | number | string;
+    id?: number | string;
+    navTitle?: null | string;
+    order?: null | number;
+    overrides?: {
+        heroDescription?: null | string;
+        heroEyebrow?: null | string;
+        heroTitle?: null | string;
+        hideFromNav?: boolean | null;
+        navTitle?: null | string;
+        seoDescription?: null | string;
+        seoTitle?: null | string;
+        theme?: null | string;
+    };
+    route?: null | string;
+    sourcePath?: null | string;
+    sync?: {
+        archived?: boolean | null;
+        archivedAt?: null | string;
+        lastSyncedAt?: null | string;
+        sourceId?: null | string;
+    };
+    title?: null | string;
+};
+export type DocsSetManagerWarning = {
+    docId?: string;
+    message: string;
+    sourcePath?: string;
+};
+export type DocsSetManagerDocStatus = 'archived' | 'draft' | 'published' | 'synced';
+export type DocsSetManagerDocItem = {
+    adminURL?: string;
+    archived?: boolean;
+    children?: DocsSetManagerDocItem[];
+    draft?: boolean;
+    hiddenFromNav?: boolean;
+    id: string;
+    kind: 'doc' | 'folder';
+    order: number;
+    overrideSummary: string[];
+    published?: boolean;
+    route: string;
+    sourcePath: string;
+    status: DocsSetManagerDocStatus;
+    title: string;
+};
+export type DocsSetManagerData = {
+    docs: DocsSetManagerDocItem[];
+    docsSet: {
+        id: string;
+        routeBase: string;
+        sourceId: string;
+        title: string;
+    };
+    summary: {
+        archived: number;
+        drafts: number;
+        hiddenFromNav: number;
+        published: number;
+        total: number;
+        withOverrides: number;
+    };
+    sync?: {
+        docsCount?: number;
+        lastStatus?: 'failed' | 'pending' | 'success';
+        lastSyncedAt?: string;
+    };
+    tree: DocsSetManagerDocItem[];
+    warnings: DocsSetManagerWarning[];
+};
+export type DocsSetManagerPayloadOperations = {
+    find: (args: {
+        collection: string;
+        depth?: number;
+        limit?: number;
+        overrideAccess?: boolean;
+        where?: unknown;
+    }) => Promise<{
+        docs: unknown[];
+    }>;
+    findByID: (args: {
+        collection: string;
+        depth?: number;
+        id: number | string;
+        overrideAccess?: boolean;
+    }) => Promise<unknown>;
+};

package/dist/admin/docsSetManagerTypes.js

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

package/dist/admin/docsSetManagerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/docsSetManagerTypes.ts"],"sourcesContent":["export type RawDocsSetRecord = {\n  id?: number | string\n  routeBase?: string\n  sourceId?: string\n  sync?: {\n    docsCount?: null | number\n    lastStatus?: 'failed' | 'pending' | 'success' | null\n    lastSyncedAt?: null | string\n  }\n  title?: string\n}\n\nexport type RawDocsRecord = {\n  _status?: 'draft' | 'published'\n  description?: null | string\n  docsSet?: { id?: number | string } | null | number | string\n  id?: number | string\n  navTitle?: null | string\n  order?: null | number\n  overrides?: {\n    heroDescription?: null | string\n    heroEyebrow?: null | string\n    heroTitle?: null | string\n    hideFromNav?: boolean | null\n    navTitle?: null | string\n    seoDescription?: null | string\n    seoTitle?: null | string\n    theme?: null | string\n  }\n  route?: null | string\n  sourcePath?: null | string\n  sync?: {\n    archived?: boolean | null\n    archivedAt?: null | string\n    lastSyncedAt?: null | string\n    sourceId?: null | string\n  }\n  title?: null | string\n}\n\nexport type DocsSetManagerWarning = {\n  docId?: string\n  message: string\n  sourcePath?: string\n}\n\nexport type DocsSetManagerDocStatus =\n  | 'archived'\n  | 'draft'\n  | 'published'\n  | 'synced'\n\nexport type DocsSetManagerDocItem = {\n  adminURL?: string\n  archived?: boolean\n  children?: DocsSetManagerDocItem[]\n  draft?: boolean\n  hiddenFromNav?: boolean\n  id: string\n  kind: 'doc' | 'folder'\n  order: number\n  overrideSummary: string[]\n  published?: boolean\n  route: string\n  sourcePath: string\n  status: DocsSetManagerDocStatus\n  title: string\n}\n\nexport type DocsSetManagerData = {\n  docs: DocsSetManagerDocItem[]\n  docsSet: {\n    id: string\n    routeBase: string\n    sourceId: string\n    title: string\n  }\n  summary: {\n    archived: number\n    drafts: number\n    hiddenFromNav: number\n    published: number\n    total: number\n    withOverrides: number\n  }\n  sync?: {\n    docsCount?: number\n    lastStatus?: 'failed' | 'pending' | 'success'\n    lastSyncedAt?: string\n  }\n  tree: DocsSetManagerDocItem[]\n  warnings: DocsSetManagerWarning[]\n}\n\nexport type DocsSetManagerPayloadOperations = {\n  find: (args: {\n    collection: string\n    depth?: number\n    limit?: number\n    overrideAccess?: boolean\n    where?: unknown\n  }) => Promise<{\n    docs: unknown[]\n  }>\n  findByID: (args: {\n    collection: string\n    depth?: number\n    id: number | string\n    overrideAccess?: boolean\n  }) => Promise<unknown>\n}\n"],"names":[],"mappings":"AA8FA,WAgBC"}

package/dist/admin/index.d.ts

@@ -0,0 +1,3 @@
+export { DocsSetManager } from './DocsSetManager.js';
+export { buildDocsSetManagerData, getDocsSetManagerData, getGeneratedDocAdminURL, isDocsRecordForDocsSet, } from './docsSetManagerData.js';
+export type { DocsSetManagerData, DocsSetManagerDocItem, DocsSetManagerDocStatus, DocsSetManagerPayloadOperations, DocsSetManagerWarning, RawDocsRecord, RawDocsSetRecord, } from './docsSetManagerTypes.js';

package/dist/admin/index.js

@@ -0,0 +1,4 @@
+export { DocsSetManager } from './DocsSetManager.js';
+export { buildDocsSetManagerData, getDocsSetManagerData, getGeneratedDocAdminURL, isDocsRecordForDocsSet } from './docsSetManagerData.js';
+
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/index.ts"],"sourcesContent":["export { DocsSetManager } from './DocsSetManager.js'\nexport {\n  buildDocsSetManagerData,\n  getDocsSetManagerData,\n  getGeneratedDocAdminURL,\n  isDocsRecordForDocsSet,\n} from './docsSetManagerData.js'\nexport type {\n  DocsSetManagerData,\n  DocsSetManagerDocItem,\n  DocsSetManagerDocStatus,\n  DocsSetManagerPayloadOperations,\n  DocsSetManagerWarning,\n  RawDocsRecord,\n  RawDocsSetRecord,\n} from './docsSetManagerTypes.js'\n"],"names":["DocsSetManager","buildDocsSetManagerData","getDocsSetManagerData","getGeneratedDocAdminURL","isDocsRecordForDocsSet"],"mappings":"AAAA,SAASA,cAAc,QAAQ,sBAAqB;AACpD,SACEC,uBAAuB,EACvBC,qBAAqB,EACrBC,uBAAuB,EACvBC,sBAAsB,QACjB,0BAAyB"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,2 @@
+import type { CliResult, ParsedCliArgs } from '../types.js';
+export declare const runInstallCommand: (args: ParsedCliArgs) => Promise<CliResult>;

package/dist/cli/commands/install.js

@@ -0,0 +1,211 @@
+import { access, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getFlagBoolean, getFlagString } from '../parseArgs.js';
+const packageManagers = new Set([
+    'bun',
+    'npm',
+    'pnpm',
+    'yarn'
+]);
+const supportedInstallTargets = new Set([
+    'ai-skill',
+    'skill'
+]);
+const defaultSkillOutputPath = '.agents/skills/payload-markdown-docs';
+const skillTemplateRoot = new URL('../../skills/codex/', import.meta.url);
+const fileExists = async (filePath)=>{
+    try {
+        await access(filePath);
+        return true;
+    } catch  {
+        return false;
+    }
+};
+const detectPackageManager = async (cwd = process.cwd())=>{
+    const lockfiles = [
+        [
+            'pnpm-lock.yaml',
+            'pnpm'
+        ],
+        [
+            'package-lock.json',
+            'npm'
+        ],
+        [
+            'yarn.lock',
+            'yarn'
+        ],
+        [
+            'bun.lockb',
+            'bun'
+        ]
+    ];
+    for (const [file, packageManager] of lockfiles){
+        if (await fileExists(path.join(cwd, file))) {
+            return packageManager;
+        }
+    }
+    return 'pnpm';
+};
+const readTemplateFiles = async (directoryUrl = skillTemplateRoot, basePath = '')=>{
+    const entries = await readdir(directoryUrl, {
+        withFileTypes: true
+    });
+    const files = [];
+    for (const entry of entries){
+        if (entry.isSymbolicLink()) {
+            continue;
+        }
+        const relativePath = path.posix.join(basePath, entry.name);
+        const entryUrl = new URL(`${entry.name}${entry.isDirectory() ? '/' : ''}`, directoryUrl);
+        if (entry.isDirectory()) {
+            files.push(...await readTemplateFiles(entryUrl, relativePath));
+            continue;
+        }
+        if (!entry.isFile()) {
+            continue;
+        }
+        files.push({
+            content: await readFile(entryUrl, 'utf8'),
+            relativePath
+        });
+    }
+    return files.sort((left, right)=>left.relativePath.localeCompare(right.relativePath));
+};
+const applyTemplateValues = ({ content, docsRoot, packageManager })=>content.replaceAll('{{docsRoot}}', docsRoot).replaceAll('{{packageManager}}', packageManager);
+const assertSafeRelativePath = (relativePath)=>{
+    const normalized = path.posix.normalize(relativePath);
+    if (normalized.startsWith('../') || normalized === '..' || path.isAbsolute(relativePath) || relativePath.includes('\\')) {
+        return {
+            exitCode: 1,
+            stderr: `Unsafe bundled skill path "${relativePath}".\n`
+        };
+    }
+    return undefined;
+};
+const createPlannedFiles = async ({ docsRoot, outDir, packageManager })=>{
+    const absoluteOutDir = path.resolve(outDir);
+    const templates = await readTemplateFiles();
+    const plannedFiles = [];
+    for (const template of templates){
+        const unsafe = assertSafeRelativePath(template.relativePath);
+        if (unsafe) {
+            return unsafe;
+        }
+        const outputPath = path.resolve(absoluteOutDir, template.relativePath);
+        if (outputPath !== absoluteOutDir && !outputPath.startsWith(`${absoluteOutDir}${path.sep}`)) {
+            return {
+                exitCode: 1,
+                stderr: `Refusing to write outside target directory: ${template.relativePath}\n`
+            };
+        }
+        plannedFiles.push({
+            content: applyTemplateValues({
+                content: template.content,
+                docsRoot,
+                packageManager
+            }),
+            path: outputPath,
+            relativePath: template.relativePath
+        });
+    }
+    return plannedFiles;
+};
+const getInstallSkillOptions = async (args)=>{
+    const [target] = args.positionals;
+    if (!target || !supportedInstallTargets.has(target)) {
+        return {
+            exitCode: 1,
+            stderr: 'Install requires target "skill" or "ai-skill".\n'
+        };
+    }
+    const agentFlag = getFlagString(args, 'agent');
+    const codex = getFlagBoolean(args, 'codex');
+    if (agentFlag && agentFlag !== 'codex') {
+        return {
+            exitCode: 1,
+            stderr: '--agent currently supports only "codex".\n'
+        };
+    }
+    if (!codex && agentFlag !== 'codex') {
+        return {
+            exitCode: 1,
+            stderr: 'Install skill requires --codex or --agent codex.\n'
+        };
+    }
+    const packageManagerFlag = getFlagString(args, 'package-manager');
+    if (packageManagerFlag !== undefined && !packageManagers.has(packageManagerFlag)) {
+        return {
+            exitCode: 1,
+            stderr: '--package-manager must be pnpm, npm, yarn, or bun.\n'
+        };
+    }
+    return {
+        agent: 'codex',
+        docsRoot: getFlagString(args, 'docs-root') ?? './docs',
+        dryRun: getFlagBoolean(args, 'dry-run'),
+        force: getFlagBoolean(args, 'force'),
+        outDir: getFlagString(args, 'out') ?? defaultSkillOutputPath,
+        packageManager: packageManagerFlag ?? await detectPackageManager()
+    };
+};
+const formatPlannedFiles = ({ dryRun, files, outDir })=>{
+    const lines = [
+        dryRun ? 'payload-markdown-docs install skill dry-run' : 'payload-markdown-docs install skill',
+        '',
+        `Target: ${path.resolve(outDir)}`,
+        'Files:',
+        ...files.map((file)=>`- ${file.relativePath}`)
+    ];
+    return `${lines.join('\n')}\n`;
+};
+export const runInstallCommand = async (args)=>{
+    const options = await getInstallSkillOptions(args);
+    if ('exitCode' in options) {
+        return options;
+    }
+    const plannedFiles = await createPlannedFiles(options);
+    if ('exitCode' in plannedFiles) {
+        return plannedFiles;
+    }
+    if (!options.force) {
+        const existingFiles = [];
+        for (const file of plannedFiles){
+            if (await fileExists(file.path)) {
+                existingFiles.push(file.relativePath);
+            }
+        }
+        if (existingFiles.length > 0) {
+            return {
+                exitCode: 1,
+                stderr: `Skill files already exist. Use --force to overwrite:\n${existingFiles.map((file)=>`- ${file}`).join('\n')}\n`
+            };
+        }
+    }
+    if (options.dryRun) {
+        return {
+            exitCode: 0,
+            stdout: formatPlannedFiles({
+                dryRun: true,
+                files: plannedFiles,
+                outDir: options.outDir
+            })
+        };
+    }
+    for (const file of plannedFiles){
+        await mkdir(path.dirname(file.path), {
+            recursive: true
+        });
+        await writeFile(file.path, file.content, 'utf8');
+    }
+    return {
+        exitCode: 0,
+        stdout: formatPlannedFiles({
+            dryRun: false,
+            files: plannedFiles,
+            outDir: options.outDir
+        })
+    };
+};
+
+//# sourceMappingURL=install.js.map