node-web-audio-api 0.14.0 → 0.15.0

package/js/DelayNode.js

@@ -0,0 +1,52 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativeDelayNode) => {
+
+  const EventTarget = EventTargetMixin(NativeDelayNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class DelayNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+      this.delayTime = new AudioParam(this.delayTime);
+    }
+
+    // getters
+
+    // setters
+
+    // methods
+    
+  }
+
+  return DelayNode;
+};
+
+
+  

package/js/DynamicsCompressorNode.js

@@ -0,0 +1,60 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativeDynamicsCompressorNode) => {
+
+  const EventTarget = EventTargetMixin(NativeDynamicsCompressorNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class DynamicsCompressorNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+      this.threshold = new AudioParam(this.threshold);
+      this.knee = new AudioParam(this.knee);
+      this.ratio = new AudioParam(this.ratio);
+      this.attack = new AudioParam(this.attack);
+      this.release = new AudioParam(this.release);
+    }
+
+    // getters
+
+    get reduction() {
+      return super.reduction;
+    }
+
+    // setters
+
+    // methods
+    
+  }
+
+  return DynamicsCompressorNode;
+};
+
+
+  

package/js/EventTarget.mixin.js

@@ -0,0 +1,59 @@
+const { isFunction } = require('./lib/utils.js');
+
+const kEventListeners = Symbol('node-web-audio-api:event-listeners');
+const kDispatchEvent = Symbol.for('node-web-audio-api:napi-dispatch-event');
+
+module.exports = (superclass, eventTypes = []) => class EventTarget extends superclass {
+  [kEventListeners] = new Map();
+
+  constructor(...args) {
+    super(...args);
+
+    eventTypes.forEach((eventType) => {
+      this[`on${eventType}`] = null;
+    });
+
+    // we need to bind because calling [kDispatchEvent] from rust loose `this`
+    this[kDispatchEvent] = this[kDispatchEvent].bind(this);
+  }
+
+  // instance might
+  addEventListener(eventType, callback) {
+    if (!this[kEventListeners].has(eventType)) {
+      this[kEventListeners].set(eventType, new Set());
+    }
+
+    const callbacks = this[kEventListeners].get(eventType);
+    callbacks.add(callback);
+  }
+
+  removeEventListener(eventType, callback) {
+    // this is valid event eventType, otherwaise just ignore
+    if (this[kEventListeners].has(eventType)) {
+      const callbacks = this[kEventListeners].get(eventType);
+      callbacks.delete(callback);
+    }
+  }
+
+  dispatchEvent(event) {
+    if (isFunction(this[`on${event.type}`])) {
+      this[`on${event.type}`](event);
+    }
+
+    if (this[kEventListeners].has(event.type)) {
+      const callbacks = this[kEventListeners].get(event.type);
+      callbacks.forEach(callback => callback(event));
+    }
+  }
+
+  // called from rust
+  [kDispatchEvent](err, eventType) {
+    const event = new Event(eventType);
+    // cannot override, this would need to derive EventTarget
+    // cf. https://www.nearform.com/blog/node-js-and-the-struggles-of-being-an-eventtarget/
+    // event.target = this;
+    // event.currentTarget = this;
+    // event.srcElement = this;
+    this.dispatchEvent(event);
+  }
+};

package/js/GainNode.js

@@ -0,0 +1,52 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativeGainNode) => {
+
+  const EventTarget = EventTargetMixin(NativeGainNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class GainNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+      this.gain = new AudioParam(this.gain);
+    }
+
+    // getters
+
+    // setters
+
+    // methods
+    
+  }
+
+  return GainNode;
+};
+
+
+  

package/js/IIRFilterNode.js

