@squareboat/nest-cache
v0.2.9
Published
The cache package for your NestJS Applications
Downloads
130
Readme
NestJS Cache
Sometimes, the data retrieval or computed tasks performed by your applications can be heavy, CPU intensive or time taking. In those cases, you may want to save it in a fast-read store so that you don't need to run the computation again and again. When the data is cached, it can be retrieved quickly on subsequent requests for the same data.
This package provides a multi-store cache provider for your NestJS application.
Supported Queues
- Redis
- Memcache (Coming Soon)
- RocksDB (Coming Soon)
- KeyDB (Coming Soon)
Few Hightlights
- ✅ Easy to setup and configure
- ✅ Handle multiple stores with ease
- ✅ Expressive API methods
Installation
# npm
npm i @squareboat/nest-cache
# yarn
yarn add @squareboat/nest-cache
For NestJS v6.7.x, please do
# npm
npm i @squareboat/nest-cache^0.0.1
# yarn
yarn add @squareboat/nest-cache^0.0.1
Configuration
Now that the installation is done, you need to configure the package as mentioned below.
Synchronous Registration
You can register the cache module like below
// src/app.module.ts
import { Module } from "@nestjs/common";
import { CacheModule } from "@libs/cache";
@Module({
imports: [
CacheModule.register({
default: "redis",
stores: {
redis: {
driver: "redis",
host: process.env.REDIS_HOST,
password: process.env.REDIS_PASSWORD,
port: process.env.REDIS_PORT || 6379,
database: process.env.REDIS_DB || 0,
prefix: "nestjs_boilerplate",
},
},
}),
],
controllers: [],
providers: [],
})
export class AppModule {}
Asynchronous Registration (Recommended)
You need to create a file, config/cache.ts
// config/cache.ts
import { registerAs } from "@nestjs/config";
import { basePath } from "@libs/core";
import { CacheOptions } from "@libs/cache";
export default registerAs(
"cache",
() =>
({
default: "redis",
stores: {
redis: {
driver: "redis",
host: process.env.REDIS_HOST || "127.0.0.1",
password: process.env.REDIS_PASSWORD || undefined,
port: process.env.REDIS_PORT || 6379,
database: process.env.REDIS_DB || 0,
prefix: "nestjs_boilerplate",
},
},
} as CacheOptions)
);
// src/app.module.ts
import { Module } from "@nestjs/common";
import { ConfigModule, ConfigService } from "@nestjs/config";
import config from "@config/index";
import { CacheModule } from "@libs/cache";
@Module({
imports: [
ConfigModule.forRoot({
isGlobal: true,
expandVariables: true,
load: config,
}),
CacheModule.registerAsync({
isGlobal: true,
imports: [ConfigModule],
useFactory: (config: ConfigService) => config.get("cache"),
inject: [ConfigService],
}),
],
controllers: [],
providers: [],
})
export class AppModule {}
Usage
To access the store, you can use the CacheStore
method or Cache
class.
// method
import { CacheStore } from "@squareboat/nest-cache";
const store = CacheStore("redis");
// class
import { Cache } from "@squareboat/nest-cache";
const store = Cache.store("redis");
If no store name is passed, then default store is returned.
Now, you can set data in the store using .set()
method.
// saved forever in the store
await CacheStore().set("reset_password_token", "abcd123456");
// saved for 2 mins or 120 seconds in the store
await CacheStore().set("reset_password_token", "abcdef12345678", 120);
To fetch the data from store, you can use .get()
method.
await CacheStore().set("reset_password_token");
// will return 'abcd123456'
To check if key exists in the store, you can use .has()
method
await CacheStore().has("reset_password_token");
// will return `true` if found, else `false`
To remove a key from the store, use .forget()
method
await CacheStore().forget("reset_password_token");
There will be cases where you may want to process something and then save it to store.
Thankfully, this package provides two methods, .remember()
and .rememberForever()
method which you can use to handle this case automatically.
const cb = () => {
return "some_random_generated_token";
};
await CacheStore().rememberForever("reset_password_token", cb);
await CacheStore().remember("reset_password_token", cb, 120);
Notice the callback cb
passed to the rememberForever
method, it will be processed and the value returned by the callback will be serialized and saved to the store automatically.
The only difference between the rememberForever
and remember
method is the expiry time (3rd argument) of the key in the store.
Extras
There might be instances where you would want to generate unique keys with multiple values, and to maintain a uniformity and consistency, this package comes with a genKey
method.
const key = Cache.genKey({ type: "reset_password_token", userId: 1234 });
console.log(key); // type[reset_password_token],userId[1234]
genKey
method automatically sorts the object's key in lexical order.
Contributing
To know about contributing to this package, read the guidelines here
About Us
We are a bunch of dreamers, designers, and futurists. We are high on collaboration, low on ego, and take our happy hours seriously. We'd love to hear more about your product. Let's talk and turn your great ideas into something even greater! We have something in store for everyone. ☎️ 📧 Connect with us!
License
The MIT License. Please see License File for more information. Copyright © 2020 SquareBoat.
Made with ❤️ by Squareboat