@shopgate/pwa-core 7.30.0-alpha.7 → 7.30.0-alpha.9

package/classes/Scanner/index.js

@@ -1,69 +1,248 @@
-import _regeneratorRuntime from"@babel/runtime/regenerator";function asyncGeneratorStep(gen,resolve,reject,_next,_throw,key,arg){try{var info=gen[key](arg);var value=info.value;}catch(error){reject(error);return;}if(info.done){resolve(value);}else{Promise.resolve(value).then(_next,_throw);}}function _asyncToGenerator(fn){return function(){var self=this,args=arguments;return new Promise(function(resolve,reject){var gen=fn.apply(self,args);function _next(value){asyncGeneratorStep(gen,resolve,reject,_next,_throw,"next",value);}function _throw(err){asyncGeneratorStep(gen,resolve,reject,_next,_throw,"throw",err);}_next(undefined);});};}function _defineProperties(target,props){for(var i=0;i<props.length;i++){var descriptor=props[i];descriptor.enumerable=descriptor.enumerable||false;descriptor.configurable=true;if("value"in descriptor)descriptor.writable=true;Object.defineProperty(target,descriptor.key,descriptor);}}function _createClass(Constructor,protoProps,staticProps){if(protoProps)_defineProperties(Constructor.prototype,protoProps);if(staticProps)_defineProperties(Constructor,staticProps);return Constructor;}function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor)){throw new TypeError("Cannot call a class as a function");}}function _defineProperty(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true});}else{obj[key]=value;}return obj;}import{logger}from"../../helpers";import{isLibVersionAtLeast}from"../../helpers/version";import ScannerEvent from"../ScannerEvent";import ScannerEventHandler from"../ScannerEventHandler";import appEvent from"../Event";import registerEvents from"../../commands/registerEvents";import{APP_EVENT_SCANNER_DID_SCAN}from"../../constants/AppEvents";import{SCANNER_MODE_ON,SCANNER_TYPE_BARCODE,SCANNER_TYPE_IMAGE,SCANNER_ANIMATION_NONE,SCANNER_MIN_APP_LIB_VERSION}from"../../constants/Scanner";import{openScanner as openAppScanner,startScanner as startAppScanner,stopScanner as stopAppScanner,closeScanner as closeAppScanner,setFlashlightMode as setAppScannerFlashlightMode}from"../../commands/scanner";/**
+import { logger } from "../../helpers";
+import { isLibVersionAtLeast } from "../../helpers/version";
+import ScannerEvent from "../ScannerEvent";
+import ScannerEventHandler from "../ScannerEventHandler";
+import appEvent from "../Event";
+import registerEvents from "../../commands/registerEvents";
+import { APP_EVENT_SCANNER_DID_SCAN } from "../../constants/AppEvents";
+import { SCANNER_MODE_ON, SCANNER_TYPE_BARCODE, SCANNER_TYPE_IMAGE, SCANNER_ANIMATION_NONE, SCANNER_MIN_APP_LIB_VERSION } from "../../constants/Scanner";
+import { openScanner as openAppScanner, startScanner as startAppScanner, stopScanner as stopAppScanner, closeScanner as closeAppScanner, setFlashlightMode as setAppScannerFlashlightMode } from "../../commands/scanner";
+
+/**
  * Represents the app scanner.
- */export var Scanner=/*#__PURE__*/_createClass(/**
+ */
+export class Scanner {
+  /**
    * Initializes the scanner
-   */function Scanner(){var _this=this;_classCallCheck(this,Scanner);/**
-   * Reset Scanner state
-   */_defineProperty(this,"reset",function(){_this.scope=null;_this.type=null;_this.opened=false;_this.running=false;_this.handling=false;_this.flashlightEnabled=false;_this.closeHandler=null;});/**
-   * Adds an event listener to the scanner.
-   * @param {ScannerEventListener} eventListener The eventListener to add.
-   */_defineProperty(this,"addListener",function(eventListener){_this.eventHandler.attach(eventListener);});/**
-   * @param {ScannerEventListener} eventListener The event listener to remove.
-   * @returns {boolean} Returns false if the listener was not found by id. Returns true otherwise.
-   */_defineProperty(this,"removeListener",function(eventListener){return _this.eventHandler.detach(eventListener);});/**
-   * Callback for the close handler for the scanner. The scanner stops scanning and notifies
-   * the close handler when it's done. The close handler can either shut down the Scanner instance
-   * by calling its close() method or restart it to continue scanning.
-   *
-   * @callback Scanner~CloseHandler
-   * @param {Scanner} scannerInstance The instance of the scanner which requested closing.
-   * @returns {undefined|null} The return value is ignored.
-   */ /**
-   * Starts the app scanner. It will instantly start the scanning process for type
-   * "barcodeRecognition". The image scanner requires user interaction to scan.
-   * @param {string} scope The initially activated scanner scope.
-   * @param {ScannerType|string} type The initially activated scanner type.
-   * @param {CloseHandler|null} [closeHandler] This handler is called when the Scanner is closed.
-   * @param {string|null} [source] Tells the app which overlay to use, null for "current".
-   * @param {string|null} [animation] Tells the app what type of animation to apply when opening.
-   */_defineProperty(this,"open",/*#__PURE__*/function(){var _ref=_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(scope){var type,closeHandler,source,animation,errMsgPrefix,libVersionResult,err,_err,_err2,_err3,_err4,_args=arguments;return _regeneratorRuntime.wrap(function _callee$(_context){while(1)switch(_context.prev=_context.next){case 0:type=_args.length>1&&_args[1]!==undefined?_args[1]:SCANNER_TYPE_BARCODE;closeHandler=_args.length>2&&_args[2]!==undefined?_args[2]:null;source=_args.length>3&&_args[3]!==undefined?_args[3]:null;animation=_args.length>4&&_args[4]!==undefined?_args[4]:null;errMsgPrefix='Failed to open scanner:';// A minimum app lib version is required, which is defined above.
-_context.prev=5;_context.next=8;return isLibVersionAtLeast(SCANNER_MIN_APP_LIB_VERSION);case 8:libVersionResult=_context.sent;_context.next=15;break;case 11:_context.prev=11;_context.t0=_context["catch"](5);logger.error("".concat(errMsgPrefix," Could not fetch app lib version. Instead received error:"),_context.t0);return _context.abrupt("return");case 15:if(libVersionResult){_context.next=19;break;}err=new Error("".concat(errMsgPrefix," App lib version must be at least equal to or higher than ").concat(SCANNER_MIN_APP_LIB_VERSION,"."));logger.error(err);return _context.abrupt("return");case 19:if(!(!scope||scope==='')){_context.next=23;break;}_err=new Error("".concat(errMsgPrefix," Scope can not be empty."));logger.error(_err);return _context.abrupt("return");case 23:if(_this.supportedTypes.includes(type)){_context.next=27;break;}_err2=new Error("".concat(errMsgPrefix," ").concat(type," is a not supported scanner type."));logger.error(_err2);return _context.abrupt("return");case 27:if(!_this.opened){_context.next=31;break;}_err3=new Error("".concat(errMsgPrefix," An instance with scope \"").concat(_this.scope,"\" is already running."));logger.error(_err3);return _context.abrupt("return");case 31:if(!(closeHandler!==null&&typeof closeHandler!=='function')){_context.next=35;break;}_err4=new Error("".concat(errMsgPrefix," Close handler must be a function."));logger.error(_err4);return _context.abrupt("return");case 35:// Add a listener to the scannerDidScan app event to process scanned data.
-appEvent.addCallback(APP_EVENT_SCANNER_DID_SCAN,_this.handleScan);// Open the app scanner.
-openAppScanner({src:source||'',modes:_defineProperty({},type,SCANNER_MODE_ON),animation:animation||SCANNER_ANIMATION_NONE});// Initialize internal states
-_this.scope=scope;_this.type=type;_this.opened=true;// Image scanner does not automatically scan
-_this.running=_this.type!==SCANNER_TYPE_IMAGE;_this.closeHandler=closeHandler||null;case 42:case"end":return _context.stop();}},_callee,null,[[5,11]]);}));return function(_x){return _ref.apply(this,arguments);};}());/**
-   * Starts the Scanner if it is opened and not already running.
-   */_defineProperty(this,"start",function(){if(!_this.opened){logger.error(new Error("Can't start Scanner: Scanner is not opened."));return;}_this.handling=false;// Start only if not already running.
-if(!_this.running){_this.running=true;startAppScanner();}});/**
-   * Stops the scanner if it is opened and running.
-   */_defineProperty(this,"stop",function(){if(!_this.opened){logger.error(new Error("Can't start Scanner: Scanner is not opened."));return;}// Stop only if is running at the moment.
-if(_this.isRunning){_this.running=false;stopAppScanner();}});/**
-   * Close the app scanner.
-   */_defineProperty(this,"close",function(){if(!_this.opened){logger.warn("Can't close Scanner: Scanner is not opened.");return;}// Remove the listener to avoid further scan results.
-appEvent.removeCallback(APP_EVENT_SCANNER_DID_SCAN,_this.handleScan);// Switch off flashlight to make sure it does not stay enabled.
-_this.toggleFlashlight(false);closeAppScanner();_this.reset();});/**
-   * Switches between the flashlight being on or off. The return result might not always
-   * be reliable when the app is brought into the background or if other apps interfere.
-   * Can only be toggled when the scanner is opened.
-   * @param {boolean|undefined} [enable] True/false to switch on/off or leave out for toggle.
-   * @returns {boolean} Returns the new flashlight on/off state.
-   */_defineProperty(this,"toggleFlashlight",function(){var enable=arguments.length>0&&arguments[0]!==undefined?arguments[0]:undefined;if(!_this.opened){logger.error(new Error("Can't toggle the flashlight: Scanner not opened!"));return false;}if(enable!==undefined){_this.flashlightEnabled=!!enable;}else{_this.flashlightEnabled=!_this.flashlightEnabled;}setAppScannerFlashlightMode(_this.flashlightEnabled);return _this.flashlightEnabled;});/**
-   * Because opening the scanner can fail silently, this is a way to check if it was
-   * opened properly.
-   * @returns {boolean}
-   */_defineProperty(this,"isOpened",function(){return _this.opened;});/**
-   * Some scanner types don't start and all of them stop running after a successful scan.
-   * This method allows checking if a scan is currently in progress.
-   * @returns {boolean}
-   */_defineProperty(this,"isRunning",function(){return _this.running;});/**
-   * Helps checking the current state of the flashlight. This might not be reliable as the
-   * flashlight is turned off without notice, when the app is pushed into the background.
-   * @returns {boolean}
-   */_defineProperty(this,"isFlashlightEnabled",function(){return _this.flashlightEnabled;});/**
-   * The internal handler for the "scannerDidScan" app event.
-   * @private
-   * @param {ScannerEventPayload} payload The payload of the scanner event for the scanned result.
-   */_defineProperty(this,"handleScan",/*#__PURE__*/function(){var _ref2=_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2(payload){var event;return _regeneratorRuntime.wrap(function _callee2$(_context2){while(1)switch(_context2.prev=_context2.next){case 0:event=new ScannerEvent(_this.scope,_this.type,payload);if(_this.eventHandler.hasListenersForEvent(event)){_context2.next=4;break;}logger.warn('No scanner listeners',payload);return _context2.abrupt("return");case 4:if(!_this.handling){_context2.next=7;break;}logger.warn('Scan result ignored in handling stage',payload);return _context2.abrupt("return");case 7:_this.handling=true;_this.stop();_context2.prev=9;_context2.next=12;return _this.eventHandler.notifyAllListeners(event);case 12:// Notify the close handler that the Scanner is done doing his work.
-if(_this.closeHandler){_this.closeHandler(_this);}_context2.next=19;break;case 15:_context2.prev=15;_context2.t0=_context2["catch"](9);logger.warn('Scan handler threw error:',_context2.t0);// Force restart when a handler throws an error.
-_this.start();case 19:case"end":return _context2.stop();}},_callee2,null,[[9,15]]);}));return function(_x2){return _ref2.apply(this,arguments);};}());this.supportedTypes=[SCANNER_TYPE_BARCODE,SCANNER_TYPE_IMAGE];this.eventHandler=new ScannerEventHandler();// Register app scan event to listen for.
-registerEvents([APP_EVENT_SCANNER_DID_SCAN]);this.reset();});export default new Scanner();
+   */
+  constructor() {
+    /**
+     * Reset Scanner state
+     */
+    this.reset = () => {
+      this.scope = null;
+      this.type = null;
+      this.opened = false;
+      this.running = false;
+      this.handling = false;
+      this.flashlightEnabled = false;
+      this.closeHandler = null;
+    };
+    /**
+     * Adds an event listener to the scanner.
+     * @param {ScannerEventListener} eventListener The eventListener to add.
+     */
+    this.addListener = eventListener => {
+      this.eventHandler.attach(eventListener);
+    };
+    /**
+     * @param {ScannerEventListener} eventListener The event listener to remove.
+     * @returns {boolean} Returns false if the listener was not found by id. Returns true otherwise.
+     */
+    this.removeListener = eventListener => this.eventHandler.detach(eventListener);
+    /**
+     * Callback for the close handler for the scanner. The scanner stops scanning and notifies
+     * the close handler when it's done. The close handler can either shut down the Scanner instance
+     * by calling its close() method or restart it to continue scanning.
+     *
+     * @callback Scanner~CloseHandler
+     * @param {Scanner} scannerInstance The instance of the scanner which requested closing.
+     * @returns {undefined|null} The return value is ignored.
+     */
+    /**
+     * Starts the app scanner. It will instantly start the scanning process for type
+     * "barcodeRecognition". The image scanner requires user interaction to scan.
+     * @param {string} scope The initially activated scanner scope.
+     * @param {ScannerType|string} type The initially activated scanner type.
+     * @param {CloseHandler|null} [closeHandler] This handler is called when the Scanner is closed.
+     * @param {string|null} [source] Tells the app which overlay to use, null for "current".
+     * @param {string|null} [animation] Tells the app what type of animation to apply when opening.
+     */
+    this.open = async (scope, type = SCANNER_TYPE_BARCODE, closeHandler = null, source = null, animation = null) => {
+      const errMsgPrefix = 'Failed to open scanner:';
+
+      // A minimum app lib version is required, which is defined above.
+      let libVersionResult;
+      try {
+        libVersionResult = await isLibVersionAtLeast(SCANNER_MIN_APP_LIB_VERSION);
+      } catch (err) {
+        logger.error(`${errMsgPrefix} Could not fetch app lib version. Instead received error:`, err);
+        return;
+      }
+      if (!libVersionResult) {
+        const err = new Error(`${errMsgPrefix} App lib version must be at least equal to or higher than ${SCANNER_MIN_APP_LIB_VERSION}.`);
+        logger.error(err);
+        return;
+      }
+
+      // Make sure the scope was properly set
+      if (!scope || scope === '') {
+        const err = new Error(`${errMsgPrefix} Scope can not be empty.`);
+        logger.error(err);
+        return;
+      }
+      if (!this.supportedTypes.includes(type)) {
+        const err = new Error(`${errMsgPrefix} ${type} is a not supported scanner type.`);
+        logger.error(err);
+        return;
+      }
+
+      // Only one instance can be running at the same time.
+      if (this.opened) {
+        const err = new Error(`${errMsgPrefix} An instance with scope "${this.scope}" is already running.`);
+        logger.error(err);
+        return;
+      }
+      if (closeHandler !== null && typeof closeHandler !== 'function') {
+        const err = new Error(`${errMsgPrefix} Close handler must be a function.`);
+        logger.error(err);
+        return;
+      }
+
+      // Add a listener to the scannerDidScan app event to process scanned data.
+      appEvent.addCallback(APP_EVENT_SCANNER_DID_SCAN, this.handleScan);
+
+      // Open the app scanner.
+      openAppScanner({
+        src: source || '',
+        modes: {
+          [type]: SCANNER_MODE_ON
+        },
+        animation: animation || SCANNER_ANIMATION_NONE
+      });
+
+      // Initialize internal states
+      this.scope = scope;
+      this.type = type;
+      this.opened = true;
+
+      // Image scanner does not automatically scan
+      this.running = this.type !== SCANNER_TYPE_IMAGE;
+      this.closeHandler = closeHandler || null;
+    };
+    /**
+     * Starts the Scanner if it is opened and not already running.
+     */
+    this.start = () => {
+      if (!this.opened) {
+        logger.error(new Error("Can't start Scanner: Scanner is not opened."));
+        return;
+      }
+      this.handling = false;
+
+      // Start only if not already running.
+      if (!this.running) {
+        this.running = true;
+        startAppScanner();
+      }
+    };
+    /**
+     * Stops the scanner if it is opened and running.
+     */
+    this.stop = () => {
+      if (!this.opened) {
+        logger.error(new Error("Can't start Scanner: Scanner is not opened."));
+        return;
+      }
+
+      // Stop only if is running at the moment.
+      if (this.isRunning) {
+        this.running = false;
+        stopAppScanner();
+      }
+    };
+    /**
+     * Close the app scanner.
+     */
+    this.close = () => {
+      if (!this.opened) {
+        logger.warn("Can't close Scanner: Scanner is not opened.");
+        return;
+      }
+
+      // Remove the listener to avoid further scan results.
+      appEvent.removeCallback(APP_EVENT_SCANNER_DID_SCAN, this.handleScan);
+
+      // Switch off flashlight to make sure it does not stay enabled.
+      this.toggleFlashlight(false);
+      closeAppScanner();
+      this.reset();
+    };
+    /**
+     * Switches between the flashlight being on or off. The return result might not always
+     * be reliable when the app is brought into the background or if other apps interfere.
+     * Can only be toggled when the scanner is opened.
+     * @param {boolean|undefined} [enable] True/false to switch on/off or leave out for toggle.
+     * @returns {boolean} Returns the new flashlight on/off state.
+     */
+    this.toggleFlashlight = (enable = undefined) => {
+      if (!this.opened) {
+        logger.error(new Error("Can't toggle the flashlight: Scanner not opened!"));
+        return false;
+      }
+      if (enable !== undefined) {
+        this.flashlightEnabled = !!enable;
+      } else {
+        this.flashlightEnabled = !this.flashlightEnabled;
+      }
+      setAppScannerFlashlightMode(this.flashlightEnabled);
+      return this.flashlightEnabled;
+    };
+    /**
+     * Because opening the scanner can fail silently, this is a way to check if it was
+     * opened properly.
+     * @returns {boolean}
+     */
+    this.isOpened = () => this.opened;
+    /**
+     * Some scanner types don't start and all of them stop running after a successful scan.
+     * This method allows checking if a scan is currently in progress.
+     * @returns {boolean}
+     */
+    this.isRunning = () => this.running;
+    /**
+     * Helps checking the current state of the flashlight. This might not be reliable as the
+     * flashlight is turned off without notice, when the app is pushed into the background.
+     * @returns {boolean}
+     */
+    this.isFlashlightEnabled = () => this.flashlightEnabled;
+    /**
+     * The internal handler for the "scannerDidScan" app event.
+     * @private
+     * @param {ScannerEventPayload} payload The payload of the scanner event for the scanned result.
+     */
+    this.handleScan = async payload => {
+      const event = new ScannerEvent(this.scope, this.type, payload);
+      if (!this.eventHandler.hasListenersForEvent(event)) {
+        logger.warn('No scanner listeners', payload);
+        return;
+      }
+      if (this.handling) {
+        logger.warn('Scan result ignored in handling stage', payload);
+        return;
+      }
+      this.handling = true;
+      this.stop();
+      try {
+        // Ignore return values from handlers.
+        await this.eventHandler.notifyAllListeners(event);
+
+        // Notify the close handler that the Scanner is done doing his work.
+        if (this.closeHandler) {
+          this.closeHandler(this);
+        }
+      } catch (error) {
+        logger.warn('Scan handler threw error:', error);
+        // Force restart when a handler throws an error.
+        this.start();
+      }
+    };
+    this.supportedTypes = [SCANNER_TYPE_BARCODE, SCANNER_TYPE_IMAGE];
+    this.eventHandler = new ScannerEventHandler();
+
+    // Register app scan event to listen for.
+    registerEvents([APP_EVENT_SCANNER_DID_SCAN]);
+    this.reset();
+  }
+}
+export default new Scanner();