@@ -0,0 +1,59 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativeIIRFilterNode) => {
+
+  const EventTarget = EventTargetMixin(NativeIIRFilterNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class IIRFilterNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+    }
+
+    // getters
+
+    // setters
+
+    // methods
+    
+    getFrequencyResponse(...args) {
+      try {
+        return super.getFrequencyResponse(...args);
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+  }
+
+  return IIRFilterNode;
+};
+
+
+  

package/js/OfflineAudioContext.js

@@ -0,0 +1,45 @@
+const { NotSupportedError } = require('./lib/errors.js');
+const { isPlainObject, isPositiveInt, isPositiveNumber } = require('./lib/utils.js');
+
+module.exports = function patchOfflineAudioContext(bindings) {
+  // @todo - EventTarget
+  // - https://github.com/orottier/web-audio-api-rs/issues/411
+  // - https://github.com/orottier/web-audio-api-rs/issues/416
+
+  const EventTarget = require('./EventTarget.mixin.js')(bindings.OfflineAudioContext, ['statechange']);
+  const BaseAudioContext = require('./BaseAudioContext.mixin.js')(EventTarget, bindings);
+
+  class OfflineAudioContext extends BaseAudioContext {
+    constructor(...args) {
+      // handle initialisation with either an options object or a sequence of parameters
+      // https://webaudio.github.io/web-audio-api/#dom-offlineaudiocontext-constructor-contextoptions-contextoptions
+      if (isPlainObject(args[0])
+          && 'numberOfChannels' in args[0] && 'length' in args[0] && 'sampleRate' in args[0]
+      ) {
+        const { numberOfChannels, length, sampleRate } = args[0];
+        args = [numberOfChannels, length, sampleRate];
+      }
+
+      const [numberOfChannels, length, sampleRate] = args;
+
+      if (!isPositiveInt(numberOfChannels)) {
+        throw new NotSupportedError(`Invalid value for numberOfChannels: ${numberOfChannels}`);
+      } else if (!isPositiveInt(length)) {
+        throw new NotSupportedError(`Invalid value for length: ${length}`);
+      } else if (!isPositiveNumber(sampleRate)) {
+        throw new NotSupportedError(`Invalid value for sampleRate: ${sampleRate}`);
+      }
+
+      super(numberOfChannels, length, sampleRate);
+
+      // @todo - do not init the event target, no way to clean the thread safe
+      // functions for now
+
+      // EventTargetMixin has been called so EventTargetMixin[kDispatchEvent] is
+      // bound to this, then we can safely finalize event target initialization
+      // super.__initEventTarget__();
+    }
+  }
+
+  return OfflineAudioContext;
+};

package/js/OscillatorNode.js

@@ -0,0 +1,77 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+const AudioScheduledSourceNodeMixin = require('./AudioScheduledSourceNode.mixin.js');
+
+module.exports = (NativeOscillatorNode) => {
+
+  const EventTarget = EventTargetMixin(NativeOscillatorNode, ['ended']);
+  const AudioNode = AudioNodeMixin(EventTarget);
+  const AudioScheduledSourceNode = AudioScheduledSourceNodeMixin(AudioNode);
+
+  class OscillatorNode extends AudioScheduledSourceNode {
+    constructor(context, options) {
+      super(context, options);
+      // EventTargetMixin has been called so EventTargetMixin[kDispatchEvent] is
+      // bound to this, then we can safely finalize event target initialization
+      super.__initEventTarget__();
+
+      this.frequency = new AudioParam(this.frequency);
+      this.detune = new AudioParam(this.detune);
+    }
+
+    // getters
+
+    get type() {
+      return super.type;
+    }
+
+    // setters
+
+    set type(value) {
+      try {
+        super.type = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    // methods
+    
+    setPeriodicWave(...args) {
+      try {
+        return super.setPeriodicWave(...args);
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+  }
+
+  return OscillatorNode;
+};
+
+
+  

package/js/PannerNode.js

@@ -0,0 +1,169 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativePannerNode) => {
+
+  const EventTarget = EventTargetMixin(NativePannerNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class PannerNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+      this.positionX = new AudioParam(this.positionX);
+      this.positionY = new AudioParam(this.positionY);
+      this.positionZ = new AudioParam(this.positionZ);
+      this.orientationX = new AudioParam(this.orientationX);
+      this.orientationY = new AudioParam(this.orientationY);
+      this.orientationZ = new AudioParam(this.orientationZ);
+    }
+
+    // getters
+
+    get panningModel() {
+      return super.panningModel;
+    }
+
+    get distanceModel() {
+      return super.distanceModel;
+    }
+
+    get refDistance() {
+      return super.refDistance;
+    }
+
+    get maxDistance() {
+      return super.maxDistance;
+    }
+
+    get rolloffFactor() {
+      return super.rolloffFactor;
+    }
+
+    get coneInnerAngle() {
+      return super.coneInnerAngle;
+    }
+
+    get coneOuterAngle() {
+      return super.coneOuterAngle;
+    }
+
+    get coneOuterGain() {
+      return super.coneOuterGain;
+    }
+
+    // setters
+
+    set panningModel(value) {
+      try {
+        super.panningModel = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set distanceModel(value) {
+      try {
+        super.distanceModel = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set refDistance(value) {
+      try {
+        super.refDistance = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set maxDistance(value) {
+      try {
+        super.maxDistance = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set rolloffFactor(value) {
+      try {
+        super.rolloffFactor = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set coneInnerAngle(value) {
+      try {
+        super.coneInnerAngle = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set coneOuterAngle(value) {
+      try {
+        super.coneOuterAngle = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    set coneOuterGain(value) {
+      try {
+        super.coneOuterGain = value;
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    // methods
+    
+    setPosition(...args) {
+      try {
+        return super.setPosition(...args);
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+    setOrientation(...args) {
+      try {
+        return super.setOrientation(...args);
+      } catch (err) {
+        throwSanitizedError(err);
+      }
+    }
+
+  }
+
+  return PannerNode;
+};
+
+
+  

package/js/StereoPannerNode.js

@@ -0,0 +1,52 @@
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+//                                                                            //
+//                                                                            //
+//                                                                            //
+//    ██╗    ██╗ █████╗ ██████╗ ███╗   ██╗██╗███╗   ██╗ ██████╗               //
+//    ██║    ██║██╔══██╗██╔══██╗████╗  ██║██║████╗  ██║██╔════╝               //
+//    ██║ █╗ ██║███████║██████╔╝██╔██╗ ██║██║██╔██╗ ██║██║  ███╗              //
+//    ██║███╗██║██╔══██║██╔══██╗██║╚██╗██║██║██║╚██╗██║██║   ██║              //
+//    ╚███╔███╔╝██║  ██║██║  ██║██║ ╚████║██║██║ ╚████║╚██████╔╝              //
+//     ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝╚═╝  ╚═══╝ ╚═════╝               //
+//                                                                            //
+//                                                                            //
+//    - This file has been generated ---------------------------              //
+//                                                                            //
+//                                                                            //
+// -------------------------------------------------------------------------- //
+// -------------------------------------------------------------------------- //
+
+// eslint-disable-next-line no-unused-vars
+const { throwSanitizedError } = require('./lib/errors.js');
+// eslint-disable-next-line no-unused-vars
+const { AudioParam } = require('./AudioParam.js');
+const EventTargetMixin = require('./EventTarget.mixin.js');
+const AudioNodeMixin = require('./AudioNode.mixin.js');
+
+
+module.exports = (NativeStereoPannerNode) => {
+
+  const EventTarget = EventTargetMixin(NativeStereoPannerNode);
+  const AudioNode = AudioNodeMixin(EventTarget);
+
+  class StereoPannerNode extends AudioNode {
+    constructor(context, options) {
+      super(context, options);
+
+      this.pan = new AudioParam(this.pan);
+    }
+
+    // getters
+
+    // setters
+
+    // methods
+    
+  }
+
+  return StereoPannerNode;
+};
+
+
+