@nictool/dns-resource-record 1.1.7 → 1.2.1

package/rr/rrsig.js

@@ -1,85 +1,91 @@
-
 import RR from '../rr.js'
 
 export default class RRSIG extends RR {
-  constructor (opts) {
+  constructor(opts) {
     super(opts)
   }
 
   /****** Resource record specific setters   *******/
-  setTypeCovered (val) {
+  setTypeCovered(val) {
     // a 2 octet Type Covered field
-    if (!val) throw new Error(`RRSIG: 'type covered' is required`)
-    if (val.length > 2) throw new Error(`RRSIG: 'type covered' is too long, ${this.citeRFC()}`)
+    if (!val) this.throwHelp(`RRSIG: 'type covered' is required`)
+    if (val.length > 2) this.throwHelp(`RRSIG: 'type covered' is too long`)
 
     this.set('type covered', val)
   }
 
-  setAlgorithm (val) {
+  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))
-      throw new Error(`RRSIG: algorithm invalid, ${this.citeRFC()}`)
+    if (![1, 2, 3, 4, 5, 253, 254].includes(val))
+      this.throwHelp(`RRSIG: algorithm invalid`)
 
     this.set('algorithm', val)
   }
 
-  setLabels (val) {
+  setLabels(val) {
     // a 1 octet Labels field
     this.is8bitInt('RRSIG', 'labels', val)
 
     this.set('labels', val)
   }
 
-  setOriginalTtl (val) {
+  setOriginalTtl(val) {
     // a 4 octet Original TTL field
     this.is32bitInt('RRSIG', 'original ttl', val)
 
     this.set('original ttl', val)
   }
 
-  setSignatureExpiration (val) {
+  setSignatureExpiration(val) {
     // a 4 octet Signature Expiration field
     this.set('signature expiration', val)
   }
 
-  setSignatureInception (val) {
+  setSignatureInception(val) {
     // a 4 octet Signature Inception field
     this.set('signature inception', val)
   }
 
-  setKeyTag (val) {
+  setKeyTag(val) {
     // a 2 octet Key tag
     this.set('key tag', val)
   }
 
-  setSignersName (val) {
+  setSignersName(val) {
     // the Signer's Name field
     this.set('signers name', val)
   }
 
-  setSignature (val) {
+  setSignature(val) {
     // the Signature field.
 
     this.set('signature', val)
   }
 
-  getDescription () {
+  getDescription() {
     return 'Resource Record Signature'
   }
 
-  getRdataFields (arg) {
+  getRdataFields(arg) {
     return [
-      'type covered', 'algorithm', 'labels', 'original ttl', 'signature expiration',
-      'signature inception', 'key tag', 'signers name', 'signature',
+      'type covered',
+      'algorithm',
+      'labels',
+      'original ttl',
+      'signature expiration',
+      'signature inception',
+      'key tag',
+      'signers name',
+      'signature',
     ]
   }
 
-  getRFCs () {
-    return [ 4034 ]
+  getRFCs() {
+    return [4034]
   }
 
-  getTypeId () {
+  getTypeId() {
     return 46
   }
 
@@ -97,5 +103,4 @@ export default class RRSIG extends RR {
   // }
 
   /******  EXPORTERS   *******/
-
 }

package/rr/sig.js

@@ -1,20 +1,19 @@
-
 import RR from '../rr.js'
 
 export default class SIG extends RR {
-  constructor (opts) {
+  constructor(opts) {
     super(opts)
   }
 
   /****** Resource record specific setters   *******/
-  setTypeCovered (val) {
+  setTypeCovered(val) {
     // a 2 octet Type Covered field
-    if (!val) throw new Error(`SIG: 'type covered' is required`)
+    if (!val) this.throwHelp(`SIG: 'type covered' is required`)
 
     this.set('type covered', val)
   }
 
-  setAlgorithm (val) {
+  setAlgorithm(val) {
     // a 1 octet Algorithm field
 
     this.is8bitInt('SIG', 'labels', val)
@@ -22,64 +21,71 @@ export default class SIG extends RR {
     this.set('algorithm', val)
   }
 
-  setLabels (val) {
+  setLabels(val) {
     // a 1 octet Labels field
     this.is8bitInt('SIG', 'labels', val)
 
     this.set('labels', val)
   }
 
-  setOriginalTtl (val) {
+  setOriginalTtl(val) {
     // a 4 octet Original TTL field
     this.is32bitInt('SIG', 'original ttl', val)
 
     this.set('original ttl', val)
   }
 
-  setSignatureExpiration (val) {
+  setSignatureExpiration(val) {
     // a 4 octet Signature Expiration field
     this.set('signature expiration', val)
   }
 
-  setSignatureInception (val) {
+  setSignatureInception(val) {
     // a 4 octet Signature Inception field
     this.set('signature inception', val)
   }
 
-  setKeyTag (val) {
+  setKeyTag(val) {
     // a 2 octet Key tag
     this.set('key tag', val)
   }
 
-  setSignersName (val) {
+  setSignersName(val) {
     // the domain name of the signer generating the SIG RR
 
     // RFC 4034: letters in the DNS names are lower cased
     this.set('signers name', val.toLowerCase())
   }
 
-  setSignature (val) {
+  setSignature(val) {
     // the Signature field.
 
     this.set('signature', val)
   }
 
-  getDescription () {
+  getDescription() {
     return 'Signature'
   }
 
-  getRdataFields (arg) {
+  getRdataFields(arg) {
     return [
-      'type covered', 'algorithm', 'labels', 'original ttl', 'signature expiration',
-      'signature inception', 'key tag', 'signers name', 'signature',
+      'type covered',
+      'algorithm',
+      'labels',
+      'original ttl',
+      'signature expiration',
+      'signature inception',
+      'key tag',
+      'signers name',
+      'signature',
     ]
   }
 
-  getRFCs () {
-    return [ 2535 ]
+  getRFCs() {
+    return [2535]
   }
 
-  getTypeId () {
+  getTypeId() {
     return 24
   }
 
@@ -96,5 +102,4 @@ export default class SIG extends RR {
   // }
 
   /******  EXPORTERS   *******/
-
 }

package/rr/smimea.js

@@ -1,73 +1,78 @@
-
 import RR from '../rr.js'
 
 export default class SMIMEA extends RR {
-  constructor (opts) {
+  constructor(opts) {
     super(opts)
   }
 
   /****** Resource record specific setters   *******/
-  setCertificateUsage (val) {
-    if (![ 0,1,2,3 ].includes(val))
-      throw new Error(`SMIMEA: certificate usage invalid, ${this.citeRFC()}`)
+  setCertificateUsage(val) {
+    if (![0, 1, 2, 3].includes(val))
+      this.throwHelp(`SMIMEA: certificate usage invalid`)
 
     this.set('certificate usage', val)
   }
 
-  setSelector (val) {
-    if (![ 0,1 ].includes(val))
-      throw new Error(`SMIMEA: selector invalid, ${this.citeRFC()}`)
+  setSelector(val) {
+    if (![0, 1].includes(val)) this.throwHelp(`SMIMEA: selector invalid`)
 
     this.set('selector', val)
   }
 
-  setMatchingType (val) {
-    if (![ 0,1,2 ].includes(val))
-      throw new Error(`SMIMEA: matching type, ${this.citeRFC()}`)
+  setMatchingType(val) {
+    if (![0, 1, 2].includes(val)) this.throwHelp(`SMIMEA: matching type`)
 
     this.set('matching type', val)
   }
 
-  setCertificateAssociationData (val) {
+  setCertificateAssociationData(val) {
     this.set('certificate association data', val)
   }
 
-
-  getDescription () {
+  getDescription() {
     return 'S/MIME cert association'
   }
 
-  getRdataFields (arg) {
-    return [ 'certificate usage', 'selector', 'matching type', 'certificate association data' ]
+  getRdataFields(arg) {
+    return [
+      'certificate usage',
+      'selector',
+      'matching type',
+      'certificate association data',
+    ]
   }
 
-  getRFCs () {
-    return [ 8162 ]
+  getRFCs() {
+    return [8162]
   }
 
-  getTypeId () {
+  getTypeId() {
     return 53
   }
 
-  getQuotedFields () {
-    return [  ]
+  getQuotedFields() {
+    return []
   }
 
   /******  IMPORTERS   *******/
 
-  fromBind (opts) {
+  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),
-      class                         : c,
-      type                          : type,
-      '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(),
+      ttl: parseInt(ttl, 10),
+      class: c,
+      type: type,
+      '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(),
     })
   }
-
 }

package/rr/soa.js

@@ -1,13 +1,12 @@
-
 import RR from '../rr.js'
 
 export default class SOA extends RR {
-  constructor (opts) {
+  constructor(opts) {
     super(opts)
   }
 
   /****** Resource record specific setters   *******/
-  setMinimum (val) {
+  setMinimum(val) {
     // minimum (used for negative caching, since RFC 2308)
     // RFC 1912 sugggests 1-5 days
     // RIPE recommends 3600 (1 hour)
@@ -16,7 +15,7 @@ export default class SOA extends RR {
     this.set('minimum', val)
   }
 
-  setMname (val) {
+  setMname(val) {
     // MNAME (primary NS)
     this.isValidHostname('SOA', 'MNAME', val)
     this.isFullyQualified('SOA', 'MNAME', val)
@@ -25,23 +24,23 @@ export default class SOA extends RR {
     this.set('mname', val.toLowerCase())
   }
 
-  setRname (val) {
+  setRname(val) {
     // RNAME (email of admin)  (escape . with \)
     this.isValidHostname('SOA', 'RNAME', val)
     this.isFullyQualified('SOA', 'RNAME', val)
-    if (/@/.test(val)) throw new Error(`SOA rname replaces @ with a . (dot), ${this.citeRFC()}`)
+    if (/@/.test(val)) this.throwHelp(`SOA rname replaces @ with a . (dot)`)
 
     // RFC 4034: letters in the DNS names are lower cased
     this.set('rname', val.toLowerCase())
   }
 
-  setSerial (val) {
+  setSerial(val) {
     this.is32bitInt('SOA', 'serial', val)
 
     this.set('serial', val)
   }
 
-  setRefresh (val) {
+  setRefresh(val) {
     // refresh (seconds after which to check with master for update)
     // RFC 1912 suggests 20 min to 12 hours
     // RIPE recommends 86400 (24 hours)
@@ -50,7 +49,7 @@ export default class SOA extends RR {
     this.set('refresh', val)
   }
 
-  setRetry (val) {
+  setRetry(val) {
     // seconds after which to retry serial # update
     // RIPE recommends 7200 seconds (2 hours)
 
@@ -59,7 +58,7 @@ export default class SOA extends RR {
     this.set('retry', val)
   }
 
-  setExpire (val) {
+  setExpire(val) {
     // seconds after which secondary should drop zone if no master response
     // RFC 1912 suggests 2-4 weeks
     // RIPE suggests 3600000 (1,000 hours, 6 weeks)
@@ -68,73 +67,88 @@ export default class SOA extends RR {
     this.set('expire', val)
   }
 
-  getDescription () {
+  getDescription() {
     return 'Start Of Authority'
   }
 
-  getRdataFields (arg) {
-    return [ 'mname', 'rname', 'serial', 'refresh', 'retry', 'expire', 'minimum' ]
+  getRdataFields(arg) {
+    return ['mname', 'rname', 'serial', 'refresh', 'retry', 'expire', 'minimum']
   }
 
-  getRFCs () {
-    return [ 1035, 2308 ]
+  getRFCs() {
+    return [1035, 2308]
   }
 
-  getTypeId () {
+  getTypeId() {
     return 6
   }
 
   /******  IMPORTERS   *******/
-  fromBind (opts) {
+  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,
-      ttl    : parseInt(ttl) || parseInt(minimum),
-      class  : c,
+      ttl: parseInt(ttl) || parseInt(minimum),
+      class: c,
       type,
       mname,
       rname,
-      serial : parseInt(serial , 10),
+      serial: parseInt(serial, 10),
       refresh: parseInt(refresh, 10),
-      retry  : parseInt(retry  , 10),
-      expire : parseInt(expire , 10),
+      retry: parseInt(retry, 10),
+      expire: parseInt(expire, 10),
       minimum: parseInt(minimum, 10),
     })
   }
 
-  fromTinydns (opts) {
+  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),
-      ttl      : parseInt(ttl, 10),
-      type     : 'SOA',
-      mname    : this.fullyQualify(mname),
-      rname    : this.fullyQualify(rname),
-      serial   : parseInt(ser || opts.default?.serial, 10),
-      refresh  : parseInt(ref, 10) || 16384,
-      retry    : parseInt(ret, 10) || 2048,
-      expire   : parseInt(exp, 10) || 1048576,
-      minimum  : parseInt(min, 10) || 2560,
+      owner: this.fullyQualify(fqdn),
+      ttl: parseInt(ttl, 10),
+      type: 'SOA',
+      mname: this.fullyQualify(mname),
+      rname: this.fullyQualify(rname),
+      serial: parseInt(ser || opts.default?.serial, 10),
+      refresh: parseInt(ref, 10) || 16384,
+      retry: parseInt(ret, 10) || 2048,
+      expire: parseInt(exp, 10) || 1048576,
+      minimum: parseInt(min, 10) || 2560,
       timestamp: parseInt(ts) || '',
-      location : loc !== '' && loc !== '\n' ? loc : '',
+      location: loc !== '' && loc !== '\n' ? loc : '',
     })
   }
 
   /******  EXPORTERS   *******/
-  toBind (zone_opts) {
-    const numFields = [ 'serial', 'refresh', 'retry', 'expire', 'minimum' ]
-    return `${this.getFQDN('owner', zone_opts)}\t${this.get('ttl')}\t${this.get('class')}\tSOA\t${this.getFQDN('mname', zone_opts)}\t${this.getFQDN('rname', zone_opts)}${numFields.map(f => '\t' + this.get(f) ).join('')}\n`
+  toBind(zone_opts) {
+    const numFields = ['serial', 'refresh', 'retry', 'expire', 'minimum']
+    return `${this.getFQDN('owner', zone_opts)}\t${this.get('ttl')}\t${this.get('class')}\tSOA\t${this.getFQDN('mname', zone_opts)}\t${this.getFQDN('rname', zone_opts)}${numFields.map((f) => '\t' + this.get(f)).join('')}\n`
   }
 
-  toMaraDNS () {
-    return `${this.get('owner')}\t SOA\t${this.getRdataFields().map(f => this.getQuoted(f)).join('\t')} ~\n`
+  toMaraDNS() {
+    return `${this.get('owner')}\t SOA\t${this.getRdataFields()
+      .map((f) => this.getQuoted(f))
+      .join('\t')} ~\n`
   }
 
-  toTinydns () {
+  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

@@ -5,50 +5,53 @@ import TXT from './txt.js'
 import * as TINYDNS from '../lib/tinydns.js'
 
 export default class SPF extends TXT {
-  constructor (opts) {
+  constructor(opts) {
     super(opts)
   }
 
   /****** Resource record specific setters   *******/
-  setData (val) {
+  setData(val) {
     this.set('data', val)
   }
 
-  getDescription () {
+  getDescription() {
     return 'Sender Policy Framework'
   }
 
-  getRdataFields (arg) {
-    return [ 'data' ]
+  getRdataFields(arg) {
+    return ['data']
   }
 
-  getRFCs () {
-    return [ 4408, 7208 ]
+  getRFCs() {
+    return [4408, 7208]
   }
 
-  getTypeId () {
+  getTypeId() {
     return 99
   }
 
   /******  IMPORTERS   *******/
-  fromTinydns (opts) {
+  fromTinydns(opts) {
     // SPF via generic, :fqdn:n:rdata:ttl:timestamp:lo
-    const [ fqdn, n, rdata, ttl, ts, loc ] = opts.tinyline.substring(1).split(':')
-    if (n != 99) throw new Error('SPF fromTinydns, invalid n')
+    const [fqdn, n, rdata, ttl, ts, loc] = opts.tinyline.substring(1).split(':')
+    if (n != 99) this.throwHelp('SPF fromTinydns, invalid n')
 
     return new SPF({
-      type     : 'SPF',
-      owner    : this.fullyQualify(fqdn),
-      data     : TINYDNS.octalToChar(rdata),
-      ttl      : parseInt(ttl, 10),
+      type: 'SPF',
+      owner: this.fullyQualify(fqdn),
+      data: TINYDNS.octalToChar(rdata),
+      ttl: parseInt(ttl, 10),
       timestamp: ts,
-      location : loc !== '' && loc !== '\n' ? loc : '',
+      location: loc !== '' && loc !== '\n' ? loc : '',
     })
   }
 
   /******  EXPORTERS   *******/
-  toTinydns () {
-    const rdata = TINYDNS.escapeOctal(new RegExp(/[\r\n\t:\\/]/, 'g'), this.get('data'))
+  toTinydns() {
+    const rdata = TINYDNS.escapeOctal(
+      new RegExp(/[\r\n\t:\\/]/, 'g'),
+      this.get('data'),
+    )
     return this.getTinydnsGeneric(rdata)
   }
 }