package/classes/ScannerEvent/index.js

@@ -1,17 +1,31 @@
-function _defineProperties(target,props){for(var i=0;i<props.length;i++){var descriptor=props[i];descriptor.enumerable=descriptor.enumerable||false;descriptor.configurable=true;if("value"in descriptor)descriptor.writable=true;Object.defineProperty(target,descriptor.key,descriptor);}}function _createClass(Constructor,protoProps,staticProps){if(protoProps)_defineProperties(Constructor.prototype,protoProps);if(staticProps)_defineProperties(Constructor,staticProps);return Constructor;}function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor)){throw new TypeError("Cannot call a class as a function");}}function _defineProperty(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true});}else{obj[key]=value;}return obj;}/**
+/**
  * @typedef {Object} ScannerEventPayload
  * @property {string} format
  * @property {string} code
  *
  * Defines an event which is emitted when the scanner scans something.
- */var ScannerEvent=/*#__PURE__*/_createClass(/**
+ */
+export default class ScannerEvent {
+  /**
    * @param {string} scope The scanner instance, that was running when this event was emitted.
    * @param {string} type The type of scanner that produced this result.
    * @param {ScannerEventPayload} payload The payload of the scan result.
-   */function ScannerEvent(scope,type,payload){var _this=this;_classCallCheck(this,ScannerEvent);/**
-   * @returns {string}
-   */_defineProperty(this,"getScope",function(){return _this.scope;});/**
-   * @returns {string}
-   */_defineProperty(this,"getType",function(){return _this.type;});/**
-   * @returns {ScannerEventPayload}
-   */_defineProperty(this,"getPayload",function(){return _this.payload;});this.scope=scope;this.type=type;this.payload=payload;});export{ScannerEvent as default};
+   */
+  constructor(scope, type, payload) {
+    /**
+     * @returns {string}
+     */
+    this.getScope = () => this.scope;
+    /**
+     * @returns {string}
+     */
+    this.getType = () => this.type;
+    /**
+     * @returns {ScannerEventPayload}
+     */
+    this.getPayload = () => this.payload;
+    this.scope = scope;
+    this.type = type;
+    this.payload = payload;
+  }
+}

