misairu 4.1.0 → 5.0.1

package/dist/misairu.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misairu.modern.js","sources":["../src/processors/repeat.ts","../src/utilities/audio.ts","../src/misairu.ts","../src/utilities/source.ts"],"sourcesContent":["import { EventFunction, EventTrack, ITrackProcessor } from \"../types\";\r\n\r\nconst REPEAT_NAME_REGEX = new RegExp(/repeat:\\d:\\d:\\d/)\r\n\r\nexport class RepeatTrackProcessor implements ITrackProcessor {\r\n  deleteOriginTrack = true;\r\n\r\n  matches(name: string): boolean {\r\n    return name.match(REPEAT_NAME_REGEX) !== null\r\n  }\r\n\r\n  process(name: string, track: EventFunction): [string, EventTrack] {\r\n    if (typeof track != 'function')\r\n      throw Error(`The value of repeat track \"${track}\" is not a function`)\r\n\r\n    const repeatTrackArgs = name.split(':')\r\n\r\n    if (repeatTrackArgs.length != 4)\r\n      throw Error(`The repeat track \"${name}\" does not supply the valid amount of arguments`)\r\n\r\n    const startTime = parseFloat(repeatTrackArgs[1])\r\n    const interval = parseFloat(repeatTrackArgs[2])\r\n    const endTime = parseFloat(repeatTrackArgs[3])\r\n\r\n    let time = startTime\r\n    const tempTrack = {}\r\n\r\n    do {\r\n      tempTrack[time.toString()] = track\r\n      time += interval\r\n    } while (time < endTime)\r\n\r\n    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]\r\n  }\r\n}","/**\r\n * Method to turn the passed decibel values into volume values for the audio playback\r\n *\r\n * @param db decibel value\r\n * @returns volume value\r\n */\r\nexport function dbToVolume(db: number): number {\r\n  return Math.pow(10, db / 20)\r\n}\r\n\r\n/**\r\n * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures\r\n */\r\nexport function clampGain(volume: number): number {\r\n  if (volume < -80) {\r\n    return -80\r\n  } else if (volume > 5) {\r\n    return 5\r\n  }\r\n\r\n  return volume\r\n}","import { RepeatTrackProcessor } from './processors/repeat'\r\nimport { EventCache, ITrackProcessor, TimingObject } from './types'\r\nimport { dbToVolume, clampGain } from './utilities/audio'\r\nimport { fetchAudioSource, attachAudioElementSource } from './utilities/source'\r\n\r\n/**\r\n * Main misairu class\r\n */\r\nexport class Misairu {\r\n  /**\r\n   * The HTML5 AudioContext used for accurately timing our events\r\n   */\r\n  private readonly _audioContext: AudioContext\r\n\r\n  /**\r\n   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source\r\n   *\r\n   * @default null\r\n   */\r\n  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null\r\n\r\n  /**\r\n   * A object containing the last executed time key per track to not execute an event on every tick\r\n   *\r\n   * @default {}\r\n   */\r\n  private _cache: EventCache = {}\r\n\r\n  /**\r\n   * Reference to the `requestAnimationFrame` handler\r\n   *\r\n   * @default null\r\n   */\r\n  private _eventHandler: number | null = null\r\n\r\n  /**\r\n   * Gain node from our audio context to control audio volume\r\n   */\r\n  private readonly _gainNode: GainNode\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently muted\r\n   */\r\n  private _muted = false\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently paused\r\n   */\r\n  private _paused = false\r\n\r\n  /**\r\n   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called\r\n   */\r\n  private _startTime = 0\r\n\r\n  /**\r\n   * Object containing all timing tracks and events to be executed\r\n   */\r\n  private _timings: TimingObject\r\n\r\n  /**\r\n   * Volume of the current instance\r\n   */\r\n  private _volume = 0\r\n\r\n  /**\r\n   * List of (predefined) track processors\r\n   */\r\n  private _processors: ITrackProcessor[] = [\r\n    new RepeatTrackProcessor()\r\n  ]\r\n\r\n  get volume(): number {\r\n    return this._volume\r\n  }\r\n\r\n  set volume(db: number) {\r\n    this._volume = clampGain(db)\r\n\r\n    if (!this._muted) {\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * misairu constructor\r\n   *\r\n   * @param audioSource a string or HTML element to be used as audio source\r\n   * @param timings a object containing event timing information\r\n   */\r\n  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {\r\n    if (timings === null) console.error('You need to specify a timings object')\r\n    this._timings = timings\r\n\r\n    this._audioContext = new AudioContext()\r\n\r\n    this._gainNode = this._audioContext.createGain()\r\n    this._gainNode.connect(this._audioContext.destination)\r\n\r\n    this.getOptimalAudioSource(audioSource)\r\n\r\n    this.processTracks()\r\n  }\r\n\r\n  /**\r\n   * Method to figure out the best course of action to take with the passed audio source\r\n   *\r\n   * @param audioSource the audio source `Misairu` has been constructed with\r\n   * @internal\r\n   */\r\n  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {\r\n    if (typeof audioSource == 'string') {\r\n      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {\r\n        this._audioSource = audioSource\r\n        this._audioSource.connect(this._gainNode)\r\n\r\n        document.dispatchEvent(new Event('misairu.ready'))\r\n      })\r\n    } else if (\r\n      typeof audioSource == 'object' &&\r\n      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')\r\n    ) {\r\n      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)\r\n      this._audioSource.connect(this._gainNode)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Mutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public mute(): void {\r\n    if (!this._muted) {\r\n      this._muted = true\r\n      this._gainNode.gain.value = 0\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unmutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public unmute(): void {\r\n    if (this._muted) {\r\n      this._muted = false\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Pauses instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public pause(): void {\r\n    if (!this._paused) {\r\n      this._audioContext.suspend()\r\n      this._paused = true\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resumes instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public unpause(): void {\r\n    if (this._paused) {\r\n      this._audioContext.resume()\r\n      this._paused = false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set a cache entry for the given track\r\n   *\r\n   * @param track track to set a cache entry for\r\n   * @param entry value of the cache entry\r\n   * @internal\r\n   */\r\n  private setCacheEntry(track: string, entry: string): void {\r\n    this._cache[track] = entry\r\n  }\r\n\r\n  /**\r\n   * Get cache entry for the given track\r\n   *\r\n   * @param track track to get a cache entry for\r\n   * @returns a cache entry\r\n   * @internal\r\n   */\r\n  private getCacheEntry(track: string): string {\r\n    return this._cache[track]\r\n  }\r\n\r\n  /**\r\n   * Get all tracks from the timing configuration\r\n   *\r\n   * @returns a list of all track names\r\n   * @internal\r\n   */\r\n  private getAllTracks(): string[] {\r\n    return Object.keys(this._timings)\r\n  }\r\n\r\n  /**\r\n   * Returns the current active timing key for a given track\r\n   *\r\n   * @param track track to get the timing key from\r\n   * @param currentTime current playback time\r\n   * @returns the current active timing key\r\n   * @internal\r\n   */\r\n  private getActiveTimingKey(track: string, currentTime: number): string {\r\n    const timingKeys = Object.keys(this._timings[track])\r\n\r\n    const activeTimings = timingKeys.filter((timing) => {\r\n      if (currentTime >= parseFloat(timing)) {\r\n        return true\r\n      }\r\n    })\r\n\r\n    return activeTimings[activeTimings.length - 1]\r\n  }\r\n\r\n  /**\r\n   * Main method to process special sections in the timing configuration\r\n   *\r\n   * @internal\r\n   */\r\n  private processTracks(): void {\r\n    this.getAllTracks().forEach((trackName) => {\r\n      this._processors.forEach((processor: ITrackProcessor) => {\r\n        if (processor.matches(trackName)) {\r\n          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])\r\n\r\n          this._timings[processedTrackName] = eventTrack\r\n\r\n          if (processor.deleteOriginTrack) {\r\n            delete this._timings[trackName]\r\n          }\r\n        }\r\n      })\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Start audio playback and event handling\r\n   *\r\n   * @public\r\n   */\r\n  public start(): void {\r\n    this._startTime = this._audioContext.currentTime\r\n\r\n    ;(this._audioSource as AudioBufferSourceNode).start()\r\n\r\n    this.startEventHandling()\r\n  }\r\n\r\n  /**\r\n   * Method to start event handler loop\r\n   *\r\n   * @internal\r\n   */\r\n  private startEventHandling(): void {\r\n    if (this._eventHandler == null) {\r\n      this._eventHandler = window.requestAnimationFrame(() => {\r\n        this.handleEvents()\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Event handler method, is running in a loop using `requestAnimationFrame`\r\n   *\r\n   * @internal\r\n   */\r\n  private handleEvents(): void {\r\n    const time = this._audioContext.currentTime - this._startTime\r\n\r\n    this.getAllTracks().forEach((track) => {\r\n      const timingKey = this.getActiveTimingKey(track, time)\r\n\r\n      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {\r\n        this.executeEvent(track, timingKey, time)\r\n        this.setCacheEntry(track, timingKey)\r\n      }\r\n    })\r\n\r\n    this._eventHandler = window.requestAnimationFrame(() => {\r\n      this.handleEvents()\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Method to execute the event for a given timing key on a given track\r\n   *\r\n   * @param track the track to execute the event on\r\n   * @param timingKey the timing key to execute\r\n   * @param time current playback time\r\n   * @internal\r\n   */\r\n  private executeEvent(track: string, timingKey: string, time: number): void {\r\n    this._timings[track][timingKey](this, timingKey, track, time)\r\n  }\r\n}\r\n","/**\r\n * Method to fetch the external audio file (if the audio source parameter was a string)\r\n * and turning it into a `AudioBufferSourceNode`\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport async function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode> {\r\n  const source = audioContext.createBufferSource()\r\n\r\n  const response = await fetch(audioSource)\r\n  const arrayBuffer = await response.arrayBuffer()\r\n  const buffer = await audioContext.decodeAudioData(arrayBuffer)\r\n\r\n  source.buffer = buffer\r\n\r\n  return source\r\n}\r\n\r\n/**\r\n * Method to get an `MediaElementAudioSourceNode` from the passed audio source\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode {\r\n  return audioContext.createMediaElementSource(audioSource)\r\n}"],"names":["REPEAT_NAME_REGEX","RegExp","RepeatTrackProcessor","deleteOriginTrack","matches","name","match","process","track","Error","repeatTrackArgs","split","length","startTime","parseFloat","interval","endTime","time","tempTrack","toString","Math","random","substring","dbToVolume","db","pow","Misairu","volume","_volume","this","_muted","_gainNode","gain","value","constructor","audioSource","timings","_audioContext","_audioSource","_cache","_eventHandler","_paused","_startTime","_timings","_processors","console","error","AudioContext","createGain","connect","destination","getOptimalAudioSource","processTracks","audioContext","source","createBufferSource","response","fetch","arrayBuffer","buffer","decodeAudioData","fetchAudioSource","then","document","dispatchEvent","Event","tagName","createMediaElementSource","attachAudioElementSource","mute","unmute","pause","suspend","unpause","resume","setCacheEntry","entry","getCacheEntry","getAllTracks","Object","keys","getActiveTimingKey","currentTime","activeTimings","filter","timing","forEach","trackName","processor","processedTrackName","eventTrack","start","startEventHandling","window","requestAnimationFrame","handleEvents","timingKey","executeEvent"],"mappings":"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"}

