Caching for Node.js

Cacheable v2

`cacheable` is now using `@cacheable/utils`, `@cacheable/memoize`, and `@cacheable/memory` for its core functionality as we are moving to this modular architecture and plan to eventually have these modules across `cache-manager` and `flat-cache`. In addition there are some breaking changes:

• `get()` and `getMany()` no longer have the `raw` option but instead we have built out `getRaw()` and `getManyRaw()` to use.
• All `get` related functions now support `nonBlocking` which means if `nonBlocking: true` the primary store will return what it has and then in the background will work to sync from secondary storage for any misses. You can disable this by setting at the `get` function level the option `nonBlocking: false` which will look for any missing keys in the secondary.
• `Keyv` v5.5+ is now the recommended supported version as we are using its native `getMany` and `getRaw`
• `Wrap` and `getOrSet` have been updated with more robust options including the ability to use your own `serialize` function for creating the key in `wrap`.
• `hash` has now been updated with robust options and also an enum for setting the algorithm.

What's Changed

• net - fix: making it so fetch is cached by @jaredwray in https://github.com/jaredwray/cacheable/pull/1292
• net - feat: adding in get helper for fetch by @jaredwray in https://github.com/jaredwray/cacheable/pull/1293
• net - feat: adding in get response by @jaredwray in https://github.com/jaredwray/cacheable/pull/1294
• net - feat: adding in post from fetch by @jaredwray in https://github.com/jaredwray/cacheable/pull/1295
• net - feat: updating patch and post to have data param by @jaredwray in https://github.com/jaredwray/cacheable/pull/1296
• net - feat: adding in head helper method for fetch by @jaredwray in https://github.com/jaredwray/cacheable/pull/1297
• net - feat: adding in delete fetch helper by @jaredwray in https://github.com/jaredwray/cacheable/pull/1298
• net - feat: adding in http cache policy by @jaredwray in https://github.com/jaredwray/cacheable/pull/1299
• cacheable - fix: handling nonBlocking errors better by @jaredwray in https://github.com/jaredwray/cacheable/pull/1300
• cacheable - feat: (BREAKING) using memory, utils, and memoize by @jaredwray in https://github.com/jaredwray/cacheable/pull/1301
• mono - chore: upgrading wrangler to latest by @jaredwray in https://github.com/jaredwray/cacheable/pull/1304
• mono - fix: centralizing biome to root by @jaredwray in https://github.com/jaredwray/cacheable/pull/1305
• cache-manager - chore: upgrading @keyv/redis to 5.1.1 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1306
• cache-manager - chore: upgrading @faker-js/faker to 10.0.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1307
• cacheable-request - chore: upgrading @biomejs/biome to 2.2.3 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1308
• website - chore: upgrading docula to 0.20.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1309
• utils - feat: adding in helper functions from cache manager by @jaredwray in https://github.com/jaredwray/cacheable/pull/1311
• cache-manager - feat: using @cacheable/utils for helper functions by @jaredwray in https://github.com/jaredwray/cacheable/pull/1312
• cacheable - fix: if there are no keys needed from secondary do not ca… by @jaredwray in https://github.com/jaredwray/cacheable/pull/1313
• cacheable - feat: moving to @cacheable/utils hash function by @jaredwray in https://github.com/jaredwray/cacheable/pull/1314
• cacheable - feat: moving to native Keyv getManyRaw function by @jaredwray in https://github.com/jaredwray/cacheable/pull/1315
• cacheable - feat: moving to Keyv native setMany by @jaredwray in https://github.com/jaredwray/cacheable/pull/1316
• cacheable - feat: moving to native Keyv deleteMany by @jaredwray in https://github.com/jaredwray/cacheable/pull/1318
• cacheable - feat: moving to native Keyv getRaw by @jaredwray in https://github.com/jaredwray/cacheable/pull/1319
• cacheable - feat: adding getRaw and getManyRaw by @jaredwray in https://github.com/jaredwray/cacheable/pull/1320
• cacheable - feat: get() and getMany() to not return raw value by @jaredwray in https://github.com/jaredwray/cacheable/pull/1321
• cacheable - feat: moving get and getMany to use raw methods by @jaredwray in https://github.com/jaredwray/cacheable/pull/1322
• cacheable - chore: clean up types and enums by @jaredwray in https://github.com/jaredwray/cacheable/pull/1323
• utils - feat: moving hash function to take options with stringify by @jaredwray in https://github.com/jaredwray/cacheable/pull/1324
• memoize - feat: adding options with serialize and deserialize for create key hash by @jaredwray in https://github.com/jaredwray/cacheable/pull/1325
• cacheable - feat: adding in the ability to not set serializers by default by @jaredwray in https://github.com/jaredwray/cacheable/pull/1326
• cacheable - feat: adding in non blocking to get by @jaredwray in https://github.com/jaredwray/cacheable/pull/1327

