@fluex/fluexgl-dsp 0.4.2 → 0.4.3

package/lib/dist/console-codes.d.ts

@@ -1,13 +1,28 @@
 export declare enum ErrorCodes {
-    NO_CONTEXT_PERMISSION = "FLUEXGL@AUDIO_ERROR_0001",
-    NO_FILE_TYPE_FOUND = "FLUEXGL@AUDIO_ERROR_0002",
-    PATH_TO_FILE_NOT_FOUND = "FLUEXGL@AUDIO_ERROR_0003",
-    SAME_MASTER_CHANNEL = "FLUEXGL@AUDIO_ERROR_0004",
-    WASM_MODULE_INITIALIZATION_FAILED = "FLUEXGL@AUDIO_ERROR_0005",
-    PATH_TO_WASM_FILE_NOT_FOUND = "FLUEXGL@AUDIO_ERROR_0006"
+    NO_CONTEXT_PERMISSION = "ERROR:FLUEXGL-DSP@0001",
+    NO_FILE_TYPE_FOUND = "ERROR:FLUEXGL-DSP@0002",
+    PATH_TO_FILE_NOT_FOUND = "ERROR:FLUEXGL-DSP@0003",
+    SAME_MASTER_CHANNEL = "ERROR:FLUEXGL-DSP@0004",
+    WASM_MODULE_INITIALIZATION_FAILED = "ERROR:FLUEXGL-DSP@0005",
+    PATH_TO_WASM_FILE_NOT_FOUND = "ERROR:FLUEXGL-DSP@0006",
+    WASM_COMPILATION_ERROR = "ERROR:FLUEXGL-DSP@0007",
+    WORKLET_NO_WASM_MODULE_INSTANTIATED = "ERROR:FLUEXGL-DSP@0008",
+    EFFECT_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0009",
+    EFFECT_NOT_FOUND = "ERROR:FLUEXGL-DSP@0010",
+    CHANNEL_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0011",
+    CHANNEL_NOT_FOUND = "ERROR:FLUEXGL-DSP@0012",
+    CHANNEL_CANNOT_LINK_TO_ITSELF = "ERROR:FLUEXGL-DSP@0013",
+    CHANNEL_NOT_INITIALIZED = "ERROR:FLUEXGL-DSP@0014",
+    CHANNEL_NOT_SAME_AUDIO_CONTEXT = "ERROR:FLUEXGL-DSP@0015",
+    CHANNEL_ALREADY_LINKED = "ERROR:FLUEXGL-DSP@0016",
+    CHANNEL_POSSIBLE_FEEDBACK_LOOP = "ERROR:FLUEXGL-DSP@0017",
+    AUDIO_CLIP_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0018",
+    AUDIO_CLIP_NOT_FOUND = "ERROR:FLUEXGL-DSP@0019",
+    AUDIO_CLIP_PLAYER_NO_CONTEXT = "ERROR:FLUEXGL-DSP@0020",
+    PANNING_OUT_OF_RANGE = "ERROR:FLUEXGL-DSP@0021"
 }
 export declare enum WarningCodes {
-    NO_DEFAULT_AUDIO_DEVICE_FOUND = "FLUEXGL@AUDIO_WARNING_0001"
+    NO_DEFAULT_AUDIO_DEVICE_FOUND = "WARNING:FLUEXGL-DSP@0001"
 }
 export declare enum SuccessCodes {
 }

