@sdxc/zone-file 0.0.0-pre.1 → 0.0.0-stage

package/dist/lexer.js

@@ -1,128 +0,0 @@
-/**
- * Splits master-file text into entries: one per line, or one per parenthesized group of
- * lines, each a list of fields with its trailing comment. Quotes, escapes and parentheses
- * are settled here, so the entry reader sees fields and never characters.
- *
- * @author [Sergio Xalambrí](https://sergiodxa.com)
- * @copyright Sergio Xalambrí 2026
- */
-/** Whether a character separates fields. */
-function isSpace(char) {
-    return char === " " || char === "\t" || char === "\r";
-}
-/** Whether a character ends a bare field. */
-function endsField(char) {
-    return isSpace(char) || char === ";" || char === "(" || char === ")";
-}
-/**
- * The index of the quote closing the one at `start`, skipping escaped characters, or `-1`
- * when the line ends first.
- */
-function closingQuote(line, start) {
-    let end = start + 1;
-    while (end < line.length && line[end] !== '"')
-        end += line[end] === "\\" ? 2 : 1;
-    return end < line.length ? end : -1;
-}
-/**
- * Splits text into entries. Blank and comment-only lines produce none; an entry whose
- * parentheses never close runs to the end of the text and carries an error, as does one
- * with a quote left open at the end of a line.
- *
- * @param text - The zone file's contents.
- * @returns The entries in file order.
- * @example lex("www IN A 192.0.2.1 ; web")[0]?.tokens.length // 4
- */
-export function lex(text) {
-    let lines = text.split(/\r?\n/);
-    let entries = [];
-    let current = null;
-    let depth = 0;
-    let firstLine = 0;
-    for (let index = 0; index < lines.length; index++) {
-        let line = lines[index] ?? "";
-        if (current === null) {
-            firstLine = index;
-            current = {
-                line: index + 1,
-                endLine: index + 1,
-                blankOwner: isSpace(line[0]),
-                tokens: [],
-                comment: null,
-                error: null,
-                input: "",
-            };
-        }
-        let entry = current;
-        entry.endLine = index + 1;
-        let fail = (message) => {
-            entry.error ??= message;
-        };
-        let position = 0;
-        while (position < line.length) {
-            let char = line[position];
-            if (isSpace(char)) {
-                position += 1;
-            }
-            else if (char === ";") {
-                let comment = line.slice(position + 1).trim();
-                if (depth === 0)
-                    entry.comment = comment.length > 0 ? comment : null;
-                break;
-            }
-            else if (char === "(") {
-                if (depth > 0)
-                    fail("Parentheses cannot nest");
-                depth = 1;
-                position += 1;
-            }
-            else if (char === ")") {
-                if (depth === 0)
-                    fail("A closing parenthesis has no opening one");
-                depth = 0;
-                position += 1;
-            }
-            else if (char === '"') {
-                let end = closingQuote(line, position);
-                if (end === -1) {
-                    fail("A quoted string cannot span lines");
-                    entry.tokens.push({ text: `${line.slice(position)}"`, quoted: true });
-                    break;
-                }
-                entry.tokens.push({ text: line.slice(position, end + 1), quoted: true });
-                position = end + 1;
-            }
-            else {
-                let end = position;
-                while (end < line.length && !endsField(line[end])) {
-                    if (line[end] === '"') {
-                        let closing = closingQuote(line, end);
-                        if (closing === -1) {
-                            fail("A quoted string cannot span lines");
-                            end = line.length;
-                            break;
-                        }
-                        end = closing + 1;
-                    }
-                    else {
-                        end += line[end] === "\\" ? 2 : 1;
-                    }
-                }
-                entry.tokens.push({ text: line.slice(position, end), quoted: false });
-                position = end;
-            }
-        }
-        if (depth === 0) {
-            entry.input = lines.slice(firstLine, index + 1).join("\n");
-            if (entry.tokens.length > 0 || entry.error !== null)
-                entries.push(entry);
-            current = null;
-        }
-    }
-    if (current !== null) {
-        current.error ??= "An opening parenthesis is never closed";
-        current.input = lines.slice(firstLine).join("\n");
-        entries.push(current);
-    }
-    return entries;
-}

