[WIP] Added the ability to pull server side changes.

We now also set a user agent and have data exclusions (WIP).
Added some documentation (from the .NET client)

Author: niemyjski

src/EventBuilder.ts

@@ -7,6 +7,8 @@ import { EventPluginContext } from './plugins/EventPluginContext';
 import { Utils } from 'Utils';
 
 export class EventBuilder {
+  private _validIdentifierErrorMessage:string = "must contain between 8 and 100 alphanumeric or '-' characters.";
+
   public target:IEvent;
   public client:ExceptionlessClient;
   public pluginContextData:ContextData;
@@ -35,7 +37,7 @@ export class EventBuilder {
 
   public setSessionId(sessionId:string): EventBuilder {
     if (!this.isValidIdentifier(sessionId)) {
-      throw new Error("SessionId must contain between 8 and 100 alphanumeric or '-' characters.");
+      throw new Error(`SessionId ${this._validIdentifierErrorMessage}`);
     }
 
     this.target.session_id = sessionId;
@@ -44,7 +46,7 @@ export class EventBuilder {
 
   public setReferenceId(referenceId:string): EventBuilder {
     if (!this.isValidIdentifier(referenceId)) {
-      throw new Error("SessionId must contain between 8 and 100 alphanumeric or '-' characters.");
+      throw new Error(`ReferenceId ${this._validIdentifierErrorMessage}`);
     }
 
     this.target.reference_id = referenceId;
@@ -82,8 +84,6 @@ export class EventBuilder {
     return this;
   }
 
-  // TODO: we to see if it makes sense to add setUserDescription.
-
   public setValue(value:number): EventBuilder {
     if (!!value) {
       this.target.value = value;
@@ -93,20 +93,7 @@ export class EventBuilder {
   }
 
   public addTags(...tags:string[]): EventBuilder {
-    if (!tags || tags.length === 0) {
-      return this;
-    }
-
-    if (!this.target.tags) {
-      this.target.tags = [];
-    }
-
-    for (var index = 0; index < tags.length; index++) {
-      if (tags[index] && this.target.tags.indexOf(tags[index]) < 0) {
-        this.target.tags.push(tags[index]);
-      }
-    }
-
+    this.target.tags = Utils.addRange<string>(this.target.tags, ...tags);
     return this;
   }
 
@@ -131,7 +118,8 @@ export class EventBuilder {
     return this;
   }
 
-  public addRequestInfo(request:any): EventBuilder {
+  //todo: rename this
+  public addRequestInfo(request:Object): EventBuilder {
     if (!!request) {
       this.pluginContextData['@request'] = request;
     }

src/Utils-spec.ts

@@ -1,6 +1,20 @@
+import { IEvent } from './models/IEvent';
 import { Utils } from 'Utils';
 
 describe('Utils', () => {
+  it('should add range', () => {
+    var target:string[];
+    expect(Utils.addRange(target)).toEqual([]);
+    expect(target).toBeUndefined();
+
+    expect(Utils.addRange(target, '1', '2')).toEqual(['1', '2']);
+    expect(Utils.addRange(target, '1', '2')).toEqual(['1', '2']);
+
+    target = ['3'];
+    expect(Utils.addRange(target, '1', '2')).toEqual(['3', '1', '2']);
+    expect(target).toEqual(['3', '1', '2']);
+  });
+
   it('should stringify circular reference', () => {
     var afoo:any = {a: 'foo'};
     afoo.b = afoo;
@@ -10,7 +24,7 @@ describe('Utils', () => {
   });
 
   it('should stringify array', () => {
-    var error = {
+    var error:IEvent = {
       "type": "error",
       "data": {
         "@error": {

src/Utils.ts

@@ -1,6 +1,24 @@
 import { IStackFrame } from 'models/IStackFrame';
 
 export class Utils {
+  public static addRange<T>(target:T[], ...values:T[]) {
+    if (!target) {
+      target = [];
+    }
+
+    if (!values || values.length === 0) {
+      return target;
+    }
+
+    for (var index = 0; index < values.length; index++) {
+      if (values[index] && target.indexOf(values[index]) < 0) {
+        target.push(values[index]);
+      }
+    }
+
+    return target;
+  }
+
   public static getHashCode(source:string): string {
     if (!source || source.length === 0) {
       return null;
@@ -17,11 +35,11 @@ export class Utils {
   }
 
   public static getCookies(cookies:string): Object {
-    var result = {};
+    var result:Object = {};
 
-    var parts = (cookies || '').split('; ');
+    var parts:string[] = (cookies || '').split('; ');
     for (var index = 0; index < parts.length; index++) {
-      var cookie = parts[index].split('=');
+      var cookie:string[] = parts[index].split('=');
       result[cookie[0]] = cookie[1];
     }
 
@@ -36,8 +54,8 @@ export class Utils {
     return s4() + s4() + '-' + s4() + '-' + s4() + '-' + s4() + '-' + s4() + s4() + s4();
   }
 
-  public static merge(defaultValues:any, values:any) {
-    var result = {};
+  public static merge(defaultValues:Object, values:Object) {
+    var result:Object = {};
 
     for (var key in defaultValues || {}) {
       if (!!defaultValues[key]) {
@@ -78,7 +96,7 @@ export class Utils {
       return null;
     }
 
-    var result = {};
+    var result:Object = {};
     for (var index = 0; index < pairs.length; index++) {
       var pair = pairs[index].split('=');
       result[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
@@ -93,7 +111,7 @@ export class Utils {
 
   public static stringify(data:any): string {
     function stringifyImpl(data:any): string {
-      var cache = [];
+      var cache:string[] = [];
       return JSON.stringify(data, function(key:string, value:any) {
         if (typeof value === 'object' && !!value) {
           if (cache.indexOf(value) !== -1) {

src/bootstrap/NodeBootstrapper.ts

@@ -21,7 +21,7 @@ export class NodeBootstrapper implements IBootstrapper {
     configDefaults.requestInfoCollector = new NodeRequestInfoCollector();
     configDefaults.submissionClient = new NodeSubmissionClient();
 
-    process.on('uncaughtException', function(error) {
+    process.on('uncaughtException', function(error:Error) {
       ExceptionlessClient.default.submitUnhandledException(error, 'uncaughtException');
     });
 

src/bootstrap/WindowBootstrapper.ts

@@ -49,13 +49,13 @@ export class WindowBootstrapper implements IBootstrapper {
     return null;
   }
 
-  private processUnhandledException(stackTrace:TraceKit.StackTrace, options): void {
+  private processUnhandledException(stackTrace:TraceKit.StackTrace, options?:any): void {
     var builder = ExceptionlessClient.default.createUnhandledException(new Error(stackTrace.message || (options || {}).status || 'Script error'), 'onerror');
     builder.pluginContextData['@@_TraceKit.StackTrace'] = stackTrace;
     builder.submit();
   }
 
-  private processJQueryAjaxError(event, xhr, settings, error): void {
+  private processJQueryAjaxError(event, xhr, settings, error:Error): void {
     var client = ExceptionlessClient.default;
     if (xhr.status === 404) {
       client.submitNotFound(settings.url);