v0.9.10; support 'moduleState: 10' custom error; added 'WebAudio.base64' functions;

Author: fquirin

src/modules/example-processor.js

@@ -30,7 +30,7 @@ class ExampleProcessor extends AudioWorkletProcessor {
 			that.port.postMessage({
 				//Default message type is "processing result", but it can be 'moduleState', 'moduleEvent' and 'moduleResponse' ("on-demand" requests) as well
 				//NOTE: only default processing (no tag) and 'moduleEvent' will be forwarded automatically
-				moduleState: 1,		//1=ready, 2=changed, 9=read for termination
+				moduleState: 1,		//1=ready, 2=changed, 9=ready for termination, 10=custom error
 				moduleInfo: {
 					sourceSamplerate: that.sourceSamplerate,
 					targetSamplerate: that.targetSamplerate,

src/modules/example-worker.js

@@ -44,7 +44,7 @@ function constructWorker(options) {
 	postMessage({
 		//Default message type is "processing result", but it can be 'moduleState', 'moduleEvent' and 'moduleResponse' ("on-demand" requests) as well
 		//NOTE: only default processing (no tag) and 'moduleEvent' will be forwarded automatically
-		moduleState: 1,		//1=ready, 2=changed, 9=read for termination -- for "on-demand" requests outside of normal processing sequence use 'moduleResponse: true'
+		moduleState: 1,		//1=ready, 2=changed, 9=ready for termination, 10=custom error -- for "on-demand" requests outside of normal processing sequence use 'moduleResponse: true'
 		moduleInfo: {
 			hello: "world"
 		}

src/modules/shared/common.js

@@ -75,3 +75,6 @@ CommonConverters.int16ToFloat32BitAudio = function(output, input){
 		return CommonConverters.singleSampleInt16ToFloat32BitAudio(input[i]);
 	}
 }
+CommonConverters.uint8ArrayToBase64String = function(uint8Array){
+	return btoa(uint8Array.reduce(function(data, byte){ return data + String.fromCharCode(byte); }, ''));
+}

src/sepia-web-audio.js

@@ -3,7 +3,7 @@ if (!(typeof SepiaFW == "object")){
 }
 (function (parentModule){
 	var WebAudio = parentModule.webAudio || {};
-	WebAudio.version = "0.9.9";
+	WebAudio.version = "0.9.10";
 
 	//Preparations
 	var AudioContext = window.AudioContext || window.webkitAudioContext;
@@ -324,7 +324,7 @@ if (!(typeof SepiaFW == "object")){
 						if (!event || event.data == undefined){
 							//TODO: simply ignore?
 						}else if (event.data.moduleState == 1){
-							//STATE
+							//STATE: READY
 							thisProcessNode.isReady = true;
 							completeInitCondition("module-" + i);
 							if (event.data.moduleInfo) thisProcessNode.moduleInfo = event.data.moduleInfo;
@@ -336,6 +336,7 @@ if (!(typeof SepiaFW == "object")){
 								completeCallback(initInfo);
 							}
 						}else if (event.data.moduleState == 9 && !thisProcessNode.isTerminated){
+							//STATE: READY TO BE TERMINATED
 							if (typeof thisProcessNode.terminate == "function"){
 								try {
 									thisProcessNode.isTerminated = true;
@@ -345,6 +346,11 @@ if (!(typeof SepiaFW == "object")){
 									onError({name: "TerminateError", message: "Failed to terminate module", info: err});
 								}
 							}
+						}else if (event.data.moduleState == 10){
+							//STATE: CUSTOM INIT. ERROR
+							event.data.error.target = event.target;
+							onError(event.data.error);
+							
 						}else if (event.data.moduleResponse){
 							//RESPONSE to "on-demand" request
 							//TODO: ignore?
@@ -365,14 +371,16 @@ if (!(typeof SepiaFW == "object")){
 						if (moduleSetup.onmessage){
 							moduleSetup.onmessage(event.data, processNodes);
 						}
-					};
+					}
 					function onError(err){
 						//TODO: do something with 'completeInitCondition("module-" + i)' or abort whole processor?
 						var errorMessage;
 						if (err.message && err.message.indexOf("Uncaught {") == 0){
 							err.preventDefault();
 							errorMessage = JSON.parse(err.message.replace(/^Uncaught /, ""));
 							err.message = errorMessage;
+						}else{
+							errorMessage = err;
 						}
 						onProcessorError({
 							name: "AudioModuleProcessorException",
@@ -1425,9 +1433,21 @@ if (!(typeof SepiaFW == "object")){
 			}
 			return bytes;
 		}catch (error){
-			throw new Error("Converting base64 string to bytes failed.");
+			throw new Error("Converting base64 string to Uint8Array bytes array failed.");
 		}
 	}
+	function convertUint8ArrayToBase64String(uint8Array){
+		try {
+			return btoa(uint8Array.reduce(function(data, byte){ return data + String.fromCharCode(byte); }, ''));
+		}catch (error){
+			throw new Error("Converting Uint8Array to base64 string failed.");
+		}
+	}
+	//export
+	WebAudio.base64 = {
+		base64StringToUint8Array: convertBase64ToUint8Array,
+		uint8ArrayToBase64String: convertUint8ArrayToBase64String
+	}
 
 	//Add audio data as audio element to element on page (or body)
 	WebAudio.addAudioElementToPage = function(targetEle, audioData, audioType){