@panyam/tsutils 0.0.63 → 0.0.64

package/lib/cjs/comms/events.d.ts

@@ -35,10 +35,6 @@ export declare class EventEmitter {
 }
 export declare class EventHub {
     private _handlers;
-    private _muted;
-    get isMuted(): boolean;
-    mute(): void;
-    unmute(): void;
     on(names: Array<string> | string, callback: EventCallback): this;
     removeOn(names: Array<string> | string, callback: EventCallback): this;
     _ensurestrings(names: Array<string> | string): string[];
@@ -50,6 +46,12 @@ export declare class EventHub {
     }, handler: T): this;
     emit(name: string, source: any, payload?: any): boolean;
     dispatchEvent(event: TEvent): boolean;
+    static BATCH_EVENTS: string;
+    protected _events: TEvent[];
+    protected _inBatchMode: boolean;
+    startBatchMode(): this;
+    cancelBatch(): void;
+    commitBatch(): void;
 }
 export declare class StateMachine {
     private _states;

package/lib/cjs/comms/events.js

@@ -71,16 +71,8 @@ exports.EventEmitter = EventEmitter;
 class EventHub {
     constructor() {
         this._handlers = {};
-        this._muted = false;
-    }
-    get isMuted() {
-        return this._muted;
-    }
-    mute() {
-        this._muted = true;
-    }
-    unmute() {
-        this._muted = false;
+        this._events = [];
+        this._inBatchMode = false;
     }
     on(names, callback) {
         return this._addHandler(names, this._handlers, callback);
@@ -116,7 +108,14 @@ class EventHub {
         return this;
     }
     emit(name, source, payload) {
-        return this.dispatchEvent(new TEvent(name, source, payload));
+        const evt = new TEvent(name, source, payload);
+        if (this._inBatchMode) {
+            this._events.push(evt);
+            return true;
+        }
+        else {
+            return this.dispatchEvent(evt);
+        }
     }
     dispatchEvent(event) {
         const evtCallbacks = this._handlers[event.name] || [];
@@ -127,8 +126,24 @@ class EventHub {
         }
         return true;
     }
+    startBatchMode() {
+        if (!this._inBatchMode) {
+            this._inBatchMode = true;
+        }
+        return this;
+    }
+    cancelBatch() {
+        this._inBatchMode = false;
+        this._events = [];
+    }
+    commitBatch() {
+        this._inBatchMode = false;
+        this.emit(EventHub.BATCH_EVENTS, this, this._events);
+        this._events = [];
+    }
 }
 exports.EventHub = EventHub;
+EventHub.BATCH_EVENTS = "BatchEvents";
 class StateMachine {
     constructor() {
         this._states = {};

package/lib/cjs/comms/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/comms/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { Nullable, Timestamp } from \"../types\";\n\n/**\n * Super class of all Events.\n */\nexport class TEvent {\n  // Globally unique ID for all events.\n  private static counter = 0;\n  readonly uuid = TEvent.counter++;\n\n  /**\n   * The event this event was spawned from (if any).\n   */\n  protected _spawnedFrom: Nullable<this> = null;\n\n  /**\n   * Name of the event.\n   */\n  readonly name: string;\n\n  /**\n   * Source from which this event is originating.\n   */\n  readonly source: any;\n\n  /**\n   * Source state that is set by the source of the event only\n   * *it* can use.\n   */\n  sourceState: any = null;\n\n  /**\n   * Event specific payload.\n   */\n  payload: any;\n\n  /**\n   * Whether the event was cancelled.\n   */\n  cancelled = false;\n\n  /**\n   * Timestamp of the event - optional.\n   */\n  timeStamp: Timestamp = -1;\n\n  /**\n   * All child events that were spawned from this Event.\n   * The parent/spawnedFrom and child event references help us\n   * form a call tree/trace of a events as it traverses\n   * the system.\n   */\n  children: TEvent[] = [];\n\n  constructor(name: string, source: any, payload?: any) {\n    this.name = name;\n    this.source = source;\n    this.payload = payload;\n  }\n\n  get spawnedFrom(): Nullable<this> {\n    return this._spawnedFrom;\n  }\n\n  protected setSpawnedFrom(msg: Nullable<this>): void {\n    this._spawnedFrom = msg;\n    if (msg == null) this._rootEvent = this;\n    else this._rootEvent = msg.rootEvent;\n  }\n\n  spawn(name: string, source: any, payload?: any): TEvent {\n    const child = new TEvent(name, source, payload);\n    child.setSpawnedFrom(this);\n    this.children.push(child);\n    return child;\n  }\n\n  /**\n   * The first/root message in the forward chain.\n   */\n  private _rootEvent: this;\n\n  get rootEvent(): this {\n    return this._rootEvent as this;\n  }\n}\n\nexport class State {\n  private static counter = 0;\n  stateData: any = null;\n  readonly id = State.counter++;\n\n  get name(): string {\n    return this.constructor.name;\n  }\n\n  enter(data: any): void {\n    this.stateData = data;\n  }\n\n  handle(event: TEvent): void {\n    // todo\n  }\n}\n\nexport type EventCallback = ((event: TEvent) => void) | ((event: TEvent) => Promise<void>);\n\nexport class EventEmitter {\n  protected _eventHub: EventHub | null;\n  constructor() {\n    this._eventHub = new EventHub();\n  }\n  get eventHub(): EventHub | null {\n    return this._eventHub;\n  }\n  set eventHub(hub: EventHub | null) {\n    const oldHub = this._eventHub;\n    this._eventHub = hub;\n    this.eventHubChanged(oldHub);\n  }\n  protected eventHubChanged(oldHub: EventHub | null): void {\n    // Do nothing\n    console.log(\"WARNING - EventHub Change Listener not implemented: \", this.constructor.name);\n  }\n}\n\nexport class EventHub {\n  private _handlers: { [key: string]: Array<EventCallback> } = {};\n  private _muted = false;\n\n  get isMuted(): boolean {\n    return this._muted;\n  }\n\n  mute(): void {\n    this._muted = true;\n  }\n\n  unmute(): void {\n    this._muted = false;\n  }\n\n  on(names: Array<string> | string, callback: EventCallback): this {\n    return this._addHandler(names, this._handlers, callback);\n  }\n\n  removeOn(names: Array<string> | string, callback: EventCallback): this {\n    return this._removeHandler(names, this._handlers, callback);\n  }\n\n  _ensurestrings(names: Array<string> | string): string[] {\n    if (typeof names === \"string\") {\n      names = (names as string).split(\",\");\n    }\n    return names.map(function (v) {\n      return v.trim();\n    });\n  }\n\n  _addHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      handlerlist[name] = handlerlist[name] || [];\n      handlerlist[name].push(handler);\n    });\n    return this;\n  }\n\n  _removeHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      const evHandlers = handlerlist[name] || [];\n      for (let i = 0; i < evHandlers.length; i++) {\n        if (evHandlers[i] == handler) {\n          evHandlers.splice(i, 1);\n          break;\n        }\n      }\n    });\n    return this;\n  }\n\n  emit(name: string, source: any, payload?: any): boolean {\n    return this.dispatchEvent(new TEvent(name, source, payload));\n  }\n\n  dispatchEvent(event: TEvent): boolean {\n    const evtCallbacks = this._handlers[event.name] || [];\n    for (const callback of evtCallbacks) {\n      callback(event);\n      if (event.cancelled) return false;\n    }\n    return true;\n  }\n}\n\n/**\n * StateMachines allow declarative and stateful chaining of events.\n */\nexport class StateMachine {\n  private _states: { [key: string]: State } = {};\n  private _rootState: Nullable<State> = null;\n  private _currentState: Nullable<State> = null;\n  constructor() {\n    this._states = {};\n    this._rootState = null;\n    this._currentState = null;\n  }\n\n  /**\n   * The starting/root state of the machine.\n   *\n   * @param {String} name  Name of the default/root state.\n   */\n  set rootState(name: string) {\n    this._rootState = this.getState(name);\n    if (this._currentState == null) {\n      this._currentState = this._rootState;\n    }\n  }\n\n  /**\n   * Exits the current state (if any) and enters a new state.\n   *\n   * @param {String}   state   Name of the new state to enter.\n   * @param {Object}   data    State specific data for the state handler to use for the new state.\n   */\n  enter(state: string, data: any = null): void {\n    if (state == \"\") {\n      this._currentState = this._rootState;\n    } else {\n      this._currentState = this.getState(state);\n    }\n    if (this._currentState != null) {\n      this._currentState.enter(data);\n    }\n  }\n\n  /**\n   * Get the state by name.\n   *\n   * @param {String} name  Name of the state being queried.\n   * @returns {State} State object associated with the name.\n   */\n  getState(name: string): State {\n    if (!(name in this._states)) {\n      throw Error(\"State '\" + name + \"' not yet registered.\");\n    }\n    return this._states[name];\n  }\n\n  /**\n   * Register a new state in the state machine.\n   *\n   * @param {State} state  State being registered.  If another State with\n   * the same name exists, then a {DuplicateError} is thrown.\n   * @param {Bool} isRoot  Whether the new state is a root state.\n   */\n  registerState(state: State, isRoot = false): void {\n    const name = state.name;\n    if (name in this._states) {\n      throw Error(\"State '\" + name + \"' already registered.\");\n    }\n    this._states[name] = state;\n    if (isRoot || false) {\n      this.rootState = state.name;\n    }\n  }\n\n  /**\n   * Handles an event from the current state in the state machine possibly resulting in a state transition.\n   *\n   * @param {Object} name    Type of event being sent.\n   * @param {EventSource} source  The source generating the event.\n   * @param {Object} data    The event specific data.\n   */\n  handle(event: TEvent): void {\n    if (this._currentState == null) return;\n\n    const nextState: any = this._currentState.handle(event);\n    if (nextState != null) {\n      if (nextState == \"\") {\n        if (this._rootState != null) {\n          this.enter(this._rootState.name);\n        } else {\n          throw new Error(\"Root state has not been set\");\n        }\n      } else {\n        this.enter(nextState);\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/comms/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { Nullable, Timestamp } from \"../types\";\n\n/**\n * Super class of all Events.\n */\nexport class TEvent {\n  // Globally unique ID for all events.\n  private static counter = 0;\n  readonly uuid = TEvent.counter++;\n\n  /**\n   * The event this event was spawned from (if any).\n   */\n  protected _spawnedFrom: Nullable<this> = null;\n\n  /**\n   * Name of the event.\n   */\n  readonly name: string;\n\n  /**\n   * Source from which this event is originating.\n   */\n  readonly source: any;\n\n  /**\n   * Source state that is set by the source of the event only\n   * *it* can use.\n   */\n  sourceState: any = null;\n\n  /**\n   * Event specific payload.\n   */\n  payload: any;\n\n  /**\n   * Whether the event was cancelled.\n   */\n  cancelled = false;\n\n  /**\n   * Timestamp of the event - optional.\n   */\n  timeStamp: Timestamp = -1;\n\n  /**\n   * All child events that were spawned from this Event.\n   * The parent/spawnedFrom and child event references help us\n   * form a call tree/trace of a events as it traverses\n   * the system.\n   */\n  children: TEvent[] = [];\n\n  constructor(name: string, source: any, payload?: any) {\n    this.name = name;\n    this.source = source;\n    this.payload = payload;\n  }\n\n  get spawnedFrom(): Nullable<this> {\n    return this._spawnedFrom;\n  }\n\n  protected setSpawnedFrom(msg: Nullable<this>): void {\n    this._spawnedFrom = msg;\n    if (msg == null) this._rootEvent = this;\n    else this._rootEvent = msg.rootEvent;\n  }\n\n  spawn(name: string, source: any, payload?: any): TEvent {\n    const child = new TEvent(name, source, payload);\n    child.setSpawnedFrom(this);\n    this.children.push(child);\n    return child;\n  }\n\n  /**\n   * The first/root message in the forward chain.\n   */\n  private _rootEvent: this;\n\n  get rootEvent(): this {\n    return this._rootEvent as this;\n  }\n}\n\nexport class State {\n  private static counter = 0;\n  stateData: any = null;\n  readonly id = State.counter++;\n\n  get name(): string {\n    return this.constructor.name;\n  }\n\n  enter(data: any): void {\n    this.stateData = data;\n  }\n\n  handle(event: TEvent): void {\n    // todo\n  }\n}\n\nexport type EventCallback = ((event: TEvent) => void) | ((event: TEvent) => Promise<void>);\n\nexport class EventEmitter {\n  protected _eventHub: EventHub | null;\n  constructor() {\n    this._eventHub = new EventHub();\n  }\n  get eventHub(): EventHub | null {\n    return this._eventHub;\n  }\n  set eventHub(hub: EventHub | null) {\n    const oldHub = this._eventHub;\n    this._eventHub = hub;\n    this.eventHubChanged(oldHub);\n  }\n  protected eventHubChanged(oldHub: EventHub | null): void {\n    // Do nothing\n    console.log(\"WARNING - EventHub Change Listener not implemented: \", this.constructor.name);\n  }\n}\n\nexport class EventHub {\n  private _handlers: { [key: string]: Array<EventCallback> } = {};\n\n  on(names: Array<string> | string, callback: EventCallback): this {\n    return this._addHandler(names, this._handlers, callback);\n  }\n\n  removeOn(names: Array<string> | string, callback: EventCallback): this {\n    return this._removeHandler(names, this._handlers, callback);\n  }\n\n  _ensurestrings(names: Array<string> | string): string[] {\n    if (typeof names === \"string\") {\n      names = (names as string).split(\",\");\n    }\n    return names.map(function (v) {\n      return v.trim();\n    });\n  }\n\n  _addHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      handlerlist[name] = handlerlist[name] || [];\n      handlerlist[name].push(handler);\n    });\n    return this;\n  }\n\n  _removeHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      const evHandlers = handlerlist[name] || [];\n      for (let i = 0; i < evHandlers.length; i++) {\n        if (evHandlers[i] == handler) {\n          evHandlers.splice(i, 1);\n          break;\n        }\n      }\n    });\n    return this;\n  }\n\n  emit(name: string, source: any, payload?: any): boolean {\n    const evt = new TEvent(name, source, payload);\n    if (this._inBatchMode) {\n      this._events.push(evt);\n      return true;\n    } else {\n      return this.dispatchEvent(evt);\n    }\n  }\n\n  dispatchEvent(event: TEvent): boolean {\n    const evtCallbacks = this._handlers[event.name] || [];\n    for (const callback of evtCallbacks) {\n      callback(event);\n      if (event.cancelled) return false;\n    }\n    return true;\n  }\n\n  // Support for transactional/batch event handling, where\n  // the user can allow a bunch of events to first collect\n  // before triggering a batch dispatch\n  public static BATCH_EVENTS = \"BatchEvents\";\n  protected _events: TEvent[] = [];\n  protected _inBatchMode = false;\n  startBatchMode(): this {\n    if (!this._inBatchMode) {\n      this._inBatchMode = true;\n    }\n    return this;\n  }\n\n  cancelBatch(): void {\n    this._inBatchMode = false;\n    this._events = [];\n  }\n\n  commitBatch(): void {\n    this._inBatchMode = false;\n    this.emit(EventHub.BATCH_EVENTS, this, this._events);\n    this._events = [];\n  }\n}\n\n/**\n * StateMachines allow declarative and stateful chaining of events.\n */\nexport class StateMachine {\n  private _states: { [key: string]: State } = {};\n  private _rootState: Nullable<State> = null;\n  private _currentState: Nullable<State> = null;\n  constructor() {\n    this._states = {};\n    this._rootState = null;\n    this._currentState = null;\n  }\n\n  /**\n   * The starting/root state of the machine.\n   *\n   * @param {String} name  Name of the default/root state.\n   */\n  set rootState(name: string) {\n    this._rootState = this.getState(name);\n    if (this._currentState == null) {\n      this._currentState = this._rootState;\n    }\n  }\n\n  /**\n   * Exits the current state (if any) and enters a new state.\n   *\n   * @param {String}   state   Name of the new state to enter.\n   * @param {Object}   data    State specific data for the state handler to use for the new state.\n   */\n  enter(state: string, data: any = null): void {\n    if (state == \"\") {\n      this._currentState = this._rootState;\n    } else {\n      this._currentState = this.getState(state);\n    }\n    if (this._currentState != null) {\n      this._currentState.enter(data);\n    }\n  }\n\n  /**\n   * Get the state by name.\n   *\n   * @param {String} name  Name of the state being queried.\n   * @returns {State} State object associated with the name.\n   */\n  getState(name: string): State {\n    if (!(name in this._states)) {\n      throw Error(\"State '\" + name + \"' not yet registered.\");\n    }\n    return this._states[name];\n  }\n\n  /**\n   * Register a new state in the state machine.\n   *\n   * @param {State} state  State being registered.  If another State with\n   * the same name exists, then a {DuplicateError} is thrown.\n   * @param {Bool} isRoot  Whether the new state is a root state.\n   */\n  registerState(state: State, isRoot = false): void {\n    const name = state.name;\n    if (name in this._states) {\n      throw Error(\"State '\" + name + \"' already registered.\");\n    }\n    this._states[name] = state;\n    if (isRoot || false) {\n      this.rootState = state.name;\n    }\n  }\n\n  /**\n   * Handles an event from the current state in the state machine possibly resulting in a state transition.\n   *\n   * @param {Object} name    Type of event being sent.\n   * @param {EventSource} source  The source generating the event.\n   * @param {Object} data    The event specific data.\n   */\n  handle(event: TEvent): void {\n    if (this._currentState == null) return;\n\n    const nextState: any = this._currentState.handle(event);\n    if (nextState != null) {\n      if (nextState == \"\") {\n        if (this._rootState != null) {\n          this.enter(this._rootState.name);\n        } else {\n          throw new Error(\"Root state has not been set\");\n        }\n      } else {\n        this.enter(nextState);\n      }\n    }\n  }\n}\n"]}

package/lib/esm/comms/events.d.ts

@@ -35,10 +35,6 @@ export declare class EventEmitter {
 }
 export declare class EventHub {
     private _handlers;
-    private _muted;
-    get isMuted(): boolean;
-    mute(): void;
-    unmute(): void;
     on(names: Array<string> | string, callback: EventCallback): this;
     removeOn(names: Array<string> | string, callback: EventCallback): this;
     _ensurestrings(names: Array<string> | string): string[];
@@ -50,6 +46,12 @@ export declare class EventHub {
     }, handler: T): this;
     emit(name: string, source: any, payload?: any): boolean;
     dispatchEvent(event: TEvent): boolean;
+    static BATCH_EVENTS: string;
+    protected _events: TEvent[];
+    protected _inBatchMode: boolean;
+    startBatchMode(): this;
+    cancelBatch(): void;
+    commitBatch(): void;
 }
 export declare class StateMachine {
     private _states;

package/lib/esm/comms/events.js

@@ -65,16 +65,8 @@ export class EventEmitter {
 export class EventHub {
     constructor() {
         this._handlers = {};
-        this._muted = false;
-    }
-    get isMuted() {
-        return this._muted;
-    }
-    mute() {
-        this._muted = true;
-    }
-    unmute() {
-        this._muted = false;
+        this._events = [];
+        this._inBatchMode = false;
     }
     on(names, callback) {
         return this._addHandler(names, this._handlers, callback);
@@ -110,7 +102,14 @@ export class EventHub {
         return this;
     }
     emit(name, source, payload) {
-        return this.dispatchEvent(new TEvent(name, source, payload));
+        const evt = new TEvent(name, source, payload);
+        if (this._inBatchMode) {
+            this._events.push(evt);
+            return true;
+        }
+        else {
+            return this.dispatchEvent(evt);
+        }
     }
     dispatchEvent(event) {
         const evtCallbacks = this._handlers[event.name] || [];
@@ -121,7 +120,23 @@ export class EventHub {
         }
         return true;
     }
+    startBatchMode() {
+        if (!this._inBatchMode) {
+            this._inBatchMode = true;
+        }
+        return this;
+    }
+    cancelBatch() {
+        this._inBatchMode = false;
+        this._events = [];
+    }
+    commitBatch() {
+        this._inBatchMode = false;
+        this.emit(EventHub.BATCH_EVENTS, this, this._events);
+        this._events = [];
+    }
 }
+EventHub.BATCH_EVENTS = "BatchEvents";
 export class StateMachine {
     constructor() {
         this._states = {};

package/lib/esm/comms/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/comms/events.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,MAAM;IAiDjB,YAAY,IAAY,EAAE,MAAW,EAAE,OAAa;QA9C3C,SAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAKvB,iBAAY,GAAmB,IAAI,CAAC;QAgB9C,gBAAW,GAAQ,IAAI,CAAC;QAUxB,cAAS,GAAG,KAAK,CAAC;QAKlB,cAAS,GAAc,CAAC,CAAC,CAAC;QAQ1B,aAAQ,GAAa,EAAE,CAAC;QAGtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAES,cAAc,CAAC,GAAmB;QAC1C,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,IAAI,GAAG,IAAI,IAAI;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;;YACnC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,MAAW,EAAE,OAAa;QAC5C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAOD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAkB,CAAC;IACjC,CAAC;;AA7Ec,cAAO,GAAG,CAAC,CAAC;AAgF7B,MAAM,OAAO,KAAK;IAAlB;QAEE,cAAS,GAAQ,IAAI,CAAC;QACb,OAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAahC,CAAC;IAXC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAS;QACb,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,KAAa;IAEpB,CAAC;;AAdc,aAAO,GAAG,CAAC,CAAC;AAmB7B,MAAM,OAAO,YAAY;IAEvB;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IACD,IAAI,QAAQ,CAAC,GAAoB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACS,eAAe,CAAC,MAAuB;QAE/C,OAAO,CAAC,GAAG,CAAC,sDAAsD,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7F,CAAC;CACF;AAED,MAAM,OAAO,QAAQ;IAArB;QACU,cAAS,GAA4C,EAAE,CAAC;QACxD,WAAM,GAAG,KAAK,CAAC;IAgEzB,CAAC;IA9DC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,EAAE,CAAC,KAA6B,EAAE,QAAuB;QACvD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,KAA6B,EAAE,QAAuB;QAC7D,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,KAA6B;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC7B,KAAK,GAAI,KAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACtC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;YAC1B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAI,KAA6B,EAAE,WAAwC,EAAE,OAAU;QAChG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI;YAC/C,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5C,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAI,KAA6B,EAAE,WAAwC,EAAE,OAAU;QACnG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI;YAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBAC1C,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE;oBAC5B,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACxB,MAAM;iBACP;aACF;QACH,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,MAAW,EAAE,OAAa;QAC3C,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACtD,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE;YACnC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,KAAK,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;SACnC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAKD,MAAM,OAAO,YAAY;IAIvB;QAHQ,YAAO,GAA6B,EAAE,CAAC;QACvC,eAAU,GAAoB,IAAI,CAAC;QACnC,kBAAa,GAAoB,IAAI,CAAC;QAE5C,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAOD,IAAI,SAAS,CAAC,IAAY;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE;YAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC;SACtC;IACH,CAAC;IAQD,KAAK,CAAC,KAAa,EAAE,OAAY,IAAI;QACnC,IAAI,KAAK,IAAI,EAAE,EAAE;YACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC;SACtC;aAAM;YACL,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC3C;QACD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAChC;IACH,CAAC;IAQD,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE;YAC3B,MAAM,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,uBAAuB,CAAC,CAAC;SACzD;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IASD,aAAa,CAAC,KAAY,EAAE,MAAM,GAAG,KAAK;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE;YACxB,MAAM,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,uBAAuB,CAAC,CAAC;SACzD;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC3B,IAAI,MAAM,IAAI,KAAK,EAAE;YACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;SAC7B;IACH,CAAC;IASD,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI;YAAE,OAAO;QAEvC,MAAM,SAAS,GAAQ,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,SAAS,IAAI,IAAI,EAAE;YACrB,IAAI,SAAS,IAAI,EAAE,EAAE;gBACnB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE;oBAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;iBAClC;qBAAM;oBACL,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;iBAChD;aACF;iBAAM;gBACL,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;aACvB;SACF;IACH,CAAC;CACF","sourcesContent":["import { Nullable, Timestamp } from \"../types\";\n\n/**\n * Super class of all Events.\n */\nexport class TEvent {\n  // Globally unique ID for all events.\n  private static counter = 0;\n  readonly uuid = TEvent.counter++;\n\n  /**\n   * The event this event was spawned from (if any).\n   */\n  protected _spawnedFrom: Nullable<this> = null;\n\n  /**\n   * Name of the event.\n   */\n  readonly name: string;\n\n  /**\n   * Source from which this event is originating.\n   */\n  readonly source: any;\n\n  /**\n   * Source state that is set by the source of the event only\n   * *it* can use.\n   */\n  sourceState: any = null;\n\n  /**\n   * Event specific payload.\n   */\n  payload: any;\n\n  /**\n   * Whether the event was cancelled.\n   */\n  cancelled = false;\n\n  /**\n   * Timestamp of the event - optional.\n   */\n  timeStamp: Timestamp = -1;\n\n  /**\n   * All child events that were spawned from this Event.\n   * The parent/spawnedFrom and child event references help us\n   * form a call tree/trace of a events as it traverses\n   * the system.\n   */\n  children: TEvent[] = [];\n\n  constructor(name: string, source: any, payload?: any) {\n    this.name = name;\n    this.source = source;\n    this.payload = payload;\n  }\n\n  get spawnedFrom(): Nullable<this> {\n    return this._spawnedFrom;\n  }\n\n  protected setSpawnedFrom(msg: Nullable<this>): void {\n    this._spawnedFrom = msg;\n    if (msg == null) this._rootEvent = this;\n    else this._rootEvent = msg.rootEvent;\n  }\n\n  spawn(name: string, source: any, payload?: any): TEvent {\n    const child = new TEvent(name, source, payload);\n    child.setSpawnedFrom(this);\n    this.children.push(child);\n    return child;\n  }\n\n  /**\n   * The first/root message in the forward chain.\n   */\n  private _rootEvent: this;\n\n  get rootEvent(): this {\n    return this._rootEvent as this;\n  }\n}\n\nexport class State {\n  private static counter = 0;\n  stateData: any = null;\n  readonly id = State.counter++;\n\n  get name(): string {\n    return this.constructor.name;\n  }\n\n  enter(data: any): void {\n    this.stateData = data;\n  }\n\n  handle(event: TEvent): void {\n    // todo\n  }\n}\n\nexport type EventCallback = ((event: TEvent) => void) | ((event: TEvent) => Promise<void>);\n\nexport class EventEmitter {\n  protected _eventHub: EventHub | null;\n  constructor() {\n    this._eventHub = new EventHub();\n  }\n  get eventHub(): EventHub | null {\n    return this._eventHub;\n  }\n  set eventHub(hub: EventHub | null) {\n    const oldHub = this._eventHub;\n    this._eventHub = hub;\n    this.eventHubChanged(oldHub);\n  }\n  protected eventHubChanged(oldHub: EventHub | null): void {\n    // Do nothing\n    console.log(\"WARNING - EventHub Change Listener not implemented: \", this.constructor.name);\n  }\n}\n\nexport class EventHub {\n  private _handlers: { [key: string]: Array<EventCallback> } = {};\n  private _muted = false;\n\n  get isMuted(): boolean {\n    return this._muted;\n  }\n\n  mute(): void {\n    this._muted = true;\n  }\n\n  unmute(): void {\n    this._muted = false;\n  }\n\n  on(names: Array<string> | string, callback: EventCallback): this {\n    return this._addHandler(names, this._handlers, callback);\n  }\n\n  removeOn(names: Array<string> | string, callback: EventCallback): this {\n    return this._removeHandler(names, this._handlers, callback);\n  }\n\n  _ensurestrings(names: Array<string> | string): string[] {\n    if (typeof names === \"string\") {\n      names = (names as string).split(\",\");\n    }\n    return names.map(function (v) {\n      return v.trim();\n    });\n  }\n\n  _addHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      handlerlist[name] = handlerlist[name] || [];\n      handlerlist[name].push(handler);\n    });\n    return this;\n  }\n\n  _removeHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      const evHandlers = handlerlist[name] || [];\n      for (let i = 0; i < evHandlers.length; i++) {\n        if (evHandlers[i] == handler) {\n          evHandlers.splice(i, 1);\n          break;\n        }\n      }\n    });\n    return this;\n  }\n\n  emit(name: string, source: any, payload?: any): boolean {\n    return this.dispatchEvent(new TEvent(name, source, payload));\n  }\n\n  dispatchEvent(event: TEvent): boolean {\n    const evtCallbacks = this._handlers[event.name] || [];\n    for (const callback of evtCallbacks) {\n      callback(event);\n      if (event.cancelled) return false;\n    }\n    return true;\n  }\n}\n\n/**\n * StateMachines allow declarative and stateful chaining of events.\n */\nexport class StateMachine {\n  private _states: { [key: string]: State } = {};\n  private _rootState: Nullable<State> = null;\n  private _currentState: Nullable<State> = null;\n  constructor() {\n    this._states = {};\n    this._rootState = null;\n    this._currentState = null;\n  }\n\n  /**\n   * The starting/root state of the machine.\n   *\n   * @param {String} name  Name of the default/root state.\n   */\n  set rootState(name: string) {\n    this._rootState = this.getState(name);\n    if (this._currentState == null) {\n      this._currentState = this._rootState;\n    }\n  }\n\n  /**\n   * Exits the current state (if any) and enters a new state.\n   *\n   * @param {String}   state   Name of the new state to enter.\n   * @param {Object}   data    State specific data for the state handler to use for the new state.\n   */\n  enter(state: string, data: any = null): void {\n    if (state == \"\") {\n      this._currentState = this._rootState;\n    } else {\n      this._currentState = this.getState(state);\n    }\n    if (this._currentState != null) {\n      this._currentState.enter(data);\n    }\n  }\n\n  /**\n   * Get the state by name.\n   *\n   * @param {String} name  Name of the state being queried.\n   * @returns {State} State object associated with the name.\n   */\n  getState(name: string): State {\n    if (!(name in this._states)) {\n      throw Error(\"State '\" + name + \"' not yet registered.\");\n    }\n    return this._states[name];\n  }\n\n  /**\n   * Register a new state in the state machine.\n   *\n   * @param {State} state  State being registered.  If another State with\n   * the same name exists, then a {DuplicateError} is thrown.\n   * @param {Bool} isRoot  Whether the new state is a root state.\n   */\n  registerState(state: State, isRoot = false): void {\n    const name = state.name;\n    if (name in this._states) {\n      throw Error(\"State '\" + name + \"' already registered.\");\n    }\n    this._states[name] = state;\n    if (isRoot || false) {\n      this.rootState = state.name;\n    }\n  }\n\n  /**\n   * Handles an event from the current state in the state machine possibly resulting in a state transition.\n   *\n   * @param {Object} name    Type of event being sent.\n   * @param {EventSource} source  The source generating the event.\n   * @param {Object} data    The event specific data.\n   */\n  handle(event: TEvent): void {\n    if (this._currentState == null) return;\n\n    const nextState: any = this._currentState.handle(event);\n    if (nextState != null) {\n      if (nextState == \"\") {\n        if (this._rootState != null) {\n          this.enter(this._rootState.name);\n        } else {\n          throw new Error(\"Root state has not been set\");\n        }\n      } else {\n        this.enter(nextState);\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/comms/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { Nullable, Timestamp } from \"../types\";\n\n/**\n * Super class of all Events.\n */\nexport class TEvent {\n  // Globally unique ID for all events.\n  private static counter = 0;\n  readonly uuid = TEvent.counter++;\n\n  /**\n   * The event this event was spawned from (if any).\n   */\n  protected _spawnedFrom: Nullable<this> = null;\n\n  /**\n   * Name of the event.\n   */\n  readonly name: string;\n\n  /**\n   * Source from which this event is originating.\n   */\n  readonly source: any;\n\n  /**\n   * Source state that is set by the source of the event only\n   * *it* can use.\n   */\n  sourceState: any = null;\n\n  /**\n   * Event specific payload.\n   */\n  payload: any;\n\n  /**\n   * Whether the event was cancelled.\n   */\n  cancelled = false;\n\n  /**\n   * Timestamp of the event - optional.\n   */\n  timeStamp: Timestamp = -1;\n\n  /**\n   * All child events that were spawned from this Event.\n   * The parent/spawnedFrom and child event references help us\n   * form a call tree/trace of a events as it traverses\n   * the system.\n   */\n  children: TEvent[] = [];\n\n  constructor(name: string, source: any, payload?: any) {\n    this.name = name;\n    this.source = source;\n    this.payload = payload;\n  }\n\n  get spawnedFrom(): Nullable<this> {\n    return this._spawnedFrom;\n  }\n\n  protected setSpawnedFrom(msg: Nullable<this>): void {\n    this._spawnedFrom = msg;\n    if (msg == null) this._rootEvent = this;\n    else this._rootEvent = msg.rootEvent;\n  }\n\n  spawn(name: string, source: any, payload?: any): TEvent {\n    const child = new TEvent(name, source, payload);\n    child.setSpawnedFrom(this);\n    this.children.push(child);\n    return child;\n  }\n\n  /**\n   * The first/root message in the forward chain.\n   */\n  private _rootEvent: this;\n\n  get rootEvent(): this {\n    return this._rootEvent as this;\n  }\n}\n\nexport class State {\n  private static counter = 0;\n  stateData: any = null;\n  readonly id = State.counter++;\n\n  get name(): string {\n    return this.constructor.name;\n  }\n\n  enter(data: any): void {\n    this.stateData = data;\n  }\n\n  handle(event: TEvent): void {\n    // todo\n  }\n}\n\nexport type EventCallback = ((event: TEvent) => void) | ((event: TEvent) => Promise<void>);\n\nexport class EventEmitter {\n  protected _eventHub: EventHub | null;\n  constructor() {\n    this._eventHub = new EventHub();\n  }\n  get eventHub(): EventHub | null {\n    return this._eventHub;\n  }\n  set eventHub(hub: EventHub | null) {\n    const oldHub = this._eventHub;\n    this._eventHub = hub;\n    this.eventHubChanged(oldHub);\n  }\n  protected eventHubChanged(oldHub: EventHub | null): void {\n    // Do nothing\n    console.log(\"WARNING - EventHub Change Listener not implemented: \", this.constructor.name);\n  }\n}\n\nexport class EventHub {\n  private _handlers: { [key: string]: Array<EventCallback> } = {};\n\n  on(names: Array<string> | string, callback: EventCallback): this {\n    return this._addHandler(names, this._handlers, callback);\n  }\n\n  removeOn(names: Array<string> | string, callback: EventCallback): this {\n    return this._removeHandler(names, this._handlers, callback);\n  }\n\n  _ensurestrings(names: Array<string> | string): string[] {\n    if (typeof names === \"string\") {\n      names = (names as string).split(\",\");\n    }\n    return names.map(function (v) {\n      return v.trim();\n    });\n  }\n\n  _addHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      handlerlist[name] = handlerlist[name] || [];\n      handlerlist[name].push(handler);\n    });\n    return this;\n  }\n\n  _removeHandler<T>(names: Array<string> | string, handlerlist: { [key: string]: Array<T> }, handler: T): this {\n    this._ensurestrings(names).forEach(function (name) {\n      const evHandlers = handlerlist[name] || [];\n      for (let i = 0; i < evHandlers.length; i++) {\n        if (evHandlers[i] == handler) {\n          evHandlers.splice(i, 1);\n          break;\n        }\n      }\n    });\n    return this;\n  }\n\n  emit(name: string, source: any, payload?: any): boolean {\n    const evt = new TEvent(name, source, payload);\n    if (this._inBatchMode) {\n      this._events.push(evt);\n      return true;\n    } else {\n      return this.dispatchEvent(evt);\n    }\n  }\n\n  dispatchEvent(event: TEvent): boolean {\n    const evtCallbacks = this._handlers[event.name] || [];\n    for (const callback of evtCallbacks) {\n      callback(event);\n      if (event.cancelled) return false;\n    }\n    return true;\n  }\n\n  // Support for transactional/batch event handling, where\n  // the user can allow a bunch of events to first collect\n  // before triggering a batch dispatch\n  public static BATCH_EVENTS = \"BatchEvents\";\n  protected _events: TEvent[] = [];\n  protected _inBatchMode = false;\n  startBatchMode(): this {\n    if (!this._inBatchMode) {\n      this._inBatchMode = true;\n    }\n    return this;\n  }\n\n  cancelBatch(): void {\n    this._inBatchMode = false;\n    this._events = [];\n  }\n\n  commitBatch(): void {\n    this._inBatchMode = false;\n    this.emit(EventHub.BATCH_EVENTS, this, this._events);\n    this._events = [];\n  }\n}\n\n/**\n * StateMachines allow declarative and stateful chaining of events.\n */\nexport class StateMachine {\n  private _states: { [key: string]: State } = {};\n  private _rootState: Nullable<State> = null;\n  private _currentState: Nullable<State> = null;\n  constructor() {\n    this._states = {};\n    this._rootState = null;\n    this._currentState = null;\n  }\n\n  /**\n   * The starting/root state of the machine.\n   *\n   * @param {String} name  Name of the default/root state.\n   */\n  set rootState(name: string) {\n    this._rootState = this.getState(name);\n    if (this._currentState == null) {\n      this._currentState = this._rootState;\n    }\n  }\n\n  /**\n   * Exits the current state (if any) and enters a new state.\n   *\n   * @param {String}   state   Name of the new state to enter.\n   * @param {Object}   data    State specific data for the state handler to use for the new state.\n   */\n  enter(state: string, data: any = null): void {\n    if (state == \"\") {\n      this._currentState = this._rootState;\n    } else {\n      this._currentState = this.getState(state);\n    }\n    if (this._currentState != null) {\n      this._currentState.enter(data);\n    }\n  }\n\n  /**\n   * Get the state by name.\n   *\n   * @param {String} name  Name of the state being queried.\n   * @returns {State} State object associated with the name.\n   */\n  getState(name: string): State {\n    if (!(name in this._states)) {\n      throw Error(\"State '\" + name + \"' not yet registered.\");\n    }\n    return this._states[name];\n  }\n\n  /**\n   * Register a new state in the state machine.\n   *\n   * @param {State} state  State being registered.  If another State with\n   * the same name exists, then a {DuplicateError} is thrown.\n   * @param {Bool} isRoot  Whether the new state is a root state.\n   */\n  registerState(state: State, isRoot = false): void {\n    const name = state.name;\n    if (name in this._states) {\n      throw Error(\"State '\" + name + \"' already registered.\");\n    }\n    this._states[name] = state;\n    if (isRoot || false) {\n      this.rootState = state.name;\n    }\n  }\n\n  /**\n   * Handles an event from the current state in the state machine possibly resulting in a state transition.\n   *\n   * @param {Object} name    Type of event being sent.\n   * @param {EventSource} source  The source generating the event.\n   * @param {Object} data    The event specific data.\n   */\n  handle(event: TEvent): void {\n    if (this._currentState == null) return;\n\n    const nextState: any = this._currentState.handle(event);\n    if (nextState != null) {\n      if (nextState == \"\") {\n        if (this._rootState != null) {\n          this.enter(this._rootState.name);\n        } else {\n          throw new Error(\"Root state has not been set\");\n        }\n      } else {\n        this.enter(nextState);\n      }\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panyam/tsutils",
-  "version": "0.0.63",
+  "version": "0.0.64",
   "author": "Sriram Panyam",
   "description": "Some basic TS utils for personal use",
   "homepage": "https://github.com/panyam/tsutils#readme",