@atcute/lexicon-resolver 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,64 @@
+# @atcute/lexicon-resolver
+
+atproto lexicon authority resolution and schema retrieval
+
+```ts
+// authority resolution
+const authorityResolver = new DohJsonLexiconAuthorityResolver({
+	dohUrl: 'https://mozilla.cloudflare-dns.com/dns-query',
+});
+
+try {
+	const authority = await authorityResolver.resolve('app.bsky.feed.post');
+	//    ^? 'did:plc:4v4y5r3lwsbtmsxhile2ljac'
+} catch (err) {
+	if (err instanceof AuthorityNotFoundError) {
+		// nsid returned no did
+	}
+	if (err instanceof InvalidResolvedAuthorityError) {
+		// nsid returned a did, but isn't a valid atproto did
+	}
+	if (err instanceof AmbiguousAuthorityError) {
+		// nsid returned multiple did values
+	}
+	if (err instanceof FailedAuthorityResolutionError) {
+		// nsid resolution had thrown something unexpected (fetch error)
+	}
+
+	if (err instanceof LexiconAuthorityResolutionError) {
+		// the errors above extend this class, so you can do a catch-all.
+	}
+}
+
+// schema resolution
+const schemaResolver = new LexiconSchemaResolver({
+	didDocumentResolver: new CompositeDidDocumentResolver({
+		methods: {
+			plc: new PlcDidDocumentResolver(),
+			web: new WebDidDocumentResolver(),
+		},
+	}),
+});
+
+try {
+	const resolved = await schemaResolver.resolve(authority, 'app.bsky.feed.post');
+	//    ^? { uri: string, cid: string, schema: LexiconDoc }
+} catch (err) {
+	if (err instanceof LexiconNotFoundError) {
+		// lexicon record not found
+	}
+	if (err instanceof InvalidLexiconSchemaError) {
+		// lexicon schema is malformed
+	}
+	if (err instanceof InvalidLexiconProofError) {
+		// lexicon record proof verification failed
+	}
+	if (err instanceof FailedLexiconResolutionError) {
+		// lexicon resolution had thrown something unexpected (fetch error)
+	}
+
+	if (err instanceof LexiconResolutionError) {
+		// the errors above extend this class, so you can do a catch-all.
+	}
+}
+```

package/dist/authority/doh-json.d.ts

@@ -0,0 +1,12 @@
+import type { AtprotoDid, Nsid } from '@atcute/lexicons/syntax';
+import type { LexiconAuthorityResolver, ResolveLexiconAuthorityOptions } from '../types.js';
+export interface DohJsonLexiconAuthorityResolverOptions {
+    dohUrl: string;
+    fetch?: typeof fetch;
+}
+export declare class DohJsonLexiconAuthorityResolver implements LexiconAuthorityResolver {
+    #private;
+    readonly dohUrl: string;
+    constructor({ dohUrl, fetch: fetchThis }: DohJsonLexiconAuthorityResolverOptions);
+    resolve(nsid: Nsid, options?: ResolveLexiconAuthorityOptions): Promise<AtprotoDid>;
+}

package/dist/authority/doh-json.js

@@ -0,0 +1,107 @@
+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';
+import { nsidToLookupDomain } from '../utils.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 = '_lexicon';
+const PREFIX = 'did=';
+const fetchDohJsonHandler = pipe(isResponseOk, parseResponseAsJson(/^application\/(dns-)?json$/, 16 * 1024), validateJsonWith(result, { mode: 'passthrough' }));
+export class DohJsonLexiconAuthorityResolver {
+    dohUrl;
+    #fetch;
+    constructor({ dohUrl, fetch: fetchThis = fetch }) {
+        this.dohUrl = dohUrl;
+        this.#fetch = fetchThis;
+    }
+    async resolve(nsid, options) {
+        const lookupDomain = nsidToLookupDomain(nsid);
+        let json;
+        try {
+            const url = new URL(this.dohUrl);
+            url.searchParams.set('name', `${SUBDOMAIN}.${lookupDomain}`);
+            url.searchParams.set('type', 'TXT');
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : undefined,
+                headers: { accept: 'application/dns-json' },
+            });
+            const handled = await fetchDohJsonHandler(response);
+            json = handled.json;
+        }
+        catch (cause) {
+            throw new err.FailedAuthorityResolutionError(nsid, { cause });
+        }
+        const status = json.Status;
+        const answers = json.Answer;
+        if (status !== 0 /* NOERROR */) {
+            if (status === 3 /* NXDOMAIN */) {
+                throw new err.AuthorityNotFoundError(nsid);
+            }
+            throw new err.FailedAuthorityResolutionError(nsid, {
+                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.AmbiguousAuthorityError(nsid);
+                }
+            }
+            const did = data.slice(PREFIX.length);
+            if (!isAtprotoDid(did)) {
+                throw new err.InvalidResolvedAuthorityError(nsid, did);
+            }
+            return did;
+        }
+        // theoretically this shouldn't happen, it should've returned NXDOMAIN
+        throw new err.AuthorityNotFoundError(nsid);
+    }
+}
+//# sourceMappingURL=doh-json.js.map

