Memorio

A lightweight, type-safe state management library for JavaScript applications

TypeScript

Node.js

Jest

ESLint

esbuild

Tests

Coverage

License

Table of Contents

• Features

• Installation

• Quick Start

• API Reference

  • State Management

  • Observer Pattern

  • Store

  • Session

• Testing

• Security

• 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

• Easy debugging with proxy-based state

Installation

npm i -D 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

/*
 IMPORTANT!
 Add import only at first start of your SPA. Became global!.
 You don't need to import any time you need to use memorio
*/

import 'memorio';

// State Management
state.counter = 0;
state.active = false;
state.name = "john";
state.user = { name: 'John', age: 30 };
state.hours = [2,3,10,23]

// Observer Pattern
// Example: if you change the state.counter you get a console.log
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:

// 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:

// Basic observer
observer(
  'state.user',
    (newValue, oldValue) => {
    console.log('User updated:', newValue);
  }
);

1. You can use in a function outside React

2. In a javascript function

3. in a setTimeout

// With React useState
const [user, setUser] = useState();
observer(
  'state.user',
  () => {
    setUser(state.user);
  }
);

// With React useEffect to avoid multiple observer after update
useEffect(
  () => {
    observer(
      'state.user',
      () => {
        setUser(state.user);
      }
    );
  }, []
);

Store

Persistent storage for your application:

// 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:

// 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();

---

Testing

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

• Snyk.io

License

MIT (c) Dario Passariello

Created with by Dario Passariello - Copyright (c) 2025