@dee-wan/cache 1.0.1 → 2.0.0

package/dist/client.js

@@ -0,0 +1,260 @@
+import { needsFreshness } from './chunk-JPK2AF7X.js';
+import { mergeD1Bookmarks, parseD1Bookmarks, D1_BOOKMARK_HEADER, serializeD1Bookmarks } from './chunk-ZBYAKDNZ.js';
+export { D1_BOOKMARK_HEADER, parseD1Bookmarks, serializeD1Bookmarks } from './chunk-ZBYAKDNZ.js';
+
+// src/client.ts
+function createSingleFlight() {
+  const pending = /* @__PURE__ */ new Map();
+  return {
+    run(key, load) {
+      const existing = pending.get(key);
+      if (existing) return existing;
+      const promise = Promise.resolve().then(load);
+      pending.set(key, promise);
+      void promise.then(() => {
+        if (pending.get(key) === promise) pending.delete(key);
+      }, () => {
+        if (pending.get(key) === promise) pending.delete(key);
+      });
+      return promise;
+    },
+    forget(key) {
+      pending.delete(key);
+    }
+  };
+}
+function createIntentWarmup(cooldownMs = 6e4, now = monotonicNow) {
+  const duration = Number.isFinite(cooldownMs) && cooldownMs > 0 ? cooldownMs : 6e4;
+  const warmed = /* @__PURE__ */ new Map();
+  let scope = "";
+  let generation = 0;
+  let running = false;
+  let queued;
+  const drain = () => {
+    if (running || !queued) return;
+    const task = queued;
+    queued = void 0;
+    if ((warmed.get(task.key) ?? 0) > now()) return;
+    running = true;
+    const isCurrent = () => task.generation === generation && scope !== "";
+    void Promise.resolve().then(() => isCurrent() ? task.load(isCurrent) : false).then((ok) => {
+      if (ok && task.generation === generation) warmed.set(task.key, now() + duration);
+    }, () => {
+    }).finally(() => {
+      running = false;
+      drain();
+    });
+  };
+  return {
+    setScope(next) {
+      if (scope === next) return;
+      scope = next;
+      generation++;
+      queued = void 0;
+      warmed.clear();
+    },
+    invalidate() {
+      generation++;
+      queued = void 0;
+      warmed.clear();
+    },
+    warm(key, load) {
+      if (!scope || !key || (warmed.get(key) ?? 0) > now()) return;
+      queued = { key, load, generation };
+      drain();
+    }
+  };
+}
+function usesGenerationCookie(policy, url, transport) {
+  if (policy.freshnessCookieMode !== "generation" || !policy.credentialHeaders?.some((name) => name.toLowerCase() === "cookie") || transport?.withCredentials !== true || !transport.origin || transport.baseUrl === void 0) return false;
+  try {
+    const origin = new URL(transport.origin).origin;
+    const base = new URL(transport.baseUrl, origin);
+    return origin !== "null" && new URL(url, base).origin === origin;
+  } catch {
+    return false;
+  }
+}
+function createReadFreshness(policy, now = Date.now) {
+  const until = /* @__PURE__ */ new Map();
+  const prune = (time) => {
+    for (const [scope, deadline] of until) if (deadline <= time) until.delete(scope);
+  };
+  return {
+    headers(scope, method) {
+      const time = now();
+      prune(time);
+      if (method.toUpperCase() !== "GET" || !until.has(scope)) return {};
+      return { "Cache-Control": "no-cache", ...policy.freshnessHeader ? { [policy.freshnessHeader]: "1" } : {} };
+    },
+    observe(scope, method, url, transport) {
+      const time = now();
+      prune(time);
+      let pathname;
+      try {
+        pathname = new URL(url, "https://cache.invalid").pathname;
+      } catch {
+        pathname = "";
+      }
+      if (needsFreshness(method, pathname, policy.freshnessCookieExcludedPaths) && !usesGenerationCookie(policy, url, transport)) until.set(scope, time + (Number.isInteger(policy.maxSeconds) && policy.maxSeconds !== void 0 && policy.maxSeconds >= 1 && policy.maxSeconds <= 300 ? policy.maxSeconds : 5) * 1e3);
+    }
+  };
+}
+function monotonicNow() {
+  const clock = Reflect.get(globalThis, "performance");
+  if (clock && typeof clock === "object") {
+    const read = Reflect.get(clock, "now");
+    if (typeof read === "function") {
+      const value = Reflect.apply(read, clock, []);
+      if (typeof value === "number" && Number.isFinite(value)) return value;
+    }
+  }
+  return Date.now();
+}
+function createRevalidationWindow(windowMs, now = monotonicNow) {
+  const duration = Number.isFinite(windowMs) && windowMs > 0 ? windowMs : 3e5;
+  const scopes = /* @__PURE__ */ new Map();
+  return {
+    remaining(scope) {
+      const time = now();
+      let deadline = scopes.get(scope);
+      if (deadline === void 0) {
+        deadline = time + duration;
+        scopes.set(scope, deadline);
+      }
+      return Math.max(0, deadline - time);
+    },
+    take(scope) {
+      const time = now();
+      const deadline = scopes.get(scope);
+      if (deadline !== void 0 && time < deadline) return false;
+      scopes.set(scope, time + duration);
+      return true;
+    }
+  };
+}
+var mutationChannelName = "dee-wan-cache-invalidation-v1";
+var validScope = (scope) => /^[A-Za-z0-9:_-]{1,256}$/.test(scope);
+var validMethod = (method) => /^[!#$%&'*+.^_`|~0-9A-Z-]{1,32}$/.test(method);
+var validPathname = (pathname) => pathname.startsWith("/") && pathname.length <= 2048 && ![...pathname].some((character) => character === "?" || character === "#" || character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);
+function invalidationChannel(value) {
+  return !!value && typeof value === "object" && Reflect.get(value, "name") === mutationChannelName && ["postMessage", "addEventListener", "removeEventListener", "close"].every((name) => typeof Reflect.get(value, name) === "function");
+}
+function browserInvalidationChannel() {
+  const document = Reflect.get(globalThis, "document");
+  if (!document || typeof document !== "object") return void 0;
+  const constructor = Reflect.get(globalThis, "BroadcastChannel");
+  if (typeof constructor !== "function") return void 0;
+  try {
+    const channel = Reflect.construct(constructor, [mutationChannelName]);
+    return invalidationChannel(channel) ? channel : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createMutationInvalidation(policy, options = {}) {
+  const supplied = options.channel === void 0 ? browserInvalidationChannel() : options.channel;
+  const channel = invalidationChannel(supplied) ? supplied : void 0;
+  const listeners = /* @__PURE__ */ new Map();
+  let disposed = false;
+  const notify = (event) => {
+    for (const listener of listeners.get(event.scope) ?? []) {
+      try {
+        listener({ ...event });
+      } catch {
+      }
+    }
+  };
+  const receive = ({ data }) => {
+    try {
+      if (disposed || !data || typeof data !== "object" || Object.keys(data).sort().join(",") !== "method,pathname,scope") return;
+      const scope = Reflect.get(data, "scope");
+      const method = Reflect.get(data, "method");
+      const pathname = Reflect.get(data, "pathname");
+      if (typeof scope !== "string" || !validScope(scope) || typeof method !== "string" || !validMethod(method) || typeof pathname !== "string" || !validPathname(pathname) || !needsFreshness(method, pathname, policy.freshnessCookieExcludedPaths)) return;
+      notify({ scope, method, pathname });
+    } catch {
+    }
+  };
+  channel?.addEventListener("message", receive);
+  return {
+    publish(scope, method, url) {
+      if (disposed || !validScope(scope)) return;
+      const normalized = method.toUpperCase();
+      if (!validMethod(normalized)) return;
+      let pathname;
+      try {
+        pathname = new URL(url, "https://cache.invalid").pathname;
+      } catch {
+        return;
+      }
+      if (!validPathname(pathname) || !needsFreshness(normalized, pathname, policy.freshnessCookieExcludedPaths)) return;
+      const event = { scope, method: normalized, pathname };
+      notify(event);
+      try {
+        channel?.postMessage({ scope, method: normalized, pathname });
+      } catch {
+      }
+    },
+    subscribe(scope, listener) {
+      if (disposed || !validScope(scope)) return () => {
+      };
+      let group = listeners.get(scope);
+      if (!group) {
+        group = /* @__PURE__ */ new Set();
+        listeners.set(scope, group);
+      }
+      group.add(listener);
+      const subscribed = group;
+      return () => {
+        subscribed.delete(listener);
+        if (subscribed.size === 0 && listeners.get(scope) === subscribed) listeners.delete(scope);
+      };
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      listeners.clear();
+      channel?.removeEventListener("message", receive);
+      channel?.close();
+    }
+  };
+}
+function createD1BookmarkFetch(fetcher = fetch, options = {}) {
+  const origins = /* @__PURE__ */ new Map();
+  return async (input, init) => {
+    const request = new Request(input, init);
+    const origin = new URL(request.url).origin;
+    const bookmarks = origins.get(origin) ?? {};
+    if (!origins.has(origin)) origins.set(origin, bookmarks);
+    const key = `dee-wan:d1-bookmarks:${origin}`;
+    const mergeStored = () => {
+      try {
+        const saved = parseD1Bookmarks(options.storage?.getItem(key) ?? null);
+        const combined = { ...bookmarks };
+        if (mergeD1Bookmarks(combined, saved)) Object.assign(bookmarks, combined);
+      } catch {
+      }
+    };
+    mergeStored();
+    const headers = new Headers(request.headers);
+    const outgoing = { ...bookmarks };
+    if (!mergeD1Bookmarks(outgoing, parseD1Bookmarks(headers.get(D1_BOOKMARK_HEADER)))) throw new RangeError("D1 bookmark capacity exceeded");
+    const encoded = serializeD1Bookmarks(outgoing);
+    if (encoded && encoded !== "{}") headers.set(D1_BOOKMARK_HEADER, encoded);
+    else headers.delete(D1_BOOKMARK_HEADER);
+    const response = await fetcher(new Request(request, { headers }));
+    mergeStored();
+    if (!mergeD1Bookmarks(bookmarks, parseD1Bookmarks(response.headers.get(D1_BOOKMARK_HEADER)))) throw new RangeError("D1 bookmark capacity exceeded");
+    try {
+      const value = serializeD1Bookmarks(bookmarks);
+      if (value && value !== "{}") options.storage?.setItem(key, value);
+    } catch {
+    }
+    return response;
+  };
+}
+
+export { createD1BookmarkFetch, createIntentWarmup, createMutationInvalidation, createReadFreshness, createRevalidationWindow, createSingleFlight };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["import type { D1CacheProfile } from './d1/profile';\nimport { needsFreshness } from './d1/read-freshness-policy';\n\nexport function createSingleFlight<Key, Value>() {\n  const pending = new Map<Key, Promise<Value>>();\n  return {\n    run(key: Key, load: () => Promise<Value>): Promise<Value> {\n      const existing = pending.get(key);\n      if (existing) return existing;\n      const promise = Promise.resolve().then(load);\n      pending.set(key, promise);\n      void promise.then(() => { if (pending.get(key) === promise) pending.delete(key); }, () => { if (pending.get(key) === promise) pending.delete(key); });\n      return promise;\n    },\n    forget(key: Key): void { pending.delete(key); },\n  };\n}\n\nexport function createIntentWarmup(cooldownMs = 60_000, now: () => number = monotonicNow) {\n  const duration = Number.isFinite(cooldownMs) && cooldownMs > 0 ? cooldownMs : 60_000;\n  const warmed = new Map<string, number>();\n  let scope = '';\n  let generation = 0;\n  let running = false;\n  let queued: { key: string; load: (isCurrent: () => boolean) => Promise<boolean>; generation: number } | undefined;\n  const drain = () => {\n    if (running || !queued) return;\n    const task = queued;\n    queued = undefined;\n    if ((warmed.get(task.key) ?? 0) > now()) return;\n    running = true;\n    const isCurrent = () => task.generation === generation && scope !== '';\n    void Promise.resolve().then(() => isCurrent() ? task.load(isCurrent) : false).then((ok) => {\n      if (ok && task.generation === generation) warmed.set(task.key, now() + duration);\n    }, () => {}).finally(() => { running = false; drain(); });\n  };\n  return {\n    setScope(next: string): void {\n      if (scope === next) return;\n      scope = next;\n      generation++;\n      queued = undefined;\n      warmed.clear();\n    },\n    invalidate(): void { generation++; queued = undefined; warmed.clear(); },\n    warm(key: string, load: (isCurrent: () => boolean) => Promise<boolean>): void {\n      if (!scope || !key || (warmed.get(key) ?? 0) > now()) return;\n      queued = { key, load, generation };\n      drain();\n    },\n  };\n}\n\ntype ReadLeasePolicy = Pick<NonNullable<D1CacheProfile['readResponseLease']>, 'freshnessHeader' | 'freshnessCookieExcludedPaths' | 'maxSeconds' | 'freshnessCookieMode'> & Partial<Pick<NonNullable<D1CacheProfile['readResponseLease']>, 'credentialHeaders'>>;\n\nexport interface FreshnessTransport { origin?: string; baseUrl?: string; withCredentials?: boolean }\n\nfunction usesGenerationCookie(policy: ReadLeasePolicy, url: string, transport?: FreshnessTransport): boolean {\n  if (policy.freshnessCookieMode !== 'generation' || !policy.credentialHeaders?.some((name) => name.toLowerCase() === 'cookie') || transport?.withCredentials !== true || !transport.origin || transport.baseUrl === undefined) return false;\n  try {\n    const origin = new URL(transport.origin).origin;\n    const base = new URL(transport.baseUrl, origin);\n    return origin !== 'null' && new URL(url, base).origin === origin;\n  } catch { return false; }\n}\n\nexport function createReadFreshness(policy: ReadLeasePolicy, now: () => number = Date.now) {\n  const until = new Map<string, number>();\n  const prune = (time: number) => { for (const [scope, deadline] of until) if (deadline <= time) until.delete(scope); };\n  return {\n    headers(scope: string, method: string): Record<string, string> {\n      const time = now();\n      prune(time);\n      if (method.toUpperCase() !== 'GET' || !until.has(scope)) return {};\n      return { 'Cache-Control':'no-cache', ...(policy.freshnessHeader ? { [policy.freshnessHeader]:'1' } : {}) };\n    },\n    observe(scope: string, method: string, url: string, transport?: FreshnessTransport): void {\n      const time = now();\n      prune(time);\n      let pathname: string;\n      try { pathname = new URL(url, 'https://cache.invalid').pathname; } catch { pathname = ''; }\n      if (needsFreshness(method, pathname, policy.freshnessCookieExcludedPaths) && !usesGenerationCookie(policy, url, transport)) until.set(scope, time + (Number.isInteger(policy.maxSeconds) && policy.maxSeconds !== undefined && policy.maxSeconds >= 1 && policy.maxSeconds <= 300 ? policy.maxSeconds : 5) * 1000);\n    },\n  };\n}\n\nfunction monotonicNow(): number {\n  const clock: unknown = Reflect.get(globalThis, 'performance');\n  if (clock && typeof clock === 'object') {\n    const read: unknown = Reflect.get(clock, 'now');\n    if (typeof read === 'function') {\n      const value: unknown = Reflect.apply(read, clock, []);\n      if (typeof value === 'number' && Number.isFinite(value)) return value;\n    }\n  }\n  return Date.now();\n}\n\nexport function createRevalidationWindow(windowMs: number, now: () => number = monotonicNow) {\n  const duration = Number.isFinite(windowMs) && windowMs > 0 ? windowMs : 300_000;\n  const scopes = new Map<string, number>();\n  return {\n    remaining(scope: string): number {\n      const time = now();\n      let deadline = scopes.get(scope);\n      if (deadline === undefined) { deadline = time + duration; scopes.set(scope, deadline); }\n      return Math.max(0, deadline - time);\n    },\n    take(scope: string): boolean {\n      const time = now();\n      const deadline = scopes.get(scope);\n      if (deadline !== undefined && time < deadline) return false;\n      scopes.set(scope, time + duration);\n      return true;\n    },\n  };\n}\n\nexport interface MutationInvalidationEvent {\n  scope: string;\n  method: string;\n  pathname: string;\n}\n\nexport interface MutationInvalidationChannel {\n  readonly name: string;\n  postMessage(value: MutationInvalidationEvent): void;\n  addEventListener(type: 'message', listener: (event: { data: unknown }) => void): void;\n  removeEventListener(type: 'message', listener: (event: { data: unknown }) => void): void;\n  close(): void;\n}\n\nconst mutationChannelName = 'dee-wan-cache-invalidation-v1';\nconst validScope = (scope: string): boolean => /^[A-Za-z0-9:_-]{1,256}$/.test(scope);\nconst validMethod = (method: string): boolean => /^[!#$%&'*+.^_`|~0-9A-Z-]{1,32}$/.test(method);\nconst validPathname = (pathname: string): boolean => pathname.startsWith('/') && pathname.length <= 2048 && ![...pathname].some((character) => character === '?' || character === '#' || character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);\n\nfunction invalidationChannel(value: unknown): value is MutationInvalidationChannel {\n  return !!value && typeof value === 'object' && Reflect.get(value, 'name') === mutationChannelName && ['postMessage', 'addEventListener', 'removeEventListener', 'close'].every((name) => typeof Reflect.get(value, name) === 'function');\n}\n\nfunction browserInvalidationChannel(): MutationInvalidationChannel | undefined {\n  const document: unknown = Reflect.get(globalThis, 'document');\n  if (!document || typeof document !== 'object') return undefined;\n  const constructor: unknown = Reflect.get(globalThis, 'BroadcastChannel');\n  if (typeof constructor !== 'function') return undefined;\n  try { const channel: unknown = Reflect.construct(constructor, [mutationChannelName]); return invalidationChannel(channel) ? channel : undefined; } catch { return undefined; }\n}\n\nexport function createMutationInvalidation(policy: Pick<NonNullable<D1CacheProfile['readResponseLease']>, 'freshnessCookieExcludedPaths'>, options: { channel?: MutationInvalidationChannel | null } = {}) {\n  const supplied = options.channel === undefined ? browserInvalidationChannel() : options.channel;\n  const channel = invalidationChannel(supplied) ? supplied : undefined;\n  const listeners = new Map<string, Set<(event: MutationInvalidationEvent) => void>>();\n  let disposed = false;\n  const notify = (event: MutationInvalidationEvent) => {\n    for (const listener of listeners.get(event.scope) ?? []) {\n      try { listener({ ...event }); } catch { /* Subscribers are independent. */ }\n    }\n  };\n  const receive = ({ data }: { data: unknown }) => {\n    try {\n      if (disposed || !data || typeof data !== 'object' || Object.keys(data).sort().join(',') !== 'method,pathname,scope') return;\n      const scope: unknown = Reflect.get(data, 'scope');\n      const method: unknown = Reflect.get(data, 'method');\n      const pathname: unknown = Reflect.get(data, 'pathname');\n      if (typeof scope !== 'string' || !validScope(scope) || typeof method !== 'string' || !validMethod(method) || typeof pathname !== 'string' || !validPathname(pathname) || !needsFreshness(method, pathname, policy.freshnessCookieExcludedPaths)) return;\n      notify({ scope, method, pathname });\n    } catch { /* Ignore malformed messages. */ }\n  };\n  channel?.addEventListener('message', receive);\n  return {\n    publish(scope: string, method: string, url: string): void {\n      if (disposed || !validScope(scope)) return;\n      const normalized = method.toUpperCase();\n      if (!validMethod(normalized)) return;\n      let pathname: string;\n      try { pathname = new URL(url, 'https://cache.invalid').pathname; } catch { return; }\n      if (!validPathname(pathname) || !needsFreshness(normalized, pathname, policy.freshnessCookieExcludedPaths)) return;\n      const event = { scope, method:normalized, pathname };\n      notify(event);\n      try { channel?.postMessage({ scope, method:normalized, pathname }); } catch { /* Local notification remains available. */ }\n    },\n    subscribe(scope: string, listener: (event: MutationInvalidationEvent) => void): () => void {\n      if (disposed || !validScope(scope)) return () => {};\n      let group = listeners.get(scope);\n      if (!group) { group = new Set(); listeners.set(scope, group); }\n      group.add(listener);\n      const subscribed = group;\n      return () => { subscribed.delete(listener); if (subscribed.size === 0 && listeners.get(scope) === subscribed) listeners.delete(scope); };\n    },\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      listeners.clear();\n      channel?.removeEventListener('message', receive);\n      channel?.close();\n    },\n  };\n}\n\nexport { D1_BOOKMARK_HEADER, parseD1Bookmarks, serializeD1Bookmarks } from './d1/bookmarks';\n\nimport { D1_BOOKMARK_HEADER, mergeD1Bookmarks, parseD1Bookmarks, serializeD1Bookmarks } from './d1/bookmarks';\n\nexport interface D1BookmarkStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nexport function createD1BookmarkFetch(fetcher: typeof fetch = fetch, options: { storage?: D1BookmarkStorage } = {}): typeof fetch {\n  const origins = new Map<string, Record<string, string>>();\n  return async (input, init) => {\n    const request = new Request(input, init);\n    const origin = new URL(request.url).origin;\n    const bookmarks = origins.get(origin) ?? {};\n    if (!origins.has(origin)) origins.set(origin, bookmarks);\n    const key = `dee-wan:d1-bookmarks:${origin}`;\n    const mergeStored = () => {\n      try {\n        const saved = parseD1Bookmarks(options.storage?.getItem(key) ?? null);\n        const combined = { ...bookmarks };\n        if (mergeD1Bookmarks(combined, saved)) Object.assign(bookmarks, combined);\n      } catch { /* Storage is optional. */ }\n    };\n    mergeStored();\n    const headers = new Headers(request.headers);\n    const outgoing = { ...bookmarks };\n    if (!mergeD1Bookmarks(outgoing, parseD1Bookmarks(headers.get(D1_BOOKMARK_HEADER)))) throw new RangeError('D1 bookmark capacity exceeded');\n    const encoded = serializeD1Bookmarks(outgoing);\n    if (encoded && encoded !== '{}') headers.set(D1_BOOKMARK_HEADER, encoded);\n    else headers.delete(D1_BOOKMARK_HEADER);\n    const response = await fetcher(new Request(request, { headers }));\n    mergeStored();\n    if (!mergeD1Bookmarks(bookmarks, parseD1Bookmarks(response.headers.get(D1_BOOKMARK_HEADER)))) throw new RangeError('D1 bookmark capacity exceeded');\n    try {\n      const value = serializeD1Bookmarks(bookmarks);\n      if (value && value !== '{}') options.storage?.setItem(key, value);\n    } catch { /* Storage is optional. */ }\n    return response;\n  };\n}\n"]}

package/dist/cloudflare/index.d.ts

@@ -1,9 +1,11 @@
 import { DurableObject } from 'cloudflare:workers';
-import { R as ReadRequest, a as ReadResponse, W as WriteRequest, b as WriteResult, c as ReleaseRequest, B as BeginWriteRequest, E as EndWriteRequest, C as CacheStore } from '../types-DwtU0KpX.js';
+import { I as InspectFencesRequest, a as InspectFencesResponse, R as ReadRequest, b as ReadResponse, W as WriteRequest, c as WriteResult, d as ReleaseRequest, B as BeginWriteRequest, E as EndWriteRequest, C as CacheStore } from '../types-CtErcz2a.js';
+export { a as ReadResponseWarmupContext, R as ReadResponseWarmupOptions, b as ReadResponseWarmupTarget, c as createResponseWarmup } from '../response-warmup-BWQvnT1G.js';
 
 declare class CacheCoordinator<Env = unknown> extends DurableObject<Env> {
     private readonly core;
     constructor(ctx: DurableObjectState, env: Env);
+    inspectFences(request: InspectFencesRequest): InspectFencesResponse;
     read(request: ReadRequest): ReadResponse;
     write(request: WriteRequest): WriteResult;
     release(request: ReleaseRequest): void;
@@ -23,4 +25,15 @@ interface DurableObjectStoreOptions {
 
 declare function createDurableObjectStore<Env>(namespace: DurableObjectNamespace<CacheCoordinator<Env>>, options: DurableObjectStoreOptions): CacheStore;
 
-export { CacheCoordinator, type CoordinatorLocationHint, type DurableObjectStoreOptions, createDurableObjectStore };
+interface RegionalStoreOptions {
+    namespace: string;
+    generation: string;
+    ttlMs: number;
+    enabled?: boolean;
+    cache?: () => Pick<Cache, "match" | "put">;
+    now?: () => number;
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+declare function createRegionalStore(store: CacheStore, options: RegionalStoreOptions): CacheStore;
+
+export { CacheCoordinator, type CoordinatorLocationHint, type DurableObjectStoreOptions, type RegionalStoreOptions, createDurableObjectStore, createRegionalStore };