Keyv is a simple key-value storage library for JavaScript and TypeScript that provides a consistent interface across multiple backends using storage adapters. It supports TTL-based expiry, which makes it useful for building caches or persistent key-value stores.
Project status
- Actively maintained: GitHub upstream push was on 2026-06-19, and there have been multiple recent v6.0.0-beta updates through 2026-06-18 and 2026-06-11, indicating ongoing active development rather than a dormant state.
- Apparent cadence: During June 2026 the project shows a relatively fast beta iteration pace (about 1 week between beta.4 and beta.3), with earlier activity in March to April 2026 also arriving in frequent bursts, consistent with an active modernization cycle.
AI summary generated
Recent updates
v6.0.0-beta.4
Keyv v6.0.0-beta.4 finalizes the v6 storage-adapter API by switching from relative ttl to absolute expires timestamps, and updates adapter internals and tests accordingly. In parallel, @keyv/bigmap gains Hookified-backed mutation events via a new BigMapEvents enum, plus related type/API cleanups. Multiple storage adapters also get targeted bug fixes (notably etcd, dynamo, and mysql).
BreakingFeaturesv6.0.0-beta.3
Keyv v6.0.0-beta.3 is a major modernization that rolls up the v6 beta cycle, including a new raw-data API, capability detection helpers, a stats/telemetry overhaul, new encryption adapters, and hookification across core and adapters. The release also includes a broad set of breaking dependency upgrades across the monorepo and adapts the test suite to the v6 API.
BreakingFeaturesv6.0.0-beta.1
v6.0.0-beta.1 includes a major Keyv overhaul focused on adapters (memory and bridge), stats and telemetry changes, and broader hook support. It also includes BigMap hashing performance improvements and new/expanded integrations such as Dynamo enhancements and encryption adapters.
BreakingFeaturesv6.0.0-alpha.4
v6.0.0-alpha.4 is a refactor-heavy release that integrates Hookified into Keyv, standardizes compression adapters, and simplifies several Keyv APIs (including iterator and storage adapter shapes). The diff shows multiple concrete signature and return-type changes in storage and compression adapters, some of which are not explicitly called out in the release notes.
BreakingFeaturesv6.0.0-alpha.3
v6.0.0-alpha.3 is an alpha release focused on driver and refactors across multiple storage adapters (notably sqlite, dynamo, etcd, and memcache) plus internal work in the core keyv library. The release also introduces optional serialization in core and adds raw set capability flags, while reorganizing BigMap into the core package.
BreakingFeaturesv6.0.0-alpha.2
v6.0.0-alpha.2 updates the Keyv mono-repo primarily by migrating adapters to hookified v2, and enhancing the Valkey backend with new batch APIs and a redesigned configuration surface. The release notes call out key Valkey changes like moving options to properties and renaming redis access to client, but the diff shows additional Valkey configuration and storage-key behavior changes that are not mentioned.
BreakingFeatures6.0.0-alpha.1
Release 6.0.0-alpha.1 is a large monorepo refactor and feature wave across Keyv core, multiple storage adapters, and compression adapters. The release notes emphasize moving storage adapters to a new “hookified” structure, removing some adapter and Keyv class properties, adding SQLite WAL support, and upgrading test tooling (Vitest).
BreakingFeatures2026-01-20
This release adds Bun-focused validation and documentation, expands KeyvGenericStore with iterator support and new integration tests, and updates CI to run on Node.js 24 and Bun. It also includes a batch of backend adapter fixes and dependency upgrades across redis, mysql, postgres, sqlite, and other adapters.
SecurityFeatures2025-12-26
This release mainly updates development and test tooling (Biome, Vitest) and bumps dependency versions across multiple Keyv storage adapters. It also includes a Keyv bug fix to prevent duplicate namespace prefixing and adds iterator coverage around delete statistics.
2025-12-10
This release primarily updates development tooling and dependencies across the monorepo (Biome, Vitest, tsup) and bumps a few runtime dependencies for specific adapters (Redis, Dynamo). It also includes documentation updates for Redis namespaces and a small TypeScript type loosening related to Keyv namespace adapter compatibility.
Features2025-11-20
This release updates the PostgreSQL adapter to add batch setMany support, and hardens the MySQL adapter's has method against SQL injection. It also adds MySQL JSDoc coverage and introduces tests to validate the MySQL security behavior.
SecurityFeatures2025-11-17
This release updates multiple Keyv packages to correct ESM vs CJS export entrypoints and typings, and includes functional changes to the bigmap hashing implementation. It also improves PostgreSQL getMany performance and bumps several dev/tooling dependencies across adapters.
Features