@atcute/identity-resolver 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @atcute/identity-resolver
+
+atproto handle and DID document resolution
+
+```ts
+// handle resolution
+const handleResolver = new CompositeHandleResolver({
+	strategy: 'race',
+	methods: {
+		dns: new DohJsonHandleResolver({ dohUrl: 'https://mozilla.cloudflare-dns.com/dns-query' }),
+		http: new WellKnownHandleResolver(),
+	},
+});
+
+try {
+	const handle = await handleResolver.resolve('bsky.app');
+	//    ^? 'did:plc:z72i7hdynmk6r22z27h6tvur'
+} catch (err) {
+	if (err instanceof DidNotFoundError) {
+		// handle returned no did
+	}
+	if (err instanceof InvalidResolvedHandleError) {
+		// handle returned a did, but isn't a valid atproto did
+	}
+	if (err instanceof AmbiguousHandleError) {
+		// handle returned multiple did values
+	}
+	if (err instanceof FailedHandleResolutionError) {
+		// handle resolution had thrown something unexpected (fetch error)
+	}
+
+	if (err instanceof HandleResolutionError) {
+		// the errors above extend this class, so you can do a catch-all.
+	}
+}
+
+// DID document resolution
+const docResolver = new CompositeDidDocumentResolver({
+	methods: {
+		plc: new PlcDidDocumentResolver(),
+		web: new WebDidDocumentResolver(),
+	},
+});
+
+try {
+	const doc = await docResolver.resolve('did:plc:z72i7hdynmk6r22z27h6tvur');
+	//    ^? { '@context': [...], id: 'did:plc:z72i7hdynmk6r22z27h6tvur', ... }
+} catch (err) {
+	if (err instanceof DocumentNotFoundError) {
+		// did returned no document
+	}
+	if (err instanceof UnsupportedDidMethodError) {
+		// resolver doesn't support did method (composite resolver)
+	}
+	if (err instanceof ImproperDidError) {
+		// resolver considers did as invalid (atproto did:web)
+	}
+	if (err instanceof FailedDocumentResolutionError) {
+		// document resolution had thrown something unexpected (fetch error)
+	}
+
+	if (err instanceof HandleResolutionError) {
+		// the errors above extend this class, so you can do a catch-all.
+	}
+}
+```

package/dist/did/composite.d.ts

@@ -0,0 +1,12 @@
+import { type Did, type DidDocument } from '@atcute/identity';
+import type { DidDocumentResolver, ResolveDidDocumentOptions } from '../types.js';
+export interface CompositeDidDocumentResolverOptions<M extends string> {
+    methods: {
+        [K in M]: DidDocumentResolver<K>;
+    };
+}
+export declare class CompositeDidDocumentResolver<M extends string> implements DidDocumentResolver<M> {
+    #private;
+    constructor({ methods }: CompositeDidDocumentResolverOptions<M>);
+    resolve(did: Did<M>, options?: ResolveDidDocumentOptions): Promise<DidDocument>;
+}

package/dist/did/composite.js

@@ -0,0 +1,17 @@
+import { extractDidMethod } from '@atcute/identity';
+import * as err from '../errors.js';
+export class CompositeDidDocumentResolver {
+    #methods;
+    constructor({ methods }) {
+        this.#methods = new Map(Object.entries(methods));
+    }
+    async resolve(did, options) {
+        const method = extractDidMethod(did);
+        const resolver = this.#methods.get(method);
+        if (resolver === undefined) {
+            throw new err.UnsupportedDidMethodError(did);
+        }
+        return await resolver.resolve(did, options);
+    }
+}
+//# sourceMappingURL=composite.js.map

package/dist/did/composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../../lib/did/composite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kBAAkB,CAAC;AAEhF,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAOpC,MAAM,OAAO,4BAA4B;IACxC,QAAQ,CAAsC;IAE9C,YAAY,EAAE,OAAO,EAA0C;QAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAAmC;QAC7D,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACD"}

package/dist/did/methods/plc.d.ts

@@ -0,0 +1,12 @@
+import { type Did, type DidDocument } from '@atcute/identity';
+import type { DidDocumentResolver, ResolveDidDocumentOptions } from '../../types.js';
+export interface PlcDidDocumentResolverOptions {
+    apiUrl?: string;
+    fetch?: typeof fetch;
+}
+export declare class PlcDidDocumentResolver implements DidDocumentResolver<'plc'> {
+    #private;
+    readonly apiUrl: string;
+    constructor({ apiUrl, fetch: fetchThis, }?: PlcDidDocumentResolverOptions);
+    resolve(did: Did<'plc'>, options?: ResolveDidDocumentOptions): Promise<DidDocument>;
+}

