You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
			
				
					199 lines
				
				5.5 KiB
			
		
		
			
		
	
	
					199 lines
				
				5.5 KiB
			| 
								 
											4 years ago
										 
									 | 
							
								'use strict'
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								var util = require('util')
							 | 
						||
| 
								 | 
							
								var EventEmitter = require('events').EventEmitter
							 | 
						||
| 
								 | 
							
								var serviceName = require('multicast-dns-service-types')
							 | 
						||
| 
								 | 
							
								var dnsEqual = require('dns-equal')
							 | 
						||
| 
								 | 
							
								var dnsTxt = require('dns-txt')
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								var TLD = '.local'
							 | 
						||
| 
								 | 
							
								var WILDCARD = '_services._dns-sd._udp' + TLD
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								module.exports = Browser
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								util.inherits(Browser, EventEmitter)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/**
							 | 
						||
| 
								 | 
							
								 * Start a browser
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * The browser listens for services by querying for PTR records of a given
							 | 
						||
| 
								 | 
							
								 * type, protocol and domain, e.g. _http._tcp.local.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * If no type is given, a wild card search is performed.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * An internal list of online services is kept which starts out empty. When
							 | 
						||
| 
								 | 
							
								 * ever a new service is discovered, it's added to the list and an "up" event
							 | 
						||
| 
								 | 
							
								 * is emitted with that service. When it's discovered that the service is no
							 | 
						||
| 
								 | 
							
								 * longer available, it is removed from the list and a "down" event is emitted
							 | 
						||
| 
								 | 
							
								 * with that service.
							 | 
						||
| 
								 | 
							
								 */
							 | 
						||
