@nictool/dns-resource-record 1.2.3 → 1.3.0

package/rr/rp.js

@@ -0,0 +1,78 @@
+import RR from '../rr.js'
+
+import * as TINYDNS from '../lib/tinydns.js'
+
+export default class RP extends RR {
+  constructor(opts) {
+    super(opts)
+  }
+
+  /****** Resource record specific setters   *******/
+  setMbox(val) {
+    if (!val) this.throwHelp('RP: mbox is required')
+
+    this.isFullyQualified('RP', 'mbox', val)
+
+    this.set('mbox', val.toLowerCase())
+  }
+
+  setTxt(val) {
+    if (!val) this.throwHelp('RP: txt is required')
+
+    this.isFullyQualified('RP', 'txt', val)
+
+    this.set('txt', val.toLowerCase())
+  }
+
+  getDescription() {
+    return 'Responsible Person'
+  }
+
+  getRdataFields(arg) {
+    return ['mbox', 'txt']
+  }
+
+  getRFCs() {
+    return [1183]
+  }
+
+  getTypeId() {
+    return 17
+  }
+
+  getCanonical() {
+    return {
+      owner: 'example.com.',
+      ttl: 3600,
+      class: 'IN',
+      type: 'RP',
+      mbox: 'admin.example.com.',
+      txt: 'info.example.com.',
+    }
+  }
+
+  /******  IMPORTERS   *******/
+  fromBind(opts) {
+    // test.example.com  3600  IN  RP  mbox txt
+    const [owner, ttl, c, type, mbox, txt] = opts.bindline.split(/\s+/)
+    return new RP({
+      owner,
+      ttl: parseInt(ttl, 10),
+      class: c,
+      type,
+      mbox,
+      txt,
+    })
+  }
+
+  /******  EXPORTERS   *******/
+  toBind(zone_opts) {
+    return `${this.getPrefix(zone_opts)}\t${this.getFQDN('mbox', zone_opts)}\t${this.getFQDN('txt', zone_opts)}\n`
+  }
+
+  toTinydns() {
+    return this.getTinydnsGeneric(
+      TINYDNS.packDomainName(this.get('mbox')) + TINYDNS.packDomainName(this.get('txt')),
+    )
+  }
+}

package/rr/rrsig.js

