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

package/dist/payload/syncRuns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/payload/syncRuns.ts"],"sourcesContent":["import type {\n  DocsDeleteBehavior,\n  DocsSyncMode,\n  DocsValidationIssue,\n} from '../sync/index.js'\n\nexport type SyncRunStatus = 'failed' | 'pending' | 'success'\n\nexport type SyncRunSummary = {\n  archive: number\n  create: number\n  delete: number\n  draft: number\n  unchanged: number\n  update: number\n  warnings: number\n}\n\nexport type PayloadRecordId = number | string\n\nexport type SyncRunsPayloadOperations = {\n  create: (args: {\n    collection: string\n    data: Record<string, unknown>\n    overrideAccess?: boolean\n  }) => Promise<Record<string, unknown>>\n  update?: (args: {\n    collection: string\n    data: Record<string, unknown>\n    id: PayloadRecordId\n    overrideAccess?: boolean\n  }) => Promise<Record<string, unknown>>\n}\n\nexport type CreateSyncRunAuditInput = {\n  actor?: string\n  bodyHash: string\n  branch?: string\n  collectionSlug: string\n  commit?: string\n  completedAt: Date\n  deleteBehavior: DocsDeleteBehavior\n  effectivePublishMode?: 'draft' | 'preserve' | 'published'\n  errors: DocsValidationIssue[]\n  fileCount: number\n  keyId: string\n  mode: DocsSyncMode\n  payload: SyncRunsPayloadOperations\n  publishRequested: boolean\n  repository?: string\n  sourceId: string\n  startedAt: Date\n  status: SyncRunStatus\n  summary: SyncRunSummary\n  totalBytes: number\n  warnings: DocsValidationIssue[]\n}\n\nconst issueToArrayRow = (issue: DocsValidationIssue): { message: string } => ({\n  message: issue.path ? `${issue.path}: ${issue.message}` : issue.message,\n})\n\nexport const createSyncRunAudit = async ({\n  actor,\n  bodyHash,\n  branch,\n  collectionSlug,\n  commit,\n  completedAt,\n  deleteBehavior,\n  effectivePublishMode,\n  errors,\n  fileCount,\n  keyId,\n  mode,\n  payload,\n  publishRequested,\n  repository,\n  sourceId,\n  startedAt,\n  status,\n  summary,\n  totalBytes,\n  warnings,\n}: CreateSyncRunAuditInput): Promise<Record<string, unknown>> =>\n  payload.create({\n    collection: collectionSlug,\n    data: {\n      actor,\n      bodyHash,\n      branch,\n      commit,\n      completedAt: completedAt.toISOString(),\n      deleteBehavior,\n      effectivePublishMode,\n      errors: errors.map(issueToArrayRow),\n      fileCount,\n      keyId,\n      mode,\n      publishRequested,\n      repository,\n      sourceId,\n      startedAt: startedAt.toISOString(),\n      status,\n      summary,\n      totalBytes,\n      warnings: warnings.map(issueToArrayRow),\n    },\n    overrideAccess: true,\n  })\n\nexport const getRecordId = (\n  record: Record<string, unknown>,\n): PayloadRecordId | undefined => {\n  if (typeof record.id === 'string' || typeof record.id === 'number') {\n    return record.id\n  }\n\n  return undefined\n}\n\nexport const updateSyncRunAudit = async ({\n  collectionSlug,\n  completedAt,\n  errors,\n  payload,\n  status,\n  summary,\n  syncRunId,\n  warnings,\n}: {\n  collectionSlug: string\n  completedAt: Date\n  errors?: DocsValidationIssue[]\n  payload: SyncRunsPayloadOperations\n  status: SyncRunStatus\n  summary?: SyncRunSummary\n  syncRunId: PayloadRecordId\n  warnings?: DocsValidationIssue[]\n}): Promise<Record<string, unknown> | undefined> => {\n  if (!payload.update) {\n    return undefined\n  }\n\n  return payload.update({\n    id: syncRunId,\n    collection: collectionSlug,\n    data: {\n      completedAt: completedAt.toISOString(),\n      errors: errors?.map(issueToArrayRow),\n      status,\n      summary,\n      warnings: warnings?.map(issueToArrayRow),\n    },\n    overrideAccess: true,\n  })\n}\n"],"names":["issueToArrayRow","issue","message","path","createSyncRunAudit","actor","bodyHash","branch","collectionSlug","commit","completedAt","deleteBehavior","effectivePublishMode","errors","fileCount","keyId","mode","payload","publishRequested","repository","sourceId","startedAt","status","summary","totalBytes","warnings","create","collection","data","toISOString","map","overrideAccess","getRecordId","record","id","undefined","updateSyncRunAudit","syncRunId","update"],"mappings":"AA0DA,MAAMA,kBAAkB,CAACC,QAAqD,CAAA;QAC5EC,SAASD,MAAME,IAAI,GAAG,GAAGF,MAAME,IAAI,CAAC,EAAE,EAAEF,MAAMC,OAAO,EAAE,GAAGD,MAAMC,OAAO;IACzE,CAAA;AAEA,OAAO,MAAME,qBAAqB,OAAO,EACvCC,KAAK,EACLC,QAAQ,EACRC,MAAM,EACNC,cAAc,EACdC,MAAM,EACNC,WAAW,EACXC,cAAc,EACdC,oBAAoB,EACpBC,MAAM,EACNC,SAAS,EACTC,KAAK,EACLC,IAAI,EACJC,OAAO,EACPC,gBAAgB,EAChBC,UAAU,EACVC,QAAQ,EACRC,SAAS,EACTC,MAAM,EACNC,OAAO,EACPC,UAAU,EACVC,QAAQ,EACgB,GACxBR,QAAQS,MAAM,CAAC;QACbC,YAAYnB;QACZoB,MAAM;YACJvB;YACAC;YACAC;YACAE;YACAC,aAAaA,YAAYmB,WAAW;YACpClB;YACAC;YACAC,QAAQA,OAAOiB,GAAG,CAAC9B;YACnBc;YACAC;YACAC;YACAE;YACAC;YACAC;YACAC,WAAWA,UAAUQ,WAAW;YAChCP;YACAC;YACAC;YACAC,UAAUA,SAASK,GAAG,CAAC9B;QACzB;QACA+B,gBAAgB;IAClB,GAAE;AAEJ,OAAO,MAAMC,cAAc,CACzBC;IAEA,IAAI,OAAOA,OAAOC,EAAE,KAAK,YAAY,OAAOD,OAAOC,EAAE,KAAK,UAAU;QAClE,OAAOD,OAAOC,EAAE;IAClB;IAEA,OAAOC;AACT,EAAC;AAED,OAAO,MAAMC,qBAAqB,OAAO,EACvC5B,cAAc,EACdE,WAAW,EACXG,MAAM,EACNI,OAAO,EACPK,MAAM,EACNC,OAAO,EACPc,SAAS,EACTZ,QAAQ,EAUT;IACC,IAAI,CAACR,QAAQqB,MAAM,EAAE;QACnB,OAAOH;IACT;IAEA,OAAOlB,QAAQqB,MAAM,CAAC;QACpBJ,IAAIG;QACJV,YAAYnB;QACZoB,MAAM;YACJlB,aAAaA,YAAYmB,WAAW;YACpChB,QAAQA,QAAQiB,IAAI9B;YACpBsB;YACAC;YACAE,UAAUA,UAAUK,IAAI9B;QAC1B;QACA+B,gBAAgB;IAClB;AACF,EAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'payload';
+import type { PayloadMarkdownDocsConfig } from './types.js';
+export declare const payloadMarkdownDocs: (pluginOptions?: PayloadMarkdownDocsConfig) => Plugin;