package/dist/misairu.module.js

@@ -0,0 +1,2 @@
+var t=new RegExp(/repeat:\d:\d:\d/),e=function(){function e(){this.deleteOriginTrack=!0}var n=e.prototype;return n.matches=function(e){return null!==e.match(t)},n.process=function(t,e){if("function"!=typeof e)throw Error('The value of repeat track "'+e+'" is not a function');var n=t.split(":");if(4!=n.length)throw Error('The repeat track "'+t+'" does not supply the valid amount of arguments');var i=parseFloat(n[1]),o=parseFloat(n[2]),r=parseFloat(n[3]),s=i,a={};do{a[s.toString()]=e,s+=o}while(s<r);return["repeat-"+Math.random().toString(36).substring(7),a]},e}();function n(t){return Math.pow(10,t/20)}var i=function(){function t(t,n){this._audioContext=void 0,this._audioSource=null,this._cache={},this._eventHandler=null,this._gainNode=void 0,this._muted=!1,this._paused=!1,this._startTime=0,this._timings=void 0,this._volume=0,this._processors=[new e],null===n&&console.error("You need to specify a timings object"),this._timings=n,this._audioContext=new AudioContext,this._gainNode=this._audioContext.createGain(),this._gainNode.connect(this._audioContext.destination),this.getOptimalAudioSource(t),this.processTracks()}var i,o=t.prototype;return o.getOptimalAudioSource=function(t){var e=this;"string"==typeof t?function(t,e){try{var n=e.createBufferSource();return Promise.resolve(fetch(t)).then(function(t){return Promise.resolve(t.arrayBuffer()).then(function(t){return Promise.resolve(e.decodeAudioData(t)).then(function(t){return n.buffer=t,n})})})}catch(t){return Promise.reject(t)}}(t,this._audioContext).then(function(t){e._audioSource=t,e._audioSource.connect(e._gainNode),document.dispatchEvent(new Event("misairu.ready"))}):"object"!=typeof t||"AUDIO"!=t.tagName&&"VIDEO"!=t.tagName||(this._audioSource=function(t,e){return e.createMediaElementSource(t)}(t,this._audioContext),this._audioSource.connect(this._gainNode))},o.mute=function(){this._muted||(this._muted=!0,this._gainNode.gain.value=0)},o.unmute=function(){this._muted&&(this._muted=!1,this._gainNode.gain.value=n(this._volume))},o.pause=function(){this._paused||(this._audioContext.suspend(),this._paused=!0)},o.unpause=function(){this._paused&&(this._audioContext.resume(),this._paused=!1)},o.setCacheEntry=function(t,e){this._cache[t]=e},o.getCacheEntry=function(t){return this._cache[t]},o.getAllTracks=function(){return Object.keys(this._timings)},o.getActiveTimingKey=function(t,e){var n=Object.keys(this._timings[t]).filter(function(t){if(e>=parseFloat(t))return!0});return n[n.length-1]},o.processTracks=function(){var t=this;this.getAllTracks().forEach(function(e){t._processors.forEach(function(n){if(n.matches(e)){var i=n.process(e,t._timings[e]);t._timings[i[0]]=i[1],n.deleteOriginTrack&&delete t._timings[e]}})})},o.start=function(){this._startTime=this._audioContext.currentTime,this._audioSource.start(),this.startEventHandling()},o.startEventHandling=function(){var t=this;null==this._eventHandler&&(this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()}))},o.handleEvents=function(){var t=this,e=this._audioContext.currentTime-this._startTime;this.getAllTracks().forEach(function(n){var i=t.getActiveTimingKey(n,e);null!==i&&t.getCacheEntry(n)!=i&&(t.executeEvent(n,i,e),t.setCacheEntry(n,i))}),this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()})},o.executeEvent=function(t,e,n){this._timings[t][e](this,e,t,n)},(i=[{key:"volume",get:function(){return this._volume},set:function(t){var e;this._volume=(e=t)<-80?-80:e>5?5:e,this._muted||(this._gainNode.gain.value=n(this._volume))}}])&&function(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}(t.prototype,i),t}();export{i as default};
+//# sourceMappingURL=misairu.module.js.map

