aotrautils 0.0.2043 → 0.0.2045

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -457,6 +457,30 @@ if(!window.aotestAllTestsManager){
 // Utility methods for aotest framework :
 
 // UI/CLI ONLY :
+
+window.aotestMethods.getTestsMapForScenarii=(testsArray, scenariiNames=null/*(OPTIONAL)*/)=>{
+	const testsMap={};
+	
+	if(!scenariiNames || scenariiNames=="" || scenariiNames=="*"){// Case we want all tests from all scenarii:
+		foreach(testsArray, (test, testName)=>{
+			// (to avoid doing this treatment several times unecessarily)
+			if(testsMap[testName])	return "continue";
+			testsMap[testName]=test;
+		});
+	}else{
+		foreach(scenariiNames,scenarioName=>{
+			foreach(testsArray,(test,testName)=>{
+				// (to avoid doing this treatment several times unecessarily)
+				if(testsMap[testName])	return "continue";
+				testsMap[testName]=test;
+			},(test, testName)=>(contains(Object.keys(test),scenarioName)));
+		});
+	}
+	
+	return testsMap;
+};
+
+
 window.aotestMethods.getParentTestByScenarioNameInTestsArray=function(testsArray, scenarioName){
 	return foreach(testsArray,test=>{
 		return window.aotestMethods.iterateOverScenariiInSingleTest(test, (parentTest, scenario)=>{
@@ -560,7 +584,7 @@ window.aotestMethods.getScenarioInSingleTest=function(test, scenarioName=null){
 window.aotestMethods.getScenariiInSingleTest=function(test, scenariiNames=null){
 	let results={};
 	window.aotestMethods.iterateOverScenariiInSingleTest(test,(t,s,sName)=>{
-		if(!scenariiNames || contains(scenariiNames, sName)){
+		if(!scenariiNames || scenariiNames=="" || scenariiNames=="*" || contains(scenariiNames, sName)){
 			results[sName]=s;
 		}
 	});
@@ -578,6 +602,7 @@ window.aotestMethods.iterateOverScenariiInSingleTest=function(test, doOnEachIter
 
 
 
+
 /*public*/window.aotestMethods.iterateOverValuesOnClonedObject=function(scenarioParam, doOnIterationForValue, visited=[], valuePath="", isValueFunction=null){
 
 	// CAUTION : We ABSOLUTELY need to iterate over a deep copy, or else it will create weird incomprehensible bugs 
@@ -5485,7 +5510,7 @@ window.AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -13053,7 +13078,7 @@ window.createOritaMicroClient=function(url, port, isNode=false, staticMicroClien
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14142,10 +14167,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 (17/10/2026-01:26:49)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14409,7 +14434,7 @@ window.getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProvider
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (17/10/2026-01:26:49)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (18/10/2026-01:57:55)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -17263,7 +17288,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.";
@@ -17956,9 +17981,9 @@ window.isURLLocalhost=(url)=>{
 
 
 window.assert={};
-window.assert.notNull=(value, errorMessage=null)=>{
+window.assert.notNull=(value, variableName=null, errorMessage=null)=>{
 	if(typeof(value)=="undefined" || value==null)
-		throw new Error(nonull(errorMessage, "ERROR : Value is null."));
+		throw new Error(nonull(errorMessage, (variableName?"ERROR : "+variableName+" is null.":"ERROR : Value is null.")));
 };
 
 
@@ -18429,7 +18454,7 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 		this.clientsRoomsTag=clientsRoomsTag;
 		
 		this.serverReceptionEntryPoints=[];
-		this.asyncPrerequisiteMethods=[];
+		this.asyncPrerequisiteMethods=new Set();
 	}
 	
 	// Executed whenever any message is received on any channel :
@@ -18477,8 +18502,9 @@ window.ServerReceptionEntryPointsBag=class ServerReceptionEntryPointsBag{
 		
 	}
 	
+	
 	addReceiveListenerPrerequisite(asyncPrerequisiteMethod){
-		this.asyncPrerequisiteMethods.push(asyncPrerequisiteMethod);
+		this.asyncPrerequisiteMethods.add(asyncPrerequisiteMethod);
 		// TRACE
 		lognow("INFO : Added prerequisite: asyncPrerequisiteMethods:",asyncPrerequisiteMethod);
 		return this;
@@ -18504,6 +18530,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) ? [] : 
@@ -18511,7 +18541,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){
@@ -18531,11 +18561,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){
@@ -18543,7 +18574,7 @@ window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 		if(!eventOrMessage){
 			// TRACE
 			lognow("ERROR : No message received.");
-			return;
+			return null;
 		}
 		
 		// OLD :
@@ -18562,7 +18593,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){
@@ -18571,7 +18602,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;
 			}
 		}
 
@@ -18588,6 +18619,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);
+	}
+	
 }
 
 
@@ -18641,10 +18679,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 :
@@ -18825,7 +18863,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.2043",
+	"version": "0.0.2045",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "aotrautils",
-			"version": "0.0.2043",
+			"version": "0.0.2045",
 			"license": "HGPL-1.0",
 			"dependencies": {
 				"atob": "^2.1.2",

aotrautils/package.json

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