package/dist/plugin.js

@@ -0,0 +1,165 @@
+import { createDocsCollection, createDocsGroupsCollection, createDocsSetsCollection, createNoncesCollection, createSyncRunsCollection } from './collections/index.js';
+import { DEFAULT_DOCS_COLLECTION_SLUG, DEFAULT_DOCS_GROUPS_COLLECTION_SLUG, DEFAULT_DOCS_ROUTE_BASE, DEFAULT_DOCS_SETS_COLLECTION_SLUG, DEFAULT_DOCS_SYNC_ENDPOINT_PATH, DEFAULT_DOCS_SYNC_NONCES_COLLECTION_SLUG, DEFAULT_DOCS_SYNC_RUNS_COLLECTION_SLUG, DEFAULT_MARKDOWN_FIELD_NAME, DEFAULT_MAX_BODY_BYTES, DEFAULT_PAGES_BRIDGE_FIELD, DEFAULT_PAGES_COLLECTION_SLUG, DEFAULT_PAGES_ROUTE_FIELD } from './constants.js';
+import { createSyncEndpoint } from './endpoints/index.js';
+const normalizeEndpointPath = (path)=>{
+    const normalized = `/${path.trim()}`.replace(/\/+/g, '/');
+    return normalized.length > 1 ? normalized.replace(/\/+$/g, '') : normalized;
+};
+const resolveCollectionOptions = (pluginOptions)=>{
+    if (pluginOptions.target?.type === 'existingCollection') {
+        throw new Error('payloadMarkdownDocs: target.type "existingCollection" is not supported yet. Use target.type "docsCollection".');
+    }
+    const docsSlugFromTarget = pluginOptions.target?.slug;
+    const docsSlugFromCollections = pluginOptions.collections?.docs?.slug;
+    if (docsSlugFromTarget && docsSlugFromCollections && docsSlugFromTarget !== docsSlugFromCollections) {
+        throw new Error('payloadMarkdownDocs: target.slug and collections.docs.slug must match when both are provided.');
+    }
+    return {
+        docsCollectionSlug: docsSlugFromTarget ?? docsSlugFromCollections ?? DEFAULT_DOCS_COLLECTION_SLUG,
+        docsEnabled: pluginOptions.collections?.docs?.enabled !== false,
+        docsGroupsCollectionSlug: pluginOptions.collections?.docsGroups?.slug ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,
+        docsGroupsEnabled: pluginOptions.collections?.docsGroups?.enabled !== false,
+        docsSetsCollectionSlug: pluginOptions.collections?.docsSets?.slug ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG,
+        docsSetsEnabled: pluginOptions.collections?.docsSets?.enabled !== false,
+        enableDrafts: pluginOptions.target?.type === 'docsCollection' ? pluginOptions.target.enableDrafts === true : false,
+        markdownFieldName: pluginOptions.target?.type === 'docsCollection' ? pluginOptions.target.markdownField ?? DEFAULT_MARKDOWN_FIELD_NAME : DEFAULT_MARKDOWN_FIELD_NAME,
+        noncesCollectionSlug: pluginOptions.collections?.nonces?.slug ?? DEFAULT_DOCS_SYNC_NONCES_COLLECTION_SLUG,
+        noncesEnabled: pluginOptions.collections?.nonces?.enabled !== false,
+        syncRunsCollectionSlug: pluginOptions.collections?.syncRuns?.slug ?? DEFAULT_DOCS_SYNC_RUNS_COLLECTION_SLUG,
+        syncRunsEnabled: pluginOptions.collections?.syncRuns?.enabled !== false
+    };
+};
+const assertCollectionOptionCompatibility = ({ docsGroupsEnabled, docsSetsEnabled })=>{
+    if (docsSetsEnabled && !docsGroupsEnabled) {
+        throw new Error('payloadMarkdownDocs: collections.docsSets requires collections.docsGroups to be enabled.');
+    }
+};
+const assertNoCollectionSlugConflicts = (incomingConfig, collectionSlugsToAdd)=>{
+    const duplicateRequestedSlug = collectionSlugsToAdd.find((slug, index)=>collectionSlugsToAdd.indexOf(slug) !== index);
+    if (duplicateRequestedSlug) {
+        throw new Error(`payloadMarkdownDocs: collection slug "${duplicateRequestedSlug}" is configured more than once.`);
+    }
+    const existingCollectionSlugs = new Set(incomingConfig.collections?.map((collection)=>collection.slug) ?? []);
+    const conflictingSlug = collectionSlugsToAdd.find((slug)=>existingCollectionSlugs.has(slug));
+    if (conflictingSlug) {
+        throw new Error(`payloadMarkdownDocs: collection slug "${conflictingSlug}" already exists in the Payload config.`);
+    }
+};
+export const payloadMarkdownDocs = (pluginOptions = {})=>(incomingConfig)=>{
+        if (pluginOptions.enabled === false) {
+            return incomingConfig;
+        }
+        const { docsCollectionSlug, docsEnabled, docsGroupsCollectionSlug, docsGroupsEnabled, docsSetsCollectionSlug, docsSetsEnabled, enableDrafts, markdownFieldName, noncesCollectionSlug, noncesEnabled, syncRunsCollectionSlug, syncRunsEnabled } = resolveCollectionOptions(pluginOptions);
+        assertCollectionOptionCompatibility({
+            docsCollectionSlug,
+            docsEnabled,
+            docsGroupsCollectionSlug,
+            docsGroupsEnabled,
+            docsSetsCollectionSlug,
+            docsSetsEnabled,
+            enableDrafts,
+            markdownFieldName,
+            noncesCollectionSlug,
+            noncesEnabled,
+            syncRunsCollectionSlug,
+            syncRunsEnabled
+        });
+        const endpointPath = normalizeEndpointPath(pluginOptions.endpoint?.path ?? DEFAULT_DOCS_SYNC_ENDPOINT_PATH);
+        const collectionSlugsToAdd = [
+            ...docsGroupsEnabled ? [
+                docsGroupsCollectionSlug
+            ] : [],
+            ...docsSetsEnabled ? [
+                docsSetsCollectionSlug
+            ] : [],
+            ...docsEnabled ? [
+                docsCollectionSlug
+            ] : [],
+            ...syncRunsEnabled ? [
+                syncRunsCollectionSlug
+            ] : [],
+            ...noncesEnabled ? [
+                noncesCollectionSlug
+            ] : []
+        ];
+        assertNoCollectionSlugConflicts(incomingConfig, collectionSlugsToAdd);
+        const addedCollections = [
+            ...docsGroupsEnabled ? [
+                createDocsGroupsCollection({
+                    slug: docsGroupsCollectionSlug
+                })
+            ] : [],
+            ...docsSetsEnabled ? [
+                createDocsSetsCollection({
+                    slug: docsSetsCollectionSlug,
+                    docsCollectionSlug: docsEnabled ? docsCollectionSlug : undefined,
+                    docsGroupsCollectionSlug,
+                    syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined
+                })
+            ] : [],
+            ...docsEnabled ? [
+                createDocsCollection({
+                    slug: docsCollectionSlug,
+                    docsSetsCollectionSlug: docsSetsEnabled ? docsSetsCollectionSlug : undefined,
+                    enableDrafts,
+                    markdownFieldName,
+                    syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined
+                })
+            ] : [],
+            ...syncRunsEnabled ? [
+                createSyncRunsCollection({
+                    slug: syncRunsCollectionSlug
+                })
+            ] : [],
+            ...noncesEnabled ? [
+                createNoncesCollection({
+                    slug: noncesCollectionSlug,
+                    syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined
+                })
+            ] : []
+        ];
+        return {
+            ...incomingConfig,
+            collections: [
+                ...incomingConfig.collections ?? [],
+                ...addedCollections
+            ],
+            endpoints: [
+                ...incomingConfig.endpoints ?? [],
+                createSyncEndpoint({
+                    allowHardDelete: pluginOptions.sync?.allowHardDelete,
+                    allowPublish: pluginOptions.sync?.allowPublish,
+                    allowWrites: pluginOptions.sync?.allowWrites,
+                    auth: pluginOptions.auth,
+                    defaultPublishMode: pluginOptions.sync?.defaultPublishMode,
+                    deleteBehavior: pluginOptions.sync?.deleteBehavior,
+                    docsCollectionSlug,
+                    docsEnabled,
+                    docsEnableDrafts: enableDrafts,
+                    docsSetsCollectionSlug,
+                    docsSetsEnabled,
+                    endpointPath,
+                    markdownFieldName,
+                    maxBodyBytes: pluginOptions.endpoint?.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+                    noncesCollectionSlug,
+                    noncesEnabled,
+                    requireDryRunBeforeApply: pluginOptions.sync?.requireDryRunBeforeApply,
+                    routeBase: DEFAULT_DOCS_ROUTE_BASE,
+                    routing: {
+                        pages: {
+                            allowBridgePages: pluginOptions.routing?.pages?.allowBridgePages ?? true,
+                            bridgeField: pluginOptions.routing?.pages?.bridgeField ?? DEFAULT_PAGES_BRIDGE_FIELD,
+                            collection: pluginOptions.routing?.pages?.collection ?? DEFAULT_PAGES_COLLECTION_SLUG,
+                            enabled: pluginOptions.routing?.pages?.enabled === true,
+                            routeField: pluginOptions.routing?.pages?.routeField ?? DEFAULT_PAGES_ROUTE_FIELD
+                        }
+                    },
+                    sources: pluginOptions.sources,
+                    syncRunsCollectionSlug,
+                    syncRunsEnabled
+                })
+            ]
+        };
+    };
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Config, Plugin } from 'payload'\n\nimport type { PayloadMarkdownDocsConfig } from './types.js'\n\nimport {\n  createDocsCollection,\n  createDocsGroupsCollection,\n  createDocsSetsCollection,\n  createNoncesCollection,\n  createSyncRunsCollection,\n} from './collections/index.js'\nimport {\n  DEFAULT_DOCS_COLLECTION_SLUG,\n  DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n  DEFAULT_DOCS_ROUTE_BASE,\n  DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n  DEFAULT_DOCS_SYNC_ENDPOINT_PATH,\n  DEFAULT_DOCS_SYNC_NONCES_COLLECTION_SLUG,\n  DEFAULT_DOCS_SYNC_RUNS_COLLECTION_SLUG,\n  DEFAULT_MARKDOWN_FIELD_NAME,\n  DEFAULT_MAX_BODY_BYTES,\n  DEFAULT_PAGES_BRIDGE_FIELD,\n  DEFAULT_PAGES_COLLECTION_SLUG,\n  DEFAULT_PAGES_ROUTE_FIELD,\n} from './constants.js'\nimport { createSyncEndpoint } from './endpoints/index.js'\n\ntype ResolvedCollectionOptions = {\n  docsCollectionSlug: string\n  docsEnabled: boolean\n  docsGroupsCollectionSlug: string\n  docsGroupsEnabled: boolean\n  docsSetsCollectionSlug: string\n  docsSetsEnabled: boolean\n  enableDrafts: boolean\n  markdownFieldName: string\n  noncesCollectionSlug: string\n  noncesEnabled: boolean\n  syncRunsCollectionSlug: string\n  syncRunsEnabled: boolean\n}\n\nconst normalizeEndpointPath = (path: string): string => {\n  const normalized = `/${path.trim()}`.replace(/\\/+/g, '/')\n\n  return normalized.length > 1 ? normalized.replace(/\\/+$/g, '') : normalized\n}\n\nconst resolveCollectionOptions = (\n  pluginOptions: PayloadMarkdownDocsConfig,\n): ResolvedCollectionOptions => {\n  if (pluginOptions.target?.type === 'existingCollection') {\n    throw new Error(\n      'payloadMarkdownDocs: target.type \"existingCollection\" is not supported yet. Use target.type \"docsCollection\".',\n    )\n  }\n\n  const docsSlugFromTarget = pluginOptions.target?.slug\n  const docsSlugFromCollections = pluginOptions.collections?.docs?.slug\n\n  if (\n    docsSlugFromTarget &&\n    docsSlugFromCollections &&\n    docsSlugFromTarget !== docsSlugFromCollections\n  ) {\n    throw new Error(\n      'payloadMarkdownDocs: target.slug and collections.docs.slug must match when both are provided.',\n    )\n  }\n\n  return {\n    docsCollectionSlug:\n      docsSlugFromTarget ?? docsSlugFromCollections ?? DEFAULT_DOCS_COLLECTION_SLUG,\n    docsEnabled: pluginOptions.collections?.docs?.enabled !== false,\n    docsGroupsCollectionSlug:\n      pluginOptions.collections?.docsGroups?.slug ?? DEFAULT_DOCS_GROUPS_COLLECTION_SLUG,\n    docsGroupsEnabled: pluginOptions.collections?.docsGroups?.enabled !== false,\n    docsSetsCollectionSlug:\n      pluginOptions.collections?.docsSets?.slug ?? DEFAULT_DOCS_SETS_COLLECTION_SLUG,\n    docsSetsEnabled: pluginOptions.collections?.docsSets?.enabled !== false,\n    enableDrafts:\n      pluginOptions.target?.type === 'docsCollection'\n        ? pluginOptions.target.enableDrafts === true\n        : false,\n    markdownFieldName:\n      pluginOptions.target?.type === 'docsCollection'\n        ? pluginOptions.target.markdownField ?? DEFAULT_MARKDOWN_FIELD_NAME\n        : DEFAULT_MARKDOWN_FIELD_NAME,\n    noncesCollectionSlug:\n      pluginOptions.collections?.nonces?.slug ?? DEFAULT_DOCS_SYNC_NONCES_COLLECTION_SLUG,\n    noncesEnabled: pluginOptions.collections?.nonces?.enabled !== false,\n    syncRunsCollectionSlug:\n      pluginOptions.collections?.syncRuns?.slug ?? DEFAULT_DOCS_SYNC_RUNS_COLLECTION_SLUG,\n    syncRunsEnabled: pluginOptions.collections?.syncRuns?.enabled !== false,\n  }\n}\n\nconst assertCollectionOptionCompatibility = ({\n  docsGroupsEnabled,\n  docsSetsEnabled,\n}: ResolvedCollectionOptions) => {\n  if (docsSetsEnabled && !docsGroupsEnabled) {\n    throw new Error(\n      'payloadMarkdownDocs: collections.docsSets requires collections.docsGroups to be enabled.',\n    )\n  }\n}\n\nconst assertNoCollectionSlugConflicts = (\n  incomingConfig: Config,\n  collectionSlugsToAdd: string[],\n) => {\n  const duplicateRequestedSlug = collectionSlugsToAdd.find(\n    (slug, index) => collectionSlugsToAdd.indexOf(slug) !== index,\n  )\n\n  if (duplicateRequestedSlug) {\n    throw new Error(\n      `payloadMarkdownDocs: collection slug \"${duplicateRequestedSlug}\" is configured more than once.`,\n    )\n  }\n\n  const existingCollectionSlugs = new Set(\n    incomingConfig.collections?.map((collection) => collection.slug) ?? [],\n  )\n\n  const conflictingSlug = collectionSlugsToAdd.find((slug) =>\n    existingCollectionSlugs.has(slug),\n  )\n\n  if (conflictingSlug) {\n    throw new Error(\n      `payloadMarkdownDocs: collection slug \"${conflictingSlug}\" already exists in the Payload config.`,\n    )\n  }\n}\n\nexport const payloadMarkdownDocs =\n  (pluginOptions: PayloadMarkdownDocsConfig = {}): Plugin =>\n  (incomingConfig: Config): Config => {\n    if (pluginOptions.enabled === false) {\n      return incomingConfig\n    }\n\n    const {\n      docsCollectionSlug,\n      docsEnabled,\n      docsGroupsCollectionSlug,\n      docsGroupsEnabled,\n      docsSetsCollectionSlug,\n      docsSetsEnabled,\n      enableDrafts,\n      markdownFieldName,\n      noncesCollectionSlug,\n      noncesEnabled,\n      syncRunsCollectionSlug,\n      syncRunsEnabled,\n    } = resolveCollectionOptions(pluginOptions)\n    assertCollectionOptionCompatibility({\n      docsCollectionSlug,\n      docsEnabled,\n      docsGroupsCollectionSlug,\n      docsGroupsEnabled,\n      docsSetsCollectionSlug,\n      docsSetsEnabled,\n      enableDrafts,\n      markdownFieldName,\n      noncesCollectionSlug,\n      noncesEnabled,\n      syncRunsCollectionSlug,\n      syncRunsEnabled,\n    })\n    const endpointPath = normalizeEndpointPath(\n      pluginOptions.endpoint?.path ?? DEFAULT_DOCS_SYNC_ENDPOINT_PATH,\n    )\n\n    const collectionSlugsToAdd = [\n      ...(docsGroupsEnabled ? [docsGroupsCollectionSlug] : []),\n      ...(docsSetsEnabled ? [docsSetsCollectionSlug] : []),\n      ...(docsEnabled ? [docsCollectionSlug] : []),\n      ...(syncRunsEnabled ? [syncRunsCollectionSlug] : []),\n      ...(noncesEnabled ? [noncesCollectionSlug] : []),\n    ]\n\n    assertNoCollectionSlugConflicts(incomingConfig, collectionSlugsToAdd)\n\n    const addedCollections = [\n      ...(docsGroupsEnabled\n        ? [\n            createDocsGroupsCollection({\n              slug: docsGroupsCollectionSlug,\n            }),\n          ]\n        : []),\n      ...(docsSetsEnabled\n        ? [\n            createDocsSetsCollection({\n              slug: docsSetsCollectionSlug,\n              docsCollectionSlug: docsEnabled ? docsCollectionSlug : undefined,\n              docsGroupsCollectionSlug,\n              syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined,\n            }),\n          ]\n        : []),\n      ...(docsEnabled\n        ? [\n            createDocsCollection({\n              slug: docsCollectionSlug,\n              docsSetsCollectionSlug: docsSetsEnabled\n                ? docsSetsCollectionSlug\n                : undefined,\n              enableDrafts,\n              markdownFieldName,\n              syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined,\n            }),\n          ]\n        : []),\n      ...(syncRunsEnabled\n        ? [\n            createSyncRunsCollection({\n              slug: syncRunsCollectionSlug,\n            }),\n          ]\n        : []),\n      ...(noncesEnabled\n        ? [\n            createNoncesCollection({\n              slug: noncesCollectionSlug,\n              syncRunsCollectionSlug: syncRunsEnabled ? syncRunsCollectionSlug : undefined,\n            }),\n          ]\n        : []),\n    ]\n\n    return {\n      ...incomingConfig,\n      collections: [...(incomingConfig.collections ?? []), ...addedCollections],\n      endpoints: [\n        ...(incomingConfig.endpoints ?? []),\n        createSyncEndpoint({\n          allowHardDelete: pluginOptions.sync?.allowHardDelete,\n          allowPublish: pluginOptions.sync?.allowPublish,\n          allowWrites: pluginOptions.sync?.allowWrites,\n          auth: pluginOptions.auth,\n          defaultPublishMode: pluginOptions.sync?.defaultPublishMode,\n          deleteBehavior: pluginOptions.sync?.deleteBehavior,\n          docsCollectionSlug,\n          docsEnabled,\n          docsEnableDrafts: enableDrafts,\n          docsSetsCollectionSlug,\n          docsSetsEnabled,\n          endpointPath,\n          markdownFieldName,\n          maxBodyBytes: pluginOptions.endpoint?.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,\n          noncesCollectionSlug,\n          noncesEnabled,\n          requireDryRunBeforeApply: pluginOptions.sync?.requireDryRunBeforeApply,\n          routeBase: DEFAULT_DOCS_ROUTE_BASE,\n          routing: {\n            pages: {\n              allowBridgePages:\n                pluginOptions.routing?.pages?.allowBridgePages ?? true,\n              bridgeField:\n                pluginOptions.routing?.pages?.bridgeField ?? DEFAULT_PAGES_BRIDGE_FIELD,\n              collection:\n                pluginOptions.routing?.pages?.collection ?? DEFAULT_PAGES_COLLECTION_SLUG,\n              enabled: pluginOptions.routing?.pages?.enabled === true,\n              routeField:\n                pluginOptions.routing?.pages?.routeField ?? DEFAULT_PAGES_ROUTE_FIELD,\n            },\n          },\n          sources: pluginOptions.sources,\n          syncRunsCollectionSlug,\n          syncRunsEnabled,\n        }),\n      ],\n    }\n  }\n"],"names":["createDocsCollection","createDocsGroupsCollection","createDocsSetsCollection","createNoncesCollection","createSyncRunsCollection","DEFAULT_DOCS_COLLECTION_SLUG","DEFAULT_DOCS_GROUPS_COLLECTION_SLUG","DEFAULT_DOCS_ROUTE_BASE","DEFAULT_DOCS_SETS_COLLECTION_SLUG","DEFAULT_DOCS_SYNC_ENDPOINT_PATH","DEFAULT_DOCS_SYNC_NONCES_COLLECTION_SLUG","DEFAULT_DOCS_SYNC_RUNS_COLLECTION_SLUG","DEFAULT_MARKDOWN_FIELD_NAME","DEFAULT_MAX_BODY_BYTES","DEFAULT_PAGES_BRIDGE_FIELD","DEFAULT_PAGES_COLLECTION_SLUG","DEFAULT_PAGES_ROUTE_FIELD","createSyncEndpoint","normalizeEndpointPath","path","normalized","trim","replace","length","resolveCollectionOptions","pluginOptions","target","type","Error","docsSlugFromTarget","slug","docsSlugFromCollections","collections","docs","docsCollectionSlug","docsEnabled","enabled","docsGroupsCollectionSlug","docsGroups","docsGroupsEnabled","docsSetsCollectionSlug","docsSets","docsSetsEnabled","enableDrafts","markdownFieldName","markdownField","noncesCollectionSlug","nonces","noncesEnabled","syncRunsCollectionSlug","syncRuns","syncRunsEnabled","assertCollectionOptionCompatibility","assertNoCollectionSlugConflicts","incomingConfig","collectionSlugsToAdd","duplicateRequestedSlug","find","index","indexOf","existingCollectionSlugs","Set","map","collection","conflictingSlug","has","payloadMarkdownDocs","endpointPath","endpoint","addedCollections","undefined","endpoints","allowHardDelete","sync","allowPublish","allowWrites","auth","defaultPublishMode","deleteBehavior","docsEnableDrafts","maxBodyBytes","requireDryRunBeforeApply","routeBase","routing","pages","allowBridgePages","bridgeField","routeField","sources"],"mappings":"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"}

