JSS package incompatability with older versions

[mattyindustries]

Describe the Bug

I'm working on a Next.JS Sitecore project that I'm wanting to target 21.0.8 as we don't have the time nor inclination right now to investigate the switch from Next.JS 12 to Next.JS 13.

Because of the way YARN/NPM handle versioning within the package.json files the syntax

"@sitecore-jss/sitecore-jss-nextjs": "^21.0.8",

This is currently valid for 21.0.8, 21.1.0, 21.1.1 and 21.1.2.

This flows through all of the sub packages as well and we keep getting Next.JS 13 compatible packages which is breaking our build.

I've no problem with your versioning strategy however I think you should go through your package.json's and update them to

"@sitecore-jss/sitecore-jss-nextjs": "~21.0.8",

which won't cross the minor version boundary.

To Reproduce

Establish a new Sitecore Next.JS site with version 21.0.8

npx [email protected] --templates nextjs,nextjs-sxa --appName testing--destination . --fetchWith GraphQL --prerender SSG --hostName www.testing.localhost

Perform a yarn install and build

Look in node_modules or yarn.lock to see version 21.1.2

  "name": "@sitecore-jss/sitecore-jss-nextjs",
  "version": "21.1.2",
  "main": "dist/cjs/index.js",
  "module": "dist/esm/index.js",

Expected Behavior

Sitecore packages remain compatible and don't introduce a breaking change or new functionality not desired.

Possible Fix

Update package.json files to use the ~ rather than the ^

Provide environment information

• Sitecore Version: 10.3
• JSS Version: 21
• Browser Name and version: Chrome
• Operating System and version (desktop or mobile): Windows
• Link to your project (if available): N/A

[ambrauer]

Thanks for the information, we've added this to our backlog to investigate / fix in an upcoming release.

[mattyindustries]

Thanks @ambrauer . Awesome work

[mattyindustries]

Thanks very much for releasing 21.0.9 which backports these changes.

Very appreciated.

[addy-pathania]

@mattyindustries there was another correction so it should be 21.0.10 :)