@atproto-labs/handle-resolver 0.0.1 → 0.1.0

package/src/{well-known-handler-resolver.ts → internal-resolvers/well-known-handler-resolver.ts}

@@ -1,37 +1,44 @@
-import { Fetch } from '@atproto-labs/fetch'
-
 import {
-  HandleResolveOptions,
+  ResolveOptions,
   HandleResolver,
   ResolvedHandle,
   isResolvedHandle,
-} from './handle-resolver.js'
+} from '../types.js'
 
 export type WellKnownHandleResolverOptions = {
-  fetch?: Fetch
+  /**
+   * Fetch function to use for HTTP requests. Allows customizing the request
+   * behavior, e.g. adding headers, setting a timeout, mocking, etc. The
+   * provided fetch function will be wrapped with a safeFetchWrap function that
+   * adds SSRF protection.
+   *
+   * @default `globalThis.fetch`
+   */
+  fetch?: typeof globalThis.fetch
 }
 
 export class WellKnownHandleResolver implements HandleResolver {
-  protected readonly fetch: Fetch
+  protected readonly fetch: typeof globalThis.fetch
 
-  constructor({
-    fetch = globalThis.fetch,
-  }: WellKnownHandleResolverOptions = {}) {
-    this.fetch = fetch
+  constructor(options?: WellKnownHandleResolverOptions) {
+    this.fetch = options?.fetch ?? globalThis.fetch
   }
 
   public async resolve(
     handle: string,
-    options?: HandleResolveOptions,
+    options?: ResolveOptions,
   ): Promise<ResolvedHandle> {
     const url = new URL('/.well-known/atproto-did', `https://${handle}`)
 
     const headers = new Headers()
     if (options?.noCache) headers.set('cache-control', 'no-cache')
-    const request = new Request(url, { headers, signal: options?.signal })
 
     try {
-      const response = await (0, this.fetch)(request)
+      const response = await this.fetch.call(null, url, {
+        headers,
+        signal: options?.signal,
+        redirect: 'error',
+      })
       const text = await response.text()
       const firstLine = text.split('\n')[0]!.trim()
 
@@ -43,8 +50,6 @@ export class WellKnownHandleResolver implements HandleResolver {
       // unless the failure was due to the signal being aborted.
       options?.signal?.throwIfAborted()
 
-      // TODO: propagate some errors as-is (?)
-
       return null
     }
   }

package/src/types.ts

@@ -0,0 +1,33 @@
+import { Did, isAtprotoDidWeb, isDidPlc } from '@atproto/did'
+
+export type ResolveOptions = {
+  signal?: AbortSignal
+  noCache?: boolean
+}
+
+/**
+ * @see {@link https://atproto.com/specs/did#blessed-did-methods}
+ */
+export type ResolvedHandle = null | Did<'plc' | 'web'>
+
+export { type Did }
+
+/**
+ * @see {@link https://atproto.com/specs/did#blessed-did-methods}
+ */
+export function isResolvedHandle<T = unknown>(
+  value: T,
+): value is T & ResolvedHandle {
+  return value === null || isDidPlc(value) || isAtprotoDidWeb(value)
+}
+
+export interface HandleResolver {
+  /**
+   * @returns the DID that corresponds to the given handle, or `null` if no DID
+   * is found. `null` should only be returned if no unexpected behavior occurred
+   * during the resolution process.
+   * @throws Error if the resolution method fails due to an unexpected error, or
+   * if the resolution is aborted ({@link ResolveOptions}).
+   */
+  resolve(handle: string, options?: ResolveOptions): Promise<ResolvedHandle>
+}

package/tsconfig.build.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig/isomorphic.json",
+  "extends": "../../../tsconfig/isomorphic.json",
   "compilerOptions": {
     "rootDir": "./src",
     "outDir": "./dist"

package/dist/atproto-lexicon-handle-resolver.d.ts

@@ -1,36 +0,0 @@
-import { Fetch } from '@atproto-labs/fetch';
-import z from 'zod';
-import { HandleResolveOptions, HandleResolver, ResolvedHandle } from './handle-resolver.js';
-export declare const xrpcErrorSchema: z.ZodObject<{
-    error: z.ZodString;
-    message: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    error: string;
-    message?: string | undefined;
-}, {
-    error: string;
-    message?: string | undefined;
-}>;
-export type AtprotoLexiconHandleResolverOptions = {
-    /**
-     * Fetch function to use for HTTP requests. Allows customizing the request
-     * behavior, e.g. adding headers, setting a timeout, mocking, etc.
-     *
-     * @default globalThis.fetch
-     */
-    fetch?: Fetch;
-    /**
-     * URL of the atproto lexicon server. This is the base URL where the
-     * `com.atproto.identity.resolveHandle` XRPC method is located.
-     *
-     * @default 'https://bsky.social'
-     */
-    url?: URL | string;
-};
-export declare class AtprotoLexiconHandleResolver implements HandleResolver {
-    protected readonly url: URL;
-    protected readonly fetch: Fetch;
-    constructor({ url, fetch, }?: AtprotoLexiconHandleResolverOptions);
-    resolve(handle: string, options?: HandleResolveOptions): Promise<ResolvedHandle>;
-}
-//# sourceMappingURL=atproto-lexicon-handle-resolver.d.ts.map

package/dist/atproto-lexicon-handle-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"atproto-lexicon-handle-resolver.d.ts","sourceRoot":"","sources":["../src/atproto-lexicon-handle-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,cAAc,EAEf,MAAM,sBAAsB,CAAA;AAE7B,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAA;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb;;;;;OAKG;IACH,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAA;CACnB,CAAA;AAED,qBAAa,4BAA6B,YAAW,cAAc;IACjE,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IAC3B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;gBAEnB,EACV,GAA4B,EAC5B,KAAwB,GACzB,GAAE,mCAAwC;IAK9B,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;CAuC3B"}

package/dist/atproto-lexicon-handle-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"atproto-lexicon-handle-resolver.js","sourceRoot":"","sources":["../src/atproto-lexicon-handle-resolver.ts"],"names":[],"mappings":";;;;;;AACA,8CAAmB;AAEnB,6DAK6B;AAEhB,QAAA,eAAe,GAAG,aAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,aAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA;AAoBF,MAAa,4BAA4B;IAIvC,YAAY,EACV,GAAG,GAAG,sBAAsB,EAC5B,KAAK,GAAG,UAAU,CAAC,KAAK,MACe,EAAE;QANxB;;;;;WAAQ;QACR;;;;;WAAY;QAM7B,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,MAAc,EACd,OAA8B;QAE9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,0CAA0C,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QACzE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAEtC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAC7B,IAAI,OAAO,EAAE,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;QAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAEtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACrD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAErC,gCAAgC;QAChC,0FAA0F;QAC1F,qDAAqD;QACrD,iFAAiF;QAEjF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,uBAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC3C,IACE,IAAI,CAAC,KAAK,KAAK,gBAAgB;gBAC/B,IAAI,CAAC,OAAO,KAAK,0BAA0B,EAC3C,CAAC;gBACD,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC/D,CAAC;QAED,MAAM,KAAK,GAAY,OAAO,EAAE,GAAG,CAAA;QAEnC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAA,qCAAgB,EAAC,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACnE,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAtDD,oEAsDC"}

package/dist/handle-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handle-resolver.d.ts","sourceRoot":"","sources":["../src/handle-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAS,MAAM,mBAAmB,CAAA;AAE9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AACD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,GAAG,CAAA;AAEvC,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,KAAK,EAAE,CAAC,GACP,KAAK,IAAI,CAAC,GAAG,cAAc,CAE7B;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAAA;CAC3B"}

package/dist/handle-resolver.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isResolvedHandle = void 0;
-const did_1 = require("@atproto-labs/did");
-function isResolvedHandle(value) {
-    return value === null || (typeof value === 'string' && (0, did_1.isDid)(value));
-}
-exports.isResolvedHandle = isResolvedHandle;
-//# sourceMappingURL=handle-resolver.js.map

package/dist/handle-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handle-resolver.js","sourceRoot":"","sources":["../src/handle-resolver.ts"],"names":[],"mappings":";;;AAAA,2CAA8C;AAQ9C,SAAgB,gBAAgB,CAC9B,KAAQ;IAER,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,WAAK,EAAC,KAAK,CAAC,CAAC,CAAA;AACtE,CAAC;AAJD,4CAIC"}

package/dist/serial-handle-resolver.d.ts

@@ -1,7 +0,0 @@
-import { HandleResolveOptions, HandleResolver, ResolvedHandle } from './handle-resolver.js';
-export declare class SerialHandleResolver implements HandleResolver {
-    protected readonly resolvers: readonly HandleResolver[];
-    constructor(resolvers: readonly HandleResolver[]);
-    resolve(handle: string, options?: HandleResolveOptions): Promise<ResolvedHandle>;
-}
-//# sourceMappingURL=serial-handle-resolver.d.ts.map

package/dist/serial-handle-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serial-handle-resolver.d.ts","sourceRoot":"","sources":["../src/serial-handle-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,qBAAa,oBAAqB,YAAW,cAAc;IAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE;gBAApC,SAAS,EAAE,SAAS,cAAc,EAAE;IAMtD,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;CAY3B"}

package/dist/serial-handle-resolver.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SerialHandleResolver = void 0;
-class SerialHandleResolver {
-    constructor(resolvers) {
-        Object.defineProperty(this, "resolvers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: resolvers
-        });
-        if (!resolvers.length) {
-            throw new TypeError('At least one resolver is required');
-        }
-    }
-    async resolve(handle, options) {
-        for (const resolver of this.resolvers) {
-            options?.signal?.throwIfAborted();
-            const value = await resolver.resolve(handle, options);
-            if (value)
-                return value;
-        }
-        // If no resolver was able to resolve the handle, assume there is no DID
-        // corresponding to the handle.
-        return null;
-    }
-}
-exports.SerialHandleResolver = SerialHandleResolver;
-//# sourceMappingURL=serial-handle-resolver.js.map

package/dist/serial-handle-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serial-handle-resolver.js","sourceRoot":"","sources":["../src/serial-handle-resolver.ts"],"names":[],"mappings":";;;AAMA,MAAa,oBAAoB;IAC/B,YAA+B,SAAoC;QAAvD;;;;mBAAmB,SAAS;WAA2B;QACjE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,MAAc,EACd,OAA8B;QAE9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;YAEjC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACrD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;QAED,wEAAwE;QACxE,+BAA+B;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAtBD,oDAsBC"}

package/dist/universal-handle-resolver.d.ts

@@ -1,32 +0,0 @@
-import { GenericStore } from '@atproto-labs/caching';
-import { Fetch } from '@atproto-labs/fetch';
-import { CachedHandleResolver } from './cached-handle-resolver.js';
-import { HandleResolver, ResolvedHandle } from './handle-resolver.js';
-import { AtprotoLexiconHandleResolverOptions } from './atproto-lexicon-handle-resolver.js';
-export type HandleResolverCache = GenericStore<string, ResolvedHandle>;
-export type UniversalHandleResolverOptions = {
-    cache?: HandleResolverCache;
-    /**
-     * Fetch function to use for HTTP requests. Allows customizing the request
-     * behavior, e.g. adding headers, setting a timeout, mocking, etc.
-     *
-     * When using this library from a Node.js environment, you may want to use
-     * `safeFetchWrap()` from `@atproto-labs/fetch-node` to add SSRF protection.
-     *
-     * @default `globalThis.fetch`
-     */
-    fetch?: Fetch;
-    /**
-     * @see {@link AtprotoLexiconHandleResolverOptions.url}
-     */
-    atprotoLexiconUrl?: AtprotoLexiconHandleResolverOptions['url'];
-};
-/**
- * A handle resolver that works in any environment that supports `fetch()`. This
- * relies on the a public XRPC implementing "com.atproto.identity.resolveHandle"
- * to resolve handles.
- */
-export declare class UniversalHandleResolver extends CachedHandleResolver implements HandleResolver {
-    constructor({ fetch, cache, atprotoLexiconUrl, }?: UniversalHandleResolverOptions);
-}
-//# sourceMappingURL=universal-handle-resolver.d.ts.map

package/dist/universal-handle-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"universal-handle-resolver.d.ts","sourceRoot":"","sources":["../src/universal-handle-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAEL,mCAAmC,EACpC,MAAM,sCAAsC,CAAA;AAI7C,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEtE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,CAAC,EAAE,mBAAmB,CAAA;IAE3B;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb;;OAEG;IACH,iBAAiB,CAAC,EAAE,mCAAmC,CAAC,KAAK,CAAC,CAAA;CAC/D,CAAA;AAED;;;;GAIG;AACH,qBAAa,uBACX,SAAQ,oBACR,YAAW,cAAc;gBAEb,EACV,KAAwB,EACxB,KAAK,EACL,iBAAiB,GAClB,GAAE,8BAAmC;CAUvC"}

package/dist/universal-handle-resolver.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniversalHandleResolver = void 0;
-const cached_handle_resolver_js_1 = require("./cached-handle-resolver.js");
-const atproto_lexicon_handle_resolver_js_1 = require("./atproto-lexicon-handle-resolver.js");
-const serial_handle_resolver_js_1 = require("./serial-handle-resolver.js");
-const well_known_handler_resolver_js_1 = require("./well-known-handler-resolver.js");
-/**
- * A handle resolver that works in any environment that supports `fetch()`. This
- * relies on the a public XRPC implementing "com.atproto.identity.resolveHandle"
- * to resolve handles.
- */
-class UniversalHandleResolver extends cached_handle_resolver_js_1.CachedHandleResolver {
-    constructor({ fetch = globalThis.fetch, cache, atprotoLexiconUrl, } = {}) {
-        const resolver = new serial_handle_resolver_js_1.SerialHandleResolver([
-            // Try the well-known method first, allowing to reduce the load on the
-            // XRPC.
-            new well_known_handler_resolver_js_1.WellKnownHandleResolver({ fetch }),
-            new atproto_lexicon_handle_resolver_js_1.AtprotoLexiconHandleResolver({ fetch, url: atprotoLexiconUrl }),
-        ]);
-        super({ resolver, cache });
-    }
-}
-exports.UniversalHandleResolver = UniversalHandleResolver;
-//# sourceMappingURL=universal-handle-resolver.js.map

package/dist/universal-handle-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"universal-handle-resolver.js","sourceRoot":"","sources":["../src/universal-handle-resolver.ts"],"names":[],"mappings":";;;AAGA,2EAAkE;AAElE,6FAG6C;AAC7C,2EAAkE;AAClE,qFAA0E;AAwB1E;;;;GAIG;AACH,MAAa,uBACX,SAAQ,gDAAoB;IAG5B,YAAY,EACV,KAAK,GAAG,UAAU,CAAC,KAAK,EACxB,KAAK,EACL,iBAAiB,MACiB,EAAE;QACpC,MAAM,QAAQ,GAAG,IAAI,gDAAoB,CAAC;YACxC,sEAAsE;YACtE,QAAQ;YACR,IAAI,wDAAuB,CAAC,EAAE,KAAK,EAAE,CAAC;YACtC,IAAI,iEAA4B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC;SACpE,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5B,CAAC;CACF;AAlBD,0DAkBC"}

package/dist/well-known-handler-resolver.d.ts

@@ -1,11 +0,0 @@
-import { Fetch } from '@atproto-labs/fetch';
-import { HandleResolveOptions, HandleResolver, ResolvedHandle } from './handle-resolver.js';
-export type WellKnownHandleResolverOptions = {
-    fetch?: Fetch;
-};
-export declare class WellKnownHandleResolver implements HandleResolver {
-    protected readonly fetch: Fetch;
-    constructor({ fetch, }?: WellKnownHandleResolverOptions);
-    resolve(handle: string, options?: HandleResolveOptions): Promise<ResolvedHandle>;
-}
-//# sourceMappingURL=well-known-handler-resolver.d.ts.map

package/dist/well-known-handler-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"well-known-handler-resolver.d.ts","sourceRoot":"","sources":["../src/well-known-handler-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,cAAc,EAEf,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;gBAEnB,EACV,KAAwB,GACzB,GAAE,8BAAmC;IAIzB,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;CAyB3B"}

package/dist/well-known-handler-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"well-known-handler-resolver.js","sourceRoot":"","sources":["../src/well-known-handler-resolver.ts"],"names":[],"mappings":";;;AAEA,6DAK6B;AAM7B,MAAa,uBAAuB;IAGlC,YAAY,EACV,KAAK,GAAG,UAAU,CAAC,KAAK,MACU,EAAE;QAJnB;;;;;WAAY;QAK7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,MAAc,EACd,OAA8B;QAE9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,0BAA0B,EAAE,WAAW,MAAM,EAAE,CAAC,CAAA;QAEpE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAC7B,IAAI,OAAO,EAAE,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;QAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAEtE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAA;YAC/C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAA;YAE7C,IAAI,IAAA,qCAAgB,EAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAA;YAEjD,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,uEAAuE;YACvE,0DAA0D;YAC1D,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;YAEjC,wCAAwC;YAExC,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;CACF;AArCD,0DAqCC"}

