@nordicsemiconductor/nrf-jlink-js 0.10.0 → 0.12.0

package/LICENSE

@@ -1,11 +1,12 @@
-Copyright (c) 2025 Nordic Semiconductor ASA
-All rights reserved.
+LicenseID: LicenseRef-Nordic-4-Clause
 
-SPDX-License-Identifier: Nordic-4-Clause
+ExtractedText: <text>
 
-Use in source and binary forms, redistribution in binary form only, with
-or without modification, are permitted provided that the following conditions
-are met:
+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
@@ -32,4 +33,4 @@ 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.
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </text>

package/LICENSE.2

@@ -0,0 +1,38 @@
+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.

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-import { downloadAndInstallJLink, getVersionToInstall, downloadAndSaveJLink, installJLink, Update as JLinkUpdate } from './jlink';
-export { downloadAndInstallJLink, getVersionToInstall, downloadAndSaveJLink, installJLink, JLinkUpdate, };
+export type { Update as JLinkUpdate } from './shared/update';
+export { downloadAndInstallJLink, downloadAndSaveJLink } from './jlink';
+export { getJLinkState, type JLinkState } from './operations/getJLinkState';
+export { installJLink } from './operations/installJLink';

package/dist/index.js

@@ -1,8 +1,15 @@
 "use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installJLink = exports.downloadAndSaveJLink = exports.getVersionToInstall = exports.downloadAndInstallJLink = void 0;
+exports.installJLink = exports.getJLinkState = exports.downloadAndSaveJLink = exports.downloadAndInstallJLink = void 0;
 var jlink_1 = require("./jlink");
 Object.defineProperty(exports, "downloadAndInstallJLink", { enumerable: true, get: function () { return jlink_1.downloadAndInstallJLink; } });
-Object.defineProperty(exports, "getVersionToInstall", { enumerable: true, get: function () { return jlink_1.getVersionToInstall; } });
 Object.defineProperty(exports, "downloadAndSaveJLink", { enumerable: true, get: function () { return jlink_1.downloadAndSaveJLink; } });
-Object.defineProperty(exports, "installJLink", { enumerable: true, get: function () { return jlink_1.installJLink; } });
+var getJLinkState_1 = require("./operations/getJLinkState");
+Object.defineProperty(exports, "getJLinkState", { enumerable: true, get: function () { return getJLinkState_1.getJLinkState; } });
+var installJLink_1 = require("./operations/installJLink");
+Object.defineProperty(exports, "installJLink", { enumerable: true, get: function () { return installJLink_1.installJLink; } });

package/dist/jlink.d.ts

@@ -1,18 +1,3 @@
-export interface Update {
-    step: 'install' | 'download';
-    percentage: number;
-}
-export declare const installJLink: (installerPath: string, onUpdate?: (update: Update) => void) => Promise<void>;
-interface JLinkState {
-    outdated: boolean;
-    installed: boolean;
-    versionToBeInstalled?: string;
-    installedVersion?: string;
-}
-export declare const getVersionToInstall: ({ fallbackVersion, checkOnline, }?: {
-    fallbackVersion?: string;
-    checkOnline?: boolean;
-}) => Promise<JLinkState>;
-export declare const downloadAndSaveJLink: (destinationDir: string, destinationFileName?: string, onUpdate?: (update: Update) => void) => Promise<string>;
-export declare const downloadAndInstallJLink: (onUpdate?: (update: Update) => void) => Promise<void>;
-export {};
+import type { OnUpdate } from './shared/update';
+export declare const downloadAndSaveJLink: (destinationDir: string, destinationFileName?: string, onUpdate?: OnUpdate) => Promise<string>;
+export declare const downloadAndInstallJLink: (onUpdate?: OnUpdate) => Promise<void>;

package/dist/jlink.js

@@ -1,274 +1,23 @@
 "use strict";
