memorio 0.2.19 → 1.0.0

package/dist/README.md

@@ -0,0 +1,319 @@
+# Memorio
+
+> A lightweight, type-safe state management library for modern JavaScript applications
+
+![TypeScript](https://img.shields.io/badge/TypeScript-5.9.2-blue?logo=typescript)
+![Node.js](https://img.shields.io/badge/Node.js-24.3.0-green?logo=node.js)
+![Jest](https://img.shields.io/badge/Jest-30.0.5-red?logo=jest)
+![ESLint](https://img.shields.io/badge/ESLint-9.34.0-purple?logo=eslint)
+![esbuild](https://img.shields.io/badge/esbuild-0.25.9-yellow?logo=esbuild)
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Version](https://img.shields.io/badge/version-0.2.15-orange)
+
+![Tests](https://img.shields.io/badge/tests-passing-brightgreen)
+![Coverage](https://img.shields.io/badge/coverage-25%20passed-success)
+
+## 📋 Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [State Management](#state-management)
+  - [Observer Pattern](#observer-pattern)
+  - [Store](#store)
+  - [Session](#session)
+- [Testing](#testing)
+- [Security](#security)
+- [License](#license)
+
+## ✨ Features
+
+- 🔄 Reactive state management with observer pattern
+- 💾 Persistent storage with Store API
+- ⚡ Session management for temporary data
+- 🔒 Type-safe with full TypeScript support
+- 🧪 Comprehensive test coverage
+- 🎯 Zero dependencies
+- 🔍 Easy debugging with proxy-based state
+
+## 📦 Installation
+
+```bash
+npm install memorio
+# or
+yarn add memorio
+# or
+pnpm add memorio
+```
+
+✅ All test suites are passing:
+
+- Basic functionality tests
+- State management tests
+- Store operations tests
+- Cache operations tests
+- Observer pattern tests
+
+Total: 25 tests passed across 5 test suites
+
+## 🚀 Quick Start
+
+```javascript
+import 'memorio';
+
+// State Management
+state.counter = 0;
+state.user = { name: 'John', age: 30 };
+
+// Observer Pattern
+observer('state.counter', (newValue, oldValue) => {
+  console.log(`Counter changed from ${oldValue} to ${newValue}`);
+});
+
+// Store (Persistent Storage)
+store.set('preferences', { theme: 'dark' });
+const preferences = store.get('preferences');
+
+// Session Storage
+session.set('token', 'user-jwt-token');
+const token = session.get('token');
+```
+
+## 📖 API Reference
+
+### State Management
+
+State in Memorio is globally accessible and reactive:
+
+```javascript
+// Setting state
+state.user = { name: 'John' };
+
+// Getting state
+const userName = state.user.name;
+
+// Listing all states
+console.log(state.list);
+
+// Locking state (for Objects or Arrays)
+state.user.lock();
+
+// Removing state
+state.remove('user');
+
+// Clearing all states
+state.removeAll();
+
+```
+
+### Observer Pattern
+
+Observe state changes with React-like syntax:
+
+```javascript
+// Basic observer
+observer('state.user', (newValue, oldValue) => {
+  console.log('User updated:', newValue);
+});
+
+// With React useState
+const [user, setUser] = useState();
+observer('state.user', () => {
+  setUser(state.user);
+});
+
+// With React useEffect
+useEffect(() => {
+  console.log('User changed:', state.user);
+}, [state.user]);
+```
+
+### Another example of use of Observer
+
+```js
+import 'memorio';
+
+// Use the observer to log the changing state value
+observer(
+  'state.count',
+  () => console.log("State changed: ", state.count)
+);
+
+// Store a value in the state that changes every 5 seconds
+setInterval(() => state.count = Date.now(), 5000);
+```
+
+---
+
+## STORE
+
+```js
+// Set a store:
+store.set("test", { test: "test" })
+
+// Get a store:
+store.get("test") // Output: { test: "test" }
+
+// Remove a store:
+store.remove("test") // Output: "ok"
+
+// Remove all stores:
+store.removeAll() // Output: "ok"
+```
+
+### Store
+
+Persistent storage for your application:
+
+```javascript
+// Setting values
+store.set('config', { theme: 'dark', language: 'en' });
+
+// Getting values
+const config = store.get('config');
+
+// Removing specific value
+store.remove('config');
+
+// Getting store size
+const size = store.size();
+
+// Clearing store
+store.removeAll();
+```
+
+### Session
+
+Temporary storage that persists during page sessions:
+
+```javascript
+// Setting session data
+session.set('userSession', {
+  id: 'user123',
+  lastActive: Date.now()
+});
+
+// Getting session data
+const userData = session.get('userSession');
+
+// Checking session size
+const activeItems = session.size();
+
+// Removing session data
+session.remove('userSession');
+
+// Clearing all session data
+session.removeAll();
+
+  // Remove all stored data if necessary
+  // store.removeAll();
+
+  return (
+    <div>
+      <h1 id="name">...</h1>
+    </div>
+  );
+}
+
+export default App;
+```
+
+---
+
+## SESSION
+
+Session storage provides a way to store data for the duration of a page session. The data persists as long as the browser is open and survives over page reloads, but is lost when the browser tab or window is closed.
+
+```js
+// Set a session value:
+session.set("userId", "12345")
+
+// Get a session value:
+session.get("userId") // Output: "12345"
+
+// Remove a specific session value:
+session.remove("userId")
+
+// Get the number of items in session:
+session.size() // Output: number of stored items
+
+// Remove all session values:
+session.removeAll()
+```
+
+### Example use Session in React
+
+```js
+import { useEffect } from 'react';
+import 'memorio';
+
+function UserSession() {
+  useEffect(() => {
+    // Store user session data
+    session.set('userSession', {
+      id: '12345',
+      lastActive: Date.now(),
+      preferences: {
+        theme: 'dark',
+        language: 'en'
+      }
+    });
+
+    // Retrieve session data
+    const userData = session.get('userSession');
+    console.log('User session:', userData);
+
+    // Clean up on component unmount
+    return () => {
+      session.remove('userSession');
+    };
+  }, []);
+
+  return (
+    <div>
+      {/* Your component JSX */}
+    </div>
+  );
+}
+
+export default UserSession;
+```
+
+---
+
+## 🧪 Testing
+
+✅ All test suites are passing:
+
+- Basic functionality tests
+- State management tests
+- Store operations tests
+- Cache operations tests
+- Observer pattern tests
+
+Total: 25 tests passed across 5 test suites
+
+## 🔒 Security
+
+Security scans and reports are available at:
+- [Socket.dev](https://socket.dev/npm/package/memorio)
+- [Snyk.io](https://security.snyk.io/package/npm/memorio)
+
+## 📄 License
+
+MIT © [Dario Passariello](https://dario.passariello.ca/)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📧 Support
+
+Need help? Feel free to [open an issue](https://github.com/a51-dev/a51.memorio/issues).
+
+---
+
+Created with ❤️ by [Dario Passariello](https://dario.passariello.ca/) - Copyright © 2025

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";(()=>{var c={name:"memorio",version:"1.0.0",type:"module",main:"index.js",scripts:{build:"node ./esbuild.config.mjs",watch:"esbuild init.ts --bundle --outdir=dist --serve","-----------":"",test:"set NODE_OPTIONS=--experimental-vm-modules && jest","test:watch":"set NODE_OPTIONS=--experimental-vm-modules && jest --watch","test:coverage":"set NODE_OPTIONS=--experimental-vm-modules && jest --coverage","test:watchAll":"set NODE_OPTIONS=--experimental-vm-modules && jest --watchAll",tsc:"tsc -b .",eslint:"eslint .",updates:"npx npm-check-updates -u && npm i","----------":"","publish:npm":"npm run build && npm publish ./dist"},types:"index.d.ts",typings:"./types/*",description:"Memorio, State + Observer and Store for a easy life ",license:"MIT",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"}],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/*"],dependencies:{"dphelper.types":"0.0.19"},devDependencies:{"@eslint/js":"9.34.0","@types/jest":"30.0.0","@types/node":"^24.3.0","@typescript-eslint/eslint-plugin":"8.41.0","@typescript-eslint/parser":"8.41.0","dphelper.types":"0.0.19",esbuild:"^0.25.9","esbuild-plugin-clean":"^1.0.1","esbuild-plugin-copy":"^2.1.1",eslint:"9.34.0",jest:"30.0.5","jest-environment-jsdom":"30.0.5","ts-jest":"29.4.1","ts-loader":"^9.5.4","ts-node":"10.9.2",tslib:"^2.8.1",typescript:"5.9.2"}};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:c.version});Object.defineProperty(memorio,"dispatch",{writable:!1,configurable:!1,enumerable:!1,value:{set:(e,t={})=>{dispatchEvent(new CustomEvent(String(e),t))},listen:(e,t=null,i=!1)=>{observer.list?.[e]?.length>0&&observer.remove(e);let l=r=>t?setTimeout(()=>t(r),1):null;globalThis.addEventListener(e,l),globalThis.events[e]=l},remove:e=>{globalThis.removeEventListener(e,globalThis.events[e]),delete globalThis.events[e]}}});Object.defineProperty(memorio,"objPath",{writable:!1,configurable:!1,enumerable:!1,value:(e,t,i=".")=>t.concat(e).join(i)});var u=(e,t,i=[])=>{let l=r=>{let o=r.split(".");o.forEach((s,n)=>{let a=o.slice(0,n+1).join(".");globalThis.memorio.dispatch.set(a,{detail:{name:a}})})};return new Proxy(e,{get(r,o){if(o==="list"){let s={};for(let n in r)typeof r[n]!="function"&&!["list","remove","removeAll"].includes(n)&&(s[n]=r[n]);return s}if(o==="remove")return function(s){return s in r&&!["list","remove","removeAll"].includes(s)?(delete r[s],!0):!1};if(o==="removeAll")return function(){for(let s in r)typeof r[s]!="function"&&!["list","remove","removeAll"].includes(s)&&delete r[s];return!0};if(Object.isFrozen(r[o]))return r[o];try{let s=Reflect.get(r,o);return s&&typeof s=="object"&&["Array","Object"].includes(s.constructor.name)?u(s,t,i.concat(o)):s}catch(s){console.error("Error: ",s);return}},set(r,o,s){if(r[o]&&typeof r[o]=="object"&&Object.isFrozen(r[o])){console.error(`Error: state '${o}' is locked`);return}try{let n=globalThis.memorio.objPath(o,i);return t({action:"set",path:n,target:r,newValue:s,previousValue:Reflect.get(r,o)}),l("state."+n),Reflect.set(r,o,s),r[o]&&typeof r[o]=="object"&&Reflect.defineProperty(r[o],"lock",{value(){Object.defineProperty(r,o,{writable:!1,enumerable:!1}),Object.freeze(r[o])}}),!0}catch(n){return console.error("Error in set trap:",n),!1}},deleteProperty(r,o){try{let s=globalThis.memorio.objPath(o,i);return t({action:"delete",path:s,target:r}),Reflect.deleteProperty(r,o)}catch(s){return console.error("Error in deleteProperty trap:",s),!1}}})},g={};globalThis?.state?globalThis.state=state:globalThis.state=u(g,()=>{});var f=new WeakSet;f.add(state);setInterval(()=>{if(!f.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});globalThis.observer||(globalThis.observer=null);Object.defineProperty(globalThis,"observer",{enumerable:!1});observer=(e,t=null,i=!0)=>{if((r=>r.split(".")[0]!=="state"?(console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${r}' string is incorrect!`),!1):!0)(e)){if(!e&&!t){console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");return}if(!e&&t){console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'.");return}if(e&&!t){globalThis.memorio.dispatch.listen(String(e),{detail:{name:String(e)}}),console.debug("called: ",e);return}if(e&&t){if(typeof e!="string"||typeof t!="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,t,i);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);Object.defineProperty(globalThis,"store",{value:new Proxy({},{}),enumerable:!1,configurable:!1});Object.defineProperties(store,{get:{value(e){if(e)try{let t=localStorage.getItem(e);return t&&JSON.parse(t)}catch(t){console.error(`Error parsing store item '${e}':`,t)}}},set:{value(e,t){if(e)try{t==null?localStorage.setItem(e,JSON.stringify(null)):typeof t=="object"||typeof t=="number"||typeof t=="boolean"||typeof t=="string"?localStorage.setItem(e,JSON.stringify(t)):typeof t=="function"&&console.error("It's not secure to store functions.")}catch(i){console.error(`Error setting store item '${e}':`,i)}}},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:t})=>{e&&t&&console.debug(`Using ${e/1024} out of ${t/1024} Mb.`)}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let t in localStorage)if(localStorage.hasOwnProperty(t)){let i=localStorage.getItem(t);i&&(e+=i.length)}return e}}});Object.freeze(store);Object.defineProperty(globalThis,"session",{value:new Proxy({},{}),enumerable:!1,configurable:!1});Object.defineProperties(session,{get:{value(e){if(e)try{let t=sessionStorage.getItem(e);return t&&JSON.parse(t)}catch(t){console.error(`Error parsing session item '${e}':`,t)}}},set:{value(e,t){if(e)try{t==null?sessionStorage.setItem(e,JSON.stringify(null)):typeof t=="object"||typeof t=="number"||typeof t=="boolean"||typeof t=="string"?sessionStorage.setItem(e,JSON.stringify(t)):typeof t=="function"&&console.error("It's not secure to session functions.")}catch(i){console.error(`Error setting session item '${e}':`,i)}}},remove:{value(e){if(e&&sessionStorage.getItem(e))return sessionStorage.removeItem(e),!0}},delete:{value(e){session.remove(e)}},removeAll:{value(){return sessionStorage.clear(),!0}},clearAll:{value(){return session.removeAll(),!0}},quota:{value(){"storage"in navigator&&"estimate"in navigator.storage&&navigator.storage.estimate().then(({usage:e,quota:t})=>{e&&t&&console.debug(`Using ${e/1024} out of ${t/1024} Mb.`)}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let t in sessionStorage)if(sessionStorage.hasOwnProperty(t)){let i=sessionStorage.getItem(t);i&&(e+=i.length)}return e}}});Object.freeze(session);Object.defineProperty(window,"cache",{value:new Proxy({},{}),enumerable:!1,configurable:!1});})();

package/dist/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "memorio",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "build": "node ./esbuild.config.mjs",
+    "watch": "esbuild init.ts --bundle --outdir=dist --serve",
+    "-----------": "",
+    "test": "set NODE_OPTIONS=--experimental-vm-modules && jest",
+    "test:watch": "set NODE_OPTIONS=--experimental-vm-modules && jest --watch",
+    "test:coverage": "set NODE_OPTIONS=--experimental-vm-modules && jest --coverage",
+    "test:watchAll": "set NODE_OPTIONS=--experimental-vm-modules && jest --watchAll",
+    "tsc": "tsc -b .",
+    "eslint": "eslint .",
+    "updates": "npx npm-check-updates -u && npm i",
+    "----------": "",
+    "publish:npm": "npm run build && npm publish ./dist"
+  },
+  "types": "index.d.ts",
+  "typings": "./types/*",
+  "description": "Memorio, State + Observer and Store/Session for a easy life ",
+  "license": "MIT",
+  "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"
+    }
+  ],
+  "keywords": [
+    "memorio",
+    "state",
+    "store",
+    "session",
+    "observer",
+    "dario",
+    "passariello",
+    "context",
+    "react",
+    "biglogic",
+    "a51"
+  ],
+  "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/*"
+  ],
+  "dependencies": {
+    "dphelper.types": "0.0.19"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.34.0",
+    "@types/jest": "30.0.0",
+    "@types/node": "^24.3.0",
+    "@typescript-eslint/eslint-plugin": "8.41.0",
+    "@typescript-eslint/parser": "8.41.0",
+    "dphelper.types": "0.0.19",
+    "esbuild": "^0.25.9",
+    "esbuild-plugin-clean": "^1.0.1",
+    "esbuild-plugin-copy": "^2.1.1",
+    "eslint": "9.34.0",
+    "jest": "30.0.5",
+    "jest-environment-jsdom": "30.0.5",
+    "ts-jest": "29.4.1",
+    "ts-loader": "^9.5.4",
+    "ts-node": "10.9.2",
+    "tslib": "^2.8.1",
+    "typescript": "5.9.2"
+  }
+}

package/dist/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/dist/types/memorio.d.ts

@@ -0,0 +1,18 @@
+
+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/dist/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/dist/types/session.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: session.set("example",{test:"test"})
+*/
+interface _session {
+
+  /**
+    * Create a new session
+    *
+    * @example
+    * session.set("test","example") // or Array, Object, Number, Functions...
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the session.
+    * @param param The information taht you want to session (Any).
+    * @return boolean
+  */
+  set: (name: string, value: any) => void
+
+  /**
+    * Have back the data from a session.
+    *
+    * @example
+    * session.get("test")
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the session.
+  */
+  get: (name: string) => any
+
+  /**
+    * Delete an existing session:
+    *
+    * @example
+    * session.delete("test")
+    * session.remove("test")
+    *
+    * @since memorio 0.0.1
+    * @param name The String as name to define the session.
+    * @return boolean
+  */
+  delete: (name: string) => boolean | undefined
+  remove: (name: string) => boolean | undefined
+
+  /**
+    * Delete all storages
+    *
+    * @example
+    * session.clearAll()
+    * session.removeAll()
+    *
+    * @since memorio 0.0.1
+    * @return boolean
+  */
+  clearAll: () => boolean
+  removeAll: () => boolean
+
+  /**
+    * Know how much space you have for total storages
+    *
+    * @example
+    * session.quota()
+    *
+    * @since memorio 0.0.1
+    * @return values
+  */
+  quota: () => void
+
+  /**
+    * Get the size of sessions an the total
+    *
+    * @example
+    * session.size()
+    *
+    * @since memorio 0.0.1
+    * @return dimension in kb
+  */
+  size: () => number
+
+  // TODO
+  // readonly increaseQuota: (value: number) => void
+}
+
+declare var session: _session
+type session = _session

package/dist/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