nope-redis

Simple & Fast Node.js in-memory caching — Redis-like functionality without a Redis server.

• 🚀 Fast: 1M+ SET, 2M+ GET ops/sec with a flat heap under sustained load
• ⏰ TTL: automatic key expiration with eager cleanup on read
• 🔄 Eviction: LRU, LFU and TTL policies with a configurable memory limit (MB)
• 🎯 Batch operations, 📈 statistics, 🛡️ self-recovery, 📘 TypeScript types
• 🔌 Works with both ESM (import) and CommonJS (require) — one shared cache instance
• 🔧 Zero runtime dependencies — single file, Node.js ≥ 18

Install

npm install nope-redis

Quick Start

Works with both CommonJS and ESM — both entry points share the same cache instance.

// CommonJS
const nopeRedis = require('nope-redis');

nopeRedis.setItem('user:1', { name: 'John', age: 30 }, 10); // TTL: 10s
const user = nopeRedis.getItem('user:1'); // { name: 'John', age: 30 } — null if missing/expired
nopeRedis.deleteItem('user:1');

// Optional runtime configuration
nopeRedis.config({ defaultTtl: 60, maxMemorySize: 100, evictionPolicy: 'lru' });

// ESM — default and named imports are both supported
import nopeRedis, { setItem, getItem } from 'nope-redis';

setItem('user:1', { name: 'John', age: 30 }, 10);
const user = getItem('user:1');
nopeRedis.deleteItem('user:1'); // same singleton as the named imports

TypeScript definitions are included (setItem<T>, getItem<T>, …).

API at a Glance

| Function | Description | Returns | |----------|-------------|---------| | setItem(key, value, ttl?) | Store any JS value (default TTL: 30s) | boolean | | getItem(key) | Read a value | T \| null \| false | | deleteItem(key) | Remove a key | boolean | | itemStats(key) | Per-key expires_at, remaining_seconds, hit | ItemStats \| null \| false | | setItems(items) | Bulk set [{ key, value, ttl? }] | boolean[] \| false | | getItems(keys) | Bulk read | Record<string, T \| null> \| false | | deleteItems(keys) | Bulk remove | boolean | | stats(options?) | Cache-wide statistics (showSize for memory usage) | Stats \| false | | config(options) | defaultTtl, maxMemorySize (MB), evictionPolicy, maxChecksPerCycle, isMemoryStatsEnabled | boolean | | flushAll() | Clear all data, keep service running | boolean | | SERVICE_KILL() / SERVICE_START() | Stop / restart the background service | Promise<boolean> |

All functions return false when the service is stopped. Full reference with examples: docs/README.md.

Performance

Node v24.18.0 · AMD EPYC 7763 64-Core Processor · linux x64 · 2026-07-15 — refreshed automatically by the Update README benchmarks workflow.

| Operation | ops/sec | ns/op | |-----------|--------:|------:| | SET (fresh string keys) | 2,281,928 | 438 | | SET (nested JSON, ~30 nodes) | 643,008 | 1,555 | | SET (overwrite existing keys) | 4,311,185 | 232 | | GET hit (100k keyspace) | 3,036,232 | 329 | | GET miss | 44,887,845 | 22 | | DELETE | 4,325,878 | 231 | | Mixed (70% get / 20% set / 10% delete) | 2,789,967 | 358 | | BATCH setItems (100 items/call) | 4,212,197 | 237 | | BATCH getItems (100 keys/call) | 1,354,869 | 738 |

No memory leaks: expired entries are freed eagerly and byte accounting returns to exactly zero when the cache empties — see the detailed performance notes for methodology and more details. Reproduce locally with npm run bench.

Documentation

Detailed docs live in docs/README.md:

• API Reference
• Configuration
• Memory Management & Eviction Policies
• Performance & Benchmarks
• Limitations
• Testing & Contributing

Good to know: single-process only (not distributed), no persistence, values are stored by reference, keys must be strings, TTL is whole seconds.

License

MIT — Orhan Aydogdu (orhanayd) · npm · issues