nano-safe-storage

A safe wrapper around localStorage with TTL (Time To Live), quota management, and memory fallback.

Installation

pnpm add nano-safe-storage
# or
npm install nano-safe-storage

Usage

import { createStorage } from 'nano-safe-storage';

const storage = createStorage({
    namespace: 'myapp',
    ttl: 3600000 // 1 hour default TTL
});

// Set with optional override TTL
storage.set('user', { name: 'Alice' }, { ttl: 60000 });

// Get (returns null if expired or missing)
const user = storage.get('user');

// Check existence
if (storage.has('user')) { ... }

// Remove
storage.remove('user');

Features

• Namespace Isolation: Prefixes keys to avoid collisions.
• TTL Support: Auto-expiration of data.
• Memory Fallback: Works in private mode or non-browser environments (like SSR) without crashing.
• Safe JSON: Handles JSON parsing errors gracefully.

License

MIT