package/dist/authority/doh-json.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const LEXICON_SCHEMA_COLLECTION = "com.atproto.lexicon.schema";

package/dist/constants.js

@@ -0,0 +1,2 @@
+export const LEXICON_SCHEMA_COLLECTION = 'com.atproto.lexicon.schema';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,4BAA4B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+import type { Nsid } from '@atcute/lexicons/syntax';
+export declare class LexiconAuthorityResolutionError extends Error {
+    name: string;
+}
+export declare class AuthorityNotFoundError extends LexiconAuthorityResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid);
+}
+export declare class FailedAuthorityResolutionError extends LexiconAuthorityResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid, options?: ErrorOptions);
+}
+export declare class InvalidResolvedAuthorityError extends LexiconAuthorityResolutionError {
+    nsid: Nsid;
+    did: string;
+    name: string;
+    constructor(nsid: Nsid, did: string);
+}
+export declare class AmbiguousAuthorityError extends LexiconAuthorityResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid);
+}
+export declare class LexiconResolutionError extends Error {
+    name: string;
+}
+export declare class FailedLexiconResolutionError extends LexiconResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid, options?: ErrorOptions);
+}
+export declare class InvalidLexiconSchemaError extends LexiconResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid, options?: ErrorOptions);
+}
+export declare class InvalidLexiconProofError extends LexiconResolutionError {
+    nsid: Nsid;
+    name: string;
+    constructor(nsid: Nsid, options?: ErrorOptions);
+}

package/dist/errors.js