package/dist/routing/index.d.ts

@@ -0,0 +1,3 @@
+export { deriveDocsSetRouteBase, isRouteDescendant, joinRouteSegments, normalizeRoutePath, } from './paths.js';
+export { createDocRouteReservations, createDocsGroupRouteReservation, createDocsSetRouteReservation, findPageRouteCollisions, findRouteReservationCollisions, } from './reservations.js';
+export type { DocsRouteCollision, DocsRouteCollisionReason, DocsRouteReservation, DocsRouteReservationOwnerType, } from './reservations.js';

package/dist/routing/index.js

@@ -0,0 +1,4 @@
+export { deriveDocsSetRouteBase, isRouteDescendant, joinRouteSegments, normalizeRoutePath } from './paths.js';
+export { createDocRouteReservations, createDocsGroupRouteReservation, createDocsSetRouteReservation, findPageRouteCollisions, findRouteReservationCollisions } from './reservations.js';
+
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/index.ts"],"sourcesContent":["export {\n  deriveDocsSetRouteBase,\n  isRouteDescendant,\n  joinRouteSegments,\n  normalizeRoutePath,\n} from './paths.js'\nexport {\n  createDocRouteReservations,\n  createDocsGroupRouteReservation,\n  createDocsSetRouteReservation,\n  findPageRouteCollisions,\n  findRouteReservationCollisions,\n} from './reservations.js'\nexport type {\n  DocsRouteCollision,\n  DocsRouteCollisionReason,\n  DocsRouteReservation,\n  DocsRouteReservationOwnerType,\n} from './reservations.js'\n"],"names":["deriveDocsSetRouteBase","isRouteDescendant","joinRouteSegments","normalizeRoutePath","createDocRouteReservations","createDocsGroupRouteReservation","createDocsSetRouteReservation","findPageRouteCollisions","findRouteReservationCollisions"],"mappings":"AAAA,SACEA,sBAAsB,EACtBC,iBAAiB,EACjBC,iBAAiB,EACjBC,kBAAkB,QACb,aAAY;AACnB,SACEC,0BAA0B,EAC1BC,+BAA+B,EAC/BC,6BAA6B,EAC7BC,uBAAuB,EACvBC,8BAA8B,QACzB,oBAAmB"}