package/lib/dist/console-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-codes.d.ts","sourceRoot":"","sources":["../src/console-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,qBAAqB,6BAA6B;IAClD,kBAAkB,6BAA6B;IAC/C,sBAAsB,6BAA6B;IACnD,mBAAmB,6BAA6B;IAChD,iCAAiC,6BAA6B;IAC9D,2BAA2B,6BAA6B;CAC3D;AAED,oBAAY,YAAY;IACpB,6BAA6B,+BAA+B;CAC/D;AAED,oBAAY,YAAY;CAEvB"}
+{"version":3,"file":"console-codes.d.ts","sourceRoot":"","sources":["../src/console-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,qBAAqB,2BAA2B;IAChD,kBAAkB,2BAA2B;IAC7C,sBAAsB,2BAA2B;IACjD,mBAAmB,2BAA2B;IAC9C,iCAAiC,2BAA2B;IAC5D,2BAA2B,2BAA2B;IACtD,sBAAsB,2BAA2B;IACjD,mCAAmC,2BAA2B;IAC9D,uBAAuB,2BAA2B;IAClD,gBAAgB,2BAA2B;IAC3C,wBAAwB,2BAA2B;IACnD,iBAAiB,2BAA2B;IAC5C,6BAA6B,2BAA2B;IACxD,uBAAuB,2BAA2B;IAClD,8BAA8B,2BAA2B;IACzD,sBAAsB,2BAA2B;IACjD,8BAA8B,2BAA2B;IACzD,2BAA2B,2BAA2B;IACtD,oBAAoB,2BAA2B;IAC/C,4BAA4B,2BAA2B;IACvD,oBAAoB,2BAA2B;CAClD;AAED,oBAAY,YAAY;IACpB,6BAA6B,6BAA6B;CAC7D;AAED,oBAAY,YAAY;CAEvB"}

package/lib/dist/console-codes.js

@@ -1,15 +1,30 @@
 export var ErrorCodes;
 (function (ErrorCodes) {
-    ErrorCodes["NO_CONTEXT_PERMISSION"] = "FLUEXGL@AUDIO_ERROR_0001";
-    ErrorCodes["NO_FILE_TYPE_FOUND"] = "FLUEXGL@AUDIO_ERROR_0002";
-    ErrorCodes["PATH_TO_FILE_NOT_FOUND"] = "FLUEXGL@AUDIO_ERROR_0003";
-    ErrorCodes["SAME_MASTER_CHANNEL"] = "FLUEXGL@AUDIO_ERROR_0004";
-    ErrorCodes["WASM_MODULE_INITIALIZATION_FAILED"] = "FLUEXGL@AUDIO_ERROR_0005";
-    ErrorCodes["PATH_TO_WASM_FILE_NOT_FOUND"] = "FLUEXGL@AUDIO_ERROR_0006";
+    ErrorCodes["NO_CONTEXT_PERMISSION"] = "ERROR:FLUEXGL-DSP@0001";
+    ErrorCodes["NO_FILE_TYPE_FOUND"] = "ERROR:FLUEXGL-DSP@0002";
+    ErrorCodes["PATH_TO_FILE_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0003";
+    ErrorCodes["SAME_MASTER_CHANNEL"] = "ERROR:FLUEXGL-DSP@0004";
+    ErrorCodes["WASM_MODULE_INITIALIZATION_FAILED"] = "ERROR:FLUEXGL-DSP@0005";
+    ErrorCodes["PATH_TO_WASM_FILE_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0006";
+    ErrorCodes["WASM_COMPILATION_ERROR"] = "ERROR:FLUEXGL-DSP@0007";
+    ErrorCodes["WORKLET_NO_WASM_MODULE_INSTANTIATED"] = "ERROR:FLUEXGL-DSP@0008";
+    ErrorCodes["EFFECT_ALREADY_ATTACHED"] = "ERROR:FLUEXGL-DSP@0009";
+    ErrorCodes["EFFECT_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0010";
+    ErrorCodes["CHANNEL_ALREADY_ATTACHED"] = "ERROR:FLUEXGL-DSP@0011";
+    ErrorCodes["CHANNEL_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0012";
+    ErrorCodes["CHANNEL_CANNOT_LINK_TO_ITSELF"] = "ERROR:FLUEXGL-DSP@0013";
+    ErrorCodes["CHANNEL_NOT_INITIALIZED"] = "ERROR:FLUEXGL-DSP@0014";
+    ErrorCodes["CHANNEL_NOT_SAME_AUDIO_CONTEXT"] = "ERROR:FLUEXGL-DSP@0015";
+    ErrorCodes["CHANNEL_ALREADY_LINKED"] = "ERROR:FLUEXGL-DSP@0016";
+    ErrorCodes["CHANNEL_POSSIBLE_FEEDBACK_LOOP"] = "ERROR:FLUEXGL-DSP@0017";
+    ErrorCodes["AUDIO_CLIP_ALREADY_ATTACHED"] = "ERROR:FLUEXGL-DSP@0018";
+    ErrorCodes["AUDIO_CLIP_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0019";
+    ErrorCodes["AUDIO_CLIP_PLAYER_NO_CONTEXT"] = "ERROR:FLUEXGL-DSP@0020";
+    ErrorCodes["PANNING_OUT_OF_RANGE"] = "ERROR:FLUEXGL-DSP@0021";
 })(ErrorCodes || (ErrorCodes = {}));
 export var WarningCodes;
 (function (WarningCodes) {
-    WarningCodes["NO_DEFAULT_AUDIO_DEVICE_FOUND"] = "FLUEXGL@AUDIO_WARNING_0001";
+    WarningCodes["NO_DEFAULT_AUDIO_DEVICE_FOUND"] = "WARNING:FLUEXGL-DSP@0001";
 })(WarningCodes || (WarningCodes = {}));
 export var SuccessCodes;
 (function (SuccessCodes) {

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

@@ -1 +1 @@
-{"version":3,"file":"AudioClip.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClip.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,qBAAa,SAAS;IA2BC,IAAI,EAAE,eAAe;IAzBjC,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B,IAAI,EAAE,OAAO,CAAS;IACtB,SAAS,EAAE,OAAO,CAAS;IAC3B,SAAS,EAAE,MAAM,CAAK;IACtB,aAAa,EAAE,MAAM,CAAK;IAE1B,mBAAmB,EAAE,MAAM,CAAM;IAEjC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEtD,OAAO,CAAC,sBAAsB,CAA+B;IAC7D,OAAO,CAAC,yBAAyB,CAAa;IAE9C,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,MAAM,CAEb;gBAEkB,IAAI,EAAE,eAAe;IAExC,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAmBjB,UAAU,CAAC,eAAe,EAAE,eAAe;IAc3C,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAqExC,IAAI,CAAC,OAAO,EAAE,MAAM;IAsBpB,IAAI,IAAI,SAAS,GAAG,IAAI;IAkBxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAcpC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAmBxC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS;IAU/B,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAatD,mCAAmC,IAAI,OAAO;IAc9C,gBAAgB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMnG,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYvF,mBAAmB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAarG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS;IAW/D,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,YAAY;IAIjD,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAW9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAWvC,IAAW,mBAAmB,IAAI,MAAM,CAIvC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,iBAAiB,IAAI,MAAM,CAKrC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;CACJ"}
+{"version":3,"file":"AudioClip.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClip.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,qBAAa,SAAS;IA2BC,IAAI,EAAE,eAAe;IAzBjC,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B,IAAI,EAAE,OAAO,CAAS;IACtB,SAAS,EAAE,OAAO,CAAS;IAC3B,SAAS,EAAE,MAAM,CAAK;IACtB,aAAa,EAAE,MAAM,CAAK;IAE1B,mBAAmB,EAAE,MAAM,CAAM;IAEjC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEtD,OAAO,CAAC,sBAAsB,CAA+B;IAC7D,OAAO,CAAC,yBAAyB,CAAa;IAE9C,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,MAAM,CAEb;gBAEkB,IAAI,EAAE,eAAe;IAExC,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAmBjB,UAAU,CAAC,eAAe,EAAE,eAAe;IAc3C,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAqExC,IAAI,CAAC,OAAO,EAAE,MAAM;IAsBpB,IAAI,IAAI,SAAS,GAAG,IAAI;IAkBxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAUpC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAexC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS;IAU/B,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAatD,mCAAmC,IAAI,OAAO;IAc9C,gBAAgB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMnG,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYvF,mBAAmB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAarG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS;IAW/D,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,YAAY;IAIjD,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAW9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAWvC,IAAW,mBAAmB,IAAI,MAAM,CAIvC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,iBAAiB,IAAI,MAAM,CAKrC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;CACJ"}

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

@@ -2,6 +2,7 @@ import { v4 } from "uuid";
 import { format } from "date-fns";
 import { Debug } from "../../utilities/debugger";
 import { DSP } from "../../index";
+import { ErrorCodes } from "lib/src/console-codes";
 export class AudioClip {
     data;
     id = v4();
@@ -60,7 +61,7 @@ export class AudioClip {
             return Debug.Error("Could not initialize AudioClip, because the AudioClipPlayer somehow has no audio context.", [
                 `AudioClipPlayer id: ${audioClipPlayer.id}`,
                 `AudioClip id: ${this.id}`
-            ]);
+            ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
         this.audioClipPlayer = audioClipPlayer;
         this.context = audioClipPlayer.context;
         this.gainNode = new GainNode(this.context);
@@ -149,11 +150,7 @@ export class AudioClip {
         if (!this.context)
             Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
                 "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetVolume() on this AudioClip.",
-            ]);
-        if (!this.gainNode)
-            Debug.Error("Could not set volume because the gainNode (GainNode) of this AudioClip is undefined.", [
-                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetVolume() on this AudioClip.",
-            ]);
+            ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
         this.gainNode?.gain.setValueAtTime(volume, this.context?.currentTime ?? 0);
         return this;
     }
@@ -161,16 +158,12 @@ export class AudioClip {
         if (!this.context)
             Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
                 "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetPanLevel() on this AudioClip.",
-            ]);
-        if (!this.stereoPannerNode)
-            Debug.Error("Could not set volume because the stereoPannerNode (StereoPannerNode) of this AudioClip is undefined.", [
-                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetPanLevel() on this AudioClip.",
-            ]);
+            ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
         if (panLevel < -1 || panLevel > 1)
             Debug.Error("Could not set the pan level because it is not between -1 and 1.", [
                 `Given value: ${panLevel}.`,
                 `Accepts a value between -1 and 1. Can be a floating number.`
-            ]);
+            ], ErrorCodes.PANNING_OUT_OF_RANGE);
         this.stereoPannerNode?.pan.setValueAtTime(panLevel, this.context?.currentTime ?? 0);
         return this;
     }

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

@@ -17,5 +17,7 @@ export declare class AudioClipPlayer {
     StopAll(): void;
     Dispose(): void;
     SetLabel(label: string): void;
+    get length(): number;
+    get volume(): number;
 }
 //# sourceMappingURL=AudioClipPlayer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AudioClipPlayer.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClipPlayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,eAAe;IAEjB,KAAK,EAAE,MAAM,CAAqB;IAClC,EAAE,EAAE,MAAM,CAAQ;IAElB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7B,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAEvC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAQ;gBAEnC,OAAO,EAAE,YAAY;IAK1B,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAU3C,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAgBtC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAUrC,MAAM,IAAI,IAAI;IAad,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU9B,OAAO,IAAI,IAAI;IAOf,OAAO,IAAI,IAAI;IAYf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGvC"}
+{"version":3,"file":"AudioClipPlayer.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClipPlayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,qBAAa,eAAe;IAEjB,KAAK,EAAE,MAAM,CAAqB;IAClC,EAAE,EAAE,MAAM,CAAQ;IAElB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7B,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAEvC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAQ;gBAEnC,OAAO,EAAE,YAAY;IAK1B,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAU3C,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAgBtC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAUrC,MAAM,IAAI,IAAI;IAad,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU9B,OAAO,IAAI,IAAI;IAOf,OAAO,IAAI,IAAI;IAYf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;CACJ"}

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

@@ -1,5 +1,6 @@
 import { v4 } from "uuid";
 import { Debug } from "../../utilities/debugger";
+import { ErrorCodes } from "lib/src/console-codes";
 export class AudioClipPlayer {
     label = "AudioClipPlayer";
     id = v4();
@@ -15,7 +16,7 @@ export class AudioClipPlayer {
         if (this.audioClips.includes(audioClip))
             return Debug.Error("Could not attach audio clip because it is already part of this channel", [
                 "Call .DetachAudioClip([clip AudioClip]) before attaching audio clip."
-            ]);
+            ], ErrorCodes.AUDIO_CLIP_ALREADY_ATTACHED);
         audioClip.Initialize(this);
         this.audioClips.push(audioClip);
     }
@@ -23,7 +24,7 @@ export class AudioClipPlayer {
         if (!this.audioClips.includes(clip))
             return Debug.Error("Could not detach audio clip because it is not part of this channel", [
                 "Call .AttachAudioClip([clip AudioClip]) before detaching audio clip."
-            ]);
+            ], ErrorCodes.AUDIO_CLIP_NOT_FOUND);
         clip.Stop();
         const self = this;
         this.audioClips.forEach(function (_clip, index) {
@@ -75,4 +76,10 @@ export class AudioClipPlayer {
     SetLabel(label) {
         this.label = label;
     }
+    get length() {
+        return this.audioClips.length;
+    }
+    get volume() {
+        return this.outputGainNode?.gain.value ?? 0;
+    }
 }

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

@@ -12,6 +12,6 @@ export declare class AudioDevice {
     SetMasterChannel(channel: Master): void;
     CreateMasterChannel(): Master;
     GetContext(): AudioContext;
-    CreateChannel(): Channel;
+    CreateChannel(label?: string): Channel;
 }
 //# sourceMappingURL=AudioDevice.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AudioDevice.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioDevice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,WAAW;IAUD,UAAU,EAAE,eAAe;IARvC,EAAE,EAAE,MAAM,CAAQ;IAClB,SAAS,EAAE,MAAM,CAAc;IAE/B,OAAO,EAAE,YAAY,CAAsB;IAE3C,aAAa,EAAE,MAAM,CAA4B;IACjD,cAAc,EAAE,MAAM,EAAE,CAAM;gBAElB,UAAU,EAAE,eAAe;IAEvC,gBAAgB,IAAI,MAAM;IAI1B,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUvC,mBAAmB,IAAI,MAAM;IAQ7B,UAAU,IAAI,YAAY;IAI1B,aAAa,IAAI,OAAO;CAGlC"}
+{"version":3,"file":"AudioDevice.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioDevice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,WAAW;IAUD,UAAU,EAAE,eAAe;IARvC,EAAE,EAAE,MAAM,CAAQ;IAClB,SAAS,EAAE,MAAM,CAAc;IAE/B,OAAO,EAAE,YAAY,CAAsB;IAE3C,aAAa,EAAE,MAAM,CAA4B;IACjD,cAAc,EAAE,MAAM,EAAE,CAAM;gBAElB,UAAU,EAAE,eAAe;IAEvC,gBAAgB,IAAI,MAAM;IAI1B,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUvC,mBAAmB,IAAI,MAAM;IAQ7B,UAAU,IAAI,YAAY;IAI1B,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;CAGhD"}

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

@@ -13,6 +13,7 @@ export class AudioDevice {
     constructor(deviceInfo) {
         this.deviceInfo = deviceInfo;
     }
+    ;
     GetMasterChannel() {
         return this.masterChannel;
     }
@@ -32,7 +33,7 @@ export class AudioDevice {
     GetContext() {
         return this.context;
     }
-    CreateChannel() {
-        return new Channel(this.context);
+    CreateChannel(label) {
+        return new Channel(this.context, label);
     }
 }

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

@@ -14,7 +14,7 @@ export declare class Channel {
     context: AudioContext | null;
     sends: Channel[];
     audioClipPlayer: AudioClipPlayer | null;
-    constructor(context: AudioContext);
+    constructor(context: AudioContext, label?: string);
     private rebuildEffectChain;
     AddEffect(effect: Effector): void;
     AttachEffect(effect: Effector): void;
@@ -27,6 +27,8 @@ export declare class Channel {
     Unsend(channel: Channel | Master): void;
     HasAudioClipPlayer(): boolean;
     UnsendToAllChannels(): void;
-    AttachAudioClip(audioClip: AudioClip): void;
+    AttachAudioClip(audioClip: AudioClip): Channel;
+    Volume(volume?: number): number;
+    Pan(pan?: number): number;
 }
 //# 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;AAEtC,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;IAqBjC,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;IASnB,eAAe,CAAC,SAAS,EAAE,SAAS;CAM9C"}
+{"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"}

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

@@ -2,6 +2,7 @@ import { v4 } from "uuid";
 import { Debug } from "../../utilities/debugger";
 import { AudioClipPlayer } from "./AudioClipPlayer";
 import { Master } from "./Master";
+import { ErrorCodes } from "../../console-codes";
 export class Channel {
     id = v4();
     label = "Channel";
@@ -14,8 +15,9 @@ export class Channel {
     context = null;
     sends = [];
     audioClipPlayer = null;
-    constructor(context) {
+    constructor(context, label) {
         this.context = context;
+        this.label = label ?? this.label;
         this.disconnectAudioNodes(true);
         this.input = new GainNode(context);
         this.stereoPannerNode = new StereoPannerNode(context);
@@ -64,7 +66,7 @@ export class Channel {
         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);
@@ -78,7 +80,7 @@ export class Channel {
         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;
@@ -133,27 +135,27 @@ export class Channel {
         if (channel.id === this.id)
             return Debug.Error("Could not link channel to itself.", [
                 `This channel id: ${this.id}`
-            ]);
+            ], ErrorCodes.CHANNEL_CANNOT_LINK_TO_ITSELF);
         if (!this.isInitialized() || !channel.isInitialized())
             return Debug.Error("Could not link channels because one (or both) channels are not initialized.", [
                 `This channel id: ${this.id} initialized: ${this.isInitialized()}`,
                 `Target channel id: ${channel.id} initialized: ${channel.isInitialized()}`
-            ]);
+            ], ErrorCodes.CHANNEL_NOT_INITIALIZED);
         if (this.context !== channel.context)
             return Debug.Error("Could not link channels because they do not share the same AudioContext.", [
                 `This channel context: ${this.context ? "set" : "null"}`,
                 `Target channel context: ${channel.context ? "set" : "null"}`
-            ]);
+            ], ErrorCodes.CHANNEL_NOT_SAME_AUDIO_CONTEXT);
         if (this.sends.includes(channel))
             return Debug.Error("Could not link channels, because the given channel is already linked with this one.", [
                 `This channel id: ${this.id}`,
                 `Target channel id: ${channel.id}`
-            ]);
+            ], ErrorCodes.CHANNEL_ALREADY_LINKED);
         if (channel.isReachable(this))
             return Debug.Error("Could not link channels because it would create a feedback loop.", [
                 `This channel id: ${this.id}`,
                 `Target channel id: ${channel.id}`
-            ]);
+            ], ErrorCodes.CHANNEL_POSSIBLE_FEEDBACK_LOOP);
         this.output.connect(channel.input);
         this.sends.push(channel);
     }
@@ -178,7 +180,24 @@ export class Channel {
     }
     AttachAudioClip(audioClip) {
         if (!this.audioClipPlayer)
-            return Debug.Error("Cannot not link AudioClip to this channel because this channel's AudioClipPlayer is undefined.");
+            throw Error("Cannot not link AudioClip to this channel because this channel's AudioClipPlayer is undefined.");
         this.audioClipPlayer.AttachAudioClip(audioClip);
+        return this;
+    }
+    Volume(volume) {
+        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;
+    }
+    Pan(pan) {
+        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;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Master.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Master.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,MAAM;IAER,EAAE,EAAE,MAAM,CAAQ;IAElB,QAAQ,EAAE,OAAO,EAAE,CAAM;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAM;IAEzB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC9B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,YAAY;IAmBjC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,kBAAkB;IAuBnB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAapC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAkBpC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAcrC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAkBrC,kBAAkB,IAAI,OAAO;IAI7B,eAAe,CAAC,SAAS,EAAE,SAAS;CAM9C"}
+{"version":3,"file":"Master.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Master.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,qBAAa,MAAM;IAER,EAAE,EAAE,MAAM,CAAQ;IAElB,QAAQ,EAAE,OAAO,EAAE,CAAM;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAM;IAEzB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC9B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,YAAY;IAmBjC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,kBAAkB;IAuBnB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAapC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAkBpC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAcrC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAkBrC,kBAAkB,IAAI,OAAO;IAI7B,eAAe,CAAC,SAAS,EAAE,SAAS;CAM9C"}

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

@@ -1,6 +1,7 @@
 import { v4 } from "uuid";
 import { Debug } from "../../utilities/debugger";
 import { AudioClipPlayer } from "./AudioClipPlayer";
+import { ErrorCodes } from "lib/src/console-codes";
 export class Master {
     id = v4();
     channels = [];
@@ -55,7 +56,7 @@ export class Master {
         if (this.effects.includes(effect))
             return Debug.Error("Could not attach the effect because it is already part of this master channel.", [
                 "Call .DetachEffect([effect Effector]) before attaching the effect."
-            ]);
+            ], ErrorCodes.EFFECT_ALREADY_ATTACHED);
         if (!this.context)
             return this.rebuildEffectChain();
         this.effects.push(effect);
@@ -66,7 +67,7 @@ export class Master {
         if (!this.effects.includes(effect))
             return Debug.Error("Could not detach the effect because it is not part of this master channel.", [
                 "Call .AttachEffect([effect Effector]) before detaching the effect."
-            ]);
+            ], ErrorCodes.EFFECT_NOT_FOUND);
         const self = this;
         this.effects.forEach(function (_effect, index) {
             if (effect.id === _effect.id) {
@@ -80,7 +81,7 @@ export class Master {
         if (this.channels.includes(channel))
             return Debug.Error("Could not attach the channel because it is already part of this master channel.", [
                 "Call .DetachChannel([channel Channel]) before attaching the channel."
-            ]);
+            ], ErrorCodes.CHANNEL_ALREADY_ATTACHED);
         this.channels.push(channel);
         if (channel.output && this.input)
             channel.output.connect(this.input);
@@ -90,7 +91,7 @@ export class Master {
         if (!this.channels.includes(channel))
             return Debug.Error("Could not detach the channel because it is not part of this master channel.", [
                 "Call .AttachChannel([channel Channel]) before detaching the channel."
-            ]);
+            ], ErrorCodes.CHANNEL_NOT_FOUND);
         if (channel.output && this.input)
             channel.output.disconnect(this.input);
         const self = this;

package/lib/dist/utilities/helpers.js

@@ -181,7 +181,7 @@ export function CreateAudioWorkletNode(context, name, data) {
     if (!compiledWebAssemblyModule) {
         Debug.Error("Failed to create audio worklet node, because the web assembly module has not been compiled properly.", [
             `Request audio worklet node: ${name}.`
-        ]);
+        ], ErrorCodes.WORKLET_NO_WASM_MODULE_INSTANTIATED);
         return null;
     }
     try {

package/lib/dist/utilities/web-assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-assembly.d.ts","sourceRoot":"","sources":["../../src/utilities/web-assembly.ts"],"names":[],"mappings":"AAAA,eAAO,IAAI,kBAAkB,EAAE,OAAe,CAAC;AAC/C,eAAO,IAAI,yBAAyB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAW,CAAC;AAEvE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CASrF"}
+{"version":3,"file":"web-assembly.d.ts","sourceRoot":"","sources":["../../src/utilities/web-assembly.ts"],"names":[],"mappings":"AAGA,eAAO,IAAI,kBAAkB,EAAE,OAAe,CAAC;AAC/C,eAAO,IAAI,yBAAyB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAW,CAAC;AAEvE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAcrF"}

package/lib/dist/utilities/web-assembly.js

@@ -1,3 +1,5 @@
+import { Debug } from "./debugger";
+import { ErrorCodes } from "../console-codes";
 export let hasInitializedWasm = false;
 export let compiledWebAssemblyModule = null;
 export async function LoadWebAssemblyModule(path) {
@@ -6,6 +8,10 @@ export async function LoadWebAssemblyModule(path) {
             compiledWebAssemblyModule = module;
             resolve(module);
         }).catch(function (error) {
+            Debug.Error("Failed to load WebAssembly module from path: " + path, [
+                "Make sure the path is correct and the server is serving the .wasm file with the correct MIME type (application/wasm).",
+                "Error details: " + error.message
+            ], ErrorCodes.WASM_COMPILATION_ERROR);
             reject(error);
         });
     });

package/lib/src/console-codes.ts

@@ -1,14 +1,29 @@
 export enum ErrorCodes {
-    NO_CONTEXT_PERMISSION = "FLUEXGL@AUDIO_ERROR_0001",
-    NO_FILE_TYPE_FOUND = "FLUEXGL@AUDIO_ERROR_0002",
-    PATH_TO_FILE_NOT_FOUND = "FLUEXGL@AUDIO_ERROR_0003",
-    SAME_MASTER_CHANNEL = "FLUEXGL@AUDIO_ERROR_0004",
-    WASM_MODULE_INITIALIZATION_FAILED = "FLUEXGL@AUDIO_ERROR_0005",
-    PATH_TO_WASM_FILE_NOT_FOUND = "FLUEXGL@AUDIO_ERROR_0006"
+    NO_CONTEXT_PERMISSION = "ERROR:FLUEXGL-DSP@0001",
+    NO_FILE_TYPE_FOUND = "ERROR:FLUEXGL-DSP@0002",
+    PATH_TO_FILE_NOT_FOUND = "ERROR:FLUEXGL-DSP@0003",
+    SAME_MASTER_CHANNEL = "ERROR:FLUEXGL-DSP@0004",
+    WASM_MODULE_INITIALIZATION_FAILED = "ERROR:FLUEXGL-DSP@0005",
+    PATH_TO_WASM_FILE_NOT_FOUND = "ERROR:FLUEXGL-DSP@0006",
+    WASM_COMPILATION_ERROR = "ERROR:FLUEXGL-DSP@0007",
+    WORKLET_NO_WASM_MODULE_INSTANTIATED = "ERROR:FLUEXGL-DSP@0008",
+    EFFECT_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0009",
+    EFFECT_NOT_FOUND = "ERROR:FLUEXGL-DSP@0010",
+    CHANNEL_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0011",
+    CHANNEL_NOT_FOUND = "ERROR:FLUEXGL-DSP@0012",
+    CHANNEL_CANNOT_LINK_TO_ITSELF = "ERROR:FLUEXGL-DSP@0013",
+    CHANNEL_NOT_INITIALIZED = "ERROR:FLUEXGL-DSP@0014",
+    CHANNEL_NOT_SAME_AUDIO_CONTEXT = "ERROR:FLUEXGL-DSP@0015",
+    CHANNEL_ALREADY_LINKED = "ERROR:FLUEXGL-DSP@0016",
+    CHANNEL_POSSIBLE_FEEDBACK_LOOP = "ERROR:FLUEXGL-DSP@0017",
+    AUDIO_CLIP_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0018",
+    AUDIO_CLIP_NOT_FOUND = "ERROR:FLUEXGL-DSP@0019",
+    AUDIO_CLIP_PLAYER_NO_CONTEXT = "ERROR:FLUEXGL-DSP@0020",
+    PANNING_OUT_OF_RANGE = "ERROR:FLUEXGL-DSP@0021"
 }
 
 export enum WarningCodes {
-    NO_DEFAULT_AUDIO_DEVICE_FOUND = "FLUEXGL@AUDIO_WARNING_0001"
+    NO_DEFAULT_AUDIO_DEVICE_FOUND = "WARNING:FLUEXGL-DSP@0001"
 }
 
 export enum SuccessCodes {

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

@@ -7,6 +7,7 @@ import { Channel } from "./Channel";
 import { AudioClipPlayer } from "./AudioClipPlayer";
 import { Master } from "./Master";
 import { DSP } from "../../index";
+import { ErrorCodes } from "lib/src/console-codes";
 
 type ProgressPayload = Parameters<AudioClipEventMap["progress"]>[0];
 
@@ -87,7 +88,7 @@ export class AudioClip {
         if (!audioClipPlayer.context) return Debug.Error("Could not initialize AudioClip, because the AudioClipPlayer somehow has no audio context.", [
             `AudioClipPlayer id: ${audioClipPlayer.id}`,
             `AudioClip id: ${this.id}`
-        ]);
+        ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
 
         this.audioClipPlayer = audioClipPlayer;
         this.context = audioClipPlayer.context;
@@ -209,11 +210,7 @@ export class AudioClip {
 
         if (!this.context) Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
             "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetVolume() on this AudioClip.",
-        ]);
-
-        if (!this.gainNode) Debug.Error("Could not set volume because the gainNode (GainNode) of this AudioClip is undefined.", [
-            "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetVolume() on this AudioClip.",
-        ]);
+        ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
 
         this.gainNode?.gain.setValueAtTime(volume, this.context?.currentTime ?? 0);
         return this;
@@ -223,16 +220,12 @@ export class AudioClip {
 
         if (!this.context) Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
             "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetPanLevel() on this AudioClip.",
-        ]);
-
-        if (!this.stereoPannerNode) Debug.Error("Could not set volume because the stereoPannerNode (StereoPannerNode) of this AudioClip is undefined.", [
-            "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetPanLevel() on this AudioClip.",
-        ]);
+        ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
 
         if (panLevel < -1 || panLevel > 1) Debug.Error("Could not set the pan level because it is not between -1 and 1.", [
             `Given value: ${panLevel}.`,
             `Accepts a value between -1 and 1. Can be a floating number.`
-        ]);
+        ], ErrorCodes.PANNING_OUT_OF_RANGE);
 
         this.stereoPannerNode?.pan.setValueAtTime(panLevel, this.context?.currentTime ?? 0);
         return this;

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

