@barchart/portfolio-api-common 1.2.10 → 1.2.14

package/lib/data/TransactionValidator.js

@@ -73,6 +73,28 @@ module.exports = (() => {
 			return valid.map(d => d.type);
 		}
 
+		/**
+		 * Returns transaction types which can be initiated by the user, regardless
+		 * of instrument type.
+		 *
+		 * @public
+		 * @static
+		 * @return {Array.<TransactionType>}
+		 */
+		static getUserInitiatedTransactionTypes() {
+			return array.unique(Object.keys(validTransactionTypes).reduce((types, key) => {
+				const instrumentTypes = validTransactionTypes[key];
+
+				instrumentTypes.forEach((data) => {
+					if (data.user) {
+						types.push(data.type);
+					}
+				});
+
+				return types;
+			}, [ ]));
+		}
+
 		/**
 		 * Checks to see if an transaction type is applicable to an instrument type.
 		 *
@@ -155,6 +177,7 @@ module.exports = (() => {
 	associateTypes(InstrumentType.FUND, TransactionType.FEE, true, [ PositionDirection.LONG ]);
 	associateTypes(InstrumentType.FUND, TransactionType.FEE_UNITS, false);
 	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_CASH, false);
+	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_REINVEST, false);
 	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_FUND, false);
 
 	associateTypes(InstrumentType.OTHER, TransactionType.BUY, true, [ PositionDirection.LONG, PositionDirection.EVEN ]);

package/lib/formatters/TransactionFormatter.js

@@ -197,8 +197,18 @@ module.exports = (() => {
 	});
 
 	formatters.set(TransactionType.VALUATION, (t) => {
+		let rate;
+
+		if (t.valuation.rate) {
+			rate = t.valuation.rate;
+		} else if (t.snapshot.open.getIsZero()) {
+			rate = null;
+		} else {
+			rate = t.valuation.value.divide(t.snapshot.open)
+		}
+
 		return {
-			price: t.valuation.value
+			rate: rate
 		};
 	});
 

package/lib/serialization/TransactionSchema.js

@@ -201,6 +201,7 @@ module.exports = (() => {
 		.withField('split.reference', DataType.STRING, true)
 		.withField('charge.amount', DataType.DECIMAL, true)
 		.withField('income.amount', DataType.DECIMAL, true)
+		.withField('valuation.rate', DataType.DECIMAL, true)
 		.withField('valuation.value', DataType.DECIMAL, true)
 		.withField('system.sequence', DataType.NUMBER)
 		.withField('system.version', DataType.STRING)
@@ -239,6 +240,7 @@ module.exports = (() => {
 		.withField('split.reference', DataType.STRING, true)
 		.withField('charge.amount', DataType.DECIMAL, true)
 		.withField('income.amount', DataType.DECIMAL, true)
+		.withField('valuation.rate', DataType.DECIMAL, true)
 		.withField('valuation.value', DataType.DECIMAL, true)
 		.schema
 	);

package/package.json

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

package/test/SpecRunner.js

@@ -1062,6 +1062,28 @@ module.exports = (() => {
 			return valid.map(d => d.type);
 		}
 
+		/**
+		 * Returns transaction types which can be initiated by the user, regardless
+		 * of instrument type.
+		 *
+		 * @public
+		 * @static
+		 * @return {Array.<TransactionType>}
+		 */
+		static getUserInitiatedTransactionTypes() {
+			return array.unique(Object.keys(validTransactionTypes).reduce((types, key) => {
+				const instrumentTypes = validTransactionTypes[key];
+
+				instrumentTypes.forEach((data) => {
+					if (data.user) {
+						types.push(data.type);
+					}
+				});
+
+				return types;
+			}, [ ]));
+		}
+
 		/**
 		 * Checks to see if an transaction type is applicable to an instrument type.
 		 *
@@ -1144,6 +1166,7 @@ module.exports = (() => {
 	associateTypes(InstrumentType.FUND, TransactionType.FEE, true, [ PositionDirection.LONG ]);
 	associateTypes(InstrumentType.FUND, TransactionType.FEE_UNITS, false);
 	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_CASH, false);
+	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_REINVEST, false);
 	associateTypes(InstrumentType.FUND, TransactionType.DISTRIBUTION_FUND, false);
 
 	associateTypes(InstrumentType.OTHER, TransactionType.BUY, true, [ PositionDirection.LONG, PositionDirection.EVEN ]);
@@ -9225,6 +9248,20 @@ describe('When validating transaction order', () => {
 	});
 });
 
+describe('When requesting all the user-initiated transaction types', () => {
+	'use strict';
+
+	let userInitiated;
+
+	beforeEach(() => {
+		userInitiated = TransactionValidator.getUserInitiatedTransactionTypes();
+	});
+
+	it('Only nine types should be returned', () => {
+		expect(userInitiated.length).toEqual(9);
+	});
+});
+
 },{"./../../../lib/data/TransactionValidator":5,"@barchart/common-js/lang/Day":18}],37:[function(require,module,exports){
 const Currency = require('@barchart/common-js/lang/Currency'),
 	Decimal = require('@barchart/common-js/lang/Decimal');

package/test/specs/data/TransactionValidatorSpec.js

@@ -41,3 +41,17 @@ describe('When validating transaction order', () => {
 		expect(TransactionValidator.validateOrder([ build(1, '2018-05-02'), build(2, '2018-05-01'), build(3, '2018-04-30') ])).toEqual(false);
 	});
 });
+
+describe('When requesting all the user-initiated transaction types', () => {
+	'use strict';
+
+	let userInitiated;
+
+	beforeEach(() => {
+		userInitiated = TransactionValidator.getUserInitiatedTransactionTypes();
+	});
+
+	it('Only nine types should be returned', () => {
+		expect(userInitiated.length).toEqual(9);
+	});
+});