package/dist/names.d.ts

@@ -1,49 +0,0 @@
-/**
- * Domain names in presentation form (RFC 1035 section 5.1): reads `\.` and `\DDD` escapes
- * into label octets, qualifies relative names against an origin, and prints one canonical
- * spelling, lowercased with every special octet escaped, so equal names compare equal.
- *
- * @author [Sergio Xalambrí](https://sergiodxa.com)
- * @copyright Sergio Xalambrí 2026
- */
-/** How relative names are read; see `ZoneFile.ParseOptions.relativeNames`. */
-export type RelativeNames = "rfc1035" | "origin-suffix";
-/**
- * Prints labels as a canonical name without the trailing dot, the root as `"."`. Wire
- * labels from RFC 3597 generic data print through here too, so both spellings agree.
- */
-export declare function printLabels(labels: readonly Uint8Array[]): string;
-/**
- * Reads a name as written, absolute or not, into its canonical spelling: lowercased, no
- * trailing dot, the root as `"."`. `null` when the text is not a valid name.
- *
- * @example canonicalName("Mail.Example.COM.") // "mail.example.com"
- * @example canonicalName("a\\065b.example.com") // "aab.example.com"
- */
-export declare function canonicalName(text: string): string | null;
-/**
- * Resolves a name as a zone file writes it to its absolute canonical spelling: `@` is the
- * origin, a trailing dot marks an absolute name, and any other name gets the origin
- * appended. `null` when the text, or the qualified name, is not a valid name.
- *
- * @param text - The name as written.
- * @param origin - The current origin, in canonical form.
- * @param mode - `"origin-suffix"` reads a relative name already ending in the origin as absolute.
- * @example qualifyName("www", "example.com", "rfc1035") // "www.example.com"
- */
-export declare function qualifyName(text: string, origin: string, mode: RelativeNames): string | null;
-/**
- * Writes a canonical name relative to `origin` when it is the origin (`@`) or below it, and
- * absolute with its trailing dot otherwise.
- *
- * @example relativeName("www.example.com", "example.com") // "www"
- * @example relativeName("example.net", "example.com") // "example.net."
- */
-export declare function relativeName(name: string, origin: string): string;
-/**
- * Writes a name absolute: the trailing dot added unless it is the root or already ends in
- * an unescaped dot.
- *
- * @example absoluteName("mx.example.com") // "mx.example.com."
- */
-export declare function absoluteName(name: string): string;

package/dist/names.js

