@flipt-io/flipt-client-js 0.5.1 → 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_408e67f47ca7b58b: 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_c9c83ebd41b34df3: 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_a57024b9c6e4a48b: 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_ac983077f137f2e6: function(arg0, arg1) {
+        __wbg___wbindgen_in_92f62ee1427d9e49: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_function_5e4570eb24ffa122: function(arg0) {
+        __wbg___wbindgen_is_function_1f9d30630b8b1d3d: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_object_a2790eb24c211ea0: 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_e6f02f0ea5f20a32: function(arg0) {
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_6cff064c44e0d823: function(arg0) {
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_acf2776254a8d832: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_677f21e468d6b461: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_136b9679cab35cfb: 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_d154f1e671052120: 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,18 +173,18 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_1c5886ab9c57d1c7: 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_669171204c3dcae2: function(arg0) {
+        __wbg_done_b41a1d26cdb37fb6: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_7774d489e1da5f4f: function(arg0) {
+        __wbg_entries_fb6397112b1de25f: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
@@ -199,19 +199,19 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_getTime_63fb0332e6c4ec17: function(arg0) {
+        __wbg_getTime_f5a55efff2585d5d: function(arg0) {
             const ret = arg0.getTime();
             return ret;
         },
-        __wbg_get_c0c8f8d7da0c03dd: function(arg0, arg1) {
-            const ret = arg0[arg1 >>> 0];
-            return ret;
-        },
-        __wbg_get_d173c0308df22d37: 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_e20b893aeafc3fca: 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_993d02d2d254cad1: 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_f935dbb0aa7cdeed: 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_6339f732981044bf: function(arg0) {
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_iterator_5cebbb86e33c6dd6: function() {
+        __wbg_iterator_e3c31c892080e444: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_36bd29c6848c2144: function(arg0) {
+        __wbg_length_7f3c00c40364105e: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_ecfa2c63d3d0d82c: function(arg0) {
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_0_f117d868b403dc07: function() {
+        __wbg_new_0_72d020f0c63443d4: function() {
             const ret = new Date();
             return ret;
         },
-        __wbg_new_116be93542d39019: function() {
-            const ret = new Array();
+        __wbg_new_1dbf7428bba60a42: function(arg0) {
+            const ret = new Uint8Array(arg0);
             return ret;
         },
         __wbg_new_227d7c05414eb861: function() {
             const ret = new Error();
             return ret;
         },
-        __wbg_new_77cc4f4f472aeb81: function(arg0) {
-            const ret = new Uint8Array(arg0);
-            return ret;
-        },
-        __wbg_new_ebe3e0f6837f0879: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return ret;
         },
-        __wbg_next_42cf16ee0dafc9e2: function() { return handleError(function (arg0) {
-            const ret = arg0.next();
+        __wbg_new_ee2291f50781bf1d: function() {
+            const ret = new Array();
             return ret;
-        }, arguments); },
-        __wbg_next_8f26b64fa5e9f64b: function(arg0) {
+        },
+        __wbg_next_33784799010f1bbe: function(arg0) {
             const ret = arg0.next;
             return ret;
         },
+        __wbg_next_f4aac29c42af995c: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
+            return ret;
+        }, arguments); },
         __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_de8e0d9553586985: 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_a80955eb93b145c6: 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_466428f93b4eaa76: 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_c7aea38d4de089bc: 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_42d4fae05e59267a: function() {
+        __wbg_static_accessor_SELF_0b583911f537483a: function() {
             const ret = typeof self === 'undefined' ? null : self;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_static_accessor_WINDOW_e0db14a0eba6a812: function() {
+        __wbg_static_accessor_WINDOW_d7f903d1508cbdc4: function() {
             const ret = typeof window === 'undefined' ? null : window;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_value_1e2369fab29b420e: 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;
@@ -612,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.
  */
@@ -637,7 +647,8 @@ class ClientOptionsFactory {
             url: 'http://localhost:8080',
             reference: '',
             updateInterval: 120,
-            errorStrategy: ErrorStrategy.Fail
+            errorStrategy: ErrorStrategy.Fail,
+            fetchMode: FetchMode.Polling
         };
     }
 }
@@ -669,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
      */
@@ -959,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.1",
+  "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": {
@@ -108,7 +109,7 @@
     "undici": "^8.0.2"
   },
   "engines": {
-    "node": ">=14"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"