A thin wrapper around react-native-mmkv with optional per-key expiration (TTL).

• 🚀 Fast and efficient key-value storage powered by MMKV
• ⏰ Optional TTL (Time To Live) for automatic key expiration
• 📦 Automatic JSON serialization for objects and arrays
• 🔒 Type-safe with TypeScript support
• 🪶 Lightweight and easy to use

npm install @janiscommerce/app-storage

This package requires react-native-mmkv as a peer dependency:

npm install react-native-mmkv

import Storage from '@janis-commerce/app-storage';

// Create a storage instance
const storage = new Storage({ id: 'my-app-storage' });

// Store values
storage.set('token', 'abc123');
storage.set('user', { name: 'Jane', age: 30 });

// Retrieve values
const token = storage.get<string>('token'); // 'abc123'
const user = storage.get<{ name: string; age: number }>('user'); // { name: 'Jane', age: 30 }

// Remove a key
storage.remove('token');

// Clear all keys
storage.clear();

import Storage from '@janis-commerce/app-storage';

const storage = new Storage();

// Store a value that expires in 5 minutes
storage.set('session-token', 'xyz789', { expiresAt: 5 });

// After 5 minutes, this will return null
const token = storage.get('session-token');

You can create multiple isolated storage instances for different purposes:

import Storage from '@janis-commerce/app-storage';

const userStorage = new Storage({ id: 'user-data' });
const cacheStorage = new Storage({ id: 'cache' });
const sessionStorage = new Storage({ id: 'session' });

userStorage.set('profile', { name: 'John' });
cacheStorage.set('last-fetch', Date.now(), { expiresAt: 10 }); // expires in 10 minutes
sessionStorage.set('temp-data', { foo: 'bar' });

A thin wrapper around MMKV with optional per-key expiration (TTL).

• Serializes objects/arrays to JSON on set.
• get() attempts JSON parse; otherwise returns string/number/boolean.
• Optional per-key expiration via expiresAt (minutes from now).
• Expired keys are automatically removed on get().
• remove() deletes the value and its expiration metadata.

Kind: global class
Access: public

• Storage
  • new Storage(options)
  • .set(key, value, options)
  • .get(key) ⇒
  • .remove(key)
  • .clear()

Creates a new Storage instance.

Stores a value by key with optional expiration.

Semantics:

• key null/undefined: no-op
• value null/undefined: no-op (null will not be stored; it is ignored)
• string/number/boolean are stored as string
• objects/arrays are serialized to JSON

Expiration:

• options.expiresAt: minutes from now until expiration.
• Stored under ${key}:__meta as an absolute timestamp in milliseconds.

Kind: instance method of Storage

Retrieves a value by key. If expired or metadata is invalid, the key is removed and null is returned.

Kind: instance method of Storage
Returns: Parsed JSON as T, or string/number/boolean; null if missing/expired/invalid.
Typeparam: T - Expected value type after JSON parse.

Removes a key and its expiration metadata.

Kind: instance method of Storage

Clears all keys from the current MMKV instance.

Kind: instance method of Storage

Janis Commerce