aotrautils 0.0.2042 → 0.0.2044

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (15/10/2026-21:45:11)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5485,7 +5485,7 @@ window.AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (15/10/2026-21:45:11)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -13053,7 +13053,7 @@ window.createOritaMicroClient=function(url, port, isNode=false, staticMicroClien
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (15/10/2026-21:45:11)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14142,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 (15/10/2026-21:45:11)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (15/10/2026-21:45:11)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14409,7 +14409,7 @@ window.getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProvider
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (15/10/2026-21:45:11)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (17/10/2026-02:53:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -17263,7 +17263,7 @@ window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=
 							
 							// (we bypass the channel and message types filters !)
 							try{
-								httpEndpointResultObject.body=await serverReceptionEntryPoint.execute(eventOrMessage, null, false);
+								httpEndpointResultObject.body=await serverReceptionEntryPoint.executeWithAllPrerequisites(dataWrapped, eventOrMessage, null);
 							}catch(treatmentsChannelError){
 								// TODO : FIXME : DUPLICATED CODE !!!
 								const errorMessage="ERROR : An error has occured during the processing of a client message on channel treatments.";
@@ -18034,7 +18034,7 @@ if(typeof(window)==="undefined")	window=global;
 //	clientSocket.isConnectionAlive=true;
 //});
 
-
+const ERRORS_CHANNEL_NAME="errors";
 
 
 // ==================================================================================================================
@@ -18429,11 +18429,12 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 		this.clientsRoomsTag=clientsRoomsTag;
 		
 		this.serverReceptionEntryPoints=[];
-		this.asyncPrerequisiteMethods=[];
+		this.asyncPrerequisiteMethods=new Set();
 	}
 	
 	// 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;
@@ -18461,7 +18462,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 					// TRACE
 					lognow(errorMessage, treatmentsChannelError);
 					const errorDataWrapped={errorMessage:errorMessage, cause:treatmentsChannelError};
-					self.sendError(errorDataWrapped, clientSocket);
+					self.server.sendError(errorDataWrapped, clientSocket);
 				});
 				
 			});
@@ -18471,13 +18472,14 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 			// TRACE
 			lognow(errorMessage, error);
 			const errorDataWrapped={errorMessage:errorMessage, cause:error};
-			self.sendError(errorDataWrapped, clientSocket);
+			self.server.sendError(errorDataWrapped, clientSocket);
 		});
 		
 	}
 	
+	
 	addReceiveListenerPrerequisite(asyncPrerequisiteMethod){
-		this.asyncPrerequisiteMethods.push(asyncPrerequisiteMethod);
+		this.asyncPrerequisiteMethods.add(asyncPrerequisiteMethod);
 		// TRACE
 		lognow("INFO : Added prerequisite: asyncPrerequisiteMethods:",asyncPrerequisiteMethod);
 		return this;
@@ -18503,6 +18505,10 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 	// I-
 	// ASYNC
 	addReceiveListener(messageType, asyncDoOnIncomingMessage, httpEndpointDefinition=null){
+
+		// DBG
+		lognow("(SERVER) (ServerReceptionEntryPointsBag) Registering receive (NEW API) for message type «"+messageType+"»...");
+
 		const channelNameParam=this.channelNameParam;
 		const clientsRoomsTag=this.clientsRoomsTag;
 		const messageTypes=(!messageType || empty(messageType) ? [] : 
@@ -18510,7 +18516,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 											 );
 		const listenerConfig={listenerMessageTypes:messageTypes, httpEndpointDefinition:httpEndpointDefinition};
 		const serverReceptionEntryPoint=
-						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, asyncDoOnIncomingMessage);
+						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, asyncDoOnIncomingMessage, this);
 		this.serverReceptionEntryPoints.push(serverReceptionEntryPoint);
 		
 		if(httpEndpointDefinition){
@@ -18530,11 +18536,12 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 
 window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 	
-	constructor(channelNameParam, clientsRoomsTag, listenerConfig=null, asyncDoOnIncomingMessage){
+	constructor(channelNameParam, clientsRoomsTag, listenerConfig=null, asyncDoOnIncomingMessage, parentServerReceptionEntryPointsBag=null){
 		this.channelName=channelNameParam;
 		this.clientsRoomsTag=clientsRoomsTag;
 		this.listenerConfig=listenerConfig;
 		this.asyncDoOnIncomingMessage=asyncDoOnIncomingMessage;
+		this.parentServerReceptionEntryPointsBag=parentServerReceptionEntryPointsBag;
 	}
 	
 	async execute(eventOrMessage, clientSocketParam=null){
@@ -18542,7 +18549,7 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 		if(!eventOrMessage){
 			// TRACE
 			lognow("ERROR : No message received.");
-			return;
+			return null;
 		}
 		
 		// OLD :
@@ -18561,7 +18568,7 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 
 		// Room information is stored in client socket object :
 		const isClientInRoom=window.WebsocketImplementation.isInRoom(clientSocketParam, this.clientsRoomsTag);
-		if(!isClientInRoom) return;
+		if(!isClientInRoom) return null;
 		
 		
 		if(this.listenerConfig){
@@ -18570,7 +18577,7 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 				// Else we check if the message matches the required message types :
 				if(			dataWrapped.data && dataWrapped.data.type 
 						&& !contains(this.listenerConfig.listenerMessageTypes, dataWrapped.data.type))
-					return;
+					return null;
 			}
 		}
 
@@ -18587,6 +18594,13 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 		}
 				
 	}
+	
+	async executeWithAllPrerequisites(dataWrapped, originalEventOrMessage, clientSocket){
+		if(this.parentServerReceptionEntryPointsBag)
+			await this.parentServerReceptionEntryPointsBag.executeAllPrerequisites(dataWrapped, originalEventOrMessage, clientSocket);
+		return await this.execute(originalEventOrMessage, clientSocket);
+	}
+	
 }
 
 
@@ -18640,10 +18654,10 @@ window.NodeServerInstance=class NodeServerInstance{
 	receive(channelNameParam, doOnIncomingMessage, listenerConfig=null, clientsRoomsTag=null){
 			
 		// DBG
-		lognow("(SERVER) Registering receive (OLD API) for channel «"+channelNameParam+"»...");
+		lognow("(SERVER) (NodeServerInstance) Registering receive (OLD API) for channel «"+channelNameParam+"»...");
 		
 		const serverReceptionEntryPoint=
-						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, doOnIncomingMessage);
+						new window.ServerReceptionEntryPoint(channelNameParam, clientsRoomsTag, listenerConfig, doOnIncomingMessage, null);
 		this.serverReceptionEntryPoints.push(serverReceptionEntryPoint);
 		
 //OLD:	// SPECIAL FOR THE SOCKETIO IMPLEMENTATION :
@@ -18762,7 +18776,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;
@@ -18802,7 +18838,7 @@ 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).then(()=>{
+					serverReceptionEntryPoint.execute(eventOrMessage, clientSocket).then(()=>{
 						/*DO NOTHING*/
 					}).catch(treatmentsChannelError=>{
 						// TODO : FIXME : DUPLICATED CODE !!!

aotrautils/package-lock.json

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

aotrautils/package.json

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