@syncular/server-cloudflare 0.0.6-89 → 0.0.6-92

package/dist/durable-object.js.map

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

package/dist/index.d.ts

@@ -8,11 +8,15 @@
  * Blob storage:
  * - R2 native: `@syncular/server-cloudflare/r2`
  *
+ * Scope cache:
+ * - Durable Object cache backend: `@syncular/server-cloudflare/scope-cache`
+ *
  * Dialect is user-provided:
  * - D1 + SQLite: `@syncular/dialect-d1` + `@syncular/server-dialect-sqlite`
  * - Neon + Postgres: `@syncular/dialect-neon` + `@syncular/server-dialect-postgres`
  */
 export * from './durable-object';
 export * from './r2';
+export * from './scope-cache';
 export * from './worker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -8,11 +8,15 @@
  * Blob storage:
  * - R2 native: `@syncular/server-cloudflare/r2`
  *
+ * Scope cache:
+ * - Durable Object cache backend: `@syncular/server-cloudflare/scope-cache`
+ *
  * Dialect is user-provided:
  * - D1 + SQLite: `@syncular/dialect-d1` + `@syncular/server-dialect-sqlite`
  * - Neon + Postgres: `@syncular/dialect-neon` + `@syncular/server-dialect-postgres`
  */
 export * from './durable-object.js';
 export * from './r2.js';
+export * from './scope-cache.js';
 export * from './worker.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/dist/scope-cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Durable Object-backed scope cache for @syncular/server.
+ *
+ * This module provides two parts:
+ * 1) `createDurableObjectScopeCache()` - cache backend to pass to createSyncServer/createSyncRoutes
+ * 2) `ScopeCacheDurableObject` - Durable Object class that stores scope entries in DO storage
+ */
+type ScopeValues = Record<string, string | string[]>;
+interface ScopeCacheContext {
+    db: object;
+    auth: {
+        actorId: string;
+        partitionId?: string;
+    };
+    table: string;
+    cacheKey: string;
+}
+interface ScopeCacheSetContext extends ScopeCacheContext {
+    scopes: ScopeValues;
+}
+interface ScopeCacheBackend {
+    name: string;
+    get(args: ScopeCacheContext): Promise<ScopeValues | null>;
+    set(args: ScopeCacheSetContext): Promise<void>;
+    delete?(args: ScopeCacheContext): Promise<void>;
+}
+interface ScopeCacheLookup {
+    cacheKey: string;
+    partitionId: string;
+    actorId: string;
+    table: string;
+}
+/**
+ * Durable Object for scope cache entries.
+ *
+ * Bind this class in your Worker as a separate DO namespace.
+ */
+export declare class ScopeCacheDurableObject {
+    private readonly state;
+    constructor(state: DurableObjectState, _env: object);
+    fetch(request: Request): Promise<Response>;
+}
+export interface DurableObjectScopeCacheOptions {
+    namespace: DurableObjectNamespace;
+    ttlMs?: number;
+    path?: string;
+    getStubId?: (namespace: DurableObjectNamespace, lookup: ScopeCacheLookup) => DurableObjectId;
+}
+/**
+ * Create a scope cache backend that reads/writes through a Durable Object.
+ */
+export declare function createDurableObjectScopeCache(options: DurableObjectScopeCacheOptions): ScopeCacheBackend;
+export {};
+//# sourceMappingURL=scope-cache.d.ts.map

package/dist/scope-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-cache.d.ts","sourceRoot":"","sources":["../src/scope-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAErD,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,oBAAqB,SAAQ,iBAAiB;IACtD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAOD,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AA+HD;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,YAAY,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAElD;IAEK,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0C/C;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CACV,SAAS,EAAE,sBAAsB,EACjC,MAAM,EAAE,gBAAgB,KACrB,eAAe,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAwFnB"}

package/dist/scope-cache.js

