@barchart/portfolio-client-js 10.0.1 → 10.2.0

package/lib/data/.meta.js

@@ -298,6 +298,17 @@ const InstrumentType = require('@barchart/portfolio-api-common/lib/data/Instrume
  * @property {String[]} positions - Array of position identifiers for which are currently being calculated. An empty result indicates all position valuations are up-to-date.
  */
 
+/**
+ * The result of recalculating aggregate values in a requested currency for the authorized user.
+ *
+ * @typedef UpdateValuesCurrencyResult
+ * @type {Object}
+ * @memberOf Schema
+ * @property {Boolean} success - Indicates the aggregate values were successfully recalculated.
+ * @property {String} userId - The identifier of the authorized user whose values were recalculated.
+ * @property {String} currency - The currency code used for the recalculation.
+ */
+
 /**
  * Instructions for connecting to a brokerage via SnapTrade.
  *

package/lib/gateway/PortfolioGateway.js

@@ -330,6 +330,23 @@ module.exports = (() => {
 				.withErrorInterceptor(errorInterceptor)
 				.endpoint;
 
+			this._updateValuesCurrencyEndpoint = EndpointBuilder.for('update-values-currency', 'update values currency')
+				.withVerb(VerbType.PUT)
+				.withProtocol(protocolType)
+				.withHost(host)
+				.withPort(port)
+				.withPathBuilder((pb) => {
+					pb.withLiteralParameter('version', REST_API_VERSION)
+						.withLiteralParameter('values', 'values')
+						.withLiteralParameter('currency', 'currency');
+				})
+				.withBody('currency')
+				.withRequestInterceptor(RequestInterceptor.PLAIN_TEXT_RESPONSE)
+				.withRequestInterceptor(requestInterceptor)
+				.withResponseInterceptor(responseInterceptorForDeserialization)
+				.withErrorInterceptor(errorInterceptor)
+				.endpoint;
+
 			this._readTransactionsEndpoint = EndpointBuilder.for('read-transactions', 'read transactions')
 				.withVerb(VerbType.GET)
 				.withProtocol(protocolType)
@@ -1055,6 +1072,22 @@ module.exports = (() => {
 			return Gateway.invoke(this._queryPositionValuationsEndpoint, { symbol });
 		}
 
+		/**
+		 * Recalculates aggregate values for the authorized user in the requested currency.
+		 *
+		 * @public
+		 * @async
+		 * @param {String} currency - The target currency code (e.g. `USD`).
+		 * @returns {Promise<Schema.UpdateValuesCurrencyResult>}
+		 */
+		async updateValuesCurrency(currency) {
+			checkStart.call(this);
+
+			assert.argumentIsRequired(currency, 'currency', String);
+
+			return Gateway.invoke(this._updateValuesCurrencyEndpoint, { currency });
+		}
+
 		/**
 		 * Creates a new transaction.
 		 *
@@ -1412,13 +1445,16 @@ module.exports = (() => {
 		 * @param {String} connection - The SnapTrade identifier for the brokerage connection.
 		 * @param {String} account - The SnapTrade identifier for the brokerage account.
 		 * @param {SnapTradeLinkStatusCallback} callback
+		 * @param {Number=} interval - The polling interval, in milliseconds. Default is 2500 ms.
 		 * @returns {Disposable}
 		 */
-		subscribeSnapTradeAccountLink(connection, account, callback) {
+		subscribeSnapTradeAccountLink(connection, account, callback, interval = 2500) {
 			checkStart.call(this);
 
 			assert.argumentIsRequired(connection, 'connection', String);
 			assert.argumentIsRequired(account, 'account', String);
+			assert.argumentIsRequired(callback, 'callback', Function);
+			assert.argumentIsOptional(interval, 'interval', Number);
 
 			let disposable;
 
@@ -1436,7 +1472,7 @@ module.exports = (() => {
 				}
 			};
 
-			const token = setInterval(poll, 2500);
+			const token = setInterval(poll, interval);
 
 			disposable = Disposable.fromAction(() => {
 				clearInterval(token);
@@ -1917,4 +1953,4 @@ module.exports = (() => {
 	 */
 
 	return PortfolioGateway;
-})();
+})();

package/lib/index.js

@@ -7,6 +7,6 @@ module.exports = (() => {
 	return {
 		JwtProvider: JwtProvider,
 		PortfolioGateway: PortfolioGateway,
-		version: '10.0.1'
+		version: '10.2.0'
 	};
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barchart/portfolio-client-js",
-  "version": "10.0.1",
+  "version": "10.2.0",
   "description": "JavaScript SDK for Barchart's Portfolio Service",
   "homepage": "https://docs.barchart.com/portfolio/#/",
   "author": {