Apostrophe 3.49.0/3.50.0 Locale improvements, RegExp for strings, more login options, and fixes

[BoDonkey]

Rise and Shine, Apostrophe Innovators!

This cycle features multiple updates and changes to Apostrophe core. This includes further improvements to the rich-text widget 'insert' menu UX and expanded keyboard accessibility.

Styling the login-related Vue components of either the core @apostrophecms/login or the Pro @apostrophecms-pro/signup modules has become a little easier. All of the logic has been abstracted away to mixins. If you have already copied the components to project level to style them, we encourage you to consider replacing the script tag with the new version to take advantage of future updates.

Also on the topic of user login, the @apostrophecms/passport-bridge module has been updated for better handling of access tokens and secondary account handling. Now a user with an e-mail-based login account can connect their GitHub account for login.

The string schema field has a new option, pattern. This option takes a regular expression string that is used to test the editor input and throws an error if the expression doesn't match the input. Ahh, the joy of forcing the editor to input everything in SCREAMING_SNAKE_CASE is now within your grasp!

The @apostrophecms/i18n module also received a shiny new option, redirectToFirstLocale. This option helps in redirecting users to the correct page if there are multiple locale matches for the hostname and all of them have a URL prefix. You can read more in the documentation. The rename-locale task of this module also received an update. And Assembly customers using @apostrophecms-pro/multisite can now rename locales via the dashboard without losing content or encountering bugs.

Finally, some changes were made to the internal Apostrophe Webpack build that allow for the use of pnpm instead of npm. This isn't something we necessarily encourage all our users to adopt, but you can learn more in the documentation if this is a use case you need for that shiny monorepo of yours!

Moving to changes outside of core, We had not one, but two contributions to the random-words repository. These changes involve converting the package to ES6, which includes renaming the generate() function and introducing a new count() function that returns the size of the dictionary being utilized. Since these are not backwards compatible changes, we bumped the major version number. Thanks to Nellfs and prateek-budhiraja🎉!

In this next cycle, we are pressing forward with implementation of page templating making it easier to start new projects with a unique look and add pages to existing projects. Thanks again to our vibrant community for speaking up on Discord and making wonderful contributions to our repos!

Apostrophe 3.50.0

Adds

• Introduced the @apostrophecms/page:reattach command line task, which is useful if the page tree data for a page has become corrupted.

Apostrophe 3.49.0

Changes

• Updates area UX to not display Add Content controls when a widget is focused.
• Updates area UX to unfocus widget on esc key.
• Updates widget UI to use dashed outlines instead of borders to indicate bounds.
• Updates UI for Insert Menu.
• Updates Insert Menu UX to allow mid-node insertion.
• Rich Text Widget's Insert components are now expected to emit done and cancel for proper RT cleanup. close still supported for BC, acts as done.
• Migrated the business logic of the login-related Vue components to external mixins, so that the templates and styles can be overridden by
  copying the component .vue file to project level without copying all of the business logic. If you have already copied the components to style them,
  we encourage you to consider replacing your script tag with the new version, which just imports the mixin, so that fixes we make there will be
  available in your project.

Adds

• Adds keyboard accessibility to Insert menu.
• Adds regex pattern feature for string fields.
• Adds pnpm support. Introduces new optional Apostrophe root configuration pnpm to force opt-in/out when auto detection fails. See the documentation for more details.
• Adds a warning if database queries involving relationships
  are made before the last apostrophe:modulesRegistered handler has fired.
  If you need to call Apostrophe's find() methods at startup,
  it is best to wait for the @apostrophecms/doc:beforeReplicate event.
• Allow @ when a piece is a template and /@ for page templates (doc-template-library module).
• Adds a prefix option to the http frontend util module.
  If explicitly set to false, prevents the prefix from being automatically added to the URL,
  when making calls with already-prefixed URLs for instance.
• Adds the redirectToFirstLocale option to the i18n module to prevent users from reaching a version of their site that would not match any locale when requesting the site without a locale prefix in the URL.
• If just one instance of a piece type should always exist (per locale if localized), the
  singletonAuto option may now be set to true or to an object with a slug option in
  order to guarantee it. This implicitly sets singleton: true as well. This is now used
  internally by @apostrophecms/global as well as the optional @apostrophecms-pro/palette module.

Fixes

