puvox-library 1.0.88 → 1.1.1

package/library_standard.d.ts

@@ -356,9 +356,8 @@ declare class PuvoxLibrary {
     enable_jquery_errors(): void;
     encode_chars(str: any, chars?: any[]): any;
     telegramMessage(textOriginal: any, chat_id: any, bot_key: any, extra_opts?: {}): Promise<any>;
-    telegram_interval_ms: number;
-    telegram_last_sent_time: number;
-    telegramMessageCached(text: any, chat_id: any, bot_key: any, extra_opts?: {}, customCacheId?: null): Promise<any>;
+    telegram_interval_ms: number | undefined;
+    telegram_last_sent_timestamp: number | undefined;
     openUrlInBrowser(url: any): void;
     stringify(obj_or_str: any): any;
     stringify_plain(data: any): string;
@@ -374,6 +373,7 @@ declare class PuvoxLibrary {
     privateAppName__: null;
     setAppName(name: any): void;
     getAppName(): never;
+    stringifyForWrite(content: any): any;
     Cookies: {
         parentClass: null;
         mainClass(): null;
@@ -395,24 +395,32 @@ declare class PuvoxLibrary {
     cache: {
         parentClass: null;
         mainClass(): null;
-        helper_read(groupName: any, storageType: any, expireSeconds?: number): any;
-        helper_write(groupName: any, content: any, storageType: any): true | undefined;
-        helper_delete(groupName: any, storageType: any): true | undefined;
-        get(groupName: any, defaultVal?: null, storageType?: string, expireSeconds?: number): any;
-        set(groupName: any, content: any, storageType?: string): void;
-        delete(groupName: any, storageType?: string): void;
-        getChild(groupName: any, optName: any, defaultVal?: null, storageType?: string, expireSeconds?: number): any;
-        setChild(groupName: any, optName: any, val: any, storageType?: string): void;
-        deleteChild(groupName: any, optName: any, storageType?: string): void;
+        helper_get_child(instanceClass: any, optName: any, subKeyName: any, defaultVal?: null, expireSeconds?: number): any;
+        helper_set_child(instanceClass: any, optName: any, subKeyName: any, val: any): void;
+        helper_delete_child(instanceClass: any, optName: any, subKeyName: any): void;
+        localstorage: {
+            parentClass: null;
+            mainClass(): any;
+            get(optName: any, defaultValue?: null, decode?: boolean, expireSeconds?: number): any;
+            set(optName: any, content: any): true | undefined;
+            delete(optName: any): boolean;
+            get_child(optName: any, subKeyName: any, defaultVal?: null, expireSeconds?: number): any;
+            set_child(optName: any, subKeyName: any, val: any): any;
+            delete_child(optName: any, subKeyName: any): any;
+        };
         file: {
             parentClass: null;
             mainClass(): any;
             customCacheDir: null;
-            get_dir(): any;
+            file_path(optName: any): string;
+            get(optName: any, defaultValue?: null, decode?: boolean, expire_seconds?: number): any;
+            set(optName: any, content: any): any;
+            delete(optName: any): any;
+            get_child(optName: any, subKeyName: any, defaultVal?: null, expireSeconds?: number): any;
+            set_child(optName: any, subKeyName: any, val: any): any;
+            delete_child(optName: any, subKeyName: any): any;
             set_dir(dir: any, auto_clear_seconds?: null): any;
             filePath(uniqFileName: any): string;
-            get(uniqFileName: any, defaultContent?: string, expire_seconds?: number, decode?: boolean): any;
-            set(uniqFileName: any, content: any): any;
             containerDefaultPrefix: string;
             tempIds: {};
             idForContent(slugOrContent: any): any;
@@ -439,8 +447,9 @@ declare class PuvoxLibrary {
         delete(filePath: any): any;
         unlink(filePath: any): any;
         createDirectory(dirPath: any): any;
-        read(filePath: any, defaultContent?: string): any;
-        write(filePath: any, content: any): void;
+        read(filePath: any, defaultValue?: string): any;
+        readCustom(filePath: any, defaultValue?: string, decode?: boolean, expireSeconds?: number): any;
+        write(filePath: any, content: any): any;
         getFilesListFromDir(dir: any): any[];
     };
     catchUnhandledExceptions(callback: any): void;

package/library_standard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_standard.d.ts","sourceRoot":"","sources":["library_standard.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"library_standard.d.ts","sourceRoot":"","sources":["library_standard.js"],"names":[],"mappings":"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"}

package/library_standard.js

@@ -2697,8 +2697,9 @@ class PuvoxLibrary {
         return str;
 	}
 
+
 	// region ### TELEGRAM FUNCTIONS ###
-	async telegramMessage(textOriginal, chat_id, bot_key, extra_opts={}){
+	async telegramMessage(textOriginal, chat_id, bot_key, extra_opts={}){ 
 		if (!extra_opts) extra_opts = {};
 		if (! ('parse_mode' in extra_opts)){
 			extra_opts['parse_mode'] = 'html';
@@ -2716,8 +2717,45 @@ class PuvoxLibrary {
 		//
 		const is_repeated_call = ('is_repeated_call' in extra_opts);
 		delete extra_opts['is_repeated_call'];
+		// ###############################################
+		// ############## support caching  ###############
+		// ########## (ppl can remove this part) #########
+		// ###############################################
+		//
+		// you can set custom random cache_id, so if that cache_id is found in store datas, it avoids sending the same message to telegram
+		//
+		if ('cache_id' in extra_opts){
+			if (!this.telegram_interval_ms) {
+				this.telegram_interval_ms= 50; // telegram seems to accept around 30 times per second, so we'd better wait around that milliseconds
+			}
+			if (!this.telegram_last_sent_timestamp) {
+				this.telegram_last_sent_timestamp= 0;
+			}
+			const curMS  = this.milliseconds();
+			const goneMS = curMS - this.telegram_last_sent_timestamp;
+			if ( goneMS < this.telegram_interval_ms ){
+				await this.sleep (this.telegram_interval_ms - goneMS);
+			}
+			this.telegram_last_sent_timestamp = curMS;
+			const opt_cache_id = extra_opts['cache_id'];
+			delete extra_opts['cache_id'];
+			const cacheId = opt_cache_id ? opt_cache_id : this.cache.file.idForContent( text +'_'+ chat_id +'_'+ bot_key +'_'+ JSON.stringify(extra_opts) );
+			if (!this.cache.file.addIdIfNotExists('function_telegram_message', cacheId) ){
+				return {'ok': true, 'cached':true};
+			}
+		}
+		// ###############################################
+		// ################ [ END CACHING ]###############
+		// ###############################################
 		const requestOpts = Object.assign({'chat_id':chat_id, 'text':text}, extra_opts);
-		let responseText = await this.getRemoteData('https://api.telegram.org/bot'+ bot_key +'/sendMessage', requestOpts);  // pastebin_com/u0J1Cph3 //'sendMessage?'.http_build_query(opts, ''); 
+		let responseText = undefined;
+		const isPhotoMessage = ('photo' in extra_opts);
+		if (!isPhotoMessage) {
+			responseText = await this.getRemoteData('https://api.telegram.org/bot'+ bot_key +'/sendMessage', requestOpts);  // pastebin_com/u0J1Cph3 //'sendMessage?'.http_build_query(opts, ''); 
+		} else {
+			requestOpts['caption'] = requestOpts['text'].substring(0, 1023);
+			responseText = await this.getRemoteData('https://api.telegram.org/bot'+ bot_key +'/sendPhoto', requestOpts);  // pastebin_com/u0J1Cph3 //'sendMessage?'.http_build_query(opts, ''); 
+		}
 		try {
 			const responseJson = JSON.parse(responseText);
 			if (responseJson.ok){
@@ -2743,29 +2781,6 @@ class PuvoxLibrary {
 		}
 	}
 
-	telegram_interval_ms= 50; // telegram seems to accept around 30 times per second, so we'd better wait around that milliseconds
-	telegram_last_sent_time= 0;
-
-	async telegramMessageCached(text, chat_id, bot_key, extra_opts={}, customCacheId=null){
-		if (!extra_opts) extra_opts = {};
-		const curMS  = this.milliseconds();
-		const goneMS = curMS - this.telegram_last_sent_time;
-		if ( goneMS < this.telegram_interval_ms ){
-			await this.sleep (this.telegram_interval_ms - goneMS);
-		}
-		this.telegram_last_sent_time = curMS;
-		const cacheId = customCacheId ? customCacheId : this.cache.file.idForContent( text +'_'+ chat_id +'_'+ bot_key +'_'+ JSON.stringify(extra_opts) );
-		if (this.cache.file.addIdIfNotExists('function_telegram_message', cacheId) ){
-			return this.telegramMessage(text, chat_id, bot_key, extra_opts);
-		}
-		else {
-			return false;
-		}
-		//if(is_callable([$this,'notifications_db_entry'])) 
-		//	$this->notifications_db_entry($key, $array['chat_id'], $this->stringify($res), time(), $ok );
-		//return $res;
-	}
-
 	openUrlInBrowser(url)
 	{
 		var cmd = (process.platform == 'darwin'? `open ${url}`: process.platform == 'win32'? `start ${url}`: `xdg-open ${url}`); 
@@ -2884,6 +2899,18 @@ class PuvoxLibrary {
 		return this.privateAppName__; 
 	}
 
+	stringifyForWrite(content) {
+		if (this.isString(content)) {
+			return content;
+		}
+		else if (this.isNumeric(content)) {
+			return content.toString();
+		}
+		else if (this.isObject(content) || this.isArray(content)) {
+			return JSON.stringify(content);
+		}
+		return content;
+	}
 	
 	// ######## Cookies: https://github.com/ttodua/useful-javascript/blob/master/cookies-library.js ######## //
 	Cookies = new (class { 
@@ -2967,107 +2994,78 @@ class PuvoxLibrary {
 			this.parentClass = parentClass;
 		}
 		mainClass() { return this.parentClass; }
+ 
+		helper_get_child(instanceClass, optName, subKeyName, defaultVal = null, expireSeconds = 0){
+			const json = instanceClass.get(optName, {}, true, expireSeconds);
+			return (subKeyName in json) ? json[subKeyName] : defaultVal;
+		}
+		helper_set_child(instanceClass, optName, subKeyName, val){
+			const json = instanceClass.get(optName, {}, true, 0);
+			json[subKeyName] = val;
+			instanceClass.set(optName, json);
+		}
+		helper_delete_child(instanceClass, optName, subKeyName){
+			const json = instanceClass.get(optName, {}, true, 0);
+			delete json[subKeyName];
+			instanceClass.set(optName, json);
+		}
+
+		// lets localstrage be under cache class
+		localstorage = new (class {
+			parentClass = null;
+			constructor(parentClass){
+				this.parentClass = parentClass;
+			}
+			mainClass() { return this.parentClass.parentClass; }
 
-		helper_read(groupName, storageType, expireSeconds = 0){
-			const appName = this.mainClass().getAppName();
-			if (storageType === 'file'){
-				const dir = this.mainClass().file.tempDir() + appName + '/';
-				const filepath = dir + groupName + '.json';
-				// todo: add expiration
-				return this.mainClass().file.read(filepath);
-			} else if (storageType === 'localStorage') {
+			// ###################
+			get(optName, defaultValue = null, decode = true, expireSeconds = 0){
+				const appName = this.mainClass().getAppName();
 				const storage = window.localStorage;
-				let val = storage.getItem(appName + '_' + groupName);
-				let expireVal = parseInt(storage.getItem(appName + '_' + groupName + '_t'));
+				const tsValue = storage.getItem(appName + '_' + optName + '_t');
+				let expireVal = tsValue ? parseInt(tsValue) : 0;
 				// if it's expired, then return null
 				if (expireSeconds !== 0 && (new Date()).getTime() - expireVal > expireSeconds*1000){
-					this.storage.removeItem(appName + '_' + groupName);
-					this.storage.removeItem(appName + '_' + groupName + '_t');
-					return null;
+					storage.removeItem(appName + '_' + optName);
+					storage.removeItem(appName + '_' + optName + '_t');
+					return defaultValue;
 				} else {
+					const val = storage.getItem(appName + '_' + optName);
+					if (decode) { try { return JSON.parse(val) } catch(e) {} }
 					return val;
 				}
-			} else {
-				if (typeof alert !== 'undefined') alert(`storageType ${storageType} not supported`);
-				throw new Error(`storageType ${storageType} not supported`);
-			}
-		}
-		helper_write(groupName, content, storageType){
-			content = this.mainClass().isString (content) ? content : (this.mainClass().isArray(content) || this.mainClass().isObject(content) ? JSON.stringify(content) : content);
-			const appName = this.mainClass().getAppName();
-			if (storageType === 'file'){
-				const dir = this.mainClass().file.tempDir() + appName + '/';
-				this.mainClass().file.createDirectory(dir);
-				const filepath = dir + groupName + '.json';
-				// todo: add expiration
-				this.mainClass().file.write(filepath, content);
-				return true;
-			} else if (storageType === 'localStorage') {
-				try{ 
-					const storage = window.localStorage;
-					storage.setItem(appName + '_' + groupName, content); 
-					storage.setItem(appName + '_' + groupName + '_t', (new Date()).getTime()); 
-					return true; 
-				}
-				catch(ex){ alert("Cache storage quote exceeded. can't save value. err598 |" + ex.message); }
-			} else {
-				if (typeof alert !== 'undefined') alert(`storageType ${storageType} not supported`);
-				throw new Error(`storageType ${storageType} not supported`);
-			}
-		}
-		helper_delete(groupName, storageType){
-			const appName = this.mainClass().getAppName();
-			if (storageType === 'file'){
-				const filepath = this.mainClass().file.tempDir() + appName + '/' + groupName + '.json';
-				// todo: better delete
-				this.mainClass().file.delete(filepath);
-				return true;
-			} else if (storageType === 'localStorage') {
+			}
+			set(optName, content){
 				try{ 
 					const storage = window.localStorage;
-					storage.setItem(appName + '_' + groupName, content); 
-					storage.setItem(appName + '_' + groupName + '_t', (new Date()).getTime()); 
+					const finalContent = this.mainClass().stringifyForWrite(content);
+					storage.setItem(appName + '_' + optName, finalContent); 
+					storage.setItem(appName + '_' + optName + '_t', (new Date()).getTime()); 
 					return true; 
 				}
-				catch(ex){ alert("Cache storage quote exceeded. can't save value. err598 |" + ex.message); }
-			} else {
-				alert(`storageType ${storageType} not supported`);
-				throw new Error(`storageType ${storageType} not supported`);
+				catch(ex){ alert("Can't save value. Might be exceeding cache size. err598 |" + ex.message); }
 			}
-		}
-
-		get(groupName, defaultVal = null, storageType = 'localStorage', expireSeconds = 0){
-			const content = this.helper_read(groupName, storageType, expireSeconds);
-			return (content !== null && content !== '') ? content : defaultVal;
-		}
-		set(groupName, content, storageType = 'localStorage'){
-			this.helper_write(groupName, content, storageType);
-		}
-		delete(groupName, storageType = 'localStorage'){
-			this.helper_delete(groupName, storageType);
-		}
-		getChild(groupName, optName, defaultVal = null, storageType = 'localStorage', expireSeconds = 0){
-			// todo: individual sub-item expiration
-			const content = this.get(groupName, '{}', storageType, expireSeconds);
-			const json = JSON.parse(content);
-			return (optName in json) ? json[optName] : defaultVal;
-		}
-		setChild(groupName, optName, val, storageType = 'localStorage'){
-			const content = this.get(groupName, '{}', storageType);
-			const json = JSON.parse(content);
-			json[optName] = val;
-			this.set(groupName, JSON.stringify(json), storageType);
-		}
-		deleteChild(groupName, optName, storageType = 'localStorage'){
-			const content = this.get(groupName, '{}', storageType, expireSeconds);
-			// if it's empty, no need to do anything
-			if (content === '{}') return;
-			const json = JSON.parse(content);
-			delete json[optName];
-			this.set(groupName, JSON.stringify(json), storageType);
-		}
-
+			delete(optName){
+				const storage = window.localStorage;
+				storage.removeItem(appName + '_' + optName); 
+				storage.removeItem(appName + '_' + optName + '_t'); 
+				return true; 
+			}
+			// ################ child methods ################## //
+			get_child(optName, subKeyName, defaultVal = null, expireSeconds = 0){
+				return this.parentClass.helper_get_child(this, optName, subKeyName, defaultVal, expireSeconds);
+			}
+			set_child(optName, subKeyName, val){
+				return this.parentClass.helper_set_child(this, optName, subKeyName, val);
+			}
+			delete_child(optName, subKeyName){
+				return this.parentClass.helper_delete_child(this, optName, subKeyName);
+			}
+			// ########################################### //
+		})(this);
 
+		
+		// server-side caching
 		file = new (class {
 			parentClass = null;
 			constructor(parentClass){
@@ -3075,15 +3073,38 @@ class PuvoxLibrary {
 			}
 			mainClass() { return this.parentClass.parentClass; }
 
-			// ########## CACHE DIRS (server-side JS) ##########
+			// ###################
 			customCacheDir = null;
-			get_dir(){  
+			file_path(optName) {
 				if (!this.customCacheDir){ 
-					this.customCacheDir = this.mainClass().file.tempDir();
+					this.customCacheDir = this.mainClass().file.tempDir() + this.mainClass().getAppName() + '/';
 				}
-				let finaldir = this.mainClass().trailingSlash(this.customCacheDir + this.mainClass().getAppName() + '_cache_');
-				return finaldir; 
+				return this.customCacheDir + optName + '.json';
+			}
+			get(optName, defaultValue = null, decode = true, expire_seconds=0)
+			{
+				return this.mainClass().file.readCustom(this.file_path(optName), defaultValue, decode, expire_seconds);
 			}
+			set(optName, content)
+			{
+				return this.mainClass().file.write(this.file_path(optName), content);
+			}
+			delete (optName) {
+				return this.mainClass().file.delete(this.file_path(optName));
+			}
+			// ################ child methods ################## //
+			get_child(optName, subKeyName, defaultVal = null, expireSeconds = 0){
+				return this.parentClass.helper_get_child(this, optName, subKeyName, defaultVal, expireSeconds);
+			}
+			set_child(optName, subKeyName, val){
+				return this.parentClass.helper_set_child(this, optName, subKeyName, val);
+			}
+			delete_child(optName, subKeyName){
+				return this.parentClass.helper_delete_child(this, optName, subKeyName);
+			}
+			// #############################################
+
+			// old 
 			set_dir(dir, auto_clear_seconds=null){ 
 				if(dir) this.customCacheDir = dir;
 				const res = this.mainClass().file.createDirectory(this.customCacheDir);
@@ -3101,69 +3122,8 @@ class PuvoxLibrary {
 				const filePath = this.get_dir() + uniqFileName + "_tmp"; //"/". 
 				return filePath;
 			}
-			//
-			get(uniqFileName, defaultContent ='', expire_seconds=8640000, decode = true)
-			{
-				const parent = this.mainClass();
-				let filePath = this.filePath(uniqFileName);
-				if ( parent.file.exists(filePath) ){
-					if ( parent.file.mtime(filePath) + expire_seconds *1000 < (new Date()).getTime() ){
-						parent.file.unlink(filePath);
-						return defaultContent;
-					}
-					else{	
-						const cont = parent.file.read(filePath, null);
-						// if specifically array, then on empty, reckon as array
-						if (cont===null)
-						{
-							return defaultContent;
-						}
-						if (decode){
-							try{
-								return JSON.parse(cont);
-							}
-							catch(ex){
-								return cont;
-							}
-						}
-						else{
-							return cont;
-						}
-					}
-				}
-				else {
-					return defaultContent;
-				}
-			}
-			set(uniqFileName, content)
-			{
-				const parent = this.mainClass();
-				let filePath= this.filePath(uniqFileName);
-				let contentFinal = parent.isString(content) ? content : ((parent.isArray(content) || parent.isObject(content)) ? JSON.stringify(content) : content);
-				return parent.file.write(filePath, contentFinal);
-			}
 
-			
-			//
-			// writeFileAppendJson(filePath, jsonContent, callback){
-			// 	try{
-			// 		var callback = callback || function(){};
-			// 		var self = this;
-			// 		this.mainClass().modules('fs').readFile(filePath, 'utf8', function(err,data) {
-			// 			let json = {};
-			// 			if (typeof data !="undefined" && data!=''){
-			// 				json=JSON.parse(data);
-			// 			}
-			// 			let jsonNew = self.jsonConcat(json, jsonContent);
-			// 			let content = JSON.stringify(jsonNew);
-			// 			this.mainClass().modules('fs').writeFile(filePath, content, 'utf8', function(callback_) {
-			// 			}); 
-			// 		});
-			// 	}
-			// 	catch(e){
-			// 		console.log("writeFileAppendJson", e); 
-			// 	}
-			// },
+			// ids
 			containerDefaultPrefix = "_cached_ids_";
 			tempIds = {};
 			idForContent(slugOrContent){
@@ -3195,6 +3155,26 @@ class PuvoxLibrary {
 				}
 				return false;
 			}
+			//
+			// writeFileAppendJson(filePath, jsonContent, callback){
+			// 	try{
+			// 		var callback = callback || function(){};
+			// 		var self = this;
+			// 		this.mainClass().modules('fs').readFile(filePath, 'utf8', function(err,data) {
+			// 			let json = {};
+			// 			if (typeof data !="undefined" && data!=''){
+			// 				json=JSON.parse(data);
+			// 			}
+			// 			let jsonNew = self.jsonConcat(json, jsonContent);
+			// 			let content = JSON.stringify(jsonNew);
+			// 			this.mainClass().modules('fs').writeFile(filePath, content, 'utf8', function(callback_) {
+			// 			}); 
+			// 		});
+			// 	}
+			// 	catch(e){
+			// 		console.log("writeFileAppendJson", e); 
+			// 	}
+			// },
 		})(this);
 	})(this);
 
@@ -3274,16 +3254,40 @@ class PuvoxLibrary {
 			}
 			return true;
 		}
-		read(filePath, defaultContent = ''){
+		read(filePath, defaultValue = ''){
 			if (!this.exists(filePath)){
-				return defaultContent;
+				return defaultValue;
 			}
 			return this.fs().readFileSync(filePath, 'utf8');
 		}
+		readCustom(filePath, defaultValue = '', decode = true, expireSeconds = 0){
+			if (!this.exists(filePath)){
+				return defaultValue;
+			}
+			else {
+				if ( this.mtime(filePath) + expireSeconds*1000 < (new Date()).getTime() ){
+					this.unlink(filePath);
+					return defaultValue;
+				}
+				else{	
+					const cont = this.read(filePath, null);
+					// if specifically array, then on empty, reckon as array
+					if (cont===null) {
+						return defaultValue;
+					}
+					if (decode){
+						try { return JSON.parse(cont); }
+						catch(ex){ }
+					}
+					return cont;
+				}
+			}
+		}
 		write(filePath, content){
 			const dir = this.path().dirname(filePath);
 			this.createDirectory(dir);
-			this.fs().writeFileSync(filePath, content, 'utf8', function(err){
+			const finalContent = this.mainClass().stringifyForWrite(content);
+			return this.fs().writeFileSync(filePath, finalContent, 'utf8', function(err){
 				if (err) throw err;
 			});
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puvox-library",
-  "version": "1.0.88",
+  "version": "1.1.1",
   "description": "library-class-javascript",
   "main": "library_standard.js",
   "scripts": {