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

package/dist/slim/index.mjs

@@ -111,7 +111,7 @@ if (Symbol.dispose) Engine.prototype[Symbol.dispose] = Engine.prototype.free;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_fdd633d4bb5dd76a: function(arg0, arg1) {
+        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
@@ -122,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_edaed31a367ce1bd: function(arg0) {
+        __wbg___wbindgen_boolean_get_5b446f51afd21013: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_8a447059637473e2: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_4687d8d8c2017d52: 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_4990f46af709e33c: function(arg0, arg1) {
+        __wbg___wbindgen_in_92f62ee1427d9e49: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_function_acc5528be2b923f2: function(arg0) {
+        __wbg___wbindgen_is_function_1f9d30630b8b1d3d: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_object_0beba4a1980d3eea: function(arg0) {
+        __wbg___wbindgen_is_object_3c45d4f2dde4e749: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_1fca8072260dd261: function(arg0) {
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_721f8decd50c87a3: function(arg0) {
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_4b9aba9e5b3c4582: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_677f21e468d6b461: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_1cc01dd708740256: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_2e0e7dee9f701a71: 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_71bb4348194e31f0: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_0380ccaa2f57f0d9: 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);
@@ -173,22 +173,22 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_ea4887a5f8f9a9db: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_8e98ed2f3c86c4b5: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_6137034ef55c9d0f: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_b62d4a7d2286852a: function(arg0) {
+        __wbg_done_b41a1d26cdb37fb6: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_c261c3fa1f281256: function(arg0) {
+        __wbg_entries_fb6397112b1de25f: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
+        __wbg_error_757e9472f8410341: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -199,19 +199,19 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_getTime_7a770f8a2ec8d634: function(arg0) {
+        __wbg_getTime_f5a55efff2585d5d: function(arg0) {
             const ret = arg0.getTime();
             return ret;
         },
-        __wbg_get_197a3fe98f169e38: function(arg0, arg1) {
-            const ret = arg0[arg1 >>> 0];
-            return ret;
-        },
-        __wbg_get_9a29be2cb383ed9a: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_658f6698067d9515: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_unchecked_54a4374c38e08460: function(arg0, arg1) {
+        __wbg_get_6c896e0571ddae51: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_get_unchecked_288889d017702237: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -219,7 +219,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_2a7bb09fee70c2da: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_a99f175873e5d9b8: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -229,7 +229,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_f080092dc70f5d58: function(arg0) {
+        __wbg_instanceof_Uint8Array_828cef2aaacafc31: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -239,50 +239,50 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_145a34fd0a38d37b: function(arg0) {
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_iterator_cc47ba25a2be735a: function() {
+        __wbg_iterator_e3c31c892080e444: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_589238bdcf171f0e: function(arg0) {
+        __wbg_length_7f3c00c40364105e: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_c6054974c0a6cdb9: function(arg0) {
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_0_1b32bedde98fef4b: function() {
+        __wbg_new_0_72d020f0c63443d4: function() {
             const ret = new Date();
             return ret;
         },
+        __wbg_new_1dbf7428bba60a42: function(arg0) {
+            const ret = new Uint8Array(arg0);
+            return ret;
+        },
         __wbg_new_227d7c05414eb861: function() {
             const ret = new Error();
             return ret;
         },
-        __wbg_new_2e117a478906f062: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return ret;
         },
-        __wbg_new_36e147a8ced3c6e0: function() {
+        __wbg_new_ee2291f50781bf1d: function() {
             const ret = new Array();
             return ret;
         },
-        __wbg_new_81880fb5002cb255: function(arg0) {
-            const ret = new Uint8Array(arg0);
+        __wbg_next_33784799010f1bbe: function(arg0) {
+            const ret = arg0.next;
             return ret;
         },
-        __wbg_next_0c4066e251d2eff9: function() { return handleError(function (arg0) {
+        __wbg_next_f4aac29c42af995c: 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;
@@ -291,13 +291,13 @@ function __wbg_get_imports() {
             const ret = arg0.performance;
             return ret;
         },
-        __wbg_prototypesetcall_d721637c7ca66eb8: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_bc27214492979395: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
         __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
             arg0[arg1] = arg2;
         },
-        __wbg_set_dc601f4a69da0bc2: function(arg0, arg1, arg2) {
+        __wbg_set_bea140a88be9b277: function(arg0, arg1, arg2) {
             arg0[arg1 >>> 0] = arg2;
         },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
@@ -307,32 +307,32 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg_static_accessor_GLOBAL_THIS_2fee5048bcca5938: function() {
-            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+        __wbg_static_accessor_GLOBAL_266715b9d96ba635: function() {
+            const ret = typeof global === 'undefined' ? null : global;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_GLOBAL_ce44e66a4935da8c: function() {
-            const ret = typeof global === 'undefined' ? null : global;
+        __wbg_static_accessor_GLOBAL_THIS_10fb7dc1ae063179: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_SELF_44f6e0cb5e67cdad: function() {
+        __wbg_static_accessor_SELF_0b583911f537483a: function() {
             const ret = typeof self === 'undefined' ? null : self;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_WINDOW_168f178805d978fe: function() {
+        __wbg_static_accessor_WINDOW_d7f903d1508cbdc4: function() {
             const ret = typeof window === 'undefined' ? null : window;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_value_49f783bb59765962: function(arg0) {
+        __wbg_value_f3c585ee8f5ba40c: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
-        __wbindgen_cast_0000000000000001: function(arg0) {
+        __wbindgen_generic_0000000000000001: function(arg0) {
             // Cast intrinsic for `F64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000002: function(arg0, arg1) {
+        __wbindgen_generic_0000000000000002: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
@@ -549,11 +549,15 @@ function __wbg_finalize_init(instance, module) {
 
 async function __wbg_load(module, imports) {
     if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
         if (typeof WebAssembly.instantiateStreaming === 'function') {
             try {
                 return await WebAssembly.instantiateStreaming(module, imports);
             } catch (e) {
-                const validResponse = module.ok && expectedResponseType(module.type);
+                const validResponse = expectedResponseType(module.type);
 
                 if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
                     console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
@@ -608,6 +612,16 @@ async function __wbg_init(module_or_path) {
     return __wbg_finalize_init(instance);
 }
 
+/**
+ * Defines how the client fetches flag state updates from the Flipt server.
+ */
+var FetchMode;
+(function (FetchMode) {
+    /** Periodically poll the server for new flag state at the configured updateInterval. */
+    FetchMode["Polling"] = "polling";
+    /** Use Server-Sent Events to receive real-time flag state updates. */
+    FetchMode["Streaming"] = "streaming";
+})(FetchMode || (FetchMode = {}));
 /**
  * Defines the strategy to handle errors during the flags snapshot update calls.
  */
@@ -633,7 +647,8 @@ class ClientOptionsFactory {
             url: 'http://localhost:8080',
             reference: '',
             updateInterval: 120,
-            errorStrategy: ErrorStrategy.Fail
+            errorStrategy: ErrorStrategy.Fail,
+            fetchMode: FetchMode.Polling
         };
     }
 }
@@ -665,11 +680,67 @@ function serialize(data) {
     return result;
 }
 
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { }
+};
 class BaseFliptClient {
     constructor(engine, fetcher) {
+        this.logger = noopLogger;
         this.engine = engine;
         this.fetcher = fetcher;
     }
+    /**
+     * Close the client and clean up resources.
+     */
+    close() {
+        this.closeEventSource();
+    }
+    /**
+     * Wire up SSE handlers shared by the browser and Node clients.
+     * EventSource reconnects on its own after transient errors; on every
+     * (re)open we refresh so updates missed while disconnected are picked up.
+     */
+    attachStream(eventSource) {
+        eventSource.onopen = () => {
+            this.logger.debug('sse connected');
+            this.refreshFromStream();
+        };
+        eventSource.onmessage = (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                this.logger.debug('sse message:', data);
+                if (data.type === 'refetchEvaluation') {
+                    this.refreshFromStream();
+                }
+            }
+            catch {
+                this.logger.warn('sse parse error:', event.data);
+            }
+        };
+        eventSource.onerror = (err) => {
+            if (eventSource.readyState === 2 /* CLOSED */) {
+                this.logger.error('sse connection closed, no further updates:', err);
+            }
+            else {
+                this.logger.warn('sse error, reconnecting:', err);
+            }
+        };
+        this.eventSource = eventSource;
+    }
+    refreshFromStream() {
+        this.refresh().catch((err) => {
+            this.logger.warn('sse refresh failed:', err);
+        });
+    }
+    closeEventSource() {
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = undefined;
+        }
+    }
     /**
      * Store etag from response for next requests
      */
@@ -955,4 +1026,4 @@ class FliptClient extends BaseFliptClient {
     }
 }
 
-export { BaseFliptClient, ClientOptionsFactory, ErrorStrategy, FliptClient };
+export { BaseFliptClient, ClientOptionsFactory, ErrorStrategy, FetchMode, FliptClient };

package/dist/types/browser/index.d.ts

@@ -9,4 +9,5 @@ export declare class FliptClient extends BaseFliptClient {
      * @returns {Promise<FliptClient>}
      */
     static init(options?: ClientOptions): Promise<FliptClient>;
+    private setupStream;
 }

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

@@ -1,12 +1,34 @@
-import { BatchEvaluationResponse, BooleanEvaluationResponse, EvaluationRequest, Flag, IFetcher, VariantEvaluationResponse, ErrorStrategy, Response, Hook } from './types';
+import { BatchEvaluationResponse, BooleanEvaluationResponse, EvaluationRequest, Flag, IFetcher, VariantEvaluationResponse, ErrorStrategy, Response, Hook, Logger } from './types';
 export type FliptClient = BaseFliptClient;
+/** The subset of the EventSource API used by the client (browser and `eventsource` package). */
+export interface StreamSource {
+    readyState: number;
+    onopen: ((event: any) => void) | null;
+    onmessage: ((event: any) => void) | null;
+    onerror: ((event: any) => void) | null;
+    close(): void;
+}
 export declare abstract class BaseFliptClient {
     protected engine: any;
     protected fetcher: IFetcher;
     protected etag?: string;
     protected errorStrategy?: ErrorStrategy;
     protected hook?: Hook;
+    protected eventSource?: StreamSource;
+    protected logger: Logger;
     constructor(engine: any, fetcher: IFetcher);
+    /**
+     * Close the client and clean up resources.
+     */
+    close(): void;
+    /**
+     * Wire up SSE handlers shared by the browser and Node clients.
+     * EventSource reconnects on its own after transient errors; on every
+     * (re)open we refresh so updates missed while disconnected are picked up.
+     */
+    protected attachStream(eventSource: StreamSource): void;
+    private refreshFromStream;
+    protected closeEventSource(): void;
     /**
      * Store etag from response for next requests
      */

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

@@ -132,6 +132,16 @@ export interface ClientOptions {
      * The strategy to use for errors during refresh snapshot calls. {@link ErrorStrategy}
      */
     errorStrategy?: ErrorStrategy;
+    /**
+     * The fetch mode to use for receiving flag state updates. {@link FetchMode}
+     *
+     * @defaultValue `FetchMode.Polling`
+     */
+    fetchMode?: FetchMode;
+    /**
+     * Optional logger for debugging and diagnostics.
+     */
+    logger?: Logger;
     /**
      * The hook to use for before and after evaluation calls.
      */
@@ -259,6 +269,15 @@ export interface BatchEvaluationResponse {
     /** Duration of the request in milliseconds. */
     requestDurationMillis: number;
 }
+/**
+ * Defines how the client fetches flag state updates from the Flipt server.
+ */
+export declare enum FetchMode {
+    /** Periodically poll the server for new flag state at the configured updateInterval. */
+    Polling = "polling",
+    /** Use Server-Sent Events to receive real-time flag state updates. */
+    Streaming = "streaming"
+}
 /**
  * Defines the strategy to handle errors during the flags snapshot update calls.
  */
@@ -299,3 +318,12 @@ export interface Hook {
         segmentKeys: string[];
     }): void;
 }
+/**
+ * Logger interface for client diagnostics.
+ */
+export interface Logger {
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+}

package/dist/types/index.d.ts

@@ -6,5 +6,5 @@ import { FliptClient as NodeImpl } from './node';
 import { FliptClient as BrowserImpl } from './browser';
 export { NodeImpl as NodeFliptClient };
 export { BrowserImpl as BrowserFliptClient };
-export declare const FliptClient: typeof BrowserImpl;
+export declare const FliptClient: typeof NodeImpl | typeof BrowserImpl;
 export type FliptClient = InstanceType<typeof FliptClient>;

package/dist/types/node/index.d.ts

@@ -11,6 +11,7 @@ export declare class FliptClient extends BaseFliptClient {
      * @returns {Promise<FliptClient>}
      */
     static init(options?: ClientOptions): Promise<FliptClient>;
+    private setupStream;
     private setupAutoRefresh;
     private cleanupAutoRefresh;
     close(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipt-io/flipt-client-js",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Flipt Client Evaluation SDK for Web and Node.js",
   "type": "module",
   "main": "./dist/node/index.cjs",
@@ -83,6 +83,7 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
+    "eventsource": "^4.1.0",
     "node-fetch": "^3.3.0"
   },
   "devDependencies": {
@@ -91,7 +92,7 @@
     "@rollup/plugin-typescript": "^12.1.0",
     "@rollup/plugin-wasm": "^6.2.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.2",
+    "@types/node": "^26.0.0",
     "@types/node-fetch": "^2.6.11",
     "@typescript-eslint/eslint-plugin": "^8.33.1",
     "@typescript-eslint/parser": "^8.33.1",
@@ -108,7 +109,7 @@
     "undici": "^8.0.2"
   },
   "engines": {
-    "node": ">=14"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"