@nictool/dns-resource-record 1.5.0 → 1.6.0

package/rr/nsec.js

@@ -29,6 +29,10 @@ export default class NSEC extends RR {
     return 'Next Secure'
   }
 
+  getTags() {
+    return ['dnssec']
+  }
+
   getRdataFields(arg) {
     return ['next domain', 'type bit maps']
   }
@@ -41,6 +45,17 @@ export default class NSEC extends RR {
     return 47
   }
 
+  getCanonical() {
+    return {
+      owner: 'alfa.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'NSEC',
+      'next domain': 'host.example.com.',
+      'type bit maps': 'A MX RRSIG NSEC TYPE1234',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromTinydns({ tinyline }) {

package/rr/nsec3.js

@@ -64,6 +64,10 @@ export default class NSEC3 extends RR {
     return 'Next Secure'
   }
 
+  getTags() {
+    return ['dnssec']
+  }
+
   getRdataFields(arg) {
     return ['hash algorithm', 'flags', 'iterations', 'salt', 'next hashed owner name', 'type bit maps']
   }
@@ -76,6 +80,21 @@ export default class NSEC3 extends RR {
     return 50
   }
 
+  getCanonical() {
+    return {
+      owner: 'test.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'NSEC3',
+      'hash algorithm': 1,
+      flags: 1,
+      iterations: 12,
+      salt: 'aabbccdd',
+      'next hashed owner name': '2vptu5timamqttgl4luu9kg21e0aor3s',
+      'type bit maps': 'A RRSIG',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {

package/rr/nsec3param.js

@@ -57,6 +57,10 @@ export default class NSEC3PARAM extends RR {
     return 'Next Secure Parameters'
   }
 
+  getTags() {
+    return ['dnssec']
+  }
+
   getRdataFields(arg) {
     return ['hash algorithm', 'flags', 'iterations', 'salt']
   }
@@ -69,6 +73,19 @@ export default class NSEC3PARAM extends RR {
     return 51
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'NSEC3PARAM',
+      'hash algorithm': 1,
+      flags: 1,
+      iterations: 12,
+      salt: 'aabbccdd',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {

package/rr/nxt.js

@@ -29,6 +29,10 @@ export default class NXT extends RR {
     return 'Next Secure'
   }
 
+  getTags() {
+    return ['deprecated']
+  }
+
   getRdataFields(arg) {
     return ['next domain', 'type bit map']
   }
@@ -41,6 +45,17 @@ export default class NXT extends RR {
     return 30
   }
 
+  getCanonical() {
+    return {
+      owner: 'big.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'NXT',
+      'next domain': 'host.example.com.',
+      'type bit map': 'A MX NXT',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromTinydns({ tinyline }) {

package/rr/openpgpkey.js

@@ -15,6 +15,10 @@ export default class OPENPGPKEY extends RR {
     return 'OpenPGP Public Key'
   }
 
+  getTags() {
+    return ['security']
+  }
+
   getRdataFields() {
     return ['public key']
   }
@@ -27,6 +31,16 @@ export default class OPENPGPKEY extends RR {
     return 61
   }
 
+  getCanonical() {
+    return {
+      owner: 'matt.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'OPENPGPKEY',
+      'public key': 'mQINBFY...',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromBind({ bindline: bindline }) {
     // test.example.com  3600  IN  OPENPGPKEY  <base64 public key>

package/rr/ptr.js

@@ -18,6 +18,10 @@ export default class PTR extends RR {
     return 'Pointer'
   }
 
+  getTags() {
+    return ['common']
+  }
+
   getRdataFields(arg) {
     return ['dname']
   }
@@ -30,6 +34,16 @@ export default class PTR extends RR {
     return 12
   }
 
+  getCanonical() {
+    return {
+      owner: '2.2.0.192.in-addr.arpa.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'PTR',
+      dname: 'host.example.com.',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns({ tinyline }) {
     // ^fqdn:p:ttl:timestamp:lo
@@ -58,6 +72,10 @@ export default class PTR extends RR {
   }
 
   /******  EXPORTERS   *******/
+  getWireRdata() {
+    return this.wirePackDomain(this.get('dname'))
+  }
+
   toTinydns() {
     return `^${this.getTinyFQDN('owner')}:${this.getTinyFQDN('dname')}:${this.getTinydnsPostamble()}\n`
   }

package/rr/rp.js

@@ -28,6 +28,10 @@ export default class RP extends RR {
     return 'Responsible Person'
   }
 
+  getTags() {
+    return ['obsolete']
+  }
+
   getRdataFields(arg) {
     return ['mbox', 'txt']
   }

package/rr/rrsig.js

@@ -78,6 +78,10 @@ export default class RRSIG extends RR {
     return 'Resource Record Signature'
   }
 
+  getTags() {
+    return ['dnssec']
+  }
+
   getRdataFields(arg) {
     return [
       'type covered',
@@ -100,6 +104,24 @@ export default class RRSIG extends RR {
     return 46
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'RRSIG',
+      'type covered': 1,
+      algorithm: 5,
+      labels: 3,
+      'original ttl': 3600,
+      'signature expiration': 1045053120,
+      'signature inception': 1042461120,
+      'key tag': 12345,
+      'signers name': 'example.com.',
+      signature: 'ABCDEF...',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {

package/rr/sig.js

@@ -68,6 +68,10 @@ export default class SIG extends RR {
     return 'Signature'
   }
 
+  getTags() {
+    return ['obsolete']
+  }
+
   getRdataFields(arg) {
     return [
       'type covered',
@@ -83,13 +87,31 @@ export default class SIG extends RR {
   }
 
   getRFCs() {
-    return [2535]
+    return [2535, 3755]
   }
 
   getTypeId() {
     return 24
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SIG',
+      'type covered': 1,
+      algorithm: 5,
+      labels: 3,
+      'original ttl': 3600,
+      'signature expiration': 1045053120,
+      'signature inception': 1042461120,
+      'key tag': 12345,
+      'signers name': 'example.com.',
+      signature: 'ABCDEF...',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {

package/rr/smimea.js

@@ -58,6 +58,10 @@ export default class SMIMEA extends RR {
     return 'S/MIME cert association'
   }
 
+  getTags() {
+    return ['security']
+  }
+
   getRdataFields(arg) {
     return ['certificate usage', 'selector', 'matching type', 'certificate association data']
   }
@@ -70,6 +74,19 @@ export default class SMIMEA extends RR {
     return 53
   }
 
+  getCanonical() {
+    return {
+      owner: '_443._tcp.www.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SMIMEA',
+      'certificate usage': 0,
+      selector: 0,
+      'matching type': 1,
+      'certificate association data': 'ABCDEF...',
+    }
+  }
+
   getQuotedFields() {
     return []
   }

package/rr/soa.js

@@ -83,6 +83,22 @@ export default class SOA extends RR {
     return 6
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SOA',
+      mname: 'ns1.example.com.',
+      rname: 'admin.example.com.',
+      serial: 2023051001,
+      refresh: 7200,
+      retry: 3600,
+      expire: 1209600,
+      minimum: 3600,
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromBind({ bindline }) {
     // example.com TTL IN  SOA mname rname serial refresh retry expire minimum
@@ -136,6 +152,20 @@ export default class SOA extends RR {
       .join('\t')} ~\n`
   }
 
+  getWireRdata() {
+    const nums = Buffer.alloc(20)
+    nums.writeUInt32BE(this.get('serial'), 0)
+    nums.writeUInt32BE(this.get('refresh'), 4)
+    nums.writeUInt32BE(this.get('retry'), 8)
+    nums.writeUInt32BE(this.get('expire'), 12)
+    nums.writeUInt32BE(this.get('minimum'), 16)
+    return Buffer.concat([
+      this.wirePackDomain(this.get('mname')),
+      this.wirePackDomain(this.get('rname')),
+      nums,
+    ])
+  }
+
   toTinydns() {
     return `Z${this.getTinyFQDN('owner')}:${this.getTinyFQDN('mname')}:${this.getTinyFQDN('rname')}:${this.getEmpty('serial')}:${this.getEmpty('refresh')}:${this.getEmpty('retry')}:${this.getEmpty('expire')}:${this.getEmpty('minimum')}:${this.getTinydnsPostamble()}\n`
   }

package/rr/spf.js

@@ -18,6 +18,10 @@ export default class SPF extends TXT {
     return 'Sender Policy Framework'
   }
 
+  getTags() {
+    return ['deprecated']
+  }
+
   getRdataFields(arg) {
     return ['data']
   }
@@ -30,6 +34,16 @@ export default class SPF extends TXT {
     return 99
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SPF',
+      data: 'v=spf1 mx -all',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns({ tinyline }) {
     // SPF via generic, :fqdn:n:rdata:ttl:timestamp:lo

package/rr/srv.js

@@ -41,6 +41,10 @@ export default class SRV extends RR {
     return 'Service'
   }
 
+  getTags() {
+    return ['common']
+  }
+
   getRdataFields(arg) {
     return ['priority', 'weight', 'port', 'target']
   }
@@ -53,6 +57,19 @@ export default class SRV extends RR {
     return 33
   }
 
+  getCanonical() {
+    return {
+      owner: '_imaps._tcp.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SRV',
+      priority: 10,
+      weight: 10,
+      port: 993,
+      target: 'mail.example.com.',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns({ tinyline }) {
     const str = tinyline

package/rr/sshfp.js

@@ -46,6 +46,10 @@ export default class SSHFP extends RR {
     return 'Secure Shell Key Fingerprints'
   }
 
+  getTags() {
+    return ['security']
+  }
+
   getRdataFields() {
     return ['algorithm', 'fptype', 'fingerprint']
   }
@@ -58,6 +62,18 @@ export default class SSHFP extends RR {
     return 44
   }
 
+  getCanonical() {
+    return {
+      owner: 'mail.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SSHFP',
+      algorithm: 2,
+      fptype: 1,
+      fingerprint: '123456789abcdef6789abcdf6789abdf6789abcd',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns({ tinyline }) {
     // SSHFP via generic, :fqdn:n:rdata:ttl:timestamp:lo

package/rr/svcb.js

@@ -44,6 +44,18 @@ export default class SVCB extends RR {
     return 64
   }
 
+  getCanonical() {
+    return {
+      owner: '_8443._foo.api.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'SVCB',
+      priority: 1,
+      'target name': 'svc4.example.net.',
+      params: 'alpn="h2,h3"',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {

package/rr/tlsa.js

@@ -58,18 +58,35 @@ export default class TLSA extends RR {
     return 'TLSA certificate association'
   }
 
+  getTags() {
+    return ['security']
+  }
+
   getRdataFields(arg) {
     return ['certificate usage', 'selector', 'matching type', 'certificate association data']
   }
 
   getRFCs() {
-    return [6698]
+    return [6698, 7671]
   }
 
   getTypeId() {
     return 52
   }
 
+  getCanonical() {
+    return {
+      owner: '_443._tcp.www.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'TLSA',
+      'certificate usage': 3,
+      selector: 1,
+      'matching type': 1,
+      'certificate association data': 'ABCDEF...',
+    }
+  }
+
   getQuotedFields() {
     return []
   }

package/rr/tsig.js

@@ -25,6 +25,22 @@ export default class TSIG extends RR {
     return 250
   }
 
+  getCanonical() {
+    return {
+      owner: 'test.example.',
+      ttl: 0,
+      class: 'ANY',
+      type: 'TSIG',
+      'algorithm name': 'hmac-sha256.',
+      'time signed': 1620650000,
+      fudge: 300,
+      mac: 'ABCDEF...',
+      'original id': 12345,
+      error: 0,
+      other: '',
+    }
+  }
+
   setClass(t) {
     if (t !== 'ANY') this.throwHelp('TSIG: Class is required to be ANY')
     this.set('class', t)

package/rr/txt.js

@@ -16,18 +16,32 @@ export default class TXT extends RR {
     return 'Text'
   }
 
+  getTags() {
+    return ['common']
+  }
+
   getRdataFields(arg) {
     return ['data']
   }
 
   getRFCs() {
-    return [1035]
+    return [1035, 4408, 7208, 6376]
   }
 
   getTypeId() {
     return 16
   }
 
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'TXT',
+      data: 'v=spf1 mx -all',
+    }
+  }
+
   /******  IMPORTERS   *******/
   fromTinydns({ tinyline }) {
     const str = tinyline
@@ -98,6 +112,12 @@ export default class TXT extends RR {
     return `${this.get('owner')}\t+${this.get('ttl')}\t${this.get('type')}\t'${data}' ~\n`
   }
 
+  getWireRdata() {
+    let data = this.get('data')
+    if (Array.isArray(data)) data = data.join('')
+    return packStringWire(data)
+  }
+
   toTinydns() {
     let data = this.get('data')
     if (Array.isArray(data)) data = data.join('')
@@ -127,3 +147,18 @@ function asQuotedStrings(data) {
 
   return data
 }
+
+function packStringWire(str) {
+  const parts = str.match(/(.{1,255})/g)
+  let len = 0
+  for (const part of parts) len += part.length + 1
+
+  const buf = Buffer.allocUnsafe(len)
+  let offset = 0
+  for (const part of parts) {
+    buf.writeUInt8(part.length, offset++)
+    buf.write(part, offset, 'ascii')
+    offset += part.length
+  }
+  return buf
+}

package/rr/uri.js

@@ -75,6 +75,18 @@ export default class URI extends RR {
     return 256
   }
 
+  getCanonical() {
+    return {
+      owner: 'www.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'URI',
+      priority: 10,
+      weight: 10,
+      target: 'http://www.example.com/',
+    }
+  }
+
   getQuotedFields() {
     return ['target']
   }

package/rr/wks.js

@@ -29,6 +29,10 @@ export default class WKS extends RR {
     return 'Well Known Service'
   }
 
+  getTags() {
+    return ['obsolete']
+  }
+
   getRdataFields(arg) {
     return ['address', 'protocol', 'bit map']
   }
@@ -41,6 +45,18 @@ export default class WKS extends RR {
     return 11
   }
 
+  getCanonical() {
+    return {
+      owner: 'host.example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'WKS',
+      address: '192.0.2.1',
+      protocol: 'TCP',
+      'bit map': 'ftp smtp',
+    }
+  }
+
   /******  IMPORTERS   *******/
 
   fromBind({ bindline }) {