memorio 0.2.19 → 1.0.0

package/tests/basic.test.ts

@@ -0,0 +1,50 @@
+import { describe, test, expect } from '@jest/globals'
+import '../init'
+
+// Basic state management tests
+describe('Basic State Tests', () => {
+  test('State should exist globally', () => {
+    expect(globalThis.state).toBeDefined()
+  })
+
+  test('Should set and get a simple value', () => {
+    state.testValue = 'hello'
+    expect(state.testValue).toBe('hello')
+  })
+
+  test('Should handle number values', () => {
+    state.number = 42
+    expect(state.number).toBe(42)
+  })
+})
+
+// Object state tests
+describe('Object State Tests', () => {
+  test('Should handle object values', () => {
+    state.obj = { key: 'value' }
+    expect(state.obj.key).toBe('value')
+  })
+
+  test('Should handle nested objects', () => {
+    state.nested = {
+      level1: {
+        level2: 'deep'
+      }
+    }
+    expect(state.nested.level1.level2).toBe('deep')
+  })
+})
+
+// Array state tests
+describe('Array State Tests', () => {
+  test('Should handle array values', () => {
+    state.array = [1, 2, 3]
+    expect(state.array).toEqual([1, 2, 3])
+  })
+
+  test('Should allow array mutations', () => {
+    state.array = [1, 2]
+    state.array.push(3)
+    expect(state.array).toEqual([1, 2, 3])
+  })
+})

package/tests/cache.test.ts

@@ -0,0 +1,52 @@
+import { describe, test, expect, beforeEach } from '@jest/globals'
+import '../config/global.js'
+import '../init'
+
+describe('Cache Tests', () => {
+  beforeEach(() => {
+    // Clear cache if possible
+    try {
+      cache.clear()
+    } catch (e) {
+      // Ignore if clear is not available
+    }
+  })
+
+  test('should set and get cache values', () => {
+    cache.test = 'value'
+    expect(cache.test).toBe('value')
+  })
+
+  test('should handle object values', () => {
+    const testObj = { key: 'value' }
+    cache.testObj = testObj
+    expect(cache.testObj).toEqual(testObj)
+  })
+
+  test('should handle array values', () => {
+    const testArray = [1, 2, 3]
+    cache.testArray = testArray
+    expect(cache.testArray).toEqual(testArray)
+  })
+
+  test('should handle nested objects', () => {
+    const nested = {
+      level1: {
+        level2: {
+          data: 'test'
+        }
+      }
+    }
+    cache.nested = nested
+    expect(cache.nested.level1.level2.data).toBe('test')
+  })
+
+  test('should handle persistence', () => {
+    cache.persistent = 'persist'
+    expect(cache.persistent).toBe('persist')
+
+    // Test removal
+    delete cache.persistent
+    expect(cache.persistent).toBeUndefined()
+  })
+})

package/tests/observer.test.ts

@@ -0,0 +1,62 @@
+import { describe, test, expect, jest, beforeEach } from '@jest/globals'
+import '../config/global.js'
+
+// Initialize memorio object first
+if (!globalThis.memorio) {
+  Object.defineProperty(globalThis, 'memorio', {
+    value: {},
+    writable: false,
+    configurable: false,
+    enumerable: false
+  })
+}
+
+// Then import other modules
+import { buildProxy } from '../functions/state/index.js'
+import '../init'
+
+describe('Observer Tests', () => {
+  beforeEach(() => {
+    // Reset state for each test
+    globalThis.state = buildProxy({}, () => { })
+  })
+
+  test('should observe state changes', async () => {
+    const mockCallback = jest.fn()
+    observer('state.test', mockCallback)
+
+    state.test = 'value'
+
+    // Observer events are async, so we need to wait
+    await new Promise(resolve => setTimeout(resolve, 100))
+    expect(mockCallback).toHaveBeenCalled()
+  })
+
+  test('should handle multiple observers', async () => {
+    const mockCallback1 = jest.fn()
+    const mockCallback2 = jest.fn()
+
+    observer('state.test', mockCallback1)
+    observer('state.test', mockCallback2)
+
+    state.test = 'value'
+
+    await new Promise(resolve => setTimeout(resolve, 100))
+    expect(mockCallback1).toHaveBeenCalled()
+    expect(mockCallback2).toHaveBeenCalled()
+  })
+
+  test('should observe nested state changes', async () => {
+    const mockCallback = jest.fn()
+
+    // Initialize nested state structure first
+    state.nested = {}
+    observer('state.nested.deep', mockCallback)
+
+    // Then set the deep value
+    state.nested.deep = 'value'
+
+    await new Promise(resolve => setTimeout(resolve, 100))
+    expect(mockCallback).toHaveBeenCalled()
+  })
+})

package/tests/setup.ts

@@ -0,0 +1,48 @@
+
+import { jest } from '@jest/globals'
+
+// Mock localStorage and sessionStorage
+const localStorageMock = {
+  getItem: jest.fn(),
+  setItem: jest.fn(),
+  removeItem: jest.fn(),
+  clear: jest.fn(),
+  length: 0,
+  key: jest.fn()
+}
+
+const sessionStorageMock = {
+  getItem: jest.fn(),
+  setItem: jest.fn(),
+  removeItem: jest.fn(),
+  clear: jest.fn(),
+  length: 0,
+  key: jest.fn()
+}
+
+Object.defineProperty(globalThis, 'localStorage', { value: localStorageMock })
+Object.defineProperty(globalThis, 'sessionStorage', { value: sessionStorageMock })
+
+// Mock navigator.storage
+Object.defineProperty(globalThis, 'navigator', {
+  value: {
+    storage: {
+      estimate: () => Promise.resolve({ usage: 0, quota: 1000000 })
+    }
+  }
+})
+
+// Initialize global objects
+globalThis.state = {}
+globalThis.store = {
+  get: jest.fn(key => null),
+  set: jest.fn((key, value) => true),
+  remove: jest.fn(() => true),
+  removeAll: jest.fn(() => true),
+  delete: jest.fn(() => true),
+  clearAll: jest.fn(() => true),
+  quota: jest.fn(() => ({ usage: 0, quota: 1000000 })),
+  size: jest.fn(() => 0)
+}
+globalThis.cache = {}
+globalThis.observer = jest.fn()

