@kameleoon/react-sdk 4.0.0 → 4.0.3

package/dist/useFeature.js

@@ -0,0 +1,104 @@
+"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);
+};
+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");
+var useActivateFeature_1 = require("./useActivateFeature");
+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 _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 _e = __read((0, react_1.useState)((_b = {},
+        _b[constants_1.FeatureResultField.IsActive] = false,
+        _b[constants_1.FeatureResultField.Variables] = [],
+        _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;
+        if (value) {
+            return _a = {},
+                _a[key] = value,
+                _a;
+        }
+        return {};
+    }
+    var getVariablesArray = (0, react_1.useCallback)(function (environment) {
+        var variablesArray = [];
+        var environmentVariableKeys = variableKeys[environment];
+        if (Array.isArray(environmentVariableKeys)) {
+            environmentVariableKeys.forEach(function (key) {
+                variablesArray.push(getVariableObject(key, getFeatureVariable(featureKey, key)));
+            });
+        }
+        else {
+            variablesArray.push(getVariableObject(environmentVariableKeys, getFeatureVariable(featureKey, environmentVariableKeys)));
+        }
+        return variablesArray;
+    }, [variableKeys, getFeatureVariable, featureKey]);
+    (0, react_1.useEffect)(function () {
+        var _a;
+        var _b, _c, _d;
+        var _e = __read((_b = client.configurations) === null || _b === void 0 ? void 0 : _b.configuration.featureFlags.filter(function (item) {
+            return item.identificationKey === featureKey;
+        }), 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(featureKey, userCode),
+                _a[constants_1.FeatureResultField.Variables] = getVariablesArray(currentEnvironment),
+                _a));
+        }
+        catch (_f) {
+            setFeature(function (prevFeature) {
+                var _a;
+                return (__assign(__assign({}, prevFeature), (_a = {}, _a[constants_1.FeatureResultField.IsActive] = false, _a)));
+            });
+        }
+        // getVariablesArray put in dependencies creates an infinite loop
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [userCode, featureKey, hasFeature]);
+    (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

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

package/dist/useFeatureVariable.d.ts

@@ -0,0 +1,15 @@
+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
+ */
+export declare function useFeatureVariable(): FeatureVariableHookResult;
+export {};

package/dist/useFeatureVariable.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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;
+        }
+        if (typeof value === 'string' && (0, isJSON_1.default)(value)) {
+            return JSON.parse(value);
+        }
+        return value;
+    }, []);
+    var getFeatureVariable = (0, react_1.useCallback)(function (featureKey, variableKey) {
+        try {
+            return getProcessedVariable(client.obtainFeatureVariable(featureKey, variableKey));
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return undefined;
+        }
+    }, [client, getProcessedVariable, setError]);
+    return {
+        getFeatureVariable: getFeatureVariable,
+        error: error,
+    };
+}
+exports.useFeatureVariable = useFeatureVariable;
+//# sourceMappingURL=useFeatureVariable.js.map

package/dist/useFeatureVariable.js.map