@@ -1,167 +0,0 @@
-/**
- * Domain names in presentation form (RFC 1035 section 5.1): reads `\.` and `\DDD` escapes
- * into label octets, qualifies relative names against an origin, and prints one canonical
- * spelling, lowercased with every special octet escaped, so equal names compare equal.
- *
- * @author [Sergio Xalambrí](https://sergiodxa.com)
- * @copyright Sergio Xalambrí 2026
- */
-/** Encodes literal characters into the octets they stand for. */
-const ENCODER = new TextEncoder();
-/**
- * Octets printed with a backslash: the label separator, the escape itself, and the
- * characters a zone file reads as syntax (`"`, `$`, `(`, `)`, `;`, `@`).
- */
-const SPECIAL_OCTETS = new Set([0x22, 0x24, 0x28, 0x29, 0x2e, 0x3b, 0x40, 0x5c]);
-/** The longest label RFC 1035 allows, in octets. */
-const MAX_LABEL_OCTETS = 63;
-/** The longest name RFC 1035 allows, in wire octets: each label plus its length, plus the root. */
-const MAX_NAME_OCTETS = 255;
-/**
- * Reads presentation text into label octets. Fails on an empty label, a label over 63
- * octets, a decimal escape above 255 and a lone trailing backslash.
- */
-function readName(text) {
-    if (text === ".")
-        return { labels: [], absolute: true };
-    let chars = Array.from(text);
-    let labels = [];
-    let label = [];
-    let absolute = false;
-    for (let index = 0; index < chars.length; index++) {
-        let char = chars[index] ?? "";
-        if (char === "\\") {
-            let digits = chars.slice(index + 1, index + 4).join("");
-            if (/^\d{3}$/.test(digits)) {
-                let octet = Number(digits);
-                if (octet > 255)
-                    return null;
-                label.push(octet);
-                index += 3;
-                continue;
-            }
-            let next = chars[index + 1];
-            if (next === undefined)
-                return null;
-            label.push(...ENCODER.encode(next));
-            index += 1;
-            continue;
-        }
-        if (char === ".") {
-            if (label.length === 0)
-                return null;
-            labels.push(Uint8Array.from(label));
-            label = [];
-            if (index === chars.length - 1)
-                absolute = true;
-            continue;
-        }
-        label.push(...ENCODER.encode(char));
-    }
-    if (!absolute) {
-        if (label.length === 0)
-            return null;
-        labels.push(Uint8Array.from(label));
-    }
-    return labels.every((part) => part.length <= MAX_LABEL_OCTETS) ? { labels, absolute } : null;
-}
-/** Whether labels fit in the 255 wire octets of one name. */
-function fits(labels) {
-    return labels.reduce((total, label) => total + label.length + 1, 1) <= MAX_NAME_OCTETS;
-}
-/** One label in canonical form: ASCII letters lowercased, specials and non-printables escaped. */
-function printLabel(label) {
-    let printed = "";
-    for (let octet of label) {
-        let folded = octet >= 0x41 && octet <= 0x5a ? octet + 0x20 : octet;
-        if (SPECIAL_OCTETS.has(folded))
-            printed += `\\${String.fromCharCode(folded)}`;
-        else if (folded > 0x20 && folded < 0x7f)
-            printed += String.fromCharCode(folded);
-        else
-            printed += `\\${String(folded).padStart(3, "0")}`;
-    }
-    return printed;
-}
-/**
- * Prints labels as a canonical name without the trailing dot, the root as `"."`. Wire
- * labels from RFC 3597 generic data print through here too, so both spellings agree.
- */
-export function printLabels(labels) {
-    return labels.length === 0 ? "." : labels.map(printLabel).join(".");
-}
-/** The labels of a canonical name, as `canonicalName` prints it. */
-function labelsOf(canonical) {
-    return readName(canonical === "." ? "." : `${canonical}.`)?.labels ?? [];
-}
-/** Whether `labels` end with every label of `suffix`, compared in canonical form. */
-function endsWithLabels(labels, suffix) {
-    if (suffix.length > labels.length)
-        return false;
-    let offset = labels.length - suffix.length;
-    return suffix.every((label, index) => printLabel(label) === printLabel(labels[offset + index] ?? new Uint8Array()));
-}
-/**
- * Reads a name as written, absolute or not, into its canonical spelling: lowercased, no
- * trailing dot, the root as `"."`. `null` when the text is not a valid name.
- *
- * @example canonicalName("Mail.Example.COM.") // "mail.example.com"
- * @example canonicalName("a\\065b.example.com") // "aab.example.com"
- */
-export function canonicalName(text) {
-    let name = readName(text);
-    return name && fits(name.labels) ? printLabels(name.labels) : null;
-}
-/**
- * Resolves a name as a zone file writes it to its absolute canonical spelling: `@` is the
- * origin, a trailing dot marks an absolute name, and any other name gets the origin
- * appended. `null` when the text, or the qualified name, is not a valid name.
- *
- * @param text - The name as written.
- * @param origin - The current origin, in canonical form.
- * @param mode - `"origin-suffix"` reads a relative name already ending in the origin as absolute.
- * @example qualifyName("www", "example.com", "rfc1035") // "www.example.com"
- */
-export function qualifyName(text, origin, mode) {
-    if (text === "@")
-        return origin;
-    let name = readName(text);
-    if (!name)
-        return null;
-    if (name.absolute)
-        return fits(name.labels) ? printLabels(name.labels) : null;
-    let originLabels = labelsOf(origin);
-    if (mode === "origin-suffix" && originLabels.length > 0) {
-        if (endsWithLabels(name.labels, originLabels))
-            return printLabels(name.labels);
-    }
-    let labels = [...name.labels, ...originLabels];
-    return fits(labels) ? printLabels(labels) : null;
-}
-/**
- * Writes a canonical name relative to `origin` when it is the origin (`@`) or below it, and
- * absolute with its trailing dot otherwise.
- *
- * @example relativeName("www.example.com", "example.com") // "www"
- * @example relativeName("example.net", "example.com") // "example.net."
- */
-export function relativeName(name, origin) {
-    if (name === origin)
-        return "@";
-    let labels = labelsOf(name);
-    let originLabels = labelsOf(origin);
-    if (labels.length > originLabels.length && endsWithLabels(labels, originLabels))
-        return printLabels(labels.slice(0, labels.length - originLabels.length));
-    return absoluteName(name);
-}
-/**
- * Writes a name absolute: the trailing dot added unless it is the root or already ends in
- * an unescaped dot.
- *
- * @example absoluteName("mx.example.com") // "mx.example.com."
- */
-export function absoluteName(name) {
-    let trailing = /(\\*)\.$/.exec(name);
-    let absolute = name === "." || (trailing !== null && (trailing[1] ?? "").length % 2 === 0);
-    return absolute ? name : `${name}.`;
-}