package/dist/misairu.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misairu.module.js","sources":["../src/processors/repeat.ts","../src/utilities/audio.ts","../src/misairu.ts","../src/utilities/source.ts"],"sourcesContent":["import { EventFunction, EventTrack, ITrackProcessor } from \"../types\";\r\n\r\nconst REPEAT_NAME_REGEX = new RegExp(/repeat:\\d:\\d:\\d/)\r\n\r\nexport class RepeatTrackProcessor implements ITrackProcessor {\r\n  deleteOriginTrack = true;\r\n\r\n  matches(name: string): boolean {\r\n    return name.match(REPEAT_NAME_REGEX) !== null\r\n  }\r\n\r\n  process(name: string, track: EventFunction): [string, EventTrack] {\r\n    if (typeof track != 'function')\r\n      throw Error(`The value of repeat track \"${track}\" is not a function`)\r\n\r\n    const repeatTrackArgs = name.split(':')\r\n\r\n    if (repeatTrackArgs.length != 4)\r\n      throw Error(`The repeat track \"${name}\" does not supply the valid amount of arguments`)\r\n\r\n    const startTime = parseFloat(repeatTrackArgs[1])\r\n    const interval = parseFloat(repeatTrackArgs[2])\r\n    const endTime = parseFloat(repeatTrackArgs[3])\r\n\r\n    let time = startTime\r\n    const tempTrack = {}\r\n\r\n    do {\r\n      tempTrack[time.toString()] = track\r\n      time += interval\r\n    } while (time < endTime)\r\n\r\n    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]\r\n  }\r\n}","/**\r\n * Method to turn the passed decibel values into volume values for the audio playback\r\n *\r\n * @param db decibel value\r\n * @returns volume value\r\n */\r\nexport function dbToVolume(db: number): number {\r\n  return Math.pow(10, db / 20)\r\n}\r\n\r\n/**\r\n * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures\r\n */\r\nexport function clampGain(volume: number): number {\r\n  if (volume < -80) {\r\n    return -80\r\n  } else if (volume > 5) {\r\n    return 5\r\n  }\r\n\r\n  return volume\r\n}","import { RepeatTrackProcessor } from './processors/repeat'\r\nimport { EventCache, ITrackProcessor, TimingObject } from './types'\r\nimport { dbToVolume, clampGain } from './utilities/audio'\r\nimport { fetchAudioSource, attachAudioElementSource } from './utilities/source'\r\n\r\n/**\r\n * Main misairu class\r\n */\r\nexport class Misairu {\r\n  /**\r\n   * The HTML5 AudioContext used for accurately timing our events\r\n   */\r\n  private readonly _audioContext: AudioContext\r\n\r\n  /**\r\n   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source\r\n   *\r\n   * @default null\r\n   */\r\n  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null\r\n\r\n  /**\r\n   * A object containing the last executed time key per track to not execute an event on every tick\r\n   *\r\n   * @default {}\r\n   */\r\n  private _cache: EventCache = {}\r\n\r\n  /**\r\n   * Reference to the `requestAnimationFrame` handler\r\n   *\r\n   * @default null\r\n   */\r\n  private _eventHandler: number | null = null\r\n\r\n  /**\r\n   * Gain node from our audio context to control audio volume\r\n   */\r\n  private readonly _gainNode: GainNode\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently muted\r\n   */\r\n  private _muted = false\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently paused\r\n   */\r\n  private _paused = false\r\n\r\n  /**\r\n   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called\r\n   */\r\n  private _startTime = 0\r\n\r\n  /**\r\n   * Object containing all timing tracks and events to be executed\r\n   */\r\n  private _timings: TimingObject\r\n\r\n  /**\r\n   * Volume of the current instance\r\n   */\r\n  private _volume = 0\r\n\r\n  /**\r\n   * List of (predefined) track processors\r\n   */\r\n  private _processors: ITrackProcessor[] = [\r\n    new RepeatTrackProcessor()\r\n  ]\r\n\r\n  get volume(): number {\r\n    return this._volume\r\n  }\r\n\r\n  set volume(db: number) {\r\n    this._volume = clampGain(db)\r\n\r\n    if (!this._muted) {\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * misairu constructor\r\n   *\r\n   * @param audioSource a string or HTML element to be used as audio source\r\n   * @param timings a object containing event timing information\r\n   */\r\n  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {\r\n    if (timings === null) console.error('You need to specify a timings object')\r\n    this._timings = timings\r\n\r\n    this._audioContext = new AudioContext()\r\n\r\n    this._gainNode = this._audioContext.createGain()\r\n    this._gainNode.connect(this._audioContext.destination)\r\n\r\n    this.getOptimalAudioSource(audioSource)\r\n\r\n    this.processTracks()\r\n  }\r\n\r\n  /**\r\n   * Method to figure out the best course of action to take with the passed audio source\r\n   *\r\n   * @param audioSource the audio source `Misairu` has been constructed with\r\n   * @internal\r\n   */\r\n  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {\r\n    if (typeof audioSource == 'string') {\r\n      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {\r\n        this._audioSource = audioSource\r\n        this._audioSource.connect(this._gainNode)\r\n\r\n        document.dispatchEvent(new Event('misairu.ready'))\r\n      })\r\n    } else if (\r\n      typeof audioSource == 'object' &&\r\n      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')\r\n    ) {\r\n      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)\r\n      this._audioSource.connect(this._gainNode)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Mutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public mute(): void {\r\n    if (!this._muted) {\r\n      this._muted = true\r\n      this._gainNode.gain.value = 0\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unmutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public unmute(): void {\r\n    if (this._muted) {\r\n      this._muted = false\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Pauses instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public pause(): void {\r\n    if (!this._paused) {\r\n      this._audioContext.suspend()\r\n      this._paused = true\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resumes instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public unpause(): void {\r\n    if (this._paused) {\r\n      this._audioContext.resume()\r\n      this._paused = false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set a cache entry for the given track\r\n   *\r\n   * @param track track to set a cache entry for\r\n   * @param entry value of the cache entry\r\n   * @internal\r\n   */\r\n  private setCacheEntry(track: string, entry: string): void {\r\n    this._cache[track] = entry\r\n  }\r\n\r\n  /**\r\n   * Get cache entry for the given track\r\n   *\r\n   * @param track track to get a cache entry for\r\n   * @returns a cache entry\r\n   * @internal\r\n   */\r\n  private getCacheEntry(track: string): string {\r\n    return this._cache[track]\r\n  }\r\n\r\n  /**\r\n   * Get all tracks from the timing configuration\r\n   *\r\n   * @returns a list of all track names\r\n   * @internal\r\n   */\r\n  private getAllTracks(): string[] {\r\n    return Object.keys(this._timings)\r\n  }\r\n\r\n  /**\r\n   * Returns the current active timing key for a given track\r\n   *\r\n   * @param track track to get the timing key from\r\n   * @param currentTime current playback time\r\n   * @returns the current active timing key\r\n   * @internal\r\n   */\r\n  private getActiveTimingKey(track: string, currentTime: number): string {\r\n    const timingKeys = Object.keys(this._timings[track])\r\n\r\n    const activeTimings = timingKeys.filter((timing) => {\r\n      if (currentTime >= parseFloat(timing)) {\r\n        return true\r\n      }\r\n    })\r\n\r\n    return activeTimings[activeTimings.length - 1]\r\n  }\r\n\r\n  /**\r\n   * Main method to process special sections in the timing configuration\r\n   *\r\n   * @internal\r\n   */\r\n  private processTracks(): void {\r\n    this.getAllTracks().forEach((trackName) => {\r\n      this._processors.forEach((processor: ITrackProcessor) => {\r\n        if (processor.matches(trackName)) {\r\n          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])\r\n\r\n          this._timings[processedTrackName] = eventTrack\r\n\r\n          if (processor.deleteOriginTrack) {\r\n            delete this._timings[trackName]\r\n          }\r\n        }\r\n      })\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Start audio playback and event handling\r\n   *\r\n   * @public\r\n   */\r\n  public start(): void {\r\n    this._startTime = this._audioContext.currentTime\r\n\r\n    ;(this._audioSource as AudioBufferSourceNode).start()\r\n\r\n    this.startEventHandling()\r\n  }\r\n\r\n  /**\r\n   * Method to start event handler loop\r\n   *\r\n   * @internal\r\n   */\r\n  private startEventHandling(): void {\r\n    if (this._eventHandler == null) {\r\n      this._eventHandler = window.requestAnimationFrame(() => {\r\n        this.handleEvents()\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Event handler method, is running in a loop using `requestAnimationFrame`\r\n   *\r\n   * @internal\r\n   */\r\n  private handleEvents(): void {\r\n    const time = this._audioContext.currentTime - this._startTime\r\n\r\n    this.getAllTracks().forEach((track) => {\r\n      const timingKey = this.getActiveTimingKey(track, time)\r\n\r\n      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {\r\n        this.executeEvent(track, timingKey, time)\r\n        this.setCacheEntry(track, timingKey)\r\n      }\r\n    })\r\n\r\n    this._eventHandler = window.requestAnimationFrame(() => {\r\n      this.handleEvents()\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Method to execute the event for a given timing key on a given track\r\n   *\r\n   * @param track the track to execute the event on\r\n   * @param timingKey the timing key to execute\r\n   * @param time current playback time\r\n   * @internal\r\n   */\r\n  private executeEvent(track: string, timingKey: string, time: number): void {\r\n    this._timings[track][timingKey](this, timingKey, track, time)\r\n  }\r\n}\r\n","/**\r\n * Method to fetch the external audio file (if the audio source parameter was a string)\r\n * and turning it into a `AudioBufferSourceNode`\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport async function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode> {\r\n  const source = audioContext.createBufferSource()\r\n\r\n  const response = await fetch(audioSource)\r\n  const arrayBuffer = await response.arrayBuffer()\r\n  const buffer = await audioContext.decodeAudioData(arrayBuffer)\r\n\r\n  source.buffer = buffer\r\n\r\n  return source\r\n}\r\n\r\n/**\r\n * Method to get an `MediaElementAudioSourceNode` from the passed audio source\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode {\r\n  return audioContext.createMediaElementSource(audioSource)\r\n}"],"names":["REPEAT_NAME_REGEX","RegExp","RepeatTrackProcessor","deleteOriginTrack","matches","name","match","process","track","Error","repeatTrackArgs","split","length","startTime","parseFloat","interval","endTime","time","tempTrack","toString","Math","random","substring","dbToVolume","db","pow","Misairu","audioSource","timings","_audioContext","_audioSource","_cache","_eventHandler","_gainNode","_muted","_paused","_startTime","_timings","_volume","_processors","console","error","this","AudioContext","createGain","connect","destination","getOptimalAudioSource","processTracks","audioContext","source","createBufferSource","fetch","response","arrayBuffer","decodeAudioData","buffer","fetchAudioSource","then","_this","document","dispatchEvent","Event","tagName","createMediaElementSource","attachAudioElementSource","mute","gain","value","unmute","pause","suspend","unpause","resume","setCacheEntry","entry","getCacheEntry","getAllTracks","Object","keys","getActiveTimingKey","currentTime","activeTimings","filter","timing","forEach","trackName","_this2","processor","start","startEventHandling","window","requestAnimationFrame","_this3","handleEvents","timingKey","_this4","executeEvent","volume"],"mappings":"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"}