@@ -0,0 +1 @@
+{"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/useFlush.d.ts

@@ -0,0 +1,11 @@
+interface FlushHookResult {
+    /**
+     * @param visitorCode - unique identifier of the user
+     */
+    flush: (visitorCode: string) => void;
+}
+/**
+ * A React Hook that returns callback function which allows to flush data to servers
+ */
+export declare function useFlush(): FlushHookResult;
+export {};

package/dist/useFlush.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFlush = void 0;
+var react_1 = require("react");
+var useKameleoon_1 = require("./useKameleoon");
+/**
+ * A React Hook that returns callback function which allows to flush data to servers
+ */
+function useFlush() {
+    var client = (0, useKameleoon_1.useKameleoon)().client;
+    var flush = (0, react_1.useCallback)(function (visitorCode) {
+        client.flush(visitorCode);
+    }, [client]);
+    return {
+        flush: flush,
+    };
+}
+exports.useFlush = useFlush;
+//# sourceMappingURL=useFlush.js.map

package/dist/useFlush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlush.js","sourceRoot":"","sources":["../src/useFlush.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAS9C;;GAEG;AACH,SAAgB,QAAQ;IACd,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,KAAK,GAAG,IAAA,mBAAW,EACvB,UAAC,WAAmB;QAClB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AAbD,4BAaC"}

package/dist/useKameleoon.d.ts

@@ -0,0 +1,10 @@
+import { KameleoonClient } from 'kameleoon-client-javascript';
+interface KameleoonHookResult {
+    /** An instance of KameleoonClient */
+    client: KameleoonClient;
+}
+/**
+ * A React Hook that validates if context is used within a KameleoonProvider and returns it
+ */
+export declare function useKameleoon(): KameleoonHookResult;
+export {};

package/dist/useKameleoon.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useKameleoon = void 0;
+var react_1 = require("react");
+var KameleoonContext_1 = require("./KameleoonContext");
+var ProviderError_1 = require("./ProviderError");
+/**
+ * A React Hook that validates if context is used within a KameleoonProvider and returns it
+ */
+function useKameleoon() {
+    var context = (0, react_1.useContext)(KameleoonContext_1.KameleoonContext);
+    if (!context) {
+        throw new ProviderError_1.ProviderError('useKameleoon');
+    }
+    return {
+        client: context,
+    };
+}
+exports.useKameleoon = useKameleoon;
+//# sourceMappingURL=useKameleoon.js.map

package/dist/useKameleoon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKameleoon.js","sourceRoot":"","sources":["../src/useKameleoon.ts"],"names":[],"mappings":";;;AAAA,+BAAmC;AAEnC,uDAAsD;AACtD,iDAAgD;AAOhD;;GAEG;AACH,SAAgB,YAAY;IAC1B,IAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,mCAAgB,CAAC,CAAC;IAE7C,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,IAAI,6BAAa,CAAC,cAAc,CAAC,CAAC;KACzC;IAED,OAAO;QACL,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC;AAVD,oCAUC"}

package/dist/usePageView.d.ts

@@ -0,0 +1,14 @@
+import { PageView } from 'kameleoon-client-javascript/dist/data';
+interface PageViewHookResult {
+    /**
+     * @param url - URL of the page viewed
+     * @param title - title of the page viewed
+     * @param referrer - referrer of the page viewed
+     */
+    addPageView: (url: string, title: string, referrer?: number) => PageView;
+}
+/**
+ * A React Hook that returns callback function which adds page view
+ */
+export declare function usePageView(): PageViewHookResult;
+export {};

package/dist/usePageView.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePageView = void 0;
+var react_1 = require("react");
+var kameleoon_client_javascript_1 = require("kameleoon-client-javascript");
+/**
+ * A React Hook that returns callback function which adds page view
+ */
+function usePageView() {
+    var addPageView = (0, react_1.useCallback)(function (url, title, referrer) {
+        return new kameleoon_client_javascript_1.KameleoonData.PageView(url, title, referrer);
+    }, []);
+    return {
+        addPageView: addPageView,
+    };
+}
+exports.usePageView = usePageView;
+//# sourceMappingURL=usePageView.js.map

package/dist/usePageView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageView.js","sourceRoot":"","sources":["../src/usePageView.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,2EAA4D;AAY5D;;GAEG;AACH,SAAgB,WAAW;IACzB,IAAM,WAAW,GAAG,IAAA,mBAAW,EAC7B,UAAC,GAAW,EAAE,KAAa,EAAE,QAAiB;QAC5C,OAAA,IAAI,2CAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC;IAAhD,CAAgD,EAClD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,WAAW,aAAA;KACZ,CAAC;AACJ,CAAC;AAVD,kCAUC"}

package/dist/useRetrieveDataFromRemoteSource.d.ts

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

package/dist/useRetrieveDataFromRemoteSource.js

@@ -0,0 +1,79 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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
+ */
+function useRetrieveDataFromRemoteSource() {
+    var _this = this;
+    var client = (0, useKameleoon_1.useKameleoon)().client;
+    var isObjectEmpty = (0, react_1.useCallback)(function (object) {
+        return (object &&
+            Object.keys(object).length === 0 &&
+            Object.getPrototypeOf(object) === Object.prototype);
+    }, []);
+    var retrieveDataFromRemoteSource = (0, react_1.useCallback)(function (key) { return __awaiter(_this, void 0, void 0, function () {
+        var resultData, error;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, client.retrieveDataFromRemoteSource(key)];
+                case 1:
+                    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: resultData, error: null }];
+            }
+        });
+    }); }, [client, isObjectEmpty]);
+    if (!client) {
+        throw new ProviderError_1.ProviderError('useKameleoon');
+    }
+    return {
+        retrieveDataFromRemoteSource: retrieveDataFromRemoteSource,
+    };
+}
+exports.useRetrieveDataFromRemoteSource = useRetrieveDataFromRemoteSource;
+//# sourceMappingURL=useRetrieveDataFromRemoteSource.js.map

package/dist/useRetrieveDataFromRemoteSource.js.map

