@nordicsemiconductor/pc-nrfconnect-shared 116.0.0 → 118.0.0

package/Changelog.md

@@ -7,6 +7,28 @@ This project does _not_ adhere to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html) but contrary to it
 every new version is a new major version.
 
+## 118 - 2023-10-13
+
+### Added
+
+-   Option to configure external React to support legacy apps in the launcher.
+
+### Changed
+
+-   Checking whether the `package.json` contains all required fields is now also
+    down before building.
+-   Use `zod` for the `package.json` schema for apps. This is used verify that
+    apps have the right fields in `package.json` and also generates the right
+    TypeScript type for it.
+-   `nrfConnectForDesktop.html` is not optional anymore, it must always be
+    specified in `package.json`.
+
+## 117 - 2023-10-04
+
+### Fixed
+
+-   `nrfutil device program` did now throw error when files buffers where used
+
 ## 116 - 2023-10-03
 
 ### Fixed
@@ -388,7 +410,7 @@ declare module '!!@svgr!*.svg' {
 ### Steps to upgrade when using this package
 
 -   Following this step will make the app incompatible with the currently
-    released launcher (v4.1.2): Add an `index`-property to package.json. The
+    released launcher (v4.1.2): Add an `html`-property to package.json. The
     following example will use the index bundled with shared that works with our
     apps, but apps can also make their own instead if needed.
 

package/coverage/cobertura-coverage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">
-<coverage lines-valid="3209" lines-covered="1788" line-rate="0.5571" branches-valid="1541" branches-covered="448" branch-rate="0.2907" timestamp="1696334939734" complexity="0" version="0.1">
+<coverage lines-valid="3210" lines-covered="1788" line-rate="0.557" branches-valid="1531" branches-covered="448" branch-rate="0.2926" timestamp="1697198852924" complexity="0" version="0.1">
   <sources>
     <source>/home/vsts/work/1/s</source>
   </sources>
@@ -932,7 +932,7 @@
         </class>
       </classes>
     </package>
-    <package name="nrfutil.device" line-rate="0.2463" branch-rate="0">
+    <package name="nrfutil.device" line-rate="0.24539999999999998" branch-rate="0">
       <classes>
         <class name="batch.ts" filename="nrfutil/device/batch.ts" line-rate="0.07139999999999999" branch-rate="0">
           <methods>
@@ -1437,7 +1437,7 @@
             <line number="95" hits="0" branch="false"/>
           </lines>
         </class>
-        <class name="program.ts" filename="nrfutil/device/program.ts" line-rate="0.2452" branch-rate="0">
+        <class name="program.ts" filename="nrfutil/device/program.ts" line-rate="0.2407" branch-rate="0">
           <methods>
             <method name="(anonymous_7)" hits="0" signature="()V">
               <lines>
@@ -1491,7 +1491,7 @@
             </method>
             <method name="(anonymous_17)" hits="0" signature="()V">
               <lines>
-                <line number="158" hits="0"/>
+                <line number="159" hits="0"/>
               </lines>
             </method>
           </methods>
@@ -1545,10 +1545,11 @@
             <line number="144" hits="0" branch="false"/>
             <line number="145" hits="0" branch="false"/>
             <line number="154" hits="0" branch="false"/>
-            <line number="158" hits="3" branch="false"/>
-            <line number="166" hits="0" branch="true" condition-coverage="0% (0/2)"/>
-            <line number="167" hits="0" branch="false"/>
-            <line number="176" hits="0" branch="false"/>
+            <line number="155" hits="0" branch="false"/>
+            <line number="159" hits="3" branch="false"/>
+            <line number="167" hits="0" branch="true" condition-coverage="0% (0/2)"/>
+            <line number="168" hits="0" branch="false"/>
+            <line number="177" hits="0" branch="false"/>
           </lines>
         </class>
         <class name="recover.ts" filename="nrfutil/device/recover.ts" line-rate="0.6666" branch-rate="0">
@@ -4815,37 +4816,36 @@
           <methods>
             <method name="(anonymous_9)" hits="56" signature="()V">
               <lines>
-                <line number="233" hits="56"/>
+                <line number="219" hits="56"/>
               </lines>
             </method>
             <method name="(anonymous_11)" hits="56" signature="()V">
               <lines>
-                <line number="251" hits="56"/>
+                <line number="237" hits="56"/>
               </lines>
             </method>
             <method name="(anonymous_12)" hits="28" signature="()V">
               <lines>
-                <line number="254" hits="28"/>
+                <line number="240" hits="28"/>
               </lines>
             </method>
             <method name="(anonymous_13)" hits="28" signature="()V">
               <lines>
-                <line number="261" hits="28"/>
+                <line number="247" hits="28"/>
               </lines>
             </method>
             <method name="(anonymous_14)" hits="0" signature="()V">
               <lines>
-                <line number="272" hits="0"/>
+                <line number="258" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_15)" hits="0" signature="()V">
               <lines>
