@nictool/dns-resource-record 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ Notable changes to this project are documented in this file.
 
 #### Unreleased
 
+### [1.2.1] - 2024-03-10
+
+- fix(nsec3param): fixed setHash fname typo
+- feat(SVCB,HTTPS): add record support (#29)
+- feat(OPENGPGPKEY): improved bindline parser, added test
+- feat(throwHelp): far more useful error messages (#41)
+- feat(A,MX,AAAA,CAA,IPSECKEY): added getCanonical
+
 ### [1.2.0] - 2024-03-07
 
 - feat(index): export typeMap (lookup table for type to id)
@@ -286,3 +294,4 @@ Notable changes to this project are documented in this file.
 [1.1.5]: https://github.com/NicTool/dns-resource-record/releases/tag/1.1.5
 [1.1.6]: https://github.com/NicTool/dns-resource-record/releases/tag/1.1.6
 [1.1.8]: https://github.com/NicTool/dns-resource-record/releases/tag/1.1.8
+[1.2.1]: https://github.com/NicTool/dns-resource-record/releases/tag/1.2.1

package/README.md

@@ -10,7 +10,7 @@ DNS resource record parser, validator, importer, and exporter.
 This module is used to:
 
 - validate well formedness and RFC compliance of DNS resource records
-- import RRs from and from the following formats:
+- import RRs to and from the following formats:
 
 |                      **RR format**                       |     **import**     |     **export**     |
 | :------------------------------------------------------: | :----------------: | :----------------: |
@@ -196,6 +196,7 @@ PRs are welcome, especially PRs with tests.
 |   **DNSKEY**   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |     **DS**     | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |   **HINFO**    | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+|   **HTTPS**    |                    |                    |                    |                    |
 |  **IPSECKEY**  | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |    **KEY**     |                    |                    |                    |                    |
 |    **LOC**     | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
@@ -215,6 +216,7 @@ PRs are welcome, especially PRs with tests.
 |    **SPF**     | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |    **SRV**     | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |   **SSHFP**    | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+|    **SVCB**    |                    |                    |                    |                    |
 |    **TLSA**    | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 |    **TSIG**    |                    |                    |                    |                    |
 |    **TXT**     | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |

package/index.js

@@ -10,6 +10,7 @@ import DNAME from './rr/dname.js'
 import DNSKEY from './rr/dnskey.js'
 import DS from './rr/ds.js'
 import HINFO from './rr/hinfo.js'
+import HTTPS from './rr/https.js'
 import IPSECKEY from './rr/ipseckey.js'
 import KEY from './rr/key.js'
 import LOC from './rr/loc.js'
@@ -29,6 +30,7 @@ import SOA from './rr/soa.js'
 import SPF from './rr/spf.js'
 import SRV from './rr/srv.js'
 import SSHFP from './rr/sshfp.js'
+import SVCB from './rr/svcb.js'
 import TLSA from './rr/tlsa.js'
 import TSIG from './rr/tsig.js'
 import TXT from './rr/txt.js'
@@ -47,6 +49,7 @@ export {
   DNSKEY,
   DS,
   HINFO,
+  HTTPS,
   IPSECKEY,
   KEY,
   LOC,
@@ -66,6 +69,7 @@ export {
   SOA,
   SPF,
   SRV,
+  SVCB,
   TLSA,
   TSIG,
   TXT,
@@ -84,6 +88,7 @@ for (const c of [
   DNSKEY,
   DS,
   HINFO,
+  HTTPS,
   IPSECKEY,
   KEY,
   LOC,
@@ -103,6 +108,7 @@ for (const c of [
   SOA,
   SPF,
   SRV,
+  SVCB,
   TLSA,
   TSIG,
   TXT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nictool/dns-resource-record",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "DNS Resource Records",
   "main": "index.js",
   "type": "module",

package/rr/a.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 
@@ -9,8 +9,8 @@ export default class A extends RR {
 
   /****** Resource record specific setters   *******/
   setAddress(val) {
-    if (!val) throw new Error('A: address is required')
-    if (!net.isIPv4(val)) throw new Error('A address must be IPv4')
+    if (!val) this.throwHelp('A: address is required')
+    if (!net.isIPv4(val)) this.throwHelp('A address must be IPv4')
     this.set('address', val)
   }
 
@@ -30,6 +30,16 @@ export default class A extends RR {
     return 1
   }
 
+  getCanonical() {
+    return {
+      owner: 'host.example.com.',
+      class: 'IN',
+      ttl: 3600,
+      type: 'A',
+      address: '192.0.2.127',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns(opts) {
     // +fqdn:ip:ttl:timestamp:lo

package/rr/aaaa.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 import * as TINYDNS from '../lib/tinydns.js'
@@ -10,8 +10,8 @@ export default class AAAA extends RR {
 
   /****** Resource record specific setters   *******/
   setAddress(val) {
-    if (!val) throw new Error('AAAA: address is required')
-    if (!net.isIPv6(val)) throw new Error(`AAAA: address must be IPv6 (${val})`)
+    if (!val) this.throwHelp('AAAA: address is required')
+    if (!net.isIPv6(val)) this.throwHelp(`AAAA: address must be IPv6 (${val})`)
 
     this.set('address', this.expand(val.toLowerCase())) // lower case: RFC 5952
   }
@@ -36,6 +36,16 @@ export default class AAAA extends RR {
     return 28
   }
 
+  getCanonical() {
+    return {
+      owner: 'host.example.com.',
+      address: '2001:0db8:0020:000a:0000:0000:0000:0004',
+      class: 'IN',
+      ttl: 3600,
+      type: 'A',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns(opts) {
     const str = opts.tinyline
@@ -45,7 +55,7 @@ export default class AAAA extends RR {
       case ':':
         // GENERIC  =>  :fqdn:28:rdata:ttl:timestamp:lo
         ;[fqdn, n, rdata, ttl, ts, loc] = str.substring(1).split(':')
-        if (n != 28) throw new Error('AAAA fromTinydns, invalid n')
+        if (n != 28) this.throwHelp('AAAA fromTinydns, invalid n')
         ip = TINYDNS.octalToHex(rdata)
           .match(/([0-9a-fA-F]{4})/g)
           .join(':')

package/rr/caa.js

@@ -11,7 +11,7 @@ export default class CAA extends RR {
     this.is8bitInt('CAA', 'flags', val)
 
     if (![0, 128].includes(val)) {
-      throw new Error(`CAA flags ${val} not recognized, ${this.citeRFC()}`)
+      this.throwHelp(`CAA flags ${val} not recognized`)
     }
 
     this.set('flags', val)
@@ -19,12 +19,12 @@ export default class CAA extends RR {
 
   setTag(val) {
     if (typeof val !== 'string' || val.length < 1 || /[^a-z0-9]/.test(val))
-      throw new Error(
-        `CAA tag must be a sequence of ASCII letters and numbers in lowercase, ${this.citeRFC()}`,
+      this.throwHelp(
+        `CAA tag must be a sequence of ASCII letters and numbers in lowercase`,
       )
 
     if (!['issue', 'issuewild', 'iodef'].includes(val)) {
-      throw new Error(`CAA tag ${val} not recognized: ${this.citeRFC()}`)
+      this.throwHelp(`CAA tag ${val} not recognized`)
     }
     this.set('tag', val)
   }
@@ -35,16 +35,14 @@ export default class CAA extends RR {
     if (this.isQuoted(val)) {
       val = val.replace(/^["']|["']$/g, '') // strip quotes
     } else {
-      // if (/\s/.test(val)) throw new Error(`CAA value may not have spaces unless quoted: RFC 8659`)
+      // if (/\s/.test(val)) this.throwHelp(`CAA value may not have spaces unless quoted`)
     }
 
     // check if val starts with one of iodefSchemes
     if (this.get('tag') === 'iodef') {
       const iodefSchemes = ['mailto:', 'http:', 'https:']
       if (!iodefSchemes.filter((s) => val.startsWith(s)).length) {
-        throw new Error(
-          `CAA value must have valid iodefScheme prefix, ${this.citeRFC()}`,
-        )
+        this.throwHelp(`CAA value must have valid iodefScheme prefix`)
       }
     }
 
@@ -71,11 +69,23 @@ export default class CAA extends RR {
     return 257
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'CAA',
+      flags: 0,
+      tag: 'issue',
+      value: 'http://letsencrypt.org',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns(opts) {
     // CAA via generic, :fqdn:n:rdata:ttl:timestamp:lo
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 257) throw new Error('CAA fromTinydns, invalid n')
+    if (n != 257) this.throwHelp('CAA fromTinydns, invalid n')
 
     const flags = TINYDNS.octalToUInt8(rdata.substring(0, 4))
     const taglen = TINYDNS.octalToUInt8(rdata.substring(4, 8))
@@ -101,7 +111,7 @@ export default class CAA extends RR {
     const fields = opts.bindline.match(
       /^([^\s]+)\s+([0-9]+)\s+(\w+)\s+(\w+)\s+([0-9]+)\s+(\w+)\s+("[^"]+"|[^\s]+?)\s*$/i,
     )
-    if (!fields) throw new Error(`unable to parse: ${opts.bindline}`)
+    if (!fields) this.throwHelp(`unable to parse: ${opts.bindline}`)
 
     const [owner, ttl, c, type, flags, tag, value] = fields.slice(1)
     return new CAA({

package/rr/cname.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 
@@ -12,10 +12,10 @@ export default class CNAME extends RR {
     // A <domain-name> which specifies the canonical or primary
     // name for the owner.  The owner name is an alias.
 
-    if (!val) throw new Error('CNAME: cname is required')
+    if (!val) this.throwHelp('CNAME: cname is required')
 
     if (net.isIPv4(val) || net.isIPv6(val))
-      throw new Error(`CNAME: cname must be a FQDN: RFC 2181`)
+      this.throwHelp(`CNAME: cname must be a FQDN: RFC 2181`)
 
     if (!this.isFullyQualified('CNAME', 'cname', val)) return
     if (!this.isValidHostname('CNAME', 'cname', val)) return

package/rr/dname.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 import * as TINYDNS from '../lib/tinydns.js'
@@ -10,10 +10,10 @@ export default class DNAME extends RR {
 
   /****** Resource record specific setters   *******/
   setTarget(val) {
-    if (!val) throw new Error('DNAME: target is required')
+    if (!val) this.throwHelp('DNAME: target is required')
 
     if (net.isIPv4(val) || net.isIPv6(val))
-      throw new Error(`DNAME: target must be a domain name, ${this.citeRFC()}`)
+      this.throwHelp(`DNAME: target must be a domain name`)
 
     this.isFullyQualified('DNAME', 'target', val)
     this.isValidHostname('DNAME', 'target', val)
@@ -42,7 +42,7 @@ export default class DNAME extends RR {
   fromTinydns(opts) {
     // DNAME via generic, :fqdn:n:rdata:ttl:timestamp:lo
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 39) throw new Error('DNAME fromTinydns, invalid n')
+    if (n != 39) this.throwHelp('DNAME fromTinydns, invalid n')
 
     return new DNAME({
       type: 'DNAME',

package/rr/dnskey.js

@@ -13,8 +13,7 @@ export default class DNSKEY extends RR {
     this.is16bitInt('DNSKEY', 'flags', val)
 
     // the possible values are: 0, 256, and 257; RFC 4034
-    if (![0, 256, 257].includes(val))
-      throw new Error(`DNSKEY: flags invalid, ${this.citeRFC()}`)
+    if (![0, 256, 257].includes(val)) this.throwHelp(`DNSKEY: flags invalid`)
 
     this.set('flags', val)
   }
@@ -24,8 +23,7 @@ export default class DNSKEY extends RR {
     this.is8bitInt('DNSKEY', 'protocol', val)
 
     // The Protocol Field MUST be represented as an unsigned decimal integer with a value of 3.
-    if (![3].includes(val))
-      throw new Error(`DNSKEY: protocol invalid, ${this.citeRFC()}`)
+    if (![3].includes(val)) this.throwHelp(`DNSKEY: protocol invalid`)
 
     this.set('protocol', val)
   }
@@ -37,16 +35,13 @@ export default class DNSKEY extends RR {
     // https://www.iana.org/assignments/dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml
     // 1=RSA/MD5, 2=DH, 3=DSA/SHA-1, 4=EC, 5=RSA/SHA-1
     if (![...Array(16).keys(), 253, 254].includes(val))
-      console.error(
-        `DNSKEY: algorithm (${val}) not recognized, ${this.citeRFC()}`,
-      )
+      console.error(`DNSKEY: algorithm (${val}) not recognized`)
 
     this.set('algorithm', val)
   }
 
   setPublickey(val) {
-    if (!val)
-      throw new Error(`DNSKEY: publickey is required, ${this.citeRFC()}`)
+    if (!val) this.throwHelp(`DNSKEY: publickey is required`)
 
     this.set('publickey', val)
   }
@@ -74,7 +69,7 @@ export default class DNSKEY extends RR {
     const match = opts.bindline.match(
       /^([^\s]+)\s+([0-9]+)\s+(\w+)\s+(\w+)\s+([0-9]+)\s+([0-9]+)\s+([0-9]+)\s+\s*(.*?)\s*$/,
     )
-    if (!match) throw new Error(`unable to parse DNSKEY: ${opts.bindline}`)
+    if (!match) this.throwHelp(`unable to parse DNSKEY: ${opts.bindline}`)
     const [owner, ttl, c, type, flags, protocol, algorithm, publickey] =
       match.slice(1)
 
@@ -92,7 +87,7 @@ export default class DNSKEY extends RR {
 
   fromTinydns(opts) {
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 48) throw new Error('DNSKEY fromTinydns, invalid n')
+    if (n != 48) this.throwHelp('DNSKEY fromTinydns, invalid n')
 
     const bytes = Buffer.from(TINYDNS.octalToChar(rdata), 'binary')
 

package/rr/ds.js

@@ -10,9 +10,8 @@ export default class DS extends RR {
   /****** Resource record specific setters   *******/
   setKeyTag(val) {
     // a 2 octet Key Tag field...in network byte order
-    if (!val) throw new Error(`DS: key tag is required`)
-    if (val.length > 2)
-      throw new Error(`DS: key tag is too long, ${this.citeRFC()}`)
+    if (!val) this.throwHelp(`DS: key tag is required`)
+    if (val.length > 2) this.throwHelp(`DS: key tag is too long`)
 
     this.set('key tag', val)
   }
@@ -20,20 +19,19 @@ export default class DS extends RR {
   setAlgorithm(val) {
     // 1=RSA/MD5, 2=DH, 3=DSA/SHA-1, 4=EC, 5=RSA/SHA-1
     if (![1, 2, 3, 4, 5, 253, 254].includes(val))
-      throw new Error(`DS: algorithm invalid, ${this.citeRFC()}`)
+      this.throwHelp(`DS: algorithm invalid`)
 
     this.set('algorithm', val)
   }
 
   setDigestType(val) {
-    if (![1, 2].includes(val))
-      throw new Error(`DS: digest type invalid, ${this.citeRFC()}`)
+    if (![1, 2].includes(val)) this.throwHelp(`DS: digest type invalid`)
 
     this.set('digest type', val)
   }
 
   setDigest(val) {
-    if (!val) throw new Error(`DS: digest is required, ${this.citeRFC()}`)
+    if (!val) this.throwHelp(`DS: digest is required`)
 
     this.set('digest', val)
   }
@@ -74,7 +72,7 @@ export default class DS extends RR {
 
   fromTinydns(opts) {
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 43) throw new Error('DS fromTinydns, invalid n')
+    if (n != 43) this.throwHelp('DS fromTinydns, invalid n')
 
     const binRdata = Buffer.from(TINYDNS.octalToChar(rdata), 'binary')
 

package/rr/hinfo.js

@@ -9,12 +9,12 @@ export default class HINFO extends RR {
 
   /****** Resource record specific setters   *******/
   setCpu(val) {
-    if (val.length > 255) throw new Error('HINFO cpu cannot exceed 255 chars')
+    if (val.length > 255) this.throwHelp('HINFO cpu cannot exceed 255 chars')
     this.set('cpu', val.replace(/^["']|["']$/g, ''))
   }
 
   setOs(val) {
-    if (val.length > 255) throw new Error('HINFO os cannot exceed 255 chars')
+    if (val.length > 255) this.throwHelp('HINFO os cannot exceed 255 chars')
     this.set('os', val.replace(/^["']|["']$/g, ''))
   }
 
@@ -44,7 +44,7 @@ export default class HINFO extends RR {
     const match = opts.bindline.match(
       /([^\s]+)\s+([0-9]+)\s+(IN)\s+(HINFO)\s+("[^"]+"|[^\s]+)\s+("[^"]+"|[^\s]+)/i,
     )
-    if (!match) throw new Error(`unable to parse HINFO: ${opts.bindline}`)
+    if (!match) this.throwHelp(`unable to parse HINFO: ${opts.bindline}`)
     const [owner, ttl, c, type, cpu, os] = match.slice(1)
 
     return new HINFO({

package/rr/https.js

@@ -0,0 +1,62 @@
+import RR from '../rr.js'
+
+export default class HTTPS extends RR {
+  constructor(opts) {
+    super(opts)
+  }
+
+  /****** Resource record specific setters   *******/
+  setPriority(val) {
+    this.is16bitInt('HTTPS', 'priority', val)
+
+    this.set('priority', val)
+  }
+
+  setTargetName(val) {
+    // this.isFullyQualified('HTTPS', 'target name', val)
+    // this.isValidHostname('HTTPS', 'target name', val)
+
+    // RFC 4034: letters in the DNS names are lower cased
+    this.set('target name', val.toLowerCase())
+  }
+
+  setParams(val) {
+    // if (!val) this.throwHelp(`HTTPS: params is required`)
+
+    this.set('params', val)
+  }
+
+  getDescription() {
+    return 'HTTP Semantics'
+  }
+
+  getRdataFields(arg) {
+    return ['priority', 'target name', 'params']
+  }
+
+  getRFCs() {
+    return [9460]
+  }
+
+  getTypeId() {
+    return 65
+  }
+
+  /******  IMPORTERS   *******/
+
+  fromBind(opts) {
+    // test.example.com  3600  IN  HTTPS Priority TargetName Params
+    const [owner, ttl, c, type, pri, fqdn] = opts.bindline.split(/\s+/)
+    return new HTTPS({
+      owner,
+      ttl: parseInt(ttl, 10),
+      class: c,
+      type,
+      priority: parseInt(pri, 10),
+      'target name': fqdn,
+      params: opts.bindline.split(/\s+/).slice(6).join(' ').trim(),
+    })
+  }
+
+  /******  EXPORTERS   *******/
+}

package/rr/ipseckey.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 
@@ -20,23 +20,20 @@ export default class IPSECKEY extends RR {
   setGatewayType(val) {
     // 0 (none), 1 (4-byte IPv4), 2 (16-byte IPv6), 3 (wire encoded domain name)
     if (![0, 1, 2, 3].includes(val))
-      throw new Error(`IPSECKEY: Gateway Type is invalid, ${this.citeRFC()}`)
+      this.throwHelp(`IPSECKEY: Gateway Type is invalid`)
 
     this.set('gateway type', val)
   }
 
   setAlgorithm(val) {
     // unsigned int, 1 octet, values: 1=DSA, 2=RSA
-    if (![1, 2].includes(val))
-      throw new Error(`IPSECKEY: Algorithm invalid, ${this.citeRFC()}`)
+    if (![1, 2].includes(val)) this.throwHelp(`IPSECKEY: Algorithm invalid`)
 
     this.set('algorithm', val)
   }
 
   setGateway(val) {
-    const gwErr = new Error(
-      `IPSECKEY: gateway invalid (${val}), ${this.citeRFC()}`,
-    )
+    const gwErr = new Error(`IPSECKEY: gateway invalid (${val})`)
     switch (this.get('gateway type')) {
       case 0:
         if (val !== '.') throw gwErr
@@ -53,7 +50,7 @@ export default class IPSECKEY extends RR {
   }
 
   setPublickey(val) {
-    // if (val) throw new Error(`IPSECKEY: publickey is optional, ${this.citeRFC()}`)
+    // if (val) this.throwHelp(`IPSECKEY: publickey is optional`)
 
     this.set('publickey', val)
   }
@@ -74,6 +71,20 @@ export default class IPSECKEY extends RR {
     return 45
   }
 
+  getCanonical() {
+    return {
+      owner: '38.2.0.192.in-addr.arpa.',
+      ttl: 7200,
+      class: 'IN',
+      type: 'IPSECKEY',
+      precedence: 10,
+      'gateway type': 1,
+      algorithm: 2,
+      gateway: '192.0.2.38',
+      publickey: 'AQNRU3mG7TVTO2BkR47usntb102uFJtugbo6BSGvgqt4AQ==',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromBind(opts) {
     // FQDN TTL CLASS IPSECKEY Precedence GatewayType Algorithm Gateway PublicKey
@@ -94,7 +105,7 @@ export default class IPSECKEY extends RR {
 
   fromTinydns(opts) {
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 45) throw new Error('IPSECKEY fromTinydns, invalid n')
+    if (n != 45) this.throwHelp('IPSECKEY fromTinydns, invalid n')
 
     const precedence = TINYDNS.octalToUInt8(rdata.substring(0, 4))
     const gwType = TINYDNS.octalToUInt8(rdata.substring(4, 8))

package/rr/key.js

@@ -24,13 +24,13 @@ export default class KEY extends RR {
     // 1 octet
     // 1=RSA/MD5, 2=DH, 3=DSA/SHA-1, 4=EC, 5=RSA/SHA-1
     if (![1, 2, 3, 4, 5, 253, 254].includes(val))
-      throw new Error(`KEY: algorithm invalid, ${this.citeRFC()}`)
+      this.throwHelp(`KEY: algorithm invalid`)
 
     this.set('algorithm', val)
   }
 
   setPublickey(val) {
-    if (!val) throw new Error(`KEY: publickey is required, ${this.citeRFC()}`)
+    if (!val) this.throwHelp(`KEY: publickey is required`)
 
     this.set('publickey', val)
   }

package/rr/loc.js

@@ -20,7 +20,7 @@ export default class LOC extends RR {
 
   /****** Resource record specific setters   *******/
   setAddress(val) {
-    if (!val) throw new Error('LOC: address is required')
+    if (!val) this.throwHelp('LOC: address is required')
 
     /*
     ... LOC ( d1 [m1 [s1]] {"N"|"S"} d2 [m2 [s2]]
@@ -59,7 +59,7 @@ export default class LOC extends RR {
     // put them all together
     const locRe = new RegExp(`^${dms}(N|S)\\s+${dms}(E|W)\\s+${alt}`, 'i')
     const r = string.match(locRe)
-    if (!r) throw new Error('LOC address: invalid format, see RFC 1876')
+    if (!r) this.throwHelp('LOC address: invalid format, see RFC 1876')
 
     const loc = {
       latitude: {
@@ -89,7 +89,7 @@ export default class LOC extends RR {
   fromTinydns(opts) {
     // LOC via generic, :fqdn:n:rdata:ttl:timestamp:lo
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 29) throw new Error('LOC fromTinydns, invalid n')
+    if (n != 29) this.throwHelp('LOC fromTinydns, invalid n')
 
     // divide by 100 is to convert cm to meters
     const l = {
@@ -173,7 +173,7 @@ export default class LOC extends RR {
         hem = rawmsec >= REF.LATLON ? 'E' : 'W'
         break
       default:
-        throw new Error('unknown or missing hemisphere')
+        this.throwHelp('unknown or missing hemisphere')
     }
 
     return `${deg} ${min} ${sec}${msec ? '.' + msec : ''} ${hem}`

package/rr/mx.js

@@ -1,4 +1,4 @@
-import net from 'net'
+import net from 'node:net'
 
 import RR from '../rr.js'
 
@@ -10,15 +10,16 @@ export default class MX extends RR {
   /****** Resource record specific setters   *******/
   setPreference(val) {
     if (val === undefined) val = this?.default?.preference
+    if (val === undefined) this.throwHelp('MX: preference is required')
     this.is16bitInt('MX', 'preference', val)
     this.set('preference', val)
   }
 
   setExchange(val) {
-    if (!val) throw new Error('MX: exchange is required')
+    if (!val) this.throwHelp('MX: exchange is required')
 
     if (net.isIPv4(val) || net.isIPv6(val))
-      throw new Error(`MX: exchange must be a FQDN, ${this.citeRFC()}`)
+      this.throwHelp(`MX: exchange must be a FQDN`)
 
     this.isFullyQualified('MX', 'exchange', val)
     this.isValidHostname('MX', 'exchange', val)
@@ -43,6 +44,17 @@ export default class MX extends RR {
     return 15
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 43200,
+      class: 'IN',
+      type: 'MX',
+      preference: 0,
+      exchange: 'mail.example.com.',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns(opts) {
     // @fqdn:ip:x:dist:ttl:timestamp:lo

package/rr/naptr.js

@@ -41,7 +41,7 @@ export default class NAPTR extends RR {
 
   setFlags(val) {
     if (!['', 'S', 'A', 'U', 'P'].includes(val.toUpperCase()))
-      throw new Error(`NAPTR flags are invalid, ${this.citeRFC()}`)
+      this.throwHelp(`NAPTR flags are invalid`)
 
     this.set('flags', val.toUpperCase())
   }
@@ -62,7 +62,7 @@ export default class NAPTR extends RR {
   fromTinydns(opts) {
     // NAPTR via generic, :fqdn:n:rdata:ttl:timestamp:lo
     const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
-    if (n != 35) throw new Error('NAPTR fromTinydns, invalid n')
+    if (n != 35) this.throwHelp('NAPTR fromTinydns, invalid n')
 
     const binRdata = Buffer.from(TINYDNS.octalToChar(rdata), 'binary')