• Fix 404 error when viewing/editing a doc which draft has a different version of the slug than the published one.
• Fixed a bug where multiple home pages can potentially be inserted into the database if the
  default locale is renamed. Introduced the async apos.doc.bestAposDocId(criteria) method to
  help identify the right aposDocId when inserting a document that might exist in
  other locales.
• Fixed a bug where singletons like the global doc might not be inserted at all if they
  exist under the former name of the default locale and there are no other locales.

Apostrophe 2.227.3

Fixes

• Bumped the version of momentjs that ships with A2 on the front end to the latest 2.x release to address a security warning. There was no actual
  security issue in practice due to the way this module is used on the front end in ApostropheCMS.

Apostrophe 3.x modules

@apostrophecms/passport-bridge 1.2.0

apostrophe-passport works together with passport-google-oauth20, passport-gitlab2 and similar passport strategy modules to let users log in to Apostrophe CMS sites via Google, Gitlab and other identity providers. This feature is often called federation or single sign-on.

• Support for making "connections" to secondary accounts. For instance, a user whose primary account login method is email can connect
  their account to a github account when the appropriate features are active as described in the documentation.
• Accept scope either as an option of the strategy, or as an authenticate property for the strategy, and
  pass it on to the strategy in both ways, as well as to both the login and callback routes. This allows passport-github2
  to capture the user's private email address correctly, and should help with other differences between strategies as well.
• Back to using upstream passport-oauth2-refresh now that our PR has been accepted (thanks).

Pro and Assembly modules

@apostrophecms-pro/advanced-permission 1.6.1

This module provides more granular control over content permission. It allows the creation of custom groups with proscribed abilities and the ability to assign users to as few or as many groups as desired. Users and groups can also be assigned per-document and per-locale permissions allowing for fine control of who can edit and publish any document. Contact us or visit our new pricing page to learn more.

Fixes

• Hides pieces in the manager modal if the user cannot edit or localize them.

@apostrophecms-pro/signup 1.0.0

A seamless solution that empowers users to easily create accounts on your website. Users can sign up in a few simple steps, complete with email verification and pre-determined user role and access level. Contact us or visit our new pricing page to learn more.

• Migrated the business logic of the signup-related Vue components to external mixins, so that the templates and styles can be overridden by
  copying the component .vue file to project level without copying all of the business logic. If you have already copied the components to style them,
  we encourage you to consider replacing your script tag with the new version, which just imports the mixin, so that fixes we make there will be
  available in your project as well.

@apostrophecms-pro/palette 3.2.0

An in-context interface for changing CSS. @apostrophecms-pro/palette is a module that provides an in-context interface for changing the values of developer-set CSS properties. The values are stored in an Apostrophe piece singleton (like @apostrophecms/global) and applied to the site whenever the stylesheet link is included in a template. Adjusting values via the palette interface renders changes to the site instantly. Contact us or visit our new pricing page to learn more.

• Fix bug where multiple palette objects can potentially be inserted into the database if the
  default locale is renamed.
• Use the new singletonAuto mechanism for more consistent results. Note that the apostrophe
  module must also be updated.

@apostrophecms-pro/multisite 3.11.0

This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Each has its own database, users, media uploads, etc. Sites can be created and managed via a dashboard site. Contact us or visit our new pricing page to learn more.

Adds

• Changing the name (not just the label) of a locale without losing content is now supported,
  although it can be a slow operation. We encourage making locale name choices early in the
  lifetime of a site if possible. Note that the apostrophe module must also be updated.
• Basic support for operations that must pause access to a site has been added.

Fixes

• Uses the new string field pattern from A3 core to block the user from saving a locale prefix without a slash,
  if a prefix is present.
• Uses the new string field pattern from A3 core to block user from saving a locale prefix without slash when there is a prefix.
• Connects successfully to MongoDB at localhost:27017 on Node 18. This issue was specific to localhost in certain environments.

Utilities

random-words 2.0.0

This module generates random words for use as sample text. We use it to generate random blog posts when testing Apostrophe.

This is a significant update that transforms this module into an ECMAScript module and changes the name of the exported function. For that reason, we have updated the major version number.

• Converted default export to named export (generate) to generate random words.
• Adds count named export to count number of words.
• Thanks to prateek-budhiraja for these updates.
• Addition of minLength option.
• Code update to ES6 Syntax.
• Thanks to Nellfs for these updates.