@barchart/portfolio-api-common 1.23.0 → 1.24.0

package/lib/calculators/AveragePriceCalculator.js

@@ -24,7 +24,7 @@ module.exports = (() => {
 		 * @param {Object} instrument
 		 * @param {Decimal|Number} basis
 		 * @param {Decimal|Number} quantity
-		 * @returns {null|Decimal}
+		 * @returns {Decimal|null}
 		 */
 		static calculate(instrument, basis, quantity) {
 			let basisToUse = null;

package/lib/formatters/TransactionFormatter.js

@@ -6,6 +6,8 @@ const assert = require('@barchart/common-js/lang/assert'),
 	is = require('@barchart/common-js/lang/is'),
 	formatter = require('@barchart/common-js/lang/formatter');
 
+formatter.numberToFraction = require('@barchart/marketdata-api-js/lib/utilities/format/fraction');
+
 const InstrumentType = require('./../data/InstrumentType'),
 	TransactionType = require('./../data/TransactionType');
 
@@ -32,12 +34,14 @@ module.exports = (() => {
 		 * @param {Object[]} transactions
 		 * @param {Object[]} positions
 		 * @param {Boolean=} descending
+		 * @param {Boolean=} fractions
 		 * @returns {Array}
 		 */
-		static format(transactions, positions, descending) {
+		static format(transactions, positions, descending, fractions) {
 			assert.argumentIsArray(transactions, 'transactions');
 			assert.argumentIsArray(positions, 'positions');
 			assert.argumentIsOptional(descending, 'descending', Boolean);
+			assert.argumentIsOptional(fractions, 'fractions', Boolean);
 
 			const instruments = positions.reduce((map, p) => {
 				const instrument = Object.assign({ }, p.instrument || { });
@@ -52,7 +56,7 @@ module.exports = (() => {
 
 				if (instruments.hasOwnProperty(position)) {
 					let instrument = instruments[position];
-					let formatted = { instrument, raw: {} };
+					let formatted = { instrument, raw: { } };
 
 					const formatterFunctions = formatters.get(transaction.type);
 
@@ -60,13 +64,21 @@ module.exports = (() => {
 						formatterFunction(transaction, formatted);
 					});
 
+					const code = instrument.code;
+
 					Object.keys(formatted).forEach((key) => {
 						const value = formatted[key];
 
 						if (value instanceof Decimal) {
-							const precision = instrument.currency.precision;
+							if (fractions && code && code.supportsFractions && (instrument.type === InstrumentType.FUTURE || instrument.type === InstrumentType.FUTURE_OPTION) && keys.fractions.some(k => k === key)) {
+								const rounded = code.roundToNearestTick(value.toFloat(), instrument.future ? instrument.future.tick : instrument.option.tick, true);
+
+								formatted[key] = formatter.numberToFraction(rounded, code.fractionFactor, code.fractionDigits, '-', true);
+							} else {
+								const precision = instrument.currency.precision;
 
-							formatted[key] = formatter.numberToString(value.toFloat(), precision, ',');
+								formatted[key] = formatter.numberToString(value.toFloat(), precision, ',');
+							}
 						}
 					});
 
@@ -122,6 +134,10 @@ module.exports = (() => {
 		}
 	}
 
+	const keys = { };
+
+	keys.fractions = [ 'average', 'price' ];
+
 	const basicFormatter = (t, f) => {
 		f.date = t.date;
 		f.type = t.type.display;
@@ -147,6 +163,7 @@ module.exports = (() => {
 		}
 
 		f.average = average;
+		f.raw.average = getRawForDecimal(average);
 	};
 
 	const buySellFormatter = (t, f) => {

package/lib/processing/PositionGroup.js

@@ -9,6 +9,8 @@ const array = require('@barchart/common-js/lang/array'),
 	is = require('@barchart/common-js/lang/is'),
 	Rate = require('@barchart/common-js/lang/Rate');
 
+const fractionFormatter = require('@barchart/marketdata-api-js/lib/utilities/format/fraction');
+
 const InstrumentType = require('./../data/InstrumentType');
 
 const PositionLevelDefinition = require('./definitions/PositionLevelDefinition'),
@@ -218,10 +220,10 @@ module.exports = (() => {
 		}
 
 		/**
-		 * The {@link LevelDefinition} which was used to generate this group.
+		 * The {@link PositionLevelDefinition} which was used to generate this group.
 		 *
 		 * @public
-		 * @returns {LevelDefinition}
+		 * @returns {PositionLevelDefinition}
 		 */
 		get definition() {
 			return this._definition;
@@ -516,10 +518,12 @@ module.exports = (() => {
 	function bindItem(item) {
 		const quoteBinding = item.registerQuoteChangeHandler((quote, sender) => {
 			if (this._single) {
-				const precision = sender.position.instrument.currency.precision;
+				const instrument = sender.position.instrument;
+				const currency = instrument.currency;
+				const precision = currency.precision;
 
 				this._dataActual.currentPrice = quote.lastPrice;
-				this._dataFormat.currentPrice = formatNumber(this._dataActual.currentPrice, precision);
+				this._dataFormat.currentPrice = formatFraction(this._dataActual.currentPrice, currency, instrument);
 
 				this._dataActual.quoteLast = quote.previousPrice;
 				this._dataActual.quoteOpen = quote.openPrice;
@@ -534,7 +538,8 @@ module.exports = (() => {
 				this._dataFormat.quoteOpen = formatNumber(this._dataActual.quoteOpen, precision);
 				this._dataFormat.quoteHigh = formatNumber(this._dataActual.quoteHigh, precision);
 				this._dataFormat.quoteLow = formatNumber(this._dataActual.quoteLow, precision);
-				this._dataFormat.quoteChange = formatNumber(this._dataActual.quoteChange, precision);
+				this._dataFormat.quoteChange = formatFraction(this._dataActual.quoteChange, currency, instrument);
+
 				this._dataFormat.quoteChangePercent = formatPercent(new Decimal(this._dataActual.quoteChangePercent || 0), 2);
 				this._dataFormat.quoteTime = this._dataActual.quoteTime;
 				this._dataFormat.quoteVolume = formatNumber(this._dataActual.quoteVolume, 0);
@@ -660,6 +665,27 @@ module.exports = (() => {
 		}));
 	}
 
+	function formatFraction(value, currency, instrument) {
+		let decimal = value instanceof Decimal;
+
+		if (instrument) {
+			const type = instrument.type;
+			const code = instrument.code;
+
+			if (code && code.supportsFractions && (type === InstrumentType.FUTURE || type === InstrumentType.FUTURE_OPTION)) {
+				const rounded = code.roundToNearestTick(decimal ? value.toFloat() : value, instrument.future ? instrument.future.tick : instrument.option.tick, true);
+
+				return fractionFormatter(rounded, code.fractionFactor, code.fractionDigits, '-', true);
+			}
+		}
+
+		if (decimal) {
+			return formatDecimal(value, currency.precision);
+		} else {
+			return formatNumber(value, currency.precision);
+		}
+	}
+
 	function formatNumber(number, precision) {
 		if (is.number(number)) {
 			return formatter.numberToString(number, precision, ',', false);
@@ -833,8 +859,7 @@ module.exports = (() => {
 			format.quantityPrevious = formatDecimal(actual.quantityPrevious, 2);
 
 			actual.basisPrice = item.data.basisPrice;
-
-			format.basisPrice = formatCurrency(actual.basisPrice, currency);
+			format.basisPrice = formatFraction(actual.basisPrice, currency, item.position.instrument);
 
 			actual.periodPrice = item.data.periodPrice;
 			actual.periodPricePrevious = item.data.periodPricePrevious;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barchart/portfolio-api-common",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "description": "Common JavaScript code used by Barchart's Portfolio Service",
   "author": {
     "name": "Bryan Ingle",
@@ -16,7 +16,7 @@
   },
   "dependencies": {
     "@barchart/common-js": "^4.27.0",
-    "@barchart/marketdata-api-js": "^6.2.0",
+    "@barchart/marketdata-api-js": "^6.2.1",
     "uuid": "^8.3.2"
   },
   "devDependencies": {