@barchart/portfolio-client-js 10.2.0 → 10.3.0

package/lib/gateway/PortfolioGateway.js

@@ -108,6 +108,25 @@ module.exports = (() => {
 
 			const protocolType = Enum.fromCode(ProtocolType, protocol.toUpperCase());
 
+			this._readInstrumentEndpoint = EndpointBuilder.for('read-instrument', 'read instrument')
+				.withVerb(VerbType.GET)
+				.withProtocol(protocolType)
+				.withHost(host)
+				.withPort(port)
+				.withPathBuilder((pb) => {
+					pb.withLiteralParameter('version', REST_API_VERSION)
+						.withLiteralParameter('instruments', 'instruments')
+						.withVariableParameter('symbol', 'symbol', 'symbol', false);
+				})
+				.withQueryBuilder((qb) => {
+					qb.withVariableParameter('day', 'day', 'day', true, x => x.format());
+				})
+				.withRequestInterceptor(RequestInterceptor.PLAIN_TEXT_RESPONSE)
+				.withRequestInterceptor(requestInterceptor)
+				.withResponseInterceptor(responseInterceptorForDeserialization)
+				.withErrorInterceptor(errorInterceptor)
+				.endpoint;
+
 			this._readPortfoliosEndpoint = EndpointBuilder.for('read-portfolios', 'read portfolios')
 				.withVerb(VerbType.GET)
 				.withProtocol(protocolType)
@@ -712,6 +731,30 @@ module.exports = (() => {
 			return this._startPromise;
 		}
 
+		/**
+		 * Resolves an instrument.
+		 *
+		 * @public
+		 * @async
+		 * @param {String} symbol - The symbol used to resolve the instrument.
+		 * @param {Day=} day - The day used for symbol resolution.
+		 * @returns {Promise<Object>}
+		 */
+		async readInstrument(symbol, day) {
+			checkStart.call(this);
+
+			assert.argumentIsRequired(symbol, 'symbol', String);
+			assert.argumentIsOptional(day, 'day', Day, 'Day');
+
+			const payload = { symbol };
+
+			if (day) {
+				payload.day = day;
+			}
+
+			return Gateway.invoke(this._readInstrumentEndpoint, payload);
+		}
+
 		/**
 		 * Creates a new portfolio for the current user.
 		 *

package/lib/index.js

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

package/package.json

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