@nordicsemiconductor/nrf-jlink-js 0.12.0 → 0.13.1

package/LICENSE

@@ -1,12 +1,14 @@
-LicenseID: LicenseRef-Nordic-4-Clause
+LicenseID:  LicenseRef-Nordic-4-Clause
 
 ExtractedText: <text>
 
-Copyright (c) 2025 Nordic Semiconductor ASA All rights reserved.
+Copyright (c) 2025 Nordic Semiconductor ASA
+All rights reserved.
 
-Use in source and binary forms, redistribution in binary form only, with or
-without modification, are permitted provided that the following conditions are
-met:
+
+Use in source and binary forms, redistribution in binary form only, with
+or without modification, are permitted provided that the following conditions
+are met:
 
 1. Redistributions in binary form, except as embedded into a Nordic
    Semiconductor ASA integrated circuit in a product or a software update for
@@ -33,4 +35,5 @@ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
 TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </text>
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+</text>

package/README.md

@@ -1,6 +1,7 @@
 # nrf-jlink-js
 
-`nrf-jlink-js` is a Node.js module to check and install the recommended JLink version used by some products of Nordic Semiconductor ASA.
+`nrf-jlink-js` is a Node.js module to check and install the recommended JLink
+version used by some products of Nordic Semiconductor ASA.
 
 ## Installation
 
@@ -11,9 +12,9 @@ npm install @nordicsemiconductor/nrf-jlink-js
 ## Usage
 
 ```js
-const { outdated, versionToBeInstalled } = await getVersionToInstall()
+const { status } = await getJLinkState();
 
-if (outdated) {
-    downloadAndInstallJlink(console.log)
+if (status === 'should be updated') {
+    downloadAndInstallJlink(console.log);
 }
 ```

package/dist/jlink.d.ts

@@ -1,3 +1,6 @@
 import type { OnUpdate } from './shared/update';
-export declare const downloadAndSaveJLink: (destinationDir: string, destinationFileName?: string, onUpdate?: OnUpdate) => Promise<string>;
+export declare const downloadAndSaveJLink: (destinationDir: string, destinationFileName?: string, onUpdate?: OnUpdate) => Promise<{
+    version: string;
+    fileName: string;
+}>;
 export declare const downloadAndInstallJLink: (onUpdate?: OnUpdate) => Promise<void>;

package/dist/jlink.js

@@ -4,20 +4,65 @@
  *
  * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
  */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.downloadAndInstallJLink = exports.downloadAndSaveJLink = void 0;
 var fetchIndex_1 = require("./operations/fetchIndex");
 var downloadJLink_1 = require("./operations/downloadJLink");
 var installJLink_1 = require("./operations/installJLink");
-var downloadAndSaveJLink = function (destinationDir, destinationFileName, onUpdate) {
-    return (0, fetchIndex_1.fetchIndex)().then(function (v) {
-        return (0, downloadJLink_1.downloadJLink)(v, onUpdate, destinationDir, destinationFileName);
+var downloadAndSaveJLink = function (destinationDir, destinationFileName, onUpdate) { return __awaiter(void 0, void 0, void 0, function () {
+    var index, fileName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, fetchIndex_1.fetchIndex)()];
+            case 1:
+                index = _a.sent();
+                return [4 /*yield*/, (0, downloadJLink_1.downloadJLink)(index, onUpdate, destinationDir, destinationFileName)];
+            case 2:
+                fileName = _a.sent();
+                return [2 /*return*/, { version: index.version, fileName: fileName }];
+        }
     });
-};
+}); };
 exports.downloadAndSaveJLink = downloadAndSaveJLink;
 var downloadAndInstallJLink = function (onUpdate) {
     return (0, fetchIndex_1.fetchIndex)()
-        .then(function (v) { return (0, downloadJLink_1.downloadJLink)(v, onUpdate); })
-        .then(function (v) { return (0, installJLink_1.installJLink)(v, onUpdate); });
+        .then(function (index) { return (0, downloadJLink_1.downloadJLink)(index, onUpdate); })
+        .then(function (fileName) { return (0, installJLink_1.installJLink)(fileName, onUpdate); });
 };
 exports.downloadAndInstallJLink = downloadAndInstallJLink;

package/dist/shared/jLinkVersion.js

@@ -4,6 +4,17 @@
  *
  * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
  */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -147,6 +158,11 @@ var isValidVersion = function (installedVersion, expectedVersion) {
     return semver_1.default.gte(convertToSemverVersion(installedVersion), convertToSemverVersion(expectedVersion));
 };
 exports.isValidVersion = isValidVersion;
+var getEnv = function () {
+    if (process.platform !== 'darwin')
+        return undefined;
+    return __assign(__assign({}, process.env), { PATH: "".concat(process.env.PATH, ":/usr/local/bin") });
+};
 var getInstalledJLinkVersion = function () { return __awaiter(void 0, void 0, void 0, function () {
     var env_1, scriptFile, output, versionRegExp, match, e_1;
     var _a;
@@ -158,7 +174,9 @@ var getInstalledJLinkVersion = function () { return __awaiter(void 0, void 0, vo
             case 1:
                 _b.trys.push([1, 3, 4, 5]);
                 scriptFile = __addDisposableResource(env_1, (0, fs_2.createTemporaryScriptFile)('Exit'), false);
-                return [4 /*yield*/, (0, util_1.promisify)(child_process_1.exec)("".concat(getJLinkExePath(), " -CommandFile ").concat(scriptFile.filePath)).catch(function (e) { return e; })];
+                return [4 /*yield*/, (0, util_1.promisify)(child_process_1.exec)("".concat(getJLinkExePath(), " -CommandFile ").concat(scriptFile.filePath), {
+                        env: getEnv()
+                    }).catch(function (e) { return e; })];
             case 2:
                 output = _b.sent();
                 versionRegExp = /^SEGGER J-Link Commander V([0-9a-z.]+) .*$/m;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nordicsemiconductor/nrf-jlink-js",
-    "version": "0.12.0",
+    "version": "0.13.1",
     "main": "dist",
     "types": "dist",
     "files": [
@@ -10,6 +10,7 @@
         "semver": "^7.7.2"
     },
     "scripts": {
+        "prepare": "npm run build",
         "build": "tsc",
         "upload-jlink": "ts-node scripts/upload-jlink.ts"
     },

package/LICENSE.2

@@ -1,38 +0,0 @@
-LicenseID:  LicenseRef-Nordic-4-Clause
-
-ExtractedText: <text>
-
-Copyright (c) 2025 Nordic Semiconductor ASA
-All rights reserved.
-
-
-Use in source and binary forms, redistribution in binary form only, with
-or without modification, are permitted provided that the following conditions
-are met:
-
-1. Redistributions in binary form, except as embedded into a Nordic
-   Semiconductor ASA integrated circuit in a product or a software update for
-   such product, must reproduce the above copyright notice, this list of
-   conditions and the following disclaimer in the documentation and/or other
-   materials provided with the distribution.
-
-2. Neither the name of Nordic Semiconductor ASA nor the names of its
-   contributors may be used to endorse or promote products derived from this
-   software without specific prior written permission.
-
-3. This software, with or without modification, must only be used with a Nordic
-   Semiconductor ASA integrated circuit.
-
-4. Any software provided in binary form under this license must not be reverse
-   engineered, decompiled, modified and/or disassembled.
-
-THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS OR
-IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
-TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.