jsforce2 1.11.1 → 5.2.1

package/lib/core.js

@@ -1,16 +0,0 @@
-/**
- * @file JSforce Core
- * @author Shinichi Tomita <shinichi.tomita@gmail.com>
- */
-'use strict';
-
-var EventEmitter = require('events').EventEmitter;
-
-var jsforce = module.exports = new EventEmitter();
-jsforce.VERSION = require('./VERSION');
-jsforce.Connection = require('./connection');
-jsforce.OAuth2 = require('./oauth2');
-jsforce.Date = jsforce.SfDate = require("./date");
-jsforce.RecordStream = require('./record-stream');
-jsforce.Promise = require('./promise');
-jsforce.require = require('./require');

package/lib/csv.js

@@ -1,50 +0,0 @@
-'use strict';
-
-var _ = require('lodash/core'),
-    csvParse = require('csv-parse/lib/es5'),
-    csvParseSync = require('csv-parse/lib/es5/sync'),
-    csvStringify = require('csv-stringify'),
-    csvStringifySync = require('csv-stringify/lib/sync');
-
-/**
- * @private
- */
-function parseCSV(str, options) {
-  options = _.extend({}, options, { columns: true });
-  return csvParseSync(str, options);
-}
-
-/**
- * @private
- */
-function toCSV(records, options) {
-  options = _.extend({}, options, { header: true });
-  return csvStringifySync(records, options);
-}
-
-/**
- * @private
- */
-function parseCSVStream(options) {
-  options = _.extend({}, options, { columns: true });
-  return csvParse(options);
-}
-
-/**
- * @private
- */
-function serializeCSVStream(options) {
-  options = _.extend({}, options, { header: true });
-  return csvStringify(options);
-}
-
-
-/**
- * @protected
- */
-module.exports = {
-  parseCSV: parseCSV,
-  toCSV: toCSV,
-  parseCSVStream: parseCSVStream,
-  serializeCSVStream: serializeCSVStream
-};

package/lib/date.js

