@daiso-tech/core 0.23.0 → 0.25.0

package/dist/cache/implementations/derivables/cache/cache.d.ts

@@ -0,0 +1,650 @@
+/**
+ * @module Cache
+ */
+import type { CacheEvents, WithTtlValue } from "../../../../cache/contracts/_module-exports.js";
+import { type ICache, type ICacheAdapter } from "../../../../cache/contracts/_module-exports.js";
+import { type IGroupableCache } from "../../../../cache/contracts/_module-exports.js";
+import type { AsyncLazyable, GetOrAddValue, OneOrMore } from "../../../../utilities/_module-exports.js";
+import type { TimeSpan } from "../../../../utilities/_module-exports.js";
+import type { BackoffPolicy, RetryPolicy } from "../../../../async/_module-exports.js";
+import { LazyPromise } from "../../../../async/_module-exports.js";
+import type { IGroupableEventBus, EventListener, Unsubscribe, EventClass, EventInstance } from "../../../../event-bus/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/derivables"```
+ * @group Derivables
+ */
+export type CacheSettings = {
+    adapter: ICacheAdapter<any>;
+    /**
+     * @default
+     * ```ts
+     * new EventBus({
+     *   adapter: new MemoryEventBusAdapter({
+     *     rootGroup: "@global"
+     *   })
+     * })
+     * ```
+     */
+    eventBus?: IGroupableEventBus<any>;
+    /**
+     * You can decide the default ttl value. If null is passed then no ttl will be used by default.
+     * @default {null}
+     */
+    defaultTtl?: TimeSpan | null;
+    /**
+     * The default retry attempt to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    retryAttempts?: number | null;
+    /**
+     * The default backof policy to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    backoffPolicy?: BackoffPolicy | null;
+    /**
+     * The default retry policy to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    retryPolicy?: RetryPolicy | null;
+    /**
+     * The default timeout to use in the returned <i>LazyPromise</i>.
+     * @default {null}
+     */
+    timeout?: TimeSpan | null;
+};
+/**
+ * <i>Cache</i> class can be derived from any <i>{@link ICacheAdapter}</i>.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/derivables"```
+ * @group Derivables
+ */
+export declare class Cache<TType = unknown> implements IGroupableCache<TType> {
+    private static defaultRetryPolicy;
+    private readonly groupdEventBus;
+    private readonly eventBus;
+    private readonly adapter;
+    private readonly defaultTtl;
+    private readonly retryAttempts;
+    private readonly backoffPolicy;
+    private readonly retryPolicy;
+    private readonly timeout;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     * ```
+     */
+    constructor(settings: CacheSettings);
+    private createLayPromise;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * await cache.addListener(KeyAddedCacheEvent, listener);
+     * await cache.add("a", 1);
+     * ```
+     */
+    addListener<TEventClass extends EventClass<CacheEvents>>(eventName: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * await cache.addListenerMany([KeyAddedCacheEvent], listener);
+     * await cache.add("a", 1);
+     * ```
+     */
+    addListenerMany<TEventClass extends EventClass<CacheEvents>>(eventNames: TEventClass[], listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * await cache.addListener(KeyAddedCacheEvent, listener);
+     * await cache.removeListener(KeyAddedCacheEvent, listener);
+     * await cache.add("a", 1);
+     * ```
+     */
+    removeListener<TEventClass extends EventClass<CacheEvents>>(eventName: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * await cache.addListenerMany([KeyAddedCacheEvent], listener);
+     * await cache.removeListenerMany(KeyAddedCacheEvent, listener);
+     * await cache.add("a", 1);
+     * ```
+     */
+    removeListenerMany<TEventClass extends EventClass<CacheEvents>>(eventNames: TEventClass[], listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * await cache.listenOnce(KeyAddedCacheEvent, listener);
+     * await cache.add("a", 1);
+     * ```
+     */
+    listenOnce<TEventClass extends EventClass<CacheEvents>>(eventName: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<void>;
+    asPromise<TEventClass extends EventClass<CacheEvents>>(event: TEventClass): LazyPromise<EventInstance<TEventClass>>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * const unsubscribe = await cache.subscribe(KeyAddedCacheEvent, listener);
+     * await cache.add("a", 1);
+     * await unsubscribe();
+     * ```
+     */
+    subscribe<TEventClass extends EventClass<CacheEvents>>(eventName: TEventClass, listener: EventListener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    /**
+     * You can listen to different events of <i>Cache</i> class instance.
+     *
+     * Refer to <i>{@link CacheEvents}</i>, to se all events dispatched by <i>Cache</i> class instance.
+     * Refer to <i>{@link IEventListenable}</i> for details on how the method works.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     * import type { EventListener} from "@daiso-tech/core/event-bus/contracts";
+     * import { KeyAddedCacheEvent, type CacheEvents } from "@daiso-tech/core/cache/contracts";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const listener: EventListener<CacheEvents> = event => {
+     *   console.log(event);
+     * };
+     * const unsubscribe = await cache.subscribeMany([KeyAddedCacheEvent], listener);
+     * await cache.add("a", 1);
+     * await unsubscribe();
+     * ```
+     */
+    subscribeMany<TEventClass extends EventClass<CacheEvents>>(eventNames: TEventClass[], listener: EventListener<EventInstance<TEventClass>>): LazyPromise<Unsubscribe>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache, ICache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * // Will print "@global"
+     * console.log(cache.getGroup());
+     *
+     * const groupedCache: ICache = cache.withGroup("company-1");
+     *
+     * // Will print "@global/company-1"
+     * console.log(groupedCache.getGroup());
+     * ```
+     */
+    withGroup(group: OneOrMore<string>): ICache<TType>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * // Will print "@global"
+     * console.log(cache.getGroup());
+     * ```
+     */
+    getGroup(): string;
+    get(key: string): LazyPromise<TType | null>;
+    add(key: string, value: TType, 
+    /**
+     * @default null
+     */
+    ttl?: TimeSpan | null): LazyPromise<boolean>;
+    update(key: string, value: TType): LazyPromise<boolean>;
+    put(key: string, value: TType, 
+    /**
+     * @default null
+     */
+    ttl?: TimeSpan | null): LazyPromise<boolean>;
+    remove(key: string): LazyPromise<boolean>;
+    increment(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
+    clear(): LazyPromise<void>;
+    exists(key: string): LazyPromise<boolean>;
+    existsMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
+    missing(key: string): LazyPromise<boolean>;
+    missingMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
+    getMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, TType | null>>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOr("a", -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOr("a", () => -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass async function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOr("a", async () => -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass <i>{@link LazyPromise}</i> as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOr("a", new LazyPromise(async () => -1));
+     * // -1
+     * console.log(result);
+     * ```
+     */
+    getOr(key: string, defaultValue: AsyncLazyable<TType>): LazyPromise<TType>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrMany({ a: -1 });
+     * // { a: -1 }
+     * console.log(result);
+     * ```
+     *
+     * You can pass function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrMany({ a: () => -1 });
+     * // { a: -1 }
+     * console.log(result);
+     * ```
+     *
+     * You can pass async function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrMany({ a: async () => -1 });
+     * // { a: -1 }
+     * console.log(result);
+     * ```
+     *
+     * You can pass <i>{@link LazyPromise}</i> as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrMany({ a: new LazyPromise(async () => - 1) });
+     * // { a: -1 }
+     * console.log(result);
+     * ```
+     */
+    getOrMany<TKeys extends string>(keysWithDefaults: Record<TKeys, AsyncLazyable<TType>>): LazyPromise<Record<TKeys, TType>>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * await cache.add("a", 1);
+     *
+     * const result1 = await cache.getOrFail("a");
+     * // Will print 1
+     * console.log(result1);
+     *
+     * await cache.remove("a");
+     *
+     * // Will throw an error
+     * await cache.getOrFail("a");
+     * ```
+     */
+    getOrFail(key: string): LazyPromise<TType>;
+    addMany<TKeys extends string>(values: Record<TKeys, WithTtlValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
+    updateMany<TKeys extends string>(values: Record<TKeys, TType>): LazyPromise<Record<TKeys, boolean>>;
+    putMany<TKeys extends string>(values: Record<TKeys, WithTtlValue<TType>>): LazyPromise<Record<TKeys, boolean>>;
+    removeMany<TKeys extends string>(keys: TKeys[]): LazyPromise<Record<TKeys, boolean>>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result1 = await cache.getAndRemove("a");
+     * // Will print null
+     * console.log(result1);
+     *
+     * await cache.add("a", 2)
+     *
+     * const result2 = await cache.getAndRemove("a");
+     * // Will print 2
+     * console.log(result2);
+     *
+     * const result3 = await cache.get("a");
+     * // Will print null
+     * console.log(result3);
+     * ```
+     */
+    getAndRemove(key: string): LazyPromise<TType | null>;
+    /**
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrAdd("a", -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrAdd("a", () => -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass async function as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrAdd("a", async () => -1);
+     * // -1
+     * console.log(result);
+     * ```
+     *
+     * You can pass <i>{@link LazyPromise}</i> as default value.
+     * @example
+     * ```ts
+     * import type { IGroupableCache } from "@daiso-tech/core/cache/contracts";
+     * import type { IGroupableEventBus } from "@daiso-tech/core/event-bus/contracts";
+     * import { Cache } from "@daiso-tech/core/cache/implementations/derivables";
+     * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
+     *
+     * const cache: IGroupableCache = new Cache({
+     *   adapter: new MemoryCacheAdapter({
+     *     rootGroup: "@global"
+     *   }),
+     * });
+     *
+     * const result = await cache.getOrAdd("a", new LazyPromise(async () => -1));
+     * // -1
+     * console.log(result);
+     * ```
+     */
+    getOrAdd(key: string, valueToAdd: AsyncLazyable<GetOrAddValue<TType>>, 
+    /**
+     * @default {null}
+     */
+    ttl?: TimeSpan): LazyPromise<TType>;
+    decrement(key: string, value?: Extract<TType, number>): LazyPromise<boolean>;
+}