@barchart/portfolio-api-common 1.2.139 → 1.2.143

package/lib/api/failures/PortfolioFailureType.js

@@ -303,7 +303,7 @@ module.exports = (() => {
 	const transactionCreateFailedTypeReserved = new FailureType('TRANSACTION_CREATE_FAILED_TYPE_RESERVED', 'Unable to create {U|type.description} transaction, this type of transaction is managed by the system.');
 	const transactionCreateFailedReinvestPriceUnavailable = new FailureType('TRANSACTION_CREATE_FAILED_REINVEST_PRICE_UNAVAILABLE', 'Unable to create transaction, a dividend was paid on {L|day}; however no historical price is available for this day. To successfully create this transaction, please turn off dividend reinvestment for this position.');
 	const transactionCreateFailedPositionLocked = new FailureType('TRANSACTION_CREATE_FAILED_POSITION_LOCKED', 'Unable to create transaction, your {L|description} history is being recalculated. Please re-enter this transaction in a minute or two.');
-	const transactionCreateFailedInstrumentCorrupt = new new FailureType('TRANSACTION_CREATE_FAILED_INSTRUMENT_CORRUPT', 'Unable to create transaction, corporate action history for {U|symbol} cannot be located.');
+	const transactionCreateFailedInstrumentCorrupt = new FailureType('TRANSACTION_CREATE_FAILED_INSTRUMENT_CORRUPT', 'Unable to create transaction, corporate action history for {U|symbol} cannot be located.');
 
 	const transactionDeleteFailedOutOfSequence = new FailureType('TRANSACTION_DELETE_FAILED_OUT_OF_SEQUENCE', 'Deleting any transaction, except for the most recent, will cause transaction history to be re-written. Please confirm your intent to re-write transaction history (which could take some time and alter the historical results for this position).');
 	const transactionDeleteFailedNoTransaction = new FailureType('TRANSACTION_DELETE_FAILED_NO_TRANSACTION', 'Unable to delete transaction. The referenced transaction does not exist.');

package/lib/processing/PositionGroup.js

@@ -137,6 +137,7 @@ module.exports = (() => {
 			this._dataActual.marketChange = null;
 			this._dataActual.marketChangePercent = null;
 			this._dataActual.cashTotal = null;
+			this._dataActual.totalDivisor = null;
 			this._dataActual.periodDivisorCurrent = null;
 			this._dataActual.periodDivisorPrevious = null;
 			this._dataActual.periodDivisorPrevious2 = null;
@@ -183,10 +184,12 @@ module.exports = (() => {
 			this._dataFormat.periodRealized = null;
 			this._dataFormat.periodUnrealized = null;
 
+			this._dataActual.totalPercent = null;
 			this._dataActual.periodPercent = null;
 			this._dataActual.periodPercentPrevious = null;
 			this._dataActual.periodPercentPrevious2 = null;
 
+			this._dataFormat.totalPercent = null;
 			this._dataFormat.periodPercent = null;
 			this._dataFormat.periodPercentPrevious = null;
 			this._dataFormat.periodPercentPrevious2 = null;
@@ -695,6 +698,7 @@ module.exports = (() => {
 				updates.cashTotal = updates.cashTotal.add(translate(item, item.data.market));
 			}
 
+			updates.totalDivisor = updates.periodDivisorCurrent.add(translate(item, item.data.totalDivisor));
 			updates.periodDivisorCurrent = updates.periodDivisorCurrent.add(translate(item, item.data.periodDivisor));
 			updates.periodDivisorPrevious = updates.periodDivisorPrevious.add(translate(item, item.data.periodDivisorPrevious));
 			updates.periodDivisorPrevious2 = updates.periodDivisorPrevious2.add(translate(item, item.data.periodDivisorPrevious2));
@@ -714,6 +718,7 @@ module.exports = (() => {
 			periodUnrealized: Decimal.ZERO,
 			periodIncome: Decimal.ZERO,
 			cashTotal: Decimal.ZERO,
+			totalDivisor: Decimal.ZERO,
 			periodDivisorCurrent: Decimal.ZERO,
 			periodDivisorPrevious: Decimal.ZERO,
 			periodDivisorPrevious2: Decimal.ZERO
@@ -732,6 +737,7 @@ module.exports = (() => {
 		actual.periodUnrealized = updates.periodUnrealized;
 		actual.periodIncome = updates.periodIncome;
 		actual.cashTotal = updates.cashTotal;
+		actual.totalDivisor = updates.totalDivisor;
 		actual.periodDivisorCurrent = updates.periodDivisorCurrent;
 		actual.periodDivisorPrevious = updates.periodDivisorPrevious;
 		actual.periodDivisorPrevious2 = updates.periodDivisorPrevious2;
@@ -755,6 +761,14 @@ module.exports = (() => {
 
 		calculateUnrealizedPercent(group);
 
+		actual.periodPercent = calculateGainPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
+		actual.periodPercentPrevious = calculateGainPercent(actual.summaryTotalPrevious, actual.periodDivisorPrevious);
+		actual.periodPercentPrevious2 = calculateGainPercent(actual.summaryTotalPrevious2, actual.periodDivisorPrevious2);
+
+		format.periodPercent = formatPercent(actual.periodPercent, 2);
+		format.periodPercentPrevious = formatPercent(actual.periodPercentPrevious, 2);
+		format.periodPercentPrevious2 = formatPercent(actual.periodPercentPrevious2, 2);
+
 		const groupItems = group._items;
 
 		if (group.single && groupItems.length === 1) {
@@ -762,28 +776,20 @@ module.exports = (() => {
 
 			actual.quantity = item.data.quantity;
 			actual.quantityPrevious = item.data.quantityPrevious;
-			
-			actual.basisPrice = item.data.basisPrice;
-
-			actual.periodPrice = item.data.periodPrice;
-			actual.periodPricePrevious = item.data.periodPricePrevious;
 
 			format.quantity = formatDecimal(actual.quantity, 2);
 			format.quantityPrevious = formatDecimal(actual.quantityPrevious, 2);
 
+			actual.basisPrice = item.data.basisPrice;
+
 			format.basisPrice = formatCurrency(actual.basisPrice, currency);
 
+			actual.periodPrice = item.data.periodPrice;
+			actual.periodPricePrevious = item.data.periodPricePrevious;
+
 			format.periodPrice = formatCurrency(actual.periodPrice, currency);
 			format.periodPricePrevious = formatCurrency(actual.periodPricePrevious, currency);
 
-			actual.periodPercent = calculatePeriodPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
-			actual.periodPercentPrevious = calculatePeriodPercent(actual.summaryTotalPrevious, actual.periodDivisorPrevious);
-			actual.periodPercentPrevious2 = calculatePeriodPercent(actual.summaryTotalPrevious2, actual.periodDivisorPrevious2);
-
-			format.periodPercent = formatPercent(actual.periodPercent, 2);
-			format.periodPercentPrevious = formatPercent(actual.periodPercentPrevious, 2);
-			format.periodPercentPrevious2 = formatPercent(actual.periodPercentPrevious2, 2);
-
 			format.invalid = definition.type === PositionLevelType.POSITION && item.invalid;
 			format.locked = definition.type === PositionLevelType.POSITION && item.data.locked;
 		}
@@ -864,7 +870,9 @@ module.exports = (() => {
 		actual.unrealized = updates.unrealized;
 		actual.unrealizedToday = updates.unrealizedToday;
 		actual.summaryTotalCurrent = updates.summaryTotalCurrent;
+
 		actual.total = updates.unrealized.add(actual.realized).add(actual.income);
+		actual.totalPercent = calculateGainPercent(actual.total, actual.totalDivisor);
 
 		let marketChange = updates.market.subtract(actual.marketPrevious);
 		let marketChangePercent;
@@ -902,17 +910,18 @@ module.exports = (() => {
 
 		format.total = formatCurrency(actual.total, currency);
 		format.totalNegative = actual.total.getIsNegative();
+		format.totalPercent = formatPercent(actual.totalPercent, 2);
 
 		format.marketChange = formatCurrency(actual.marketChange, currency);
 		format.marketChangePercent = formatPercent(actual.marketChangePercent, 2);
 
 		calculateUnrealizedPercent(group);
 
+		actual.periodPercent = calculateGainPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
+		format.periodPercent = formatPercent(actual.periodPercent, 2);
+
 		if (group.single && item) {
 			actual.periodUnrealized = item.data.periodUnrealized;
-
-			actual.periodPercent = calculatePeriodPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
-			format.periodPercent = formatPercent(actual.periodPercent, 2);
 		}
 	}
 
@@ -972,8 +981,8 @@ module.exports = (() => {
 		}
 	}
 
-	function calculatePeriodPercent(periodSummaryTotal, periodDivisor) {
-		return periodDivisor.getIsZero() ? Decimal.ZERO : periodSummaryTotal.divide(periodDivisor);
+	function calculateGainPercent(gain, basis) {
+		return basis.getIsZero() ? Decimal.ZERO : gain.divide(basis);
 	}
 
 	const unchanged = { up: false, down: false };

package/lib/processing/PositionItem.js

@@ -94,6 +94,8 @@ module.exports = (() => {
 
 			this._data.initiate = null;
 
+			this._data.totalDivisor = null;
+
 			this._data.newsExists = false;
 			this._data.fundamental = { };
 			this._data.locked = getIsLocked(position);
@@ -422,13 +424,13 @@ module.exports = (() => {
 		data.periodRealized = currentSummary !== null ? currentSummary.period.realized : Decimal.ZERO;
 		data.periodUnrealized = currentSummary !== null ? currentSummary.period.unrealized : Decimal.ZERO;
 
-		data.periodGain = calculatePeriodGain(data.initiate, currentSummary, previousSummary1);
-		data.periodGainPrevious = calculatePeriodGain(data.initiate, previousSummary1, previousSummary2);
-		data.periodGainPrevious2 = calculatePeriodGain(data.initiate, previousSummary2, previousSummary3);
+		data.periodGain = calculatePeriodGain(position.instrument.type, data.initiate, currentSummary, previousSummary1);
+		data.periodGainPrevious = calculatePeriodGain(position.instrument.type, data.initiate, previousSummary1, previousSummary2);
+		data.periodGainPrevious2 = calculatePeriodGain(position.instrument.type, data.initiate, previousSummary2, previousSummary3);
 
-		data.periodDivisor = calculatePeriodDivisor(data.initiate, currentSummary, previousSummary1);
-		data.periodDivisorPrevious = calculatePeriodDivisor(data.initiate, previousSummary1, previousSummary2);
-		data.periodDivisorPrevious2 = calculatePeriodDivisor(data.initiate, previousSummary2, previousSummary3);
+		data.periodDivisor = calculatePeriodDivisor(position.instrument.type, data.initiate, currentSummary, previousSummary1);
+		data.periodDivisorPrevious = calculatePeriodDivisor(position.instrument.type, data.initiate, previousSummary1, previousSummary2);
+		data.periodDivisorPrevious2 = calculatePeriodDivisor(position.instrument.type, data.initiate, previousSummary2, previousSummary3);
 
 		if (snapshot.open.getIsZero()) {
 			data.basisPrice = Decimal.ZERO;
@@ -447,6 +449,8 @@ module.exports = (() => {
 		} else {
 			data.periodPricePrevious = null;
 		}
+
+		data.totalDivisor = calculateTotalDivisor(position.instrument.type, data.initiate, currentSummary);
 	}
 
 	function calculatePriceData(item, price) {
@@ -540,7 +544,7 @@ module.exports = (() => {
 				data.unrealized = unrealized;
 				data.unrealizedChange = unrealizedChange;
 
-				let periodGain = calculatePeriodGain(data.initiate, currentSummary, previousSummary, priceToUse);
+				let periodGain = calculatePeriodGain(position.instrument.type, data.initiate, currentSummary, previousSummary, priceToUse);
 				let periodGainChange;
 
 				if (data.periodGain !== null) {
@@ -585,10 +589,10 @@ module.exports = (() => {
 		return direction || PositionDirection.LONG;
 	}
 
-	function calculatePeriodGain(direction, currentSummary, previousSummary, overridePrice) {
+	function calculatePeriodGain(type, direction, currentSummary, previousSummary, overridePrice) {
 		let returnRef;
 
-		if (currentSummary) {
+		if (currentSummary && type !== InstrumentType.CASH) {
 			let startValue;
 
 			if (previousSummary) {
@@ -617,10 +621,10 @@ module.exports = (() => {
 		return returnRef;
 	}
 
-	function calculatePeriodDivisor(direction, currentSummary, previousSummary) {
+	function calculatePeriodDivisor(type, direction, currentSummary, previousSummary) {
 		let returnRef;
 
-		if (currentSummary) {
+		if (currentSummary && type !== InstrumentType.CASH) {
 			let startValue;
 
 			if (previousSummary) {
@@ -641,6 +645,22 @@ module.exports = (() => {
 		return returnRef;
 	}
 
+	function calculateTotalDivisor(type, direction, finalSummary) {
+		let returnRef;
+
+		if (finalSummary && type !== InstrumentType.CASH) {
+			if (direction === PositionDirection.SHORT) {
+				returnRef = finalSummary.period.sells;
+			} else {
+				returnRef = finalSummary.period.buys.opposite();
+			}
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
 	function getPreviousSummary(previousSummaries, count) {
 		const index = previousSummaries.length - count;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barchart/portfolio-api-common",
-  "version": "1.2.139",
+  "version": "1.2.143",
   "description": "Common classes used by the Portfolio system",
   "author": {
     "name": "Bryan Ingle",

package/test/SpecRunner.js

@@ -2659,6 +2659,7 @@ module.exports = (() => {
 			this._dataActual.marketChange = null;
 			this._dataActual.marketChangePercent = null;
 			this._dataActual.cashTotal = null;
+			this._dataActual.totalDivisor = null;
 			this._dataActual.periodDivisorCurrent = null;
 			this._dataActual.periodDivisorPrevious = null;
 			this._dataActual.periodDivisorPrevious2 = null;
@@ -2705,10 +2706,12 @@ module.exports = (() => {
 			this._dataFormat.periodRealized = null;
 			this._dataFormat.periodUnrealized = null;
 
+			this._dataActual.totalPercent = null;
 			this._dataActual.periodPercent = null;
 			this._dataActual.periodPercentPrevious = null;
 			this._dataActual.periodPercentPrevious2 = null;
 
+			this._dataFormat.totalPercent = null;
 			this._dataFormat.periodPercent = null;
 			this._dataFormat.periodPercentPrevious = null;
 			this._dataFormat.periodPercentPrevious2 = null;
@@ -3217,6 +3220,7 @@ module.exports = (() => {
 				updates.cashTotal = updates.cashTotal.add(translate(item, item.data.market));
 			}
 
+			updates.totalDivisor = updates.periodDivisorCurrent.add(translate(item, item.data.totalDivisor));
 			updates.periodDivisorCurrent = updates.periodDivisorCurrent.add(translate(item, item.data.periodDivisor));
 			updates.periodDivisorPrevious = updates.periodDivisorPrevious.add(translate(item, item.data.periodDivisorPrevious));
 			updates.periodDivisorPrevious2 = updates.periodDivisorPrevious2.add(translate(item, item.data.periodDivisorPrevious2));
@@ -3236,6 +3240,7 @@ module.exports = (() => {
 			periodUnrealized: Decimal.ZERO,
 			periodIncome: Decimal.ZERO,
 			cashTotal: Decimal.ZERO,
+			totalDivisor: Decimal.ZERO,
 			periodDivisorCurrent: Decimal.ZERO,
 			periodDivisorPrevious: Decimal.ZERO,
 			periodDivisorPrevious2: Decimal.ZERO
@@ -3254,6 +3259,7 @@ module.exports = (() => {
 		actual.periodUnrealized = updates.periodUnrealized;
 		actual.periodIncome = updates.periodIncome;
 		actual.cashTotal = updates.cashTotal;
+		actual.totalDivisor = updates.totalDivisor;
 		actual.periodDivisorCurrent = updates.periodDivisorCurrent;
 		actual.periodDivisorPrevious = updates.periodDivisorPrevious;
 		actual.periodDivisorPrevious2 = updates.periodDivisorPrevious2;
@@ -3277,6 +3283,14 @@ module.exports = (() => {
 
 		calculateUnrealizedPercent(group);
 
+		actual.periodPercent = calculateGainPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
+		actual.periodPercentPrevious = calculateGainPercent(actual.summaryTotalPrevious, actual.periodDivisorPrevious);
+		actual.periodPercentPrevious2 = calculateGainPercent(actual.summaryTotalPrevious2, actual.periodDivisorPrevious2);
+
+		format.periodPercent = formatPercent(actual.periodPercent, 2);
+		format.periodPercentPrevious = formatPercent(actual.periodPercentPrevious, 2);
+		format.periodPercentPrevious2 = formatPercent(actual.periodPercentPrevious2, 2);
+
 		const groupItems = group._items;
 
 		if (group.single && groupItems.length === 1) {
@@ -3284,28 +3298,20 @@ module.exports = (() => {
 
 			actual.quantity = item.data.quantity;
 			actual.quantityPrevious = item.data.quantityPrevious;
-			
-			actual.basisPrice = item.data.basisPrice;
-
-			actual.periodPrice = item.data.periodPrice;
-			actual.periodPricePrevious = item.data.periodPricePrevious;
 
 			format.quantity = formatDecimal(actual.quantity, 2);
 			format.quantityPrevious = formatDecimal(actual.quantityPrevious, 2);
 
+			actual.basisPrice = item.data.basisPrice;
+
 			format.basisPrice = formatCurrency(actual.basisPrice, currency);
 
+			actual.periodPrice = item.data.periodPrice;
+			actual.periodPricePrevious = item.data.periodPricePrevious;
+
 			format.periodPrice = formatCurrency(actual.periodPrice, currency);
 			format.periodPricePrevious = formatCurrency(actual.periodPricePrevious, currency);
 
-			actual.periodPercent = calculatePeriodPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
-			actual.periodPercentPrevious = calculatePeriodPercent(actual.summaryTotalPrevious, actual.periodDivisorPrevious);
-			actual.periodPercentPrevious2 = calculatePeriodPercent(actual.summaryTotalPrevious2, actual.periodDivisorPrevious2);
-
-			format.periodPercent = formatPercent(actual.periodPercent, 2);
-			format.periodPercentPrevious = formatPercent(actual.periodPercentPrevious, 2);
-			format.periodPercentPrevious2 = formatPercent(actual.periodPercentPrevious2, 2);
-
 			format.invalid = definition.type === PositionLevelType.POSITION && item.invalid;
 			format.locked = definition.type === PositionLevelType.POSITION && item.data.locked;
 		}
@@ -3386,7 +3392,9 @@ module.exports = (() => {
 		actual.unrealized = updates.unrealized;
 		actual.unrealizedToday = updates.unrealizedToday;
 		actual.summaryTotalCurrent = updates.summaryTotalCurrent;
+
 		actual.total = updates.unrealized.add(actual.realized).add(actual.income);
+		actual.totalPercent = calculateGainPercent(actual.total, actual.totalDivisor);
 
 		let marketChange = updates.market.subtract(actual.marketPrevious);
 		let marketChangePercent;
@@ -3424,17 +3432,18 @@ module.exports = (() => {
 
 		format.total = formatCurrency(actual.total, currency);
 		format.totalNegative = actual.total.getIsNegative();
+		format.totalPercent = formatPercent(actual.totalPercent, 2);
 
 		format.marketChange = formatCurrency(actual.marketChange, currency);
 		format.marketChangePercent = formatPercent(actual.marketChangePercent, 2);
 
 		calculateUnrealizedPercent(group);
 
+		actual.periodPercent = calculateGainPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
+		format.periodPercent = formatPercent(actual.periodPercent, 2);
+
 		if (group.single && item) {
 			actual.periodUnrealized = item.data.periodUnrealized;
-
-			actual.periodPercent = calculatePeriodPercent(actual.summaryTotalCurrent, actual.periodDivisorCurrent);
-			format.periodPercent = formatPercent(actual.periodPercent, 2);
 		}
 	}
 
@@ -3494,8 +3503,8 @@ module.exports = (() => {
 		}
 	}
 
-	function calculatePeriodPercent(periodSummaryTotal, periodDivisor) {
-		return periodDivisor.getIsZero() ? Decimal.ZERO : periodSummaryTotal.divide(periodDivisor);
+	function calculateGainPercent(gain, basis) {
+		return basis.getIsZero() ? Decimal.ZERO : gain.divide(basis);
 	}
 
 	const unchanged = { up: false, down: false };
@@ -3600,6 +3609,8 @@ module.exports = (() => {
 
 			this._data.initiate = null;
 
+			this._data.totalDivisor = null;
+
 			this._data.newsExists = false;
 			this._data.fundamental = { };
 			this._data.locked = getIsLocked(position);
@@ -3928,13 +3939,13 @@ module.exports = (() => {
 		data.periodRealized = currentSummary !== null ? currentSummary.period.realized : Decimal.ZERO;
 		data.periodUnrealized = currentSummary !== null ? currentSummary.period.unrealized : Decimal.ZERO;
 
-		data.periodGain = calculatePeriodGain(data.initiate, currentSummary, previousSummary1);
-		data.periodGainPrevious = calculatePeriodGain(data.initiate, previousSummary1, previousSummary2);
-		data.periodGainPrevious2 = calculatePeriodGain(data.initiate, previousSummary2, previousSummary3);
+		data.periodGain = calculatePeriodGain(position.instrument.type, data.initiate, currentSummary, previousSummary1);
+		data.periodGainPrevious = calculatePeriodGain(position.instrument.type, data.initiate, previousSummary1, previousSummary2);
+		data.periodGainPrevious2 = calculatePeriodGain(position.instrument.type, data.initiate, previousSummary2, previousSummary3);
 
-		data.periodDivisor = calculatePeriodDivisor(data.initiate, currentSummary, previousSummary1);
-		data.periodDivisorPrevious = calculatePeriodDivisor(data.initiate, previousSummary1, previousSummary2);
-		data.periodDivisorPrevious2 = calculatePeriodDivisor(data.initiate, previousSummary2, previousSummary3);
+		data.periodDivisor = calculatePeriodDivisor(position.instrument.type, data.initiate, currentSummary, previousSummary1);
+		data.periodDivisorPrevious = calculatePeriodDivisor(position.instrument.type, data.initiate, previousSummary1, previousSummary2);
+		data.periodDivisorPrevious2 = calculatePeriodDivisor(position.instrument.type, data.initiate, previousSummary2, previousSummary3);
 
 		if (snapshot.open.getIsZero()) {
 			data.basisPrice = Decimal.ZERO;
@@ -3953,6 +3964,8 @@ module.exports = (() => {
 		} else {
 			data.periodPricePrevious = null;
 		}
+
+		data.totalDivisor = calculateTotalDivisor(position.instrument.type, data.initiate, currentSummary);
 	}
 
 	function calculatePriceData(item, price) {
@@ -4046,7 +4059,7 @@ module.exports = (() => {
 				data.unrealized = unrealized;
 				data.unrealizedChange = unrealizedChange;
 
-				let periodGain = calculatePeriodGain(data.initiate, currentSummary, previousSummary, priceToUse);
+				let periodGain = calculatePeriodGain(position.instrument.type, data.initiate, currentSummary, previousSummary, priceToUse);
 				let periodGainChange;
 
 				if (data.periodGain !== null) {
@@ -4091,10 +4104,10 @@ module.exports = (() => {
 		return direction || PositionDirection.LONG;
 	}
 
-	function calculatePeriodGain(direction, currentSummary, previousSummary, overridePrice) {
+	function calculatePeriodGain(type, direction, currentSummary, previousSummary, overridePrice) {
 		let returnRef;
 
-		if (currentSummary) {
+		if (currentSummary && type !== InstrumentType.CASH) {
 			let startValue;
 
 			if (previousSummary) {
@@ -4123,10 +4136,10 @@ module.exports = (() => {
 		return returnRef;
 	}
 
-	function calculatePeriodDivisor(direction, currentSummary, previousSummary) {
+	function calculatePeriodDivisor(type, direction, currentSummary, previousSummary) {
 		let returnRef;
 
-		if (currentSummary) {
+		if (currentSummary && type !== InstrumentType.CASH) {
 			let startValue;
 
 			if (previousSummary) {
@@ -4147,6 +4160,22 @@ module.exports = (() => {
 		return returnRef;
 	}
 
+	function calculateTotalDivisor(type, direction, finalSummary) {
+		let returnRef;
+
+		if (finalSummary && type !== InstrumentType.CASH) {
+			if (direction === PositionDirection.SHORT) {
+				returnRef = finalSummary.period.sells;
+			} else {
+				returnRef = finalSummary.period.buys.opposite();
+			}
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
 	function getPreviousSummary(previousSummaries, count) {
 		const index = previousSummaries.length - count;