package/classes/ScannerEventHandler/index.js

@@ -1,18 +1,41 @@
-function _defineProperties(target,props){for(var i=0;i<props.length;i++){var descriptor=props[i];descriptor.enumerable=descriptor.enumerable||false;descriptor.configurable=true;if("value"in descriptor)descriptor.writable=true;Object.defineProperty(target,descriptor.key,descriptor);}}function _createClass(Constructor,protoProps,staticProps){if(protoProps)_defineProperties(Constructor.prototype,protoProps);if(staticProps)_defineProperties(Constructor,staticProps);return Constructor;}function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor)){throw new TypeError("Cannot call a class as a function");}}function _defineProperty(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true});}else{obj[key]=value;}return obj;}/**
+/**
  * Manages scanner event listeners.
- */var ScannerEventHandler=/*#__PURE__*/_createClass(/**
+ */
+export default class ScannerEventHandler {
+  /**
    * Initializes the event handler.
-   */function ScannerEventHandler(){var _this=this;_classCallCheck(this,ScannerEventHandler);/**
-   * @param {ScannerEventListener} eventListener The event listener to attach to the handler.
-   */_defineProperty(this,"attach",function(eventListener){_this.eventListeners.add(eventListener);});/**
-   * @param {ScannerEventListener} eventListener The event listener to detach from the handler.
-   * @returns {boolean} Returns true if the event listener was detached successfully.
-   */_defineProperty(this,"detach",function(eventListener){return _this.eventListeners["delete"](eventListener);});/**
-   * @param {ScannerEvent} event The event which has been emitted by the scanner.
-   * @returns {boolean}
-   */_defineProperty(this,"hasListenersForEvent",function(event){return Array.from(_this.eventListeners).some(function(listener){return listener.canHandleEvent(event);});});/**
-   * @param {ScannerEvent} event The event which has been emitted by the scanner.
-   * @returns {Promise<undefined>}
-   * @throws {Error}
-   */_defineProperty(this,"notifyAllListeners",function(event){var notifyResults=[];_this.eventListeners.forEach(function(listener){notifyResults.push(listener.notify(event));});// Forward occurring errors only, because there should be no return value from "notify"
-return Promise.all(notifyResults).then(function(){});});this.eventListeners=new Set();});export{ScannerEventHandler as default};
+   */
+  constructor() {
+    /**
+     * @param {ScannerEventListener} eventListener The event listener to attach to the handler.
+     */
+    this.attach = eventListener => {
+      this.eventListeners.add(eventListener);
+    };
+    /**
+     * @param {ScannerEventListener} eventListener The event listener to detach from the handler.
+     * @returns {boolean} Returns true if the event listener was detached successfully.
+     */
+    this.detach = eventListener => this.eventListeners.delete(eventListener);
+    /**
+     * @param {ScannerEvent} event The event which has been emitted by the scanner.
+     * @returns {boolean}
+     */
+    this.hasListenersForEvent = event => Array.from(this.eventListeners).some(listener => listener.canHandleEvent(event));
+    /**
+     * @param {ScannerEvent} event The event which has been emitted by the scanner.
+     * @returns {Promise<undefined>}
+     * @throws {Error}
+     */
+    this.notifyAllListeners = event => {
+      const notifyResults = [];
+      this.eventListeners.forEach(listener => {
+        notifyResults.push(listener.notify(event));
+      });
+
+      // Forward occurring errors only, because there should be no return value from "notify"
+      return Promise.all(notifyResults).then(() => {});
+    };
+    this.eventListeners = new Set();
+  }
+}