package/src/handle-resolver.ts

@@ -1,27 +0,0 @@
-import { Did, isDid } from '@atproto-labs/did'
-
-export type HandleResolveOptions = {
-  signal?: AbortSignal
-  noCache?: boolean
-}
-export type ResolvedHandle = null | Did
-
-export function isResolvedHandle<T = unknown>(
-  value: T,
-): value is T & ResolvedHandle {
-  return value === null || (typeof value === 'string' && isDid(value))
-}
-
-export interface HandleResolver {
-  /**
-   * @returns the DID that corresponds to the given handle, or `null` if no DID
-   * is found. `null` should only be returned if no unexpected behavior occurred
-   * during the resolution process.
-   * @throws Error if the resolution method fails due to an unexpected error, or
-   * if the resolution is aborted ({@link HandleResolveOptions.signal}).
-   */
-  resolve(
-    handle: string,
-    options?: HandleResolveOptions,
-  ): Promise<ResolvedHandle>
-}

package/src/serial-handle-resolver.ts

@@ -1,29 +0,0 @@
-import {
-  HandleResolveOptions,
-  HandleResolver,
-  ResolvedHandle,
-} from './handle-resolver.js'
-
-export class SerialHandleResolver implements HandleResolver {
-  constructor(protected readonly resolvers: readonly HandleResolver[]) {
-    if (!resolvers.length) {
-      throw new TypeError('At least one resolver is required')
-    }
-  }
-
-  public async resolve(
-    handle: string,
-    options?: HandleResolveOptions,
-  ): Promise<ResolvedHandle> {
-    for (const resolver of this.resolvers) {
-      options?.signal?.throwIfAborted()
-
-      const value = await resolver.resolve(handle, options)
-      if (value) return value
-    }
-
-    // If no resolver was able to resolve the handle, assume there is no DID
-    // corresponding to the handle.
-    return null
-  }
-}