package/dist/misairu.umd.js

@@ -0,0 +1,2 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):(t||self).misairu=e()}(this,function(){var t=new RegExp(/repeat:\d:\d:\d/),e=function(){function e(){this.deleteOriginTrack=!0}var n=e.prototype;return n.matches=function(e){return null!==e.match(t)},n.process=function(t,e){if("function"!=typeof e)throw Error('The value of repeat track "'+e+'" is not a function');var n=t.split(":");if(4!=n.length)throw Error('The repeat track "'+t+'" does not supply the valid amount of arguments');var i=parseFloat(n[1]),o=parseFloat(n[2]),r=parseFloat(n[3]),s=i,u={};do{u[s.toString()]=e,s+=o}while(s<r);return["repeat-"+Math.random().toString(36).substring(7),u]},e}();function n(t){return Math.pow(10,t/20)}return function(){function t(t,n){this._audioContext=void 0,this._audioSource=null,this._cache={},this._eventHandler=null,this._gainNode=void 0,this._muted=!1,this._paused=!1,this._startTime=0,this._timings=void 0,this._volume=0,this._processors=[new e],null===n&&console.error("You need to specify a timings object"),this._timings=n,this._audioContext=new AudioContext,this._gainNode=this._audioContext.createGain(),this._gainNode.connect(this._audioContext.destination),this.getOptimalAudioSource(t),this.processTracks()}var i,o=t.prototype;return o.getOptimalAudioSource=function(t){var e=this;"string"==typeof t?function(t,e){try{var n=e.createBufferSource();return Promise.resolve(fetch(t)).then(function(t){return Promise.resolve(t.arrayBuffer()).then(function(t){return Promise.resolve(e.decodeAudioData(t)).then(function(t){return n.buffer=t,n})})})}catch(t){return Promise.reject(t)}}(t,this._audioContext).then(function(t){e._audioSource=t,e._audioSource.connect(e._gainNode),document.dispatchEvent(new Event("misairu.ready"))}):"object"!=typeof t||"AUDIO"!=t.tagName&&"VIDEO"!=t.tagName||(this._audioSource=function(t,e){return e.createMediaElementSource(t)}(t,this._audioContext),this._audioSource.connect(this._gainNode))},o.mute=function(){this._muted||(this._muted=!0,this._gainNode.gain.value=0)},o.unmute=function(){this._muted&&(this._muted=!1,this._gainNode.gain.value=n(this._volume))},o.pause=function(){this._paused||(this._audioContext.suspend(),this._paused=!0)},o.unpause=function(){this._paused&&(this._audioContext.resume(),this._paused=!1)},o.setCacheEntry=function(t,e){this._cache[t]=e},o.getCacheEntry=function(t){return this._cache[t]},o.getAllTracks=function(){return Object.keys(this._timings)},o.getActiveTimingKey=function(t,e){var n=Object.keys(this._timings[t]).filter(function(t){if(e>=parseFloat(t))return!0});return n[n.length-1]},o.processTracks=function(){var t=this;this.getAllTracks().forEach(function(e){t._processors.forEach(function(n){if(n.matches(e)){var i=n.process(e,t._timings[e]);t._timings[i[0]]=i[1],n.deleteOriginTrack&&delete t._timings[e]}})})},o.start=function(){this._startTime=this._audioContext.currentTime,this._audioSource.start(),this.startEventHandling()},o.startEventHandling=function(){var t=this;null==this._eventHandler&&(this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()}))},o.handleEvents=function(){var t=this,e=this._audioContext.currentTime-this._startTime;this.getAllTracks().forEach(function(n){var i=t.getActiveTimingKey(n,e);null!==i&&t.getCacheEntry(n)!=i&&(t.executeEvent(n,i,e),t.setCacheEntry(n,i))}),this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()})},o.executeEvent=function(t,e,n){this._timings[t][e](this,e,t,n)},(i=[{key:"volume",get:function(){return this._volume},set:function(t){var e;this._volume=(e=t)<-80?-80:e>5?5:e,this._muted||(this._gainNode.gain.value=n(this._volume))}}])&&function(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}(t.prototype,i),t}()});
+//# sourceMappingURL=misairu.umd.js.map

