@featurevisor/sdk 0.12.1 → 0.13.0

package/lib/createInstance.js

@@ -1,14 +1,16 @@
 import { FeaturevisorSDK } from "./client";
 import { createLogger } from "./logger";
+import { Emitter } from "./emitter";
 function fetchDatafileContent(datafileUrl, options) {
     if (options.handleDatafileFetch) {
         return options.handleDatafileFetch(datafileUrl);
     }
     return fetch(datafileUrl).then(function (res) { return res.json(); });
 }
-function getInstanceFromSdk(sdk, options, logger) {
+function getInstanceFromSdk(sdk, options, logger, emitter, statuses) {
     var intervalId;
-    var refreshInProgress = false;
+    var on = emitter.addListener.bind(emitter);
+    var off = emitter.removeListener.bind(emitter);
     var instance = {
         // variation
         getVariation: sdk.getVariation.bind(sdk),
@@ -32,15 +34,22 @@ function getInstanceFromSdk(sdk, options, logger) {
         getVariableObject: sdk.getVariableObject.bind(sdk),
         // additions
         setLogLevels: logger.setLevels.bind(logger),
+        // emitter
+        on: on,
+        addListener: on,
+        off: off,
+        removeListener: off,
+        removeAllListeners: emitter.removeAllListeners.bind(emitter),
+        // refresh
         refresh: function () {
             logger.debug("refreshing datafile");
-            if (refreshInProgress) {
+            if (statuses.refreshInProgress) {
                 return logger.warn("refresh in progress, skipping");
             }
             if (!options.datafileUrl) {
                 return logger.error("cannot refresh since `datafileUrl` is not provided");
             }
-            refreshInProgress = true;
+            statuses.refreshInProgress = true;
             fetchDatafileContent(options.datafileUrl, options)
                 .then(function (datafile) {
                 var currentRevision = sdk.getRevision();
@@ -48,17 +57,15 @@ function getInstanceFromSdk(sdk, options, logger) {
                 var isNotSameRevision = currentRevision !== newRevision;
                 sdk.setDatafile(datafile);
                 logger.info("refreshed datafile");
-                if (typeof options.onRefresh === "function") {
-                    options.onRefresh();
+                emitter.emit("refresh");
+                if (isNotSameRevision) {
+                    emitter.emit("update");
                 }
-                if (isNotSameRevision && typeof options.onUpdate === "function") {
-                    options.onUpdate();
-                }
-                refreshInProgress = false;
+                statuses.refreshInProgress = false;
             })
                 .catch(function (e) {
                 logger.error("failed to refresh datafile", { error: e });
-                refreshInProgress = false;
+                statuses.refreshInProgress = false;
             });
         },
         startRefreshing: function () {
@@ -81,6 +88,9 @@ function getInstanceFromSdk(sdk, options, logger) {
             }
             clearInterval(intervalId);
         },
+        isReady: function () {
+            return statuses.ready;
+        },
     };
     if (options.datafileUrl && options.refreshInterval) {
         instance.startRefreshing();
@@ -99,9 +109,26 @@ export function createInstance(options) {
         throw new Error("Featurevisor SDK instance cannot be created without both `datafile` and `datafileUrl` options");
     }
     var logger = options.logger || createLogger();
+    var emitter = new Emitter();
+    var statuses = {
+        ready: false,
+        refreshInProgress: false,
+    };
     if (!options.datafileUrl && options.refreshInterval) {
         logger.warn("refreshing datafile requires `datafileUrl` option");
     }
+    if (options.onReady) {
+        emitter.addListener("ready", options.onReady);
+    }
+    if (options.onActivation) {
+        emitter.addListener("activation", options.onActivation);
+    }
+    if (options.onRefresh) {
+        emitter.addListener("refresh", options.onRefresh);
+    }
+    if (options.onUpdate) {
+        emitter.addListener("update", options.onUpdate);
+    }
     // datafile content is already provided
     if (options.datafile) {
         var sdk_1 = new FeaturevisorSDK({
@@ -109,15 +136,15 @@ export function createInstance(options) {
             onActivation: options.onActivation,
             configureBucketValue: options.configureBucketValue,
             logger: logger,
+            emitter: emitter,
             interceptAttributes: options.interceptAttributes,
+            fromInstance: true,
         });
-        if (typeof options.onReady === "function") {
-            var onReady_1 = options.onReady;
-            setTimeout(function () {
-                onReady_1();
-            }, 0);
-        }
-        return getInstanceFromSdk(sdk_1, options, logger);
+        statuses.ready = true;
+        setTimeout(function () {
+            emitter.emit("ready");
+        }, 0);
+        return getInstanceFromSdk(sdk_1, options, logger, emitter, statuses);
     }
     // datafile has to be fetched
     var sdk = new FeaturevisorSDK({
@@ -125,21 +152,22 @@ export function createInstance(options) {
         onActivation: options.onActivation,
         configureBucketValue: options.configureBucketValue,
         logger: logger,
+        emitter: emitter,
         interceptAttributes: options.interceptAttributes,
+        fromInstance: true,
     });
     if (options.datafileUrl) {
         fetchDatafileContent(options.datafileUrl, options)
             .then(function (datafile) {
             sdk.setDatafile(datafile);
-            if (typeof options.onReady === "function") {
-                options.onReady();
-            }
+            statuses.ready = true;
+            emitter.emit("ready");
         })
             .catch(function (e) {
             logger.error("failed to fetch datafile:");
             console.error(e);
         });
     }
-    return getInstanceFromSdk(sdk, options, logger);
+    return getInstanceFromSdk(sdk, options, logger, emitter, statuses);
 }
 //# sourceMappingURL=createInstance.js.map

package/lib/createInstance.js.map

@@ -1 +1 @@
-{"version":3,"file":"createInstance.js","sourceRoot":"","sources":["../src/createInstance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createInstance.js","sourceRoot":"","sources":["../src/createInstance.ts"],"names":[],"mappings":"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"}

package/lib/emitter.d.ts

@@ -0,0 +1,12 @@
+export type EventName = "ready" | "refresh" | "update" | "activation";
+export interface Listeners {
+    [key: string]: Function[];
+}
+export declare class Emitter {
+    private _listeners;
+    constructor();
+    addListener(eventName: EventName, fn: Function): void;
+    removeListener(eventName: EventName, fn: Function): void;
+    removeAllListeners(eventName?: EventName): void;
+    emit(eventName: EventName, ...args: any[]): void;
+}

package/lib/emitter.js

@@ -0,0 +1,46 @@
+var Emitter = /** @class */ (function () {
+    function Emitter() {
+        this._listeners = {};
+    }
+    Emitter.prototype.addListener = function (eventName, fn) {
+        if (typeof this._listeners[eventName] === "undefined") {
+            this._listeners[eventName] = [];
+        }
+        this._listeners[eventName].push(fn);
+    };
+    Emitter.prototype.removeListener = function (eventName, fn) {
+        if (typeof this._listeners[eventName] === "undefined") {
+            return;
+        }
+        var index = this._listeners[eventName].indexOf(fn);
+        if (index !== -1) {
+            this._listeners[eventName].splice(index, 1);
+        }
+    };
+    Emitter.prototype.removeAllListeners = function (eventName) {
+        var _this = this;
+        if (eventName) {
+            this._listeners[eventName] = [];
+        }
+        else {
+            Object.keys(this._listeners).forEach(function (key) {
+                _this._listeners[key] = [];
+            });
+        }
+    };
+    Emitter.prototype.emit = function (eventName) {
+        var args = [];
+        for (var _i = 1; _i < arguments.length; _i++) {
+            args[_i - 1] = arguments[_i];
+        }
+        if (typeof this._listeners[eventName] === "undefined") {
+            return;
+        }
+        this._listeners[eventName].forEach(function (fn) {
+            fn.apply(void 0, args);
+        });
+    };
+    return Emitter;
+}());
+export { Emitter };
+//# sourceMappingURL=emitter.js.map

package/lib/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAMA;IAGE;QACE,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAEM,6BAAW,GAAlB,UAAmB,SAAoB,EAAE,EAAY;QACnD,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE;YACrD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;SACjC;QAED,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAEM,gCAAc,GAArB,UAAsB,SAAoB,EAAE,EAAY;QACtD,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE;YACrD,OAAO;SACR;QAED,IAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAErD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;YAChB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;SAC7C;IACH,CAAC;IAEM,oCAAkB,GAAzB,UAA0B,SAAqB;QAA/C,iBAQC;QAPC,IAAI,SAAS,EAAE;YACb,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;SACjC;aAAM;YACL,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAC,GAAG;gBACvC,KAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;SACJ;IACH,CAAC;IAEM,sBAAI,GAAX,UAAY,SAAoB;QAAE,cAAc;aAAd,UAAc,EAAd,qBAAc,EAAd,IAAc;YAAd,6BAAc;;QAC9C,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE;YACrD,OAAO;SACR;QAED,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAC,EAAE;YACpC,EAAE,eAAI,IAAI,EAAE;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACH,cAAC;AAAD,CAAC,AA9CD,IA8CC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/sdk",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Featurevisor SDK for Node.js and the browser",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -42,9 +42,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/types": "^0.12.0",
+    "@featurevisor/types": "^0.13.0",
     "compare-versions": "^6.0.0-rc.1",
     "murmurhash": "^2.0.1"
   },
-  "gitHead": "b7211a7777145fbf1629ca1af0b2da3578cbfc16"
+  "gitHead": "84bc69876c7b5ea080d0dff53b305bd47b3d43e1"
 }

package/src/client.ts

@@ -19,6 +19,7 @@ import {
 } from "./feature";
 import { getBucketedNumber } from "./bucket";
 import { createLogger, Logger } from "./logger";
+import { Emitter } from "./emitter";
 
 export type ActivationCallback = (
   featureName: string,
@@ -34,7 +35,9 @@ export interface SdkOptions {
   onActivation?: ActivationCallback; // @TODO: move it to FeaturevisorInstance in next breaking semver
   configureBucketValue?: ConfigureBucketValue;
   logger?: Logger; // @TODO: keep it in FeaturevisorInstance only in next breaking semver
+  emitter?: Emitter; // @TODO: keep it in FeaturevisorInstance only in next breaking semver
   interceptAttributes?: (attributes: Attributes) => Attributes; // @TODO: move it to FeaturevisorInstance in next breaking semver
+  fromInstance?: boolean;
 }
 
 type FieldType = VariationType | VariableType;
@@ -71,7 +74,9 @@ export class FeaturevisorSDK {
   private datafileReader: DatafileReader;
   private configureBucketValue?: ConfigureBucketValue;
   private logger: Logger;
+  private emitter?: Emitter;
   private interceptAttributes?: (attributes: Attributes) => Attributes;
+  private fromInstance: boolean;
 
   constructor(options: SdkOptions) {
     if (options.onActivation) {
@@ -88,7 +93,13 @@ export class FeaturevisorSDK {
       this.interceptAttributes = options.interceptAttributes;
     }
 
+    if (options.emitter) {
+      this.emitter = options.emitter;
+    }
+
     this.setDatafile(options.datafile);
+
+    this.fromInstance = options.fromInstance || false;
   }
 
   setDatafile(datafile: DatafileContent | string) {
@@ -243,23 +254,33 @@ export class FeaturevisorSDK {
         return undefined;
       }
 
-      if (this.onActivation) {
-        const finalAttributes = this.interceptAttributes
-          ? this.interceptAttributes(attributes)
-          : attributes;
+      const finalAttributes = this.interceptAttributes
+        ? this.interceptAttributes(attributes)
+        : attributes;
+
+      const captureAttributes: Attributes = {};
 
-        const captureAttributes: Attributes = {};
+      const attributesForCapturing = this.datafileReader
+        .getAllAttributes()
+        .filter((a) => a.capture === true);
 
-        const attributesForCapturing = this.datafileReader
-          .getAllAttributes()
-          .filter((a) => a.capture === true);
+      attributesForCapturing.forEach((a) => {
+        if (typeof finalAttributes[a.key] !== "undefined") {
+          captureAttributes[a.key] = attributes[a.key];
+        }
+      });
 
-        attributesForCapturing.forEach((a) => {
-          if (typeof finalAttributes[a.key] !== "undefined") {
-            captureAttributes[a.key] = attributes[a.key];
-          }
-        });
+      if (this.emitter) {
+        this.emitter.emit(
+          "activation",
+          featureKey,
+          variationValue,
+          finalAttributes,
+          captureAttributes,
+        );
+      }
 
+      if (this.fromInstance && this.onActivation) {
         this.onActivation(featureKey, variationValue, finalAttributes, captureAttributes);
       }
 

package/src/createInstance.spec.ts

@@ -21,6 +21,28 @@ describe("sdk: createInstance", function () {
     expect(typeof sdk.getVariation).toEqual("function");
   });
 
+  it("should trigger onReady event once", function (done) {
+    let readyCount = 0;
+
+    const sdk = createInstance({
+      datafile: {
+        schemaVersion: "1",
+        revision: "1.0",
+        features: [],
+        attributes: [],
+        segments: [],
+      },
+      onReady: () => {
+        readyCount += 1;
+      },
+    });
+
+    setTimeout(() => {
+      expect(readyCount).toEqual(1);
+      done();
+    }, 0);
+  });
+
   it("should intercept attributes", function () {
     let intercepted = false;
 
@@ -126,10 +148,14 @@ describe("sdk: createInstance", function () {
       },
     });
 
+    expect(sdk.isReady()).toEqual(false);
+
     setTimeout(function () {
       expect(refreshed).toEqual(true);
       expect(updated).toEqual(true);
 
+      expect(sdk.isReady()).toEqual(true);
+
       sdk.stopRefreshing();
 
       done();

package/src/createInstance.ts

@@ -1,6 +1,7 @@
 import { DatafileContent, Attributes } from "@featurevisor/types";
 import { FeaturevisorSDK, ConfigureBucketValue, ActivationCallback } from "./client";
 import { createLogger, Logger } from "./logger";
+import { Emitter } from "./emitter";
 
 export type ReadyCallback = () => void;
 
@@ -21,6 +22,8 @@ export interface InstanceOptions {
   onUpdate?: () => void;
 }
 
+export type Event = "ready" | "refresh" | "update" | "activation";
+
 // @TODO: consider renaming it to FeaturevisorSDK in next breaking semver
 export interface FeaturevisorInstance {
   /**
@@ -54,9 +57,18 @@ export interface FeaturevisorInstance {
    * Additions
    */
   setLogLevels: Logger["setLevels"];
+
   refresh: () => void;
   startRefreshing: () => void;
   stopRefreshing: () => void;
+
+  addListener: Emitter["addListener"];
+  on: Emitter["addListener"];
+  removeListener: Emitter["removeListener"];
+  off: Emitter["removeListener"];
+  removeAllListeners: Emitter["removeAllListeners"];
+
+  isReady: () => boolean;
 }
 
 function fetchDatafileContent(datafileUrl, options: InstanceOptions): Promise<DatafileContent> {
@@ -67,13 +79,26 @@ function fetchDatafileContent(datafileUrl, options: InstanceOptions): Promise<Da
   return fetch(datafileUrl).then((res) => res.json());
 }
 
+interface Listeners {
+  [key: string]: Function[];
+}
+
+interface Statuses {
+  ready: boolean;
+  refreshInProgress: boolean;
+}
+
 function getInstanceFromSdk(
   sdk: FeaturevisorSDK,
   options: InstanceOptions,
   logger: Logger,
+  emitter: Emitter,
+  statuses: Statuses,
 ): FeaturevisorInstance {
   let intervalId;
-  let refreshInProgress = false;
+
+  const on = emitter.addListener.bind(emitter);
+  const off = emitter.removeListener.bind(emitter);
 
   const instance: FeaturevisorInstance = {
     // variation
@@ -102,10 +127,18 @@ function getInstanceFromSdk(
     // additions
     setLogLevels: logger.setLevels.bind(logger),
 
+    // emitter
+    on: on,
+    addListener: on,
+    off: off,
+    removeListener: off,
+    removeAllListeners: emitter.removeAllListeners.bind(emitter),
+
+    // refresh
     refresh() {
       logger.debug("refreshing datafile");
 
-      if (refreshInProgress) {
+      if (statuses.refreshInProgress) {
         return logger.warn("refresh in progress, skipping");
       }
 
@@ -113,7 +146,7 @@ function getInstanceFromSdk(
         return logger.error("cannot refresh since `datafileUrl` is not provided");
       }
 
-      refreshInProgress = true;
+      statuses.refreshInProgress = true;
 
       fetchDatafileContent(options.datafileUrl, options)
         .then((datafile) => {
@@ -124,19 +157,17 @@ function getInstanceFromSdk(
           sdk.setDatafile(datafile);
           logger.info("refreshed datafile");
 
-          if (typeof options.onRefresh === "function") {
-            options.onRefresh();
-          }
+          emitter.emit("refresh");
 
-          if (isNotSameRevision && typeof options.onUpdate === "function") {
-            options.onUpdate();
+          if (isNotSameRevision) {
+            emitter.emit("update");
           }
 
-          refreshInProgress = false;
+          statuses.refreshInProgress = false;
         })
         .catch((e) => {
           logger.error("failed to refresh datafile", { error: e });
-          refreshInProgress = false;
+          statuses.refreshInProgress = false;
         });
     },
 
@@ -165,6 +196,10 @@ function getInstanceFromSdk(
 
       clearInterval(intervalId);
     },
+
+    isReady() {
+      return statuses.ready;
+    },
   };
 
   if (options.datafileUrl && options.refreshInterval) {
@@ -190,11 +225,32 @@ export function createInstance(options: InstanceOptions) {
   }
 
   const logger = options.logger || createLogger();
+  const emitter = new Emitter();
+  const statuses: Statuses = {
+    ready: false,
+    refreshInProgress: false,
+  };
 
   if (!options.datafileUrl && options.refreshInterval) {
     logger.warn("refreshing datafile requires `datafileUrl` option");
   }
 
+  if (options.onReady) {
+    emitter.addListener("ready", options.onReady);
+  }
+
+  if (options.onActivation) {
+    emitter.addListener("activation", options.onActivation);
+  }
+
+  if (options.onRefresh) {
+    emitter.addListener("refresh", options.onRefresh);
+  }
+
+  if (options.onUpdate) {
+    emitter.addListener("update", options.onUpdate);
+  }
+
   // datafile content is already provided
   if (options.datafile) {
     const sdk = new FeaturevisorSDK({
@@ -202,18 +258,17 @@ export function createInstance(options: InstanceOptions) {
       onActivation: options.onActivation,
       configureBucketValue: options.configureBucketValue,
       logger,
+      emitter,
       interceptAttributes: options.interceptAttributes,
+      fromInstance: true,
     });
 
-    if (typeof options.onReady === "function") {
-      const onReady = options.onReady;
-
-      setTimeout(function () {
-        onReady();
-      }, 0);
-    }
+    statuses.ready = true;
+    setTimeout(function () {
+      emitter.emit("ready");
+    }, 0);
 
-    return getInstanceFromSdk(sdk, options, logger);
+    return getInstanceFromSdk(sdk, options, logger, emitter, statuses);
   }
 
   // datafile has to be fetched
@@ -222,7 +277,9 @@ export function createInstance(options: InstanceOptions) {
     onActivation: options.onActivation,
     configureBucketValue: options.configureBucketValue,
     logger,
+    emitter,
     interceptAttributes: options.interceptAttributes,
+    fromInstance: true,
   });
 
   if (options.datafileUrl) {
@@ -230,9 +287,8 @@ export function createInstance(options: InstanceOptions) {
       .then((datafile) => {
         sdk.setDatafile(datafile);
 
-        if (typeof options.onReady === "function") {
-          options.onReady();
-        }
+        statuses.ready = true;
+        emitter.emit("ready");
       })
       .catch((e) => {
         logger.error("failed to fetch datafile:");
@@ -240,5 +296,5 @@ export function createInstance(options: InstanceOptions) {
       });
   }
 
-  return getInstanceFromSdk(sdk, options, logger);
+  return getInstanceFromSdk(sdk, options, logger, emitter, statuses);
 }

package/src/emitter.ts

@@ -0,0 +1,53 @@
+export type EventName = "ready" | "refresh" | "update" | "activation";
+
+export interface Listeners {
+  [key: string]: Function[];
+}
+
+export class Emitter {
+  private _listeners: Listeners;
+
+  constructor() {
+    this._listeners = {};
+  }
+
+  public addListener(eventName: EventName, fn: Function): void {
+    if (typeof this._listeners[eventName] === "undefined") {
+      this._listeners[eventName] = [];
+    }
+
+    this._listeners[eventName].push(fn);
+  }
+
+  public removeListener(eventName: EventName, fn: Function): void {
+    if (typeof this._listeners[eventName] === "undefined") {
+      return;
+    }
+
+    const index = this._listeners[eventName].indexOf(fn);
+
+    if (index !== -1) {
+      this._listeners[eventName].splice(index, 1);
+    }
+  }
+
+  public removeAllListeners(eventName?: EventName): void {
+    if (eventName) {
+      this._listeners[eventName] = [];
+    } else {
+      Object.keys(this._listeners).forEach((key) => {
+        this._listeners[key] = [];
+      });
+    }
+  }
+
+  public emit(eventName: EventName, ...args: any[]): void {
+    if (typeof this._listeners[eventName] === "undefined") {
+      return;
+    }
+
+    this._listeners[eventName].forEach((fn) => {
+      fn(...args);
+    });
+  }
+}