@sasjs/server 3.6.2 → 3.7.0

package/README.md

@@ -19,55 +19,61 @@ SASjs Server is available in two modes - Desktop (without authentication) and Se
 
 ## Installation
 
-Installation can be made programmatically using command line, or by manually downloading and running the executable.
+Two channels - the npm package and the standalone executable. Both read the same
+environment variables and serve the same API.
 
-### Programmatic
+### npm
 
-Fetch the relevant package from github using `curl`, eg as follows (for linux):
+```bash
+npx @sasjs/server@3.6.2
+```
+
+Or install it once and run `sasjs-server` from then on:
 
 ```bash
-curl -L https://github.com/sasjs/server/releases/latest/download/linux.zip > linux.zip
-unzip linux.zip
+npm install -g @sasjs/server
+sasjs-server
 ```
 
-The app can then be launched with `./api-linux` and prompts followed (if ENV vars not set).
+Requires Node 22 or later. Useful where Node is already managed by the platform,
+and the only channel that runs on arm64 (Apple Silicon, Graviton, a Pi), because
+the standalone executables are built for x64 only.
 
-### Manual
+Three things to know before choosing it:
 
-1. Download the relevant package from the [releases](https://github.com/sasjs/server/releases) page
-2. Trigger by double clicking (windows) or executing from commandline.
+- **Pin the version**, as above: an unpinned `npx @sasjs/server` re-resolves
+  `latest` on every run, so a restart becomes a silent upgrade.
+- **`.env` is read from the working directory.** `dotenv.config()` is relative to
+  where the process starts, so run it from the project directory you want the
+  server to own (that directory also gets the `./sasjs_root`). Under `npx` the
+  package itself lives in an evictable `~/.npm/_npx/<hash>` cache, so an `.env`
+  placed there would be lost - it belongs beside the command, not the code.
+- **It starts in desktop mode**, the single-user mode. The `RUN_AS` check still
+  refuses to run as root, so install it under the account that should own the SAS
+  sessions rather than starting it with `sudo`.
 
-You are presented with two prompts (if not set as ENV vars):
+Installing the package runs no install script, so it makes no network call of its
+own.
 
-- Location of your `sas.exe` / `sas.sh` executable
-- Path to a filesystem location for Stored Programs and temporary files
+### Standalone executable
 
-## Deployment options
+Download the relevant package from the [releases](https://github.com/sasjs/server/releases)
+page, or fetch it programmatically (linux):
 
-The server runs as a standalone executable (above) and as a Node process. Both
-read the same environment variables and serve the same API.
+```bash
+curl -L https://github.com/sasjs/server/releases/latest/download/linux.zip > linux.zip
+unzip linux.zip
+```
 
-- **Standalone executable** - the zip from the releases page, with SAS and a data
-  path supplied either as prompts or as `SAS_PATH` / `DATA_DIR`.
-- **Node** - `npx @sasjs/server@3.4.0`, or `npm install -g @sasjs/server` and run
-  `sasjs-server`. Useful where Node is already managed by the platform, and the
-  only channel that runs on arm64 (Apple Silicon, Graviton, a Pi), because the
-  standalone executables are built for x64 only.
+Then launch `./api-linux` (on windows, double click `api-win.exe` - no
+administrative privileges are needed) and answer the two prompts, unless the ENV
+vars are set:
 
-Both channels read the same environment variables and serve the same API, with
-two differences worth knowing before choosing the Node one:
+- Location of your `sas.exe` / `sas.sh` executable
+- Path to a filesystem location for Stored Programs and temporary files
 
-- **Pin the version.** An unpinned `npx @sasjs/server` re-resolves `latest` on
-  every run, so a restart becomes a silent upgrade. The examples above pin it.
-- **`.env` is read from the working directory.** `dotenv.config()` is relative to
-  where the process starts, so run it from the project directory you want the
-  server to own (that directory also gets the `./sasjs_root`). Under `npx` the
-  package itself lives in an evictable `~/.npm/_npx/<hash>` cache, so an `.env`
-  placed there would be lost - it belongs beside the command, not the code.
+## Deployment options
 
-The Node channel starts in desktop mode, which is the single-user mode; the
-`RUN_AS` check still refuses to run as root, so install it under the account that
-should own the SAS sessions rather than starting it with `sudo`.
 - **Embedded** - the server's pieces are also used inside other SASjs tooling,
   such as the VS Code extension, and the mock backend runs in the browser for
   front-end development without a server at all.

package/build/src/e2e/studio.spec.js

@@ -98,6 +98,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * the unit-test run deliberately excludes.
  */
 var path_1 = __importDefault(require("path"));
+var fs_1 = require("fs");
 var promises_1 = require("fs/promises");
 var mongoose_1 = __importDefault(require("mongoose"));
 var mongodb_memory_server_1 = require("mongodb-memory-server");
@@ -140,7 +141,11 @@ describe('Studio in a browser', function () {
                 case 2:
                     _a.sent();
                     _a.label = 3;
-                case 3: return [4 /*yield*/, (0, utils_1.fileExists)(path_1.default.join((0, utils_2.getWebBuildFolder)(), 'index.bundle.js'))];
+                case 3:
+                    // The screenshots folder is gitignored, so a fresh checkout has no such
+                    // directory and a failure screenshot would fail on the write itself.
+                    (0, fs_1.mkdirSync)(screenshotDir, { recursive: true });
+                    return [4 /*yield*/, (0, utils_1.fileExists)(path_1.default.join((0, utils_2.getWebBuildFolder)(), 'index.bundle.js'))];
                 case 4:
                     if (!(_a.sent())) {
                         throw new Error("No web build at ".concat((0, utils_2.getWebBuildFolder)(), ". Run `npm run build` in web/ before the browser test."));
@@ -185,7 +190,10 @@ describe('Studio in a browser', function () {
                     // An admin passes every route check, which keeps this test about the
                     // editor rather than about the permission model.
                     expect(dbUser.isAdmin).toBe(true);
-                    process.runTimes = [utils_2.RunTimeType.JS];
+                    // The fixture is a .sas program, and this suite never executes code for
+                    // real - the log case fulfils the execute request in the browser - so one
+                    // runtime, the one the fixture needs, keeps the editor from switching it.
+                    process.runTimes = [utils_2.RunTimeType.SAS];
                     process.nodeLoc = process.execPath;
                     return [4 /*yield*/, app];
                 case 13:
@@ -200,7 +208,15 @@ describe('Studio in a browser', function () {
                     return [4 /*yield*/, browser.newPage({ viewport: { width: 1280, height: 800 } })];
                 case 15:
                     page = _a.sent();
-                    page.on('pageerror', function (error) { return pageErrors.push(String(error)); });
+                    page.on('pageerror', function (error) {
+                        // A request the app aborts surfaces here as an unhandled rejection with
+                        // axios's "Canceled: Canceled". That is a request superseded by a newer one
+                        // - the editor re-syncing, a tab switching - not a fault in the tree, which
+                        // is what this collector exists to catch.
+                        if (String(error).includes('Canceled: Canceled'))
+                            return;
+                        pageErrors.push(String(error));
+                    });
                     page.on('request', function (request) {
                         var _a;
                         if (!request.url().includes('/SASjsApi/drive/fileTree'))
@@ -576,4 +592,83 @@ describe('Studio in a browser', function () {
             }
         });
     }); }, 60000);
+    it('lists the errors, warnings and notable notes of a SAS log, and hides the notes on request', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var log, _a, _b, _c, stored;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    log = [
+                        'NOTE: SAS (r) Proprietary Software 9.4 (TS1M9 MBCS3170)',
+                        '1    data want;',
+                        '2      x = age / 0;',
+                        '3    run;',
+                        'WARNING: Division by zero detected at line 3 column 11.',
+                        'NOTE: Variable y is uninitialized.',
+                        'ERROR Libref X is not assigned.',
+                        'NOTE 49-169: The meaning of an identifier after a quoted string may change.',
+                        'ERROR: File WORK.MISSING_DS.DATA does not exist.',
+                        ''
+                    ].join('\n');
+                    return [4 /*yield*/, page.route('**/SASjsApi/code/execute', function (route) {
+                            return route.fulfill({
+                                status: 200,
+                                contentType: 'text/plain',
+                                body: ['<html></html>', log, ''].join('SASJS_LOGS_SEPARATOR_163ee17b6ff24f028928972d80a26784')
+                            });
+                        })
+                        // The fixture program is a .sas file, so opening it selects the SAS runtime
+                        // and the log pane will render the parsed shape.
+                    ];
+                case 1:
+                    _d.sent();
+                    // The fixture program is a .sas file, so opening it selects the SAS runtime
+                    // and the log pane will render the parsed shape.
+                    return [4 /*yield*/, page.click('button:has-text("RUN")')];
+                case 2:
+                    // The fixture program is a .sas file, so opening it selects the SAS runtime
+                    // and the log pane will render the parsed shape.
+                    _d.sent();
+                    return [4 /*yield*/, page.waitForSelector('text=Errors (2)', { timeout: 30000 })];
+                case 3:
+                    _d.sent();
+                    _a = expect;
+                    return [4 /*yield*/, page.isVisible('text=Warnings (1)')];
+                case 4:
+                    _a.apply(void 0, [_d.sent()]).toBe(true);
+                    _b = expect;
+                    return [4 /*yield*/, page.isVisible('text=Notes (2)')];
+                case 5:
+                    _b.apply(void 0, [_d.sent()]).toBe(true);
+                    return [4 /*yield*/, page.screenshot({
+                            path: path_1.default.join(screenshotDir, '02-log-issues.png')
+                        })
+                        // The switch hides them without another run.
+                    ];
+                case 6:
+                    _d.sent();
+                    // The switch hides them without another run.
+                    return [4 /*yield*/, page.click('[aria-label="Hide notable notes"]')];
+                case 7:
+                    // The switch hides them without another run.
+                    _d.sent();
+                    return [4 /*yield*/, page.waitForSelector('text=Notes (2)', {
+                            state: 'detached',
+                            timeout: 30000
+                        })];
+                case 8:
+                    _d.sent();
+                    _c = expect;
+                    return [4 /*yield*/, page.isVisible('text=Errors (2)')];
+                case 9:
+                    _c.apply(void 0, [_d.sent()]).toBe(true);
+                    return [4 /*yield*/, page.evaluate(function () {
+                            return window.localStorage.getItem('studio-settings');
+                        })];
+                case 10:
+                    stored = _d.sent();
+                    expect(JSON.parse(stored)['log.notableNotes']).toBe(false);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 120000);
 });

package/build/src/utils/buildInfo.generated.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILD_INFO = void 0;
 // Generated by scripts/generateBuildInfo.ts. Do not edit by hand.
 exports.BUILD_INFO = {
-    version: "v3.6.2",
-    gitHash: "6141e36",
-    buildDate: "2026-10-30T14:54:32.248Z"
+    version: "v3.7.0",
+    gitHash: "d1cc0c9",
+    buildDate: "2026-11-01T21:13:10.033Z"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sasjs/server",
-  "version": "3.6.2",
+  "version": "3.7.0",
   "description": "NodeJS wrapper for calling the SAS binary executable",
   "license": "MIT",
   "repository": "https://github.com/sasjs/server",
@@ -35,7 +35,7 @@
     "express-session": "^1.19.0",
     "helmet": "^8.3.0",
     "http-headers-validation": "^0.0.2",
-    "joi": "^18.2.9",
+    "joi": "^18.3.1",
     "jose": "5.10.0",
     "jsonwebtoken": "^9.0.3",
     "ldapjs": "2.3.3",