Trails

dist/connector.d.ts

@@ -48,6 +48,8 @@ declare class Connector extends HKEntity {
     public roles: {
         [x: string]: string;
     };
+    properties: any;
+    metaProperties: any;
     /**
      * Adds a new role to this connector.
      *
@@ -96,6 +98,6 @@ declare class Connector extends HKEntity {
     };
 }
 declare namespace Connector {
-    const type: string;
+    const type: "connector";
 }
 import HKEntity = require("./hkentity");

dist/connectorclass.d.ts

@@ -2,10 +2,10 @@
 * Copyright (c) 2016-present, IBM Research
 * Licensed under The MIT License [see LICENSE for details]
 */
-export var HIERARCHY: string;
-export var FACTS: string;
-export var REASONING: string;
-export var CONSTRAINT: string;
-export var CAUSAL: string;
-export var POSSIBILITY: string;
-export var POSSIBILITYRESOLVER: string;
+export const HIERARCHY: "h";
+export const FACTS: "f";
+export const REASONING: "r";
+export const CONSTRAINT: "c";
+export const CAUSAL: "C";
+export const POSSIBILITY: "p";
+export const POSSIBILITYRESOLVER: "P";

dist/constants.d.ts

@@ -2,5 +2,5 @@
 * Copyright (c) 2016-present, IBM Research
 * Licensed under The MIT License [see LICENSE for details]
 */
-export var LAMBDA: string;
-export var MIMETYPE: string;
+export const LAMBDA: "λ";
+export const MIMETYPE: "hk:mimeType";

dist/context.d.ts

@@ -10,8 +10,9 @@ declare class Context extends Node {
      * @param {string | null} [parent] Parent id.
      */
     constructor(id?: string | null | undefined, parent?: string | null | undefined);
+    type: "context";
 }
 declare namespace Context {
-    const type: string;
+    const type: "context";
 }
 import Node = require("./node");

dist/datasource/hkdatasource.d.ts

@@ -147,6 +147,18 @@ declare class HKDatasource {
     }, payload: object, callback: (err: string, entities: {
         [x: string]: HKEntity;
     }) => any): void;
+    /**
+   * @callback GetTrailCallback
+   * @param {string} err An error object that indicate if the operation was succesful or not
+   * @param {object} trail
+   */
+    /**
+     * Fetch trail
+     *
+     * @param {string} trailId The trail id to retrieve their nested entities.
+     * @param {GetTrailCallback} callback Callback with the entities
+     */
+    fetchTrail(trailId: string, callback?: (err: string, trail: object) => any): void;
     /**
      * Filter entities using CSS pattern `(TODO: document it better)`
      *

dist/datasource/hkdatasource.js

@@ -417,6 +417,40 @@ class HKDatasource {
             }
         });
     }
+    /**
+   * @callback GetTrailCallback
+   * @param {string} err An error object that indicate if the operation was succesful or not
+   * @param {object} trail
+   */
+    /**
+     * Fetch trail
+     *
+     * @param {string} trailId The trail id to retrieve their nested entities.
+     * @param {GetTrailCallback} callback Callback with the entities
+     */
+    fetchTrail(trailId, callback = () => { }) {
+        let url = this.url + "repository/" + this.graphName + "/trail/" + encodeURIComponent(trailId);
+        request.get(url, this.options, (err, res) => {
+            // console.log(res.body);
+            if (!err) {
+                if (requestCompletedWithSuccess(res.statusCode)) {
+                    try {
+                        let entities = convertEntities(res.body);
+                        callback(null, entities[trailId]);
+                    }
+                    catch (exp) {
+                        callback(exp);
+                    }
+                }
+                else {
+                    callback(`Server responded with ${res.statusCode}. ${res.body}`);
+                }
+            }
+            else {
+                callback(err);
+            }
+        });
+    }
     /**
      * Filter entities using CSS pattern `(TODO: document it better)`
      *

dist/datasource/observer/clients/index.d.ts

@@ -2,7 +2,7 @@
 * Copyright (c) 2016-present, IBM Research
 * Licensed under The MIT License [see LICENSE for details]
 */
-export var DefaultObserverClient: typeof import("./observerclient");
-export var ConfigurableObserverClient: typeof import("./configurableobserverclient");
-export var RestObserverClient: typeof import("./restobserverclient");
-export var RabbitMQObserverClient: typeof import("./rabbitmqobserverclient");
+export const DefaultObserverClient: typeof import("./observerclient");
+export const ConfigurableObserverClient: typeof import("./configurableobserverclient");
+export const RestObserverClient: typeof import("./restobserverclient");
+export const RabbitMQObserverClient: typeof import("./rabbitmqobserverclient");