@@ -0,0 +1,218 @@
+/**
+ * Durable Object-backed scope cache for @syncular/server.
+ *
+ * This module provides two parts:
+ * 1) `createDurableObjectScopeCache()` - cache backend to pass to createSyncServer/createSyncRoutes
+ * 2) `ScopeCacheDurableObject` - Durable Object class that stores scope entries in DO storage
+ */
+const DEFAULT_SCOPE_CACHE_TTL_MS = 60_000;
+const DEFAULT_SCOPE_CACHE_DO_NAME = 'syncular-scope-cache';
+const DEFAULT_SCOPE_CACHE_PATH = '/scope-cache';
+const JSON_HEADERS = { 'content-type': 'application/json' };
+function cloneScopeValues(scopes) {
+    const cloned = {};
+    for (const [key, value] of Object.entries(scopes)) {
+        if (typeof value === 'string') {
+            cloned[key] = value;
+            continue;
+        }
+        cloned[key] = [...value];
+    }
+    return cloned;
+}
+function isScopeValues(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    for (const scopeValue of Object.values(value)) {
+        if (typeof scopeValue === 'string') {
+            continue;
+        }
+        if (Array.isArray(scopeValue) &&
+            scopeValue.every((entry) => typeof entry === 'string')) {
+            continue;
+        }
+        return false;
+    }
+    return true;
+}
+function parseJsonObject(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return null;
+    }
+    const out = {};
+    for (const [key, entry] of Object.entries(parsed)) {
+        out[key] = entry;
+    }
+    return out;
+}
+async function parseRequestBody(request) {
+    let body;
+    try {
+        body = await request.text();
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseJsonObject(body);
+    if (!parsed) {
+        return null;
+    }
+    const action = parsed.action;
+    const cacheKey = parsed.cacheKey;
+    if (typeof action !== 'string' || typeof cacheKey !== 'string') {
+        return null;
+    }
+    if (action === 'get') {
+        return { action: 'get', cacheKey };
+    }
+    if (action === 'delete') {
+        return { action: 'delete', cacheKey };
+    }
+    if (action === 'set') {
+        const ttlMs = parsed.ttlMs;
+        const scopes = parsed.scopes;
+        if (typeof ttlMs !== 'number' ||
+            Number.isNaN(ttlMs) ||
+            !Number.isFinite(ttlMs)) {
+            return null;
+        }
+        if (!isScopeValues(scopes)) {
+            return null;
+        }
+        return {
+            action: 'set',
+            cacheKey,
+            scopes: cloneScopeValues(scopes),
+            ttlMs,
+        };
+    }
+    return null;
+}
+/**
+ * Durable Object for scope cache entries.
+ *
+ * Bind this class in your Worker as a separate DO namespace.
+ */
+export class ScopeCacheDurableObject {
+    state;
+    constructor(state, _env) {
+        this.state = state;
+    }
+    async fetch(request) {
+        if (request.method !== 'POST') {
+            return new Response('Method not allowed', { status: 405 });
+        }
+        const payload = await parseRequestBody(request);
+        if (!payload) {
+            return new Response('Invalid scope cache request', { status: 400 });
+        }
+        if (payload.action === 'get') {
+            const entry = await this.state.storage.get(payload.cacheKey);
+            if (!entry) {
+                return Response.json({ scopes: null });
+            }
+            if (entry.expiresAt <= Date.now()) {
+                await this.state.storage.delete(payload.cacheKey);
+                return Response.json({ scopes: null });
+            }
+            return Response.json({ scopes: cloneScopeValues(entry.scopes) });
+        }
+        if (payload.action === 'set') {
+            if (payload.ttlMs <= 0) {
+                await this.state.storage.delete(payload.cacheKey);
+                return Response.json({ ok: true });
+            }
+            await this.state.storage.put(payload.cacheKey, {
+                scopes: cloneScopeValues(payload.scopes),
+                expiresAt: Date.now() + payload.ttlMs,
+            });
+            return Response.json({ ok: true });
+        }
+        await this.state.storage.delete(payload.cacheKey);
+        return Response.json({ ok: true });
+    }
+}
+/**
+ * Create a scope cache backend that reads/writes through a Durable Object.
+ */
+export function createDurableObjectScopeCache(options) {
+    const ttlMs = options.ttlMs ?? DEFAULT_SCOPE_CACHE_TTL_MS;
+    const path = options.path ?? DEFAULT_SCOPE_CACHE_PATH;
+    const getStubId = options.getStubId ??
+        ((namespace) => namespace.idFromName(DEFAULT_SCOPE_CACHE_DO_NAME));
+    async function callDurableObject(lookup, body) {
+        const id = getStubId(options.namespace, lookup);
+        const stub = options.namespace.get(id);
+        const response = await stub.fetch(`https://scope-cache${path}`, {
+            method: 'POST',
+            headers: JSON_HEADERS,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Scope cache durable object request failed: ${response.status}`);
+        }
+        const parsed = parseJsonObject(await response.text());
+        if (!parsed) {
+            throw new Error('Scope cache durable object response was not JSON');
+        }
+        return parsed;
+    }
+    return {
+        name: 'durable-object',
+        async get(args) {
+            const lookup = {
+                cacheKey: args.cacheKey,
+                partitionId: args.auth.partitionId ?? 'default',
+                actorId: args.auth.actorId,
+                table: args.table,
+            };
+            const response = await callDurableObject(lookup, {
+                action: 'get',
+                cacheKey: args.cacheKey,
+            });
+            const scopes = response.scopes;
+            if (scopes === null || scopes === undefined) {
+                return null;
+            }
+            if (!isScopeValues(scopes)) {
+                return null;
+            }
+            return cloneScopeValues(scopes);
+        },
+        async set(args) {
+            const lookup = {
+                cacheKey: args.cacheKey,
+                partitionId: args.auth.partitionId ?? 'default',
+                actorId: args.auth.actorId,
+                table: args.table,
+            };
+            await callDurableObject(lookup, {
+                action: 'set',
+                cacheKey: args.cacheKey,
+                scopes: cloneScopeValues(args.scopes),
+                ttlMs,
+            });
+        },
+        async delete(args) {
+            const lookup = {
+                cacheKey: args.cacheKey,
+                partitionId: args.auth.partitionId ?? 'default',
+                actorId: args.auth.actorId,
+                table: args.table,
+            };
+            await callDurableObject(lookup, {
+                action: 'delete',
+                cacheKey: args.cacheKey,
+            });
+        },
+    };
+}
+//# sourceMappingURL=scope-cache.js.map

package/dist/scope-cache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/server-cloudflare",
-  "version": "0.0.6-89",
+  "version": "0.0.6-92",
   "description": "Cloudflare Workers adapter for the Syncular server",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -56,6 +56,13 @@
         "types": "./dist/r2.d.ts",
         "default": "./dist/r2.js"
       }
+    },
+    "./scope-cache": {
+      "bun": "./src/scope-cache.ts",
+      "import": {
+        "types": "./dist/scope-cache.d.ts",
+        "default": "./dist/scope-cache.js"
+      }
     }
   },
   "scripts": {

package/src/index.ts

@@ -8,6 +8,9 @@
  * Blob storage:
  * - R2 native: `@syncular/server-cloudflare/r2`
  *
+ * Scope cache:
+ * - Durable Object cache backend: `@syncular/server-cloudflare/scope-cache`
+ *
  * Dialect is user-provided:
  * - D1 + SQLite: `@syncular/dialect-d1` + `@syncular/server-dialect-sqlite`
  * - Neon + Postgres: `@syncular/dialect-neon` + `@syncular/server-dialect-postgres`
@@ -15,4 +18,5 @@
 
 export * from './durable-object';
 export * from './r2';
+export * from './scope-cache';
 export * from './worker';

package/src/scope-cache.ts

@@ -0,0 +1,329 @@
+/**
+ * Durable Object-backed scope cache for @syncular/server.
+ *
+ * This module provides two parts:
+ * 1) `createDurableObjectScopeCache()` - cache backend to pass to createSyncServer/createSyncRoutes
+ * 2) `ScopeCacheDurableObject` - Durable Object class that stores scope entries in DO storage
+ */
+
+type ScopeValues = Record<string, string | string[]>;
+
+interface ScopeCacheContext {
+  db: object;
+  auth: {
+    actorId: string;
+    partitionId?: string;
+  };
+  table: string;
+  cacheKey: string;
+}
+
+interface ScopeCacheSetContext extends ScopeCacheContext {
+  scopes: ScopeValues;
+}
+
+interface ScopeCacheBackend {
+  name: string;
+  get(args: ScopeCacheContext): Promise<ScopeValues | null>;
+  set(args: ScopeCacheSetContext): Promise<void>;
+  delete?(args: ScopeCacheContext): Promise<void>;
+}
+
+const DEFAULT_SCOPE_CACHE_TTL_MS = 60_000;
+const DEFAULT_SCOPE_CACHE_DO_NAME = 'syncular-scope-cache';
+const DEFAULT_SCOPE_CACHE_PATH = '/scope-cache';
+const JSON_HEADERS = { 'content-type': 'application/json' };
+
+interface ScopeCacheLookup {
+  cacheKey: string;
+  partitionId: string;
+  actorId: string;
+  table: string;
+}
+
+type ScopeCacheRequestBody =
+  | {
+      action: 'get';
+      cacheKey: string;
+    }
+  | {
+      action: 'set';
+      cacheKey: string;
+      scopes: ScopeValues;
+      ttlMs: number;
+    }
+  | {
+      action: 'delete';
+      cacheKey: string;
+    };
+
+function cloneScopeValues(scopes: ScopeValues): ScopeValues {
+  const cloned: ScopeValues = {};
+  for (const [key, value] of Object.entries(scopes)) {
+    if (typeof value === 'string') {
+      cloned[key] = value;
+      continue;
+    }
+    cloned[key] = [...value];
+  }
+  return cloned;
+}
+
+function isScopeValues(value: unknown): value is ScopeValues {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    return false;
+  }
+
+  for (const scopeValue of Object.values(value)) {
+    if (typeof scopeValue === 'string') {
+      continue;
+    }
+    if (
+      Array.isArray(scopeValue) &&
+      scopeValue.every((entry) => typeof entry === 'string')
+    ) {
+      continue;
+    }
+    return false;
+  }
+  return true;
+}
+
+function parseJsonObject(value: string): Record<string, unknown> | null {
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    return null;
+  }
+
+  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    return null;
+  }
+
+  const out: Record<string, unknown> = {};
+  for (const [key, entry] of Object.entries(parsed)) {
+    out[key] = entry;
+  }
+  return out;
+}
+
+async function parseRequestBody(
+  request: Request
+): Promise<ScopeCacheRequestBody | null> {
+  let body: string;
+  try {
+    body = await request.text();
+  } catch {
+    return null;
+  }
+
+  const parsed = parseJsonObject(body);
+  if (!parsed) {
+    return null;
+  }
+
+  const action = parsed.action;
+  const cacheKey = parsed.cacheKey;
+  if (typeof action !== 'string' || typeof cacheKey !== 'string') {
+    return null;
+  }
+
+  if (action === 'get') {
+    return { action: 'get', cacheKey };
+  }
+
+  if (action === 'delete') {
+    return { action: 'delete', cacheKey };
+  }
+
+  if (action === 'set') {
+    const ttlMs = parsed.ttlMs;
+    const scopes = parsed.scopes;
+    if (
+      typeof ttlMs !== 'number' ||
+      Number.isNaN(ttlMs) ||
+      !Number.isFinite(ttlMs)
+    ) {
+      return null;
+    }
+    if (!isScopeValues(scopes)) {
+      return null;
+    }
+    return {
+      action: 'set',
+      cacheKey,
+      scopes: cloneScopeValues(scopes),
+      ttlMs,
+    };
+  }
+
+  return null;
+}
+
+interface StoredScopeCacheValue {
+  scopes: ScopeValues;
+  expiresAt: number;
+}
+
+/**
+ * Durable Object for scope cache entries.
+ *
+ * Bind this class in your Worker as a separate DO namespace.
+ */
+export class ScopeCacheDurableObject {
+  private readonly state: DurableObjectState;
+
+  constructor(state: DurableObjectState, _env: object) {
+    this.state = state;
+  }
+
+  async fetch(request: Request): Promise<Response> {
+    if (request.method !== 'POST') {
+      return new Response('Method not allowed', { status: 405 });
+    }
+
+    const payload = await parseRequestBody(request);
+    if (!payload) {
+      return new Response('Invalid scope cache request', { status: 400 });
+    }
+
+    if (payload.action === 'get') {
+      const entry = await this.state.storage.get<StoredScopeCacheValue>(
+        payload.cacheKey
+      );
+      if (!entry) {
+        return Response.json({ scopes: null });
+      }
+
+      if (entry.expiresAt <= Date.now()) {
+        await this.state.storage.delete(payload.cacheKey);
+        return Response.json({ scopes: null });
+      }
+
+      return Response.json({ scopes: cloneScopeValues(entry.scopes) });
+    }
+
+    if (payload.action === 'set') {
+      if (payload.ttlMs <= 0) {
+        await this.state.storage.delete(payload.cacheKey);
+        return Response.json({ ok: true });
+      }
+
+      await this.state.storage.put(payload.cacheKey, {
+        scopes: cloneScopeValues(payload.scopes),
+        expiresAt: Date.now() + payload.ttlMs,
+      } satisfies StoredScopeCacheValue);
+
+      return Response.json({ ok: true });
+    }
+
+    await this.state.storage.delete(payload.cacheKey);
+    return Response.json({ ok: true });
+  }
+}
+
+export interface DurableObjectScopeCacheOptions {
+  namespace: DurableObjectNamespace;
+  ttlMs?: number;
+  path?: string;
+  getStubId?: (
+    namespace: DurableObjectNamespace,
+    lookup: ScopeCacheLookup
+  ) => DurableObjectId;
+}
+
+/**
+ * Create a scope cache backend that reads/writes through a Durable Object.
+ */
+export function createDurableObjectScopeCache(
+  options: DurableObjectScopeCacheOptions
+): ScopeCacheBackend {
+  const ttlMs = options.ttlMs ?? DEFAULT_SCOPE_CACHE_TTL_MS;
+  const path = options.path ?? DEFAULT_SCOPE_CACHE_PATH;
+  const getStubId =
+    options.getStubId ??
+    ((namespace: DurableObjectNamespace) =>
+      namespace.idFromName(DEFAULT_SCOPE_CACHE_DO_NAME));
+
+  async function callDurableObject(
+    lookup: ScopeCacheLookup,
+    body: ScopeCacheRequestBody
+  ): Promise<Record<string, unknown>> {
+    const id = getStubId(options.namespace, lookup);
+    const stub = options.namespace.get(id);
+    const response = await stub.fetch(`https://scope-cache${path}`, {
+      method: 'POST',
+      headers: JSON_HEADERS,
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `Scope cache durable object request failed: ${response.status}`
+      );
+    }
+
+    const parsed = parseJsonObject(await response.text());
+    if (!parsed) {
+      throw new Error('Scope cache durable object response was not JSON');
+    }
+
+    return parsed;
+  }
+
+  return {
+    name: 'durable-object',
+    async get(args) {
+      const lookup: ScopeCacheLookup = {
+        cacheKey: args.cacheKey,
+        partitionId: args.auth.partitionId ?? 'default',
+        actorId: args.auth.actorId,
+        table: args.table,
+      };
+
+      const response = await callDurableObject(lookup, {
+        action: 'get',
+        cacheKey: args.cacheKey,
+      });
+      const scopes = response.scopes;
+      if (scopes === null || scopes === undefined) {
+        return null;
+      }
+
+      if (!isScopeValues(scopes)) {
+        return null;
+      }
+
+      return cloneScopeValues(scopes);
+    },
+    async set(args) {
+      const lookup: ScopeCacheLookup = {
+        cacheKey: args.cacheKey,
+        partitionId: args.auth.partitionId ?? 'default',
+        actorId: args.auth.actorId,
+        table: args.table,
+      };
+
+      await callDurableObject(lookup, {
+        action: 'set',
+        cacheKey: args.cacheKey,
+        scopes: cloneScopeValues(args.scopes),
+        ttlMs,
+      });
+    },
+    async delete(args) {
+      const lookup: ScopeCacheLookup = {
+        cacheKey: args.cacheKey,
+        partitionId: args.auth.partitionId ?? 'default',
+        actorId: args.auth.actorId,
+        table: args.table,
+      };
+
+      await callDurableObject(lookup, {
+        action: 'delete',
+        cacheKey: args.cacheKey,
+      });
+    },
+  };
+}