@daiso-tech/core
Version:
The library offers flexible, framework-agnostic solutions for modern web applications, built on adaptable components that integrate seamlessly with popular frameworks like Next Js.
153 lines • 4.94 kB
JavaScript
/**
* @module Cache
*/
import {} from "@standard-schema/spec";
import {} from "../../../../cache/contracts/_module.js";
import { Cache, } from "../../../../cache/implementations/derivables/cache/_module.js";
import {} from "../../../../event-bus/contracts/_module.js";
import {} from "../../../../execution-context/contracts/_module.js";
import {} from "../../../../lock/contracts/_module.js";
import {} from "../../../../namespace/contracts/_module.js";
import {} from "../../../../time-span/contracts/_module.js";
import { DefaultAdapterNotDefinedError, UnregisteredAdapterError, } from "../../../../utilities/_module.js";
/**
* The `CacheResolver` class is immutable.
*
* IMPORT_PATH: `"@daiso-tech/core/cache"`
* @group Derivables
*/
export class CacheResolver {
settings;
/**
* @example
* ```ts
* import { CacheResolver } from "@daiso-tech/core/cache";
* import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
* import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
* import { Serde } from "@daiso-tech/core/serde";
* import type { ISerde } from "@daiso-tech/core/serde/contracts";
* import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
* import Redis from "ioredis"
*
* const serde = new Serde(new SuperJsonSerdeAdapter());
* const cacheResolver = new CacheResolver({
* adapters: {
* memory: new MemoryCacheAdapter(),
* redis: new RedisCacheAdapter({
* database: new Redis("YOUR_REDIS_CONNECTION"),
* serde,
* }),
* },
* defaultAdapter: "memory",
* });
*/
constructor(settings) {
this.settings = settings;
}
setNamespace(namespace) {
return new CacheResolver({
...this.settings,
namespace,
});
}
setDefaultTtl(ttl) {
return new CacheResolver({
...this.settings,
defaultTtl: ttl,
});
}
setEventBus(eventBus) {
return new CacheResolver({
...this.settings,
eventBus,
});
}
setSchema(schema) {
return new CacheResolver({
...this.settings,
schema,
});
}
setType() {
return new CacheResolver(this.settings);
}
setJitter(jitter) {
return new CacheResolver({
...this.settings,
defaultJitter: jitter,
});
}
setWaitUntil(waitUntil) {
return new CacheResolver({
...this.settings,
waitUntil,
});
}
setExecutionContext(executionContext) {
return new CacheResolver({
...this.settings,
executionContext,
});
}
setLockFactory(lockFactory) {
return new CacheResolver({
...this.settings,
lockFactory,
});
}
/**
* @example
* ```ts
* import { CacheResolver } from "@daiso-tech/core/cache";
* import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
* import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
* import { Serde } from "@daiso-tech/core/serde";
* import type { ISerde } from "@daiso-tech/core/serde/contracts";
* import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/super-json-serde-adapter";
* import { TimeSpan } from "@daiso-tech/core/time-span";
* import Redis from "ioredis"
*
* const serde = new Serde(new SuperJsonSerdeAdapter());
* const cacheResolver = new CacheResolver({
* adapters: {
* memory: new MemoryCacheAdapter(),
* redis: new RedisCacheAdapter({
* database: new Redis("YOUR_REDIS_CONNECTION"),
* serde,
* }),
* },
* defaultAdapter: "memory",
* });
*
* // Will add key to cache using the default adapter which is MemoryCacheAdapter
* await cacheResolver
* .use()
* .add("a", 1);
*
* // Will add key to cache using the redis adapter
* await cacheResolver
* .use("redis")
* .add("a", 1);
*
* // You can change the default settings of the returned Cache instance.
* await cacheResolver
* .setDefaultTtl(TimeSpan.fromMinutes(2))
* .use("sqlite")
* .add("a", 1);
* ```
*/
use(adapterName = this.settings.defaultAdapter) {
if (adapterName === undefined) {
throw new DefaultAdapterNotDefinedError(CacheResolver.name);
}
const adapter = this.settings.adapters[adapterName];
if (adapter === undefined) {
throw new UnregisteredAdapterError(adapterName);
}
return new Cache({
...this.settings,
adapter,
});
}
}
//# sourceMappingURL=cache-resolver.js.map