@ensnode/ensnode-sdk 1.14.0 → 1.15.1

package/dist/index.d.cts

@@ -3475,6 +3475,27 @@ declare class SWRCache<ValueType> {
      * has never successfully returned.
      */
     read(): Promise<ValueType | Error>;
+    /**
+     * Synchronously returns the most recently cached result without triggering revalidation.
+     *
+     * Unlike {@link read}, this method is synchronous and never causes any I/O — it simply
+     * returns whatever value is already in memory. Use this when you need a best-effort
+     * snapshot of the cached value and can tolerate stale data.
+     *
+     * @returns the most recently cached `ValueType`, or an `Error` if the last fetch failed.
+     * @throws if the cache has not been initialized yet (i.e. {@link read} has never been awaited
+     * and `proactivelyInitialize` was not set to `true`).
+     *
+     * @example
+     * ```ts
+     * // Ensure cache is initialized first
+     * await cache.read();
+     *
+     * // Later, peek synchronously without triggering revalidation
+     * const result = cache.peek();
+     * ```
+     */
+    peek(): ValueType | Error;
     /**
      * Destroys the background revalidation interval, if exists.
      */

package/dist/index.d.ts

@@ -3475,6 +3475,27 @@ declare class SWRCache<ValueType> {
      * has never successfully returned.
      */
     read(): Promise<ValueType | Error>;
+    /**
+     * Synchronously returns the most recently cached result without triggering revalidation.
+     *
+     * Unlike {@link read}, this method is synchronous and never causes any I/O — it simply
+     * returns whatever value is already in memory. Use this when you need a best-effort
+     * snapshot of the cached value and can tolerate stale data.
+     *
+     * @returns the most recently cached `ValueType`, or an `Error` if the last fetch failed.
+     * @throws if the cache has not been initialized yet (i.e. {@link read} has never been awaited
+     * and `proactivelyInitialize` was not set to `true`).
+     *
+     * @example
+     * ```ts
+     * // Ensure cache is initialized first
+     * await cache.read();
+     *
+     * // Later, peek synchronously without triggering revalidation
+     * const result = cache.peek();
+     * ```
+     */
+    peek(): ValueType | Error;
     /**
      * Destroys the background revalidation interval, if exists.
      */

package/dist/index.js

@@ -4440,6 +4440,30 @@ var SWRCache = class {
     }
     return this.cache.result;
   }
+  /**
+   * Synchronously returns the most recently cached result without triggering revalidation.
+   *
+   * Unlike {@link read}, this method is synchronous and never causes any I/O — it simply
+   * returns whatever value is already in memory. Use this when you need a best-effort
+   * snapshot of the cached value and can tolerate stale data.
+   *
+   * @returns the most recently cached `ValueType`, or an `Error` if the last fetch failed.
+   * @throws if the cache has not been initialized yet (i.e. {@link read} has never been awaited
+   * and `proactivelyInitialize` was not set to `true`).
+   *
+   * @example
+   * ```ts
+   * // Ensure cache is initialized first
+   * await cache.read();
+   *
+   * // Later, peek synchronously without triggering revalidation
+   * const result = cache.peek();
+   * ```
+   */
+  peek() {
+    if (!this.cache) throw new Error("Cache is not initialized yet");
+    return this.cache.result;
+  }
   /**
    * Destroys the background revalidation interval, if exists.
    */