Full Changelog: https://github.com/jaredwray/cacheable/compare/2025-08-26...2025-09-09

What's Changed

• cache-manager - feat: add store layer identification to event payloads by @faizanu94 in https://github.com/jaredwray/cacheable/pull/1270
• cacheable - fix: pass createKey option through wrap methods by @amit13k in https://github.com/jaredwray/cacheable/pull/1269
• cacheable - feat: adding in cache:hit and cache:miss events by @jaredwray in https://github.com/jaredwray/cacheable/pull/1273
• utils - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1274
• utils - chore: upgrading keyv adapters to latest by @jaredwray in https://github.com/jaredwray/cacheable/pull/1275
• utlis - chore: upgrading @biomejs/biome to 2.2.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1276
• utils - chore: upgrading @fakerjs/faker to 10.0.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1277
• memoize - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1278
• memoize - chore: upgrading @biomejs/biome to 2.2.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1279
• memoize - chore: upgrading @faker-js/faker to 10.0.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1280
• memoize - chore: upgrading keyv adapters to latest by @jaredwray in https://github.com/jaredwray/cacheable/pull/1281
• net - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1282
• net - chore: upgrading hookified to 1.12.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1283
• net - chore: upgrading undici to 7.15.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1284
• net - chore: upgrading @biomejs/biome to 2.2.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1285
• net - chore: upgrading @faker-js/faker to 10.0.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1286
• memory - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1287
• memory - chore: upgrading keyv to 5.5.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1288
• memory - chore: upgrading hookified to 1.12.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1289
• memory - chore: upgrading @biomejs/biome to 2.2.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1290
• memory - chore: upgrading @faker-js/faker to 10.0.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1291
• mono - fix: moving codecov to better file search by @jaredwray in https://github.com/jaredwray/cacheable/pull/1272
• mono - fix: updating biome to fail on warnings by @jaredwray in https://github.com/jaredwray/cacheable/pull/1271

New Contributors

• @amit13k made their first contribution in https://github.com/jaredwray/cacheable/pull/1269
• @faizanu94 made their first contribution in https://github.com/jaredwray/cacheable/pull/1270

Full Changelog: https://github.com/jaredwray/cacheable/compare/2025-08-17...2025-08-26

What's Changed

• node-cache - fix: adding in supported node versions by @jaredwray in https://github.com/jaredwray/cacheable/pull/1256
• node-cache - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1262
• node-cache - chore: upgrading hookified to 1.11.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1263
• node-cache - chore: upgrading keyv to 5.5.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1264
• mono - feat: migrating to biome from xo by @jaredwray in https://github.com/jaredwray/cacheable/pull/1258
• cacheable - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1259
• cacheable - chore: upgrading hookified to 1.11.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1260
• cacheable - chore: upgrading keyv to 5.5.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1261
• flat-cache - chore: upgrading hookified to 1.11.0 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1265
• flat-cache - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1266
• file-entry-cache - chore: upgrading typescript to 5.9.2 by @jaredwray in https://github.com/jaredwray/cacheable/pull/1267

Full Changelog: https://github.com/jaredwray/cacheable/compare/2025-08-06...2025-08-17