aotrautils 0.0.2035 → 0.0.2037

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (12/10/2026-22:30:09)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5485,7 +5485,7 @@ window.AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (12/10/2026-22:30:09)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -13041,7 +13041,7 @@ window.createOritaMicroClient=function(url, port, isNode=false, staticMicroClien
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (12/10/2026-22:30:09)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14130,10 +14130,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 (12/10/2026-22:30:09)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (12/10/2026-22:30:09)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14397,7 +14397,7 @@ window.getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProvider
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (12/10/2026-22:30:09)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (13/10/2026-01:15:36)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -16810,11 +16810,11 @@ window.WebsocketImplementation={
 					 || contains(clientsRoomsTag, clientSocket.clientRoomTag));
 		},
 		
-		/*public static*/isInRightChannel(eventOrMessage, channelName){
-			return (!eventOrMessage || empty(eventOrMessage) 
-					 || !eventOrMessage.channelName || empty(eventOrMessage.channelName)
+		/*public static*/isInRightChannel(dataWrapped, channelName){
+			return (!dataWrapped || empty(dataWrapped) 
+					 || !dataWrapped.channelName || empty(dataWrapped.channelName)
 					 || !channelName || empty(channelName) 
-					 || eventOrMessage.channelName==channelName);
+					 || dataWrapped.channelName==channelName);
 		},
 
 		//
@@ -17217,15 +17217,10 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 	};
 	
 	
-	/*private static*/handleHTTPEndpoints=async function(request, response){
+	const /*private static*/HANDLE_HTTP_ENDPOINTS=async function(request, response){
 		const url=new URL(request.url, `https://${request.headers.host}`);
 		
 		
-		// DBG
-		lognow("				DEBUG : handler.httpEndpoints:",handler.httpEndpoints);
-		
-		
-		
 		for(const httpEndpoint of handler.httpEndpoints){
 			
 			
@@ -17241,7 +17236,6 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 					  
 						messageIn={...getRequestURLParameters(request)};
 			
-						return true;
 					}else if(requestHttpMethod=="POST" 
 								&& contains(["POST","PUT","PATCH","DELETE"],httpEndpoint.httpMethod.toUpperCase())){
 									
@@ -17257,6 +17251,8 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 
 						response.writeHead(httpEndpointResultObject.httpStatus, { "Content-Type": "application/json" });
 						response.end(JSON.stringify(httpEndpointResultObject.body));
+						
+						return true;
 					}
 				
 				
@@ -17271,13 +17267,13 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 		return false;
 	};
 	
-	const handler=function(request, response){
+	const handler=nonull(httpHandlerParam, function(request, response){
 
 		try{
 			EXCLUSION_HANDLER(request, response);
-			handleHTTPEndpoints(request, response).then(httpEndpointHasInterceptedRequest=>{
+			HANDLE_HTTP_ENDPOINTS(request, response).then(httpEndpointHasInterceptedRequest=>{
 				if(!httpEndpointHasInterceptedRequest){
-					nonull(httpHandlerParam, DEFAULT_HANDLER_HTTP_FILE_RETRIEVAL)(request, response);
+					DEFAULT_HANDLER_HTTP_FILE_RETRIEVAL(request, response);
 				}
 			}).catch(error=>{
 				// TRACE
@@ -17288,7 +17284,7 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 			lognow("ERROR : An error occurred when trying to process request :error:",error);
 		}
 		
-	};
+	});
 	
 	
 	let listenableServer;
@@ -18132,10 +18128,8 @@ window.ClientReceptionEntryPoint=class ClientReceptionEntryPoint{
 		const dataWrapped=window.WebsocketImplementation.getMessageDataBothImplementations(eventOrMessage);
 		
 		// We check if the message is in the right channel (channel information is stored in exchanged wrapped data) :
-		const channelName=this.channelName;
-		if(dataWrapped.channelName && dataWrapped.channelName!==this.channelName){
-			return;
-		}
+		// Channel information is stored in wrapped exchanged data :
+		if(!window.WebsocketImplementation.isInRightChannel(dataWrapped, this.channelName)) return;
 		
 		// We check if the message is in the right room (r)oom information is stored in client socket object) :
 		if(!window.WebsocketImplementation.isInRoom(clientSocket, this.clientsRoomsTag))	return;
@@ -18404,24 +18398,30 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 	// Executed whenever any message is received on any channel :
 	executeAll(eventOrMessage, clientSocket=null){ // FOR REAL-TIME ONLY :
 		
-		
 		const clientsRoomsTag=this.clientsRoomsTag;
 		if(!window.WebsocketImplementation.isInRoom(clientSocket, clientsRoomsTag)) return;
 		
 		const channelName=this.channelName;
-		if(!window.WebsocketImplementation.isInRightChannel(eventOrMessage, channelName)) return;
+
+		const dataWrapped=window.WebsocketImplementation.getMessageDataBothImplementations(eventOrMessage);
+		
+		// Channel information is stored in wrapped exchanged data :
+		if(!window.WebsocketImplementation.isInRightChannel(dataWrapped, channelName)) return;
 		
-		executeAllPrerequisites(eventOrMessage).then(prequisiteResult=>{
-			const messageModifiedByPrerequisites=prequisiteResult;
+		this.executeAllPrerequisites(dataWrapped, eventOrMessage, clientSocket).then(eventOrMessageParam=>{
+			
+			//DBG
+			lognow("DEBUG : Prerequisite passed, executing server reception points...");
+			
 			foreach(this.serverReceptionEntryPoints, (serverReceptionEntryPoint,i)=>{
 
 				// All listeners are executed IN PARALLEL !
-				serverReceptionEntryPoint.execute(messageModifiedByPrerequisites, clientSocket).then((message)=>{
+				const p=serverReceptionEntryPoint.execute(eventOrMessageParam, clientSocket);
+				p.then((message)=>{
 					/*DO NOTHING*/
 					lognow("SERVER : DEBUG : Server sent message:",message);
 				}).catch(treatmentsChannelError=>{
-					
-					const errorMessage="INFO : An error has occured during the processing of a client message on channel treatments.";
+					const errorMessage="ERROR : An error has occured during the processing of a client message on channel treatments.";
 					
 					// TRACE
 					lognow(errorMessage, treatmentsChannelError);
@@ -18435,11 +18435,9 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 			
 		}).catch(error=>{
 			// TRACE
-			lognow("ERROR : (.executeAll()) A prerequisite encountered an error :", error);
+			lognow("ERROR : (.executeAllPrerequisites()) A prerequisite encountered an error :", error);
 		});
 		
-		
-		
 	}
 	
 	addReceiveListenerPrerequisite(asyncPrerequisiteMethod){
@@ -18449,21 +18447,24 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 		return this;
 	}
 	
-	async executeAllPrerequisites(eventOrMessage){
-		let prequisiteResult=eventOrMessage;
+	async executeAllPrerequisites(dataWrapped, originalEventOrMessage, clientSocket){
+		
+		const message=dataWrapped.data
 		let i=1;
 		try {
-			for(const asyncPrerequisiteMethod of this.asyncPrerequisiteMethods) {
-			  prequisiteResult=await asyncPrerequisiteMethod(prequisiteResult, clientSocket);
+			for(const asyncPrerequisiteMethod of this.asyncPrerequisiteMethods){
+			  await asyncPrerequisiteMethod(message, clientSocket);
 				i++;
 			}
 		}catch(error){
 			// TRACE
 			lognow("ERROR : (.executeAllPrerequisites()) Prerequisite #"+i+" encountered an error :", error);
+			throw error;
 		}
-		return prequisiteResult;
+		return originalEventOrMessage;
 	}
 	
+	// I-
 	// ASYNC
 	addReceiveListener(messageType, asyncDoOnIncomingMessage, httpEndpointDefinition=null){
 		const channelNameParam=this.channelNameParam;
@@ -18472,7 +18473,8 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 														(isArray(messageType) ? messageType : [messageType])
 												);
 		const listenerConfig={listenerMessageTypes:messageTypes, httpEndpointDefinition:httpEndpointDefinition};
-		const serverReceptionEntryPoint=new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, asyncDoOnIncomingMessage);
+		const serverReceptionEntryPoint=
+						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, asyncDoOnIncomingMessage);
 		this.serverReceptionEntryPoints.push(serverReceptionEntryPoint);
 		
 		if(httpEndpointDefinition){
@@ -18498,7 +18500,11 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 		this.asyncDoOnIncomingMessage=asyncDoOnIncomingMessage;
 	}
 	
-	execute(eventOrMessage, clientSocketParam=null){
+	async execute(eventOrMessage, clientSocketParam=null){
+
+		// DBG
+		lognow("DEBUG : ServerReceptionEntryPoint.execute()");
+		
 
 		if(!eventOrMessage){
 			// TRACE
@@ -18517,9 +18523,9 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 
 		const dataWrapped=window.WebsocketImplementation.getMessageDataBothImplementations(eventOrMessage);
 		
-		// Channel information is stored in exchanged data :
-		if(dataWrapped.channelName!==this.channelName) return;
-										
+		// Channel information is stored in wrapped exchanged data :
+		if(!window.WebsocketImplementation.isInRightChannel(dataWrapped, this.channelName)) return;
+
 		// Room information is stored in client socket object :
 		const isClientInRoom=window.WebsocketImplementation.isInRoom(clientSocketParam, this.clientsRoomsTag);
 		if(!isClientInRoom) return;
@@ -18591,15 +18597,16 @@ window.NodeServerInstance=class NodeServerInstance{
 	//sendChainable(channelNameParam, data, clientsRoomsTag=null){
 	//}
 
-	// I- (NOT ASYNC)
+	// I-
+	// NOT ASYNC
 	// DEPRECATED, USE THE NEW API INSTEAD : 
 	receive(channelNameParam, doOnIncomingMessage, listenerConfig=null, clientsRoomsTag=null){
 			
 		// DBG
 		lognow("(SERVER) Registering receive (OLD API) for channel «"+channelNameParam+"»...");
 		
-		const serverReceptionEntryPoint=new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig
-			,doOnIncomingMessage);
+		const serverReceptionEntryPoint=
+						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, doOnIncomingMessage);
 		this.serverReceptionEntryPoints.push(serverReceptionEntryPoint);
 		
 //OLD:	// SPECIAL FOR THE SOCKETIO IMPLEMENTATION :
@@ -18757,7 +18764,9 @@ window.NodeServerInstance=class NodeServerInstance{
 				// We execute the events registration listeners entry points:
 				// DEPRECATED : OLD API :
 				foreach(self.serverReceptionEntryPoints, (serverReceptionEntryPoint,i)=>{
-					serverReceptionEntryPoint.execute(eventOrMessage, clientSocket, true);
+					serverReceptionEntryPoint.execute(eventOrMessage, clientSocket, true).then(()=>{
+						/*DO NOTHING*/
+					});
 				});
 				
 				// NEW API :

aotrautils/package-lock.json

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

aotrautils/package.json

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