@capturebridge/sdk 0.12.1 → 0.14.2

package/ImageSource.js

@@ -1,110 +1,110 @@
-import { blobToBase64, base64ToDataURL, checkResponse } from './Common.js'
-
-/**
- * ImageSource
- * @classdesc Class to handle loading various image formats
- *
- * @see {@link Probe}
- */
-export class ImageSource {
-  source
-  url
-  imageData
-  type
-  /**
-   * Instantiate an ImageSource
-   * @constructor
-   * @param {string} source - The source of the image data.
-   * @param {string} [type] - The type of data in the image source, valid values
-   * are 'url', 'base64', and 'dataurl'. If not provided 'base64' is the default.
-   *
-   * @example
-   * const personPhoto = new ImageSource('/person/123.jpg', '123', 'url')
-   */
-  constructor (source, type = 'base64') {
-    // TODO:
-    // If the source is typeof object and/or type=object we should do some duck
-    // typing and accept any of...
-    // - The result of an ICAO check that contains a cropped image
-    // - An Image tag (fetch the source)
-    // - A Blob
-    // - An Array Buffer
-    // - An object that has a fullCapture method (call function in .data())
-    this.type = type
-    switch (this.type) {
-      case 'url':
-        this.url = source
-        break
-      case 'base64':
-        this.imageData = source
-        break
-      case 'dataurl':
-        this.imageData = source.split(',')[1]
-        break
-      case undefined:
-      case null:
-      default:
-        throw new Error('Invalid image source type provided')
-    }
-  }
-
-  /**
-   * Fetch the image data and base64 encode it
-   * @async
-   * @example
-   * const personPhoto = new ImageSource("/img/photo.jpg")
-   * await personPhoto.data()
-   * console.log(personPhoto.imageData)
-   */
-  async data () {
-    if (!this.imageData && this.url) {
-      const response = await fetch(this.url)
-      await checkResponse(response)
-      const blob = await response.blob()
-      this.imageData = await blobToBase64(blob)
-    }
-    return this.imageData
-  }
-
-  /**
-   * Create an <img> element, wait for it to load and return it
-   * @async
-   * @example
-   * // Load the image and draw it on a Canvas
-   * const img = await imgSrc.toImage()
-   * const canvas = document.createElement('canvas')
-   * const ctx = canvas.getContext('2d')
-   * canvas.width = img.width
-   * canvas.height = img.height
-   * ctx.drawImage(img, canvas.width, canvas.height, img.width, img.height)
-   */
-  async toImage () {
-    const img = new window.Image()
-    const promise = new Promise((resolve, reject) => {
-      img.onload = (data) => resolve(img)
-      img.onerror = (err) => reject(err)
-    })
-    switch (this.type) {
-      case 'url':
-        img.src = this.url
-        break
-      case 'base64':
-        img.src = base64ToDataURL(this.imageData)
-        break
-      case 'dataurl':
-        img.src = this.source
-        break
-      case undefined:
-      case null:
-      default:
-        throw new Error('Invalid image source type provided')
-    }
-    return promise
-  }
-
-  toJSON () {
-    return this.imageData
-  }
-}
-
-export default ImageSource
+import { blobToBase64, base64ToDataURL, checkResponse } from './Common.js'
+
+/**
+ * ImageSource
+ * @classdesc Class to handle loading various image formats
+ *
+ * @see {@link Probe}
+ */
+export class ImageSource {
+  source
+  url
+  imageData
+  type
+  /**
+   * Instantiate an ImageSource
+   * @constructor
+   * @param {string} source - The source of the image data.
+   * @param {string} [type] - The type of data in the image source, valid values
+   * are 'url', 'base64', and 'dataurl'. If not provided 'base64' is the default.
+   *
+   * @example
+   * const personPhoto = new ImageSource('/person/123.jpg', '123', 'url')
+   */
+  constructor (source, type = 'base64') {
+    // TODO:
+    // If the source is typeof object and/or type=object we should do some duck
+    // typing and accept any of...
+    // - The result of an ICAO check that contains a cropped image
+    // - An Image tag (fetch the source)
+    // - A Blob
+    // - An Array Buffer
+    // - An object that has a fullCapture method (call function in .data())
+    this.type = type
+    switch (this.type) {
+      case 'url':
+        this.url = source
+        break
+      case 'base64':
+        this.imageData = source
+        break
+      case 'dataurl':
+        this.imageData = source.split(',')[1]
+        break
+      case undefined:
+      case null:
+      default:
+        throw new Error('Invalid image source type provided')
+    }
+  }
+
+  /**
+   * Fetch the image data and base64 encode it
+   * @async
+   * @example
+   * const personPhoto = new ImageSource("/img/photo.jpg")
+   * await personPhoto.data()
+   * console.log(personPhoto.imageData)
+   */
+  async data () {
+    if (!this.imageData && this.url) {
+      const response = await fetch(this.url)
+      await checkResponse(response)
+      const blob = await response.blob()
+      this.imageData = await blobToBase64(blob)
+    }
+    return this.imageData
+  }
+
+  /**
+   * Create an <img> element, wait for it to load and return it
+   * @async
+   * @example
+   * // Load the image and draw it on a Canvas
+   * const img = await imgSrc.toImage()
+   * const canvas = document.createElement('canvas')
+   * const ctx = canvas.getContext('2d')
+   * canvas.width = img.width
+   * canvas.height = img.height
+   * ctx.drawImage(img, canvas.width, canvas.height, img.width, img.height)
+   */
+  async toImage () {
+    const img = new window.Image()
+    const promise = new Promise((resolve, reject) => {
+      img.onload = (data) => resolve(img)
+      img.onerror = (err) => reject(err)
+    })
+    switch (this.type) {
+      case 'url':
+        img.src = this.url
+        break
+      case 'base64':
+        img.src = base64ToDataURL(this.imageData)
+        break
+      case 'dataurl':
+        img.src = this.source
+        break
+      case undefined:
+      case null:
+      default:
+        throw new Error('Invalid image source type provided')
+    }
+    return promise
+  }
+
+  toJSON () {
+    return this.imageData
+  }
+}
+
+export default ImageSource

