release: 2026-05-27 (8 packages) by jaredwray · Pull Request #1647 · jaredwray/cacheable

jaredwray · 2026-05-27T15:00:12Z

Release summary

Releasing 8 packages: @cacheable/memory@2.1.0 (minor), @cacheable/node-cache@3.1.0 (minor), cacheable@2.4.0 (minor), cache-manager@7.2.9 (patch), file-entry-cache@11.1.4 (patch), flat-cache@6.1.23 (patch), @cacheable/net@2.0.9 (patch), @cacheable/utils@2.4.2 (patch).

Packages

Package	Current	New	Bump	Rationale	Commits
`@cacheable/memory`	`2.0.9`	`2.1.0`	minor	2 feat (hooks, maxTtl), 1 build	3
`@cacheable/node-cache`	`3.0.1`	`3.1.0`	minor	1 feat (enhanced store + bug fixes), 1 test	3
`cacheable`	`2.3.5`	`2.4.0`	minor	1 feat (maxTtl), 1 build	2
`cache-manager`	`7.2.8`	`7.2.9`	patch	build: tsup→tsdown, pnpm 11	1
`file-entry-cache`	`11.1.3`	`11.1.4`	patch	build: tsup→tsdown, pnpm 11	1
`flat-cache`	`6.1.22`	`6.1.23`	patch	build: tsup→tsdown, pnpm 11	1
`@cacheable/net`	`2.0.8`	`2.0.9`	patch	build: tsup→tsdown, pnpm 11	1
`@cacheable/utils`	`2.4.1`	`2.4.2`	patch	build: tsup→tsdown, pnpm 11	1
`cacheable-request`	`13.0.19`	—	skipped	no changes since v13.0.19	0
`@cacheable/benchmark`	`1.0.0`	—	skipped	not published on npm	0
`@cacheable/website`	`1.0.0`	—	private	not published	0

@cacheable/memory@2.1.0 — 2026-05-27

Add lifecycle hooks and maxTtl cap to CacheableMemory.

Features