package/dist/did/methods/plc.js

@@ -0,0 +1,34 @@
+import {} from '@atcute/identity';
+import { FailedResponseError } from '@atcute/util-fetch';
+import * as err from '../../errors.js';
+import { fetchDocHandler } from '../utils.js';
+export class PlcDidDocumentResolver {
+    apiUrl;
+    #fetch;
+    constructor({ apiUrl = 'https://plc.directory', fetch: fetchThis = fetch, } = {}) {
+        this.apiUrl = apiUrl;
+        this.#fetch = fetchThis;
+    }
+    async resolve(did, options) {
+        let json;
+        try {
+            const url = new URL(`/${encodeURIComponent(did)}`, this.apiUrl);
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : 'default',
+                redirect: 'error',
+                headers: { accept: 'application/did+ld+json,application/json' },
+            });
+            const handled = await fetchDocHandler(response);
+            json = handled.json;
+        }
+        catch (cause) {
+            if (cause instanceof FailedResponseError && cause.status === 404) {
+                throw new err.DocumentNotFoundError(did);
+            }
+            throw new err.FailedDocumentResolutionError(did, { cause });
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=plc.js.map

package/dist/did/methods/plc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plc.js","sourceRoot":"","sources":["../../../lib/did/methods/plc.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAS;IACxB,MAAM,CAAe;IAErB,YAAY,EACX,MAAM,GAAG,uBAAuB,EAChC,KAAK,EAAE,SAAS,GAAG,KAAK,MACU,EAAE;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAAmC;QACjE,IAAI,IAAiB,CAAC;QAEtB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhE,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE;gBAC5C,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBAChD,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE;aAC/D,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEhD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClE,MAAM,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/did/methods/web.d.ts

@@ -0,0 +1,15 @@
+import { type Did, type DidDocument } from '@atcute/identity';
+import type { DidDocumentResolver, ResolveDidDocumentOptions } from '../../types.js';
+export interface WebDidDocumentResolverOptions {
+    fetch?: typeof fetch;
+}
+export declare class WebDidDocumentResolver implements DidDocumentResolver<'web'> {
+    #private;
+    constructor({ fetch: fetchThis }?: WebDidDocumentResolverOptions);
+    resolve(did: Did<'web'>, options?: ResolveDidDocumentOptions): Promise<DidDocument>;
+}
+export declare class AtprotoWebDidDocumentResolver implements DidDocumentResolver<'web'> {
+    #private;
+    constructor({ fetch: fetchThis }?: WebDidDocumentResolverOptions);
+    resolve(did: Did<'web'>, options?: ResolveDidDocumentOptions): Promise<DidDocument>;
+}

package/dist/did/methods/web.js

@@ -0,0 +1,63 @@
+import { webDidToDocumentUrl } from '@atcute/identity';
+import { FailedResponseError } from '@atcute/util-fetch';
+import * as err from '../../errors.js';
+import { fetchDocHandler } from '../utils.js';
+export class WebDidDocumentResolver {
+    #fetch;
+    constructor({ fetch: fetchThis = fetch } = {}) {
+        this.#fetch = fetchThis;
+    }
+    async resolve(did, options) {
+        let json;
+        try {
+            const url = webDidToDocumentUrl(did);
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : 'default',
+                redirect: 'error',
+                headers: { accept: 'application/did+ld+json,application/json' },
+            });
+            const handled = await fetchDocHandler(response);
+            json = handled.json;
+        }
+        catch (cause) {
+            if (cause instanceof FailedResponseError && cause.status === 404) {
+                throw new err.DocumentNotFoundError(did);
+            }
+            throw new err.FailedDocumentResolutionError(did, { cause });
+        }
+        return json;
+    }
+}
+export class AtprotoWebDidDocumentResolver {
+    #fetch;
+    constructor({ fetch: fetchThis = fetch } = {}) {
+        this.#fetch = fetchThis;
+    }
+    async resolve(did, options) {
+        const [host, ...paths] = did.slice(8).split(':').map(decodeURIComponent);
+        const url = new URL(`https://${host}/.well-known/did.json`);
+        if (paths.length > 0) {
+            throw new err.ImproperDidError(did);
+        }
+        let json;
+        try {
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : 'default',
+                redirect: 'error',
+                headers: { accept: 'application/did+ld+json,application/json' },
+            });
+            const handled = await fetchDocHandler(response);
+            json = handled.json;
+        }
+        catch (cause) {
+            if (cause instanceof FailedResponseError && cause.status === 404) {
+                throw new err.DocumentNotFoundError(did);
+            }
+            throw new err.FailedDocumentResolutionError(did, { cause });
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/did/methods/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../lib/did/methods/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA8B,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,OAAO,sBAAsB;IAClC,MAAM,CAAe;IAErB,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,KAAoC,EAAE;QAC3E,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAAmC;QACjE,IAAI,IAAiB,CAAC;QAEtB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAErC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE;gBAC5C,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBAChD,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE;aAC/D,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEhD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClE,MAAM,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AAED,MAAM,OAAO,6BAA6B;IACzC,MAAM,CAAe;IAErB,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,KAAoC,EAAE;QAC3E,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAAmC;QACjE,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,IAAI,uBAAuB,CAAC,CAAC;QAE5D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,IAAiB,CAAC;QAEtB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE;gBAC5C,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBAChD,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE;aAC/D,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEhD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClE,MAAM,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/did/utils.d.ts

@@ -0,0 +1 @@
+export declare const fetchDocHandler: (input: Response) => Promise<import("@atcute/util-fetch").ParsedJsonResponse<import("@atcute/identity").DidDocument>>;

package/dist/did/utils.js

@@ -0,0 +1,4 @@
+import { defs } from '@atcute/identity';
+import { isResponseOk, parseResponseAsJson, pipe, validateJsonWith } from '@atcute/util-fetch';
+export const fetchDocHandler = pipe(isResponseOk, parseResponseAsJson(/^application\/(did\+ld\+)?json$/, 20 * 1024), validateJsonWith(defs.didDocument, { mode: 'passthrough' }));
+//# sourceMappingURL=utils.js.map

package/dist/did/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../lib/did/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE/F,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAClC,YAAY,EACZ,mBAAmB,CAAC,iCAAiC,EAAE,EAAE,GAAG,IAAI,CAAC,EACjE,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAC3D,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+import type { Did } from '@atcute/identity';
+export declare class DidDocumentResolutionError extends Error {
+    name: string;
+}
+export declare class UnsupportedDidMethodError extends DidDocumentResolutionError {
+    did: Did;
+    name: string;
+    constructor(did: Did);
+}
+export declare class ImproperDidError extends DidDocumentResolutionError {
+    did: Did;
+    name: string;
+    constructor(did: Did);
+}
+export declare class DocumentNotFoundError extends DidDocumentResolutionError {
+    did: Did;
+    name: string;
+    constructor(did: Did);
+}
+export declare class FailedDocumentResolutionError extends DidDocumentResolutionError {
+    did: Did;
+    name: string;
+    constructor(did: Did, options?: ErrorOptions);
+}
+export declare class HandleResolutionError extends Error {
+    name: string;
+}
+export declare class DidNotFoundError extends HandleResolutionError {
+    handle: string;
+    name: string;
+    constructor(handle: string);
+}
+export declare class FailedHandleResolutionError extends HandleResolutionError {
+    handle: string;
+    name: string;
+    constructor(handle: string, options?: ErrorOptions);
+}
+export declare class InvalidResolvedHandleError extends HandleResolutionError {
+    handle: string;
+    did: string;
+    name: string;
+    constructor(handle: string, did: string);
+}
+export declare class AmbiguousHandleError extends HandleResolutionError {
+    name: string;
+    constructor(handle: string);
+}

package/dist/errors.js

@@ -0,0 +1,75 @@
+// #region DID document resolution errors
+export class DidDocumentResolutionError extends Error {
+    name = 'DidResolutionError';
+}
+export class UnsupportedDidMethodError extends DidDocumentResolutionError {
+    did;
+    name = 'UnsupportedDidMethodError';
+    constructor(did) {
+        super(`unsupported did method; did=${did}`);
+        this.did = did;
+    }
+}
+export class ImproperDidError extends DidDocumentResolutionError {
+    did;
+    name = 'ImproperDidError';
+    constructor(did) {
+        super(`improper did; did=${did}`);
+        this.did = did;
+    }
+}
+export class DocumentNotFoundError extends DidDocumentResolutionError {
+    did;
+    name = 'DocumentNotFoundError';
+    constructor(did) {
+        super(`did document not found; did=${did}`);
+        this.did = did;
+    }
+}
+export class FailedDocumentResolutionError extends DidDocumentResolutionError {
+    did;
+    name = 'FailedDocumentResolutionError';
+    constructor(did, options) {
+        super(`failed to resolve did document; did=${did}`, options);
+        this.did = did;
+    }
+}
+// #endregion
+// #region Handle resolution errors
+export class HandleResolutionError extends Error {
+    name = 'HandleResolutionError';
+}
+export class DidNotFoundError extends HandleResolutionError {
+    handle;
+    name = 'DidNotFoundError';
+    constructor(handle) {
+        super(`handle returned no did; handle=${handle}`);
+        this.handle = handle;
+    }
+}
+export class FailedHandleResolutionError extends HandleResolutionError {
+    handle;
+    name = 'FailedHandleResolutionError';
+    constructor(handle, options) {
+        super(`failed to resolve handle; handle=${handle}`, options);
+        this.handle = handle;
+    }
+}
+export class InvalidResolvedHandleError extends HandleResolutionError {
+    handle;
+    did;
+    name = 'InvalidResolvedHandleError';
+    constructor(handle, did) {
+        super(`handle returned invalid did; handle=${handle}; did=${did}`);
+        this.handle = handle;
+        this.did = did;
+    }
+}
+export class AmbiguousHandleError extends HandleResolutionError {
+    name = 'AmbiguousHandleError';
+    constructor(handle) {
+        super(`handle returned multiple did values; handle=${handle}`);
+    }
+}
+// #endregion
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC3C,IAAI,GAAG,oBAAoB,CAAC;CACrC;AAED,MAAM,OAAO,yBAA0B,SAAQ,0BAA0B;IAGrD;IAFV,IAAI,GAAG,2BAA2B,CAAC;IAE5C,YAAmB,GAAQ;QAC1B,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QAD1B,QAAG,GAAH,GAAG,CAAK;IAE3B,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,0BAA0B;IAG5C;IAFV,IAAI,GAAG,kBAAkB,CAAC;IAEnC,YAAmB,GAAQ;QAC1B,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QADhB,QAAG,GAAH,GAAG,CAAK;IAE3B,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,0BAA0B;IAGjD;IAFV,IAAI,GAAG,uBAAuB,CAAC;IAExC,YAAmB,GAAQ;QAC1B,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QAD1B,QAAG,GAAH,GAAG,CAAK;IAE3B,CAAC;CACD;AAED,MAAM,OAAO,6BAA8B,SAAQ,0BAA0B;IAIpE;IAHC,IAAI,GAAG,+BAA+B,CAAC;IAEhD,YACQ,GAAQ,EACf,OAAsB;QAEtB,KAAK,CAAC,uCAAuC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAHtD,QAAG,GAAH,GAAG,CAAK;IAIhB,CAAC;CACD;AACD,aAAa;AAEb,mCAAmC;AACnC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACtC,IAAI,GAAG,uBAAuB,CAAC;CACxC;AAED,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IAGvC;IAFV,IAAI,GAAG,kBAAkB,CAAC;IAEnC,YAAmB,MAAc;QAChC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;QADhC,WAAM,GAAN,MAAM,CAAQ;IAEjC,CAAC;CACD;AAED,MAAM,OAAO,2BAA4B,SAAQ,qBAAqB;IAI7D;IAHC,IAAI,GAAG,6BAA6B,CAAC;IAE9C,YACQ,MAAc,EACrB,OAAsB;QAEtB,KAAK,CAAC,oCAAoC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAHtD,WAAM,GAAN,MAAM,CAAQ;IAItB,CAAC;CACD;AAED,MAAM,OAAO,0BAA2B,SAAQ,qBAAqB;IAI5D;IACA;IAJC,IAAI,GAAG,4BAA4B,CAAC;IAE7C,YACQ,MAAc,EACd,GAAW;QAElB,KAAK,CAAC,uCAAuC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;QAH5D,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAQ;IAGnB,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,qBAAqB;IACrD,IAAI,GAAG,sBAAsB,CAAC;IAEvC,YAAY,MAAc;QACzB,KAAK,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;CACD;AACD,aAAa"}

package/dist/handle/composite.d.ts

@@ -0,0 +1,15 @@
+import type { AtprotoDid, Handle } from '@atcute/identity';
+import type { HandleResolver, ResolveHandleOptions } from '../types.js';
+export type CompositeStrategy = 'http-first' | 'dns-first' | 'race' | 'both';
+export interface CompositeHandleResolverOptions {
+    /** controls how the resolution is done, defaults to 'race' */
+    strategy?: CompositeStrategy;
+    /** the methods to use for resolving the handle. */
+    methods: Record<'http' | 'dns', HandleResolver>;
+}
+export declare class CompositeHandleResolver implements HandleResolver {
+    #private;
+    strategy: CompositeStrategy;
+    constructor({ methods, strategy }: CompositeHandleResolverOptions);
+    resolve(handle: Handle, options?: ResolveHandleOptions): Promise<AtprotoDid>;
+}

package/dist/handle/composite.js

@@ -0,0 +1,62 @@
+import * as err from '../errors.js';
+export class CompositeHandleResolver {
+    #methods;
+    strategy;
+    constructor({ methods, strategy = 'race' }) {
+        this.#methods = methods;
+        this.strategy = strategy;
+    }
+    async resolve(handle, options) {
+        const { http, dns } = this.#methods;
+        const parentSignal = options?.signal;
+        const controller = new AbortController();
+        if (parentSignal) {
+            parentSignal.addEventListener('abort', () => controller.abort(), { signal: controller.signal });
+        }
+        const dnsPromise = dns.resolve(handle, { ...options, signal: controller.signal });
+        const httpPromise = http.resolve(handle, { ...options, signal: controller.signal });
+        switch (this.strategy) {
+            case 'race': {
+                return new Promise((resolve) => {
+                    dnsPromise.then((did) => {
+                        controller.abort();
+                        resolve(did);
+                    }, () => resolve(httpPromise));
+                    httpPromise.then((did) => {
+                        controller.abort();
+                        resolve(did);
+                    }, () => resolve(dnsPromise));
+                });
+            }
+            case 'dns-first': {
+                httpPromise.catch(noop);
+                const resolved = await dnsPromise.catch(noop);
+                if (resolved) {
+                    controller.abort();
+                    return resolved;
+                }
+                return httpPromise;
+            }
+            case 'http-first': {
+                dnsPromise.catch(noop);
+                const resolved = await httpPromise.catch(noop);
+                if (resolved) {
+                    controller.abort();
+                    return resolved;
+                }
+                return dnsPromise;
+            }
+            case 'both': {
+                const [dnsResponse, httpResponse] = await Promise.allSettled([dnsPromise, httpPromise]);
+                const dnsDid = dnsResponse.status === 'fulfilled' ? dnsResponse.value : undefined;
+                const httpDid = httpResponse.status === 'fulfilled' ? httpResponse.value : undefined;
+                if (dnsDid && httpDid && dnsDid !== httpDid) {
+                    throw new err.AmbiguousHandleError(handle);
+                }
+                return dnsDid || httpDid || dnsPromise;
+            }
+        }
+    }
+}
+const noop = () => { };
+//# sourceMappingURL=composite.js.map

package/dist/handle/composite.js.map

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

package/dist/handle/methods/doh-json.d.ts

@@ -0,0 +1,12 @@
+import { type AtprotoDid, type Handle } from '@atcute/identity';
+import type { HandleResolver, ResolveHandleOptions } from '../../types.js';
+export interface DohJsonHandleResolverOptions {
+    dohUrl: string;
+    fetch?: typeof fetch;
+}
+export declare class DohJsonHandleResolver implements HandleResolver {
+    #private;
+    readonly dohUrl: string;
+    constructor({ dohUrl, fetch: fetchThis }: DohJsonHandleResolverOptions);
+    resolve(handle: Handle, options?: ResolveHandleOptions): Promise<AtprotoDid>;
+}

package/dist/handle/methods/doh-json.js

@@ -0,0 +1,105 @@
+import * as v from '@badrap/valita';
+import { isAtprotoDid } from '@atcute/identity';
+import { isResponseOk, parseResponseAsJson, pipe, validateJsonWith } from '@atcute/util-fetch';
+import * as err from '../../errors.js';
+const uint32 = v.number().assert((input) => Number.isInteger(input) && input >= 0 && input <= 2 ** 32 - 1);
+const question = v.object({
+    name: v.string(),
+    type: v.literal(16), // TXT
+});
+const answer = v.object({
+    name: v.string(),
+    type: v.literal(16), // TXT
+    TTL: uint32,
+    data: v.string().chain((input) => {
+        return v.ok(input.replace(/^"|"$/g, '').replace(/\\"/g, '"'));
+    }),
+});
+const authority = v.object({
+    name: v.string(),
+    type: uint32,
+    TTL: uint32,
+    data: v.string(),
+});
+const result = v.object({
+    /** DNS response code */
+    Status: uint32,
+    /** Whether response is truncated */
+    TC: v.boolean(),
+    /** Whether recursive desired bit is set, always true for Google and Cloudflare DoH */
+    RD: v.boolean(),
+    /** Whether recursive available bit is set, always true for Google and Cloudflare DoH */
+    RA: v.boolean(),
+    /** Whether response data was validated with DNSSEC */
+    AD: v.boolean(),
+    /** Whether client asked to disable DNSSEC validation */
+    CD: v.boolean(),
+    /** Requested records */
+    Question: v.tuple([question]),
+    /** Answers */
+    Answer: v.array(answer).optional(() => []),
+    /** Authority */
+    Authority: v.array(authority).optional(),
+    /** Comment from the DNS server */
+    Comment: v.string().optional(),
+});
+const SUBDOMAIN = '_atproto';
+const PREFIX = 'did=';
+const fetchDohJsonHandler = pipe(isResponseOk, parseResponseAsJson(/^application\/(dns-)?json$/, 16 * 1024), validateJsonWith(result, { mode: 'passthrough' }));
+export class DohJsonHandleResolver {
+    dohUrl;
+    #fetch;
+    constructor({ dohUrl, fetch: fetchThis = fetch }) {
+        this.dohUrl = dohUrl;
+        this.#fetch = fetchThis;
+    }
+    async resolve(handle, options) {
+        let json;
+        try {
+            const url = new URL(this.dohUrl);
+            url.searchParams.set('name', `${SUBDOMAIN}.${handle}`);
+            url.searchParams.set('type', 'TXT');
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : 'default',
+                headers: { accept: 'application/dns-json' },
+            });
+            const handled = await fetchDohJsonHandler(response);
+            json = handled.json;
+        }
+        catch (cause) {
+            throw new err.FailedHandleResolutionError(handle, { cause });
+        }
+        const status = json.Status;
+        const answers = json.Answer;
+        if (status !== 0 /* NOERROR */) {
+            if (status === 3 /* NXDOMAIN */) {
+                throw new err.DidNotFoundError(handle);
+            }
+            throw new err.FailedHandleResolutionError(handle, {
+                cause: new TypeError(`dns returned ${status}`),
+            });
+        }
+        for (let i = 0, il = answers.length; i < il; i++) {
+            const answer = answers[i];
+            const data = answer.data;
+            if (!data.startsWith(PREFIX)) {
+                continue;
+            }
+            for (let j = i + 1; j < il; j++) {
+                const data = answers[j].data;
+                if (data.startsWith(PREFIX)) {
+                    throw new err.AmbiguousHandleError(handle);
+                }
+            }
+            const did = data.slice(PREFIX.length);
+            if (!isAtprotoDid(did)) {
+                throw new err.InvalidResolvedHandleError(handle, did);
+            }
+            return did;
+        }
+        // theoretically this shouldn't happen, it should've returned NXDOMAIN
+        throw new err.DidNotFoundError(handle);
+    }
+}
+//# sourceMappingURL=doh-json.js.map

package/dist/handle/methods/doh-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doh-json.js","sourceRoot":"","sources":["../../../lib/handle/methods/doh-json.ts"],"names":[],"mappings":"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"}

package/dist/handle/methods/well-known.d.ts

@@ -0,0 +1,10 @@
+import { type AtprotoDid, type Handle } from '@atcute/identity';
+import type { HandleResolver, ResolveHandleOptions } from '../../types.js';
+export interface WellKnownHandleResolverOptions {
+    fetch?: typeof fetch;
+}
+export declare class WellKnownHandleResolver implements HandleResolver {
+    #private;
+    constructor({ fetch: fetchThis }?: WellKnownHandleResolverOptions);
+    resolve(handle: Handle, options?: ResolveHandleOptions): Promise<AtprotoDid>;
+}