@atproto-labs/identity-resolver 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @atproto-labs/identity-resolver
+
+## 0.0.1
+
+### Patch Changes
+
+- [`e134c79a0`](https://github.com/bluesky-social/atproto/commit/e134c79a0ffb000b2cb36437815673fa6bda664b) Thanks [@devinivy](https://github.com/devinivy)! - Initial publish of experimental oauth packages to @atproto-labs
+
+- Updated dependencies [[`e134c79a0`](https://github.com/bluesky-social/atproto/commit/e134c79a0ffb000b2cb36437815673fa6bda664b)]:
+  - @atproto-labs/handle-resolver@0.0.1
+  - @atproto-labs/fetch@0.0.1
+  - @atproto-labs/did@0.0.1

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/identity-resolver.d.ts

@@ -0,0 +1,13 @@
+import { DidResolver } from '@atproto-labs/did';
+import { HandleResolver, ResolvedHandle } from '@atproto-labs/handle-resolver';
+export type ResolvedIdentity = {
+    did: NonNullable<ResolvedHandle>;
+    url: URL;
+};
+export declare class IdentityResolver {
+    readonly handleResolver: HandleResolver;
+    readonly didResolver: DidResolver<'plc' | 'web'>;
+    constructor(handleResolver: HandleResolver, didResolver: DidResolver<'plc' | 'web'>);
+    resolve(input: string, serviceType?: string): Promise<ResolvedIdentity>;
+}
+//# sourceMappingURL=identity-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity-resolver.d.ts","sourceRoot":"","sources":["../src/identity-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EACL,cAAc,EACd,cAAc,EAEf,MAAM,+BAA+B,CAAA;AAGtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAChC,GAAG,EAAE,GAAG,CAAA;CACT,CAAA;AAED,qBAAa,gBAAgB;IAEzB,QAAQ,CAAC,cAAc,EAAE,cAAc;IACvC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;gBADvC,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;IAGrC,OAAO,CAClB,KAAK,EAAE,MAAM,EACb,WAAW,SAA8B,GACxC,OAAO,CAAC,gBAAgB,CAAC;CAY7B"}

package/dist/identity-resolver.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityResolver = void 0;
+const handle_resolver_1 = require("@atproto-labs/handle-resolver");
+const syntax_1 = require("@atproto/syntax");
+class IdentityResolver {
+    constructor(handleResolver, didResolver) {
+        Object.defineProperty(this, "handleResolver", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: handleResolver
+        });
+        Object.defineProperty(this, "didResolver", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: didResolver
+        });
+    }
+    async resolve(input, serviceType = 'AtprotoPersonalDataServer') {
+        const did = (0, handle_resolver_1.isResolvedHandle)(input)
+            ? input // Already a did
+            : await this.handleResolver.resolve((0, syntax_1.normalizeAndEnsureValidHandle)(input));
+        if (!did)
+            throw new Error(`Handle ${input} does not resolve to a DID`);
+        const url = await this.didResolver.resolveServiceEndpoint(did, {
+            type: serviceType,
+        });
+        return { did, url };
+    }
+}
+exports.IdentityResolver = IdentityResolver;
+//# sourceMappingURL=identity-resolver.js.map

package/dist/identity-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-resolver.js","sourceRoot":"","sources":["../src/identity-resolver.ts"],"names":[],"mappings":";;;AACA,mEAIsC;AACtC,4CAA+D;AAO/D,MAAa,gBAAgB;IAC3B,YACW,cAA8B,EAC9B,WAAuC;QADhD;;;;mBAAS,cAAc;WAAgB;QACvC;;;;mBAAS,WAAW;WAA4B;IAC/C,CAAC;IAEG,KAAK,CAAC,OAAO,CAClB,KAAa,EACb,WAAW,GAAG,2BAA2B;QAEzC,MAAM,GAAG,GAAG,IAAA,kCAAgB,EAAC,KAAK,CAAC;YACjC,CAAC,CAAC,KAAK,CAAC,gBAAgB;YACxB,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAA,sCAA6B,EAAC,KAAK,CAAC,CAAC,CAAA;QAC3E,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,4BAA4B,CAAC,CAAA;QAEtE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,GAAG,EAAE;YAC7D,IAAI,EAAE,WAAW;SAClB,CAAC,CAAA;QAEF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACrB,CAAC;CACF;AArBD,4CAqBC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './identity-resolver.js';
+export * from './universal-identity-resolver.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,wBAAwB,CAAA;AACtC,cAAc,kCAAkC,CAAA"}

package/dist/index.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("./identity-resolver.js"), exports);
+__exportStar(require("./universal-identity-resolver.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,yDAAsC;AACtC,mEAAgD"}

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

@@ -0,0 +1,23 @@
+import { DidCache, IsomorphicDidResolverOptions } from '@atproto-labs/did';
+import { Fetch } from '@atproto-labs/fetch';
+import { HandleResolverCache, UniversalHandleResolverOptions } from '@atproto-labs/handle-resolver';
+import { IdentityResolver } from './identity-resolver.js';
+export type { DidCache, DidDocument } from '@atproto-labs/did';
+export type { HandleResolverCache, ResolvedHandle, } from '@atproto-labs/handle-resolver';
+export type UniversalIdentityResolverOptions = {
+    fetch?: Fetch;
+    didCache?: DidCache;
+    handleCache?: HandleResolverCache;
+    /**
+     * @see {@link IsomorphicDidResolverOptions.plcDirectoryUrl}
+     */
+    plcDirectoryUrl?: IsomorphicDidResolverOptions['plcDirectoryUrl'];
+    /**
+     * @see {@link UniversalHandleResolverOptions.atprotoLexiconUrl}
+     */
+    atprotoLexiconUrl?: UniversalHandleResolverOptions['atprotoLexiconUrl'];
+};
+export declare class UniversalIdentityResolver extends IdentityResolver {
+    static from({ fetch, didCache, handleCache, plcDirectoryUrl, atprotoLexiconUrl, }: UniversalIdentityResolverOptions): UniversalIdentityResolver;
+}
+//# sourceMappingURL=universal-identity-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"universal-identity-resolver.d.ts","sourceRoot":"","sources":["../src/universal-identity-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,4BAA4B,EAC7B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAgC,EAC9B,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC9D,YAAY,EACV,mBAAmB,EACnB,cAAc,GACf,MAAM,+BAA+B,CAAA;AAEtC,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,WAAW,CAAC,EAAE,mBAAmB,CAAA;IAEjC;;OAEG;IACH,eAAe,CAAC,EAAE,4BAA4B,CAAC,iBAAiB,CAAC,CAAA;IAEjE;;OAEG;IACH,iBAAiB,CAAC,EAAE,8BAA8B,CAAC,mBAAmB,CAAC,CAAA;CACxE,CAAA;AAED,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,MAAM,CAAC,IAAI,CAAC,EACV,KAAwB,EACxB,QAAQ,EACR,WAAW,EACX,eAAe,EACf,iBAAiB,GAClB,EAAE,gCAAgC;CAcpC"}

package/dist/universal-identity-resolver.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniversalIdentityResolver = void 0;
+const did_1 = require("@atproto-labs/did");
+const handle_resolver_1 = __importDefault(require("@atproto-labs/handle-resolver"));
+const identity_resolver_js_1 = require("./identity-resolver.js");
+class UniversalIdentityResolver extends identity_resolver_js_1.IdentityResolver {
+    static from({ fetch = globalThis.fetch, didCache, handleCache, plcDirectoryUrl, atprotoLexiconUrl, }) {
+        return new this(new handle_resolver_1.default({
+            fetch,
+            cache: handleCache,
+            atprotoLexiconUrl,
+        }), new did_1.IsomorphicDidResolver({
+            fetch, //
+            cache: didCache,
+            plcDirectoryUrl,
+        }));
+    }
+}
+exports.UniversalIdentityResolver = UniversalIdentityResolver;
+//# sourceMappingURL=universal-identity-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"universal-identity-resolver.js","sourceRoot":"","sources":["../src/universal-identity-resolver.ts"],"names":[],"mappings":";;;;;;AAAA,2CAI0B;AAE1B,oFAGsC;AACtC,iEAAyD;AAyBzD,MAAa,yBAA0B,SAAQ,uCAAgB;IAC7D,MAAM,CAAC,IAAI,CAAC,EACV,KAAK,GAAG,UAAU,CAAC,KAAK,EACxB,QAAQ,EACR,WAAW,EACX,eAAe,EACf,iBAAiB,GACgB;QACjC,OAAO,IAAI,IAAI,CACb,IAAI,yBAAuB,CAAC;YAC1B,KAAK;YACL,KAAK,EAAE,WAAW;YAClB,iBAAiB;SAClB,CAAC,EACF,IAAI,2BAAqB,CAAC;YACxB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,QAAQ;YACf,eAAe;SAChB,CAAC,CACH,CAAA;IACH,CAAC;CACF;AArBD,8DAqBC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@atproto-labs/identity-resolver",
+  "version": "0.0.1",
+  "license": "MIT",
+  "description": "A library resolving ATPROTO identities",
+  "keywords": [
+    "atproto",
+    "identity",
+    "isomorphic",
+    "resolver"
+  ],
+  "homepage": "https://atproto.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bluesky-social/atproto",
+    "directory": "packages/identity-resolver"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@atproto-labs/did": "0.0.1",
+    "@atproto-labs/fetch": "0.0.1",
+    "@atproto-labs/handle-resolver": "0.0.1",
+    "@atproto/syntax": "0.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.json"
+  }
+}

