n8n-nodes-dns 0.1.0

package/dist/src/transport/dns-client.d.ts

@@ -0,0 +1,22 @@
+import type { DnsRecordType, DnsResponse } from './dns-packet';
+export interface DnsServer {
+    address: string;
+    port: number;
+}
+export interface DnsClientOptions {
+    timeoutMilliseconds?: number;
+    retryCount?: number;
+    recursionDesired?: boolean;
+}
+export interface DnsServerResult {
+    server: DnsServer;
+    response: DnsResponse | null;
+    responseCode: string;
+    truncated: boolean;
+    responseTimeMilliseconds: number;
+}
+export interface DnsQueryResult {
+    results: DnsServerResult[];
+}
+export declare function querySingleServer(domain: string, recordType: DnsRecordType, server: DnsServer, options?: DnsClientOptions): Promise<DnsServerResult>;
+export declare function queryMultipleServers(domain: string, recordType: DnsRecordType, servers: DnsServer[], options?: DnsClientOptions): Promise<DnsQueryResult>;

package/dist/src/transport/dns-client.js

@@ -0,0 +1,168 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.querySingleServer = querySingleServer;
+exports.queryMultipleServers = queryMultipleServers;
+const dgram = __importStar(require("dgram"));
+const dns_packet_1 = require("./dns-packet");
+const DEFAULT_TIMEOUT_MILLISECONDS = 5000;
+const DEFAULT_RETRY_COUNT = 1;
+const TIMEOUT_RESPONSE_CODE = 'TIMEOUT';
+const UNKNOWN_RESPONSE_CODE = 'UNKNOWN';
+class DnsTimeoutError extends Error {
+    constructor(server) {
+        super(`DNS query to ${server.address}:${server.port} timed out`);
+        this.code = 'ETIMEOUT';
+    }
+}
+function extractTransactionId(packet) {
+    return packet.readUInt16BE(0);
+}
+function isTimeoutError(error) {
+    return error instanceof DnsTimeoutError;
+}
+function sendQuery(packet, expectedTransactionId, server, timeoutMilliseconds) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const socket = dgram.createSocket('udp4');
+        function trySettle() {
+            if (settled)
+                return false;
+            settled = true;
+            clearTimeout(timer);
+            socket.close();
+            return true;
+        }
+        const timer = setTimeout(() => {
+            if (trySettle())
+                reject(new DnsTimeoutError(server));
+        }, timeoutMilliseconds);
+        socket.on('message', (message) => {
+            if (message.readUInt16BE(0) !== expectedTransactionId)
+                return;
+            if (trySettle())
+                resolve(message);
+        });
+        socket.on('error', (error) => {
+            if (trySettle())
+                reject(error);
+        });
+        socket.send(packet, 0, packet.length, server.port, server.address, (sendError) => {
+            if (sendError && trySettle())
+                reject(sendError);
+        });
+    });
+}
+async function queryWithRetry(packet, expectedTransactionId, server, timeoutMilliseconds, retryCount) {
+    const totalAttempts = 1 + retryCount;
+    for (let attempt = 0; attempt < totalAttempts; attempt++) {
+        try {
+            return await sendQuery(packet, expectedTransactionId, server, timeoutMilliseconds);
+        }
+        catch (error) {
+            const isLastAttempt = attempt === totalAttempts - 1;
+            if (!isTimeoutError(error) || isLastAttempt)
+                throw error;
+        }
+    }
+    throw new DnsTimeoutError(server);
+}
+function buildServerResult(server, response, responseTimeMilliseconds) {
+    var _a;
+    const numericCode = response.header.flags.responseCode;
+    const responseCode = (_a = dns_packet_1.RESPONSE_CODE_NAMES[numericCode]) !== null && _a !== void 0 ? _a : UNKNOWN_RESPONSE_CODE;
+    return {
+        server,
+        response,
+        responseCode,
+        truncated: response.header.flags.truncated,
+        responseTimeMilliseconds,
+    };
+}
+function buildTimeoutResult(server) {
+    return {
+        server,
+        response: null,
+        responseCode: TIMEOUT_RESPONSE_CODE,
+        truncated: false,
+        responseTimeMilliseconds: 0,
+    };
+}
+function buildNetworkErrorResult(server, error) {
+    return {
+        server,
+        response: null,
+        responseCode: error.message,
+        truncated: false,
+        responseTimeMilliseconds: 0,
+    };
+}
+async function querySingleServer(domain, recordType, server, options) {
+    var _a, _b, _c;
+    const timeoutMilliseconds = (_a = options === null || options === void 0 ? void 0 : options.timeoutMilliseconds) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MILLISECONDS;
+    const retryCount = (_b = options === null || options === void 0 ? void 0 : options.retryCount) !== null && _b !== void 0 ? _b : DEFAULT_RETRY_COUNT;
+    const recursionDesired = (_c = options === null || options === void 0 ? void 0 : options.recursionDesired) !== null && _c !== void 0 ? _c : true;
+    const packet = (0, dns_packet_1.encodeQuery)(domain, recordType, { recursionDesired });
+    const transactionId = extractTransactionId(packet);
+    const startTime = Date.now();
+    try {
+        const responseBuffer = await queryWithRetry(packet, transactionId, server, timeoutMilliseconds, retryCount);
+        const response = (0, dns_packet_1.decodeResponse)(responseBuffer);
+        const elapsed = Date.now() - startTime;
+        return buildServerResult(server, response, elapsed);
+    }
+    catch (error) {
+        if (isTimeoutError(error))
+            return buildTimeoutResult(server);
+        const message = `DNS query to ${server.address}:${server.port} failed: ` +
+            (error instanceof Error ? error.message : String(error));
+        throw new Error(message);
+    }
+}
+async function queryMultipleServers(domain, recordType, servers, options) {
+    if (servers.length === 0)
+        return { results: [] };
+    const promises = servers.map((server) => querySingleServer(domain, recordType, server, options));
+    const settled = await Promise.allSettled(promises);
+    const results = settled.map((outcome, index) => {
+        if (outcome.status === 'fulfilled')
+            return outcome.value;
+        const server = servers[index];
+        const error = outcome.reason instanceof Error ? outcome.reason : new Error(String(outcome.reason));
+        return buildNetworkErrorResult(server, error);
+    });
+    return { results };
+}
+//# sourceMappingURL=dns-client.js.map