package/tests/state.test.ts

@@ -0,0 +1,45 @@
+import { describe, test, expect, beforeEach } from '@jest/globals'
+import '../config/global.js'
+import { buildProxy } from '../functions/state/index.js'
+import '../init'
+
+describe('State Management', () => {
+  beforeEach(() => {
+    // Reset state by creating a new proxy
+    globalThis.state = buildProxy({}, () => { })
+  })
+
+  test('should set and get state value', () => {
+    state.test = 'value'
+    expect(state.test).toBe('value')
+  })
+
+  test('should list all states', () => {
+    state.test1 = 'value1'
+    state.test2 = 'value2'
+    const list = state.list
+    expect(list).toHaveProperty('test1')
+    expect(list).toHaveProperty('test2')
+  })
+
+  test('should remove state', () => {
+    state.test = 'value'
+    state.remove('test')
+    expect(state.test).toBeUndefined()
+  })
+
+  test('should remove all states', () => {
+    state.test1 = 'value1'
+    state.test2 = 'value2'
+    state.removeAll()
+    expect(state.list).toEqual({})
+  })
+
+  test('should lock object state', () => {
+    state.test = { prop: 'value' }
+    state.test.lock()
+    expect(() => {
+      state.test.newProp = 'value'
+    }).toThrow()
+  })
+})

package/tests/store.test.ts

@@ -0,0 +1,62 @@
+import { describe, test, expect, jest, beforeEach } from '@jest/globals'
+import '../config/global.js'
+import '../init'
+
+describe('Store Tests', () => {
+  let mockStore = {}
+
+  beforeEach(() => {
+    mockStore = {}
+    localStorage.clear()
+    jest.spyOn(localStorage, 'getItem').mockImplementation(key => mockStore[key] || null)
+    jest.spyOn(localStorage, 'setItem').mockImplementation((key, value) => {
+      mockStore[key] = value
+    })
+    jest.spyOn(localStorage, 'removeItem').mockImplementation(key => {
+      delete mockStore[key]
+    })
+    jest.spyOn(localStorage, 'clear').mockImplementation(() => {
+      mockStore = {}
+    })
+  })
+
+  test('should set and get store values', () => {
+    const testValue = 'test value'
+    store.set('test', testValue)
+    expect(localStorage.setItem).toHaveBeenCalledWith('test', JSON.stringify(testValue))
+    expect(store.get('test')).toBe(testValue)
+  })
+
+  test('should handle object values', () => {
+    const testObj = { key: 'value' }
+    store.set('test', testObj)
+    expect(localStorage.setItem).toHaveBeenCalledWith('test', JSON.stringify(testObj))
+    expect(store.get('test')).toEqual(testObj)
+  })
+
+  test('should remove store item', () => {
+    store.set('test', 'value')
+    store.remove('test')
+    expect(localStorage.removeItem).toHaveBeenCalledWith('test')
+    expect(store.get('test')).toBeNull()
+  })
+
+  test('should remove all store items', () => {
+    store.set('test1', 'value1')
+    store.set('test2', 'value2')
+    store.removeAll()
+    expect(localStorage.clear).toHaveBeenCalled()
+    expect(store.get('test1')).toBeNull()
+    expect(store.get('test2')).toBeNull()
+  })
+
+  test('should get store size', () => {
+    mockStore = {}
+    store.removeAll()
+    store.set('test1', 'value1')
+    store.set('test2', 'value2')
+    const size = Object.keys(mockStore).length
+    expect(typeof size).toBe('number')
+    expect(size).toBe(2)
+  })
+})

package/tsconfig.json

@@ -0,0 +1,67 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "es2022",
+      "dom"
+    ],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "types": [
+      "node"
+    ],
+    "strict": true,
+    "noEmit": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "importHelpers": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noImplicitAny": false,
+    "preserveConstEnums": true,
+    "removeComments": true,
+    "sourceMap": false,
+    "allowJs": true,
+    "esModuleInterop": true,
+    "strictNullChecks": false,
+    "strictPropertyInitialization": false,
+    "jsx": "react",
+    "moduleDetection": "force",
+    "baseUrl": ".",
+    "outDir": "./dist/",
+    "target": "es2022",
+    "rootDirs": [
+      "./"
+    ],
+    "paths": {
+      "/*": [
+        "./*"
+      ]
+    }
+  },
+  "include": [
+    "index.d.ts",
+    "./types/memorio.d.ts",
+    "./**/*.ts",
+    "./**/*.tsx"
+  ],
+  "types": [
+    "node"
+  ],
+  "typeRoots": [
+    "./types/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "private",
+    "archive",
+    "*backup",
+    "dist",
+    ".old*",
+    ".OLD*",
+    "#OLD*",
+    "@OLD*",
+  ]
+}

package/index.js

@@ -1 +0,0 @@
-"use strict";(()=>{var c={name:"memorio",version:"0.2.19",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",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/*"],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.40.0","@typescript-eslint/parser":"8.40.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.2","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});})();