aotrautils 0.0.1931 → 0.0.1934

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (26/07/2026-17:25:00)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5195,7 +5195,7 @@ window.getPathFileName=(path, fileSeparator="/", removeExtension=false)=>{
 // ======================== Timeout ========================
 
 // CAUTION : This is not a routine, but a single-use timeout !
-window.MonoThreadedTimeout=class {
+window.MonoThreadedTimeout=class MonoThreadedTimeout{
 	constructor(actuator, delayMillis){
 		this.actuator=actuator;
 	}
@@ -5309,7 +5309,7 @@ window.getMonoThreadedRoutine=function(actuator, refreshMillis=null, startDepend
 }
 
 
-window.MonoThreadedGoToGoal=class {
+window.MonoThreadedGoToGoal=class MonoThreadedGoToGoal{
 	constructor(actuator,actualValue,goalValue,refreshMillis=null,totalTimeMillis=1000,mode="linear"){
 		
 		this.actuator=actuator;
@@ -5470,7 +5470,7 @@ window.AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (26/07/2026-17:25:00)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -8982,7 +8982,7 @@ window.playAudioData=function(audioData,audioCtxParam=null,audioBufferSizeParam=
 }
 
 
-window.SoundsLoop=class {
+window.SoundsLoop=class SoundsLoop{
 	constructor(doOnEnded=null){
 
 		this.doOnEnded=doOnEnded;
@@ -9097,7 +9097,7 @@ window.loadSoundsLoop=function(filesPaths,doOnLoaded=null,doOnEnded=null){
 
 const SOUND_FADE_REFRESH_MILLIS=500;
 
-window.Sound=class{
+window.Sound=class Sound{
 	constructor(filePath,doOnEnded=null){
 
 		this.doOnEnded=doOnEnded;
@@ -9440,7 +9440,7 @@ window.drawImageAndCenterWithZooms=function(ctx,image,xParam=0,yParam=0,zooms={z
 // ====================================================== SPRITES ======================================================
 
 
-window.SpriteMonoThreaded=class{
+window.SpriteMonoThreaded=class SpriteMonoThreaded{
 	
 	constructor(imagesPool,/*OPTIONAL*/refreshMillis=null,
 		clipSize={w:100,h:100},scaleFactorW=1,scaleFactorH=1,
@@ -11450,7 +11450,7 @@ window.getPointsFromSVGDString=function(str){
 
 // ========================= FUSRODA CLIENT : =========================
 
-window.VNCFrame2D=class{
+window.VNCFrame2D=class VNCFrame2D{
 	
 	constructor(url, port=4000, htmlConfig={parentElement:null,imageMode:"CSSBackground"}, mouseEventsRefreshMillis=100){
 		
@@ -12985,7 +12985,7 @@ window.createOritaMicroClient=function(url, port, isNode=false, staticMicroClien
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (26/07/2026-17:25:00)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14047,10 +14047,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 (26/07/2026-17:25:00)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (26/07/2026-17:25:00)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14153,7 +14153,7 @@ window.LLMAPIClient=class LLMAPIClient{
 		const parameters=getAPIRequestParameters(messages);
 
 		return new Promise((resolve,reject)=>{
-			window.performHTTPRequest(this.apiURL, "POST", headers, parameters, true).then((responseObj)=>{
+			performHTTPRequest(this.apiURL, "POST", headers, parameters, true).then((responseObj)=>{
 				const responseData=responseObj.responseData;
 				const data=responseData;
 				
@@ -14310,7 +14310,7 @@ window.getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProvider
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (26/07/2026-17:25:00)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (02/08/2026-00:11:11)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14351,7 +14351,7 @@ if(typeof(window)==="undefined")	window=global;
 
 // New implementation :
 
-window.AORTACClientCell=class{
+window.AORTACClientCell=class AORTACClientCell{
 	
 	constructor(serverCellOrigin, model, view, isNodeContext=true){
 		
@@ -14722,7 +14722,7 @@ window.AORTAC_OUTCOMING_SERVERS_CONNECTION_GLOBAL_TIMEOUT=30000;
 window.AORTAC_SERVER_CELL_PERIODICAL_CONNECTIVITY_CHECK_MILLIS=2000;
 
 
-window.AORTACServerCell=class{
+window.AORTACServerCell=class AORTACServerCell{
 	
 	constructor(quorumNumber=1, selfOrigin, outcomingCellsOrigins, model, controller, sslConfig={/*OPTIONAL*/certPath:null,/*OPTIONAL*/keyPath:null}){
 
@@ -16308,7 +16308,7 @@ window.crypto=require("node:crypto");
 
 const FILE_ENCODING="utf8";
 
-const ADD_CORS_HEADER=true;
+const ADD_CORS_HEADER_BY_DEFAULT=true;
 
 
 // DEBUG
@@ -16320,99 +16320,122 @@ if(typeof(require)!=="undefined" && typeof(window.fs)==="undefined" ){
 }
 
 
-// Nodejs filesystem utils :
-if(typeof(window.fs)==="undefined"){
-	// TRACE
-	console.log("WARN : Could not find the nodejs dependency «fs», aborting persister setup.");
-	window.getPersister=()=>{	return null;	};
-	
-}else{
-	
+
+window.Persister=class Persister{
 	
-	window.getPersister=function(dataDirPath,prefix=""){
+	constructor(dataDirPath="./", prefix="", createDirectoryIfNotExists=false){
+		this.dataDirPath=dataDirPath;
+		this.prefix=prefix;
+		this.createDirectoryIfNotExists=createDirectoryIfNotExists;
 		
-		let self={
+	}
+
+	//FILE_NAME_PATTERN:"data.clientId.repositoryName.json",
+	/*private*/getPath(clientId="noclient", repositoryName="norepository"){
 		
-			dataDirPath:dataDirPath,
-			prefix:prefix,
-			
-			//FILE_NAME_PATTERN:"data.clientId.repositoryName.json",
-			/*private*/getPath:function(clientId="noclient", repositoryName="norepository"){
-		//	let path=self.FILE_NAME_PATTERN.replace(new RegExp("@clientId@","g"),clientId);
-				let path=`${self.dataDirPath}`
-								+ (blank(self.prefix)?"":(self.prefix+"."))
-								+`${clientId}.${repositoryName}.json`;
-				return path;
-			},
-			
-			readTreeObjectFromFile:function(clientId="noclient", repositoryName="norepository", keepClassName=false){
-				
-				let path=self.getPath(clientId,repositoryName);
-				let resultFlat=null;
+		const self=this;
 		
-				try{
+//	let path=self.FILE_NAME_PATTERN.replace(new RegExp("@clientId@","g"),clientId);
+		let path=`${self.dataDirPath}`
+						+ (blank(self.prefix)?"":(self.prefix+"."))
+						+`${clientId}.${repositoryName}.json`;
+		return path;
+	}
 
-					resultFlat=window.fs.readFileSync(path, FILE_ENCODING);
-					
-				}catch(error){
-					// TRACE
-					console.log("ERROR : Could not read file «"+path+"».");
+	/*private*/createDirectoryIfNecessary(path){
+		if(!fileExists(path) && this.createDirectoryIfNotExists){
+			// TRACE
+			lognow(`WARN : Directory «${path}» does not exist. We will create it.`);
+			createDirectory(path);	
+		}
+	}
+	
+	readTreeObjectFromFile(clientId="noclient", repositoryName="norepository", keepClassName=false){
+		const self=this;
+
+		let resultFlat=null;
+		let path=self.getPath(clientId, repositoryName);
+		this.createDirectoryIfNecessary(path);
 		
-					return null;
-				}
-				
-				
-				let resultData={};
-				
-				// 1)
-				if(!empty(resultFlat))	resultData=parseJSON(resultFlat);
-				
-				// 2)
-				if(!empty(resultData) && isFlatMap(resultData)){
-					// CAUTION : We have to keep the type information, here too ! (in the sub-objects)				
-					resultData=getAsTreeStructure(resultData, keepClassName);
-				}
-				
-				return resultData;
-			},
+		
+		try{
 
+			resultFlat=window.fs.readFileSync(path, FILE_ENCODING);
 			
-			saveDataToFileForClient:function(clientId,repositoryName,dataFlatForClient,forceKeepUnflatten=false,doOnSuccess=null){
-				
-				if(!empty(dataFlatForClient) && !isFlatMap(dataFlatForClient) && !forceKeepUnflatten){
-					dataFlatForClient=getAsFlatStructure(dataFlatForClient);
-				}
-				
-				// reserved characters : -/\^$*+?.()|[]{}
-				// CANNOT USE stringifyObject(...) function because we are in a common, lower-level library !
-				let dataFlatStr=stringifyObject(dataFlatForClient)
-					// We «aerate» the produced JSON :
-					.replace(/":[\w]*\{/gim,"\":{\n").replace(/,"/gim,",\n\"")
-					// ...except for inline, escaped JSON string representations :
-					.replace(/\\\":[\w]*\{\n/gim,"\\\":{");
-					// NO : .replace(/}/gim,"}\n");
-				
-				
-				let path=self.getPath(clientId,repositoryName);
-				window.fs.writeFile(path, dataFlatStr, FILE_ENCODING, (error) => {
-			    if(error){
-			    	// TRACE
-						console.log("ERROR : Could not write file «"+path+"»:",error);
-			    	throw error;
-			    }
-			    if(doOnSuccess)	doOnSuccess(dataFlatForClient);
-				});
-			}
-			
-		};
+		}catch(error){
+			// TRACE
+			console.log("ERROR : Could not read file «"+path+"».");
+
+			return null;
+		}
 		
 		
-		return self;
-	};
+		let resultData={};
+		
+		// 1)
+		if(!empty(resultFlat))	resultData=parseJSON(resultFlat);
+		
+		// 2)
+		if(!empty(resultData) && isFlatMap(resultData)){
+			// CAUTION : We have to keep the type information, here too ! (in the sub-objects)				
+			resultData=getAsTreeStructure(resultData, keepClassName);
+		}
+		
+		return resultData;
+	}
+
 	
+	saveDataToFileForClient(clientId, repositoryName, dataFlatForClient, forceKeepUnflatten=false, doOnSuccess=null){
+		const self=this;
+
+		if(!empty(dataFlatForClient) && !isFlatMap(dataFlatForClient) && !forceKeepUnflatten){
+			dataFlatForClient=getAsFlatStructure(dataFlatForClient);
+		}
+		
+		// reserved characters : -/\^$*+?.()|[]{}
+		// CANNOT USE stringifyObject(...) function because we are in a common, lower-level library !
+		let dataFlatStr=stringifyObject(dataFlatForClient)
+			// We «aerate» the produced JSON :
+			.replace(/":[\w]*\{/gim,"\":{\n").replace(/,"/gim,",\n\"")
+			// ...except for inline, escaped JSON string representations :
+			.replace(/\\\":[\w]*\{\n/gim,"\\\":{");
+			// NO : .replace(/}/gim,"}\n");
+		
+		
+		let path=self.getPath(clientId, repositoryName);
+		this.createDirectoryIfNecessary(path);
+		
+		window.fs.writeFile(path, dataFlatStr, FILE_ENCODING, (error) => {
+	    if(error){
+	    	// TRACE
+				console.log("ERROR : Could not write file «"+path+"»:",error);
+	    	throw error;
+	    }
+	    if(doOnSuccess)	doOnSuccess(dataFlatForClient);
+		});
+	}
+		
+
 }
 
 
+
+
+
+
+
+// Nodejs filesystem utils :
+if(typeof(window.fs)==="undefined"){
+	// TRACE
+	console.log("WARN : Could not find the nodejs dependency «fs», aborting persister setup.");
+	window.getPersister=()=>{	return null;	};
+}else{
+	window.getPersister=function(dataDirPath, prefix="", createDirectoryIfNotExists=false){
+		return new Persister(dataDirPath, prefix, createDirectoryIfNotExists);
+	};
+}
+
+// Also handles directories !
 window.fileExists=(filePath)=>{
 	if(typeof(window.fs)=="undefined"){
 		// TRACE
@@ -16422,7 +16445,18 @@ window.fileExists=(filePath)=>{
 	return window.fs.existsSync(filePath);
 };
 
-
+window.createDirectory=(dirPath)=>{
+	if(typeof(window.fs)=="undefined"){
+		// TRACE
+		lognow("ERROR : «fs» node dependency is not available ! Cannot create directory at path «"+dirPath+"».");
+		return;
+	}
+	try {
+	  fs.mkdirSync(dirPath, { recursive: true });
+	} catch (err) {
+	  console.error("Error creating directory:", err);
+	}
+}
 
 // Nodejs server launching helper functions :
 //Networking management :
@@ -16870,7 +16904,8 @@ window.WebsocketImplementation={
 };
 
 
-window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, doOnConnectionLost=null, /*OPTIONAL*/sslOptions=null, httpHandlerParam=null, addCORSHeader=ADD_CORS_HEADER){
+window.launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, doOnConnectionLost=null, /*OPTIONAL*/sslOptions=null, httpHandlerParam=null,
+	addCORSHeader=ADD_CORS_HEADER_BY_DEFAULT){
 	
 	const EXCLUDED_FILENAMES_PARTS=[".keyHash.",".pem"];
 	
@@ -17216,7 +17251,7 @@ window.initNodeServerInfrastructureWrapper=function(doOnClientConnection=null, d
 
 // ========================= UTILITY SERVERSIDE METHODS : =========================
 
-window.ListManager=class{
+window.ListManager=class ListManager{
 	
 	constructor(config){
 		this.config=config;
@@ -17386,7 +17421,9 @@ window.getListManager=function(config){
 // NO : IN A NODE CONTEXT WITH require("...") WILL RESULT IN AN UNDEFINED FUNCTION ERROR !!! 
 // function performHTTPRequest(...){...
 // USE THIS INSTEAD :
-window.performHTTPRequest=function(completeURL, httpMethod="GET", headers={}, requestBodyOrNamedArgs=null, isNodeContext=false, addCORSHeader=ADD_CORS_HEADER){
+window.performHTTPRequest=function(completeURL, httpMethod="GET", headers={}, requestBodyOrNamedArgs=null, isNodeContext=false, 
+	addCORSHeader=ADD_CORS_HEADER_BY_DEFAULT,
+	allowSelfSignedCerts=false/*RECOMMENDED VALUE, TRY NOT TO SET IT TO «true» !!!*/){
 
 	// Body
 	let requestBodyOrNamedArgsStr=null;
@@ -17436,12 +17473,19 @@ window.performHTTPRequest=function(completeURL, httpMethod="GET", headers={}, re
 		// TRACE
 		lognow("INFO : We are not running in a browser context (isNodeContext:"+isNodeContext+";typeof(require):"+(typeof(require))+"). Using browser library.");
 		
+		const options={
+	  	method: httpMethod,
+	  	headers: headers,
+	  	body: body,
+	  };
+		
+		
+		if(allowSelfSignedCerts)
+			options.rejectUnauthorized=true;
+
+		
 		return new Promise((resolve,reject)=>{
-			fetch(completeURL, {
-			   method: httpMethod,
-			   headers: headers,
-			   body: body,
-			  })
+			fetch(completeURL, options)
 				// STRANGE : DOES NOT WORK !!:
 		    //.then(response => response.json())
 		    // STRANGE : DOES WORK :
@@ -17497,7 +17541,12 @@ window.performHTTPRequest=function(completeURL, httpMethod="GET", headers={}, re
 	}
 	
   options.headers=headers;
-  
+	
+	
+	if(allowSelfSignedCerts)
+		options.rejectUnauthorized=true;
+
+	
 	return new Promise((resolve,reject)=>{
 		
 		// Create the HTTP request
@@ -17777,7 +17826,7 @@ window.initClient=function(isNodeContext=true
 
 
 
-window.ClientReceptionEntryPoint=class{
+window.ClientReceptionEntryPoint=class ClientReceptionEntryPoint{
 	
 	constructor(channelNameParam, entryPointId, clientsRoomsTag, listenerConfig, doOnIncomingMessage){
 		this.channelName=channelNameParam;
@@ -17856,7 +17905,7 @@ window.ClientReceptionEntryPoint=class{
 //
 // CLIENT INSTANCE :
 //
-window.ClientInstance=class{
+window.ClientInstance=class ClientInstance{
 
 	constructor(clientSocket){
 		
@@ -18064,7 +18113,7 @@ window.ClientInstance=class{
 
 // ==================================================================================================================
 
-window.ServerReceptionEntryPoint=class{
+window.ServerReceptionEntryPoint=class ServerReceptionEntryPoint{
 	
 	constructor(channelNameParam, clientsRoomsTag, listenerConfig=null, doOnIncomingMessage){
 		this.channelName=channelNameParam;
@@ -18126,7 +18175,7 @@ window.ServerReceptionEntryPoint=class{
 
 
 
-window.NodeServerInstance=class{
+window.NodeServerInstance=class NodeServerInstance{
 	
 	constructor(serverSocket, listenableServer){
 		

aotrautils/package-lock.json

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

aotrautils/package.json

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