package/dist/src/transport/dns-client.js.map

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

package/dist/src/transport/dns-packet.d.ts

@@ -0,0 +1,49 @@
+export type DnsRecordType = 'A' | 'AAAA' | 'MX' | 'TXT' | 'SRV' | 'PTR' | 'CAA' | 'SOA' | 'NS' | 'CNAME' | 'NAPTR' | 'DNSKEY' | 'TLSA';
+export interface QueryFlags {
+    recursionDesired?: boolean;
+}
+export interface DnsHeaderFlags {
+    queryResponse: boolean;
+    opcode: number;
+    authoritative: boolean;
+    truncated: boolean;
+    recursionDesired: boolean;
+    recursionAvailable: boolean;
+    responseCode: number;
+}
+export interface DnsHeader {
+    transactionId: number;
+    flags: DnsHeaderFlags;
+    questionCount: number;
+    answerCount: number;
+    authorityCount: number;
+    additionalCount: number;
+}
+export interface DnsQuestion {
+    name: string;
+    recordType: number;
+    recordClass: number;
+}
+export interface DnsResourceRecord {
+    name: string;
+    recordType: number;
+    recordClass: number;
+    ttl: number;
+    rdataLength: number;
+    rdata: Buffer;
+    rdataOffset: number;
+}
+export interface DnsResponse {
+    header: DnsHeader;
+    questions: DnsQuestion[];
+    answers: DnsResourceRecord[];
+    authorities: DnsResourceRecord[];
+    additionals: DnsResourceRecord[];
+    rawPacket: Buffer;
+}
+export declare const RECORD_TYPE_VALUES: Record<DnsRecordType, number>;
+export declare const RECORD_TYPE_NAMES: Record<number, DnsRecordType>;
+export declare const RESPONSE_CODE_NAMES: Record<number, string>;
+export declare function encodeDomainName(domain: string): Buffer;
+export declare function encodeQuery(domain: string, recordType: DnsRecordType, flags?: QueryFlags): Buffer;
+export declare function decodeResponse(packet: Buffer): DnsResponse;