package/dist/routing/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const normalizeRoutePath: (input: string) => string;
+export declare const joinRouteSegments: (...segments: (string | undefined)[]) => string;
+export declare const deriveDocsSetRouteBase: ({ docsSetSlug, groupRoutePath, }: {
+    docsSetSlug: string;
+    groupRoutePath?: string;
+}) => string;
+export declare const isRouteDescendant: (parent: string, child: string) => boolean;

package/dist/routing/paths.js

@@ -0,0 +1,23 @@
+export const normalizeRoutePath = (input)=>{
+    const trimmed = input.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/';
+    }
+    const normalized = `/${trimmed}`.replace(/\\/g, '/').replace(/\/+/g, '/').replace(/\/+$/g, '');
+    return normalized || '/';
+};
+export const joinRouteSegments = (...segments)=>{
+    const normalizedSegments = segments.flatMap((segment)=>(segment ?? '').split(/[\\/]+/)).map((segment)=>segment.trim()).filter(Boolean);
+    return normalizeRoutePath(normalizedSegments.join('/'));
+};
+export const deriveDocsSetRouteBase = ({ docsSetSlug, groupRoutePath })=>joinRouteSegments(groupRoutePath ?? '/', docsSetSlug);
+export const isRouteDescendant = (parent, child)=>{
+    const normalizedParent = normalizeRoutePath(parent);
+    const normalizedChild = normalizeRoutePath(child);
+    if (normalizedParent === '/') {
+        return normalizedChild !== '/';
+    }
+    return normalizedChild.startsWith(`${normalizedParent}/`);
+};
+
+//# sourceMappingURL=paths.js.map