-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 };
-    }
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadAndInstallJLink = exports.downloadAndSaveJLink = exports.getVersionToInstall = exports.installJLink = void 0;
-var child_process_1 = require("child_process");
-var os_1 = __importDefault(require("os"));
-var path_1 = __importDefault(require("path"));
-var semver_1 = __importDefault(require("semver"));
-var fs_1 = require("fs");
-var common_1 = require("./common");
-var util_1 = require("util");
-function winRegQuery(key) {
-    var _a;
-    if (process.platform !== 'win32') {
-        throw new Error('Unsupported platform');
-    }
-    var reg = path_1.default.resolve((_a = process.env.SystemRoot) !== null && _a !== void 0 ? _a : 'C:\\Windows', 'System32', 'reg.exe');
-    if (!(0, fs_1.existsSync)(reg)) {
-        reg = 'reg.exe';
-    }
-    return (0, child_process_1.execSync)("".concat(reg, " query ").concat(key)).toString().trim();
-}
-var getJLinkExePath = function () {
-    var _a;
-    switch (os_1.default.platform()) {
-        case 'win32':
-            var cwd = winRegQuery('HKEY_CURRENT_USER\\Software\\SEGGER\\J-Link /v InstallPath');
-            if (!cwd) {
-                cwd = winRegQuery('HKEY_LOCAL_MACHINE\\Software\\SEGGER\\J-Link /v InstallPath');
-            }
-            cwd = ((_a = /InstallPath\s+\w+\s+(.*)/.exec(cwd)) !== null && _a !== void 0 ? _a : [])[1];
-            if (!cwd) {
-                throw new Error('JLink not installed');
-            }
-            return "\"".concat(path_1.default.join(cwd, 'JLink.exe'), "\"");
-        case 'linux':
-        case 'darwin':
-            return 'JLinkExe';
-        default:
-            throw new Error('Invalid platform');
-    }
-};
-var getInstalledJLinkVersion = function () { return __awaiter(void 0, void 0, void 0, function () {
-    var output, versionRegExp, match;
-    var _a;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0: return [4 /*yield*/, (0, util_1.promisify)(child_process_1.exec)("".concat(getJLinkExePath(), " -CommandFile foo")).catch(function (e) { return e; })];
-            case 1:
-                output = _b.sent();
-                versionRegExp = /^SEGGER J-Link Commander V([0-9a-z.]+) .*$/m;
-                match = (_a = output.stdout.match(versionRegExp)) === null || _a === void 0 ? void 0 : _a[1];
-                if (!match) {
-                    throw new Error("Couldn't get jlink version.");
-                }
-                return [2 /*return*/, "v".concat(match)];
-        }
-    });
-}); };
-var downloadJLink = function (_a, onUpdate_1) {
-    var args_1 = [];
-    for (var _i = 2; _i < arguments.length; _i++) {
-        args_1[_i - 2] = arguments[_i];
-    }
-    return __awaiter(void 0, __spreadArray([_a, onUpdate_1], args_1, true), void 0, function (_b, onUpdate, destinationDir, destinationFileName) {
-        var platform, arch, url, response, hasContentLength, contentLength, reader, chunks, receivedLength, _c, done, value, chunksAll, position;
-        var _d, _e;
-        var jlinkUrls = _b.jlinkUrls;
-        if (destinationDir === void 0) { destinationDir = os_1.default.tmpdir(); }
-        return __generator(this, function (_f) {
-            switch (_f.label) {
-                case 0:
-                    platform = os_1.default.platform();
-                    arch = os_1.default.arch();
-                    // @ts-expect-error It is quite literally checked right before
-                    if (!(platform in jlinkUrls) || !(arch in jlinkUrls[platform])) {
-                        throw new Error("JLink not available for ".concat(platform, "/").concat(arch));
-                    }
-                    url = (_d = jlinkUrls[platform]) === null || _d === void 0 ? void 0 : _d[arch];
-                    if (!url) {
-                        throw new Error("JLink not available for ".concat(platform, "/").concat(arch));
-                    }
-                    return [4 /*yield*/, fetch(url, {
-                            headers: {
-                                Range: 'bytes=0-',
-                            },
-                        })];
-                case 1:
-                    response = _f.sent();
-                    if (!response.ok) {
-                        throw new Error("Unable to download ".concat(url, ". Got status code ").concat(status, "."));
-                    }
-                    hasContentLength = response.headers.has('content-length');
-                    contentLength = hasContentLength
-                        ? Number(response.headers.get('content-length'))
-                        : 1;
-                    reader = (_e = response.body) === null || _e === void 0 ? void 0 : _e.getReader();
-                    chunks = [];
-                    receivedLength = 0;
-                    _f.label = 2;
-                case 2:
-                    if (!reader) return [3 /*break*/, 4];
-                    return [4 /*yield*/, reader.read()];
-                case 3:
-                    _c = _f.sent(), done = _c.done, value = _c.value;
-                    if (done) {
-                        return [3 /*break*/, 4];
-                    }
-                    chunks.push(value);
-                    receivedLength += value.length;
-                    onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
-                        step: 'download',
-                        percentage: hasContentLength
-                            ? Number(((receivedLength / contentLength) * 100).toFixed(2))
-                            : 0,
-                    });
-                    return [3 /*break*/, 2];
-                case 4:
-                    chunksAll = new Uint8Array(receivedLength);
-                    position = 0;
-                    chunks.forEach(function (chunk) {
-                        chunksAll.set(chunk, position);
-                        position += chunk.length;
-                    });
-                    return [4 /*yield*/, (0, common_1.saveToFile)(path_1.default.join(destinationDir, destinationFileName || path_1.default.basename(url)), Buffer.from(chunksAll))];
-                case 5: return [2 /*return*/, _f.sent()];
-            }
-        });
-    });
-};
-var installJLink = function (installerPath, onUpdate) {
-    var command;
-    var args;
-    switch (os_1.default.platform()) {
-        case 'darwin':
-            command = 'open';
-            args = ['-W', installerPath];
-            break;
-        case 'linux':
-            command = 'pkexec';
-            args = ['sh', '-c', "dpkg -i \"".concat(installerPath, "\"")];
-            break;
-        case 'win32':
-            command = installerPath;
-            break;
-        default:
-            throw new Error('Invalid platform');
-    }
-    onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({ step: 'install', percentage: 0 });
-    return new Promise(function (resolve, reject) {
-        (0, child_process_1.execFile)(command, args, function (error, _, stderr) {
-            if (error) {
-                return reject(error);
-            }
-            if (stderr) {
-                return reject(stderr);
-            }
-            onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({ step: 'install', percentage: 100 });
-            return resolve();
-        });
-    });
-};
-exports.installJLink = installJLink;
-var convertToSemverVersion = function (version) {
-    var _a;
-    var _b = (_a = version.match(/V?(\d+\.\d+)(.)?/)) !== null && _a !== void 0 ? _a : [], majorMinor = _b[1], patchLetter = _b[2];
-    var patch = patchLetter
-        ? patchLetter.charCodeAt(0) - 'a'.charCodeAt(0) + 1
-        : 0;
-    return "".concat(majorMinor, ".").concat(patch);
-};
-var isValidVersion = function (installedVersion, expectedVersion) {
-    return semver_1.default.gte(convertToSemverVersion(installedVersion), convertToSemverVersion(expectedVersion));
-};
-var getVersionToInstall = function () {
-    var args_1 = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args_1[_i] = arguments[_i];
-    }
-    return __awaiter(void 0, __spreadArray([], args_1, true), void 0, function (_a) {
-        var onlineRecommendedVersion, _b, versionToBeInstalled, installedVersion, installed, outdated;
-        var _c;
-        var _d = _a === void 0 ? {} : _a, fallbackVersion = _d.fallbackVersion, _e = _d.checkOnline, checkOnline = _e === void 0 ? true : _e;
-        return __generator(this, function (_f) {
-            switch (_f.label) {
-                case 0:
-                    if (!checkOnline) return [3 /*break*/, 2];
-                    return [4 /*yield*/, (0, common_1.fetchIndex)().catch(function () { return undefined; })];
-                case 1:
-                    _b = (_c = (_f.sent())) === null || _c === void 0 ? void 0 : _c.version;
-                    return [3 /*break*/, 3];
-                case 2:
-                    _b = undefined;
-                    _f.label = 3;
-                case 3:
-                    onlineRecommendedVersion = _b;
-                    versionToBeInstalled = onlineRecommendedVersion !== null && onlineRecommendedVersion !== void 0 ? onlineRecommendedVersion : fallbackVersion;
-                    return [4 /*yield*/, getInstalledJLinkVersion().catch(function () { return undefined; })];
-                case 4:
-                    installedVersion = _f.sent();
-                    installed = !!installedVersion;
-                    outdated = !installed ||
-                        !versionToBeInstalled ||
-                        !isValidVersion(installedVersion, versionToBeInstalled);
-                    return [2 /*return*/, {
-                            outdated: outdated,
-                            installedVersion: installedVersion,
-                            installed: installed,
-                            versionToBeInstalled: versionToBeInstalled,
-                        }];
-            }
-        });
-    });
-};
-exports.getVersionToInstall = getVersionToInstall;
+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, common_1.fetchIndex)().then(function (v) {
-        return downloadJLink(v, onUpdate, destinationDir, destinationFileName);
+    return (0, fetchIndex_1.fetchIndex)().then(function (v) {
+        return (0, downloadJLink_1.downloadJLink)(v, onUpdate, destinationDir, destinationFileName);
     });
 };
 exports.downloadAndSaveJLink = downloadAndSaveJLink;
 var downloadAndInstallJLink = function (onUpdate) {
-    return (0, common_1.fetchIndex)()
-        .then(function (v) { return downloadJLink(v, onUpdate); })
-        .then(function (v) { return (0, exports.installJLink)(v, 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); });
 };
 exports.downloadAndInstallJLink = downloadAndInstallJLink;

package/dist/operations/downloadJLink.d.ts

@@ -0,0 +1,3 @@
+import { JLinkIndex } from './fetchIndex';
+import { OnUpdate } from '../shared/update';
+export declare const downloadJLink: ({ jlinkUrls }: JLinkIndex, onUpdate?: OnUpdate, destinationDir?: string, destinationFileName?: string) => Promise<string>;

package/dist/operations/downloadJLink.js

@@ -0,0 +1,97 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * 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 };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadJLink = void 0;
+var os_1 = __importDefault(require("os"));
+var path_1 = __importDefault(require("path"));
+var fs_1 = require("../shared/fs");
+var net_1 = require("../shared/net");
+var getDownloadJLinkUrl = function (jlinkUrls) {
+    var _a;
+    var platform = os_1.default.platform();
+    var arch = os_1.default.arch();
+    // @ts-expect-error It is quite literally checked right before
+    if (!(platform in jlinkUrls) || !(arch in jlinkUrls[platform])) {
+        throw new Error("JLink not available for ".concat(platform, "/").concat(arch));
+    }
+    // @ts-expect-error We know it exists but it is also handled if undefined
+    var url = (_a = jlinkUrls[platform]) === null || _a === void 0 ? void 0 : _a[arch];
+    if (!url) {
+        throw new Error("JLink not available for ".concat(platform, "/").concat(arch));
+    }
+    return url;
+};
+var downloadJLink = function (_a, onUpdate_1) {
+    var args_1 = [];
+    for (var _i = 2; _i < arguments.length; _i++) {
+        args_1[_i - 2] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([_a, onUpdate_1], args_1, true), void 0, function (_b, onUpdate, destinationDir, destinationFileName) {
+        var url, jlink;
+        var jlinkUrls = _b.jlinkUrls;
+        if (destinationDir === void 0) { destinationDir = os_1.default.tmpdir(); }
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    url = getDownloadJLinkUrl(jlinkUrls);
+                    return [4 /*yield*/, (0, net_1.download)(url, onUpdate)];
+                case 1:
+                    jlink = _c.sent();
+                    return [2 /*return*/, (0, fs_1.saveToFile)(path_1.default.join(destinationDir, destinationFileName || path_1.default.basename(url)), jlink)];
+            }
+        });
+    });
+};
+exports.downloadJLink = downloadJLink;

