final 6.9.2

Author: hklages

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented in this file.
 
+### [6.9.2] 2025-01-09
+
+#### Changed
+
+- added command "household.remove.subwoofer"
+
+
 ### [6.9.1] 2024-12-12
 
 #### Info

docs/Helper.js.html

@@ -145,6 +145,43 @@ <h1 class="page-title">Source: Helper.js</h1>
       return item.replace(/:LR|:RR/, '')
     }) 
   },
+
+  /** Returns the UUID of the subwoofer.
+   * @param {string} mapString string from HTSatChanMapSet or channelMapSet
+   * 
+   * @returns {"Promise&lt;string>"} subwoofer UUID
+   * 
+   * @throws {error} 
+   * 
+   */
+  // Example
+  // eslint-disable-next-line max-len
+  // RINCON_48A6B8B5614E01400:LF,RF;RINCON_38420B92ABE601400:RR;RINCON_7828CA042C8401400:LR;RINCON_542A1B108A6201400:SW
+   
+  extractSubwooferUuid: async (mapString) => {
+    debug('method:%s', 'extractSubwooferUuid')
+
+    if (!module.exports.isTruthy(mapString)) {
+      throw new Error('invalid parameter - invalid/missing')
+    }
+    if (typeof mapString !== 'string') {
+      throw new Error('invalid parameter - is not string')
+    }
+    
+    if (!mapString.includes(';')) {
+      throw new Error('invalid parameter - no subwoofer (missing ;)')
+    }
+    const uuidsPlusChannel = mapString.split(';')
+    const subwooferUuidArray = uuidsPlusChannel.filter((item) => {
+      return item.includes(':SW')
+    })
+    if ((subwooferUuidArray.length !== 1)) {
+      throw new Error('invalid parameter -  no subwoofer found')
+    }
+    
+    // remove identifier :SW
+    return subwooferUuidArray[0].replace(/:SW/, '')
+  },
 
   /** Converts hh:mm:ss time to milliseconds. Does not check input!
    * No validation: hh 0 to 23, mm 0 to 59 ss 0 59, : must exist
@@ -658,7 +695,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="Sonos-Ext
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Dec 12 2024 13:22:32 GMT+0100 (Central European Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Jan 09 2025 18:19:06 GMT+0100 (Central European Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/global.html

@@ -1493,7 +1493,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="Sonos-Ext
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Dec 12 2024 13:22:32 GMT+0100 (Central European Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Jan 09 2025 18:19:06 GMT+0100 (Central European Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/index.html

@@ -56,7 +56,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="Sonos-Ext
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Dec 12 2024 13:22:32 GMT+0100 (Central European Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Jan 09 2025 18:19:06 GMT+0100 (Central European Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/module-MySonos.html

@@ -2259,7 +2259,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="Sonos-Ext
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Dec 12 2024 13:22:32 GMT+0100 (Central European Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Jan 09 2025 18:19:06 GMT+0100 (Central European Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/module-Sonos-Commands.html

@@ -4121,7 +4121,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="Sonos-Ext
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Dec 12 2024 13:22:32 GMT+0100 (Central European Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.4</a> on Thu Jan 09 2025 18:19:06 GMT+0100 (Central European Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>