Strapi Release: 3.0.0-beta.14

TL;DR

Strapi v3.0.0-beta.14 brings important updates to the framework's database handling, authentication, and GraphQL functionality. This release includes MongoDB Atlas documentation improvements, package updates for better performance and compatibility, and several critical bug fixes for Google authentication and GraphQL queries. Developers using SQL databases or GraphQL will particularly benefit from these fixes.

Highlight of the Release

• Updated MongoDB Atlas documentation for easier database setup and deployment
• Fixed Google authentication issues in the Users & Permissions plugin
• Resolved GraphQL query issues on SQL databases
• Updated bookshelf and knex packages for better database performance
• Fixed missing connector in generated database.json files

Migration Guide

No specific migration steps are required for this beta release. However, developers should note:

1. If you're using MongoDB Atlas, refer to the updated documentation for the latest recommended configuration.

2. If you've experienced issues with Google authentication or GraphQL queries on SQL databases, upgrading to this version should resolve those problems without additional configuration.

3. The updated engine configuration standardizes Node.js version requirements across Strapi packages. Ensure your development environment meets these requirements.

Upgrade Recommendations

This release is recommended for all Strapi beta users, especially those:

• Using Google authentication
• Working with GraphQL and SQL databases
• Setting up MongoDB Atlas deployments
• Experiencing issues with database connectors in new projects

To upgrade:

npm install [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]

Or if using yarn:

yarn upgrade [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]

Bug Fixes

Framework Fixes

• Database Configuration Fix: Resolved an issue where the connector was missing in generated database.json files when creating new Strapi projects, which prevented proper database connections.

Plugin Fixes

• Google Authentication: Fixed issues with Google authentication in the Users & Permissions plugin, ensuring users can properly authenticate using Google accounts.

• GraphQL Improvements:

  • Fixed the GraphQL 'me' query route when using bookshelf/SQL databases, which previously wasn't returning proper user data
  • Resolved an issue where GraphQL wasn't using the amountLimit setting when no limit was provided in queries (fixes #3648)
  • Improved query handling to ensure consistent results across different database types

New Features

Framework Enhancements

• Updated Engine Configuration: The Node.js engine requirements have been updated across all Strapi packages for better compatibility and performance. This standardizes the engine configuration across the framework.

• Package Updates:

  • Updated koa-ip version for improved IP handling
  • Updated bookshelf and knex packages to their latest versions for better database performance and compatibility

Documentation Improvements

• MongoDB Atlas Guide: Comprehensive update to the MongoDB Atlas documentation in both database and deployment sections, making it easier for developers to set up and deploy Strapi with MongoDB Atlas.

• Removed i18n Example: The internationalization example has been removed from the documentation.

Security Updates

No specific security fixes were included in this release. However, keeping dependencies up-to-date with the package updates (koa-ip, bookshelf, and knex) helps maintain the overall security posture of Strapi installations.

Performance Improvements

Database Performance

• Updated Database Packages: The update to the latest versions of bookshelf and knex packages brings performance improvements for SQL database operations, resulting in more efficient queries and better overall database interaction.

• GraphQL Query Optimization: The fix for GraphQL amountLimit handling ensures that queries are properly limited, preventing potential performance issues from overly large result sets when no explicit limit is provided.

Impact Summary

Strapi v3.0.0-beta.14 focuses on improving stability and developer experience with several important bug fixes and enhancements. The fixes for Google authentication and GraphQL queries address significant pain points reported by the community, while the updated MongoDB Atlas documentation makes database setup and deployment more accessible.

The update to bookshelf and knex packages improves database performance for SQL users, and the fix for missing connectors in generated database.json files resolves a critical issue that affected new project creation.

This release demonstrates Strapi's commitment to improving the developer experience across different database types and authentication methods, making the beta version more stable as it moves toward a production-ready release. The changes are particularly valuable for developers working with SQL databases, GraphQL APIs, and third-party authentication providers.

Full Release Notes