package/dist/{common.d.ts → operations/fetchIndex.d.ts}

@@ -6,5 +6,5 @@ export interface JLinkIndex {
     version: string;
     jlinkUrls: JLinkVariant;
 }
+export declare const indexUrl = "https://files.nordicsemi.com/ui/api/v1/download?isNativeBrowsing=true&repoKey=swtools&path=external/ncd/jlink/index.json";
 export declare const fetchIndex: () => Promise<JLinkIndex>;
-export declare const saveToFile: (destinationFile: string, data: string | NodeJS.ArrayBufferView) => Promise<string>;

package/dist/{common.js → operations/fetchIndex.js}

@@ -1,4 +1,9 @@
 "use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * 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) {
@@ -35,39 +40,17 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveToFile = exports.fetchIndex = exports.archs = exports.platforms = void 0;
-var fs_1 = require("fs");
-var path_1 = __importDefault(require("path"));
+exports.fetchIndex = exports.indexUrl = exports.archs = exports.platforms = void 0;
+var net_1 = require("../shared/net");
 exports.platforms = ['darwin', 'linux', 'win32'];
 exports.archs = ['arm64', 'x64'];
-var fetchJSON = function (url) { return __awaiter(void 0, void 0, void 0, function () {
-    var response;
-    return __generator(this, function (_a) {
-        switch (_a.label) {
-            case 0: return [4 /*yield*/, fetch(url, {
-                    headers: {
-                        Range: 'bytes=0-',
-                    },
-                })];
-            case 1:
-                response = _a.sent();
-                if (!response.ok) {
-                    throw new Error("Unable to fetch file from ".concat(indexUrl, ". Got status code ").concat(status, "."));
-                }
-                return [2 /*return*/, response.json()];
-        }
-    });
-}); };
-var indexUrl = 'https://files.nordicsemi.com/ui/api/v1/download?isNativeBrowsing=true&repoKey=swtools&path=external/ncd/jlink/index.json';
+exports.indexUrl = 'https://files.nordicsemi.com/ui/api/v1/download?isNativeBrowsing=true&repoKey=swtools&path=external/ncd/jlink/index.json';
 var fetchIndex = function () { return __awaiter(void 0, void 0, void 0, function () {
     var res;
     return __generator(this, function (_a) {
         switch (_a.label) {
-            case 0: return [4 /*yield*/, fetchJSON(indexUrl)];
+            case 0: return [4 /*yield*/, (0, net_1.fetchJSON)(exports.indexUrl)];
             case 1:
                 res = _a.sent();
                 if (res == null ||
@@ -81,16 +64,3 @@ var fetchIndex = function () { return __awaiter(void 0, void 0, void 0, function
     });
 }); };
 exports.fetchIndex = fetchIndex;
-var saveToFile = function (destinationFile, data) { return __awaiter(void 0, void 0, void 0, function () {
-    return __generator(this, function (_a) {
-        (0, fs_1.mkdirSync)(path_1.default.dirname(destinationFile), { recursive: true });
-        try {
-            (0, fs_1.writeFileSync)(destinationFile, data);
-        }
-        catch (e) {
-            throw new Error("Unable to write file to ".concat(destinationFile, ". Error: ").concat(e));
-        }
-        return [2 /*return*/, destinationFile];
-    });
-}); };
-exports.saveToFile = saveToFile;

package/dist/operations/getJLinkState.d.ts

@@ -0,0 +1,23 @@
+type JLinkNotInstalled = {
+    status: 'not installed';
+    versionToBeInstalled: string;
+};
+type JLinkNotInstalledNonAvailable = {
+    status: 'not installed but none available';
+};
+type JLinkUpToDate = {
+    status: 'up to date';
+    installedVersion: string;
+    versionToBeInstalled?: string;
+};
+type JLinkShouldBeUpdated = {
+    status: 'should be updated';
+    installedVersion?: string;
+    versionToBeInstalled: string;
+};
+export type JLinkState = JLinkNotInstalled | JLinkNotInstalledNonAvailable | JLinkUpToDate | JLinkShouldBeUpdated;
+export declare const getJLinkState: ({ fallbackVersion, checkOnline, }?: {
+    fallbackVersion?: string;
+    checkOnline?: boolean;
+}) => Promise<JLinkState>;
+export {};

package/dist/operations/getJLinkState.js

@@ -0,0 +1,106 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * 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 };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJLinkState = void 0;
+var fetchIndex_1 = require("./fetchIndex");
+var jLinkVersion_1 = require("../shared/jLinkVersion");
+var getJLinkState = function () {
+    var args_1 = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args_1[_i] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([], args_1, true), void 0, function (_a) {
+        var onlineRecommendedVersion, _b, versionToBeInstalled, installedVersion;
+        var _c;
+        var _d = _a === void 0 ? {} : _a, fallbackVersion = _d.fallbackVersion, _e = _d.checkOnline, checkOnline = _e === void 0 ? true : _e;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    if (!checkOnline) return [3 /*break*/, 2];
+                    return [4 /*yield*/, (0, fetchIndex_1.fetchIndex)().catch(function () { return undefined; })];
+                case 1:
+                    _b = (_c = (_f.sent())) === null || _c === void 0 ? void 0 : _c.version;
+                    return [3 /*break*/, 3];
+                case 2:
+                    _b = undefined;
+                    _f.label = 3;
+                case 3:
+                    onlineRecommendedVersion = _b;
+                    versionToBeInstalled = onlineRecommendedVersion !== null && onlineRecommendedVersion !== void 0 ? onlineRecommendedVersion : fallbackVersion;
+                    return [4 /*yield*/, (0, jLinkVersion_1.getInstalledJLinkVersion)().catch(function () { return undefined; })];
+                case 4:
+                    installedVersion = _f.sent();
+                    if (installedVersion == null) {
+                        if (versionToBeInstalled == null) {
+                            return [2 /*return*/, { status: 'not installed but none available' }];
+                        }
+                        return [2 /*return*/, { status: 'not installed', versionToBeInstalled: versionToBeInstalled }];
+                    }
+                    /* If `versionToBeInstalled` is undefined we do not really know but at
+                    least there is some J-Link installed and we do not know that it is
+                    outdated. So, we return 'up to date', but this may be changed to a
+                    fifth state "installed, unknown if up-to-date" if we see the need for
+                    this in the future. */
+                    if (versionToBeInstalled == null ||
+                        (0, jLinkVersion_1.isValidVersion)(installedVersion, versionToBeInstalled)) {
+                        return [2 /*return*/, { status: 'up to date', installedVersion: installedVersion, versionToBeInstalled: versionToBeInstalled }];
+                    }
+                    return [2 /*return*/, {
+                            status: 'should be updated',
+                            installedVersion: installedVersion,
+                            versionToBeInstalled: versionToBeInstalled,
+                        }];
+            }
+        });
+    });
+};
+exports.getJLinkState = getJLinkState;