package/dist/routing/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/paths.ts"],"sourcesContent":["export const normalizeRoutePath = (input: string): string => {\n  const trimmed = input.trim()\n\n  if (!trimmed || trimmed === '/') {\n    return '/'\n  }\n\n  const normalized = `/${trimmed}`\n    .replace(/\\\\/g, '/')\n    .replace(/\\/+/g, '/')\n    .replace(/\\/+$/g, '')\n\n  return normalized || '/'\n}\n\nexport const joinRouteSegments = (...segments: (string | undefined)[]): string => {\n  const normalizedSegments = segments\n    .flatMap((segment) => (segment ?? '').split(/[\\\\/]+/))\n    .map((segment) => segment.trim())\n    .filter(Boolean)\n\n  return normalizeRoutePath(normalizedSegments.join('/'))\n}\n\nexport const deriveDocsSetRouteBase = ({\n  docsSetSlug,\n  groupRoutePath,\n}: {\n  docsSetSlug: string\n  groupRoutePath?: string\n}): string => joinRouteSegments(groupRoutePath ?? '/', docsSetSlug)\n\nexport const isRouteDescendant = (parent: string, child: string): boolean => {\n  const normalizedParent = normalizeRoutePath(parent)\n  const normalizedChild = normalizeRoutePath(child)\n\n  if (normalizedParent === '/') {\n    return normalizedChild !== '/'\n  }\n\n  return normalizedChild.startsWith(`${normalizedParent}/`)\n}\n"],"names":["normalizeRoutePath","input","trimmed","trim","normalized","replace","joinRouteSegments","segments","normalizedSegments","flatMap","segment","split","map","filter","Boolean","join","deriveDocsSetRouteBase","docsSetSlug","groupRoutePath","isRouteDescendant","parent","child","normalizedParent","normalizedChild","startsWith"],"mappings":"AAAA,OAAO,MAAMA,qBAAqB,CAACC;IACjC,MAAMC,UAAUD,MAAME,IAAI;IAE1B,IAAI,CAACD,WAAWA,YAAY,KAAK;QAC/B,OAAO;IACT;IAEA,MAAME,aAAa,CAAC,CAAC,EAAEF,SAAS,CAC7BG,OAAO,CAAC,OAAO,KACfA,OAAO,CAAC,QAAQ,KAChBA,OAAO,CAAC,SAAS;IAEpB,OAAOD,cAAc;AACvB,EAAC;AAED,OAAO,MAAME,oBAAoB,CAAC,GAAGC;IACnC,MAAMC,qBAAqBD,SACxBE,OAAO,CAAC,CAACC,UAAY,AAACA,CAAAA,WAAW,EAAC,EAAGC,KAAK,CAAC,WAC3CC,GAAG,CAAC,CAACF,UAAYA,QAAQP,IAAI,IAC7BU,MAAM,CAACC;IAEV,OAAOd,mBAAmBQ,mBAAmBO,IAAI,CAAC;AACpD,EAAC;AAED,OAAO,MAAMC,yBAAyB,CAAC,EACrCC,WAAW,EACXC,cAAc,EAIf,GAAaZ,kBAAkBY,kBAAkB,KAAKD,aAAY;AAEnE,OAAO,MAAME,oBAAoB,CAACC,QAAgBC;IAChD,MAAMC,mBAAmBtB,mBAAmBoB;IAC5C,MAAMG,kBAAkBvB,mBAAmBqB;IAE3C,IAAIC,qBAAqB,KAAK;QAC5B,OAAOC,oBAAoB;IAC7B;IAEA,OAAOA,gBAAgBC,UAAU,CAAC,GAAGF,iBAAiB,CAAC,CAAC;AAC1D,EAAC"}

