fix!: improve collection / global slugs type-safety in various places

[r1tsuu]

BREAKING:
Improves type-safety of collection / global slugs by using CollectionSlug and GlobalSlug types instead of string in these places:

• Sanitized collection / global config, keys of payload.collections
• Direct Payload DB operations through payload.db
• collections argument of plugins: storage-adapters, nested-docs, cloud
• collectionSlugsproperty ofListDrawerProps`
• collectionSlugs and selectCollectionSlugs arguments of useListDrawer
• Permissions of AuthResult

This also changes how we suggest to add a upload collection to cloud-storage adapter:

Before:

azureStorage({
  collections: {
    [Media.slug]: true,
  },
}) 

After:

azureStorage({
  collections: {
    media: true,
  },
}) 

It's not needed anymore, as keys of the collection argument are type-safe now and Media.slug from this code actually has string type so this will lead to a TS error.

export const Media: CollectionConfig = {
  slug: 'media',
  fields: [],
  upload: true
}

If you still want to use Media.slug, you can use this notation:

export const Media = {
  slug: 'media' as const,
  fields: [],
  upload: true
} satisfies CollectionConfig

This way, Media.slug is typed as 'media' instead of string and can be used as CollectionSlug.

[DanRibbens]

I'd like @denolfe to review this also before we merge it in and we need to have a BREAKING CHANGES section written in the commit for release notes.

[denolfe]

I think this is a good change that will help DX. Left a few questions.

[denolfe]

What is the reasoning for this to be a partial?

[r1tsuu]

Because if it's not partial, you have to define all the collections there.

[denolfe]

Does TS still allow using Media.slug without error? Having people change all their slugs to as const seems less than ideal.

[r1tsuu]

No, because Media.slug itself has a type of string, not 'media'. Other way around it is to write collection like this:

It would work if the slug property itself of CollectionConfig would be of the CollectionSlug type, though.
But the drawback of this is that you wouldn't be able to define a new collection slug without typescript error, which can be fixed only after types generation. That's why I only did it for SanitizedCollectionConfig['slug']