@towns-protocol/web3 0.0.452 → 0.0.455

package/dist/cache/EntitlementCache.d.ts

@@ -1,19 +1,24 @@
 import { Keyable } from './Keyable';
+import { CreateStorageFn } from './ICacheStorage';
 export interface CacheResult<V> {
     value: V;
     cacheHit: boolean;
     isPositive: boolean;
 }
-export declare class EntitlementCache<K extends Keyable, V> {
-    private readonly negativeCache;
-    private readonly positiveCache;
-    constructor(options?: {
-        positiveCacheTTLSeconds: number;
-        negativeCacheTTLSeconds: number;
-        positiveCacheSize?: number;
-        negativeCacheSize?: number;
-    });
-    invalidate(keyable: K): void;
-    executeUsingCache(keyable: K, onCacheMiss: (k: K) => Promise<CacheResult<V>>): Promise<CacheResult<V>>;
+export interface EntitlementCacheOptions<V> {
+    positiveCacheTTLSeconds?: number;
+    negativeCacheTTLSeconds?: number;
+    positiveCacheSize?: number;
+    negativeCacheSize?: number;
+    /** Factory function to create storage. Defaults to in-memory TTLCacheStorage */
+    createStorageFn: CreateStorageFn<CacheResult<V>> | undefined;
+}
+export declare class EntitlementCache<V> {
+    private readonly negativeStorage;
+    private readonly positiveStorage;
+    private readonly pendingFetches;
+    constructor(options: EntitlementCacheOptions<V>);
+    invalidate(keyable: Keyable): Promise<void>;
+    executeUsingCache(keyable: Keyable, onCacheMiss: (k: Keyable) => Promise<CacheResult<V>>): Promise<CacheResult<V>>;
 }
 //# sourceMappingURL=EntitlementCache.d.ts.map

package/dist/cache/EntitlementCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntitlementCache.d.ts","sourceRoot":"","sources":["../../src/cache/EntitlementCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACtB;AAED,qBAAa,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;gBAEpD,OAAO,CAAC,EAAE;QAClB,uBAAuB,EAAE,MAAM,CAAA;QAC/B,uBAAuB,EAAE,MAAM,CAAA;QAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC7B;IAgBD,UAAU,CAAC,OAAO,EAAE,CAAC;IAMf,iBAAiB,CACnB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuB7B"}
+{"version":3,"file":"EntitlementCache.d.ts","sourceRoot":"","sources":["../../src/cache/EntitlementCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGjD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gFAAgF;IAChF,eAAe,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;CAC/D;AAED,qBAAa,gBAAgB,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6C;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6C;IAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;gBAErE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAqBzC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,iBAAiB,CACnB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA2C7B"}

package/dist/cache/EntitlementCache.js

@@ -1,46 +1,68 @@
-import TTLCache from '@isaacs/ttlcache';
+import { createDefaultStorage } from './TTLCacheStorage';
 export class EntitlementCache {
-    negativeCache;
-    positiveCache;
+    negativeStorage;
+    positiveStorage;
+    pendingFetches = new Map();
     constructor(options) {
         const positiveCacheTTLSeconds = options?.positiveCacheTTLSeconds ?? 15 * 60;
         const negativeCacheTTLSeconds = options?.negativeCacheTTLSeconds ?? 2;
         const positiveCacheSize = options?.positiveCacheSize ?? 10000;
         const negativeCacheSize = options?.negativeCacheSize ?? 10000;
-        this.negativeCache = new TTLCache({
-            ttl: negativeCacheTTLSeconds * 1000,
-            max: negativeCacheSize,
+        const createFn = options?.createStorageFn ?? createDefaultStorage;
+        this.negativeStorage = createFn({
+            ttlMs: negativeCacheTTLSeconds * 1000,
+            maxSize: negativeCacheSize,
+            keyPostfix: 'neg',
         });
-        this.positiveCache = new TTLCache({
-            ttl: positiveCacheTTLSeconds * 1000,
-            max: positiveCacheSize,
+        this.positiveStorage = createFn({
+            ttlMs: positiveCacheTTLSeconds * 1000,
+            maxSize: positiveCacheSize,
+            keyPostfix: 'pos',
         });
     }
-    invalidate(keyable) {
+    async invalidate(keyable) {
         const key = keyable.toKey();
-        this.negativeCache.delete(key);
-        this.positiveCache.delete(key);
+        // Clear pending fetch first to prevent returning stale in-flight data
+        this.pendingFetches.delete(key);
+        await Promise.all([this.negativeStorage.delete(key), this.positiveStorage.delete(key)]);
     }
     async executeUsingCache(keyable, onCacheMiss) {
         const key = keyable.toKey();
-        const negativeCacheResult = this.negativeCache.get(key);
-        if (negativeCacheResult !== undefined) {
-            negativeCacheResult.cacheHit = true;
-            return negativeCacheResult;
+        // 1. Check for pending fetch FIRST (synchronous check before any await)
+        // This prevents race conditions where concurrent calls interleave
+        const pendingPromise = this.pendingFetches.get(key);
+        if (pendingPromise) {
+            return pendingPromise;
         }
-        const positiveCacheResult = this.positiveCache.get(key);
-        if (positiveCacheResult !== undefined) {
-            positiveCacheResult.cacheHit = true;
-            return positiveCacheResult;
+        // 2. Create promise that checks caches then fetches if needed
+        // Store it synchronously BEFORE any await to prevent races
+        const operationPromise = (async () => {
+            const negativeCacheResult = await this.negativeStorage.get(key);
+            if (negativeCacheResult !== undefined) {
+                negativeCacheResult.cacheHit = true;
+                return negativeCacheResult;
+            }
+            const positiveCacheResult = await this.positiveStorage.get(key);
+            if (positiveCacheResult !== undefined) {
+                positiveCacheResult.cacheHit = true;
+                return positiveCacheResult;
+            }
+            const result = await onCacheMiss(keyable);
+            if (result.isPositive) {
+                await this.positiveStorage.set(key, result);
+            }
+            else {
+                await this.negativeStorage.set(key, result);
+            }
+            return result;
+        })();
+        this.pendingFetches.set(key, operationPromise);
+        try {
+            return await operationPromise;
         }
-        const result = await onCacheMiss(keyable);
-        if (result.isPositive) {
-            this.positiveCache.set(key, result);
+        finally {
+            this.pendingFetches.delete(key);
         }
-        else {
-            this.negativeCache.set(key, result);
-        }
-        return result;
     }
 }
 //# sourceMappingURL=EntitlementCache.js.map

package/dist/cache/EntitlementCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntitlementCache.js","sourceRoot":"","sources":["../../src/cache/EntitlementCache.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,kBAAkB,CAAA;AASvC,MAAM,OAAO,gBAAgB;IACR,aAAa,CAAkC;IAC/C,aAAa,CAAkC;IAEhE,YAAY,OAKX;QACG,MAAM,uBAAuB,GAAG,OAAO,EAAE,uBAAuB,IAAI,EAAE,GAAG,EAAE,CAAA;QAC3E,MAAM,uBAAuB,GAAG,OAAO,EAAE,uBAAuB,IAAI,CAAC,CAAA;QACrE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,KAAK,CAAA;QAC7D,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,KAAK,CAAA;QAE7D,IAAI,CAAC,aAAa,GAAG,IAAI,QAAQ,CAAC;YAC9B,GAAG,EAAE,uBAAuB,GAAG,IAAI;YACnC,GAAG,EAAE,iBAAiB;SACzB,CAAC,CAAA;QACF,IAAI,CAAC,aAAa,GAAG,IAAI,QAAQ,CAAC;YAC9B,GAAG,EAAE,uBAAuB,GAAG,IAAI;YACnC,GAAG,EAAE,iBAAiB;SACzB,CAAC,CAAA;IACN,CAAC;IAED,UAAU,CAAC,OAAU;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,iBAAiB,CACnB,OAAU,EACV,WAA8C;QAE9C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;QAC3B,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACpC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,CAAA;YACnC,OAAO,mBAAmB,CAAA;QAC9B,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACpC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,CAAA;YACnC,OAAO,mBAAmB,CAAA;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QAED,OAAO,MAAM,CAAA;IACjB,CAAC;CACJ"}
+{"version":3,"file":"EntitlementCache.js","sourceRoot":"","sources":["../../src/cache/EntitlementCache.ts"],"names":[],"mappings":"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"}

package/dist/cache/ICacheStorage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Interface for cache storage backends
+ * This abstracts the underlying storage mechanism (TTLCache, KV, Redis, etc.)
+ */
+export interface ICacheStorage<V> {
+    /**
+     * Get a value from the cache
+     * Returns undefined if not found or expired
+     */
+    get(key: string): Promise<V | undefined>;
+    /**
+     * Set a value in the cache
+     * @param key Cache key
+     * @param value Value to store
+     * @param ttlMs Time-to-live in milliseconds (optional, uses default if not provided)
+     */
+    set(key: string, value: V, ttlMs?: number): Promise<void>;
+    /**
+     * Delete a value from the cache
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all values from the cache (optional - not all implementations support this)
+     */
+    clear?(): Promise<void>;
+}
+/**
+ * Configuration for creating cache storage instances
+ */
+export interface CacheStorageConfig {
+    /** Default TTL in milliseconds */
+    ttlMs?: number;
+    /** Maximum number of entries (for size-limited caches) */
+    maxSize?: number;
+    /** Key postfix (for differentiating things like positive/negative entitlements) */
+    keyPostfix?: string;
+}
+/**
+ * Factory function type for creating cache storage instances
+ * This allows injection of different storage backends (memory, KV, etc.)
+ * keys are unique per instantiation, and unique globally once `keyPostfix` is applied
+ */
+export type CreateStorageFn<V> = (config: CacheStorageConfig) => ICacheStorage<V>;
+//# sourceMappingURL=ICacheStorage.d.ts.map

package/dist/cache/ICacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICacheStorage.d.ts","sourceRoot":"","sources":["../../src/cache/ICacheStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC5B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAExC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;OAEG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA"}

package/dist/cache/ICacheStorage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICacheStorage.js.map

package/dist/cache/ICacheStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICacheStorage.js","sourceRoot":"","sources":["../../src/cache/ICacheStorage.ts"],"names":[],"mappings":""}

package/dist/cache/KVCacheStorage.d.ts

@@ -0,0 +1,79 @@
+import { CacheStorageConfig, CreateStorageFn, ICacheStorage } from './ICacheStorage';
+/**
+ * Configuration options specific to KVCacheStorage
+ */
+export interface KVCacheStorageConfig extends CacheStorageConfig {
+    /**
+     * Disable the local in-memory cache layer.
+     * When enabled (default), a local TTLCache is used as a synchronous first-level cache
+     * before falling back to KV. This is intended for use in workers where the local
+     * cache only exists for the duration of a single request, providing fast access
+     * for repeated reads within the same request without hitting KV multiple times.
+     */
+    disableLocalCache?: boolean;
+}
+/**
+ * Cloudflare KV namespace interface
+ */
+export interface KVNamespace {
+    get(key: string, options?: {
+        type?: 'text' | 'json' | 'arrayBuffer' | 'stream';
+    }): Promise<string | null>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+        expiration?: number;
+        metadata?: unknown;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        keys: {
+            name: string;
+            expiration?: number;
+            metadata?: unknown;
+        }[];
+        list_complete: boolean;
+        cursor?: string;
+    }>;
+}
+/**
+ * Cloudflare KV-backed cache storage implementation
+ * Implements ICacheStorage from @towns-protocol/web3 for use as a SpaceDapp cache backend
+ *
+ * This implementation includes an optional local in-memory cache layer (enabled by default)
+ * that sits in front of KV. This is intended for use in Cloudflare Workers or similar
+ * serverless environments where the local cache only exists for the duration of a single
+ * request. This provides fast access for repeated reads within the same request without
+ * hitting KV multiple times, while still benefiting from KV's persistence across requests.
+ */
+export declare class KVCacheStorage<V> implements ICacheStorage<V> {
+    private readonly kv;
+    private readonly keyPostfix;
+    private readonly defaultTtlMs;
+    private readonly minKVTtlSeconds;
+    /**
+     * Local in-memory cache that serves as a synchronous first-level cache before KV.
+     * In a worker context, this cache only exists for the duration of the request,
+     * providing fast repeated access without additional KV reads.
+     * TTLCache handles expiration automatically via its built-in TTL support.
+     */
+    private readonly localCache;
+    constructor(kv: KVNamespace, config: KVCacheStorageConfig);
+    private getKey;
+    get(key: string): Promise<V | undefined>;
+    set(key: string, value: V, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Create a factory function that creates KV-backed cache storage instances
+ * This is what you pass to SpaceDapp as the createStorageFn parameter
+ *
+ * @param kv The Cloudflare or Hosting provider KV namespace
+ * @param options Optional configuration for the KV storage (e.g., disableLocalCache)
+ * @returns A factory function compatible with SpaceDapp's createStorageFn parameter
+ */
+export declare function createKVStorageFactory<V = unknown>(kv: KVNamespace, options?: Pick<KVCacheStorageConfig, 'disableLocalCache'>): CreateStorageFn<V>;
+//# sourceMappingURL=KVCacheStorage.d.ts.map

package/dist/cache/KVCacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KVCacheStorage.d.ts","sourceRoot":"","sources":["../../src/cache/KVCacheStorage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKpF;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAoHD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,GAAG,CACC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzB,GAAG,CACC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9E,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC1E,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACjE,aAAa,EAAE,OAAO,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;CACL;AAYD;;;;;;;;;GASG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IACrC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;gBAE3C,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB;IAezD,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA0CxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAe3C;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAC9C,EAAE,EAAE,WAAW,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,GAC1D,eAAe,CAAC,CAAC,CAAC,CAKpB"}

package/dist/cache/KVCacheStorage.js

@@ -0,0 +1,227 @@
+import { BigNumber } from 'ethers';
+import SuperJson from 'superjson';
+import TTLCache from '@isaacs/ttlcache';
+import { dlogger } from '@towns-protocol/utils';
+const logger = dlogger('web3:kvcache');
+// Register ethers BigNumber with SuperJSON
+SuperJson.registerCustom({
+    isApplicable: (v) => BigNumber.isBigNumber(v),
+    serialize: (v) => v.toHexString(),
+    deserialize: (v) => BigNumber.from(v),
+}, 'ethers.BigNumber');
+/**
+ * Detects if a value is an ethers.js struct output (array with named properties).
+ * These are arrays that have string-keyed properties in addition to numeric indices.
+ */
+function isEthersStructOutput(value) {
+    if (!Array.isArray(value))
+        return false;
+    const namedKeys = Object.keys(value).filter((key) => isNaN(Number(key)));
+    return namedKeys.length > 0;
+}
+/**
+ * Converts ethers.js struct outputs to plain objects for proper serialization.
+ * Works recursively for nested structures.
+ */
+function normalizeEthersOutput(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    // Let SuperJson's registered BigNumber serializer handle BigNumbers
+    // BigNumber properties (_hex, _isBigNumber) are non-enumerable, so Object.entries
+    // would return an empty array and corrupt the BigNumber into {}
+    if (BigNumber.isBigNumber(value)) {
+        return value;
+    }
+    // Handle ethers struct outputs (arrays with named properties)
+    if (isEthersStructOutput(value)) {
+        const namedKeys = Object.keys(value).filter((key) => isNaN(Number(key)));
+        const obj = { __ethersStruct: true };
+        for (const key of namedKeys) {
+            obj[key] = normalizeEthersOutput(value[key]);
+        }
+        return obj;
+    }
+    // Handle regular arrays (recurse into elements)
+    if (Array.isArray(value)) {
+        return value.map(normalizeEthersOutput);
+    }
+    // Handle plain objects (recurse into values)
+    if (typeof value === 'object') {
+        const obj = {};
+        for (const [key, val] of Object.entries(value)) {
+            obj[key] = normalizeEthersOutput(val);
+        }
+        return obj;
+    }
+    // Primitives pass through unchanged
+    return value;
+}
+/**
+ * Restores ethers-like struct outputs from normalized objects.
+ * The restored object has both array indices and named properties.
+ */
+function denormalizeEthersOutput(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    // Preserve BigNumber objects - they've already been deserialized by SuperJson
+    // BigNumber properties are non-enumerable, so Object.entries would corrupt them
+    if (BigNumber.isBigNumber(value)) {
+        return value;
+    }
+    // Handle normalized ethers struct objects
+    if (typeof value === 'object' &&
+        !Array.isArray(value) &&
+        value.__ethersStruct === true) {
+        const valueObj = value;
+        const keys = Object.keys(valueObj).filter((k) => k !== '__ethersStruct');
+        // Create array-like object with both indices and named properties
+        const result = keys.map((key) => denormalizeEthersOutput(valueObj[key]));
+        for (let i = 0; i < keys.length; i++) {
+            result[keys[i]] = result[i];
+        }
+        return result;
+    }
+    // Handle regular arrays (recurse into elements)
+    if (Array.isArray(value)) {
+        return value.map(denormalizeEthersOutput);
+    }
+    // Handle plain objects (recurse into values)
+    if (typeof value === 'object') {
+        const obj = {};
+        for (const [key, val] of Object.entries(value)) {
+            obj[key] = denormalizeEthersOutput(val);
+        }
+        return obj;
+    }
+    // Primitives pass through unchanged
+    return value;
+}
+/**
+ * Cloudflare KV-backed cache storage implementation
+ * Implements ICacheStorage from @towns-protocol/web3 for use as a SpaceDapp cache backend
+ *
+ * This implementation includes an optional local in-memory cache layer (enabled by default)
+ * that sits in front of KV. This is intended for use in Cloudflare Workers or similar
+ * serverless environments where the local cache only exists for the duration of a single
+ * request. This provides fast access for repeated reads within the same request without
+ * hitting KV multiple times, while still benefiting from KV's persistence across requests.
+ */
+export class KVCacheStorage {
+    kv;
+    keyPostfix;
+    defaultTtlMs;
+    minKVTtlSeconds = 60; // KV minimum TTL
+    /**
+     * Local in-memory cache that serves as a synchronous first-level cache before KV.
+     * In a worker context, this cache only exists for the duration of the request,
+     * providing fast repeated access without additional KV reads.
+     * TTLCache handles expiration automatically via its built-in TTL support.
+     */
+    localCache;
+    constructor(kv, config) {
+        this.kv = kv;
+        this.keyPostfix = config?.keyPostfix ?? '';
+        this.defaultTtlMs = config?.ttlMs ?? 15 * 60 * 1000; // 15 minutes default
+        // Initialize local cache unless explicitly disabled
+        // Uses the same TTL and maxSize config as the KV cache
+        this.localCache = config?.disableLocalCache
+            ? null
+            : new TTLCache({
+                ttl: this.defaultTtlMs,
+                max: config?.maxSize ?? 10_000,
+            });
+    }
+    getKey(key) {
+        return this.keyPostfix ? `${key}:${this.keyPostfix}` : key;
+    }
+    async get(key) {
+        try {
+            // Check local cache first if enabled (synchronous)
+            if (this.localCache) {
+                const localValue = this.localCache.get(key);
+                if (localValue !== undefined) {
+                    return localValue;
+                }
+            }
+            const cached = await this.kv.get(this.getKey(key));
+            if (cached === null) {
+                return undefined;
+            }
+            const entry = SuperJson.parse(cached);
+            // Check if expired (belt-and-suspenders with KV TTL)
+            if (entry.expiresAt <= Date.now()) {
+                // Expired - clean up and return undefined
+                void this.kv.delete(this.getKey(key));
+                return undefined;
+            }
+            // Denormalize ethers.js struct outputs back to array-like objects with named properties
+            const value = denormalizeEthersOutput(entry.value);
+            // Populate local cache on successful KV fetch with remaining TTL
+            if (this.localCache) {
+                const remainingTtlMs = entry.expiresAt - Date.now();
+                if (remainingTtlMs > 0) {
+                    this.localCache.set(key, value, { ttl: remainingTtlMs });
+                }
+            }
+            return value;
+        }
+        catch (error) {
+            logger.error('KVCacheStorage.get error:', error);
+            return undefined;
+        }
+    }
+    async set(key, value, ttlMs) {
+        try {
+            const effectiveTtlMs = ttlMs ?? this.defaultTtlMs;
+            const expiresAt = Date.now() + effectiveTtlMs;
+            // Set in local cache if enabled (synchronous)
+            if (this.localCache) {
+                this.localCache.set(key, value, { ttl: effectiveTtlMs });
+            }
+            // Normalize ethers.js struct outputs to plain objects for proper serialization
+            const normalizedValue = normalizeEthersOutput(value);
+            const entry = {
+                value: normalizedValue,
+                expiresAt,
+            };
+            // KV requires minimum 60 second TTL
+            const kvTtlSeconds = Math.max(this.minKVTtlSeconds, Math.ceil(effectiveTtlMs / 1000));
+            const valueStr = SuperJson.stringify(entry);
+            await this.kv.put(this.getKey(key), valueStr, {
+                expirationTtl: kvTtlSeconds,
+            });
+        }
+        catch (error) {
+            logger.error('KVCacheStorage.set error:', error);
+        }
+    }
+    async delete(key) {
+        try {
+            // Delete from local cache if enabled (synchronous)
+            if (this.localCache) {
+                this.localCache.delete(key);
+            }
+            await this.kv.delete(this.getKey(key));
+        }
+        catch (error) {
+            logger.error('KVCacheStorage.delete error:', error);
+        }
+    }
+}
+/**
+ * Create a factory function that creates KV-backed cache storage instances
+ * This is what you pass to SpaceDapp as the createStorageFn parameter
+ *
+ * @param kv The Cloudflare or Hosting provider KV namespace
+ * @param options Optional configuration for the KV storage (e.g., disableLocalCache)
+ * @returns A factory function compatible with SpaceDapp's createStorageFn parameter
+ */
+export function createKVStorageFactory(kv, options) {
+    return (config) => {
+        // Combine base prefix with config prefix and options
+        return new KVCacheStorage(kv, { ...config, ...options });
+    };
+}
+//# sourceMappingURL=KVCacheStorage.js.map

package/dist/cache/KVCacheStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KVCacheStorage.js","sourceRoot":"","sources":["../../src/cache/KVCacheStorage.ts"],"names":[],"mappings":"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"}

package/dist/cache/Keyable.d.ts

@@ -1,31 +1,20 @@
 import { ethers } from 'ethers';
 import { Permission } from '../types/ContractTypes';
-export interface Keyable {
-    toKey(): string;
-}
-export declare class BannedTokenIdsRequest implements Keyable {
-    spaceId: string;
-    constructor(spaceId: string);
-    toKey(): string;
-}
-export declare class OwnerOfTokenRequest implements Keyable {
-    spaceId: string;
-    tokenId: ethers.BigNumber;
-    constructor(spaceId: string, tokenId: ethers.BigNumber);
-    toKey(): string;
-}
-export declare class IsTokenBanned implements Keyable {
-    spaceId: string;
-    tokenId: ethers.BigNumber;
-    constructor(spaceId: string, tokenId: ethers.BigNumber);
-    toKey(): string;
-}
-export declare class EntitlementRequest implements Keyable {
-    spaceId: string;
-    channelId: string;
-    userId: string;
-    permission: Permission;
-    constructor(spaceId: string, channelId: string, userId: string, permission: Permission);
+export declare class Keyable {
+    private readonly parts;
+    constructor(...args: unknown[]);
     toKey(): string;
+    static spaceInfoRequest(spaceId: string): Keyable;
+    static getEntitlementsRequest(spaceAddress: string): Keyable;
+    static ownerRequest(spaceAddress: string): Keyable;
+    static balanceOfRequest(accountAddress: string): Keyable;
+    static bannedTokenIdsRequest(spaceId: string): Keyable;
+    static ownerOfTokenRequest(spaceId: string, tokenId: ethers.BigNumber): Keyable;
+    static isTokenBanned(spaceId: string, tokenId: ethers.BigNumber): Keyable;
+    static entitlementRequest(spaceId: string, channelId: string, userId: string, permission: Permission): Keyable;
+    static spaceEntitlementRequest(spaceId: string, permission: Permission): Keyable;
+    static spaceEntitlementEvaluationRequest(spaceId: string, rootKey: string, permission: Permission): Keyable;
+    static channelEntitlementRequest(spaceId: string, channelId: string, permission: Permission): Keyable;
+    static channelEntitlementEvaluationRequest(spaceId: string, channelNetworkId: string, userId: string, permission: Permission): Keyable;
 }
 //# sourceMappingURL=Keyable.d.ts.map

package/dist/cache/Keyable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Keyable.d.ts","sourceRoot":"","sources":["../../src/cache/Keyable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,MAAM,WAAW,OAAO;IACpB,KAAK,IAAI,MAAM,CAAA;CAClB;AAED,qBAAa,qBAAsB,YAAW,OAAO;IACjD,OAAO,EAAE,MAAM,CAAA;gBACH,OAAO,EAAE,MAAM;IAG3B,KAAK,IAAI,MAAM;CAGlB;AAED,qBAAa,mBAAoB,YAAW,OAAO;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,SAAS,CAAA;gBACb,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS;IAItD,KAAK,IAAI,MAAM;CAGlB;AAED,qBAAa,aAAc,YAAW,OAAO;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,SAAS,CAAA;gBACb,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS;IAItD,KAAK,IAAI,MAAM;CAGlB;AAED,qBAAa,kBAAmB,YAAW,OAAO;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,UAAU,CAAA;gBACV,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAMtF,KAAK,IAAI,MAAM;CAGlB"}
+{"version":3,"file":"Keyable.d.ts","sourceRoot":"","sources":["../../src/cache/Keyable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;gBAErB,GAAG,IAAI,EAAE,OAAO,EAAE;IAI9B,KAAK,IAAI,MAAM;IAiBf,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjD,MAAM,CAAC,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI5D,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlD,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIxD,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO;IAI/E,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO;IAIzE,MAAM,CAAC,kBAAkB,CACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACvB,OAAO;IAIV,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO;IAIhF,MAAM,CAAC,iCAAiC,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACvB,OAAO;IAIV,MAAM,CAAC,yBAAyB,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GACvB,OAAO;IAIV,MAAM,CAAC,mCAAmC,CACtC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACvB,OAAO;CAGb"}