package/dist/src/transport/dns-packet.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESPONSE_CODE_NAMES = exports.RECORD_TYPE_NAMES = exports.RECORD_TYPE_VALUES = void 0;
+exports.encodeDomainName = encodeDomainName;
+exports.encodeQuery = encodeQuery;
+exports.decodeResponse = decodeResponse;
+const crypto_1 = require("crypto");
+const utils_1 = require("../utils");
+exports.RECORD_TYPE_VALUES = {
+    A: 1,
+    NS: 2,
+    CNAME: 5,
+    SOA: 6,
+    PTR: 12,
+    MX: 15,
+    TXT: 16,
+    AAAA: 28,
+    SRV: 33,
+    NAPTR: 35,
+    DNSKEY: 48,
+    TLSA: 52,
+    CAA: 257,
+};
+exports.RECORD_TYPE_NAMES = Object.fromEntries(Object.entries(exports.RECORD_TYPE_VALUES).map(([name, value]) => [value, name]));
+exports.RESPONSE_CODE_NAMES = {
+    0: 'NOERROR',
+    1: 'FORMERR',
+    2: 'SERVFAIL',
+    3: 'NXDOMAIN',
+    4: 'NOTIMP',
+    5: 'REFUSED',
+};
+const HEADER_LENGTH = 12;
+const QUERY_CLASS_IN = 1;
+const MAX_LABEL_LENGTH = 63;
+function encodeDomainName(domain) {
+    if (domain === '') {
+        return Buffer.from([0x00]);
+    }
+    const labels = domain.split('.');
+    const segments = [];
+    let nameLength = 0;
+    for (const label of labels) {
+        if (label.length === 0) {
+            throw new Error('DNS domain name contains an empty label');
+        }
+        if (label.length > MAX_LABEL_LENGTH) {
+            throw new Error(`DNS label "${label.slice(0, 10)}..." length ${label.length} exceeds maximum of ${MAX_LABEL_LENGTH} bytes`);
+        }
+        nameLength += (nameLength > 0 ? 1 : 0) + label.length;
+        if (nameLength > utils_1.DNS_MAX_NAME_LENGTH) {
+            throw new Error(`DNS domain name exceeds maximum length of ${utils_1.DNS_MAX_NAME_LENGTH} characters`);
+        }
+        const lengthByte = Buffer.from([label.length]);
+        const labelBytes = Buffer.from(label, 'ascii');
+        segments.push(lengthByte, labelBytes);
+    }
+    segments.push(Buffer.from([0x00]));
+    return Buffer.concat(segments);
+}
+function encodeHeader(transactionId, flags, questionCount) {
+    var _a;
+    const header = Buffer.alloc(HEADER_LENGTH);
+    transactionId.copy(header, 0);
+    const recursionDesired = (_a = flags.recursionDesired) !== null && _a !== void 0 ? _a : true;
+    const flagsWord = recursionDesired ? 0x0100 : 0x0000;
+    header.writeUInt16BE(flagsWord, 2);
+    header.writeUInt16BE(questionCount, 4);
+    return header;
+}
+function encodeQuestion(domain, recordType) {
+    const encodedName = encodeDomainName(domain);
+    const typeAndClass = Buffer.alloc(4);
+    typeAndClass.writeUInt16BE(exports.RECORD_TYPE_VALUES[recordType], 0);
+    typeAndClass.writeUInt16BE(QUERY_CLASS_IN, 2);
+    return Buffer.concat([encodedName, typeAndClass]);
+}
+function encodeQuery(domain, recordType, flags) {
+    const transactionId = (0, crypto_1.randomBytes)(2);
+    const header = encodeHeader(transactionId, flags !== null && flags !== void 0 ? flags : {}, 1);
+    const question = encodeQuestion(domain, recordType);
+    return Buffer.concat([header, question]);
+}
+function decodeHeaderFlags(flagsWord) {
+    return {
+        queryResponse: (flagsWord & 0x8000) !== 0,
+        opcode: (flagsWord >> 11) & 0x0f,
+        authoritative: (flagsWord & 0x0400) !== 0,
+        truncated: (flagsWord & 0x0200) !== 0,
+        recursionDesired: (flagsWord & 0x0100) !== 0,
+        recursionAvailable: (flagsWord & 0x0080) !== 0,
+        responseCode: flagsWord & 0x000f,
+    };
+}
+function decodeHeader(packet) {
+    if (packet.length < HEADER_LENGTH) {
+        throw new Error(`DNS packet too short: expected at least ${HEADER_LENGTH} bytes, got ${packet.length}`);
+    }
+    return {
+        transactionId: packet.readUInt16BE(0),
+        flags: decodeHeaderFlags(packet.readUInt16BE(2)),
+        questionCount: packet.readUInt16BE(4),
+        answerCount: packet.readUInt16BE(6),
+        authorityCount: packet.readUInt16BE(8),
+        additionalCount: packet.readUInt16BE(10),
+    };
+}
+function decodeQuestion(packet, offset) {
+    const { name, bytesConsumed: nameBytes } = (0, utils_1.decompressName)(packet, offset);
+    const typeClassOffset = offset + nameBytes;
+    if (typeClassOffset + 4 > packet.length) {
+        throw new Error('DNS packet truncated in question section');
+    }
+    return {
+        question: {
+            name,
+            recordType: packet.readUInt16BE(typeClassOffset),
+            recordClass: packet.readUInt16BE(typeClassOffset + 2),
+        },
+        bytesConsumed: nameBytes + 4,
+    };
+}
+function decodeResourceRecord(packet, offset) {
+    const { name, bytesConsumed: nameBytes } = (0, utils_1.decompressName)(packet, offset);
+    const fixedFieldsOffset = offset + nameBytes;
+    if (fixedFieldsOffset + 10 > packet.length) {
+        throw new Error('DNS packet truncated in resource record');
+    }
+    const recordType = packet.readUInt16BE(fixedFieldsOffset);
+    const recordClass = packet.readUInt16BE(fixedFieldsOffset + 2);
+    const ttl = packet.readUInt32BE(fixedFieldsOffset + 4);
+    const rdataLength = packet.readUInt16BE(fixedFieldsOffset + 8);
+    const rdataOffset = fixedFieldsOffset + 10;
+    if (rdataOffset + rdataLength > packet.length) {
+        throw new Error('DNS packet truncated in resource record RDATA');
+    }
+    return {
+        record: {
+            name,
+            recordType,
+            recordClass,
+            ttl,
+            rdataLength,
+            rdata: Buffer.from(packet.subarray(rdataOffset, rdataOffset + rdataLength)),
+            rdataOffset,
+        },
+        bytesConsumed: nameBytes + 10 + rdataLength,
+    };
+}
+function decodeQuestionSection(packet, offset, count) {
+    const questions = [];
+    let currentOffset = offset;
+    for (let questionIndex = 0; questionIndex < count; questionIndex++) {
+        const { question, bytesConsumed } = decodeQuestion(packet, currentOffset);
+        questions.push(question);
+        currentOffset += bytesConsumed;
+    }
+    return { questions, offset: currentOffset };
+}
+function decodeResourceRecordSection(packet, offset, count) {
+    const records = [];
+    let currentOffset = offset;
+    for (let recordIndex = 0; recordIndex < count; recordIndex++) {
+        const { record, bytesConsumed } = decodeResourceRecord(packet, currentOffset);
+        records.push(record);
+        currentOffset += bytesConsumed;
+    }
+    return { records, offset: currentOffset };
+}
+function decodeResponse(packet) {
+    const header = decodeHeader(packet);
+    const { questions, offset: afterQuestions } = decodeQuestionSection(packet, HEADER_LENGTH, header.questionCount);
+    const { records: answers, offset: afterAnswers } = decodeResourceRecordSection(packet, afterQuestions, header.answerCount);
+    const { records: authorities, offset: afterAuthorities } = decodeResourceRecordSection(packet, afterAnswers, header.authorityCount);
+    const { records: additionals } = decodeResourceRecordSection(packet, afterAuthorities, header.additionalCount);
+    return { header, questions, answers, authorities, additionals, rawPacket: packet };
+}
+//# sourceMappingURL=dns-packet.js.map

