payload 4.0.0-internal.fa345ef → 4.0.0-internal.ff27d6e

package/dist/branching/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/branching/validation.ts"],"sourcesContent":["import type { Field } from '../fields/config/types.js'\nimport type { Payload, PayloadRequest } from '../types/index.js'\nimport type { EffectiveOperation, ResolvedChange } from './effectiveOperations.js'\n\nimport { ValidationError } from '../errors/ValidationError.js'\nimport { fieldIsVirtual, tabHasName } from '../fields/config/types.js'\nimport {\n  validateCollectionData,\n  validateGlobalData,\n} from '../utilities/entityInputSchema/validateEntityData.js'\nimport { traverseForLocalizedFields } from '../utilities/traverseForLocalizedFields.js'\nimport {\n  getGlobalMergeLocales,\n  readBranchGlobalWrite,\n  resolveGlobalMergeWrites,\n} from './globalMergeWrites.js'\nimport { branchMergeValidationContextKey } from './mergeWriteGuard.js'\nimport { readLocalizedBranchWrite } from './readLocalizedBranchWrite.js'\nimport { isolateBranchState } from './resolveBranch.js'\nimport { stripBranchMergeData, stripBranchMergeGlobalData } from './stripBranchMergeData.js'\nimport { MAIN_BRANCH } from './types.js'\n\nexport type BranchMergeValidationCandidate = {\n  changeID: number | string\n  collectionSlug?: string\n  data?: Record<string, unknown>\n  docID?: number | string\n  draft: boolean\n  entityType: 'collection' | 'global'\n  globalSlug?: string\n  locale?: string\n  operation: EffectiveOperation\n}\n\nexport type BranchMergeValidationError = {\n  changeID: number | string\n  collectionSlug?: string\n  docID?: number | string\n  globalSlug?: string\n  locale?: string\n  message: string\n  path?: string\n}\n\nexport type BranchMergeValidationResult = {\n  errors: BranchMergeValidationError[]\n  valid: boolean\n}\n\nexport type BranchMergeValidate = (args: {\n  branch: string\n  candidates: BranchMergeValidationCandidate[]\n  req: PayloadRequest\n  target: 'main'\n}) => BranchMergeValidationResult | Promise<BranchMergeValidationResult>\n\nexport const createMainBranchRequest = ({ req }: { req: PayloadRequest }): PayloadRequest => {\n  const targetReq = isolateBranchState({ req: req })\n\n  targetReq.branch = MAIN_BRANCH\n  targetReq.query = { ...targetReq.query }\n  delete targetReq.query.branch\n  delete (targetReq.context as Record<string, unknown>)._branchBypass\n\n  return targetReq\n}\n\nexport const createBranchMergeValidationRequest = ({\n  req,\n}: {\n  req: PayloadRequest\n}): PayloadRequest => {\n  const validationReq = createMainBranchRequest({ req })\n  const validationContext = validationReq.context as Record<PropertyKey, unknown>\n\n  validationContext[branchMergeValidationContextKey] = true\n  validationReq.operation = 'validate'\n\n  return validationReq\n}\n\nexport const prepareBranchMergeValidationCandidates = async ({\n  payload,\n  pending,\n  pendingGlobals,\n  req,\n}: {\n  payload: Payload\n  pending: ResolvedChange[]\n  pendingGlobals: Record<string, unknown>[]\n  req: PayloadRequest\n}): Promise<BranchMergeValidationCandidate[]> => {\n  const candidates: BranchMergeValidationCandidate[] = []\n\n  for (const resolved of pending) {\n    const collectionConfig = payload.collections[resolved.collectionSlug]!.config\n    const localization = payload.config.localization\n    const locales =\n      localization && traverseForLocalizedFields(collectionConfig.fields)\n        ? localization.localeCodes\n        : undefined\n\n    for (const write of resolved.writes) {\n      const baseCandidate = {\n        changeID: resolved.change.id as number | string,\n        collectionSlug: resolved.collectionSlug,\n        docID: resolved.docID,\n        draft: write.draft,\n        entityType: 'collection' as const,\n        operation: write.operation,\n      }\n\n      if (write.operation === 'delete' || !locales?.length) {\n        candidates.push({\n          ...baseCandidate,\n          data:\n            write.operation === 'delete'\n              ? undefined\n              : prepareCollectionCandidate({\n                  collectionSlug: resolved.collectionSlug,\n                  data: write.data,\n                  payload,\n                }),\n        })\n        continue\n      }\n\n      for (const locale of locales) {\n        const data = await readLocalizedBranchWrite({\n          branch: resolved.change.branch as string,\n          collectionSlug: resolved.collectionSlug,\n          docID: resolved.docID,\n          draft: write.draft,\n          locale,\n          payload,\n          req,\n        })\n\n        if (data) {\n          candidates.push({\n            ...baseCandidate,\n            data: prepareCollectionCandidate({\n              collectionSlug: resolved.collectionSlug,\n              data,\n              payload,\n            }),\n            locale,\n          })\n        }\n      }\n    }\n  }\n\n  for (const change of pendingGlobals) {\n    const branch = change.branch as string\n    const globalSlug = change.globalSlug as string\n    const writes = await resolveGlobalMergeWrites({ branch, globalSlug, payload, req })\n    const locales = getGlobalMergeLocales({ globalSlug, payload, req })\n\n    for (const write of writes) {\n      for (const locale of locales) {\n        const data = await readBranchGlobalWrite({\n          branch,\n          draft: write.draft,\n          globalSlug,\n          locale,\n          payload,\n          req,\n        })\n\n        if (data) {\n          candidates.push({\n            changeID: change.id as number | string,\n            data: stripNonWritableFields({\n              data: stripBranchMergeGlobalData({\n                data,\n                fields: payload.globals.config.find(({ slug }) => slug === globalSlug)!.fields,\n              }),\n              fields: payload.globals.config.find(({ slug }) => slug === globalSlug)!.fields,\n              payload,\n            }),\n            draft: write.draft,\n            entityType: 'global',\n            globalSlug,\n            locale,\n            operation: 'update',\n          })\n        }\n      }\n    }\n  }\n\n  return candidates\n}\n\n/** Best-effort structural validation for the exact candidates selected by merge. */\nexport const defaultBranchMergeValidation: BranchMergeValidate = ({ candidates, req }) => {\n  const errors: BranchMergeValidationError[] = []\n\n  for (const candidate of candidates) {\n    if (!candidate.data || candidate.operation === 'delete') {\n      continue\n    }\n\n    const candidateReq = isolateBranchState({ req: req })\n\n    if (candidate.locale) {\n      candidateReq.locale = candidate.locale\n    }\n\n    try {\n      if (candidate.entityType === 'collection' && candidate.collectionSlug) {\n        validateCollectionData({\n          slug: candidate.collectionSlug as never,\n          data: candidate.data,\n          partial: candidate.operation !== 'create',\n          req: candidateReq,\n        })\n      } else if (candidate.entityType === 'global' && candidate.globalSlug) {\n        validateGlobalData({\n          slug: candidate.globalSlug as never,\n          data: candidate.data,\n          req: candidateReq,\n        })\n      }\n    } catch (error) {\n      if (!(error instanceof ValidationError)) {\n        throw error\n      }\n\n      for (const fieldError of error.data.errors) {\n        errors.push({\n          changeID: candidate.changeID,\n          collectionSlug: candidate.collectionSlug,\n          docID: candidate.docID,\n          globalSlug: candidate.globalSlug,\n          locale: candidate.locale,\n          message: fieldError.message,\n          path: fieldError.path,\n        })\n      }\n    }\n  }\n\n  return { errors, valid: errors.length === 0 }\n}\n\nconst prepareCollectionCandidate = ({\n  collectionSlug,\n  data,\n  payload,\n}: {\n  collectionSlug: string\n  data: Record<string, unknown>\n  payload: Payload\n}): Record<string, unknown> =>\n  stripNonWritableFields({\n    data: stripBranchMergeData({\n      data,\n      fields: payload.collections[collectionSlug]!.config.fields,\n    }),\n    fields: payload.collections[collectionSlug]!.config.fields,\n    payload,\n  })\n\nconst stripNonWritableFields = ({\n  data,\n  fields,\n  payload,\n}: {\n  data: Record<string, unknown>\n  fields: Field[]\n  payload: Payload\n}): Record<string, unknown> => {\n  let writableData = { ...data }\n\n  for (const field of fields) {\n    if ('name' in field && field.name && (field.type === 'join' || fieldIsVirtual(field))) {\n      delete writableData[field.name]\n      continue\n    }\n\n    if (field.type === 'row' || field.type === 'collapsible') {\n      writableData = stripNonWritableFields({ data: writableData, fields: field.fields, payload })\n      continue\n    }\n\n    if (field.type === 'tabs') {\n      for (const tab of field.tabs) {\n        if (!tabHasName(tab)) {\n          writableData = stripNonWritableFields({ data: writableData, fields: tab.fields, payload })\n          continue\n        }\n\n        const tabData = writableData[tab.name]\n\n        if (isRecord(tabData)) {\n          writableData[tab.name] = stripNonWritableFields({\n            data: tabData,\n            fields: tab.fields,\n            payload,\n          })\n        }\n      }\n\n      continue\n    }\n\n    if (field.type === 'group') {\n      if (!('name' in field) || !field.name) {\n        writableData = stripNonWritableFields({ data: writableData, fields: field.fields, payload })\n        continue\n      }\n\n      const groupData = writableData[field.name]\n\n      if (isRecord(groupData)) {\n        writableData[field.name] = stripNonWritableFields({\n          data: groupData,\n          fields: field.fields,\n          payload,\n        })\n      }\n\n      continue\n    }\n\n    if (field.type === 'array' && field.name) {\n      const rows = writableData[field.name]\n\n      if (Array.isArray(rows)) {\n        writableData[field.name] = rows.map((row) =>\n          isRecord(row)\n            ? stripNonWritableFields({ data: row, fields: field.fields, payload })\n            : row,\n        )\n      }\n\n      continue\n    }\n\n    if (field.type === 'blocks' && field.name) {\n      const rows = writableData[field.name]\n\n      if (Array.isArray(rows)) {\n        writableData[field.name] = rows.map((row) => {\n          if (!isRecord(row) || typeof row.blockType !== 'string') {\n            return row\n          }\n\n          const block =\n            payload.config.blocks?.find(({ slug }) => slug === row.blockType) ??\n            field.blocks.find(\n              (candidate) => typeof candidate !== 'string' && candidate.slug === row.blockType,\n            )\n\n          return !block || typeof block === 'string'\n            ? row\n            : stripNonWritableFields({ data: row, fields: block.fields, payload })\n        })\n      }\n    }\n  }\n\n  return writableData\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value && typeof value === 'object' && !Array.isArray(value))\n"],"names":["ValidationError","fieldIsVirtual","tabHasName","validateCollectionData","validateGlobalData","traverseForLocalizedFields","getGlobalMergeLocales","readBranchGlobalWrite","resolveGlobalMergeWrites","branchMergeValidationContextKey","readLocalizedBranchWrite","isolateBranchState","stripBranchMergeData","stripBranchMergeGlobalData","MAIN_BRANCH","createMainBranchRequest","req","targetReq","branch","query","context","_branchBypass","createBranchMergeValidationRequest","validationReq","validationContext","operation","prepareBranchMergeValidationCandidates","payload","pending","pendingGlobals","candidates","resolved","collectionConfig","collections","collectionSlug","config","localization","locales","fields","localeCodes","undefined","write","writes","baseCandidate","changeID","change","id","docID","draft","entityType","length","push","data","prepareCollectionCandidate","locale","globalSlug","stripNonWritableFields","globals","find","slug","defaultBranchMergeValidation","errors","candidate","candidateReq","partial","error","fieldError","message","path","valid","writableData","field","name","type","tab","tabs","tabData","isRecord","groupData","rows","Array","isArray","map","row","blockType","block","blocks","value","Boolean"],"mappings":"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"}

