⭐️ query usb devices on macOS (#5414)

Author: chris-rock

.github/actions/spelling/expect.txt

@@ -61,6 +61,7 @@ messagestoragepolicy
 mfs
 mgroup
 Mpim
+mkey
 natgateway
 networkinterface
 nmap
@@ -70,6 +71,7 @@ notebookinstancedetails
 nsrecord
 nullgroup
 nullstring
+nodekey
 opcplc
 openssl
 orstatement
@@ -108,8 +110,7 @@ timestream
 toplevel
 tpu
 tailscale
-nodekey
-mkey
+usb
 vdcs
 virtualmachine
 Vtpm

providers/os/resources/os.lr

@@ -1754,3 +1754,37 @@ private networkInterface @defaults("name mac active") {
   // Whether a network interface is virtual of not
   virtual bool
 }
+
+// Experimental: USB resource
+usb {
+  // List of USB devices
+  devices() []usb.device
+}
+
+// Experimental: USB device
+private usb.device @defaults("manufacturer name") {
+  // USB device vendor id
+  vendorId string
+  // USB manufacturer
+  manufacturer string
+  // USB device product id
+  productId string
+  // USB device serial number
+  serial string
+  // USB device name
+  name string
+  // USB device version
+  version string
+  // USB speed
+  speed string
+  // USB device class
+  class string
+  // USB device class name
+  className string
+  // USB device subclass
+  subclass string
+  // Protocol
+  protocol string
+  // Removable device
+  isRemovable bool
+}

providers/os/resources/os.lr.go

@@ -997,6 +997,29 @@ resources:
       params: {}
     is_private: true
     min_mondoo_version: latest
+  usb:
+    fields:
+      devices: {}
+    min_mondoo_version: 9.0.0
+  usb.device:
+    fields:
+      class: {}
+      className: {}
+      isRemovable: {}
+      manufacturer: {}
+      name: {}
+      product: {}
+      productId: {}
+      protocol: {}
+      removable: {}
+      serial: {}
+      speed: {}
+      subclass: {}
+      vendor: {}
+      vendorId: {}
+      version: {}
+    is_private: true
+    min_mondoo_version: 9.0.0
   user:
     fields:
       authorizedkeys: {}