package/src/identity-resolver.ts

@@ -0,0 +1,35 @@
+import { DidResolver } from '@atproto-labs/did'
+import {
+  HandleResolver,
+  ResolvedHandle,
+  isResolvedHandle,
+} from '@atproto-labs/handle-resolver'
+import { normalizeAndEnsureValidHandle } from '@atproto/syntax'
+
+export type ResolvedIdentity = {
+  did: NonNullable<ResolvedHandle>
+  url: URL
+}
+
+export class IdentityResolver {
+  constructor(
+    readonly handleResolver: HandleResolver,
+    readonly didResolver: DidResolver<'plc' | 'web'>,
+  ) {}
+
+  public async resolve(
+    input: string,
+    serviceType = 'AtprotoPersonalDataServer',
+  ): Promise<ResolvedIdentity> {
+    const did = isResolvedHandle(input)
+      ? input // Already a did
+      : await this.handleResolver.resolve(normalizeAndEnsureValidHandle(input))
+    if (!did) throw new Error(`Handle ${input} does not resolve to a DID`)
+
+    const url = await this.didResolver.resolveServiceEndpoint(did, {
+      type: serviceType,
+    })
+
+    return { did, url }
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './identity-resolver.js'
+export * from './universal-identity-resolver.js'

package/src/universal-identity-resolver.ts

@@ -0,0 +1,57 @@
+import {
+  DidCache,
+  IsomorphicDidResolver,
+  IsomorphicDidResolverOptions,
+} from '@atproto-labs/did'
+import { Fetch } from '@atproto-labs/fetch'
+import UniversalHandleResolver, {
+  HandleResolverCache,
+  UniversalHandleResolverOptions,
+} from '@atproto-labs/handle-resolver'
+import { IdentityResolver } from './identity-resolver.js'
+
+export type { DidCache, DidDocument } from '@atproto-labs/did'
+export type {
+  HandleResolverCache,
+  ResolvedHandle,
+} from '@atproto-labs/handle-resolver'
+
+export type UniversalIdentityResolverOptions = {
+  fetch?: Fetch
+
+  didCache?: DidCache
+  handleCache?: HandleResolverCache
+
+  /**
+   * @see {@link IsomorphicDidResolverOptions.plcDirectoryUrl}
+   */
+  plcDirectoryUrl?: IsomorphicDidResolverOptions['plcDirectoryUrl']
+
+  /**
+   * @see {@link UniversalHandleResolverOptions.atprotoLexiconUrl}
+   */
+  atprotoLexiconUrl?: UniversalHandleResolverOptions['atprotoLexiconUrl']
+}
+
+export class UniversalIdentityResolver extends IdentityResolver {
+  static from({
+    fetch = globalThis.fetch,
+    didCache,
+    handleCache,
+    plcDirectoryUrl,
+    atprotoLexiconUrl,
+  }: UniversalIdentityResolverOptions) {
+    return new this(
+      new UniversalHandleResolver({
+        fetch,
+        cache: handleCache,
+        atprotoLexiconUrl,
+      }),
+      new IsomorphicDidResolver({
+        fetch, //
+        cache: didCache,
+        plcDirectoryUrl,
+      }),
+    )
+  }
+}

package/tsconfig.json

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