@@ -1,163 +0,0 @@
-'use strict';
-
-var _ = require('lodash/core');
-
-/**
- * A date object to keep Salesforce date literal
- *
- * @class
- * @constructor
- * @see http://www.salesforce.com/us/developer/docs/soql_sosl/Content/sforce_api_calls_soql_select_dateformats.htm
- */
-var SfDate = module.exports = function(literal) {
-  this._literal = literal;
-};
-
-/**
- * Returns literal when converted to string
- *
- * @override
- */
-SfDate.prototype.toString =
-SfDate.prototype.toJSON = function() { return this._literal; };
-
-
-/** @private **/
-function zeropad(n) { return (n<10 ? "0" : "") + n; }
-
-/**
- * Convert JavaScript date object to ISO8601 Date format (e.g. 2012-10-31)
- *
- * @param {String|Number|Date} date - Input date
- * @returns {SfDate} - Salesforce date literal with ISO8601 date format
- */
-SfDate.toDateLiteral = function(date) {
-  if (_.isNumber(date)) {
-    date = new Date(date);
-  } else if (_.isString(date)) {
-    date = SfDate.parseDate(date);
-  }
-  var yy = date.getFullYear();
-  var mm = date.getMonth()+1;
-  var dd = date.getDate();
-  var dstr = [ yy, zeropad(mm), zeropad(dd) ].join("-");
-  return new SfDate(dstr);
-};
-
-/**
- * Convert JavaScript date object to ISO8601 DateTime format
- * (e.g. 2012-10-31T12:34:56Z)
- *
- * @param {String|Number|Date} date - Input date
- * @returns {SfDate} - Salesforce date literal with ISO8601 datetime format
- */
-SfDate.toDateTimeLiteral = function(date) {
-  if (_.isNumber(date)) {
-    date = new Date(date);
-  } else if (_.isString(date)) {
-    date = SfDate.parseDate(date);
-  }
-  var yy = date.getUTCFullYear();
-  var mm = date.getUTCMonth()+1;
-  var dd = date.getUTCDate();
-  var hh = date.getUTCHours();
-  var mi = date.getUTCMinutes();
-  var ss = date.getUTCSeconds();
-  var dtstr =
-    [ yy, zeropad(mm), zeropad(dd) ].join("-") + "T" +
-    [ zeropad(hh), zeropad(mi), zeropad(ss) ].join(":") + "Z";
-  return new SfDate(dtstr);
-};
-
-/**
- * Parse IS08601 date(time) formatted string and return date instance
- *
- * @param {String} str
- * @returns {Date}
- */
-SfDate.parseDate = function(str) {
-  var d = new Date();
-  var regexp = /^([\d]{4})-?([\d]{2})-?([\d]{2})(T([\d]{2}):?([\d]{2}):?([\d]{2})(.([\d]{3}))?(Z|([\+\-])([\d]{2}):?([\d]{2})))?$/;
-  var m = str.match(regexp);
-  if (m) {
-    d = new Date(0);
-    if (!m[4]) {
-      d.setFullYear(parseInt(m[1], 10));
-      d.setDate(parseInt(m[3], 10));
-      d.setMonth(parseInt(m[2], 10) - 1);
-      d.setHours(0);
-      d.setMinutes(0);
-      d.setSeconds(0);
-      d.setMilliseconds(0);
-    } else {
-      d.setUTCFullYear(parseInt(m[1], 10));
-      d.setUTCDate(parseInt(m[3], 10));
-      d.setUTCMonth(parseInt(m[2], 10) - 1);
-      d.setUTCHours(parseInt(m[5], 10));
-      d.setUTCMinutes(parseInt(m[6], 10));
-      d.setUTCSeconds(parseInt(m[7], 10));
-      d.setUTCMilliseconds(parseInt(m[9] || '0', 10));
-      if (m[10] && m[10] !== 'Z') {
-        var offset = parseInt(m[12],10) * 60 + parseInt(m[13], 10);
-        d.setTime((m[11] === '+' ? -1 : 1) * offset * 60 * 1000 +d.getTime());
-      }
-    }
-    return d;
-  } else {
-    throw new Error("Invalid date format is specified : " + str);
-  }
-};
-
-/*
- * Pre-defined Salesforce Date Literals
- */
-var SfDateLiterals = {
-  YESTERDAY: 1,
-  TODAY: 1,
-  TOMORROW: 1,
-  LAST_WEEK: 1,
-  THIS_WEEK: 1,
-  NEXT_WEEK: 1,
-  LAST_MONTH: 1,
-  THIS_MONTH: 1,
-  NEXT_MONTH: 1,
-  LAST_90_DAYS: 1,
-  NEXT_90_DAYS: 1,
-  LAST_N_DAYS: 2,
-  NEXT_N_DAYS: 2,
-  NEXT_N_WEEKS: 2,
-  LAST_N_WEEKS: 2,
-  NEXT_N_MONTHS: 2,
-  LAST_N_MONTHS: 2,
-  THIS_QUARTER: 1,
-  LAST_QUARTER: 1,
-  NEXT_QUARTER: 1,
-  NEXT_N_QUARTERS: 2,
-  LAST_N_QUARTERS: 2,
-  THIS_YEAR: 1,
-  LAST_YEAR: 1,
-  NEXT_YEAR: 1,
-  NEXT_N_YEARS: 2,
-  LAST_N_YEARS: 2,
-  THIS_FISCAL_QUARTER: 1,
-  LAST_FISCAL_QUARTER: 1,
-  NEXT_FISCAL_QUARTER: 1,
-  NEXT_N_FISCAL_QUARTERS:2,
-  LAST_N_FISCAL_QUARTERS:2,
-  THIS_FISCAL_YEAR:1,
-  LAST_FISCAL_YEAR:1,
-  NEXT_FISCAL_YEAR:1,
-  NEXT_N_FISCAL_YEARS: 2,
-  LAST_N_FISCAL_YEARS: 2
-};
-
-for (var literal in SfDateLiterals) {
-  var type = SfDateLiterals[literal];
-  SfDate[literal] =
-   type === 1 ? new SfDate(literal) : createLiteralBuilder(literal);
-}
-
-/** @private **/
-function createLiteralBuilder(literal) {
-  return function(num) { return new SfDate(literal + ":" + num); };
-}

package/lib/http-api.js