@@ -0,0 +1,69 @@
+// #region Lexicon authority resolution errors
+export class LexiconAuthorityResolutionError extends Error {
+    name = 'LexiconAuthorityResolutionError';
+}
+export class AuthorityNotFoundError extends LexiconAuthorityResolutionError {
+    nsid;
+    name = 'AuthorityNotFoundError';
+    constructor(nsid) {
+        super(`lexicon authority not found; nsid=${nsid}`);
+        this.nsid = nsid;
+    }
+}
+export class FailedAuthorityResolutionError extends LexiconAuthorityResolutionError {
+    nsid;
+    name = 'FailedAuthorityResolutionError';
+    constructor(nsid, options) {
+        super(`failed to resolve lexicon authority; nsid=${nsid}`, options);
+        this.nsid = nsid;
+    }
+}
+export class InvalidResolvedAuthorityError extends LexiconAuthorityResolutionError {
+    nsid;
+    did;
+    name = 'InvalidResolvedAuthorityError';
+    constructor(nsid, did) {
+        super(`lexicon authority returned invalid did; nsid=${nsid}; did=${did}`);
+        this.nsid = nsid;
+        this.did = did;
+    }
+}
+export class AmbiguousAuthorityError extends LexiconAuthorityResolutionError {
+    nsid;
+    name = 'AmbiguousAuthorityError';
+    constructor(nsid) {
+        super(`lexicon authority returned multiple did values; nsid=${nsid}`);
+        this.nsid = nsid;
+    }
+}
+// #endregion
+// #region Lexicon resolution errors
+export class LexiconResolutionError extends Error {
+    name = 'LexiconResolutionError';
+}
+export class FailedLexiconResolutionError extends LexiconResolutionError {
+    nsid;
+    name = 'FailedLexiconResolutionError';
+    constructor(nsid, options) {
+        super(`failed to resolve lexicon; nsid=${nsid}`, options);
+        this.nsid = nsid;
+    }
+}
+export class InvalidLexiconSchemaError extends LexiconResolutionError {
+    nsid;
+    name = 'InvalidLexiconSchemaError';
+    constructor(nsid, options) {
+        super(`invalid lexicon schema; nsid=${nsid}`, options);
+        this.nsid = nsid;
+    }
+}
+export class InvalidLexiconProofError extends LexiconResolutionError {
+    nsid;
+    name = 'InvalidLexiconProofError';
+    constructor(nsid, options) {
+        super(`invalid lexicon record proof; nsid=${nsid}`, options);
+        this.nsid = nsid;
+    }
+}
+// #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,8CAA8C;AAC9C,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAChD,IAAI,GAAG,iCAAiC,CAAC;CAClD;AAED,MAAM,OAAO,sBAAuB,SAAQ,+BAA+B;IAGvD;IAFV,IAAI,GAAG,wBAAwB,CAAC;IAEzC,YAAmB,IAAU;QAC5B,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QADjC,SAAI,GAAJ,IAAI,CAAM;IAE7B,CAAC;CACD;AAED,MAAM,OAAO,8BAA+B,SAAQ,+BAA+B;IAI1E;IAHC,IAAI,GAAG,gCAAgC,CAAC;IAEjD,YACQ,IAAU,EACjB,OAAsB;QAEtB,KAAK,CAAC,6CAA6C,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAH7D,SAAI,GAAJ,IAAI,CAAM;IAIlB,CAAC;CACD;AAED,MAAM,OAAO,6BAA8B,SAAQ,+BAA+B;IAIzE;IACA;IAJC,IAAI,GAAG,+BAA+B,CAAC;IAEhD,YACQ,IAAU,EACV,GAAW;QAElB,KAAK,CAAC,gDAAgD,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC;QAHnE,SAAI,GAAJ,IAAI,CAAM;QACV,QAAG,GAAH,GAAG,CAAQ;IAGnB,CAAC;CACD;AAED,MAAM,OAAO,uBAAwB,SAAQ,+BAA+B;IAGxD;IAFV,IAAI,GAAG,yBAAyB,CAAC;IAE1C,YAAmB,IAAU;QAC5B,KAAK,CAAC,wDAAwD,IAAI,EAAE,CAAC,CAAC;QADpD,SAAI,GAAJ,IAAI,CAAM;IAE7B,CAAC;CACD;AACD,aAAa;AAEb,oCAAoC;AACpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,IAAI,GAAG,wBAAwB,CAAC;CACzC;AAGD,MAAM,OAAO,4BAA6B,SAAQ,sBAAsB;IAI/D;IAHC,IAAI,GAAG,8BAA8B,CAAC;IAE/C,YACQ,IAAU,EACjB,OAAsB;QAEtB,KAAK,CAAC,mCAAmC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAHnD,SAAI,GAAJ,IAAI,CAAM;IAIlB,CAAC;CACD;AAED,MAAM,OAAO,yBAA0B,SAAQ,sBAAsB;IAI5D;IAHC,IAAI,GAAG,2BAA2B,CAAC;IAE5C,YACQ,IAAU,EACjB,OAAsB;QAEtB,KAAK,CAAC,gCAAgC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAHhD,SAAI,GAAJ,IAAI,CAAM;IAIlB,CAAC;CACD;AAED,MAAM,OAAO,wBAAyB,SAAQ,sBAAsB;IAI3D;IAHC,IAAI,GAAG,0BAA0B,CAAC;IAE3C,YACQ,IAAU,EACjB,OAAsB;QAEtB,KAAK,CAAC,sCAAsC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAHtD,SAAI,GAAJ,IAAI,CAAM;IAIlB,CAAC;CACD;AACD,aAAa"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './authority/doh-json.js';
+export * from './errors.js';
+export * from './schemas/xrpc.js';
+export * from './types.js';
+export * from './utils.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './authority/doh-json.js';
+export * from './errors.js';
+export * from './schemas/xrpc.js';
+export * from './types.js';
+export * from './utils.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;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/schemas/verify.d.ts

