@barchart/portfolio-api-common 1.2.99 → 1.2.103

package/lib/data/PositionSummaryFrame.js

@@ -286,7 +286,7 @@ module.exports = (() => {
 	}
 
 	function getYearlyRangeDescription(start, end) {
-		return `Year ended ${end.year.toString()}`;
+		return `Year ended ${end.format()}`;
 	}
 
 	function getQuarterlyRangeDescription(start, end) {

package/lib/processing/PositionContainer.js

@@ -3,6 +3,7 @@ const array = require('@barchart/common-js/lang/array'),
 	ComparatorBuilder = require('@barchart/common-js/collections/sorting/ComparatorBuilder'),
 	comparators = require('@barchart/common-js/collections/sorting/comparators'),
 	Currency = require('@barchart/common-js/lang/Currency'),
+	Day = require('@barchart/common-js/lang/Day'),
 	Decimal = require('@barchart/common-js/lang/Decimal'),
 	DisposableStack = require('@barchart/common-js/collections/specialized/DisposableStack'),
 	Event = require('@barchart/common-js/messaging/Event'),

package/lib/processing/PositionGroup.js

@@ -166,6 +166,14 @@ module.exports = (() => {
 			this._dataFormat.cashTotal = null;
 			this._dataFormat.portfolioType = null;
 
+			this._dataActual.periodRealized = null;
+			this._dataActual.periodUnrealized = null;
+			this._dataActual.periodIncome = null;
+
+			this._dataFormat.periodRealized = null;
+			this._dataFormat.periodUnrealized = null;
+			this._dataFormat.periodIncome = null;
+
 			this._items.forEach((item) => {
 				bindItem.call(this, item);
 			});
@@ -662,6 +670,10 @@ module.exports = (() => {
 			updates.marketPrevious = updates.marketPrevious.add(translate(item, item.data.marketPrevious));
 			updates.marketPrevious2 = updates.marketPrevious2.add(translate(item, item.data.marketPrevious2));
 
+			updates.periodRealized = updates.periodRealized.add(translate(item, item.data.periodRealized));
+			updates.periodUnrealized = updates.periodUnrealized.add(translate(item, item.data.periodUnrealized));
+			updates.periodIncome = updates.periodIncome.add(translate(item, item.data.periodIncome));
+
 			if (item.position.instrument.type === InstrumentType.CASH) {
 				updates.cashTotal = updates.cashTotal.add(translate(item, item.data.market));
 			}
@@ -677,7 +689,10 @@ module.exports = (() => {
 			summaryTotalPrevious2: Decimal.ZERO,
 			marketPrevious: Decimal.ZERO,
 			marketPrevious2: Decimal.ZERO,
-			cashTotal: Decimal.ZERO
+			periodRealized: Decimal.ZERO,
+			periodUnrealized: Decimal.ZERO,
+			periodIncome: Decimal.ZERO,
+			cashTotal: Decimal.ZERO,
 		});
 
 		actual.basis = updates.basis;

package/lib/processing/PositionItem.js

@@ -78,6 +78,9 @@ module.exports = (() => {
 			this._data.income = null;
 			this._data.basisPrice = null;
 
+			this._data.realizedPeriod = null;
+			this._data.unrealizedPeriod = null;
+
 			this._data.newsExists = false;
 			this._data.fundamental = { };
 			this._data.locked = getIsLocked(position);
@@ -368,8 +371,13 @@ module.exports = (() => {
 	function calculateStaticData(item) {
 		const position = item.position;
 		const snapshot = getSnapshot(position, item.currentSummary, item._reporting);
+
 		const previousSummaries = item.previousSummaries;
 
+		const previousSummary1 = getPreviousSummary(previousSummaries, 1);
+		const previousSummary2 = getPreviousSummary(previousSummaries, 2);
+		const previousSummary3 = getPreviousSummary(previousSummaries, 3);
+
 		const data = item._data;
 
 		data.previousPrice = position.previous || null;
@@ -389,19 +397,18 @@ module.exports = (() => {
 
 		data.income = snapshot.income;
 
-		const previousSummary1 = getPreviousSummary(previousSummaries, 1);
-		const previousSummary2 = getPreviousSummary(previousSummaries, 2);
-		const previousSummary3 = getPreviousSummary(previousSummaries, 3);
-
 		data.summaryTotalCurrent = calculateSummaryTotal(item.currentSummary, previousSummary1);
 		data.summaryTotalPrevious = calculateSummaryTotal(previousSummary1, previousSummary2);
 		data.summaryTotalPrevious2 = calculateSummaryTotal(previousSummary2, previousSummary3);
 
 		data.marketPrevious = previousSummary1 === null ? Decimal.ZERO : previousSummary1.end.value;
 		data.marketPrevious2 = previousSummary2 === null ? Decimal.ZERO : previousSummary2.end.value;
-
 		data.quantityPrevious = previousSummary1 === null ? Decimal.ZERO : previousSummary1.end.open;
 
+		data.periodRealized = calculateRealizedPeriod(item.currentSummary, previousSummary1);
+		data.periodUnrealized = calculateUnrealizedPeriod(item.currentSummary, previousSummary1);
+		data.periodIncome = calculateIncomePeriod(item.currentSummary, previousSummary1);
+
 		if (snapshot.open.getIsZero()) {
 			data.basisPrice = Decimal.ZERO;
 		} else {
@@ -543,6 +550,48 @@ module.exports = (() => {
 		return returnRef;
 	}
 
+	function calculateRealizedPeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.unrealized;
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
+	function calculateUnrealizedPeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.unrealized.subtract(previousSummary !== null ? previousSummary.period.unrealized : Decimal.ZERO);
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
+	function calculateIncomePeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.income;
+		} 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.99",
+  "version": "1.2.103",
   "description": "Common classes used by the Portfolio system",
   "author": {
     "name": "Bryan Ingle",

package/test/SpecRunner.js

@@ -677,7 +677,7 @@ module.exports = (() => {
 	}
 
 	function getYearlyRangeDescription(start, end) {
-		return `Year ended ${end.year.toString()}`;
+		return `Year ended ${end.format()}`;
 	}
 
 	function getQuarterlyRangeDescription(start, end) {
@@ -1427,6 +1427,7 @@ const array = require('@barchart/common-js/lang/array'),
 	ComparatorBuilder = require('@barchart/common-js/collections/sorting/ComparatorBuilder'),
 	comparators = require('@barchart/common-js/collections/sorting/comparators'),
 	Currency = require('@barchart/common-js/lang/Currency'),
+	Day = require('@barchart/common-js/lang/Day'),
 	Decimal = require('@barchart/common-js/lang/Decimal'),
 	DisposableStack = require('@barchart/common-js/collections/specialized/DisposableStack'),
 	Event = require('@barchart/common-js/messaging/Event'),
@@ -2440,7 +2441,7 @@ module.exports = (() => {
 	return PositionContainer;
 })();
 
-},{"./../data/PositionSummaryFrame":3,"./PositionGroup":7,"./PositionItem":8,"./definitions/PositionLevelDefinition":9,"./definitions/PositionLevelType":10,"./definitions/PositionTreeDefinition":11,"@barchart/common-js/collections/Tree":15,"@barchart/common-js/collections/sorting/ComparatorBuilder":16,"@barchart/common-js/collections/sorting/comparators":17,"@barchart/common-js/collections/specialized/DisposableStack":18,"@barchart/common-js/lang/Currency":20,"@barchart/common-js/lang/Decimal":22,"@barchart/common-js/lang/Rate":26,"@barchart/common-js/lang/array":28,"@barchart/common-js/lang/assert":29,"@barchart/common-js/lang/is":33,"@barchart/common-js/messaging/Event":35}],7:[function(require,module,exports){
+},{"./../data/PositionSummaryFrame":3,"./PositionGroup":7,"./PositionItem":8,"./definitions/PositionLevelDefinition":9,"./definitions/PositionLevelType":10,"./definitions/PositionTreeDefinition":11,"@barchart/common-js/collections/Tree":15,"@barchart/common-js/collections/sorting/ComparatorBuilder":16,"@barchart/common-js/collections/sorting/comparators":17,"@barchart/common-js/collections/specialized/DisposableStack":18,"@barchart/common-js/lang/Currency":20,"@barchart/common-js/lang/Day":21,"@barchart/common-js/lang/Decimal":22,"@barchart/common-js/lang/Rate":26,"@barchart/common-js/lang/array":28,"@barchart/common-js/lang/assert":29,"@barchart/common-js/lang/is":33,"@barchart/common-js/messaging/Event":35}],7:[function(require,module,exports){
 const array = require('@barchart/common-js/lang/array'),
 	assert = require('@barchart/common-js/lang/assert'),
 	Currency = require('@barchart/common-js/lang/Currency'),
@@ -2609,6 +2610,14 @@ module.exports = (() => {
 			this._dataFormat.cashTotal = null;
 			this._dataFormat.portfolioType = null;
 
+			this._dataActual.periodRealized = null;
+			this._dataActual.periodUnrealized = null;
+			this._dataActual.periodIncome = null;
+
+			this._dataFormat.periodRealized = null;
+			this._dataFormat.periodUnrealized = null;
+			this._dataFormat.periodIncome = null;
+
 			this._items.forEach((item) => {
 				bindItem.call(this, item);
 			});
@@ -3105,6 +3114,10 @@ module.exports = (() => {
 			updates.marketPrevious = updates.marketPrevious.add(translate(item, item.data.marketPrevious));
 			updates.marketPrevious2 = updates.marketPrevious2.add(translate(item, item.data.marketPrevious2));
 
+			updates.periodRealized = updates.periodRealized.add(translate(item, item.data.periodRealized));
+			updates.periodUnrealized = updates.periodUnrealized.add(translate(item, item.data.periodUnrealized));
+			updates.periodIncome = updates.periodIncome.add(translate(item, item.data.periodIncome));
+
 			if (item.position.instrument.type === InstrumentType.CASH) {
 				updates.cashTotal = updates.cashTotal.add(translate(item, item.data.market));
 			}
@@ -3120,7 +3133,10 @@ module.exports = (() => {
 			summaryTotalPrevious2: Decimal.ZERO,
 			marketPrevious: Decimal.ZERO,
 			marketPrevious2: Decimal.ZERO,
-			cashTotal: Decimal.ZERO
+			periodRealized: Decimal.ZERO,
+			periodUnrealized: Decimal.ZERO,
+			periodIncome: Decimal.ZERO,
+			cashTotal: Decimal.ZERO,
 		});
 
 		actual.basis = updates.basis;
@@ -3431,6 +3447,9 @@ module.exports = (() => {
 			this._data.income = null;
 			this._data.basisPrice = null;
 
+			this._data.realizedPeriod = null;
+			this._data.unrealizedPeriod = null;
+
 			this._data.newsExists = false;
 			this._data.fundamental = { };
 			this._data.locked = getIsLocked(position);
@@ -3721,8 +3740,13 @@ module.exports = (() => {
 	function calculateStaticData(item) {
 		const position = item.position;
 		const snapshot = getSnapshot(position, item.currentSummary, item._reporting);
+
 		const previousSummaries = item.previousSummaries;
 
+		const previousSummary1 = getPreviousSummary(previousSummaries, 1);
+		const previousSummary2 = getPreviousSummary(previousSummaries, 2);
+		const previousSummary3 = getPreviousSummary(previousSummaries, 3);
+
 		const data = item._data;
 
 		data.previousPrice = position.previous || null;
@@ -3742,19 +3766,18 @@ module.exports = (() => {
 
 		data.income = snapshot.income;
 
-		const previousSummary1 = getPreviousSummary(previousSummaries, 1);
-		const previousSummary2 = getPreviousSummary(previousSummaries, 2);
-		const previousSummary3 = getPreviousSummary(previousSummaries, 3);
-
 		data.summaryTotalCurrent = calculateSummaryTotal(item.currentSummary, previousSummary1);
 		data.summaryTotalPrevious = calculateSummaryTotal(previousSummary1, previousSummary2);
 		data.summaryTotalPrevious2 = calculateSummaryTotal(previousSummary2, previousSummary3);
 
 		data.marketPrevious = previousSummary1 === null ? Decimal.ZERO : previousSummary1.end.value;
 		data.marketPrevious2 = previousSummary2 === null ? Decimal.ZERO : previousSummary2.end.value;
-
 		data.quantityPrevious = previousSummary1 === null ? Decimal.ZERO : previousSummary1.end.open;
 
+		data.periodRealized = calculateRealizedPeriod(item.currentSummary, previousSummary1);
+		data.periodUnrealized = calculateUnrealizedPeriod(item.currentSummary, previousSummary1);
+		data.periodIncome = calculateIncomePeriod(item.currentSummary, previousSummary1);
+
 		if (snapshot.open.getIsZero()) {
 			data.basisPrice = Decimal.ZERO;
 		} else {
@@ -3896,6 +3919,48 @@ module.exports = (() => {
 		return returnRef;
 	}
 
+	function calculateRealizedPeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.unrealized;
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
+	function calculateUnrealizedPeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.unrealized.subtract(previousSummary !== null ? previousSummary.period.unrealized : Decimal.ZERO);
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
+	function calculateIncomePeriod(currentSummary, previousSummary) {
+		let returnRef;
+
+		if (currentSummary) {
+			const period = currentSummary.period;
+
+			returnRef = period.income;
+		} else {
+			returnRef = Decimal.ZERO;
+		}
+
+		return returnRef;
+	}
+
 	function getPreviousSummary(previousSummaries, count) {
 		const index = previousSummaries.length - count;
 
@@ -6185,11 +6250,12 @@ module.exports = function () {
 			}
 
 			/**
-    * Clones a {@link Day} instance.
+    * Converts a string (which matches the output of {@link Day#format} into
+    * a {@link Day} instance.
     *
     * @public
     * @static
-    * @param {Day} value
+    * @param {String} value
     * @returns {Day}
     */
 
@@ -6230,24 +6296,6 @@ module.exports = function () {
 				return this._day;
 			}
 		}], [{
-			key: 'clone',
-			value: function clone(value) {
-				assert.argumentIsRequired(value, 'value', Day, 'Day');
-
-				return new Day(value.year, value.month, value.day);
-			}
-
-			/**
-    * Converts a string (which matches the output of {@link Day#format} into
-    * a {@link Day} instance.
-    *
-    * @public
-    * @static
-    * @param {String} value
-    * @returns {Day}
-    */
-
-		}, {
 			key: 'parse',
 			value: function parse(value) {
 				assert.argumentIsRequired(value, 'value', String);
@@ -6564,17 +6612,15 @@ module.exports = function () {
     *
     * @public
     * @param {Boolean=} approximate
-    * @param {Number=} places
     * @returns {Boolean}
     */
 
 		}, {
 			key: 'getIsZero',
-			value: function getIsZero(approximate, places) {
+			value: function getIsZero(approximate) {
 				assert.argumentIsOptional(approximate, 'approximate', Boolean);
-				assert.argumentIsOptional(places, 'places', Number);
 
-				return this._big.eq(zero) || is.boolean(approximate) && approximate && this.round(places || Big.DP, RoundingMode.NORMAL).getIsZero();
+				return this._big.eq(zero) || is.boolean(approximate) && approximate && this.round(20, RoundingMode.NORMAL).getIsZero();
 			}
 
 			/**
@@ -6673,43 +6719,6 @@ module.exports = function () {
 				return this._big.eq(getBig(other));
 			}
 
-			/**
-    * Returns true if the current instance is an integer (i.e. has no decimal
-    * component).
-    *
-    * @public
-    * @return {Boolean}
-    */
-
-		}, {
-			key: 'getIsInteger',
-			value: function getIsInteger() {
-				return this.getIsEqual(this.round(0));
-			}
-
-			/**
-    * Returns the number of decimal places used.
-    *
-    * @public
-    * @returns {Number}
-    */
-
-		}, {
-			key: 'getDecimalPlaces',
-			value: function getDecimalPlaces() {
-				var matches = this.toFixed().match(/-?\d*\.(\d*)/);
-
-				var returnVal = void 0;
-
-				if (matches === null) {
-					returnVal = 0;
-				} else {
-					returnVal = matches[1].length;
-				}
-
-				return returnVal;
-			}
-
 			/**
     * Emits a floating point value that approximates the value of the current
     * instance.
@@ -6758,11 +6767,10 @@ module.exports = function () {
 			}
 
 			/**
-    * Clones a {@link Decimal} instance.
+    * Parses the value emitted by {@link Decimal#toJSON}.
     *
     * @public
-    * @static
-    * @param {Decimal} value
+    * @param {String} value
     * @returns {Decimal}
     */
 
@@ -6772,22 +6780,6 @@ module.exports = function () {
 				return '[Decimal]';
 			}
 		}], [{
-			key: 'clone',
-			value: function clone(value) {
-				assert.argumentIsRequired(value, 'value', Decimal, 'Decimal');
-
-				return new Decimal(value._big);
-			}
-
-			/**
-    * Parses the value emitted by {@link Decimal#toJSON}.
-    *
-    * @public
-    * @param {String} value
-    * @returns {Decimal}
-    */
-
-		}, {
 			key: 'parse',
 			value: function parse(value) {
 				return new Decimal(value);
@@ -7809,11 +7801,10 @@ module.exports = function () {
 			}
 
 			/**
-    * Clones a {@link Timestamp} instance.
+    * Parses the value emitted by {@link Timestamp#toJSON}.
     *
     * @public
-    * @static
-    * @param {Timestamp} value
+    * @param {Number} value
     * @returns {Timestamp}
     */
 
@@ -7849,22 +7840,6 @@ module.exports = function () {
 				return this._moment;
 			}
 		}], [{
-			key: 'clone',
-			value: function clone(value) {
-				assert.argumentIsRequired(value, 'value', Timestamp, 'Timestamp');
-
-				return new Timestamp(value._timestamp, value._timezone);
-			}
-
-			/**
-    * Parses the value emitted by {@link Timestamp#toJSON}.
-    *
-    * @public
-    * @param {Number} value
-    * @returns {Timestamp}
-    */
-
-		}, {
 			key: 'parse',
 			value: function parse(value) {
 				return new Timestamp(value);