package/dist/src/transport/dns-packet.js.map

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

package/dist/src/transport/dns-resolvers.d.ts

@@ -0,0 +1,18 @@
+import type { DnsServer } from './dns-client';
+export declare const DNS_DEFAULT_PORT = 53;
+export interface WellKnownResolver {
+    name: string;
+    primary: string;
+    secondary: string;
+    notes: string;
+}
+export declare const WELL_KNOWN_RESOLVERS: readonly WellKnownResolver[];
+export declare function parseResolvConf(content: string): string[];
+export declare function readSystemResolvers(): Promise<DnsServer[]>;
+export declare function getWellKnownServers(resolverNames: string[]): DnsServer[];
+export type ResolverMode = 'wellKnown' | 'custom' | 'system';
+export interface ResolverSelection {
+    wellKnownNames?: string[];
+    customServers?: DnsServer[];
+}
+export declare function resolveTargetServers(mode: ResolverMode, selection: ResolverSelection): Promise<DnsServer[]>;

package/dist/src/transport/dns-resolvers.js

@@ -0,0 +1,132 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WELL_KNOWN_RESOLVERS = exports.DNS_DEFAULT_PORT = void 0;
+exports.parseResolvConf = parseResolvConf;
+exports.readSystemResolvers = readSystemResolvers;
+exports.getWellKnownServers = getWellKnownServers;
+exports.resolveTargetServers = resolveTargetServers;
+const fs = __importStar(require("fs"));
+exports.DNS_DEFAULT_PORT = 53;
+const RESOLV_CONF_PATH = '/etc/resolv.conf';
+exports.WELL_KNOWN_RESOLVERS = [
+    {
+        name: 'Cloudflare',
+        primary: '1.1.1.1',
+        secondary: '1.0.0.1',
+        notes: 'Fastest average response time',
+    },
+    { name: 'Google', primary: '8.8.8.8', secondary: '8.8.4.4', notes: 'Widest adoption' },
+    {
+        name: 'Quad9',
+        primary: '9.9.9.9',
+        secondary: '149.112.112.112',
+        notes: 'Malware blocking enabled',
+    },
+    {
+        name: 'Quad9 Unfiltered',
+        primary: '9.9.9.10',
+        secondary: '149.112.112.10',
+        notes: 'No filtering',
+    },
+    {
+        name: 'OpenDNS',
+        primary: '208.67.222.222',
+        secondary: '208.67.220.220',
+        notes: 'Cisco-operated',
+    },
+    {
+        name: 'Cloudflare Malware',
+        primary: '1.1.1.2',
+        secondary: '1.0.0.2',
+        notes: 'Malware blocking',
+    },
+    {
+        name: 'Cloudflare Family',
+        primary: '1.1.1.3',
+        secondary: '1.0.0.3',
+        notes: 'Malware + adult content blocking',
+    },
+    { name: 'AdGuard', primary: '94.140.14.14', secondary: '94.140.15.15', notes: 'Ad blocking' },
+    {
+        name: 'Control D',
+        primary: '76.76.2.0',
+        secondary: '76.76.10.0',
+        notes: 'Configurable filtering',
+    },
+];
+const resolversByName = new Map(exports.WELL_KNOWN_RESOLVERS.map((resolver) => [resolver.name, resolver]));
+function removeComment(line) {
+    return line.replace(/[#;].*$/, '');
+}
+function parseResolvConf(content) {
+    const nameservers = [];
+    for (const rawLine of content.split('\n')) {
+        const line = removeComment(rawLine).trim();
+        const tokens = line.split(/\s+/);
+        if (tokens[0] === 'nameserver' && tokens[1]) {
+            nameservers.push(tokens[1]);
+        }
+    }
+    return nameservers;
+}
+async function readSystemResolvers() {
+    const content = await fs.promises.readFile(RESOLV_CONF_PATH, 'utf-8');
+    const addresses = parseResolvConf(content);
+    return addresses.map((address) => ({ address, port: exports.DNS_DEFAULT_PORT }));
+}
+function getWellKnownServers(resolverNames) {
+    const servers = [];
+    for (const name of resolverNames) {
+        const resolver = resolversByName.get(name);
+        if (!resolver) {
+            throw new Error(`Unknown resolver: "${name}"`);
+        }
+        servers.push({ address: resolver.primary, port: exports.DNS_DEFAULT_PORT }, { address: resolver.secondary, port: exports.DNS_DEFAULT_PORT });
+    }
+    return servers;
+}
+async function resolveTargetServers(mode, selection) {
+    var _a, _b;
+    switch (mode) {
+        case 'wellKnown':
+            return getWellKnownServers((_a = selection.wellKnownNames) !== null && _a !== void 0 ? _a : []);
+        case 'custom':
+            return (_b = selection.customServers) !== null && _b !== void 0 ? _b : [];
+        case 'system':
+            return readSystemResolvers();
+    }
+}
+//# sourceMappingURL=dns-resolvers.js.map

package/dist/src/transport/dns-resolvers.js.map

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

package/dist/src/transport/index.d.ts

@@ -0,0 +1,6 @@
+export { encodeQuery, decodeResponse, encodeDomainName, RECORD_TYPE_VALUES, RECORD_TYPE_NAMES, RESPONSE_CODE_NAMES, } from './dns-packet';
+export type { DnsRecordType, DnsHeader, DnsHeaderFlags, DnsQuestion, DnsResourceRecord, DnsResponse, QueryFlags, } from './dns-packet';
+export { querySingleServer, queryMultipleServers } from './dns-client';
+export type { DnsServer, DnsClientOptions, DnsServerResult, DnsQueryResult } from './dns-client';
+export { DNS_DEFAULT_PORT, WELL_KNOWN_RESOLVERS, parseResolvConf, readSystemResolvers, getWellKnownServers, resolveTargetServers, } from './dns-resolvers';
+export type { WellKnownResolver, ResolverMode, ResolverSelection } from './dns-resolvers';

package/dist/src/transport/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTargetServers = exports.getWellKnownServers = exports.readSystemResolvers = exports.parseResolvConf = exports.WELL_KNOWN_RESOLVERS = exports.DNS_DEFAULT_PORT = exports.queryMultipleServers = exports.querySingleServer = exports.RESPONSE_CODE_NAMES = exports.RECORD_TYPE_NAMES = exports.RECORD_TYPE_VALUES = exports.encodeDomainName = exports.decodeResponse = exports.encodeQuery = void 0;
+var dns_packet_1 = require("./dns-packet");
+Object.defineProperty(exports, "encodeQuery", { enumerable: true, get: function () { return dns_packet_1.encodeQuery; } });
+Object.defineProperty(exports, "decodeResponse", { enumerable: true, get: function () { return dns_packet_1.decodeResponse; } });
+Object.defineProperty(exports, "encodeDomainName", { enumerable: true, get: function () { return dns_packet_1.encodeDomainName; } });
+Object.defineProperty(exports, "RECORD_TYPE_VALUES", { enumerable: true, get: function () { return dns_packet_1.RECORD_TYPE_VALUES; } });
+Object.defineProperty(exports, "RECORD_TYPE_NAMES", { enumerable: true, get: function () { return dns_packet_1.RECORD_TYPE_NAMES; } });
+Object.defineProperty(exports, "RESPONSE_CODE_NAMES", { enumerable: true, get: function () { return dns_packet_1.RESPONSE_CODE_NAMES; } });
+var dns_client_1 = require("./dns-client");
+Object.defineProperty(exports, "querySingleServer", { enumerable: true, get: function () { return dns_client_1.querySingleServer; } });
+Object.defineProperty(exports, "queryMultipleServers", { enumerable: true, get: function () { return dns_client_1.queryMultipleServers; } });
+var dns_resolvers_1 = require("./dns-resolvers");
+Object.defineProperty(exports, "DNS_DEFAULT_PORT", { enumerable: true, get: function () { return dns_resolvers_1.DNS_DEFAULT_PORT; } });
+Object.defineProperty(exports, "WELL_KNOWN_RESOLVERS", { enumerable: true, get: function () { return dns_resolvers_1.WELL_KNOWN_RESOLVERS; } });
+Object.defineProperty(exports, "parseResolvConf", { enumerable: true, get: function () { return dns_resolvers_1.parseResolvConf; } });
+Object.defineProperty(exports, "readSystemResolvers", { enumerable: true, get: function () { return dns_resolvers_1.readSystemResolvers; } });
+Object.defineProperty(exports, "getWellKnownServers", { enumerable: true, get: function () { return dns_resolvers_1.getWellKnownServers; } });
+Object.defineProperty(exports, "resolveTargetServers", { enumerable: true, get: function () { return dns_resolvers_1.resolveTargetServers; } });
+//# sourceMappingURL=index.js.map

package/dist/src/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":";;;AAAA,2CAOsB;AANrB,yGAAA,WAAW,OAAA;AACX,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AAWpB,2CAAuE;AAA9D,+GAAA,iBAAiB,OAAA;AAAE,kHAAA,oBAAoB,OAAA;AAEhD,iDAOyB;AANxB,iHAAA,gBAAgB,OAAA;AAChB,qHAAA,oBAAoB,OAAA;AACpB,gHAAA,eAAe,OAAA;AACf,oHAAA,mBAAmB,OAAA;AACnB,oHAAA,mBAAmB,OAAA;AACnB,qHAAA,oBAAoB,OAAA"}

package/dist/src/utils/authoritative-discovery.d.ts

@@ -0,0 +1,9 @@
+import type { DnsRecordType } from '../transport/dns-packet';
+import type { DnsClientOptions, DnsServer, DnsServerResult } from '../transport/dns-client';
+export type QueryFunction = (domain: string, recordType: DnsRecordType, server: DnsServer, options?: DnsClientOptions) => Promise<DnsServerResult>;
+export interface WalkDelegationChainOptions {
+    recursiveResolver: DnsServer;
+    queryFn?: QueryFunction;
+    clientOptions?: DnsClientOptions;
+}
+export declare function walkDelegationChain(domain: string, options: WalkDelegationChainOptions): Promise<DnsServer[]>;