@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.
137 lines (136 loc) • 5.56 kB
TypeScript
/**
* @module Cache
*/
import { type AsyncLazy, type Factory } from "../../../../utilities/_module-exports.js";
import type { IEventBus } from "../../../../event-bus/contracts/_module-exports.js";
import type { ICache, ICacheFactory } from "../../../../cache/contracts/_module-exports.js";
import { type CacheSettingsBase, type CacheAdapter } from "../../../../cache/implementations/derivables/cache/_module.js";
import { KeyPrefixer, type TimeSpan } from "../../../../utilities/_module-exports.js";
import type { LazyPromise } from "../../../../async/_module-exports.js";
/**
*
* IMPORT_PATH: `"@daiso-tech/core/cache"`
* @group Derivables
*/
export type CacheAdapters<TAdapters extends string = string> = Partial<Record<TAdapters, CacheAdapter<any>>>;
/**
*
* IMPORT_PATH: `"@daiso-tech/core/cache"`
* @group Derivables
*/
export type CacheFactorySettings<TAdapters extends string = string> = CacheSettingsBase & {
adapters: CacheAdapters<TAdapters>;
defaultAdapter?: NoInfer<TAdapters>;
};
/**
* The `CacheFactory` class is immutable.
*
* IMPORT_PATH: `"@daiso-tech/core/cache"`
* @group Derivables
*/
export declare class CacheFactory<TAdapters extends string = string> implements ICacheFactory<TAdapters> {
private readonly settings;
/**
* @example
* ```ts
* import { CacheFactory } from "@daiso-tech/core/cache";
* import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
* import { MemoryCacheAdapter, RedisCacheAdapter, SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
* import { Serde } from "@daiso-tech/core/serde";
* import type { ISerde } from "@daiso-tech/core/serde/contracts";
* import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters";
* import { KeyPrefixer, type ISqliteDatabase, type AsyncFactoryFn } from "@daiso-tech/core/utilities";
* import Redis from "ioredis"
* import Sqlite from "better-sqlite3";
*
* function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): AsyncFactoryFn<string, IDatabaseCacheAdapter> {
* return async (prefix) => {
* const cacheAdapter = new SqliteCacheAdapter({
* database,
* serde,
* tableName: `cache_${prefix}`
* });
* await cacheAdapter.init();
* return cacheAdapter;
* }
* }
*
* const database = new Sqlite("local.db");
* const serde = new Serde(new SuperJsonSerdeAdapter());
* const cacheFactory = new CacheFactory({
* keyPrefixer: new KeyPrefixer("cache"),
* adapters: {
* sqlite: cahceAdapterFactory(database, serde),
* memory: new MemoryCacheAdapter(),
* redis: new RedisCacheAdapter({
* database: new Redis("YOUR_REDIS_CONNECTION"),
* serde,
* }),
* },
* defaultAdapter: "memory",
* });
*/
constructor(settings: CacheFactorySettings<TAdapters>);
setKeyPrefixer(keyPrefixer: KeyPrefixer): CacheFactory<TAdapters>;
setDefaultTtl(ttl: TimeSpan): CacheFactory<TAdapters>;
setEventBus(eventBus: IEventBus): CacheFactory<TAdapters>;
setlazyPromiseFactory(factory: Factory<AsyncLazy<any>, LazyPromise<any>>): CacheFactory<TAdapters>;
/**
* @example
* ```ts
* import { CacheFactory } from "@daiso-tech/core/cache";
* import type { IDatabaseCacheAdapter } from "@daiso-tech/core/cache/contracts";
* import { MemoryCacheAdapter, RedisCacheAdapter, SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
* import { Serde } from "@daiso-tech/core/serde";
* import type { ISerde } from "@daiso-tech/core/serde/contracts";
* import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters";
* import { KeyPrefixer, TimeSpan, type ISqliteDatabase, type AsyncFactoryFn } from "@daiso-tech/core/utilities";
* import Redis from "ioredis"
* import Sqlite from "better-sqlite3";
*
* function cahceAdapterFactory(database: ISqliteDatabase, serde: ISerde<string>): AsyncFactoryFn<string, IDatabaseCacheAdapter> {
* return async (prefix) => {
* const cacheAdapter = new SqliteCacheAdapter({
* database,
* serde,
* tableName: `cache_${prefix}`
* });
* await cacheAdapter.init();
* return cacheAdapter;
* }
* }
*
* const database = new Sqlite("local.db");
* const serde = new Serde(new SuperJsonSerdeAdapter());
* const cacheFactory = new CacheFactory({
* keyPrefixer: new KeyPrefixer("cache"),
* adapters: {
* sqlite: cahceAdapterFactory(database, serde),
* 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 cacheFactory
* .use()
* .add("a", 1);
*
* // Will add key to cache using the redis adapter which is RedisCacheAdapter
* await cacheFactory
* .use("redis")
* .add("a", 1);
*
* // You can change the default settings of the returned Cache instance.
* await cacheFactory
* .setDefaultTtl(TimeSpan.fromMinutes(2))
* .use("sqlite")
* .add("a", 1);
* ```
*/
use<TType = unknown>(adapterName?: TAdapters | undefined): ICache<TType>;
}