@kameleoon/react-sdk 2.1.0 → 4.0.1

package/dist/useActivateFeature.d.ts

@@ -1,9 +1,11 @@
+import { KameleoonError } from './KameleoonError';
 interface ActivateFeatureHookResult {
     /**
      * @param visitorCode - unique identifier of the user
      * @param featureKey - unique identifier or key of the feature you want to expose to a user
      */
-    hasFeature: (visitorCode: string, featureKey: string | number) => boolean;
+    hasFeature: (featureKey: string | number, visitorCode?: string) => boolean;
+    error: KameleoonError | null;
 }
 /**
  * A React Hook that returns callback function which activates a feature toggle

package/dist/useActivateFeature.js

@@ -4,19 +4,31 @@ exports.useActivateFeature = void 0;
 var react_1 = require("react");
 var useKameleoon_1 = require("./useKameleoon");
 var ProviderError_1 = require("./ProviderError");
+var useError_1 = require("./useError");
+var useVisitorCode_1 = require("./useVisitorCode");
 /**
  * A React Hook that returns callback function which activates a feature toggle
  */
 function useActivateFeature() {
     var client = (0, useKameleoon_1.useKameleoon)().client;
-    var hasFeature = (0, react_1.useCallback)(function (visitorCode, featureKey) {
-        return client.activateFeature(visitorCode, featureKey);
-    }, [client]);
+    var _a = (0, useError_1.useError)(), error = _a.error, setError = _a.setError;
+    var getVisitorCode = (0, useVisitorCode_1.useVisitorCode)().getVisitorCode;
+    var hasFeature = (0, react_1.useCallback)(function (featureKey, visitorCode) {
+        try {
+            var userCode = visitorCode !== null && visitorCode !== void 0 ? visitorCode : getVisitorCode('');
+            return client.activateFeature(userCode, featureKey);
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return false;
+        }
+    }, [client, getVisitorCode, setError]);
     if (!client) {
         throw new ProviderError_1.ProviderError('useActivateFeature');
     }
     return {
         hasFeature: hasFeature,
+        error: error,
     };
 }
 exports.useActivateFeature = useActivateFeature;

