@barchart/portfolio-api-common 1.2.74 → 1.2.78

package/lib/processing/PositionContainer.js

@@ -6,6 +6,7 @@ const array = require('@barchart/common-js/lang/array'),
 	Decimal = require('@barchart/common-js/lang/Decimal'),
 	DisposableStack = require('@barchart/common-js/collections/specialized/DisposableStack'),
 	Event = require('@barchart/common-js/messaging/Event'),
+	is = require('@barchart/common-js/lang/array'),
 	Rate = require('@barchart/common-js/lang/Rate'),
 	Tree = require('@barchart/common-js/collections/Tree');
 
@@ -370,6 +371,21 @@ module.exports = (() => {
 			return array.unique(symbols);
 		}
 
+		setPositionLock(position) {
+			if (position) {
+				assert.argumentIsRequired(position, 'position', Object);
+				assert.argumentIsRequired(position.position, 'position.position', String);
+
+				const item = this._items.find((i) => i.position.position === position.position);
+
+				if (item) {
+					const locked = is.object(position.system) && is.boolean(position.system.locked) && position.system.locked;
+
+					item.setPositionLock(locked);
+				}
+			}
+		}
+
 		/**
 		 * Performs a batch update of both position quotes and forex quotes,
 		 * triggering updates to position(s) and data aggregation(s).
@@ -717,6 +733,8 @@ module.exports = (() => {
 					});
 				}
 			}
+
+			recalculatePercentages.call(this);
 		}));
 	}
 

package/lib/processing/PositionGroup.js

@@ -72,6 +72,7 @@ module.exports = (() => {
 			this._dataFormat.description = this._description;
 			this._dataFormat.hide = false;
 			this._dataFormat.invalid = false;
+			this._dataFormat.locked = false;
 			this._dataFormat.newsExists = false;
 			this._dataFormat.quantity = null;
 			this._dataFormat.basisPrice = null;
@@ -541,12 +542,17 @@ module.exports = (() => {
 		});
 
 		let newsBinding = Disposable.getEmpty();
+		let lockedBinding = Disposable.getEmpty();
 
 		if (this._single) {
 			newsBinding = item.registerNewsExistsChangeHandler((exists) => {
 				this._dataActual.newsExists = exists;
 				this._dataFormat.newsExists = exists;
 			});
+
+			lockedBinding = item.registerLockChangeHandler((locked) => {
+				this._dataFormat.locked = locked;
+			});
 		}
 
 		this._disposeStack.push(item.registerPortfolioChangeHandler((portfolio) => {
@@ -558,14 +564,16 @@ module.exports = (() => {
 			this._dataFormat.description = this._description;
 		}));
 
+		this._disposeStack.push(fundamentalBinding);
 		this._disposeStack.push(quoteBinding);
+		this._disposeStack.push(lockedBinding);
 		this._disposeStack.push(newsBinding);
-		this._disposeStack.push(fundamentalBinding);
 
 		this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
+			fundamentalBinding.dispose();
 			quoteBinding.dispose();
 			newsBinding.dispose();
-			fundamentalBinding.dispose();
+			lockedBinding.dispose();
 
 			array.remove(this._items, i => i === item);
 			array.remove(this._excludedItems, i => i === item);
@@ -692,6 +700,7 @@ module.exports = (() => {
 			format.basisPrice = formatCurrency(actual.basisPrice, currency);
 
 			format.invalid = definition.type === PositionLevelType.POSITION && item.invalid;
+			format.locked = definition.type === PositionLevelType.POSITION && item.data.locked;
 		}
 
 		const groupItems = group._items;

package/lib/processing/PositionItem.js

@@ -70,13 +70,15 @@ module.exports = (() => {
 
 			this._data.newsExists = false;
 			this._data.fundamental = { };
+			this._data.locked = is.object(position.system) && is.boolean(position.system.locked) && position.system.locked;
 
 			calculateStaticData(this);
 			calculatePriceData(this, null);
 
 			this._quoteChangedEvent = new Event(this);
 			this._newsExistsChangedEvent = new Event(this);
-			this._fundamentalDataChangeEvent = new Event(this);
+			this._fundamentalDataChangedEvent = new Event(this);
+			this._lockChangedEvent = new Event(this);
 			this._portfolioChangedEvent = new Event(this);
 			this._positionItemDisposeEvent = new Event(this);
 		}
@@ -204,6 +206,25 @@ module.exports = (() => {
 			}
 		}
 
+		/**
+		 * Sets a flag which indicates if news article(s) exist for the encapsulated position's
+		 * symbol.
+		 *
+		 * @public
+		 * @param {Boolean} value
+		 */
+		setNewsArticleExists(value) {
+			assert.argumentIsRequired(value, 'value', Boolean);
+
+			if (this.getIsDisposed()) {
+				return;
+			}
+
+			if (this._data.newsExists !== value) {
+				this._newsExistsChangedEvent.fire(this._data.newsExists = value);
+			}
+		}
+
 		/**
 		 * Sets fundamental data for the position.
 		 *
@@ -217,25 +238,24 @@ module.exports = (() => {
 				return;
 			}
 
-			this._fundamentalDataChangeEvent.fire(this._data.fundamental = data);
+			this._fundamentalDataChangedEvent.fire(this._data.fundamental = data);
 		}
 
 		/**
-		 * Sets a flag which indicates if news article(s) exist for the encapsulated position's
-		 * symbol.
+		 * Sets position lock status.
 		 *
 		 * @public
 		 * @param {Boolean} value
 		 */
-		setNewsArticleExists(value) {
+		setPositionLock(value) {
 			assert.argumentIsRequired(value, 'value', Boolean);
 
 			if (this.getIsDisposed()) {
 				return;
 			}
 
-			if (this._data.newsExists !== value) {
-				this._newsExistsChangedEvent.fire(this._data.newsExists = value);
+			if (this._data.locked !== value) {
+				this._lockChangedEvent.fire(this._data.locked = value);
 			}
 		}
 
@@ -251,6 +271,17 @@ module.exports = (() => {
 			return this._quoteChangedEvent.register(handler);
 		}
 
+		/**
+		 * Registers an observer changes to the status of news existence.
+		 *
+		 * @public
+		 * @param {Function} handler
+		 * @returns {Disposable}
+		 */
+		registerNewsExistsChangeHandler(handler) {
+			return this._newsExistsChangedEvent.register(handler);
+		}
+
 		/**
 		 * Registers an observer for fundamental data changes.
 		 *
@@ -259,18 +290,18 @@ module.exports = (() => {
 		 * @returns {Disposable}
 		 */
 		registerFundamentalDataChangeHandler(handler) {
-			return this._fundamentalDataChangeEvent.register(handler);
+			return this._fundamentalDataChangedEvent.register(handler);
 		}
 
 		/**
-		 * Registers an observer changes to the status of news existence.
+		 * Registers an observer for position lock changes.
 		 *
 		 * @public
 		 * @param {Function} handler
 		 * @returns {Disposable}
 		 */
-		registerNewsExistsChangeHandler(handler) {
-			return this._newsExistsChangedEvent.register(handler);
+		registerLockChangeHandler(handler) {
+			return this._lockChangedEvent.register(handler);
 		}
 
 		/**
@@ -300,7 +331,8 @@ module.exports = (() => {
 
 			this._quoteChangedEvent.clear();
 			this._newsExistsChangedEvent.clear();
-			this._fundamentalDataChangeEvent.clear();
+			this._fundamentalDataChangedEvent.clear();
+			this._lockChangedEvent.clear();
 			this._portfolioChangedEvent.clear();
 			this._positionItemDisposeEvent.clear();
 		}

package/package.json

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

package/test/SpecRunner.js

@@ -1385,6 +1385,7 @@ const array = require('@barchart/common-js/lang/array'),
 	Decimal = require('@barchart/common-js/lang/Decimal'),
 	DisposableStack = require('@barchart/common-js/collections/specialized/DisposableStack'),
 	Event = require('@barchart/common-js/messaging/Event'),
+	is = require('@barchart/common-js/lang/array'),
 	Rate = require('@barchart/common-js/lang/Rate'),
 	Tree = require('@barchart/common-js/collections/Tree');
 
@@ -1749,6 +1750,21 @@ module.exports = (() => {
 			return array.unique(symbols);
 		}
 
+		setPositionLock(position) {
+			if (position) {
+				assert.argumentIsRequired(position, 'position', Object);
+				assert.argumentIsRequired(position.position, 'position.position', String);
+
+				const item = this._items.find((i) => i.position.position === position.position);
+
+				if (item) {
+					const locked = is.object(position.system) && is.boolean(position.system.locked) && position.system.locked;
+
+					item.setPositionLock(locked);
+				}
+			}
+		}
+
 		/**
 		 * Performs a batch update of both position quotes and forex quotes,
 		 * triggering updates to position(s) and data aggregation(s).
@@ -2096,6 +2112,8 @@ module.exports = (() => {
 					});
 				}
 			}
+
+			recalculatePercentages.call(this);
 		}));
 	}
 
@@ -2393,6 +2411,7 @@ module.exports = (() => {
 			this._dataFormat.description = this._description;
 			this._dataFormat.hide = false;
 			this._dataFormat.invalid = false;
+			this._dataFormat.locked = false;
 			this._dataFormat.newsExists = false;
 			this._dataFormat.quantity = null;
 			this._dataFormat.basisPrice = null;
@@ -2862,12 +2881,17 @@ module.exports = (() => {
 		});
 
 		let newsBinding = Disposable.getEmpty();
+		let lockedBinding = Disposable.getEmpty();
 
 		if (this._single) {
 			newsBinding = item.registerNewsExistsChangeHandler((exists) => {
 				this._dataActual.newsExists = exists;
 				this._dataFormat.newsExists = exists;
 			});
+
+			lockedBinding = item.registerLockChangeHandler((locked) => {
+				this._dataFormat.locked = locked;
+			});
 		}
 
 		this._disposeStack.push(item.registerPortfolioChangeHandler((portfolio) => {
@@ -2879,14 +2903,16 @@ module.exports = (() => {
 			this._dataFormat.description = this._description;
 		}));
 
+		this._disposeStack.push(fundamentalBinding);
 		this._disposeStack.push(quoteBinding);
+		this._disposeStack.push(lockedBinding);
 		this._disposeStack.push(newsBinding);
-		this._disposeStack.push(fundamentalBinding);
 
 		this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
+			fundamentalBinding.dispose();
 			quoteBinding.dispose();
 			newsBinding.dispose();
-			fundamentalBinding.dispose();
+			lockedBinding.dispose();
 
 			array.remove(this._items, i => i === item);
 			array.remove(this._excludedItems, i => i === item);
@@ -3013,6 +3039,7 @@ module.exports = (() => {
 			format.basisPrice = formatCurrency(actual.basisPrice, currency);
 
 			format.invalid = definition.type === PositionLevelType.POSITION && item.invalid;
+			format.locked = definition.type === PositionLevelType.POSITION && item.data.locked;
 		}
 
 		const groupItems = group._items;
@@ -3251,13 +3278,15 @@ module.exports = (() => {
 
 			this._data.newsExists = false;
 			this._data.fundamental = { };
+			this._data.locked = is.object(position.system) && is.boolean(position.system.locked) && position.system.locked;
 
 			calculateStaticData(this);
 			calculatePriceData(this, null);
 
 			this._quoteChangedEvent = new Event(this);
 			this._newsExistsChangedEvent = new Event(this);
-			this._fundamentalDataChangeEvent = new Event(this);
+			this._fundamentalDataChangedEvent = new Event(this);
+			this._lockChangedEvent = new Event(this);
 			this._portfolioChangedEvent = new Event(this);
 			this._positionItemDisposeEvent = new Event(this);
 		}
@@ -3385,6 +3414,25 @@ module.exports = (() => {
 			}
 		}
 
+		/**
+		 * Sets a flag which indicates if news article(s) exist for the encapsulated position's
+		 * symbol.
+		 *
+		 * @public
+		 * @param {Boolean} value
+		 */
+		setNewsArticleExists(value) {
+			assert.argumentIsRequired(value, 'value', Boolean);
+
+			if (this.getIsDisposed()) {
+				return;
+			}
+
+			if (this._data.newsExists !== value) {
+				this._newsExistsChangedEvent.fire(this._data.newsExists = value);
+			}
+		}
+
 		/**
 		 * Sets fundamental data for the position.
 		 *
@@ -3398,25 +3446,24 @@ module.exports = (() => {
 				return;
 			}
 
-			this._fundamentalDataChangeEvent.fire(this._data.fundamental = data);
+			this._fundamentalDataChangedEvent.fire(this._data.fundamental = data);
 		}
 
 		/**
-		 * Sets a flag which indicates if news article(s) exist for the encapsulated position's
-		 * symbol.
+		 * Sets position lock status.
 		 *
 		 * @public
 		 * @param {Boolean} value
 		 */
-		setNewsArticleExists(value) {
+		setPositionLock(value) {
 			assert.argumentIsRequired(value, 'value', Boolean);
 
 			if (this.getIsDisposed()) {
 				return;
 			}
 
-			if (this._data.newsExists !== value) {
-				this._newsExistsChangedEvent.fire(this._data.newsExists = value);
+			if (this._data.locked !== value) {
+				this._lockChangedEvent.fire(this._data.locked = value);
 			}
 		}
 
@@ -3432,6 +3479,17 @@ module.exports = (() => {
 			return this._quoteChangedEvent.register(handler);
 		}
 
+		/**
+		 * Registers an observer changes to the status of news existence.
+		 *
+		 * @public
+		 * @param {Function} handler
+		 * @returns {Disposable}
+		 */
+		registerNewsExistsChangeHandler(handler) {
+			return this._newsExistsChangedEvent.register(handler);
+		}
+
 		/**
 		 * Registers an observer for fundamental data changes.
 		 *
@@ -3440,18 +3498,18 @@ module.exports = (() => {
 		 * @returns {Disposable}
 		 */
 		registerFundamentalDataChangeHandler(handler) {
-			return this._fundamentalDataChangeEvent.register(handler);
+			return this._fundamentalDataChangedEvent.register(handler);
 		}
 
 		/**
-		 * Registers an observer changes to the status of news existence.
+		 * Registers an observer for position lock changes.
 		 *
 		 * @public
 		 * @param {Function} handler
 		 * @returns {Disposable}
 		 */
-		registerNewsExistsChangeHandler(handler) {
-			return this._newsExistsChangedEvent.register(handler);
+		registerLockChangeHandler(handler) {
+			return this._lockChangedEvent.register(handler);
 		}
 
 		/**
@@ -3481,7 +3539,8 @@ module.exports = (() => {
 
 			this._quoteChangedEvent.clear();
 			this._newsExistsChangedEvent.clear();
-			this._fundamentalDataChangeEvent.clear();
+			this._fundamentalDataChangedEvent.clear();
+			this._lockChangedEvent.clear();
 			this._portfolioChangedEvent.clear();
 			this._positionItemDisposeEvent.clear();
 		}
@@ -5920,12 +5979,11 @@ module.exports = function () {
 			}
 
 			/**
-    * Converts a string (which matches the output of {@link Day#format} into
-    * a {@link Day} instance.
+    * Clones a {@link Day} instance.
     *
     * @public
     * @static
-    * @param {String} value
+    * @param {Day} value
     * @returns {Day}
     */
 
@@ -5966,6 +6024,24 @@ 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);
@@ -6476,10 +6552,11 @@ module.exports = function () {
 			}
 
 			/**
-    * Parses the value emitted by {@link Decimal#toJSON}.
+    * Clones a {@link Decimal} instance.
     *
     * @public
-    * @param {String} value
+    * @static
+    * @param {Decimal} value
     * @returns {Decimal}
     */
 
@@ -6489,6 +6566,22 @@ 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);
@@ -7510,10 +7603,11 @@ module.exports = function () {
 			}
 
 			/**
-    * Parses the value emitted by {@link Timestamp#toJSON}.
+    * Clones a {@link Timestamp} instance.
     *
     * @public
-    * @param {Number} value
+    * @static
+    * @param {Timestamp} value
     * @returns {Timestamp}
     */
 
@@ -7549,6 +7643,22 @@ 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);