Version Packages (canary)

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to canary, this PR will be updated.

Releases

@bigcommerce/catalyst-core@1.4.0

Minor Changes

• #2709 3820a75 Thanks @jordanarldt! - Adds product review submission functionality to the product detail page via a modal form with validation for rating, title, review text, name, and email fields. Integrates with BigCommerce's GraphQL API using Conform and Zod for form validation and real-time feedback.

• #2690 44f6bc0 Thanks @jfugalde! - Introduce displayName and displayKey fields to facets for improved labeling and filtering

  Facet filters now use the displayName field for more descriptive labels in the UI, replacing the deprecated name field. Product attribute facets now support the filterKey field for consistent parameter naming. The facet transformer has been updated to use displayName with a fallback to filterName when displayName is not available.

• #2708 aa35bec Thanks @jordanarldt! - Adds OpenTelemetry instrumentation for Catalyst, enabling the collection of spans for Catalyst storefronts.

  Migration

  Change is new code only, so just copy over /core/instrumentation.ts and core/lib/otel/tracers.ts.

• #2711 fcd0836 Thanks @jordanarldt! - Separate first and last name fields on user session object.

Patch Changes

• #2750 c22f0e8 Thanks @jorgemoya! - Improved login error handling to display a custom error message when BigCommerce indicates a password reset is required, instead of showing a generic error message.

  What's Fixed

  When attempting to log in with an account that requires a password reset, users now see an informative error message: "Password reset required. Please check your email for instructions to reset your password."

  Before: Generic "something went wrong" error message
  After: Clear error message explaining the password reset requirement

  Migration

  Step 1: Update Translation Files

  Add this translation key to your locale files (e.g., core/messages/en.json):

  {
    "Auth": {
      "Login": {
        "passwordResetRequired": "Password reset required. Please check your email for instructions to reset your password."
      }
    }
  }

  Repeat for all supported locales if you maintain custom translations.

  Step 2: Update Login Server Action

  In your login server action (e.g., core/app/[locale]/(default)/(auth)/login/_actions/login.ts):

  Add the password reset error handling block:

  if (
    error instanceof AuthError &&
    error.type === 'CallbackRouteError' &&
    error.cause &&
    error.cause.err instanceof BigCommerceGQLError &&
    error.cause.err.message.includes('Reset password"')
  ) {
    return submission.reply({ formErrors: [t('passwordResetRequired')] });
  }

  This should be placed in your error handling, before the generic "Invalid credentials" check.