-                <line number="276" hits="0"/>
+                <line number="262" hits="0"/>
               </lines>
             </method>
           </methods>
           <lines>
-            <line number="34" hits="3" branch="false"/>
             <line number="35" hits="3" branch="false"/>
             <line number="36" hits="3" branch="false"/>
             <line number="37" hits="3" branch="false"/>
@@ -4854,31 +4854,32 @@
             <line number="40" hits="3" branch="false"/>
             <line number="41" hits="3" branch="false"/>
             <line number="42" hits="3" branch="false"/>
-            <line number="73" hits="3" branch="false"/>
-            <line number="217" hits="56" branch="true" condition-coverage="75% (3/4)"/>
+            <line number="43" hits="3" branch="false"/>
+            <line number="57" hits="3" branch="false"/>
+            <line number="201" hits="56" branch="false"/>
+            <line number="205" hits="3" branch="false"/>
+            <line number="207" hits="112" branch="true" condition-coverage="83.33333333333334% (5/6)"/>
+            <line number="209" hits="0" branch="false"/>
             <line number="219" hits="3" branch="false"/>
-            <line number="221" hits="112" branch="true" condition-coverage="83.33333333333334% (5/6)"/>
-            <line number="223" hits="0" branch="false"/>
-            <line number="233" hits="3" branch="false"/>
-            <line number="234" hits="56" branch="true" condition-coverage="0% (0/1)"/>
-            <line number="235" hits="0" branch="true" condition-coverage="0% (0/7)"/>
-            <line number="236" hits="0" branch="false"/>
-            <line number="238" hits="0" branch="true" condition-coverage="0% (0/5)"/>
-            <line number="239" hits="0" branch="false"/>
-            <line number="242" hits="56" branch="false"/>
-            <line number="245" hits="56" branch="false"/>
-            <line number="251" hits="28" branch="false"/>
-            <line number="252" hits="56" branch="true" condition-coverage="100% (3/3)"/>
-            <line number="254" hits="3" branch="false"/>
-            <line number="257" hits="28" branch="true" condition-coverage="100% (3/3)"/>
-            <line number="261" hits="28" branch="false"/>
-            <line number="265" hits="28" branch="true" condition-coverage="66.66666666666666% (2/3)"/>
-            <line number="266" hits="0" branch="false"/>
-            <line number="269" hits="28" branch="true" condition-coverage="14.285714285714285% (1/7)"/>
-            <line number="272" hits="3" branch="false"/>
-            <line number="273" hits="0" branch="true" condition-coverage="0% (0/2)"/>
-            <line number="276" hits="3" branch="false"/>
-            <line number="277" hits="0" branch="true" condition-coverage="0% (0/2)"/>
+            <line number="220" hits="56" branch="true" condition-coverage="0% (0/1)"/>
+            <line number="221" hits="0" branch="true" condition-coverage="0% (0/7)"/>
+            <line number="222" hits="0" branch="false"/>
+            <line number="224" hits="0" branch="true" condition-coverage="0% (0/5)"/>
+            <line number="225" hits="0" branch="false"/>
+            <line number="228" hits="56" branch="false"/>
+            <line number="231" hits="56" branch="false"/>
+            <line number="237" hits="28" branch="false"/>
+            <line number="238" hits="56" branch="true" condition-coverage="100% (3/3)"/>
+            <line number="240" hits="3" branch="false"/>
+            <line number="243" hits="28" branch="true" condition-coverage="100% (3/3)"/>
+            <line number="247" hits="28" branch="false"/>
+            <line number="251" hits="28" branch="true" condition-coverage="66.66666666666666% (2/3)"/>
+            <line number="252" hits="0" branch="false"/>
+            <line number="255" hits="28" branch="true" condition-coverage="14.285714285714285% (1/7)"/>
+            <line number="258" hits="3" branch="false"/>
+            <line number="259" hits="0" branch="true" condition-coverage="0% (0/2)"/>
+            <line number="262" hits="3" branch="false"/>
+            <line number="263" hits="0" branch="true" condition-coverage="0% (0/2)"/>
           </lines>
         </class>
       </classes>