@@ -4,6 +4,7 @@ import { AudioClip } from "./AudioClip";
 import { Debug } from "../../utilities/debugger";
 import { Channel } from "./Channel";
 import { Master } from "./Master";
+import { ErrorCodes } from "lib/src/console-codes";
 
 export class AudioClipPlayer {
 
@@ -25,7 +26,7 @@ export class AudioClipPlayer {
 
         if (this.audioClips.includes(audioClip)) return Debug.Error("Could not attach audio clip because it is already part of this channel", [
             "Call .DetachAudioClip([clip AudioClip]) before attaching audio clip."
-        ]);
+        ], ErrorCodes.AUDIO_CLIP_ALREADY_ATTACHED);
 
         audioClip.Initialize(this);
         this.audioClips.push(audioClip);
@@ -35,7 +36,7 @@ export class AudioClipPlayer {
 
         if (!this.audioClips.includes(clip)) return Debug.Error("Could not detach audio clip because it is not part of this channel", [
             "Call .AttachAudioClip([clip AudioClip]) before detaching audio clip."
-        ]);
+        ], ErrorCodes.AUDIO_CLIP_NOT_FOUND);
 
         clip.Stop();
 
@@ -102,4 +103,12 @@ export class AudioClipPlayer {
     public SetLabel(label: string): void {
         this.label = label;
     }
+
+    public get length(): number {
+        return this.audioClips.length;
+    }
+
+    public get volume(): number {
+        return this.outputGainNode?.gain.value ?? 0;
+    }
 }

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