package/classes/ScannerEventListener/index.js

@@ -1,29 +1,89 @@
-import _regeneratorRuntime from"@babel/runtime/regenerator";function asyncGeneratorStep(gen,resolve,reject,_next,_throw,key,arg){try{var info=gen[key](arg);var value=info.value;}catch(error){reject(error);return;}if(info.done){resolve(value);}else{Promise.resolve(value).then(_next,_throw);}}function _asyncToGenerator(fn){return function(){var self=this,args=arguments;return new Promise(function(resolve,reject){var gen=fn.apply(self,args);function _next(value){asyncGeneratorStep(gen,resolve,reject,_next,_throw,"next",value);}function _throw(err){asyncGeneratorStep(gen,resolve,reject,_next,_throw,"throw",err);}_next(undefined);});};}function _defineProperties(target,props){for(var i=0;i<props.length;i++){var descriptor=props[i];descriptor.enumerable=descriptor.enumerable||false;descriptor.configurable=true;if("value"in descriptor)descriptor.writable=true;Object.defineProperty(target,descriptor.key,descriptor);}}function _createClass(Constructor,protoProps,staticProps){if(protoProps)_defineProperties(Constructor.prototype,protoProps);if(staticProps)_defineProperties(Constructor,staticProps);return Constructor;}function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor)){throw new TypeError("Cannot call a class as a function");}}function _defineProperty(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true});}else{obj[key]=value;}return obj;}import{logger}from"../../helpers";import AppScanner from"../Scanner";/**
+import { logger } from "../../helpers";
+import AppScanner from "../Scanner";
+
+/**
  * Allows anyone to listen for scan results based on scope, type or both.
- */var ScannerEventListener=/*#__PURE__*/_createClass(/**
+ */
+class ScannerEventListener {
+  /**
    * @param {string|null} name A name for the listener object to refer to.
    * @param {string|null} scope The scanner scope to listen for.
    * @param {string|null} type THe type of scanner events to listen for.
    * @param {Array} formats The formats which can be processed by the listener.
-   */function ScannerEventListener(){var _this=this;var name=arguments.length>0&&arguments[0]!==undefined?arguments[0]:null;var scope=arguments.length>1&&arguments[1]!==undefined?arguments[1]:null;var type=arguments.length>2&&arguments[2]!==undefined?arguments[2]:null;var formats=arguments.length>3&&arguments[3]!==undefined?arguments[3]:[];_classCallCheck(this,ScannerEventListener);/**
-   * Callback for an instance of an event listener. It is expected to return no value on success.
-   * Throw an Error() to force the scanner to restart.
-   *
-   * @callback ScannerEventListener~Handler
-   * @param {ScannerEvent} event The event which is emitted, when something was scanned.
-   * @returns {undefined|null} The return value is ignored. Returning a value will cause a warning.
-   * @throws {Error} Throwing an error will cause the Scanner to restart and scan again.
-   */ /**
-   * @param {Handler} handler The function which is called when a scan is done.
-   * @returns {ScannerEventListener}
-   */_defineProperty(this,"setHandler",function(handler){if(typeof handler!=='function'){logger.error(new Error('The ScannerEventListener handler must be a function!'));}_this.handler=handler;return _this;});/**
-   * Checks if the event fits to the handler.
-   * @param {ScannerEvent} event The scanner event which was emitted.
-   * @returns {boolean}
-   */_defineProperty(this,"canHandleEvent",function(event){if(!_this.handler){logger.warn("No event handler defined for eventListener \"".concat(_this.name,"\""));return false;}if(_this.type&&_this.type!==event.getType()){return false;}if(_this.scope&&_this.scope!==event.getScope()){return false;}var _ref=event.getPayload()||{},format=_ref.format;if(_this.formats.length&&!_this.formats.includes(format)){return false;}return true;});/**
-   * Attach the current event listener to the app scanner.
-   */_defineProperty(this,"attach",function(){AppScanner.addListener(_this);});/**
-   * Checks the event to see, if the listener is interested in it and call it's handler.
-   * @param {ScannerEvent} event The scanner event which was emitted.
-   */_defineProperty(this,"notify",/*#__PURE__*/function(){var _ref2=_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(event){var handlerResult;return _regeneratorRuntime.wrap(function _callee$(_context){while(1)switch(_context.prev=_context.next){case 0:if(_this.canHandleEvent(event)){_context.next=2;break;}return _context.abrupt("return");case 2:_context.next=4;return _this.handler(event);case 4:handlerResult=_context.sent;// Don't expect anything else than undefined or null
-if(handlerResult!==undefined&&handlerResult!==null){logger.warn("Expected the ScannerEventListener::Handler \"".concat(_this.name,"\" to return no value,"),"but it returned \"".concat(handlerResult,"\""));}case 6:case"end":return _context.stop();}},_callee);}));return function(_x){return _ref2.apply(this,arguments);};}());this.name=name||'unnamed';this.scope=scope||null;this.type=type||null;this.formats=formats||[];this.handler=null;});export default ScannerEventListener;
+   */
+  constructor(name = null, scope = null, type = null, formats = []) {
+    /**
+     * Callback for an instance of an event listener. It is expected to return no value on success.
+     * Throw an Error() to force the scanner to restart.
+     *
+     * @callback ScannerEventListener~Handler
+     * @param {ScannerEvent} event The event which is emitted, when something was scanned.
+     * @returns {undefined|null} The return value is ignored. Returning a value will cause a warning.
+     * @throws {Error} Throwing an error will cause the Scanner to restart and scan again.
+     */
+    /**
+     * @param {Handler} handler The function which is called when a scan is done.
+     * @returns {ScannerEventListener}
+     */
+    this.setHandler = handler => {
+      if (typeof handler !== 'function') {
+        logger.error(new Error('The ScannerEventListener handler must be a function!'));
+      }
+      this.handler = handler;
+      return this;
+    };
+    /**
+     * Checks if the event fits to the handler.
+     * @param {ScannerEvent} event The scanner event which was emitted.
+     * @returns {boolean}
+     */
+    this.canHandleEvent = event => {
+      if (!this.handler) {
+        logger.warn(`No event handler defined for eventListener "${this.name}"`);
+        return false;
+      }
+      if (this.type && this.type !== event.getType()) {
+        return false;
+      }
+      if (this.scope && this.scope !== event.getScope()) {
+        return false;
+      }
+      const {
+        format
+      } = event.getPayload() || {};
+      if (this.formats.length && !this.formats.includes(format)) {
+        return false;
+      }
+      return true;
+    };
+    /**
+     * Attach the current event listener to the app scanner.
+     */
+    this.attach = () => {
+      AppScanner.addListener(this);
+    };
+    /**
+     * Checks the event to see, if the listener is interested in it and call it's handler.
+     * @param {ScannerEvent} event The scanner event which was emitted.
+     */
+    this.notify = async event => {
+      if (!this.canHandleEvent(event)) {
+        return;
+      }
+
+      // Call the listener which was previously registered
+      const handlerResult = await this.handler(event);
+
+      // Don't expect anything else than undefined or null
+      if (handlerResult !== undefined && handlerResult !== null) {
+        logger.warn(`Expected the ScannerEventListener::Handler "${this.name}" to return no value,`, `but it returned "${handlerResult}"`);
+      }
+    };
+    this.name = name || 'unnamed';
+    this.scope = scope || null;
+    this.type = type || null;
+    this.formats = formats || [];
+    this.handler = null;
+  }
+}
+export default ScannerEventListener;