@@ -7401,9 +7402,9 @@
         </class>
       </classes>
     </package>
-    <package name="src.utils" line-rate="0.6344" branch-rate="0.1603">
+    <package name="src.utils" line-rate="0.6344" branch-rate="0.17350000000000002">
       <classes>
-        <class name="appDirs.ts" filename="src/utils/appDirs.ts" line-rate="0.6153" branch-rate="0">
+        <class name="appDirs.ts" filename="src/utils/appDirs.ts" line-rate="0.6153" branch-rate="1">
           <methods>
             <method name="(anonymous_7)" hits="0" signature="()V">
               <lines>
@@ -7437,7 +7438,7 @@
             <line number="10" hits="13" branch="false"/>
             <line number="12" hits="13" branch="false"/>
             <line number="19" hits="13" branch="false"/>
-            <line number="20" hits="0" branch="true" condition-coverage="0% (0/10)"/>
+            <line number="20" hits="0" branch="false"/>
             <line number="21" hits="0" branch="false"/>
             <line number="22" hits="0" branch="false"/>
             <line number="31" hits="13" branch="false"/>
@@ -7772,134 +7773,134 @@
           <methods>
             <method name="(anonymous_13)" hits="3" signature="()V">
               <lines>
-                <line number="36" hits="3"/>
+                <line number="35" hits="3"/>
               </lines>
             </method>
             <method name="(anonymous_14)" hits="0" signature="()V">
               <lines>
-                <line number="57" hits="0"/>
+                <line number="56" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_15)" hits="0" signature="()V">
               <lines>
-                <line number="75" hits="0"/>
+                <line number="74" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_16)" hits="3" signature="()V">
               <lines>
-                <line number="87" hits="3"/>
+                <line number="86" hits="3"/>
               </lines>
             </method>
             <method name="(anonymous_17)" hits="0" signature="()V">
               <lines>
-                <line number="101" hits="0"/>
+                <line number="100" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_18)" hits="0" signature="()V">
               <lines>
-                <line number="112" hits="0"/>
+                <line number="111" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_19)" hits="0" signature="()V">
               <lines>
-                <line number="122" hits="0"/>
+                <line number="121" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_20)" hits="0" signature="()V">
               <lines>
-                <line number="133" hits="0"/>
+                <line number="132" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_21)" hits="0" signature="()V">
               <lines>
-                <line number="144" hits="0"/>
+                <line number="143" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_22)" hits="0" signature="()V">
               <lines>
-                <line number="162" hits="0"/>
+                <line number="161" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_23)" hits="0" signature="()V">
               <lines>
-                <line number="171" hits="0"/>
+                <line number="170" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_24)" hits="0" signature="()V">
               <lines>
-                <line number="178" hits="0"/>
+                <line number="177" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_25)" hits="0" signature="()V">
               <lines>
-                <line number="189" hits="0"/>
+                <line number="188" hits="0"/>
               </lines>
             </method>
             <method name="(anonymous_26)" hits="1" signature="()V">
               <lines>
-                <line number="197" hits="1"/>
+                <line number="196" hits="1"/>
               </lines>
             </method>
           </methods>
           <lines>
             <line number="7" hits="4" branch="false"/>