@@ -0,0 +1,18 @@
+import { type DidDocument } from '@atcute/identity';
+import { type AtprotoDid } from '@atcute/lexicons/syntax';
+export interface VerifiedRecord {
+    /** AT-URI of the record */
+    uri: string;
+    /** CID of the record */
+    cid: string;
+    /** Record data */
+    record: unknown;
+}
+export interface VerifyRecordOptions {
+    did: AtprotoDid;
+    collection: string;
+    rkey: string;
+    didDocument: DidDocument;
+    carBytes: Uint8Array;
+}
+export declare const verifyRecord: ({ did, collection, rkey, didDocument, carBytes, }: VerifyRecordOptions) => Promise<VerifiedRecord>;

package/dist/schemas/verify.js

@@ -0,0 +1,169 @@
+import * as CAR from '@atcute/car';
+import { CarReader } from '@atcute/car/v4';
+import * as CBOR from '@atcute/cbor';
+import * as CID from '@atcute/cid';
+import { getPublicKeyFromDidController, verifySig } from '@atcute/crypto';
+import { getAtprotoVerificationMaterial } from '@atcute/identity';
+import {} from '@atcute/lexicons/syntax';
+import { toSha256 } from '@atcute/uint8array';
+export const verifyRecord = async ({ did, collection, rkey, didDocument, carBytes, }) => {
+    // grab public key from did document
+    let publicKey;
+    {
+        const controller = getAtprotoVerificationMaterial(didDocument);
+        if (!controller) {
+            throw new Error(`did document does not contain verification material`);
+        }
+        publicKey = getPublicKeyFromDidController(controller);
+    }
+    // read the car
+    let blockmap;
+    let commit;
+    {
+        const reader = CarReader.fromUint8Array(carBytes);
+        if (reader.header.data.roots.length !== 1) {
+            throw new Error(`car must have exactly one root`);
+        }
+        blockmap = new Map();
+        for (const entry of reader) {
+            const cidString = CID.toString(entry.cid);
+            // Verify that `bytes` matches its associated CID
+            const expectedCid = CID.toString(await CID.create(entry.cid.codec, entry.bytes));
+            if (cidString !== expectedCid) {
+                throw new Error(`cid does not match bytes`);
+            }
+            blockmap.set(cidString, entry);
+        }
+        if (blockmap.size === 0) {
+            throw new Error(`car must have at least one block`);
+        }
+        commit = CAR.readBlock(blockmap, reader.header.data.roots[0], CAR.isCommit);
+    }
+    // verify did in commit matches the did
+    if (commit.did !== did) {
+        throw new Error(`did in commit does not match expected did`);
+    }
+    // verify signature contained in commit is valid
+    {
+        const { sig, ...unsigned } = commit;
+        const data = CBOR.encode(unsigned);
+        const valid = await verifySig(publicKey, CBOR.fromBytes(sig), data);
+        if (!valid) {
+            throw new Error(`signature verification failed`);
+        }
+    }
+    // find and verify the record in the commit
+    const targetKey = `${collection}/${rkey}`;
+    const { found } = await dfs(blockmap, commit.data.$link, targetKey);
+    if (!found) {
+        throw new Error(`could not find record in car`);
+    }
+    return {
+        uri: `at://${did}/${collection}/${rkey}`,
+        cid: found.cid,
+        record: found.record,
+    };
+};
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+const dfs = async (blockmap, from, targetKey, visited = new Set()) => {
+    // If there's no starting point, return empty state
+    if (from == null) {
+        return { found: false };
+    }
+    // Check for cycles
+    {
+        if (visited.has(from)) {
+            throw new Error(`cycle detected; cid=${from}`);
+        }
+        visited.add(from);
+    }
+    // Get the block data
+    let node;
+    {
+        const entry = blockmap.get(from);
+        if (!entry) {
+            return { found: false };
+        }
+        const decoded = CBOR.decode(entry.bytes);
+        if (!CAR.isMstNode(decoded)) {
+            throw new Error(`invalid mst node; cid=${from}`);
+        }
+        node = decoded;
+    }
+    // Recursively process the left child
+    const left = await dfs(blockmap, node.l?.$link, targetKey, visited);
+    let key = '';
+    let found = left.found;
+    let depth;
+    let firstKey;
+    let lastKey;
+    // Process all entries in this node
+    for (const entry of node.e) {
+        // Construct the key by truncating and appending
+        key = key.substring(0, entry.p) + decoder.decode(CBOR.fromBytes(entry.k));
+        // Check if this is our target key
+        if (key === targetKey) {
+            const recordBlock = blockmap.get(entry.v.$link);
+            if (recordBlock) {
+                const record = CBOR.decode(recordBlock.bytes);
+                found = { cid: entry.v.$link, record };
+            }
+        }
+        // Calculate depth based on leading zeros in the hash
+        const keyDigest = await toSha256(encoder.encode(key));
+        let zeroCount = 0;
+        outerLoop: for (const byte of keyDigest) {
+            for (let bit = 7; bit >= 0; bit--) {
+                if (((byte >> bit) & 1) !== 0) {
+                    break outerLoop;
+                }
+                zeroCount++;
+            }
+        }
+        const thisDepth = Math.floor(zeroCount / 2);
+        // Ensure consistent depth
+        if (depth === undefined) {
+            depth = thisDepth;
+        }
+        else if (depth !== thisDepth) {
+            throw new Error(`node has entries with different depths; cid=${from}`);
+        }
+        // Track first and last keys
+        if (lastKey === undefined) {
+            firstKey = key;
+            lastKey = key;
+        }
+        // Check key ordering
+        if (lastKey > key) {
+            throw new Error(`entries are out of order; cid=${from}`);
+        }
+        // Process right child
+        const right = await dfs(blockmap, entry.t?.$link, targetKey, visited);
+        // Check ordering with right subtree
+        if (right.min && right.min < lastKey) {
+            throw new Error(`entries are out of order; cid=${from}`);
+        }
+        found = found || right.found;
+        // Check depth ordering
+        if (left.depth !== undefined && left.depth >= thisDepth) {
+            throw new Error(`depths are out of order; cid=${from}`);
+        }
+        if (right.depth !== undefined && right.depth >= thisDepth) {
+            throw new Error(`depths are out of order; cid=${from}`);
+        }
+        // Update last key based on right subtree
+        lastKey = right.max ?? key;
+    }
+    // Check ordering with left subtree
+    if (left.max && firstKey && left.max > firstKey) {
+        throw new Error(`entries are out of order; cid=${from}`);
+    }
+    return {
+        found,
+        min: firstKey,
+        max: lastKey,
+        depth,
+    };
+};
+//# sourceMappingURL=verify.js.map