package/dist/routing/reservations.d.ts

@@ -0,0 +1,37 @@
+export type DocsRouteReservationOwnerType = 'doc' | 'docsGroup' | 'docsSet' | 'page';
+export type DocsRouteReservation = {
+    allowBridge?: boolean;
+    ownerId?: string;
+    ownerType: DocsRouteReservationOwnerType;
+    reservesDescendants?: boolean;
+    route: string;
+};
+export type DocsRouteCollisionReason = 'descendant_route_collision' | 'exact_route_collision';
+export type DocsRouteCollision = {
+    first: DocsRouteReservation;
+    reason: DocsRouteCollisionReason;
+    second: DocsRouteReservation;
+};
+export declare const findRouteReservationCollisions: (reservations: DocsRouteReservation[]) => DocsRouteCollision[];
+export declare const createDocRouteReservations: (docs: {
+    ownerId?: string;
+    route: string;
+}[]) => DocsRouteReservation[];
+export declare const createDocsSetRouteReservation: ({ ownerId, routeBase, }: {
+    ownerId?: string;
+    routeBase: string;
+}) => DocsRouteReservation;
+export declare const createDocsGroupRouteReservation: ({ ownerId, routePath, serveIndex, }: {
+    ownerId?: string;
+    routePath: string;
+    serveIndex?: boolean;
+}) => DocsRouteReservation;
+export declare const findPageRouteCollisions: ({ allowBridgePages, docsSetRouteBase, pages, }: {
+    allowBridgePages?: boolean;
+    docsSetRouteBase: string;
+    pages: {
+        bridge?: boolean;
+        id?: string;
+        route: string;
+    }[];
+}) => DocsRouteCollision[];

package/dist/routing/reservations.js