package/dist/parse-record-data.d.ts

@@ -1,23 +0,0 @@
-/**
- * Reads record data in presentation format, as a zone file or a DoH JSON answer writes it,
- * into typed fields per record type. RFC 3597 generic data (`\# len hex`) is decoded from
- * its wire form, which is how some resolvers answer types such as CAA.
- *
- * @author [Sergio Xalambrí](https://sergiodxa.com)
- * @copyright Sergio Xalambrí 2026
- */
-import type { Result } from "@sdxc/result";
-import type * as ZoneFile from "./types.js";
-import { RecordDataError } from "./errors.js";
-/**
- * Reads a record's data into its typed fields; untyped types come back as `{ type, data }`.
- * Names come back canonical (lowercased, escapes resolved, no trailing dot, the root as
- * `"."`), and SOA timers accept BIND's TTL units (`2h`, `1w`) as zone files write them.
- *
- * @param type - The record type, as a mnemonic or RFC 3597 `TYPEnnn`.
- * @param data - The RDATA in presentation format.
- * @returns The record's fields, or why the data does not fit the type.
- * @template Type - The record type, which selects the fields returned.
- * @example parseRecordData("MX", "10 mx.example.com.") // success({ type: "MX", preference: 10, exchange: "mx.example.com" })
- */
-export declare function parseRecordData<Type extends ZoneFile.RecordType>(type: Type, data: string): Result<ZoneFile.RecordData<Type>, RecordDataError>;

package/dist/parse-record-data.js

