aotrautils 0.0.1889 → 0.0.1891

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5470,7 +5470,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -11832,7 +11832,8 @@ createFusrodaClient=function(doOnClientReady, doOnDataReception, urlParam=null,
  	// CAUTION : WORKS BETTER WHEN UNSECURE, BUT 'NEEDS CLIENT BROWSER TO ALLOW MIXED (SECURE/UNSECURE) CONTENT !
 	
 	const fusrodaClient=initClient(false,
-		/*CAUTION : Fusroda Java server requires the Socket IO websocket implementation !!*/true,
+		// TODO : FIXME : REFACTOR THE FUSRODA SERVER TO USE THE WEBSOCKET IMPLEMENTATION !!!
+//		/*CAUTION : Fusroda Java server requires the Socket IO websocket implementation !!*/true
 		/*doOnServerConnection:*/(socketToServerClientInstance)=>{
 		
 		// DBG
@@ -12065,7 +12066,9 @@ window.createOritaMainClient=function(
 
 
 
-	const oritaClient=initClient(false, false, /*doOnServerConnection*/(socketToServerClientInstance)=>{
+	const oritaClient=initClient(false, 
+//		false, 
+		/*doOnServerConnection*/(socketToServerClientInstance)=>{
 
 		// DBG
 		lognow("ORITA MAIN CLIENT : SETTING UP");
@@ -13288,7 +13291,7 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14373,10 +14376,10 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils 3D library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14636,7 +14639,7 @@ getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProviderName=DE
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (19/06/2026-22:43:56)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (25/07/2026-21:58:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14679,7 +14682,7 @@ if(typeof(window)==="undefined")	window=global;
 
 class AORTACClientCell{
 	
-	constructor(serverCellOrigin, model, view, isNodeContext=false){
+	constructor(serverCellOrigin, model, view, isNodeContext=true){
 		
 		this.clientId=getUUID();
 
@@ -14722,7 +14725,9 @@ class AORTACClientCell{
 			
 			
 			// 1) Initial connection
-			self.initialClientInstance=initClient(self.isNodeContext, false, (socketToServerClientInstance, initialClientInstanceLocal)=>{
+			self.initialClientInstance=initClient(self.isNodeContext
+//			,false
+				,(socketToServerClientInstance, initialClientInstanceLocal)=>{
 			
 				// DBG
 				lognow("DEBUG : Starting client...");
@@ -14816,7 +14821,9 @@ class AORTACClientCell{
 				const host=nonull(infos.host,"localhost");
 				const port=nonull(infos.port,"30000");
 				
-				const reconnectedClientInstance=initClient(self.isNodeContext, false, (socketToServerClientInstance, reconnectedClientInstanceLocal)=>{
+				const reconnectedClientInstance=initClient(self.isNodeContext
+//																,false
+																	,(socketToServerClientInstance, reconnectedClientInstanceLocal)=>{
 				
 					// DBG
 					lognow("DEBUG : Starting reconnected client...");
@@ -14998,7 +15005,7 @@ class ClientLobule{
 
 
 
-window.getAORTACClient=function(serverCellOrigin="ws://127.0.0.1:40000", model, view, isNodeContext=false){
+window.getAORTACClient=function(serverCellOrigin="ws://127.0.0.1:40000", model, view, isNodeContext=true){
 	if(nothing(serverCellOrigin)){
 		// TRACE
 		lognow("ERROR : No known server node, cannot connect to servers cells blob. Aborting AORTAC client setup.");
@@ -15213,7 +15220,9 @@ class AORTACServerCell{
 			const outcomingCellHost=nonull(infos.host,"localhost");
 			const outcomingCellPort=nonull(infos.port,"40000");
 			
-			const clientInstance=initClient(true, false, (socketToServerClientInstance)=>{
+			const clientInstance=initClient(true
+//																,false
+																	,(socketToServerClientInstance)=>{
 				
 				
 				const channelsNames=[];
@@ -16751,9 +16760,11 @@ window.fileExists=(filePath)=>{
 //- WEBSOCKETS AND NODEJS :
 
 function isConnected(clientSocket){
-	if(!WebsocketImplementation.useSocketIOImplementation)
-		return (clientSocket.readyState===WebSocket.OPEN)
-	return (clientSocket.connected);
+//	if(!WebsocketImplementation.useSocketIOImplementation)
+		if(!WebsocketImplementation.implementationToUse)
+			return (clientSocket.readyState===WebSocket.OPEN)
+		return WebsocketImplementation.implementationToUse.isConnected(clientSocket);
+//	return (clientSocket.connected);
 }
 
 // Client-side or Server-side :
@@ -16890,7 +16901,8 @@ WebsocketImplementation={
 
 
 		isNodeContext:true,
-		useSocketIOImplementation:false,
+//	useSocketIOImplementation:false,
+		implementationToUse:null,// null is default (WebSocket)
 		useFlatStrings:false,
 		
 		// COMMON METHODS
@@ -16902,12 +16914,16 @@ WebsocketImplementation={
 		//
 		// CONSOLE NODE SERVER/CLIENT
 		//
-		getStatic:(isNodeContext=true, useSocketIOImplementation=/*DEBUG*/false)=>{
+		getStatic:(isNodeContext=true
+//			, useSocketIOImplementation=/*DEBUG*/false
+		)=>{
 			
 			WebsocketImplementation.isNodeContext=isNodeContext;
-			WebsocketImplementation.useSocketIOImplementation=useSocketIOImplementation;
+//		WebsocketImplementation.useSocketIOImplementation=useSocketIOImplementation;
+
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
 
-			if(!WebsocketImplementation.useSocketIOImplementation){
 				// TRACE
 				lognow("INFO : (SERVER/CLIENT) Using native WebSocket implementation.");	
 				
@@ -16927,40 +16943,40 @@ WebsocketImplementation={
 				}
 				
 			}else{
-				// TRACE
-				lognow("INFO : (SERVER/CLIENT) Using socket.io websocket implementation.");	
-				
-				if(isNodeContext){
-					
-					// NODE SERVER :
-					// DBG
-					lognow("INFO : Loading NODE SERVER socket.io libraries.")
-					if(typeof(Socket)==="undefined"){
-						// TRACE
-						console.log("«socket.io» NODE SERVER library not called yet, calling it now.");
-						Socket=require("socket.io");
-					}
-					if(typeof(Socket)==="undefined"){
-						// TRACE
-						console.log("ERROR : «socket.io» NODE CLIENT/SERVER library not found. Cannot launch nodejs server. Aborting.");
-					}
-					
-					// NODE CLIENT :
-					// DBG
-					lognow("INFO : Loading NODE CLIENT socket.io libraries.")
-					if(typeof(io)==="undefined"){
-						// TRACE
-						console.log("«socket.io-client» NODE CLIENT library not called yet, calling it now.");
-						io=require("socket.io-client");
-					}
-					if(typeof(io)==="undefined"){
-						// TRACE
-						console.log("ERROR : «socket-client.io» NODE CLIENT library not found. Cannot launch nodejs server. Aborting.");
-					}
-				}
-
-				
+				window.WebSocket=WebsocketImplementation.implementationToUse.getSocketClass();
 			}
+//				// TRACE
+//				lognow("INFO : (SERVER/CLIENT) Using socket.io websocket implementation.");	
+//				
+//				if(isNodeContext){
+//					
+//					// NODE SERVER :
+//					// DBG
+//					lognow("INFO : Loading NODE SERVER socket.io libraries.")
+//					if(typeof(Socket)==="undefined"){
+//						// TRACE
+//						console.log("«socket.io» NODE SERVER library not called yet, calling it now.");
+//						Socket=require("socket.io");
+//					}
+//					if(typeof(Socket)==="undefined"){
+//						// TRACE
+//						console.log("ERROR : «socket.io» NODE CLIENT/SERVER library not found. Cannot launch nodejs server. Aborting.");
+//					}
+//					
+//					// NODE CLIENT :
+//					// DBG
+//					lognow("INFO : Loading NODE CLIENT socket.io libraries.")
+//					if(typeof(io)==="undefined"){
+//						// TRACE
+//						console.log("«socket.io-client» NODE CLIENT library not called yet, calling it now.");
+//						io=require("socket.io-client");
+//					}
+//					if(typeof(io)==="undefined"){
+//						// TRACE
+//						console.log("ERROR : «socket-client.io» NODE CLIENT library not found. Cannot launch nodejs server. Aborting.");
+//					}
+//				}
+//			}
 
 			// *********************************************************************************
 			
@@ -16970,8 +16986,12 @@ WebsocketImplementation={
 		
 		/*public*//*static*/getMessageDataBothImplementations:(eventOrMessageParam)=>{
 			
-				const eventOrMessage=(!WebsocketImplementation.useSocketIOImplementation?eventOrMessageParam.data:eventOrMessageParam);
-			
+//			const eventOrMessage=(!WebsocketImplementation.useSocketIOImplementation?eventOrMessageParam.data:eventOrMessageParam);
+				const eventOrMessage=
+					(!WebsocketImplementation.implementationToUse)?
+					 eventOrMessageParam.data
+					:WebsocketImplementation.implementationToUse.getData(eventOrMessageParam);
+	
 				let dataResult=eventOrMessage;
 				
 				try{
@@ -16993,42 +17013,43 @@ WebsocketImplementation={
 				throw new Error("ERROR : SERVER : Server launch is not supported in a non-nodejs context for any implementation.");
 			}
 			
-			
-			// TODO : FIXME : Use one single interface !
 			// NODE SERVER MODE ONLY :
 			let serverSocket;
-			if(!WebsocketImplementation.useSocketIOImplementation){
-					
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
 				if(typeof(WebSocketServer)==="undefined")
 					window.WebSocketServer=require("ws");
 				if(typeof(WebSocketServer)==="undefined")
 					// TRACE
 					lognow("ERROR : «ws» CONSOLE SERVER library not found. Cannot launch nodejs server. Aborting.");
 
-				// DOES NOT WORK ANYMORE :
+				// DOES NOT WORK ANYMORE : (< node v20)
 //			serverSocket=new WebSocket.Server({
+			// DOES WORK NOW : (> node v20)	
 				serverSocket=new WebSocketServer.Server({
+				// DOES WORK ALSO : (> node v20)
 //			serverSocket=new window.WebSocketServer.WebSocketServer({
 					server:listenableServer,
-					perMessageDeflate: false,
+					perMessageDeflate: false, // (to improve a bit the  security)
 				});
 				
 			}else{
-				
-				// NOW : socket.io :
-				// Loading socket.io
-//			OLD SYNTAX : serverSocket=Socket.listen(listenableServer);
-				serverSocket=new Socket.Server(listenableServer);
-				
-				if(listenableServer.cert || listenableServer.key){
-					// TRACE :
-					lognow("WARN : CAUTION ! ON TODAY (01/08/2022) socket.io SERVER LIBRARY IS BOGUS AND WON'T WORK (node clients can't connect !!) IF listenableServer IS A https SERVER !!!");
-				}
-				
-				// Setting up the disconnect event for a client :
-				serverSocket.on("endConnection",()=>{
-					serverSocket.disconnect();
-				});
+				serverSocket=WebsocketImplementation.implementationToUse.getServerSocket(listenableServer);
+
+//				
+//				// Loading socket.io
+////			OLD SYNTAX : serverSocket=Socket.listen(listenableServer);
+//				serverSocket=new Socket.Server(listenableServer);
+//				
+//				if(listenableServer.cert || listenableServer.key){
+//					// TRACE :
+//					lognow("WARN : CAUTION ! ON TODAY (01/08/2022) socket.io SERVER LIBRARY IS BOGUS AND WON'T WORK (node clients can't connect !!) IF listenableServer IS A https SERVER !!!");
+//				}
+//				
+//				// Setting up the disconnect event for a client :
+//				serverSocket.on("endConnection",()=>{
+//					serverSocket.disconnect();
+//				});
 			}
 			
 			serverSocket.on("error",(error)=>{
@@ -17048,10 +17069,13 @@ WebsocketImplementation={
 			// To make the server aware of the clients connections states :
 			nodeServerInstance.serverSocket.on("close", function close() {
 				
-				// TODO : FIXME : Use one single interface !
-				if(!WebsocketImplementation.useSocketIOImplementation)	serverClients=nodeServerInstance.serverSocket.clients;
-				// OLD : else																						serverClients=nodeServerInstance.serverSocket.sockets.clients();
-				else																										serverClients=nodeServerInstance.serverSocket.sockets.sockets;
+//			if(!WebsocketImplementation.useSocketIOImplementation)
+				if(!WebsocketImplementation.implementationToUse){
+					serverClients=nodeServerInstance.serverSocket.clients;
+				}else{
+					serverClients=WebsocketImplementation.implementationToUse.getClientSockets();
+// 				serverClients=nodeServerInstance.serverSocket.sockets.sockets;
+				}
 				
 				serverClients.forEach((clientSocket)=>{
 				 	clearInterval(clientSocket.stateCheckInterval);
@@ -17082,8 +17106,9 @@ WebsocketImplementation={
 			
 			// NODE CLIENT MODE ONLY :
 			let clientSocket;
-			if(!WebsocketImplementation.useSocketIOImplementation){
-			
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
+
 				// NEW : ws :
 				if(typeof(WebSocket)==="undefined"){
 					// TRACE
@@ -17094,7 +17119,6 @@ WebsocketImplementation={
 				// TRACE
 				lognow("INFO : CLIENT : Trying to establish connection to server (serverURL:«"+serverURL+"» ; port:«"+port+"» ; isSecure:«"+isSecure+"»)");
 
-
 				clientSocket=new WebSocket(serverURL+":"+port,/*WORKAROUND:*/{ 
 					// CAUTION : SECURITY BREACH :
 					// BUT ALSO NECESSARY TO ALLOW SELF-SIGNED CERTIFICATES USAGE WITH THE YESBOT SYSTEM ON DEV ENVIRONMENTS !
@@ -17103,28 +17127,30 @@ WebsocketImplementation={
 					secure: isSecure
 				});
 				
+				// TODO : FIXME :
+				// !!! CAUTION !!! ON TODAY (06/2026) IT DOES NOT WORK ON NODE VERSIONS > v20 !!!
+				// MEANING IT WILL TRIGGER THE error EVENT FOR NO REASON WITH wss:// !!!
 				clientSocket.addEventListener("error", error=>{
 					// TRACE
 				  lognow("ERROR : (NODEJS) A WebSocket client error occurred while trying to connect to server: error:", error);
 				});
 				
 			}else{
-				// NOW : socket.io :
-				//client on server-side:
+				clientSocket=WebsocketImplementation.implementationToUse.getClientSocket(true);
 				
-				if(WebsocketImplementation.isNodeContext && typeof(io)!=="undefined"){
-					
-//				OLD SYNTAX:	clientSocket=Socket.connect(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
-//				NO :	clientSocket=new Socket.Client(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
-					clientSocket=io(serverURL + ":" + port,{timeout: timeout, secure: isSecure, autoConnect:true});
-					// UNUSEFUL (since we have the autoconnect:true option) : clientSocket.connect();
-					
-					clientSocket.on("connect_error", error=>{
-						// TRACE
-					  lognow("ERROR : (NODEJS) A SocketIO client error occurred while trying to connect to server:", error.message);
-					});
-
-				}
+//				// NOW : socket.io :
+//				//client on server-side:
+//				if(WebsocketImplementation.isNodeContext && typeof(io)!=="undefined"){
+////				OLD SYNTAX:	clientSocket=Socket.connect(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
+////				NO :	clientSocket=new Socket.Client(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
+//					clientSocket=io(serverURL + ":" + port,{timeout: timeout, secure: isSecure, autoConnect:true});
+//					// UNUSEFUL (since we have the autoconnect:true option) : clientSocket.connect();
+//					
+//					clientSocket.on("connect_error", error=>{
+//						// TRACE
+//					  lognow("ERROR : (NODEJS) A SocketIO client error occurred while trying to connect to server:", error.message);
+//					});
+//				}
 			}
 			
 			// DBG
@@ -17147,10 +17173,12 @@ WebsocketImplementation={
 				return null;
 			}
 			
-			// TODO : FIXME : Use one single interface !
 			// BROWSER CLIENT MODE ONLY :
 			let clientSocket;
-			if(!WebsocketImplementation.useSocketIOImplementation){
+
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
+
 				// CAUTION : PARAMETER rejectUnauthorized:false WILL DO NOTHING,
 				// BECAUSE THIS IS COMPLETLY HANDLED BY THE BROWSER SECURITY POLICY !
 				// SO TO CLEAR THE SSL ERROR :
@@ -17162,17 +17190,17 @@ WebsocketImplementation={
 					// TRACE
 				  lognow("ERROR : (BROWSER) A WebSocket client error occurred while trying to connect to server:", error.message);
 				});
-				
-			}else if(typeof(io)!=="undefined"){
-				// OLD SYNTAX :clientSocket=io.connect(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
-				// ALTERNATIVE :
-				clientSocket=io(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
-				
-				clientSocket.on("connect_error", error=>{
-					// TRACE
-				  lognow("ERROR : (BROWSER) A SocketIO client error occurred while trying to connect to server:", error.message);
-				});
-					
+			}else{
+//		}else if(typeof(io)!=="undefined"){
+				WebsocketImplementation.implementationToUse.getClientSocket();
+//			// OLD SYNTAX :clientSocket=io.connect(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
+//			// ALTERNATIVE :
+//			clientSocket=io(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
+//			
+//			clientSocket.on("connect_error", error=>{
+//				// TRACE
+//			  lognow("ERROR : (BROWSER) A SocketIO client error occurred while trying to connect to server:", error.message);
+//			});
 			}
 			
 			// BROWSER CLIENT INSTANCE :
@@ -17973,12 +18001,59 @@ if(typeof(window)==="undefined")	window=global;
 // ==================================================================================================================
 
 
+// TODO : FIXME : DEVELOP...
+// THIS IS HOW A implementationToUse FOR WEBSOCKET TECHNOLOGY MUST BE :
+//
+//return WebsocketImplementation.implementationToUse.isConnected(clientSocket);
+//
+//return WebsocketImplementation.implementationToUse.getSocketClass();
+//
+//return WebsocketImplementation.implementationToUse.getData(eventOrMessageParam)
+//				serverSocket=WebsocketImplementation.implementationToUse.getServerSocket(listenableServer);
+//
+//serverClients=WebsocketImplementation.implementationToUse.getClientSockets();
+//
+//clientSocket=WebsocketImplementation.implementationToUse.getClientSocket(isNodeContext=true);
+//
+//WebsocketImplementation.implementationToUse.send(dataWrapped);
+//WebsocketImplementation.implementationToUse.serverSend(clientSocket, dataWrapped);
+//
+//WebsocketImplementation.implementationToUse.receive((eventOrMessage)=>{	});
+//
+//
+//WebsocketImplementation.implementationToUse.initClientSocket(clientSocket);
+//WebsocketImplementation.implementationToUse.initOnClose(()=>{
+//	foreach(self.onServerLostListeners,l=>{l.execute(self.clientSocket);});
+//});
+//
+//WebsocketImplementation.implementationToUse.initOnReceiveBrowserContext(channelNameParam, (eventOrMessage)=>{ });
+//
+//WebsocketImplementation.implementationToUse.initOnReceiveNodeContext(channelNameParam, serverReceptionEntryPoint);
+//
+//WebsocketImplementation.implementationToUse.getServerClients();
+//
+//if(WebsocketImplementation.implementationToUse.isReady(clientSocket))	return;
+//				WebsocketImplementation.implementationToUse.initOnMessageReceived(doOnMessage);
+//							WebsocketImplementation.implementationToUse.terminate();
+//
+//WebsocketImplementation.implementationToUse.ping();
+//
+//WebsocketImplementation.implementationToUse.doOnPong(()=>{
+//	clientSocket.isConnectionAlive=true;
+//});
+
+
+
+
+// ==================================================================================================================
 
 
 // -Client :
 
 // TODO : Use everywhere it's applicable !
-initClient=function(isNodeContext=true, useSocketIOImplementation=/*DEBUG*/false, doOnServerConnection=null, url, /*OPTIONAL*/port=25000, /*OPTIONAL*/timeout=10000, /*OPTIONAL*/selfParam=null){
+initClient=function(isNodeContext=true
+//	,useSocketIOImplementation=/*DEBUG*/false
+		,doOnServerConnection=null, url, /*OPTIONAL*/port=25000, /*OPTIONAL*/timeout=10000, /*OPTIONAL*/selfParam=null){
 
 	const isSecure=(contains(url.toLowerCase(),"https:") || contains(url.toLowerCase(),"wss:"));
 
@@ -17990,7 +18065,9 @@ initClient=function(isNodeContext=true, useSocketIOImplementation=/*DEBUG*/false
 		// DBG
 		lognow("INFO : Setting up client :... (url:«"+url+"» ; port:«"+port+"»)");
 		
-		let socketToServerClientInstance=WebsocketImplementation.getStatic(isNodeContext, useSocketIOImplementation).connectToServer(url, port, isSecure, timeout);
+		let socketToServerClientInstance=WebsocketImplementation.getStatic(isNodeContext
+//			, useSocketIOImplementation
+		).connectToServer(url, port, isSecure, timeout);
 		if(!socketToServerClientInstance){
 			// TRACE
 			lognow("ERROR : CLIENT : Could not get socketToServerClientInstance, aborting client connection.");
@@ -18205,12 +18282,16 @@ class ClientInstance{
 			this.clientReceptionEntryPoints.push(clientReceptionEntryPoint);
 		}
 
-		const clientSocket=this.clientSocket;
-	  if(WebsocketImplementation.useSocketIOImplementation){
-			// FOR THE SOCKETIO IMPLEMENTATION :
-			clientSocket.on(channelNameParam, (eventOrMessage)=>{
+//	// FOR THE SOCKETIO IMPLEMENTATION :
+//	const clientSocket=this.clientSocket;
+//	if(WebsocketImplementation.useSocketIOImplementation){
+		if(WebsocketImplementation.implementationToUse){
+			WebsocketImplementation.implementationToUse.initOnReceiveBrowserContext(channelNameParam, (eventOrMessage)=>{
 				clientReceptionEntryPoint.execute(eventOrMessage, clientSocket, this.clientReceptionEntryPoints);
 			});
+//		clientSocket.on(channelNameParam, (eventOrMessage)=>{
+//			clientReceptionEntryPoint.execute(eventOrMessage, clientSocket, this.clientReceptionEntryPoints);
+//		});
 		}
 			
 		return this;
@@ -18237,9 +18318,13 @@ class ClientInstance{
 		// (Don't worry, the underlying sub-system will turn it back into Objects without you need to do anything!)					
 		dataWrapped=stringifyObject(dataWrapped);
    	
-		// TODO : FIXME : Use one single interface !
-		if(!WebsocketImplementation.useSocketIOImplementation)	clientSocket.send(dataWrapped);
-  	else																										clientSocket.emit(channelNameParam,dataWrapped);
+//	if(!WebsocketImplementation.useSocketIOImplementation)
+		if(!WebsocketImplementation.implementationToUse){
+			clientSocket.send(dataWrapped);
+  	}else{
+			WebsocketImplementation.implementationToUse.send(dataWrapped);
+// 		clientSocket.emit(channelNameParam,dataWrapped);
+		}
 		
 		return this;
 	}
@@ -18268,20 +18353,29 @@ class ClientInstance{
 			lognow("DEBUG : CLIENT : doOnConnection !");
 			
 			const clientSocket=self.clientSocket;
-		  if(!WebsocketImplementation.useSocketIOImplementation){
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
 				// FOR THE WEBSOCKET IMPLEMENTATION :
 				clientSocket.addEventListener("message", (eventOrMessage)=>{
 					foreach(self.clientReceptionEntryPoints,(clientReceptionEntryPoint)=>{
 						clientReceptionEntryPoint.execute(eventOrMessage, clientSocket, self.clientReceptionEntryPoints);
 					});
 				});
+			}else{
+				WebsocketImplementation.implementationToUse.receive((eventOrMessage)=>{
+					foreach(self.clientReceptionEntryPoints,(clientReceptionEntryPoint)=>{
+						clientReceptionEntryPoint.execute(eventOrMessage, clientSocket, self.clientReceptionEntryPoints);
+					});
+				});
 			}
 
 			doOnConnection(self, clientSocket);
 		};
 		
 		
-		if(!WebsocketImplementation.useSocketIOImplementation){
+//	if(!WebsocketImplementation.useSocketIOImplementation){
+		if(!WebsocketImplementation.implementationToUse){
+
 			// FOR THE WEBSOCKET IMPLEMENTATION :
 			this.clientSocket.addEventListener("open",doAllOnConnection);
 			
@@ -18292,25 +18386,31 @@ class ClientInstance{
 			}
 			
 		}else{
-			// FOR THE SOCKETIO IMPLEMENTATION :
-			this.clientSocket.on("connect",doAllOnConnection);
-
+			WebsocketImplementation.implementationToUse.initClientSocket(this.clientSocket);
 			if(!empty(this.onServerLostListeners)){
-				this.clientSocket.on("close",()=>{
+				WebsocketImplementation.implementationToUse.initOnClose(()=>{
 					foreach(self.onServerLostListeners,l=>{l.execute(self.clientSocket);});
 				});
 			}
-
-			
-			// Client ping handling :
-			// (SocketIO implementation only, the websocket implementation sends back a hidden pong !)
-			// PING-PONG :
-			this.receive("protocol",(message)=>{
-				if(message.type!=="ping")	return;
-				self.send("protocol",{type:"pong"});
-				// // DBG
-				// lognow("DEBUG : CLIENT : Pong sent.");
-			});
+//			// FOR THE SOCKETIO IMPLEMENTATION :
+//			this.clientSocket.on("connect",doAllOnConnection);
+//
+//			if(!empty(this.onServerLostListeners)){
+//				this.clientSocket.on("close",()=>{
+//					foreach(self.onServerLostListeners,l=>{l.execute(self.clientSocket);});
+//				});
+//			}
+//
+//			
+//			// Client ping handling :
+//			// (SocketIO implementation only, the websocket implementation sends back a hidden pong !)
+//			// PING-PONG :
+//			this.receive("protocol",(message)=>{
+//				if(message.type!=="ping")	return;
+//				self.send("protocol",{type:"pong"});
+//				// // DBG
+//				// lognow("DEBUG : CLIENT : Pong sent.");
+//			});
 		}
 		
 		
@@ -18356,7 +18456,6 @@ class ServerReceptionEntryPoint{
 		// Channel information is stored in exchanged data :
 		if(dataWrapped.channelName!==this.channelName) return;
 										
-		// TODO : FIXME : Use one single interface !
 		// Room information is stored in client socket object :
 		const isClientInRoom=WebsocketImplementation.isInRoom(clientSocketParam, this.clientsRoomsTag);
 		
@@ -18441,11 +18540,13 @@ class NodeServerInstance{
 		this.serverReceptionEntryPoints.push(serverReceptionEntryPoint);
 		
 		// SPECIAL FOR THE SOCKETIO IMPLEMENTATION :
-		if(WebsocketImplementation.useSocketIOImplementation){
-			const channelName=serverReceptionEntryPoint.channelName;
-			clientSocket.on(channelName, (eventOrMessage)=>{
-				serverReceptionEntryPoint.execute(eventOrMessage, clientSocket);
-			});
+//	if(WebsocketImplementation.useSocketIOImplementation){
+		if(WebsocketImplementation.implementationToUse){
+			WebsocketImplementation.implementationToUse.initOnReceiveNodeContext(channelNameParam, serverReceptionEntryPoint);
+//			const channelName=serverReceptionEntryPoint.channelName;
+//			clientSocket.on(channelName, (eventOrMessage)=>{
+//				serverReceptionEntryPoint.execute(eventOrMessage, clientSocket);
+//			});
 		}
 		
 		return this;
@@ -18463,10 +18564,14 @@ class NodeServerInstance{
 				// DBG
 				lognow("(SERVER) (server sends to all clients)");
 			
-				// TODO : FIXME : Use one single interface !
 				let serverClients;
-				if(!WebsocketImplementation.useSocketIOImplementation)	serverClients=this.serverSocket.clients;
-				else																										serverClients=this.serverSocket.sockets.sockets;
+//			if(!WebsocketImplementation.useSocketIOImplementation)
+				if(!WebsocketImplementation.implementationToUse){
+					serverClients=this.serverSocket.clients;
+				}else{
+					WebsocketImplementation.implementationToUse.getServerClients();
+//				serverClients=this.serverSocket.sockets.sockets;
+				}
 		    
 		    
 		    serverClients.forEach((clientSocket)=>{
@@ -18486,9 +18591,13 @@ class NodeServerInstance{
 					// (Don't worry, the underlying sub-system will turn it back into Objects without you need to do anything!)					
 					dataWrapped=stringifyObject(dataWrapped);
 					
-					// TODO : FIXME : Use one single interface !
-	      	if(!WebsocketImplementation.useSocketIOImplementation)	clientSocket.send(dataWrapped);
-		      else																										clientSocket.emit(channelName, dataWrapped);
+//	      if(!WebsocketImplementation.useSocketIOImplementation)
+					if(!WebsocketImplementation.implementationToUse){
+						clientSocket.send(dataWrapped);
+		     	}else{
+						WebsocketImplementation.implementationToUse.serverSend(clientSocket, dataWrapped);
+//					clientSocket.emit(channelName, dataWrapped);
+					}
 	
 		    });
 		
@@ -18498,10 +18607,14 @@ class NodeServerInstance{
 			lognow("(SERVER) (server sends to a client)");
 			
 			
-			// TODO : FIXME : Use one single interface !
 			let clientSocket=clientSocketParam;
-			if(!WebsocketImplementation.useSocketIOImplementation)	if(clientSocket.readyState!==WebSocket.OPEN)	return;
-			else																										if(clientSocket.connected)	return;
+//		if(!WebsocketImplementation.useSocketIOImplementation)
+			if(!WebsocketImplementation.implementationToUse){
+				if(clientSocket.readyState!==WebSocket.OPEN)	return;
+			}else{
+				if(WebsocketImplementation.implementationToUse.isReady(clientSocket))	return;
+//			if(clientSocket.connected)	return;
+			}
 	
 	
 			// Room information is stored in client socket object :
@@ -18516,9 +18629,13 @@ class NodeServerInstance{
 			dataWrapped=stringifyObject(dataWrapped);
 			
 			
-			// TODO : FIXME : Use one single interface !
-			if(!WebsocketImplementation.useSocketIOImplementation)	clientSocket.send(dataWrapped);
-	  	else																										clientSocket.emit(channelName,dataWrapped);
+//		if(!WebsocketImplementation.useSocketIOImplementation)
+			if(!WebsocketImplementation.implementationToUse){
+				clientSocket.send(dataWrapped);
+	  	}else{
+				WebsocketImplementation.implementationToUse.serverSend(clientSocket, dataWrapped);
+//			clientSocket.emit(channelName,dataWrapped);
+			}
 	  	
 		}
 	  
@@ -18549,8 +18666,11 @@ class NodeServerInstance{
 				});
 			};
 
-			if(!WebsocketImplementation.useSocketIOImplementation){
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
 				clientSocket.addEventListener("message", doOnMessage);
+			}else{
+				WebsocketImplementation.implementationToUse.initOnMessageReceived(doOnMessage);
 			}
 				
 			doOnConnection(this, clientSocket);
@@ -18558,7 +18678,6 @@ class NodeServerInstance{
 			
 			// DBG
 			lognow("DEBUG : Starting ping-pong with client : clientSocket.clientId:",clientSocket.clientId);
-			lognow("DEBUG : WebsocketImplementation.useSocketIOImplementation:",WebsocketImplementation.useSocketIOImplementation);
 			lognow("DEBUG : clientSocket.readyState:",clientSocket.readyState);
 			
 			
@@ -18574,9 +18693,13 @@ class NodeServerInstance{
   				 	
   				 	clientSocket.removeAllListeners();
   				 	
-			 			// TODO : FIXME : Use one single interface !
-						if(!WebsocketImplementation.useSocketIOImplementation)	clientSocket.terminate();
-						else																										clientSocket.emit("endConnection");
+//					if(!WebsocketImplementation.useSocketIOImplementation)
+						if(!WebsocketImplementation.implementationToUse){
+							clientSocket.terminate();
+						}else{
+							WebsocketImplementation.implementationToUse.terminate();
+//						clientSocket.emit("endConnection");
+						}
 
 			    	if(!empty(self.onClientLostListeners))
 			    		foreach(self.onClientLostListeners,l=>{l.execute(clientSocket);});
@@ -18594,12 +18717,14 @@ class NodeServerInstance{
 			    
 			    clientSocket.isConnectionAlive=false;
 				
-					if(!WebsocketImplementation.useSocketIOImplementation){
+//				if(!WebsocketImplementation.useSocketIOImplementation){
+					if(!WebsocketImplementation.implementationToUse){
 						// FOR THE WEBSOCKET IMPLEMENTATION :
 						clientSocket.ping();
 					}else{
-						// FOR THE SOCKETIO IMPLEMENTATION :
-						self.send("protocol",{type:"ping"}, null, clientSocket);
+						WebsocketImplementation.implementationToUse.ping();
+//					// FOR THE SOCKETIO IMPLEMENTATION :
+//					self.send("protocol",{type:"ping"}, null, clientSocket);
 					}
 
 			    
@@ -18607,18 +18732,21 @@ class NodeServerInstance{
 			
 
 			// PING-PONG :		
-			if(!WebsocketImplementation.useSocketIOImplementation){
+//		if(!WebsocketImplementation.useSocketIOImplementation){
+			if(!WebsocketImplementation.implementationToUse){
 				// FOR THE WEBSOCKET IMPLEMENTATION :
 				clientSocket.on("pong",()=>{
 					clientSocket.isConnectionAlive=true;
 				});
 			}else{
-				// FOR THE SOCKETIO IMPLEMENTATION :
-				this.receive("protocol",(message)=>{
-					if(message.type!=="pong")	return;
+				WebsocketImplementation.implementationToUse.doOnPong(()=>{
 					clientSocket.isConnectionAlive=true;
 				});
-				
+//			// FOR THE SOCKETIO IMPLEMENTATION :
+//			this.receive("protocol",(message)=>{
+//				if(message.type!=="pong")	return;
+//				clientSocket.isConnectionAlive=true;
+//			});
 			}
 			
 		});

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1889",
+	"version": "0.0.1891",
 	"main": "aotrautils.build.js",
 	"description": "A library for vanilla javascript utils (client-side) used in aotra javascript CMS",
 	"author": "Jeremie Ratomposon <info@alqemia.com> (https://alqemia.com)",