@nordicsemiconductor/pc-nrfconnect-shared 230.0.0 → 232.0.0

package/nrfutil/device/boardController.ts

@@ -11,7 +11,7 @@ export default (
     device: NrfutilDevice,
     data: object,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     // "operation: 2, command_id: 0" is the command to set the configuration for the board controller.
     const json = {
@@ -35,6 +35,6 @@ export default (
         'x-execute-batch',
         onProgress,
         controller,
-        ['--batch-json', JSON.stringify(json)]
+        ['--batch-json', JSON.stringify(json)],
     );
 };

package/nrfutil/device/common.ts

@@ -153,11 +153,11 @@ export const deviceSingleTaskEndOperation = async <T = void>(
     command: string,
     onProgress?: OnProgress,
     controller?: AbortController,
-    args: string[] = []
+    args: string[] = [],
 ) => {
     if (!device.serialNumber) {
         throw new Error(
-            `Device does not have a serial number, no device operation is possible`
+            `Device does not have a serial number, no device operation is possible`,
         );
     }
     const box = await getModule('device');
@@ -165,7 +165,7 @@ export const deviceSingleTaskEndOperation = async <T = void>(
         command,
         onProgress,
         controller,
-        [...args, '--serial-number', device.serialNumber]
+        [...args, '--serial-number', device.serialNumber],
     );
 };
 
@@ -174,11 +174,11 @@ export const deviceSingleTaskEndOperationVoid = async (
     command: string,
     onProgress?: OnProgress,
     controller?: AbortController,
-    args: string[] = []
+    args: string[] = [],
 ) => {
     if (!device.serialNumber) {
         throw new Error(
-            `Device does not have a serial number, no device operation is possible`
+            `Device does not have a serial number, no device operation is possible`,
         );
     }
 
@@ -187,7 +187,7 @@ export const deviceSingleTaskEndOperationVoid = async (
         command,
         onProgress,
         controller,
-        [...args, '--serial-number', device.serialNumber]
+        [...args, '--serial-number', device.serialNumber],
     );
 };
 

package/nrfutil/device/deviceInfo.ts

@@ -70,7 +70,7 @@ export default async (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     try {
         return device.traits.jlink ||
@@ -82,11 +82,11 @@ export default async (
                       'device-info',
                       onProgress,
                       controller,
-                      coreArg(core)
+                      coreArg(core),
                   )
               ).deviceInfo
             : undefined;
-    } catch (_) {
+    } catch {
         return undefined;
     }
 };

package/nrfutil/device/erase.ts

@@ -16,12 +16,12 @@ export default (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
         'erase',
         onProgress,
         controller,
-        coreArg(core)
+        coreArg(core),
     );

package/nrfutil/device/getBoardControllerConfig.ts