package/dist/operations/installJLink.d.ts

@@ -0,0 +1,2 @@
+import type { OnUpdate } from '../shared/update';
+export declare const installJLink: (installerPath: string, onUpdate?: OnUpdate) => Promise<void>;

package/dist/operations/installJLink.js

@@ -0,0 +1,47 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installJLink = void 0;
+var child_process_1 = require("child_process");
+var os_1 = __importDefault(require("os"));
+var installJLink = function (installerPath, onUpdate) {
+    var command;
+    var args;
+    switch (os_1.default.platform()) {
+        case 'darwin':
+            command = 'open';
+            args = ['-W', installerPath];
+            break;
+        case 'linux':
+            command = 'pkexec';
+            args = ['sh', '-c', "dpkg -i \"".concat(installerPath, "\"")];
+            break;
+        case 'win32':
+            command = installerPath;
+            args = ['-InstUSBDriver=1'];
+            break;
+        default:
+            throw new Error('Invalid platform');
+    }
+    onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({ step: 'install', percentage: 0 });
+    return new Promise(function (resolve, reject) {
+        (0, child_process_1.execFile)(command, args, function (error, _, stderr) {
+            if (error) {
+                return reject(error);
+            }
+            if (stderr) {
+                return reject(stderr);
+            }
+            onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({ step: 'install', percentage: 100 });
+            return resolve();
+        });
+    });
+};
+exports.installJLink = installJLink;