@@ -1,288 +0,0 @@
-import { failure, isFailure, success } from "@sdxc/result";
-import { decodeOctets, readCharacterStrings } from "./character-strings.js";
-import { RecordDataError } from "./errors.js";
-import { canonicalName, printLabels } from "./names.js";
-import { canonicalType } from "./record-types.js";
-import { readTtl } from "./ttl.js";
-/**
- * A dotted-quad IPv4 address without leading zeros, which `inet_aton` would read as octal
- * and browsers as decimal, so an address carrying them has no single meaning.
- */
-const IPV4_PATTERN = /^(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}$/;
-/**
- * Reads a record's data into its typed fields; untyped types come back as `{ type, data }`.
- * Names come back canonical (lowercased, escapes resolved, no trailing dot, the root as
- * `"."`), and SOA timers accept BIND's TTL units (`2h`, `1w`) as zone files write them.
- *
- * @param type - The record type, as a mnemonic or RFC 3597 `TYPEnnn`.
- * @param data - The RDATA in presentation format.
- * @returns The record's fields, or why the data does not fit the type.
- * @template Type - The record type, which selects the fields returned.
- * @example parseRecordData("MX", "10 mx.example.com.") // success({ type: "MX", preference: 10, exchange: "mx.example.com" })
- */
-export function parseRecordData(type, data) {
-    let canonical = canonicalType(type);
-    let value = data.trim();
-    let parsed = value.startsWith("\\#")
-        ? parseGeneric(canonical, value)
-        : parsePresentation(canonical, value);
-    return parsed;
-}
-/** Fails with the reason a record's data does not fit its type. */
-function invalid(type, data) {
-    return failure(new RecordDataError(`Invalid ${type} record data: ${JSON.stringify(data)}`));
-}
-/** Reads an unsigned decimal field no larger than `max`, or `null`. */
-function readNumber(field, max) {
-    if (field === undefined || !/^\d+$/.test(field))
-        return null;
-    let number = Number(field);
-    return number <= max ? number : null;
-}
-/** An IPv6 literal in RFC 5952 canonical form, or `null` when the text is not one. */
-function canonicalIpv6(value) {
-    if (!value.includes(":"))
-        return null;
-    let url = URL.parse(`http://[${value}]/`);
-    return url ? url.hostname.slice(1, -1) : null;
-}
-/** Reads presentation-format data for the typed record types. */
-function parsePresentation(type, value) {
-    let fields = value.split(/\s+/).filter((field) => field.length > 0);
-    switch (type) {
-        case "A":
-            return IPV4_PATTERN.test(value) ? success({ type, address: value }) : invalid(type, value);
-        case "AAAA": {
-            let address = canonicalIpv6(value);
-            return address ? success({ type, address }) : invalid(type, value);
-        }
-        case "CNAME":
-        case "NS":
-        case "PTR":
-        case "DNAME": {
-            let name = fields.length === 1 && fields[0] !== undefined ? canonicalName(fields[0]) : null;
-            if (name === null)
-                return invalid(type, value);
-            return success(type === "NS" ? { type, host: name } : { type, target: name });
-        }
-        case "MX": {
-            let preference = readNumber(fields[0], 0xffff);
-            let exchange = fields[1] === undefined ? null : canonicalName(fields[1]);
-            if (fields.length !== 2 || preference === null || exchange === null)
-                return invalid(type, value);
-            return success({ type, preference, exchange });
-        }
-        case "TXT": {
-            let strings = readCharacterStrings(value);
-            if (isFailure(strings))
-                return strings;
-            return success({ type, text: strings.data.join(""), strings: strings.data });
-        }
-        case "CAA": {
-            let match = /^(\d+)\s+([A-Za-z0-9]+)\s+(.+)$/.exec(value);
-            let flags = readNumber(match?.[1], 0xff);
-            if (!match || flags === null || match[2] === undefined || match[3] === undefined)
-                return invalid(type, value);
-            let raw = match[3];
-            let text = raw;
-            if (raw.startsWith('"')) {
-                let strings = readCharacterStrings(raw);
-                if (isFailure(strings))
-                    return strings;
-                text = strings.data.join("");
-            }
-            return success({
-                type,
-                flags,
-                critical: (flags & 0x80) !== 0,
-                tag: match[2].toLowerCase(),
-                value: text,
-            });
-        }
-        case "SRV": {
-            let [priority, weight, port] = fields.slice(0, 3).map((field) => readNumber(field, 0xffff));
-            let target = fields[3] === undefined ? null : canonicalName(fields[3]);
-            if (fields.length !== 4 ||
-                priority == null ||
-                weight == null ||
-                port == null ||
-                target === null)
-                return invalid(type, value);
-            return success({ type, priority, weight, port, target });
-        }
-        case "SOA": {
-            let [primary, mailbox] = fields.slice(0, 2).map((field) => canonicalName(field));
-            let numbers = fields
-                .slice(2)
-                .map((field, index) => readNumber(field, 0xffffffff) ?? (index > 0 ? readTtl(field) : null));
-            if (fields.length !== 7 ||
-                primary == null ||
-                mailbox == null ||
-                numbers.some((n) => n === null)) {
-                return invalid(type, value);
-            }
-            let [serial, refresh, retry, expire, minimum] = numbers;
-            return success({
-                type,
-                primary,
-                mailbox,
-                serial,
-                refresh,
-                retry,
-                expire,
-                minimum,
-            });
-        }
-        default:
-            return success({ type, data: value });
-    }
-}
-/** Decodes RFC 3597 generic data (`\# <length> <hex>`) and reads the octets for the type. */
-function parseGeneric(type, value) {
-    let match = /^\\#\s+(\d+)((?:\s*[0-9a-fA-F]+)*)\s*$/.exec(value);
-    if (!match)
-        return invalid(type, value);
-    let hex = (match[2] ?? "").replace(/\s+/g, "");
-    let length = Number(match[1]);
-    if (hex.length !== length * 2)
-        return invalid(type, value);
-    let octets = new Uint8Array(length);
-    for (let index = 0; index < length; index++)
-        octets[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
-    let fields = new WireReader(octets).record(type);
-    if (fields === "unknown")
-        return success({ type, data: value });
-    return fields ? success({ type, ...fields }) : invalid(type, value);
-}
-/**
- * Reads the wire form of RDATA front to back. Every read returns `null` past the end, and a
- * record parses only when it consumes every octet, since trailing bytes mean a wrong type.
- */
-class WireReader {
-    #octets;
-    #offset = 0;
-    /** @param octets - The RDATA octets. */
-    constructor(octets) {
-        this.#octets = octets;
-    }
-    /**
-     * The typed fields for `type`, `null` when the octets do not fit it, or `"unknown"` for a
-     * type without a typed reading.
-     */
-    record(type) {
-        let fields = this.#fields(type);
-        if (fields === null || fields === "unknown")
-            return fields;
-        return this.#offset === this.#octets.length ? fields : null;
-    }
-    /** Reads the type's fields, leaving the offset after the last octet read. */
-    #fields(type) {
-        switch (type) {
-            case "A": {
-                let bytes = this.#bytes(4);
-                return bytes ? { address: Array.from(bytes).join(".") } : null;
-            }
-            case "AAAA": {
-                let bytes = this.#bytes(16);
-                if (!bytes)
-                    return null;
-                let groups = Array.from({ length: 8 }, (_, index) => (((bytes[index * 2] ?? 0) << 8) | (bytes[index * 2 + 1] ?? 0)).toString(16));
-                return { address: canonicalIpv6(groups.join(":")) ?? groups.join(":") };
-            }
-            case "CNAME":
-            case "PTR":
-            case "DNAME": {
-                let target = this.#name();
-                return target === null ? null : { target };
-            }
-            case "NS": {
-                let host = this.#name();
-                return host === null ? null : { host };
-            }
-            case "MX": {
-                let preference = this.#uint(2);
-                let exchange = this.#name();
-                return preference === null || exchange === null ? null : { preference, exchange };
-            }
-            case "TXT": {
-                let strings = [];
-                while (this.#offset < this.#octets.length) {
-                    let length = this.#uint(1);
-                    let bytes = length === null ? null : this.#bytes(length);
-                    if (!bytes)
-                        return null;
-                    strings.push(decodeOctets(bytes));
-                }
-                return { text: strings.join(""), strings };
-            }
-            case "CAA": {
-                let flags = this.#uint(1);
-                let tagLength = this.#uint(1);
-                let tag = tagLength === null ? null : this.#bytes(tagLength);
-                if (flags === null || !tag || tag.length === 0)
-                    return null;
-                let rest = this.#bytes(this.#octets.length - this.#offset) ?? new Uint8Array();
-                return {
-                    flags,
-                    critical: (flags & 0x80) !== 0,
-                    tag: decodeOctets(tag).toLowerCase(),
-                    value: decodeOctets(rest),
-                };
-            }
-            case "SRV": {
-                let priority = this.#uint(2);
-                let weight = this.#uint(2);
-                let port = this.#uint(2);
-                let target = this.#name();
-                if (priority === null || weight === null || port === null || target === null)
-                    return null;
-                return { priority, weight, port, target };
-            }
-            case "SOA": {
-                let primary = this.#name();
-                let mailbox = this.#name();
-                let numbers = Array.from({ length: 5 }, () => this.#uint(4));
-                if (primary === null || mailbox === null || numbers.some((n) => n === null))
-                    return null;
-                let [serial, refresh, retry, expire, minimum] = numbers;
-                return { primary, mailbox, serial, refresh, retry, expire, minimum };
-            }
-            default:
-                return "unknown";
-        }
-    }
-    /** The next `length` octets, or `null` past the end. */
-    #bytes(length) {
-        if (this.#offset + length > this.#octets.length)
-            return null;
-        let bytes = this.#octets.subarray(this.#offset, this.#offset + length);
-        this.#offset += length;
-        return bytes;
-    }
-    /** A big-endian unsigned integer of `size` octets. */
-    #uint(size) {
-        let bytes = this.#bytes(size);
-        if (!bytes)
-            return null;
-        return bytes.reduce((total, byte) => total * 256 + byte, 0);
-    }
-    /**
-     * An uncompressed domain name, printed like presentation names. RFC 3597 forbids
-     * compression in generic data, so a compression pointer fails the read.
-     */
-    #name() {
-        let labels = [];
-        while (true) {
-            let length = this.#uint(1);
-            if (length === null || length > 63)
-                return null;
-            if (length === 0)
-                break;
-            let label = this.#bytes(length);
-            if (!label)
-                return null;
-            labels.push(label);
-        }
-        return printLabels(labels);
-    }
-}

