@kameleoon/react-sdk 2.1.0 → 3.0.0

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,9 +76,9 @@ 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 = {},
@@ -68,7 +86,7 @@ function useFeature(_a) {
                 _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;
@@ -26,10 +28,17 @@ function useFeatureVariable() {
         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,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,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;AA3CD,gDA2CC"}

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;
+    activateFeatureError: KameleoonError | null;
 }
 /**
  * A React HOC that gives a wrapped component access to callback

package/dist/withActivateFeature.js

@@ -13,23 +13,15 @@ var __assign = (this && this.__assign) || function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withActivateFeature = void 0;
 var jsx_runtime_1 = require("react/jsx-runtime");
-var react_1 = require("react");
-var KameleoonContext_1 = require("./KameleoonContext");
-var ProviderError_1 = require("./ProviderError");
+var useActivateFeature_1 = require("./useActivateFeature");
 /**
  * A React HOC that gives a wrapped component access to callback
  * function which activates a feature toggle
  */
 function withActivateFeature(Component) {
     return function WrappedComponent(props) {
-        var client = (0, react_1.useContext)(KameleoonContext_1.KameleoonContext);
-        var hasFeature = (0, react_1.useCallback)(function (visitorCode, featureKey) {
-            if (!client) {
-                throw new ProviderError_1.ProviderError('withActivateFeature');
-            }
-            return client.activateFeature(visitorCode, featureKey);
-        }, [client]);
-        return (0, jsx_runtime_1.jsx)(Component, __assign({ hasFeature: hasFeature }, props), void 0);
+        var _a = (0, useActivateFeature_1.useActivateFeature)(), hasFeature = _a.hasFeature, activateFeatureError = _a.error;
+        return ((0, jsx_runtime_1.jsx)(Component, __assign({ hasFeature: hasFeature, activateFeatureError: activateFeatureError }, props), void 0));
     };
 }
 exports.withActivateFeature = withActivateFeature;

package/dist/withActivateFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"withActivateFeature.js","sourceRoot":"","sources":["../src/withActivateFeature.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,+BAAuD;AAEvD,uDAAsD;AACtD,iDAAgD;AAUhD;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QAC3C,IAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,mCAAgB,CAAC,CAAC;QAE5C,IAAM,UAAU,GAAG,IAAA,mBAAW,EAC5B,UAAC,WAAmB,EAAE,UAA2B;YAC/C,IAAI,CAAC,MAAM,EAAE;gBACX,MAAM,IAAI,6BAAa,CAAC,qBAAqB,CAAC,CAAC;aAChD;YAED,OAAO,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,OAAO,uBAAC,SAAS,aAAC,UAAU,EAAE,UAAU,IAAO,KAAe,UAAI,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAnBD,kDAmBC"}
+{"version":3,"file":"withActivateFeature.js","sourceRoot":"","sources":["../src/withActivateFeature.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,2DAA0D;AAY1D;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QACrC,IAAA,KAA8C,IAAA,uCAAkB,GAAE,EAAhE,UAAU,gBAAA,EAAS,oBAAoB,WAAyB,CAAC;QAEzE,OAAO,CACL,uBAAC,SAAS,aACR,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,oBAAoB,IACrC,KAAe,UACpB,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAdD,kDAcC"}

package/dist/withAddData.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;
+};
 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)) {
@@ -40,7 +56,7 @@ function withAddData(Component) {
             if (!client) {
                 throw new ProviderError_1.ProviderError('withAddData');
             }
-            return client.addData.apply(client, __spreadArray([visitorCode], dataTypes, false));
+            return client.addData.apply(client, __spreadArray([visitorCode], __read(dataTypes), false));
         }, [client]);
         return (0, jsx_runtime_1.jsx)(Component, __assign({ addData: addData }, props), void 0);
     };

package/dist/withAddData.js.map