package/dist/shared/fs.d.ts

@@ -0,0 +1,5 @@
+export declare const saveToFile: (destinationFile: string, data: string | NodeJS.ArrayBufferView) => string;
+export declare const createTemporaryScriptFile: (content: string) => {
+    filePath: string;
+    [Symbol.dispose]: () => void;
+};

package/dist/shared/fs.js

@@ -0,0 +1,39 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTemporaryScriptFile = exports.saveToFile = void 0;
+var fs_1 = require("fs");
+var os_1 = require("os");
+var path_1 = __importDefault(require("path"));
+var saveToFile = function (destinationFile, data) {
+    try {
+        (0, fs_1.mkdirSync)(path_1.default.dirname(destinationFile), { recursive: true });
+        (0, fs_1.writeFileSync)(destinationFile, data);
+    }
+    catch (e) {
+        throw new Error("Unable to write file to ".concat(destinationFile, ". Error: ").concat(e));
+    }
+    return destinationFile;
+};
+exports.saveToFile = saveToFile;
+var createTemporaryScriptFile = function (content) {
+    var _a;
+    var tmpDir = (0, fs_1.mkdtempSync)(path_1.default.join((0, os_1.tmpdir)(), 'jlink-'));
+    var filePath = path_1.default.join(tmpDir, 'script');
+    (0, fs_1.writeFileSync)(filePath, content);
+    return _a = {
+            filePath: filePath
+        },
+        _a[Symbol.dispose] = function () {
+            (0, fs_1.rmSync)(tmpDir, { recursive: true, force: true });
+        },
+        _a;
+};
+exports.createTemporaryScriptFile = createTemporaryScriptFile;

