Strapi Release: 3.0.0-alpha.14.5

TL;DR

Strapi v3.0.0-alpha.14.5 brings significant improvements to the GraphQL plugin, including a new query for the current user and fixes for many-to-many relations. The release also enhances the admin interface with better language support, fixes content type display issues, and improves security. Documentation has been expanded with a new Webhooks guide, and the framework now auto-opens the admin panel on first start for better user experience.

Highlight of the Release

• New GraphQL query for retrieving current user data
• Fixed many-to-many relation queries in GraphQL for better symmetry
• Auto-opening admin panel on first start for improved user experience
• Added Russian language support and made English the default language
• Improved security with better permissions policy for GraphQL
• Fixed content types not appearing in left menu

Migration Guide

Upgrading to v3.0.0-alpha.14.5

No breaking changes have been introduced in this release, so upgrading should be straightforward:

1. Update your Strapi version in your package.json:

   "dependencies": {
     "strapi": "3.0.0-alpha.14.5",
     "strapi-admin": "3.0.0-alpha.14.5",
     "strapi-utils": "3.0.0-alpha.14.5",
     "strapi-plugin-content-manager": "3.0.0-alpha.14.5",
     "strapi-plugin-content-type-builder": "3.0.0-alpha.14.5",
     "strapi-plugin-users-permissions": "3.0.0-alpha.14.5",
     "strapi-plugin-email": "3.0.0-alpha.14.5",
     "strapi-plugin-upload": "3.0.0-alpha.14.5"
   }
   

2. Run npm install or yarn install to update your dependencies.

3. If you've been experiencing issues with GraphQL many-to-many relations, test your queries after upgrading as this release includes fixes for those issues.

4. If you're using custom GraphQL schema files with the .graphql extension, you can now optionally rename them to .graphql.js for better IDE support.

Upgrade Recommendations

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

• Use GraphQL with many-to-many relations
• Have experienced issues with content types not appearing in the left menu
• Need better internationalization support with Russian language
• Want improved security for GraphQL queries
• Have encountered blank pages in the Content Manager

The upgrade process is straightforward with no breaking changes, making it a low-risk update that brings numerous bug fixes and quality-of-life improvements. Since this is still an alpha release, it's recommended to test thoroughly in a development environment before deploying to production.

Bug Fixes

GraphQL Fixes

• Many-to-Many Relations: Fixed symmetry issues in many-to-many relation queries, ensuring consistent results when querying from either side of the relation.
• Array of IDs Comparison: Changed comparison operator for arrays of IDs to use 'IN' instead of '=' to properly handle multiple values.
• Null Property Handling: Fixed "Cannot read property 'toJSON' of null" error in GraphQL queries.

Admin Interface Fixes

• Content Type Display: Fixed issue where content types were not appearing in the left menu.
• Blank Page Prevention: Resolved problem where Content Manager would redirect to a blank page.
• User Creation: Fixed provider type not being properly set to 'local' during user creation in Admin UI.

Other Fixes

• Plugin Installation: Fixed plugin installation when using Yarn package manager.
• Duplicate Entries: Prevented duplicate entries in many-to-many relations.
• Google Auth: Updated username handling for Google Authentication.
• Multi-line Descriptions: Fixed support for multi-line descriptions in content types.

New Features

GraphQL Enhancements

• New Current User Query: Added a new GraphQL query to retrieve the current user's data with a special return type that avoids returning roles and permissions the user doesn't have access to.
• Support for Multiple File Extensions: Schema files can now use both .graphql and .graphql.js extensions, improving IDE compatibility while maintaining backward compatibility.

Admin Interface Improvements

• Auto-open Admin Panel: The admin panel now automatically opens on first start, providing a smoother onboarding experience.
• Enhanced Language Support: Added Russian language support and made English the default language in the admin panel.
• Better Password Reset Flow: Improved redirect handling after password reset for a more seamless user experience.

Security Updates

GraphQL Security Enhancements

• Permissions Policy: Improved permissions policy to prevent security breaches with GraphQL by ensuring proper access control.

Vulnerability Fixes

• GitHub Alert Remediation: Addressed vulnerability alerts on GitHub for projects to enhance overall security.

Authentication Improvements

• User Provider Setting: Fixed provider type setting during user creation to ensure proper authentication flow.

Performance Improvements

Code Quality and Performance

• Redux-Sagas Updates: Fixed deprecation warnings in redux-sagas for better future compatibility.
• Code Style Improvements: Enhanced code style and quality throughout the codebase.
• ESLint Upgrade: Updated ESLint to version 4 for better code linting capabilities.

Content Manager Optimization

• Component Rendering: Improved Content Manager component rendering for better performance.
• beforeSave Hook Handling: Fixed Content Manager save to properly handle beforeSave hook throw errors.

Impact Summary

This release significantly improves the GraphQL plugin functionality, fixing several critical issues with many-to-many relations and adding a new query for retrieving the current user's data. The admin interface receives multiple enhancements, including better language support with Russian translation and English as the default, fixed content type display in the left menu, and auto-opening on first start.

Security is improved through better permissions policy for GraphQL and vulnerability fixes. The developer experience is enhanced with support for both .graphql and .graphql.js file extensions and improved plugin installation with Yarn.

Content editors will benefit from fixes to the Content Manager, including resolved blank page issues and better support for multi-line descriptions in content types. Documentation has been expanded with a new Webhooks guide and various clarifications.

Overall, this release focuses on stability, security, and user experience improvements across the board, making it a recommended upgrade for all Strapi alpha users.

Full Release Notes