-            <line number="12" hits="4" branch="false"/>
-            <line number="18" hits="4" branch="false"/>
-            <line number="20" hits="4" branch="false"/>
-            <line number="27" hits="4" branch="false"/>
-            <line number="36" hits="4" branch="false"/>
-            <line number="37" hits="3" branch="true" condition-coverage="50% (1/2)"/>
-            <line number="40" hits="3" branch="false"/>
-            <line number="42" hits="3" branch="true" condition-coverage="100% (1/1)"/>
-            <line number="44" hits="0" branch="false"/>
-            <line number="46" hits="0" branch="false"/>
+            <line number="11" hits="4" branch="false"/>
+            <line number="17" hits="4" branch="false"/>
+            <line number="19" hits="4" branch="false"/>
+            <line number="26" hits="4" branch="false"/>
+            <line number="35" hits="4" branch="false"/>
+            <line number="36" hits="3" branch="true" condition-coverage="50% (1/2)"/>
+            <line number="39" hits="3" branch="false"/>
+            <line number="41" hits="3" branch="true" condition-coverage="100% (1/1)"/>
+            <line number="43" hits="0" branch="false"/>
+            <line number="45" hits="0" branch="false"/>
+            <line number="52" hits="0" branch="false"/>
             <line number="53" hits="0" branch="false"/>
-            <line number="54" hits="0" branch="false"/>
+            <line number="56" hits="0" branch="false"/>
             <line number="57" hits="0" branch="false"/>
-            <line number="58" hits="0" branch="false"/>
+            <line number="61" hits="0" branch="false"/>
             <line number="62" hits="0" branch="false"/>
-            <line number="63" hits="0" branch="false"/>
-            <line number="70" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="75" hits="0" branch="false"/>
+            <line number="69" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="74" hits="0" branch="false"/>
+            <line number="76" hits="0" branch="false"/>
             <line number="77" hits="0" branch="false"/>
-            <line number="78" hits="0" branch="false"/>
-            <line number="87" hits="4" branch="false"/>
-            <line number="88" hits="3" branch="true" condition-coverage="75% (3/4)"/>
-            <line number="93" hits="3" branch="false"/>
-            <line number="101" hits="4" branch="false"/>
-            <line number="102" hits="0" branch="false"/>
-            <line number="103" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="104" hits="0" branch="false"/>
-            <line number="112" hits="4" branch="false"/>
-            <line number="113" hits="0" branch="false"/>
-            <line number="114" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="122" hits="4" branch="false"/>
-            <line number="123" hits="0" branch="false"/>
-            <line number="124" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="133" hits="4" branch="false"/>
-            <line number="134" hits="0" branch="false"/>
-            <line number="135" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="144" hits="4" branch="false"/>
-            <line number="145" hits="0" branch="false"/>
-            <line number="147" hits="0" branch="true" condition-coverage="0% (0/3)"/>
-            <line number="148" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="149" hits="0" branch="false"/>
-            <line number="162" hits="4" branch="false"/>
-            <line number="163" hits="0" branch="false"/>
-            <line number="164" hits="0" branch="true" condition-coverage="0% (0/1)"/>
-            <line number="165" hits="0" branch="false"/>
+            <line number="86" hits="4" branch="false"/>
+            <line number="87" hits="3" branch="true" condition-coverage="75% (3/4)"/>
+            <line number="92" hits="3" branch="false"/>
+            <line number="100" hits="4" branch="false"/>
+            <line number="101" hits="0" branch="false"/>
+            <line number="102" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="103" hits="0" branch="false"/>
+            <line number="111" hits="4" branch="false"/>
+            <line number="112" hits="0" branch="false"/>
+            <line number="113" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="121" hits="4" branch="false"/>
+            <line number="122" hits="0" branch="false"/>
+            <line number="123" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="132" hits="4" branch="false"/>
+            <line number="133" hits="0" branch="false"/>
+            <line number="134" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="143" hits="4" branch="false"/>
+            <line number="144" hits="0" branch="false"/>
+            <line number="146" hits="0" branch="true" condition-coverage="0% (0/3)"/>
+            <line number="147" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="148" hits="0" branch="false"/>
+            <line number="161" hits="4" branch="false"/>
+            <line number="162" hits="0" branch="false"/>
+            <line number="163" hits="0" branch="true" condition-coverage="0% (0/1)"/>
+            <line number="164" hits="0" branch="false"/>
+            <line number="166" hits="0" branch="false"/>
             <line number="167" hits="0" branch="false"/>