@@ -0,0 +1 @@
+{"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/useTrackingConversion.d.ts

@@ -0,0 +1,13 @@
+interface TrackingConversionHookResult {
+    /**
+     * @param visitorCode - unique identifier of the user
+     * @param goalId - unique identifier of the goal
+     * @param revenue - revenue of the conversion
+     */
+    trackConversion: (visitorCode: string, goalId: number, revenue?: number) => void;
+}
+/**
+ * A React Hook that returns callback function which tracks conversion
+ */
+export declare function useTrackingConversion(): TrackingConversionHookResult;
+export {};

package/dist/useTrackingConversion.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTrackingConversion = void 0;
+var react_1 = require("react");
+var useKameleoon_1 = require("./useKameleoon");
+/**
+ * A React Hook that returns callback function which tracks conversion
+ */
+function useTrackingConversion() {
+    var client = (0, useKameleoon_1.useKameleoon)().client;
+    var trackConversion = (0, react_1.useCallback)(function (visitorCode, goalId, revenue) {
+        client.trackConversion(visitorCode, goalId, revenue);
+    }, [client]);
+    return {
+        trackConversion: trackConversion,
+    };
+}
+exports.useTrackingConversion = useTrackingConversion;
+//# sourceMappingURL=useTrackingConversion.js.map

package/dist/useTrackingConversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackingConversion.js","sourceRoot":"","sources":["../src/useTrackingConversion.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAe9C;;GAEG;AACH,SAAgB,qBAAqB;IAC3B,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,eAAe,GAAG,IAAA,mBAAW,EACjC,UAAC,WAAmB,EAAE,MAAc,EAAE,OAAgB;QACpD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,eAAe,iBAAA;KAChB,CAAC;AACJ,CAAC;AAbD,sDAaC"}

package/dist/useTriggerExperiment.d.ts

@@ -0,0 +1,17 @@
+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.
+ * If such a user has never been associated with any variation, the SDK returns a randomly selected variation.
+ * If a user with a given visitorCode is already registered with a variation,
+ * it will detect the previously registered variation and return the variationID
+ */
+export declare function useTriggerExperiment(): IGetVariationIdHookResult;
+export {};

package/dist/useTriggerExperiment.js

@@ -0,0 +1,32 @@
+"use strict";
+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.
+ * If a user with a given visitorCode is already registered with a variation,
+ * 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) {
+        try {
+            return client.triggerExperiment(visitorCode, experimentId);
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return DEFAULT_VARIATION_ID;
+        }
+    }, [client, setError]);
+    return {
+        getVariationId: getVariationId,
+        error: error,
+    };
+}
+exports.useTriggerExperiment = useTriggerExperiment;
+//# sourceMappingURL=useTriggerExperiment.js.map

package/dist/useTriggerExperiment.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,16 @@
+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) => VariationAssociatedDataType;
+    error: KameleoonError | null;
+}
+/**
+ * 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,
+ * and can be configured on our web application interface or via our Automation API.
+ */
+export declare function useVariationAssociatedData(): VariationAssociatedDataHookResult;
+export {};

package/dist/useVariationAssociatedData.js

@@ -0,0 +1,30 @@
+"use strict";
+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,
+ * and can be configured on our web application interface or via our Automation API.
+ */
+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) {
+        try {
+            return client.obtainVariationAssociatedData(variationId);
+        }
+        catch (unknownError) {
+            setError(unknownError);
+            return null;
+        }
+    }, [client, setError]);
+    return {
+        getVariationAssociatedData: getVariationAssociatedData,
+        error: error,
+    };
+}
+exports.useVariationAssociatedData = useVariationAssociatedData;
+//# sourceMappingURL=useVariationAssociatedData.js.map

package/dist/useVariationAssociatedData.js.map

@@ -0,0 +1 @@
+{"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/useVisitorCode.d.ts

@@ -0,0 +1,12 @@
+interface VisitorCodeHookResult {
+    /**
+     * @param topLevelDomain - current top level domain for the concerned site
+     * @param defaultVisitorCode - this parameter will be used as the visitorCode
+     */
+    getVisitorCode: (topLevelDomain: string, defaultVisitorCode?: string) => string;
+}
+/**
+ * A React Hook that returns callback function which obtains the Kameleoon visitorCode for the current visitor
+ */
+export declare function useVisitorCode(): VisitorCodeHookResult;
+export {};

package/dist/useVisitorCode.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useVisitorCode = void 0;
+var react_1 = require("react");
+var useKameleoon_1 = require("./useKameleoon");
+/**
+ * A React Hook that returns callback function which obtains the Kameleoon visitorCode for the current visitor
+ */
+function useVisitorCode() {
+    var client = (0, useKameleoon_1.useKameleoon)().client;
+    var getVisitorCode = (0, react_1.useCallback)(function (topLevelDomain, defaultVisitorCode) {
+        return client.obtainVisitorCode(topLevelDomain, defaultVisitorCode);
+    }, [client]);
+    return {
+        getVisitorCode: getVisitorCode,
+    };
+}
+exports.useVisitorCode = useVisitorCode;
+//# sourceMappingURL=useVisitorCode.js.map

package/dist/useVisitorCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisitorCode.js","sourceRoot":"","sources":["../src/useVisitorCode.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,+CAA8C;AAa9C;;GAEG;AACH,SAAgB,cAAc;IACpB,IAAA,MAAM,GAAK,IAAA,2BAAY,GAAE,OAAnB,CAAoB;IAElC,IAAM,cAAc,GAAG,IAAA,mBAAW,EAChC,UAAC,cAAsB,EAAE,kBAA2B;QAClD,OAAA,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAA5D,CAA4D,EAC9D,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,cAAc,gBAAA;KACf,CAAC;AACJ,CAAC;AAZD,wCAYC"}

package/dist/withActivateFeature.d.ts

@@ -0,0 +1,17 @@
+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: (featureKey: string | number, visitorCode?: string) => boolean;
+    activateFeatureError: KameleoonError | null;
+}
+/**
+ * A React HOC that gives a wrapped component access to callback
+ * function which activates a feature toggle
+ */
+export declare function withActivateFeature<Props extends UnknownPropsType>(Component: React.ComponentType<Props>): React.ComponentType<Props & Without<Props, IWithHasFeature>>;
+export {};