@linkedmink/multilevel-aging-cache
Version:
Package provides an interface to cache and persist data to Redis, MongoDB, memory
74 lines • 2.48 kB
TypeScript
/**
* The algorithm for selecting which element should be replaced first in a cache
*/
export declare enum AgingCacheReplacementPolicy {
/**
* Replace items in a First-in First-out manner
*/
FIFO = 0,
/**
* Replace items by Least Recently Used
*/
LRU = 1
}
/**
* In a distributed environment, multiple instances could write to cache at once. This option
* determines what should happen if an exiting entry is found in a higher level cache.
*/
export declare enum AgingCacheWriteMode {
/**
* When a higher level cache has a key, refresh the lower level keys and only overwrite if
* the force option is supplied
*/
RefreshAlways = 0,
/**
* When our entry is newer, then allow it to take precedence and overwrite the higher level
* caches. Refresh the lower level caches if older
*/
OverwriteAged = 1,
/**
* Unconditionally overwrite the value that's stored in higher level caches
*/
OverwriteAlways = 2
}
/**
* The set of options used to construct an aging cache
*/
export interface IAgingCacheOptions {
/**
* The maximum number of entries to store in the cache, undefined for no max
* FIFO: Check the lowest level for maximum
*/
maxEntries?: number;
/**
* During a purge, the maximum value of the age marker to keep entries, varies by algorithm
* FIFO: The maximum time to keep entries in minutes, undefined for no limit
*/
ageLimit?: number;
/**
* The interval to check for old entries in seconds
*/
purgeInterval: number;
/**
* The order elements should be replaced when purging stale entries
*/
replacementPolicy: AgingCacheReplacementPolicy;
/**
* Determine when a value should be overwritten in the storage hierarchy on set
*/
setMode: AgingCacheWriteMode;
/**
* Determine when a value should be overwritten in the storage hierarchy on delete
*/
deleteMode: AgingCacheWriteMode;
/**
* When evicting stale entries, delete from layers below this level. When not set,
* delete from all levels, thus, making this a cache only with no persistence layer.
*/
evictAtLevel?: number;
}
/**
* @return Options for a default FIFO cache
*/
export declare function getDefaultAgingCacheOptions(): IAgingCacheOptions;
//# sourceMappingURL=IAgingCacheOptions.d.ts.map