-            <line number="168" hits="0" branch="false"/>
-            <line number="171" hits="4" branch="false"/>
-            <line number="172" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="178" hits="4" branch="false"/>
-            <line number="179" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="189" hits="4" branch="false"/>
+            <line number="170" hits="4" branch="false"/>
+            <line number="171" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="177" hits="4" branch="false"/>
+            <line number="178" hits="0" branch="true" condition-coverage="0% (0/4)"/>
+            <line number="188" hits="4" branch="false"/>
+            <line number="189" hits="0" branch="true" condition-coverage="0% (0/4)"/>
             <line number="190" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="191" hits="0" branch="true" condition-coverage="0% (0/4)"/>
-            <line number="197" hits="4" branch="false"/>
-            <line number="198" hits="1" branch="false"/>
-            <line number="201" hits="4" branch="false"/>
+            <line number="196" hits="4" branch="false"/>
+            <line number="197" hits="1" branch="false"/>
+            <line number="200" hits="4" branch="false"/>
           </lines>
         </class>
         <class name="useHotKey.ts" filename="src/utils/useHotKey.ts" line-rate="0.7916" branch-rate="0.6">

package/ipc/MetaFiles.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
  */
 
-import { DevicePCA } from '../src/Device/deviceInfo/deviceInfo';
+import { z } from 'zod';
 
 export type UrlString = string;
 
@@ -40,49 +40,21 @@ export interface AppInfo {
     };
 }
 
-interface ObjectContainingOptionalStrings {
-    [index: string]: string | undefined;
-}
+export const semver = z.string().regex(
+    // From https://semver.org
+    /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/,
+    'Is not a valid string for a semantic version'
+);
 
-interface NrfConnectForDesktop {
-    supportedDevices?: DevicePCA[];
-    nrfutil?: NrfutilModules;
-    html?: string;
-}
+const nrfutilModuleName = z.string();
+const nrfutilModuleVersion = semver;
 
-type SemverString = string;
+export type NrfutilModuleName = z.infer<typeof nrfutilModuleName>;
+export type NrfutilModuleVersion = z.infer<typeof nrfutilModuleVersion>;
 
-export type NrfutilModuleName = string;
-export type NrfutilModuleVersion = SemverString;
+export const nrfModules = z.record(
+    nrfutilModuleName,
+    nrfutilModuleVersion.array().nonempty()
+);
 
-export interface NrfutilModules {
-    [name: NrfutilModuleName]: [
-        NrfutilModuleVersion,
-        ...NrfutilModuleVersion[]
-    ];
-}
-
-export interface PackageJson {
-    name: string;
-    version: SemverString;
-
-    // Several optional properties
-    author?: string;
-    bin?: ObjectContainingOptionalStrings | string;
-    dependencies?: ObjectContainingOptionalStrings;
-    description?: string;
-    homepage?: UrlString;
-    devDependencies?: ObjectContainingOptionalStrings;
-    displayName?: string;
-    engines?: ObjectContainingOptionalStrings;
-    nrfConnectForDesktop?: NrfConnectForDesktop;
-    files?: readonly string[];
-    license?: string;
-    main?: string;
-    peerDependencies?: ObjectContainingOptionalStrings;
-    repository?: {
-        type: string;
-        url: UrlString;
-    };
-    scripts?: ObjectContainingOptionalStrings;
-}
+export type NrfutilModules = z.infer<typeof nrfModules>;