package/dist/schemas/verify.js.map

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

package/dist/schemas/xrpc.d.ts

@@ -0,0 +1,13 @@
+import type { DidDocumentResolver } from '@atcute/identity-resolver';
+import type { AtprotoDid, Nsid } from '@atcute/lexicons/syntax';
+import type { ResolvedSchema, ResolveLexiconRecordOptions } from '../types.js';
+export interface LexiconSchemaResolverOptions {
+    didDocumentResolver: DidDocumentResolver;
+    fetch?: typeof fetch;
+}
+export declare class LexiconSchemaResolver {
+    #private;
+    readonly didDocumentResolver: DidDocumentResolver;
+    constructor({ didDocumentResolver, fetch: fetchThis }: LexiconSchemaResolverOptions);
+    resolve(authority: AtprotoDid, nsid: Nsid, options?: ResolveLexiconRecordOptions): Promise<ResolvedSchema>;
+}

package/dist/schemas/xrpc.js

@@ -0,0 +1,82 @@
+import { getPdsEndpoint } from '@atcute/identity';
+import { lexiconDoc } from '@atcute/lexicon-doc';
+import { FailedResponseError } from '@atcute/util-fetch';
+import { LEXICON_SCHEMA_COLLECTION } from '../constants.js';
+import * as err from '../errors.js';
+import { verifyRecord } from './verify.js';
+export class LexiconSchemaResolver {
+    didDocumentResolver;
+    #fetch;
+    constructor({ didDocumentResolver, fetch: fetchThis = fetch }) {
+        this.didDocumentResolver = didDocumentResolver;
+        this.#fetch = fetchThis;
+    }
+    async resolve(authority, nsid, options) {
+        // Step 1: Resolve DID to get PDS service endpoint
+        const didDocument = await this.didDocumentResolver.resolve(authority, {
+            signal: options?.signal,
+            noCache: options?.noCache,
+        });
+        const pdsEndpoint = getPdsEndpoint(didDocument);
+        if (!pdsEndpoint) {
+            throw new err.FailedLexiconResolutionError(nsid, {
+                cause: new TypeError(`no pds service in did document; did=${authority}`),
+            });
+        }
+        // Step 2: Fetch the record
+        let carBytes;
+        try {
+            const url = new URL('/xrpc/com.atproto.sync.getRecord', pdsEndpoint);
+            url.searchParams.set('did', authority);
+            url.searchParams.set('collection', LEXICON_SCHEMA_COLLECTION);
+            url.searchParams.set('rkey', nsid);
+            const response = await (0, this.#fetch)(url, {
+                signal: options?.signal,
+                cache: options?.noCache ? 'no-cache' : undefined,
+                headers: { accept: 'application/vnd.ipld.car' },
+            });
+            if (!response.ok) {
+                throw new FailedResponseError(response.status, `got http ${response.status}`);
+            }
+            carBytes = await response.bytes();
+        }
+        catch (cause) {
+            throw new err.FailedLexiconResolutionError(nsid, { cause });
+        }
+        // Step 3: Verify record and extract data
+        let verifiedRecord;
+        try {
+            verifiedRecord = await verifyRecord({
+                did: authority,
+                collection: LEXICON_SCHEMA_COLLECTION,
+                rkey: nsid,
+                didDocument,
+                carBytes,
+            });
+        }
+        catch (cause) {
+            throw new err.InvalidLexiconProofError(nsid, { cause });
+        }
+        // Step 4: Parse into lexicon schema
+        const rawSchema = verifiedRecord.record;
+        if (typeof rawSchema !== 'object' ||
+            rawSchema === null ||
+            rawSchema.$type !== LEXICON_SCHEMA_COLLECTION ||
+            rawSchema.id !== nsid) {
+            throw new err.InvalidLexiconSchemaError(nsid);
+        }
+        let schema;
+        try {
+            schema = lexiconDoc.parse(rawSchema, { mode: 'passthrough' });
+        }
+        catch (cause) {
+            throw new err.InvalidLexiconSchemaError(nsid, { cause });
+        }
+        return {
+            uri: verifiedRecord.uri,
+            cid: verifiedRecord.cid,
+            schema,
+        };
+    }
+}
+//# sourceMappingURL=xrpc.js.map

