@atcute/lexicon-resolver-node 0.1.0

package/LICENSE

@@ -0,0 +1,14 @@
+BSD Zero Clause License
+
+Copyright (c) 2025 Mary
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @atcute/lexicon-resolver-node
+
+Node.js lexicon authority resolver using native DNS.
+
+```sh
+npm install @atcute/lexicon-resolver-node
+```
+
+provides `NodeDnsLexiconAuthorityResolver` which resolves lexicon authorities via DNS TXT records
+using Node.js's native `dns` module, avoiding the need for HTTP-based DoH resolution.
+
+## usage
+
+```ts
+import { NodeDnsLexiconAuthorityResolver } from '@atcute/lexicon-resolver-node';
+
+const authorityResolver = new NodeDnsLexiconAuthorityResolver();
+
+const authority = await authorityResolver.resolve('app.bsky.feed.post');
+// -> 'did:plc:4v4y5r3lwsbtmsxhile2ljac'
+```
+
+### custom nameservers
+
+```ts
+const resolver = new NodeDnsLexiconAuthorityResolver({
+	nameservers: ['8.8.8.8', '8.8.4.4'],
+});
+```

package/dist/authority/node-dns.d.ts

@@ -0,0 +1,12 @@
+import { type LexiconAuthorityResolver, type ResolveLexiconAuthorityOptions } from '@atcute/lexicon-resolver';
+import type { AtprotoDid, Nsid } from '@atcute/lexicons/syntax';
+export interface NodeDnsLexiconAuthorityResolverOptions {
+    nameservers?: string[];
+}
+export declare class NodeDnsLexiconAuthorityResolver implements LexiconAuthorityResolver {
+    #private;
+    get nameservers(): string[] | undefined;
+    constructor({ nameservers }?: NodeDnsLexiconAuthorityResolverOptions);
+    resolve(nsid: Nsid, options?: ResolveLexiconAuthorityOptions): Promise<AtprotoDid>;
+}
+//# sourceMappingURL=node-dns.d.ts.map

package/dist/authority/node-dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-dns.d.ts","sourceRoot":"","sources":["../../lib/authority/node-dns.ts"],"names":[],"mappings":"AAGA,OAAO,EAKN,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EAEnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAKhE,MAAM,WAAW,sCAAsC;IACtD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,+BAAgC,YAAW,wBAAwB;;IAG/E,IAAI,WAAW,IAAI,MAAM,EAAE,GAAG,SAAS,CAEtC;IAED,YAAY,EAAE,WAAW,EAAE,GAAE,sCAA2C,EAKvE;IAEK,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CvF;CACD"}

package/dist/authority/node-dns.js

