tiny-essentials 1.1.0 → 1.1.1

package/README.md

@@ -21,6 +21,7 @@
 - ⏱️ **Time Calculations**: Easily calculate durations, format timers, and more.
 - 🧠 **Object Utilities**: Perform type checks, count object properties, and calculate percentages.
 - 🛠️ **Custom Utilities**: Includes various helper functions like `ruleOfThree` for proportion calculations and `getAge` to calculate the age based on a given birth date.
+- 🔐 **Encryption Tools**: Use `TinyCrypto` to securely encrypt and decrypt values using AES-256-GCM, with full support for complex JavaScript data types like RegExp, Date, Buffer, and DOM elements (in browsers).
 
 ## 📦 Installation
 

package/dist/TinyEssentials.min.js

@@ -1 +1 @@
-var TinyEssentials=function(e){"use strict";function t(e,t="seconds",n="{time}"){e=Math.max(0,Math.floor(e));const r=["seconds","minutes","hours","days","months","years"].indexOf(t),o=r>=5,i=r>=4,a=r>=3,s=r>=2,u=r>=1,l=r>=0,c={years:o?0:NaN,months:i?0:NaN,days:a?0:NaN,hours:s?0:NaN,minutes:u?0:NaN,seconds:l?0:NaN,total:NaN};let p=e;if(o||i||a){const e=new Date(1980,0,1),t=new Date(e.getTime()+1e3*p),n=new Date(e);if(o)for(;new Date(n.getFullYear()+1,n.getMonth(),n.getDate())<=t;)n.setFullYear(n.getFullYear()+1),c.years++;if(i)for(;new Date(n.getFullYear(),n.getMonth()+1,n.getDate())<=t;)n.setMonth(n.getMonth()+1),c.months++;if(a)for(;new Date(n.getFullYear(),n.getMonth(),n.getDate()+1)<=t;)n.setDate(n.getDate()+1),c.days++;p=Math.floor((t-n)/1e3)}s&&(c.hours=Math.floor(p/3600),p%=3600),u&&(c.minutes=Math.floor(p/60),p%=60),l&&(c.seconds=p);const g={seconds:l?e:NaN,minutes:u?e/60:NaN,hours:s?e/3600:NaN,days:a?e/86400:NaN,months:i?12*c.years+c.months+(c.days||0)/30:NaN,years:o?c.years+(c.months||0)/12+(c.days||0)/365:NaN};c.total=+(g[t]||0).toFixed(2).replace(/\.00$/,"");const f=e=>isNaN(e)?"NaN":String(e).padStart(2,"0"),h=[s?f(c.hours):null,u?f(c.minutes):null,l?f(c.seconds):null].filter((e=>null!==e)).join(":");return n.replace(/\{years\}/g,c.years).replace(/\{months\}/g,c.months).replace(/\{days\}/g,c.days).replace(/\{hours\}/g,f(c.hours)).replace(/\{minutes\}/g,f(c.minutes)).replace(/\{seconds\}/g,f(c.seconds)).replace(/\{time\}/g,h).replace(/\{total\}/g,c.total).trim()}const n={items:{undefined:e=>void 0===e,null:e=>null===e,boolean:e=>"boolean"==typeof e,number:e=>"number"==typeof e&&!isNaN(e),bigint:e=>"bigint"==typeof e,string:e=>"string"==typeof e,symbol:e=>"symbol"==typeof e,function:e=>"function"==typeof e,array:e=>Array.isArray(e),date:e=>e instanceof Date,regexp:e=>e instanceof RegExp,map:e=>e instanceof Map,set:e=>e instanceof Set,weakmap:e=>e instanceof WeakMap,weakset:e=>e instanceof WeakSet,promise:e=>e instanceof Promise,buffer:e=>"undefined"!=typeof Buffer&&Buffer.isBuffer(e),htmlElement:e=>"undefined"!=typeof HTMLElement&&e instanceof HTMLElement,object:e=>"object"==typeof e&&null!==e},order:["undefined","null","boolean","number","bigint","string","symbol","function","array","buffer","date","regexp","map","set","weakmap","weakset","promise","htmlElement","object"]};function r(e,t){if(void 0===e)return null;const r=(e=>{if(null===e)return"null";for(const t of n.order)if(!n.items[t]||n.items[t](e))return t;return"unknown"})(e);return"string"==typeof t?r===t.toLowerCase():r}var o={},i={};const a="undefined"!=typeof window&&void 0!==window.document;return e.TinyCrypto=class{constructor(e={}){this.algorithm=e.algorithm||"aes-256-gcm",this.outputEncoding=e.outputEncoding||"hex",this.inputEncoding=e.inputEncoding||"utf8",this.authTagLength=e.authTagLength||16,this.key=e.key||this.generateKey()}generateKey(e=32){return o.randomBytes(e)}generateIV(e=12){return o.randomBytes(e)}encrypt(e,t=this.generateIV()){const n=this.#e(e),r=o.createCipheriv(this.algorithm,this.key,t,{authTagLength:this.authTagLength});let i=r.update(n,this.inputEncoding);i=Buffer.concat([i,r.final()]);const a=r.getAuthTag();return{iv:t.toString(this.outputEncoding),encrypted:i.toString(this.outputEncoding),authTag:a.toString(this.outputEncoding)}}decrypt({iv:e,encrypted:t,authTag:n},r=null){const i=Buffer.from(e,this.outputEncoding),a=Buffer.from(t,this.outputEncoding),s=Buffer.from(n,this.outputEncoding),u=o.createDecipheriv(this.algorithm,this.key,i,{authTagLength:this.authTagLength});u.setAuthTag(s);let l=u.update(a,null,this.inputEncoding);l+=u.final(this.inputEncoding);const{value:c,type:p}=this.#t(l);return r&&this.#n(r,p),c}getTypeFromEncrypted({iv:e,encrypted:t,authTag:n}){const r=Buffer.from(e,this.outputEncoding),i=Buffer.from(t,this.outputEncoding),a=Buffer.from(n,this.outputEncoding),s=o.createDecipheriv(this.algorithm,this.key,r,{authTagLength:this.authTagLength});s.setAuthTag(a);let u=s.update(i,null,this.inputEncoding);u+=s.final(this.inputEncoding);const{type:l}=this.#t(u);return"string"==typeof l?l.toLowerCase():"unknown"}saveKeyToFile(e="secret.key"){const t=this.key.toString("hex");if(a){const n=new Blob([t],{type:"text/plain"}),r=URL.createObjectURL(n),o=document.createElement("a");o.href=r,o.download=e,o.click(),URL.revokeObjectURL(r)}else i.writeFileSync(e,t)}saveConfigToFile(e="crypto-config.json"){const t=JSON.stringify(this.exportConfig(),null,2);if(a){const n=new Blob([t],{type:"application/json"}),r=URL.createObjectURL(n),o=document.createElement("a");o.href=r,o.download=e,o.click(),URL.revokeObjectURL(r)}else i.writeFileSync(e,t)}async loadConfigFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{try{const e=JSON.parse(r.result);t(this.importConfig(e))}catch(e){n(new Error("Invalid config JSON file"))}},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=i.readFileSync(e,"utf8"),n=JSON.parse(t);return this.importConfig(n)}}async loadKeyFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{const e=r.result.trim(),n=Buffer.from(e,"hex");this.key=n,t(n)},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=i.readFileSync(e,"utf8"),n=Buffer.from(t,"hex");return this.key=n,n}}exportConfig(){return{algorithm:this.algorithm,outputEncoding:this.outputEncoding,inputEncoding:this.inputEncoding,key:this.key.toString("hex"),authTagLength:this.authTagLength}}importConfig(e){if("string"==typeof e.algorithm)this.algorithm=e.algorithm;else if(void 0!==e.algorithm)throw new Error('Invalid or missing "algorithm" property. Expected a string.');if("string"==typeof e.outputEncoding)this.outputEncoding=e.outputEncoding;else if(void 0!==e.outputEncoding)throw new Error('Invalid or missing "outputEncoding" property. Expected a string.');if("string"==typeof e.inputEncoding)this.inputEncoding=e.inputEncoding;else if(void 0!==e.inputEncoding)throw new Error('Invalid or missing "inputEncoding" property. Expected a string.');if("number"==typeof e.authTagLength)this.authTagLength=e.authTagLength;else if(void 0!==e.authTagLength)throw new Error('Invalid or missing "authTagLength" property. Expected a number.');if("string"==typeof e.key)this.key=Buffer.from(e.key,"hex");else if(void 0!==e.key)throw new Error('Invalid or missing "key" property. Expected a hexadecimal string.')}#r={weakmap:()=>{throw new Error("WeakMap cannot be serialized")},weakset:()=>{throw new Error("WeakSet cannot be serialized")},promise:()=>{throw new Error("Promise cannot be serialized")},function:()=>{throw new Error("Function cannot be serialized")},regexp:e=>JSON.stringify({__type:"RegExp",value:e.toString()}),htmlElement:e=>JSON.stringify({__type:"HTMLElement",value:e.outerHTML}),date:e=>JSON.stringify({__type:"Date",value:e.toISOString()}),bigint:e=>JSON.stringify({__type:"BigInt",value:e.toString()}),number:e=>JSON.stringify({__type:"Number",value:e}),boolean:e=>JSON.stringify({__type:"Boolean",value:e}),string:e=>JSON.stringify({__type:"String",value:e}),null:e=>JSON.stringify({__type:"Null"}),undefined:e=>JSON.stringify({__type:"Undefined"}),map:e=>JSON.stringify({__type:"Map",value:Array.from(e.entries())}),set:e=>JSON.stringify({__type:"Set",value:Array.from(e.values())}),symbol:e=>JSON.stringify({__type:"Symbol",value:e.description}),array:e=>JSON.stringify({__type:"Array",value:e}),object:e=>JSON.stringify({__type:"JSON",value:e}),buffer:e=>JSON.stringify({__type:"Buffer",value:e.toString("base64")})};#o={RegExp:e=>{const t=e.match(/^\/(.*)\/([gimsuy]*)$/);return t?new RegExp(t[1],t[2]):new RegExp(e)},HTMLElement:e=>{if("undefined"==typeof document)throw new Error("HTMLElement deserialization is only supported in browsers");const t=document.createElement("div");return t.innerHTML=e,t.firstElementChild},Date:e=>new Date(e),BigInt:e=>BigInt(e),Number:e=>Number(e),Boolean:e=>Boolean(e),Null:e=>null,Undefined:e=>{},Map:e=>new Map(e),Set:e=>new Set(e),Symbol:e=>Symbol(e),Array:e=>e,JSON:e=>e,String:e=>String(e),Buffer:e=>Buffer.from(e,"base64")};#e(e){const t=r(e)||"undefined";if(this.#r[t])return this.#r[t](e);throw new Error(`Unsupported data type for encryption: ${t}`)}#t(e){try{const t=JSON.parse(e),n=t.__type;return"string"!=typeof n?{value:e,type:"String"}:"function"==typeof this.#o[n]?{value:this.#o[n](t.value),type:n}:{value:e,type:"Unknown"}}catch{return{value:e,type:"Unknown"}}}#n(e,t){if(e.toLowerCase()!==t.toLowerCase())throw new Error(`Type mismatch: expected ${e.toLowerCase()}, but got ${t.toLowerCase()}`)}},e.TinyLevelUp=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const n=this.expLevel*e.level;return e.exp>=n&&(e.level++,t=e.exp-n,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let n=1;n<=e.level;n++)t+=this.expLevel*n;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,n="add",r=1){return"add"===n?e.exp+=this.expGenerator(r)+t:"extra"===n&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,n="add",r=1){return"add"===n?e.exp-=this.expGenerator(r)+t:"extra"===n&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}},e.asyncReplace=async function(e,t,n){const r=[];e.replace(t,((e,...t)=>(r.push(n(e,...t)),e)));const o=await Promise.all(r);return e.replace(t,(()=>o.shift()))},e.cloneObjTypeOrder=function(){return[...n.order]},e.countObj=function(e){return Array.isArray(e)?e.length:r(e,"object")?Object.keys(e).length:0},e.extendObjType=function(e,t){const r=[];for(const[o,i]of Object.entries(e))if(!n.items.hasOwnProperty(o)){n.items[o]=i;let e="number"==typeof t?t:-1;if(-1===e){const t=n.order.indexOf("object");e=t>-1?t:n.order.length}e=Math.min(Math.max(0,e),n.order.length),n.order.splice(e,0,o),r.push(o)}return r},e.formatCustomTimer=t,e.formatDayTimer=function(e){return t(e,"days","{days}d {hours}:{minutes}:{seconds}")},e.formatTimer=function(e){return t(e,"hours","{hours}:{minutes}:{seconds}")},e.getAge=function(e=0,t=null){if(null!=e&&0!==e){const n=new Date(e);if(isNaN(n))return null;const r=t instanceof Date?t:new Date;let o=r.getFullYear()-n.getFullYear();const i=r.getMonth(),a=n.getMonth(),s=r.getDate(),u=n.getDate();return(i<a||i===a&&s<u)&&o--,Math.abs(o)}return null},e.getSimplePerc=function(e,t){return e*(t/100)},e.getTimeDuration=function(e=new Date,t="asSeconds",n=null){if(e instanceof Date){const r=e-(n instanceof Date?n:new Date);switch(t){case"asMilliseconds":return r;case"asSeconds":default:return r/1e3;case"asMinutes":return r/6e4;case"asHours":return r/36e5;case"asDays":return r/864e5}}return null},e.objType=r,e.reorderObjTypeOrder=function(e){const t=[...n.order];return!!e.every((e=>t.includes(e)))&&(n.order=e.slice(),!0)},e.ruleOfThree=function(e,t,n,r){return r?Number(e*t)/n:Number(n*t)/e},e.shuffleArray=function(e){let t,n=e.length;for(;0!==n;)t=Math.floor(Math.random()*n),n--,[e[n],e[t]]=[e[t],e[n]];return e},e.toTitleCase=function(e){return e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()))},e.toTitleCaseLowerFirst=function(e){const t=e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()));return t.charAt(0).toLowerCase()+t.slice(1)},e}({});
+var TinyEssentials=function(e){"use strict";function t(e,t="seconds",n="{time}"){e=Math.max(0,Math.floor(e));const r=["seconds","minutes","hours","days","months","years"].indexOf(t),i=r>=5,o=r>=4,a=r>=3,s=r>=2,u=r>=1,l=r>=0,c={years:i?0:NaN,months:o?0:NaN,days:a?0:NaN,hours:s?0:NaN,minutes:u?0:NaN,seconds:l?0:NaN,total:NaN};let p=e;if(i||o||a){const e=new Date(1980,0,1),t=new Date(e.getTime()+1e3*p),n=new Date(e);if(i)for(;new Date(n.getFullYear()+1,n.getMonth(),n.getDate())<=t;)n.setFullYear(n.getFullYear()+1),c.years++;if(o)for(;new Date(n.getFullYear(),n.getMonth()+1,n.getDate())<=t;)n.setMonth(n.getMonth()+1),c.months++;if(a)for(;new Date(n.getFullYear(),n.getMonth(),n.getDate()+1)<=t;)n.setDate(n.getDate()+1),c.days++;p=Math.floor((t-n)/1e3)}s&&(c.hours=Math.floor(p/3600),p%=3600),u&&(c.minutes=Math.floor(p/60),p%=60),l&&(c.seconds=p);const g={seconds:l?e:NaN,minutes:u?e/60:NaN,hours:s?e/3600:NaN,days:a?e/86400:NaN,months:o?12*c.years+c.months+(c.days||0)/30:NaN,years:i?c.years+(c.months||0)/12+(c.days||0)/365:NaN};c.total=+(g[t]||0).toFixed(2).replace(/\.00$/,"");const h=e=>isNaN(e)?"NaN":String(e).padStart(2,"0"),f=[s?h(c.hours):null,u?h(c.minutes):null,l?h(c.seconds):null].filter((e=>null!==e)).join(":");return n.replace(/\{years\}/g,c.years).replace(/\{months\}/g,c.months).replace(/\{days\}/g,c.days).replace(/\{hours\}/g,h(c.hours)).replace(/\{minutes\}/g,h(c.minutes)).replace(/\{seconds\}/g,h(c.seconds)).replace(/\{time\}/g,f).replace(/\{total\}/g,c.total).trim()}const n={items:{undefined:e=>void 0===e,null:e=>null===e,boolean:e=>"boolean"==typeof e,number:e=>"number"==typeof e&&!isNaN(e),bigint:e=>"bigint"==typeof e,string:e=>"string"==typeof e,symbol:e=>"symbol"==typeof e,function:e=>"function"==typeof e,array:e=>Array.isArray(e),date:e=>e instanceof Date,regexp:e=>e instanceof RegExp,map:e=>e instanceof Map,set:e=>e instanceof Set,weakmap:e=>e instanceof WeakMap,weakset:e=>e instanceof WeakSet,promise:e=>e instanceof Promise,buffer:e=>"undefined"!=typeof Buffer&&Buffer.isBuffer(e),htmlelement:e=>"undefined"!=typeof HTMLElement&&e instanceof HTMLElement,object:e=>"object"==typeof e&&null!==e},order:["undefined","null","boolean","number","bigint","string","symbol","function","array","buffer","date","regexp","map","set","weakmap","weakset","promise","htmlelement","object"]};function r(e,t){if(void 0===e)return null;const r=(e=>{if(null===e)return"null";for(const t of n.order)if(!n.items[t]||n.items[t](e))return t;return"unknown"})(e);return"string"==typeof t?r===t.toLowerCase():r}var i={},o={};const a="undefined"!=typeof window&&void 0!==window.document;return e.TinyCrypto=class{constructor(e={}){this.algorithm=e.algorithm||"aes-256-gcm",this.outputEncoding=e.outputEncoding||"hex",this.inputEncoding=e.inputEncoding||"utf8",this.authTagLength=e.authTagLength||16,this.key=e.key||this.generateKey()}generateKey(e=32){return i.randomBytes(e)}generateIV(e=12){return i.randomBytes(e)}encrypt(e,t=this.generateIV()){const n=this.#e(e),r=i.createCipheriv(this.algorithm,this.key,t,{authTagLength:this.authTagLength});let o=r.update(n,this.inputEncoding);o=Buffer.concat([o,r.final()]);const a=r.getAuthTag();return{iv:t.toString(this.outputEncoding),encrypted:o.toString(this.outputEncoding),authTag:a.toString(this.outputEncoding)}}decrypt({iv:e,encrypted:t,authTag:n},r=null){const o=Buffer.from(e,this.outputEncoding),a=Buffer.from(t,this.outputEncoding),s=Buffer.from(n,this.outputEncoding),u=i.createDecipheriv(this.algorithm,this.key,o,{authTagLength:this.authTagLength});u.setAuthTag(s);let l=u.update(a,null,this.inputEncoding);l+=u.final(this.inputEncoding);const{value:c,type:p}=this.#t(l);return r&&this.#n(r,p),c}getTypeFromEncrypted({iv:e,encrypted:t,authTag:n}){const r=Buffer.from(e,this.outputEncoding),o=Buffer.from(t,this.outputEncoding),a=Buffer.from(n,this.outputEncoding),s=i.createDecipheriv(this.algorithm,this.key,r,{authTagLength:this.authTagLength});s.setAuthTag(a);let u=s.update(o,null,this.inputEncoding);u+=s.final(this.inputEncoding);const{type:l}=this.#t(u);return"string"==typeof l?l:"unknown"}saveKeyToFile(e="secret.key"){const t=this.key.toString("hex");if(a){const n=new Blob([t],{type:"text/plain"}),r=URL.createObjectURL(n),i=document.createElement("a");i.href=r,i.download=e,i.click(),URL.revokeObjectURL(r)}else o.writeFileSync(e,t)}saveConfigToFile(e="crypto-config.json"){const t=JSON.stringify(this.exportConfig(),null,2);if(a){const n=new Blob([t],{type:"application/json"}),r=URL.createObjectURL(n),i=document.createElement("a");i.href=r,i.download=e,i.click(),URL.revokeObjectURL(r)}else o.writeFileSync(e,t)}async loadConfigFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{try{const e=JSON.parse(r.result);t(this.importConfig(e))}catch(e){n(new Error("Invalid config JSON file"))}},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=o.readFileSync(e,"utf8"),n=JSON.parse(t);return this.importConfig(n)}}async loadKeyFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{const e=r.result.trim(),n=Buffer.from(e,"hex");this.key=n,t(n)},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=o.readFileSync(e,"utf8"),n=Buffer.from(t,"hex");return this.key=n,n}}exportConfig(){return{algorithm:this.algorithm,outputEncoding:this.outputEncoding,inputEncoding:this.inputEncoding,key:this.key.toString("hex"),authTagLength:this.authTagLength}}importConfig(e){if("string"==typeof e.algorithm)this.algorithm=e.algorithm;else if(void 0!==e.algorithm)throw new Error('Invalid or missing "algorithm" property. Expected a string.');if("string"==typeof e.outputEncoding)this.outputEncoding=e.outputEncoding;else if(void 0!==e.outputEncoding)throw new Error('Invalid or missing "outputEncoding" property. Expected a string.');if("string"==typeof e.inputEncoding)this.inputEncoding=e.inputEncoding;else if(void 0!==e.inputEncoding)throw new Error('Invalid or missing "inputEncoding" property. Expected a string.');if("number"==typeof e.authTagLength)this.authTagLength=e.authTagLength;else if(void 0!==e.authTagLength)throw new Error('Invalid or missing "authTagLength" property. Expected a number.');if("string"==typeof e.key)this.key=Buffer.from(e.key,"hex");else if(void 0!==e.key)throw new Error('Invalid or missing "key" property. Expected a hexadecimal string.')}#r={weakmap:()=>{throw new Error("WeakMap cannot be serialized")},weakset:()=>{throw new Error("WeakSet cannot be serialized")},promise:()=>{throw new Error("Promise cannot be serialized")},function:()=>{throw new Error("Function cannot be serialized")},regexp:e=>JSON.stringify({__type:"regexp",value:e.toString()}),htmlElement:e=>JSON.stringify({__type:"htmlelement",value:e.outerHTML}),date:e=>JSON.stringify({__type:"date",value:e.toISOString()}),bigint:e=>JSON.stringify({__type:"bigint",value:e.toString()}),number:e=>JSON.stringify({__type:"number",value:e}),boolean:e=>JSON.stringify({__type:"boolean",value:e}),string:e=>JSON.stringify({__type:"string",value:e}),null:e=>JSON.stringify({__type:"null"}),undefined:e=>JSON.stringify({__type:"undefined"}),map:e=>JSON.stringify({__type:"map",value:Array.from(e.entries())}),set:e=>JSON.stringify({__type:"set",value:Array.from(e.values())}),symbol:e=>JSON.stringify({__type:"symbol",value:e.description}),array:e=>JSON.stringify({__type:"array",value:e}),object:e=>JSON.stringify({__type:"object",value:e}),buffer:e=>JSON.stringify({__type:"buffer",value:e.toString("base64")})};#i={regexp:e=>{const t=e.match(/^\/(.*)\/([gimsuy]*)$/);return t?new RegExp(t[1],t[2]):new RegExp(e)},htmlelement:e=>{if("undefined"==typeof document)throw new Error("HTMLElement deserialization is only supported in browsers");const t=document.createElement("div");return t.innerHTML=e,t.firstElementChild},date:e=>new Date(e),bigint:e=>BigInt(e),number:e=>Number(e),boolean:e=>Boolean(e),null:e=>null,undefined:e=>{},map:e=>new Map(e),set:e=>new Set(e),symbol:e=>Symbol(e),array:e=>e,object:e=>e,string:e=>String(e),buffer:e=>Buffer.from(e,"base64")};#e(e){const t=r(e)||"undefined";if(this.#r[t])return this.#r[t](e);throw new Error(`Unsupported data type for encryption: ${t}`)}#t(e){try{const t=JSON.parse(e),n=t.__type;return"string"!=typeof n?{value:e,type:"string"}:"function"==typeof this.#i[n]?{value:this.#i[n](t.value),type:n}:{value:e,type:"Unknown"}}catch{return{value:e,type:"Unknown"}}}#n(e,t){if(e!==t)throw new Error(`Type mismatch: expected ${e}, but got ${t}`)}},e.TinyLevelUp=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const n=this.expLevel*e.level;return e.exp>=n&&(e.level++,t=e.exp-n,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let n=1;n<=e.level;n++)t+=this.expLevel*n;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,n="add",r=1){return"add"===n?e.exp+=this.expGenerator(r)+t:"extra"===n&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,n="add",r=1){return"add"===n?e.exp-=this.expGenerator(r)+t:"extra"===n&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}},e.asyncReplace=async function(e,t,n){const r=[];e.replace(t,((e,...t)=>(r.push(n(e,...t)),e)));const i=await Promise.all(r);return e.replace(t,(()=>i.shift()))},e.cloneObjTypeOrder=function(){return[...n.order]},e.countObj=function(e){return Array.isArray(e)?e.length:r(e,"object")?Object.keys(e).length:0},e.extendObjType=function(e,t){const r=[];for(const[i,o]of Object.entries(e))if(!n.items.hasOwnProperty(i)){n.items[i]=o;let e="number"==typeof t?t:-1;if(-1===e){const t=n.order.indexOf("object");e=t>-1?t:n.order.length}e=Math.min(Math.max(0,e),n.order.length),n.order.splice(e,0,i),r.push(i)}return r},e.formatCustomTimer=t,e.formatDayTimer=function(e){return t(e,"days","{days}d {hours}:{minutes}:{seconds}")},e.formatTimer=function(e){return t(e,"hours","{hours}:{minutes}:{seconds}")},e.getAge=function(e=0,t=null){if(null!=e&&0!==e){const n=new Date(e);if(isNaN(n))return null;const r=t instanceof Date?t:new Date;let i=r.getFullYear()-n.getFullYear();const o=r.getMonth(),a=n.getMonth(),s=r.getDate(),u=n.getDate();return(o<a||o===a&&s<u)&&i--,Math.abs(i)}return null},e.getSimplePerc=function(e,t){return e*(t/100)},e.getTimeDuration=function(e=new Date,t="asSeconds",n=null){if(e instanceof Date){const r=e-(n instanceof Date?n:new Date);switch(t){case"asMilliseconds":return r;case"asSeconds":default:return r/1e3;case"asMinutes":return r/6e4;case"asHours":return r/36e5;case"asDays":return r/864e5}}return null},e.objType=r,e.reorderObjTypeOrder=function(e){const t=[...n.order];return!!e.every((e=>t.includes(e)))&&(n.order=e.slice(),!0)},e.ruleOfThree=function(e,t,n,r){return r?Number(e*t)/n:Number(n*t)/e},e.shuffleArray=function(e){let t,n=e.length;for(;0!==n;)t=Math.floor(Math.random()*n),n--,[e[n],e[t]]=[e[t],e[n]];return e},e.toTitleCase=function(e){return e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()))},e.toTitleCaseLowerFirst=function(e){const t=e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()));return t.charAt(0).toLowerCase()+t.slice(1)},e}({});

package/dist/v1/basics/objFilter.cjs

@@ -73,7 +73,7 @@ const typeValidator = {
     buffer: (val) => typeof Buffer !== 'undefined' && Buffer.isBuffer(val),
 
     /** Checks if the value is a Html Element. */
-    htmlElement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
+    htmlelement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
 
     /** Checks if the value is a non-null plain object or instance of a class. */
     object: (val) => typeof val === 'object' && val !== null,
@@ -98,7 +98,7 @@ const typeValidator = {
     'weakmap',
     'weakset',
     'promise',
-    'htmlElement',
+    'htmlelement',
     'object',
   ],
 };

package/dist/v1/basics/objFilter.mjs

@@ -53,7 +53,7 @@ const typeValidator = {
         /** Checks if the value is a Buffer. */
         buffer: (val) => typeof Buffer !== 'undefined' && Buffer.isBuffer(val),
         /** Checks if the value is a Html Element. */
-        htmlElement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
+        htmlelement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
         /** Checks if the value is a non-null plain object or instance of a class. */
         object: (val) => typeof val === 'object' && val !== null,
     },
@@ -76,7 +76,7 @@ const typeValidator = {
         'weakmap',
         'weakset',
         'promise',
-        'htmlElement',
+        'htmlelement',
         'object',
     ],
 };

package/dist/v1/libs/TinyCrypto.cjs

@@ -188,7 +188,7 @@ class TinyCrypto {
     decrypted += decipher.final(this.inputEncoding);
 
     const { type } = this.#deserialize(decrypted);
-    return typeof type === 'string' ? type.toLowerCase() : 'unknown';
+    return typeof type === 'string' ? type : 'unknown';
   }
 
   /**
@@ -458,29 +458,29 @@ class TinyCrypto {
     function: () => {
       throw new Error('Function cannot be serialized');
     },
-    regexp: (data) => JSON.stringify({ __type: 'RegExp', value: data.toString() }),
-    htmlElement: (data) => JSON.stringify({ __type: 'HTMLElement', value: data.outerHTML }),
-    date: (data) => JSON.stringify({ __type: 'Date', value: data.toISOString() }),
-    bigint: (data) => JSON.stringify({ __type: 'BigInt', value: data.toString() }),
-    number: (data) => JSON.stringify({ __type: 'Number', value: data }),
-    boolean: (data) => JSON.stringify({ __type: 'Boolean', value: data }),
-    string: (data) => JSON.stringify({ __type: 'String', value: data }),
-    null: (data) => JSON.stringify({ __type: 'Null' }),
-    undefined: (data) => JSON.stringify({ __type: 'Undefined' }),
+    regexp: (data) => JSON.stringify({ __type: 'regexp', value: data.toString() }),
+    htmlElement: (data) => JSON.stringify({ __type: 'htmlelement', value: data.outerHTML }),
+    date: (data) => JSON.stringify({ __type: 'date', value: data.toISOString() }),
+    bigint: (data) => JSON.stringify({ __type: 'bigint', value: data.toString() }),
+    number: (data) => JSON.stringify({ __type: 'number', value: data }),
+    boolean: (data) => JSON.stringify({ __type: 'boolean', value: data }),
+    string: (data) => JSON.stringify({ __type: 'string', value: data }),
+    null: (data) => JSON.stringify({ __type: 'null' }),
+    undefined: (data) => JSON.stringify({ __type: 'undefined' }),
     map: (data) =>
       JSON.stringify({
-        __type: 'Map',
+        __type: 'map',
         value: Array.from(data.entries()),
       }),
     set: (data) =>
       JSON.stringify({
-        __type: 'Set',
+        __type: 'set',
         value: Array.from(data.values()),
       }),
-    symbol: (data) => JSON.stringify({ __type: 'Symbol', value: data.description }),
-    array: (data) => JSON.stringify({ __type: 'Array', value: data }),
-    object: (data) => JSON.stringify({ __type: 'JSON', value: data }),
-    buffer: (data) => JSON.stringify({ __type: 'Buffer', value: data.toString('base64') }),
+    symbol: (data) => JSON.stringify({ __type: 'symbol', value: data.description }),
+    array: (data) => JSON.stringify({ __type: 'array', value: data }),
+    object: (data) => JSON.stringify({ __type: 'object', value: data }),
+    buffer: (data) => JSON.stringify({ __type: 'buffer', value: data.toString('base64') }),
   };
 
   /**
@@ -492,47 +492,47 @@ class TinyCrypto {
    * and the value is a function that deserializes the value to its original format.
    *
    * @type {Object}
-   * @property {Function} RegExp - Deserializes a regular expression from its string representation (e.g., `/pattern/flags`).
-   * @property {Function} HTMLElement - Deserializes an HTML element from its serialized outerHTML string (only works in browser environments).
-   * @property {Function} Date - Deserializes a date from its ISO string representation.
-   * @property {Function} BigInt - Deserializes a BigInt from its string representation.
-   * @property {Function} Number - Deserializes a number from its string or numeric representation.
-   * @property {Function} Boolean - Deserializes a boolean value from its string representation.
-   * @property {Function} Null - Deserializes the `null` value.
-   * @property {Function} Undefined - Deserializes the `undefined` value.
-   * @property {Function} Map - Deserializes a Map from an array of key-value pairs.
-   * @property {Function} Set - Deserializes a Set from an array of values.
-   * @property {Function} Symbol - Deserializes a Symbol from its string description.
-   * @property {Function} Array - Deserializes an array from its serialized representation.
-   * @property {Function} JSON - Deserializes a plain JSON object from its serialized representation.
-   * @property {Function} String - Deserializes a string from its serialized representation.
-   * @property {Function} Buffer - Deserializes a Buffer from its base64-encoded string representation.
+   * @property {Function} regexp - Deserializes a regular expression from its string representation (e.g., `/pattern/flags`).
+   * @property {Function} htmlelement - Deserializes an HTML element from its serialized outerHTML string (only works in browser environments).
+   * @property {Function} date - Deserializes a date from its ISO string representation.
+   * @property {Function} bigint - Deserializes a BigInt from its string representation.
+   * @property {Function} number - Deserializes a number from its string or numeric representation.
+   * @property {Function} boolean - Deserializes a boolean value from its string representation.
+   * @property {Function} null - Deserializes the `null` value.
+   * @property {Function} undefined - Deserializes the `undefined` value.
+   * @property {Function} map - Deserializes a Map from an array of key-value pairs.
+   * @property {Function} set - Deserializes a Set from an array of values.
+   * @property {Function} symbol - Deserializes a Symbol from its string description.
+   * @property {Function} array - Deserializes an array from its serialized representation.
+   * @property {Function} object - Deserializes a plain JSON object from its serialized representation.
+   * @property {Function} string - Deserializes a string from its serialized representation.
+   * @property {Function} buffer - Deserializes a Buffer from its base64-encoded string representation.
    */
   #valueTypes = {
-    RegExp: (value) => {
+    regexp: (value) => {
       const match = value.match(/^\/(.*)\/([gimsuy]*)$/);
       return match ? new RegExp(match[1], match[2]) : new RegExp(value);
     },
-    HTMLElement: (value) => {
+    htmlelement: (value) => {
       if (typeof document === 'undefined')
         throw new Error('HTMLElement deserialization is only supported in browsers');
       const div = document.createElement('div');
       div.innerHTML = value;
       return div.firstElementChild;
     },
-    Date: (value) => new Date(value),
-    BigInt: (value) => BigInt(value),
-    Number: (value) => Number(value),
-    Boolean: (value) => Boolean(value),
-    Null: (value) => null,
-    Undefined: (value) => undefined,
-    Map: (value) => new Map(value),
-    Set: (value) => new Set(value),
-    Symbol: (value) => Symbol(value),
-    Array: (value) => value,
-    JSON: (value) => value,
-    String: (value) => String(value),
-    Buffer: (value) => Buffer.from(value, 'base64'),
+    date: (value) => new Date(value),
+    bigint: (value) => BigInt(value),
+    number: (value) => Number(value),
+    boolean: (value) => Boolean(value),
+    null: (value) => null,
+    undefined: (value) => undefined,
+    map: (value) => new Map(value),
+    set: (value) => new Set(value),
+    symbol: (value) => Symbol(value),
+    array: (value) => value,
+    object: (value) => value,
+    string: (value) => String(value),
+    buffer: (value) => Buffer.from(value, 'base64'),
   };
 
   /**
@@ -564,7 +564,7 @@ class TinyCrypto {
       const parsed = JSON.parse(text);
       const type = parsed.__type;
 
-      if (typeof type !== 'string') return { value: text, type: 'String' };
+      if (typeof type !== 'string') return { value: text, type: 'string' };
       if (typeof this.#valueTypes[type] === 'function')
         return {
           value: this.#valueTypes[type](parsed.value),
@@ -586,10 +586,8 @@ class TinyCrypto {
    * @throws {Error} If the types do not match.
    */
   #validateDeserializedType(expected, actual) {
-    if (expected.toLowerCase() !== actual.toLowerCase())
-      throw new Error(
-        `Type mismatch: expected ${expected.toLowerCase()}, but got ${actual.toLowerCase()}`,
-      );
+    if (expected !== actual)
+      throw new Error(`Type mismatch: expected ${expected}, but got ${actual}`);
   }
 }
 

package/dist/v1/libs/TinyCrypto.mjs

@@ -169,7 +169,7 @@ class TinyCrypto {
         let decrypted = decipher.update(encryptedBuffer, null, this.inputEncoding);
         decrypted += decipher.final(this.inputEncoding);
         const { type } = this.#deserialize(decrypted);
-        return typeof type === 'string' ? type.toLowerCase() : 'unknown';
+        return typeof type === 'string' ? type : 'unknown';
     }
     /**
      * Saves the cryptographic key to a file.
@@ -440,27 +440,27 @@ class TinyCrypto {
         function: () => {
             throw new Error('Function cannot be serialized');
         },
-        regexp: (data) => JSON.stringify({ __type: 'RegExp', value: data.toString() }),
-        htmlElement: (data) => JSON.stringify({ __type: 'HTMLElement', value: data.outerHTML }),
-        date: (data) => JSON.stringify({ __type: 'Date', value: data.toISOString() }),
-        bigint: (data) => JSON.stringify({ __type: 'BigInt', value: data.toString() }),
-        number: (data) => JSON.stringify({ __type: 'Number', value: data }),
-        boolean: (data) => JSON.stringify({ __type: 'Boolean', value: data }),
-        string: (data) => JSON.stringify({ __type: 'String', value: data }),
-        null: (data) => JSON.stringify({ __type: 'Null' }),
-        undefined: (data) => JSON.stringify({ __type: 'Undefined' }),
+        regexp: (data) => JSON.stringify({ __type: 'regexp', value: data.toString() }),
+        htmlElement: (data) => JSON.stringify({ __type: 'htmlelement', value: data.outerHTML }),
+        date: (data) => JSON.stringify({ __type: 'date', value: data.toISOString() }),
+        bigint: (data) => JSON.stringify({ __type: 'bigint', value: data.toString() }),
+        number: (data) => JSON.stringify({ __type: 'number', value: data }),
+        boolean: (data) => JSON.stringify({ __type: 'boolean', value: data }),
+        string: (data) => JSON.stringify({ __type: 'string', value: data }),
+        null: (data) => JSON.stringify({ __type: 'null' }),
+        undefined: (data) => JSON.stringify({ __type: 'undefined' }),
         map: (data) => JSON.stringify({
-            __type: 'Map',
+            __type: 'map',
             value: Array.from(data.entries()),
         }),
         set: (data) => JSON.stringify({
-            __type: 'Set',
+            __type: 'set',
             value: Array.from(data.values()),
         }),
-        symbol: (data) => JSON.stringify({ __type: 'Symbol', value: data.description }),
-        array: (data) => JSON.stringify({ __type: 'Array', value: data }),
-        object: (data) => JSON.stringify({ __type: 'JSON', value: data }),
-        buffer: (data) => JSON.stringify({ __type: 'Buffer', value: data.toString('base64') }),
+        symbol: (data) => JSON.stringify({ __type: 'symbol', value: data.description }),
+        array: (data) => JSON.stringify({ __type: 'array', value: data }),
+        object: (data) => JSON.stringify({ __type: 'object', value: data }),
+        buffer: (data) => JSON.stringify({ __type: 'buffer', value: data.toString('base64') }),
     };
     /**
      * A mapping of data types to their deserialization functions.
@@ -471,47 +471,47 @@ class TinyCrypto {
      * and the value is a function that deserializes the value to its original format.
      *
      * @type {Object}
-     * @property {Function} RegExp - Deserializes a regular expression from its string representation (e.g., `/pattern/flags`).
-     * @property {Function} HTMLElement - Deserializes an HTML element from its serialized outerHTML string (only works in browser environments).
-     * @property {Function} Date - Deserializes a date from its ISO string representation.
-     * @property {Function} BigInt - Deserializes a BigInt from its string representation.
-     * @property {Function} Number - Deserializes a number from its string or numeric representation.
-     * @property {Function} Boolean - Deserializes a boolean value from its string representation.
-     * @property {Function} Null - Deserializes the `null` value.
-     * @property {Function} Undefined - Deserializes the `undefined` value.
-     * @property {Function} Map - Deserializes a Map from an array of key-value pairs.
-     * @property {Function} Set - Deserializes a Set from an array of values.
-     * @property {Function} Symbol - Deserializes a Symbol from its string description.
-     * @property {Function} Array - Deserializes an array from its serialized representation.
-     * @property {Function} JSON - Deserializes a plain JSON object from its serialized representation.
-     * @property {Function} String - Deserializes a string from its serialized representation.
-     * @property {Function} Buffer - Deserializes a Buffer from its base64-encoded string representation.
+     * @property {Function} regexp - Deserializes a regular expression from its string representation (e.g., `/pattern/flags`).
+     * @property {Function} htmlelement - Deserializes an HTML element from its serialized outerHTML string (only works in browser environments).
+     * @property {Function} date - Deserializes a date from its ISO string representation.
+     * @property {Function} bigint - Deserializes a BigInt from its string representation.
+     * @property {Function} number - Deserializes a number from its string or numeric representation.
+     * @property {Function} boolean - Deserializes a boolean value from its string representation.
+     * @property {Function} null - Deserializes the `null` value.
+     * @property {Function} undefined - Deserializes the `undefined` value.
+     * @property {Function} map - Deserializes a Map from an array of key-value pairs.
+     * @property {Function} set - Deserializes a Set from an array of values.
+     * @property {Function} symbol - Deserializes a Symbol from its string description.
+     * @property {Function} array - Deserializes an array from its serialized representation.
+     * @property {Function} object - Deserializes a plain JSON object from its serialized representation.
+     * @property {Function} string - Deserializes a string from its serialized representation.
+     * @property {Function} buffer - Deserializes a Buffer from its base64-encoded string representation.
      */
     #valueTypes = {
-        RegExp: (value) => {
+        regexp: (value) => {
             const match = value.match(/^\/(.*)\/([gimsuy]*)$/);
             return match ? new RegExp(match[1], match[2]) : new RegExp(value);
         },
-        HTMLElement: (value) => {
+        htmlelement: (value) => {
             if (typeof document === 'undefined')
                 throw new Error('HTMLElement deserialization is only supported in browsers');
             const div = document.createElement('div');
             div.innerHTML = value;
             return div.firstElementChild;
         },
-        Date: (value) => new Date(value),
-        BigInt: (value) => BigInt(value),
-        Number: (value) => Number(value),
-        Boolean: (value) => Boolean(value),
-        Null: (value) => null,
-        Undefined: (value) => undefined,
-        Map: (value) => new Map(value),
-        Set: (value) => new Set(value),
-        Symbol: (value) => Symbol(value),
-        Array: (value) => value,
-        JSON: (value) => value,
-        String: (value) => String(value),
-        Buffer: (value) => Buffer.from(value, 'base64'),
+        date: (value) => new Date(value),
+        bigint: (value) => BigInt(value),
+        number: (value) => Number(value),
+        boolean: (value) => Boolean(value),
+        null: (value) => null,
+        undefined: (value) => undefined,
+        map: (value) => new Map(value),
+        set: (value) => new Set(value),
+        symbol: (value) => Symbol(value),
+        array: (value) => value,
+        object: (value) => value,
+        string: (value) => String(value),
+        buffer: (value) => Buffer.from(value, 'base64'),
     };
     /**
      * Serializes a given data value into a JSON-compatible format based on its type.
@@ -542,7 +542,7 @@ class TinyCrypto {
             const parsed = JSON.parse(text);
             const type = parsed.__type;
             if (typeof type !== 'string')
-                return { value: text, type: 'String' };
+                return { value: text, type: 'string' };
             if (typeof this.#valueTypes[type] === 'function')
                 return {
                     value: this.#valueTypes[type](parsed.value),
@@ -565,8 +565,8 @@ class TinyCrypto {
      * @throws {Error} If the types do not match.
      */
     #validateDeserializedType(expected, actual) {
-        if (expected.toLowerCase() !== actual.toLowerCase())
-            throw new Error(`Type mismatch: expected ${expected.toLowerCase()}, but got ${actual.toLowerCase()}`);
+        if (expected !== actual)
+            throw new Error(`Type mismatch: expected ${expected}, but got ${actual}`);
     }
 }
 export default TinyCrypto;

package/docs/libs/TinyCrypto.md

@@ -79,7 +79,7 @@ const result = crypto.encrypt('Hello!');
 Decrypts a previously encrypted value and returns the original data. You can optionally pass an `expectedType` to validate it.
 
 ```js
-const plain = crypto.decrypt(result, 'String');
+const plain = crypto.decrypt(result, 'string');
 ```
 
 ---
@@ -136,7 +136,7 @@ Returns an object with the current settings:
   "outputEncoding": "hex",
   "inputEncoding": "utf8",
   "authTagLength": 16,
-  "key": "..." // hex string
+  "key": "..."
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",