package/dist/schemas/xrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrpc.js","sourceRoot":"","sources":["../../lib/schemas/xrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAOhE,MAAM,OAAO,qBAAqB;IACxB,mBAAmB,CAAsB;IAClD,MAAM,CAAe;IAErB,YAAY,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAgC;QAC1F,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CACZ,SAAqB,EACrB,IAAU,EACV,OAAqC;QAErC,kDAAkD;QAClD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE;YACrE,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,OAAO,EAAE,OAAO,EAAE,OAAO;SACzB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,CAAC,4BAA4B,CAAC,IAAI,EAAE;gBAChD,KAAK,EAAE,IAAI,SAAS,CAAC,uCAAuC,SAAS,EAAE,CAAC;aACxE,CAAC,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,QAAoB,CAAC;QACzB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,kCAAkC,EAAE,WAAW,CAAC,CAAC;YACrE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;YAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAEnC,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,OAAO,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE;aAC/C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/E,CAAC;YAED,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,4BAA4B,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,yCAAyC;QACzC,IAAI,cAA8B,CAAC;QACnC,IAAI,CAAC;YACJ,cAAc,GAAG,MAAM,YAAY,CAAC;gBACnC,GAAG,EAAE,SAAS;gBACd,UAAU,EAAE,yBAAyB;gBACrC,IAAI,EAAE,IAAI;gBACV,WAAW;gBACX,QAAQ;aACR,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,oCAAoC;QACpC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC;QACxC,IACC,OAAO,SAAS,KAAK,QAAQ;YAC7B,SAAS,KAAK,IAAI;YACjB,SAAiB,CAAC,KAAK,KAAK,yBAAyB;YACrD,SAAiB,CAAC,EAAE,KAAK,IAAI,EAC7B,CAAC;YACF,MAAM,IAAI,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,MAAkB,CAAC;QACvB,IAAI,CAAC;YACJ,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,yBAAyB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO;YACN,GAAG,EAAE,cAAc,CAAC,GAAG;YACvB,GAAG,EAAE,cAAc,CAAC,GAAG;YACvB,MAAM;SACN,CAAC;IACH,CAAC;CACD"}