package/dist/shared/jLinkVersion.d.ts

@@ -0,0 +1,2 @@
+export declare const isValidVersion: (installedVersion: string, expectedVersion: string) => boolean;
+export declare const getInstalledJLinkVersion: () => Promise<string>;

package/dist/shared/jLinkVersion.js

@@ -0,0 +1,182 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * 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 };
+    }
+};
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInstalledJLinkVersion = exports.isValidVersion = void 0;
+var child_process_1 = require("child_process");
+var fs_1 = require("fs");
+var os_1 = __importDefault(require("os"));
+var path_1 = __importDefault(require("path"));
+var semver_1 = __importDefault(require("semver"));
+var util_1 = require("util");
+var fs_2 = require("./fs");
+var reg = function () {
+    var _a;
+    var defaultRegLocation = path_1.default.resolve((_a = process.env.SystemRoot) !== null && _a !== void 0 ? _a : 'C:\\Windows', 'System32', 'reg.exe');
+    return (0, fs_1.existsSync)(defaultRegLocation) ? defaultRegLocation : 'reg.exe';
+};
+var winRegQuery = function (key) {
+    if (process.platform !== 'win32') {
+        throw new Error('Unsupported platform');
+    }
+    return (0, child_process_1.execSync)("".concat(reg(), " query ").concat(key)).toString().trim();
+};
+var getJLinkExePath = function () {
+    var _a;
+    switch (os_1.default.platform()) {
+        case 'win32':
+            var cwd = winRegQuery('HKEY_CURRENT_USER\\Software\\SEGGER\\J-Link /v InstallPath');
+            if (!cwd) {
+                cwd = winRegQuery('HKEY_LOCAL_MACHINE\\Software\\SEGGER\\J-Link /v InstallPath');
+            }
+            cwd = ((_a = /InstallPath\s+\w+\s+(.*)/.exec(cwd)) !== null && _a !== void 0 ? _a : [])[1];
+            if (!cwd) {
+                throw new Error('JLink not installed');
+            }
+            return "\"".concat(path_1.default.join(cwd, 'JLink.exe'), "\"");
+        case 'linux':
+        case 'darwin':
+            return 'JLinkExe';
+        default:
+            throw new Error('Invalid platform');
+    }
+};
+var convertToSemverVersion = function (version) {
+    var _a;
+    var _b = (_a = version.match(/V?(\d+\.\d+)(.)?/)) !== null && _a !== void 0 ? _a : [], majorMinor = _b[1], patchLetter = _b[2];
+    var patch = patchLetter
+        ? patchLetter.charCodeAt(0) - 'a'.charCodeAt(0) + 1
+        : 0;
+    return "".concat(majorMinor, ".").concat(patch);
+};
+var isValidVersion = function (installedVersion, expectedVersion) {
+    return semver_1.default.gte(convertToSemverVersion(installedVersion), convertToSemverVersion(expectedVersion));
+};
+exports.isValidVersion = isValidVersion;
+var getInstalledJLinkVersion = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var env_1, scriptFile, output, versionRegExp, match, e_1;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                env_1 = { stack: [], error: void 0, hasError: false };
+                _b.label = 1;
+            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; })];
+            case 2:
+                output = _b.sent();
+                versionRegExp = /^SEGGER J-Link Commander V([0-9a-z.]+) .*$/m;
+                match = (_a = output.stdout.match(versionRegExp)) === null || _a === void 0 ? void 0 : _a[1];
+                if (!match) {
+                    throw new Error("Couldn't get jlink version.");
+                }
+                return [2 /*return*/, "v".concat(match)];
+            case 3:
+                e_1 = _b.sent();
+                env_1.error = e_1;
+                env_1.hasError = true;
+                return [3 /*break*/, 5];
+            case 4:
+                __disposeResources(env_1);
+                return [7 /*endfinally*/];
+            case 5: return [2 /*return*/];
+        }
+    });
+}); };
+exports.getInstalledJLinkVersion = getInstalledJLinkVersion;