@@ -16,7 +16,7 @@ export class AudioDevice {
     public masterChannel: Master = new Master(this.context);
     public masterChannels: Master[] = [];
 
-    constructor(public deviceInfo: MediaDeviceInfo) { }
+    constructor(public deviceInfo: MediaDeviceInfo) {};
 
     public GetMasterChannel(): Master {
         return this.masterChannel;
@@ -44,7 +44,7 @@ export class AudioDevice {
         return this.context;
     }
 
-    public CreateChannel(): Channel {
-        return new Channel(this.context);
+    public CreateChannel(label?: string): Channel {
+        return new Channel(this.context, label);
     }
 }

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

@@ -4,6 +4,7 @@ import { AudioClipPlayer } from "./AudioClipPlayer";
 import { AudioClip } from "./AudioClip";
 import { Master } from "./Master";
 import { Effector } from "./Effector";
+import { ErrorCodes } from "../../console-codes";
 
 export class Channel {
 
@@ -22,8 +23,9 @@ export class Channel {
     public sends: Channel[] = [];
     public audioClipPlayer: AudioClipPlayer | null = null;
 
-    constructor(context: AudioContext) {
+    constructor(context: AudioContext, label?: string) {
         this.context = context;
+        this.label = label ?? this.label;
 
         this.disconnectAudioNodes(true);
 
@@ -91,7 +93,7 @@ export class Channel {
         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;
         }
 
@@ -109,7 +111,7 @@ export class Channel {
         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;
         }
 
@@ -185,27 +187,27 @@ export class Channel {
 
         if (channel.id === this.id) return Debug.Error("Could not link channel to itself.", [
             `This channel id: ${this.id}`
-        ]);
+        ], ErrorCodes.CHANNEL_CANNOT_LINK_TO_ITSELF);
 
         if (!this.isInitialized() || !channel.isInitialized()) return Debug.Error("Could not link channels because one (or both) channels are not initialized.", [
             `This channel id: ${this.id} initialized: ${this.isInitialized()}`,
             `Target channel id: ${channel.id} initialized: ${channel.isInitialized()}`
-        ]);
+        ], ErrorCodes.CHANNEL_NOT_INITIALIZED);
 
         if (this.context !== channel.context) return Debug.Error("Could not link channels because they do not share the same AudioContext.", [
             `This channel context: ${this.context ? "set" : "null"}`,
             `Target channel context: ${channel.context ? "set" : "null"}`
-        ]);
+        ], ErrorCodes.CHANNEL_NOT_SAME_AUDIO_CONTEXT);
 
         if (this.sends.includes(channel)) return Debug.Error("Could not link channels, because the given channel is already linked with this one.", [
             `This channel id: ${this.id}`,
             `Target channel id: ${channel.id}`
-        ]);
+        ], ErrorCodes.CHANNEL_ALREADY_LINKED);
 
         if (channel.isReachable(this)) return Debug.Error("Could not link channels because it would create a feedback loop.", [
             `This channel id: ${this.id}`,
             `Target channel id: ${channel.id}`
-        ]);
+        ], ErrorCodes.CHANNEL_POSSIBLE_FEEDBACK_LOOP);
 
         (this.output as AudioNode).connect(channel.input as AudioNode);
 