@@ -0,0 +1,79 @@
+import { isRouteDescendant, normalizeRoutePath } from './paths.js';
+const normalizeReservation = (reservation)=>({
+        ...reservation,
+        route: normalizeRoutePath(reservation.route)
+    });
+const sameOwner = (first, second)=>first.ownerType === second.ownerType && first.ownerId !== undefined && first.ownerId === second.ownerId;
+const isAllowedBridgeCollision = (first, second)=>{
+    if (first.route !== second.route) {
+        return false;
+    }
+    return first.ownerType === 'page' && first.allowBridge === true || second.ownerType === 'page' && second.allowBridge === true;
+};
+export const findRouteReservationCollisions = (reservations)=>{
+    const normalizedReservations = reservations.map(normalizeReservation);
+    const collisions = [];
+    for(let index = 0; index < normalizedReservations.length; index += 1){
+        for(let comparedIndex = index + 1; comparedIndex < normalizedReservations.length; comparedIndex += 1){
+            const first = normalizedReservations[index];
+            const second = normalizedReservations[comparedIndex];
+            if (!first || !second || sameOwner(first, second)) {
+                continue;
+            }
+            if (first.route === second.route) {
+                if (!isAllowedBridgeCollision(first, second)) {
+                    collisions.push({
+                        first,
+                        reason: 'exact_route_collision',
+                        second
+                    });
+                }
+                continue;
+            }
+            if (first.reservesDescendants && isRouteDescendant(first.route, second.route) || second.reservesDescendants && isRouteDescendant(second.route, first.route)) {
+                collisions.push({
+                    first,
+                    reason: 'descendant_route_collision',
+                    second
+                });
+            }
+        }
+    }
+    return collisions;
+};
+export const createDocRouteReservations = (docs)=>docs.map((doc)=>({
+            ownerId: doc.ownerId,
+            ownerType: 'doc',
+            route: doc.route
+        }));
+export const createDocsSetRouteReservation = ({ ownerId, routeBase })=>({
+        ownerId,
+        ownerType: 'docsSet',
+        reservesDescendants: true,
+        route: routeBase
+    });
+export const createDocsGroupRouteReservation = ({ ownerId, routePath, serveIndex })=>({
+        ownerId,
+        ownerType: 'docsGroup',
+        reservesDescendants: false,
+        route: routePath,
+        ...serveIndex ? {} : {
+            allowBridge: true
+        }
+    });
+export const findPageRouteCollisions = ({ allowBridgePages = true, docsSetRouteBase, pages })=>{
+    const reservations = [
+        createDocsSetRouteReservation({
+            routeBase: docsSetRouteBase
+        }),
+        ...pages.map((page)=>({
+                allowBridge: allowBridgePages && page.bridge === true,
+                ownerId: page.id,
+                ownerType: 'page',
+                route: page.route
+            }))
+    ];
+    return findRouteReservationCollisions(reservations).filter((collision)=>collision.first.ownerType === 'page' || collision.second.ownerType === 'page');
+};
+
+//# sourceMappingURL=reservations.js.map

package/dist/routing/reservations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/reservations.ts"],"sourcesContent":["import { isRouteDescendant, normalizeRoutePath } from './paths.js'\n\nexport type DocsRouteReservationOwnerType = 'doc' | 'docsGroup' | 'docsSet' | 'page'\n\nexport type DocsRouteReservation = {\n  allowBridge?: boolean\n  ownerId?: string\n  ownerType: DocsRouteReservationOwnerType\n  reservesDescendants?: boolean\n  route: string\n}\n\nexport type DocsRouteCollisionReason =\n  | 'descendant_route_collision'\n  | 'exact_route_collision'\n\nexport type DocsRouteCollision = {\n  first: DocsRouteReservation\n  reason: DocsRouteCollisionReason\n  second: DocsRouteReservation\n}\n\nconst normalizeReservation = (\n  reservation: DocsRouteReservation,\n): DocsRouteReservation => ({\n  ...reservation,\n  route: normalizeRoutePath(reservation.route),\n})\n\nconst sameOwner = (\n  first: DocsRouteReservation,\n  second: DocsRouteReservation,\n): boolean =>\n  first.ownerType === second.ownerType &&\n  first.ownerId !== undefined &&\n  first.ownerId === second.ownerId\n\nconst isAllowedBridgeCollision = (\n  first: DocsRouteReservation,\n  second: DocsRouteReservation,\n): boolean => {\n  if (first.route !== second.route) {\n    return false\n  }\n\n  return (\n    (first.ownerType === 'page' && first.allowBridge === true) ||\n    (second.ownerType === 'page' && second.allowBridge === true)\n  )\n}\n\nexport const findRouteReservationCollisions = (\n  reservations: DocsRouteReservation[],\n): DocsRouteCollision[] => {\n  const normalizedReservations = reservations.map(normalizeReservation)\n  const collisions: DocsRouteCollision[] = []\n\n  for (let index = 0; index < normalizedReservations.length; index += 1) {\n    for (\n      let comparedIndex = index + 1;\n      comparedIndex < normalizedReservations.length;\n      comparedIndex += 1\n    ) {\n      const first = normalizedReservations[index]\n      const second = normalizedReservations[comparedIndex]\n\n      if (!first || !second || sameOwner(first, second)) {\n        continue\n      }\n\n      if (first.route === second.route) {\n        if (!isAllowedBridgeCollision(first, second)) {\n          collisions.push({\n            first,\n            reason: 'exact_route_collision',\n            second,\n          })\n        }\n\n        continue\n      }\n\n      if (\n        (first.reservesDescendants && isRouteDescendant(first.route, second.route)) ||\n        (second.reservesDescendants && isRouteDescendant(second.route, first.route))\n      ) {\n        collisions.push({\n          first,\n          reason: 'descendant_route_collision',\n          second,\n        })\n      }\n    }\n  }\n\n  return collisions\n}\n\nexport const createDocRouteReservations = (\n  docs: {\n    ownerId?: string\n    route: string\n  }[],\n): DocsRouteReservation[] =>\n  docs.map((doc) => ({\n    ownerId: doc.ownerId,\n    ownerType: 'doc',\n    route: doc.route,\n  }))\n\nexport const createDocsSetRouteReservation = ({\n  ownerId,\n  routeBase,\n}: {\n  ownerId?: string\n  routeBase: string\n}): DocsRouteReservation => ({\n  ownerId,\n  ownerType: 'docsSet',\n  reservesDescendants: true,\n  route: routeBase,\n})\n\nexport const createDocsGroupRouteReservation = ({\n  ownerId,\n  routePath,\n  serveIndex,\n}: {\n  ownerId?: string\n  routePath: string\n  serveIndex?: boolean\n}): DocsRouteReservation => ({\n  ownerId,\n  ownerType: 'docsGroup',\n  reservesDescendants: false,\n  route: routePath,\n  ...(serveIndex ? {} : { allowBridge: true }),\n})\n\nexport const findPageRouteCollisions = ({\n  allowBridgePages = true,\n  docsSetRouteBase,\n  pages,\n}: {\n  allowBridgePages?: boolean\n  docsSetRouteBase: string\n  pages: {\n    bridge?: boolean\n    id?: string\n    route: string\n  }[]\n}): DocsRouteCollision[] => {\n  const reservations = [\n    createDocsSetRouteReservation({\n      routeBase: docsSetRouteBase,\n    }),\n    ...pages.map((page) => ({\n      allowBridge: allowBridgePages && page.bridge === true,\n      ownerId: page.id,\n      ownerType: 'page' as const,\n      route: page.route,\n    })),\n  ]\n\n  return findRouteReservationCollisions(reservations).filter(\n    (collision) =>\n      collision.first.ownerType === 'page' || collision.second.ownerType === 'page',\n  )\n}\n"],"names":["isRouteDescendant","normalizeRoutePath","normalizeReservation","reservation","route","sameOwner","first","second","ownerType","ownerId","undefined","isAllowedBridgeCollision","allowBridge","findRouteReservationCollisions","reservations","normalizedReservations","map","collisions","index","length","comparedIndex","push","reason","reservesDescendants","createDocRouteReservations","docs","doc","createDocsSetRouteReservation","routeBase","createDocsGroupRouteReservation","routePath","serveIndex","findPageRouteCollisions","allowBridgePages","docsSetRouteBase","pages","page","bridge","id","filter","collision"],"mappings":"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"}

