Merge pull request #273 from ChartIQ/feature/add-optional-properties-to-appmetadata

Add appId & version to AppMetadata

Author: rikoe

docs/api/ref/AppMetadata.md

@@ -9,6 +9,8 @@ hide_title: true
 ```ts
 interface AppMetadata {
   name: string;
+  appId?: string;
+  version?: string;
   title?: string;
   tooltip?: string;
   description?: string;
@@ -24,5 +26,7 @@ It always includes at least a `name` property, which can be used with [`open`](D
 Optionally, extra information from the app directory can be returned, to aid in rendering UI elements, e.g. a context menu.
 This includes a title, description, tooltip and icon and image URLs.
 
+In situations where a desktop agent connects to multiple app directories or multiple versions of the same app exists in a single app directory, it may be neccessary to specify appId and version to target applications that share the same name. 
+
 #### See also
 * [`AppIntent.apps`](AppIntent)

src/api/AppMetadata.ts

@@ -10,6 +10,12 @@ export interface AppMetadata {
   /** The unique app name that can be used with the open and raiseIntent calls. */
   readonly name: string;
 
+  /** The unique application identifier located within a specific application directory instance. An example of an appId might be '[email protected]' */
+  readonly appId?: string;
+
+  /** The Version of the application. */
+  readonly version?: string;
+
   /** A more user-friendly application title that can be used to render UI elements  */
   readonly title?: string;