@@ -1,300 +0,0 @@
-'use strict';
-
-var inherits = require('inherits'),
-    events = require('events'),
-    _ = require('lodash/core'),
-    Promise = require('./promise');
-
-/**
- * HTTP based API class with authorization hook
- *
- * @constructor
- * @extends events.EventEmitter
- * @param {Connection} conn - Connection object
- * @param {Object} [options] - Http API Options
- * @param {String} [options.responseType] - Overriding content mime-type in response
- * @param {Transport} [options.transport] - Transport for http api
- * @param {Object} [options.noContentResponse] - Alternative response when no content returned in response (= HTTP 204)
- */
-var HttpApi = function(conn, options) {
-  options = options || {};
-  this._conn = conn;
-  this.on('resume', function(err) { conn.emit('resume', err); });
-  this._responseType = options.responseType;
-  this._transport = options.transport || conn._transport;
-  this._noContentResponse = options.noContentResponse;
-};
-
-inherits(HttpApi, events.EventEmitter);
-
-/**
- * Callout to API endpoint using http
- *
- * @param {Object} request - Http Request object
- * @param {String} request.url - Endpoint URL to request
- * @param {String} request.method - Http method for request
- * @param {Object} [request.headers] - Http request headers in hash object
- * @param {Callback.<Object>} callback - Callback function
- * @returns {Promise.<Object>} -
- */
-HttpApi.prototype.request = function(request, callback) {
-  var self = this;
-  var conn = this._conn;
-  var logger = conn._logger;
-  var refreshDelegate = this.getRefreshDelegate();
-  // remember previous instance url in case it changes after a refresh
-  var lastInstanceUrl = conn.instanceUrl;
-
-  var deferred = Promise.defer();
-
-  var onResume = function(err) {
-    if (err) {
-      deferred.reject(err);
-      return;
-    }
-    // check to see if the token refresh has changed the instance url
-    if(lastInstanceUrl !== conn.instanceUrl){
-      // if the instance url has changed
-      // then replace the current request urls instance url fragment
-      // with the updated instance url
-      request.url = request.url.replace(lastInstanceUrl,conn.instanceUrl);
-    }
-
-    self.request(request).then(function(response) {
-      deferred.resolve(response);
-    }, function(err) {
-      deferred.reject(err);
-    });
-  };
-
-  if (refreshDelegate && refreshDelegate._refreshing) {
-    refreshDelegate.once('resume', onResume);
-    return deferred.promise.thenCall(callback);
-  }
-
-  // hook before sending
-  self.beforeSend(request);
-
-  self.emit('request', request);
-  logger.debug("<request> method=" + request.method + ", url=" + request.url);
-  var requestTime = Date.now();
-
-  return this._transport.httpRequest(request).then(function(response) {
-    var responseTime = Date.now();
-    logger.debug("elapsed time : " + (responseTime - requestTime) + "msec");
-    logger.debug("<response> status=" + response.statusCode + ", url=" + request.url);
-
-    self.emit('response', response);
-    // Refresh token if session has been expired and requires authentication
-    // when session refresh delegate is available
-    if (self.isSessionExpired(response) && refreshDelegate) {
-      refreshDelegate.refresh(requestTime, onResume);
-      return deferred.promise;
-    }
-    if (self.isErrorResponse(response)) {
-      var err = self.getError(response);
-      throw err;
-    }
-    return self.getResponseBody(response);
-  }, function(err) {
-    var responseTime = Date.now();
-    logger.debug("elapsed time : " + (responseTime - requestTime) + "msec");
-    logger.error(err);
-    throw err;
-  })
-  .thenCall(callback);
-};
-
-/**
- * @protected
- */
-HttpApi.prototype.getRefreshDelegate = function() {
-  return this._conn._refreshDelegate;
-};
-
-/**
- *
- * @protected
- */
-HttpApi.prototype.beforeSend = function(request) {
-  request.headers = request.headers || {};
-  if (this._conn.accessToken) {
-    request.headers.Authorization = "Bearer " + this._conn.accessToken;
-  }
-  if (this._conn.callOptions) {
-    var callOptions = [];
-    for (var name in this._conn.callOptions) {
-      callOptions.push(name + "=" + this._conn.callOptions[name]);
-    }
-    request.headers["Sforce-Call-Options"] = callOptions.join(', ');
-  }
-};
-
-/**
- * Detect response content mime-type
- * @protected
- */
-HttpApi.prototype.getResponseContentType = function(response) {
-  return this._responseType || response.headers && response.headers["content-type"];
-};
-
-/**
- *
- */
-HttpApi.prototype.parseResponseBody = function(response) {
-  var contentType = this.getResponseContentType(response);
-  var parseBody = /^(text|application)\/xml(;|$)/.test(contentType) ? parseXML :
-         /^application\/json(;|$)/.test(contentType) ? parseJSON :
-         /^text\/csv(;|$)/.test(contentType) ? parseCSV :
-         parseText;
-  try {
-    return parseBody(response.body);
-  } catch(e) {
-    return response.body;
-  }
-};
-
-/**
- * Get response body
- * @protected
- */
-HttpApi.prototype.getResponseBody = function(response) {
-  if (response.statusCode === 204) { // No Content
-    return this._noContentResponse;
-  }
-  var body = this.parseResponseBody(response);
-  var err;
-  if (this.hasErrorInResponseBody(body)) {
-    err = this.getError(response, body);
-    throw err;
-  }
-  if (response.statusCode === 300) { // Multiple Choices
-    err = new Error('Multiple records found');
-    err.name = "MULTIPLE_CHOICES";
-    err.content = body;
-    throw err;
-  }
-  return body;
-};
-
-/** @private */
-function parseJSON(str) {
-  return JSON.parse(str);
-}
-
-/** @private */
-function parseXML(str) {
-  var ret = {};
-  require('xml2js').parseString(str, { explicitArray: false }, function(err, result) {
-    ret = { error: err, result : result };
-  });
-  if (ret.error) { throw ret.error; }
-  return ret.result;
-}
-
-/** @private */
-function parseCSV(str) {
-  return require('./csv').parseCSV(str);
-}
-
-/** @private */
-function parseText(str) { return str; }
-
-
-/**
- * Detect session expiry
- * @protected
- */
-HttpApi.prototype.isSessionExpired = function(response) {
-  return response.statusCode === 401;
-};
-
-/**
- * Detect error response
- * @protected
- */
-HttpApi.prototype.isErrorResponse = function(response) {
-  return response.statusCode >= 400;
-};
-
-/**
- * Detect error in response body
- * @protected
- */
-HttpApi.prototype.hasErrorInResponseBody = function(body) {
-  return false;
-};
-
-/**
- * Parsing error message in response
- * @protected
- */
-HttpApi.prototype.parseError = function(body) {
-  var errors = body;
-  return _.isArray(errors) ? errors[0] : errors;
-};
-
-/**
- * Get error message in response
- * @protected
- */
-HttpApi.prototype.getError = function(response, body) {
-  var error;
-  try {
-    error = this.parseError(body || this.parseResponseBody(response));
-  } catch(e) {}
-  error = _.isObject(error) && _.isString(error.message) ? error : {
-    errorCode: 'ERROR_HTTP_' + response.statusCode,
-    message : response.body
-  };
-  var err = new Error(error.message);
-  err.name = error.errorCode;
-  for (var key in error) { err[key] = error[key]; }
-  return err;
-};
-
-/*-------------------------------------------------------------------------*/
-
-/**
- * @protected
- */
-var SessionRefreshDelegate = function(conn, refreshFn) {
-  this._conn = conn;
-  this._refreshFn = refreshFn;
-  this._refreshing = false;
-};
-
-inherits(SessionRefreshDelegate, events.EventEmitter);
-
-/**
- * Refresh access token
- * @private
- */
-SessionRefreshDelegate.prototype.refresh = function(since, callback) {
-  // Callback immediately When refreshed after designated time
-  if (this._lastRefreshedAt > since) { return callback(); }
-  var self = this;
-  var conn = this._conn;
-  var logger = conn._logger;
-  self.once('resume', callback);
-  if (self._refreshing) { return; }
-  logger.debug("<refresh token>");
-  self._refreshing = true;
-  return self._refreshFn(conn, function(err, accessToken, res) {
-    if (!err) {
-      logger.debug("Connection refresh completed.");
-      conn.accessToken = accessToken;
-      conn.emit("refresh", accessToken, res);
-    }
-    self._lastRefreshedAt = Date.now();
-    self._refreshing = false;
-    self.emit('resume', err);
-  });
-};
-
-
-/**
- *
- */
-HttpApi.SessionRefreshDelegate = SessionRefreshDelegate;
-module.exports = HttpApi;

