TL;DR

Payload CMS v1.15.0 Release

What's new: This release introduces geospatial query capabilities with within and intersects operators, improves TypeScript typing in sanitization functions, enhances the e-commerce template with draft preview and on-demand revalidation, and fixes filtering for hasMany number fields.

Why it matters: Developers working with location data can now perform more sophisticated geospatial queries. The improved templates and examples provide better starting points for e-commerce projects with draft preview functionality.

Who should care: Developers building applications with geospatial components, e-commerce sites, or those who need better TypeScript support in their Payload CMS projects.

Highlight of the Release

• New geospatial query operators: within and intersects with dynamic GraphQL operator types
• Improved TypeScript typing in sanitization functions
• Enhanced e-commerce template with draft preview and on-demand revalidation
• Better handling of network requests in templates
• Static cart page fallback rendering for e-commerce template

Migration Guide

No breaking changes were introduced in this release, so no migration is required.

If you're using the e-commerce template or draft preview examples, you may want to update to the latest versions to take advantage of the new features:

# For updating an existing e-commerce project
# Pull the latest changes and merge them into your project

# For the draft-preview example, update to use revalidateTag
# See the updated example in the repository

For developers wanting to use the new geospatial query operators, refer to the documentation for implementation details.

Upgrade Recommendations

This is a feature release with no breaking changes, so upgrading should be straightforward for most users.

To upgrade:

npm install [email protected]
# or
yarn add [email protected]
# or
pnpm add [email protected]

The upgrade is recommended for:

• Developers working with geospatial data who need the new query operators
• Projects using the e-commerce template who want draft preview functionality
• Anyone who wants improved TypeScript typing in sanitization functions

There are no known compatibility issues with this release.

Bug Fixes

Filtering Improvements

• Fixed filtering for hasMany number fields
• Improved checkbox UI and interaction
• Added proper limit reached notification for collections

New Features

Geospatial Query Support

• Added support for geospatial query operators within and intersects
• Implemented dynamic GraphQL operator types for geospatial queries
• This enables more sophisticated location-based filtering and queries

E-commerce Template Enhancements

• Implemented draft preview functionality for content editors
• Added on-demand revalidation for more efficient content updates
• Created static cart page fallback for improved performance
• Improved handling of network requests for better reliability

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Template Performance

• Added static cart page fallback in e-commerce template for better performance when dynamic rendering fails
• Implemented on-demand revalidation in e-commerce template to reduce unnecessary rebuilds
• Improved handling of network requests to prevent failures and provide graceful fallbacks

TypeScript Improvements

• Enhanced TypeScript typing in sanitization functions for better developer experience and code reliability

Impact Summary

Payload CMS v1.15.0 is primarily a feature and improvement release that enhances developer experience and adds capabilities without introducing breaking changes.

The addition of geospatial query operators (within and intersects) is significant for applications dealing with location data, enabling more sophisticated filtering and search capabilities. This feature, combined with dynamic GraphQL operator types, provides developers with more powerful tools for building location-aware applications.

The improvements to the e-commerce template, including draft preview, on-demand revalidation, and static cart page fallbacks, make it a more robust starting point for e-commerce projects. These enhancements improve both the content editing experience and the end-user experience through better performance and reliability.

TypeScript improvements in sanitization functions will benefit developers by providing better type safety and code completion, reducing potential errors and improving development speed.

Overall, this release focuses on quality-of-life improvements for developers and enhanced capabilities for specific use cases rather than introducing major architectural changes.

Full Release Notes