@ztimson/utils 0.25.12 → 0.25.13

package/dist/cache.d.ts

@@ -69,6 +69,13 @@ export declare class Cache<K extends string | number | symbol, T> {
      * @param {K} key Key to expire
      */
     expire(key: K): this;
+    /**
+     * Find the first cached item to match a filter
+     * @param {Partial<T>} filter Partial item to match
+     * @param {Boolean} expired Include expired items, defaults to false
+     * @returns {T | undefined} Cached item or undefined if nothing matched
+     */
+    find(filter: Partial<T>, expired?: boolean): T | undefined;
     /**
      * Get item from the cache
      * @param {K} key Key to lookup

package/dist/index.cjs

@@ -648,6 +648,15 @@ ${opts.message || this.desc}`;
       } else this.delete(key);
       return this;
     }
+    /**
+     * Find the first cached item to match a filter
+     * @param {Partial<T>} filter Partial item to match
+     * @param {Boolean} expired Include expired items, defaults to false
+     * @returns {T | undefined} Cached item or undefined if nothing matched
+     */
+    find(filter, expired) {
+      return Object.values(this.store).find((row) => (expired || !row._expired) && includes(row, filter));
+    }
     /**
      * Get item from the cache
      * @param {K} key Key to lookup