@@ -16,13 +16,23 @@ export default class RRSIG extends RR {
 
   setAlgorithm(val) {
     // a 1 octet Algorithm field
-    // 1=RSA/MD5, 2=DH, 3=RRSIGA/SHA-1, 4=EC, 5=RSA/SHA-1
-    if (![1, 2, 3, 4, 5, 253, 254].includes(val))
-      this.throwHelp(`RRSIG: algorithm invalid`)
+    if (!this.getAlgorithmOptions().has(val)) this.throwHelp(`RRSIG: algorithm invalid`)
 
     this.set('algorithm', val)
   }
 
+  getAlgorithmOptions() {
+    return new Map([
+      [1, 'RSA/MD5'],
+      [2, 'DH'],
+      [3, 'RRSIGA/SHA-1'],
+      [4, 'EC'],
+      [5, 'RSA/SHA-1'],
+      [253],
+      [254],
+    ])
+  }
+
   setLabels(val) {
     // a 1 octet Labels field
     this.is8bitInt('RRSIG', 'labels', val)

package/rr/smimea.js

@@ -1,5 +1,7 @@
 import RR from '../rr.js'
 
+import * as TINYDNS from '../lib/tinydns.js'
+
 export default class SMIMEA extends RR {
   constructor(opts) {
     super(opts)
@@ -7,24 +9,47 @@ export default class SMIMEA extends RR {
 
   /****** Resource record specific setters   *******/
   setCertificateUsage(val) {
-    if (![0, 1, 2, 3].includes(val))
-      this.throwHelp(`SMIMEA: certificate usage invalid`)
+    if (!this.getCertificateUsageOptions().has(val)) this.throwHelp(`SMIMEA: certificate usage invalid`)
 
     this.set('certificate usage', val)
   }
 
+  getCertificateUsageOptions() {
+    return new Map([
+      [0, 'CA certificate'],
+      [1, 'an end entity certificate'],
+      [2, 'the trust anchor'],
+      [3, 'domain-issued certificate'],
+    ])
+  }
+
   setSelector(val) {
-    if (![0, 1].includes(val)) this.throwHelp(`SMIMEA: selector invalid`)
+    if (!this.getSelectorOptions().has(val)) this.throwHelp(`SMIMEA: selector invalid`)
 
     this.set('selector', val)
   }
 
+  getSelectorOptions() {
+    return new Map([
+      [0, 'Full certificate'],
+      [1, 'SubjectPublicKeyInfo'],
+    ])
+  }
+
   setMatchingType(val) {
-    if (![0, 1, 2].includes(val)) this.throwHelp(`SMIMEA: matching type`)
+    if (!this.getMatchingTypeOptions().has(val)) this.throwHelp(`SMIMEA: matching type`)
 
     this.set('matching type', val)
   }
 
+  getMatchingTypeOptions() {
+    return new Map([
+      [0, 'Exact match'],
+      [1, 'SHA-256 hash'],
+      [2, 'SHA-512 hash'],
+    ])
+  }
+
   setCertificateAssociationData(val) {
     this.set('certificate association data', val)
   }
@@ -34,12 +59,7 @@ export default class SMIMEA extends RR {
   }
 
   getRdataFields(arg) {
-    return [
-      'certificate usage',
-      'selector',
-      'matching type',
-      'certificate association data',
-    ]
+    return ['certificate usage', 'selector', 'matching type', 'certificate association data']
   }
 
   getRFCs() {
@@ -58,8 +78,7 @@ export default class SMIMEA extends RR {
 
   fromBind(opts) {
     // test.example.com  3600  IN  SMIMEA, usage, selector, match, data
-    const [owner, ttl, c, type, usage, selector, match] =
-      opts.bindline.split(/\s+/)
+    const [owner, ttl, c, type, usage, selector, match] = opts.bindline.split(/\s+/)
     return new SMIMEA({
       owner,
       ttl: parseInt(ttl, 10),
@@ -68,11 +87,19 @@ export default class SMIMEA extends RR {
       'certificate usage': parseInt(usage, 10),
       selector: parseInt(selector, 10),
       'matching type': parseInt(match, 10),
-      'certificate association data': opts.bindline
-        .split(/\s+/)
-        .slice(7)
-        .join(' ')
-        .trim(),
+      'certificate association data': opts.bindline.split(/\s+/).slice(7).join(' ').trim(),
     })
   }
+
+  /******  EXPORTERS   *******/
+  toTinydns() {
+    const dataRe = new RegExp(/[\r\n\t:\\/]/, 'g')
+
+    return this.getTinydnsGeneric(
+      TINYDNS.UInt8toOctal(this.get('certificate usage')) +
+        TINYDNS.UInt8toOctal(this.get('selector')) +
+        TINYDNS.UInt8toOctal(this.get('matching type')) +
+        TINYDNS.escapeOctal(dataRe, this.get('certificate association data')),
+    )
+  }
 }

package/rr/soa.js

@@ -86,19 +86,8 @@ export default class SOA extends RR {
   /******  IMPORTERS   *******/
   fromBind(opts) {
     // example.com TTL IN  SOA mname rname serial refresh retry expire minimum
-    const [
-      owner,
-      ttl,
-      c,
-      type,
-      mname,
-      rname,
-      serial,
-      refresh,
-      retry,
-      expire,
-      minimum,
-    ] = opts.bindline.split(/[\s+]/)
+    const [owner, ttl, c, type, mname, rname, serial, refresh, retry, expire, minimum] =
+      opts.bindline.split(/[\s+]/)
 
     return new SOA({
       owner,
@@ -117,8 +106,7 @@ export default class SOA extends RR {
 
   fromTinydns(opts) {
     // Zfqdn:mname:rname:ser:ref:ret:exp:min:ttl:time:lo
-    const [fqdn, mname, rname, ser, ref, ret, exp, min, ttl, ts, loc] =
-      opts.tinyline.substring(1).split(':')
+    const [fqdn, mname, rname, ser, ref, ret, exp, min, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
 
     return new SOA({
       owner: this.fullyQualify(fqdn),

package/rr/spf.js

@@ -48,10 +48,7 @@ export default class SPF extends TXT {
 
   /******  EXPORTERS   *******/
   toTinydns() {
-    const rdata = TINYDNS.escapeOctal(
-      new RegExp(/[\r\n\t:\\/]/, 'g'),
-      this.get('data'),
-    )
+    const rdata = TINYDNS.escapeOctal(new RegExp(/[\r\n\t:\\/]/, 'g'), this.get('data'))
     return this.getTinydnsGeneric(rdata)
   }
 }

package/rr/srv.js

@@ -28,8 +28,7 @@ export default class SRV extends RR {
   setTarget(val) {
     if (!val) this.throwHelp(`SRV: target is required`)
 
-    if (this.isIPv4(val) || this.isIPv6(val))
-      this.throwHelp(`SRV: target must be a FQDN`)
+    if (this.isIPv4(val) || this.isIPv6(val)) this.throwHelp(`SRV: target must be a FQDN`)
 
     this.isFullyQualified('SRV', 'target', val)
     this.isValidHostname('SRV', 'target', val)
@@ -61,9 +60,7 @@ export default class SRV extends RR {
 
     if (str[0] === 'S') {
       // patched tinydns with S records
-      ;[fqdn, addr, port, pri, weight, ttl, ts, loc] = str
-        .substring(1)
-        .split(':')
+      ;[fqdn, addr, port, pri, weight, ttl, ts, loc] = str.substring(1).split(':')
     } else {
       // tinydns generic record format
       ;[fqdn, n, rdata, ttl, ts, loc] = str.substring(1).split(':')
@@ -90,8 +87,7 @@ export default class SRV extends RR {
 
   fromBind(opts) {
     // test.example.com  3600  IN  SRV Priority Weight Port Target
-    const [owner, ttl, c, type, pri, weight, port, target] =
-      opts.bindline.split(/\s+/)
+    const [owner, ttl, c, type, pri, weight, port, target] = opts.bindline.split(/\s+/)
     return new SRV({
       owner: owner,
       ttl: parseInt(ttl, 10),

package/rr/sshfp.js

@@ -8,19 +8,36 @@ export default class SSHFP extends RR {
 
   /****** Resource record specific setters   *******/
   setAlgorithm(val) {
-    // 0: reserved  1: RSA  2: DSA  3: ECDSA  4: Ed25519  6: Ed448
     this.is8bitInt('SSHFP', 'algorithm', val)
 
     this.set('algorithm', val)
   }
 
+  getAlgorithmOptions() {
+    return new Map([
+      [0, 'reserved'],
+      [1, 'RSA'],
+      [2, 'DSA'],
+      [3, 'ECDSA'],
+      [4, 'Ed25519'],
+      [6, 'Ed448'],
+    ])
+  }
+
   setFptype(val) {
-    // 0: reserved, 1: SHA-1, 2: SHA-256
-    this.is8bitInt('SSHFP', 'type', val)
+    this.is8bitInt('SSHFP', 'fptype', val)
 
     this.set('fptype', val)
   }
 
+  getFptypeOptions() {
+    return new Map([
+      [0, 'reserved'],
+      [1, 'SHA-1'],
+      [2, 'SHA-256'],
+    ])
+  }
+
   setFingerprint(val) {
     this.set('fingerprint', val)
   }

package/rr/svcb.js

@@ -1,5 +1,7 @@
 import RR from '../rr.js'
 
+import * as TINYDNS from '../lib/tinydns.js'
+
 export default class SVCB extends RR {
   constructor(opts) {
     super(opts)
@@ -61,4 +63,14 @@ export default class SVCB extends RR {
   }
 
   /******  EXPORTERS   *******/
+
+  toTinydns() {
+    const dataRe = new RegExp(/[\r\n\t:\\/]/, 'g')
+
+    return this.getTinydnsGeneric(
+      TINYDNS.UInt16toOctal(this.get('priority')) +
+        TINYDNS.packDomainName(this.get('target name')) +
+        TINYDNS.escapeOctal(dataRe, this.get('params')),
+    )
+  }
 }

package/rr/tlsa.js

@@ -9,24 +9,47 @@ export default class TLSA extends RR {
 
   /****** Resource record specific setters   *******/
   setCertificateUsage(val) {
-    if (![0, 1, 2, 3].includes(val))
-      this.throwHelp(`TLSA: certificate usage invalid`)
+    if (!this.getCertificateUsageOptions().has(val)) this.throwHelp(`TLSA: certificate usage invalid`)
 
     this.set('certificate usage', val)
   }
 
+  getCertificateUsageOptions() {
+    return new Map([
+      [0, 'CA certificate'],
+      [1, 'an end entity certificate'],
+      [2, 'the trust anchor'],
+      [3, 'domain-issued certificate'],
+    ])
+  }
+
   setSelector(val) {
-    if (![0, 1].includes(val)) this.throwHelp(`TLSA: selector invalid`)
+    if (!this.getSelectorOptions().has(val)) this.throwHelp(`TLSA: selector invalid`)
 
     this.set('selector', val)
   }
 
+  getSelectorOptions() {
+    return new Map([
+      [0, 'Full certificate'],
+      [1, 'SubjectPublicKeyInfo'],
+    ])
+  }
+
   setMatchingType(val) {
-    if (![0, 1, 2].includes(val)) this.throwHelp(`TLSA: matching type`)
+    if (!this.getMatchingTypeOptions().has(val)) this.throwHelp(`TLSA: matching type`)
 
     this.set('matching type', val)
   }
 
+  getMatchingTypeOptions() {
+    return new Map([
+      [0, 'Exact match'],
+      [1, 'SHA-256 hash'],
+      [2, 'SHA-512 hash'],
+    ])
+  }
+
   setCertificateAssociationData(val) {
     this.set('certificate association data', val)
   }
@@ -36,12 +59,7 @@ export default class TLSA extends RR {
   }
 
   getRdataFields(arg) {
-    return [
-      'certificate usage',
-      'selector',
-      'matching type',
-      'certificate association data',
-    ]
+    return ['certificate usage', 'selector', 'matching type', 'certificate association data']
   }
 
   getRFCs() {
@@ -60,19 +78,17 @@ export default class TLSA extends RR {
 
   fromBind(opts) {
     // test.example.com  3600  IN  TLSA, usage, selector, match, data
-    const match = opts.bindline
-      .trim()
-      .split(
-        /^([^\s]+)\s+([0-9]{1,10})\s+(IN)\s+(TLSA)\s+([0-9]+)\s+([0-9]+)\s+([0-9]+)\s+(.*?)$/,
-      )
+    const regex =
+      /^(?<owner>\S+)\s+(?<ttl>\d{1,10})\s+(?<cls>IN)\s+(?<type>TLSA)\s+(?<usage>\d+)\s+(?<selector>\d+)\s+(?<matchtype>\d+)\s+(?<cad>.+)$/i
+    const match = opts.bindline.trim().match(regex)
     if (!match) this.throwHelp(`unable to parse TLSA: ${opts.bindline}`)
-    const [owner, ttl, c, type, usage, selector, matchtype, cad] =
-      match.slice(1)
+    const { owner, ttl, cls, type, usage, selector, matchtype, cad } = match.groups
+
     return new TLSA({
       owner: this.fullyQualify(owner),
       ttl: parseInt(ttl, 10),
-      class: c,
-      type,
+      class: cls.toUpperCase(),
+      type: type.toUpperCase(),
       'certificate usage': parseInt(usage, 10),
       selector: parseInt(selector, 10),
       'matching type': parseInt(matchtype, 10),

package/rr/tsig.js

@@ -13,15 +13,7 @@ export default class TSIG extends RR {
   }
 
   getRdataFields(arg) {
-    return [
-      'algorithm name',
-      'time signed',
-      'fudge',
-      'mac',
-      'original id',
-      'error',
-      'other',
-    ]
+    return ['algorithm name', 'time signed', 'fudge', 'mac', 'original id', 'error', 'other']
   }
 
   getRFCs() {

package/rr/txt.js

@@ -70,17 +70,18 @@ export default class TXT extends RR {
 
   fromBind(opts) {
     // test.example.com  3600  IN  TXT  "..."
-    const match = opts.bindline
-      .trim()
-      .split(/^([\S]{1,255})\s+([0-9]{1,10})\s+(IN)\s+(\w{3})\s+?\s*(.*?)$/i)
+    const regex =
+      /^(?<owner>[\S]{1,255})\s+(?<ttl>\d{1,10})\s+(?<cls>IN)\s+(?<type>\w{3})\s+?\s*(?<rdata>.+?)$/i
+    const match = opts.bindline.trim().match(regex)
     if (!match) this.throwHelp(`unable to parse TXT: ${opts.bindline}`)
-    const [owner, ttl, c, type, rdata] = match.slice(1)
+
+    const { owner, ttl, cls, type, rdata } = match.groups
 
     return new this.constructor({
       owner,
       ttl: parseInt(ttl, 10),
-      class: c,
-      type,
+      class: cls,
+      type: type.toUpperCase(),
       data: rdata
         .match(/"([^"]+?)"/g)
         .map((s) => s.replace(/^"|"$/g, ''))

package/rr/uri.js

@@ -46,8 +46,7 @@ export default class URI extends RR {
 
   fromBind(opts) {
     // test.example.com  3600  IN  URI  priority, weight, target
-    const [owner, ttl, c, type, priority, weight, target] =
-      opts.bindline.split(/\s+/)
+    const [owner, ttl, c, type, priority, weight, target] = opts.bindline.split(/\s+/)
     return new URI({
       class: c,
       type: type,

package/rr/wks.js

@@ -1,19 +1,36 @@
 import RR from '../rr.js'
 
+import * as TINYDNS from '../lib/tinydns.js'
+
 export default class WKS extends RR {
   constructor(opts) {
     super(opts)
-    if (opts === null) return
   }
 
   /****** Resource record specific setters   *******/
+  setAddress(val) {
+    if (!val) this.throwHelp('WKS: address is required')
+    if (!this.isIPv4(val)) this.throwHelp('WKS address must be IPv4')
+    this.set('address', val)
+  }
+
+  setProtocol(val) {
+    if (!val) this.throwHelp('WKS: protocol is required')
+    const upper = typeof val === 'string' ? val.toUpperCase() : val
+    if (!['TCP', 'UDP', 6, 17].includes(upper)) this.throwHelp('WKS protocol must be TCP or UDP')
+    this.set('protocol', upper)
+  }
+
+  setBitMap(val) {
+    this.set('bit map', val ?? '')
+  }
 
   getDescription() {
     return 'Well Known Service'
   }
 
   getRdataFields(arg) {
-    return ['bit map']
+    return ['address', 'protocol', 'bit map']
   }
 
   getRFCs() {
@@ -27,19 +44,31 @@ export default class WKS extends RR {
   /******  IMPORTERS   *******/
 
   fromBind(opts) {
-    // test.example.com  3600  IN  WKS 192.168.1.1 TCP 25
-    const [owner, ttl, c, type, address, protocol, bitmap] =
-      opts.bindline.split(/\s+/)
+    // test.example.com  3600  IN  WKS 192.168.1.1 TCP ftp smtp
+    const parts = opts.bindline.split(/\s+/)
+    const [owner, ttl, c, type, address, protocol] = parts
     return new WKS({
       owner,
       ttl: parseInt(ttl, 10),
       class: c,
       type,
-      address, // 32-bit int
-      protocol, // 8-bit int, 6=TCP, 17=UDP
-      bitmap, // var len bit map, must be multiple of 8
+      address,
+      protocol,
+      'bit map': parts.slice(6).join(' ').trim(),
     })
   }
 
   /******  EXPORTERS   *******/
+
+  toTinydns() {
+    const dataRe = new RegExp(/[\r\n\t:\\/]/, 'g')
+    const protoMap = { TCP: 6, UDP: 17, 6: 6, 17: 17 }
+    const protoNum = protoMap[this.get('protocol')]
+
+    return this.getTinydnsGeneric(
+      TINYDNS.ipv4toOctal(this.get('address')) +
+        TINYDNS.UInt8toOctal(protoNum) +
+        TINYDNS.escapeOctal(dataRe, this.get('bit map')),
+    )
+  }
 }