package/ipc/device.ts

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2023 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+
+export const knownDevicePcas = [
+    'PCA10028',
+    'PCA10031',
+    'PCA10040',
+    'PCA10056',
+    'PCA10059',
+    'PCA10090',
+    'PCA10095',
+    'PCA10100',
+    'PCA10121',
+    'PCA20020',
+    'PCA20035',
+    'PCA10143',
+    'PCA10152',
+    'PCA10153',
+    'PCA20049',
+] as const;
+
+export type KnownDevicePCA = (typeof knownDevicePcas)[number];

package/ipc/schema/packageJson.ts

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2023 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+
+import { z } from 'zod';
+
+import { knownDevicePcas } from '../device';
+import { nrfModules, semver } from '../MetaFiles';
+import { parseWithPrettifiedErrorMessage } from './parseJson';
+
+const nrfConnectForDesktop = z.object({
+    supportedDevices: z.enum(knownDevicePcas).array().nonempty().optional(),
+    nrfutil: nrfModules.optional(),
+    html: z.string(),
+});
+
+const recordOfOptionalStrings = z.record(z.string().optional());
+
+const engines = recordOfOptionalStrings.and(
+    z.object({ nrfconnect: z.string() })
+);
+
+const packageJson = z.object({
+    name: z.string(),
+    version: semver,
+
+    author: z.string().optional(),
+    bin: z.string().or(recordOfOptionalStrings).optional(),
+    dependencies: recordOfOptionalStrings.optional(),
+    description: z.string(),
+    homepage: z.string().url().optional(),
+    devDependencies: recordOfOptionalStrings.optional(),
+    displayName: z.string(),
+    engines,
+    nrfConnectForDesktop,
+    files: z.string().array().optional(),
+    license: z.string().optional(),
+    main: z.string().optional(),
+    peerDependencies: recordOfOptionalStrings.optional(),
+    repository: z
+        .object({
+            type: z.string(),
+            url: z.string().url(),
+        })
+        .optional(),
+    scripts: recordOfOptionalStrings.optional(),
+});
+
+export type PackageJson = z.infer<typeof packageJson>;
+
+export const parsePackageJson =
+    parseWithPrettifiedErrorMessage<PackageJson>(packageJson);
+
+// In the launcher we want to handle that the whole nrfConnectForDesktop may be missing
+// and the html in it can also be undefined, so there we need to use this legacy variant
+const legacyPackageJson = packageJson.merge(
+    z.object({
+        nrfConnectForDesktop: nrfConnectForDesktop
+            .partial({ html: true })
+            .optional(),
+    })
+);
+
+export type LegacyPackageJson = z.infer<typeof legacyPackageJson>;
+
+export const parseLegacyPackageJson =
+    parseWithPrettifiedErrorMessage<LegacyPackageJson>(legacyPackageJson);

package/ipc/schema/parseJson.ts

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2023 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
+ */
+
+import { z } from 'zod';
+import { fromZodError } from 'zod-validation-error';
+
+export const parseWithPrettifiedErrorMessage =
+    <Out, T extends z.ZodType<Out> = z.ZodTypeAny>(schema: T) =>
+    (content: string) => {
+        const result = schema.safeParse(JSON.parse(content));
+
+        if (result.success) {
+            return result;
+        }
+
+        return {
+            ...result,
+            error: fromZodError(result.error, {
+                prefix: 'Error in package.json',
+                prefixSeparator: ':\n- ',
+                issueSeparator: '\n- ',
+            }),
+        };
+    };

package/main/index.ts

@@ -28,7 +28,20 @@ export const serialPort = {
     forRenderer: forRendererSerialPort,
 };
 
-export * from '../ipc/MetaFiles';
+export {
+    type AppInfo,
+    type NrfutilModuleName,
+    type NrfutilModules,
+    type NrfutilModuleVersion,
+    type SourceJson,
+    type WithdrawnJson,
+} from '../ipc/MetaFiles';
+export {
+    type LegacyPackageJson,
+    type PackageJson,
+    parseLegacyPackageJson,
+    parsePackageJson,
+} from '../ipc/schema/packageJson';
 
 export { type OverwriteOptions } from '../ipc/serialPort';
 export { type OpenAppOptions } from '../ipc/openWindow';