@sasjs/cli 4.20.5 → 4.20.7

package/build/commands/web/internal/spec/updateScriptTag.spec.js

@@ -69,6 +69,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 var path_1 = __importDefault(require("path"));
 var utils_1 = require("@sasjs/utils");
+var test_1 = require("../../../../utils/test");
 var updateScriptTag_1 = require("../updateScriptTag");
 var utils_2 = require("../../../../utils");
 describe('updateScriptTag', function () {
@@ -77,7 +78,7 @@ describe('updateScriptTag', function () {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    destinationPath = path_1.default.join(__dirname, "cli-test-web-updateScriptTag-".concat((0, utils_1.generateTimestamp)()));
+                    destinationPath = path_1.default.join(__dirname, "cli-test-web-updateScriptTag-".concat((0, test_1.generateUniqueTimestamp)()));
                     return [4 /*yield*/, (0, utils_1.createFolder)(destinationPath)];
                 case 1:
                     _a.sent();

package/build/commands/web/internal/spec/updateStyleTag.spec.js

@@ -69,6 +69,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 var path_1 = __importDefault(require("path"));
 var utils_1 = require("@sasjs/utils");
+var test_1 = require("../../../../utils/test");
 var updateStyleTag_1 = require("../updateStyleTag");
 var utils_2 = require("../../../../utils");
 describe('updateStyleTag', function () {
@@ -77,7 +78,7 @@ describe('updateStyleTag', function () {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    destinationPath = path_1.default.join(__dirname, "cli-test-web-updateStyleTag-".concat((0, utils_1.generateTimestamp)()));
+                    destinationPath = path_1.default.join(__dirname, "cli-test-web-updateStyleTag-".concat((0, test_1.generateUniqueTimestamp)()));
                     return [4 /*yield*/, (0, utils_1.createFolder)(destinationPath)];
                 case 1:
                     _a.sent();

package/build/commands/web/spec/web.spec.js

@@ -121,7 +121,7 @@ describe('sasjs web', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = "cli-test-web-minimal-".concat((0, utils_1.generateTimestamp)());
+                    appName = "cli-test-web-minimal-".concat((0, test_1.generateUniqueTimestamp)());
                     return [4 /*yield*/, (0, test_1.createTestMinimalApp)(__dirname, appName)];
                 case 1:
                     _b.sent();

package/build/utils/auth.d.ts

@@ -1,5 +1,11 @@
 import { ServerType, Target } from '@sasjs/utils';
 import SASjs from '@sasjs/adapter/node';
+/**
+ * The URL a user visits to obtain an authorization code.
+ *
+ * SASjs Server serves its authorization code screen at /SASjsLogon - a real
+ * path on its single-page app. SAS Viya answers at its own /SASLogon endpoint.
+ */
 export declare const getAuthUrl: (serverType: ServerType, serverUrl: string, clientId: string) => string;
 export declare function getAuthCode(authUrl: string): Promise<string>;
 /**

package/build/utils/auth.js

@@ -44,9 +44,15 @@ exports.fetchLoggedInUser = fetchLoggedInUser;
 exports.getNewAccessToken = getNewAccessToken;
 var utils_1 = require("@sasjs/utils");
 var node_1 = require("@sasjs/adapter/node");
+/**
+ * The URL a user visits to obtain an authorization code.
+ *
+ * SASjs Server serves its authorization code screen at /SASjsLogon - a real
+ * path on its single-page app. SAS Viya answers at its own /SASLogon endpoint.
+ */
 var getAuthUrl = function (serverType, serverUrl, clientId) {
     return serverType === utils_1.ServerType.Sasjs
-        ? "".concat(serverUrl, "/#/SASjsLogon?client_id=").concat(clientId, "&response_type=code")
+        ? "".concat(serverUrl, "/SASjsLogon?client_id=").concat(clientId, "&response_type=code")
         : "".concat(serverUrl, "/SASLogon/oauth/authorize?client_id=").concat(clientId, "&response_type=code");
 };
 exports.getAuthUrl = getAuthUrl;

package/build/utils/shell.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The shell operations the CLI needs, on Node's own APIs.
+ *
+ * The CLI used shelljs for five things: run a command, copy a folder, remove a
+ * file or folder, list entries matching a pattern, and find an executable. Its
+ * current release pulls `fast-glob`, which pulls `micromatch`, which pulls
+ * `braces` - and `braces` has an unpatched stack-overflow advisory with no
+ * fixed release to move to. Nothing here needs a glob engine: the patterns are
+ * `*main`, `*master` and `*-main`, matched against one directory.
+ *
+ * The shapes match what the call sites already expect, so the behaviour they
+ * rely on - a command's stdout/stderr/exit code, and `cp -r <dir>/. <dest>`
+ * copying a directory's contents rather than the directory - is unchanged.
+ */
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+/**
+ * Runs a command through the platform shell.
+ *
+ * `silent` decides whether the command's output also reaches this process's
+ * streams, which is how shelljs' option of the same name behaved.
+ */
+export declare const exec: (command: string, options?: {
+    silent?: boolean;
+}) => ShellResult;
+/**
+ * Copies the contents of a folder into another folder, matching
+ * `cp -r <source>/. <destination>`.
+ *
+ * @param source - the folder to copy from, addressed as `<dir>/.` so that its
+ * contents land directly in the destination.
+ * @param destination - the folder to copy into.
+ */
+export declare const cp: (source: string, destination: string) => Promise<void>;
+/**
+ * Removes files and folders. `recursive` matches `rm -rf`, and without it the
+ * call matches `rm -f`. A target containing `*` is expanded first, because
+ * shelljs expanded it and the call sites rely on that.
+ */
+export declare const rm: (targets: string[], recursive?: boolean) => void;
+/**
+ * The entries of one directory whose name matches a pattern.
+ *
+ * Only `*` is supported, which is all the CLI's patterns use, and the result is
+ * addressed the same way the caller's pattern was - `./*main` answers with
+ * `./sasjs-react-seed-app-main`.
+ */
+export declare const ls: (pattern: string) => string[];
+/**
+ * The path of an executable on this machine, or null when it is not there.
+ *
+ * POSIX `which`, because that is the only question asked of it: the one caller
+ * wants to know whether `wget` is available, and it only asks on Linux. Answer
+ * `where` when something needs to ask on Windows - a branch for it now would be
+ * unreachable, since the caller has already ruled Windows out.
+ */
+export declare const which: (command: string) => string | null;

package/build/utils/shell.js

@@ -0,0 +1,155 @@
+"use strict";
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.which = exports.ls = exports.rm = exports.cp = exports.exec = void 0;
+var child_process_1 = require("child_process");
+var fs_1 = __importDefault(require("fs"));
+var path_1 = __importDefault(require("path"));
+var utils_1 = require("@sasjs/utils");
+/**
+ * Runs a command through the platform shell.
+ *
+ * `silent` decides whether the command's output also reaches this process's
+ * streams, which is how shelljs' option of the same name behaved.
+ */
+var exec = function (command, options) {
+    var _a, _b, _c;
+    if (options === void 0) { options = {}; }
+    var result = (0, child_process_1.spawnSync)(command, {
+        shell: true,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        // shelljs allowed 20MB of output; spawnSync's 1MB default kills a chatty
+        // command mid-run, and a deploy script can easily be chatty.
+        maxBuffer: 20 * 1024 * 1024
+    });
+    var stdout = (_a = result.stdout) !== null && _a !== void 0 ? _a : '';
+    var stderr = (_b = result.stderr) !== null && _b !== void 0 ? _b : '';
+    if (!options.silent) {
+        if (stdout)
+            process.stdout.write(stdout);
+        if (stderr)
+            process.stderr.write(stderr);
+    }
+    // A killed command leaves status null and reports why on `error` - an
+    // exceeded buffer is ENOBUFS. Returning `status ?? 0` for that would report a
+    // command that never finished as a success.
+    if (result.error) {
+        return {
+            stdout: stdout,
+            stderr: [stderr, result.error.message].filter(Boolean).join('\n'),
+            code: 1
+        };
+    }
+    return { stdout: stdout, stderr: stderr, code: (_c = result.status) !== null && _c !== void 0 ? _c : 0 };
+};
+exports.exec = exec;
+/**
+ * Copies the contents of a folder into another folder, matching
+ * `cp -r <source>/. <destination>`.
+ *
+ * @param source - the folder to copy from, addressed as `<dir>/.` so that its
+ * contents land directly in the destination.
+ * @param destination - the folder to copy into.
+ */
+var cp = function (source, destination) {
+    return (0, utils_1.copy)(source, destination);
+};
+exports.cp = cp;
+/**
+ * Removes files and folders. `recursive` matches `rm -rf`, and without it the
+ * call matches `rm -f`. A target containing `*` is expanded first, because
+ * shelljs expanded it and the call sites rely on that.
+ */
+var rm = function (targets, recursive) {
+    var e_1, _a, e_2, _b;
+    if (recursive === void 0) { recursive = false; }
+    try {
+        for (var targets_1 = __values(targets), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
+            var target = targets_1_1.value;
+            var resolved = target.includes('*') ? (0, exports.ls)(target) : [target];
+            try {
+                for (var resolved_1 = (e_2 = void 0, __values(resolved)), resolved_1_1 = resolved_1.next(); !resolved_1_1.done; resolved_1_1 = resolved_1.next()) {
+                    var entry = resolved_1_1.value;
+                    fs_1.default.rmSync(entry, { recursive: recursive, force: true });
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (resolved_1_1 && !resolved_1_1.done && (_b = resolved_1.return)) _b.call(resolved_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (targets_1_1 && !targets_1_1.done && (_a = targets_1.return)) _a.call(targets_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+};
+exports.rm = rm;
+/**
+ * The entries of one directory whose name matches a pattern.
+ *
+ * Only `*` is supported, which is all the CLI's patterns use, and the result is
+ * addressed the same way the caller's pattern was - `./*main` answers with
+ * `./sasjs-react-seed-app-main`.
+ */
+var ls = function (pattern) {
+    var directory = path_1.default.dirname(pattern);
+    var matcher = new RegExp('^' +
+        path_1.default
+            .basename(pattern)
+            .split('*')
+            .map(function (part) { return part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); })
+            .join('.*') +
+        '$');
+    var entries;
+    try {
+        entries = fs_1.default.readdirSync(directory);
+    }
+    catch (_a) {
+        return [];
+    }
+    var matches = entries.filter(function (entry) { return matcher.test(entry); }).sort();
+    // `path.join` would drop the `./`, and the callers pass the result straight
+    // to a shell-style path, so the prefix is rebuilt rather than normalised.
+    return matches.map(function (entry) {
+        return pattern.startsWith('./') ? "./".concat(entry) : path_1.default.join(directory, entry);
+    });
+};
+exports.ls = ls;
+/**
+ * The path of an executable on this machine, or null when it is not there.
+ *
+ * POSIX `which`, because that is the only question asked of it: the one caller
+ * wants to know whether `wget` is available, and it only asks on Linux. Answer
+ * `where` when something needs to ask on Windows - a branch for it now would be
+ * unreachable, since the caller has already ruled Windows out.
+ */
+var which = function (command) {
+    var _a;
+    var result = (0, child_process_1.spawnSync)('which', [command], { encoding: 'utf8' });
+    if (result.status !== 0)
+        return null;
+    var first = ((_a = result.stdout) !== null && _a !== void 0 ? _a : '').split('\n')[0].trim();
+    return first || null;
+};
+exports.which = which;

package/build/utils/spec/auth.spec.js

@@ -86,6 +86,19 @@ var target = new utils_1.Target({
     appLoc: '/Public/test',
     contextName: 'test context'
 });
+describe('getAuthUrl', function () {
+    it('should address the SASjs Server authorization screen as a path', function () {
+        expect((0, auth_1.getAuthUrl)(utils_1.ServerType.Sasjs, 'https://server.example.com', 'my-client')).toBe('https://server.example.com/SASjsLogon?client_id=my-client&response_type=code');
+    });
+    it('should build the Viya authorize URL for a SAS Viya server', function () {
+        expect((0, auth_1.getAuthUrl)(utils_1.ServerType.SasViya, 'https://viya.example.com', 'my-client')).toBe('https://viya.example.com/SASLogon/oauth/authorize?client_id=my-client&response_type=code');
+    });
+    it('should keep the route out of the fragment', function () {
+        // The screen used to live at /#/SASjsLogon. A fragment is not sent to the
+        // server, so the path is what makes a deep link work.
+        expect((0, auth_1.getAuthUrl)(utils_1.ServerType.Sasjs, 'https://server.example.com', 'my-client')).not.toContain('#');
+    });
+});
 describe('fetchLoggedInUser', function () {
     afterEach(function () {
         jest.clearAllMocks();

package/build/utils/spec/config.spec.js

@@ -456,7 +456,7 @@ describe('getAuthConfig - opaque refresh tokens', function () {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    projectDir = path_1.default.join(process.env.TEMP || process.env.TMP || '/tmp', "sasjs-cli-test-".concat((0, utils_1.generateTimestamp)()));
+                    projectDir = path_1.default.join(process.env.TEMP || process.env.TMP || '/tmp', "sasjs-cli-test-".concat((0, test_1.generateUniqueTimestamp)()));
                     process.projectDir = projectDir;
                     return [4 /*yield*/, (0, setConstants_1.setConstants)()];
                 case 1:
@@ -752,7 +752,7 @@ describe('saveToGlobalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-config-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-config-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToGlobalConfig)(target, true)];
                 case 1:
@@ -776,7 +776,7 @@ describe('saveToGlobalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-config-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-config-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToGlobalConfig)(target, false)];
                 case 1:
@@ -814,7 +814,7 @@ describe('removeFromGlobalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-config-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-config-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToGlobalConfig)(target, true)];
                 case 1:
@@ -842,8 +842,8 @@ describe('removeFromGlobalConfig', function () {
         return __generator(this, function (_d) {
             switch (_d.label) {
                 case 0:
-                    appName1 = 'cli-tests-config-1-' + (0, utils_1.generateTimestamp)();
-                    appName2 = 'cli-tests-config-2-' + (0, utils_1.generateTimestamp)();
+                    appName1 = 'cli-tests-config-1-' + (0, test_1.generateUniqueTimestamp)();
+                    appName2 = 'cli-tests-config-2-' + (0, test_1.generateUniqueTimestamp)();
                     target1 = (0, test_1.generateTestTarget)(appName1, "/Public/app/cli-tests/".concat(appName1));
                     target2 = (0, test_1.generateTestTarget)(appName2, "/Public/app/cli-tests/".concat(appName2));
                     return [4 /*yield*/, (0, config_1.saveToGlobalConfig)(target1, true)];
@@ -880,7 +880,7 @@ describe('saveToLocalConfig', function () {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    appName = "cli-tests-config-".concat((0, utils_1.generateTimestamp)());
+                    appName = "cli-tests-config-".concat((0, test_1.generateUniqueTimestamp)());
                     return [4 /*yield*/, (0, test_1.createTestMinimalApp)(__dirname, appName)];
                 case 1:
                     _a.sent();
@@ -904,7 +904,7 @@ describe('saveToLocalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-cb-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-cb-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToLocalConfig)(target, true)];
                 case 1:
@@ -928,7 +928,7 @@ describe('saveToLocalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-cb-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-cb-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToLocalConfig)(target, false)];
                 case 1:
@@ -953,7 +953,7 @@ describe('removeFromLocalConfig', function () {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    appName = "cli-tests-config-".concat((0, utils_1.generateTimestamp)());
+                    appName = "cli-tests-config-".concat((0, test_1.generateUniqueTimestamp)());
                     return [4 /*yield*/, (0, test_1.createTestMinimalApp)(__dirname, appName)];
                 case 1:
                     _a.sent();
@@ -977,7 +977,7 @@ describe('removeFromLocalConfig', function () {
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    appName = 'cli-tests-config-' + (0, utils_1.generateTimestamp)();
+                    appName = 'cli-tests-config-' + (0, test_1.generateUniqueTimestamp)();
                     target = (0, test_1.generateTestTarget)(appName, "/Public/app/cli-tests/".concat(appName));
                     return [4 /*yield*/, (0, config_1.saveToLocalConfig)(target, true)];
                 case 1:
@@ -1005,8 +1005,8 @@ describe('removeFromLocalConfig', function () {
         return __generator(this, function (_d) {
             switch (_d.label) {
                 case 0:
-                    appName1 = 'cli-tests-config-1-' + (0, utils_1.generateTimestamp)();
-                    appName2 = 'cli-tests-config-2-' + (0, utils_1.generateTimestamp)();
+                    appName1 = 'cli-tests-config-1-' + (0, test_1.generateUniqueTimestamp)();
+                    appName2 = 'cli-tests-config-2-' + (0, test_1.generateUniqueTimestamp)();
                     target1 = (0, test_1.generateTestTarget)(appName1, "/Public/app/cli-tests/".concat(appName1));
                     target2 = (0, test_1.generateTestTarget)(appName2, "/Public/app/cli-tests/".concat(appName2));
                     return [4 /*yield*/, (0, config_1.saveToLocalConfig)(target1, true)];

package/build/utils/spec/downloadFile.spec.js

@@ -10,21 +10,48 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-var shelljs_1 = __importDefault(require("shelljs"));
+var shell = __importStar(require("../shell"));
 var utils_1 = require("@sasjs/utils");
 var utils_2 = require("../utils");
-jest.mock('shelljs', function () { return ({
-    exec: jest.fn(function () { return ({ stdout: '', stderr: '', code: 0 }); }),
-    which: jest.fn()
-}); });
+jest.mock('../shell', function () { return (__assign(__assign({}, jest.requireActual('../shell')), { exec: jest.fn(function () { return ({ stdout: '', stderr: '', code: 0 }); }), which: jest.fn() })); });
 jest.mock('@sasjs/utils', function () { return (__assign(__assign({}, jest.requireActual('@sasjs/utils')), { isLinux: jest.fn(), isWindows: jest.fn() })); });
 describe('downloadFile', function () {
-    var exec = shelljs_1.default.exec;
-    var which = shelljs_1.default.which;
+    var exec = shell.exec;
+    var which = shell.which;
     var linux = utils_1.isLinux;
     var windows = utils_1.isWindows;
     beforeEach(function () {

package/build/utils/spec/file.spec.js

@@ -41,9 +41,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 var path_1 = __importDefault(require("path"));
 var utils_1 = require("@sasjs/utils");
+var test_1 = require("../test");
 describe('file utility', function () {
     describe('createFile', function () {
-        var filename = "test-create-file-".concat((0, utils_1.generateTimestamp)(), ".txt");
+        var filename = "test-create-file-".concat((0, test_1.generateUniqueTimestamp)(), ".txt");
         it('should create a file', function () { return __awaiter(void 0, void 0, void 0, function () {
             var filePath, content;
             return __generator(this, function (_a) {

package/build/utils/spec/shell.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/spec/shell.spec.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var fs_1 = __importDefault(require("fs"));
+var os_1 = __importDefault(require("os"));
+var path_1 = __importDefault(require("path"));
+var shell_1 = require("../shell");
+/**
+ * The shell wrapper, directly.
+ *
+ * Every other suite replaces this module with a mock, so nothing exercised it -
+ * which is how the maxBuffer mapping shipped reporting a killed command as a
+ * success. These cover the behaviours the call sites rely on: a command's
+ * stdout/stderr/exit code, `ls` matching a suffix pattern, `rm` expanding one,
+ * and `cp` copying a directory's contents rather than the directory.
+ */
+describe('shell', function () {
+    var root;
+    beforeEach(function () {
+        root = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'sasjs-shell-spec-'));
+    });
+    afterEach(function () {
+        fs_1.default.rmSync(root, { recursive: true, force: true });
+    });
+    describe('exec', function () {
+        it('should answer with stdout and a zero code for a command that succeeds', function () {
+            var result = (0, shell_1.exec)("node -e \"process.stdout.write('hello')\"", {
+                silent: true
+            });
+            expect(result.stdout).toEqual('hello');
+            expect(result.stderr).toEqual('');
+            expect(result.code).toEqual(0);
+        });
+        it('should answer with the exit code and stderr for a command that fails', function () {
+            var result = (0, shell_1.exec)("node -e \"process.stderr.write('boom'); process.exit(3)\"", { silent: true });
+            expect(result.code).toEqual(3);
+            expect(result.stderr).toContain('boom');
+        });
+        it('should report a command killed by the output ceiling as a failure', function () {
+            // A command that exceeds maxBuffer is killed, and spawnSync reports that
+            // with status null and the reason on `error`. Mapping `status ?? 0` would
+            // call it a success, which is what a chatty deploy script would hit.
+            var result = (0, shell_1.exec)("node -e \"process.stdout.write('x'.repeat(25 * 1024 * 1024))\"", { silent: true });
+            expect(result.code).not.toEqual(0);
+            expect(result.stderr).not.toEqual('');
+        });
+        it('should keep a command that is merely chatty', function () {
+            // 3MB is over spawnSync's 1MB default and under the ceiling this module
+            // sets, so the command must finish rather than be killed.
+            var result = (0, shell_1.exec)("node -e \"process.stdout.write('x'.repeat(3 * 1024 * 1024))\"", { silent: true });
+            expect(result.code).toEqual(0);
+            expect(result.stdout.length).toEqual(3 * 1024 * 1024);
+        });
+    });
+    describe('ls', function () {
+        beforeEach(function () {
+            fs_1.default.mkdirSync(path_1.default.join(root, 'sasjs-react-seed-app-main'));
+            fs_1.default.mkdirSync(path_1.default.join(root, 'docs-main'));
+            fs_1.default.mkdirSync(path_1.default.join(root, 'unrelated'));
+            fs_1.default.writeFileSync(path_1.default.join(root, 'main.zip'), '');
+        });
+        it('should match entries by a suffix pattern', function () {
+            expect((0, shell_1.ls)(path_1.default.join(root, '*main')).sort()).toEqual([
+                path_1.default.join(root, 'docs-main'),
+                path_1.default.join(root, 'sasjs-react-seed-app-main')
+            ]);
+        });
+        it('should match a pattern that narrows the suffix', function () {
+            expect((0, shell_1.ls)(path_1.default.join(root, '*-main'))).toEqual([
+                path_1.default.join(root, 'docs-main'),
+                path_1.default.join(root, 'sasjs-react-seed-app-main')
+            ]);
+        });
+        it('should keep the ./ prefix the caller passed', function () {
+            // createApp passes the result straight to a shell-style path, so the
+            // prefix survives rather than being normalised away. The pattern is
+            // relative, so it resolves against the working directory.
+            var cwd = process.cwd();
+            try {
+                process.chdir(root);
+                var matches = (0, shell_1.ls)('./*main');
+                expect(matches.sort()).toEqual([
+                    './docs-main',
+                    './sasjs-react-seed-app-main'
+                ]);
+            }
+            finally {
+                process.chdir(cwd);
+            }
+        });
+        it('should answer with nothing when the directory does not exist', function () {
+            expect((0, shell_1.ls)(path_1.default.join(root, 'no-such-dir', '*main'))).toEqual([]);
+        });
+        it('should answer with nothing when nothing matches', function () {
+            expect((0, shell_1.ls)(path_1.default.join(root, '*nothing-like-this'))).toEqual([]);
+        });
+    });
+    describe('rm', function () {
+        it('should expand a pattern before removing', function () {
+            fs_1.default.mkdirSync(path_1.default.join(root, 'sasjs-react-seed-app-main'));
+            fs_1.default.mkdirSync(path_1.default.join(root, 'docs-main'));
+            fs_1.default.mkdirSync(path_1.default.join(root, 'keep-me'));
+            (0, shell_1.rm)([path_1.default.join(root, '*main')], true);
+            expect(fs_1.default.existsSync(path_1.default.join(root, 'sasjs-react-seed-app-main'))).toBe(false);
+            expect(fs_1.default.existsSync(path_1.default.join(root, 'docs-main'))).toBe(false);
+            expect(fs_1.default.existsSync(path_1.default.join(root, 'keep-me'))).toBe(true);
+        });
+        it('should remove a directory and its contents when recursive', function () {
+            var target = path_1.default.join(root, 'nested');
+            fs_1.default.mkdirSync(path_1.default.join(target, 'deep'), { recursive: true });
+            fs_1.default.writeFileSync(path_1.default.join(target, 'deep', 'file.txt'), 'x');
+            (0, shell_1.rm)([target], true);
+            expect(fs_1.default.existsSync(target)).toBe(false);
+        });
+        it('should remove a single file', function () {
+            var file = path_1.default.join(root, 'main.zip');
+            fs_1.default.writeFileSync(file, '');
+            (0, shell_1.rm)([file]);
+            expect(fs_1.default.existsSync(file)).toBe(false);
+        });
+        it('should not throw for something that is not there', function () {
+            expect(function () { return (0, shell_1.rm)([path_1.default.join(root, 'missing')], true); }).not.toThrow();
+        });
+    });
+    describe('cp', function () {
+        it("should copy a directory's contents into the destination", function () {
+            var source = path_1.default.join(root, 'sasjs-react-seed-app-main');
+            fs_1.default.mkdirSync(path_1.default.join(source, 'nested'), { recursive: true });
+            fs_1.default.writeFileSync(path_1.default.join(source, 'package.json'), '{}');
+            fs_1.default.writeFileSync(path_1.default.join(source, 'nested', 'file.txt'), 'x');
+            var destination = path_1.default.join(root, 'my-new-app');
+            fs_1.default.mkdirSync(destination);
+            return (0, shell_1.cp)("".concat(source, "/."), destination).then(function () {
+                // The contents land in the destination, not a folder named after the
+                // source - the difference between `cp -r <dir>/. <dest>` and
+                // `cp -r <dir> <dest>`, which the create flow depends on.
+                expect(fs_1.default.existsSync(path_1.default.join(destination, 'package.json'))).toBe(true);
+                expect(fs_1.default.existsSync(path_1.default.join(destination, 'nested', 'file.txt'))).toBe(true);
+                expect(fs_1.default.existsSync(path_1.default.join(destination, 'sasjs-react-seed-app-main'))).toBe(false);
+            });
+        });
+    });
+    // `which` answers the POSIX question its one caller asks, and that caller
+    // only asks on Linux, so the assertions are Linux-only.
+    var describePosix = process.platform === 'win32' ? describe.skip : describe;
+    describePosix('which', function () {
+        it('should answer with the path of an executable that is there', function () {
+            expect((0, shell_1.which)('sh')).toMatch(/sh$/);
+        });
+        it('should answer with null for one that is not', function () {
+            expect((0, shell_1.which)('definitely-not-a-real-executable-xyz')).toBeNull();
+        });
+    });
+});