@flipt-io/flipt-client-js 0.4.1 → 0.5.0

package/dist/slim/index.mjs

@@ -44,6 +44,27 @@ class Engine {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * @returns {string}
+     */
+    get_snapshot() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ret = wasm.engine_get_snapshot(this.__wbg_ptr);
+            var ptr1 = ret[0];
+            var len1 = ret[1];
+            if (ret[3]) {
+                ptr1 = 0; len1 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * @returns {any}
      */
@@ -61,10 +82,21 @@ class Engine {
         const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.engine_new(ptr0, len0);
-        this.__wbg_ptr = ret >>> 0;
+        this.__wbg_ptr = ret;
         EngineFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * @param {string} snapshot_b64
+     */
+    seed_snapshot(snapshot_b64) {
+        const ptr0 = passStringToWasm0(snapshot_b64, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.engine_seed_snapshot(this.__wbg_ptr, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * @param {any} data
      */
@@ -76,11 +108,10 @@ class Engine {
     }
 }
 if (Symbol.dispose) Engine.prototype[Symbol.dispose] = Engine.prototype.free;
-
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_55538483de6e3abe: function(arg0, arg1) {
+        __wbg_Error_fdd633d4bb5dd76a: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
@@ -91,50 +122,50 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_boolean_get_fe2a24fdfdb4064f: function(arg0) {
+        __wbg___wbindgen_boolean_get_edaed31a367ce1bd: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_d89627202d0155b7: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_8a447059637473e2: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_fe3eb6a509f75744: function(arg0, arg1) {
+        __wbg___wbindgen_in_4990f46af709e33c: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_function_2a95406423ea8626: function(arg0) {
+        __wbg___wbindgen_is_function_acc5528be2b923f2: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_object_59a002e76b059312: function(arg0) {
+        __wbg___wbindgen_is_object_0beba4a1980d3eea: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_624d5244bb2bc87c: function(arg0) {
+        __wbg___wbindgen_is_string_1fca8072260dd261: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_87a3a837f331fef5: function(arg0) {
+        __wbg___wbindgen_is_undefined_721f8decd50c87a3: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_cf851f110c48f9ba: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_4b9aba9e5b3c4582: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_769f3676dc20c1d7: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_1cc01dd708740256: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_f1161390414f9b59: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_71bb4348194e31f0: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -142,18 +173,18 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_5549492daedad139: function(arg0, arg1) {
+        __wbg___wbindgen_throw_ea4887a5f8f9a9db: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_6ae20895a60069a2: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_8e98ed2f3c86c4b5: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_19f92cb1f8738aba: function(arg0) {
+        __wbg_done_b62d4a7d2286852a: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_28ed7cb892e12eff: function(arg0) {
+        __wbg_entries_c261c3fa1f281256: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
@@ -168,19 +199,19 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_getTime_c3af35594e283356: function(arg0) {
+        __wbg_getTime_7a770f8a2ec8d634: function(arg0) {
             const ret = arg0.getTime();
             return ret;
         },
-        __wbg_get_94f5fc088edd3138: function(arg0, arg1) {
+        __wbg_get_197a3fe98f169e38: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_get_a50328e7325d7f9b: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_9a29be2cb383ed9a: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_unchecked_7c6bbabf5b0b1fbf: function(arg0, arg1) {
+        __wbg_get_unchecked_54a4374c38e08460: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -188,7 +219,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_8d855993947fc3a2: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_2a7bb09fee70c2da: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -198,7 +229,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_ce24d58a5f4bdcc3: function(arg0) {
+        __wbg_instanceof_Uint8Array_f080092dc70f5d58: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -208,50 +239,50 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_867202cf8f195ed8: function(arg0) {
+        __wbg_isArray_145a34fd0a38d37b: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_iterator_54661826e186eb6a: function() {
+        __wbg_iterator_cc47ba25a2be735a: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_e6e1633fbea6cfa9: function(arg0) {
+        __wbg_length_589238bdcf171f0e: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_fae3e439140f48a4: function(arg0) {
+        __wbg_length_c6054974c0a6cdb9: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_0_e649c99e7382313f: function() {
+        __wbg_new_0_1b32bedde98fef4b: function() {
             const ret = new Date();
             return ret;
         },
-        __wbg_new_1d96678aaacca32e: function(arg0) {
-            const ret = new Uint8Array(arg0);
-            return ret;
-        },
         __wbg_new_227d7c05414eb861: function() {
             const ret = new Error();
             return ret;
         },
-        __wbg_new_4370be21fa2b2f80: function() {
-            const ret = new Array();
+        __wbg_new_2e117a478906f062: function() {
+            const ret = new Object();
             return ret;
         },
-        __wbg_new_48e1d86cfd30c8e7: function() {
-            const ret = new Object();
+        __wbg_new_36e147a8ced3c6e0: function() {
+            const ret = new Array();
             return ret;
         },
-        __wbg_next_55d835fe0ab5b3e7: function(arg0) {
-            const ret = arg0.next;
+        __wbg_new_81880fb5002cb255: function(arg0) {
+            const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_next_e34cfb9df1518d7c: function() { return handleError(function (arg0) {
+        __wbg_next_0c4066e251d2eff9: function() { return handleError(function (arg0) {
             const ret = arg0.next();
             return ret;
         }, arguments); },
+        __wbg_next_402fa10b59ab20c3: function(arg0) {
+            const ret = arg0.next;
+            return ret;
+        },
         __wbg_now_e7c6795a7f81e10f: function(arg0) {
             const ret = arg0.now();
             return ret;
@@ -260,15 +291,15 @@ function __wbg_get_imports() {
             const ret = arg0.performance;
             return ret;
         },
-        __wbg_prototypesetcall_3875d54d12ef2eec: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_d721637c7ca66eb8: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_set_4702dfa37c77f492: function(arg0, arg1, arg2) {
-            arg0[arg1 >>> 0] = arg2;
-        },
         __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
             arg0[arg1] = arg2;
         },
+        __wbg_set_dc601f4a69da0bc2: function(arg0, arg1, arg2) {
+            arg0[arg1 >>> 0] = arg2;
+        },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
             const ret = arg1.stack;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -276,23 +307,23 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg_static_accessor_GLOBAL_8dfb7f5e26ebe523: function() {
-            const ret = typeof global === 'undefined' ? null : global;
+        __wbg_static_accessor_GLOBAL_THIS_2fee5048bcca5938: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_GLOBAL_THIS_941154efc8395cdd: function() {
-            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+        __wbg_static_accessor_GLOBAL_ce44e66a4935da8c: function() {
+            const ret = typeof global === 'undefined' ? null : global;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_SELF_58dac9af822f561f: function() {
+        __wbg_static_accessor_SELF_44f6e0cb5e67cdad: function() {
             const ret = typeof self === 'undefined' ? null : self;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_WINDOW_ee64f0b3d8354c0b: function() {
+        __wbg_static_accessor_WINDOW_168f178805d978fe: function() {
             const ret = typeof window === 'undefined' ? null : window;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_value_d5b248ce8419bd1b: function(arg0) {
+        __wbg_value_49f783bb59765962: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
@@ -324,7 +355,7 @@ function __wbg_get_imports() {
 
 const EngineFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_engine_free(ptr >>> 0, 1));
+    : new FinalizationRegistry(ptr => wasm.__wbg_engine_free(ptr, 1));
 
 function addToExternrefTable0(obj) {
     const idx = wasm.__externref_table_alloc();
@@ -411,8 +442,7 @@ function getDataViewMemory0() {
 }
 
 function getStringFromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return decodeText(ptr, len);
+    return decodeText(ptr >>> 0, len);
 }
 
 let cachedUint8ArrayMemory0 = null;
@@ -649,6 +679,12 @@ class BaseFliptClient {
             this.etag = etag;
         }
     }
+    /**
+     * Returns a base64-encoded snapshot of the current flag state.
+     */
+    getSnapshot() {
+        return this.engine.get_snapshot();
+    }
     /**
      * Refresh the flags snapshot
      * @returns true if snapshot changed
@@ -829,6 +865,26 @@ class BaseFliptClient {
     }
 }
 
+async function initializeSnapshot({ engine, snapshot, errorStrategy, fetcher, storeEtag }) {
+    if (snapshot) {
+        engine.seed_snapshot(snapshot);
+    }
+    try {
+        const resp = await fetcher();
+        if (!resp.ok) {
+            throw new Error(`Failed to fetch data: ${resp.statusText}`);
+        }
+        const data = await resp.json();
+        engine.snapshot(data);
+        storeEtag(resp);
+    }
+    catch (error) {
+        if (!snapshot || errorStrategy !== ErrorStrategy.Fallback) {
+            throw error;
+        }
+    }
+}
+
 class FliptClient extends BaseFliptClient {
     /**
      * Initialize the client
@@ -883,17 +939,16 @@ class FliptClient extends BaseFliptClient {
         if (!fetcher) {
             throw new Error('Failed to initialize fetcher');
         }
-        // handle case if they pass in a custom fetcher that doesn't throw on non-2xx status codes
-        const resp = await fetcher();
-        if (!resp.ok) {
-            throw new Error(`Failed to fetch data: ${resp.statusText}`);
-        }
-        const data = await resp.json();
         const engine = new Engine(namespace);
-        engine.snapshot(data);
         // Create client instance
         const client = new FliptClient(engine, fetcher);
-        client.storeEtag(resp);
+        await initializeSnapshot({
+            engine,
+            snapshot: options.snapshot,
+            errorStrategy: options.errorStrategy,
+            fetcher,
+            storeEtag: (resp) => client.storeEtag(resp)
+        });
         client.errorStrategy = options.errorStrategy;
         client.hook = options.hook;
         return client;

package/dist/types/core/base.d.ts

@@ -11,6 +11,10 @@ export declare abstract class BaseFliptClient {
      * Store etag from response for next requests
      */
     protected storeEtag(resp: Response): void;
+    /**
+     * Returns a base64-encoded snapshot of the current flag state.
+     */
+    getSnapshot(): string;
     /**
      * Refresh the flags snapshot
      * @returns true if snapshot changed

package/dist/types/core/snapshot.d.ts

@@ -0,0 +1,13 @@
+import { ErrorStrategy, Response } from './types';
+type SnapshotEngine = {
+    seed_snapshot(snapshot: string): void;
+    snapshot(data: unknown): void;
+};
+export declare function initializeSnapshot({ engine, snapshot, errorStrategy, fetcher, storeEtag }: {
+    engine: SnapshotEngine;
+    snapshot?: string;
+    errorStrategy?: ErrorStrategy;
+    fetcher: () => Promise<Response>;
+    storeEtag: (resp: Response) => void;
+}): Promise<void>;
+export {};

package/dist/types/core/snapshot.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/core/types.d.ts

@@ -118,6 +118,12 @@ export interface ClientOptions {
      * @see {@link https://docs.flipt.io/guides/user/using-references}
      */
     reference?: string;
+    /**
+     * Base64-encoded snapshot returned by getSnapshot(). When provided with
+     * ErrorStrategy.Fallback, the client can initialize offline and refresh when
+     * Flipt becomes reachable again.
+     */
+    snapshot?: string;
     /**
      * The fetcher to use when fetching flag state. If not provided, the client will default to a fetch function.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipt-io/flipt-client-js",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Flipt Client Evaluation SDK for Web and Node.js",
   "type": "module",
   "main": "./dist/node/index.cjs",
@@ -105,7 +105,7 @@
     "ts-jest": "^29.0.3",
     "tslib": "^2.6.2",
     "typescript": "^5.4.3",
-    "undici": "^7.1.0"
+    "undici": "^8.0.2"
   },
   "engines": {
     "node": ">=14"