@atproto/lex-resolver 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lex-resolver.js';
+export * from './lex-resolver-error.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,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lex-resolver.js"), exports);
+tslib_1.__exportStar(require("./lex-resolver-error.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,4DAAiC;AACjC,kEAAuC","sourcesContent":["export * from './lex-resolver.js'\nexport * from './lex-resolver-error.js'\n"]}

package/dist/lex-resolver-error.d.ts

@@ -0,0 +1,8 @@
+import { NSID } from '@atproto/syntax';
+export declare class LexResolverError extends Error {
+    readonly nsid: NSID;
+    readonly description: string;
+    name: string;
+    constructor(nsid: NSID, description?: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=lex-resolver-error.d.ts.map

package/dist/lex-resolver-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lex-resolver-error.d.ts","sourceRoot":"","sources":["../src/lex-resolver-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,qBAAa,gBAAiB,SAAQ,KAAK;aAIvB,IAAI,EAAE,IAAI;aACV,WAAW;IAJ7B,IAAI,SAAqB;gBAGP,IAAI,EAAE,IAAI,EACV,WAAW,SAAuC,EAClE,OAAO,CAAC,EAAE,YAAY;CAIzB"}

package/dist/lex-resolver-error.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LexResolverError = void 0;
+class LexResolverError extends Error {
+    nsid;
+    description;
+    name = 'LexResolverError';
+    constructor(nsid, description = `Could not resolve Lexicon for NSID`, options) {
+        super(`${description} (${nsid})`, options);
+        this.nsid = nsid;
+        this.description = description;
+    }
+}
+exports.LexResolverError = LexResolverError;
+//# sourceMappingURL=lex-resolver-error.js.map

package/dist/lex-resolver-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lex-resolver-error.js","sourceRoot":"","sources":["../src/lex-resolver-error.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAiB,SAAQ,KAAK;IAIvB;IACA;IAJlB,IAAI,GAAG,kBAAkB,CAAA;IAEzB,YACkB,IAAU,EACV,cAAc,oCAAoC,EAClE,OAAsB;QAEtB,KAAK,CAAC,GAAG,WAAW,KAAK,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;QAJ1B,SAAI,GAAJ,IAAI,CAAM;QACV,gBAAW,GAAX,WAAW,CAAuC;IAIpE,CAAC;CACF;AAVD,4CAUC","sourcesContent":["import { NSID } from '@atproto/syntax'\n\nexport class LexResolverError extends Error {\n  name = 'LexResolverError'\n\n  constructor(\n    public readonly nsid: NSID,\n    public readonly description = `Could not resolve Lexicon for NSID`,\n    options?: ErrorOptions,\n  ) {\n    super(`${description} (${nsid})`, options)\n  }\n}\n"]}

package/dist/lex-resolver.d.ts

@@ -0,0 +1,20 @@
+import { LexiconDocument } from '@atproto/lex-document';
+import { AtUri, NSID } from '@atproto/syntax';
+import { CreateDidResolverOptions, Did, DidResolver, ResolveDidOptions } from '@atproto-labs/did-resolver';
+export type LexResolverOptions = CreateDidResolverOptions & {
+    didAuthority?: Did;
+};
+export { AtUri, NSID };
+export type { LexiconDocument, ResolveDidOptions };
+export declare class LexResolver {
+    protected readonly options: LexResolverOptions;
+    protected readonly didResolver: DidResolver<'plc' | 'web'>;
+    constructor(options: LexResolverOptions);
+    get(nsidStr: NSID | string, options?: ResolveDidOptions): Promise<{
+        uri: AtUri;
+        document: LexiconDocument;
+    }>;
+    resolve(nsidStr: NSID | string): Promise<AtUri>;
+    fetch(uriStr: AtUri | string, options?: ResolveDidOptions): Promise<LexiconDocument>;
+}
+//# sourceMappingURL=lex-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lex-resolver.d.ts","sourceRoot":"","sources":["../src/lex-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAyB,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EACL,wBAAwB,EACxB,GAAG,EACH,WAAW,EACX,iBAAiB,EAIlB,MAAM,4BAA4B,CAAA;AAGnC,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG;IAC1D,YAAY,CAAC,EAAE,GAAG,CAAA;CACnB,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACtB,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAA;AAElD,qBAAa,WAAW;IAGV,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB;IAF1D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;gBAE3B,OAAO,EAAE,kBAAkB;IAIpD,GAAG,CACP,OAAO,EAAE,IAAI,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QACT,GAAG,EAAE,KAAK,CAAA;QACV,QAAQ,EAAE,eAAe,CAAA;KAC1B,CAAC;IAMI,OAAO,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAe/C,KAAK,CACT,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC;CAmE5B"}

package/dist/lex-resolver.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LexResolver = exports.NSID = exports.AtUri = void 0;
+const promises_1 = require("node:dns/promises");
+const lex_client_1 = require("@atproto/lex-client");
+const lex_document_1 = require("@atproto/lex-document");
+const syntax_1 = require("@atproto/syntax");
+Object.defineProperty(exports, "AtUri", { enumerable: true, get: function () { return syntax_1.AtUri; } });
+Object.defineProperty(exports, "NSID", { enumerable: true, get: function () { return syntax_1.NSID; } });
+const did_resolver_1 = require("@atproto-labs/did-resolver");
+const lex_resolver_error_js_1 = require("./lex-resolver-error.js");
+class LexResolver {
+    options;
+    didResolver;
+    constructor(options) {
+        this.options = options;
+        this.didResolver = (0, did_resolver_1.createDidResolver)(options);
+    }
+    async get(nsidStr, options) {
+        const uri = await this.resolve(nsidStr);
+        const document = await this.fetch(uri, options);
+        return { uri, document };
+    }
+    async resolve(nsidStr) {
+        const nsid = syntax_1.NSID.from(nsidStr);
+        const did = this.options.didAuthority ??
+            (await resolveLexiconDidAuthority(nsid).catch((cause) => {
+                throw new lex_resolver_error_js_1.LexResolverError(nsid, `Failed to resolve DID authority for Lexicon`, { cause });
+            }));
+        return syntax_1.AtUri.make(did, 'com.atproto.lexicon.schema', nsid.toString());
+    }
+    async fetch(uriStr, options) {
+        const uri = typeof uriStr === 'string' ? new syntax_1.AtUri(uriStr) : uriStr;
+        const { did, nsid } = parseLexiconUri(uri);
+        if (this.options.didAuthority && this.options.didAuthority !== did) {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `DID authority mismatch: expected ${this.options.didAuthority}, got ${did}`);
+        }
+        const didDocument = await this.didResolver
+            .resolve(did, options)
+            .catch((cause) => {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `Failed to resolve DID document for ${uri}`, { cause });
+        });
+        let service;
+        try {
+            service = (0, did_resolver_1.extractPdsUrl)(didDocument);
+        }
+        catch (cause) {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `No PDS service endpoint found in DID document for ${uri}`, { cause });
+        }
+        const agent = (0, lex_client_1.buildAgent)({
+            service,
+            fetch: this.options.fetch,
+        });
+        // TODO: use com.atproto.sync.getRecord and check signature using
+        // DID document key
+        const response = await new lex_client_1.Client(agent)
+            .getRecord('com.atproto.lexicon.schema', nsid.toString(), { repo: did })
+            .catch((cause) => {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `Failed to fetch Lexicon document at ${uri}`, { cause });
+        });
+        const result = lex_document_1.lexiconDocumentSchema.validate(response.body.value);
+        if (!result.success) {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `Invalid Lexicon document at ${uri}`, {
+                cause: result.error,
+            });
+        }
+        const document = result.value;
+        if (document.id !== nsid.toString()) {
+            throw new lex_resolver_error_js_1.LexResolverError(nsid, `Invalid document id "${document.id}" for ${uri}`);
+        }
+        return document;
+    }
+}
+exports.LexResolver = LexResolver;
+function parseLexiconUri(uri) {
+    // Validate input URI
+    const nsid = syntax_1.NSID.from(uri.rkey);
+    const did = uri.host;
+    (0, did_resolver_1.assertDid)(did);
+    return { did, nsid };
+}
+async function resolveLexiconDidAuthority(nsid) {
+    try {
+        return await getDomainTxtDid(`_lexicon.${nsid.authority}`);
+    }
+    catch (cause) {
+        throw new lex_resolver_error_js_1.LexResolverError(nsid, `Failed to resolve lexicon DID authority`, { cause });
+    }
+}
+async function getDomainTxtDid(domain) {
+    return parseDnsResult(await (0, promises_1.resolveTxt)(domain));
+}
+function parseDnsResult(chunkedResults) {
+    const didDefs = chunkedResults
+        .map((chunks) => chunks.join(''))
+        .filter((i) => i.startsWith('did='));
+    if (didDefs.length === 1) {
+        const did = didDefs[0].slice(4);
+        (0, did_resolver_1.assertDid)(did);
+        return did;
+    }
+    throw didDefs.length > 1
+        ? new Error('Multiple DIDs found in DNS TXT records')
+        : new Error('No DID found in DNS TXT records');
+}
+//# sourceMappingURL=lex-resolver.js.map