package/dist/useActivateFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"useActivateFeature.js","sourceRoot":"","sources":["../src/useActivateFeature.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAC9C,iDAAgD;AAUhD;;GAEG;AACH,SAAgB,kBAAkB;IACxB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,UAAU,GAAG,IAAA,mBAAW,EAC5B,UAAC,WAAmB,EAAE,UAA2B;QAC/C,OAAA,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC;IAA/C,CAA+C,EACjD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,6BAAa,CAAC,oBAAoB,CAAC,CAAC;KAC/C;IAED,OAAO;QACL,UAAU,YAAA;KACX,CAAC;AACJ,CAAC;AAhBD,gDAgBC"}
+{"version":3,"file":"useActivateFeature.js","sourceRoot":"","sources":["../src/useActivateFeature.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAC9C,iDAAgD;AAEhD,uCAAsC;AACtC,mDAAkD;AAWlD;;GAEG;AACH,SAAgB,kBAAkB;IACxB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAC5B,IAAA,KAAsB,IAAA,mBAAQ,GAAE,EAA9B,KAAK,WAAA,EAAE,QAAQ,cAAe,CAAC;IAC/B,IAAA,cAAc,GAAK,IAAA,+BAAc,GAAE,eAArB,CAAsB;IAE5C,IAAM,UAAU,GAAG,IAAA,mBAAW,EAC5B,UAAC,UAA2B,EAAE,WAAoB;QAChD,IAAI;YACF,IAAM,QAAQ,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,cAAc,CAAC,EAAE,CAAC,CAAC;YAEnD,OAAO,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;SACrD;QAAC,OAAO,YAAY,EAAE;YACrB,QAAQ,CAAC,YAAY,CAAC,CAAC;YAEvB,OAAO,KAAK,CAAC;SACd;IACH,CAAC,EACD,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,6BAAa,CAAC,oBAAoB,CAAC,CAAC;KAC/C;IAED,OAAO;QACL,UAAU,YAAA;QACV,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AA5BD,gDA4BC"}

package/dist/useAddData.js

@@ -1,4 +1,20 @@
 "use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
         if (ar || !(i in from)) {
@@ -23,7 +39,7 @@ function useAddData() {
         for (var _i = 1; _i < arguments.length; _i++) {
             dataTypes[_i - 1] = arguments[_i];
         }
-        client.addData.apply(client, __spreadArray([visitorCode], dataTypes, false));
+        client.addData.apply(client, __spreadArray([visitorCode], __read(dataTypes), false));
     }, [client]);
     return {
         addData: addData,

package/dist/useAddData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAddData.js","sourceRoot":"","sources":["../src/useAddData.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAAoC;AAEpC,+CAA8C;AAU9C;;;GAGG;AACH,SAAgB,UAAU;IAChB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,OAAO,GAAG,IAAA,mBAAW,EACzB,UAAC,WAAmB;QAAE,mBAAqB;aAArB,UAAqB,EAArB,qBAAqB,EAArB,IAAqB;YAArB,kCAAqB;;QACzC,MAAM,CAAC,OAAO,OAAd,MAAM,iBAAS,WAAW,GAAK,SAAS,UAAE;IAC5C,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,OAAO,SAAA;KACR,CAAC;AACJ,CAAC;AAbD,gCAaC"}
+{"version":3,"file":"useAddData.js","sourceRoot":"","sources":["../src/useAddData.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAoC;AAEpC,+CAA8C;AAU9C;;;GAGG;AACH,SAAgB,UAAU;IAChB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,OAAO,GAAG,IAAA,mBAAW,EACzB,UAAC,WAAmB;QAAE,mBAAqB;aAArB,UAAqB,EAArB,qBAAqB,EAArB,IAAqB;YAArB,kCAAqB;;QACzC,MAAM,CAAC,OAAO,OAAd,MAAM,iBAAS,WAAW,UAAK,SAAS,WAAE;IAC5C,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,OAAO,SAAA;KACR,CAAC;AACJ,CAAC;AAbD,gCAaC"}

package/dist/useDevice.d.ts

@@ -0,0 +1,12 @@
+import { Device as IDevice, DeviceType } from 'kameleoon-client-javascript/dist/data';
+interface DeviceHookResult {
+    /**
+     * @param device - device type: Phone, Tablet, Desktop
+     */
+    addDevice: (device: DeviceType) => IDevice;
+}
+/**
+ * A React Hook that returns a callback function which adds interest
+ */
+export declare function useDevice(): DeviceHookResult;
+export {};

package/dist/useDevice.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDevice = void 0;
+var react_1 = require("react");
+var kameleoon_client_javascript_1 = require("kameleoon-client-javascript");
+/**
+ * A React Hook that returns a callback function which adds interest
+ */
+function useDevice() {
+    var addDevice = (0, react_1.useCallback)(function (device) { return new kameleoon_client_javascript_1.KameleoonData.Device(device); }, []);
+    return {
+        addDevice: addDevice,
+    };
+}
+exports.useDevice = useDevice;
+//# sourceMappingURL=useDevice.js.map

package/dist/useDevice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDevice.js","sourceRoot":"","sources":["../src/useDevice.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,2EAA4D;AAa5D;;GAEG;AACH,SAAgB,SAAS;IACvB,IAAM,SAAS,GAAG,IAAA,mBAAW,EAC3B,UAAC,MAAkB,IAAc,OAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAhC,CAAgC,EACjE,EAAE,CACH,CAAC;IAEF,OAAO;QACL,SAAS,WAAA;KACV,CAAC;AACJ,CAAC;AATD,8BASC"}

package/dist/useError.d.ts

@@ -0,0 +1,7 @@
+import { KameleoonError } from './KameleoonError';
+declare type UseErrorHookResultType = {
+    error: KameleoonError | null;
+    setError: (unknownError: unknown) => void;
+};
+export declare function useError(): UseErrorHookResultType;
+export {};

package/dist/useError.js

@@ -0,0 +1,34 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useError = void 0;
+var react_1 = require("react");
+var getKameleoonException_1 = require("./getKameleoonException");
+function useError() {
+    var _a = __read((0, react_1.useState)(null), 2), error = _a[0], setError = _a[1];
+    var setErrorHandler = (0, react_1.useCallback)(function (unknownError) {
+        var exception = (0, getKameleoonException_1.getKameleoonException)(unknownError);
+        setError(exception);
+    }, []);
+    return {
+        error: error,
+        setError: setErrorHandler,
+    };
+}
+exports.useError = useError;
+//# sourceMappingURL=useError.js.map

package/dist/useError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useError.js","sourceRoot":"","sources":["../src/useError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,+BAA8C;AAC9C,iEAAgE;AAQhE,SAAgB,QAAQ;IAChB,IAAA,KAAA,OAAoB,IAAA,gBAAQ,EAAwB,IAAI,CAAC,IAAA,EAAxD,KAAK,QAAA,EAAE,QAAQ,QAAyC,CAAC;IAEhE,IAAM,eAAe,GAAG,IAAA,mBAAW,EAAC,UAAC,YAAqB;QACxD,IAAM,SAAS,GAAG,IAAA,6CAAqB,EAAC,YAAqB,CAAC,CAAC;QAC/D,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,KAAK,OAAA;QACL,QAAQ,EAAE,eAAe;KAC1B,CAAC;AACJ,CAAC;AAZD,4BAYC"}

package/dist/useErrors.d.ts

@@ -0,0 +1,7 @@
+import { KameleoonException } from './constants';
+declare type UseErrorsHookResultType = {
+    errors: KameleoonException[];
+    setErrors: (newErrors: Array<KameleoonException | undefined>) => void;
+};
+export declare function useErrors(): UseErrorsHookResultType;
+export {};

package/dist/useErrors.js

@@ -0,0 +1,42 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useErrors = void 0;
+var react_1 = require("react");
+function useErrors() {
+    var _a = __read((0, react_1.useState)([]), 2), errors = _a[0], setErrors = _a[1];
+    var setErrorHandler = (0, react_1.useCallback)(function (newErrors) {
+        var uniqueErrors = __spreadArray([], __read(new Set(newErrors)), false).filter(function (value) { return Boolean(value); });
+        setErrors(uniqueErrors);
+    }, []);
+    return {
+        errors: errors,
+        setErrors: setErrorHandler,
+    };
+}
+exports.useErrors = useErrors;
+//# sourceMappingURL=useErrors.js.map

package/dist/useErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrors.js","sourceRoot":"","sources":["../src/useErrors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAA8C;AAQ9C,SAAgB,SAAS;IACjB,IAAA,KAAA,OAAsB,IAAA,gBAAQ,EAAuB,EAAE,CAAC,IAAA,EAAvD,MAAM,QAAA,EAAE,SAAS,QAAsC,CAAC;IAE/D,IAAM,eAAe,GAAG,IAAA,mBAAW,EACjC,UAAC,SAAgD;QAC/C,IAAM,YAAY,GAAG,yBAAI,IAAI,GAAG,CAAC,SAAS,CAAC,UAAE,MAAM,CACjD,UAAC,KAAK,IAAkC,OAAA,OAAO,CAAC,KAAK,CAAC,EAAd,CAAc,CACvD,CAAC;QAEF,SAAS,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,MAAM,QAAA;QACN,SAAS,EAAE,eAAe;KAC3B,CAAC;AACJ,CAAC;AAlBD,8BAkBC"}

package/dist/useFeature.js

@@ -10,6 +10,22 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useFeature = void 0;
 var react_1 = require("react");
@@ -18,20 +34,22 @@ var useFeatureVariable_1 = require("./useFeatureVariable");
 var constants_1 = require("./constants");
 var useVisitorCode_1 = require("./useVisitorCode");
 var useKameleoon_1 = require("./useKameleoon");
+var useErrors_1 = require("./useErrors");
 /**
  * A React Hook that returns the status of a feature flag and specified variables
  */
 function useFeature(_a) {
     var _b;
     var featureKey = _a.featureKey, variableKeys = _a.variableKeys, visitorCode = _a.visitorCode;
-    var hasFeature = (0, useActivateFeature_1.useActivateFeature)().hasFeature;
-    var getFeatureVariable = (0, useFeatureVariable_1.useFeatureVariable)().getFeatureVariable;
+    var _c = (0, useActivateFeature_1.useActivateFeature)(), hasFeature = _c.hasFeature, activateFeatureError = _c.error;
+    var _d = (0, useFeatureVariable_1.useFeatureVariable)(), getFeatureVariable = _d.getFeatureVariable, featureVariableError = _d.error;
     var getVisitorCode = (0, useVisitorCode_1.useVisitorCode)().getVisitorCode;
     var client = (0, useKameleoon_1.useKameleoon)().client;
-    var _c = (0, react_1.useState)((_b = {},
+    var _e = __read((0, react_1.useState)((_b = {},
         _b[constants_1.FeatureResultField.IsActive] = false,
         _b[constants_1.FeatureResultField.Variables] = [],
-        _b)), feature = _c[0], setFeature = _c[1];
+        _b)), 2), feature = _e[0], setFeature = _e[1];
+    var _f = (0, useErrors_1.useErrors)(), errors = _f.errors, setErrors = _f.setErrors;
     var userCode = visitorCode !== null && visitorCode !== void 0 ? visitorCode : getVisitorCode('');
     function getVariableObject(key, value) {
         var _a;
@@ -58,17 +76,17 @@ function useFeature(_a) {
     (0, react_1.useEffect)(function () {
         var _a;
         var _b, _c, _d;
-        var featureFlag = ((_b = client.configurations) === null || _b === void 0 ? void 0 : _b.configuration.featureFlags.filter(function (item) {
+        var _e = __read((_b = client.configurations) === null || _b === void 0 ? void 0 : _b.configuration.featureFlags.filter(function (item) {
             return item.identificationKey === featureKey;
-        }))[0];
+        }), 1), featureFlag = _e[0];
         var currentEnvironment = (_d = (_c = featureFlag === null || featureFlag === void 0 ? void 0 : featureFlag.environment) === null || _c === void 0 ? void 0 : _c.key) !== null && _d !== void 0 ? _d : constants_1.PRODUCTION;
         try {
             setFeature((_a = {},
-                _a[constants_1.FeatureResultField.IsActive] = hasFeature(userCode, featureKey),
+                _a[constants_1.FeatureResultField.IsActive] = hasFeature(featureKey, userCode),
                 _a[constants_1.FeatureResultField.Variables] = getVariablesArray(currentEnvironment),
                 _a));
         }
-        catch (_e) {
+        catch (_f) {
             setFeature(function (prevFeature) {
                 var _a;
                 return (__assign(__assign({}, prevFeature), (_a = {}, _a[constants_1.FeatureResultField.IsActive] = false, _a)));
@@ -77,7 +95,10 @@ function useFeature(_a) {
         // getVariablesArray put in dependencies creates an infinite loop
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [userCode, featureKey, hasFeature]);
-    return feature;
+    (0, react_1.useEffect)(function () {
+        setErrors([activateFeatureError === null || activateFeatureError === void 0 ? void 0 : activateFeatureError.type, featureVariableError === null || featureVariableError === void 0 ? void 0 : featureVariableError.type]);
+    }, [activateFeatureError, featureVariableError, setErrors]);
+    return { feature: feature, errors: errors };
 }
 exports.useFeature = useFeature;
 //# sourceMappingURL=useFeature.js.map

package/dist/useFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeature.js","sourceRoot":"","sources":["../src/useFeature.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,+BAAyD;AACzD,2DAA0D;AAC1D,2DAA0D;AAE1D,yCAA6D;AAC7D,mDAAkD;AAClD,+CAA8C;AAE9C;;GAEG;AACH,SAAgB,UAAU,CAAC,EAIV;;QAHf,UAAU,gBAAA,EACV,YAAY,kBAAA,EACZ,WAAW,iBAAA;IAEH,IAAA,UAAU,GAAK,IAAA,uCAAkB,GAAE,WAAzB,CAA0B;IACpC,IAAA,kBAAkB,GAAK,IAAA,uCAAkB,GAAE,mBAAzB,CAA0B;IAC5C,IAAA,cAAc,GAAK,IAAA,+BAAc,GAAE,eAArB,CAAsB;IACpC,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAC5B,IAAA,KAAwB,IAAA,gBAAQ;QACpC,GAAC,8BAAkB,CAAC,QAAQ,IAAG,KAAK;QACpC,GAAC,8BAAkB,CAAC,SAAS,IAAG,EAAE;YAClC,EAHK,OAAO,QAAA,EAAE,UAAU,QAGxB,CAAC;IAEH,IAAM,QAAQ,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IAEnD,SAAS,iBAAiB,CACxB,GAAW,EACX,KAA8B;;QAE9B,IAAI,KAAK,EAAE;YACT;gBACE,GAAC,GAAG,IAAG,KAAK;mBACZ;SACH;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,UAAC,WAAmB;QAClB,IAAM,cAAc,GAAG,EAAE,CAAC;QAC1B,IAAM,uBAAuB,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QAE1D,IAAI,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE;YAC1C,uBAAuB,CAAC,OAAO,CAAC,UAAC,GAAG;gBAClC,cAAc,CAAC,IAAI,CACjB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAC5D,CAAC;YACJ,CAAC,CAAC,CAAC;SACJ;aAAM;YACL,cAAc,CAAC,IAAI,CACjB,iBAAiB,CACf,uBAAuB,EACvB,kBAAkB,CAAC,UAAU,EAAE,uBAAuB,CAAC,CACxD,CACF,CAAC;SACH;QAED,OAAO,cAAc,CAAC;IACxB,CAAC,EACD,CAAC,YAAY,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAC/C,CAAC;IAEF,IAAA,iBAAS,EAAC;;;QACD,IAAA,WAAW,GAChB,CAAA,MAAA,MAAM,CAAC,cAAc,0CAAE,aAAa,CAAC,YAAY,CAAC,MAAM,CACtD,UAAC,IAA6B;YAC5B,OAAA,IAAI,CAAC,iBAAiB,KAAK,UAAU;QAArC,CAAqC,CACxC,CAAA,GAJe,CAId;QAEJ,IAAM,kBAAkB,GAAG,MAAA,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,0CAAE,GAAG,mCAAI,sBAAU,CAAC;QAEvE,IAAI;YACF,UAAU;gBACR,GAAC,8BAAkB,CAAC,QAAQ,IAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC/D,GAAC,8BAAkB,CAAC,SAAS,IAAG,iBAAiB,CAAC,kBAAkB,CAAC;oBACrE,CAAC;SACJ;QAAC,WAAM;YACN,UAAU,CAAC,UAAC,WAAW;;gBAAK,OAAA,uBACvB,WAAW,gBACb,8BAAkB,CAAC,QAAQ,IAAG,KAAK,OACpC;YAH0B,CAG1B,CAAC,CAAC;SACL;QACD,iEAAiE;QACjE,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAEvC,OAAO,OAAO,CAAC;AACjB,CAAC;AA/ED,gCA+EC"}
+{"version":3,"file":"useFeature.js","sourceRoot":"","sources":["../src/useFeature.ts"],"names":[],"mappings":"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"}

package/dist/useFeatureVariable.d.ts

@@ -1,10 +1,12 @@
 import { FeatureFlagVariableType } from './types';
+import { KameleoonError } from './KameleoonError';
 interface FeatureVariableHookResult {
     /**
      * @param featureKey - unique identifier or key of the feature you want to obtain to a user
      * @param variableKey - key of the variable
      */
     getFeatureVariable: (featureKey: string | number, variableKey: string) => FeatureFlagVariableType;
+    error: KameleoonError | null;
 }
 /**
  * A React Hook that returns callback function which retrieves a feature variable

package/dist/useFeatureVariable.js

@@ -7,11 +7,13 @@ exports.useFeatureVariable = void 0;
 var react_1 = require("react");
 var isJSON_1 = __importDefault(require("validator/lib/isJSON"));
 var useKameleoon_1 = require("./useKameleoon");
+var useError_1 = require("./useError");
 /**
  * A React Hook that returns callback function which retrieves a feature variable
  */
 function useFeatureVariable() {
     var client = (0, useKameleoon_1.useKameleoon)().client;
+    var _a = (0, useError_1.useError)(), error = _a.error, setError = _a.setError;
     var getProcessedVariable = (0, react_1.useCallback)(function (value) {
         if (typeof value === 'undefined') {
             return undefined;
@@ -19,17 +21,20 @@ function useFeatureVariable() {
         if (typeof value === 'string' && (0, isJSON_1.default)(value)) {
             return JSON.parse(value);
         }
-        // JS SDK returns string instead of actual boolean therefore temporal fix
-        if (typeof value === 'string' && (value === 'True' || value === 'False')) {
-            return JSON.parse(value.toLowerCase());
-        }
         return value;
     }, []);
     var getFeatureVariable = (0, react_1.useCallback)(function (featureKey, variableKey) {
-        return getProcessedVariable(client.obtainFeatureVariable(featureKey, variableKey));
-    }, [client, getProcessedVariable]);
+        try {
+            return getProcessedVariable(client.obtainFeatureVariable(featureKey, variableKey));
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return undefined;
+        }
+    }, [client, getProcessedVariable, setError]);
     return {
         getFeatureVariable: getFeatureVariable,
+        error: error,
     };
 }
 exports.useFeatureVariable = useFeatureVariable;

package/dist/useFeatureVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureVariable.js","sourceRoot":"","sources":["../src/useFeatureVariable.ts"],"names":[],"mappings":";;;;;;AAAA,+BAAoC;AACpC,gEAA0C;AAC1C,+CAA8C;AAc9C;;GAEG;AACH,SAAgB,kBAAkB;IACxB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,oBAAoB,GAAG,IAAA,mBAAW,EAAC,UAAC,KAAK;QAC7C,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE;YAChC,OAAO,SAAS,CAAC;SAClB;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,gBAAM,EAAC,KAAK,CAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC1B;QAED,yEAAyE;QACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,CAAC,EAAE;YACxE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;SACxC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAM,kBAAkB,GAAG,IAAA,mBAAW,EACpC,UACE,UAA2B,EAC3B,WAAmB;QAEnB,OAAA,oBAAoB,CAClB,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,CACtD;IAFD,CAEC,EACH,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAC/B,CAAC;IAEF,OAAO;QACL,kBAAkB,oBAAA;KACnB,CAAC;AACJ,CAAC;AAlCD,gDAkCC"}
+{"version":3,"file":"useFeatureVariable.js","sourceRoot":"","sources":["../src/useFeatureVariable.ts"],"names":[],"mappings":";;;;;;AAAA,+BAAoC;AACpC,gEAA0C;AAC1C,+CAA8C;AAG9C,uCAAsC;AActC;;GAEG;AACH,SAAgB,kBAAkB;IACxB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAC5B,IAAA,KAAsB,IAAA,mBAAQ,GAAE,EAA9B,KAAK,WAAA,EAAE,QAAQ,cAAe,CAAC;IAEvC,IAAM,oBAAoB,GAAG,IAAA,mBAAW,EAAC,UAAC,KAAK;QAC7C,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE;YAChC,OAAO,SAAS,CAAC;SAClB;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,gBAAM,EAAC,KAAK,CAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC1B;QAED,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAM,kBAAkB,GAAG,IAAA,mBAAW,EACpC,UACE,UAA2B,EAC3B,WAAmB;QAEnB,IAAI;YACF,OAAO,oBAAoB,CACzB,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,CACtD,CAAC;SACH;QAAC,OAAO,YAAY,EAAE;YACrB,QAAQ,CAAC,YAAY,CAAC,CAAC;YAEvB,OAAO,SAAS,CAAC;SAClB;IACH,CAAC,EACD,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,CACzC,CAAC;IAEF,OAAO;QACL,kBAAkB,oBAAA;QAClB,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AAtCD,gDAsCC"}

package/dist/useRetrieveDataFromRemoteSource.d.ts

@@ -1,9 +1,9 @@
-import { RemoteSourceDataType } from './types';
+import { RemoteSourceResultType } from './types';
 interface RetrieveDataFromRemoteSourceHookResult {
     /**
      * @param key - unique key for data defined for Kameleoon Data API
      */
-    retrieveDataFromRemoteSource: (key: string) => Promise<RemoteSourceDataType>;
+    retrieveDataFromRemoteSource: (key: string) => Promise<RemoteSourceResultType>;
 }
 /**
  * A React Hook that returns asynchronous callback function which retrieves data from Kameleoon Data API

package/dist/useRetrieveDataFromRemoteSource.js

@@ -40,6 +40,8 @@ exports.useRetrieveDataFromRemoteSource = void 0;
 var react_1 = require("react");
 var useKameleoon_1 = require("./useKameleoon");
 var ProviderError_1 = require("./ProviderError");
+var KameleoonError_1 = require("./KameleoonError");
+var constants_1 = require("./constants");
 /**
  * A React Hook that returns asynchronous callback function which retrieves data from Kameleoon Data API
  */
@@ -52,16 +54,17 @@ function useRetrieveDataFromRemoteSource() {
             Object.getPrototypeOf(object) === Object.prototype);
     }, []);
     var retrieveDataFromRemoteSource = (0, react_1.useCallback)(function (key) { return __awaiter(_this, void 0, void 0, function () {
-        var data;
+        var resultData, error;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, client.retrieveDataFromRemoteSource(key)];
                 case 1:
-                    data = (_a.sent());
-                    if (isObjectEmpty(data)) {
-                        throw new Error('No data was retrieved from remote source or the data is empty');
+                    resultData = (_a.sent());
+                    if (isObjectEmpty(resultData)) {
+                        error = new KameleoonError_1.KameleoonError(constants_1.KameleoonException.NoDataWasRetrievedFromRemoteServer);
+                        return [2 /*return*/, { data: null, error: error }];
                     }
-                    return [2 /*return*/, data];
+                    return [2 /*return*/, { data: resultData, error: null }];
             }
         });
     }); }, [client, isObjectEmpty]);

package/dist/useRetrieveDataFromRemoteSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRetrieveDataFromRemoteSource.js","sourceRoot":"","sources":["../src/useRetrieveDataFromRemoteSource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAoC;AACpC,+CAA8C;AAC9C,iDAAgD;AAUhD;;GAEG;AACH,SAAgB,+BAA+B;IAA/C,iBAmCC;IAlCS,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,UAAC,MAA4B;QAC7D,OAAO,CACL,MAAM;YACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAChC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,SAAS,CACnD,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAM,4BAA4B,GAAG,IAAA,mBAAW,EAC9C,UAAO,GAAW;;;;wBACF,qBAAM,MAAM,CAAC,4BAA4B,CACrD,GAAG,CACJ,EAAA;;oBAFK,IAAI,GAAG,CAAC,SAEb,CAAyB;oBAE1B,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE;wBACvB,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;qBACH;oBAED,sBAAO,IAAI,EAAC;;;SACb,EACD,CAAC,MAAM,EAAE,aAAa,CAAC,CACxB,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,6BAAa,CAAC,cAAc,CAAC,CAAC;KACzC;IAED,OAAO;QACL,4BAA4B,8BAAA;KAC7B,CAAC;AACJ,CAAC;AAnCD,0EAmCC"}
+{"version":3,"file":"useRetrieveDataFromRemoteSource.js","sourceRoot":"","sources":["../src/useRetrieveDataFromRemoteSource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAoC;AACpC,+CAA8C;AAC9C,iDAAgD;AAEhD,mDAAkD;AAClD,yCAAiD;AAWjD;;GAEG;AACH,SAAgB,+BAA+B;IAA/C,iBAqCC;IApCS,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,UAAC,MAA4B;QAC7D,OAAO,CACL,MAAM;YACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAChC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,SAAS,CACnD,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAM,4BAA4B,GAAG,IAAA,mBAAW,EAC9C,UAAO,GAAW;;;;wBACI,qBAAM,MAAM,CAAC,4BAA4B,CAC3D,GAAG,CACJ,EAAA;;oBAFK,UAAU,GAAG,CAAC,SAEnB,CAAyB;oBAE1B,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE;wBACvB,KAAK,GAAG,IAAI,+BAAc,CAC9B,8BAAkB,CAAC,kCAAkC,CACtD,CAAC;wBAEF,sBAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,OAAA,EAAE,EAAC;qBAC9B;oBAED,sBAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAC;;;SAC1C,EACD,CAAC,MAAM,EAAE,aAAa,CAAC,CACxB,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,6BAAa,CAAC,cAAc,CAAC,CAAC;KACzC;IAED,OAAO;QACL,4BAA4B,8BAAA;KAC7B,CAAC;AACJ,CAAC;AArCD,0EAqCC"}

package/dist/useRunWhenReady.d.ts

@@ -0,0 +1,14 @@
+interface RunWhenReadyHookResult {
+    /**
+     * @param successCallback - callback which will be executed on successful client initialization
+     * @param errorCallback - callback which will be executed if client wasn't able to initialize during the timeout
+     * @param timeout - timeout which is given to perform HTTP call for initialization in ms (by default: 2 seconds)
+     */
+    runWhenReady: (successCallback: () => void, errorCallback: () => void, timeout?: number) => void;
+}
+/**
+ * A React Hook that returns callback function which makes sure that
+ * Kameleoon Client will be initialized properly using HTTP call within the specified timeout
+ */
+export declare function useRunWhenReady(): RunWhenReadyHookResult;
+export {};

package/dist/useRunWhenReady.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRunWhenReady = void 0;
+var react_1 = require("react");
+var useKameleoon_1 = require("./useKameleoon");
+var ProviderError_1 = require("./ProviderError");
+/**
+ * A React Hook that returns callback function which makes sure that
+ * Kameleoon Client will be initialized properly using HTTP call within the specified timeout
+ */
+function useRunWhenReady() {
+    var client = (0, useKameleoon_1.useKameleoon)().client;
+    var DEFAULT_TIMEOUT = 2000;
+    var runWhenReady = (0, react_1.useCallback)(function (successCallback, errorCallback, timeout) {
+        client.runWhenReady(successCallback, errorCallback, timeout !== null && timeout !== void 0 ? timeout : DEFAULT_TIMEOUT);
+    }, [client]);
+    if (!client) {
+        throw new ProviderError_1.ProviderError('useRunWhenReady');
+    }
+    return { runWhenReady: runWhenReady };
+}
+exports.useRunWhenReady = useRunWhenReady;
+//# sourceMappingURL=useRunWhenReady.js.map

package/dist/useRunWhenReady.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunWhenReady.js","sourceRoot":"","sources":["../src/useRunWhenReady.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAC9C,iDAAgD;AAehD;;;GAGG;AACH,SAAgB,eAAe;IACrB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAClC,IAAM,eAAe,GAAG,IAAI,CAAC;IAE7B,IAAM,YAAY,GAAG,IAAA,mBAAW,EAC9B,UACE,eAA2B,EAC3B,aAAyB,EACzB,OAAgB;QAEhB,MAAM,CAAC,YAAY,CACjB,eAAe,EACf,aAAa,EACb,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,eAAe,CAC3B,CAAC;IACJ,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,6BAAa,CAAC,iBAAiB,CAAC,CAAC;KAC5C;IAED,OAAO,EAAE,YAAY,cAAA,EAAE,CAAC;AAC1B,CAAC;AAxBD,0CAwBC"}

package/dist/useTriggerExperiment.d.ts

@@ -1,9 +1,11 @@
+import { KameleoonError } from './KameleoonError';
 interface IGetVariationIdHookResult {
     /**
      * @param visitorCode - unique identifier of the user
      * @param experimentId - unique identifier of the experiment you want to expose to a user
      */
     getVariationId: (visitorCode: string, experimentId: number) => number;
+    error: KameleoonError | null;
 }
 /**
  * A React Hook that returns callback function which triggers experiment.

package/dist/useTriggerExperiment.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTriggerExperiment = void 0;
 var react_1 = require("react");
 var useKameleoon_1 = require("./useKameleoon");
+var useError_1 = require("./useError");
 /**
  * A React Hook that returns callback function which triggers experiment.
  * If such a user has never been associated with any variation, the SDK returns a randomly selected variation.
@@ -10,12 +11,21 @@ var useKameleoon_1 = require("./useKameleoon");
  * it will detect the previously registered variation and return the variationID
  */
 function useTriggerExperiment() {
+    var _a = (0, useError_1.useError)(), error = _a.error, setError = _a.setError;
     var client = (0, useKameleoon_1.useKameleoon)().client;
+    var DEFAULT_VARIATION_ID = 0;
     var getVariationId = (0, react_1.useCallback)(function (visitorCode, experimentId) {
-        return client.triggerExperiment(visitorCode, experimentId);
-    }, [client]);
+        try {
+            return client.triggerExperiment(visitorCode, experimentId);
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return DEFAULT_VARIATION_ID;
+        }
+    }, [client, setError]);
     return {
         getVariationId: getVariationId,
+        error: error,
     };
 }
 exports.useTriggerExperiment = useTriggerExperiment;

package/dist/useTriggerExperiment.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTriggerExperiment.js","sourceRoot":"","sources":["../src/useTriggerExperiment.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAU9C;;;;;GAKG;AACH,SAAgB,oBAAoB;IAC1B,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,cAAc,GAAG,IAAA,mBAAW,EAChC,UAAC,WAAmB,EAAE,YAAoB;QACxC,OAAA,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,YAAY,CAAC;IAAnD,CAAmD,EACrD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,cAAc,gBAAA;KACf,CAAC;AACJ,CAAC;AAZD,oDAYC"}
+{"version":3,"file":"useTriggerExperiment.js","sourceRoot":"","sources":["../src/useTriggerExperiment.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAE9C,uCAAsC;AAWtC;;;;;GAKG;AACH,SAAgB,oBAAoB;IAC5B,IAAA,KAAsB,IAAA,mBAAQ,GAAE,EAA9B,KAAK,WAAA,EAAE,QAAQ,cAAe,CAAC;IAC/B,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAClC,IAAM,oBAAoB,GAAG,CAAC,CAAC;IAE/B,IAAM,cAAc,GAAG,IAAA,mBAAW,EAChC,UAAC,WAAmB,EAAE,YAAoB;QACxC,IAAI;YACF,OAAO,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;SAC5D;QAAC,OAAO,YAAY,EAAE;YACrB,QAAQ,CAAC,YAAY,CAAC,CAAC;YAEvB,OAAO,oBAAoB,CAAC;SAC7B;IACH,CAAC,EACD,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;IAEF,OAAO;QACL,cAAc,gBAAA;QACd,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AAtBD,oDAsBC"}

package/dist/useVariationAssociatedData.d.ts

@@ -1,9 +1,11 @@
-import { AnyType } from './types';
+import { KameleoonError } from './KameleoonError';
+import { VariationAssociatedDataType } from './types';
 interface VariationAssociatedDataHookResult {
     /**
      * @param variationId - unique identifier of the variation you want to obtain associated data for
      */
-    getVariationAssociatedData: (variationId: number) => AnyType;
+    getVariationAssociatedData: (variationId: number) => VariationAssociatedDataType;
+    error: KameleoonError | null;
 }
 /**
  * A React Hook that returns callback function which retrieves JSON data associated with a variation.

package/dist/useVariationAssociatedData.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useVariationAssociatedData = void 0;
 var react_1 = require("react");
 var useKameleoon_1 = require("./useKameleoon");
+var useError_1 = require("./useError");
 /**
  * A React Hook that returns callback function which retrieves JSON data associated with a variation.
  * The JSON data usually represents some metadata of the variation,
@@ -10,11 +11,19 @@ var useKameleoon_1 = require("./useKameleoon");
  */
 function useVariationAssociatedData() {
     var client = (0, useKameleoon_1.useKameleoon)().client;
+    var _a = (0, useError_1.useError)(), error = _a.error, setError = _a.setError;
     var getVariationAssociatedData = (0, react_1.useCallback)(function (variationId) {
-        return client.obtainVariationAssociatedData(variationId);
-    }, [client]);
+        try {
+            return client.obtainVariationAssociatedData(variationId);
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return null;
+        }
+    }, [client, setError]);
     return {
         getVariationAssociatedData: getVariationAssociatedData,
+        error: error,
     };
 }
 exports.useVariationAssociatedData = useVariationAssociatedData;

package/dist/useVariationAssociatedData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVariationAssociatedData.js","sourceRoot":"","sources":["../src/useVariationAssociatedData.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAU9C;;;;GAIG;AACH,SAAgB,0BAA0B;IAChC,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,0BAA0B,GAAG,IAAA,mBAAW,EAC5C,UAAC,WAAmB;QAClB,OAAA,MAAM,CAAC,6BAA6B,CAAC,WAAW,CAAC;IAAjD,CAAiD,EACnD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,0BAA0B,4BAAA;KAC3B,CAAC;AACJ,CAAC;AAZD,gEAYC"}
+{"version":3,"file":"useVariationAssociatedData.js","sourceRoot":"","sources":["../src/useVariationAssociatedData.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAG9C,uCAAsC;AAYtC;;;;GAIG;AACH,SAAgB,0BAA0B;IAChC,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAC5B,IAAA,KAAsB,IAAA,mBAAQ,GAAE,EAA9B,KAAK,WAAA,EAAE,QAAQ,cAAe,CAAC;IAEvC,IAAM,0BAA0B,GAAG,IAAA,mBAAW,EAC5C,UAAC,WAAmB;QAClB,IAAI;YACF,OAAO,MAAM,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAC;SAC1D;QAAC,OAAO,YAAY,EAAE;YACrB,QAAQ,CAAC,YAAY,CAAC,CAAC;YAEvB,OAAO,IAAI,CAAC;SACb;IACH,CAAC,EACD,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;IAEF,OAAO;QACL,0BAA0B,4BAAA;QAC1B,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AArBD,gEAqBC"}

package/dist/withActivateFeature.d.ts

@@ -1,11 +1,13 @@
 import React from 'react';
 import { UnknownPropsType, Without } from './types';
+import { KameleoonError } from './KameleoonError';
 interface IWithHasFeature {
     /**
      * @param visitorCode - unique identifier of the user
      * @param featureKey - unique identifier or key of the feature you want to expose to a user
      */
-    hasFeature: (visitorCode: string, featureKey: string | number) => boolean;
+    hasFeature: (featureKey: string | number, visitorCode?: string) => boolean;
+    activateFeatureError: KameleoonError | null;
 }
 /**
  * A React HOC that gives a wrapped component access to callback