package/src/universal-handle-resolver.ts

@@ -1,58 +0,0 @@
-import { GenericStore } from '@atproto-labs/caching'
-import { Fetch } from '@atproto-labs/fetch'
-
-import { CachedHandleResolver } from './cached-handle-resolver.js'
-import { HandleResolver, ResolvedHandle } from './handle-resolver.js'
-import {
-  AtprotoLexiconHandleResolver,
-  AtprotoLexiconHandleResolverOptions,
-} from './atproto-lexicon-handle-resolver.js'
-import { SerialHandleResolver } from './serial-handle-resolver.js'
-import { WellKnownHandleResolver } from './well-known-handler-resolver.js'
-
-export type HandleResolverCache = GenericStore<string, ResolvedHandle>
-
-export type UniversalHandleResolverOptions = {
-  cache?: HandleResolverCache
-
-  /**
-   * Fetch function to use for HTTP requests. Allows customizing the request
-   * behavior, e.g. adding headers, setting a timeout, mocking, etc.
-   *
-   * When using this library from a Node.js environment, you may want to use
-   * `safeFetchWrap()` from `@atproto-labs/fetch-node` to add SSRF protection.
-   *
-   * @default `globalThis.fetch`
-   */
-  fetch?: Fetch
-
-  /**
-   * @see {@link AtprotoLexiconHandleResolverOptions.url}
-   */
-  atprotoLexiconUrl?: AtprotoLexiconHandleResolverOptions['url']
-}
-
-/**
- * A handle resolver that works in any environment that supports `fetch()`. This
- * relies on the a public XRPC implementing "com.atproto.identity.resolveHandle"
- * to resolve handles.
- */
-export class UniversalHandleResolver
-  extends CachedHandleResolver
-  implements HandleResolver
-{
-  constructor({
-    fetch = globalThis.fetch,
-    cache,
-    atprotoLexiconUrl,
-  }: UniversalHandleResolverOptions = {}) {
-    const resolver = new SerialHandleResolver([
-      // Try the well-known method first, allowing to reduce the load on the
-      // XRPC.
-      new WellKnownHandleResolver({ fetch }),
-      new AtprotoLexiconHandleResolver({ fetch, url: atprotoLexiconUrl }),
-    ])
-
-    super({ resolver, cache })
-  }
-}