[Chore] [v21] Release process, maintenance simplification

README.md

@@ -81,7 +81,9 @@ To create a JSS project for an older version of JSS and Sitecore:
 
 ## Documentation and community resources
 
-- [Official JSS documentation](https://doc.sitecore.com/xp/en/developers/hd/200/sitecore-headless-development/sitecore-javascript-rendering-sdks--jss-.html)
+- Official JSS documentation:
+  - [XM Cloud](https://doc.sitecore.com/xmc/en/developers/jss/latest/jss-xmc/index-en.html)
+  - [XP](https://doc.sitecore.com/xp/en/developers/hd/latest/sitecore-headless-development/sitecore-javascript-rendering-sdks--jss-.html)
 - [StackExchange](https://sitecore.stackexchange.com/)
 - [Community Slack](https://sitecorechat.slack.com/messages/jss)
 - [Sitecore Community Forum](https://community.sitecore.net/developers/f/40)

packages/create-sitecore-jss/package.json

@@ -50,6 +50,7 @@
     "@types/minimist": "^1.2.2",
     "@types/mocha": "^10.0.1",
     "@types/node": "^18.11.18",
+    "@types/proxyquire": "^1.3.31",
     "@types/sinon": "17.0.2",
     "@types/sinon-chai": "^3.2.9",
     "chai": "^4.3.7",
@@ -58,6 +59,7 @@
     "eslint": "^8.32.0",
     "mocha": "^10.2.0",
     "nyc": "^15.1.0",
+    "proxyquire": "^2.1.3",
     "sinon": "^15.0.1",
     "sinon-chai": "^3.7.0",
     "ts-node": "^10.9.1",

packages/create-sitecore-jss/src/common/processes/transform.test.ts

@@ -7,6 +7,7 @@ import ejs from 'ejs';
 import glob from 'glob';
 import { expect } from 'chai';
 import sinon, { SinonStub } from 'sinon';
+import proxyquire from 'proxyquire';
 import { currentPkg, partialPkg } from '../test-data/pkg';
 import * as transform from './transform';
 import * as helpers from '../utils/helpers';
@@ -507,7 +508,6 @@ describe('transform', () => {
 
       globSyncStub = sinon.stub(glob, 'sync').returns([file]);
       ejsRenderFileStub = sinon.stub(ejs, 'renderFile').returns(Promise.resolve(renderFileOutput));
-      diffAndWriteFilesStub = sinon.stub(transform, 'diffAndWriteFiles');
 
       const answers = {
         destination: destinationPath,
@@ -516,10 +516,17 @@ describe('transform', () => {
         force: false,
       };
 
-      await transformFunc(templatePath, answers);
+      const transformModule = proxyquire('./transform', {
+        '../../../package.json': { version: '22.2.1-canary.33' },
+      });
+
+      diffAndWriteFilesStub = sinon.stub(transformModule, 'diffAndWriteFiles');
+
+      await transformModule.transform(templatePath, answers);
 
       expect(ejsRenderFileStub).to.have.been.calledOnceWith(path.join(templatePath, file), {
         ...answers,
+        version: '22.2.1-canary',
         helper: {
           isDev: false,
           getPascalCaseName: helpers.getPascalCaseName,
@@ -629,8 +636,6 @@ describe('transform', () => {
       fsExistsSyncStub = sinon.stub(fs, 'existsSync').returns(true);
       openPackageJsonStub = sinon.stub(helpers, 'openPackageJson').returns(currentPkg);
       ejsRenderFileStub = sinon.stub(ejs, 'renderFile').returns(Promise.resolve(renderFileOutput));
-      mergeStub = sinon.stub(transform, 'merge').returns(mergedPkg);
-      diffAndWriteFilesStub = sinon.stub(transform, 'diffAndWriteFiles');
 
       const answers = {
         destination: destinationPath,
@@ -639,10 +644,18 @@ describe('transform', () => {
         force: false,
       };
 
-      await transformFunc(templatePath, answers);
+      const transformModule = proxyquire('./transform', {
+        '../../../package.json': { version: '22.2.1-canary.33' },
+      });
+
+      diffAndWriteFilesStub = sinon.stub(transformModule, 'diffAndWriteFiles');
+      mergeStub = sinon.stub(transformModule, 'merge').returns(mergedPkg);
+
+      await transformModule.transform(templatePath, answers);
 
       expect(ejsRenderFileStub).to.have.been.calledOnceWith(path.join(templatePath, file), {
         ...answers,
+        version: '22.2.1-canary',
         helper: {
           isDev: false,
           getPascalCaseName: helpers.getPascalCaseName,
@@ -669,8 +682,13 @@ describe('transform', () => {
       fsExistsSyncStub = sinon.stub(fs, 'existsSync').returns(true);
       fsReadFileSunc = sinon.stub(fs, 'readFileSync').returns(currentDotEnv);
       ejsRenderFileStub = sinon.stub(ejs, 'renderFile').returns(Promise.resolve(templateDotEnv));
-      mergeEnvStub = sinon.stub(transform, 'mergeEnv').returns(concatDotEnv);
-      diffAndWriteFilesStub = sinon.stub(transform, 'diffAndWriteFiles');
+
+      const transformModule = proxyquire('./transform', {
+        '../../../package.json': { version: '22.2.1-canary.33' },
+      });
+
+      mergeEnvStub = sinon.stub(transformModule, 'mergeEnv').returns(concatDotEnv);
+      diffAndWriteFilesStub = sinon.stub(transformModule, 'diffAndWriteFiles');
 
       const answers = {
         destination: destinationPath,
@@ -679,10 +697,11 @@ describe('transform', () => {
         force: false,
       };
 
-      await transformFunc(templatePath, answers);
+      await transformModule.transform(templatePath, answers);
 
       expect(ejsRenderFileStub).to.have.been.calledOnceWith(path.join(templatePath, file), {
         ...answers,
+        version: '22.2.1-canary',
         helper: {
           isDev: false,
           getPascalCaseName: helpers.getPascalCaseName,

packages/create-sitecore-jss/src/common/processes/transform.ts

@@ -15,6 +15,7 @@ import {
 } from '../utils/helpers';
 import { diffLines, diffJson, Change } from 'diff';
 import { BaseArgs } from '../args/base';
+const { version } = require('../../../package.json');
 
 const FILE_FOR_COPY_REGEXP = /(index\.html)$|\.(gif|jpg|jpeg|tiff|png|svg|ashx|ico|pdf|jar|eot|woff|ttf|woff2)$/;
 
@@ -237,9 +238,15 @@ export const transform = async (
     answers.appPrefix = false;
   }
 
+  // Don't expose canary build number in the generated app
+  const jssVersion = version.includes('canary')
+    ? version.replace(/(-canary\.\d+)$/, '-canary')
+    : version;
+
   // pass in helper to answers object
   const ejsData: Data = {
     ...answers,
+    version: jssVersion,
     helper: {
       isDev: isDevEnvironment(answers.destination),
       getPascalCaseName: getPascalCaseName,

packages/create-sitecore-jss/src/templates/angular/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%- appName %>",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "description": "Application utilizing Sitecore JavaScript Services and Angular (angular-cli).",
   "config": {
     "appName": "<%- appName %>",
@@ -60,7 +60,7 @@
     "@apollo/client": "^3.3.12",
     "@ngx-translate/core": "~15.0.0",
     "@ngx-translate/http-loader": "~8.0.0",
-    "@sitecore-jss/sitecore-jss-angular": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-angular": "~<%- version %>",
     "apollo-angular": "~6.0.0",
     "bootstrap": "^5.3.3",
     "core-js": "~3.37.1",
@@ -82,9 +82,9 @@
     "@angular/cli": "~17.3.10",
     "@angular/compiler-cli": "~17.3.12",
     "@angular/language-service": "~17.3.12",
-    "@sitecore-jss/sitecore-jss-angular-schematics": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-cli": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-angular-schematics": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-cli": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
     "@types/isomorphic-fetch": "0.0.35",
     "@types/jasmine": "~3.6.7",
     "@types/jasminewd2": "~2.0.8",

packages/create-sitecore-jss/src/templates/nextjs-styleguide/package.json

@@ -4,7 +4,7 @@
     "nprogress": "~0.2.0"
   },
   "devDependencies": {
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
     "@types/nprogress": "^0.2.0"
   },
   "scripts": {

packages/create-sitecore-jss/src/templates/nextjs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "<%- appName %>",
   "description": "Application utilizing Sitecore JavaScript Services and Next.js",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "private": true,
   "config": {
     "appName": "<%- appName %>",
@@ -25,7 +25,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@sitecore-jss/sitecore-jss-nextjs": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-nextjs": "~<%- version %>",
     "graphql": "~15.8.0",
     "graphql-tag": "^2.12.6",
     "next": "^14.1.0",
@@ -42,8 +42,8 @@
     "@graphql-codegen/typescript-operations": "^4.0.1",
     "@graphql-codegen/typescript-resolvers": "^4.0.1",
     "@graphql-typed-document-node/core": "^3.2.0",
-    "@sitecore-jss/sitecore-jss-cli": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-cli": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
     "@types/node": "^18.11.18",
     "@types/react": "^18.2.22",
     "@types/react-dom": "^18.0.5",

packages/create-sitecore-jss/src/templates/node-headless-ssr-experience-edge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-headless-ssr-experience-edge-sample",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "description": "Node server-side-rendering sample for running JSS apps under Node hosting using Experience Edge",
   "scripts": {
     "start": "ts-node ./src/index.ts"
@@ -19,7 +19,7 @@
   "homepage": "https://jss.sitecore.com",
   "license": "Apache-2.0",
   "dependencies": {
-    "@sitecore-jss/sitecore-jss": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss": "~<%- version %>",
     "compression": "^1.7.4",
     "express": "^4.18.2",
     "dotenv": "^16.0.3"

packages/create-sitecore-jss/src/templates/node-headless-ssr-proxy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-headless-ssr-proxy-sample",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "description": "Node server-side-rendering proxy sample for running JSS apps under Node hosting",
   "scripts": {
     "start": "ts-node ./src/index.ts"
@@ -19,8 +19,8 @@
   "homepage": "https://jss.sitecore.com",
   "license": "Apache-2.0",
   "dependencies": {
-    "@sitecore-jss/sitecore-jss": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-proxy": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-proxy": "~<%- version %>",
     "agentkeepalive": "^4.2.1",
     "compression": "~1.7.4",
     "express": "~4.18.2",

packages/create-sitecore-jss/src/templates/react-native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%- appName %>",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "description": "A basic React Native app utilizing Sitecore JavaScript Services",
   "config": {
     "appName": "<%- appName %>",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "@react-native-community/masked-view": "^0.1.10",
-    "@sitecore-jss/sitecore-jss-react-native": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-react-native": "~<%- version %>",
     "prop-types": "^15.6.0",
     "react": "16.13.1",
     "react-native": "^0.63.4",
@@ -37,8 +37,8 @@
   },
   "private": true,
   "devDependencies": {
-    "@sitecore-jss/sitecore-jss-cli": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-cli": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
     "babel-core": "^6.26.0",
     "babel-eslint": "^8.2.1",
     "babel-plugin-inline-replace-variables": "^1.3.1",

packages/create-sitecore-jss/src/templates/react/package.json

@@ -1,7 +1,7 @@
 {
   "name": "<%- appName %>",
   "description": "Application utilizing Sitecore JavaScript Services and React (create-react-app).",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "private": true,
   "config": {
     "appName": "<%- appName %>",
@@ -28,7 +28,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@apollo/client": "^3.7.1",
-    "@sitecore-jss/sitecore-jss-react": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-react": "~<%- version %>",
     "axios": "^1.2.0",
     "bootstrap": "^5.2.3",
     "cross-fetch": "^3.1.5",
@@ -53,9 +53,9 @@
     "@babel/preset-env": "^7.20.2",
     "@babel/preset-react": "^7.18.6",
     "@babel/register": "~7.18.9",
-    "@sitecore-jss/sitecore-jss-cli": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-rendering-host": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-cli": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-rendering-host": "~<%- version %>",
     "babel-loader": "~9.1.0",
     "babel-preset-react-app": "~10.0.1",
     "chalk": "~4.1.2",

packages/create-sitecore-jss/src/templates/vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%- appName %>",
-  "version": "21.8.1-canary",
+  "version": "<%- version %>",
   "description": "Application utilizing Sitecore JavaScript Services and Vue (vue-cli).",
   "private": true,
   "config": {
@@ -45,7 +45,7 @@
   "dependencies": {
     "@apollo/client": "^3.7.4",
     "@panter/vue-i18next": "~0.15.2",
-    "@sitecore-jss/sitecore-jss-vue": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-vue": "~<%- version %>",
     "@vue/apollo-composable": "4.0.0-beta.2",
     "@vue/apollo-option": "^4.0.0-alpha.20",
     "@vue/apollo-ssr": "^4.0.0-alpha.18",
@@ -64,8 +64,8 @@
   "devDependencies": {
     "@babel/eslint-parser": "^7.19.1",
     "@babel/register": "7.18.9",
-    "@sitecore-jss/sitecore-jss-cli": "~21.8.1-canary",
-    "@sitecore-jss/sitecore-jss-dev-tools": "~21.8.1-canary",
+    "@sitecore-jss/sitecore-jss-cli": "~<%- version %>",
+    "@sitecore-jss/sitecore-jss-dev-tools": "~<%- version %>",
     "@vue/cli-plugin-babel": "~5.0.8",
     "@vue/cli-plugin-eslint": "~5.0.8",
     "@vue/cli-service": "~5.0.8",