package/dist/security/canonical.d.ts

@@ -0,0 +1,12 @@
+export type CanonicalSigningStringInput = {
+    bodySha256: string;
+    method: string;
+    nonce: string;
+    path: string;
+    timestamp: string;
+};
+export declare const buildCanonicalSigningString: ({ bodySha256, method, nonce, path, timestamp, }: CanonicalSigningStringInput) => string;
+export declare const getCanonicalPathFromRequestUrl: ({ endpointPath, url, }: {
+    endpointPath: string;
+    url?: string;
+}) => string;

package/dist/security/canonical.js

@@ -0,0 +1,24 @@
+const normalizeCanonicalPath = (path)=>{
+    const normalized = `/${path.trim()}`.replace(/\/+/g, '/');
+    return normalized.length > 1 ? normalized.replace(/\/+$/g, '') : normalized;
+};
+export const buildCanonicalSigningString = ({ bodySha256, method, nonce, path, timestamp })=>[
+        'v1',
+        method.toUpperCase(),
+        normalizeCanonicalPath(path),
+        timestamp,
+        nonce,
+        bodySha256.toLowerCase()
+    ].join('\n');
+export const getCanonicalPathFromRequestUrl = ({ endpointPath, url })=>{
+    if (url) {
+        try {
+            return new URL(url).pathname;
+        } catch  {
+        // Fall through to the configured Payload API route.
+        }
+    }
+    return `/api/${endpointPath}`.replace(/\/+/g, '/');
+};
+
+//# sourceMappingURL=canonical.js.map

package/dist/security/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/security/canonical.ts"],"sourcesContent":["export type CanonicalSigningStringInput = {\n  bodySha256: string\n  method: string\n  nonce: string\n  path: string\n  timestamp: string\n}\n\nconst normalizeCanonicalPath = (path: string): string => {\n  const normalized = `/${path.trim()}`.replace(/\\/+/g, '/')\n\n  return normalized.length > 1 ? normalized.replace(/\\/+$/g, '') : normalized\n}\n\nexport const buildCanonicalSigningString = ({\n  bodySha256,\n  method,\n  nonce,\n  path,\n  timestamp,\n}: CanonicalSigningStringInput): string =>\n  [\n    'v1',\n    method.toUpperCase(),\n    normalizeCanonicalPath(path),\n    timestamp,\n    nonce,\n    bodySha256.toLowerCase(),\n  ].join('\\n')\n\nexport const getCanonicalPathFromRequestUrl = ({\n  endpointPath,\n  url,\n}: {\n  endpointPath: string\n  url?: string\n}): string => {\n  if (url) {\n    try {\n      return new URL(url).pathname\n    } catch {\n      // Fall through to the configured Payload API route.\n    }\n  }\n\n  return `/api/${endpointPath}`.replace(/\\/+/g, '/')\n}\n\n"],"names":["normalizeCanonicalPath","path","normalized","trim","replace","length","buildCanonicalSigningString","bodySha256","method","nonce","timestamp","toUpperCase","toLowerCase","join","getCanonicalPathFromRequestUrl","endpointPath","url","URL","pathname"],"mappings":"AAQA,MAAMA,yBAAyB,CAACC;IAC9B,MAAMC,aAAa,CAAC,CAAC,EAAED,KAAKE,IAAI,IAAI,CAACC,OAAO,CAAC,QAAQ;IAErD,OAAOF,WAAWG,MAAM,GAAG,IAAIH,WAAWE,OAAO,CAAC,SAAS,MAAMF;AACnE;AAEA,OAAO,MAAMI,8BAA8B,CAAC,EAC1CC,UAAU,EACVC,MAAM,EACNC,KAAK,EACLR,IAAI,EACJS,SAAS,EACmB,GAC5B;QACE;QACAF,OAAOG,WAAW;QAClBX,uBAAuBC;QACvBS;QACAD;QACAF,WAAWK,WAAW;KACvB,CAACC,IAAI,CAAC,MAAK;AAEd,OAAO,MAAMC,iCAAiC,CAAC,EAC7CC,YAAY,EACZC,GAAG,EAIJ;IACC,IAAIA,KAAK;QACP,IAAI;YACF,OAAO,IAAIC,IAAID,KAAKE,QAAQ;QAC9B,EAAE,OAAM;QACN,oDAAoD;QACtD;IACF;IAEA,OAAO,CAAC,KAAK,EAAEH,cAAc,CAACX,OAAO,CAAC,QAAQ;AAChD,EAAC"}

package/dist/security/githubOidc.d.ts

@@ -0,0 +1,45 @@
+import type { PayloadMarkdownDocsAuthConfig } from '../types.js';
+import type { FetchJson } from './jwks.js';
+export type GitHubOidcErrorCode = 'oidc_environment_not_allowed' | 'oidc_expired' | 'oidc_invalid_audience' | 'oidc_invalid_issuer' | 'oidc_invalid_token' | 'oidc_jwks_unavailable' | 'oidc_missing_claim' | 'oidc_missing_jti' | 'oidc_not_yet_valid' | 'oidc_owner_not_allowed' | 'oidc_pull_request_not_allowed' | 'oidc_ref_not_allowed' | 'oidc_repository_not_allowed' | 'oidc_workflow_not_allowed';
+export type GitHubOidcClaims = {
+    actor?: string;
+    aud: string | string[];
+    environment?: string;
+    event_name?: string;
+    exp: number;
+    iat: number;
+    iss: string;
+    job_workflow_ref?: string;
+    jti: string;
+    nbf?: number;
+    ref: string;
+    repository: string;
+    repository_owner: string;
+    sha?: string;
+    sub: string;
+    workflow?: string;
+    workflow_ref?: string;
+};
+export type VerifiedGitHubOidcToken = {
+    claims: GitHubOidcClaims;
+    expiresAt: Date;
+    keyId: string;
+};
+export type VerifyGitHubOidcTokenResult = {
+    code: GitHubOidcErrorCode;
+    message: string;
+    ok: false;
+} | {
+    ok: true;
+    token: VerifiedGitHubOidcToken;
+};
+type GitHubOidcAuthConfig = Extract<PayloadMarkdownDocsAuthConfig, {
+    mode: 'github-oidc';
+}>;
+export declare const verifyGitHubOidcToken: ({ config, fetchJson, now, token, }: {
+    config: GitHubOidcAuthConfig;
+    fetchJson?: FetchJson;
+    now?: Date;
+    token: string;
+}) => Promise<VerifyGitHubOidcTokenResult>;
+export {};