@@ -0,0 +1,54 @@
+import dns from 'node:dns/promises';
+import { isAtprotoDid } from '@atcute/identity';
+import { AmbiguousAuthorityError, AuthorityNotFoundError, FailedAuthorityResolutionError, InvalidResolvedAuthorityError, nsidToLookupDomain, } from '@atcute/lexicon-resolver';
+const SUBDOMAIN = '_lexicon';
+const PREFIX = 'did=';
+export class NodeDnsLexiconAuthorityResolver {
+    #resolver = null;
+    get nameservers() {
+        return this.#resolver?.getServers();
+    }
+    constructor({ nameservers } = {}) {
+        if (nameservers) {
+            this.#resolver = new dns.Resolver();
+            this.#resolver.setServers(nameservers);
+        }
+    }
+    async resolve(nsid, options) {
+        const lookupDomain = nsidToLookupDomain(nsid);
+        let results;
+        try {
+            const signal = options?.signal;
+            const resolver = this.#resolver ?? dns;
+            results = await resolver.resolveTxt(`${SUBDOMAIN}.${lookupDomain}`);
+            signal?.throwIfAborted();
+        }
+        catch (cause) {
+            if (cause instanceof Error && 'code' in cause && cause.code === 'ENOTFOUND') {
+                throw new AuthorityNotFoundError(nsid);
+            }
+            throw new FailedAuthorityResolutionError(nsid, { cause });
+        }
+        const records = results.map((record) => record.join('').replace(/^"|"$/g, '').replace(/\\"/g, '"'));
+        for (let i = 0, il = records.length; i < il; i++) {
+            const data = records[i];
+            if (!data.startsWith(PREFIX)) {
+                continue;
+            }
+            for (let j = i + 1; j < il; j++) {
+                const data = records[j];
+                if (data.startsWith(PREFIX)) {
+                    throw new AmbiguousAuthorityError(nsid);
+                }
+            }
+            const did = data.slice(PREFIX.length);
+            if (!isAtprotoDid(did)) {
+                throw new InvalidResolvedAuthorityError(nsid, did);
+            }
+            return did;
+        }
+        // theoretically this shouldn't happen, it should've returned ENOTFOUND
+        throw new AuthorityNotFoundError(nsid);
+    }
+}
+//# sourceMappingURL=node-dns.js.map

package/dist/authority/node-dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-dns.js","sourceRoot":"","sources":["../../lib/authority/node-dns.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,mBAAmB,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACN,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAG7B,kBAAkB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,MAAM,GAAG,MAAM,CAAC;AAMtB,MAAM,OAAO,+BAA+B;IAC3C,SAAS,GAAwB,IAAI,CAAC;IAEtC,IAAI,WAAW,GAAyB;QACvC,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC;IAAA,CACpC;IAED,YAAY,EAAE,WAAW,EAAE,GAA2C,EAAE,EAAE;QACzE,IAAI,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;IAAA,CACD;IAED,KAAK,CAAC,OAAO,CAAC,IAAU,EAAE,OAAwC,EAAuB;QACxF,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,OAAmB,CAAC;QAExB,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;YAEvC,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,IAAI,YAAY,EAAE,CAAC,CAAC;YACpE,MAAM,EAAE,cAAc,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC7E,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YAED,MAAM,IAAI,8BAA8B,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACpG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAExB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACV,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;YACF,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,6BAA6B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,GAAG,CAAC;QACZ,CAAC;QAED,uEAAuE;QACvE,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAAA,CACvC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './authority/node-dns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './authority/node-dns.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/lib/authority/node-dns.ts

@@ -0,0 +1,81 @@
+import dns from 'node:dns/promises';
+
+import { isAtprotoDid } from '@atcute/identity';
+import {
+	AmbiguousAuthorityError,
+	AuthorityNotFoundError,
+	FailedAuthorityResolutionError,
+	InvalidResolvedAuthorityError,
+	type LexiconAuthorityResolver,
+	type ResolveLexiconAuthorityOptions,
+	nsidToLookupDomain,
+} from '@atcute/lexicon-resolver';
+import type { AtprotoDid, Nsid } from '@atcute/lexicons/syntax';
+
+const SUBDOMAIN = '_lexicon';
+const PREFIX = 'did=';
+
+export interface NodeDnsLexiconAuthorityResolverOptions {
+	nameservers?: string[];
+}
+
+export class NodeDnsLexiconAuthorityResolver implements LexiconAuthorityResolver {
+	#resolver: dns.Resolver | null = null;
+
+	get nameservers(): string[] | undefined {
+		return this.#resolver?.getServers();
+	}
+
+	constructor({ nameservers }: NodeDnsLexiconAuthorityResolverOptions = {}) {
+		if (nameservers) {
+			this.#resolver = new dns.Resolver();
+			this.#resolver.setServers(nameservers);
+		}
+	}
+
+	async resolve(nsid: Nsid, options?: ResolveLexiconAuthorityOptions): Promise<AtprotoDid> {
+		const lookupDomain = nsidToLookupDomain(nsid);
+
+		let results: string[][];
+
+		try {
+			const signal = options?.signal;
+			const resolver = this.#resolver ?? dns;
+
+			results = await resolver.resolveTxt(`${SUBDOMAIN}.${lookupDomain}`);
+			signal?.throwIfAborted();
+		} catch (cause) {
+			if (cause instanceof Error && 'code' in cause && cause.code === 'ENOTFOUND') {
+				throw new AuthorityNotFoundError(nsid);
+			}
+
+			throw new FailedAuthorityResolutionError(nsid, { cause });
+		}
+
+		const records = results.map((record) => record.join('').replace(/^"|"$/g, '').replace(/\\"/g, '"'));
+		for (let i = 0, il = records.length; i < il; i++) {
+			const data = records[i];
+
+			if (!data.startsWith(PREFIX)) {
+				continue;
+			}
+
+			for (let j = i + 1; j < il; j++) {
+				const data = records[j];
+				if (data.startsWith(PREFIX)) {
+					throw new AmbiguousAuthorityError(nsid);
+				}
+			}
+
+			const did = data.slice(PREFIX.length);
+			if (!isAtprotoDid(did)) {
+				throw new InvalidResolvedAuthorityError(nsid, did);
+			}
+
+			return did;
+		}
+
+		// theoretically this shouldn't happen, it should've returned ENOTFOUND
+		throw new AuthorityNotFoundError(nsid);
+	}
+}

package/lib/index.ts

@@ -0,0 +1 @@
+export * from './authority/node-dns.js';

package/package.json

@@ -0,0 +1,45 @@
+{
+  "type": "module",
+  "name": "@atcute/lexicon-resolver-node",
+  "version": "0.1.0",
+  "description": "additional atproto lexicon resolvers for Node.js",
+  "keywords": [
+    "atproto",
+    "lexicon",
+    "did"
+  ],
+  "license": "0BSD",
+  "repository": {
+    "url": "https://github.com/mary-ext/atcute",
+    "directory": "packages/lexicons/lexicon-resolver-node"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "lib/",
+    "!lib/**/*.bench.ts",
+    "!lib/**/*.test.ts"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@atcute/identity": "^1.0.0",
+    "@atcute/lexicon-resolver": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "@atcute/lexicon-resolver": "^0.1.6",
+    "@atcute/identity": "^1.1.3"
+  },
+  "dependencies": {
+    "@atcute/lexicons": "^1.2.6"
+  },
+  "scripts": {
+    "build": "tsgo --project tsconfig.build.json",
+    "prepublish": "rm -rf dist; pnpm run build"
+  }
+}