aotrautils 0.0.2041 → 0.0.2043

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5485,7 +5485,7 @@ window.AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -5580,6 +5580,18 @@ window.getRequestURLParameters=(request)=>{
 	return parameters;
 };
 
+window.getRequestHeaders=(request)=>{
+	const results={};
+  const visited=new Set();
+  for(let i=0; i<request.rawHeaders.length; i+=2){ // Because req.rawHeaders isn’t an array of pairs. It’s a single flat list where names and values alternate !
+    const headerName=request.rawHeaders[i].toLowerCase();
+    if(visited.has(headerName))	continue;
+    if(headerName in results)	continue;
+    visited.add(headerName);
+		results[headerName]=request.rawHeaders[i+1];
+  }
+  return results;
+}
 
 window.getRequestBody=async function(request, maxSize = 1_000_000){
   const chunks=[];
@@ -13041,7 +13053,7 @@ window.createOritaMicroClient=function(url, port, isNode=false, staticMicroClien
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14130,10 +14142,10 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 window.AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils 3D library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14397,7 +14409,7 @@ window.getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProvider
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (13/10/2026-01:52:42)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -17234,19 +17246,33 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 					if( requestHttpMethod=="GET" &&
 						(!httpEndpoint.httpMethod || empty(httpEndpoint.httpMethod) || httpEndpoint.httpMethod.toUpperCase()=="GET")){
 					  
-						messageIn={...getRequestURLParameters(request)};
+						messageIn={...getRequestURLParameters(request), ...getRequestHeaders(request)};
 			
 					}else if(requestHttpMethod=="POST" 
 								&& contains(["POST","PUT","PATCH","DELETE"],httpEndpoint.httpMethod.toUpperCase())){
 									
-						messageIn={...getRequestURLParameters(request), ...(await getRequestBody(request))};
+						messageIn={...getRequestURLParameters(request), ...getRequestHeaders(request), ...(await getRequestBody(request))};
 					}
 					
 					if(messageIn){
 						let httpEndpointResultObject={httpStatus:200, body:{}};
 						const serverReceptionEntryPoint=httpEndpoint.serverReceptionEntryPoint;
 						if(serverReceptionEntryPoint){
-							httpEndpointResultObject.body=serverReceptionEntryPoint.execute(messageIn, null, false);
+							const dataWrapped={data:messageIn};
+							const eventOrMessage={data:dataWrapped};
+							
+							// (we bypass the channel and message types filters !)
+							try{
+								httpEndpointResultObject.body=await serverReceptionEntryPoint.execute(eventOrMessage, null, false);
+							}catch(treatmentsChannelError){
+								// TODO : FIXME : DUPLICATED CODE !!!
+								const errorMessage="ERROR : An error has occured during the processing of a client message on channel treatments.";
+								// TRACE
+								lognow(errorMessage, treatmentsChannelError);
+								const errorDataWrapped={errorMessage:errorMessage, cause:{message:treatmentsChannelError.message}};
+								httpEndpointResultObject.body=errorDataWrapped;
+								httpEndpointResultObject.httpStatus=500;
+							}
 						}
 
 						response.writeHead(httpEndpointResultObject.httpStatus, { "Content-Type": "application/json" });
@@ -17929,6 +17955,17 @@ window.isURLLocalhost=(url)=>{
 
 
 
+window.assert={};
+window.assert.notNull=(value, errorMessage=null)=>{
+	if(typeof(value)=="undefined" || value==null)
+		throw new Error(nonull(errorMessage, "ERROR : Value is null."));
+};
+
+
+
+
+
+
 /* ## Utility network global methods in a javascript, console (nodejs), or vanilla javascript with no browser environment.
  *
  * This set of methods gathers utility generic-purpose methods usable in any JS project.
@@ -17997,7 +18034,7 @@ if(typeof(window)==="undefined")	window=global;
 //	clientSocket.isConnectionAlive=true;
 //});
 
-
+const ERRORS_CHANNEL_NAME="errors";
 
 
 // ==================================================================================================================
@@ -18397,6 +18434,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 	
 	// Executed whenever any message is received on any channel :
 	executeAll(eventOrMessage, clientSocket=null){ // FOR REAL-TIME ONLY :
+		const self=this;
 		
 		const clientsRoomsTag=this.clientsRoomsTag;
 		if(!window.WebsocketImplementation.isInRoom(clientSocket, clientsRoomsTag)) return;
@@ -18416,25 +18454,25 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 			foreach(this.serverReceptionEntryPoints, (serverReceptionEntryPoint,i)=>{
 
 				// All listeners are executed IN PARALLEL !
-				const p=serverReceptionEntryPoint.execute(eventOrMessageParam, clientSocket);
-				p.then((message)=>{
+				serverReceptionEntryPoint.execute(eventOrMessageParam, clientSocket).then((message)=>{
 					/*DO NOTHING*/
 				}).catch(treatmentsChannelError=>{
+					// TODO : FIXME : DUPLICATED CODE !!!
 					const errorMessage="ERROR : An error has occured during the processing of a client message on channel treatments.";
-					
 					// TRACE
 					lognow(errorMessage, treatmentsChannelError);
-					
 					const errorDataWrapped={errorMessage:errorMessage, cause:treatmentsChannelError};
-					self.sendError(errorDataWrapped, clientSocketParam);
-				
+					self.server.sendError(errorDataWrapped, clientSocket);
 				});
 				
 			});
 			
 		}).catch(error=>{
+			const errorMessage="ERROR : (.executeAllPrerequisites()) A prerequisite encountered an error :";
 			// TRACE
-			lognow("ERROR : (.executeAllPrerequisites()) A prerequisite encountered an error :", error);
+			lognow(errorMessage, error);
+			const errorDataWrapped={errorMessage:errorMessage, cause:error};
+			self.server.sendError(errorDataWrapped, clientSocket);
 		});
 		
 	}