package/dist/lex-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lex-resolver.js","sourceRoot":"","sources":["../src/lex-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolveTxt } from 'node:dns/promises'\nimport { Client, buildAgent } from '@atproto/lex-client'\nimport { LexiconDocument, lexiconDocumentSchema } from '@atproto/lex-document'\nimport { AtUri, NSID } from '@atproto/syntax'\nimport {\n  CreateDidResolverOptions,\n  Did,\n  DidResolver,\n  ResolveDidOptions,\n  assertDid,\n  createDidResolver,\n  extractPdsUrl,\n} from '@atproto-labs/did-resolver'\nimport { LexResolverError } from './lex-resolver-error.js'\n\nexport type LexResolverOptions = CreateDidResolverOptions & {\n  didAuthority?: Did\n}\n\nexport { AtUri, NSID }\nexport type { LexiconDocument, ResolveDidOptions }\n\nexport class LexResolver {\n  protected readonly didResolver: DidResolver<'plc' | 'web'>\n\n  constructor(protected readonly options: LexResolverOptions) {\n    this.didResolver = createDidResolver(options)\n  }\n\n  async get(\n    nsidStr: NSID | string,\n    options?: ResolveDidOptions,\n  ): Promise<{\n    uri: AtUri\n    document: LexiconDocument\n  }> {\n    const uri = await this.resolve(nsidStr)\n    const document = await this.fetch(uri, options)\n    return { uri, document }\n  }\n\n  async resolve(nsidStr: NSID | string): Promise<AtUri> {\n    const nsid = NSID.from(nsidStr)\n    const did =\n      this.options.didAuthority ??\n      (await resolveLexiconDidAuthority(nsid).catch((cause) => {\n        throw new LexResolverError(\n          nsid,\n          `Failed to resolve DID authority for Lexicon`,\n          { cause },\n        )\n      }))\n\n    return AtUri.make(did, 'com.atproto.lexicon.schema', nsid.toString())\n  }\n\n  async fetch(\n    uriStr: AtUri | string,\n    options?: ResolveDidOptions,\n  ): Promise<LexiconDocument> {\n    const uri = typeof uriStr === 'string' ? new AtUri(uriStr) : uriStr\n    const { did, nsid } = parseLexiconUri(uri)\n\n    if (this.options.didAuthority && this.options.didAuthority !== did) {\n      throw new LexResolverError(\n        nsid,\n        `DID authority mismatch: expected ${this.options.didAuthority}, got ${did}`,\n      )\n    }\n\n    const didDocument = await this.didResolver\n      .resolve(did, options)\n      .catch((cause) => {\n        throw new LexResolverError(\n          nsid,\n          `Failed to resolve DID document for ${uri}`,\n          { cause },\n        )\n      })\n\n    let service: URL\n    try {\n      service = extractPdsUrl(didDocument)\n    } catch (cause) {\n      throw new LexResolverError(\n        nsid,\n        `No PDS service endpoint found in DID document for ${uri}`,\n        { cause },\n      )\n    }\n\n    const agent = buildAgent({\n      service,\n      fetch: this.options.fetch,\n    })\n\n    // TODO: use com.atproto.sync.getRecord and check signature using\n    // DID document key\n    const response = await new Client(agent)\n      .getRecord('com.atproto.lexicon.schema', nsid.toString(), { repo: did })\n      .catch((cause) => {\n        throw new LexResolverError(\n          nsid,\n          `Failed to fetch Lexicon document at ${uri}`,\n          { cause },\n        )\n      })\n\n    const result = lexiconDocumentSchema.validate(response.body.value)\n    if (!result.success) {\n      throw new LexResolverError(nsid, `Invalid Lexicon document at ${uri}`, {\n        cause: result.error,\n      })\n    }\n\n    const document = result.value\n\n    if (document.id !== nsid.toString()) {\n      throw new LexResolverError(\n        nsid,\n        `Invalid document id \"${document.id}\" for ${uri}`,\n      )\n    }\n\n    return document\n  }\n}\n\nfunction parseLexiconUri(uri: AtUri): {\n  did: Did\n  nsid: NSID\n} {\n  // Validate input URI\n  const nsid = NSID.from(uri.rkey)\n  const did = uri.host\n  assertDid(did)\n\n  return { did, nsid }\n}\n\nasync function resolveLexiconDidAuthority(nsid: NSID): Promise<Did> {\n  try {\n    return await getDomainTxtDid(`_lexicon.${nsid.authority}`)\n  } catch (cause) {\n    throw new LexResolverError(\n      nsid,\n      `Failed to resolve lexicon DID authority`,\n      { cause },\n    )\n  }\n}\n\nasync function getDomainTxtDid(domain: string): Promise<Did> {\n  return parseDnsResult(await resolveTxt(domain))\n}\n\nfunction parseDnsResult(chunkedResults: string[][]): Did {\n  const didDefs = chunkedResults\n    .map((chunks) => chunks.join(''))\n    .filter((i) => i.startsWith('did='))\n\n  if (didDefs.length === 1) {\n    const did = didDefs[0].slice(4)\n    assertDid(did)\n    return did\n  }\n\n  throw didDefs.length > 1\n    ? new Error('Multiple DIDs found in DNS TXT records')\n    : new Error('No DID found in DNS TXT records')\n}\n"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@atproto/lex-resolver",
+  "version": "0.0.0",
+  "license": "MIT",
+  "description": "Lexicon document resolver utility for AT Lexicons",
+  "keywords": [
+    "atproto",
+    "lexicon",
+    "resolver",
+    "utility"
+  ],
+  "homepage": "https://atproto.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bluesky-social/atproto",
+    "directory": "packages/lex/lex-resolver"
+  },
+  "files": [
+    "./src",
+    "./dist"
+  ],
+  "sideEffects": false,
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@atproto-labs/did-resolver": "workspace:*",
+    "@atproto/lex-client": "workspace:*",
+    "@atproto/lex-document": "workspace:*",
+    "@atproto/syntax": "workspace:*",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './lex-resolver.js'
+export * from './lex-resolver-error.js'

package/src/lex-resolver-error.ts

@@ -0,0 +1,13 @@
+import { NSID } from '@atproto/syntax'
+
+export class LexResolverError extends Error {
+  name = 'LexResolverError'
+
+  constructor(
+    public readonly nsid: NSID,
+    public readonly description = `Could not resolve Lexicon for NSID`,
+    options?: ErrorOptions,
+  ) {
+    super(`${description} (${nsid})`, options)
+  }
+}

package/src/lex-resolver.ts

@@ -0,0 +1,171 @@
+import { resolveTxt } from 'node:dns/promises'
+import { Client, buildAgent } from '@atproto/lex-client'
+import { LexiconDocument, lexiconDocumentSchema } from '@atproto/lex-document'
+import { AtUri, NSID } from '@atproto/syntax'
+import {
+  CreateDidResolverOptions,
+  Did,
+  DidResolver,
+  ResolveDidOptions,
+  assertDid,
+  createDidResolver,
+  extractPdsUrl,
+} from '@atproto-labs/did-resolver'
+import { LexResolverError } from './lex-resolver-error.js'
+
+export type LexResolverOptions = CreateDidResolverOptions & {
+  didAuthority?: Did
+}
+
+export { AtUri, NSID }
+export type { LexiconDocument, ResolveDidOptions }
+
+export class LexResolver {
+  protected readonly didResolver: DidResolver<'plc' | 'web'>
+
+  constructor(protected readonly options: LexResolverOptions) {
+    this.didResolver = createDidResolver(options)
+  }
+
+  async get(
+    nsidStr: NSID | string,
+    options?: ResolveDidOptions,
+  ): Promise<{
+    uri: AtUri
+    document: LexiconDocument
+  }> {
+    const uri = await this.resolve(nsidStr)
+    const document = await this.fetch(uri, options)
+    return { uri, document }
+  }
+
+  async resolve(nsidStr: NSID | string): Promise<AtUri> {
+    const nsid = NSID.from(nsidStr)
+    const did =
+      this.options.didAuthority ??
+      (await resolveLexiconDidAuthority(nsid).catch((cause) => {
+        throw new LexResolverError(
+          nsid,
+          `Failed to resolve DID authority for Lexicon`,
+          { cause },
+        )
+      }))
+
+    return AtUri.make(did, 'com.atproto.lexicon.schema', nsid.toString())
+  }
+
+  async fetch(
+    uriStr: AtUri | string,
+    options?: ResolveDidOptions,
+  ): Promise<LexiconDocument> {
+    const uri = typeof uriStr === 'string' ? new AtUri(uriStr) : uriStr
+    const { did, nsid } = parseLexiconUri(uri)
+
+    if (this.options.didAuthority && this.options.didAuthority !== did) {
+      throw new LexResolverError(
+        nsid,
+        `DID authority mismatch: expected ${this.options.didAuthority}, got ${did}`,
+      )
+    }
+
+    const didDocument = await this.didResolver
+      .resolve(did, options)
+      .catch((cause) => {
+        throw new LexResolverError(
+          nsid,
+          `Failed to resolve DID document for ${uri}`,
+          { cause },
+        )
+      })
+
+    let service: URL
+    try {
+      service = extractPdsUrl(didDocument)
+    } catch (cause) {
+      throw new LexResolverError(
+        nsid,
+        `No PDS service endpoint found in DID document for ${uri}`,
+        { cause },
+      )
+    }
+
+    const agent = buildAgent({
+      service,
+      fetch: this.options.fetch,
+    })
+
+    // TODO: use com.atproto.sync.getRecord and check signature using
+    // DID document key
+    const response = await new Client(agent)
+      .getRecord('com.atproto.lexicon.schema', nsid.toString(), { repo: did })
+      .catch((cause) => {
+        throw new LexResolverError(
+          nsid,
+          `Failed to fetch Lexicon document at ${uri}`,
+          { cause },
+        )
+      })
+
+    const result = lexiconDocumentSchema.validate(response.body.value)
+    if (!result.success) {
+      throw new LexResolverError(nsid, `Invalid Lexicon document at ${uri}`, {
+        cause: result.error,
+      })
+    }
+
+    const document = result.value
+
+    if (document.id !== nsid.toString()) {
+      throw new LexResolverError(
+        nsid,
+        `Invalid document id "${document.id}" for ${uri}`,
+      )
+    }
+
+    return document
+  }
+}
+
+function parseLexiconUri(uri: AtUri): {
+  did: Did
+  nsid: NSID
+} {
+  // Validate input URI
+  const nsid = NSID.from(uri.rkey)
+  const did = uri.host
+  assertDid(did)
+
+  return { did, nsid }
+}
+
+async function resolveLexiconDidAuthority(nsid: NSID): Promise<Did> {
+  try {
+    return await getDomainTxtDid(`_lexicon.${nsid.authority}`)
+  } catch (cause) {
+    throw new LexResolverError(
+      nsid,
+      `Failed to resolve lexicon DID authority`,
+      { cause },
+    )
+  }
+}
+
+async function getDomainTxtDid(domain: string): Promise<Did> {
+  return parseDnsResult(await resolveTxt(domain))
+}
+
+function parseDnsResult(chunkedResults: string[][]): Did {
+  const didDefs = chunkedResults
+    .map((chunks) => chunks.join(''))
+    .filter((i) => i.startsWith('did='))
+
+  if (didDefs.length === 1) {
+    const did = didDefs[0].slice(4)
+    assertDid(did)
+    return did
+  }
+
+  throw didDefs.length > 1
+    ? new Error('Multiple DIDs found in DNS TXT records')
+    : new Error('No DID found in DNS TXT records')
+}