package/Logs.js

@@ -1,129 +1,129 @@
-import { BASE_URL } from './Common.js'
-
-export const TRACE = 10
-export const DEBUG = 20
-export const INFO = 30
-export const WARN = 40
-export const ERROR = 50
-export const FATAL = 60
-
-/**
- * @constant
- * @type {Object.<string, number>}
- *
- */
-export const LOG_LEVELS = {
-  trace: TRACE,
-  debug: DEBUG,
-  info: INFO,
-  warn: WARN,
-  error: ERROR,
-  fatal: FATAL
-}
-
-/**
- * @classdesc Plugins write
- * {@link https://github.com/trentm/node-bunyan?tab=readme-ov-file#log-record-fields|Bunyan}
- * formated logs to separate log files. This class provides
- * utilities for viewing and following those logs as they're written.
- */
-export class Logs {
-  baseUrl
-  #reader
-  #controller
-  /**
-   * Instantiate a Log Object
-   * @constructor
-   * @param {string} [baseURL] - Protocol, domain, and port for the service.
-   */
-  constructor (baseUrl = BASE_URL) {
-    this.baseUrl = baseUrl
-  }
-
-  /**
-   * End the log stream and stop following logs.
-   */
-  end () {
-    this.#reader?.cancel()
-    this.#controller?.abort()
-  }
-
-  /**
-   * Add a handler for following logs. Note that each invocation of this method
-   * opens a connection to the server and holds it open. Web browsers limit the
-   * number of connections to a single domain. Avoid using this method more than
-   * once per client.
-   * @param {string[]} plugins - Follow logs for the provided Plugin IDs.
-   * @param {string|number} level - Log Level.
-   * @param {function} callback - Invoked with two arguments. The first argument
-   * is an Error object (if an error occurred) or null. The second argument is
-   * an log object.
-   */
-  follow (plugins, level, callback) {
-    let pluginList
-    if (typeof plugins === 'object' && plugins.length > 0) {
-      pluginList = plugins.join(',')
-    } else {
-      throw new Error('Invalid value provided for plugins argument')
-    }
-
-    const logLevel = (typeof level === 'number') ? level : LOG_LEVELS[level]
-
-    if (!logLevel) {
-      throw new Error('Invalid value provided for log level argument')
-    }
-
-    if (typeof callback !== 'function') {
-      throw new Error('Invalid value provided for callback argument')
-    }
-
-    const url = `${this.baseUrl}/plugin/logs/follow?plugins=${pluginList}&level=${logLevel}`
-
-    this.#controller = new AbortController()
-    const signal = this.#controller.signal
-
-    fetch(url, { signal })
-      .then(({ body }) => {
-        let buffer = ''
-        if (!body) {
-          return callback(new Error('No response body'))
-        }
-        const readData = data => {
-          if (!data.done) {
-            callback(null, data.value)
-            this.#reader.read().then(readData).catch(e => callback(e))
-          }
-        }
-        this.#reader = body
-          .pipeThrough(new TextDecoderStream())
-          .pipeThrough(new TransformStream({
-            transform (chunk, controller) {
-              buffer += chunk
-              const parts = buffer.split('\n')
-              parts.slice(0, -1).forEach(part => controller.enqueue(part))
-              buffer = parts[parts.length - 1]
-            },
-            flush (controller) {
-              if (buffer) {
-                controller.enqueue(buffer)
-              }
-            }
-          }))
-          .pipeThrough(new TransformStream({
-            transform (chunk, controller) {
-              controller.enqueue(JSON.parse(chunk))
-            }
-          }))
-          .getReader()
-        this.#reader
-          .read()
-          .then(readData)
-          .catch(e => callback(e))
-      }).catch(e => {
-        // Don't emit an error when aborting the fetch operation
-        if (e.name !== 'AbortError') {
-          callback(e)
-        }
-      })
-  }
-}
+import { BASE_URL } from './Common.js'
+
+export const TRACE = 10
+export const DEBUG = 20
+export const INFO = 30
+export const WARN = 40
+export const ERROR = 50
+export const FATAL = 60
+
+/**
+ * @constant
+ * @type {Object.<string, number>}
+ *
+ */
+export const LOG_LEVELS = {
+  trace: TRACE,
+  debug: DEBUG,
+  info: INFO,
+  warn: WARN,
+  error: ERROR,
+  fatal: FATAL
+}
+
+/**
+ * @classdesc Plugins write
+ * {@link https://github.com/trentm/node-bunyan?tab=readme-ov-file#log-record-fields|Bunyan}
+ * formated logs to separate log files. This class provides
+ * utilities for viewing and following those logs as they're written.
+ */
+export class Logs {
+  baseUrl
+  #reader
+  #controller
+  /**
+   * Instantiate a Log Object
+   * @constructor
+   * @param {string} [baseURL] - Protocol, domain, and port for the service.
+   */
+  constructor (baseUrl = BASE_URL) {
+    this.baseUrl = baseUrl
+  }
+
+  /**
+   * End the log stream and stop following logs.
+   */
+  end () {
+    this.#reader?.cancel()
+    this.#controller?.abort()
+  }
+
+  /**
+   * Add a handler for following logs. Note that each invocation of this method
+   * opens a connection to the server and holds it open. Web browsers limit the
+   * number of connections to a single domain. Avoid using this method more than
+   * once per client.
+   * @param {string[]} plugins - Follow logs for the provided Plugin IDs.
+   * @param {string|number} level - Log Level.
+   * @param {function} callback - Invoked with two arguments. The first argument
+   * is an Error object (if an error occurred) or null. The second argument is
+   * an log object.
+   */
+  follow (plugins, level, callback) {
+    let pluginList
+    if (typeof plugins === 'object' && plugins.length > 0) {
+      pluginList = plugins.join(',')
+    } else {
+      throw new Error('Invalid value provided for plugins argument')
+    }
+
+    const logLevel = (typeof level === 'number') ? level : LOG_LEVELS[level]
+
+    if (!logLevel) {
+      throw new Error('Invalid value provided for log level argument')
+    }
+
+    if (typeof callback !== 'function') {
+      throw new Error('Invalid value provided for callback argument')
+    }
+
+    const url = `${this.baseUrl}/plugin/logs/follow?plugins=${pluginList}&level=${logLevel}`
+
+    this.#controller = new AbortController()
+    const signal = this.#controller.signal
+
+    fetch(url, { signal })
+      .then(({ body }) => {
+        let buffer = ''
+        if (!body) {
+          return callback(new Error('No response body'))
+        }
+        const readData = data => {
+          if (!data.done) {
+            callback(null, data.value)
+            this.#reader.read().then(readData).catch(e => callback(e))
+          }
+        }
+        this.#reader = body
+          .pipeThrough(new TextDecoderStream())
+          .pipeThrough(new TransformStream({
+            transform (chunk, controller) {
+              buffer += chunk
+              const parts = buffer.split('\n')
+              parts.slice(0, -1).forEach(part => controller.enqueue(part))
+              buffer = parts[parts.length - 1]
+            },
+            flush (controller) {
+              if (buffer) {
+                controller.enqueue(buffer)
+              }
+            }
+          }))
+          .pipeThrough(new TransformStream({
+            transform (chunk, controller) {
+              controller.enqueue(JSON.parse(chunk))
+            }
+          }))
+          .getReader()
+        this.#reader
+          .read()
+          .then(readData)
+          .catch(e => callback(e))
+      }).catch(e => {
+        // Don't emit an error when aborting the fetch operation
+        if (e.name !== 'AbortError') {
+          callback(e)
+        }
+      })
+  }
+}

package/MockCamera.js

@@ -1,17 +1,17 @@
-import Camera from './Camera.js'
-import { BASE_URL } from './Common.js'
-
-/**
- * MockCamera
- * @classdesc Convenience class for instantiating a Mock Camera Object.
- * Inherits all methods on the {@link Camera} class.
- * @extends Camera
- * @see {@link Camera}
- */
-class MockCamera extends Camera {
-  constructor (baseUrl = BASE_URL) {
-    super('capture_camera_mock', baseUrl)
-  }
-}
-
-export default MockCamera
+import Camera from './Camera.js'
+import { BASE_URL } from './Common.js'
+
+/**
+ * MockCamera
+ * @classdesc Convenience class for instantiating a Mock Camera Object.
+ * Inherits all methods on the {@link Camera} class.
+ * @extends Camera
+ * @see {@link Camera}
+ */
+class MockCamera extends Camera {
+  constructor (baseUrl = BASE_URL) {
+    super('capture_camera_mock', baseUrl)
+  }
+}
+
+export default MockCamera