package/classes/ScannerManager/ScanProcessingError.js

@@ -1,9 +1,17 @@
-function _typeof(obj){if(typeof Symbol==="function"&&typeof Symbol.iterator==="symbol"){_typeof=function _typeof(obj){return typeof obj;};}else{_typeof=function _typeof(obj){return obj&&typeof Symbol==="function"&&obj.constructor===Symbol&&obj!==Symbol.prototype?"symbol":typeof obj;};}return _typeof(obj);}function _defineProperties(target,props){for(var i=0;i<props.length;i++){var descriptor=props[i];descriptor.enumerable=descriptor.enumerable||false;descriptor.configurable=true;if("value"in descriptor)descriptor.writable=true;Object.defineProperty(target,descriptor.key,descriptor);}}function _createClass(Constructor,protoProps,staticProps){if(protoProps)_defineProperties(Constructor.prototype,protoProps);if(staticProps)_defineProperties(Constructor,staticProps);return Constructor;}function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor)){throw new TypeError("Cannot call a class as a function");}}function _callSuper(_this,derived,args){function isNativeReflectConstruct(){if(typeof Reflect==="undefined"||!Reflect.construct)return false;if(Reflect.construct.sham)return false;if(typeof Proxy==="function")return true;try{return!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}));}catch(e){return false;}}derived=_getPrototypeOf(derived);return _possibleConstructorReturn(_this,isNativeReflectConstruct()?Reflect.construct(derived,args||[],_getPrototypeOf(_this).constructor):derived.apply(_this,args));}function _possibleConstructorReturn(self,call){if(call&&(_typeof(call)==="object"||typeof call==="function")){return call;}return _assertThisInitialized(self);}function _assertThisInitialized(self){if(self===void 0){throw new ReferenceError("this hasn't been initialised - super() hasn't been called");}return self;}function _inherits(subClass,superClass){if(typeof superClass!=="function"&&superClass!==null){throw new TypeError("Super expression must either be null or a function");}subClass.prototype=Object.create(superClass&&superClass.prototype,{constructor:{value:subClass,writable:true,configurable:true}});if(superClass)_setPrototypeOf(subClass,superClass);}function _wrapNativeSuper(Class){var _cache=typeof Map==="function"?new Map():undefined;_wrapNativeSuper=function _wrapNativeSuper(Class){if(Class===null||!_isNativeFunction(Class))return Class;if(typeof Class!=="function"){throw new TypeError("Super expression must either be null or a function");}if(typeof _cache!=="undefined"){if(_cache.has(Class))return _cache.get(Class);_cache.set(Class,Wrapper);}function Wrapper(){return _construct(Class,arguments,_getPrototypeOf(this).constructor);}Wrapper.prototype=Object.create(Class.prototype,{constructor:{value:Wrapper,enumerable:false,writable:true,configurable:true}});return _setPrototypeOf(Wrapper,Class);};return _wrapNativeSuper(Class);}function isNativeReflectConstruct(){if(typeof Reflect==="undefined"||!Reflect.construct)return false;if(Reflect.construct.sham)return false;if(typeof Proxy==="function")return true;try{Date.prototype.toString.call(Reflect.construct(Date,[],function(){}));return true;}catch(e){return false;}}function _construct(Parent,args,Class){if(isNativeReflectConstruct()){_construct=Reflect.construct;}else{_construct=function _construct(Parent,args,Class){var a=[null];a.push.apply(a,args);var Constructor=Function.bind.apply(Parent,a);var instance=new Constructor();if(Class)_setPrototypeOf(instance,Class.prototype);return instance;};}return _construct.apply(null,arguments);}function _isNativeFunction(fn){return Function.toString.call(fn).indexOf("[native code]")!==-1;}function _setPrototypeOf(o,p){_setPrototypeOf=Object.setPrototypeOf||function _setPrototypeOf(o,p){o.__proto__=p;return o;};return _setPrototypeOf(o,p);}function _getPrototypeOf(o){_getPrototypeOf=Object.setPrototypeOf?Object.getPrototypeOf:function _getPrototypeOf(o){return o.__proto__||Object.getPrototypeOf(o);};return _getPrototypeOf(o);}/**
+/**
  * The ScanProcessingError is supposed to be thrown in case of a processing error of the scanned
  * content. It's properties will be used to display an error message to the user.
  * @extends Error
- */var ScanProcessingError=/*#__PURE__*/function(_Error){/**
+ */
+class ScanProcessingError extends Error {
+  /**
    * Constructor for the ScanProcessingError
    * @param {string} message The message of the error.
    * @param {string} [title=null] The title of the error.
-   */function ScanProcessingError(message){var _this2;var title=arguments.length>1&&arguments[1]!==undefined?arguments[1]:null;_classCallCheck(this,ScanProcessingError);_this2=_callSuper(this,ScanProcessingError,[message]);_this2.title=title;return _this2;}_inherits(ScanProcessingError,_Error);return _createClass(ScanProcessingError);}(/*#__PURE__*/_wrapNativeSuper(Error));export default ScanProcessingError;
+   */
+  constructor(message, title = null) {
+    super(message);
+    this.title = title;
+  }
+}
+export default ScanProcessingError;