@@ -234,16 +236,34 @@ export class Channel {
     public UnsendToAllChannels() {
 
         for (var i: number = 0; i < this.sends.length; i++) {
-
             this.Unsend(this.sends[i]);
             i--;
         }
     }
 
-    public AttachAudioClip(audioClip: AudioClip) {
+    public AttachAudioClip(audioClip: AudioClip): Channel {
 
-        if (!this.audioClipPlayer) return Debug.Error("Cannot not link AudioClip to this channel because this channel's AudioClipPlayer is undefined.");
+        if (!this.audioClipPlayer) throw Error("Cannot not link AudioClip to this channel because this channel's AudioClipPlayer is undefined.");
 
         this.audioClipPlayer.AttachAudioClip(audioClip);
+        return this;
+    }
+
+    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.")
+
+        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.");
+
+        pan && this.stereoPannerNode.pan.setValueAtTime(pan, this.context.currentTime);
+        return pan ?? this.stereoPannerNode.pan.value;
     }
 }

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

@@ -5,6 +5,7 @@ import { Debug } from "../../utilities/debugger";
 import { Effector } from "./Effector";
 import { AudioClipPlayer } from "./AudioClipPlayer";
 import { AudioClip } from "./AudioClip";
+import { ErrorCodes } from "lib/src/console-codes";
 
 export class Master {
 
@@ -77,7 +78,7 @@ export class Master {
 
         if (this.effects.includes(effect)) return Debug.Error("Could not attach the effect because it is already part of this master channel.", [
             "Call .DetachEffect([effect Effector]) before attaching the effect."
-        ]);
+        ], ErrorCodes.EFFECT_ALREADY_ATTACHED);
 
         if(!this.context) return this.rebuildEffectChain();
 
