| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631 | 
							- 'use strict'
 
- var EventEmitter = require('events').EventEmitter
 
- var 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 constructor
 
- Client.Query = Query
 
- module.exports = Client
 
 
  |