@@ -1 +1 @@
-{"version":3,"file":"withAddData.js","sourceRoot":"","sources":["../src/withAddData.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAuD;AAGvD,uDAAsD;AACtD,iDAAgD;AAUhD;;;GAGG;AACH,SAAgB,WAAW,CACzB,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QAC3C,IAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,mCAAgB,CAAC,CAAC;QAE5C,IAAM,OAAO,GAAG,IAAA,mBAAW,EACzB,UAAC,WAAmB;YAAE,mBAAqB;iBAArB,UAAqB,EAArB,qBAAqB,EAArB,IAAqB;gBAArB,kCAAqB;;YACzC,IAAI,CAAC,MAAM,EAAE;gBACX,MAAM,IAAI,6BAAa,CAAC,aAAa,CAAC,CAAC;aACxC;YAED,OAAO,MAAM,CAAC,OAAO,OAAd,MAAM,iBAAS,WAAW,GAAK,SAAS,UAAE;QACnD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,OAAO,uBAAC,SAAS,aAAC,OAAO,EAAE,OAAO,IAAO,KAAe,UAAI,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAnBD,kCAmBC"}
+{"version":3,"file":"withAddData.js","sourceRoot":"","sources":["../src/withAddData.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAuD;AAGvD,uDAAsD;AACtD,iDAAgD;AAUhD;;;GAGG;AACH,SAAgB,WAAW,CACzB,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QAC3C,IAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,mCAAgB,CAAC,CAAC;QAE5C,IAAM,OAAO,GAAG,IAAA,mBAAW,EACzB,UAAC,WAAmB;YAAE,mBAAqB;iBAArB,UAAqB,EAArB,qBAAqB,EAArB,IAAqB;gBAArB,kCAAqB;;YACzC,IAAI,CAAC,MAAM,EAAE;gBACX,MAAM,IAAI,6BAAa,CAAC,aAAa,CAAC,CAAC;aACxC;YAED,OAAO,MAAM,CAAC,OAAO,OAAd,MAAM,iBAAS,WAAW,UAAK,SAAS,WAAE;QACnD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,OAAO,uBAAC,SAAS,aAAC,OAAO,EAAE,OAAO,IAAO,KAAe,UAAI,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAnBD,kCAmBC"}

package/dist/withFeature.js

@@ -22,8 +22,8 @@ function withFeature(args) {
     // e.g. withFeature(...args)(Component)
     return function callbackWithArgs(Component) {
         return function WrappedComponent(props) {
-            var feature = (0, useFeature_1.useFeature)(__assign({}, args));
-            return (0, jsx_runtime_1.jsx)(Component, __assign({ feature: feature }, props), void 0);
+            var _a = (0, useFeature_1.useFeature)(__assign({}, args)), feature = _a.feature, featureErrors = _a.errors;
+            return ((0, jsx_runtime_1.jsx)(Component, __assign({ feature: feature, featureErrors: featureErrors }, props), void 0));
         };
     };
 }

package/dist/withFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"withFeature.js","sourceRoot":"","sources":["../src/withFeature.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,2CAA0C;AAE1C;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAoB;IAC9C,oEAAoE;IACpE,uCAAuC;IACvC,OAAO,SAAS,gBAAgB,CAC9B,SAAqC;QAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;YAC3C,IAAM,OAAO,GAAG,IAAA,uBAAU,eAAM,IAAI,EAAG,CAAC;YAExC,OAAO,uBAAC,SAAS,aAAC,OAAO,EAAE,OAAO,IAAO,KAAe,UAAI,CAAC;QAC/D,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAZD,kCAYC"}
+{"version":3,"file":"withFeature.js","sourceRoot":"","sources":["../src/withFeature.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,2CAA0C;AAE1C;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAoB;IAC9C,oEAAoE;IACpE,uCAAuC;IACvC,OAAO,SAAS,gBAAgB,CAC9B,SAAqC;QAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;YACrC,IAAA,KAAqC,IAAA,uBAAU,eAAM,IAAI,EAAG,EAA1D,OAAO,aAAA,EAAU,aAAa,YAA4B,CAAC;YAEnE,OAAO,CACL,uBAAC,SAAS,aACR,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,IACvB,KAAe,UACpB,CACH,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAlBD,kCAkBC"}

package/dist/withFeatureVariable.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { KameleoonError } from './KameleoonError';
 import { FeatureFlagVariableType, UnknownPropsType, Without } from './types';
 interface IWithFeatureVariable {
     /**
@@ -6,6 +7,7 @@ interface IWithFeatureVariable {
      * @param variableKey - key of the variable
      */
     getFeatureVariable: (featureKey: string | number, variableKey: string) => FeatureFlagVariableType;
+    featureVariableError: KameleoonError | null;
 }
 /**
  * A React HOC that gives a wrapped component access to callback function

package/dist/withFeatureVariable.js

@@ -20,8 +20,8 @@ var useFeatureVariable_1 = require("./useFeatureVariable");
  */
 function withFeatureVariable(Component) {
     return function WrappedComponent(props) {
-        var getFeatureVariable = (0, useFeatureVariable_1.useFeatureVariable)().getFeatureVariable;
-        return ((0, jsx_runtime_1.jsx)(Component, __assign({ getFeatureVariable: getFeatureVariable }, props), void 0));
+        var _a = (0, useFeatureVariable_1.useFeatureVariable)(), getFeatureVariable = _a.getFeatureVariable, featureVariableError = _a.error;
+        return ((0, jsx_runtime_1.jsx)(Component, __assign({ getFeatureVariable: getFeatureVariable, featureVariableError: featureVariableError }, props), void 0));
     };
 }
 exports.withFeatureVariable = withFeatureVariable;

package/dist/withFeatureVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"withFeatureVariable.js","sourceRoot":"","sources":["../src/withFeatureVariable.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,2DAA0D;AAa1D;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QACnC,IAAA,kBAAkB,GAAK,IAAA,uCAAkB,GAAE,mBAAzB,CAA0B;QAEpD,OAAO,CACL,uBAAC,SAAS,aACR,kBAAkB,EAAE,kBAAkB,IACjC,KAAe,UACpB,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAbD,kDAaC"}
+{"version":3,"file":"withFeatureVariable.js","sourceRoot":"","sources":["../src/withFeatureVariable.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAGA,2DAA0D;AAc1D;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QACrC,IAAA,KACJ,IAAA,uCAAkB,GAAE,EADd,kBAAkB,wBAAA,EAAS,oBAAoB,WACjC,CAAC;QAEvB,OAAO,CACL,uBAAC,SAAS,aACR,kBAAkB,EAAE,kBAAkB,EACtC,oBAAoB,EAAE,oBAAoB,IACrC,KAAe,UACpB,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAfD,kDAeC"}

package/dist/withRunWhenReady.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { UnknownPropsType, Without } from './types';
+interface IWithRunWhenReadyData {
+    /**
+     * @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 HOC that gives a wrapped component access to callback function which makes sure that
+ * Kameleoon Client will be initialized properly using HTTP call within the specified timeout
+ */
+export declare function withRunWhenReady<Props extends UnknownPropsType>(Component: React.ComponentType<Props>): React.ComponentType<Props & Without<Props, IWithRunWhenReadyData>>;
+export {};

package/dist/withRunWhenReady.js

@@ -0,0 +1,28 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRunWhenReady = void 0;
+var jsx_runtime_1 = require("react/jsx-runtime");
+var useRunWhenReady_1 = require("./useRunWhenReady");
+/**
+ * A React HOC that gives a wrapped component access to callback function which makes sure that
+ * Kameleoon Client will be initialized properly using HTTP call within the specified timeout
+ */
+function withRunWhenReady(Component) {
+    return function WrappedComponent(props) {
+        var runWhenReady = (0, useRunWhenReady_1.useRunWhenReady)().runWhenReady;
+        return (0, jsx_runtime_1.jsx)(Component, __assign({ runWhenReady: runWhenReady }, props), void 0);
+    };
+}
+exports.withRunWhenReady = withRunWhenReady;
+//# sourceMappingURL=withRunWhenReady.js.map

package/dist/withRunWhenReady.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withRunWhenReady.js","sourceRoot":"","sources":["../src/withRunWhenReady.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,qDAAoD;AAepD;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,SAAqC;IAErC,OAAO,SAAS,gBAAgB,CAAC,KAAY;QACnC,IAAA,YAAY,GAAK,IAAA,iCAAe,GAAE,aAAtB,CAAuB;QAE3C,OAAO,uBAAC,SAAS,aAAC,YAAY,EAAE,YAAY,IAAO,KAAe,UAAI,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC;AARD,4CAQC"}

package/dist/withTriggerExperiment.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { KameleoonError } from './KameleoonError';
 import { UnknownPropsType, Without } from './types';
 interface IWithTriggerExperiment {
     /**
@@ -6,6 +7,7 @@ interface IWithTriggerExperiment {
      * @param experimentId - unique identifier of the experiment you want to expose to a user
      */
     getVariationId: (visitorCode: string, experimentId: number) => number;
+    triggerExperimentError: KameleoonError | null;
 }
 /**
  * A React HOC that gives a wrapped component access to callback function which triggers experiment