cacheable 1.10.4 → 2.0.1

package/dist/index.js

@@ -1,1208 +1,23 @@
 // src/index.ts
-import { Hookified as Hookified2 } from "hookified";
-import { Keyv as Keyv2 } from "keyv";
-
-// src/hash.ts
-import * as crypto from "crypto";
-function hash(object, algorithm = "sha256") {
-  const objectString = JSON.stringify(object);
-  if (!crypto.getHashes().includes(algorithm)) {
-    throw new Error(`Unsupported hash algorithm: '${algorithm}'`);
-  }
-  const hasher = crypto.createHash(algorithm);
-  hasher.update(objectString);
-  return hasher.digest("hex");
-}
-function hashToNumber(object, min = 0, max = 10, algorithm = "sha256") {
-  const objectString = JSON.stringify(object);
-  if (!crypto.getHashes().includes(algorithm)) {
-    throw new Error(`Unsupported hash algorithm: '${algorithm}'`);
-  }
-  const hasher = crypto.createHash(algorithm);
-  hasher.update(objectString);
-  const hashHex = hasher.digest("hex");
-  const hashNumber = Number.parseInt(hashHex, 16);
-  const range = max - min + 1;
-  return min + hashNumber % range;
-}
-function djb2Hash(string_, min = 0, max = 10) {
-  let hash2 = 5381;
-  for (let i = 0; i < string_.length; i++) {
-    hash2 = hash2 * 33 ^ string_.charCodeAt(i);
-  }
-  const range = max - min + 1;
-  return min + Math.abs(hash2) % range;
-}
-
-// src/keyv-memory.ts
-import { Keyv } from "keyv";
-
-// src/memory.ts
-import { Hookified } from "hookified";
-
-// src/memory-lru.ts
-var ListNode = class {
-  value;
-  prev = void 0;
-  next = void 0;
-  constructor(value) {
-    this.value = value;
-  }
-};
-var DoublyLinkedList = class {
-  head = void 0;
-  tail = void 0;
-  nodesMap = /* @__PURE__ */ new Map();
-  // Add a new node to the front (most recently used)
-  addToFront(value) {
-    const newNode = new ListNode(value);
-    if (this.head) {
-      newNode.next = this.head;
-      this.head.prev = newNode;
-      this.head = newNode;
-    } else {
-      this.head = this.tail = newNode;
-    }
-    this.nodesMap.set(value, newNode);
-  }
-  // Move an existing node to the front (most recently used)
-  moveToFront(value) {
-    const node = this.nodesMap.get(value);
-    if (!node || this.head === node) {
-      return;
-    }
-    if (node.prev) {
-      node.prev.next = node.next;
-    }
-    if (node.next) {
-      node.next.prev = node.prev;
-    }
-    if (node === this.tail) {
-      this.tail = node.prev;
-    }
-    node.prev = void 0;
-    node.next = this.head;
-    if (this.head) {
-      this.head.prev = node;
-    }
-    this.head = node;
-    this.tail ??= node;
-  }
-  // Get the oldest node (tail)
-  getOldest() {
-    return this.tail ? this.tail.value : void 0;
-  }
-  // Remove the oldest node (tail)
-  removeOldest() {
-    if (!this.tail) {
-      return void 0;
-    }
-    const oldValue = this.tail.value;
-    if (this.tail.prev) {
-      this.tail = this.tail.prev;
-      this.tail.next = void 0;
-    } else {
-      this.head = this.tail = void 0;
-    }
-    this.nodesMap.delete(oldValue);
-    return oldValue;
-  }
-  get size() {
-    return this.nodesMap.size;
-  }
-};
-
-// src/shorthand-time.ts
-var shorthandToMilliseconds = (shorthand) => {
-  let milliseconds;
-  if (shorthand === void 0) {
-    return void 0;
-  }
-  if (typeof shorthand === "number") {
-    milliseconds = shorthand;
-  } else if (typeof shorthand === "string") {
-    shorthand = shorthand.trim();
-    if (Number.isNaN(Number(shorthand))) {
-      const match = /^([\d.]+)\s*(ms|s|m|h|hr|d)$/i.exec(shorthand);
-      if (!match) {
-        throw new Error(
-          `Unsupported time format: "${shorthand}". Use 'ms', 's', 'm', 'h', 'hr', or 'd'.`
-        );
-      }
-      const [, value, unit] = match;
-      const numericValue = Number.parseFloat(value);
-      const unitLower = unit.toLowerCase();
-      switch (unitLower) {
-        case "ms": {
-          milliseconds = numericValue;
-          break;
-        }
-        case "s": {
-          milliseconds = numericValue * 1e3;
-          break;
-        }
-        case "m": {
-          milliseconds = numericValue * 1e3 * 60;
-          break;
-        }
-        case "h": {
-          milliseconds = numericValue * 1e3 * 60 * 60;
-          break;
-        }
-        case "hr": {
-          milliseconds = numericValue * 1e3 * 60 * 60;
-          break;
-        }
-        case "d": {
-          milliseconds = numericValue * 1e3 * 60 * 60 * 24;
-          break;
-        }
-        /* c8 ignore next 3 */
-        default: {
-          milliseconds = Number(shorthand);
-        }
-      }
-    } else {
-      milliseconds = Number(shorthand);
-    }
-  } else {
-    throw new TypeError("Time must be a string or a number.");
-  }
-  return milliseconds;
-};
-var shorthandToTime = (shorthand, fromDate) => {
-  fromDate ??= /* @__PURE__ */ new Date();
-  const milliseconds = shorthandToMilliseconds(shorthand);
-  if (milliseconds === void 0) {
-    return fromDate.getTime();
-  }
-  return fromDate.getTime() + milliseconds;
-};
-
-// src/coalesce-async.ts
-var callbacks = /* @__PURE__ */ new Map();
-function hasKey(key) {
-  return callbacks.has(key);
-}
-function addKey(key) {
-  callbacks.set(key, []);
-}
-function removeKey(key) {
-  callbacks.delete(key);
-}
-function addCallbackToKey(key, callback) {
-  const stash = getCallbacksByKey(key);
-  stash.push(callback);
-  callbacks.set(key, stash);
-}
-function getCallbacksByKey(key) {
-  return callbacks.get(key) ?? [];
-}
-async function enqueue(key) {
-  return new Promise((resolve, reject) => {
-    const callback = { resolve, reject };
-    addCallbackToKey(key, callback);
-  });
-}
-function dequeue(key) {
-  const stash = getCallbacksByKey(key);
-  removeKey(key);
-  return stash;
-}
-function coalesce(options) {
-  const { key, error, result } = options;
-  for (const callback of dequeue(key)) {
-    if (error) {
-      callback.reject(error);
-    } else {
-      callback.resolve(result);
-    }
-  }
-}
-async function coalesceAsync(key, fnc) {
-  if (!hasKey(key)) {
-    addKey(key);
-    try {
-      const result = await Promise.resolve(fnc());
-      coalesce({ key, result });
-      return result;
-    } catch (error) {
-      coalesce({ key, error });
-      throw error;
-    }
-  }
-  return enqueue(key);
-}
-
-// src/wrap.ts
-function wrapSync(function_, options) {
-  const { ttl, keyPrefix, cache } = options;
-  return (...arguments_) => {
-    let cacheKey = createWrapKey(function_, arguments_, keyPrefix);
-    if (options.createKey) {
-      cacheKey = options.createKey(function_, arguments_, options);
-    }
-    let value = cache.get(cacheKey);
-    if (value === void 0) {
-      try {
-        value = function_(...arguments_);
-        cache.set(cacheKey, value, ttl);
-      } catch (error) {
-        cache.emit("error", error);
-        if (options.cacheErrors) {
-          cache.set(cacheKey, error, ttl);
-        }
-      }
-    }
-    return value;
-  };
-}
-async function getOrSet(key, function_, options) {
-  const keyString = typeof key === "function" ? key(options) : key;
-  let value = await options.cache.get(keyString);
-  if (value === void 0) {
-    const cacheId = options.cacheId ?? "default";
-    const coalesceKey = `${cacheId}::${keyString}`;
-    value = await coalesceAsync(coalesceKey, async () => {
-      try {
-        const result = await function_();
-        await options.cache.set(keyString, result, options.ttl);
-        return result;
-      } catch (error) {
-        options.cache.emit("error", error);
-        if (options.cacheErrors) {
-          await options.cache.set(keyString, error, options.ttl);
-        }
-        if (options.throwErrors) {
-          throw error;
-        }
-      }
-    });
-  }
-  return value;
-}
-function wrap(function_, options) {
-  const { keyPrefix, cache } = options;
-  return async (...arguments_) => {
-    let cacheKey = createWrapKey(function_, arguments_, keyPrefix);
-    if (options.createKey) {
-      cacheKey = options.createKey(function_, arguments_, options);
-    }
-    return cache.getOrSet(
-      cacheKey,
-      async () => function_(...arguments_),
-      options
-    );
-  };
-}
-function createWrapKey(function_, arguments_, keyPrefix) {
-  if (!keyPrefix) {
-    return `${function_.name}::${hash(arguments_)}`;
-  }
-  return `${keyPrefix}::${function_.name}::${hash(arguments_)}`;
-}
-
-// src/memory.ts
-var defaultStoreHashSize = 16;
-var maximumMapSize = 16777216;
-var CacheableMemory = class extends Hookified {
-  _lru = new DoublyLinkedList();
-  _storeHashSize = defaultStoreHashSize;
-  _storeHashAlgorithm = "djb2Hash" /* djb2Hash */;
-  // Default is djb2Hash
-  _store = Array.from(
-    { length: this._storeHashSize },
-    () => /* @__PURE__ */ new Map()
-  );
-  _ttl;
-  // Turned off by default
-  _useClone = true;
-  // Turned on by default
-  _lruSize = 0;
-  // Turned off by default
-  _checkInterval = 0;
-  // Turned off by default
-  _interval = 0;
-  // Turned off by default
-  /**
-   * @constructor
-   * @param {CacheableMemoryOptions} [options] - The options for the CacheableMemory
-   */
-  constructor(options) {
-    super();
-    if (options?.ttl) {
-      this.setTtl(options.ttl);
-    }
-    if (options?.useClone !== void 0) {
-      this._useClone = options.useClone;
-    }
-    if (options?.storeHashSize && options.storeHashSize > 0) {
-      this._storeHashSize = options.storeHashSize;
-    }
-    if (options?.lruSize) {
-      if (options.lruSize > maximumMapSize) {
-        this.emit(
-          "error",
-          new Error(
-            `LRU size cannot be larger than ${maximumMapSize} due to Map limitations.`
-          )
-        );
-      } else {
-        this._lruSize = options.lruSize;
-      }
-    }
-    if (options?.checkInterval) {
-      this._checkInterval = options.checkInterval;
-    }
-    if (options?.storeHashAlgorithm) {
-      this._storeHashAlgorithm = options.storeHashAlgorithm;
-    }
-    this._store = Array.from(
-      { length: this._storeHashSize },
-      () => /* @__PURE__ */ new Map()
-    );
-    this.startIntervalCheck();
-  }
-  /**
-   * Gets the time-to-live
-   * @returns {number|string|undefined} - The time-to-live in miliseconds or a human-readable format. If undefined, it will not have a time-to-live.
-   */
-  get ttl() {
-    return this._ttl;
-  }
-  /**
-   * Sets the time-to-live
-   * @param {number|string|undefined} value - The time-to-live in miliseconds or a human-readable format (example '1s' = 1 second, '1h' = 1 hour). If undefined, it will not have a time-to-live.
-   */
-  set ttl(value) {
-    this.setTtl(value);
-  }
-  /**
-   * Gets whether to use clone
-   * @returns {boolean} - If true, it will clone the value before returning it. If false, it will return the value directly. Default is true.
-   */
-  get useClone() {
-    return this._useClone;
-  }
-  /**
-   * Sets whether to use clone
-   * @param {boolean} value - If true, it will clone the value before returning it. If false, it will return the value directly. Default is true.
-   */
-  set useClone(value) {
-    this._useClone = value;
-  }
-  /**
-   * Gets the size of the LRU cache
-   * @returns {number} - The size of the LRU cache. If set to 0, it will not use LRU cache. Default is 0. If you are using LRU then the limit is based on Map() size 17mm.
-   */
-  get lruSize() {
-    return this._lruSize;
-  }
-  /**
-   * Sets the size of the LRU cache
-   * @param {number} value - The size of the LRU cache. If set to 0, it will not use LRU cache. Default is 0. If you are using LRU then the limit is based on Map() size 17mm.
-   */
-  set lruSize(value) {
-    if (value > maximumMapSize) {
-      this.emit(
-        "error",
-        new Error(
-          `LRU size cannot be larger than ${maximumMapSize} due to Map limitations.`
-        )
-      );
-      return;
-    }
-    this._lruSize = value;
-    if (this._lruSize === 0) {
-      this._lru = new DoublyLinkedList();
-      return;
-    }
-    this.lruResize();
-  }
-  /**
-   * Gets the check interval
-   * @returns {number} - The interval to check for expired items. If set to 0, it will not check for expired items. Default is 0.
-   */
-  get checkInterval() {
-    return this._checkInterval;
-  }
-  /**
-   * Sets the check interval
-   * @param {number} value - The interval to check for expired items. If set to 0, it will not check for expired items. Default is 0.
-   */
-  set checkInterval(value) {
-    this._checkInterval = value;
-  }
-  /**
-   * Gets the size of the cache
-   * @returns {number} - The size of the cache
-   */
-  get size() {
-    let size = 0;
-    for (const store of this._store) {
-      size += store.size;
-    }
-    return size;
-  }
-  /**
-   * Gets the number of hash stores
-   * @returns {number} - The number of hash stores
-   */
-  get storeHashSize() {
-    return this._storeHashSize;
-  }
-  /**
-   * Sets the number of hash stores. This will recreate the store and all data will be cleared
-   * @param {number} value - The number of hash stores
-   */
-  set storeHashSize(value) {
-    if (value === this._storeHashSize) {
-      return;
-    }
-    this._storeHashSize = value;
-    this._store = Array.from(
-      { length: this._storeHashSize },
-      () => /* @__PURE__ */ new Map()
-    );
-  }
-  /**
-   * Gets the store hash algorithm
-   * @returns {StoreHashAlgorithm | StoreHashAlgorithmFunction} - The store hash algorithm
-   */
-  get storeHashAlgorithm() {
-    return this._storeHashAlgorithm;
-  }
-  /**
-   * Sets the store hash algorithm. This will recreate the store and all data will be cleared
-   * @param {StoreHashAlgorithm | StoreHashAlgorithmFunction} value - The store hash algorithm
-   */
-  set storeHashAlgorithm(value) {
-    this._storeHashAlgorithm = value;
-  }
-  /**
-   * Gets the keys
-   * @returns {IterableIterator<string>} - The keys
-   */
-  get keys() {
-    const keys = [];
-    for (const store of this._store) {
-      for (const key of store.keys()) {
-        const item = store.get(key);
-        if (item && this.hasExpired(item)) {
-          store.delete(key);
-          continue;
-        }
-        keys.push(key);
-      }
-    }
-    return keys.values();
-  }
-  /**
-   * Gets the items
-   * @returns {IterableIterator<CacheableStoreItem>} - The items
-   */
-  get items() {
-    const items = [];
-    for (const store of this._store) {
-      for (const item of store.values()) {
-        if (this.hasExpired(item)) {
-          store.delete(item.key);
-          continue;
-        }
-        items.push(item);
-      }
-    }
-    return items.values();
-  }
-  /**
-   * Gets the store
-   * @returns {Array<Map<string, CacheableStoreItem>>} - The store
-   */
-  get store() {
-    return this._store;
-  }
-  /**
-   * Gets the value of the key
-   * @param {string} key - The key to get the value
-   * @returns {T | undefined} - The value of the key
-   */
-  get(key) {
-    const store = this.getStore(key);
-    const item = store.get(key);
-    if (!item) {
-      return void 0;
-    }
-    if (item.expires && Date.now() > item.expires) {
-      store.delete(key);
-      return void 0;
-    }
-    this.lruMoveToFront(key);
-    if (!this._useClone) {
-      return item.value;
-    }
-    return this.clone(item.value);
-  }
-  /**
-   * Gets the values of the keys
-   * @param {string[]} keys - The keys to get the values
-   * @returns {T[]} - The values of the keys
-   */
-  getMany(keys) {
-    const result = [];
-    for (const key of keys) {
-      result.push(this.get(key));
-    }
-    return result;
-  }
-  /**
-   * Gets the raw value of the key
-   * @param {string} key - The key to get the value
-   * @returns {CacheableStoreItem | undefined} - The raw value of the key
-   */
-  getRaw(key) {
-    const store = this.getStore(key);
-    const item = store.get(key);
-    if (!item) {
-      return void 0;
-    }
-    if (item.expires && item.expires && Date.now() > item.expires) {
-      store.delete(key);
-      return void 0;
-    }
-    this.lruMoveToFront(key);
-    return item;
-  }
-  /**
-   * Gets the raw values of the keys
-   * @param {string[]} keys - The keys to get the values
-   * @returns {CacheableStoreItem[]} - The raw values of the keys
-   */
-  getManyRaw(keys) {
-    const result = [];
-    for (const key of keys) {
-      result.push(this.getRaw(key));
-    }
-    return result;
-  }
-  /**
-   * Sets the value of the key
-   * @param {string} key - The key to set the value
-   * @param {any} value - The value to set
-   * @param {number|string|SetOptions} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
-   * If you want to set expire directly you can do that by setting the expire property in the SetOptions.
-   * If you set undefined, it will use the default time-to-live. If both are undefined then it will not have a time-to-live.
-   * @returns {void}
-   */
-  set(key, value, ttl) {
-    const store = this.getStore(key);
-    let expires;
-    if (ttl !== void 0 || this._ttl !== void 0) {
-      if (typeof ttl === "object") {
-        if (ttl.expire) {
-          expires = typeof ttl.expire === "number" ? ttl.expire : ttl.expire.getTime();
-        }
-        if (ttl.ttl) {
-          const finalTtl = shorthandToTime(ttl.ttl);
-          if (finalTtl !== void 0) {
-            expires = finalTtl;
-          }
-        }
-      } else {
-        const finalTtl = shorthandToTime(ttl ?? this._ttl);
-        if (finalTtl !== void 0) {
-          expires = finalTtl;
-        }
-      }
-    }
-    if (this._lruSize > 0) {
-      if (store.has(key)) {
-        this.lruMoveToFront(key);
-      } else {
-        this.lruAddToFront(key);
-        if (this._lru.size > this._lruSize) {
-          const oldestKey = this._lru.getOldest();
-          if (oldestKey) {
-            this._lru.removeOldest();
-            this.delete(oldestKey);
-          }
-        }
-      }
-    }
-    const item = { key, value, expires };
-    store.set(key, item);
-  }
-  /**
-   * Sets the values of the keys
-   * @param {CacheableItem[]} items - The items to set
-   * @returns {void}
-   */
-  setMany(items) {
-    for (const item of items) {
-      this.set(item.key, item.value, item.ttl);
-    }
-  }
-  /**
-   * Checks if the key exists
-   * @param {string} key - The key to check
-   * @returns {boolean} - If true, the key exists. If false, the key does not exist.
-   */
-  has(key) {
-    const item = this.get(key);
-    return Boolean(item);
-  }
-  /**
-   * @function hasMany
-   * @param {string[]} keys - The keys to check
-   * @returns {boolean[]} - If true, the key exists. If false, the key does not exist.
-   */
-  hasMany(keys) {
-    const result = [];
-    for (const key of keys) {
-      const item = this.get(key);
-      result.push(Boolean(item));
-    }
-    return result;
-  }
-  /**
-   * Take will get the key and delete the entry from cache
-   * @param {string} key - The key to take
-   * @returns {T | undefined} - The value of the key
-   */
-  take(key) {
-    const item = this.get(key);
-    if (!item) {
-      return void 0;
-    }
-    this.delete(key);
-    return item;
-  }
-  /**
-   * TakeMany will get the keys and delete the entries from cache
-   * @param {string[]} keys - The keys to take
-   * @returns {T[]} - The values of the keys
-   */
-  takeMany(keys) {
-    const result = [];
-    for (const key of keys) {
-      result.push(this.take(key));
-    }
-    return result;
-  }
-  /**
-   * Delete the key
-   * @param {string} key - The key to delete
-   * @returns {void}
-   */
-  delete(key) {
-    const store = this.getStore(key);
-    store.delete(key);
-  }
-  /**
-   * Delete the keys
-   * @param {string[]} keys - The keys to delete
-   * @returns {void}
-   */
-  deleteMany(keys) {
-    for (const key of keys) {
-      this.delete(key);
-    }
-  }
-  /**
-   * Clear the cache
-   * @returns {void}
-   */
-  clear() {
-    this._store = Array.from(
-      { length: this._storeHashSize },
-      () => /* @__PURE__ */ new Map()
-    );
-    this._lru = new DoublyLinkedList();
-  }
-  /**
-   * Get the store based on the key (internal use)
-   * @param {string} key - The key to get the store
-   * @returns {CacheableHashStore} - The store
-   */
-  getStore(key) {
-    const hash2 = this.getKeyStoreHash(key);
-    this._store[hash2] ||= /* @__PURE__ */ new Map();
-    return this._store[hash2];
-  }
-  /**
-   * Hash the key for which store to go to (internal use)
-   * @param {string} key - The key to hash
-   * Available algorithms are: SHA256, SHA1, MD5, and djb2Hash.
-   * @returns {number} - The hashed key as a number
-   */
-  getKeyStoreHash(key) {
-    if (this._store.length === 1) {
-      return 0;
-    }
-    if (this._storeHashAlgorithm === "djb2Hash" /* djb2Hash */) {
-      return djb2Hash(key, 0, this._storeHashSize);
-    }
-    if (typeof this._storeHashAlgorithm === "function") {
-      return this._storeHashAlgorithm(key, this._storeHashSize);
-    }
-    return hashToNumber(key, 0, this._storeHashSize, this._storeHashAlgorithm);
-  }
-  /**
-   * Clone the value. This is for internal use
-   * @param {any} value - The value to clone
-   * @returns {any} - The cloned value
-   */
-  clone(value) {
-    if (this.isPrimitive(value)) {
-      return value;
-    }
-    return structuredClone(value);
-  }
-  /**
-   * Add to the front of the LRU cache. This is for internal use
-   * @param {string} key - The key to add to the front
-   * @returns {void}
-   */
-  lruAddToFront(key) {
-    if (this._lruSize === 0) {
-      return;
-    }
-    this._lru.addToFront(key);
-  }
-  /**
-   * Move to the front of the LRU cache. This is for internal use
-   * @param {string} key - The key to move to the front
-   * @returns {void}
-   */
-  lruMoveToFront(key) {
-    if (this._lruSize === 0) {
-      return;
-    }
-    this._lru.moveToFront(key);
-  }
-  /**
-   * Resize the LRU cache. This is for internal use.
-   * @returns {void}
-   */
-  lruResize() {
-    while (this._lru.size > this._lruSize) {
-      const oldestKey = this._lru.getOldest();
-      if (oldestKey) {
-        this._lru.removeOldest();
-        this.delete(oldestKey);
-      }
-    }
-  }
-  /**
-   * Check for expiration. This is for internal use
-   * @returns {void}
-   */
-  checkExpiration() {
-    for (const store of this._store) {
-      for (const item of store.values()) {
-        if (item.expires && Date.now() > item.expires) {
-          store.delete(item.key);
-        }
-      }
-    }
-  }
-  /**
-   * Start the interval check. This is for internal use
-   * @returns {void}
-   */
-  startIntervalCheck() {
-    if (this._checkInterval > 0) {
-      if (this._interval) {
-        clearInterval(this._interval);
-      }
-      this._interval = setInterval(() => {
-        this.checkExpiration();
-      }, this._checkInterval).unref();
-    }
-  }
-  /**
-   * Stop the interval check. This is for internal use
-   * @returns {void}
-   */
-  stopIntervalCheck() {
-    if (this._interval) {
-      clearInterval(this._interval);
-    }
-    this._interval = 0;
-    this._checkInterval = 0;
-  }
-  /**
-   * Wrap the function for caching
-   * @param {Function} function_ - The function to wrap
-   * @param {Object} [options] - The options to wrap
-   * @returns {Function} - The wrapped function
-   */
-  wrap(function_, options) {
-    const wrapOptions = {
-      ttl: options?.ttl ?? this._ttl,
-      keyPrefix: options?.keyPrefix,
-      cache: this
-    };
-    return wrapSync(function_, wrapOptions);
-  }
-  isPrimitive(value) {
-    const result = false;
-    if (value === null || value === void 0) {
-      return true;
-    }
-    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-      return true;
-    }
-    return result;
-  }
-  setTtl(ttl) {
-    if (typeof ttl === "string" || ttl === void 0) {
-      this._ttl = ttl;
-    } else if (ttl > 0) {
-      this._ttl = ttl;
-    } else {
-      this._ttl = void 0;
-    }
-  }
-  hasExpired(item) {
-    if (item.expires && Date.now() > item.expires) {
-      return true;
-    }
-    return false;
-  }
-};
-
-// src/keyv-memory.ts
-var KeyvCacheableMemory = class {
-  opts = {
-    ttl: 0,
-    useClone: true,
-    lruSize: 0,
-    checkInterval: 0
-  };
-  _defaultCache = new CacheableMemory();
-  _nCache = /* @__PURE__ */ new Map();
-  _namespace;
-  constructor(options) {
-    if (options) {
-      this.opts = options;
-      this._defaultCache = new CacheableMemory(options);
-      if (options.namespace) {
-        this._namespace = options.namespace;
-        this._nCache.set(this._namespace, new CacheableMemory(options));
-      }
-    }
-  }
-  get namespace() {
-    return this._namespace;
-  }
-  set namespace(value) {
-    this._namespace = value;
-  }
-  get store() {
-    return this.getStore(this._namespace);
-  }
-  async get(key) {
-    const result = this.getStore(this._namespace).get(key);
-    if (result) {
-      return result;
-    }
-    return void 0;
-  }
-  async getMany(keys) {
-    const result = this.getStore(this._namespace).getMany(keys);
-    return result;
-  }
-  async set(key, value, ttl) {
-    this.getStore(this._namespace).set(key, value, ttl);
-  }
-  async setMany(values) {
-    this.getStore(this._namespace).setMany(values);
-  }
-  async delete(key) {
-    this.getStore(this._namespace).delete(key);
-    return true;
-  }
-  async deleteMany(key) {
-    this.getStore(this._namespace).deleteMany(key);
-    return true;
-  }
-  async clear() {
-    this.getStore(this._namespace).clear();
-  }
-  async has(key) {
-    return this.getStore(this._namespace).has(key);
-  }
-  on(event, listener) {
-    this.getStore(this._namespace).on(event, listener);
-    return this;
-  }
-  getStore(namespace) {
-    if (!namespace) {
-      return this._defaultCache;
-    }
-    if (!this._nCache.has(namespace)) {
-      this._nCache.set(namespace, new CacheableMemory(this.opts));
-    }
-    return this._nCache.get(namespace);
-  }
-};
-function createKeyv(options) {
-  const store = new KeyvCacheableMemory(options);
-  const namespace = options?.namespace;
-  let ttl;
-  if (options?.ttl && Number.isInteger(options.ttl)) {
-    ttl = options?.ttl;
-  }
-  const keyv = new Keyv({ store, namespace, ttl });
-  keyv.serialize = void 0;
-  keyv.deserialize = void 0;
-  return keyv;
-}
-
-// src/stats.ts
-var CacheableStats = class {
-  _hits = 0;
-  _misses = 0;
-  _gets = 0;
-  _sets = 0;
-  _deletes = 0;
-  _clears = 0;
-  _vsize = 0;
-  _ksize = 0;
-  _count = 0;
-  _enabled = false;
-  constructor(options) {
-    if (options?.enabled) {
-      this._enabled = options.enabled;
-    }
-  }
-  /**
-   * @returns {boolean} - Whether the stats are enabled
-   */
-  get enabled() {
-    return this._enabled;
-  }
-  /**
-   * @param {boolean} enabled - Whether to enable the stats
-   */
-  set enabled(enabled) {
-    this._enabled = enabled;
-  }
-  /**
-   * @returns {number} - The number of hits
-   * @readonly
-   */
-  get hits() {
-    return this._hits;
-  }
-  /**
-   * @returns {number} - The number of misses
-   * @readonly
-   */
-  get misses() {
-    return this._misses;
-  }
-  /**
-   * @returns {number} - The number of gets
-   * @readonly
-   */
-  get gets() {
-    return this._gets;
-  }
-  /**
-   * @returns {number} - The number of sets
-   * @readonly
-   */
-  get sets() {
-    return this._sets;
-  }
-  /**
-   * @returns {number} - The number of deletes
-   * @readonly
-   */
-  get deletes() {
-    return this._deletes;
-  }
-  /**
-   * @returns {number} - The number of clears
-   * @readonly
-   */
-  get clears() {
-    return this._clears;
-  }
-  /**
-   * @returns {number} - The vsize (value size) of the cache instance
-   * @readonly
-   */
-  get vsize() {
-    return this._vsize;
-  }
-  /**
-   * @returns {number} - The ksize (key size) of the cache instance
-   * @readonly
-   */
-  get ksize() {
-    return this._ksize;
-  }
-  /**
-   * @returns {number} - The count of the cache instance
-   * @readonly
-   */
-  get count() {
-    return this._count;
-  }
-  incrementHits() {
-    if (!this._enabled) {
-      return;
-    }
-    this._hits++;
-  }
-  incrementMisses() {
-    if (!this._enabled) {
-      return;
-    }
-    this._misses++;
-  }
-  incrementGets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._gets++;
-  }
-  incrementSets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._sets++;
-  }
-  incrementDeletes() {
-    if (!this._enabled) {
-      return;
-    }
-    this._deletes++;
-  }
-  incrementClears() {
-    if (!this._enabled) {
-      return;
-    }
-    this._clears++;
-  }
-  incrementVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize += this.roughSizeOfObject(value);
-  }
-  decreaseVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize -= this.roughSizeOfObject(value);
-  }
-  incrementKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize += this.roughSizeOfString(key);
-  }
-  decreaseKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize -= this.roughSizeOfString(key);
-  }
-  incrementCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count++;
-  }
-  decreaseCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count--;
-  }
-  setCount(count) {
-    if (!this._enabled) {
-      return;
-    }
-    this._count = count;
-  }
-  roughSizeOfString(value) {
-    return value.length * 2;
-  }
-  roughSizeOfObject(object) {
-    const objectList = [];
-    const stack = [object];
-    let bytes = 0;
-    while (stack.length > 0) {
-      const value = stack.pop();
-      if (typeof value === "boolean") {
-        bytes += 4;
-      } else if (typeof value === "string") {
-        bytes += value.length * 2;
-      } else if (typeof value === "number") {
-        bytes += 8;
-      } else if (typeof value === "object" && value !== null && !objectList.includes(value)) {
-        objectList.push(value);
-        for (const key in value) {
-          bytes += key.length * 2;
-          stack.push(value[key]);
-        }
-      }
-    }
-    return bytes;
-  }
-  reset() {
-    this._hits = 0;
-    this._misses = 0;
-    this._gets = 0;
-    this._sets = 0;
-    this._deletes = 0;
-    this._clears = 0;
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-  resetStoreValues() {
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-};
-
-// src/ttl.ts
-function getTtlFromExpires(expires) {
-  if (expires === void 0 || expires === null) {
-    return void 0;
-  }
-  const now = Date.now();
-  if (expires < now) {
-    return void 0;
-  }
-  return expires - now;
-}
-function getCascadingTtl(cacheableTtl, primaryTtl, secondaryTtl) {
-  return secondaryTtl ?? primaryTtl ?? shorthandToMilliseconds(cacheableTtl);
-}
-function calculateTtlFromExpiration(ttl, expires) {
-  const ttlFromExpires = getTtlFromExpires(expires);
-  const expiresFromTtl = ttl ? Date.now() + ttl : void 0;
-  if (ttlFromExpires === void 0) {
-    return ttl;
-  }
-  if (expiresFromTtl === void 0) {
-    return ttlFromExpires;
-  }
-  if (expires > expiresFromTtl) {
-    return ttl;
-  }
-  return ttlFromExpires;
-}
+import {
+  getOrSet,
+  wrap
+} from "@cacheable/memoize";
+import { createKeyv } from "@cacheable/memory";
+import {
+  Stats as CacheableStats,
+  calculateTtlFromExpiration,
+  getCascadingTtl,
+  HashAlgorithm,
+  hash,
+  shorthandToMilliseconds
+} from "@cacheable/utils";
+import { Hookified } from "hookified";
+import {
+  Keyv
+} from "keyv";
 
-// src/index.ts
-import { Keyv as Keyv3, KeyvHooks } from "keyv";
+// src/enums.ts
 var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
   CacheableHooks2["BEFORE_SET"] = "BEFORE_SET";
   CacheableHooks2["AFTER_SET"] = "AFTER_SET";
@@ -1217,9 +32,33 @@ var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
 })(CacheableHooks || {});
 var CacheableEvents = /* @__PURE__ */ ((CacheableEvents2) => {
   CacheableEvents2["ERROR"] = "error";
+  CacheableEvents2["CACHE_HIT"] = "cache:hit";
+  CacheableEvents2["CACHE_MISS"] = "cache:miss";
   return CacheableEvents2;
 })(CacheableEvents || {});
