@payloadcms/plugin-cloud - npm Package Versions

2.1.1 (2023-11-10)

Bug Fixes

• conditionally hide dot menu in DocumentControls (#4075) (cef4cbb)
• disable editing option for svg image types (#4071) (949e265)
• fixes creation of related documents within a transaction if filterOptions is used (#4087) (acad288)
• hide empty image sizes from the preview drawer (#3946) (687f485)
• live-preview: ensures field schema exists before traversing fields (#4074) (7059a71)
• live-preview: field recursion and relationship population (#4045) (2ad7340)
• live-preview: properly handles apiRoute (#4076) (1f851f2)
• plugin-nested-docs: sync write transaction errors (#4084) (47efd3b)
• possible issue with access control not using req (#4086) (348a70c)
• richtext-lexical: Blocks: unnecessary saving node value when initially opening a document & new lexical tests (#4059) (fff377a)
• richtext-lexical: floating select toolbar caret not positioned correctly if first line is selected (#4062) (c462df3)

2.1.0 (2023-11-08)

Features

• add internationalization (i18n) to locales (#4005) (6a0a859)
• Custom Error, Label, and before/after field components (#3747) (266c327)

Bug Fixes

• error on graphql multiple queries (#3985) (57da3c9)
• focal and cropping issues, adds test (#4039) (acba5e4)
• handle invalid tokens in refresh token operation (#3647) (131d89c)
• hasMany number and select fields unable to save within arrays (#4047) (182c57b)
• injects array and block ids into fieldSchemaToJSON (#4043) (d068ef7)
• parse predefined migrations via file arg or name prefix (#4001) (eb42c03)
• polymorphic hasMany relationships missing in postgres admin (#4053) (7a9af44)
• resets list filter row when the filter on field is changed (#3956) (8d14c21)
• Update API Views (b008b6c)
• vite not replacing env vars correctly when building (67b3baa)

2.0.0 (2023-10-09)

Features

• New database adapter pattern
• Official Postgres adapter released, built on Drizzle ORM
• Database transactions added
• Full, first-party migration support added
• The admin UI has been redesigned to be more extensible and offer more horizontal real estate
• Admin UI sidebar is now collapsible
• Live preview added to admin UI, including usable frontend hooks
• New "Views" API added, which allows for custom sub-views on List and Edit views within Admin UI
• New bundler adapter pattern released
• Official Vite bundler released
• Offical Lexical rich text adapter released
• Lexical rich text editor now supports drag and drop of rich text elements
• Lexical rich text now supports Payload blocks directly within rich text editor
• Upload image cropping added
• Upload "focal point" controls added
• New "API" view added to Edit view(s), allowing for quick and customizable references to API response
• MongoDB draft querying has been significantly improved and is now much faster
• Arabic / RTL UI support added
• Locales can now be further configured to accept settings like rtl, human-friendly labels, etc.
• The tsconfig path pointing to your generated Payload types is no longer required for types to work

BREAKING CHANGES

⚠️ You now need to provide your Payload config with a database, a bundler, and a rich text adapter

Here's an example of a barebones Payload config, set up to work as 1.0 did:

import { mongooseAdapter } from "@payloadcms/db-mongodb";
import { slateEditor } from "@payloadcms/richtext-slate";
import { webpackBundler } from "@payloadcms/bundler-webpack";
import { buildConfig } from "payload/config";

export default buildConfig({
  admin: {
    bundler: webpackBundler(),
  },
  editor: slateEditor({}),
  collections: [
    // your collections here
  ],
  db: mongooseAdapter({
    url: process.env.DATABASE_URI,
  }),
});

These new properties are all now required for Payload to function, and you will have to install each separate adapter that you use. Feel free to swap out any of the adapters with your choice (Lexical, Postgres, Vite, etc.)

Make sure to install the packages that you need. In the above example, you would need to install the following:

npm install --save @payloadcms/db-mongodb @payloadcms/richtext-slate @payloadcms/bundler-webpack

⚠️ Draft versions now require a latest: true property to be set on the most recent draft in your _versions collections(s)

We have a ready-to-go migration script for your versions from v1 to v2, and to use it, all you have to do is run the following commands:

1. First, make sure you have a payload npm script in your package.json

{
  "scripts": {
    "payload": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts payload"
  }
}

Adjust the PAYLOAD_CONFIG_PATH to point to your Payload config file if necessary.

2. Create a migration, using the new Payload migration API

npm run payload migrate:create --file @payloadcms/db-mongodb/versions-v1-v2

The above command will output a migration file into your ./src/migrations folder (default migrations location). It contains a migration script to automatically add a latest: true flag to each of your newest drafts, for all draft-enabled collections. It works out of the box!

3. Run migrations

From there, you need to run migrations. Run the following command to execute your new migration:

npm run payload migrate

And you'll be all good!