presidium 3.2.0 → 3.3.1

package/DynamoDBStream.js

@@ -467,15 +467,18 @@ class DynamoDBStream {
     let exists = false
     while (!exists) {
       await sleep(100)
-      const streamData = await this.describe().catch(error => {
+
+      try {
+        const streamData = await this.describe()
+        if (streamData.TableStatus == 'ACTIVE') {
+          exists = true
+        }
+      } catch (error) {
         if (error.message == `DynamoDB Stream for ${this.table} not found.`) {
-          // return
+          // continue
         } else {
           throw error
         }
-      })
-      if (streamData.TableStatus == 'ACTIVE') {
-        exists = true
       }
     }
   }

package/GoogleChromeDevTools.js

@@ -178,38 +178,6 @@ class GoogleChromeDevToolsPage {
   }
 }
 
-/**
- * @name Event: DOM.attributeModified
- */
-
-/**
- * @name Event: DOM.attributeRemoved
- */
-
-/**
- * @name Event: DOM.characterDataModified
- */
-
-/**
- * @name Event: DOM.childNodeCountUpdated
- */
-
-/**
- * @name Event: DOM.childNodeInserted
- */
-
-/**
- * @name Event: DOM.childNodeRemoved
- */
-
-/**
- * @name Event: DOM.documentUpdated
- */
-
-/**
- * @name Event: DOM.setChildNodes
- */
-
 class GoogleChromeDevToolsDOM {
   constructor(websocket) {
     this.websocket = websocket
@@ -497,8 +465,179 @@ class GoogleChromeDevToolsDOM {
     return _Method.call(this, 'DOM.focus', options)
   }
 
+  /**
+   * @name Event: DOM.attributeModified
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('DOM.attributeModified', data {
+   *   nodeId: string,
+   *   name: string,
+   *   value: string,
+   * })
+   * ```
+   *
+   * The `DOM.attributeModified` event. Emitted when an attribute of an element is modified.
+   *
+   * Event Data:
+   *   `data`
+   *     * `nodeId` - the ID of the element or node.
+   *     * `name` - the name of the modified attribute.
+   *     * `value` - the value of the modified attribute.
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.attributeModified', data => {
+   *   console.log('attribute modified:', data)
+   * })
+   * ```
+   */
+
+  /**
+   * @name Event: DOM.attributeRemoved
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('DOM.attributeRemoved', data {
+   *   nodeId: string,
+   *   name: string,
+   * })
+   * ```
+   *
+   * The `DOM.attributeRemoved` event. Emitted when an attribute of an element is removed.
+   *
+   * Event Data:
+   *   * `data`
+   *     * `nodeId` - the ID of the element or node.
+   *     * `name` - the name of the removed attribute.
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.attributeModified', data => {
+   *   console.log('attribute removed:', data)
+   * })
+   * ```
+   */
+
+  /**
+   * @name Event: DOM.characterDataModified
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('DOM.characterDataModified', data {
+   *   nodeId: string,
+   *   childNodeCount: number,
+   * })
+   * ```
+   *
+   * The `DOM.characterDataModified` event. Emitted when a text node is modified.
+   *
+   * Event Data:
+   *   * `data`
+   *     * `nodeId` - the ID of the element or node.
+   *     * `characterData` - the new text value.
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.characterDataModified', data => {
+   *   console.log('text modified:', data)
+   * })
+   * ```
+   */
+
+  /**
+   * @name Event: DOM.childNodeCountUpdated
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('DOM.childNodeCountUpdated', data {
+   *   nodeId: string,
+   *   childNodeCount: number,
+   * })
+   * ```
+   *
+   * The `DOM.childNodeCountUpdated` event. Emitted when the child node count of a node is updated.
+   *
+   * Event Data:
+   *   * `data`
+   *     * `nodeId` - the ID of the element or node.
+   *     * `childNodeCount` - the updated count of child nodes.
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.childNodeCountUpdated', data => {
+   *   console.log('child node count updated:', data)
+   * })
+   * ```
+   */
+
+  /**
+   * @name Event: DOM.childNodeInserted
+   *
+   * @docs
+   * ```javascript
+   * module CDPDOM 'https://chromedevtools.github.io/devtools-protocol/tot/DOM/'
+   *
+   * emit('DOM.childNodeInserted', data {
+   *   parentNodeId: string,
+   *   previousNodeId: string,
+   *   node: CDPDOM.Node,
+   * })
+   * ```
+   *
+   * The `DOM.childNodeInserted` event. Emitted when a node is inserted into the DOM as a child of another node.
+   *
+   * Event Data:
+   *   * `data`
+   *     * `parentNodeId` - the id of the parent node.
+   *     * `previousNodeId` - the id of the node immediately preceding the inserted node.
+   *     * `node` - [`CDPDOM.Node`](https://chromedevtools.github.io/devtools-protocol/tot/DOM/#type-Node) - data about the inserted node.
+   */
+
+  /**
+   * @name Event: DOM.childNodeRemoved
+   *
+   * @docs
+   * ```javascript
+   * emit('DOM.childNodeRemoved', data {
+   *   parentNodeId: string,
+   *   nodeId: string,
+   * })
+   * ```
+   *
+   * The `DOM.childNodeRemoved` event. Emitted when a node is removed from the DOM as a child of another node.
+   *
+   * Event Data:
+   *   * `data`
+   *     * `parentNodeId` - the id of the parent node.
+   *     * `nodeId` - the id of the removed node.
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.childNodeRemoved', data => {
+   *   console.log('child node removed:', data.nodeId)
+   * })
+   * ```
+   */
+
+  /**
+   * @name Event: DOM.documentUpdated
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('DOM.documentUpdated')
+   * ```
+   *
+   * The `DOM.documentUpdated` event. Emitted when the `Document` object has been totally updated and node IDs are no longer valid.
+   *
+   * Event Data:
+   *   * (none)
+   *
+   * ```javascript
+   * googleChromeDevTools.on('DOM.documentUpdated', () => {
+   *   console.log('Document updated')
+   * })
+   * ```
+   */
+
 }
 
+
 class GoogleChromeDevToolsInput {
   constructor(websocket) {
     this.websocket = websocket
@@ -849,24 +988,20 @@ class GoogleChromeDevToolsRuntime {
  * Supported platforms:
  *   * `mac-arm64`
  *   * `linux64`
+ *   * `win64`
  *
  * ## Further Installation
  * Some further installation may be required for Linux platforms.
  *
- * ### Install headless dependencies for Amazon Linux 2023
+ * ### Install headless dependencies for Amazon Linux 2023 / Red Hat
  * ```sh
  * sudo dnf install -y cairo pango nss nspr atk at-spi2-atk cups-libs libdrm libxkbcommon libXcomposite libXdamage libXfixes libXrandr mesa-libgbm alsa-lib
  * ```
  *
- * ### Install headless dependencies for Ubuntu
+ * ### Install headless dependencies for Ubuntu / Debian
  * ```sh
  * sudo apt-get update && sudo apt-get install -y libcairo2 libpango-1.0-0 libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libatspi2.0-0 libcups2 libdrm-dev libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm-dev libasound2-dev
- *
- * # disable AppArmor unprivileged security restriction
- * echo "kernel.apparmor_restrict_unprivileged_userns=0" | sudo tee /etc/sysctl.d/60-apparmor-namespace.conf
- * sudo sysctl -p /etc/sysctl.d/60-apparmor-namespace.conf
  * ```
- *
  */
 class GoogleChromeDevTools extends EventEmitter {
   constructor(options = {}) {
@@ -921,7 +1056,11 @@ class GoogleChromeDevTools extends EventEmitter {
       offerPerMessageDeflate: false,
     })
     this.websocket.on('error', error => {
-      throw error
+      if (this.closed && error.code == 'ECONNRESET') {
+        console.error('Reset after close:', error)
+      } else {
+        throw error
+      }
     })
 
     this.websocket.on('message', message => {
@@ -995,10 +1134,37 @@ class GoogleChromeDevTools extends EventEmitter {
    * ```
    */
   close() {
+    this.closed = true
     this.websocket.sendClose()
-    this.websocket.close()
-    this.googleChromeForTesting.close()
+    this.websocket.on('close', () => {
+      this.googleChromeForTesting.cmd.on('close', () => {
+        this.emit('close')
+      })
+      this.googleChromeForTesting.close()
+    })
   }
+
+  /**
+   * @name Event: close
+   *
+   * @docs
+   * ```coffeescript [specscript]
+   * emit('close')
+   * ```
+   *
+   * The `close` event. Emitted when the websocket connection to the DevTools server is closed and the Google Chrome for Testing process is terminated.
+   *
+   * Event Data:
+   *   * (none)
+   *
+   * ```javascript
+   * googleChromeForTesting.on('close', () => {
+   *   console.log('WebSocket connection closed and Google Chrome for Testing process terminated.')
+   * })
+   * ```
+   */
+
 }
 
+
 module.exports = GoogleChromeDevTools

package/GoogleChromeForTesting.js

@@ -18,7 +18,7 @@ async function getChromeVersions() {
   return data
 }
 
-function updateConsoleLog(message) {
+function updateConsoleLog(message, platform) {
   readline.cursorTo(process.stdout, 0, undefined);
   readline.clearLine(process.stdout, 0);
   process.stdout.write(message);
@@ -33,7 +33,11 @@ function getPlatform() {
 
   if (platform == 'mac') {
     platform = `${platform}-${arch}`
-  } else {
+  }
+  else if (platform == 'win32') {
+    platform = `win${arch.slice(1)}`
+  }
+  else {
     platform = `${platform}${arch.slice(1)}`
   }
 
@@ -58,13 +62,26 @@ async function getChromeUrl() {
 }
 
 async function installChrome() {
+  const platform = getPlatform()
+  const delimiter = platform.startsWith('win') ? '\\' : '/'
   const url = await getChromeUrl.call(this)
-  let filepath = `${this.chromeDir}/${url.replace('https://storage.googleapis.com/chrome-for-testing-public/', '')}`
-  if (!filepath.startsWith('/')) {
+
+  let filepath = `${this.chromeDir}${delimiter}${url.replace('https://storage.googleapis.com/chrome-for-testing-public/', '')}`
+  if (platform.startsWith('win')) {
+    filepath = filepath.replace(/\//g, '\\')
+    if (!filepath.startsWith(`${__dirname[0]}:`)) {
+      filepath = path.join(process.cwd(), filepath)
+    }
+  } else if (!filepath.startsWith('/')) {
     filepath = path.join(process.cwd(), filepath)
   }
-  let parentDir = `${filepath.split('/').slice(0, -1).join('/')}`
-  if (!parentDir.startsWith('/')) {
+
+  let parentDir = `${filepath.split(delimiter).slice(0, -1).join(delimiter)}`
+  if (platform.startsWith('win')) {
+    if (!filepath.startsWith(`${__dirname[0]}:`)) {
+      parentDir = path.join(process.cwd(), parentDir)
+    }
+  } else if (!parentDir.startsWith('/')) {
     parentDir = path.join(process.cwd(), parentDir)
   }
   await fs.promises.mkdir(parentDir, { recursive: true })
@@ -81,9 +98,9 @@ async function installChrome() {
   response.on('data', chunk => {
     downloadedLength += chunk.length
     if (downloadedLength == contentLength) {
-      updateConsoleLog(`Downloading ${url} (${downloadedLength} / ${contentLength} bytes)\n`)
+      updateConsoleLog(`Downloading ${url} (${downloadedLength} / ${contentLength} bytes)\n`, platform)
     } else {
-      updateConsoleLog(`Downloading ${url} (${downloadedLength} / ${contentLength} bytes)`)
+      updateConsoleLog(`Downloading ${url} (${downloadedLength} / ${contentLength} bytes)`, platform)
     }
 
     fileStream.write(chunk)
@@ -98,10 +115,11 @@ async function installChrome() {
   })
   await promise
 
+  console.log('Extracting', filepath)
   try {
     await extract(filepath, { dir: parentDir })
-  } catch {
-    await sleep(100)
+  } catch (_error) {
+    await sleep(1000)
     await extract(filepath, { dir: parentDir })
   }
 }
@@ -113,14 +131,21 @@ async function getChromeFilepath() {
   const parentDir = `${filepath.split('/').slice(0, -1).join('/')}`
 
   try {
+    const dirents = await fs.promises.readdir(parentDir)
+    if (dirents.length <= 1) {
+      await installChrome.call(this)
+    }
+
     for await (const filepath of walk(parentDir)) {
-      console.log(filepath)
       if (platform.startsWith('mac') && filepath.endsWith('Google Chrome for Testing')) {
         return filepath
       }
       if (platform.startsWith('linux') && filepath.endsWith('chrome')) {
         return filepath
       }
+      if (platform.startsWith('win') && filepath.endsWith('chrome.exe')) {
+        return filepath
+      }
     }
   } catch (error) {
     if (error.code == 'ENOENT') {
@@ -173,6 +198,7 @@ async function getChromeFilepath() {
  * Supported platforms:
  *   * `mac-arm64`
  *   * `linux64`
+ *   * `win64`
  *
  * ## Further Installation
  * Some further installation may be required for Linux platforms.
@@ -185,10 +211,6 @@ async function getChromeFilepath() {
  * ### Install headless dependencies for Ubuntu / Debian
  * ```sh
  * sudo apt-get update && sudo apt-get install -y libcairo2 libpango-1.0-0 libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libatspi2.0-0 libcups2 libdrm-dev libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm-dev libasound2-dev
- *
- * # disable AppArmor unprivileged security restriction
- * echo "kernel.apparmor_restrict_unprivileged_userns=0" | sudo tee /etc/sysctl.d/60-apparmor-namespace.conf
- * sudo sysctl -p /etc/sysctl.d/60-apparmor-namespace.conf
  * ```
  */
 class GoogleChromeForTesting {
@@ -236,6 +258,7 @@ class GoogleChromeForTesting {
       `--user-data-dir=${this.userDataDir}`,
       ...this.headless ? ['--headless'] : [],
       ...this.useMockKeychain ? ['--use-mock-keychain'] : [],
+      '--no-sandbox',
     ])
     cmd.stdout.pipe(process.stdout)
     cmd.stderr.pipe(process.stderr)
@@ -288,6 +311,18 @@ class GoogleChromeForTesting {
    * ```coffeescript [specscript]
    * close() -> undefined
    * ```
+   *
+   * Terminates the Google Chrome for Testing process.
+   *
+   * Arguments:
+   *   * (none)
+   *
+   * Return:
+   *   * `undefined`
+   *
+   * ```javascript
+   * googleChromeForTesting.close()
+   * ```
    */
   close() {
     this.cmd.kill('SIGKILL')

package/LICENSE

@@ -1,21 +1,9 @@
-The MIT License (MIT)
+The CLOUT Free and Open Source Software License (CFOSS)
 
-Copyright (c) 2026 Richard Tong
+© Richard Yufei Tong, King of Software
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+  1. This permission notice is included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE, OR IN THE USE OF OR OTHER DEALINGS OF THE SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "presidium",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "A library for creating web services",
   "author": "Richard Tong",
   "license": "MIT",