package/dist/branching/versions.d.ts

@@ -0,0 +1,131 @@
+import type { Payload } from '../index.js';
+import type { PayloadRequest, Where } from '../types/index.js';
+type QueryArgs = {
+    branch?: false | string;
+    collectionSlug: string;
+    req?: Partial<PayloadRequest>;
+    where: undefined | Where;
+};
+export declare const findBranchVersionForkBoundary: ({ collectionSlug, docID, req, }: {
+    collectionSlug: string;
+    docID: number | string;
+    req: PayloadRequest;
+}) => Promise<{
+    baseVersionID?: string;
+    baseVersionUpdatedAt?: string;
+}>;
+/**
+ * Branch predicate for version queries.
+ *
+ * Mirrors the collection predicate, but a version row's canonical identity is
+ * its `parent` on main and its `_branchParent` on a branch — so the exclusion of
+ * shadowed main versions compares `parent`, which for a main version row is
+ * already the canonical document ID.
+ */
+export declare const resolveBranchVersionQuery: ({ branch: branchOverride, collectionSlug, req, where, }: QueryArgs) => Promise<undefined | Where>;
+/**
+ * Synchronous branch predicate for version joins.
+ *
+ * Join query builders run after the top-level read has loaded and memoized the branch manifest.
+ * This uses that state while sharing the exact query construction with
+ * {@link resolveBranchVersionQuery}.
+ */
+export declare const resolveBranchVersionQuerySync: ({ branch: branchOverride, collectionSlug, req, where, }: QueryArgs) => undefined | Where;
+/**
+ * Branch predicate for reading version *history*, as opposed to listing drafts.
+ *
+ * A branch's history reads as a continuation of main's: main's versions up to the
+ * point the branch forked are the branch's ancestry, the branch's own versions sit
+ * on top, and no other branch is visible. Anything main recorded after the fork
+ * belongs to main alone — it is not this branch's past.
+ *
+ * Deliberately *not* {@link resolveBranchVersionQuery}. That one hides main's
+ * versions for any shadowed document, which is right when listing one row per
+ * document and exactly wrong here: those hidden rows are the ancestry.
+ */
+export declare const resolveBranchVersionHistoryQuery: ({ branch: branchOverride, collectionSlug, req, where, }: QueryArgs) => Promise<undefined | Where>;
+/**
+ * Restores canonical document IDs on version rows read from a branch, whose
+ * `parent` is the shadow row rather than the document.
+ */
+export declare const projectBranchVersionParents: (docs: Record<string, unknown>[]) => void;
+/**
+ * Attaches a new version to the branch's own copy of the document.
+ *
+ * Without this a draft saved on a branch would append to main's version chain,
+ * which is both visible on main and destructive to its `latest` bookkeeping.
+ */
+export declare const resolveBranchVersionParent: ({ branch: branchOverride, collectionSlug, parent, req, versionData, }: {
+    branch?: false | string;
+    collectionSlug: string;
+    parent: number | string;
+    req?: Partial<PayloadRequest>;
+    versionData: Record<string, unknown>;
+}) => Promise<{
+    parent: number | string;
+    versionData: Record<string, unknown>;
+}>;
+/**
+ * Restores canonical document IDs on rows returned by `queryDrafts`, which
+ * surfaces a version's `parent` as the document ID.
+ */
+export declare const projectBranchVersionParent: (row: Record<string, unknown>) => number | string;
+/**
+ * The version rows this branch owns for one document.
+ *
+ * Every operation that reaches into an existing version chain needs this, not just
+ * deletes: a cascade after a delete, pruning to `maxPerDoc`, and rewriting the latest
+ * row on unpublish are all the same question — which rows belong to the branch doing
+ * the writing.
+ *
+ * Deleting a document cascades to its versions by `parent`. On a branch that is
+ * destructive: the delete becomes a tombstone rather than a real delete, but the
+ * cascade still names the canonical ID — which is main's `parent` — so main loses
+ * its version chain while its row survives. A published document then vanishes
+ * from main's own drafts list, and nothing about the branch says why.
+ *
+ * Adding `_branch` makes the cascade hit only the rows belonging to the branch in
+ * play. It also protects a branch's chain from a delete performed on main, whose
+ * versions share no `parent` with it but are cheap to exclude explicitly.
+ */
+export declare const resolveBranchOwnVersions: ({ id, branch: branchOverride, collectionSlug, req, }: {
+    branch?: false | string;
+    collectionSlug: string;
+    id: number | string;
+    req?: Partial<PayloadRequest>;
+}) => Promise<Where>;
+/**
+ * Drops a branch's version chain for one document.
+ *
+ * Every way a branch stops owning a document ends here: merged, discarded, or
+ * promoted to main. A branch's versions hang off its *shadow row's* primary key
+ * rather than the canonical ID, so they do not travel with the document and are not
+ * cascaded by anything that addresses it — they have to be deleted deliberately.
+ *
+ * Leaving them behind is not inert. The drafts list reads through versions, so an
+ * orphaned branch chain keeps answering for a document the branch no longer has a
+ * row for: the branch lists the document twice, once from its stale chain and once
+ * from main's, as two identical rows.
+ *
+ * Scoped by `_branch` as well as `parent`: main's chain shares no parent with this
+ * one, but saying so costs nothing and a wrong delete here would strip production
+ * history. `_branchParent` is required for the same reason — only rows that were
+ * written as branch versions are in scope.
+ */
+export declare const deleteBranchVersionChain: ({ branch, collectionSlug, payload, req, rowID, }: {
+    branch: string;
+    collectionSlug: string;
+    payload: Payload;
+    req: PayloadRequest;
+    /** Primary key the branch's versions hang off — the shadow row, not the document. */
+    rowID: number | string;
+}) => Promise<void>;
+/** Drops every version of one global owned by a branch that is being discarded or merged. */
+export declare const deleteBranchGlobalVersionChain: ({ branch, globalSlug, payload, req, }: {
+    branch: string;
+    globalSlug: string;
+    payload: Payload;
+    req: PayloadRequest;
+}) => Promise<void>;
+export {};
+//# sourceMappingURL=versions.d.ts.map

package/dist/branching/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/branching/versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAmB9D,KAAK,SAAS,GAAG;IACf,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7B,KAAK,EAAE,SAAS,GAAG,KAAK,CAAA;CACzB,CAAA;AAcD,eAAO,MAAM,6BAA6B,oCAIvC;IACD,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CA+BpE,CAAA;AAqDD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,4DAKnC,SAAS,KAAG,OAAO,CAAC,SAAS,GAAG,KAAK,CAyBvC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,4DAKvC,SAAS,KAAG,SAAS,GAAG,KAwB1B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,4DAK1C,SAAS,KAAG,OAAO,CAAC,SAAS,GAAG,KAAK,CAuFvC,CAAA;AAyCD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,SAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAG,IAQ7E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,0EAMpC;IACD,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,KAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA2B5E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,GAAG,MAGvE,CAAA;AAEZ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,yDAKlC;IACD,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAC9B,KAAG,OAAO,CAAC,KAAK,CA0BhB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,qDAMlC;IACD,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;IACnB,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB,KAAG,OAAO,CAAC,IAAI,CAkBf,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,8BAA8B,0CAKxC;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC,IAAI,CAYf,CAAA"}