@atiproto/record-resolver 0.1.0

package/dist/AgentRecordResolver.d.ts

@@ -0,0 +1,20 @@
+import { type RecordMap } from "./types.js";
+/**
+ * Minimal XRPC-shaped agent. Matches `@atiproto/agent.Agent`,
+ * `@atproto/api.Agent`, and bare `@atproto/xrpc.XrpcClient`.
+ */
+export interface RecordResolverAgent {
+    call(nsid: string, params?: unknown, data?: unknown): Promise<{
+        data: unknown;
+    }>;
+}
+/**
+ * Resolves `at://` URIs to record values via an existing XRPC client.
+ * Auth, retries, and proxying live on the client — this resolver just
+ * routes the `com.atproto.repo.getRecord` call through it.
+ */
+export declare class AgentRecordResolver {
+    private readonly agent;
+    constructor(agent: RecordResolverAgent);
+    resolve: (uri: string) => Promise<RecordMap>;
+}

package/dist/EdgeRecordResolver.d.ts

@@ -0,0 +1,27 @@
+import type { SimpleStore } from "@atproto-labs/simple-store";
+import { type FetchRecordResolverOptions } from "./FetchRecordResolver.js";
+import type { RecordMap } from "./types.js";
+export interface EdgeRecordResolverOptions extends FetchRecordResolverOptions {
+    /**
+     * Cache keyed by full `at://` URI. Defaults to an in-memory store
+     * with a 24-hour TTL. For Cloudflare Workers, pass a tiered store
+     * (e.g. memory + CacheApiStore from `@atiproto/edge-resolver-cache`)
+     * so proof records persist across requests within a colo.
+     *
+     * Caching is safe because proof records are content-addressed by
+     * their strongRef CID — once written, the value at a URI never
+     * changes.
+     */
+    cache?: SimpleStore<string, RecordMap>;
+}
+/**
+ * `FetchRecordResolver` with a `SimpleStore` cache in front of the
+ * `getRecord` call. The default cache is in-memory; pass a tiered
+ * store for cross-request persistence on the edge.
+ */
+export declare class EdgeRecordResolver {
+    private readonly fetcher;
+    private readonly cache;
+    constructor(options?: EdgeRecordResolverOptions);
+    resolve: (uri: string) => Promise<RecordMap>;
+}

package/dist/FetchRecordResolver.d.ts

@@ -0,0 +1,27 @@
+import { type RecordMap } from "./types.js";
+export interface FetchRecordResolverOptions {
+    /**
+     * Base URL of the relay (or PDS) used to fetch records. Calls land on
+     * `${relay}/xrpc/com.atproto.repo.getRecord`. Default:
+     * `https://bsky.network`.
+     */
+    relay?: string;
+    /** Request timeout in milliseconds. Default: `3000`. */
+    timeout?: number;
+    /** Override the global `fetch` (for tests, custom transports). */
+    fetch?: typeof fetch;
+}
+/**
+ * Resolves `at://` URIs to record values by calling
+ * `com.atproto.repo.getRecord` on a configurable relay.
+ *
+ * Suitable for verifying remote attestations from anywhere with HTTPS —
+ * no auth required since proof records are public.
+ */
+export declare class FetchRecordResolver {
+    private readonly relay;
+    private readonly timeout;
+    private readonly fetchImpl;
+    constructor(options?: FetchRecordResolverOptions);
+    resolve: (uri: string) => Promise<RecordMap>;
+}

package/dist/createAgentRecordResolver.d.ts

@@ -0,0 +1,15 @@
+import { type RecordResolver } from "./types.js";
+/**
+ * Minimal XRPC-shaped agent. Matches `@atiproto/agent.Agent`,
+ * `@atproto/api.Agent`, and bare `@atproto/xrpc.XrpcClient`.
+ */
+export interface RecordResolverAgent {
+    call(nsid: string, params?: unknown, data?: unknown): Promise<{
+        data: unknown;
+    }>;
+}
+/**
+ * Builds a RecordResolver that routes `getRecord` through an existing
+ * XRPC client. Auth, retries, and proxying live on the client.
+ */
+export declare function createAgentRecordResolver(agent: RecordResolverAgent): RecordResolver;

package/dist/createCachedRecordResolver.d.ts