-var Cacheable = class extends Hookified2 {
+
+// src/index.ts
+import {
+  getOrSet as getOrSet2,
+  wrap as wrap2,
+  wrapSync
+} from "@cacheable/memoize";
+import {
+  CacheableMemory,
+  createKeyv as createKeyv2,
+  KeyvCacheableMemory
+} from "@cacheable/memory";
+import {
+  calculateTtlFromExpiration as calculateTtlFromExpiration2,
+  getCascadingTtl as getCascadingTtl2,
+  HashAlgorithm as HashAlgorithm2,
+  hash as hash2,
+  Stats,
+  shorthandToMilliseconds as shorthandToMilliseconds2,
+  shorthandToTime
+} from "@cacheable/utils";
+import { Keyv as Keyv2, KeyvHooks } from "keyv";
+var Cacheable = class extends Hookified {
   _primary = createKeyv();
   _secondary;
   _nonBlocking = false;
@@ -1402,7 +241,7 @@ var Cacheable = class extends Hookified2 {
     if (this.isKeyvInstance(primary)) {
       this._primary = primary;
     } else {
-      this._primary = new Keyv2(primary);
+      this._primary = new Keyv(primary);
     }
     this._primary.on("error", (error) => {
       this.emit("error" /* ERROR */, error);
@@ -1417,7 +256,7 @@ var Cacheable = class extends Hookified2 {
     if (this.isKeyvInstance(secondary)) {
       this._secondary = secondary;
     } else {
-      this._secondary = new Keyv2(secondary);
+      this._secondary = new Keyv(secondary);
     }
     this._secondary.on("error", (error) => {
       this.emit("error" /* ERROR */, error);
@@ -1425,7 +264,7 @@ var Cacheable = class extends Hookified2 {
   }
   // biome-ignore lint/suspicious/noExplicitAny: type format
   isKeyvInstance(keyv) {
-    if (keyv instanceof Keyv2) {
+    if (keyv instanceof Keyv) {
       return true;
     }
     const keyvMethods = [
@@ -1451,26 +290,68 @@ var Cacheable = class extends Hookified2 {
     }
     return this._namespace;
   }
-  async get(key, options = {}) {
+  /**
+   * Retrieves an entry from the cache.
+   *
+   * Checks the primary store first; if not found and a secondary store is configured,
+   * it will fetch from the secondary, repopulate the primary, and return the result.
+   *
+   * @typeParam T - The expected type of the stored value.
+   * @param {string} key - The cache key to retrieve.
+   * @param {GetOptions} - options such as to bypass `nonBlocking` for this call
+   * @returns {Promise<T | undefined>}
+   *   A promise that resolves to the cached value if found, or `undefined`.
+   */
+  async get(key, options) {
+    const result = await this.getRaw(key, options);
+    return result?.value;
+  }
+  /**
+   * Retrieves the raw entry from the cache including metadata like expiration.
+   *
+   * Checks the primary store first; if not found and a secondary store is configured,
+   * it will fetch from the secondary, repopulate the primary, and return the result.
+   *
+   * @typeParam T - The expected type of the stored value.
+   * @param {string} key - The cache key to retrieve.
+   * @param {GetOptions} - options such as to bypass `nonBlocking` for this call
+   * @returns {Promise<StoredDataRaw<T>>}
+   *   A promise that resolves to the full raw data object if found, or undefined.
+   */
+  async getRaw(key, options) {
     let result;
-    const { raw = false } = options;
     try {
       await this.hook("BEFORE_GET" /* BEFORE_GET */, key);
-      result = await this._primary.get(key, { raw: true });
+      result = await this._primary.getRaw(key);
       let ttl;
+      if (result) {
+        this.emit("cache:hit" /* CACHE_HIT */, {
+          key,
+          value: result.value,
+          store: "primary"
+        });
+      } else {
+        this.emit("cache:miss" /* CACHE_MISS */, { key, store: "primary" });
+      }
+      const nonBlocking = options?.nonBlocking ?? this._nonBlocking;
       if (!result && this._secondary) {
-        const secondaryResult = await this.getSecondaryRawResults(key);
-        if (secondaryResult?.value) {
-          result = secondaryResult;
-          const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
-          const expires = secondaryResult.expires ?? void 0;
-          ttl = calculateTtlFromExpiration(cascadeTtl, expires);
-          const setItem = { key, value: result.value, ttl };
-          await this.hook(
-            "BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */,
-            setItem
+        let secondaryProcessResult;
+        if (nonBlocking) {
+          secondaryProcessResult = await this.processSecondaryForGetRawNonBlocking(
+            this._primary,
+            this._secondary,
+            key
+          );
+        } else {
+          secondaryProcessResult = await this.processSecondaryForGetRaw(
+            this._primary,
+            this._secondary,
+            key
           );
-          await this._primary.set(setItem.key, setItem.value, setItem.ttl);
+        }
+        if (secondaryProcessResult) {
+          result = secondaryProcessResult.result;
+          ttl = secondaryProcessResult.ttl;
         }
       }
       await this.hook("AFTER_GET" /* AFTER_GET */, { key, result, ttl });
@@ -1485,38 +366,52 @@ var Cacheable = class extends Hookified2 {
       }
       this.stats.incrementGets();
     }
-    return raw ? result : result?.value;
+    return result;
   }
-  async getMany(keys, options = {}) {
+  /**
+   * Retrieves multiple raw entries from the cache including metadata like expiration.
+   *
+   * Checks the primary store for each key; if a key is missing and a secondary store is configured,
+   * it will fetch from the secondary store, repopulate the primary store, and return the results.
+   *
+   * @typeParam T - The expected type of the stored values.
+   * @param {string[]} keys - The cache keys to retrieve.
+   * @param {GetOptions} - options such as to bypass `nonBlocking` on this call
+   * @returns {Promise<Array<StoredDataRaw<T>>>}
+   *   A promise that resolves to an array of raw data objects.
+   */
+  async getManyRaw(keys, options) {
     let result = [];
-    const { raw = false } = options;
     try {
       await this.hook("BEFORE_GET_MANY" /* BEFORE_GET_MANY */, keys);
-      result = await this._primary.get(keys, { raw: true });
-      if (this._secondary) {
-        const missingKeys = [];
-        for (const [i, key] of keys.entries()) {
-          if (!result[i]) {
-            missingKeys.push(key);
-          }
+      result = await this._primary.getManyRaw(keys);
+      for (const [i, key] of keys.entries()) {
+        if (result[i]) {
+          this.emit("cache:hit" /* CACHE_HIT */, {
+            key,
+            value: result[i].value,
+            store: "primary"
+          });
+        } else {
+          this.emit("cache:miss" /* CACHE_MISS */, { key, store: "primary" });
         }
-        const secondaryResults = await this.getManySecondaryRawResults(missingKeys);
-        for await (const [i, key] of keys.entries()) {
-          if (!result[i] && secondaryResults[i]) {
-            result[i] = secondaryResults[i];
-            const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
-            let { expires } = secondaryResults[i];
-            if (expires === null) {
-              expires = void 0;
-            }
-            const ttl = calculateTtlFromExpiration(cascadeTtl, expires);
-            const setItem = { key, value: result[i].value, ttl };
-            await this.hook(
-              "BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */,
-              setItem
-            );
-            await this._primary.set(setItem.key, setItem.value, setItem.ttl);
-          }
+      }
+      const nonBlocking = options?.nonBlocking ?? this._nonBlocking;
+      if (this._secondary) {
+        if (nonBlocking) {
+          await this.processSecondaryForGetManyRawNonBlocking(
+            this._primary,
+            this._secondary,
+            keys,
+            result
+          );
+        } else {
+          await this.processSecondaryForGetManyRaw(
+            this._primary,
+            this._secondary,
+            keys,
+            result
+          );
         }
       }
       await this.hook("AFTER_GET_MANY" /* AFTER_GET_MANY */, { keys, result });
@@ -1533,7 +428,22 @@ var Cacheable = class extends Hookified2 {
       }
       this.stats.incrementGets();
     }
-    return raw ? result : result.map((item) => item?.value);
+    return result;
+  }
+  /**
+   * Retrieves multiple entries from the cache.
+   * Checks the primary store for each key; if a key is missing and a secondary store is configured,
+   * it will fetch from the secondary store, repopulate the primary store, and return the results.
+   *
+   * @typeParam T - The expected type of the stored values.
+   * @param {string[]} keys - The cache keys to retrieve.
+   * @param {GetOptions} - options such as to bypass `nonBlocking` on this call
+   * @returns {Promise<Array<T | undefined>>}
+   *   A promise that resolves to an array of cached values or `undefined` for misses.
+   */
+  async getMany(keys, options) {
+    const result = await this.getManyRaw(keys, options);
+    return result.map((item) => item?.value);
   }
   /**
    * Sets the value of the key. If the secondary store is set then it will also set the value in the secondary store.
@@ -1556,6 +466,11 @@ var Cacheable = class extends Hookified2 {
       }
       if (this._nonBlocking) {
         result = await Promise.race(promises);
+        for (const promise of promises) {
+          promise.catch((error) => {
+            this.emit("error" /* ERROR */, error);
+          });
+        }
       } else {
         const results = await Promise.all(promises);
         result = results[0];
@@ -1584,7 +499,9 @@ var Cacheable = class extends Hookified2 {
       result = await this.setManyKeyv(this._primary, items);
       if (this._secondary) {
         if (this._nonBlocking) {
-          this.setManyKeyv(this._secondary, items);
+          this.setManyKeyv(this._secondary, items).catch((error) => {
+            this.emit("error" /* ERROR */, error);
+          });
         } else {
           await this.setManyKeyv(this._secondary, items);
         }
@@ -1687,6 +604,11 @@ var Cacheable = class extends Hookified2 {
     }
     if (this.nonBlocking) {
       result = await Promise.race(promises);
+      for (const promise of promises) {
+        promise.catch((error) => {
+          this.emit("error" /* ERROR */, error);
+        });
+      }
     } else {
       const resultAll = await Promise.all(promises);
       result = resultAll[0];
@@ -1708,12 +630,14 @@ var Cacheable = class extends Hookified2 {
         this.stats.incrementDeletes();
       }
     }
-    const result = await this.deleteManyKeyv(this._primary, keys);
+    const result = await this._primary.deleteMany(keys);
     if (this._secondary) {
       if (this._nonBlocking) {
-        this.deleteManyKeyv(this._secondary, keys);
+        this._secondary.deleteMany(keys).catch((error) => {
+          this.emit("error" /* ERROR */, error);
+        });
       } else {
-        await this.deleteManyKeyv(this._secondary, keys);
+        await this._secondary.deleteMany(keys);
       }
     }
     return result;
@@ -1756,11 +680,30 @@ var Cacheable = class extends Hookified2 {
    */
   // biome-ignore lint/suspicious/noExplicitAny: type format
   wrap(function_, options) {
+    const cacheAdapter = {
+      get: async (key) => this.get(key),
+      has: async (key) => this.has(key),
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance requires any type
+      set: async (key, value, ttl) => {
+        await this.set(key, value, ttl);
+      },
+      /* c8 ignore start */
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance interface
+      on: (event, listener) => {
+        this.on(event, listener);
+      },
+      /* c8 ignore stop */
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance requires any type
+      emit: (event, ...args) => this.emit(event, ...args)
+    };
     const wrapOptions = {
       ttl: options?.ttl ?? this._ttl,
       keyPrefix: options?.keyPrefix,
-      cache: this,
-      cacheId: this._cacheId
+      createKey: options?.createKey,
+      cacheErrors: options?.cacheErrors,
+      cache: cacheAdapter,
+      cacheId: this._cacheId,
+      serialize: options?.serialize
     };
     return wrap(function_, wrapOptions);
   }
@@ -1775,8 +718,24 @@ var Cacheable = class extends Hookified2 {
    * @return {Promise<T | undefined>} - A promise that resolves to the cached or newly computed value, or undefined if an error occurs and caching is not configured for errors.
    */
   async getOrSet(key, function_, options) {
+    const cacheAdapter = {
+      get: async (key2) => this.get(key2),
+      has: async (key2) => this.has(key2),
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance requires any type
+      set: async (key2, value, ttl) => {
+        await this.set(key2, value, ttl);
+      },
+      /* c8 ignore start */
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance interface
+      on: (event, listener) => {
+        this.on(event, listener);
+      },
+      /* c8 ignore stop */
+      // biome-ignore lint/suspicious/noExplicitAny: CacheInstance requires any type
+      emit: (event, ...args) => this.emit(event, ...args)
+    };
     const getOrSetOptions = {
-      cache: this,
+      cache: cacheAdapter,
       cacheId: this._cacheId,
       ttl: options?.ttl ?? this._ttl,
       cacheErrors: options?.cacheErrors,
@@ -1790,39 +749,17 @@ var Cacheable = class extends Hookified2 {
    * @param {string} algorithm the hash algorithm to use. The default is 'sha256'
    * @returns {string} the hash of the object
    */
-  // biome-ignore lint/suspicious/noExplicitAny: type format
-  hash(object, algorithm = "sha256") {
-    return hash(object, algorithm);
-  }
-  async getSecondaryRawResults(key) {
-    let result;
-    if (this._secondary) {
-      result = await this._secondary.get(key, { raw: true });
-    }
-    return result;
-  }
-  async getManySecondaryRawResults(keys) {
-    let result = [];
-    if (this._secondary) {
-      result = await this._secondary.get(keys, { raw: true });
-    }
-    return result;
-  }
-  async deleteManyKeyv(keyv, keys) {
-    const promises = [];
-    for (const key of keys) {
-      promises.push(keyv.delete(key));
-    }
-    await Promise.all(promises);
-    return true;
+  hash(object, algorithm = HashAlgorithm.SHA256) {
+    const validAlgorithm = Object.values(HashAlgorithm).includes(algorithm) ? algorithm : HashAlgorithm.SHA256;
+    return hash(object, { algorithm: validAlgorithm });
   }
   async setManyKeyv(keyv, items) {
-    const promises = [];
+    const entries = [];
     for (const item of items) {
       const finalTtl = shorthandToMilliseconds(item.ttl ?? this._ttl);
-      promises.push(keyv.set(item.key, item.value, finalTtl));
+      entries.push({ key: item.key, value: item.value, ttl: finalTtl });
     }
-    await Promise.all(promises);
+    await keyv.setMany(entries);
     return true;
   }
   async hasManyKeyv(keyv, keys) {
@@ -1832,6 +769,162 @@ var Cacheable = class extends Hookified2 {
     }
     return Promise.all(promises);
   }
+  /**
+   * Processes a single key from secondary store for getRaw operation
+   * @param primary - the primary store to use
+   * @param secondary - the secondary store to use
+   * @param key - The key to retrieve from secondary store
+   * @returns Promise containing the result and TTL information
+   */
+  async processSecondaryForGetRaw(primary, secondary, key) {
+    const secondaryResult = await secondary.getRaw(key);
+    if (secondaryResult?.value) {
+      this.emit("cache:hit" /* CACHE_HIT */, {
+        key,
+        value: secondaryResult.value,
+        store: "secondary"
+      });
+      const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
+      const expires = secondaryResult.expires ?? void 0;
+      const ttl = calculateTtlFromExpiration(cascadeTtl, expires);
+      const setItem = { key, value: secondaryResult.value, ttl };
+      await this.hook("BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */, setItem);
+      await primary.set(setItem.key, setItem.value, setItem.ttl);
+      return { result: secondaryResult, ttl };
+    } else {
+      this.emit("cache:miss" /* CACHE_MISS */, { key, store: "secondary" });
+      return void 0;
+    }
+  }
+  /**
+   * Processes a single key from secondary store for getRaw operation in non-blocking mode
+   * Non-blocking mode means we don't wait for secondary operations that update primary store
+   * @param primary - the primary store to use
+   * @param secondary - the secondary store to use
+   * @param key - The key to retrieve from secondary store
+   * @returns Promise containing the result and TTL information
+   */
+  async processSecondaryForGetRawNonBlocking(primary, secondary, key) {
+    const secondaryResult = await secondary.getRaw(key);
+    if (secondaryResult?.value) {
+      this.emit("cache:hit" /* CACHE_HIT */, {
+        key,
+        value: secondaryResult.value,
+        store: "secondary"
+      });
+      const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
+      const expires = secondaryResult.expires ?? void 0;
+      const ttl = calculateTtlFromExpiration(cascadeTtl, expires);
+      const setItem = { key, value: secondaryResult.value, ttl };
+      this.hook("BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */, setItem).then(async () => {
+        await primary.set(setItem.key, setItem.value, setItem.ttl);
+      }).catch((error) => {
+        this.emit("error" /* ERROR */, error);
+      });
+      return { result: secondaryResult, ttl };
+    } else {
+      this.emit("cache:miss" /* CACHE_MISS */, { key, store: "secondary" });
+      return void 0;
+    }
+  }
+  /**
+   * Processes missing keys from secondary store for getManyRaw operation
+   * @param primary - the primary store to use
+   * @param secondary - the secondary store to use
+   * @param keys - The original array of keys requested
+   * @param result - The result array from primary store (will be modified)
+   * @returns Promise<void>
+   */
+  async processSecondaryForGetManyRaw(primary, secondary, keys, result) {
+    const missingKeys = [];
+    for (const [i, key] of keys.entries()) {
+      if (!result[i]) {
+        missingKeys.push(key);
+      }
+    }
+    const secondaryResults = await secondary.getManyRaw(missingKeys);
+    let secondaryIndex = 0;
+    for await (const [i, key] of keys.entries()) {
+      if (!result[i]) {
+        const secondaryResult = secondaryResults[secondaryIndex];
+        if (secondaryResult && secondaryResult.value !== void 0) {
+          result[i] = secondaryResult;
+          this.emit("cache:hit" /* CACHE_HIT */, {
+            key,
+            value: secondaryResult.value,
+            store: "secondary"
+          });
+          const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
+          let { expires } = secondaryResult;
+          if (expires === null) {
+            expires = void 0;
+          }
+          const ttl = calculateTtlFromExpiration(cascadeTtl, expires);
+          const setItem = { key, value: secondaryResult.value, ttl };
+          await this.hook(
+            "BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */,
+            setItem
+          );
+          await primary.set(setItem.key, setItem.value, setItem.ttl);
+        } else {
+          this.emit("cache:miss" /* CACHE_MISS */, {
+            key,
+            store: "secondary"
+          });
+        }
+        secondaryIndex++;
+      }
+    }
+  }
+  /**
+   * Processes missing keys from secondary store for getManyRaw operation in non-blocking mode
+   * Non-blocking mode means we don't wait for secondary operations that update primary store
+   * @param secondary - the secondary store to use
+   * @param keys - The original array of keys requested
+   * @param result - The result array from primary store (will be modified)
+   * @returns Promise<void>
+   */
+  async processSecondaryForGetManyRawNonBlocking(primary, secondary, keys, result) {
+    const missingKeys = [];
+    for (const [i, key] of keys.entries()) {
+      if (!result[i]) {
+        missingKeys.push(key);
+      }
+    }
+    const secondaryResults = await secondary.getManyRaw(missingKeys);
+    let secondaryIndex = 0;
+    for await (const [i, key] of keys.entries()) {
+      if (!result[i]) {
+        const secondaryResult = secondaryResults[secondaryIndex];
+        if (secondaryResult && secondaryResult.value !== void 0) {
+          result[i] = secondaryResult;
+          this.emit("cache:hit" /* CACHE_HIT */, {
+            key,
+            value: secondaryResult.value,
+            store: "secondary"
+          });
+          const cascadeTtl = getCascadingTtl(this._ttl, this._primary.ttl);
+          let { expires } = secondaryResult;
+          if (expires === null) {
+            expires = void 0;
+          }
+          const ttl = calculateTtlFromExpiration(cascadeTtl, expires);
+          const setItem = { key, value: secondaryResult.value, ttl };
+          this.hook("BEFORE_SECONDARY_SETS_PRIMARY" /* BEFORE_SECONDARY_SETS_PRIMARY */, setItem).then(async () => {
+            await primary.set(setItem.key, setItem.value, setItem.ttl);
+          }).catch((error) => {
+            this.emit("error" /* ERROR */, error);
+          });
+        } else {
+          this.emit("cache:miss" /* CACHE_MISS */, {
+            key,
+            store: "secondary"
+          });
+        }
+        secondaryIndex++;
+      }
+    }
+  }
   setTtl(ttl) {
     if (typeof ttl === "string" || ttl === void 0) {
       this._ttl = ttl;
@@ -1847,14 +940,18 @@ export {
   CacheableEvents,
   CacheableHooks,
   CacheableMemory,
-  CacheableStats,
-  Keyv3 as Keyv,
+  Stats as CacheableStats,
+  HashAlgorithm2 as HashAlgorithm,
+  Keyv2 as Keyv,
   KeyvCacheableMemory,
   KeyvHooks,
-  createKeyv,
-  getOrSet,
-  shorthandToMilliseconds,
+  calculateTtlFromExpiration2 as calculateTtlFromExpiration,
+  createKeyv2 as createKeyv,
+  getCascadingTtl2 as getCascadingTtl,
+  getOrSet2 as getOrSet,
+  hash2 as hash,
+  shorthandToMilliseconds2 as shorthandToMilliseconds,
   shorthandToTime,
-  wrap,
+  wrap2 as wrap,
   wrapSync
 };