@@ -16,7 +16,7 @@ export interface BoardControllerConfigResponse {
 export default (
     device: NrfutilDevice,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     // "operation: 0, command_id: 0" is the command to retrieve the configuration from the board controller.
     const json = {
@@ -39,6 +39,6 @@ export default (
         'x-execute-batch',
         onProgress,
         controller,
-        ['--batch-json', JSON.stringify(json)]
+        ['--batch-json', JSON.stringify(json)],
     ).then(res => res.data?.cfg ?? []);
 };

package/nrfutil/device/getBoardControllerVersion.ts

@@ -23,7 +23,7 @@ export interface BoardControllerVersion {
 export default (
     device: NrfutilDevice,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     // "operation: 0, command_id: 1" is the command to retrieve version information from the board controller.
     const json = {
@@ -46,6 +46,6 @@ export default (
         'x-execute-batch',
         onProgress,
         controller,
-        ['--batch-json', JSON.stringify(json)]
+        ['--batch-json', JSON.stringify(json)],
     ).then(res => res.data);
 };

package/nrfutil/device/getCoreInfo.ts

@@ -34,12 +34,12 @@ export default (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperation<DeviceCoreInfo>(
         device,
         'core-info',
         onProgress,
         controller,
-        coreArg(core)
+        coreArg(core),
     );

package/nrfutil/device/getFwInfo.ts

@@ -59,12 +59,12 @@ export default (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperation<FWInfo>(
         device,
         'fw-info',
         onProgress,
         controller,
-        coreArg(core)
+        coreArg(core),
     );

package/nrfutil/device/getProtectionStatus.ts

@@ -30,12 +30,12 @@ export default (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperation<GetProtectionStatusResult>(
         device,
         'protection-get',
         onProgress,
         controller,
-        coreArg(core)
+        coreArg(core),
     );

package/nrfutil/device/list.ts

@@ -21,7 +21,7 @@ const isListEvent = (event: HotplugEvent | ListEvent): event is ListEvent =>
     (event as ListEvent).devices !== undefined;
 
 const isHotplugEvent = (
-    event: HotplugEvent | ListEvent
+    event: HotplugEvent | ListEvent,
 ): event is HotplugEvent => (event as HotplugEvent).event !== undefined;
 
 export default async (
@@ -32,7 +32,7 @@ export default async (
         onDeviceArrived: (device: NrfutilDevice) => void;
         onDeviceLeft: (id: number) => void;
     },
-    timeout?: number
+    timeout?: number,
 ) => {
     const args = [
         ...deviceTraitsToArgs(traits),

package/nrfutil/device/logLibVersions.ts

@@ -16,7 +16,7 @@ import {
 
 const log = (
     description: string,
-    dependencyOrVersion?: Dependency | string
+    dependencyOrVersion?: Dependency | string,
 ) => {
     const logger = getNrfutilLogger();
     if (dependencyOrVersion == null) {
@@ -24,8 +24,8 @@ const log = (
     } else {
         logger?.info(
             `Using ${description} version: ${describeVersion(
-                dependencyOrVersion
-            )}`
+                dependencyOrVersion,
+            )}`,
         );
     }
 };
@@ -47,14 +47,14 @@ export default (moduleVersion: ModuleVersion) => {
                 logger?.warn(
                     `SEGGER J-Link is not installed. ` +
                         `Install at least version ${jlinkCompatibility.requiredJlink} ` +
-                        `from https://www.segger.com/downloads/jlink`
+                        `from https://www.segger.com/downloads/jlink`,
                 );
                 break;
             case 'Outdated SEGGER J-Link':
                 logger?.warn(
                     `Outdated SEGGER J-Link. Your version of SEGGER J-Link (${jlinkCompatibility.actualJlink}) ` +
                         `is older than the one this app was tested with (${jlinkCompatibility.requiredJlink}). ` +
-                        `Install the newer version from https://www.segger.com/downloads/jlink`
+                        `Install the newer version from https://www.segger.com/downloads/jlink`,
                 );
                 break;
             case 'Newer SEGGER J-Link is used':
@@ -62,7 +62,7 @@ export default (moduleVersion: ModuleVersion) => {
                     `Your version of SEGGER J-Link (${jlinkCompatibility.actualJlink}) ` +
                         `is newer than the one this app was tested with (${jlinkCompatibility.requiredJlink}). ` +
                         `The tested version is not required, and your J-Link version will most likely work fine.` +
-                        ` If you get issues related to J-Link with your devices, use the tested version.`
+                        ` If you get issues related to J-Link with your devices, use the tested version.`,
                 );
                 break;
         }
@@ -70,7 +70,7 @@ export default (moduleVersion: ModuleVersion) => {
         logger?.error(
             `Failed to get the library versions${
                 error != null ? `: ${describeError(error)}` : ''
-            }`
+            }`,
         );
     }
 };

package/nrfutil/device/program.ts

@@ -4,11 +4,7 @@
  * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
  */
 
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import { v4 as uuid } from 'uuid';
-
+import { createDisposableTempFile } from '../fs';
 import { type OnProgress } from '../sandboxTypes';
 import {
     coreArg,
@@ -46,18 +42,18 @@ interface NordicDfuProgrammingOptions {
 }
 
 const isJLinkProgrammingOptions = (
-    options: ProgrammingOptions
+    options: ProgrammingOptions,
 ): options is JLinkProgrammingOptions =>
     (options as JLinkProgrammingOptions).chipEraseMode !== undefined;
 
 const isMcuBootProgrammingOptions = (
-    options: ProgrammingOptions
+    options: ProgrammingOptions,
 ): options is McuBootProgrammingOptions =>
     (options as McuBootProgrammingOptions).netCoreUploadDelay !== undefined ||
     (options as McuBootProgrammingOptions).target !== undefined;
 
 export const isNordicDfuProgrammingOptions = (
-    options: ProgrammingOptions
+    options: ProgrammingOptions,
 ): options is NordicDfuProgrammingOptions =>
     !isMcuBootProgrammingOptions(options) &&
     (options as NordicDfuProgrammingOptions).mcuEndState !== undefined;
@@ -79,7 +75,7 @@ const programmingOptionsToStrings = (options?: ProgrammingOptions) => {
             options.target && `target=${options.target}`,
             options.netCoreUploadDelay &&
                 `net_core_upload_delay=${Math.round(
-                    options.netCoreUploadDelay
+                    options.netCoreUploadDelay,
                 )}`,
         ].filter(Boolean);
     }
@@ -103,7 +99,7 @@ const program = (
     onProgress?: OnProgress,
     core?: DeviceCore,
     programmingOptions?: ProgrammingOptions,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
@@ -116,42 +112,27 @@ const program = (
             ...deviceTraitsToArgs(device.traits),
             ...coreArg(core),
             ...programmingOptionsToArgs(programmingOptions),
-        ]
+        ],
     );
 
-export const createTempFile = (firmware: FirmwareBuffer): string => {
-    let tempFilePath;
-    do {
-        tempFilePath = path.join(os.tmpdir(), `${uuid()}.${firmware.type}`);
-    } while (fs.existsSync(tempFilePath));
-
-    fs.writeFileSync(tempFilePath, firmware.buffer);
-
-    return tempFilePath;
-};
-
 const programBuffer = async (
     device: NrfutilDevice,
     firmware: FirmwareBuffer,
     onProgress?: OnProgress,
     core?: DeviceCore,
     programmingOptions?: ProgrammingOptions,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
-    const tempFilePath = createTempFile(firmware);
-    try {
-        await program(
-            device,
-            tempFilePath,
-            onProgress,
-            core,
-            programmingOptions,
-            controller
-        );
-    } catch (error) {
-        fs.unlinkSync(tempFilePath);
-        throw error;
-    }
+    using tempFile = createDisposableTempFile(firmware.buffer, firmware.type);
+
+    await program(
+        device,
+        tempFile.path,
+        onProgress,
+        core,
+        programmingOptions,
+        controller,
+    );
 };
 
 export default async (
@@ -160,7 +141,7 @@ export default async (
     onProgress?: OnProgress,
     core?: DeviceCore,
     programmingOptions?: ProgrammingOptions,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     if (typeof firmware === 'string') {
         await program(
@@ -169,7 +150,7 @@ export default async (
             onProgress,
             core,
             programmingOptions,
-            controller
+            controller,
         );
     } else {
         await programBuffer(
@@ -178,7 +159,7 @@ export default async (
             onProgress,
             core,
             programmingOptions,
-            controller
+            controller,
         );
     }
 };

package/nrfutil/device/recover.ts

@@ -16,12 +16,12 @@ export default (
     device: NrfutilDevice,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
         'recover',
         onProgress,
         controller,
-        coreArg(core)
+        coreArg(core),
     );

package/nrfutil/device/reset.ts

@@ -18,7 +18,7 @@ export default async (
     core?: DeviceCore,
     resetKind?: ResetKind,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     const args = [
         ...(resetKind ? ['--reset-kind', resetKind] : []),
@@ -30,6 +30,6 @@ export default async (
         'reset',
         onProgress,
         controller,
-        args
+        args,
     );
 };

package/nrfutil/device/setMcuState.ts

@@ -14,12 +14,12 @@ export default (
     state: McuState,
     onProgress?: OnProgress,
     controller?: AbortController,
-    target?: string
+    target?: string,
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
         'mcu-state-set',
         onProgress,
         controller,
-        [state, ...(target ? ['--target', target] : [])]
+        [state, ...(target ? ['--target', target] : [])],
     );

package/nrfutil/device/setProtectionStatus.ts

@@ -17,12 +17,12 @@ export default (
     region: 'All' | 'SecureRegions' | 'Region0' | 'Region0Region1',
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
         'protection-set',
         onProgress,
         controller,
-        [region, ...coreArg(core)]
+        [region, ...coreArg(core)],
     );

package/nrfutil/device/xRead.ts

@@ -115,14 +115,14 @@ const xRead = async (
     options: XReadOptions,
     core?: DeviceCore,
     onProgress?: OnProgress,
-    controller?: AbortController
+    controller?: AbortController,
 ) => {
     const result = await deviceSingleTaskEndOperation<MemoryReadRaw>(
         device,
         'x-read',
         onProgress,
         controller,
-        [...xReadOptionsToArgs(options), ...coreArg(core)]
+        [...xReadOptionsToArgs(options), ...coreArg(core)],
     );
 
     return toIntelHex(result.memoryData);

package/nrfutil/fs.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+
+import { mkdtempSync, rmSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, sep } from 'path';
+import { v4 as uuid } from 'uuid';
+
+// When we reliably use at least Node v24.4.0, the implementation below can be replaced with this:
+// export const createDisposableTempDir = () => mkdtempDisposableSync(`${tmpdir()}${sep}`);
+export const createDisposableTempDir = () => {
+    const tmpDir = mkdtempSync(`${tmpdir()}${sep}`);
+
+    const remove = () => {
+        rmSync(tmpDir, { recursive: true, force: true });
+    };
+
+    return {
+        path: tmpDir,
+        remove,
+        [Symbol.dispose]: remove,
+    };
+};
+
+export const createDisposableTempFile = (
+    content: Parameters<typeof writeFileSync>[1],
+    fileExtension?: string,
+) => {
+    const disposableTempDir = createDisposableTempDir();
+
+    const effectiveFileExtension =
+        fileExtension == null ? '' : `.${fileExtension}`;
+
+    const filePath = join(
+        disposableTempDir.path,
+        `${uuid()}${effectiveFileExtension}`,
+    );
+
+    writeFileSync(filePath, content);
+
+    return {
+        ...disposableTempDir,
+
+        path: filePath,
+    };
+};

package/nrfutil/modules.ts

@@ -22,8 +22,8 @@ const logModuleVersions = (module: string, moduleSandbox: NrfutilSandbox) => {
         moduleSandbox.getModuleVersion().then(moduleVersion => {
             getNrfutilLogger()?.info(
                 `Using the bundled nrfutil ${module} version: ${describeVersion(
-                    moduleVersion.version
-                )}`
+                    moduleVersion.version,
+                )}`,
             );
         });
     }
@@ -31,8 +31,8 @@ const logModuleVersions = (module: string, moduleSandbox: NrfutilSandbox) => {
     moduleSandbox.getCoreVersion().then(moduleVersion => {
         getNrfutilLogger()?.info(
             `Using the bundled core version for nrfutil ${module}: ${describeVersion(
-                moduleVersion.version
-            )}`
+                moduleVersion.version,
+            )}`,
         );
     });
 };
@@ -124,24 +124,24 @@ const getAllIninitialisedModules = () =>
     Promise.all(
         Object.values(modules)
             .filter(module => module.isInitialised())
-            .map(module => module.get())
+            .map(module => module.get()),
     );
 
 export const setLogLevel = async (level: LogLevel) => {
     (await getAllIninitialisedModules()).forEach(moduleSandbox =>
-        moduleSandbox.setLogLevel(level)
+        moduleSandbox.setLogLevel(level),
     );
 };
 
 export const setVerboseLogging = async (verbose: boolean) => {
     (await getAllIninitialisedModules()).forEach(moduleSandbox =>
-        moduleSandbox.setLogLevel(verbose ? 'trace' : fallbackLevel)
+        moduleSandbox.setLogLevel(verbose ? 'trace' : fallbackLevel),
     );
 };
 
 export const getAllModuleVersions = async () =>
     Promise.all(
         (await getAllIninitialisedModules()).map(module =>
-            module.getModuleVersion()
-        )
+            module.getModuleVersion(),
+        ),
     );