viem 2.47.19 → 2.48.1

package/tempo/Storage.ts

@@ -0,0 +1,118 @@
+import type { MaybePromise } from '../types/utils.js'
+
+export type Storage = {
+  getItem(key: string): MaybePromise<string | null | undefined>
+  setItem(key: string, value: string): MaybePromise<void>
+  removeItem(key: string): MaybePromise<void>
+}
+
+/**
+ * Wraps a base storage with an optional key prefix and request
+ * deduplication — concurrent `getItem` calls for the same key share
+ * a single in-flight promise.
+ *
+ * @example
+ * ```ts
+ * import * as Storage from 'viem/tempo/zones'
+ *
+ * const storage = Storage.from(Storage.memory(), { key: 'tempo' })
+ * await storage.setItem('foo', 'bar')
+ * // stored under "tempo:foo"
+ * ```
+ */
+export function from(storage: Storage, options: from.Options = {}): Storage {
+  const { key } = options
+  const prefix = key ? `${key}:` : ''
+  const inflight = new Map<string, Promise<string | null | undefined>>()
+  return {
+    getItem(k) {
+      const fullKey = `${prefix}${k}`
+      const existing = inflight.get(fullKey)
+      if (existing) return existing
+      const result = Promise.resolve(storage.getItem(fullKey)).finally(() => {
+        inflight.delete(fullKey)
+      })
+      inflight.set(fullKey, result)
+      return result
+    },
+    setItem(k, value) {
+      const fullKey = `${prefix}${k}`
+      inflight.delete(fullKey)
+      return storage.setItem(fullKey, value)
+    },
+    removeItem(k) {
+      const fullKey = `${prefix}${k}`
+      inflight.delete(fullKey)
+      return storage.removeItem(fullKey)
+    },
+  }
+}
+
+export declare namespace from {
+  type Options = {
+    /** Key prefix prepended to all storage keys. */
+    key?: string | undefined
+  }
+}
+
+/** Creates an in-memory storage backed by a `Map`. */
+export function memory(options: from.Options = {}): Storage {
+  const store = new Map<string, string>()
+  return from(
+    {
+      getItem(key) {
+        return store.get(key) ?? null
+      },
+      setItem(key, value) {
+        store.set(key, value)
+      },
+      removeItem(key) {
+        store.delete(key)
+      },
+    },
+    options,
+  )
+}
+
+/** Creates a storage backed by `globalThis.sessionStorage`. */
+export function session(options: from.Options = {}): Storage {
+  return from(
+    {
+      getItem(key) {
+        return globalThis.sessionStorage.getItem(key)
+      },
+      setItem(key, value) {
+        try {
+          globalThis.sessionStorage.setItem(key, value)
+        } catch {}
+      },
+      removeItem(key) {
+        globalThis.sessionStorage.removeItem(key)
+      },
+    },
+    options,
+  )
+}
+
+let _default: Storage | undefined
+
+/**
+ * Returns the default storage for the current environment.
+ *
+ * Returns a singleton so that the zone transport and actions share the
+ * same instance without requiring explicit plumbing.
+ *
+ * - Browser: `sessionStorage`
+ * - Server/unsupported: in-memory `Map`-based storage
+ */
+export function defaultStorage(): Storage {
+  if (_default) return _default
+  if (
+    typeof globalThis !== 'undefined' &&
+    'sessionStorage' in globalThis &&
+    globalThis.sessionStorage
+  )
+    _default = session()
+  else _default = memory()
+  return _default
+}

package/tempo/actions/index.ts

@@ -10,3 +10,4 @@ export * as reward from './reward.js'
 export * as simulate from './simulate.js'
 export * as token from './token.js'
 export * as validator from './validator.js'
+export * as zone from './zone.js'