@payloadcms/db-mongodb 4.0.0-internal.e7d4ebc → 4.0.0-internal.ea6e8f8

package/dist/utilities/buildJoinAggregation.d.ts

@@ -1,8 +1,9 @@
 import type { PipelineStage } from 'mongoose';
-import { type CollectionSlug, type JoinQuery, type SanitizedCollectionConfig } from 'payload';
+import { type CollectionSlug, type JoinQuery, type PayloadRequest, type SanitizedCollectionConfig } from 'payload';
 import type { MongooseAdapter } from '../index.js';
 type BuildJoinAggregationArgs = {
     adapter: MongooseAdapter;
+    branch?: false | string;
     collection: CollectionSlug;
     collectionConfig: SanitizedCollectionConfig;
     draftsEnabled?: boolean;
@@ -10,9 +11,10 @@ type BuildJoinAggregationArgs = {
     locale?: string;
     projection?: Record<string, true>;
     query?: Record<string, unknown>;
+    req?: Partial<PayloadRequest>;
     /** whether the query is from drafts */
     versions?: boolean;
 };
-export declare const buildJoinAggregation: ({ adapter, collection, collectionConfig, draftsEnabled, joins, locale, projection, versions, }: BuildJoinAggregationArgs) => Promise<PipelineStage[] | undefined>;
+export declare const buildJoinAggregation: ({ adapter, branch, collection, collectionConfig, draftsEnabled, joins, locale, projection, req, versions, }: BuildJoinAggregationArgs) => Promise<PipelineStage[]>;
 export {};
 //# sourceMappingURL=buildJoinAggregation.d.ts.map

package/dist/utilities/buildJoinAggregation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildJoinAggregation.d.ts","sourceRoot":"","sources":["../../src/utilities/buildJoinAggregation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,OAAO,EAIL,KAAK,cAAc,EAInB,KAAK,SAAS,EACd,KAAK,yBAAyB,EAC/B,MAAM,SAAS,CAAA;AAGhB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,eAAe,CAAA;IACxB,UAAU,EAAE,cAAc,CAAA;IAC1B,gBAAgB,EAAE,yBAAyB,CAAA;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,oBAAoB,mGAS9B,wBAAwB,KAAG,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CA0chE,CAAA"}
+{"version":3,"file":"buildJoinAggregation.d.ts","sourceRoot":"","sources":["../../src/utilities/buildJoinAggregation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,OAAO,EAIL,KAAK,cAAc,EAKnB,KAAK,SAAS,EACd,KAAK,cAAc,EAKnB,KAAK,yBAAyB,EAE/B,MAAM,SAAS,CAAA;AAGhB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAQlD,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,UAAU,EAAE,cAAc,CAAA;IAC1B,gBAAgB,EAAE,yBAAyB,CAAA;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,oBAAoB,gHAW9B,wBAAwB,KAAG,OAAO,CAAC,aAAa,EAAE,CAiiBpD,CAAA"}

package/dist/utilities/buildJoinAggregation.js

@@ -1,14 +1,15 @@
-import { APIError, appendVersionToQueryKey, buildVersionCollectionFields, combineQueries, getQueryDraftsSort } from 'payload';
+import { APIError, appendVersionToQueryKey, buildVersionCollectionFields, combineQueries, getBranchPredicateSync, getQueryDraftsSort, resolveBranchReadState, resolveBranchVersionQuery, rewriteBranchIDs, rewriteBranchVersionParents } from 'payload';
 import { fieldShouldBeLocalized, hasDraftsEnabled } from 'payload/shared';
+import { buildBranchVisibilityStages } from '../queries/buildBranchVisibility.js';
 import { buildQuery } from '../queries/buildQuery.js';
 import { buildSortParam } from '../queries/buildSortParam.js';
 import { getCollection } from './getEntity.js';
-export const buildJoinAggregation = async ({ adapter, collection, collectionConfig, draftsEnabled, joins, locale, projection, versions })=>{
+export const buildJoinAggregation = async ({ adapter, branch, collection, collectionConfig, draftsEnabled, joins, locale, projection, req, versions })=>{
     if (!adapter.useJoinAggregations) {
-        return;
+        return [];
     }
     if (Object.keys(collectionConfig.joins).length === 0 && collectionConfig.polymorphicJoins.length == 0 || joins === false) {
-        return;
+        return [];
     }
     const joinConfig = adapter.payload.collections[collection]?.config?.joins;
     if (!joinConfig) {
@@ -49,8 +50,10 @@ export const buildJoinAggregation = async ({ adapter, collection, collectionConf
         });
         const $match = await buildQuery({
             adapter,
+            branch,
             fields: aggregatedFields,
             locale,
+            req,
             where: whereJoin
         });
         const sortProperty = Object.keys(sort)[0]// assert because buildSortParam always returns at least 1 key.
@@ -62,6 +65,29 @@ export const buildJoinAggregation = async ({ adapter, collection, collectionConf
         for (const collectionSlug of join.field.collection){
             const alias = `${as}.docs.${collectionSlug}`;
             aliases.push(alias);
+            const joinBranchPredicate = getBranchPredicateSync({
+                branch,
+                collectionSlug,
+                req
+            });
+            const joinBranchReadState = resolveBranchReadState({
+                branch,
+                collectionSlug,
+                req
+            });
+            const branchMatch = joinBranchPredicate ? await buildQuery({
+                adapter,
+                branch,
+                fields: adapter.payload.collections[collectionSlug].config.flattenedFields,
+                locale,
+                req,
+                where: joinBranchPredicate
+            }) : undefined;
+            const branchVisibility = joinBranchReadState.useBranching ? buildBranchVisibilityStages({
+                adapter,
+                branch: joinBranchReadState.branch,
+                collectionSlug
+            }) : [];
             const basePipeline = [
                 {
                     $addFields: {
@@ -81,10 +107,26 @@ export const buildJoinAggregation = async ({ adapter, collection, collectionConf
                                     ]
                                 }
                             },
-                            $match
+                            $match,
+                            ...branchMatch ? [
+                                branchMatch
+                            ] : []
                         ]
                     }
-                }
+                },
+                ...branchVisibility,
+                ...joinBranchPredicate || branchVisibility.length ? [
+                    {
+                        $set: {
+                            _id: {
+                                $ifNull: [
+                                    '$_branchDocID',
+                                    '$_id'
+                                ]
+                            }
+                        }
+                    }
+                ] : []
             ];
             const { Model: JoinModel } = getCollection({
                 adapter,
@@ -247,19 +289,75 @@ export const buildJoinAggregation = async ({ adapter, collection, collectionConf
             });
             const sortProperty = Object.keys(sort)[0];
             const sortDirection = sort[sortProperty] === 'asc' ? 1 : -1;
+            // A join subquery must carry the same branch predicate as the top-level
+            // read, or a branch would see main's related documents.
+            const joinBranchPredicate = getBranchPredicateSync({
+                branch,
+                collectionSlug: collectionConfig.slug,
+                req
+            });
+            const joinBranchReadState = resolveBranchReadState({
+                branch,
+                collectionSlug: collectionConfig.slug,
+                req
+            });
+            const resolvedWhereJoin = useDrafts ? joinBranchReadState.useBranching ? rewriteBranchVersionParents(appendVersionToQueryKey(whereJoin)) ?? {} : await resolveBranchVersionQuery({
+                branch,
+                collectionSlug: collectionConfig.slug,
+                req,
+                where: appendVersionToQueryKey(whereJoin)
+            }) ?? {} : joinBranchReadState.useBranching ? rewriteBranchIDs(whereJoin) ?? {} : joinBranchPredicate ? {
+                and: [
+                    whereJoin,
+                    joinBranchPredicate
+                ]
+            } : whereJoin;
             const $match = await JoinModel.buildQuery({
+                branch,
                 locale,
                 payload: adapter.payload,
-                where: useDrafts ? combineQueries(appendVersionToQueryKey(whereJoin), {
+                req,
+                where: useDrafts ? combineQueries(resolvedWhereJoin, {
                     latest: {
                         equals: true
                     }
-                }) : whereJoin
+                }) : resolvedWhereJoin
             });
+            const branchVisibility = joinBranchReadState.useBranching ? buildBranchVisibilityStages({
+                adapter,
+                branch: joinBranchReadState.branch,
+                collectionSlug: collectionConfig.slug,
+                mode: useDrafts ? 'drafts' : 'documents'
+            }) : [];
             const pipeline = [
                 {
                     $match
                 },
+                ...branchVisibility,
+                // Surface the canonical document ID rather than the shadow row's own
+                // primary key, so join results address documents the same way every
+                // other read does.
+                ...joinBranchPredicate || branchVisibility.length ? [
+                    useDrafts ? {
+                        $set: {
+                            parent: {
+                                $ifNull: [
+                                    '$_branchParent',
+                                    '$parent'
+                                ]
+                            }
+                        }
+                    } : {
+                        $set: {
+                            _id: {
+                                $ifNull: [
+                                    '$_branchDocID',
+                                    '$_id'
+                                ]
+                            }
+                        }
+                    }
+                ] : [],
                 {
                     $sort: {
                         [sortProperty]: sortDirection
@@ -290,6 +388,7 @@ export const buildJoinAggregation = async ({ adapter, collection, collectionConf
                             {
                                 $match
                             },
+                            ...branchVisibility,
                             {
                                 $count: 'result'
                             }

package/dist/utilities/buildJoinAggregation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/buildJoinAggregation.ts"],"sourcesContent":["import type { PipelineStage } from 'mongoose'\n\nimport {\n  APIError,\n  appendVersionToQueryKey,\n  buildVersionCollectionFields,\n  type CollectionSlug,\n  combineQueries,\n  type FlattenedField,\n  getQueryDraftsSort,\n  type JoinQuery,\n  type SanitizedCollectionConfig,\n} from 'payload'\nimport { fieldShouldBeLocalized, hasDraftsEnabled } from 'payload/shared'\n\nimport type { MongooseAdapter } from '../index.js'\nimport type { CollectionModel } from '../types.js'\n\nimport { buildQuery } from '../queries/buildQuery.js'\nimport { buildSortParam } from '../queries/buildSortParam.js'\nimport { getCollection } from './getEntity.js'\n\ntype BuildJoinAggregationArgs = {\n  adapter: MongooseAdapter\n  collection: CollectionSlug\n  collectionConfig: SanitizedCollectionConfig\n  draftsEnabled?: boolean\n  joins?: JoinQuery\n  locale?: string\n  projection?: Record<string, true>\n  // the where clause for the top collection\n  query?: Record<string, unknown>\n  /** whether the query is from drafts */\n  versions?: boolean\n}\n\nexport const buildJoinAggregation = async ({\n  adapter,\n  collection,\n  collectionConfig,\n  draftsEnabled,\n  joins,\n  locale,\n  projection,\n  versions,\n}: BuildJoinAggregationArgs): Promise<PipelineStage[] | undefined> => {\n  if (!adapter.useJoinAggregations) {\n    return\n  }\n  if (\n    (Object.keys(collectionConfig.joins).length === 0 &&\n      collectionConfig.polymorphicJoins.length == 0) ||\n    joins === false\n  ) {\n    return\n  }\n\n  const joinConfig = adapter.payload.collections[collection]?.config?.joins\n\n  if (!joinConfig) {\n    throw new APIError(`Could not retrieve sanitized join config for ${collection}.`)\n  }\n\n  const aggregate: PipelineStage[] = []\n  const polymorphicJoinsConfig = adapter.payload.collections[collection]?.config?.polymorphicJoins\n\n  if (!polymorphicJoinsConfig) {\n    throw new APIError(`Could not retrieve sanitized polymorphic joins config for ${collection}.`)\n  }\n\n  for (const join of polymorphicJoinsConfig) {\n    if (projection && !projection[join.joinPath]) {\n      continue\n    }\n\n    if (joins?.[join.joinPath] === false) {\n      continue\n    }\n\n    const {\n      count = false,\n      limit: limitJoin = join.field.defaultLimit ?? 10,\n      page,\n      sort: sortJoin = join.field.defaultSort || collectionConfig.defaultSort,\n      where: whereJoin = {},\n    } = joins?.[join.joinPath] || {}\n\n    const aggregatedFields: FlattenedField[] = []\n    for (const collectionSlug of join.field.collection) {\n      const { collectionConfig } = getCollection({ adapter, collectionSlug })\n\n      for (const field of collectionConfig.flattenedFields) {\n        if (!aggregatedFields.some((eachField) => eachField.name === field.name)) {\n          aggregatedFields.push(field)\n        }\n      }\n    }\n\n    const sort = buildSortParam({\n      adapter,\n      config: adapter.payload.config,\n      fields: aggregatedFields,\n      locale,\n      sort: sortJoin,\n      timestamps: true,\n    })\n\n    const $match = await buildQuery({\n      adapter,\n      fields: aggregatedFields,\n      locale,\n      where: whereJoin,\n    })\n\n    const sortProperty = Object.keys(sort)[0]! // assert because buildSortParam always returns at least 1 key.\n    const sortDirection = sort[sortProperty] === 'asc' ? 1 : -1\n\n    const projectSort = sortProperty !== '_id' && sortProperty !== 'relationTo'\n\n    const aliases: string[] = []\n\n    const as = join.joinPath\n\n    for (const collectionSlug of join.field.collection) {\n      const alias = `${as}.docs.${collectionSlug}`\n      aliases.push(alias)\n\n      const basePipeline = [\n        {\n          $addFields: {\n            relationTo: {\n              $literal: collectionSlug,\n            },\n          },\n        },\n        {\n          $match: {\n            $and: [\n              {\n                $expr: {\n                  $eq: [`$${join.field.on}`, '$$root_id_'],\n                },\n              },\n              $match,\n            ],\n          },\n        },\n      ]\n\n      const { Model: JoinModel } = getCollection({ adapter, collectionSlug })\n\n      aggregate.push({\n        $lookup: {\n          as: alias,\n          from: JoinModel.collection.name,\n          let: {\n            root_id_: '$_id',\n          },\n          pipeline: [\n            ...basePipeline,\n            {\n              $sort: {\n                [sortProperty]: sortDirection,\n              },\n            },\n            {\n              // Unfortunately, we can't use $skip here because we can lose data, instead we do $slice then\n              $limit: page ? page * limitJoin : limitJoin,\n            },\n            {\n              $project: {\n                value: '$_id',\n                ...(projectSort && {\n                  [sortProperty]: 1,\n                }),\n                relationTo: 1,\n              },\n            },\n          ],\n        },\n      })\n\n      if (count) {\n        aggregate.push({\n          $lookup: {\n            as: `${as}.totalDocs.${alias}`,\n            from: JoinModel.collection.name,\n            let: {\n              root_id_: '$_id',\n            },\n            pipeline: [\n              ...basePipeline,\n              {\n                $count: 'result',\n              },\n            ],\n          },\n        })\n      }\n    }\n\n    aggregate.push({\n      $addFields: {\n        [`${as}.docs`]: {\n          $concatArrays: aliases.map((alias) => `$${alias}`),\n        },\n      },\n    })\n\n    if (count) {\n      aggregate.push({\n        $addFields: {\n          [`${as}.totalDocs`]: {\n            $add: aliases.map((alias) => ({\n              $ifNull: [\n                {\n                  $first: `$${as}.totalDocs.${alias}.result`,\n                },\n                0,\n              ],\n            })),\n          },\n        },\n      })\n    }\n\n    aggregate.push({\n      $set: {\n        [`${as}.docs`]: {\n          $sortArray: {\n            input: `$${as}.docs`,\n            sortBy: {\n              [sortProperty]: sortDirection,\n            },\n          },\n        },\n      },\n    })\n\n    const sliceValue = page ? [(page - 1) * limitJoin, limitJoin] : [limitJoin]\n\n    aggregate.push({\n      $addFields: {\n        [`${as}.hasNextPage`]: {\n          $gt: [{ $size: `$${as}.docs` }, limitJoin || Number.MAX_VALUE],\n        },\n      },\n    })\n\n    aggregate.push({\n      $set: {\n        [`${as}.docs`]: {\n          $slice: [`$${as}.docs`, ...sliceValue],\n        },\n      },\n    })\n  }\n\n  for (const slug of Object.keys(joinConfig)) {\n    const joinsList = joinConfig[slug]\n\n    if (!joinsList) {\n      throw new APIError(`Failed to retrieve array of joins for ${slug} in collectio ${collection}`)\n    }\n\n    for (const join of joinsList) {\n      const projectionPath = versions ? `version.${join.joinPath}` : join.joinPath\n      if (projection && !projection[projectionPath]) {\n        continue\n      }\n\n      if (joins?.[join.joinPath] === false) {\n        continue\n      }\n\n      const collectionConfig = adapter.payload.collections[join.field.collection as string]?.config\n\n      if (!collectionConfig) {\n        throw new APIError(\n          `Collection config for ${join.field.collection.toString()} was not found`,\n        )\n      }\n\n      let JoinModel: CollectionModel | undefined\n\n      const useDrafts = (draftsEnabled || versions) && hasDraftsEnabled(collectionConfig)\n\n      if (useDrafts) {\n        JoinModel = adapter.versions[collectionConfig.slug]\n      } else {\n        JoinModel = adapter.collections[collectionConfig.slug]\n      }\n\n      if (!JoinModel) {\n        throw new APIError(`Join Model was not found for ${collectionConfig.slug}`)\n      }\n\n      const {\n        count,\n        limit: limitJoin = join.field.defaultLimit ?? 10,\n        page,\n        sort: sortJoin = join.field.defaultSort || collectionConfig.defaultSort,\n        where: whereJoin = {},\n      } = joins?.[join.joinPath] || {}\n\n      if (Array.isArray(join.field.collection)) {\n        throw new Error('Unreachable')\n      }\n\n      const fields = useDrafts\n        ? buildVersionCollectionFields(adapter.payload.config, collectionConfig, true)\n        : collectionConfig.flattenedFields\n\n      const sort = buildSortParam({\n        adapter,\n        config: adapter.payload.config,\n        fields,\n        locale,\n        sort: useDrafts ? getQueryDraftsSort({ collectionConfig, sort: sortJoin }) : sortJoin,\n        timestamps: true,\n      })\n      const sortProperty = Object.keys(sort)[0]!\n      const sortDirection = sort[sortProperty] === 'asc' ? 1 : -1\n\n      const $match = await JoinModel.buildQuery({\n        locale,\n        payload: adapter.payload,\n        where: useDrafts\n          ? combineQueries(appendVersionToQueryKey(whereJoin), {\n              latest: {\n                equals: true,\n              },\n            })\n          : whereJoin,\n      })\n\n      const pipeline: Exclude<PipelineStage, PipelineStage.Merge | PipelineStage.Out>[] = [\n        { $match },\n        {\n          $sort: { [sortProperty]: sortDirection },\n        },\n      ]\n\n      if (page) {\n        pipeline.push({\n          $skip: (page - 1) * limitJoin,\n        })\n      }\n\n      if (limitJoin > 0) {\n        pipeline.push({\n          $limit: limitJoin + 1,\n        })\n      }\n\n      let polymorphicSuffix = ''\n      if (Array.isArray(join.targetField.relationTo)) {\n        polymorphicSuffix = '.value'\n      }\n\n      const addTotalDocsAggregation = (as: string, foreignField: string) =>\n        aggregate.push(\n          {\n            $lookup: {\n              as: `${as}.totalDocs`,\n              foreignField,\n              from: JoinModel.collection.name,\n              localField: versions ? 'parent' : '_id',\n              pipeline: [\n                {\n                  $match,\n                },\n                {\n                  $count: 'result',\n                },\n              ],\n            },\n          },\n          {\n            $addFields: {\n              [`${as}.totalDocs`]: { $ifNull: [{ $first: `$${as}.totalDocs.result` }, 0] },\n            },\n          },\n        )\n\n      let foreignFieldPrefix = ''\n\n      if (useDrafts) {\n        foreignFieldPrefix = 'version.'\n      }\n\n      if (adapter.payload.config.localization && locale === 'all') {\n        adapter.payload.config.localization.localeCodes.forEach((code) => {\n          const as = `${versions ? `version.${join.joinPath}` : join.joinPath}${code}`\n\n          aggregate.push(\n            {\n              $lookup: {\n                as: `${as}.docs`,\n                foreignField: `${foreignFieldPrefix}${join.field.on}${code}${polymorphicSuffix}`,\n                from: JoinModel.collection.name,\n                localField: versions ? 'parent' : '_id',\n                pipeline,\n              },\n            },\n            {\n              $addFields: {\n                [`${as}.docs`]: {\n                  $map: {\n                    as: 'doc',\n                    in: useDrafts ? `$$doc.parent` : '$$doc._id',\n                    input: `$${as}.docs`,\n                  },\n                }, // Slicing the docs to match the limit\n                [`${as}.hasNextPage`]: limitJoin\n                  ? { $gt: [{ $size: `$${as}.docs` }, limitJoin] }\n                  : false,\n                // Boolean indicating if more docs than limit\n              },\n            },\n          )\n\n          if (limitJoin > 0) {\n            aggregate.push({\n              $addFields: {\n                [`${as}.docs`]: {\n                  $slice: [`$${as}.docs`, limitJoin],\n                },\n              },\n            })\n          }\n\n          if (count) {\n            addTotalDocsAggregation(\n              as,\n              `${foreignFieldPrefix}${join.field.on}${code}${polymorphicSuffix}`,\n            )\n          }\n        })\n      } else {\n        const localeSuffix =\n          fieldShouldBeLocalized({\n            field: join.field,\n            parentIsLocalized: join.parentIsLocalized,\n          }) &&\n          adapter.payload.config.localization &&\n          locale\n            ? `.${locale}`\n            : ''\n        const as = `${versions ? `version.${join.joinPath}` : join.joinPath}${localeSuffix}`\n\n        let foreignField: string\n\n        if (join.getForeignPath) {\n          foreignField = `${join.getForeignPath({ locale })}${polymorphicSuffix}`\n        } else {\n          foreignField = `${join.field.on}${polymorphicSuffix}`\n        }\n\n        aggregate.push(\n          {\n            $lookup: {\n              as: `${as}.docs`,\n              foreignField: `${foreignFieldPrefix}${foreignField}`,\n              from: JoinModel.collection.name,\n              localField: versions ? 'parent' : '_id',\n              pipeline,\n            },\n          },\n          {\n            $addFields: {\n              [`${as}.docs`]: {\n                $map: {\n                  as: 'doc',\n                  in: useDrafts ? `$$doc.parent` : '$$doc._id',\n                  input: `$${as}.docs`,\n                },\n              }, // Slicing the docs to match the limit\n              [`${as}.hasNextPage`]: {\n                $gt: [{ $size: `$${as}.docs` }, limitJoin || Number.MAX_VALUE],\n              }, // Boolean indicating if more docs than limit\n            },\n          },\n        )\n\n        if (count) {\n          addTotalDocsAggregation(as, `${foreignFieldPrefix}${foreignField}`)\n        }\n\n        if (limitJoin > 0) {\n          aggregate.push({\n            $addFields: {\n              [`${as}.docs`]: {\n                $slice: [`$${as}.docs`, limitJoin],\n              },\n            },\n          })\n        }\n      }\n    }\n  }\n\n  return aggregate\n}\n"],"names":["APIError","appendVersionToQueryKey","buildVersionCollectionFields","combineQueries","getQueryDraftsSort","fieldShouldBeLocalized","hasDraftsEnabled","buildQuery","buildSortParam","getCollection","buildJoinAggregation","adapter","collection","collectionConfig","draftsEnabled","joins","locale","projection","versions","useJoinAggregations","Object","keys","length","polymorphicJoins","joinConfig","payload","collections","config","aggregate","polymorphicJoinsConfig","join","joinPath","count","limit","limitJoin","field","defaultLimit","page","sort","sortJoin","defaultSort","where","whereJoin","aggregatedFields","collectionSlug","flattenedFields","some","eachField","name","push","fields","timestamps","$match","sortProperty","sortDirection","projectSort","aliases","as","alias","basePipeline","$addFields","relationTo","$literal","$and","$expr","$eq","on","Model","JoinModel","$lookup","from","let","root_id_","pipeline","$sort","$limit","$project","value","$count","$concatArrays","map","$add","$ifNull","$first","$set","$sortArray","input","sortBy","sliceValue","$gt","$size","Number","MAX_VALUE","$slice","slug","joinsList","projectionPath","toString","useDrafts","Array","isArray","Error","latest","equals","$skip","polymorphicSuffix","targetField","addTotalDocsAggregation","foreignField","localField","foreignFieldPrefix","localization","localeCodes","forEach","code","$map","in","localeSuffix","parentIsLocalized","getForeignPath"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/buildJoinAggregation.ts"],"sourcesContent":["import type { PipelineStage } from 'mongoose'\n\nimport {\n  APIError,\n  appendVersionToQueryKey,\n  buildVersionCollectionFields,\n  type CollectionSlug,\n  combineQueries,\n  type FlattenedField,\n  getBranchPredicateSync,\n  getQueryDraftsSort,\n  type JoinQuery,\n  type PayloadRequest,\n  resolveBranchReadState,\n  resolveBranchVersionQuery,\n  rewriteBranchIDs,\n  rewriteBranchVersionParents,\n  type SanitizedCollectionConfig,\n  type Where,\n} from 'payload'\nimport { fieldShouldBeLocalized, hasDraftsEnabled } from 'payload/shared'\n\nimport type { MongooseAdapter } from '../index.js'\nimport type { CollectionModel } from '../types.js'\n\nimport { buildBranchVisibilityStages } from '../queries/buildBranchVisibility.js'\nimport { buildQuery } from '../queries/buildQuery.js'\nimport { buildSortParam } from '../queries/buildSortParam.js'\nimport { getCollection } from './getEntity.js'\n\ntype BuildJoinAggregationArgs = {\n  adapter: MongooseAdapter\n  branch?: false | string\n  collection: CollectionSlug\n  collectionConfig: SanitizedCollectionConfig\n  draftsEnabled?: boolean\n  joins?: JoinQuery\n  locale?: string\n  projection?: Record<string, true>\n  // the where clause for the top collection\n  query?: Record<string, unknown>\n  req?: Partial<PayloadRequest>\n  /** whether the query is from drafts */\n  versions?: boolean\n}\n\nexport const buildJoinAggregation = async ({\n  adapter,\n  branch,\n  collection,\n  collectionConfig,\n  draftsEnabled,\n  joins,\n  locale,\n  projection,\n  req,\n  versions,\n}: BuildJoinAggregationArgs): Promise<PipelineStage[]> => {\n  if (!adapter.useJoinAggregations) {\n    return []\n  }\n  if (\n    (Object.keys(collectionConfig.joins).length === 0 &&\n      collectionConfig.polymorphicJoins.length == 0) ||\n    joins === false\n  ) {\n    return []\n  }\n\n  const joinConfig = adapter.payload.collections[collection]?.config?.joins\n\n  if (!joinConfig) {\n    throw new APIError(`Could not retrieve sanitized join config for ${collection}.`)\n  }\n\n  const aggregate: PipelineStage[] = []\n  const polymorphicJoinsConfig = adapter.payload.collections[collection]?.config?.polymorphicJoins\n\n  if (!polymorphicJoinsConfig) {\n    throw new APIError(`Could not retrieve sanitized polymorphic joins config for ${collection}.`)\n  }\n\n  for (const join of polymorphicJoinsConfig) {\n    if (projection && !projection[join.joinPath]) {\n      continue\n    }\n\n    if (joins?.[join.joinPath] === false) {\n      continue\n    }\n\n    const {\n      count = false,\n      limit: limitJoin = join.field.defaultLimit ?? 10,\n      page,\n      sort: sortJoin = join.field.defaultSort || collectionConfig.defaultSort,\n      where: whereJoin = {},\n    } = joins?.[join.joinPath] || {}\n\n    const aggregatedFields: FlattenedField[] = []\n    for (const collectionSlug of join.field.collection) {\n      const { collectionConfig } = getCollection({ adapter, collectionSlug })\n\n      for (const field of collectionConfig.flattenedFields) {\n        if (!aggregatedFields.some((eachField) => eachField.name === field.name)) {\n          aggregatedFields.push(field)\n        }\n      }\n    }\n\n    const sort = buildSortParam({\n      adapter,\n      config: adapter.payload.config,\n      fields: aggregatedFields,\n      locale,\n      sort: sortJoin,\n      timestamps: true,\n    })\n\n    const $match = await buildQuery({\n      adapter,\n      branch,\n      fields: aggregatedFields,\n      locale,\n      req,\n      where: whereJoin,\n    })\n\n    const sortProperty = Object.keys(sort)[0]! // assert because buildSortParam always returns at least 1 key.\n    const sortDirection = sort[sortProperty] === 'asc' ? 1 : -1\n\n    const projectSort = sortProperty !== '_id' && sortProperty !== 'relationTo'\n\n    const aliases: string[] = []\n\n    const as = join.joinPath\n\n    for (const collectionSlug of join.field.collection) {\n      const alias = `${as}.docs.${collectionSlug}`\n      aliases.push(alias)\n\n      const joinBranchPredicate = getBranchPredicateSync({\n        branch,\n        collectionSlug,\n        req,\n      })\n      const joinBranchReadState = resolveBranchReadState({\n        branch,\n        collectionSlug,\n        req,\n      })\n      const branchMatch = joinBranchPredicate\n        ? await buildQuery({\n            adapter,\n            branch,\n            fields: adapter.payload.collections[collectionSlug]!.config.flattenedFields,\n            locale,\n            req,\n            where: joinBranchPredicate,\n          })\n        : undefined\n      const branchVisibility = joinBranchReadState.useBranching\n        ? buildBranchVisibilityStages({\n            adapter,\n            branch: joinBranchReadState.branch,\n            collectionSlug,\n          })\n        : []\n      const basePipeline: Exclude<PipelineStage, PipelineStage.Merge | PipelineStage.Out>[] = [\n        {\n          $addFields: {\n            relationTo: {\n              $literal: collectionSlug,\n            },\n          },\n        },\n        {\n          $match: {\n            $and: [\n              {\n                $expr: {\n                  $eq: [`$${join.field.on}`, '$$root_id_'],\n                },\n              },\n              $match,\n              ...(branchMatch ? [branchMatch] : []),\n            ],\n          },\n        },\n        ...branchVisibility,\n        ...(joinBranchPredicate || branchVisibility.length\n          ? ([{ $set: { _id: { $ifNull: ['$_branchDocID', '$_id'] } } }] as Exclude<\n              PipelineStage,\n              PipelineStage.Merge | PipelineStage.Out\n            >[])\n          : []),\n      ]\n\n      const { Model: JoinModel } = getCollection({ adapter, collectionSlug })\n\n      aggregate.push({\n        $lookup: {\n          as: alias,\n          from: JoinModel.collection.name,\n          let: {\n            root_id_: '$_id',\n          },\n          pipeline: [\n            ...basePipeline,\n            {\n              $sort: {\n                [sortProperty]: sortDirection,\n              },\n            },\n            {\n              // Unfortunately, we can't use $skip here because we can lose data, instead we do $slice then\n              $limit: page ? page * limitJoin : limitJoin,\n            },\n            {\n              $project: {\n                value: '$_id',\n                ...(projectSort && {\n                  [sortProperty]: 1,\n                }),\n                relationTo: 1,\n              },\n            },\n          ],\n        },\n      })\n\n      if (count) {\n        aggregate.push({\n          $lookup: {\n            as: `${as}.totalDocs.${alias}`,\n            from: JoinModel.collection.name,\n            let: {\n              root_id_: '$_id',\n            },\n            pipeline: [\n              ...basePipeline,\n              {\n                $count: 'result',\n              },\n            ],\n          },\n        })\n      }\n    }\n\n    aggregate.push({\n      $addFields: {\n        [`${as}.docs`]: {\n          $concatArrays: aliases.map((alias) => `$${alias}`),\n        },\n      },\n    })\n\n    if (count) {\n      aggregate.push({\n        $addFields: {\n          [`${as}.totalDocs`]: {\n            $add: aliases.map((alias) => ({\n              $ifNull: [\n                {\n                  $first: `$${as}.totalDocs.${alias}.result`,\n                },\n                0,\n              ],\n            })),\n          },\n        },\n      })\n    }\n\n    aggregate.push({\n      $set: {\n        [`${as}.docs`]: {\n          $sortArray: {\n            input: `$${as}.docs`,\n            sortBy: {\n              [sortProperty]: sortDirection,\n            },\n          },\n        },\n      },\n    })\n\n    const sliceValue = page ? [(page - 1) * limitJoin, limitJoin] : [limitJoin]\n\n    aggregate.push({\n      $addFields: {\n        [`${as}.hasNextPage`]: {\n          $gt: [{ $size: `$${as}.docs` }, limitJoin || Number.MAX_VALUE],\n        },\n      },\n    })\n\n    aggregate.push({\n      $set: {\n        [`${as}.docs`]: {\n          $slice: [`$${as}.docs`, ...sliceValue],\n        },\n      },\n    })\n  }\n\n  for (const slug of Object.keys(joinConfig)) {\n    const joinsList = joinConfig[slug]\n\n    if (!joinsList) {\n      throw new APIError(`Failed to retrieve array of joins for ${slug} in collectio ${collection}`)\n    }\n\n    for (const join of joinsList) {\n      const projectionPath = versions ? `version.${join.joinPath}` : join.joinPath\n      if (projection && !projection[projectionPath]) {\n        continue\n      }\n\n      if (joins?.[join.joinPath] === false) {\n        continue\n      }\n\n      const collectionConfig = adapter.payload.collections[join.field.collection as string]?.config\n\n      if (!collectionConfig) {\n        throw new APIError(\n          `Collection config for ${join.field.collection.toString()} was not found`,\n        )\n      }\n\n      let JoinModel: CollectionModel | undefined\n\n      const useDrafts = (draftsEnabled || versions) && hasDraftsEnabled(collectionConfig)\n\n      if (useDrafts) {\n        JoinModel = adapter.versions[collectionConfig.slug]\n      } else {\n        JoinModel = adapter.collections[collectionConfig.slug]\n      }\n\n      if (!JoinModel) {\n        throw new APIError(`Join Model was not found for ${collectionConfig.slug}`)\n      }\n\n      const {\n        count,\n        limit: limitJoin = join.field.defaultLimit ?? 10,\n        page,\n        sort: sortJoin = join.field.defaultSort || collectionConfig.defaultSort,\n        where: whereJoin = {},\n      } = joins?.[join.joinPath] || {}\n\n      if (Array.isArray(join.field.collection)) {\n        throw new Error('Unreachable')\n      }\n\n      const fields = useDrafts\n        ? buildVersionCollectionFields(adapter.payload.config, collectionConfig, true)\n        : collectionConfig.flattenedFields\n\n      const sort = buildSortParam({\n        adapter,\n        config: adapter.payload.config,\n        fields,\n        locale,\n        sort: useDrafts ? getQueryDraftsSort({ collectionConfig, sort: sortJoin }) : sortJoin,\n        timestamps: true,\n      })\n      const sortProperty = Object.keys(sort)[0]!\n      const sortDirection = sort[sortProperty] === 'asc' ? 1 : -1\n\n      // A join subquery must carry the same branch predicate as the top-level\n      // read, or a branch would see main's related documents.\n      const joinBranchPredicate = getBranchPredicateSync({\n        branch,\n        collectionSlug: collectionConfig.slug,\n        req,\n      })\n      const joinBranchReadState = resolveBranchReadState({\n        branch,\n        collectionSlug: collectionConfig.slug,\n        req,\n      })\n\n      const resolvedWhereJoin = useDrafts\n        ? joinBranchReadState.useBranching\n          ? (rewriteBranchVersionParents(appendVersionToQueryKey(whereJoin)) ?? {})\n          : ((await resolveBranchVersionQuery({\n              branch,\n              collectionSlug: collectionConfig.slug,\n              req,\n              where: appendVersionToQueryKey(whereJoin),\n            })) ?? {})\n        : joinBranchReadState.useBranching\n          ? (rewriteBranchIDs(whereJoin) ?? {})\n          : joinBranchPredicate\n            ? ({ and: [whereJoin, joinBranchPredicate] } as Where)\n            : whereJoin\n\n      const $match = await JoinModel.buildQuery({\n        branch,\n        locale,\n        payload: adapter.payload,\n        req,\n        where: useDrafts\n          ? combineQueries(resolvedWhereJoin, {\n              latest: {\n                equals: true,\n              },\n            })\n          : resolvedWhereJoin,\n      })\n      const branchVisibility = joinBranchReadState.useBranching\n        ? buildBranchVisibilityStages({\n            adapter,\n            branch: joinBranchReadState.branch,\n            collectionSlug: collectionConfig.slug,\n            mode: useDrafts ? 'drafts' : 'documents',\n          })\n        : []\n\n      const pipeline: Exclude<PipelineStage, PipelineStage.Merge | PipelineStage.Out>[] = [\n        { $match },\n        ...branchVisibility,\n        // Surface the canonical document ID rather than the shadow row's own\n        // primary key, so join results address documents the same way every\n        // other read does.\n        ...(joinBranchPredicate || branchVisibility.length\n          ? ([\n              useDrafts\n                ? { $set: { parent: { $ifNull: ['$_branchParent', '$parent'] } } }\n                : { $set: { _id: { $ifNull: ['$_branchDocID', '$_id'] } } },\n            ] as Exclude<PipelineStage, PipelineStage.Merge | PipelineStage.Out>[])\n          : []),\n        {\n          $sort: { [sortProperty]: sortDirection },\n        },\n      ]\n\n      if (page) {\n        pipeline.push({\n          $skip: (page - 1) * limitJoin,\n        })\n      }\n\n      if (limitJoin > 0) {\n        pipeline.push({\n          $limit: limitJoin + 1,\n        })\n      }\n\n      let polymorphicSuffix = ''\n      if (Array.isArray(join.targetField.relationTo)) {\n        polymorphicSuffix = '.value'\n      }\n\n      const addTotalDocsAggregation = (as: string, foreignField: string) =>\n        aggregate.push(\n          {\n            $lookup: {\n              as: `${as}.totalDocs`,\n              foreignField,\n              from: JoinModel.collection.name,\n              localField: versions ? 'parent' : '_id',\n              pipeline: [\n                {\n                  $match,\n                },\n                ...branchVisibility,\n                {\n                  $count: 'result',\n                },\n              ],\n            },\n          },\n          {\n            $addFields: {\n              [`${as}.totalDocs`]: { $ifNull: [{ $first: `$${as}.totalDocs.result` }, 0] },\n            },\n          },\n        )\n\n      let foreignFieldPrefix = ''\n\n      if (useDrafts) {\n        foreignFieldPrefix = 'version.'\n      }\n\n      if (adapter.payload.config.localization && locale === 'all') {\n        adapter.payload.config.localization.localeCodes.forEach((code) => {\n          const as = `${versions ? `version.${join.joinPath}` : join.joinPath}${code}`\n\n          aggregate.push(\n            {\n              $lookup: {\n                as: `${as}.docs`,\n                foreignField: `${foreignFieldPrefix}${join.field.on}${code}${polymorphicSuffix}`,\n                from: JoinModel.collection.name,\n                localField: versions ? 'parent' : '_id',\n                pipeline,\n              },\n            },\n            {\n              $addFields: {\n                [`${as}.docs`]: {\n                  $map: {\n                    as: 'doc',\n                    in: useDrafts ? `$$doc.parent` : '$$doc._id',\n                    input: `$${as}.docs`,\n                  },\n                }, // Slicing the docs to match the limit\n                [`${as}.hasNextPage`]: limitJoin\n                  ? { $gt: [{ $size: `$${as}.docs` }, limitJoin] }\n                  : false,\n                // Boolean indicating if more docs than limit\n              },\n            },\n          )\n\n          if (limitJoin > 0) {\n            aggregate.push({\n              $addFields: {\n                [`${as}.docs`]: {\n                  $slice: [`$${as}.docs`, limitJoin],\n                },\n              },\n            })\n          }\n\n          if (count) {\n            addTotalDocsAggregation(\n              as,\n              `${foreignFieldPrefix}${join.field.on}${code}${polymorphicSuffix}`,\n            )\n          }\n        })\n      } else {\n        const localeSuffix =\n          fieldShouldBeLocalized({\n            field: join.field,\n            parentIsLocalized: join.parentIsLocalized,\n          }) &&\n          adapter.payload.config.localization &&\n          locale\n            ? `.${locale}`\n            : ''\n        const as = `${versions ? `version.${join.joinPath}` : join.joinPath}${localeSuffix}`\n\n        let foreignField: string\n\n        if (join.getForeignPath) {\n          foreignField = `${join.getForeignPath({ locale })}${polymorphicSuffix}`\n        } else {\n          foreignField = `${join.field.on}${polymorphicSuffix}`\n        }\n\n        aggregate.push(\n          {\n            $lookup: {\n              as: `${as}.docs`,\n              foreignField: `${foreignFieldPrefix}${foreignField}`,\n              from: JoinModel.collection.name,\n              localField: versions ? 'parent' : '_id',\n              pipeline,\n            },\n          },\n          {\n            $addFields: {\n              [`${as}.docs`]: {\n                $map: {\n                  as: 'doc',\n                  in: useDrafts ? `$$doc.parent` : '$$doc._id',\n                  input: `$${as}.docs`,\n                },\n              }, // Slicing the docs to match the limit\n              [`${as}.hasNextPage`]: {\n                $gt: [{ $size: `$${as}.docs` }, limitJoin || Number.MAX_VALUE],\n              }, // Boolean indicating if more docs than limit\n            },\n          },\n        )\n\n        if (count) {\n          addTotalDocsAggregation(as, `${foreignFieldPrefix}${foreignField}`)\n        }\n\n        if (limitJoin > 0) {\n          aggregate.push({\n            $addFields: {\n              [`${as}.docs`]: {\n                $slice: [`$${as}.docs`, limitJoin],\n              },\n            },\n          })\n        }\n      }\n    }\n  }\n\n  return aggregate\n}\n"],"names":["APIError","appendVersionToQueryKey","buildVersionCollectionFields","combineQueries","getBranchPredicateSync","getQueryDraftsSort","resolveBranchReadState","resolveBranchVersionQuery","rewriteBranchIDs","rewriteBranchVersionParents","fieldShouldBeLocalized","hasDraftsEnabled","buildBranchVisibilityStages","buildQuery","buildSortParam","getCollection","buildJoinAggregation","adapter","branch","collection","collectionConfig","draftsEnabled","joins","locale","projection","req","versions","useJoinAggregations","Object","keys","length","polymorphicJoins","joinConfig","payload","collections","config","aggregate","polymorphicJoinsConfig","join","joinPath","count","limit","limitJoin","field","defaultLimit","page","sort","sortJoin","defaultSort","where","whereJoin","aggregatedFields","collectionSlug","flattenedFields","some","eachField","name","push","fields","timestamps","$match","sortProperty","sortDirection","projectSort","aliases","as","alias","joinBranchPredicate","joinBranchReadState","branchMatch","undefined","branchVisibility","useBranching","basePipeline","$addFields","relationTo","$literal","$and","$expr","$eq","on","$set","_id","$ifNull","Model","JoinModel","$lookup","from","let","root_id_","pipeline","$sort","$limit","$project","value","$count","$concatArrays","map","$add","$first","$sortArray","input","sortBy","sliceValue","$gt","$size","Number","MAX_VALUE","$slice","slug","joinsList","projectionPath","toString","useDrafts","Array","isArray","Error","resolvedWhereJoin","and","latest","equals","mode","parent","$skip","polymorphicSuffix","targetField","addTotalDocsAggregation","foreignField","localField","foreignFieldPrefix","localization","localeCodes","forEach","code","$map","in","localeSuffix","parentIsLocalized","getForeignPath"],"mappings":"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"}

package/dist/utilities/resolveJoins.d.ts

@@ -1,8 +1,10 @@
-import type { JoinQuery } from 'payload';
+import type { JoinQuery, PayloadRequest } from 'payload';
 import type { MongooseAdapter } from '../index.js';
 export type ResolveJoinsArgs = {
     /** The MongoDB adapter instance */
     adapter: MongooseAdapter;
+    /** Explicit branch override for related document reads */
+    branch?: false | string;
     /** The slug of the collection being queried */
     collectionSlug: string;
     /** Array of documents to resolve joins for */
@@ -13,6 +15,8 @@ export type ResolveJoinsArgs = {
     locale?: string;
     /** Optional projection for the join query */
     projection?: Record<string, true>;
+    /** Request, for resolving the active branch */
+    req?: Partial<PayloadRequest>;
     /** Whether to resolve versions instead of published documents */
     versions?: boolean;
 };
@@ -21,5 +25,5 @@ export type ResolveJoinsArgs = {
  * This function fetches related documents based on join configurations and
  * attaches them to the original documents with pagination support.
  */
-export declare function resolveJoins({ adapter, collectionSlug, docs, joins, locale, projection, versions, }: ResolveJoinsArgs): Promise<void>;
+export declare function resolveJoins({ adapter, branch, collectionSlug, docs, joins, locale, projection, req, versions, }: ResolveJoinsArgs): Promise<void>;
 //# sourceMappingURL=resolveJoins.d.ts.map

package/dist/utilities/resolveJoins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveJoins.d.ts","sourceRoot":"","sources":["../../src/utilities/resolveJoins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAyB,MAAM,SAAS,CAAA;AAU/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAMlD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mCAAmC;IACnC,OAAO,EAAE,eAAe,CAAA;IACxB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,EACjC,OAAO,EACP,cAAc,EACd,IAAI,EACJ,KAAK,EACL,MAAM,EACN,UAAU,EACV,QAAgB,GACjB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6YlC"}
+{"version":3,"file":"resolveJoins.d.ts","sourceRoot":"","sources":["../../src/utilities/resolveJoins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAyB,MAAM,SAAS,CAAA;AAiB/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mCAAmC;IACnC,OAAO,EAAE,eAAe,CAAA;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACjC,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,EACjC,OAAO,EACP,MAAM,EACN,cAAc,EACd,IAAI,EACJ,KAAK,EACL,MAAM,EACN,UAAU,EACV,GAAG,EACH,QAAgB,GACjB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4dlC"}

package/dist/utilities/resolveJoins.js

@@ -1,5 +1,6 @@
-import { appendVersionToQueryKey, buildVersionCollectionFields, combineQueries, getQueryDraftsSort } from 'payload';
+import { appendVersionToQueryKey, applyBranchIDProjection, buildVersionCollectionFields, combineQueries, getBranchPredicateSync, getQueryDraftsSort, projectBranchVersionParent, resolveBranchReadState, resolveBranchVersionQuery, rewriteBranchIDs, rewriteBranchVersionParents } from 'payload';
 import { fieldShouldBeLocalized } from 'payload/shared';
+import { buildBranchVisibilityStages } from '../queries/buildBranchVisibility.js';
 import { buildQuery } from '../queries/buildQuery.js';
 import { buildSortParam } from '../queries/buildSortParam.js';
 import { transform } from './transform.js';
@@ -7,7 +8,7 @@ import { transform } from './transform.js';
  * Resolves join relationships for a collection of documents.
  * This function fetches related documents based on join configurations and
  * attaches them to the original documents with pagination support.
- */ export async function resolveJoins({ adapter, collectionSlug, docs, joins, locale, projection, versions = false }) {
+ */ export async function resolveJoins({ adapter, branch, collectionSlug, docs, joins, locale, projection, req, versions = false }) {
     // Early return if no joins are specified or no documents to process
     if (!joins || docs.length === 0) {
         return;
@@ -85,7 +86,7 @@ import { transform } from './transform.js';
                 return null;
             }
             // Extract all parent document IDs to use in the join query
-            const parentIDs = docs.map((d)=>versions ? d.parent ?? d._id ?? d.id : d._id ?? d.id);
+            const parentIDs = docs.map((doc)=>versions ? projectBranchVersionParent(doc) : doc._id ?? doc.id);
             // Build the base query
             let whereQuery = null;
             whereQuery = isPolymorphicJoin ? filterWhereForCollection(joinQuery.where || {}, targetConfig.flattenedFields, true) : joinQuery.where || {};
@@ -93,21 +94,57 @@ import { transform } from './transform.js';
             if (whereQuery === null) {
                 return null;
             }
-            whereQuery = useDrafts ? await JoinModel.buildQuery({
-                locale,
-                payload: adapter.payload,
-                where: combineQueries(appendVersionToQueryKey(whereQuery), {
-                    latest: {
-                        equals: true
-                    }
-                })
-            }) : await buildQuery({
-                adapter,
+            // A join subquery must carry the same branch predicate as the top-level
+            // read, or a branch would see main's related documents.
+            const joinBranchPredicate = getBranchPredicateSync({
+                branch,
                 collectionSlug: joinCollectionSlug,
-                fields: targetConfig.flattenedFields,
-                locale,
-                where: whereQuery
+                req
+            });
+            const joinBranchReadState = resolveBranchReadState({
+                branch,
+                collectionSlug: joinCollectionSlug,
+                req
             });
+            if (useDrafts) {
+                const branchVersionWhere = joinBranchReadState.useBranching ? rewriteBranchVersionParents(appendVersionToQueryKey(whereQuery)) : await resolveBranchVersionQuery({
+                    branch,
+                    collectionSlug: joinCollectionSlug,
+                    req,
+                    where: appendVersionToQueryKey(whereQuery)
+                });
+                whereQuery = await JoinModel.buildQuery({
+                    branch,
+                    locale,
+                    payload: adapter.payload,
+                    req,
+                    where: combineQueries(branchVersionWhere ?? {}, {
+                        latest: {
+                            equals: true
+                        }
+                    })
+                });
+            } else {
+                if (joinBranchReadState.useBranching) {
+                    whereQuery = rewriteBranchIDs(whereQuery) ?? {};
+                } else if (joinBranchPredicate) {
+                    whereQuery = {
+                        and: [
+                            whereQuery,
+                            joinBranchPredicate
+                        ]
+                    };
+                }
+                whereQuery = await buildQuery({
+                    adapter,
+                    branch,
+                    collectionSlug: joinCollectionSlug,
+                    fields: targetConfig.flattenedFields,
+                    locale,
+                    req,
+                    where: whereQuery
+                });
+            }
             // Handle localized paths and version prefixes
             let dbFieldName = joinDef.field.on;
             if (effectiveLocale && typeof localizationConfig === 'object' && localizationConfig) {
@@ -156,8 +193,49 @@ import { transform } from './transform.js';
                 }) : joinQuery.sort || joinDef.field.defaultSort || targetConfig.defaultSort,
                 timestamps: true
             });
-            const projection = buildJoinProjection(dbFieldName, useDrafts, sort);
-            const [results, dbCount] = await Promise.all([
+            const projection = buildJoinProjection(dbFieldName, useDrafts, sort, Boolean(joinBranchPredicate) || joinBranchReadState.useBranching);
+            const branchVisibility = joinBranchReadState.useBranching ? buildBranchVisibilityStages({
+                adapter,
+                branch: joinBranchReadState.branch,
+                collectionSlug: joinCollectionSlug,
+                mode: useDrafts ? 'drafts' : 'documents'
+            }) : [];
+            const [results, dbCount] = branchVisibility.length ? await Promise.all([
+                JoinModel.aggregate([
+                    {
+                        $match: whereQuery
+                    },
+                    ...branchVisibility,
+                    {
+                        $sort: Object.fromEntries(Object.entries(sort).map(([key, value])=>[
+                                key,
+                                value === 'asc' ? 1 : -1
+                            ]))
+                    },
+                    ...isPolymorphicJoin ? [] : [
+                        {
+                            $skip: skip
+                        },
+                        ...limit > 0 ? [
+                            {
+                                $limit: limit
+                            }
+                        ] : []
+                    ],
+                    {
+                        $project: projection
+                    }
+                ]),
+                isPolymorphicJoin ? Promise.resolve(0) : JoinModel.aggregate([
+                    {
+                        $match: whereQuery
+                    },
+                    ...branchVisibility,
+                    {
+                        $count: 'count'
+                    }
+                ]).then((rows)=>rows[0]?.count ?? 0)
+            ]) : await Promise.all([
                 JoinModel.find(whereQuery, projection, {
                     sort,
                     ...isPolymorphicJoin ? {} : {
@@ -174,14 +252,24 @@ import { transform } from './transform.js';
                 fields: useDrafts ? buildVersionCollectionFields(adapter.payload.config, targetConfig, false) : targetConfig.fields,
                 operation: 'read'
             });
+            if (useDrafts) {
+                for (const result of results){
+                    result.id = projectBranchVersionParent(result);
+                }
+            } else {
+                applyBranchIDProjection({
+                    collectionSlug: joinCollectionSlug,
+                    docs: results,
+                    req
+                });
+            }
             // Return results with collection info for grouping
             return {
                 collectionSlug: joinCollectionSlug,
                 count,
                 dbFieldName,
                 results,
-                sort,
-                useDrafts
+                sort
             };
         });
         const collectionResults = await Promise.all(collectionPromises);
@@ -192,12 +280,9 @@ import { transform } from './transform.js';
             if (!collectionResult) {
                 continue;
             }
-            const { collectionSlug, count, dbFieldName, results, sort, useDrafts } = collectionResult;
+            const { collectionSlug, count, dbFieldName, results, sort } = collectionResult;
             totalCount += count;
             for (const result of results){
-                if (useDrafts) {
-                    result.id = result.parent;
-                }
                 const parentValues = getByPathWithArrays(result, dbFieldName);
                 if (parentValues.length === 0) {
                     continue;
@@ -273,7 +358,7 @@ import { transform } from './transform.js';
         const { grouped, isPolymorphicJoin, joinQuery, limit, localizedJoinPath, skip, totalCount } = joinResult;
         // Attach the joined data to each parent document
         for (const doc of docs){
-            const id = versions ? doc.parent ?? doc._id ?? doc.id : doc._id ?? doc.id;
+            const id = versions ? projectBranchVersionParent(doc) : doc._id ?? doc.id;
             const all = grouped[id]?.docs || [];
             // Calculate the slice for pagination
             // When limit is 0, it means unlimited - return all results
@@ -437,7 +522,7 @@ import { transform } from './transform.js';
 }
 /**
  * Builds projection for join queries
- */ function buildJoinProjection(baseFieldName, useDrafts, sort) {
+ */ function buildJoinProjection(baseFieldName, useDrafts, sort, shouldProjectBranchID) {
     const projection = {
         _id: 1,
         [baseFieldName]: 1
@@ -445,6 +530,9 @@ import { transform } from './transform.js';
     if (useDrafts) {
         projection.parent = 1;
     }
+    if (shouldProjectBranchID) {
+        projection[useDrafts ? '_branchParent' : '_branchDocID'] = 1;
+    }
     for (const fieldName of Object.keys(sort)){
         projection[fieldName] = 1;
     }