dist/datasource/observer/clients/rabbitmqobserverclient.d.ts

@@ -35,7 +35,9 @@ declare class RabbitMQObserverClient extends ConfigurableObserverClient {
     _channelWrapper: any;
     _setupFunction: ((channel: any) => Promise<void>) | null;
     _queueName: any;
+    init(): Promise<void>;
     _init(exchangeName: any): Promise<void>;
     _isInitialized: boolean | undefined;
+    deinit(): Promise<void>;
 }
 import ConfigurableObserverClient = require("./configurableobserverclient");

dist/datasource/observer/clients/restobserverclient.d.ts

@@ -25,5 +25,6 @@ declare class RestObserverClient extends ConfigurableObserverClient {
     _address: string;
     _listeningPath: string | null;
     _server: any;
+    deinit(): Promise<void>;
 }
 import ConfigurableObserverClient = require("./configurableobserverclient");

dist/fi/fioperator.d.ts

@@ -4,6 +4,6 @@
 */
 export = FIOperator;
 declare const FIOperator: Readonly<{
-    NONE: string;
-    DESCRIPTION: string;
+    NONE: "";
+    DESCRIPTION: "*";
 }>;

dist/hkgraph.d.ts

@@ -13,6 +13,7 @@ declare class HKGraph {
     connectors: {};
     refs: {};
     trails: {};
+    actions: {};
     bindsMap: {};
     linkMap: {};
     virtualLinkMap: {};
@@ -75,14 +76,14 @@ declare class HKGraph {
     deserialize(str: any): HKGraph;
 }
 declare namespace HKGraph {
-    const NODE_TYPE: string;
-    const VIRTUAL_NODE_TYPE: string;
-    const CONTEXT_TYPE: string;
-    const VIRTUAL_CONTEXT_TYPE: string;
-    const LINK_TYPE: string;
-    const VIRTUAL_LINK_TYPE: string;
-    const CONNECTOR_TYPE: string;
-    const INTERFACE: string;
+    const NODE_TYPE: "node";
+    const VIRTUAL_NODE_TYPE: "virtualnode";
+    const CONTEXT_TYPE: "context";
+    const VIRTUAL_CONTEXT_TYPE: "virtualcontext";
+    const LINK_TYPE: "link";
+    const VIRTUAL_LINK_TYPE: "virtuallink";
+    const CONNECTOR_TYPE: "connector";
+    const INTERFACE: "interface";
 }
 declare function generateId(model: any, length: any): any;
 import HKEntity = require("./hkentity");

dist/hkgraph.js

@@ -11,6 +11,7 @@ const Reference = require("./reference");
 const Trail = require("./trail");
 const HKTypes = require("./types");
 const shortId = require('shortid');
+const { Action } = require("./trail");
 const VirtualContext = require("./virtualcontext");
 const HKEntity = require("./hkentity");
 const VirtualNode = require("./virtualnode");
@@ -26,6 +27,7 @@ class HKGraph {
         this.connectors = {};
         this.refs = {};
         this.trails = {};
+        this.actions = {};
         // Auxiliar maps
         this.bindsMap = {};
         this.linkMap = {};
@@ -47,7 +49,8 @@ class HKGraph {
             this.links.hasOwnProperty(id) ||
             this.connectors.hasOwnProperty(id) ||
             this.refs.hasOwnProperty(id) ||
-            this.trails.hasOwnProperty(id);
+            this.trails.hasOwnProperty(id) ||
+            this.actions.hasOwnProperty(id);
     }
     /**
      * Update an entity
@@ -66,7 +69,7 @@ class HKGraph {
             oldEntity.roles = entity.roles;
             oldEntity.className = entity.className;
         }
-        if (entity.type === HKTypes.NODE || entity.type === HKTypes.REFERENCE || entity.type === HKTypes.CONTEXT || entity.type === HKTypes.VIRTUAL_NODE || entity.type === HKTypes.VIRTUAL_CONTEXT) {
+        if (entity.type === HKTypes.NODE || entity.type === HKTypes.TRAIL || entity.type === HKTypes.REFERENCE || entity.type === HKTypes.CONTEXT || entity.type === HKTypes.VIRTUAL_NODE || entity.type === HKTypes.VIRTUAL_CONTEXT || entity.type === HKTypes.ACTION) {
             oldEntity.interfaces = entity.interfaces;
         }
         // Update parent
@@ -173,6 +176,19 @@ class HKGraph {
                         if (Trail.isValid(entity)) {
                             newEntity = new Trail(entity);
                             this.trails[entity.id] = newEntity;
+                            this.contextMap[entity.id] = {};
+                            if (this.orphans.hasOwnProperty(entity.id)) {
+                                this.contextMap[entity.id] = this.orphans[entity.id];
+                                delete this.orphans[entity.id];
+                            }
+                        }
+                        break;
+                    }
+                case HKTypes.ACTION:
+                    {
+                        if (entity instanceof Trail.Action) {
+                            newEntity = entity;
+                            this.actions[entity.id] = newEntity;
                         }
                         break;
                     }
@@ -356,8 +372,13 @@ class HKGraph {
                     {
                         /* delete children trails? */
                         delete this.trails[id];
+                        delete this.contextMap[entity.id];
                         break;
                     }
+                case Action.type:
+                    {
+                        delete this.actions[id];
+                    }
             }
             if (this.orphans.hasOwnProperty(entity.parent)) {
                 delete this.orphans[entity.parent][id];
@@ -480,7 +501,7 @@ class HKGraph {
             c.id = null;
             return c;
         }
-        return this.nodes[id] || this.virtualNodes[id] || this.contexts[id] || this.virtualContexts[id] || this.virtualLinks[id] || this.links[id] || this.connectors[id] || this.refs[id] || this.trails[id] || null;
+        return this.nodes[id] || this.virtualNodes[id] || this.contexts[id] || this.virtualContexts[id] || this.virtualLinks[id] || this.links[id] || this.connectors[id] || this.refs[id] || this.trails[id] || this.actions[id] || null;
     }
     /**
      * Returns HK entities in this graph indexed by id.

dist/index.js

@@ -32,6 +32,7 @@ exports.CONNECTOR_TYPE = require("./types").CONNECTOR;
 exports.BIND_TYPE = require("./types").BIND;
 exports.INTERFACE = require("./types").INTERFACE;
 exports.TRAIL_TYPE = require("./types").TRAIL;
+exports.ACTION_TYPE = require("./types").ACTION;
 exports.VIRTUAL_NODE_TYPE = require("./types").VIRTUAL_NODE;
 exports.VIRTUAL_CONTEXT_TYPE = require("./types").VIRTUAL_CONTEXT;
 exports.VIRTUAL_LINK_TYPE = require("./types").VIRTUAL_LINK;

dist/link.d.ts

@@ -54,6 +54,8 @@ declare class Link extends HKEntity {
             [x: string]: Object;
         };
     };
+    properties: any;
+    metaProperties: any;
     /**
      * Adds a new bind to this role;
      *
@@ -91,6 +93,6 @@ declare class Link extends HKEntity {
     };
 }
 declare namespace Link {
-    const type: string;
+    const type: "link";
 }
 import HKEntity = require("./hkentity");

dist/node.d.ts

@@ -60,6 +60,14 @@ declare class Node extends HKEntity {
             };
         };
     };
+    /**
+     * @public
+     * @type {Object.<string, string | number | Object>
+     */
+    public properties: {
+        [x: string]: string | number | Object;
+    };
+    metaProperties: any;
     /**
      *
      * @param {string} key Id of the interface
@@ -88,7 +96,7 @@ declare class Node extends HKEntity {
     };
 }
 declare namespace Node {
-    const type: string;
+    const type: "node";
 }
 import HKEntity = require("./hkentity");
 import FI = require("./fi/fi");

dist/reference.d.ts

@@ -20,8 +20,15 @@ declare class Reference extends Node {
      *
      */
     public ref: string | null;
+    type: "ref";
+    serialize: () => {
+        id: any;
+        type: "ref";
+        ref: any;
+        parent: any;
+    };
 }
 declare namespace Reference {
-    const type: string;
+    const type: "ref";
 }
 import Node = require("./node");

dist/roletypes.d.ts

@@ -2,8 +2,8 @@
 * Copyright (c) 2016-present, IBM Research
 * Licensed under The MIT License [see LICENSE for details]
 */
-export var NONE: string;
-export var SUBJECT: string;
-export var OBJECT: string;
-export var PARENT: string;
-export var CHILD: string;
+export const NONE: "n";
+export const SUBJECT: "s";
+export const OBJECT: "o";
+export const PARENT: "p";
+export const CHILD: "c";