fix(doc) Some cleanup on jsdoc annotations for API doc generation

Signed-off-by: Jerome Simeon <jeromesimeon@me.com>

Author: jeromesimeon

packages/concerto-core/api.txt

@@ -1,4 +1,14 @@
+class BaseException extends Error {
+   + void constructor(string,string) 
+}
+class BaseFileException extends BaseException {
+   + void constructor(string,string,string,string,string) 
+   + string getFileLocation() 
+   + string getShortMessage() 
+   + string getFileName() 
+}
 class Factory {
+   + void constructor(ModelManager) 
    + Resource newResource(String,String,String,Object,boolean,String,boolean,boolean) throws TypeNotFoundException
    + Resource newConcept(String,String,Object,boolean,String,boolean) throws TypeNotFoundException
    + Relationship newRelationship(String,String,String) throws TypeNotFoundException
@@ -75,6 +85,7 @@ class Introspector {
    + ClassDeclaration getClassDeclaration(String) throws Error
 }
 class ModelFile {
+   + void constructor(ModelManager,string,string,boolean) throws IllegalModelException
    + boolean isExternal() 
    + ModelManager getModelManager() 
    + string[] getImports() 
@@ -169,6 +180,7 @@ class ValidatedResource extends Resource {
    + void validate() throws Error
 }
 class ModelManager {
+   + void constructor() 
    + void validateModelFile(string,string) throws IllegalModelException
    + Object addModelFile(string,string,boolean,boolean) throws IllegalModelException
    + Object updateModelFile(string,string,boolean) throws IllegalModelException
@@ -193,6 +205,9 @@ class ModelManager {
    + void addDecoratorFactory(DecoratorFactory) 
    + boolean hasInstance(object) 
 }
+class SecurityException extends BaseException {
+   + void constructor(string) 
+}
 class Serializer {
    + void constructor(Factory,ModelManager) 
    + void setDefaultOptions(Object) 

packages/concerto-core/changelog.txt

@@ -24,6 +24,9 @@
 # Note that the latest public API is documented using JSDocs and is available in api.txt.
 #
 
+Version 0.82.1 {cb6c3b228035279e6997a4e3a34ef348} 2019-10-22
+- Make several constructors public
+
 Version 0.80.3 {6f5a9ab45943cb76732c14b11f47d044} 2019-08-24
 - Add Ergo option to serializer
 

packages/concerto-core/index.js

@@ -18,7 +18,7 @@
  * Concerto module. Concerto is a framework for defining domain
  * specific models.
  *
- * @module concerto
+ * @module concerto-core
  */
 
 module.exports.AssetDeclaration = require('./lib/introspect/assetdeclaration');

packages/concerto-core/lib/baseexception.js

@@ -21,7 +21,6 @@ const packageJson = require('../package.json');
 * @extends Error
 * @class
 * @memberof module:concerto-core
-* @private
 */
 class BaseException extends Error {
 

packages/concerto-core/lib/basefileexception.js

@@ -22,7 +22,6 @@ const BaseException = require('./baseexception');
  * @see {@link BaseException}
  * @class
  * @memberof module:concerto-core
- * @private
  */
 class BaseFileException extends BaseException {
 

packages/concerto-core/lib/factory.js

@@ -50,7 +50,6 @@ class Factory {
      * Create the factory.
      *
      * @param {ModelManager} modelManager - The ModelManager to use for this registry
-     * @private
      */
     constructor(modelManager) {
         this.modelManager = modelManager;

packages/concerto-core/lib/introspect/modelfile.js

@@ -38,7 +38,6 @@ class ModelFile {
     /**
      * Create a ModelFile. This should only be called by framework code.
      * Use the ModelManager to manage ModelFiles.
-     * @private
      * @param {ModelManager} modelManager - the ModelManager that manages this
      * ModelFile
      * @param {string} definitions - The DSL model as a string.

packages/concerto-core/lib/modelmanager.js

@@ -33,28 +33,23 @@ const debug = require('debug')('concerto:ModelManager');
 /**
  * Manages the Concerto model files.
  *
- *
  * The structure of {@link Resource}s (Assets, Transactions, Participants) is modelled
  * in a set of Concerto files. The contents of these files are managed
  * by the {@link ModelManager}. Each Concerto file has a single namespace and contains
  * a set of asset, transaction and participant type definitions.
  *
- *
  * Concerto applications load their Concerto files and then call the {@link ModelManager#addModelFile addModelFile}
  * method to register the Concerto file(s) with the ModelManager. The ModelManager
  * parses the text of the Concerto file and will make all defined types available
  * to other Concerto services, such as the {@link Serializer} (to convert instances to/from JSON)
  * and {@link Factory} (to create instances).
  *
- *
- *
  * @class
  * @memberof module:concerto-core
  */
 class ModelManager {
     /**
      * Create the ModelManager.
-     * @private
      */
     constructor() {
         this.modelFiles = {};

packages/concerto-core/lib/securityexception.js

@@ -22,7 +22,6 @@ const BaseException = require('./baseexception');
 * @see See {@link BaseException}
 * @class
 * @memberof module:concerto-core
-* @private
 */
 class SecurityException extends BaseException {