payload 3.84.1 → 4.0.0-internal.d28e9fb

package/dist/globals/operations/update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/globals/operations/update.ts"],"sourcesContent":["import type { DeepPartial } from 'ts-essentials'\n\nimport type { FindOptions } from '../../collections/operations/local/find.js'\nimport type { GlobalSlug, JsonObject } from '../../index.js'\nimport type {\n  Operation,\n  PayloadRequest,\n  PopulateType,\n  SelectType,\n  TransformGlobalWithSelect,\n  Where,\n} from '../../types/index.js'\nimport type {\n  DataFromGlobalSlug,\n  SanitizedGlobalConfig,\n  SelectFromGlobalSlug,\n} from '../config/types.js'\n\nimport { executeAccess } from '../../auth/executeAccess.js'\nimport { afterChange } from '../../fields/hooks/afterChange/index.js'\nimport { afterRead } from '../../fields/hooks/afterRead/index.js'\nimport { beforeChange } from '../../fields/hooks/beforeChange/index.js'\nimport { beforeValidate } from '../../fields/hooks/beforeValidate/index.js'\nimport { deepCopyObjectSimple } from '../../index.js'\nimport { checkDocumentLockStatus } from '../../utilities/checkDocumentLockStatus.js'\nimport { commitTransaction } from '../../utilities/commitTransaction.js'\nimport { getSelectMode } from '../../utilities/getSelectMode.js'\nimport {\n  hasDraftsEnabled,\n  hasDraftValidationEnabled,\n  hasLocalizeStatusEnabled,\n} from '../../utilities/getVersionsConfig.js'\nimport { initTransaction } from '../../utilities/initTransaction.js'\nimport { killTransaction } from '../../utilities/killTransaction.js'\nimport { mergeLocalizedData } from '../../utilities/mergeLocalizedData.js'\nimport { sanitizeSelect } from '../../utilities/sanitizeSelect.js'\nimport { getLatestGlobalVersion } from '../../versions/getLatestGlobalVersion.js'\nimport { saveVersion } from '../../versions/saveVersion.js'\ntype Args<TSlug extends GlobalSlug> = {\n  autosave?: boolean\n  data: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>\n  depth?: number\n  disableTransaction?: boolean\n  draft?: boolean\n  globalConfig: SanitizedGlobalConfig\n  overrideAccess?: boolean\n  overrideLock?: boolean\n  populate?: PopulateType\n  publishAllLocales?: boolean\n  publishSpecificLocale?: string\n  req: PayloadRequest\n  showHiddenFields?: boolean\n  slug: string\n  unpublishAllLocales?: boolean\n} & Pick<FindOptions<string, SelectType>, 'select'>\n\nexport const updateOperation = async <\n  TSlug extends GlobalSlug,\n  TSelect extends SelectFromGlobalSlug<TSlug>,\n>(\n  args: Args<TSlug>,\n): Promise<TransformGlobalWithSelect<TSlug, TSelect>> => {\n  if (args.publishSpecificLocale) {\n    args.req.locale = args.publishSpecificLocale\n  }\n\n  const {\n    slug,\n    autosave,\n    depth,\n    disableTransaction,\n    draft: draftArg,\n    globalConfig,\n    overrideAccess,\n    overrideLock,\n    populate,\n    publishAllLocales: publishAllLocalesArg,\n    publishSpecificLocale,\n    req: { fallbackLocale, locale, payload, payload: { config } = {} },\n    req,\n    select: incomingSelect,\n    showHiddenFields,\n    unpublishAllLocales: unpublishAllLocalesArg,\n  } = args\n\n  try {\n    const shouldCommit = !disableTransaction && (await initTransaction(req))\n\n    // /////////////////////////////////////\n    // beforeOperation - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeOperation?.length) {\n      for (const hook of globalConfig.hooks.beforeOperation) {\n        args =\n          (await hook({\n            args,\n            context: args.req.context,\n            global: globalConfig,\n            operation: 'update',\n            overrideAccess,\n            req: args.req,\n          })) || args\n      }\n    }\n\n    let { data } = args\n\n    const publishAllLocales =\n      !draftArg && (publishAllLocalesArg ?? (hasLocalizeStatusEnabled(globalConfig) ? false : true))\n    const unpublishAllLocales =\n      typeof unpublishAllLocalesArg === 'string'\n        ? unpublishAllLocalesArg === 'true'\n        : !!unpublishAllLocalesArg\n    const isSavingDraft =\n      Boolean(draftArg && hasDraftsEnabled(globalConfig)) &&\n      data._status !== 'published' &&\n      !publishAllLocales\n\n    if (isSavingDraft) {\n      data._status = 'draft'\n    }\n\n    // /////////////////////////////////////\n    // 1. Retrieve and execute access\n    // /////////////////////////////////////\n\n    const accessResults = !overrideAccess\n      ? await executeAccess(\n          {\n            data,\n            req,\n          },\n          globalConfig.access.update,\n        )\n      : true\n\n    // /////////////////////////////////////\n    // Retrieve document\n    // /////////////////////////////////////\n\n    const query: Where = overrideAccess ? undefined! : (accessResults as Where)\n\n    // /////////////////////////////////////\n    // 2. Retrieve document\n    // /////////////////////////////////////\n    const globalVersionResult = await getLatestGlobalVersion({\n      slug,\n      config: globalConfig,\n      locale: locale!,\n      payload,\n      req,\n      where: query,\n    })\n    const { global, globalExists } = globalVersionResult || {}\n\n    let globalJSON: JsonObject = {}\n\n    if (globalVersionResult && globalVersionResult.global) {\n      globalJSON = deepCopyObjectSimple(global)\n\n      if (globalJSON._id) {\n        delete globalJSON._id\n      }\n    }\n\n    const originalDoc = await afterRead({\n      collection: null,\n      context: req.context,\n      depth: 0,\n      doc: deepCopyObjectSimple(globalJSON),\n      draft: draftArg!,\n      fallbackLocale: fallbackLocale!,\n      global: globalConfig,\n      locale: locale!,\n      overrideAccess: true,\n      req,\n      showHiddenFields: showHiddenFields!,\n    })\n\n    // ///////////////////////////////////////////\n    // Handle potentially locked global documents\n    // ///////////////////////////////////////////\n\n    await checkDocumentLockStatus({\n      globalSlug: slug,\n      lockErrorMessage: `Global with slug \"${slug}\" is currently locked by another user and cannot be updated.`,\n      overrideLock,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // beforeValidate - Fields\n    // /////////////////////////////////////\n\n    data = await beforeValidate({\n      collection: null,\n      context: req.context,\n      data,\n      doc: originalDoc,\n      global: globalConfig,\n      operation: 'update',\n      overrideAccess: overrideAccess!,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // beforeValidate - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeValidate?.length) {\n      for (const hook of globalConfig.hooks.beforeValidate) {\n        data =\n          (await hook({\n            context: req.context,\n            data,\n            global: globalConfig,\n            originalDoc,\n            overrideAccess,\n            req,\n          })) || data\n      }\n    }\n\n    // /////////////////////////////////////\n    // beforeChange - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeChange?.length) {\n      for (const hook of globalConfig.hooks.beforeChange) {\n        data =\n          (await hook({\n            context: req.context,\n            data,\n            global: globalConfig,\n            originalDoc,\n            overrideAccess,\n            req,\n          })) || data\n      }\n    }\n\n    // /////////////////////////////////////\n    // beforeChange - Fields\n    // /////////////////////////////////////\n\n    const beforeChangeArgs = {\n      collection: null,\n      context: req.context,\n      data,\n      doc: originalDoc,\n      docWithLocales: globalJSON,\n      global: globalConfig,\n      operation: 'update' as Operation,\n      req,\n      skipValidation:\n        (isSavingDraft && !hasDraftValidationEnabled(globalConfig)) ||\n        // Skip validation for unpublish operations — they only change _status, not document data\n        unpublishAllLocales,\n    }\n\n    let result: JsonObject = await beforeChange(beforeChangeArgs)\n    let snapshotToSave: JsonObject | undefined\n\n    // /////////////////////////////////////\n    // Handle Localized Data Merging\n    // /////////////////////////////////////\n\n    if (config && config.localization && globalConfig.versions) {\n      let currentGlobal: JsonObject | null = null\n      let snapshotData: JsonObject | undefined\n\n      if (globalConfig.versions.drafts && globalConfig.versions.drafts.localizeStatus) {\n        if (publishAllLocales || unpublishAllLocales) {\n          let accessibleLocaleCodes = config.localization.localeCodes\n\n          if (config.localization.filterAvailableLocales) {\n            const filteredLocales = await config.localization.filterAvailableLocales({\n              locales: config.localization.locales,\n              req,\n            })\n            accessibleLocaleCodes = filteredLocales.map((locale) =>\n              typeof locale === 'string' ? locale : locale.code,\n            )\n          }\n\n          if (typeof result._status !== 'object' || result._status === null) {\n            result._status = {}\n          }\n\n          for (const localeCode of accessibleLocaleCodes) {\n            result._status[localeCode] = unpublishAllLocales ? 'draft' : 'published'\n          }\n        } else if (!isSavingDraft) {\n          // publishing a single locale\n          currentGlobal = await payload.db.findGlobal({\n            slug: globalConfig.slug,\n            req,\n            where: query,\n          })\n          snapshotData = result\n        }\n      } else if (publishSpecificLocale) {\n        // previous way of publishing a single locale\n        currentGlobal = (\n          await getLatestGlobalVersion({\n            slug,\n            config: globalConfig,\n            payload,\n            published: true,\n            req,\n            where: query,\n          })\n        ).global\n        snapshotData = {\n          ...result,\n          _status: 'draft',\n        }\n      }\n\n      if (snapshotData) {\n        snapshotToSave = deepCopyObjectSimple(snapshotData)\n\n        result = mergeLocalizedData({\n          configBlockReferences: config.blocks,\n          dataWithLocales: result || {},\n          docWithLocales: currentGlobal || {},\n          fields: globalConfig.fields,\n          selectedLocales: [locale!],\n        })\n      }\n    }\n    // /////////////////////////////////////\n    // Update\n    // /////////////////////////////////////\n\n    const select = sanitizeSelect({\n      fields: globalConfig.flattenedFields,\n      forceSelect: globalConfig.forceSelect,\n      select: incomingSelect,\n    })\n\n    if (!isSavingDraft) {\n      const now = new Date().toISOString()\n      // Ensure global has createdAt\n      if (!result.createdAt) {\n        result.createdAt = now\n      }\n\n      // Ensure updatedAt date is always updated\n      result.updatedAt = now\n\n      if (globalExists) {\n        result = await payload.db.updateGlobal({\n          slug,\n          data: result,\n          req,\n          select,\n        })\n      } else {\n        result = await payload.db.createGlobal({\n          slug,\n          data: result,\n          req,\n        })\n      }\n    }\n\n    // /////////////////////////////////////\n    // Create version\n    // /////////////////////////////////////\n    if (globalConfig.versions) {\n      const { globalType } = result\n      result = await saveVersion({\n        autosave,\n        docWithLocales: result,\n        draft: isSavingDraft,\n        global: globalConfig,\n        operation: 'update',\n        payload,\n        publishSpecificLocale,\n        req,\n        select,\n        snapshot: snapshotToSave,\n        unpublish: unpublishAllLocales,\n      })\n\n      result = {\n        ...result,\n        globalType,\n      }\n    }\n\n    // /////////////////////////////////////\n    // Execute globalType field if not selected\n    // /////////////////////////////////////\n    if (select && result.globalType) {\n      const selectMode = getSelectMode(select)\n      if (\n        (selectMode === 'include' && !select['globalType']) ||\n        (selectMode === 'exclude' && select['globalType'] === false)\n      ) {\n        delete result['globalType']\n      }\n    }\n\n    // /////////////////////////////////////\n    // afterRead - Fields\n    // /////////////////////////////////////\n\n    result = await afterRead({\n      collection: null,\n      context: req.context,\n      depth: depth!,\n      doc: result,\n      draft: draftArg!,\n      fallbackLocale: null,\n      global: globalConfig,\n      locale: locale!,\n      overrideAccess: overrideAccess!,\n      populate,\n      req,\n      select,\n      showHiddenFields: showHiddenFields!,\n    })\n\n    // /////////////////////////////////////\n    // afterRead - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.afterRead?.length) {\n      for (const hook of globalConfig.hooks.afterRead) {\n        result =\n          (await hook({\n            context: req.context,\n            doc: result,\n            global: globalConfig,\n            overrideAccess,\n            req,\n          })) || result\n      }\n    }\n\n    // /////////////////////////////////////\n    // afterChange - Fields\n    // /////////////////////////////////////\n\n    result = await afterChange({\n      collection: null,\n      context: req.context,\n      data,\n      doc: result,\n      global: globalConfig,\n      operation: 'update',\n      previousDoc: originalDoc,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // afterChange - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.afterChange?.length) {\n      for (const hook of globalConfig.hooks.afterChange) {\n        result =\n          (await hook({\n            context: req.context,\n            data,\n            doc: result,\n            global: globalConfig,\n            overrideAccess,\n            previousDoc: originalDoc,\n            req,\n          })) || result\n      }\n    }\n\n    // /////////////////////////////////////\n    // Return results\n    // /////////////////////////////////////\n\n    if (shouldCommit) {\n      await commitTransaction(req)\n    }\n\n    return result as TransformGlobalWithSelect<TSlug, TSelect>\n  } catch (error: unknown) {\n    await killTransaction(req)\n    throw error\n  }\n}\n"],"names":["executeAccess","afterChange","afterRead","beforeChange","beforeValidate","deepCopyObjectSimple","checkDocumentLockStatus","commitTransaction","getSelectMode","hasDraftsEnabled","hasDraftValidationEnabled","hasLocalizeStatusEnabled","initTransaction","killTransaction","mergeLocalizedData","sanitizeSelect","getLatestGlobalVersion","saveVersion","updateOperation","args","publishSpecificLocale","req","locale","slug","autosave","depth","disableTransaction","draft","draftArg","globalConfig","overrideAccess","overrideLock","populate","publishAllLocales","publishAllLocalesArg","fallbackLocale","payload","config","select","incomingSelect","showHiddenFields","unpublishAllLocales","unpublishAllLocalesArg","shouldCommit","hooks","beforeOperation","length","hook","context","global","operation","data","isSavingDraft","Boolean","_status","accessResults","access","update","query","undefined","globalVersionResult","where","globalExists","globalJSON","_id","originalDoc","collection","doc","globalSlug","lockErrorMessage","beforeChangeArgs","docWithLocales","skipValidation","result","snapshotToSave","localization","versions","currentGlobal","snapshotData","drafts","localizeStatus","accessibleLocaleCodes","localeCodes","filterAvailableLocales","filteredLocales","locales","map","code","localeCode","db","findGlobal","published","configBlockReferences","blocks","dataWithLocales","fields","selectedLocales","flattenedFields","forceSelect","now","Date","toISOString","createdAt","updatedAt","updateGlobal","createGlobal","globalType","snapshot","unpublish","selectMode","previousDoc","error"],"mappings":"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"}
+{"version":3,"sources":["../../../src/globals/operations/update.ts"],"sourcesContent":["import type { DeepPartial } from 'ts-essentials'\n\nimport type { FindOptions } from '../../collections/operations/local/find.js'\nimport type { GlobalSlug, JsonObject } from '../../index.js'\nimport type {\n  Operation,\n  PayloadRequest,\n  PopulateType,\n  SelectType,\n  TransformGlobalWithSelect,\n  Where,\n} from '../../types/index.js'\nimport type {\n  DataFromGlobalSlug,\n  SanitizedGlobalConfig,\n  SelectFromGlobalSlug,\n} from '../config/types.js'\n\nimport { executeAccess } from '../../auth/executeAccess.js'\nimport { afterChange } from '../../fields/hooks/afterChange/index.js'\nimport { afterRead } from '../../fields/hooks/afterRead/index.js'\nimport { beforeChange } from '../../fields/hooks/beforeChange/index.js'\nimport { beforeValidate } from '../../fields/hooks/beforeValidate/index.js'\nimport { deepCopyObjectSimple } from '../../index.js'\nimport { checkDocumentLockStatus } from '../../utilities/checkDocumentLockStatus.js'\nimport { commitTransaction } from '../../utilities/commitTransaction.js'\nimport { getSelectMode } from '../../utilities/getSelectMode.js'\nimport {\n  hasDraftsEnabled,\n  hasDraftValidationEnabled,\n  hasLocalizeStatusEnabled,\n} from '../../utilities/getVersionsConfig.js'\nimport { initTransaction } from '../../utilities/initTransaction.js'\nimport { killTransaction } from '../../utilities/killTransaction.js'\nimport { mergeLocalizedData } from '../../utilities/mergeLocalizedData.js'\nimport { resolveSelect } from '../../utilities/resolveSelect.js'\nimport { sanitizeSelect } from '../../utilities/sanitizeSelect.js'\nimport { getLatestGlobalVersion } from '../../versions/getLatestGlobalVersion.js'\nimport { saveVersion } from '../../versions/saveVersion.js'\ntype Args<TSlug extends GlobalSlug> = {\n  autosave?: boolean\n  data: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>\n  depth?: number\n  disableTransaction?: boolean\n  draft?: boolean\n  globalConfig: SanitizedGlobalConfig\n  overrideAccess?: boolean\n  overrideLock?: boolean\n  populate?: PopulateType\n  publishAllLocales?: boolean\n  publishSpecificLocale?: string\n  req: PayloadRequest\n  showHiddenFields?: boolean\n  slug: string\n  unpublishAllLocales?: boolean\n} & Pick<FindOptions<string, SelectType>, 'select'>\n\nexport const updateOperation = async <\n  TSlug extends GlobalSlug,\n  TSelect extends SelectFromGlobalSlug<TSlug>,\n>(\n  args: Args<TSlug>,\n): Promise<TransformGlobalWithSelect<TSlug, TSelect>> => {\n  if (args.publishSpecificLocale) {\n    args.req.locale = args.publishSpecificLocale\n  }\n\n  const {\n    slug,\n    autosave,\n    depth,\n    disableTransaction,\n    draft: draftArg,\n    globalConfig,\n    overrideAccess,\n    overrideLock,\n    populate,\n    publishAllLocales: publishAllLocalesArg,\n    publishSpecificLocale,\n    req: { fallbackLocale, locale, payload, payload: { config } = {} },\n    req,\n    select: incomingSelect,\n    showHiddenFields,\n    unpublishAllLocales: unpublishAllLocalesArg,\n  } = args\n\n  try {\n    const shouldCommit = !disableTransaction && (await initTransaction(req))\n\n    // /////////////////////////////////////\n    // beforeOperation - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeOperation?.length) {\n      for (const hook of globalConfig.hooks.beforeOperation) {\n        args =\n          (await hook({\n            args,\n            context: args.req.context,\n            global: globalConfig,\n            operation: 'update',\n            overrideAccess,\n            req: args.req,\n          })) || args\n      }\n    }\n\n    let { data } = args\n\n    const publishAllLocales =\n      !draftArg && (publishAllLocalesArg ?? (hasLocalizeStatusEnabled(globalConfig) ? false : true))\n    const unpublishAllLocales =\n      typeof unpublishAllLocalesArg === 'string'\n        ? unpublishAllLocalesArg === 'true'\n        : !!unpublishAllLocalesArg\n    const isSavingDraft =\n      Boolean(draftArg && hasDraftsEnabled(globalConfig)) &&\n      data._status !== 'published' &&\n      !publishAllLocales\n\n    if (isSavingDraft) {\n      data._status = 'draft'\n    }\n\n    // /////////////////////////////////////\n    // 1. Retrieve and execute access\n    // /////////////////////////////////////\n\n    const accessResults = !overrideAccess\n      ? await executeAccess(\n          {\n            data,\n            req,\n          },\n          globalConfig.access.update,\n        )\n      : true\n\n    // /////////////////////////////////////\n    // Retrieve document\n    // /////////////////////////////////////\n\n    const query: Where = overrideAccess ? undefined! : (accessResults as Where)\n\n    // /////////////////////////////////////\n    // 2. Retrieve document\n    // /////////////////////////////////////\n    const globalVersionResult = await getLatestGlobalVersion({\n      slug,\n      config: globalConfig,\n      locale: locale!,\n      payload,\n      req,\n      where: query,\n    })\n    const { global, globalExists } = globalVersionResult || {}\n\n    let globalJSON: JsonObject = {}\n\n    if (globalVersionResult && globalVersionResult.global) {\n      globalJSON = deepCopyObjectSimple(global)\n\n      if (globalJSON._id) {\n        delete globalJSON._id\n      }\n    }\n\n    const originalDoc = await afterRead({\n      collection: null,\n      context: req.context,\n      depth: 0,\n      doc: deepCopyObjectSimple(globalJSON),\n      draft: draftArg!,\n      fallbackLocale: fallbackLocale!,\n      global: globalConfig,\n      locale: locale!,\n      overrideAccess: true,\n      req,\n      showHiddenFields: showHiddenFields!,\n    })\n\n    // ///////////////////////////////////////////\n    // Handle potentially locked global documents\n    // ///////////////////////////////////////////\n\n    await checkDocumentLockStatus({\n      globalSlug: slug,\n      lockErrorMessage: `Global with slug \"${slug}\" is currently locked by another user and cannot be updated.`,\n      overrideLock,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // beforeValidate - Fields\n    // /////////////////////////////////////\n\n    data = await beforeValidate({\n      collection: null,\n      context: req.context,\n      data,\n      doc: originalDoc,\n      global: globalConfig,\n      operation: 'update',\n      overrideAccess: overrideAccess!,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // beforeValidate - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeValidate?.length) {\n      for (const hook of globalConfig.hooks.beforeValidate) {\n        data =\n          (await hook({\n            context: req.context,\n            data,\n            global: globalConfig,\n            originalDoc,\n            overrideAccess,\n            req,\n          })) || data\n      }\n    }\n\n    // /////////////////////////////////////\n    // beforeChange - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.beforeChange?.length) {\n      for (const hook of globalConfig.hooks.beforeChange) {\n        data =\n          (await hook({\n            context: req.context,\n            data,\n            global: globalConfig,\n            originalDoc,\n            overrideAccess,\n            req,\n          })) || data\n      }\n    }\n\n    // /////////////////////////////////////\n    // beforeChange - Fields\n    // /////////////////////////////////////\n\n    const beforeChangeArgs = {\n      collection: null,\n      context: req.context,\n      data,\n      doc: originalDoc,\n      docWithLocales: globalJSON,\n      global: globalConfig,\n      operation: 'update' as Operation,\n      req,\n      skipValidation:\n        (isSavingDraft && !hasDraftValidationEnabled(globalConfig)) ||\n        // Skip validation for unpublish operations — they only change _status, not document data\n        unpublishAllLocales,\n    }\n\n    let result: JsonObject = await beforeChange(beforeChangeArgs)\n    let snapshotToSave: JsonObject | undefined\n\n    // /////////////////////////////////////\n    // Handle Localized Data Merging\n    // /////////////////////////////////////\n\n    if (config && config.localization && globalConfig.versions) {\n      let currentGlobal: JsonObject | null = null\n      let snapshotData: JsonObject | undefined\n\n      if (globalConfig.versions.drafts && globalConfig.versions.drafts.localizeStatus) {\n        if (publishAllLocales || unpublishAllLocales) {\n          let accessibleLocaleCodes = config.localization.localeCodes\n\n          if (config.localization.filterAvailableLocales) {\n            const filteredLocales = await config.localization.filterAvailableLocales({\n              locales: config.localization.locales,\n              req,\n            })\n            accessibleLocaleCodes = filteredLocales.map((locale) =>\n              typeof locale === 'string' ? locale : locale.code,\n            )\n          }\n\n          if (typeof result._status !== 'object' || result._status === null) {\n            result._status = {}\n          }\n\n          for (const localeCode of accessibleLocaleCodes) {\n            result._status[localeCode] = unpublishAllLocales ? 'draft' : 'published'\n          }\n        } else if (!isSavingDraft) {\n          // publishing a single locale\n          currentGlobal = await payload.db.findGlobal({\n            slug: globalConfig.slug,\n            req,\n            where: query,\n          })\n          snapshotData = result\n        }\n      } else if (publishSpecificLocale) {\n        // previous way of publishing a single locale\n        currentGlobal = (\n          await getLatestGlobalVersion({\n            slug,\n            config: globalConfig,\n            payload,\n            published: true,\n            req,\n            where: query,\n          })\n        ).global\n        snapshotData = {\n          ...result,\n          _status: 'draft',\n        }\n      }\n\n      if (snapshotData) {\n        snapshotToSave = deepCopyObjectSimple(snapshotData)\n\n        result = mergeLocalizedData({\n          configBlockReferences: config.blocks,\n          dataWithLocales: result || {},\n          docWithLocales: currentGlobal || {},\n          fields: globalConfig.fields,\n          selectedLocales: [locale!],\n        })\n      }\n    }\n    // /////////////////////////////////////\n    // Update\n    // /////////////////////////////////////\n\n    const select = sanitizeSelect({\n      fields: globalConfig.flattenedFields,\n      select: resolveSelect({\n        config: globalConfig.select,\n        operation: 'update',\n        req,\n        select: incomingSelect,\n      }),\n    })\n\n    if (!isSavingDraft) {\n      const now = new Date().toISOString()\n      // Ensure global has createdAt\n      if (!result.createdAt) {\n        result.createdAt = now\n      }\n\n      // Ensure updatedAt date is always updated\n      result.updatedAt = now\n\n      if (globalExists) {\n        result = await payload.db.updateGlobal({\n          slug,\n          data: result,\n          req,\n          select,\n        })\n      } else {\n        result = await payload.db.createGlobal({\n          slug,\n          data: result,\n          req,\n        })\n      }\n    }\n\n    // /////////////////////////////////////\n    // Create version\n    // /////////////////////////////////////\n    if (globalConfig.versions) {\n      const { globalType } = result\n      result = await saveVersion({\n        autosave,\n        docWithLocales: result,\n        draft: isSavingDraft,\n        global: globalConfig,\n        operation: 'update',\n        payload,\n        publishSpecificLocale,\n        req,\n        select,\n        snapshot: snapshotToSave,\n        unpublish: unpublishAllLocales,\n      })\n\n      result = {\n        ...result,\n        globalType,\n      }\n    }\n\n    // /////////////////////////////////////\n    // Execute globalType field if not selected\n    // /////////////////////////////////////\n    if (select && result.globalType) {\n      const selectMode = getSelectMode(select)\n      if (\n        (selectMode === 'include' && !select['globalType']) ||\n        (selectMode === 'exclude' && select['globalType'] === false)\n      ) {\n        delete result['globalType']\n      }\n    }\n\n    // /////////////////////////////////////\n    // afterRead - Fields\n    // /////////////////////////////////////\n\n    result = await afterRead({\n      collection: null,\n      context: req.context,\n      depth: depth!,\n      doc: result,\n      draft: draftArg!,\n      fallbackLocale: null,\n      global: globalConfig,\n      locale: locale!,\n      overrideAccess: overrideAccess!,\n      populate,\n      req,\n      select,\n      showHiddenFields: showHiddenFields!,\n    })\n\n    // /////////////////////////////////////\n    // afterRead - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.afterRead?.length) {\n      for (const hook of globalConfig.hooks.afterRead) {\n        result =\n          (await hook({\n            context: req.context,\n            doc: result,\n            global: globalConfig,\n            overrideAccess,\n            req,\n          })) || result\n      }\n    }\n\n    // /////////////////////////////////////\n    // afterChange - Fields\n    // /////////////////////////////////////\n\n    result = await afterChange({\n      collection: null,\n      context: req.context,\n      data,\n      doc: result,\n      global: globalConfig,\n      operation: 'update',\n      previousDoc: originalDoc,\n      req,\n    })\n\n    // /////////////////////////////////////\n    // afterChange - Global\n    // /////////////////////////////////////\n\n    if (globalConfig.hooks?.afterChange?.length) {\n      for (const hook of globalConfig.hooks.afterChange) {\n        result =\n          (await hook({\n            context: req.context,\n            data,\n            doc: result,\n            global: globalConfig,\n            overrideAccess,\n            previousDoc: originalDoc,\n            req,\n          })) || result\n      }\n    }\n\n    // /////////////////////////////////////\n    // Return results\n    // /////////////////////////////////////\n\n    if (shouldCommit) {\n      await commitTransaction(req)\n    }\n\n    return result as TransformGlobalWithSelect<TSlug, TSelect>\n  } catch (error: unknown) {\n    await killTransaction(req)\n    throw error\n  }\n}\n"],"names":["executeAccess","afterChange","afterRead","beforeChange","beforeValidate","deepCopyObjectSimple","checkDocumentLockStatus","commitTransaction","getSelectMode","hasDraftsEnabled","hasDraftValidationEnabled","hasLocalizeStatusEnabled","initTransaction","killTransaction","mergeLocalizedData","resolveSelect","sanitizeSelect","getLatestGlobalVersion","saveVersion","updateOperation","args","publishSpecificLocale","req","locale","slug","autosave","depth","disableTransaction","draft","draftArg","globalConfig","overrideAccess","overrideLock","populate","publishAllLocales","publishAllLocalesArg","fallbackLocale","payload","config","select","incomingSelect","showHiddenFields","unpublishAllLocales","unpublishAllLocalesArg","shouldCommit","hooks","beforeOperation","length","hook","context","global","operation","data","isSavingDraft","Boolean","_status","accessResults","access","update","query","undefined","globalVersionResult","where","globalExists","globalJSON","_id","originalDoc","collection","doc","globalSlug","lockErrorMessage","beforeChangeArgs","docWithLocales","skipValidation","result","snapshotToSave","localization","versions","currentGlobal","snapshotData","drafts","localizeStatus","accessibleLocaleCodes","localeCodes","filterAvailableLocales","filteredLocales","locales","map","code","localeCode","db","findGlobal","published","configBlockReferences","blocks","dataWithLocales","fields","selectedLocales","flattenedFields","now","Date","toISOString","createdAt","updatedAt","updateGlobal","createGlobal","globalType","snapshot","unpublish","selectMode","previousDoc","error"],"mappings":"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"}

package/dist/hierarchy/addHierarchyToCollection.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionConfig } from '../collections/config/types.js';
+export declare const addHierarchyToCollection: ({ collectionConfig, parentFieldName, slugFieldName, slugPathFieldName, titlePathFieldName, }: {
+    collectionConfig: CollectionConfig;
+    parentFieldName: string;
+    slugFieldName?: string;
+    slugPathFieldName: string;
+    titlePathFieldName: string;
+}) => void;
+//# sourceMappingURL=addHierarchyToCollection.d.ts.map

package/dist/hierarchy/addHierarchyToCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addHierarchyToCollection.d.ts","sourceRoot":"","sources":["../../src/hierarchy/addHierarchyToCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAQtE,eAAO,MAAM,wBAAwB,iGAMlC;IACD,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,SAkEA,CAAA"}

package/dist/hierarchy/addHierarchyToCollection.js

@@ -0,0 +1,76 @@
+import { hierarchyCollectionAfterRead } from './hooks/collectionAfterRead.js';
+import { hierarchyCollectionBeforeChange } from './hooks/collectionBeforeChange.js';
+import { hierarchyCollectionBeforeDelete } from './hooks/collectionBeforeDelete.js';
+import { hierarchyCollectionBeforeOperation } from './hooks/collectionBeforeOperation.js';
+import { findFieldByName, findUseAsTitleField } from './utils/findUseAsTitle.js';
+export const addHierarchyToCollection = ({ collectionConfig, parentFieldName, slugFieldName, slugPathFieldName, titlePathFieldName })=>{
+    const { titleFieldName } = findUseAsTitleField(collectionConfig);
+    // Verify slug field exists if configured
+    const slugFieldInfo = slugFieldName ? findFieldByName(collectionConfig, slugFieldName) : undefined;
+    const validatedSlugFieldName = slugFieldInfo ? slugFieldName : undefined;
+    // Add virtual path fields (computed in afterRead)
+    collectionConfig.fields.push({
+        name: slugPathFieldName,
+        type: 'text',
+        admin: {
+            readOnly: true
+        },
+        index: true,
+        label: 'Slug Path',
+        virtual: true
+    }, {
+        name: titlePathFieldName,
+        type: 'text',
+        admin: {
+            readOnly: true
+        },
+        index: true,
+        label: 'Title Path',
+        virtual: true
+    });
+    if (!collectionConfig.admin) {
+        collectionConfig.admin = {};
+    }
+    if (!collectionConfig.admin.listSearchableFields) {
+        collectionConfig.admin.listSearchableFields = [
+            titleFieldName
+        ];
+    } else if (!collectionConfig.admin.listSearchableFields.includes(titleFieldName)) {
+        collectionConfig.admin.listSearchableFields.push(titleFieldName);
+    }
+    collectionConfig.hooks = {
+        ...collectionConfig.hooks || {},
+        afterRead: [
+            ...collectionConfig.hooks?.afterRead || [],
+            hierarchyCollectionAfterRead({
+                parentFieldName,
+                slugPathFieldName,
+                titlePathFieldName
+            })
+        ],
+        beforeChange: [
+            ...collectionConfig.hooks?.beforeChange || [],
+            hierarchyCollectionBeforeChange({
+                parentFieldName
+            })
+        ],
+        beforeDelete: [
+            ...collectionConfig.hooks?.beforeDelete || [],
+            hierarchyCollectionBeforeDelete({
+                parentFieldName
+            })
+        ],
+        beforeOperation: [
+            ...collectionConfig.hooks?.beforeOperation || [],
+            hierarchyCollectionBeforeOperation({
+                parentFieldName,
+                slugFieldName: validatedSlugFieldName,
+                slugPathFieldName,
+                titleFieldName,
+                titlePathFieldName
+            })
+        ]
+    };
+};
+
+//# sourceMappingURL=addHierarchyToCollection.js.map

package/dist/hierarchy/addHierarchyToCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/addHierarchyToCollection.ts"],"sourcesContent":["import type { CollectionConfig } from '../collections/config/types.js'\n\nimport { hierarchyCollectionAfterRead } from './hooks/collectionAfterRead.js'\nimport { hierarchyCollectionBeforeChange } from './hooks/collectionBeforeChange.js'\nimport { hierarchyCollectionBeforeDelete } from './hooks/collectionBeforeDelete.js'\nimport { hierarchyCollectionBeforeOperation } from './hooks/collectionBeforeOperation.js'\nimport { findFieldByName, findUseAsTitleField } from './utils/findUseAsTitle.js'\n\nexport const addHierarchyToCollection = ({\n  collectionConfig,\n  parentFieldName,\n  slugFieldName,\n  slugPathFieldName,\n  titlePathFieldName,\n}: {\n  collectionConfig: CollectionConfig\n  parentFieldName: string\n  slugFieldName?: string\n  slugPathFieldName: string\n  titlePathFieldName: string\n}) => {\n  const { titleFieldName } = findUseAsTitleField(collectionConfig)\n  // Verify slug field exists if configured\n  const slugFieldInfo = slugFieldName ? findFieldByName(collectionConfig, slugFieldName) : undefined\n  const validatedSlugFieldName = slugFieldInfo ? slugFieldName : undefined\n\n  // Add virtual path fields (computed in afterRead)\n  collectionConfig.fields.push(\n    {\n      name: slugPathFieldName,\n      type: 'text',\n      admin: {\n        readOnly: true,\n        // hidden: true,\n      },\n      index: true,\n      label: 'Slug Path',\n      virtual: true,\n    },\n    {\n      name: titlePathFieldName,\n      type: 'text',\n      admin: {\n        readOnly: true,\n        // hidden: true,\n      },\n      index: true,\n      label: 'Title Path',\n      virtual: true,\n    },\n  )\n\n  if (!collectionConfig.admin) {\n    collectionConfig.admin = {}\n  }\n  if (!collectionConfig.admin.listSearchableFields) {\n    collectionConfig.admin.listSearchableFields = [titleFieldName]\n  } else if (!collectionConfig.admin.listSearchableFields.includes(titleFieldName)) {\n    collectionConfig.admin.listSearchableFields.push(titleFieldName)\n  }\n\n  collectionConfig.hooks = {\n    ...(collectionConfig.hooks || {}),\n    afterRead: [\n      ...(collectionConfig.hooks?.afterRead || []),\n      hierarchyCollectionAfterRead({ parentFieldName, slugPathFieldName, titlePathFieldName }),\n    ],\n    beforeChange: [\n      ...(collectionConfig.hooks?.beforeChange || []),\n      hierarchyCollectionBeforeChange({ parentFieldName }),\n    ],\n    beforeDelete: [\n      ...(collectionConfig.hooks?.beforeDelete || []),\n      hierarchyCollectionBeforeDelete({ parentFieldName }),\n    ],\n    beforeOperation: [\n      ...(collectionConfig.hooks?.beforeOperation || []),\n      hierarchyCollectionBeforeOperation({\n        parentFieldName,\n        slugFieldName: validatedSlugFieldName,\n        slugPathFieldName,\n        titleFieldName,\n        titlePathFieldName,\n      }),\n    ],\n  }\n}\n"],"names":["hierarchyCollectionAfterRead","hierarchyCollectionBeforeChange","hierarchyCollectionBeforeDelete","hierarchyCollectionBeforeOperation","findFieldByName","findUseAsTitleField","addHierarchyToCollection","collectionConfig","parentFieldName","slugFieldName","slugPathFieldName","titlePathFieldName","titleFieldName","slugFieldInfo","undefined","validatedSlugFieldName","fields","push","name","type","admin","readOnly","index","label","virtual","listSearchableFields","includes","hooks","afterRead","beforeChange","beforeDelete","beforeOperation"],"mappings":"AAEA,SAASA,4BAA4B,QAAQ,iCAAgC;AAC7E,SAASC,+BAA+B,QAAQ,oCAAmC;AACnF,SAASC,+BAA+B,QAAQ,oCAAmC;AACnF,SAASC,kCAAkC,QAAQ,uCAAsC;AACzF,SAASC,eAAe,EAAEC,mBAAmB,QAAQ,4BAA2B;AAEhF,OAAO,MAAMC,2BAA2B,CAAC,EACvCC,gBAAgB,EAChBC,eAAe,EACfC,aAAa,EACbC,iBAAiB,EACjBC,kBAAkB,EAOnB;IACC,MAAM,EAAEC,cAAc,EAAE,GAAGP,oBAAoBE;IAC/C,yCAAyC;IACzC,MAAMM,gBAAgBJ,gBAAgBL,gBAAgBG,kBAAkBE,iBAAiBK;IACzF,MAAMC,yBAAyBF,gBAAgBJ,gBAAgBK;IAE/D,kDAAkD;IAClDP,iBAAiBS,MAAM,CAACC,IAAI,CAC1B;QACEC,MAAMR;QACNS,MAAM;QACNC,OAAO;YACLC,UAAU;QAEZ;QACAC,OAAO;QACPC,OAAO;QACPC,SAAS;IACX,GACA;QACEN,MAAMP;QACNQ,MAAM;QACNC,OAAO;YACLC,UAAU;QAEZ;QACAC,OAAO;QACPC,OAAO;QACPC,SAAS;IACX;IAGF,IAAI,CAACjB,iBAAiBa,KAAK,EAAE;QAC3Bb,iBAAiBa,KAAK,GAAG,CAAC;IAC5B;IACA,IAAI,CAACb,iBAAiBa,KAAK,CAACK,oBAAoB,EAAE;QAChDlB,iBAAiBa,KAAK,CAACK,oBAAoB,GAAG;YAACb;SAAe;IAChE,OAAO,IAAI,CAACL,iBAAiBa,KAAK,CAACK,oBAAoB,CAACC,QAAQ,CAACd,iBAAiB;QAChFL,iBAAiBa,KAAK,CAACK,oBAAoB,CAACR,IAAI,CAACL;IACnD;IAEAL,iBAAiBoB,KAAK,GAAG;QACvB,GAAIpB,iBAAiBoB,KAAK,IAAI,CAAC,CAAC;QAChCC,WAAW;eACLrB,iBAAiBoB,KAAK,EAAEC,aAAa,EAAE;YAC3C5B,6BAA6B;gBAAEQ;gBAAiBE;gBAAmBC;YAAmB;SACvF;QACDkB,cAAc;eACRtB,iBAAiBoB,KAAK,EAAEE,gBAAgB,EAAE;YAC9C5B,gCAAgC;gBAAEO;YAAgB;SACnD;QACDsB,cAAc;eACRvB,iBAAiBoB,KAAK,EAAEG,gBAAgB,EAAE;YAC9C5B,gCAAgC;gBAAEM;YAAgB;SACnD;QACDuB,iBAAiB;eACXxB,iBAAiBoB,KAAK,EAAEI,mBAAmB,EAAE;YACjD5B,mCAAmC;gBACjCK;gBACAC,eAAeM;gBACfL;gBACAE;gBACAD;YACF;SACD;IACH;AACF,EAAC"}

package/dist/hierarchy/buildParentField.d.ts

@@ -0,0 +1,11 @@
+import type { SingleRelationshipField } from '../fields/config/types.js';
+export declare const buildParentField: ({ collectionSlug, injectHeaderButton, overrides, parentFieldName, }: {
+    collectionSlug: string;
+    /**
+     * When true, uses NullField and injects a header button for parent selection
+     */
+    injectHeaderButton?: boolean;
+    overrides?: Partial<SingleRelationshipField>;
+    parentFieldName: string;
+}) => SingleRelationshipField;
+//# sourceMappingURL=buildParentField.d.ts.map

package/dist/hierarchy/buildParentField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildParentField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/buildParentField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE,eAAO,MAAM,gBAAgB,wEAK1B;IACD,cAAc,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC5C,eAAe,EAAE,MAAM,CAAA;CACxB,KAAG,uBA0CH,CAAA"}

package/dist/hierarchy/buildParentField.js

@@ -0,0 +1,42 @@
+export const buildParentField = ({ collectionSlug, injectHeaderButton = false, overrides = {}, parentFieldName })=>{
+    const field = {
+        name: parentFieldName,
+        type: 'relationship',
+        admin: {
+            ...injectHeaderButton && {
+                components: {
+                    Field: '@payloadcms/ui#NullField'
+                }
+            },
+            position: 'sidebar'
+        },
+        hasMany: false,
+        index: true,
+        label: 'Parent',
+        localized: false,
+        relationTo: collectionSlug,
+        ...injectHeaderButton && {
+            custom: {
+                hierarchy: {
+                    // Inform hierarchy UI to inject the header button for this parent field
+                    injectHeaderButton: true
+                }
+            }
+        }
+    };
+    if (overrides?.admin) {
+        field.admin = {
+            ...field.admin || {},
+            ...overrides.admin
+        };
+        if (overrides.admin.components && field.admin) {
+            field.admin.components = {
+                ...field.admin.components || {},
+                ...overrides.admin.components
+            };
+        }
+    }
+    return field;
+};
+
+//# sourceMappingURL=buildParentField.js.map

package/dist/hierarchy/buildParentField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/buildParentField.ts"],"sourcesContent":["import type { SingleRelationshipField } from '../fields/config/types.js'\n\nexport const buildParentField = ({\n  collectionSlug,\n  injectHeaderButton = false,\n  overrides = {},\n  parentFieldName,\n}: {\n  collectionSlug: string\n  /**\n   * When true, uses NullField and injects a header button for parent selection\n   */\n  injectHeaderButton?: boolean\n  overrides?: Partial<SingleRelationshipField>\n  parentFieldName: string\n}): SingleRelationshipField => {\n  const field: SingleRelationshipField = {\n    name: parentFieldName,\n    type: 'relationship',\n    admin: {\n      ...(injectHeaderButton && {\n        components: {\n          Field: '@payloadcms/ui#NullField',\n        },\n      }),\n      position: 'sidebar',\n    },\n    hasMany: false,\n    index: true,\n    label: 'Parent',\n    localized: false,\n    relationTo: collectionSlug, // Always self-referential\n    ...(injectHeaderButton && {\n      custom: {\n        hierarchy: {\n          // Inform hierarchy UI to inject the header button for this parent field\n          injectHeaderButton: true,\n        },\n      },\n    }),\n  }\n\n  if (overrides?.admin) {\n    field.admin = {\n      ...(field.admin || {}),\n      ...overrides.admin,\n    }\n\n    if (overrides.admin.components && field.admin) {\n      field.admin.components = {\n        ...(field.admin.components || {}),\n        ...overrides.admin.components,\n      }\n    }\n  }\n\n  return field\n}\n"],"names":["buildParentField","collectionSlug","injectHeaderButton","overrides","parentFieldName","field","name","type","admin","components","Field","position","hasMany","index","label","localized","relationTo","custom","hierarchy"],"mappings":"AAEA,OAAO,MAAMA,mBAAmB,CAAC,EAC/BC,cAAc,EACdC,qBAAqB,KAAK,EAC1BC,YAAY,CAAC,CAAC,EACdC,eAAe,EAShB;IACC,MAAMC,QAAiC;QACrCC,MAAMF;QACNG,MAAM;QACNC,OAAO;YACL,GAAIN,sBAAsB;gBACxBO,YAAY;oBACVC,OAAO;gBACT;YACF,CAAC;YACDC,UAAU;QACZ;QACAC,SAAS;QACTC,OAAO;QACPC,OAAO;QACPC,WAAW;QACXC,YAAYf;QACZ,GAAIC,sBAAsB;YACxBe,QAAQ;gBACNC,WAAW;oBACT,wEAAwE;oBACxEhB,oBAAoB;gBACtB;YACF;QACF,CAAC;IACH;IAEA,IAAIC,WAAWK,OAAO;QACpBH,MAAMG,KAAK,GAAG;YACZ,GAAIH,MAAMG,KAAK,IAAI,CAAC,CAAC;YACrB,GAAGL,UAAUK,KAAK;QACpB;QAEA,IAAIL,UAAUK,KAAK,CAACC,UAAU,IAAIJ,MAAMG,KAAK,EAAE;YAC7CH,MAAMG,KAAK,CAACC,UAAU,GAAG;gBACvB,GAAIJ,MAAMG,KAAK,CAACC,UAAU,IAAI,CAAC,CAAC;gBAChC,GAAGN,UAAUK,KAAK,CAACC,UAAU;YAC/B;QACF;IACF;IAEA,OAAOJ;AACT,EAAC"}

package/dist/hierarchy/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */
+export declare const HIERARCHY_SLUG_PATH_FIELD = "_h_slugPath";
+export declare const HIERARCHY_TITLE_PATH_FIELD = "_h_titlePath";
+export declare const HIERARCHY_DEFAULT_LOCALE = "en";
+/** Default limit for hierarchy tree queries */
+export declare const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */
+export declare const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */
+export declare const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */
+export declare const getHierarchyFieldName: (hierarchySlug: string) => string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/hierarchy/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/hierarchy/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AACtD,eAAO,MAAM,0BAA0B,iBAAiB,CAAA;AACxD,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAE5C,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,kBAAmB,MAAM,KAAG,MAA+B,CAAA"}

package/dist/hierarchy/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */ export const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath';
+export const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath';
+export const HIERARCHY_DEFAULT_LOCALE = 'en';
+/** Default limit for hierarchy tree queries */ export const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */ export const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */ export const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */ export const getHierarchyFieldName = (hierarchySlug)=>`_h_${hierarchySlug}`;
+
+//# sourceMappingURL=constants.js.map

package/dist/hierarchy/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/constants.ts"],"sourcesContent":["/**\n * Default field names and constants for hierarchy feature\n */\n\nexport const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath'\nexport const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath'\nexport const HIERARCHY_DEFAULT_LOCALE = 'en'\n\n/** Default limit for hierarchy tree queries */\nexport const DEFAULT_HIERARCHY_TREE_LIMIT = 100\n\n/** Default limit for hierarchy list view table queries */\nexport const DEFAULT_HIERARCHY_LIST_LIMIT = 25\n\n/** Default value for allowing hasMany on hierarchy fields */\nexport const DEFAULT_ALLOW_HAS_MANY = true\n\n/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */\nexport const getHierarchyFieldName = (hierarchySlug: string): string => `_h_${hierarchySlug}`\n"],"names":["HIERARCHY_SLUG_PATH_FIELD","HIERARCHY_TITLE_PATH_FIELD","HIERARCHY_DEFAULT_LOCALE","DEFAULT_HIERARCHY_TREE_LIMIT","DEFAULT_HIERARCHY_LIST_LIMIT","DEFAULT_ALLOW_HAS_MANY","getHierarchyFieldName","hierarchySlug"],"mappings":"AAAA;;CAEC,GAED,OAAO,MAAMA,4BAA4B,cAAa;AACtD,OAAO,MAAMC,6BAA6B,eAAc;AACxD,OAAO,MAAMC,2BAA2B,KAAI;AAE5C,6CAA6C,GAC7C,OAAO,MAAMC,+BAA+B,IAAG;AAE/C,wDAAwD,GACxD,OAAO,MAAMC,+BAA+B,GAAE;AAE9C,2DAA2D,GAC3D,OAAO,MAAMC,yBAAyB,KAAI;AAE1C,4FAA4F,GAC5F,OAAO,MAAMC,wBAAwB,CAACC,gBAAkC,CAAC,GAAG,EAAEA,eAAe,CAAA"}

package/dist/hierarchy/createFolderField.d.ts

@@ -0,0 +1,39 @@
+import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a folder relationship field.
+ * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany
+ * which are managed by the folder system.
+ */
+export type CreateFolderFieldOptions = {
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'folders')
+     */
+    relationTo: string;
+} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createFolderField(options: CreateFolderFieldOptions): RelationshipField;
+//# sourceMappingURL=createFolderField.d.ts.map

package/dist/hierarchy/createFolderField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFolderField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createFolderField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAI3F;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA2BtF"}

package/dist/hierarchy/createFolderField.js

@@ -0,0 +1,54 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */ export function createFolderField(options) {
+    const { admin: adminOverrides, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                // NullField renders nothing - the header button handles the UI
+                Field: '@payloadcms/ui#NullField',
+                ...componentOverrides
+            }
+        },
+        custom: {
+            hierarchy: {
+                injectHeaderButton: true
+            }
+        },
+        hasMany: false,
+        index: true,
+        label: label ?? 'Folder',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createFolderField.js.map

package/dist/hierarchy/createFolderField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createFolderField.ts"],"sourcesContent":["import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a folder relationship field.\n * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany\n * which are managed by the folder system.\n */\nexport type CreateFolderFieldOptions = {\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'folders')\n   */\n  relationTo: string\n} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for folder-style hierarchies (single-select).\n *\n * This field:\n * - Has hasMany:false (single folder selection)\n * - Uses NullField to render nothing in the form (no DOM output)\n * - Injects a header button for folder selection via miller columns UI\n *\n * Use this in your collection's fields array to add a folder relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createFolderField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createFolderField({\n *       relationTo: 'folders',\n *       label: 'Folder',\n *     }),\n *   ],\n * }\n */\nexport function createFolderField(options: CreateFolderFieldOptions): RelationshipField {\n  const { admin: adminOverrides, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        // NullField renders nothing - the header button handles the UI\n        Field: '@payloadcms/ui#NullField',\n        ...componentOverrides,\n      },\n    },\n    custom: {\n      hierarchy: {\n        injectHeaderButton: true,\n      },\n    },\n    hasMany: false,\n    index: true,\n    label: label ?? 'Folder',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createFolderField","options","admin","adminOverrides","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","custom","hierarchy","injectHeaderButton","hasMany","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AActD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,kBAAkBC,OAAiC;IACjE,MAAM,EAAEC,OAAOC,cAAc,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGL;IACrE,MAAM,EAAEM,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGN,kBAAkB,CAAC;IAErF,OAAO;QACLO,MAAMX,sBAAsBM;QAC5BM,MAAM;QACNT,OAAO;YACLU,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACV,+DAA+D;gBAC/DM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAM,QAAQ;YACNC,WAAW;gBACTC,oBAAoB;YACtB;QACF;QACAC,SAAS;QACTC,OAAO;QACPd,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/createTagField.d.ts

@@ -0,0 +1,44 @@
+import type { RelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a tag relationship field.
+ * All RelationshipFieldMany properties are available except name, type, and relationTo
+ * which are managed by the tag system.
+ */
+export type CreateTagFieldOptions = {
+    /**
+     * Whether to allow multiple tags (defaults to true)
+     * @default true
+     */
+    hasMany?: boolean;
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'tags')
+     */
+    relationTo: string;
+} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createTagField(options: CreateTagFieldOptions): RelationshipField;
+//# sourceMappingURL=createTagField.d.ts.map

package/dist/hierarchy/createTagField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTagField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createTagField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAqBhF"}

package/dist/hierarchy/createTagField.js

@@ -0,0 +1,48 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */ export function createTagField(options) {
+    const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                Field: '@payloadcms/ui/rsc#HierarchyField',
+                ...componentOverrides
+            }
+        },
+        hasMany,
+        index: true,
+        label: label ?? 'Tags',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createTagField.js.map

package/dist/hierarchy/createTagField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createTagField.ts"],"sourcesContent":["import type { RelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a tag relationship field.\n * All RelationshipFieldMany properties are available except name, type, and relationTo\n * which are managed by the tag system.\n */\nexport type CreateTagFieldOptions = {\n  /**\n   * Whether to allow multiple tags (defaults to true)\n   * @default true\n   */\n  hasMany?: boolean\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'tags')\n   */\n  relationTo: string\n} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for tag-style hierarchies (multi-select by default).\n *\n * This field:\n * - Has hasMany:true by default (multiple tag selection)\n * - Is positioned in the sidebar by default\n * - Does NOT inject a header button (tags use standard relationship UI)\n *\n * Use this in your collection's fields array to add a tag relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createTagField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createTagField({\n *       relationTo: 'tags',\n *       label: 'Tags',\n *     }),\n *   ],\n * }\n */\nexport function createTagField(options: CreateTagFieldOptions): RelationshipField {\n  const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        Field: '@payloadcms/ui/rsc#HierarchyField',\n        ...componentOverrides,\n      },\n    },\n    hasMany,\n    index: true,\n    label: label ?? 'Tags',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createTagField","options","admin","adminOverrides","hasMany","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AAmBtD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,eAAeC,OAA8B;IAC3D,MAAM,EAAEC,OAAOC,cAAc,EAAEC,UAAU,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGN;IACrF,MAAM,EAAEO,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGP,kBAAkB,CAAC;IAErF,OAAO;QACLQ,MAAMZ,sBAAsBO;QAC5BM,MAAM;QACNV,OAAO;YACLW,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACVM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAL;QACAW,OAAO;QACPV,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/getInitialTreeData.d.ts

@@ -0,0 +1,27 @@
+import type { TypeWithID } from '../collections/config/types.js';
+import type { PayloadRequest, Where } from '../types/index.js';
+export type GetInitialTreeDataArgs = {
+    /** Base filter to apply to all queries (e.g., tenant filter) */
+    baseFilter?: null | Where;
+    collectionSlug: string;
+    expandedNodeIds?: (number | string)[];
+    /** Filter tree to only show folders that allow these collection types (or are unrestricted) */
+    filterByCollections?: string[];
+    limit?: number;
+    payload: PayloadRequest['payload'];
+    /** The currently selected node ID. When provided, ensures siblings are loaded to include this node. */
+    selectedNodeId?: null | number | string;
+    /** The parent ID of the selected node. Required when selectedNodeId is provided. */
+    selectedNodeParentId?: null | number | string;
+    user: PayloadRequest['user'];
+};
+export type InitialTreeData = {
+    docs: TypeWithID[];
+    loadedParents: Record<string, {
+        hasMore: boolean;
+        loadedCount?: number;
+        totalDocs: number;
+    }>;
+};
+export declare const getInitialTreeData: ({ baseFilter, collectionSlug, expandedNodeIds, filterByCollections, limit, payload, selectedNodeId, selectedNodeParentId, user, }: GetInitialTreeDataArgs) => Promise<InitialTreeData>;
+//# sourceMappingURL=getInitialTreeData.d.ts.map

package/dist/hierarchy/getInitialTreeData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInitialTreeData.d.ts","sourceRoot":"","sources":["../../src/hierarchy/getInitialTreeData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAI9D,MAAM,MAAM,sBAAsB,GAAG;IACnC,gEAAgE;IAChE,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACrC,+FAA+F;IAC/F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAClC,uGAAuG;IACvG,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IACvC,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAA;IAElB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7F,CAAA;AAED,eAAO,MAAM,kBAAkB,sIAU5B,sBAAsB,KAAG,OAAO,CAAC,eAAe,CA0IlD,CAAA"}