@statsig/client-core 0.0.1-beta.3 → 0.0.1-beta.31

package/src/StorageProvider.js

@@ -8,103 +8,94 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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 (g && (g = 0, op[0] && (_ = 0)), _) 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.setObjectInStorage = exports.getObjectFromStorage = exports.Storage = void 0;
-var Log_1 = require("./Log");
-var inMemoryStore = {};
-var provider = {
-    getItem: function (key) {
+exports._setObjectInStorage = exports._getObjectFromStorage = exports.Storage = void 0;
+const Log_1 = require("./Log");
+const inMemoryStore = {};
+const _inMemoryProvider = {
+    _getProviderName: () => 'InMemory',
+    _getItemSync(key) {
+        var _a;
+        return (_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null;
+    },
+    _getItem(key) {
         var _a;
         return Promise.resolve((_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null);
     },
-    setItem: function (key, value) {
+    _setItem(key, value) {
         inMemoryStore[key] = value;
         return Promise.resolve();
     },
-    removeItem: function (key) {
+    _removeItem(key) {
         delete inMemoryStore[key];
         return Promise.resolve();
     },
+    _getAllKeys() {
+        return Promise.resolve(Object.keys(inMemoryStore));
+    },
 };
+let _localStorageProvider = null;
 try {
     if (typeof window !== 'undefined' && 'localStorage' in window) {
-        provider = {
-            getItem: function (key) {
+        _localStorageProvider = {
+            _getProviderName: () => 'LocalStorage',
+            _getItemSync(key) {
+                return localStorage.getItem(key);
+            },
+            _getItem(key) {
                 return Promise.resolve(localStorage.getItem(key));
             },
-            setItem: function (key, value) {
+            _setItem(key, value) {
                 localStorage.setItem(key, value);
                 return Promise.resolve();
             },
-            removeItem: function (key) {
+            _removeItem(key) {
                 localStorage.removeItem(key);
                 return Promise.resolve();
             },
+            _getAllKeys() {
+                const keys = Object.keys(localStorage);
+                return Promise.resolve(keys);
+            },
         };
     }
 }
 catch (error) {
-    Log_1.Log.warn('Failed to get storage provider. Failling back to in memory store.');
+    Log_1.Log.warn('Failed to setup localStorageProvider.');
 }
+let _main = _localStorageProvider !== null && _localStorageProvider !== void 0 ? _localStorageProvider : _inMemoryProvider;
+let _current = _main;
 exports.Storage = {
-    getItem: function (key) { return provider.getItem(key); },
-    setItem: function (key, value) { return provider.setItem(key, value); },
-    removeItem: function (key) { return provider.removeItem(key); },
-    setProvider: function (newProvider) {
-        provider = newProvider;
+    _getProviderName: () => _current._getProviderName(),
+    _getItem: (key) => _current._getItem(key),
+    _setItem: (key, value) => _current._setItem(key, value),
+    _removeItem: (key) => _current._removeItem(key),
+    _getAllKeys: () => _current._getAllKeys(),
+    _getItemSync: (key) => { var _a, _b; return (_b = (_a = _current._getItemSync) === null || _a === void 0 ? void 0 : _a.call(_current, key)) !== null && _b !== void 0 ? _b : null; },
+    // StorageProviderManagment
+    _setProvider: (newProvider) => {
+        _main = newProvider;
+        _current = newProvider;
+    },
+    _setDisabled: (isDisabled) => {
+        if (isDisabled) {
+            _current = _inMemoryProvider;
+        }
+        else {
+            _current = _main;
+        }
     },
 };
-function getObjectFromStorage(key) {
-    return __awaiter(this, void 0, void 0, function () {
-        var value;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, provider.getItem(key)];
-                case 1:
-                    value = _a.sent();
-                    return [2 /*return*/, JSON.parse(value !== null && value !== void 0 ? value : 'null')];
-            }
-        });
+function _getObjectFromStorage(key) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const value = yield _current._getItem(key);
+        return JSON.parse(value !== null && value !== void 0 ? value : 'null');
     });
 }
-exports.getObjectFromStorage = getObjectFromStorage;
-function setObjectInStorage(key, obj) {
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, provider.setItem(key, JSON.stringify(obj))];
-                case 1:
-                    _a.sent();
-                    return [2 /*return*/];
-            }
-        });
+exports._getObjectFromStorage = _getObjectFromStorage;
+function _setObjectInStorage(key, obj) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield _current._setItem(key, JSON.stringify(obj));
     });
 }
-exports.setObjectInStorage = setObjectInStorage;
+exports._setObjectInStorage = _setObjectInStorage;

package/src/TypedJsonParse.d.ts

@@ -0,0 +1,8 @@
+/**
+ *
+ * @param {string} data The values to parse into T
+ * @param {string} guard A field that must exists on the parsed object for the parse to be valid
+ * @param {string} error An error to print via Log.error() when parsing fails
+ * @returns {T | null} The parse object T or null if it failed
+ */
+export declare function typedJsonParse<T>(data: string, guard: string, error: string): T | null;

package/src/TypedJsonParse.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typedJsonParse = void 0;
+const Log_1 = require("./Log");
+/**
+ *
+ * @param {string} data The values to parse into T
+ * @param {string} guard A field that must exists on the parsed object for the parse to be valid
+ * @param {string} error An error to print via Log.error() when parsing fails
+ * @returns {T | null} The parse object T or null if it failed
+ */
+function typedJsonParse(data, guard, error) {
+    try {
+        const result = JSON.parse(data);
+        if (typeof result === 'object' &&
+            guard in result) {
+            return result;
+        }
+        return result;
+    }
+    catch (_a) {
+        // noop
+    }
+    Log_1.Log.error(error);
+    return null;
+}
+exports.typedJsonParse = typedJsonParse;

package/src/UUID.js

@@ -2,14 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUUID = void 0;
 function getUUID() {
-    var d = new Date().getTime();
-    var d2 = (typeof performance !== 'undefined' &&
+    if (typeof crypto !== 'undefined' &&
+        typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    let d = new Date().getTime();
+    let d2 = (typeof performance !== 'undefined' &&
         performance.now &&
         performance.now() * 1000) ||
         0;
-    var y = '89ab'[Math.floor(Math.random() * 4)];
-    return "xxxxxxxx-xxxx-4xxx-".concat(y, "xxx-xxxxxxxxxxxx").replace(/[xy]/g, function (c) {
-        var r = Math.random() * 16;
+    const y = '89ab'[Math.floor(Math.random() * 4)];
+    return `xxxxxxxx-xxxx-4xxx-${y}xxx-xxxxxxxxxxxx`.replace(/[xy]/g, (c) => {
+        let r = Math.random() * 16;
         if (d > 0) {
             r = (d + r) % 16 | 0;
             d = Math.floor(d / 16);

package/src/UrlOverrides.d.ts

@@ -0,0 +1 @@
+export declare function _getOverridableUrl(overrideUrl: string | undefined, overrideApi: string | undefined, defaultEndpoint: string, defaultApi: string): string;

package/src/UrlOverrides.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._getOverridableUrl = void 0;
+function _getOverridableUrl(overrideUrl, overrideApi, defaultEndpoint, defaultApi) {
+    if (overrideUrl) {
+        return overrideUrl;
+    }
+    else if (overrideApi) {
+        return `${overrideApi}${defaultEndpoint}`;
+    }
+    else {
+        return `${defaultApi}${defaultEndpoint}`;
+    }
+}
+exports._getOverridableUrl = _getOverridableUrl;

package/src/UtitlityTypes.d.ts

@@ -0,0 +1,3 @@
+export type Flatten<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/src/UtitlityTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/VisibilityObserving.d.ts

@@ -0,0 +1,8 @@
+declare const FOREGROUND = "foreground";
+declare const BACKGROUND = "background";
+export type Visibility = typeof FOREGROUND | typeof BACKGROUND;
+type VisibilityChangedCallback = (visibility: Visibility) => void;
+export declare const _isCurrentlyVisible: () => boolean;
+export declare const _subscribeToVisiblityChanged: (listener: VisibilityChangedCallback) => void;
+export declare const _notifyVisibilityChanged: (visibility: Visibility) => void;
+export {};

package/src/VisibilityObserving.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._notifyVisibilityChanged = exports._subscribeToVisiblityChanged = exports._isCurrentlyVisible = void 0;
+const SafeJs_1 = require("./SafeJs");
+const FOREGROUND = 'foreground';
+const BACKGROUND = 'background';
+const LISTENERS = [];
+let current = FOREGROUND;
+const _isCurrentlyVisible = () => {
+    return current === FOREGROUND;
+};
+exports._isCurrentlyVisible = _isCurrentlyVisible;
+const _subscribeToVisiblityChanged = (listener) => {
+    LISTENERS.unshift(listener);
+};
+exports._subscribeToVisiblityChanged = _subscribeToVisiblityChanged;
+const _notifyVisibilityChanged = (visibility) => {
+    if (visibility === current) {
+        return;
+    }
+    current = visibility;
+    LISTENERS.forEach((l) => l(visibility));
+};
+exports._notifyVisibilityChanged = _notifyVisibilityChanged;
+(0, SafeJs_1._addWindowEventListenerSafe)('focus', () => (0, exports._notifyVisibilityChanged)(FOREGROUND));
+(0, SafeJs_1._addWindowEventListenerSafe)('blur', () => (0, exports._notifyVisibilityChanged)(BACKGROUND));
+(0, SafeJs_1._addWindowEventListenerSafe)('beforeunload', () => (0, exports._notifyVisibilityChanged)(BACKGROUND));
+(0, SafeJs_1._addDocumentEventListenerSafe)('visibilitychange', () => {
+    (0, exports._notifyVisibilityChanged)(document.visibilityState === 'visible' ? FOREGROUND : BACKGROUND);
+});

package/src/index.d.ts

@@ -1,23 +1,40 @@
 /** Statsig Global should go first */
 import './$_StatsigGlobal';
 import { EventLogger } from './EventLogger';
+import { Log } from './Log';
+import { Storage } from './StorageProvider';
 export * from './$_StatsigGlobal';
 export * from './ClientInterfaces';
+export * from './DataAdapterCore';
+export * from './DownloadConfigSpecsResponse';
 export * from './ErrorBoundary';
+export * from './EvaluationOptions';
+export * from './EvaluationTypes';
 export * from './Hashing';
-export * from './StorageProvider';
+export * from './InitializeResponse';
 export * from './Log';
 export * from './Monitoring';
+export * from './NetworkParams';
 export * from './NetworkCore';
+export * from './NetworkDefaults';
+export * from './OverrideAdapter';
+export * from './SafeJs';
+export * from './SDKType';
+export * from './SessionID';
 export * from './StableID';
 export * from './StatsigClientBase';
 export * from './StatsigClientEventEmitter';
-export * from './StatsigDataProvider';
+export * from './StatsigDataAdapter';
 export * from './StatsigEvent';
 export * from './StatsigMetadata';
 export * from './StatsigOptionsCommon';
+export * from './StatsigTypeFactories';
 export * from './StatsigTypes';
 export * from './StatsigUser';
+export * from './StorageProvider';
+export * from './TypedJsonParse';
+export * from './UrlOverrides';
+export * from './UtitlityTypes';
 export * from './UUID';
-export * from './VisibilityChangeObserver';
-export { EventLogger };
+export * from './VisibilityObserving';
+export { EventLogger, Storage, Log };

package/src/index.js

@@ -1,15 +1,4 @@
 "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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -25,28 +14,53 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventLogger = void 0;
+exports.Log = exports.Storage = exports.EventLogger = void 0;
 /** Statsig Global should go first */
 require("./$_StatsigGlobal");
-var EventLogger_1 = require("./EventLogger");
+const EventLogger_1 = require("./EventLogger");
 Object.defineProperty(exports, "EventLogger", { enumerable: true, get: function () { return EventLogger_1.EventLogger; } });
+const Log_1 = require("./Log");
+Object.defineProperty(exports, "Log", { enumerable: true, get: function () { return Log_1.Log; } });
+const StatsigMetadata_1 = require("./StatsigMetadata");
+const StorageProvider_1 = require("./StorageProvider");
+Object.defineProperty(exports, "Storage", { enumerable: true, get: function () { return StorageProvider_1.Storage; } });
+const UUID_1 = require("./UUID");
 __exportStar(require("./$_StatsigGlobal"), exports);
 __exportStar(require("./ClientInterfaces"), exports);
+__exportStar(require("./DataAdapterCore"), exports);
+__exportStar(require("./DownloadConfigSpecsResponse"), exports);
 __exportStar(require("./ErrorBoundary"), exports);
+__exportStar(require("./EvaluationOptions"), exports);
+__exportStar(require("./EvaluationTypes"), exports);
 __exportStar(require("./Hashing"), exports);
-__exportStar(require("./StorageProvider"), exports);
+__exportStar(require("./InitializeResponse"), exports);
 __exportStar(require("./Log"), exports);
 __exportStar(require("./Monitoring"), exports);
+__exportStar(require("./NetworkParams"), exports);
 __exportStar(require("./NetworkCore"), exports);
+__exportStar(require("./NetworkDefaults"), exports);
+__exportStar(require("./OverrideAdapter"), exports);
+__exportStar(require("./SafeJs"), exports);
+__exportStar(require("./SDKType"), exports);
+__exportStar(require("./SessionID"), exports);
 __exportStar(require("./StableID"), exports);
 __exportStar(require("./StatsigClientBase"), exports);
 __exportStar(require("./StatsigClientEventEmitter"), exports);
-__exportStar(require("./StatsigDataProvider"), exports);
+__exportStar(require("./StatsigDataAdapter"), exports);
 __exportStar(require("./StatsigEvent"), exports);
 __exportStar(require("./StatsigMetadata"), exports);
 __exportStar(require("./StatsigOptionsCommon"), exports);
+__exportStar(require("./StatsigTypeFactories"), exports);
 __exportStar(require("./StatsigTypes"), exports);
 __exportStar(require("./StatsigUser"), exports);
+__exportStar(require("./StorageProvider"), exports);
+__exportStar(require("./TypedJsonParse"), exports);
+__exportStar(require("./UrlOverrides"), exports);
+__exportStar(require("./UtitlityTypes"), exports);
 __exportStar(require("./UUID"), exports);
-__exportStar(require("./VisibilityChangeObserver"), exports);
-__STATSIG__ = __assign(__assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { EventLogger: EventLogger_1.EventLogger });
+__exportStar(require("./VisibilityObserving"), exports);
+__STATSIG__ = Object.assign(Object.assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { EventLogger: EventLogger_1.EventLogger,
+    Log: Log_1.Log,
+    getUUID: UUID_1.getUUID,
+    Storage: StorageProvider_1.Storage,
+    SDK_VERSION: StatsigMetadata_1.SDK_VERSION });

package/src/StatsigDataProvider.d.ts

@@ -1,9 +0,0 @@
-import { StatsigUser } from './StatsigUser';
-export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'Bootstrap' | 'Prefetch';
-export type StatsigDataProvider = {
-    readonly getData?: (sdkKey: string, user?: StatsigUser) => string | null;
-    readonly getDataAsync?: (sdkKey: string, user?: StatsigUser) => Promise<string | null>;
-    readonly getDataPostInit?: (sdkKey: string, currentData: string | null, user?: StatsigUser) => Promise<string | null>;
-    readonly setDataPostInit?: (sdkKey: string, data: string, user?: StatsigUser) => Promise<void>;
-    readonly source: DataSource;
-};

package/src/VisibilityChangeObserver.d.ts

@@ -1,13 +0,0 @@
-export type Visibility = 'foreground' | 'background';
-type VisibilityChangeListener = {
-    onVisibilityChanged: (visibility: Visibility) => void;
-};
-export declare class VisibilityChangeObserver {
-    private static _listeners;
-    private static _current;
-    static isCurrentlyVisible(): boolean;
-    static add(listener: VisibilityChangeListener): void;
-    static remove(listener: VisibilityChangeListener): void;
-    static notify(visibility: Visibility): void;
-}
-export {};

package/src/VisibilityChangeObserver.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VisibilityChangeObserver = void 0;
-var VisibilityChangeObserver = /** @class */ (function () {
-    function VisibilityChangeObserver() {
-    }
-    VisibilityChangeObserver.isCurrentlyVisible = function () {
-        return this._current === 'foreground';
-    };
-    VisibilityChangeObserver.add = function (listener) {
-        this._listeners.push(listener);
-    };
-    VisibilityChangeObserver.remove = function (listener) {
-        var index = this._listeners.indexOf(listener);
-        if (index !== -1) {
-            this._listeners.splice(index, 1);
-        }
-    };
-    VisibilityChangeObserver.notify = function (visibility) {
-        if (visibility === this._current) {
-            return;
-        }
-        this._current = visibility;
-        this._listeners.forEach(function (l) { return l.onVisibilityChanged(visibility); });
-    };
-    VisibilityChangeObserver._listeners = [];
-    VisibilityChangeObserver._current = 'foreground';
-    return VisibilityChangeObserver;
-}());
-exports.VisibilityChangeObserver = VisibilityChangeObserver;
-if (typeof window !== 'undefined' &&
-    typeof window.addEventListener === 'function') {
-    window.addEventListener('focus', function () {
-        return VisibilityChangeObserver.notify('foreground');
-    });
-    window.addEventListener('blur', function () {
-        return VisibilityChangeObserver.notify('background');
-    });
-    window.addEventListener('beforeunload', function () {
-        return VisibilityChangeObserver.notify('background');
-    });
-}
-if (typeof document !== 'undefined' &&
-    typeof document.addEventListener === 'function') {
-    document.addEventListener('visibilitychange', function () {
-        VisibilityChangeObserver.notify(document.visibilityState === 'visible' ? 'foreground' : 'background');
-    });
-}

package/src/__tests__/MockLocalStorage.d.ts

@@ -1,9 +0,0 @@
-export declare class MockLocalStorage {
-    data: Record<string, string>;
-    static enabledMockStorage(): MockLocalStorage;
-    static disableMockStorage(): void;
-    clear(): void;
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-    removeItem(key: string): void;
-}

package/src/__tests__/MockLocalStorage.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockLocalStorage = void 0;
-var actualLocalStorage = window.localStorage;
-// todo: move to test-helpers (break circular dep)
-var MockLocalStorage = /** @class */ (function () {
-    function MockLocalStorage() {
-        this.data = {};
-    }
-    MockLocalStorage.enabledMockStorage = function () {
-        var value = new MockLocalStorage();
-        Object.defineProperty(window, 'localStorage', {
-            value: value,
-        });
-        return value;
-    };
-    MockLocalStorage.disableMockStorage = function () {
-        Object.defineProperty(window, 'localStorage', {
-            value: actualLocalStorage,
-        });
-    };
-    // LocalStorage Functions
-    MockLocalStorage.prototype.clear = function () {
-        this.data = {};
-    };
-    MockLocalStorage.prototype.getItem = function (key) {
-        return this.data[key] ? this.data[key] : null;
-    };
-    MockLocalStorage.prototype.setItem = function (key, value) {
-        this.data[key] = String(value);
-    };
-    MockLocalStorage.prototype.removeItem = function (key) {
-        delete this.data[key];
-    };
-    return MockLocalStorage;
-}());
-exports.MockLocalStorage = MockLocalStorage;