@nordicsemiconductor/nrf-jlink-js 0.11.0 → 0.13.0

package/LICENSE

@@ -1,7 +1,10 @@
+LicenseID:  LicenseRef-Nordic-4-Clause
+
+ExtractedText: <text>
+
 Copyright (c) 2025 Nordic Semiconductor ASA
 All rights reserved.
 
-SPDX-License-Identifier: Nordic-4-Clause
 
 Use in source and binary forms, redistribution in binary form only, with
 or without modification, are permitted provided that the following conditions
@@ -33,3 +36,4 @@ 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>

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/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,6 @@
-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<{
+    version: string;
+    fileName: string;
+}>;
+export declare const downloadAndInstallJLink: (onUpdate?: OnUpdate) => Promise<void>;

package/dist/jlink.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,241 +40,29 @@ 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 __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.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; })];
+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 __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:
-                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)];
+                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 }];
         }
     });
 }); };
-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;
-            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;
-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;
-var downloadAndSaveJLink = function (destinationDir, destinationFileName, onUpdate) {
-    return (0, common_1.fetchIndex)().then(function (v) {
-        return 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 (index) { return (0, downloadJLink_1.downloadJLink)(index, onUpdate); })
+        .then(function (fileName) { return (0, installJLink_1.installJLink)(fileName, 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.11.0",
+    "version": "0.13.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"
 }