package/dist/parse.d.ts

@@ -1,25 +0,0 @@
-/**
- * Reads an RFC 1035 master file into the records it declares and the entries it could not
- * use: directives, inherited owners, TTLs and classes, `$INCLUDE` through a caller-supplied
- * reader, and names qualified in owners and in typed RDATA.
- *
- * @author [Sergio Xalambrí](https://sergiodxa.com)
- * @copyright Sergio Xalambrí 2026
- */
-import type { Result } from "@sdxc/result";
-import type * as ZoneFile from "./types.js";
-import { ZoneFileError } from "./errors.js";
-/**
- * Reads a zone file. The only failure is `too-large`; every unreadable entry is a
- * `Rejection` beside the records that did parse, so one bad line never costs the rest, and
- * a caller that wants all-or-nothing checks `rejected.length`.
- *
- * Records outside the origin, repeats, non-`IN` classes and every record type are all
- * returned: which of them to keep is the caller's decision.
- *
- * @param text - The zone file's contents.
- * @param options - The origin, and how to read TTLs, includes and relative names.
- * @returns The records and rejections, or the size that passed `maxBytes`.
- * @example parse("www 300 IN A 192.0.2.1", { origin: "example.com" }) // records: [{ name: "www.example.com", ttl: 300, … }]
- */
-export declare function parse(text: string, options: ZoneFile.ParseOptions): Result<ZoneFile.Zone, ZoneFileError>;