@atproto-labs/did-resolver 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @atproto-labs/did-resolver
+
+## 0.1.0
+
+### Minor Changes
+
+- [#2482](https://github.com/bluesky-social/atproto/pull/2482) [`a8d6c1123`](https://github.com/bluesky-social/atproto/commit/a8d6c112359f5c4c0cfbe2df63443ed275f2a646) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add OAuth provider capability & support for DPoP signed tokens
+
+### Patch Changes
+
+- Updated dependencies [[`a8d6c1123`](https://github.com/bluesky-social/atproto/commit/a8d6c112359f5c4c0cfbe2df63443ed275f2a646)]:
+  - @atproto-labs/simple-store-memory@0.1.0
+  - @atproto-labs/simple-store@0.1.0
+  - @atproto-labs/fetch@0.1.0
+  - @atproto-labs/pipe@0.1.0
+  - @atproto/did@0.1.0

package/LICENSE.txt

@@ -0,0 +1,7 @@
+Dual MIT/Apache-2.0 License
+
+Copyright (c) 2022-2024 Bluesky PBC, and Contributors
+
+Except as otherwise noted in individual files, this software is licensed under the MIT license (<http://opensource.org/licenses/MIT>), or the Apache License, Version 2.0 (<http://www.apache.org/licenses/LICENSE-2.0>).
+
+Downstream projects and end users may chose either license individually, or both together, at their discretion. The motivation for this dual-licensing is the additional software patent assurance provided by Apache 2.0.

package/dist/did-cache-memory.d.ts

@@ -0,0 +1,8 @@
+import { Did, DidDocument } from '@atproto/did';
+import { SimpleStoreMemory, SimpleStoreMemoryOptions } from '@atproto-labs/simple-store-memory';
+import { DidCache } from './did-cache.js';
+export type DidCacheMemoryOptions = SimpleStoreMemoryOptions<Did, DidDocument>;
+export declare class DidCacheMemory extends SimpleStoreMemory<Did, DidDocument> implements DidCache {
+    constructor(options?: DidCacheMemoryOptions);
+}
+//# sourceMappingURL=did-cache-memory.d.ts.map

package/dist/did-cache-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache-memory.d.ts","sourceRoot":"","sources":["../src/did-cache-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAKzC,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;AAE9E,qBAAa,cACX,SAAQ,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAC1C,YAAW,QAAQ;gBAEP,OAAO,CAAC,EAAE,qBAAqB;CAO5C"}

package/dist/did-cache-memory.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DidCacheMemory = void 0;
+const simple_store_memory_1 = require("@atproto-labs/simple-store-memory");
+const DEFAULT_TTL = 3600 * 1000; // 1 hour
+const DEFAULT_MAX_SIZE = 50 * 1024 * 1024; // ~50MB
+class DidCacheMemory extends simple_store_memory_1.SimpleStoreMemory {
+    constructor(options) {
+        super(options?.max == null
+            ? { ttl: DEFAULT_TTL, maxSize: DEFAULT_MAX_SIZE, ...options }
+            : { ttl: DEFAULT_TTL, ...options });
+    }
+}
+exports.DidCacheMemory = DidCacheMemory;
+//# sourceMappingURL=did-cache-memory.js.map

package/dist/did-cache-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache-memory.js","sourceRoot":"","sources":["../src/did-cache-memory.ts"],"names":[],"mappings":";;;AACA,2EAG0C;AAI1C,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA,CAAC,SAAS;AACzC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA,CAAC,QAAQ;AAIlD,MAAa,cACX,SAAQ,uCAAmC;IAG3C,YAAY,OAA+B;QACzC,KAAK,CACH,OAAO,EAAE,GAAG,IAAI,IAAI;YAClB,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,EAAE;YAC7D,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CACrC,CAAA;IACH,CAAC;CACF;AAXD,wCAWC"}

package/dist/did-cache.d.ts

@@ -0,0 +1,15 @@
+import { CachedGetter, SimpleStore } from '@atproto-labs/simple-store';
+import { Did, DidDocument } from '@atproto/did';
+import { DidMethod, ResolveOptions } from './did-method.js';
+import { DidResolver, ResolvedDocument } from './did-resolver.js';
+export type { DidMethod, ResolveOptions, ResolvedDocument };
+export type DidCache = SimpleStore<Did, DidDocument>;
+export type DidResolverCachedOptions = {
+    cache?: DidCache;
+};
+export declare class DidResolverCached<M extends string = string> implements DidResolver<M> {
+    protected readonly getter: CachedGetter<Did, DidDocument>;
+    constructor(resolver: DidResolver<M>, cache?: DidCache);
+    resolve<D extends Did>(did: D, options?: ResolveOptions): Promise<ResolvedDocument<D, M>>;
+}
+//# sourceMappingURL=did-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache.d.ts","sourceRoot":"","sources":["../src/did-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEjE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAE3D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;AAEpD,MAAM,MAAM,wBAAwB,GAAG;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAA;AAE3D,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACtD,YAAW,WAAW,CAAC,CAAC,CAAC;IAEzB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;gBAEvD,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,KAAK,GAAE,QAA+B;IAQ3B,OAAO,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;CAGrE"}

package/dist/did-cache.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DidResolverCached = void 0;
+const simple_store_1 = require("@atproto-labs/simple-store");
+const did_cache_memory_js_1 = require("./did-cache-memory.js");
+class DidResolverCached {
+    constructor(resolver, cache = new did_cache_memory_js_1.DidCacheMemory()) {
+        Object.defineProperty(this, "getter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.getter = new simple_store_1.CachedGetter((did, options) => resolver.resolve(did, options), cache);
+    }
+    async resolve(did, options) {
+        return this.getter.get(did, options);
+    }
+}
+exports.DidResolverCached = DidResolverCached;
+//# sourceMappingURL=did-cache.js.map

package/dist/did-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache.js","sourceRoot":"","sources":["../src/did-cache.ts"],"names":[],"mappings":";;;AAAA,6DAAsE;AAGtE,+DAAsD;AAUtD,MAAa,iBAAiB;IAI5B,YACE,QAAwB,EACxB,QAAkB,IAAI,oCAAc,EAAE;QAHrB;;;;;WAAsC;QAKvD,IAAI,CAAC,MAAM,GAAG,IAAI,2BAAY,CAC5B,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EAChD,KAAK,CACN,CAAA;IACH,CAAC;IAEM,KAAK,CAAC,OAAO,CAAgB,GAAM,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAoC,CAAA;IACzE,CAAC;CACF;AAjBD,8CAiBC"}

package/dist/did-method.d.ts

@@ -0,0 +1,12 @@
+import { Did, DidDocument } from '@atproto/did';
+export type ResolveOptions = {
+    signal?: AbortSignal;
+    noCache?: boolean;
+};
+export interface DidMethod<Method extends string> {
+    resolve: (did: Did<Method>, options?: ResolveOptions) => DidDocument | PromiseLike<DidDocument>;
+}
+export type DidMethods<M extends string> = {
+    [K in M]: DidMethod<K>;
+};
+//# sourceMappingURL=did-method.d.ts.map

package/dist/did-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-method.d.ts","sourceRoot":"","sources":["../src/did-method.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,SAAS,CAAC,MAAM,SAAS,MAAM;IAC9C,OAAO,EAAE,CACP,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAChB,OAAO,CAAC,EAAE,cAAc,KACrB,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;CAC5C;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI;KACxC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;CACvB,CAAA"}

package/dist/did-method.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=did-method.js.map

package/dist/did-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-method.js","sourceRoot":"","sources":["../src/did-method.ts"],"names":[],"mappings":""}

package/dist/did-resolver-base.d.ts

@@ -0,0 +1,10 @@
+import { Did } from '@atproto/did';
+import { DidMethod, DidMethods, ResolveOptions } from './did-method.js';
+import { DidResolver, ResolvedDocument } from './did-resolver.js';
+export type { DidMethod, ResolveOptions, ResolvedDocument };
+export declare class DidResolverBase<M extends string = string> implements DidResolver<M> {
+    protected readonly methods: Map<string, DidMethod<M>>;
+    constructor(methods: DidMethods<M>);
+    resolve<D extends Did>(did: D, options?: ResolveOptions): Promise<ResolvedDocument<D, M>>;
+}
+//# sourceMappingURL=did-resolver-base.d.ts.map

package/dist/did-resolver-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver-base.d.ts","sourceRoot":"","sources":["../src/did-resolver-base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAA8B,MAAM,cAAc,CAAA;AAG9D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEjE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAE3D,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACpD,YAAW,WAAW,CAAC,CAAC,CAAC;IAEzB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;gBAEzC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAI5B,OAAO,CAAC,CAAC,SAAS,GAAG,EACzB,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CA4CnC"}

package/dist/did-resolver-base.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DidResolverBase = void 0;
+const fetch_1 = require("@atproto-labs/fetch");
+const did_1 = require("@atproto/did");
+const zod_1 = require("zod");
+class DidResolverBase {
+    constructor(methods) {
+        Object.defineProperty(this, "methods", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.methods = new Map(Object.entries(methods));
+    }
+    async resolve(did, options) {
+        options?.signal?.throwIfAborted();
+        const method = (0, did_1.extractDidMethod)(did);
+        const resolver = this.methods.get(method);
+        if (!resolver) {
+            throw new did_1.DidError(did, `Unsupported DID method`, 'did-method-invalid', 400);
+        }
+        try {
+            const document = await resolver.resolve(did, options);
+            if (document.id !== did) {
+                throw new did_1.DidError(did, `DID document id (${document.id}) does not match DID`, 'did-document-id-mismatch', 400);
+            }
+            return document;
+        }
+        catch (err) {
+            if (err instanceof fetch_1.FetchRequestError) {
+                throw new did_1.DidError(did, err.message, 'did-fetch-error', 400, err);
+            }
+            if (err instanceof zod_1.ZodError) {
+                throw new did_1.DidError(did, err.message, 'did-document-format-error', 503, err);
+            }
+            throw did_1.DidError.from(err, did);
+        }
+    }
+}
+exports.DidResolverBase = DidResolverBase;
+//# sourceMappingURL=did-resolver-base.js.map

package/dist/did-resolver-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver-base.js","sourceRoot":"","sources":["../src/did-resolver-base.ts"],"names":[],"mappings":";;;AAAA,+CAAuD;AACvD,sCAA8D;AAC9D,6BAA8B;AAO9B,MAAa,eAAe;IAK1B,YAAY,OAAsB;QAFf;;;;;WAAkC;QAGnD,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAM,EACN,OAAwB;QAExB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QAEjC,MAAM,MAAM,GAAG,IAAA,sBAAgB,EAAC,GAAG,CAAC,CAAA;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,cAAQ,CAChB,GAAG,EACH,wBAAwB,EACxB,oBAAoB,EACpB,GAAG,CACJ,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAa,EAAE,OAAO,CAAC,CAAA;YAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;gBACxB,MAAM,IAAI,cAAQ,CAChB,GAAG,EACH,oBAAoB,QAAQ,CAAC,EAAE,sBAAsB,EACrD,0BAA0B,EAC1B,GAAG,CACJ,CAAA;YACH,CAAC;YAED,OAAO,QAAkC,CAAA;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,yBAAiB,EAAE,CAAC;gBACrC,MAAM,IAAI,cAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YACnE,CAAC;YAED,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,cAAQ,CAChB,GAAG,EACH,GAAG,CAAC,OAAO,EACX,2BAA2B,EAC3B,GAAG,EACH,GAAG,CACJ,CAAA;YACH,CAAC;YAED,MAAM,cAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;CACF;AAxDD,0CAwDC"}

package/dist/did-resolver-common.d.ts

@@ -0,0 +1,9 @@
+import { DidResolverBase } from './did-resolver-base.js';
+import { DidPlcMethodOptions } from './methods/plc.js';
+import { DidWebMethodOptions } from './methods/web.js';
+import { Simplify } from './util.js';
+export type DidResolverCommonOptions = Simplify<DidPlcMethodOptions & DidWebMethodOptions>;
+export declare class DidResolverCommon extends DidResolverBase<'plc' | 'web'> implements DidResolverBase<'plc' | 'web'> {
+    constructor(options?: DidResolverCommonOptions);
+}
+//# sourceMappingURL=did-resolver-common.d.ts.map

package/dist/did-resolver-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver-common.d.ts","sourceRoot":"","sources":["../src/did-resolver-common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAgB,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAgB,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAC7C,mBAAmB,GAAG,mBAAmB,CAC1C,CAAA;AAED,qBAAa,iBACX,SAAQ,eAAe,CAAC,KAAK,GAAG,KAAK,CACrC,YAAW,eAAe,CAAC,KAAK,GAAG,KAAK,CAAC;gBAE7B,OAAO,CAAC,EAAE,wBAAwB;CAM/C"}

package/dist/did-resolver-common.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DidResolverCommon = void 0;
+const did_resolver_base_js_1 = require("./did-resolver-base.js");
+const plc_js_1 = require("./methods/plc.js");
+const web_js_1 = require("./methods/web.js");
+class DidResolverCommon extends did_resolver_base_js_1.DidResolverBase {
+    constructor(options) {
+        super({
+            plc: new plc_js_1.DidPlcMethod(options),
+            web: new web_js_1.DidWebMethod(options),
+        });
+    }
+}
+exports.DidResolverCommon = DidResolverCommon;
+//# sourceMappingURL=did-resolver-common.js.map

package/dist/did-resolver-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver-common.js","sourceRoot":"","sources":["../src/did-resolver-common.ts"],"names":[],"mappings":";;;AAAA,iEAAwD;AACxD,6CAAoE;AACpE,6CAAoE;AAOpE,MAAa,iBACX,SAAQ,sCAA8B;IAGtC,YAAY,OAAkC;QAC5C,KAAK,CAAC;YACJ,GAAG,EAAE,IAAI,qBAAY,CAAC,OAAO,CAAC;YAC9B,GAAG,EAAE,IAAI,qBAAY,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAA;IACJ,CAAC;CACF;AAVD,8CAUC"}

package/dist/did-resolver.d.ts

@@ -0,0 +1,7 @@
+import { Did, DidDocument } from '@atproto/did';
+import { ResolveOptions } from './did-method.js';
+export type ResolvedDocument<D extends Did, M extends string = string> = D extends Did<infer N> ? DidDocument<N extends string ? M : N extends M ? N : never> : never;
+export interface DidResolver<M extends string = string> {
+    resolve<D extends Did>(did: D, options?: ResolveOptions): Promise<ResolvedDocument<D, M>>;
+}
+//# sourceMappingURL=did-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver.d.ts","sourceRoot":"","sources":["../src/did-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IACnE,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAClB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAC3D,KAAK,CAAA;AAEX,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACpD,OAAO,CAAC,CAAC,SAAS,GAAG,EACnB,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CACnC"}

package/dist/did-resolver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=did-resolver.js.map

package/dist/did-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver.js","sourceRoot":"","sources":["../src/did-resolver.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from '@atproto/did';
+export * from './did-cache-memory.js';
+export * from './did-cache.js';
+export * from './did-method.js';
+export * from './did-resolver-common.js';
+export * from './did-resolver.js';
+export * from './methods.js';
+export * from './util.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAE5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@atproto/did"), exports);
+__exportStar(require("./did-cache-memory.js"), exports);
+__exportStar(require("./did-cache.js"), exports);
+__exportStar(require("./did-method.js"), exports);
+__exportStar(require("./did-resolver-common.js"), exports);
+__exportStar(require("./did-resolver.js"), exports);
+__exportStar(require("./methods.js"), exports);
+__exportStar(require("./util.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAE5B,wDAAqC;AACrC,iDAA8B;AAC9B,kDAA+B;AAC/B,2DAAwC;AACxC,oDAAiC;AACjC,+CAA4B;AAC5B,4CAAyB"}

package/dist/methods/plc.d.ts

@@ -0,0 +1,44 @@
+import { Fetch } from '@atproto-labs/fetch';
+import { Did } from '@atproto/did';
+import { DidMethod, ResolveOptions } from '../did-method.js';
+export type DidPlcMethodOptions = {
+    /**
+     * @default globalThis.fetch
+     */
+    fetch?: Fetch;
+    /**
+     * @default 'https://plc.directory/'
+     */
+    plcDirectoryUrl?: string | URL;
+};
+export declare class DidPlcMethod implements DidMethod<'plc'> {
+    protected readonly fetch: Fetch<unknown>;
+    readonly plcDirectoryUrl: URL;
+    constructor(options?: DidPlcMethodOptions);
+    resolve(did: Did<'plc'>, options?: ResolveOptions): Promise<{
+        id: `did:${string}:${string}`;
+        '@context': "https://www.w3.org/ns/did/v1" | [string, ...string[]];
+        controller?: `did:${string}:${string}` | `did:${string}:${string}`[] | undefined;
+        alsoKnownAs?: string[] | undefined;
+        service?: {
+            type: string | string[];
+            id: string;
+            serviceEndpoint: string | Record<string, string> | [string | Record<string, string>, ...(string | Record<string, string>)[]];
+        }[] | undefined;
+        authentication?: (string | {
+            type: string;
+            id: string;
+            controller: `did:${string}:${string}` | `did:${string}:${string}`[];
+            publicKeyJwk?: Record<string, unknown> | undefined;
+            publicKeyMultibase?: string | undefined;
+        })[] | undefined;
+        verificationMethod?: (string | {
+            type: string;
+            id: string;
+            controller: `did:${string}:${string}` | `did:${string}:${string}`[];
+            publicKeyJwk?: Record<string, unknown> | undefined;
+            publicKeyMultibase?: string | undefined;
+        })[] | undefined;
+    }>;
+}
+//# sourceMappingURL=plc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plc.d.ts","sourceRoot":"","sources":["../../src/methods/plc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAKN,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,GAAG,EAAqC,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAQ5D,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAC/B,CAAA;AAED,qBAAa,YAAa,YAAW,SAAS,CAAC,KAAK,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAExC,SAAgB,eAAe,EAAE,GAAG,CAAA;gBAExB,OAAO,CAAC,EAAE,mBAAmB;IAOnC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAaxD"}

package/dist/methods/plc.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DidPlcMethod = void 0;
+const fetch_1 = require("@atproto-labs/fetch");
+const pipe_1 = require("@atproto-labs/pipe");
+const did_1 = require("@atproto/did");
+const fetchSuccessHandler = (0, pipe_1.pipe)((0, fetch_1.fetchOkProcessor)(), (0, fetch_1.fetchJsonProcessor)(/^application\/(did\+ld\+)?json$/), (0, fetch_1.fetchJsonZodProcessor)(did_1.didDocumentValidator));
+class DidPlcMethod {
+    constructor(options) {
+        Object.defineProperty(this, "fetch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "plcDirectoryUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.plcDirectoryUrl = new URL(options?.plcDirectoryUrl || 'https://plc.directory/');
+        this.fetch = (0, fetch_1.bindFetch)(options?.fetch);
+    }
+    async resolve(did, options) {
+        // Although the did should start with `did:plc:` (thanks to typings), we
+        // should still check if the msid is valid.
+        (0, did_1.checkDidPlc)(did);
+        const url = new URL(`/${did}`, this.plcDirectoryUrl);
+        return this.fetch(url, {
+            redirect: 'error',
+            headers: { accept: 'application/did+ld+json,application/json' },
+            signal: options?.signal,
+        }).then(fetchSuccessHandler);
+    }
+}
+exports.DidPlcMethod = DidPlcMethod;
+//# sourceMappingURL=plc.js.map

package/dist/methods/plc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plc.js","sourceRoot":"","sources":["../../src/methods/plc.ts"],"names":[],"mappings":";;;AAAA,+CAM4B;AAC5B,6CAAyC;AACzC,sCAAqE;AAIrE,MAAM,mBAAmB,GAAG,IAAA,WAAI,EAC9B,IAAA,wBAAgB,GAAE,EAClB,IAAA,0BAAkB,EAAC,iCAAiC,CAAC,EACrD,IAAA,6BAAqB,EAAC,0BAAoB,CAAC,CAC5C,CAAA;AAcD,MAAa,YAAY;IAKvB,YAAY,OAA6B;QAJtB;;;;;WAAqB;QAExB;;;;;WAAoB;QAGlC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAC5B,OAAO,EAAE,eAAe,IAAI,wBAAwB,CACrD,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,IAAA,iBAAS,EAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAAwB;QACrD,wEAAwE;QACxE,2CAA2C;QAC3C,IAAA,iBAAW,EAAC,GAAG,CAAC,CAAA;QAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QAEpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE;YAC/D,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC9B,CAAC;CACF;AAzBD,oCAyBC"}

package/dist/methods/web.d.ts

@@ -0,0 +1,41 @@
+import { Fetch } from '@atproto-labs/fetch';
+import { Did } from '@atproto/did';
+import { DidMethod, ResolveOptions } from '../did-method.js';
+export type DidWebMethodOptions = {
+    fetch?: Fetch;
+};
+export declare class DidWebMethod implements DidMethod<'web'> {
+    protected readonly fetch: Fetch<unknown>;
+    constructor({ fetch }?: DidWebMethodOptions);
+    resolve(did: Did<'web'>, options?: ResolveOptions): Promise<{
+        id: `did:${string}:${string}`;
+        '@context': "https://www.w3.org/ns/did/v1" | [string, ...string[]];
+        controller?: `did:${string}:${string}` | `did:${string}:${string}`[] | undefined;
+        alsoKnownAs?: string[] | undefined;
+        service?: {
+            type: string | string[];
+            id: string;
+            serviceEndpoint: string | Record<string, string> | [string | Record<string, string>, ...(string | Record<string, string>)[]];
+        }[] | undefined;
+        authentication?: (string | {
+            type: string;
+            id: string;
+            controller: `did:${string}:${string}` | `did:${string}:${string}`[];
+            publicKeyJwk?: Record<string, unknown> | undefined;
+            publicKeyMultibase?: string | undefined;
+        })[] | undefined;
+        verificationMethod?: (string | {
+            type: string;
+            id: string;
+            controller: `did:${string}:${string}` | `did:${string}:${string}`[];
+            publicKeyJwk?: Record<string, unknown> | undefined;
+            publicKeyMultibase?: string | undefined;
+        })[] | undefined;
+    }>;
+}
+/**
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8615}
+ * @see {@link https://w3c-ccg.github.io/did-method-web/#create-register}
+ */
+export declare function buildDidWebDocumentUrl(did: Did<'web'>): URL;
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EAIN,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,GAAG,EAAqC,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAQ5D,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,qBAAa,YAAa,YAAW,SAAS,CAAC,KAAK,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;gBAE5B,EAAE,KAAwB,EAAE,GAAE,mBAAwB;IAI5D,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CASxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,OAarD"}

package/dist/methods/web.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDidWebDocumentUrl = exports.DidWebMethod = void 0;
+const fetch_1 = require("@atproto-labs/fetch");
+const pipe_1 = require("@atproto-labs/pipe");
+const did_1 = require("@atproto/did");
+const fetchSuccessHandler = (0, pipe_1.pipe)((0, fetch_1.fetchOkProcessor)(), (0, fetch_1.fetchJsonProcessor)(/^application\/(did\+ld\+)?json$/), (0, fetch_1.fetchJsonZodProcessor)(did_1.didDocumentValidator));
+class DidWebMethod {
+    constructor({ fetch = globalThis.fetch } = {}) {
+        Object.defineProperty(this, "fetch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.fetch = (0, fetch_1.bindFetch)(fetch);
+    }
+    async resolve(did, options) {
+        const didDocumentUrl = buildDidWebDocumentUrl(did);
+        return this.fetch(didDocumentUrl, {
+            redirect: 'error',
+            headers: { accept: 'application/did+ld+json,application/json' },
+            signal: options?.signal,
+        }).then(fetchSuccessHandler);
+    }
+}
+exports.DidWebMethod = DidWebMethod;
+/**
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8615}
+ * @see {@link https://w3c-ccg.github.io/did-method-web/#create-register}
+ */
+function buildDidWebDocumentUrl(did) {
+    const url = (0, did_1.didWebToUrl)(did); // Will throw if the DID is invalid
+    // Note: DID cannot end with an `:`, so they cannot end with a `/`. This is
+    // true unless when there is no path at all, in which case the URL constructor
+    // will set the pathname to `/`.
+    // https://w3c-ccg.github.io/did-method-web/#read-resolve
+    if (url.pathname === '/') {
+        return new URL(`/.well-known/did.json`, url);
+    }
+    else {
+        return new URL(`${url.pathname}/did.json`, url);
+    }
+}
+exports.buildDidWebDocumentUrl = buildDidWebDocumentUrl;
+//# sourceMappingURL=web.js.map

package/dist/methods/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":";;;AAAA,+CAM4B;AAC5B,6CAAyC;AACzC,sCAAqE;AAIrE,MAAM,mBAAmB,GAAG,IAAA,WAAI,EAC9B,IAAA,wBAAgB,GAAE,EAClB,IAAA,0BAAkB,EAAC,iCAAiC,CAAC,EACrD,IAAA,6BAAqB,EAAC,0BAAoB,CAAC,CAC5C,CAAA;AAMD,MAAa,YAAY;IAGvB,YAAY,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,KAA0B,EAAE;QAF/C;;;;;WAAqB;QAGtC,IAAI,CAAC,KAAK,GAAG,IAAA,iBAAS,EAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAAwB;QACrD,MAAM,cAAc,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;QAElD,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YAChC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE;YAC/D,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC9B,CAAC;CACF;AAhBD,oCAgBC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,GAAe;IACpD,MAAM,GAAG,GAAG,IAAA,iBAAW,EAAC,GAAG,CAAC,CAAA,CAAC,mCAAmC;IAEhE,2EAA2E;IAC3E,8EAA8E;IAC9E,gCAAgC;IAEhC,yDAAyD;IACzD,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,GAAG,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,WAAW,EAAE,GAAG,CAAC,CAAA;IACjD,CAAC;AACH,CAAC;AAbD,wDAaC"}

package/dist/methods.d.ts

@@ -0,0 +1,3 @@
+export * from './methods/plc.js';
+export * from './methods/web.js';
+//# sourceMappingURL=methods.d.ts.map

package/dist/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}

package/dist/methods.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./methods/plc.js"), exports);
+__exportStar(require("./methods/web.js"), exports);
+//# sourceMappingURL=methods.js.map

package/dist/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,mDAAgC"}

package/dist/util.d.ts

@@ -0,0 +1,4 @@
+export type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & NonNullable<unknown>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA"}

package/dist/util.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@atproto-labs/did-resolver",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "DID resolution and verification library",
+  "keywords": [
+    "atproto",
+    "did",
+    "resolver"
+  ],
+  "homepage": "https://atproto.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bluesky-social/atproto",
+    "directory": "packages/internal/did-resolver"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.8",
+    "@atproto-labs/fetch": "0.1.0",
+    "@atproto-labs/pipe": "0.1.0",
+    "@atproto-labs/simple-store": "0.1.0",
+    "@atproto-labs/simple-store-memory": "0.1.0",
+    "@atproto/did": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json"
+  }
+}

package/src/did-cache-memory.ts

@@ -0,0 +1,25 @@
+import { Did, DidDocument } from '@atproto/did'
+import {
+  SimpleStoreMemory,
+  SimpleStoreMemoryOptions,
+} from '@atproto-labs/simple-store-memory'
+
+import { DidCache } from './did-cache.js'
+
+const DEFAULT_TTL = 3600 * 1000 // 1 hour
+const DEFAULT_MAX_SIZE = 50 * 1024 * 1024 // ~50MB
+
+export type DidCacheMemoryOptions = SimpleStoreMemoryOptions<Did, DidDocument>
+
+export class DidCacheMemory
+  extends SimpleStoreMemory<Did, DidDocument>
+  implements DidCache
+{
+  constructor(options?: DidCacheMemoryOptions) {
+    super(
+      options?.max == null
+        ? { ttl: DEFAULT_TTL, maxSize: DEFAULT_MAX_SIZE, ...options }
+        : { ttl: DEFAULT_TTL, ...options },
+    )
+  }
+}

package/src/did-cache.ts

@@ -0,0 +1,31 @@
+import { CachedGetter, SimpleStore } from '@atproto-labs/simple-store'
+import { Did, DidDocument } from '@atproto/did'
+
+import { DidCacheMemory } from './did-cache-memory.js'
+import { DidMethod, ResolveOptions } from './did-method.js'
+import { DidResolver, ResolvedDocument } from './did-resolver.js'
+
+export type { DidMethod, ResolveOptions, ResolvedDocument }
+
+export type DidCache = SimpleStore<Did, DidDocument>
+
+export type DidResolverCachedOptions = { cache?: DidCache }
+
+export class DidResolverCached<M extends string = string>
+  implements DidResolver<M>
+{
+  protected readonly getter: CachedGetter<Did, DidDocument>
+  constructor(
+    resolver: DidResolver<M>,
+    cache: DidCache = new DidCacheMemory(),
+  ) {
+    this.getter = new CachedGetter<Did, DidDocument>(
+      (did, options) => resolver.resolve(did, options),
+      cache,
+    )
+  }
+
+  public async resolve<D extends Did>(did: D, options?: ResolveOptions) {
+    return this.getter.get(did, options) as Promise<ResolvedDocument<D, M>>
+  }
+}

package/src/did-method.ts

@@ -0,0 +1,17 @@
+import { Did, DidDocument } from '@atproto/did'
+
+export type ResolveOptions = {
+  signal?: AbortSignal
+  noCache?: boolean
+}
+
+export interface DidMethod<Method extends string> {
+  resolve: (
+    did: Did<Method>,
+    options?: ResolveOptions,
+  ) => DidDocument | PromiseLike<DidDocument>
+}
+
+export type DidMethods<M extends string> = {
+  [K in M]: DidMethod<K>
+}

package/src/did-resolver-base.ts

@@ -0,0 +1,66 @@
+import { FetchRequestError } from '@atproto-labs/fetch'
+import { Did, DidError, extractDidMethod } from '@atproto/did'
+import { ZodError } from 'zod'
+
+import { DidMethod, DidMethods, ResolveOptions } from './did-method.js'
+import { DidResolver, ResolvedDocument } from './did-resolver.js'
+
+export type { DidMethod, ResolveOptions, ResolvedDocument }
+
+export class DidResolverBase<M extends string = string>
+  implements DidResolver<M>
+{
+  protected readonly methods: Map<string, DidMethod<M>>
+
+  constructor(methods: DidMethods<M>) {
+    this.methods = new Map(Object.entries(methods))
+  }
+
+  async resolve<D extends Did>(
+    did: D,
+    options?: ResolveOptions,
+  ): Promise<ResolvedDocument<D, M>> {
+    options?.signal?.throwIfAborted()
+
+    const method = extractDidMethod(did)
+    const resolver = this.methods.get(method)
+    if (!resolver) {
+      throw new DidError(
+        did,
+        `Unsupported DID method`,
+        'did-method-invalid',
+        400,
+      )
+    }
+
+    try {
+      const document = await resolver.resolve(did as Did<M>, options)
+      if (document.id !== did) {
+        throw new DidError(
+          did,
+          `DID document id (${document.id}) does not match DID`,
+          'did-document-id-mismatch',
+          400,
+        )
+      }
+
+      return document as ResolvedDocument<D, M>
+    } catch (err) {
+      if (err instanceof FetchRequestError) {
+        throw new DidError(did, err.message, 'did-fetch-error', 400, err)
+      }
+
+      if (err instanceof ZodError) {
+        throw new DidError(
+          did,
+          err.message,
+          'did-document-format-error',
+          503,
+          err,
+        )
+      }
+
+      throw DidError.from(err, did)
+    }
+  }
+}

package/src/did-resolver-common.ts

@@ -0,0 +1,20 @@
+import { DidResolverBase } from './did-resolver-base.js'
+import { DidPlcMethod, DidPlcMethodOptions } from './methods/plc.js'
+import { DidWebMethod, DidWebMethodOptions } from './methods/web.js'
+import { Simplify } from './util.js'
+
+export type DidResolverCommonOptions = Simplify<
+  DidPlcMethodOptions & DidWebMethodOptions
+>
+
+export class DidResolverCommon
+  extends DidResolverBase<'plc' | 'web'>
+  implements DidResolverBase<'plc' | 'web'>
+{
+  constructor(options?: DidResolverCommonOptions) {
+    super({
+      plc: new DidPlcMethod(options),
+      web: new DidWebMethod(options),
+    })
+  }
+}

package/src/did-resolver.ts

@@ -0,0 +1,15 @@
+import { Did, DidDocument } from '@atproto/did'
+
+import { ResolveOptions } from './did-method.js'
+
+export type ResolvedDocument<D extends Did, M extends string = string> =
+  D extends Did<infer N>
+    ? DidDocument<N extends string ? M : N extends M ? N : never>
+    : never
+
+export interface DidResolver<M extends string = string> {
+  resolve<D extends Did>(
+    did: D,
+    options?: ResolveOptions,
+  ): Promise<ResolvedDocument<D, M>>
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+export * from '@atproto/did'
+
+export * from './did-cache-memory.js'
+export * from './did-cache.js'
+export * from './did-method.js'
+export * from './did-resolver-common.js'
+export * from './did-resolver.js'
+export * from './methods.js'
+export * from './util.js'

package/src/methods/plc.ts

@@ -0,0 +1,56 @@
+import {
+  Fetch,
+  bindFetch,
+  fetchJsonProcessor,
+  fetchJsonZodProcessor,
+  fetchOkProcessor,
+} from '@atproto-labs/fetch'
+import { pipe } from '@atproto-labs/pipe'
+import { Did, checkDidPlc, didDocumentValidator } from '@atproto/did'
+
+import { DidMethod, ResolveOptions } from '../did-method.js'
+
+const fetchSuccessHandler = pipe(
+  fetchOkProcessor(),
+  fetchJsonProcessor(/^application\/(did\+ld\+)?json$/),
+  fetchJsonZodProcessor(didDocumentValidator),
+)
+
+export type DidPlcMethodOptions = {
+  /**
+   * @default globalThis.fetch
+   */
+  fetch?: Fetch
+
+  /**
+   * @default 'https://plc.directory/'
+   */
+  plcDirectoryUrl?: string | URL
+}
+
+export class DidPlcMethod implements DidMethod<'plc'> {
+  protected readonly fetch: Fetch<unknown>
+
+  public readonly plcDirectoryUrl: URL
+
+  constructor(options?: DidPlcMethodOptions) {
+    this.plcDirectoryUrl = new URL(
+      options?.plcDirectoryUrl || 'https://plc.directory/',
+    )
+    this.fetch = bindFetch(options?.fetch)
+  }
+
+  async resolve(did: Did<'plc'>, options?: ResolveOptions) {
+    // Although the did should start with `did:plc:` (thanks to typings), we
+    // should still check if the msid is valid.
+    checkDidPlc(did)
+
+    const url = new URL(`/${did}`, this.plcDirectoryUrl)
+
+    return this.fetch(url, {
+      redirect: 'error',
+      headers: { accept: 'application/did+ld+json,application/json' },
+      signal: options?.signal,
+    }).then(fetchSuccessHandler)
+  }
+}

package/src/methods/web.ts

@@ -0,0 +1,58 @@
+import {
+  bindFetch,
+  Fetch,
+  fetchJsonProcessor,
+  fetchJsonZodProcessor,
+  fetchOkProcessor,
+} from '@atproto-labs/fetch'
+import { pipe } from '@atproto-labs/pipe'
+import { Did, didDocumentValidator, didWebToUrl } from '@atproto/did'
+
+import { DidMethod, ResolveOptions } from '../did-method.js'
+
+const fetchSuccessHandler = pipe(
+  fetchOkProcessor(),
+  fetchJsonProcessor(/^application\/(did\+ld\+)?json$/),
+  fetchJsonZodProcessor(didDocumentValidator),
+)
+
+export type DidWebMethodOptions = {
+  fetch?: Fetch
+}
+
+export class DidWebMethod implements DidMethod<'web'> {
+  protected readonly fetch: Fetch<unknown>
+
+  constructor({ fetch = globalThis.fetch }: DidWebMethodOptions = {}) {
+    this.fetch = bindFetch(fetch)
+  }
+
+  async resolve(did: Did<'web'>, options?: ResolveOptions) {
+    const didDocumentUrl = buildDidWebDocumentUrl(did)
+
+    return this.fetch(didDocumentUrl, {
+      redirect: 'error',
+      headers: { accept: 'application/did+ld+json,application/json' },
+      signal: options?.signal,
+    }).then(fetchSuccessHandler)
+  }
+}
+
+/**
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8615}
+ * @see {@link https://w3c-ccg.github.io/did-method-web/#create-register}
+ */
+export function buildDidWebDocumentUrl(did: Did<'web'>) {
+  const url = didWebToUrl(did) // Will throw if the DID is invalid
+
+  // Note: DID cannot end with an `:`, so they cannot end with a `/`. This is
+  // true unless when there is no path at all, in which case the URL constructor
+  // will set the pathname to `/`.
+
+  // https://w3c-ccg.github.io/did-method-web/#read-resolve
+  if (url.pathname === '/') {
+    return new URL(`/.well-known/did.json`, url)
+  } else {
+    return new URL(`${url.pathname}/did.json`, url)
+  }
+}

package/src/methods.ts

@@ -0,0 +1,2 @@
+export * from './methods/plc.js'
+export * from './methods/web.js'

package/src/util.ts

@@ -0,0 +1 @@
+export type Simplify<T> = { [K in keyof T]: T[K] } & NonNullable<unknown>

package/tsconfig.build.json

@@ -0,0 +1,8 @@
+{
+  "extends": ["../../../tsconfig/isomorphic.json"],
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "include": ["./src/**/*.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "include": [],
+  "references": [{ "path": "./tsconfig.build.json" }]
+}