tiny-shelf/README.md

tiny-shelf is a lightweight and easy-to-use browser storage manager. It provides a unified API for localStorage and sessionStorage, supports automatic expiration (expires)

# tiny-shelf

`tiny-shelf` is a **lightweight** and **easy-to-use** browser storage manager. It provides a unified API for `localStorage` and `sessionStorage`, supports automatic **expiration** (expires)

## Using
  ```
  import { TinyShelf } from '/node_modules/tiny-shelf/index.js';
  const storage = new TinyShelf("local");
  storage.set("user", { name: "Alice" }, { expires: 30000 });
  console.log(storage.get("user"));

  storage.onChange((key, value) => {
    console.log(`Key "${key}" changed! New value.name:`, value.name);
  });
  storage.set("user", { name: "Ann" });  // Key "user" changed! New value.name: "Ann"
  storage.remove("user"); // Key "user" changed! New value: null
  ```
  
| Feature of `tiny-shelf` |  |	
| ---------------------- |--|
| Unified API for `localStorage` and `sessionStorage` |	✅	|
| expires (auto-removal after a set time) |	✅	|
| Small size (zero dependencies) | 	✅	|
| `onChange` for reacting to storage changes |	✅	|
| Built-in encryption |	🔜	|
| IndexedDB support |	🔜	|