package/lib/jsforce.js

@@ -1,10 +0,0 @@
-/**
- * @file JSforce API root object
- * @author Shinichi Tomita <shinichi.tomita@gmail.com>
- */
-
-'use strict';
-
-require('./api');
-require('./registry');
-module.exports = require('./core');

package/lib/logger.js

@@ -1,52 +0,0 @@
-'use strict';
-
-/**
- * @protected
- * @class
- * @constructor
- * @param {String|Number} logLevel - Log level
- */
-var Logger = module.exports = function(logLevel) {
-  if (typeof logLevel === 'string') {
-    logLevel = LogLevels[logLevel];
-  }
-  if (!logLevel) {
-    logLevel = LogLevels.INFO;
-  }
-  this._logLevel = logLevel;
-};
-
-/**
- * @memberof Logger
- */
-var LogLevels = Logger.LogLevels = {
-  "DEBUG" : 1,
-  "INFO" : 2,
-  "WARN" : 3,
-  "ERROR" : 4,
-  "FATAL" : 5
-};
-
-/**
- * Output log
- *
- * @param {String} level - Logging target level
- * @param {String} message - Message to log
- */
-Logger.prototype.log = function(level, message) {
-  if (this._logLevel <= level) {
-    if (level < LogLevels.ERROR) {
-      console.log(message);
-    } else {
-      console.error(message);
-    }
-  }
-};
-
-for (var level in LogLevels) {
-  Logger.prototype[level.toLowerCase()] = createLoggerFunction(LogLevels[level]);
-}
-
-function createLoggerFunction(level) {
-  return function(message) { this.log(level, message); };
-}