memorio 0.2.10 → 0.2.12

package/index.d.ts

@@ -0,0 +1,6 @@
+
+/// <reference path="./types/memorio.d.ts" />
+/// <reference path="./types/observer.d.ts" />
+/// <reference path="./types/state.d.ts" />
+/// <reference path="./types/store.d.ts" />
+/// <reference path="./types/cache.d.ts" />

package/index.js

@@ -1 +1 @@
-"use strict";(()=>{var f=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var n=(e,r)=>()=>(e&&(r=e(e=0)),r);var T=(e,r,s,l)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of P(r))!S.call(e,t)&&t!==s&&f(e,t,{get:()=>r[t],enumerable:!(l=O(r,t))||l.enumerable});return e};var c=e=>T(f({},"__esModule",{value:!0}),e);var g,b=n(()=>{g={name:"memorio",version:"0.2.10",type:"module",main:"index.js",types:"index.d.ts",typings:"./types/*",description:"Memorio, State + Observer and Store for a easy life ",license:"MIT",deprecated:!1,preferGlobal:!0,target:"node",copyright:"Dario Passariello, BigLogic ca - a51.dev is a BigLogic project",homepage:"https://a51.gitbook.io/memorio",author:{name:"Dario Passariello",url:"https://dario.passariello.ca/",email:"dariopassariello@gmail.com"},support:{name:"Dario Passariello",url:"https://github.com/passariello/",email:"dariopassariello@gmail.com"},contributors:[{name:"Dario Passariello",email:"dariopassarielloa@gmail.com"},{name:"Valeria Cala Scaglitta",email:"valeriacalascaglitta@gmail.com"}],globals:{memorio:{}},keywords:["biglogic","a51","memorio","state","store","observer","dario","passariello"],repository:{type:"git",url:"git+https://github.com/a51-dev/a51.memorio.git",help:"https://github.com/a51-dev/a51.memorio#readme"},bugs:{url:"https://github.com/a51-dev/a51.memorio/issues"},funding:[{type:"patreon",url:"https://www.patreon.com/passariello"}],scripts:{build:"node ./esbuild.config.mjs",watch:"esbuild init.ts --bundle --outdir=dist --serve","-----------":"",tsc:"tsc -b .",eslint:"eslint .",updates:"npx npm-check-updates -u && npm i","----------":"","publish:npm":"npm run build && npm publish ./dist"},dependencies:{"dphelper.types":"0.0.14"},devDependencies:{"@eslint/js":"9.33.0","@types/jest":"^30.0.0","@types/node":"^24.3.0","dphelper.types":"0.0.14",esbuild:"^0.25.9","esbuild-plugin-clean":"^1.0.1","esbuild-plugin-copy":"^2.1.1",eslint:"9.33.0","ts-loader":"^9.5.2","ts-node":"10.9.2",tslib:"^2.8.1",typescript:"5.9.2"}}});var E={};var m=n(()=>{"use strict";b();Object.defineProperty(globalThis,"memorio",{value:{},writable:!1,configurable:!1,enumerable:!1});Object.defineProperty(globalThis,"events",{value:{},writable:!0,configurable:!1,enumerable:!1});Object.defineProperty(memorio,"version",{writable:!1,configurable:!1,enumerable:!1,value:g.version})});var k={};var d=n(()=>{"use strict";Object.defineProperty(memorio,"dispatch",{writable:!1,configurable:!1,enumerable:!1,value:{set:(e,r={})=>{dispatchEvent(new CustomEvent(String(e),r))},listen:(e,r=null,s=!1)=>{observer.list?.[e]?.length>0&&observer.remove(e);let l=t=>r?setTimeout(()=>r(t),1):null;globalThis.addEventListener(e,l),globalThis.events[e]=l},remove:e=>{globalThis.removeEventListener(e,globalThis.events[e]),delete globalThis.events[e]}}})});var x={};var p,h,v=n(()=>{"use strict";Object.defineProperty(memorio,"objPath",{writable:!1,configurable:!1,enumerable:!1,value:(e,r,s=".")=>r.concat(e).join(s)});p=(e,r,s=[])=>{let l=t=>{let o=t.split(".");o.forEach((i,a)=>{let u=o.slice(0,a+1).join(".");globalThis.memorio.dispatch.set(u,{detail:{name:u}})})};return new Proxy(e,{get(t,o){if(Object.isFrozen(t[o]))return t[o];try{let i=Reflect.get(t,o);return i&&typeof i=="object"&&["Array","Object"].includes(i.constructor.name)?p(i,r,s.concat(o)):i}catch(i){return console.error("Error: ",i),!1}},set(t,o,i){if(t[o]&&typeof t[o]=="object"&&Object.isFrozen(t[o])){console.error(`Error: state '${o}' is locked`);return}try{let a=globalThis.memorio.objPath(o,s);return r({action:"set",path:a,target:t,newValue:i,previousValue:Reflect.get(t,o)}),l("state."+a),Reflect.set(t,o,i),t[o]&&typeof t[o]=="object"&&Reflect.defineProperty(t[o],"lock",{value(){Object.defineProperty(t,o,{writable:!1,enumerable:!1}),Object.freeze(t[o])}}),!0}catch(a){return console.error("Error in set trap:",a),!1}},deleteProperty(t,o){try{let i=globalThis.memorio.objPath(o,s);return r({action:"delete",path:i,target:t}),Reflect.deleteProperty(t,o)}catch(i){return console.error("Error in deleteProperty trap:",i),!1}}})};globalThis?.state?globalThis.state=state:globalThis.state=p({},()=>{});h=new WeakSet;h.add(state);setInterval(()=>{if(!h.has(state)){alert("memorio State is compromised, check if you override it and please reload the page");for(let e=1;e<99999;e++)clearInterval(e);stop()}},1e3);Object.defineProperty(globalThis,"state",{enumerable:!1,configurable:!1});Object.defineProperties(state,{list:{get(){let e=globalThis.memorio.array.deepClone(state);return console.log(e)}},remove:{value(e){e in state?(delete state[e],console.debug(`State '${e}' deleted`)):console.error(`'${e}' not exist`)},writable:!1,configurable:!1},removeAll:{value(){state.forEach(e=>{delete state[e[0]]})},writable:!1,configurable:!1}})});var I={};var y=n(()=>{"use strict";globalThis.observer||(globalThis.observer=null);Object.defineProperty(globalThis,"observer",{enumerable:!1});observer=(e,r=null,s=!0)=>{if((t=>t.split(".")[0]!=="state"?(console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${t}' string is incorrect!`),!1):!0)(e)){if(!e&&!r){console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");return}if(!e&&r){console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'.");return}if(e&&!r){globalThis.memorio.dispatch.listen(String(e),{detail:{name:String(e)}}),console.debug("called: ",e);return}if(e&&r){if(typeof e!="string"||typeof r!="function"){console.error("Observer Error: name of state need to be a 'string' like 'state.test' and the callback need to be a 'function'");return}globalThis.memorio.dispatch.listen(e,r,s);return}}};Object.defineProperties(observer,{list:{get:()=>globalThis.events},remove:{value:e=>{e&&(globalThis.events[e]="")}},removeAll:{get:()=>{Object.entries(observer.list).forEach(e=>{globalThis.events[e[0]]})}}});Object.freeze(observer)});var $={};var j=n(()=>{"use strict";Object.defineProperty(globalThis,"store",{value:new Proxy({},{}),enumerable:!1,configurable:!1});Object.defineProperties(store,{get:{value(e){if(e)try{let r=localStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.error(`Error parsing store item '${e}':`,r)}}},set:{value(e,r){if(e)try{r==null?localStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?localStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.error("It's not secure to store functions.")}catch(s){console.error(`Error setting store item '${e}':`,s)}}},remove:{value(e){if(e&&localStorage.getItem(e))return localStorage.removeItem(e),!0}},delete:{value(e){store.remove(e)}},removeAll:{value(){return localStorage.clear(),!0}},clearAll:{value(){return store.removeAll(),!0}},quota:{value(){"storage"in navigator&&"estimate"in navigator.storage&&navigator.storage.estimate().then(({usage:e,quota:r})=>{e&&r&&console.debug(`Using ${e/1024} out of ${r/1024} Mb.`)}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let r in localStorage)if(localStorage.hasOwnProperty(r)){let s=localStorage.getItem(r);s&&(e+=s.length)}return e}}});Object.freeze(store)});m();d();v();y();j();})();
+"use strict";(()=>{var f=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var n=(e,r)=>()=>(e&&(r=e(e=0)),r);var T=(e,r,s,l)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of P(r))!S.call(e,t)&&t!==s&&f(e,t,{get:()=>r[t],enumerable:!(l=O(r,t))||l.enumerable});return e};var c=e=>T(f({},"__esModule",{value:!0}),e);var g,b=n(()=>{g={name:"memorio",version:"0.2.12",type:"module",main:"index.js",types:"index.d.ts",typings:"./types/*",description:"Memorio, State + Observer and Store for a easy life ",license:"MIT",deprecated:!1,preferGlobal:!0,target:"node",copyright:"Dario Passariello, BigLogic ca - a51.dev is a BigLogic project",homepage:"https://a51.gitbook.io/memorio",author:{name:"Dario Passariello",url:"https://dario.passariello.ca/",email:"dariopassariello@gmail.com"},support:{name:"Dario Passariello",url:"https://github.com/passariello/",email:"dariopassariello@gmail.com"},contributors:[{name:"Dario Passariello",email:"dariopassarielloa@gmail.com"},{name:"Valeria Cala Scaglitta",email:"valeriacalascaglitta@gmail.com"}],globals:{memorio:{}},keywords:["biglogic","a51","memorio","state","store","observer","dario","passariello"],repository:{type:"git",url:"git+https://github.com/a51-dev/a51.memorio.git",help:"https://github.com/a51-dev/a51.memorio#readme"},bugs:{url:"https://github.com/a51-dev/a51.memorio/issues"},funding:[{type:"patreon",url:"https://www.patreon.com/passariello"}],typing:["types/*"],scripts:{build:"node ./esbuild.config.mjs",watch:"esbuild init.ts --bundle --outdir=dist --serve","-----------":"",tsc:"tsc -b .",eslint:"eslint .",updates:"npx npm-check-updates -u && npm i","----------":"","publish:npm":"npm run build && npm publish ./dist"},dependencies:{"dphelper.types":"0.0.14"},devDependencies:{"@eslint/js":"9.33.0","@types/jest":"^30.0.0","@types/node":"^24.3.0","@typescript-eslint/eslint-plugin":"8.40.0","@typescript-eslint/parser":"8.40.0","dphelper.types":"0.0.14",esbuild:"^0.25.9","esbuild-plugin-clean":"^1.0.1","esbuild-plugin-copy":"^2.1.1",eslint:"9.33.0","ts-loader":"^9.5.2","ts-node":"10.9.2",tslib:"^2.8.1",typescript:"5.9.2"}}});var E={};var m=n(()=>{"use strict";b();Object.defineProperty(globalThis,"memorio",{value:{},writable:!1,configurable:!1,enumerable:!1});Object.defineProperty(globalThis,"events",{value:{},writable:!0,configurable:!1,enumerable:!1});Object.defineProperty(memorio,"version",{writable:!1,configurable:!1,enumerable:!1,value:g.version})});var k={};var d=n(()=>{"use strict";Object.defineProperty(memorio,"dispatch",{writable:!1,configurable:!1,enumerable:!1,value:{set:(e,r={})=>{dispatchEvent(new CustomEvent(String(e),r))},listen:(e,r=null,s=!1)=>{observer.list?.[e]?.length>0&&observer.remove(e);let l=t=>r?setTimeout(()=>r(t),1):null;globalThis.addEventListener(e,l),globalThis.events[e]=l},remove:e=>{globalThis.removeEventListener(e,globalThis.events[e]),delete globalThis.events[e]}}})});var x={};var p,h,y=n(()=>{"use strict";Object.defineProperty(memorio,"objPath",{writable:!1,configurable:!1,enumerable:!1,value:(e,r,s=".")=>r.concat(e).join(s)});p=(e,r,s=[])=>{let l=t=>{let o=t.split(".");o.forEach((i,a)=>{let u=o.slice(0,a+1).join(".");globalThis.memorio.dispatch.set(u,{detail:{name:u}})})};return new Proxy(e,{get(t,o){if(Object.isFrozen(t[o]))return t[o];try{let i=Reflect.get(t,o);return i&&typeof i=="object"&&["Array","Object"].includes(i.constructor.name)?p(i,r,s.concat(o)):i}catch(i){return console.error("Error: ",i),!1}},set(t,o,i){if(t[o]&&typeof t[o]=="object"&&Object.isFrozen(t[o])){console.error(`Error: state '${o}' is locked`);return}try{let a=globalThis.memorio.objPath(o,s);return r({action:"set",path:a,target:t,newValue:i,previousValue:Reflect.get(t,o)}),l("state."+a),Reflect.set(t,o,i),t[o]&&typeof t[o]=="object"&&Reflect.defineProperty(t[o],"lock",{value(){Object.defineProperty(t,o,{writable:!1,enumerable:!1}),Object.freeze(t[o])}}),!0}catch(a){return console.error("Error in set trap:",a),!1}},deleteProperty(t,o){try{let i=globalThis.memorio.objPath(o,s);return r({action:"delete",path:i,target:t}),Reflect.deleteProperty(t,o)}catch(i){return console.error("Error in deleteProperty trap:",i),!1}}})};globalThis?.state?globalThis.state=state:globalThis.state=p({},()=>{});h=new WeakSet;h.add(state);setInterval(()=>{if(!h.has(state)){alert("memorio State is compromised, check if you override it and please reload the page");for(let e=1;e<99999;e++)clearInterval(e);stop()}},1e3);Object.defineProperty(globalThis,"state",{enumerable:!1,configurable:!1});Object.defineProperties(state,{list:{get(){let e=globalThis.memorio.array.deepClone(state);return console.log(e)}},remove:{value(e){e in state?(delete state[e],console.debug(`State '${e}' deleted`)):console.error(`'${e}' not exist`)},writable:!1,configurable:!1},removeAll:{value(){state.forEach(e=>{delete state[e[0]]})},writable:!1,configurable:!1}})});var I={};var v=n(()=>{"use strict";globalThis.observer||(globalThis.observer=null);Object.defineProperty(globalThis,"observer",{enumerable:!1});observer=(e,r=null,s=!0)=>{if((t=>t.split(".")[0]!=="state"?(console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${t}' string is incorrect!`),!1):!0)(e)){if(!e&&!r){console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");return}if(!e&&r){console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'.");return}if(e&&!r){globalThis.memorio.dispatch.listen(String(e),{detail:{name:String(e)}}),console.debug("called: ",e);return}if(e&&r){if(typeof e!="string"||typeof r!="function"){console.error("Observer Error: name of state need to be a 'string' like 'state.test' and the callback need to be a 'function'");return}globalThis.memorio.dispatch.listen(e,r,s);return}}};Object.defineProperties(observer,{list:{get:()=>globalThis.events},remove:{value:e=>{e&&(globalThis.events[e]="")}},removeAll:{get:()=>{Object.entries(observer.list).forEach(e=>{globalThis.events[e[0]]})}}});Object.freeze(observer)});var $={};var j=n(()=>{"use strict";Object.defineProperty(globalThis,"store",{value:new Proxy({},{}),enumerable:!1,configurable:!1});Object.defineProperties(store,{get:{value(e){if(e)try{let r=localStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.error(`Error parsing store item '${e}':`,r)}}},set:{value(e,r){if(e)try{r==null?localStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?localStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.error("It's not secure to store functions.")}catch(s){console.error(`Error setting store item '${e}':`,s)}}},remove:{value(e){if(e&&localStorage.getItem(e))return localStorage.removeItem(e),!0}},delete:{value(e){store.remove(e)}},removeAll:{value(){return localStorage.clear(),!0}},clearAll:{value(){return store.removeAll(),!0}},quota:{value(){"storage"in navigator&&"estimate"in navigator.storage&&navigator.storage.estimate().then(({usage:e,quota:r})=>{e&&r&&console.debug(`Using ${e/1024} out of ${r/1024} Mb.`)}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let r in localStorage)if(localStorage.hasOwnProperty(r)){let s=localStorage.getItem(r);s&&(e+=s.length)}return e}}});Object.freeze(store)});m();d();y();v();j();})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorio",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -59,6 +59,9 @@
       "url": "https://www.patreon.com/passariello"
     }
   ],
+  "typing": [
+    "types/*"
+  ],
   "scripts": {
     "build": "node ./esbuild.config.mjs",
     "watch": "esbuild init.ts --bundle --outdir=dist --serve",
@@ -76,6 +79,8 @@
     "@eslint/js": "9.33.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.3.0",
+    "@typescript-eslint/eslint-plugin": "8.40.0",
+    "@typescript-eslint/parser": "8.40.0",
     "dphelper.types": "0.0.14",
     "esbuild": "^0.25.9",
     "esbuild-plugin-clean": "^1.0.1",

package/types/cache.d.ts

@@ -0,0 +1,27 @@
+/*!
+  dphelper
+  Copyright (c) 2019 Dario Passariello <dariopassariello@gmail.com>
+  Licensed under MIT License, see
+  https://dario.passariello.ca
+*/
+
+/**
+* Cache is used for internal use only... but you can use if you need.
+* @return Some stuff you cache... usually used for dynamic imports from dphelper.
+*/
+
+interface _cache {
+
+  /**
+  * Create a cache, please use state instead!
+  *
+  * @example
+  * cache.myCache = any
+  *
+  * @since dphelper 1.0.6
+  */
+  [key: string]: any
+}
+
+declare var cache: _cache
+type cache = _cache

package/types/memorio.d.ts

@@ -0,0 +1,23 @@
+
+declare module 'memorio' {
+  const resource: { [key: string]: any }
+  export = resource
+}
+
+interface _memorio {
+  setProps: any,
+  obj: any,
+  array: any,
+  dispatch: any,
+  setDescription: any
+}
+
+type memorio = _memorio
+declare var memorio: any
+
+type arguments = any
+declare var arguments: any
+
+global.memorio = global.memorio
+  ? global.memorio
+  : globalThis.memorio

package/types/observer.d.ts

@@ -0,0 +1,47 @@
+/*!
+  memorio
+  Copyright (c) 2025 Dario Passariello <dariopassariello@gmail.com>
+  Licensed under MIT License, see
+  https://dario.passariello.ca
+*/
+
+/**
+* Observer run a callback anytime the associated state going to change
+* @return Execution of function after state change.
+*/
+interface _observer {
+
+  /**
+  * Generate your observer
+  *
+  * @example
+  * observer("myState", Function)
+  *
+  * @since memorio 1.0.6
+  */
+  (stateName: string, callBack: any): any
+
+  /**
+  * List of active observers
+  *
+  * @example
+  * observer.list()
+  *
+  * @since memorio 1.0.6
+  */
+  readonly list?: () => void
+
+  /**
+  * Remove the active observer (not the state)
+  *
+  * @example
+  * observer.remove("myState")
+  *
+  * @since memorio 1.0.6
+  */
+  readonly remove?: (name: string, callBack?: any, flag?: boolean) => void
+
+}
+
+declare var observer: _observer
+type observer = _observer

package/types/state.d.ts

@@ -0,0 +1,71 @@
+/*!
+  memorio
+  Copyright (c) 2025 Dario Passariello <dariopassariello@gmail.com>
+  Licensed under MIT License, see
+  https://dario.passariello.ca
+*/
+
+/**
+* If you use only "state" you get the entire Proxy object
+* @return Proxy Object of all states.
+*/
+interface _state {
+
+  /**
+   * Create states using: state.test = "example"
+   *
+   * @example
+   * state.myStuff = any
+   *
+   * @since memorio 0.0.1
+   * @param key The name of the state for which you want to modify the action.
+   * @return The previous values (Any).
+   * Important: Object is a Proxy.
+   */
+  [key: string]: any
+
+  /**
+   * Delete entire state using: state.remove("test")
+   *
+   * @example
+   * state.remove(stateName)
+   *
+   * @since memorio 0.0.1
+   * @param stateName The name of the state for which you want to delete.
+   * @return boolean.
+   */
+  readonly remove?: (stateName: string) => any
+
+  /**
+   * List all states using: state.list
+   *
+   * @example
+   * state.removeAll()
+   *
+   * @since memorio 1.8.92
+   * @return Remove all states.
+   */
+  readonly removeAll?: () => any
+
+  /**
+   * List all states using: state.list
+   *
+   * @example
+   * state.list
+   *
+   * @since memorio 0.0.1
+   * @return Object of all states (Not the Proxy).
+   */
+  readonly list?: (stateName: string) => any
+
+  /**
+  * Generate a message for "memorio"
+  * Note: FOR INTERNAL USE ONLY.
+  * @since memorio 0.0.1
+  */
+  readonly mex?: any
+
+}
+
+declare var state: _state
+type state = _state

package/types/store.d.ts

@@ -0,0 +1,91 @@
+/*!
+  memorio
+  Copyright (c) 2025 Dario Passariello <dariopassariello@gmail.com>
+  Licensed under MIT License, see
+  https://dario.passariello.ca
+*/
+
+/**
+ * Create states using: store.set("example",{test:"test"})
+*/
+interface _store {
+
+  /**
+    * Create a new store
+    *
+    * @example
+    * store.set("test","example") // or Array, Object, Number, Functions...
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the store.
+    * @param param The information taht you want to store (Any).
+    * @return boolean
+  */
+  set: (name: string, value: any) => void
+
+  /**
+    * Have back the data from a store.
+    *
+    * @example
+    * store.get("test")
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the store.
+  */
+  get: (name: string) => any
+
+  /**
+    * Delete an existing store:
+    *
+    * @example
+    * store.delete("test")
+    * store.remove("test")
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the store.
+    * @return boolean
+  */
+  delete: (name: string) => boolean | undefined
+  remove: (name: string) => boolean | undefined
+
+  /**
+    * Delete all storages
+    *
+    * @example
+    * store.clearAll()
+    * store.removeAll()
+    *
+    * @since memorio 0.0.1
+    * @return boolean
+  */
+  clearAll: () => boolean
+  removeAll: () => boolean
+
+  /**
+    * Know how much space you have for total storages
+    *
+    * @example
+    * store.quota()
+    *
+    * @since memorio 0.0.1
+    * @return values
+  */
+  quota: () => void
+
+  /**
+    * Get the size of stores an the total
+    *
+    * @example
+    * store.size()
+    *
+    * @since memorio 0.0.1
+    * @return dimension in kb
+  */
+  size: () => number
+
+  // TODO
+  // readonly increaseQuota: (value: number) => void
+}
+
+declare var store: _store
+type store = _store