| 
								 | 
							
								function Browser (mdns, opts, onup) {
							 | 
						||
| 
								 | 
							
								  if (typeof opts === 'function') return new Browser(mdns, null, opts)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  EventEmitter.call(this)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this._mdns = mdns
							 | 
						||
| 
								 | 
							
								  this._onresponse = null
							 | 
						||
| 
								 | 
							
								  this._serviceMap = {}
							 | 
						||
| 
								 | 
							
								  this._txt = dnsTxt(opts.txt)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  if (!opts || !opts.type) {
							 | 
						||
| 
								 | 
							
								    this._name = WILDCARD
							 | 
						||
| 
								 | 
							
								    this._wildcard = true
							 | 
						||
| 
								 | 
							
								  } else {
							 | 
						||
| 
								 | 
							
								    this._name = serviceName.stringify(opts.type, opts.protocol || 'tcp') + TLD
							 | 
						||
| 
								 | 
							
								    if (opts.name) this._name = opts.name + '.' + this._name
							 | 
						||
| 
								 | 
							
								    this._wildcard = false
							 | 
						||
| 
								 | 
							
								  }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this.services = []
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  if (onup) this.on('up', onup)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this.start()
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Browser.prototype.start = function () {
							 | 
						||
| 
								 | 
							
								  if (this._onresponse) return
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  var self = this
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // List of names for the browser to listen for. In a normal search this will
							 | 
						||
| 
								 | 
							
								  // be the primary name stored on the browser. In case of a wildcard search
							 | 
						||
| 
								 | 
							
								  // the names will be determined at runtime as responses come in.
							 | 
						||
| 
								 | 
							
								  var nameMap = {}
							 | 
						||
| 
								 | 
							
								  if (!this._wildcard) nameMap[this._name] = true
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this._onresponse = function (packet, rinfo) {
							 | 
						||
| 
								 | 
							
								    if (self._wildcard) {
							 | 
						||
| 
								 | 
							
								      packet.answers.forEach(function (answer) {
							 | 
						||
| 
								 | 
							
								        if (answer.type !== 'PTR' || answer.name !== self._name || answer.name in nameMap) return
							 | 
						||
| 
								 | 
							
								        nameMap[answer.data] = true
							 | 
						||
| 
								 | 
							
								        self._mdns.query(answer.data, 'PTR')
							 | 
						||
| 
								 | 
							
								      })
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    Object.keys(nameMap).forEach(function (name) {
							 | 
						||
| 
								 | 
							
								      // unregister all services shutting down
							 | 
						||
| 
								 | 
							
								      goodbyes(name, packet).forEach(self._removeService.bind(self))
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      // register all new services
							 | 
						||
| 
								 | 
							
								      var matches = buildServicesFor(name, packet, self._txt, rinfo)
							 | 
						||
| 
								 | 
							
								      if (matches.length === 0) return
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      matches.forEach(function (service) {
							 | 
						||
| 
								 | 
							
								        if (self._serviceMap[service.fqdn]) return // ignore already registered services
							 | 
						||
| 
								 | 
							
								        self._addService(service)
							 | 
						||
| 
								 | 
							
								      })
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								  }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this._mdns.on('response', this._onresponse)
							 | 
						||
| 
								 | 
							
								  this.update()
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Browser.prototype.stop = function () {
							 | 
						||
| 
								 | 
							
								  if (!this._onresponse) return
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  this._mdns.removeListener('response', this._onresponse)
							 | 
						||
| 
								 | 
							
								  this._onresponse = null
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Browser.prototype.update = function () {
							 | 
						||
| 
								 | 
							
								  this._mdns.query(this._name, 'PTR')
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Browser.prototype._addService = function (service) {
							 | 
						||
| 
								 | 
							
								  this.services.push(service)
							 | 
						||
| 
								 | 
							
								  this._serviceMap[service.fqdn] = true
							 | 
						||
| 
								 | 
							
								  this.emit('up', service)
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Browser.prototype._removeService = function (fqdn) {
							 | 
						||
| 
								 | 
							
								  var service, index
							 | 
						||
| 
								 | 
							
								  this.services.some(function (s, i) {
							 | 
						||
| 
								 | 
							
								    if (dnsEqual(s.fqdn, fqdn)) {
							 | 
						||
| 
								 | 
							
								      service = s
							 | 
						||
| 
								 | 
							
								      index = i
							 | 
						||
| 
								 | 
							
								      return true
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								  })
							 | 
						||
| 
								 | 
							
								  if (!service) return
							 | 
						||
| 
								 | 
							
								  this.services.splice(index, 1)
							 | 
						||
| 
								 | 
							
								  delete this._serviceMap[fqdn]
							 | 
						||
| 
								 | 
							
								  this.emit('down', service)
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								// PTR records with a TTL of 0 is considered a "goodbye" announcement. I.e. a
							 | 
						||
| 
								 | 
							
								// DNS response broadcasted when a service shuts down in order to let the
							 | 
						||
| 
								 | 
							
								// network know that the service is no longer going to be available.
							 | 
						||
| 
								 | 
							
								//
							 | 
						||
| 
								 | 
							
								// For more info see:
							 | 
						||
| 
								 | 
							
								// https://tools.ietf.org/html/rfc6762#section-8.4
							 | 
						||
| 
								 | 
							
								//
							 | 
						||
| 
								 | 
							
								// This function returns an array of all resource records considered a goodbye
							 | 
						||
| 
								 | 
							
								// record
							 | 
						||
| 
								 | 
							
								function goodbyes (name, packet) {
							 | 
						||
| 
								 | 
							
								  return packet.answers.concat(packet.additionals)
							 | 
						||
| 
								 | 
							
								    .filter(function (rr) {
							 | 
						||
| 
								 | 
							
								      return rr.type === 'PTR' && rr.ttl === 0 && dnsEqual(rr.name, name)
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								    .map(function (rr) {
							 | 
						||
| 
								 | 
							
								      return rr.data
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								function buildServicesFor (name, packet, txt, referer) {
							 | 
						||
| 
								 | 
							
								  var records = packet.answers.concat(packet.additionals).filter(function (rr) {
							 | 
						||
| 
								 | 
							
								    return rr.ttl > 0 // ignore goodbye messages
							 | 
						||
| 
								 | 
							
								  })
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  return records
							 | 
						||
| 
								 | 
							
								    .filter(function (rr) {
							 | 
						||
| 
								 | 
							
								      return rr.type === 'PTR' && dnsEqual(rr.name, name)
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								    .map(function (ptr) {
							 | 
						||
| 
								 | 
							
								      var service = {
							 | 
						||
| 
								 | 
							
								        addresses: []
							 | 
						||
| 
								 | 
							
								      }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      records
							 | 
						||
| 
								 | 
							
								        .filter(function (rr) {
							 | 
						||
| 
								 | 
							
								          return (rr.type === 'SRV' || rr.type === 'TXT') && dnsEqual(rr.name, ptr.data)
							 | 
						||
| 
								 | 
							
								        })
							 | 
						||
| 
								 | 
							
								        .forEach(function (rr) {
							 | 
						||
| 
								 | 
							
								          if (rr.type === 'SRV') {
							 | 
						||
| 
								 | 
							
								            var parts = rr.name.split('.')
							 | 
						||
| 
								 | 
							
								            var name = parts[0]
							 | 
						||
| 
								 | 
							
								            var types = serviceName.parse(parts.slice(1, -1).join('.'))
							 | 
						||
| 
								 | 
							
								            service.name = name
							 | 
						||
| 
								 | 
							
								            service.fqdn = rr.name
							 | 
						||
| 
								 | 
							
								            service.host = rr.data.target
							 | 
						||
| 
								 | 
							
								            service.referer = referer
							 | 
						||
| 
								 | 
							
								            service.port = rr.data.port
							 | 
						||
| 
								 | 
							
								            service.type = types.name
							 | 
						||
| 
								 | 
							
								            service.protocol = types.protocol
							 | 
						||
| 
								 | 
							
								            service.subtypes = types.subtypes
							 | 
						||
| 
								 | 
							
								          } else if (rr.type === 'TXT') {
							 | 
						||
| 
								 | 
							
								            service.rawTxt = rr.data
							 | 
						||
| 
								 | 
							
								            service.txt = txt.decode(rr.data)
							 | 
						||
| 
								 | 
							
								          }
							 | 
						||
| 
								 | 
							
								        })
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      if (!service.name) return
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      records
							 | 
						||
| 
								 | 
							
								        .filter(function (rr) {
							 | 
						||
| 
								 | 
							
								          return (rr.type === 'A' || rr.type === 'AAAA') && dnsEqual(rr.name, service.host)
							 | 
						||
| 
								 | 
							
								        })
							 | 
						||
| 
								 | 
							
								        .forEach(function (rr) {
							 | 
						||
| 
								 | 
							
								          service.addresses.push(rr.data)
							 | 
						||
| 
								 | 
							
								        })
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      return service
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								    .filter(function (rr) {
							 | 
						||
| 
								 | 
							
								      return !!rr
							 | 
						||
| 
								 | 
							
								    })
							 | 
						||
| 
								 | 
							
								}
							 |