add hooks for all cache operations via CacheableMemoryHooks enum (1ff149d, feat(@cacheable/memory): add hooks like cacheable #1644)

import { CacheableMemory, CacheableMemoryHooks } from '@cacheable/memory';
const cache = new CacheableMemory();
cache.onHookSync(CacheableMemoryHooks.BEFORE_SET, (data) => {
  data.value = transform(data.value); // mutate before write
});
cache.set('key', 'value');

add maxTtl option to cap maximum time-to-live (948234a, feat(cacheable, memory): add maxTtl option to cap maximum time-to-live #1645)

const cache = new CacheableMemory({ ttl: '10m', maxTtl: '1h' });
cache.set('key', 'value', '2h'); // capped to 1h
cache.set('key2', 'value2');     // no TTL → capped to 1h

@cacheable/node-cache@3.1.0 — 2026-05-27

Add keys/has/getTtl/flushAll, events, useClones, checkperiod, and fix multiple stat-tracking bugs.

Features

add keys() and has() methods for cache inspection (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)

const store = new NodeCacheStore();
await store.set('a', 1);
await store.keys();    // ['a']
await store.has('a');  // true

add getTtl() to inspect key expiration timestamps (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
```
await store.set('key', 'val', 5000);
const ttl = await store.getTtl('key'); // ms timestamp when key expires
```
add flushAll() to clear data and reset all stats (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
```
await store.flushAll(); // clears data + resets stats, emits "flush"
```

add event emitters for set, del, expired, and flush operations (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)

store.on('set', (key, value, ttl) => { /* ... */ });
store.on('del', (key, value) => { /* ... */ });
store.on('expired', (key, value) => { /* ... */ });
store.on('flush', () => { /* ... */ });

add useClones option for deep-cloning via structuredClone (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
```
const store = new NodeCacheStore({ useClones: true });
```
add checkperiod option for interval-based expired item detection (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
```
const store = new NodeCacheStore({ checkperiod: 60 }); // check every 60s
store.close(); // stop interval
```
add deleteOnExpire option and close()/getIntervalId() lifecycle methods (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)

Bug Fixes

fix setTtl() treating falsy cached values (0, "", false, null) as non-existent (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix mdel() firing stats and events for non-existent keys (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix startInterval() leaking old timer when called twice (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix set() double-counting stats on key overwrites (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix checkData() swallowing unhandled promise rejections (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix handleExpired() stats underflow when Keyv auto-expires items (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)
fix checkData() mutating Map during iteration (bf3ea48, feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643)

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)
move store tests to use @faker-js/faker (d51b5f2, @cacheable/node-cache: move store tests to use @faker-js/faker #1641)

Contributors

@jaredwray (3)

Full List of Changes

feat(@cacheable/node-cache): enhance NodeCacheStore with missing features by @jaredwray in feat(@cacheable/node-cache): enhance NodeCacheStore with missing features #1643
feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642
@cacheable/node-cache: move store tests to use @faker-js/faker by @jaredwray in @cacheable/node-cache: move store tests to use @faker-js/faker #1641

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

cacheable@2.4.0 — 2026-05-27

Add maxTtl option to enforce an upper bound on cache entry lifetimes.

Features

add maxTtl option to cap maximum time-to-live on set() and setMany() (948234a, feat(cacheable, memory): add maxTtl option to cap maximum time-to-live #1645)

import { Cacheable } from 'cacheable';
const cache = new Cacheable({ ttl: '10m', maxTtl: '1h' });
await cache.set('key', 'value', '2h'); // capped to 1h
await cache.set('key2', 'value2');     // no TTL → capped to 1h

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (2)

Full List of Changes

feat(cacheable, memory): add maxTtl option to cap maximum time-to-live by @jaredwray in feat(cacheable, memory): add maxTtl option to cap maximum time-to-live #1645
feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

cache-manager@7.2.9 — 2026-05-27

Build tooling migration to tsdown and pnpm 11.

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (1)

Full List of Changes

feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

file-entry-cache@11.1.4 — 2026-05-27

Build tooling migration to tsdown and pnpm 11.

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (1)

Full List of Changes

feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

flat-cache@6.1.23 — 2026-05-27

Build tooling migration to tsdown and pnpm 11.

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (1)

Full List of Changes

feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

@cacheable/net@2.0.9 — 2026-05-27

Build tooling migration to tsdown and pnpm 11.

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (1)

Full List of Changes

feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

@cacheable/utils@2.4.2 — 2026-05-27

Build tooling migration to tsdown and pnpm 11.

Internal

migrate build from tsup to tsdown, pnpm 11 (1508695, feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642)

Contributors

@jaredwray (1)

Full List of Changes

feat: Migrate to pnpm 11 with corepack and tsdown from tsup by @jaredwray in feat: Migrate to pnpm 11 with corepack and tsdown from tsup #1642

Full diff: 9346f94...claude/vibrant-turing-Lt1n0

Verification

pnpm install --frozen-lockfile succeeds
pnpm build succeeds
Tests pass locally for all packages with available services (memory, node-cache, flat-cache, utils at 100% coverage)
Pre-existing test failures on main confirmed for packages requiring Redis/network services (cacheable, cache-manager, net, file-entry-cache, cacheable-request)
No uncommitted changes outside the version bump

Post-merge

Merge — no publish workflow detected; publish manually with npm publish per package or set up a workflow per release-management-nodejs.md.

Generated by Claude Code

Releasing 8 packages: - @cacheable/memory@2.1.0 (minor) - @cacheable/node-cache@3.1.0 (minor) - cacheable@2.4.0 (minor) - cache-manager@7.2.9 (patch) - file-entry-cache@11.1.4 (patch) - flat-cache@6.1.23 (patch) - @cacheable/net@2.0.9 (patch) - @cacheable/utils@2.4.2 (patch) https://claude.ai/code/session_01RHRKp9uLbfAsRAFPcDgZQx

gemini-code-assist

Code Review

This pull request increments the version numbers across multiple packages in the monorepo, including cache-manager, cacheable, file-entry-cache, flat-cache, memory, net, node-cache, and utils. No review comments were provided, and there is no feedback to address.

codecov · 2026-05-27T15:02:25Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (948234a) to head (d4e562b).

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1647   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           26        26           
  Lines         2688      2688           
  Branches       593       593           
=========================================
  Hits          2688      2688

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

gemini-code-assist Bot reviewed May 27, 2026

View reviewed changes

jaredwray merged commit 069f734 into main May 27, 2026
12 checks passed

jaredwray deleted the claude/vibrant-turing-Lt1n0 branch May 27, 2026 15:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

release: 2026-05-27 (8 packages)#1647

release: 2026-05-27 (8 packages)#1647
jaredwray merged 1 commit into
mainfrom
claude/vibrant-turing-Lt1n0

jaredwray commented May 27, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

codecov Bot commented May 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jaredwray commented May 27, 2026

Release summary

Packages

@cacheable/memory@2.1.0 — 2026-05-27

Features

Internal

Contributors

Full List of Changes

@cacheable/node-cache@3.1.0 — 2026-05-27

Features

Bug Fixes

Internal

Contributors

Full List of Changes

cacheable@2.4.0 — 2026-05-27

Features

Internal

Contributors

Full List of Changes

cache-manager@7.2.9 — 2026-05-27

Internal

Contributors

Full List of Changes

file-entry-cache@11.1.4 — 2026-05-27

Internal

Contributors

Full List of Changes

flat-cache@6.1.23 — 2026-05-27

Internal

Contributors

Full List of Changes

@cacheable/net@2.0.9 — 2026-05-27

Internal

Contributors

Full List of Changes

@cacheable/utils@2.4.2 — 2026-05-27

Internal

Contributors

Full List of Changes

Verification

Post-merge

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

codecov Bot commented May 27, 2026

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants