fix: sanitized versions type was incorrect (#14810)

Updates the config.versions (on the sanitized config) to be proper.

#### Before
```ts
versions: SanitizedCollectionVersions // not accurate 
```

#### After
```ts
versions?: SanitizedCollectionVersions
```

Previously sanitization did not remove the versions key when it was set
to false so the actual type should have been `versions:
SanitizedCollectionVersions | false`.

I chose to remove the versions key if it is false in the sanitization
function so it is easier to work with, i.e. optional chaining.

Also adds importable helper functions:
```ts
import {
  getAutosaveInterval,
  getVersionsMax,
  hasAutosaveEnabled,
  hasDraftsEnabled,
  hasDraftValidationEnabled,
  hasScheduledPublishEnabled,
} from 'payload/shared'
```

Author: JarrodMFlesch

packages/db-mongodb/src/utilities/buildJoinAggregation.ts

@@ -11,7 +11,7 @@ import {
   type JoinQuery,
   type SanitizedCollectionConfig,
 } from 'payload'
-import { fieldShouldBeLocalized } from 'payload/shared'
+import { fieldShouldBeLocalized, hasDraftsEnabled } from 'payload/shared'
 
 import type { MongooseAdapter } from '../index.js'
 import type { CollectionModel } from '../types.js'
@@ -282,7 +282,7 @@ export const buildJoinAggregation = async ({
 
       let JoinModel: CollectionModel | undefined
 
-      const useDrafts = (draftsEnabled || versions) && Boolean(collectionConfig.versions.drafts)
+      const useDrafts = (draftsEnabled || versions) && hasDraftsEnabled(collectionConfig)
 
       if (useDrafts) {
         JoinModel = adapter.versions[collectionConfig.slug]

packages/drizzle/src/createGlobalVersion.ts

@@ -2,6 +2,7 @@ import type { CreateGlobalVersionArgs, JsonObject, TypeWithVersion } from 'paylo
 
 import { sql } from 'drizzle-orm'
 import { buildVersionGlobalFields } from 'payload'
+import { hasDraftsEnabled } from 'payload/shared'
 import toSnakeCase from 'to-snake-case'
 
 import type { DrizzleAdapter } from './types.js'
@@ -51,7 +52,7 @@ export async function createGlobalVersion<T extends JsonObject = JsonObject>(
   })
 
   const table = this.tables[tableName]
-  if (global.versions.drafts) {
+  if (hasDraftsEnabled(global)) {
     await this.execute({
       db,
       sql: sql`

packages/drizzle/src/schema/buildRawSchema.ts

@@ -3,6 +3,7 @@ import {
   buildVersionCompoundIndexes,
   buildVersionGlobalFields,
 } from 'payload'
+import { hasDraftsEnabled } from 'payload/shared'
 import toSnakeCase from 'to-snake-case'
 
 import type { DrizzleAdapter, RawIndex, SetColumnID } from '../types.js'
@@ -101,7 +102,7 @@ export const buildRawSchema = ({
     buildTable({
       adapter,
       blocksTableNameMap: {},
-      disableNotNull: !!global?.versions?.drafts,
+      disableNotNull: hasDraftsEnabled(global),
       disableUnique: false,
       fields: global.flattenedFields,
       parentIsLocalized: false,

packages/graphql/src/schema/initGlobals.ts

@@ -5,6 +5,7 @@ const { singular } = pluralize
 import type { Field, GraphQLInfo, SanitizedConfig, SanitizedGlobalConfig } from 'payload'
 
 import { buildVersionGlobalFields, toWords } from 'payload'
+import { hasDraftsEnabled } from 'payload/shared'
 
 import { docAccessResolver } from '../resolvers/globals/docAccess.js'
 import { findOne } from '../resolvers/globals/findOne.js'
@@ -26,15 +27,15 @@ type InitGlobalsGraphQLArgs = {
 export function initGlobals({ config, graphqlResult }: InitGlobalsGraphQLArgs): void {
   Object.keys(graphqlResult.globals.config).forEach((slug) => {
     const global: SanitizedGlobalConfig = graphqlResult.globals.config[slug]
-    const { fields, graphQL, versions } = global
+    const { fields, graphQL } = global
 
     if (graphQL === false) {
       return
     }
 
     const formattedName = graphQL?.name ? graphQL.name : singular(toWords(global.slug, true))
 
-    const forceNullableObjectType = Boolean(versions?.drafts)
+    const forceNullableObjectType = hasDraftsEnabled(global)
 
     if (!graphqlResult.globals.graphQL) {
       graphqlResult.globals.graphQL = {}

packages/next/src/views/API/index.client.tsx

@@ -18,6 +18,7 @@ import { useSearchParams } from 'next/navigation.js'
 
 import './index.scss'
 
+import { hasDraftsEnabled } from 'payload/shared'
 import * as React from 'react'
 
 import { LocaleSelector } from './LocaleSelector/index.js'
@@ -53,12 +54,12 @@ export const APIViewClient: React.FC = () => {
   let docEndpoint: string = ''
 
   if (collectionConfig) {
-    draftsEnabled = Boolean(collectionConfig.versions?.drafts)
+    draftsEnabled = hasDraftsEnabled(collectionConfig)
     docEndpoint = `/${collectionSlug}/${id}`
   }
 
   if (globalConfig) {
-    draftsEnabled = Boolean(globalConfig.versions?.drafts)
+    draftsEnabled = hasDraftsEnabled(globalConfig)
     docEndpoint = `/globals/${globalSlug}`
   }
 

packages/next/src/views/Document/getDocumentPermissions.tsx

@@ -11,6 +11,7 @@ import {
   isEditing as getIsEditing,
 } from '@payloadcms/ui/shared'
 import { docAccessOperation, docAccessOperationGlobal, logError } from 'payload'
+import { hasDraftsEnabled } from 'payload/shared'
 
 export const getDocumentPermissions = async (args: {
   collectionConfig?: SanitizedCollectionConfig
@@ -73,7 +74,7 @@ export const getDocumentPermissions = async (args: {
         req,
       })
 
-      if (globalConfig.versions?.drafts) {
+      if (hasDraftsEnabled(globalConfig)) {
         hasPublishPermission = (
           await docAccessOperationGlobal({
             data: {

packages/next/src/views/Document/getVersions.ts

@@ -8,6 +8,7 @@ import {
   type SanitizedGlobalConfig,
   type TypedUser,
 } from 'payload'
+import { hasAutosaveEnabled, hasDraftsEnabled } from 'payload/shared'
 
 type Args = {
   collectionConfig?: SanitizedCollectionConfig
@@ -79,7 +80,7 @@ export const getVersions = async ({
       }
     }
 
-    if (versionsConfig?.drafts) {
+    if (hasDraftsEnabled(collectionConfig)) {
       // Find out if a published document exists
       if (doc?._status === 'published') {
         publishedDoc = doc
@@ -126,7 +127,7 @@ export const getVersions = async ({
         hasPublishedDoc = true
       }
 
-      if (versionsConfig.drafts?.autosave) {
+      if (hasAutosaveEnabled(collectionConfig)) {
         const mostRecentVersion = await payload.findVersions({
           collection: collectionConfig.slug,
           depth: 0,
@@ -209,7 +210,7 @@ export const getVersions = async ({
 
   if (globalConfig) {
     // Find out if a published document exists
-    if (versionsConfig?.drafts) {
+    if (hasDraftsEnabled(globalConfig)) {
       if (doc?._status === 'published') {
         publishedDoc = doc
       } else {
@@ -228,7 +229,7 @@ export const getVersions = async ({
         hasPublishedDoc = true
       }
 
-      if (versionsConfig.drafts?.autosave) {
+      if (hasAutosaveEnabled(globalConfig)) {
         const mostRecentVersion = await payload.findGlobalVersions({
           slug: globalConfig.slug,
           limit: 1,

packages/next/src/views/Document/index.tsx

@@ -22,7 +22,7 @@ import { isEditing as getIsEditing } from '@payloadcms/ui/shared'
 import { buildFormState } from '@payloadcms/ui/utilities/buildFormState'
 import { notFound, redirect } from 'next/navigation.js'
 import { isolateObjectProperty, logError } from 'payload'
-import { formatAdminURL } from 'payload/shared'
+import { formatAdminURL, hasAutosaveEnabled, hasDraftsEnabled } from 'payload/shared'
 import React from 'react'
 
 import type { GenerateEditViewMetadata } from './getMetaBySegment.js'
@@ -264,7 +264,7 @@ export const renderDocument = async ({
 
   const formattedParams = new URLSearchParams()
 
-  if (collectionConfig?.versions?.drafts || globalConfig?.versions?.drafts) {
+  if (hasDraftsEnabled(collectionConfig || globalConfig)) {
     formattedParams.append('draft', 'true')
   }
 
@@ -314,10 +314,7 @@ export const renderDocument = async ({
    * Handle case where autoSave is enabled and the document is being created
    * => create document and redirect
    */
-  const shouldAutosave =
-    hasSavePermission &&
-    ((collectionConfig?.versions?.drafts && collectionConfig?.versions?.drafts?.autosave) ||
-      (globalConfig?.versions?.drafts && globalConfig?.versions?.drafts?.autosave))
+  const shouldAutosave = hasSavePermission && hasAutosaveEnabled(collectionConfig || globalConfig)
 
   const validateDraftData =
     collectionConfig?.versions?.drafts && collectionConfig?.versions?.drafts?.validate

packages/next/src/views/Document/renderDocumentSlots.tsx

@@ -19,6 +19,7 @@ import type {
 
 import { ViewDescription } from '@payloadcms/ui'
 import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'
+import { hasDraftsEnabled } from 'payload/shared'
 
 import { getDocumentPermissions } from './getDocumentPermissions.js'
 
@@ -120,7 +121,7 @@ export const renderDocumentSlots: (args: {
   }
 
   if (hasSavePermission) {
-    if (collectionConfig?.versions?.drafts || globalConfig?.versions?.drafts) {
+    if (hasDraftsEnabled(collectionConfig || globalConfig)) {
       const CustomPublishButton =
         collectionConfig?.admin?.components?.edit?.PublishButton ||
         globalConfig?.admin?.components?.elements?.PublishButton
@@ -137,9 +138,7 @@ export const renderDocumentSlots: (args: {
         collectionConfig?.admin?.components?.edit?.SaveDraftButton ||
         globalConfig?.admin?.components?.elements?.SaveDraftButton
 
-      const draftsEnabled =
-        (collectionConfig?.versions?.drafts && !collectionConfig?.versions?.drafts?.autosave) ||
-        (globalConfig?.versions?.drafts && !globalConfig?.versions?.drafts?.autosave)
+      const draftsEnabled = hasDraftsEnabled(collectionConfig || globalConfig)
 
       if ((draftsEnabled || unsavedDraftWithValidations) && CustomSaveDraftButton) {
         components.SaveDraftButton = RenderServerComponent({

packages/next/src/views/Version/index.tsx

@@ -11,6 +11,7 @@ import { getClientConfig } from '@payloadcms/ui/utilities/getClientConfig'
 import { getClientSchemaMap } from '@payloadcms/ui/utilities/getClientSchemaMap'
 import { getSchemaMap } from '@payloadcms/ui/utilities/getSchemaMap'
 import { notFound } from 'next/navigation.js'
+import { hasDraftsEnabled } from 'payload/shared'
 import React from 'react'
 
 import type { CompareOption } from './Default/types.js'
@@ -38,7 +39,7 @@ export async function VersionView(props: DocumentViewServerProps) {
   const collectionSlug = collectionConfig?.slug
   const globalSlug = globalConfig?.slug
 
-  const draftsEnabled = (collectionConfig ?? globalConfig)?.versions?.drafts
+  const draftsEnabled = hasDraftsEnabled(collectionConfig || globalConfig)
 
   const localeCodesFromParams = searchParams.localeCodes
     ? JSON.parse(searchParams.localeCodes as string)