package/dist/misairu.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misairu.umd.js","sources":["../src/processors/repeat.ts","../src/utilities/audio.ts","../src/misairu.ts","../src/utilities/source.ts"],"sourcesContent":["import { EventFunction, EventTrack, ITrackProcessor } from \"../types\";\r\n\r\nconst REPEAT_NAME_REGEX = new RegExp(/repeat:\\d:\\d:\\d/)\r\n\r\nexport class RepeatTrackProcessor implements ITrackProcessor {\r\n  deleteOriginTrack = true;\r\n\r\n  matches(name: string): boolean {\r\n    return name.match(REPEAT_NAME_REGEX) !== null\r\n  }\r\n\r\n  process(name: string, track: EventFunction): [string, EventTrack] {\r\n    if (typeof track != 'function')\r\n      throw Error(`The value of repeat track \"${track}\" is not a function`)\r\n\r\n    const repeatTrackArgs = name.split(':')\r\n\r\n    if (repeatTrackArgs.length != 4)\r\n      throw Error(`The repeat track \"${name}\" does not supply the valid amount of arguments`)\r\n\r\n    const startTime = parseFloat(repeatTrackArgs[1])\r\n    const interval = parseFloat(repeatTrackArgs[2])\r\n    const endTime = parseFloat(repeatTrackArgs[3])\r\n\r\n    let time = startTime\r\n    const tempTrack = {}\r\n\r\n    do {\r\n      tempTrack[time.toString()] = track\r\n      time += interval\r\n    } while (time < endTime)\r\n\r\n    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]\r\n  }\r\n}","/**\r\n * Method to turn the passed decibel values into volume values for the audio playback\r\n *\r\n * @param db decibel value\r\n * @returns volume value\r\n */\r\nexport function dbToVolume(db: number): number {\r\n  return Math.pow(10, db / 20)\r\n}\r\n\r\n/**\r\n * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures\r\n */\r\nexport function clampGain(volume: number): number {\r\n  if (volume < -80) {\r\n    return -80\r\n  } else if (volume > 5) {\r\n    return 5\r\n  }\r\n\r\n  return volume\r\n}","import { RepeatTrackProcessor } from './processors/repeat'\r\nimport { EventCache, ITrackProcessor, TimingObject } from './types'\r\nimport { dbToVolume, clampGain } from './utilities/audio'\r\nimport { fetchAudioSource, attachAudioElementSource } from './utilities/source'\r\n\r\n/**\r\n * Main misairu class\r\n */\r\nexport class Misairu {\r\n  /**\r\n   * The HTML5 AudioContext used for accurately timing our events\r\n   */\r\n  private readonly _audioContext: AudioContext\r\n\r\n  /**\r\n   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source\r\n   *\r\n   * @default null\r\n   */\r\n  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null\r\n\r\n  /**\r\n   * A object containing the last executed time key per track to not execute an event on every tick\r\n   *\r\n   * @default {}\r\n   */\r\n  private _cache: EventCache = {}\r\n\r\n  /**\r\n   * Reference to the `requestAnimationFrame` handler\r\n   *\r\n   * @default null\r\n   */\r\n  private _eventHandler: number | null = null\r\n\r\n  /**\r\n   * Gain node from our audio context to control audio volume\r\n   */\r\n  private readonly _gainNode: GainNode\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently muted\r\n   */\r\n  private _muted = false\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently paused\r\n   */\r\n  private _paused = false\r\n\r\n  /**\r\n   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called\r\n   */\r\n  private _startTime = 0\r\n\r\n  /**\r\n   * Object containing all timing tracks and events to be executed\r\n   */\r\n  private _timings: TimingObject\r\n\r\n  /**\r\n   * Volume of the current instance\r\n   */\r\n  private _volume = 0\r\n\r\n  /**\r\n   * List of (predefined) track processors\r\n   */\r\n  private _processors: ITrackProcessor[] = [\r\n    new RepeatTrackProcessor()\r\n  ]\r\n\r\n  get volume(): number {\r\n    return this._volume\r\n  }\r\n\r\n  set volume(db: number) {\r\n    this._volume = clampGain(db)\r\n\r\n    if (!this._muted) {\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * misairu constructor\r\n   *\r\n   * @param audioSource a string or HTML element to be used as audio source\r\n   * @param timings a object containing event timing information\r\n   */\r\n  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {\r\n    if (timings === null) console.error('You need to specify a timings object')\r\n    this._timings = timings\r\n\r\n    this._audioContext = new AudioContext()\r\n\r\n    this._gainNode = this._audioContext.createGain()\r\n    this._gainNode.connect(this._audioContext.destination)\r\n\r\n    this.getOptimalAudioSource(audioSource)\r\n\r\n    this.processTracks()\r\n  }\r\n\r\n  /**\r\n   * Method to figure out the best course of action to take with the passed audio source\r\n   *\r\n   * @param audioSource the audio source `Misairu` has been constructed with\r\n   * @internal\r\n   */\r\n  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {\r\n    if (typeof audioSource == 'string') {\r\n      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {\r\n        this._audioSource = audioSource\r\n        this._audioSource.connect(this._gainNode)\r\n\r\n        document.dispatchEvent(new Event('misairu.ready'))\r\n      })\r\n    } else if (\r\n      typeof audioSource == 'object' &&\r\n      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')\r\n    ) {\r\n      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)\r\n      this._audioSource.connect(this._gainNode)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Mutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public mute(): void {\r\n    if (!this._muted) {\r\n      this._muted = true\r\n      this._gainNode.gain.value = 0\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unmutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public unmute(): void {\r\n    if (this._muted) {\r\n      this._muted = false\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Pauses instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public pause(): void {\r\n    if (!this._paused) {\r\n      this._audioContext.suspend()\r\n      this._paused = true\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resumes instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public unpause(): void {\r\n    if (this._paused) {\r\n      this._audioContext.resume()\r\n      this._paused = false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set a cache entry for the given track\r\n   *\r\n   * @param track track to set a cache entry for\r\n   * @param entry value of the cache entry\r\n   * @internal\r\n   */\r\n  private setCacheEntry(track: string, entry: string): void {\r\n    this._cache[track] = entry\r\n  }\r\n\r\n  /**\r\n   * Get cache entry for the given track\r\n   *\r\n   * @param track track to get a cache entry for\r\n   * @returns a cache entry\r\n   * @internal\r\n   */\r\n  private getCacheEntry(track: string): string {\r\n    return this._cache[track]\r\n  }\r\n\r\n  /**\r\n   * Get all tracks from the timing configuration\r\n   *\r\n   * @returns a list of all track names\r\n   * @internal\r\n   */\r\n  private getAllTracks(): string[] {\r\n    return Object.keys(this._timings)\r\n  }\r\n\r\n  /**\r\n   * Returns the current active timing key for a given track\r\n   *\r\n   * @param track track to get the timing key from\r\n   * @param currentTime current playback time\r\n   * @returns the current active timing key\r\n   * @internal\r\n   */\r\n  private getActiveTimingKey(track: string, currentTime: number): string {\r\n    const timingKeys = Object.keys(this._timings[track])\r\n\r\n    const activeTimings = timingKeys.filter((timing) => {\r\n      if (currentTime >= parseFloat(timing)) {\r\n        return true\r\n      }\r\n    })\r\n\r\n    return activeTimings[activeTimings.length - 1]\r\n  }\r\n\r\n  /**\r\n   * Main method to process special sections in the timing configuration\r\n   *\r\n   * @internal\r\n   */\r\n  private processTracks(): void {\r\n    this.getAllTracks().forEach((trackName) => {\r\n      this._processors.forEach((processor: ITrackProcessor) => {\r\n        if (processor.matches(trackName)) {\r\n          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])\r\n\r\n          this._timings[processedTrackName] = eventTrack\r\n\r\n          if (processor.deleteOriginTrack) {\r\n            delete this._timings[trackName]\r\n          }\r\n        }\r\n      })\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Start audio playback and event handling\r\n   *\r\n   * @public\r\n   */\r\n  public start(): void {\r\n    this._startTime = this._audioContext.currentTime\r\n\r\n    ;(this._audioSource as AudioBufferSourceNode).start()\r\n\r\n    this.startEventHandling()\r\n  }\r\n\r\n  /**\r\n   * Method to start event handler loop\r\n   *\r\n   * @internal\r\n   */\r\n  private startEventHandling(): void {\r\n    if (this._eventHandler == null) {\r\n      this._eventHandler = window.requestAnimationFrame(() => {\r\n        this.handleEvents()\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Event handler method, is running in a loop using `requestAnimationFrame`\r\n   *\r\n   * @internal\r\n   */\r\n  private handleEvents(): void {\r\n    const time = this._audioContext.currentTime - this._startTime\r\n\r\n    this.getAllTracks().forEach((track) => {\r\n      const timingKey = this.getActiveTimingKey(track, time)\r\n\r\n      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {\r\n        this.executeEvent(track, timingKey, time)\r\n        this.setCacheEntry(track, timingKey)\r\n      }\r\n    })\r\n\r\n    this._eventHandler = window.requestAnimationFrame(() => {\r\n      this.handleEvents()\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Method to execute the event for a given timing key on a given track\r\n   *\r\n   * @param track the track to execute the event on\r\n   * @param timingKey the timing key to execute\r\n   * @param time current playback time\r\n   * @internal\r\n   */\r\n  private executeEvent(track: string, timingKey: string, time: number): void {\r\n    this._timings[track][timingKey](this, timingKey, track, time)\r\n  }\r\n}\r\n","/**\r\n * Method to fetch the external audio file (if the audio source parameter was a string)\r\n * and turning it into a `AudioBufferSourceNode`\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport async function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode> {\r\n  const source = audioContext.createBufferSource()\r\n\r\n  const response = await fetch(audioSource)\r\n  const arrayBuffer = await response.arrayBuffer()\r\n  const buffer = await audioContext.decodeAudioData(arrayBuffer)\r\n\r\n  source.buffer = buffer\r\n\r\n  return source\r\n}\r\n\r\n/**\r\n * Method to get an `MediaElementAudioSourceNode` from the passed audio source\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode {\r\n  return audioContext.createMediaElementSource(audioSource)\r\n}"],"names":["REPEAT_NAME_REGEX","RegExp","RepeatTrackProcessor","deleteOriginTrack","matches","name","match","process","track","Error","repeatTrackArgs","split","length","startTime","parseFloat","interval","endTime","time","tempTrack","toString","Math","random","substring","dbToVolume","db","pow","audioSource","timings","_audioContext","_audioSource","_cache","_eventHandler","_gainNode","_muted","_paused","_startTime","_timings","_volume","_processors","console","error","this","AudioContext","createGain","connect","destination","getOptimalAudioSource","processTracks","audioContext","source","createBufferSource","fetch","response","arrayBuffer","decodeAudioData","buffer","fetchAudioSource","then","_this","document","dispatchEvent","Event","tagName","createMediaElementSource","attachAudioElementSource","mute","gain","value","unmute","pause","suspend","unpause","resume","setCacheEntry","entry","getCacheEntry","getAllTracks","Object","keys","getActiveTimingKey","currentTime","activeTimings","filter","timing","forEach","trackName","_this2","processor","start","startEventHandling","window","requestAnimationFrame","_this3","handleEvents","timingKey","_this4","executeEvent","volume"],"mappings":"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"}

