| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631 | 'use strict'var EventEmitter = require('events').EventEmittervar utils = require('./utils')var sasl = require('./crypto/sasl')var TypeOverrides = require('./type-overrides')var ConnectionParameters = require('./connection-parameters')var Query = require('./query')var defaults = require('./defaults')var Connection = require('./connection')const crypto = require('./crypto/utils')class Client extends EventEmitter {  constructor(config) {    super()    this.connectionParameters = new ConnectionParameters(config)    this.user = this.connectionParameters.user    this.database = this.connectionParameters.database    this.port = this.connectionParameters.port    this.host = this.connectionParameters.host    // "hiding" the password so it doesn't show up in stack traces    // or if the client is console.logged    Object.defineProperty(this, 'password', {      configurable: true,      enumerable: false,      writable: true,      value: this.connectionParameters.password,    })    this.replication = this.connectionParameters.replication    var c = config || {}    this._Promise = c.Promise || global.Promise    this._types = new TypeOverrides(c.types)    this._ending = false    this._ended = false    this._connecting = false    this._connected = false    this._connectionError = false    this._queryable = true    this.connection =      c.connection ||      new Connection({        stream: c.stream,        ssl: this.connectionParameters.ssl,        keepAlive: c.keepAlive || false,        keepAliveInitialDelayMillis: c.keepAliveInitialDelayMillis || 0,        encoding: this.connectionParameters.client_encoding || 'utf8',      })    this.queryQueue = []    this.binary = c.binary || defaults.binary    this.processID = null    this.secretKey = null    this.ssl = this.connectionParameters.ssl || false    // As with Password, make SSL->Key (the private key) non-enumerable.    // It won't show up in stack traces    // or if the client is console.logged    if (this.ssl && this.ssl.key) {      Object.defineProperty(this.ssl, 'key', {        enumerable: false,      })    }    this._connectionTimeoutMillis = c.connectionTimeoutMillis || 0  }  _errorAllQueries(err) {    const enqueueError = (query) => {      process.nextTick(() => {        query.handleError(err, this.connection)      })    }    if (this.activeQuery) {      enqueueError(this.activeQuery)      this.activeQuery = null    }    this.queryQueue.forEach(enqueueError)    this.queryQueue.length = 0  }  _connect(callback) {    var self = this    var con = this.connection    this._connectionCallback = callback    if (this._connecting || this._connected) {      const err = new Error('Client has already been connected. You cannot reuse a client.')      process.nextTick(() => {        callback(err)      })      return    }    this._connecting = true    this.connectionTimeoutHandle    if (this._connectionTimeoutMillis > 0) {      this.connectionTimeoutHandle = setTimeout(() => {        con._ending = true        con.stream.destroy(new Error('timeout expired'))      }, this._connectionTimeoutMillis)    }    if (this.host && this.host.indexOf('/') === 0) {      con.connect(this.host + '/.s.PGSQL.' + this.port)    } else {      con.connect(this.port, this.host)    }    // once connection is established send startup message    con.on('connect', function () {      if (self.ssl) {        con.requestSsl()      } else {        con.startup(self.getStartupConf())      }    })    con.on('sslconnect', function () {      con.startup(self.getStartupConf())    })    this._attachListeners(con)    con.once('end', () => {      const error = this._ending ? new Error('Connection terminated') : new Error('Connection terminated unexpectedly')      clearTimeout(this.connectionTimeoutHandle)      this._errorAllQueries(error)      this._ended = true      if (!this._ending) {        // if the connection is ended without us calling .end()        // on this client then we have an unexpected disconnection        // treat this as an error unless we've already emitted an error        // during connection.        if (this._connecting && !this._connectionError) {          if (this._connectionCallback) {            this._connectionCallback(error)          } else {            this._handleErrorEvent(error)          }        } else if (!this._connectionError) {          this._handleErrorEvent(error)        }      }      process.nextTick(() => {        this.emit('end')      })    })  }  connect(callback) {    if (callback) {      this._connect(callback)      return    }    return new this._Promise((resolve, reject) => {      this._connect((error) => {        if (error) {          reject(error)        } else {          resolve()        }      })    })  }  _attachListeners(con) {    // password request handling    con.on('authenticationCleartextPassword', this._handleAuthCleartextPassword.bind(this))    // password request handling    con.on('authenticationMD5Password', this._handleAuthMD5Password.bind(this))    // password request handling (SASL)    con.on('authenticationSASL', this._handleAuthSASL.bind(this))    con.on('authenticationSASLContinue', this._handleAuthSASLContinue.bind(this))    con.on('authenticationSASLFinal', this._handleAuthSASLFinal.bind(this))    con.on('backendKeyData', this._handleBackendKeyData.bind(this))    con.on('error', this._handleErrorEvent.bind(this))    con.on('errorMessage', this._handleErrorMessage.bind(this))    con.on('readyForQuery', this._handleReadyForQuery.bind(this))    con.on('notice', this._handleNotice.bind(this))    con.on('rowDescription', this._handleRowDescription.bind(this))    con.on('dataRow', this._handleDataRow.bind(this))    con.on('portalSuspended', this._handlePortalSuspended.bind(this))    con.on('emptyQuery', this._handleEmptyQuery.bind(this))    con.on('commandComplete', this._handleCommandComplete.bind(this))    con.on('parseComplete', this._handleParseComplete.bind(this))    con.on('copyInResponse', this._handleCopyInResponse.bind(this))    con.on('copyData', this._handleCopyData.bind(this))    con.on('notification', this._handleNotification.bind(this))  }  // TODO(bmc): deprecate pgpass "built in" integration since this.password can be a function  // it can be supplied by the user if required - this is a breaking change!  _checkPgPass(cb) {    const con = this.connection    if (typeof this.password === 'function') {      this._Promise        .resolve()        .then(() => this.password())        .then((pass) => {          if (pass !== undefined) {            if (typeof pass !== 'string') {              con.emit('error', new TypeError('Password must be a string'))              return            }            this.connectionParameters.password = this.password = pass          } else {            this.connectionParameters.password = this.password = null          }          cb()        })        .catch((err) => {          con.emit('error', err)        })    } else if (this.password !== null) {      cb()    } else {      try {        const pgPass = require('pgpass')        pgPass(this.connectionParameters, (pass) => {          if (undefined !== pass) {            this.connectionParameters.password = this.password = pass          }          cb()        })      } catch (e) {        this.emit('error', e)      }    }  }  _handleAuthCleartextPassword(msg) {    this._checkPgPass(() => {      this.connection.password(this.password)    })  }  _handleAuthMD5Password(msg) {    this._checkPgPass(async () => {      try {        const hashedPassword = await crypto.postgresMd5PasswordHash(this.user, this.password, msg.salt)        this.connection.password(hashedPassword)      } catch (e) {        this.emit('error', e)      }    })  }  _handleAuthSASL(msg) {    this._checkPgPass(() => {      try {        this.saslSession = sasl.startSession(msg.mechanisms)        this.connection.sendSASLInitialResponseMessage(this.saslSession.mechanism, this.saslSession.response)      } catch (err) {        this.connection.emit('error', err)      }    })  }  async _handleAuthSASLContinue(msg) {    try {      await sasl.continueSession(this.saslSession, this.password, msg.data)      this.connection.sendSCRAMClientFinalMessage(this.saslSession.response)    } catch (err) {      this.connection.emit('error', err)    }  }  _handleAuthSASLFinal(msg) {    try {      sasl.finalizeSession(this.saslSession, msg.data)      this.saslSession = null    } catch (err) {      this.connection.emit('error', err)    }  }  _handleBackendKeyData(msg) {    this.processID = msg.processID    this.secretKey = msg.secretKey  }  _handleReadyForQuery(msg) {    if (this._connecting) {      this._connecting = false      this._connected = true      clearTimeout(this.connectionTimeoutHandle)      // process possible callback argument to Client#connect      if (this._connectionCallback) {        this._connectionCallback(null, this)        // remove callback for proper error handling        // after the connect event        this._connectionCallback = null      }      this.emit('connect')    }    const { activeQuery } = this    this.activeQuery = null    this.readyForQuery = true    if (activeQuery) {      activeQuery.handleReadyForQuery(this.connection)    }    this._pulseQueryQueue()  }  // if we receieve an error event or error message  // during the connection process we handle it here  _handleErrorWhileConnecting(err) {    if (this._connectionError) {      // TODO(bmc): this is swallowing errors - we shouldn't do this      return    }    this._connectionError = true    clearTimeout(this.connectionTimeoutHandle)    if (this._connectionCallback) {      return this._connectionCallback(err)    }    this.emit('error', err)  }  // if we're connected and we receive an error event from the connection  // this means the socket is dead - do a hard abort of all queries and emit  // the socket error on the client as well  _handleErrorEvent(err) {    if (this._connecting) {      return this._handleErrorWhileConnecting(err)    }    this._queryable = false    this._errorAllQueries(err)    this.emit('error', err)  }  // handle error messages from the postgres backend  _handleErrorMessage(msg) {    if (this._connecting) {      return this._handleErrorWhileConnecting(msg)    }    const activeQuery = this.activeQuery    if (!activeQuery) {      this._handleErrorEvent(msg)      return    }    this.activeQuery = null    activeQuery.handleError(msg, this.connection)  }  _handleRowDescription(msg) {    // delegate rowDescription to active query    this.activeQuery.handleRowDescription(msg)  }  _handleDataRow(msg) {    // delegate dataRow to active query    this.activeQuery.handleDataRow(msg)  }  _handlePortalSuspended(msg) {    // delegate portalSuspended to active query    this.activeQuery.handlePortalSuspended(this.connection)  }  _handleEmptyQuery(msg) {    // delegate emptyQuery to active query    this.activeQuery.handleEmptyQuery(this.connection)  }  _handleCommandComplete(msg) {    // delegate commandComplete to active query    this.activeQuery.handleCommandComplete(msg, this.connection)  }  _handleParseComplete(msg) {    // if a prepared statement has a name and properly parses    // we track that its already been executed so we don't parse    // it again on the same client    if (this.activeQuery.name) {      this.connection.parsedStatements[this.activeQuery.name] = this.activeQuery.text    }  }  _handleCopyInResponse(msg) {    this.activeQuery.handleCopyInResponse(this.connection)  }  _handleCopyData(msg) {    this.activeQuery.handleCopyData(msg, this.connection)  }  _handleNotification(msg) {    this.emit('notification', msg)  }  _handleNotice(msg) {    this.emit('notice', msg)  }  getStartupConf() {    var params = this.connectionParameters    var data = {      user: params.user,      database: params.database,    }    var appName = params.application_name || params.fallback_application_name    if (appName) {      data.application_name = appName    }    if (params.replication) {      data.replication = '' + params.replication    }    if (params.statement_timeout) {      data.statement_timeout = String(parseInt(params.statement_timeout, 10))    }    if (params.lock_timeout) {      data.lock_timeout = String(parseInt(params.lock_timeout, 10))    }    if (params.idle_in_transaction_session_timeout) {      data.idle_in_transaction_session_timeout = String(parseInt(params.idle_in_transaction_session_timeout, 10))    }    if (params.options) {      data.options = params.options    }    return data  }  cancel(client, query) {    if (client.activeQuery === query) {      var con = this.connection      if (this.host && this.host.indexOf('/') === 0) {        con.connect(this.host + '/.s.PGSQL.' + this.port)      } else {        con.connect(this.port, this.host)      }      // once connection is established send cancel message      con.on('connect', function () {        con.cancel(client.processID, client.secretKey)      })    } else if (client.queryQueue.indexOf(query) !== -1) {      client.queryQueue.splice(client.queryQueue.indexOf(query), 1)    }  }  setTypeParser(oid, format, parseFn) {    return this._types.setTypeParser(oid, format, parseFn)  }  getTypeParser(oid, format) {    return this._types.getTypeParser(oid, format)  }  // escapeIdentifier and escapeLiteral moved to utility functions & exported  // on PG  // re-exported here for backwards compatibility  escapeIdentifier(str) {    return utils.escapeIdentifier(str)  }  escapeLiteral(str) {    return utils.escapeLiteral(str)  }  _pulseQueryQueue() {    if (this.readyForQuery === true) {      this.activeQuery = this.queryQueue.shift()      if (this.activeQuery) {        this.readyForQuery = false        this.hasExecuted = true        const queryError = this.activeQuery.submit(this.connection)        if (queryError) {          process.nextTick(() => {            this.activeQuery.handleError(queryError, this.connection)            this.readyForQuery = true            this._pulseQueryQueue()          })        }      } else if (this.hasExecuted) {        this.activeQuery = null        this.emit('drain')      }    }  }  query(config, values, callback) {    // can take in strings, config object or query object    var query    var result    var readTimeout    var readTimeoutTimer    var queryCallback    if (config === null || config === undefined) {      throw new TypeError('Client was passed a null or undefined query')    } else if (typeof config.submit === 'function') {      readTimeout = config.query_timeout || this.connectionParameters.query_timeout      result = query = config      if (typeof values === 'function') {        query.callback = query.callback || values      }    } else {      readTimeout = this.connectionParameters.query_timeout      query = new Query(config, values, callback)      if (!query.callback) {        result = new this._Promise((resolve, reject) => {          query.callback = (err, res) => (err ? reject(err) : resolve(res))        }).catch(err => {          // replace the stack trace that leads to `TCP.onStreamRead` with one that leads back to the          // application that created the query          Error.captureStackTrace(err);          throw err;        })      }    }    if (readTimeout) {      queryCallback = query.callback      readTimeoutTimer = setTimeout(() => {        var error = new Error('Query read timeout')        process.nextTick(() => {          query.handleError(error, this.connection)        })        queryCallback(error)        // we already returned an error,        // just do nothing if query completes        query.callback = () => {}        // Remove from queue        var index = this.queryQueue.indexOf(query)        if (index > -1) {          this.queryQueue.splice(index, 1)        }        this._pulseQueryQueue()      }, readTimeout)      query.callback = (err, res) => {        clearTimeout(readTimeoutTimer)        queryCallback(err, res)      }    }    if (this.binary && !query.binary) {      query.binary = true    }    if (query._result && !query._result._types) {      query._result._types = this._types    }    if (!this._queryable) {      process.nextTick(() => {        query.handleError(new Error('Client has encountered a connection error and is not queryable'), this.connection)      })      return result    }    if (this._ending) {      process.nextTick(() => {        query.handleError(new Error('Client was closed and is not queryable'), this.connection)      })      return result    }    this.queryQueue.push(query)    this._pulseQueryQueue()    return result  }  ref() {    this.connection.ref()  }  unref() {    this.connection.unref()  }  end(cb) {    this._ending = true    // if we have never connected, then end is a noop, callback immediately    if (!this.connection._connecting || this._ended) {      if (cb) {        cb()      } else {        return this._Promise.resolve()      }    }    if (this.activeQuery || !this._queryable) {      // if we have an active query we need to force a disconnect      // on the socket - otherwise a hung query could block end forever      this.connection.stream.destroy()    } else {      this.connection.end()    }    if (cb) {      this.connection.once('end', cb)    } else {      return new this._Promise((resolve) => {        this.connection.once('end', resolve)      })    }  }}// expose a Query constructorClient.Query = Querymodule.exports = Client
 |