@@ -0,0 +1,18 @@
+import type { SimpleStore } from "@atproto-labs/simple-store";
+import { type FetchRecordResolverOptions } from "./createFetchRecordResolver.js";
+import type { RecordMap, RecordResolver } from "./types.js";
+export interface CachedRecordResolverOptions extends FetchRecordResolverOptions {
+    /**
+     * Cache keyed by full `at://` URI. Defaults to an in-memory store
+     * with a 24-hour TTL bounded at 1000 entries. Proof records are
+     * content-addressed by their strongRef CID, so caching by URI is
+     * safe for an unlimited duration.
+     */
+    cache?: SimpleStore<string, RecordMap>;
+}
+/**
+ * Builds a RecordResolver that wraps `createFetchRecordResolver` with
+ * a `SimpleStore` cache. Safe by virtue of content-addressed
+ * strongRefs.
+ */
+export declare function createCachedRecordResolver(options?: CachedRecordResolverOptions): RecordResolver;

package/dist/createEdgeRecordResolver.d.ts

@@ -0,0 +1,18 @@
+import type { SimpleStore } from "@atproto-labs/simple-store";
+import { type FetchRecordResolverOptions } from "./createFetchRecordResolver.js";
+import type { RecordMap, RecordResolver } from "./types.js";
+export interface EdgeRecordResolverOptions extends FetchRecordResolverOptions {
+    /**
+     * Cache keyed by full `at://` URI. Defaults to an in-memory store
+     * with a 24-hour TTL bounded at 1000 entries. Proof records are
+     * content-addressed by their strongRef CID, so caching by URI is
+     * safe for an unlimited duration.
+     */
+    cache?: SimpleStore<string, RecordMap>;
+}
+/**
+ * Builds a RecordResolver that wraps `createFetchRecordResolver` with
+ * a `SimpleStore` cache. Safe by virtue of content-addressed
+ * strongRefs.
+ */
+export declare function createEdgeRecordResolver(options?: EdgeRecordResolverOptions): RecordResolver;

package/dist/createFetchRecordResolver.d.ts

@@ -0,0 +1,18 @@
+import { type RecordResolver } from "./types.js";
+export interface FetchRecordResolverOptions {
+    /**
+     * Base URL of the relay (or PDS) used to fetch records. Calls land
+     * on `${relay}/xrpc/com.atproto.repo.getRecord`. Default:
+     * `https://bsky.network`.
+     */
+    relay?: string;
+    /** Request timeout in milliseconds. Default: `3000`. */
+    timeout?: number;
+    /** Override the global `fetch` (for tests, custom transports). */
+    fetch?: typeof fetch;
+}
+/**
+ * Builds a RecordResolver that calls `com.atproto.repo.getRecord` on a
+ * configurable relay (or PDS) over plain `fetch`. No auth.
+ */
+export declare function createFetchRecordResolver(options?: FetchRecordResolverOptions): RecordResolver;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createFetchRecordResolver, type FetchRecordResolverOptions, } from "./createFetchRecordResolver.js";
+export { createAgentRecordResolver, type RecordResolverAgent, } from "./createAgentRecordResolver.js";
+export { createCachedRecordResolver, type CachedRecordResolverOptions, } from "./createCachedRecordResolver.js";
+export { parseAtUri, type ParsedAtUri } from "./types.js";
+export type { RecordMap, RecordResolver } from "./types.js";

package/dist/index.js