@@ -18470,7 +18508,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 		const clientsRoomsTag=this.clientsRoomsTag;
 		const messageTypes=(!messageType || empty(messageType) ? [] : 
 														(isArray(messageType) ? messageType : [messageType])
-												);
+											 );
 		const listenerConfig={listenerMessageTypes:messageTypes, httpEndpointDefinition:httpEndpointDefinition};
 		const serverReceptionEntryPoint=
 						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, asyncDoOnIncomingMessage);
@@ -18480,6 +18518,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 			// TRACE
 			lognow("INFO : Registered HTTP listener:",httpEndpointDefinition);
 
+			httpEndpointDefinition.serverReceptionEntryPoint=serverReceptionEntryPoint;
 			this.server.httpEndpoints.push(httpEndpointDefinition);
 		}
 		
@@ -18541,7 +18580,11 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 			const dataRestored=restoreClassesInformation(dataLocal);
 			
 			// CAUTION : This method can be ASYNC or NOT ASYNC !!!
-			this.asyncDoOnIncomingMessage(dataRestored, clientSocketParam);
+			// DBG
+			if(isAsyncFunction(this.asyncDoOnIncomingMessage))
+				return await this.asyncDoOnIncomingMessage(dataRestored, clientSocketParam);
+			return this.asyncDoOnIncomingMessage(dataRestored, clientSocketParam);
+			
 		}
 				
 	}
@@ -18638,8 +18681,9 @@ window.NodeServerInstance=class NodeServerInstance{
 		// Channel information is stored in exchanged data :
 		let dataWrapped=saveClassesInformation({channelName:channelName, data:data});
 
-		
-		if(!clientSocketParam){
+		if(!clientSocketParam)	return dataWrapped;
+
+		if(isString(clientSocketParam) && clientSocketParam=="*"){
 			
 				// DBG
 				lognow("(SERVER) (server sends to all clients)");
@@ -18719,7 +18763,29 @@ window.NodeServerInstance=class NodeServerInstance{
 		
 		return dataWrapped;
 	}
-					
+
+
+	/*private*/sendError(error, clientSocketParam=null){
+		// CAUTION ! NEVER DO THIS : clientSocketParam.send(...) ! (because it directly calls  a single socket implementation !)
+
+		let errorMessageToSend=error;		
+		if(contains(typeof(error),"Error")){
+			errorMessageToSend={
+				type: error.type,
+				httpStatus:error.httpStatus,
+				error:(isString(error) ? 
+					{errorMessage:error} 
+				: {errorMessage:error.errorMessage, cause:(error.cause?{message:error.cause.message}:null)})
+			};
+		}
+
+		if(clientSocketParam){
+			return this.send(ERRORS_CHANNEL_NAME, errorMessageToSend, null, clientSocketParam);
+		}
+		return errorMessageToSend;
+	}
+
+	
 
 	onConnectionToClient(doOnConnection, doOnConnectionLost=null){
 		const self=this;
@@ -18761,7 +18827,15 @@ window.NodeServerInstance=class NodeServerInstance{
 				foreach(self.serverReceptionEntryPoints, (serverReceptionEntryPoint,i)=>{
 					serverReceptionEntryPoint.execute(eventOrMessage, clientSocket, true).then(()=>{
 						/*DO NOTHING*/
+					}).catch(treatmentsChannelError=>{
+						// TODO : FIXME : DUPLICATED CODE !!!
+						const errorMessage="ERROR : An error has occured during the processing of a client message on channel treatments.";
+						// TRACE
+						lognow(errorMessage, treatmentsChannelError);
+						const errorDataWrapped={errorMessage:errorMessage, cause:treatmentsChannelError};
+						self.sendError(errorDataWrapped, clientSocket);
 					});
+					
 				});
 				
 				// NEW API :

aotrautils/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.2041",
+	"version": "0.0.2043",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "aotrautils",
-			"version": "0.0.2041",
+			"version": "0.0.2043",
 			"license": "HGPL-1.0",
 			"dependencies": {
 				"atob": "^2.1.2",

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.2041",
+	"version": "0.0.2043",
 	"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)",