package/dist/shared/net.d.ts

@@ -0,0 +1,3 @@
+import type { OnUpdate } from './update';
+export declare const download: (url: string, onUpdate?: OnUpdate) => Promise<Buffer<ArrayBuffer>>;
+export declare const fetchJSON: <T>(url: string) => Promise<T>;

package/dist/shared/net.js

@@ -0,0 +1,109 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * 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.fetchJSON = exports.download = void 0;
+var handleFailedRequest = function (response, url) {
+    if (!response.ok) {
+        throw new Error("Unable to fetch file from ".concat(url, ". Got status code ").concat(response.status, "."));
+    }
+};
+var download = function (url, onUpdate) { return __awaiter(void 0, void 0, void 0, function () {
+    var response, hasContentLength, contentLength, reader, chunks, receivedLength, _a, done, value;
+    var _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0: return [4 /*yield*/, fetch(url, {
+                    headers: {
+                        Range: 'bytes=0-',
+                    },
+                })];
+            case 1:
+                response = _c.sent();
+                handleFailedRequest(response, url);
+                hasContentLength = response.headers.has('content-length');
+                contentLength = hasContentLength
+                    ? Number(response.headers.get('content-length'))
+                    : 1;
+                reader = (_b = response.body) === null || _b === void 0 ? void 0 : _b.getReader();
+                chunks = [];
+                receivedLength = 0;
+                _c.label = 2;
+            case 2:
+                if (!reader) return [3 /*break*/, 4];
+                return [4 /*yield*/, reader.read()];
+            case 3:
+                _a = _c.sent(), done = _a.done, value = _a.value;
+                if (done) {
+                    return [3 /*break*/, 4];
+                }
+                chunks.push(value);
+                receivedLength += value.length;
+                onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
+                    step: 'download',
+                    percentage: hasContentLength
+                        ? Number(((receivedLength / contentLength) * 100).toFixed(2))
+                        : 0,
+                });
+                return [3 /*break*/, 2];
+            case 4: return [2 /*return*/, Buffer.concat(chunks)];
+        }
+    });
+}); };
+exports.download = download;
+var fetchJSON = function (url) { return __awaiter(void 0, void 0, void 0, function () {
+    var response;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, fetch(url, {
+                    headers: {
+                        Range: 'bytes=0-',
+                    },
+                })];
+            case 1:
+                response = _a.sent();
+                handleFailedRequest(response, url);
+                return [2 /*return*/, response.json()];
+        }
+    });
+}); };
+exports.fetchJSON = fetchJSON;

package/dist/shared/update.d.ts

@@ -0,0 +1,5 @@
+export interface Update {
+    step: 'install' | 'download';
+    percentage: number;
+}
+export type OnUpdate = (update: Update) => void;

package/dist/shared/update.js

@@ -0,0 +1,7 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nordicsemiconductor/nrf-jlink-js",
-    "version": "0.10.0",
+    "version": "0.12.0",
     "main": "dist",
     "types": "dist",
     "files": [
@@ -23,6 +23,6 @@
         "url": "git+https://github.com/NordicSemiconductor/nrf-jlink-js.git"
     },
     "author": "Nordic Semiconductor ASA",
-    "license": "Proprietary",
+    "license": "SEE LICENSE IN LICENSE",
     "description": "Shared library to handle J-Link versions"
 }