@fluex/fluexgl-dsp 0.4.4 → 0.4.6

package/lib/dist/core/classes/Channel.d.ts

@@ -2,6 +2,7 @@ import { AudioClipPlayer } from "./AudioClipPlayer";
 import { AudioClip } from "./AudioClip";
 import { Master } from "./Master";
 import { Effector } from "./Effector";
+import { ArrayPosition } from "../../typings";
 export declare class Channel {
     id: string;
     label: string;
@@ -16,13 +17,22 @@ export declare class Channel {
     audioClipPlayer: AudioClipPlayer | null;
     constructor(context: AudioContext, label?: string);
     private rebuildEffectChain;
-    AddEffect(effect: Effector): void;
-    AttachEffect(effect: Effector): void;
-    RemoveEffect(effect: Effector): void;
-    DetachEffect(effect: Effector): void;
     private disconnectAudioNodes;
     private isInitialized;
     private isReachable;
+    /**
+     * Public method to manually rebuild the effect chain.
+     * Can be useful when the automatic rebuilt did not
+     * work properly.
+     * @returns
+     */
+    RebuildEffectChain(): void;
+    AddEffect(effect: Effector): Channel;
+    AttachEffect(effect: Effector): Channel;
+    RemoveEffect(effect: Effector): void;
+    RemoveAllEffects(): void;
+    DetachEffect(effect: Effector): void;
+    DetachAllEffects(): void;
     Send(channel: Channel | Master): void;
     Unsend(channel: Channel | Master): void;
     HasAudioClipPlayer(): boolean;
@@ -30,5 +40,10 @@ export declare class Channel {
     AttachAudioClip(audioClip: AudioClip): Channel;
     Volume(volume?: number): number;
     Pan(pan?: number): number;
+    GetEffectsByLabel(label: string): Effector[];
+    GetFirstEffectByLabel(label: string): Effector | null;
+    GetEffectById(id: string): Effector[];
+    GetFirstEffectById(id: string): Effector | null;
+    MoveEffectToIndex(effect: Effector, index: number | ArrayPosition): void;
 }
 //# sourceMappingURL=Channel.d.ts.map

package/lib/dist/core/classes/Channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Channel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,qBAAa,OAAO;IAET,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,CAAa;IAE1B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC/B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEhC,OAAO,EAAE,QAAQ,EAAE,CAAM;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEpC,KAAK,EAAE,OAAO,EAAE,CAAM;IACtB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM;IAsBjD,OAAO,CAAC,kBAAkB;IAsCnB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAmBjC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAIpC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAqBpC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAI3C,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAwBZ,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAkC9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAehC,kBAAkB,IAAI,OAAO;IAI7B,mBAAmB;IAQnB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAQ9C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAS/B,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;CAQnC"}
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Channel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,OAAO;IAET,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,CAAa;IAE1B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC/B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEhC,OAAO,EAAE,QAAQ,EAAE,CAAM;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEpC,KAAK,EAAE,OAAO,EAAE,CAAM;IACtB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM;IAsBjD,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAwBnB;;;;;OAKG;IACI,kBAAkB;IAIlB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAcpC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIvC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAqBpC,gBAAgB;IAMhB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAIpC,gBAAgB;IAIhB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAkC9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAehC,kBAAkB,IAAI,OAAO;IAI7B,mBAAmB;IAOnB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAQ9C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAS/B,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IASzB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAI5C,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAMrD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIrC,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAM/C,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CAmElF"}

package/lib/dist/core/classes/Channel.js

@@ -58,42 +58,6 @@ export class Channel {
         }
         activeEffects[activeEffects.length - 1].audioWorkletNode.connect(this.stereoPannerNode);
     }
-    AddEffect(effect) {
-        if (!this.context) {
-            Debug.Error("Could not add effect because this channel has no AudioContext.");
-            return;
-        }
-        if (this.effects.includes(effect)) {
-            Debug.Error("Could not add effect because it is already part of this channel", [
-                "Call .RemoveEffect([effect Effector]) before adding effect."
-            ], ErrorCodes.EFFECT_ALREADY_ATTACHED);
-            return;
-        }
-        this.effects.push(effect);
-        effect.InitializeOnAttachment(this.context);
-        this.rebuildEffectChain();
-    }
-    AttachEffect(effect) {
-        return this.AddEffect(effect);
-    }
-    RemoveEffect(effect) {
-        if (!this.effects.includes(effect)) {
-            Debug.Error("Could not remove effect, because it is not part of this channel.", [
-                "Call .AddEffect([effect Effector]) before removing effect."
-            ], ErrorCodes.EFFECT_NOT_FOUND);
-            return;
-        }
-        const self = this;
-        this.effects.forEach(function (_effect, index) {
-            if (effect.id === _effect.id)
-                self.effects.splice(index, 1);
-        });
-        effect.audioWorkletNode?.disconnect();
-        this.rebuildEffectChain();
-    }
-    DetachEffect(effect) {
-        return this.RemoveEffect(effect);
-    }
     disconnectAudioNodes(gc) {
         this.input?.disconnect();
         this.stereoPannerNode?.disconnect();
@@ -129,6 +93,54 @@ export class Channel {
         }
         return false;
     }
+    /**
+     * Public method to manually rebuild the effect chain.
+     * Can be useful when the automatic rebuilt did not
+     * work properly.
+     * @returns
+     */
+    RebuildEffectChain() {
+        return this.rebuildEffectChain();
+    }
+    AddEffect(effect) {
+        if (!this.context)
+            throw new Error(`Could not add effect (${effect.id}), to channel (${this.id}), because the channel's AudioContext is undefined.`);
+        if (this.effects.includes(effect))
+            throw new Error(`Could not add effect (${effect.id}), to channel (${this.id}), because it has already been added to the channel.`);
+        this.effects.push(effect);
+        effect.InitializeOnAttachment(this.context);
+        this.rebuildEffectChain();
+        return this;
+    }
+    AttachEffect(effect) {
+        return this.AddEffect(effect);
+    }
+    RemoveEffect(effect) {
+        if (!this.effects.includes(effect)) {
+            Debug.Error("Could not remove effect, because it is not part of this channel.", [
+                "Call .AddEffect([effect Effector]) before removing effect."
+            ], ErrorCodes.EFFECT_NOT_FOUND);
+            return;
+        }
+        const self = this;
+        this.effects.forEach(function (_effect, index) {
+            if (effect.id === _effect.id)
+                self.effects.splice(index, 1);
+        });
+        effect.audioWorkletNode?.disconnect();
+        this.rebuildEffectChain();
+    }
+    RemoveAllEffects() {
+        for (const effect of this.effects) {
+            this.RemoveEffect(effect);
+        }
+    }
+    DetachEffect(effect) {
+        return this.RemoveEffect(effect);
+    }
+    DetachAllEffects() {
+        return this.RemoveAllEffects();
+    }
     Send(channel) {
         if (channel instanceof Master)
             return channel.AttachChannel(this);
@@ -200,4 +212,69 @@ export class Channel {
         pan && this.stereoPannerNode.pan.setValueAtTime(pan, this.context.currentTime);
         return pan ?? this.stereoPannerNode.pan.value;
     }
+    GetEffectsByLabel(label) {
+        return this.effects.filter(effect => effect.label === label);
+    }
+    GetFirstEffectByLabel(label) {
+        const filteredEffects = this.effects.filter(effect => effect.label === label);
+        return filteredEffects.length !== 0 ? filteredEffects[0] : null;
+    }
+    GetEffectById(id) {
+        return this.effects.filter(effect => effect.id === id);
+    }
+    GetFirstEffectById(id) {
+        const filteredEffects = this.effects.filter(effect => effect.id === id);
+        return filteredEffects.length !== 0 ? filteredEffects[0] : null;
+    }
+    MoveEffectToIndex(effect, index) {
+        let fromIndex = -1, matches = 0, i = 0;
+        for (i = 0; i < this.effects.length; i++) {
+            if (this.effects[i].id === effect.id) {
+                if (fromIndex === -1)
+                    fromIndex = i;
+                matches++;
+            }
+        }
+        if (matches === 0)
+            throw new Error("Effect '" + effect.id + "' (" + effect.label + ") could not be found. " +
+                "The effect ID may have changed, or the effect is not attached to this channel.");
+        if (matches > 1)
+            throw new Error("Multiple effects with the ID '" + effect.id + "' are attached to this channel. " +
+                "Make sure every effect has a unique ID.");
+        let toIndex;
+        if (typeof index === "number") {
+            toIndex = index;
+        }
+        else {
+            switch (index) {
+                case "start":
+                    toIndex = 0;
+                    break;
+                case "end":
+                    toIndex = this.effects.length - 1;
+                    break;
+                case "one-after-start":
+                    toIndex = 1;
+                    break;
+                case "one-before-end":
+                    toIndex = this.effects.length - 2;
+                    break;
+                default:
+                    throw new Error("Invalid ArrayPosition: " + String(index));
+            }
+        }
+        if (toIndex < 0)
+            toIndex = 0;
+        if (toIndex >= this.effects.length)
+            toIndex = this.effects.length - 1;
+        if (fromIndex === toIndex)
+            return;
+        const item = this.effects.splice(fromIndex, 1)[0];
+        if (fromIndex < toIndex)
+            toIndex = toIndex - 1;
+        this.effects.splice(toIndex, 0, item);
+        // Initializing the effect is unnessecary because it should have been intialized already
+        // otherwise it could not been found. Rebuilding the effect chain is nessecary though.
+        this.rebuildEffectChain();
+    }
 }

package/lib/dist/core/classes/Effector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Effector.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Effector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGhH,8BAAsB,QAAQ;IAEnB,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,IAAI,EAAE,MAAM,CAAc;IAE1B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE3C,OAAO,CAAC,iCAAiC,CAAkB;IAE3D,OAAO,CAAC,MAAM,CAMb;IAED,OAAO,CAAC,sBAAsB;IAgB9B,SAAS,CAAC,4BAA4B,CAAC,IAAI,EAAE,gBAAgB;IAOtD,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjG,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAarF,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ;IAalG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,gBAAgB,GAAG,QAAQ;aAWpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/E"}
+{"version":3,"file":"Effector.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Effector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiD,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGhG,8BAAsB,QAAQ;IAEnB,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,IAAI,EAAE,MAAM,CAAc;IAE1B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE3C,OAAO,CAAC,iCAAiC,CAAkB;IAE3D,OAAO,CAAC,MAAM,CAMb;IAED,OAAO,CAAC,sBAAsB;IAgB9B,SAAS,CAAC,4BAA4B,CAAC,IAAI,EAAE,gBAAgB;IAQtD,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjG,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAarF,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ;IAalG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,gBAAgB,GAAG,QAAQ;aAWpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/E"}

package/lib/dist/core/classes/Effector.js

@@ -30,6 +30,7 @@ export class Effector {
     registerMessageEventListener(node) {
         if (this.hasRegisteredMessageEventListener)
             return;
+        this.hasRegisteredMessageEventListener = true;
         node.port.onmessage = this.handleIncomingMessages.bind(this);
         Debug.Log(`Succesfully registered event listener on effector ${this.name} (${this.label}) [${this.id}]`);
     }

package/lib/dist/effects/classes/clips/SoftClip.d.ts

@@ -6,7 +6,7 @@ export declare class SoftClip extends Effector {
     drive: number;
     gain: number;
     strictMode: StrictMode;
-    constructor({ drive, gain, strictMode }: Partial<SoftClipOptions>);
+    constructor({ drive, gain, strictMode }?: Partial<SoftClipOptions>);
     InitializeOnAttachment(context: AudioContext): Promise<void>;
     ReturnOptionsAsObject(): SoftClipOptions;
     SetDrive(drive: number): boolean;

package/lib/dist/effects/classes/clips/SoftClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoftClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/SoftClip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwD,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAErH,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;IACjB,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC;IAUpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,qBAAqB,IAAI,eAAe;IAQxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKxC"}
+{"version":3,"file":"SoftClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/SoftClip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwD,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAErH,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;IACjB,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,GAAE,OAAO,CAAC,eAAe,CAAM;IAUzD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,qBAAqB,IAAI,eAAe;IAQxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKxC"}

package/lib/dist/effects/classes/clips/SoftClip.js

@@ -7,7 +7,7 @@ export class SoftClip extends Effector {
     drive = 1;
     gain = 1;
     strictMode = StrictMode.Disabled;
-    constructor({ drive, gain, strictMode }) {
+    constructor({ drive, gain, strictMode } = {}) {
         super();
         this.drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
         this.gain = Math.max(0, CoerceFiniteNumber(gain, this.gain));
@@ -15,8 +15,10 @@ export class SoftClip extends Effector {
         this.strictMode = mode === StrictMode.Enabled ? StrictMode.Enabled : StrictMode.Disabled;
     }
     async InitializeOnAttachment(context) {
-        this.context = context;
-        this.audioWorkletNode = CreateAudioWorkletNode(context, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
+        if (this.context === null)
+            this.context = context;
+        if (this.audioWorkletNode === null)
+            this.audioWorkletNode = CreateAudioWorkletNode(context, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
     }
     ReturnOptionsAsObject() {
         return {

package/lib/dist/index.d.ts

@@ -9,6 +9,6 @@ export { AudioDevice, Channel, Effector, Master, AudioClip, DspPipeline, AudioCl
 export { InitializeDspPipeline, ResolveAudioOutputDevices, ResolveAudioInputDevices, ResolveDefaultAudioInputDevice, ResolveDefaultAudioOutputDevice, LoadAudioSource, LoadAudioSourceFromBlob, LoadWorkletOnAudioDevice, SendMessageToWorklet } from "./utilities/helpers";
 export { SUPPORTED_FILE_TYPES } from "./utilities/constants";
 export { hasInitializedWasm, } from "./utilities/web-assembly";
-export { StrictMode, ProcessorIdentificationCodes, HardClipMessageCommandId, SoftClipMessageCommandId, AudioWorkletProcessorNames, ChorusMessageCommandId, LowPassFilterMessageCommandId } from "./typings";
-export type { DspDebuggerOptions, DspOptions, LoadAudioSourceOptions, AudioSourceData, ChannelOptions, ChannelSpatialization, AudioClipEventMap, AudioClipEvents, AudioClipOnProgressEvent, AudioClipAnalyserProperty, AudioClipAnalyserType, DspPipelineInitializationOptions, DspPipelineInitializationState, ChorusEffectOptions, LowPassFilterOptions, SoftClipOptions, HardClipOptions, EffectorEventMap, IncomingMessageType, IncomingProcessorMessage, ProcessorData, EffectorEvents, } from "./typings";
+export { StrictMode, ProcessorIdentificationCodes, HardClipMessageCommandId, SoftClipMessageCommandId, AudioWorkletProcessorNames, ChorusMessageCommandId, LowPassFilterMessageCommandId, } from "./typings";
+export type { DspDebuggerOptions, DspOptions, LoadAudioSourceOptions, AudioSourceData, ChannelOptions, ChannelSpatialization, AudioClipEventMap, AudioClipEvents, AudioClipOnProgressEvent, AudioClipAnalyserProperty, AudioClipAnalyserType, DspPipelineInitializationOptions, DspPipelineInitializationState, ChorusEffectOptions, LowPassFilterOptions, SoftClipOptions, HardClipOptions, EffectorEventMap, IncomingMessageType, IncomingProcessorMessage, ProcessorData, EffectorEvents, ArrayPosition } from "./typings";
 //# sourceMappingURL=index.d.ts.map

package/lib/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,eAAO,MAAM,GAAG,EAAE,UAYjB,CAAA;AAED,OAAO,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,WAAW,EACX,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,WAAW,EACX,eAAe,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,oBAAoB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,kBAAkB,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACH,UAAU,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAChC,MAAM,WAAW,CAAC;AAEnB,YAAY,EACR,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,cAAc,GACjB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,eAAO,MAAM,GAAG,EAAE,UAYjB,CAAA;AAED,OAAO,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,WAAW,EACX,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,WAAW,EACX,eAAe,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,oBAAoB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,kBAAkB,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACH,UAAU,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,GAChC,MAAM,WAAW,CAAC;AAEnB,YAAY,EACR,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,aAAa,EAChB,MAAM,WAAW,CAAC"}

package/lib/dist/index.js

@@ -5,7 +5,7 @@
 export const DSP = {
     maxMasterChannels: 8,
     maxTotalChannels: 128,
-    sampleRate: 44000,
+    sampleRate: 41000,
     spatialization: "stereo",
     overrideMaxAudioBufferNodes: false,
     debugger: {
@@ -20,4 +20,4 @@ export { AudioDevice, Channel, Effector, Master, AudioClip, DspPipeline, AudioCl
 export { InitializeDspPipeline, ResolveAudioOutputDevices, ResolveAudioInputDevices, ResolveDefaultAudioInputDevice, ResolveDefaultAudioOutputDevice, LoadAudioSource, LoadAudioSourceFromBlob, LoadWorkletOnAudioDevice, SendMessageToWorklet } from "./utilities/helpers";
 export { SUPPORTED_FILE_TYPES } from "./utilities/constants";
 export { hasInitializedWasm, } from "./utilities/web-assembly";
-export { StrictMode, ProcessorIdentificationCodes, HardClipMessageCommandId, SoftClipMessageCommandId, AudioWorkletProcessorNames, ChorusMessageCommandId, LowPassFilterMessageCommandId } from "./typings";
+export { StrictMode, ProcessorIdentificationCodes, HardClipMessageCommandId, SoftClipMessageCommandId, AudioWorkletProcessorNames, ChorusMessageCommandId, LowPassFilterMessageCommandId, } from "./typings";

package/lib/dist/typings.d.ts

@@ -2,6 +2,7 @@ export type ChannelSpatialization = "mono" | "stereo" | "surround";
 export type AudioClipAnalyserType = "pre" | "post";
 export type AudioClipAnalyserProperty = "fftSize" | "minDecibels" | "maxDecibels" | "smoothingTimeConstant";
 export type IncomingMessageType = "message" | "error" | "warning" | "wasm-instantiated";
+export type ArrayPosition = "start" | "middle" | "end" | "one-after-start" | "one-before-end";
 export type AudioClipEvents = {
     [K in keyof AudioClipEventMap]: AudioClipEventMap[K][];
 };

package/lib/dist/typings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typings.d.ts","sourceRoot":"","sources":["../src/typings.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,uBAAuB,CAAC;AAC5G,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,mBAAmB,CAAC;AAExF,MAAM,MAAM,eAAe,GAAG;KACzB,CAAC,IAAI,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE;CACzD,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;KACxB,CAAC,IAAI,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE;CACvD,CAAA;AAED,oBAAY,6BAA6B;IACrC,SAAS,IAAA;IACT,eAAe,IAAA;IACf,IAAI,IAAA;CACP;AAED,oBAAY,sBAAsB;IAC9B,cAAc,IAAA;IACd,UAAU,IAAA;IACV,SAAS,IAAA;IACT,MAAM,IAAA;IACN,WAAW,IAAA;CACd;AAED,oBAAY,wBAAwB;IAChC,QAAQ,IAAA;IACR,OAAO,IAAA;CACV;AAED,oBAAY,wBAAwB;IAChC,QAAQ,IAAA;IACR,OAAO,IAAA;CACV;AAED,oBAAY,0BAA0B;IAClC,UAAU,wBAAwB;IAClC,mBAAmB,iCAAiC;IACpD,aAAa,2BAA2B;IACxC,SAAS,uBAAuB;IAChC,aAAa,2BAA2B;IACxC,WAAW,yBAAyB;IACpC,aAAa,2BAA2B;IACxC,cAAc,4BAA4B;IAC1C,cAAc,4BAA4B;IAC1C,WAAW,yBAAyB;IACpC,MAAM,oBAAoB;IAC1B,OAAO,qBAAqB;IAC5B,MAAM,oBAAoB;IAC1B,MAAM,oBAAoB;IAC1B,QAAQ,sBAAsB;IAC9B,QAAQ,sBAAsB;CACjC;AAED,oBAAY,4BAA4B;IACpC,kBAAkB,yBAAyB;IAC3C,oBAAoB,2BAA2B;IAC/C,4BAA4B,oCAAoC;CACnE;AAED,oBAAY,UAAU;IAClB,QAAQ,IAAO;IACf,OAAO,IAAO;CACjB;AAED,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,qBAAqB,CAAC;IACtC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2BAA2B,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACnC,qBAAqB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,gCAAgC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,4BAA4B,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC1E,4BAA4B,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC1E,0BAA0B,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACxE,mCAAmC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACjF,6BAA6B,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAC9E;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,GAAG,4BAA4B,CAAC,kBAAkB,CAAC;IAC7D,IAAI,EAAE,MAAM,GAAG,4BAA4B,CAAC,oBAAoB,CAAC;IACjE,SAAS,EAAE,MAAM,GAAG,4BAA4B,CAAC,4BAA4B,CAAC;CACjF;AAED,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,CAAC,EAAE,GAAG,CAAC;CACxB"}
+{"version":3,"file":"typings.d.ts","sourceRoot":"","sources":["../src/typings.ts"],"names":[],"mappings":"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"}

package/lib/src/core/classes/Channel.ts

@@ -1,10 +1,12 @@
 import { v4 } from "uuid";
+
 import { Debug } from "../../utilities/debugger";
 import { AudioClipPlayer } from "./AudioClipPlayer";
 import { AudioClip } from "./AudioClip";
 import { Master } from "./Master";
 import { Effector } from "./Effector";
 import { ErrorCodes } from "../../console-codes";
+import { ArrayPosition } from "../../typings";
 
 export class Channel {
 
@@ -73,7 +75,7 @@ export class Channel {
         this.input.connect(activeEffects[0].audioWorkletNode as AudioNode);
 
         for (let i: number = 0; i < activeEffects.length - 1; i++) {
-            
+
             const current = activeEffects[i].audioWorkletNode as AudioNode;
             const next = activeEffects[i + 1].audioWorkletNode as AudioNode;
 
@@ -83,54 +85,6 @@ export class Channel {
         (activeEffects[activeEffects.length - 1].audioWorkletNode as AudioNode).connect(this.stereoPannerNode);
     }
 
-    public AddEffect(effect: Effector): void {
-
-        if (!this.context) {
-            Debug.Error("Could not add effect because this channel has no AudioContext.");
-            return;
-        }
-
-        if (this.effects.includes(effect)) {
-            Debug.Error("Could not add effect because it is already part of this channel", [
-                "Call .RemoveEffect([effect Effector]) before adding effect."
-            ], ErrorCodes.EFFECT_ALREADY_ATTACHED);
-            return;
-        }
-
-        this.effects.push(effect);
-        effect.InitializeOnAttachment(this.context);
-        this.rebuildEffectChain();
-    }
-
-    public AttachEffect(effect: Effector): void {
-        return this.AddEffect(effect);
-    }
-
-    public RemoveEffect(effect: Effector): void {
-
-        if (!this.effects.includes(effect)) {
-            Debug.Error("Could not remove effect, because it is not part of this channel.", [
-                "Call .AddEffect([effect Effector]) before removing effect."
-            ], ErrorCodes.EFFECT_NOT_FOUND);
-            return;
-        }
-
-        const self: Channel = this;
-
-        this.effects.forEach(function (_effect: Effector, index: number): void {
-            if (effect.id === _effect.id)
-                self.effects.splice(index, 1);
-        });
-
-        effect.audioWorkletNode?.disconnect();
-
-        this.rebuildEffectChain();
-    }
-
-    public DetachEffect(effect: Effector): void {
-        return this.RemoveEffect(effect);
-    }
-
     private disconnectAudioNodes(gc?: boolean) {
 
         this.input?.disconnect();
@@ -180,6 +134,69 @@ export class Channel {
         return false;
     }
 
+    /**
+     * Public method to manually rebuild the effect chain.
+     * Can be useful when the automatic rebuilt did not
+     * work properly.
+     * @returns 
+     */
+    public RebuildEffectChain() {
+        return this.rebuildEffectChain();
+    }
+
+    public AddEffect(effect: Effector): Channel {
+
+        if (!this.context)
+            throw new Error(`Could not add effect (${effect.id}), to channel (${this.id}), because the channel's AudioContext is undefined.`);
+
+        if (this.effects.includes(effect))
+            throw new Error(`Could not add effect (${effect.id}), to channel (${this.id}), because it has already been added to the channel.`);
+
+        this.effects.push(effect);
+        effect.InitializeOnAttachment(this.context);
+        this.rebuildEffectChain();
+        return this;
+    }
+
+    public AttachEffect(effect: Effector): Channel {
+        return this.AddEffect(effect);
+    }
+
+    public RemoveEffect(effect: Effector): void {
+
+        if (!this.effects.includes(effect)) {
+            Debug.Error("Could not remove effect, because it is not part of this channel.", [
+                "Call .AddEffect([effect Effector]) before removing effect."
+            ], ErrorCodes.EFFECT_NOT_FOUND);
+            return;
+        }
+
+        const self: Channel = this;
+
+        this.effects.forEach(function (_effect: Effector, index: number): void {
+            if (effect.id === _effect.id)
+                self.effects.splice(index, 1);
+        });
+
+        effect.audioWorkletNode?.disconnect();
+
+        this.rebuildEffectChain();
+    }
+
+    public RemoveAllEffects() {
+        for (const effect of this.effects) {
+            this.RemoveEffect(effect);
+        }
+    }
+
+    public DetachEffect(effect: Effector): void {
+        return this.RemoveEffect(effect);
+    }
+
+    public DetachAllEffects() {
+        return this.RemoveAllEffects();
+    }
+
     public Send(channel: Channel | Master) {
 
         if (channel instanceof Master)
@@ -234,7 +251,6 @@ export class Channel {
     }
 
     public UnsendToAllChannels() {
-
         for (var i: number = 0; i < this.sends.length; i++) {
             this.Unsend(this.sends[i]);
             i--;
@@ -251,19 +267,107 @@ export class Channel {
 
     public Volume(volume?: number): number {
 
-        if(!this.context) throw new Error("Could not set volume on channel, because it's context is undefined.");
-        if(!this.gainNode) throw new Error("Could not set volume on channel, because it's GainNode is undefined.")
+        if (!this.context) throw new Error("Could not set volume on channel, because it's context is undefined.");
+        if (!this.gainNode) throw new Error("Could not set volume on channel, because it's GainNode is undefined.")
 
         volume && this.gainNode.gain.setValueAtTime(volume, this.context.currentTime);
         return volume ?? this.gainNode.gain.value;
     }
 
     public Pan(pan?: number): number {
-        
-        if(!this.context) throw new Error("Could not set pan on channel, because it's context is undefined.");
-        if(!this.stereoPannerNode) throw new Error("Cannot set pan on channel, because it's StereoPannerNode is undefined.");
+
+        if (!this.context) throw new Error("Could not set pan on channel, because it's context is undefined.");
+        if (!this.stereoPannerNode) throw new Error("Cannot set pan on channel, because it's StereoPannerNode is undefined.");
 
         pan && this.stereoPannerNode.pan.setValueAtTime(pan, this.context.currentTime);
         return pan ?? this.stereoPannerNode.pan.value;
     }
+
+    public GetEffectsByLabel(label: string): Effector[] {
+        return this.effects.filter(effect => effect.label === label);
+    }
+
+    public GetFirstEffectByLabel(label: string): Effector | null {
+
+        const filteredEffects: Effector[] = this.effects.filter(effect => effect.label === label);
+        return filteredEffects.length !== 0 ? filteredEffects[0] : null;
+    }
+
+    public GetEffectById(id: string): Effector[] {
+        return this.effects.filter(effect => effect.id === id);
+    }
+
+    public GetFirstEffectById(id: string): Effector | null {
+
+        const filteredEffects: Effector[] = this.effects.filter(effect => effect.id === id);
+        return filteredEffects.length !== 0 ? filteredEffects[0] : null;
+    }
+
+    public MoveEffectToIndex(effect: Effector, index: number | ArrayPosition): void {
+
+        let fromIndex: number = -1,
+            matches: number = 0,
+            i: number = 0;
+
+        for (i = 0; i < this.effects.length; i++) {
+            if (this.effects[i].id === effect.id) {
+                if (fromIndex === -1)
+                    fromIndex = i;
+
+                matches++;
+            }
+        }
+
+        if (matches === 0) throw new Error(
+            "Effect '" + effect.id + "' (" + effect.label + ") could not be found. " +
+            "The effect ID may have changed, or the effect is not attached to this channel."
+        );
+
+        if (matches > 1) throw new Error(
+            "Multiple effects with the ID '" + effect.id + "' are attached to this channel. " +
+            "Make sure every effect has a unique ID."
+        );
+
+        let toIndex: number;
+
+        if (typeof index === "number") {
+            toIndex = index;
+        } else {
+            switch (index) {
+                case "start":
+                    toIndex = 0;
+                    break;
+                case "end":
+                    toIndex = this.effects.length - 1;
+                    break;
+                case "one-after-start":
+                    toIndex = 1;
+                    break;
+                case "one-before-end":
+                    toIndex = this.effects.length - 2;
+                    break;
+                default:
+                    throw new Error("Invalid ArrayPosition: " + String(index));
+            }
+        }
+
+        if (toIndex < 0)
+            toIndex = 0;
+
+        if (toIndex >= this.effects.length)
+            toIndex = this.effects.length - 1;
+
+        if (fromIndex === toIndex) return;
+
+        const item: Effector = this.effects.splice(fromIndex, 1)[0];
+
+        if (fromIndex < toIndex)
+            toIndex = toIndex - 1;
+
+        this.effects.splice(toIndex, 0, item);
+
+        // Initializing the effect is unnessecary because it should have been intialized already
+        // otherwise it could not been found. Rebuilding the effect chain is nessecary though.
+        this.rebuildEffectChain();
+    }
 }

package/lib/src/core/classes/Effector.ts

@@ -1,6 +1,6 @@
 import { v4 } from "uuid";
 
-import { IncomingProcessorMessage, IncomingMessageType, EffectorEvents, EffectorEventMap } from "../../typings";
+import { IncomingProcessorMessage, type EffectorEvents, EffectorEventMap } from "../../typings";
 import { Debug } from "../../utilities/debugger";
 
 export abstract class Effector {
@@ -41,6 +41,7 @@ export abstract class Effector {
     protected registerMessageEventListener(node: AudioWorkletNode) {
         if (this.hasRegisteredMessageEventListener) return;
 
+        this.hasRegisteredMessageEventListener = true;
         node.port.onmessage = this.handleIncomingMessages.bind(this);
         Debug.Log(`Succesfully registered event listener on effector ${this.name} (${this.label}) [${this.id}]`);
     }

package/lib/src/effects/classes/clips/SoftClip.ts

@@ -11,7 +11,7 @@ export class SoftClip extends Effector {
     public gain: number = 1;
     public strictMode: StrictMode = StrictMode.Disabled;
 
-    constructor({ drive, gain, strictMode }: Partial<SoftClipOptions>) {
+    constructor({ drive, gain, strictMode }: Partial<SoftClipOptions> = {}) {
         super();
 
         this.drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
@@ -22,8 +22,12 @@ export class SoftClip extends Effector {
     }
 
     public async InitializeOnAttachment(context: AudioContext): Promise<void> {
-        this.context = context;
-        this.audioWorkletNode = CreateAudioWorkletNode<SoftClipOptions>(context, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
+    
+        if(this.context === null) 
+            this.context = context;
+        
+        if(this.audioWorkletNode === null) 
+            this.audioWorkletNode = CreateAudioWorkletNode<SoftClipOptions>(context, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
     }
 
     public ReturnOptionsAsObject(): SoftClipOptions {

package/lib/src/index.ts

@@ -8,7 +8,7 @@ import { DspOptions } from "./typings";
 export const DSP: DspOptions = {
     maxMasterChannels: 8,
     maxTotalChannels: 128,
-    sampleRate: 44000,
+    sampleRate: 41000,
     spatialization: "stereo",
     overrideMaxAudioBufferNodes: false,
     debugger: {
@@ -80,7 +80,7 @@ export {
     SoftClipMessageCommandId,
     AudioWorkletProcessorNames,
     ChorusMessageCommandId,
-    LowPassFilterMessageCommandId
+    LowPassFilterMessageCommandId,
 } from "./typings";
 
 export type {
@@ -106,4 +106,5 @@ export type {
     IncomingProcessorMessage,
     ProcessorData,
     EffectorEvents,
-} from "./typings";
+    ArrayPosition
+} from "./typings";

package/lib/src/typings.ts

@@ -2,6 +2,8 @@ export type ChannelSpatialization = "mono" | "stereo" | "surround";
 export type AudioClipAnalyserType = "pre" | "post";
 export type AudioClipAnalyserProperty = "fftSize" | "minDecibels" | "maxDecibels" | "smoothingTimeConstant";
 export type IncomingMessageType = "message" | "error" | "warning" | "wasm-instantiated";
+export type ArrayPosition = "start" | "middle" | "end" | "one-after-start" | "one-before-end";
+
 
 export type AudioClipEvents = {
     [K in keyof AudioClipEventMap]: AudioClipEventMap[K][];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fluex/fluexgl-dsp",
-    "version": "0.4.4",
+    "version": "0.4.6",
     "description": "An open-source, web-based DSP library developed alongside FluexGL, designed for creating and manipulating sounds in various contexts.",
     "main": "lib/dist/index.js",
     "types": "lib/dist/index.d.ts",