@@ -0,0 +1,120 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createAgentRecordResolver: () => createAgentRecordResolver,
+  createCachedRecordResolver: () => createCachedRecordResolver,
+  createFetchRecordResolver: () => createFetchRecordResolver,
+  parseAtUri: () => parseAtUri
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+function parseAtUri(uri) {
+  if (!uri.startsWith("at://")) {
+    throw new Error(`Not an at:// URI: ${uri}`);
+  }
+  const [repo, collection, rkey] = uri.slice("at://".length).split("/");
+  if (!repo || !collection || !rkey) {
+    throw new Error(`Malformed at:// URI: ${uri}`);
+  }
+  return { repo, collection, rkey };
+}
+
+// src/createFetchRecordResolver.ts
+var DEFAULT_RELAY = "https://bsky.network";
+var DEFAULT_TIMEOUT = 3e3;
+function createFetchRecordResolver(options = {}) {
+  const relay = options.relay ?? DEFAULT_RELAY;
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const fetchImpl = options.fetch ?? fetch;
+  return async (uri) => {
+    const { repo, collection, rkey } = parseAtUri(uri);
+    const url = new URL("/xrpc/com.atproto.repo.getRecord", relay);
+    url.searchParams.set("repo", repo);
+    url.searchParams.set("collection", collection);
+    url.searchParams.set("rkey", rkey);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+      const res = await fetchImpl(url, {
+        signal: controller.signal,
+        headers: { accept: "application/json" }
+      });
+      if (!res.ok) {
+        throw new Error(
+          `getRecord ${repo}/${collection}/${rkey} -> ${res.status}`
+        );
+      }
+      const body = await res.json();
+      if (!body.value || typeof body.value !== "object") {
+        throw new Error(`getRecord response missing value: ${uri}`);
+      }
+      return body.value;
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+}
+
+// src/createAgentRecordResolver.ts
+function createAgentRecordResolver(agent) {
+  return async (uri) => {
+    const { repo, collection, rkey } = parseAtUri(uri);
+    const res = await agent.call("com.atproto.repo.getRecord", {
+      repo,
+      collection,
+      rkey
+    });
+    const data = res.data;
+    if (!data?.value || typeof data.value !== "object") {
+      throw new Error(`getRecord response missing value: ${uri}`);
+    }
+    return data.value;
+  };
+}
+
+// src/createCachedRecordResolver.ts
+var import_simple_store_memory = require("@atproto-labs/simple-store-memory");
+function createCachedRecordResolver(options = {}) {
+  const fetcher = createFetchRecordResolver(options);
+  const cache = options.cache ?? new import_simple_store_memory.SimpleStoreMemory({
+    ttl: 864e5,
+    ttlAutopurge: true,
+    max: 1e3
+  });
+  return async (uri) => {
+    const cached = await cache.get(uri);
+    if (cached) return cached;
+    const record = await fetcher(uri);
+    void Promise.resolve(cache.set(uri, record)).catch(() => {
+    });
+    return record;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAgentRecordResolver,
+  createCachedRecordResolver,
+  createFetchRecordResolver,
+  parseAtUri
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/createFetchRecordResolver.ts","../src/createAgentRecordResolver.ts","../src/createCachedRecordResolver.ts"],"sourcesContent":["export {\n  createFetchRecordResolver,\n  type FetchRecordResolverOptions,\n} from \"./createFetchRecordResolver.js\";\nexport {\n  createAgentRecordResolver,\n  type RecordResolverAgent,\n} from \"./createAgentRecordResolver.js\";\nexport {\n  createCachedRecordResolver,\n  type CachedRecordResolverOptions,\n} from \"./createCachedRecordResolver.js\";\nexport { parseAtUri, type ParsedAtUri } from \"./types.js\";\nexport type { RecordMap, RecordResolver } from \"./types.js\";\n","import type { RecordMap, RecordResolver } from \"@atiproto/atproto-attestation\";\n\nexport type { RecordMap, RecordResolver };\n\n/**\n * Parsed pieces of an `at://{repo}/{collection}/{rkey}` URI.\n */\nexport interface ParsedAtUri {\n  repo: string;\n  collection: string;\n  rkey: string;\n}\n\nexport function parseAtUri(uri: string): ParsedAtUri {\n  if (!uri.startsWith(\"at://\")) {\n    throw new Error(`Not an at:// URI: ${uri}`);\n  }\n  const [repo, collection, rkey] = uri.slice(\"at://\".length).split(\"/\");\n  if (!repo || !collection || !rkey) {\n    throw new Error(`Malformed at:// URI: ${uri}`);\n  }\n  return { repo, collection, rkey };\n}\n","import { parseAtUri, type RecordMap, type RecordResolver } from \"./types.js\";\n\nexport interface FetchRecordResolverOptions {\n  /**\n   * Base URL of the relay (or PDS) used to fetch records. Calls land\n   * on `${relay}/xrpc/com.atproto.repo.getRecord`. Default:\n   * `https://bsky.network`.\n   */\n  relay?: string;\n  /** Request timeout in milliseconds. Default: `3000`. */\n  timeout?: number;\n  /** Override the global `fetch` (for tests, custom transports). */\n  fetch?: typeof fetch;\n}\n\nconst DEFAULT_RELAY = \"https://bsky.network\";\nconst DEFAULT_TIMEOUT = 3000;\n\n/**\n * Builds a RecordResolver that calls `com.atproto.repo.getRecord` on a\n * configurable relay (or PDS) over plain `fetch`. No auth.\n */\nexport function createFetchRecordResolver(\n  options: FetchRecordResolverOptions = {},\n): RecordResolver {\n  const relay = options.relay ?? DEFAULT_RELAY;\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const fetchImpl = options.fetch ?? fetch;\n\n  return async (uri) => {\n    const { repo, collection, rkey } = parseAtUri(uri);\n\n    const url = new URL(\"/xrpc/com.atproto.repo.getRecord\", relay);\n    url.searchParams.set(\"repo\", repo);\n    url.searchParams.set(\"collection\", collection);\n    url.searchParams.set(\"rkey\", rkey);\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeout);\n    try {\n      const res = await fetchImpl(url, {\n        signal: controller.signal,\n        headers: { accept: \"application/json\" },\n      });\n      if (!res.ok) {\n        throw new Error(\n          `getRecord ${repo}/${collection}/${rkey} -> ${res.status}`,\n        );\n      }\n      const body = (await res.json()) as { value?: RecordMap };\n      if (!body.value || typeof body.value !== \"object\") {\n        throw new Error(`getRecord response missing value: ${uri}`);\n      }\n      return body.value;\n    } finally {\n      clearTimeout(timer);\n    }\n  };\n}\n","import { parseAtUri, type RecordMap, type RecordResolver } from \"./types.js\";\n\n/**\n * Minimal XRPC-shaped agent. Matches `@atiproto/agent.Agent`,\n * `@atproto/api.Agent`, and bare `@atproto/xrpc.XrpcClient`.\n */\nexport interface RecordResolverAgent {\n  call(\n    nsid: string,\n    params?: unknown,\n    data?: unknown,\n  ): Promise<{ data: unknown }>;\n}\n\n/**\n * Builds a RecordResolver that routes `getRecord` through an existing\n * XRPC client. Auth, retries, and proxying live on the client.\n */\nexport function createAgentRecordResolver(\n  agent: RecordResolverAgent,\n): RecordResolver {\n  return async (uri) => {\n    const { repo, collection, rkey } = parseAtUri(uri);\n    const res = await agent.call(\"com.atproto.repo.getRecord\", {\n      repo,\n      collection,\n      rkey,\n    });\n    const data = res.data as { value?: RecordMap } | undefined;\n    if (!data?.value || typeof data.value !== \"object\") {\n      throw new Error(`getRecord response missing value: ${uri}`);\n    }\n    return data.value;\n  };\n}\n","import type { SimpleStore } from \"@atproto-labs/simple-store\";\nimport { SimpleStoreMemory } from \"@atproto-labs/simple-store-memory\";\nimport {\n  createFetchRecordResolver,\n  type FetchRecordResolverOptions,\n} from \"./createFetchRecordResolver.js\";\nimport type { RecordMap, RecordResolver } from \"./types.js\";\n\nexport interface CachedRecordResolverOptions\n  extends FetchRecordResolverOptions {\n  /**\n   * Cache keyed by full `at://` URI. Defaults to an in-memory store\n   * with a 24-hour TTL bounded at 1000 entries. Proof records are\n   * content-addressed by their strongRef CID, so caching by URI is\n   * safe for an unlimited duration.\n   */\n  cache?: SimpleStore<string, RecordMap>;\n}\n\n/**\n * Builds a RecordResolver that wraps `createFetchRecordResolver` with\n * a `SimpleStore` cache. Safe by virtue of content-addressed\n * strongRefs.\n */\nexport function createCachedRecordResolver(\n  options: CachedRecordResolverOptions = {},\n): RecordResolver {\n  const fetcher = createFetchRecordResolver(options);\n  const cache =\n    options.cache ??\n    new SimpleStoreMemory<string, RecordMap>({\n      ttl: 86_400_000,\n      ttlAutopurge: true,\n      max: 1000,\n    });\n\n  return async (uri) => {\n    const cached = await cache.get(uri);\n    if (cached) return cached;\n    const record = await fetcher(uri);\n    void Promise.resolve(cache.set(uri, record)).catch(() => {});\n    return record;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,SAAS,WAAW,KAA0B;AACnD,MAAI,CAAC,IAAI,WAAW,OAAO,GAAG;AAC5B,UAAM,IAAI,MAAM,qBAAqB,GAAG,EAAE;AAAA,EAC5C;AACA,QAAM,CAAC,MAAM,YAAY,IAAI,IAAI,IAAI,MAAM,QAAQ,MAAM,EAAE,MAAM,GAAG;AACpE,MAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM;AACjC,UAAM,IAAI,MAAM,wBAAwB,GAAG,EAAE;AAAA,EAC/C;AACA,SAAO,EAAE,MAAM,YAAY,KAAK;AAClC;;;ACPA,IAAM,gBAAgB;AACtB,IAAM,kBAAkB;AAMjB,SAAS,0BACd,UAAsC,CAAC,GACvB;AAChB,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,YAAY,QAAQ,SAAS;AAEnC,SAAO,OAAO,QAAQ;AACpB,UAAM,EAAE,MAAM,YAAY,KAAK,IAAI,WAAW,GAAG;AAEjD,UAAM,MAAM,IAAI,IAAI,oCAAoC,KAAK;AAC7D,QAAI,aAAa,IAAI,QAAQ,IAAI;AACjC,QAAI,aAAa,IAAI,cAAc,UAAU;AAC7C,QAAI,aAAa,IAAI,QAAQ,IAAI;AAEjC,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAC1D,QAAI;AACF,YAAM,MAAM,MAAM,UAAU,KAAK;AAAA,QAC/B,QAAQ,WAAW;AAAA,QACnB,SAAS,EAAE,QAAQ,mBAAmB;AAAA,MACxC,CAAC;AACD,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI;AAAA,UACR,aAAa,IAAI,IAAI,UAAU,IAAI,IAAI,OAAO,IAAI,MAAM;AAAA,QAC1D;AAAA,MACF;AACA,YAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,UAAI,CAAC,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACjD,cAAM,IAAI,MAAM,qCAAqC,GAAG,EAAE;AAAA,MAC5D;AACA,aAAO,KAAK;AAAA,IACd,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AACF;;;ACxCO,SAAS,0BACd,OACgB;AAChB,SAAO,OAAO,QAAQ;AACpB,UAAM,EAAE,MAAM,YAAY,KAAK,IAAI,WAAW,GAAG;AACjD,UAAM,MAAM,MAAM,MAAM,KAAK,8BAA8B;AAAA,MACzD;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,OAAO,IAAI;AACjB,QAAI,CAAC,MAAM,SAAS,OAAO,KAAK,UAAU,UAAU;AAClD,YAAM,IAAI,MAAM,qCAAqC,GAAG,EAAE;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EACd;AACF;;;ACjCA,iCAAkC;AAuB3B,SAAS,2BACd,UAAuC,CAAC,GACxB;AAChB,QAAM,UAAU,0BAA0B,OAAO;AACjD,QAAM,QACJ,QAAQ,SACR,IAAI,6CAAqC;AAAA,IACvC,KAAK;AAAA,IACL,cAAc;AAAA,IACd,KAAK;AAAA,EACP,CAAC;AAEH,SAAO,OAAO,QAAQ;AACpB,UAAM,SAAS,MAAM,MAAM,IAAI,GAAG;AAClC,QAAI,OAAQ,QAAO;AACnB,UAAM,SAAS,MAAM,QAAQ,GAAG;AAChC,SAAK,QAAQ,QAAQ,MAAM,IAAI,KAAK,MAAM,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAC3D,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,90 @@
+// src/types.ts
+function parseAtUri(uri) {
+  if (!uri.startsWith("at://")) {
+    throw new Error(`Not an at:// URI: ${uri}`);
+  }
+  const [repo, collection, rkey] = uri.slice("at://".length).split("/");
+  if (!repo || !collection || !rkey) {
+    throw new Error(`Malformed at:// URI: ${uri}`);
+  }
+  return { repo, collection, rkey };
+}
+
+// src/createFetchRecordResolver.ts
+var DEFAULT_RELAY = "https://bsky.network";
+var DEFAULT_TIMEOUT = 3e3;
+function createFetchRecordResolver(options = {}) {
+  const relay = options.relay ?? DEFAULT_RELAY;
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const fetchImpl = options.fetch ?? fetch;
+  return async (uri) => {
+    const { repo, collection, rkey } = parseAtUri(uri);
+    const url = new URL("/xrpc/com.atproto.repo.getRecord", relay);
+    url.searchParams.set("repo", repo);
+    url.searchParams.set("collection", collection);
+    url.searchParams.set("rkey", rkey);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+      const res = await fetchImpl(url, {
+        signal: controller.signal,
+        headers: { accept: "application/json" }
+      });
+      if (!res.ok) {
+        throw new Error(
+          `getRecord ${repo}/${collection}/${rkey} -> ${res.status}`
+        );
+      }
+      const body = await res.json();
+      if (!body.value || typeof body.value !== "object") {
+        throw new Error(`getRecord response missing value: ${uri}`);
+      }
+      return body.value;
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+}
+
+// src/createAgentRecordResolver.ts
+function createAgentRecordResolver(agent) {
+  return async (uri) => {
+    const { repo, collection, rkey } = parseAtUri(uri);
+    const res = await agent.call("com.atproto.repo.getRecord", {
+      repo,
+      collection,
+      rkey
+    });
+    const data = res.data;
+    if (!data?.value || typeof data.value !== "object") {
+      throw new Error(`getRecord response missing value: ${uri}`);
+    }
+    return data.value;
+  };
+}
+
+// src/createCachedRecordResolver.ts
+import { SimpleStoreMemory } from "@atproto-labs/simple-store-memory";
+function createCachedRecordResolver(options = {}) {
+  const fetcher = createFetchRecordResolver(options);
+  const cache = options.cache ?? new SimpleStoreMemory({
+    ttl: 864e5,
+    ttlAutopurge: true,
+    max: 1e3
+  });
+  return async (uri) => {
+    const cached = await cache.get(uri);
+    if (cached) return cached;
+    const record = await fetcher(uri);
+    void Promise.resolve(cache.set(uri, record)).catch(() => {
+    });
+    return record;
+  };
+}
+export {
+  createAgentRecordResolver,
+  createCachedRecordResolver,
+  createFetchRecordResolver,
+  parseAtUri
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/createFetchRecordResolver.ts","../src/createAgentRecordResolver.ts","../src/createCachedRecordResolver.ts"],"sourcesContent":["import type { RecordMap, RecordResolver } from \"@atiproto/atproto-attestation\";\n\nexport type { RecordMap, RecordResolver };\n\n/**\n * Parsed pieces of an `at://{repo}/{collection}/{rkey}` URI.\n */\nexport interface ParsedAtUri {\n  repo: string;\n  collection: string;\n  rkey: string;\n}\n\nexport function parseAtUri(uri: string): ParsedAtUri {\n  if (!uri.startsWith(\"at://\")) {\n    throw new Error(`Not an at:// URI: ${uri}`);\n  }\n  const [repo, collection, rkey] = uri.slice(\"at://\".length).split(\"/\");\n  if (!repo || !collection || !rkey) {\n    throw new Error(`Malformed at:// URI: ${uri}`);\n  }\n  return { repo, collection, rkey };\n}\n","import { parseAtUri, type RecordMap, type RecordResolver } from \"./types.js\";\n\nexport interface FetchRecordResolverOptions {\n  /**\n   * Base URL of the relay (or PDS) used to fetch records. Calls land\n   * on `${relay}/xrpc/com.atproto.repo.getRecord`. Default:\n   * `https://bsky.network`.\n   */\n  relay?: string;\n  /** Request timeout in milliseconds. Default: `3000`. */\n  timeout?: number;\n  /** Override the global `fetch` (for tests, custom transports). */\n  fetch?: typeof fetch;\n}\n\nconst DEFAULT_RELAY = \"https://bsky.network\";\nconst DEFAULT_TIMEOUT = 3000;\n\n/**\n * Builds a RecordResolver that calls `com.atproto.repo.getRecord` on a\n * configurable relay (or PDS) over plain `fetch`. No auth.\n */\nexport function createFetchRecordResolver(\n  options: FetchRecordResolverOptions = {},\n): RecordResolver {\n  const relay = options.relay ?? DEFAULT_RELAY;\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const fetchImpl = options.fetch ?? fetch;\n\n  return async (uri) => {\n    const { repo, collection, rkey } = parseAtUri(uri);\n\n    const url = new URL(\"/xrpc/com.atproto.repo.getRecord\", relay);\n    url.searchParams.set(\"repo\", repo);\n    url.searchParams.set(\"collection\", collection);\n    url.searchParams.set(\"rkey\", rkey);\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeout);\n    try {\n      const res = await fetchImpl(url, {\n        signal: controller.signal,\n        headers: { accept: \"application/json\" },\n      });\n      if (!res.ok) {\n        throw new Error(\n          `getRecord ${repo}/${collection}/${rkey} -> ${res.status}`,\n        );\n      }\n      const body = (await res.json()) as { value?: RecordMap };\n      if (!body.value || typeof body.value !== \"object\") {\n        throw new Error(`getRecord response missing value: ${uri}`);\n      }\n      return body.value;\n    } finally {\n      clearTimeout(timer);\n    }\n  };\n}\n","import { parseAtUri, type RecordMap, type RecordResolver } from \"./types.js\";\n\n/**\n * Minimal XRPC-shaped agent. Matches `@atiproto/agent.Agent`,\n * `@atproto/api.Agent`, and bare `@atproto/xrpc.XrpcClient`.\n */\nexport interface RecordResolverAgent {\n  call(\n    nsid: string,\n    params?: unknown,\n    data?: unknown,\n  ): Promise<{ data: unknown }>;\n}\n\n/**\n * Builds a RecordResolver that routes `getRecord` through an existing\n * XRPC client. Auth, retries, and proxying live on the client.\n */\nexport function createAgentRecordResolver(\n  agent: RecordResolverAgent,\n): RecordResolver {\n  return async (uri) => {\n    const { repo, collection, rkey } = parseAtUri(uri);\n    const res = await agent.call(\"com.atproto.repo.getRecord\", {\n      repo,\n      collection,\n      rkey,\n    });\n    const data = res.data as { value?: RecordMap } | undefined;\n    if (!data?.value || typeof data.value !== \"object\") {\n      throw new Error(`getRecord response missing value: ${uri}`);\n    }\n    return data.value;\n  };\n}\n","import type { SimpleStore } from \"@atproto-labs/simple-store\";\nimport { SimpleStoreMemory } from \"@atproto-labs/simple-store-memory\";\nimport {\n  createFetchRecordResolver,\n  type FetchRecordResolverOptions,\n} from \"./createFetchRecordResolver.js\";\nimport type { RecordMap, RecordResolver } from \"./types.js\";\n\nexport interface CachedRecordResolverOptions\n  extends FetchRecordResolverOptions {\n  /**\n   * Cache keyed by full `at://` URI. Defaults to an in-memory store\n   * with a 24-hour TTL bounded at 1000 entries. Proof records are\n   * content-addressed by their strongRef CID, so caching by URI is\n   * safe for an unlimited duration.\n   */\n  cache?: SimpleStore<string, RecordMap>;\n}\n\n/**\n * Builds a RecordResolver that wraps `createFetchRecordResolver` with\n * a `SimpleStore` cache. Safe by virtue of content-addressed\n * strongRefs.\n */\nexport function createCachedRecordResolver(\n  options: CachedRecordResolverOptions = {},\n): RecordResolver {\n  const fetcher = createFetchRecordResolver(options);\n  const cache =\n    options.cache ??\n    new SimpleStoreMemory<string, RecordMap>({\n      ttl: 86_400_000,\n      ttlAutopurge: true,\n      max: 1000,\n    });\n\n  return async (uri) => {\n    const cached = await cache.get(uri);\n    if (cached) return cached;\n    const record = await fetcher(uri);\n    void Promise.resolve(cache.set(uri, record)).catch(() => {});\n    return record;\n  };\n}\n"],"mappings":";AAaO,SAAS,WAAW,KAA0B;AACnD,MAAI,CAAC,IAAI,WAAW,OAAO,GAAG;AAC5B,UAAM,IAAI,MAAM,qBAAqB,GAAG,EAAE;AAAA,EAC5C;AACA,QAAM,CAAC,MAAM,YAAY,IAAI,IAAI,IAAI,MAAM,QAAQ,MAAM,EAAE,MAAM,GAAG;AACpE,MAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM;AACjC,UAAM,IAAI,MAAM,wBAAwB,GAAG,EAAE;AAAA,EAC/C;AACA,SAAO,EAAE,MAAM,YAAY,KAAK;AAClC;;;ACPA,IAAM,gBAAgB;AACtB,IAAM,kBAAkB;AAMjB,SAAS,0BACd,UAAsC,CAAC,GACvB;AAChB,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,YAAY,QAAQ,SAAS;AAEnC,SAAO,OAAO,QAAQ;AACpB,UAAM,EAAE,MAAM,YAAY,KAAK,IAAI,WAAW,GAAG;AAEjD,UAAM,MAAM,IAAI,IAAI,oCAAoC,KAAK;AAC7D,QAAI,aAAa,IAAI,QAAQ,IAAI;AACjC,QAAI,aAAa,IAAI,cAAc,UAAU;AAC7C,QAAI,aAAa,IAAI,QAAQ,IAAI;AAEjC,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAC1D,QAAI;AACF,YAAM,MAAM,MAAM,UAAU,KAAK;AAAA,QAC/B,QAAQ,WAAW;AAAA,QACnB,SAAS,EAAE,QAAQ,mBAAmB;AAAA,MACxC,CAAC;AACD,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI;AAAA,UACR,aAAa,IAAI,IAAI,UAAU,IAAI,IAAI,OAAO,IAAI,MAAM;AAAA,QAC1D;AAAA,MACF;AACA,YAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,UAAI,CAAC,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACjD,cAAM,IAAI,MAAM,qCAAqC,GAAG,EAAE;AAAA,MAC5D;AACA,aAAO,KAAK;AAAA,IACd,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AACF;;;ACxCO,SAAS,0BACd,OACgB;AAChB,SAAO,OAAO,QAAQ;AACpB,UAAM,EAAE,MAAM,YAAY,KAAK,IAAI,WAAW,GAAG;AACjD,UAAM,MAAM,MAAM,MAAM,KAAK,8BAA8B;AAAA,MACzD;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,OAAO,IAAI;AACjB,QAAI,CAAC,MAAM,SAAS,OAAO,KAAK,UAAU,UAAU;AAClD,YAAM,IAAI,MAAM,qCAAqC,GAAG,EAAE;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EACd;AACF;;;ACjCA,SAAS,yBAAyB;AAuB3B,SAAS,2BACd,UAAuC,CAAC,GACxB;AAChB,QAAM,UAAU,0BAA0B,OAAO;AACjD,QAAM,QACJ,QAAQ,SACR,IAAI,kBAAqC;AAAA,IACvC,KAAK;AAAA,IACL,cAAc;AAAA,IACd,KAAK;AAAA,EACP,CAAC;AAEH,SAAO,OAAO,QAAQ;AACpB,UAAM,SAAS,MAAM,MAAM,IAAI,GAAG;AAClC,QAAI,OAAQ,QAAO;AACnB,UAAM,SAAS,MAAM,QAAQ,GAAG;AAChC,SAAK,QAAQ,QAAQ,MAAM,IAAI,KAAK,MAAM,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAC3D,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+import type { RecordMap, RecordResolver } from "@atiproto/atproto-attestation";
+export type { RecordMap, RecordResolver };
+/**
+ * Parsed pieces of an `at://{repo}/{collection}/{rkey}` URI.
+ */
+export interface ParsedAtUri {
+    repo: string;
+    collection: string;
+    rkey: string;
+}
+export declare function parseAtUri(uri: string): ParsedAtUri;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@atiproto/record-resolver",
+  "version": "0.1.0",
+  "description": "RecordResolver implementations for @atiproto/atproto-attestation: fetch-backed XRPC, agent-backed, and cached variants",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration",
+    "prepack": "npm run build",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Yakrware/atiproto.git",
+    "directory": "packages/record-resolver"
+  },
+  "homepage": "https://atiproto.com/docs/record-resolver",
+  "bugs": "https://github.com/Yakrware/atiproto/issues",
+  "license": "MIT",
+  "publishConfig": {
+    "tag": "beta",
+    "access": "public"
+  },
+  "dependencies": {
+    "@atiproto/atproto-attestation": "^0.1.0",
+    "@atproto-labs/simple-store": "^0.3.0",
+    "@atproto-labs/simple-store-memory": "^0.1.4"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
+  }
+}