@@ -90,7 +91,7 @@ export class Master {
 
         if (!this.effects.includes(effect)) return Debug.Error("Could not detach the effect because it is not part of this master channel.", [
             "Call .AttachEffect([effect Effector]) before detaching the effect."
-        ]);
+        ], ErrorCodes.EFFECT_NOT_FOUND);
 
         const self = this;
 
@@ -108,7 +109,7 @@ export class Master {
 
         if (this.channels.includes(channel)) return Debug.Error("Could not attach the channel because it is already part of this master channel.", [
             "Call .DetachChannel([channel Channel]) before attaching the channel."
-        ]);
+        ], ErrorCodes.CHANNEL_ALREADY_ATTACHED);
 
         this.channels.push(channel);
 
@@ -122,7 +123,7 @@ export class Master {
 
         if (!this.channels.includes(channel)) return Debug.Error("Could not detach the channel because it is not part of this master channel.", [
             "Call .AttachChannel([channel Channel]) before detaching the channel."
-        ]);
+        ], ErrorCodes.CHANNEL_NOT_FOUND);
 
         if (channel.output && this.input)
             channel.output.disconnect(this.input);

package/lib/src/utilities/helpers.ts

@@ -261,7 +261,7 @@ export function CreateAudioWorkletNode<T = any>(context: AudioContext, name: Aud
     if (!compiledWebAssemblyModule) {
         Debug.Error("Failed to create audio worklet node, because the web assembly module has not been compiled properly.", [
             `Request audio worklet node: ${name}.`
-        ]);
+        ], ErrorCodes.WORKLET_NO_WASM_MODULE_INSTANTIATED);
         return null;
     }
 

package/lib/src/utilities/web-assembly.ts

@@ -1,3 +1,6 @@
+import { Debug } from "./debugger";
+import { ErrorCodes } from "../console-codes";
+
 export let hasInitializedWasm: boolean = false;
 export let compiledWebAssemblyModule: WebAssembly.Module | null = null;
 
@@ -7,6 +10,11 @@ export async function LoadWebAssemblyModule(path: string): Promise<WebAssembly.M
             compiledWebAssemblyModule = module;
             resolve(module);
         }).catch(function (error: Error) {
+            
+            Debug.Error("Failed to load WebAssembly module from path: " + path, [
+                "Make sure the path is correct and the server is serving the .wasm file with the correct MIME type (application/wasm).",
+                "Error details: " + error.message
+            ], ErrorCodes.WASM_COMPILATION_ERROR);
             reject(error);
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fluex/fluexgl-dsp",
-    "version": "0.4.2",
+    "version": "0.4.3",
     "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",