package/dist/processors/repeat.d.ts

@@ -0,0 +1,6 @@
+import { EventFunction, EventTrack, ITrackProcessor } from "../types";
+export declare class RepeatTrackProcessor implements ITrackProcessor {
+    deleteOriginTrack: boolean;
+    matches(name: string): boolean;
+    process(name: string, track: EventFunction): [string, EventTrack];
+}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+import { Misairu } from './misairu';
+/**
+ * Type describing the structure of the event cache
+ */
+export declare type EventCache = {
+    [trackName: string]: string;
+};
+/**
+ * Type describing the available arguments of event functions
+ */
+export declare type EventFunction = (instance: Misairu, timingKey: string, track: string, time: number) => void;
+/**
+ * Type describing the structure of an event track
+ */
+export declare type EventTrack = {
+    [timingKey: string]: EventFunction;
+};
+/**
+ * Type describing the structure of the timing object
+ */
+export declare type TimingObject = {
+    [trackName: string]: EventTrack;
+};
+/**
+ * Interface describing required methods/members for track processors
+ */
+export interface ITrackProcessor {
+    /**
+     * Member describing if the processed track should be deleted
+     */
+    deleteOriginTrack: boolean;
+    /**
+     * Method to check if the track name matches to determine if the processor
+     * should process it
+     *
+     * @param name name oƒ a track
+     */
+    matches(name: string): boolean;
+    /**
+     * Main processing method
+     *
+     * @param name name of the track to be processed
+     * @param track content of the track to be processed
+     */
+    process(name: string, track: EventTrack | EventFunction): [string, EventTrack];
+}

