@sasjs/cli 6.30.0 → 6.31.0

package/build/commands/version/spec/version.spec.js

@@ -75,6 +75,11 @@ describe('versionMessage', function () {
         writePackage(root, '6.4.7-alpha.1');
         expect((0, version_1.versionMessage)(root)).toEqual("You are using a linked version of SASjs CLI (v6.4.7-alpha.1) running from sources at ".concat(root));
     });
+    it('leaves the placeholder version out of a source checkout', function () {
+        var root = path_1.default.join(tempRoot(), 'cli');
+        writePackage(root, '0.0.0');
+        expect((0, version_1.versionMessage)(root)).toEqual("You are using a linked version of SASjs CLI running from sources at ".concat(root));
+    });
     it('leaves the version out of a source checkout that has none', function () {
         var root = path_1.default.join(tempRoot(), 'cli');
         writePackage(root, undefined);
@@ -92,6 +97,11 @@ describe('versionMessage', function () {
     it('throws when an installed package carries no version', function () {
         var root = packageRoot();
         writePackage(root, undefined);
-        expect(function () { return (0, version_1.versionMessage)(root); }).toThrow(/has no version in its package.json/);
+        expect(function () { return (0, version_1.versionMessage)(root); }).toThrow(/has no version in its package.json\./);
+    });
+    it('names the placeholder when an installed package was never stamped', function () {
+        var root = packageRoot();
+        writePackage(root, '0.0.0');
+        expect(function () { return (0, version_1.versionMessage)(root); }).toThrow(/carries the placeholder version 0\.0\.0, so it was never stamped from a tag/);
     });
 });

package/build/commands/version/version.d.ts

@@ -4,9 +4,11 @@
  * Reads the version from the package.json of the package that is running, so
  * it works for every install shape - global, project-local, `npx`, a temp
  * prefix, or embedded as a dependency. A package root outside a
- * `node_modules` folder is a source checkout (an `npm link`, or a local
- * build), and is reported as such; a source checkout carries no version until
- * semantic-release writes one, so the version is left out when it is absent.
+ * `node_modules` folder is a source checkout (an `npm link`, or a local build),
+ * and is reported as such. Its package.json carries the placeholder version
+ * (`0.0.0`): the version is the git tag, stamped in when the package is
+ * published, so from sources there is nothing to report and the version is left
+ * out.
  *
  * @param packageRoot - the folder holding the package.json of the running CLI.
  */

package/build/commands/version/version.js

@@ -49,9 +49,11 @@ var path_1 = __importDefault(require("path"));
  * Reads the version from the package.json of the package that is running, so
  * it works for every install shape - global, project-local, `npx`, a temp
  * prefix, or embedded as a dependency. A package root outside a
- * `node_modules` folder is a source checkout (an `npm link`, or a local
- * build), and is reported as such; a source checkout carries no version until
- * semantic-release writes one, so the version is left out when it is absent.
+ * `node_modules` folder is a source checkout (an `npm link`, or a local build),
+ * and is reported as such. Its package.json carries the placeholder version
+ * (`0.0.0`): the version is the git tag, stamped in when the package is
+ * published, so from sources there is nothing to report and the version is left
+ * out.
  *
  * @param packageRoot - the folder holding the package.json of the running CLI.
  */
@@ -65,13 +67,21 @@ var versionMessage = function (packageRoot) {
             "Reinstall the CLI - 'npm i -g @sasjs/cli@latest'.");
     }
     var fromSources = !packageRoot.split(path_1.default.sep).includes('node_modules');
+    // the placeholder means "not stamped from a tag" - the same thing as absent
+    var stated = version && !/^0\.0\.0(-|$)/.test(version) ? version : undefined;
     if (fromSources) {
-        return version
-            ? "You are using a linked version of SASjs CLI (v".concat(version, ") running from sources at ").concat(packageRoot)
+        return stated
+            ? "You are using a linked version of SASjs CLI (v".concat(stated, ") running from sources at ").concat(packageRoot)
             : "You are using a linked version of SASjs CLI running from sources at ".concat(packageRoot);
     }
-    if (!version) {
-        throw new Error("The installed CLI at ".concat(packageRoot, " has no version in its package.json. ") +
+    if (!stated) {
+        // two ways to get here, and they mean different things to whoever is reading
+        // it: no version field at all, or the placeholder that was never stamped from
+        // a tag
+        var reason = version
+            ? "carries the placeholder version ".concat(version, ", so it was never stamped from a tag")
+            : 'has no version in its package.json';
+        throw new Error("The installed CLI at ".concat(packageRoot, " ").concat(reason, ". ") +
             "Reinstall it - 'npm i -g @sasjs/cli@latest'.");
     }
     return "You are using SASjs CLI v".concat(version);

package/build/types/mockWebBasePath.d.ts

@@ -20,5 +20,14 @@ declare module '@sasjs/utils/types/config' {
          * slash (`/demo`). Unset means the origin root.
          */
         mockWebBasePath?: string;
+        /**
+         * Whether the mock site carries the API console at `<base>/api/`.
+         *
+         * On unless it is set to false: the console is how a demonstration site lets
+         * a visitor try the API it is a mock of, and a page nothing links to costs
+         * the app nothing. A site whose output must be the app and nothing else
+         * turns it off.
+         */
+        mockApi?: boolean;
     }
 }

package/package.json

@@ -1,5 +1,6 @@
 {
   "name": "@sasjs/cli",
+  "version": "6.31.0",
   "description": "Command line interface for SASjs",
   "engines": {
     "node": "^22.14.0 || >=24.10.0"
@@ -9,43 +10,23 @@
     "build/**/*"
   ],
   "scripts": {
-    "start:ci": "npm run build && npm run set:permissions",
-    "start": "nodemon --watch \"src/**/*\" --exec \"npm run build && npm run set:permissions\"",
-    "set:permissions": "node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "build": "npx rimraf build && tsc -p . && npm run copy:files",
-    "copy:files": "copyfiles -u 1 ./src/config.json ./build/ && npm run copy:doxy && npm run copy:mock",
     "copy:doxy": "copyfiles -u 2 src/doxy/* build/doxy/",
+    "copy:files": "copyfiles -u 1 ./src/config.json ./build/ && npm run copy:doxy && npm run copy:mock",
     "copy:mock": "copyfiles -u 6 src/commands/build/internal/mockSite/assets/* build/commands/build/internal/mockSite/assets/",
+    "doc": "npx compodoc -p tsconfig.doc.json --coverageTest 16 --coverageTestThresholdFail",
+    "lint": "npx prettier --check \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,yml,md,graphql}\"",
+    "lint:fix": "npx prettier --write \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,yml,md,graphql}\"",
+    "prepublishOnly": "node -e \"const v=require('./package.json').version; if (/^0\\.0\\.0/.test(v)) { console.error('refusing to publish ' + v + ': the version is stamped from the tag (npm version <tag> --no-git-tag-version)'); process.exit(1) }\"",
+    "release": "sasjs-release",
+    "set:permissions": "node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "start": "nodemon --watch \"src/**/*\" --exec \"npm run build && npm run set:permissions\"",
+    "start:ci": "npm run build && npm run set:permissions",
     "test": "npm run test:mocked && npm run test:server",
-    "test:server": "jest --silent --runInBand --config=jest.server.config.js",
     "test:mocked": "jest --silent --runInBand --config=jest.config.js --coverage",
-    "lint:fix": "npx prettier --write \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,yml,md,graphql}\"",
-    "lint": "npx prettier --check \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,yml,md,graphql}\"",
-    "doc": "npx compodoc -p tsconfig.doc.json --coverageTest 16 --coverageTestThresholdFail"
+    "test:server": "jest --silent --runInBand --config=jest.server.config.js"
   },
   "testServerTypes": "sasjs",
-  "release": {
-    "branches": [
-      "main"
-    ],
-    "plugins": [
-      "@semantic-release/commit-analyzer",
-      "@semantic-release/release-notes-generator",
-      [
-        "@semantic-release/npm",
-        {
-          "npmPublish": false
-        }
-      ],
-      [
-        "@semantic-release/exec",
-        {
-          "publishCmd": "npm publish --provenance --access public"
-        }
-      ],
-      "@semantic-release/github"
-    ]
-  },
   "bin": {
     "sasjs": "build/index.js"
   },
@@ -97,6 +78,7 @@
     "@babel/preset-env": "7.29.7",
     "@babel/preset-typescript": "7.29.7",
     "@nogoo9/gitleaks": "8.30.1-post.2",
+    "@sasjs/release": "0.1.3",
     "@types/debug": "4.1.13",
     "@types/find": "0.2.4",
     "@types/jest": "30.0.0",
@@ -124,6 +106,5 @@
   "overrides": {
     "ws": "8.21.0",
     "nanoid": "3.3.18"
-  },
-  "version": "6.30.0"
+  }
 }