package/dist/utilities/audio.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Method to turn the passed decibel values into volume values for the audio playback
+ *
+ * @param db decibel value
+ * @returns volume value
+ */
+export declare function dbToVolume(db: number): number;
+/**
+ * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures
+ */
+export declare function clampGain(volume: number): number;

package/dist/utilities/source.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Method to fetch the external audio file (if the audio source parameter was a string)
+ * and turning it into a `AudioBufferSourceNode`
+ *
+ * @param audioSource the audio source `Misairu` has been constructed with
+ * @internal
+ */
+export declare function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode>;
+/**
+ * Method to get an `MediaElementAudioSourceNode` from the passed audio source
+ *
+ * @param audioSource the audio source `Misairu` has been constructed with
+ * @internal
+ */
+export declare function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode;

package/package.json

@@ -1,26 +1,52 @@
-{
-  "name": "misairu",
-  "version": "4.1.0",
-  "description": "Fire events for specific timeframes easily",
-  "main": "misairu.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pixeldesu/misairu.git"
-  },
-  "keywords": [
-    "audio",
-    "video",
-    "media",
-    "events",
-    "timing"
-  ],
-  "author": "Andreas Nedbal <andy@pixelde.su>",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/pixeldesu/misairu/issues"
-  },
-  "homepage": "https://github.com/pixeldesu/misairu#readme"
-}
+{
+  "name": "misairu",
+  "version": "5.0.1",
+  "description": "Fire events for specific timeframes easily",
+  "source": "src/index.ts",
+  "main": "dist/misairu.js",
+  "exports": "./dist/misairu.modern.js",
+  "module": "dist/misairu.module.js",
+  "unpkg": "dist/misairu.umd.js",
+  "iife": "dist/misairu.iife.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "microbundle",
+    "postbuild": "microbundle -i src/index.ts -o dist/misairu.iife.js --name Misairu --no-pkg-main -f iife",
+    "dev": "microbundle watch",
+    "fix": "eslint --fix src/ --ext .ts",
+    "lint": "eslint src/ --ext .ts",
+    "prepare": "husky install"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://codeberg.org/pixeldesu/misairu.git"
+  },
+  "keywords": [
+    "audio",
+    "video",
+    "media",
+    "events",
+    "timing"
+  ],
+  "author": "Andreas Nedbal <andy@pixelde.su>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://codeberg.org/pixeldesu/misairu/issues"
+  },
+  "homepage": "https://codeberg.org/pixeldesu/misairu#readme",
+  "lint-staged": {
+    "*.{js,ts}": "eslint --fix"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^4.30.0",
+    "@typescript-eslint/parser": "^4.30.0",
+    "eslint": "^7.32.0",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-plugin-prettier": "^4.0.0",
+    "husky": "^7.0.2",
+    "lint-staged": "^11.1.2",
+    "microbundle": "^0.13.3",
+    "prettier": "^2.3.2",
+    "typescript": "^4.4.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export { Misairu as default } from './misairu'

package/src/misairu.ts

@@ -0,0 +1,308 @@
+import { RepeatTrackProcessor } from './processors/repeat'
+import { EventCache, ITrackProcessor, TimingObject } from './types'
+import { dbToVolume, clampGain } from './utilities/audio'
+import { fetchAudioSource, attachAudioElementSource } from './utilities/source'
+
+/**
+ * Main misairu class
+ */
+export class Misairu {
+  /**
+   * The HTML5 AudioContext used for accurately timing our events
+   */
+  private readonly _audioContext: AudioContext
+
+  /**
+   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source
+   *
+   * @default null
+   */
+  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null
+
+  /**
+   * A object containing the last executed time key per track to not execute an event on every tick
+   *
+   * @default {}
+   */
+  private _cache: EventCache = {}
+
+  /**
+   * Reference to the `requestAnimationFrame` handler
+   *
+   * @default null
+   */
+  private _eventHandler: number | null = null
+
+  /**
+   * Gain node from our audio context to control audio volume
+   */
+  private readonly _gainNode: GainNode
+
+  /**
+   * Boolean value describing if this instance is currently muted
+   */
+  private _muted = false
+
+  /**
+   * Boolean value describing if this instance is currently paused
+   */
+  private _paused = false
+
+  /**
+   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called
+   */
+  private _startTime = 0
+
+  /**
+   * Object containing all timing tracks and events to be executed
+   */
+  private _timings: TimingObject
+
+  /**
+   * Volume of the current instance
+   */
+  private _volume = 0
+
+  /**
+   * List of (predefined) track processors
+   */
+  private _processors: ITrackProcessor[] = [
+    new RepeatTrackProcessor()
+  ]
+
+  get volume(): number {
+    return this._volume
+  }
+
+  set volume(db: number) {
+    this._volume = clampGain(db)
+
+    if (!this._muted) {
+      this._gainNode.gain.value = dbToVolume(this._volume)
+    }
+  }
+
+  /**
+   * misairu constructor
+   *
+   * @param audioSource a string or HTML element to be used as audio source
+   * @param timings a object containing event timing information
+   */
+  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {
+    if (timings === null) console.error('You need to specify a timings object')
+    this._timings = timings
+
+    this._audioContext = new AudioContext()
+
+    this._gainNode = this._audioContext.createGain()
+    this._gainNode.connect(this._audioContext.destination)
+
+    this.getOptimalAudioSource(audioSource)
+
+    this.processTracks()
+  }
+
+  /**
+   * Method to figure out the best course of action to take with the passed audio source
+   *
+   * @param audioSource the audio source `Misairu` has been constructed with
+   * @internal
+   */
+  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {
+    if (typeof audioSource == 'string') {
+      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {
+        this._audioSource = audioSource
+        this._audioSource.connect(this._gainNode)
+
+        document.dispatchEvent(new Event('misairu.ready'))
+      })
+    } else if (
+      typeof audioSource == 'object' &&
+      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')
+    ) {
+      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)
+      this._audioSource.connect(this._gainNode)
+    }
+  }
+
+  /**
+   * Mutes the instance audio
+   *
+   * @public
+   */
+  public mute(): void {
+    if (!this._muted) {
+      this._muted = true
+      this._gainNode.gain.value = 0
+    }
+  }
+
+  /**
+   * Unmutes the instance audio
+   *
+   * @public
+   */
+  public unmute(): void {
+    if (this._muted) {
+      this._muted = false
+      this._gainNode.gain.value = dbToVolume(this._volume)
+    }
+  }
+
+  /**
+   * Pauses instance playback
+   *
+   * @public
+   */
+  public pause(): void {
+    if (!this._paused) {
+      this._audioContext.suspend()
+      this._paused = true
+    }
+  }
+
+  /**
+   * Resumes instance playback
+   *
+   * @public
+   */
+  public unpause(): void {
+    if (this._paused) {
+      this._audioContext.resume()
+      this._paused = false
+    }
+  }
+
+  /**
+   * Set a cache entry for the given track
+   *
+   * @param track track to set a cache entry for
+   * @param entry value of the cache entry
+   * @internal
+   */
+  private setCacheEntry(track: string, entry: string): void {
+    this._cache[track] = entry
+  }
+
+  /**
+   * Get cache entry for the given track
+   *
+   * @param track track to get a cache entry for
+   * @returns a cache entry
+   * @internal
+   */
+  private getCacheEntry(track: string): string {
+    return this._cache[track]
+  }
+
+  /**
+   * Get all tracks from the timing configuration
+   *
+   * @returns a list of all track names
+   * @internal
+   */
+  private getAllTracks(): string[] {
+    return Object.keys(this._timings)
+  }
+
+  /**
+   * Returns the current active timing key for a given track
+   *
+   * @param track track to get the timing key from
+   * @param currentTime current playback time
+   * @returns the current active timing key
+   * @internal
+   */
+  private getActiveTimingKey(track: string, currentTime: number): string {
+    const timingKeys = Object.keys(this._timings[track])
+
+    const activeTimings = timingKeys.filter((timing) => {
+      if (currentTime >= parseFloat(timing)) {
+        return true
+      }
+    })
+
+    return activeTimings[activeTimings.length - 1]
+  }
+
+  /**
+   * Main method to process special sections in the timing configuration
+   *
+   * @internal
+   */
+  private processTracks(): void {
+    this.getAllTracks().forEach((trackName) => {
+      this._processors.forEach((processor: ITrackProcessor) => {
+        if (processor.matches(trackName)) {
+          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])
+
+          this._timings[processedTrackName] = eventTrack
+
+          if (processor.deleteOriginTrack) {
+            delete this._timings[trackName]
+          }
+        }
+      })
+    })
+  }
+
+  /**
+   * Start audio playback and event handling
+   *
+   * @public
+   */
+  public start(): void {
+    this._startTime = this._audioContext.currentTime
+
+    ;(this._audioSource as AudioBufferSourceNode).start()
+
+    this.startEventHandling()
+  }
+
+  /**
+   * Method to start event handler loop
+   *
+   * @internal
+   */
+  private startEventHandling(): void {
+    if (this._eventHandler == null) {
+      this._eventHandler = window.requestAnimationFrame(() => {
+        this.handleEvents()
+      })
+    }
+  }
+
+  /**
+   * Event handler method, is running in a loop using `requestAnimationFrame`
+   *
+   * @internal
+   */
+  private handleEvents(): void {
+    const time = this._audioContext.currentTime - this._startTime
+
+    this.getAllTracks().forEach((track) => {
+      const timingKey = this.getActiveTimingKey(track, time)
+
+      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {
+        this.executeEvent(track, timingKey, time)
+        this.setCacheEntry(track, timingKey)
+      }
+    })
+
+    this._eventHandler = window.requestAnimationFrame(() => {
+      this.handleEvents()
+    })
+  }
+
+  /**
+   * Method to execute the event for a given timing key on a given track
+   *
+   * @param track the track to execute the event on
+   * @param timingKey the timing key to execute
+   * @param time current playback time
+   * @internal
+   */
+  private executeEvent(track: string, timingKey: string, time: number): void {
+    this._timings[track][timingKey](this, timingKey, track, time)
+  }
+}

package/src/processors/repeat.ts

@@ -0,0 +1,35 @@
+import { EventFunction, EventTrack, ITrackProcessor } from "../types";
+
+const REPEAT_NAME_REGEX = new RegExp(/repeat:\d:\d:\d/)
+
+export class RepeatTrackProcessor implements ITrackProcessor {
+  deleteOriginTrack = true;
+
+  matches(name: string): boolean {
+    return name.match(REPEAT_NAME_REGEX) !== null
+  }
+
+  process(name: string, track: EventFunction): [string, EventTrack] {
+    if (typeof track != 'function')
+      throw Error(`The value of repeat track "${track}" is not a function`)
+
+    const repeatTrackArgs = name.split(':')
+
+    if (repeatTrackArgs.length != 4)
+      throw Error(`The repeat track "${name}" does not supply the valid amount of arguments`)
+
+    const startTime = parseFloat(repeatTrackArgs[1])
+    const interval = parseFloat(repeatTrackArgs[2])
+    const endTime = parseFloat(repeatTrackArgs[3])
+
+    let time = startTime
+    const tempTrack = {}
+
+    do {
+      tempTrack[time.toString()] = track
+      time += interval
+    } while (time < endTime)
+
+    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]
+  }
+}