@flipt-io/flipt-client-js
Version:
Flipt Client Evaluation SDK for Web and Node.js
916 lines (858 loc) • 31.4 kB
JavaScript
;
var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
let wasm;
let cachedUint8ArrayMemory0 = null;
function getUint8ArrayMemory0() {
if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
}
return cachedUint8ArrayMemory0;
}
let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
cachedTextDecoder.decode();
const MAX_SAFARI_DECODE_BYTES = 2146435072;
let numBytesDecoded = 0;
function decodeText(ptr, len) {
numBytesDecoded += len;
if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
cachedTextDecoder.decode();
numBytesDecoded = len;
}
return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
}
function getStringFromWasm0(ptr, len) {
ptr = ptr >>> 0;
return decodeText(ptr, len);
}
let WASM_VECTOR_LEN = 0;
const cachedTextEncoder = new TextEncoder();
if (!('encodeInto' in cachedTextEncoder)) {
cachedTextEncoder.encodeInto = function (arg, view) {
const buf = cachedTextEncoder.encode(arg);
view.set(buf);
return {
read: arg.length,
written: buf.length
};
};
}
function passStringToWasm0(arg, malloc, realloc) {
if (realloc === undefined) {
const buf = cachedTextEncoder.encode(arg);
const ptr = malloc(buf.length, 1) >>> 0;
getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
WASM_VECTOR_LEN = buf.length;
return ptr;
}
let len = arg.length;
let ptr = malloc(len, 1) >>> 0;
const mem = getUint8ArrayMemory0();
let offset = 0;
for (; offset < len; offset++) {
const code = arg.charCodeAt(offset);
if (code > 0x7F) break;
mem[ptr + offset] = code;
}
if (offset !== len) {
if (offset !== 0) {
arg = arg.slice(offset);
}
ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
const ret = cachedTextEncoder.encodeInto(arg, view);
offset += ret.written;
ptr = realloc(ptr, len, offset, 1) >>> 0;
}
WASM_VECTOR_LEN = offset;
return ptr;
}
let cachedDataViewMemory0 = null;
function getDataViewMemory0() {
if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
}
return cachedDataViewMemory0;
}
function isLikeNone(x) {
return x === undefined || x === null;
}
function debugString(val) {
// primitive types
const type = typeof val;
if (type == 'number' || type == 'boolean' || val == null) {
return `${val}`;
}
if (type == 'string') {
return `"${val}"`;
}
if (type == 'symbol') {
const description = val.description;
if (description == null) {
return 'Symbol';
} else {
return `Symbol(${description})`;
}
}
if (type == 'function') {
const name = val.name;
if (typeof name == 'string' && name.length > 0) {
return `Function(${name})`;
} else {
return 'Function';
}
}
// objects
if (Array.isArray(val)) {
const length = val.length;
let debug = '[';
if (length > 0) {
debug += debugString(val[0]);
}
for(let i = 1; i < length; i++) {
debug += ', ' + debugString(val[i]);
}
debug += ']';
return debug;
}
// Test for built-in
const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
let className;
if (builtInMatches && builtInMatches.length > 1) {
className = builtInMatches[1];
} else {
// Failed to match the standard '[object ClassName]'
return toString.call(val);
}
if (className == 'Object') {
// we're a user defined class or Object
// JSON.stringify avoids problems with cycles, and is generally much
// easier than looping through ownProperties of `val`.
try {
return 'Object(' + JSON.stringify(val) + ')';
} catch (_) {
return 'Object';
}
}
// errors
if (val instanceof Error) {
return `${val.name}: ${val.message}\n${val.stack}`;
}
// TODO we could test for more things here, like `Set`s and `Map`s.
return className;
}
function addToExternrefTable0(obj) {
const idx = wasm.__externref_table_alloc();
wasm.__wbindgen_externrefs.set(idx, obj);
return idx;
}
function handleError(f, args) {
try {
return f.apply(this, args);
} catch (e) {
const idx = addToExternrefTable0(e);
wasm.__wbindgen_exn_store(idx);
}
}
function getArrayU8FromWasm0(ptr, len) {
ptr = ptr >>> 0;
return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
}
function takeFromExternrefTable0(idx) {
const value = wasm.__wbindgen_externrefs.get(idx);
wasm.__externref_table_dealloc(idx);
return value;
}
const EngineFinalization = (typeof FinalizationRegistry === 'undefined')
? { register: () => {}, unregister: () => {} }
: new FinalizationRegistry(ptr => wasm.__wbg_engine_free(ptr >>> 0, 1));
class Engine {
__destroy_into_raw() {
const ptr = this.__wbg_ptr;
this.__wbg_ptr = 0;
EngineFinalization.unregister(this);
return ptr;
}
free() {
const ptr = this.__destroy_into_raw();
wasm.__wbg_engine_free(ptr, 0);
}
/**
* @param {string} namespace
*/
constructor(namespace) {
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;
EngineFinalization.register(this, this.__wbg_ptr, this);
return this;
}
/**
* @param {any} data
*/
snapshot(data) {
const ret = wasm.engine_snapshot(this.__wbg_ptr, data);
if (ret[1]) {
throw takeFromExternrefTable0(ret[0]);
}
}
/**
* @param {any} request
* @returns {any}
*/
evaluate_boolean(request) {
const ret = wasm.engine_evaluate_boolean(this.__wbg_ptr, request);
if (ret[2]) {
throw takeFromExternrefTable0(ret[1]);
}
return takeFromExternrefTable0(ret[0]);
}
/**
* @param {any} request
* @returns {any}
*/
evaluate_variant(request) {
const ret = wasm.engine_evaluate_variant(this.__wbg_ptr, request);
if (ret[2]) {
throw takeFromExternrefTable0(ret[1]);
}
return takeFromExternrefTable0(ret[0]);
}
/**
* @param {any} request
* @returns {any}
*/
evaluate_batch(request) {
const ret = wasm.engine_evaluate_batch(this.__wbg_ptr, request);
if (ret[2]) {
throw takeFromExternrefTable0(ret[1]);
}
return takeFromExternrefTable0(ret[0]);
}
/**
* @returns {any}
*/
list_flags() {
const ret = wasm.engine_list_flags(this.__wbg_ptr);
if (ret[2]) {
throw takeFromExternrefTable0(ret[1]);
}
return takeFromExternrefTable0(ret[0]);
}
}
if (Symbol.dispose) Engine.prototype[Symbol.dispose] = Engine.prototype.free;
const EXPECTED_RESPONSE_TYPES = new Set(['basic', 'cors', 'default']);
async function __wbg_load(module, imports) {
if (typeof Response === 'function' && module instanceof Response) {
if (typeof WebAssembly.instantiateStreaming === 'function') {
try {
return await WebAssembly.instantiateStreaming(module, imports);
} catch (e) {
const validResponse = module.ok && EXPECTED_RESPONSE_TYPES.has(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);
} else {
throw e;
}
}
}
const bytes = await module.arrayBuffer();
return await WebAssembly.instantiate(bytes, imports);
} else {
const instance = await WebAssembly.instantiate(module, imports);
if (instance instanceof WebAssembly.Instance) {
return { instance, module };
} else {
return instance;
}
}
}
function __wbg_get_imports() {
const imports = {};
imports.wbg = {};
imports.wbg.__wbg_Error_e83987f665cf5504 = function(arg0, arg1) {
const ret = Error(getStringFromWasm0(arg0, arg1));
return ret;
};
imports.wbg.__wbg_String_8f0eb39a4a4c2f66 = function(arg0, arg1) {
const ret = String(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);
};
imports.wbg.__wbg___wbindgen_boolean_get_6d5a1ee65bab5f68 = function(arg0) {
const v = arg0;
const ret = typeof(v) === 'boolean' ? v : undefined;
return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
};
imports.wbg.__wbg___wbindgen_debug_string_df47ffb5e35e6763 = 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);
};
imports.wbg.__wbg___wbindgen_in_bb933bd9e1b3bc0f = function(arg0, arg1) {
const ret = arg0 in arg1;
return ret;
};
imports.wbg.__wbg___wbindgen_is_function_ee8a6c5833c90377 = function(arg0) {
const ret = typeof(arg0) === 'function';
return ret;
};
imports.wbg.__wbg___wbindgen_is_object_c818261d21f283a4 = function(arg0) {
const val = arg0;
const ret = typeof(val) === 'object' && val !== null;
return ret;
};
imports.wbg.__wbg___wbindgen_is_string_fbb76cb2940daafd = function(arg0) {
const ret = typeof(arg0) === 'string';
return ret;
};
imports.wbg.__wbg___wbindgen_is_undefined_2d472862bd29a478 = function(arg0) {
const ret = arg0 === undefined;
return ret;
};
imports.wbg.__wbg___wbindgen_jsval_loose_eq_b664b38a2f582147 = function(arg0, arg1) {
const ret = arg0 == arg1;
return ret;
};
imports.wbg.__wbg___wbindgen_number_get_a20bf9b85341449d = 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);
};
imports.wbg.__wbg___wbindgen_string_get_e4f06c90489ad01b = 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);
var len1 = WASM_VECTOR_LEN;
getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
};
imports.wbg.__wbg___wbindgen_throw_b855445ff6a94295 = function(arg0, arg1) {
throw new Error(getStringFromWasm0(arg0, arg1));
};
imports.wbg.__wbg_call_e762c39fa8ea36bf = function() { return handleError(function (arg0, arg1) {
const ret = arg0.call(arg1);
return ret;
}, arguments) };
imports.wbg.__wbg_done_2042aa2670fb1db1 = function(arg0) {
const ret = arg0.done;
return ret;
};
imports.wbg.__wbg_entries_e171b586f8f6bdbf = function(arg0) {
const ret = Object.entries(arg0);
return ret;
};
imports.wbg.__wbg_error_7534b8e9a36f1ab4 = function(arg0, arg1) {
let deferred0_0;
let deferred0_1;
try {
deferred0_0 = arg0;
deferred0_1 = arg1;
console.error(getStringFromWasm0(arg0, arg1));
} finally {
wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
}
};
imports.wbg.__wbg_getTime_14776bfb48a1bff9 = function(arg0) {
const ret = arg0.getTime();
return ret;
};
imports.wbg.__wbg_get_7bed016f185add81 = function(arg0, arg1) {
const ret = arg0[arg1 >>> 0];
return ret;
};
imports.wbg.__wbg_get_efcb449f58ec27c2 = function() { return handleError(function (arg0, arg1) {
const ret = Reflect.get(arg0, arg1);
return ret;
}, arguments) };
imports.wbg.__wbg_get_with_ref_key_1dc361bd10053bfe = function(arg0, arg1) {
const ret = arg0[arg1];
return ret;
};
imports.wbg.__wbg_instanceof_ArrayBuffer_70beb1189ca63b38 = function(arg0) {
let result;
try {
result = arg0 instanceof ArrayBuffer;
} catch (_) {
result = false;
}
const ret = result;
return ret;
};
imports.wbg.__wbg_instanceof_Uint8Array_20c8e73002f7af98 = function(arg0) {
let result;
try {
result = arg0 instanceof Uint8Array;
} catch (_) {
result = false;
}
const ret = result;
return ret;
};
imports.wbg.__wbg_isArray_96e0af9891d0945d = function(arg0) {
const ret = Array.isArray(arg0);
return ret;
};
imports.wbg.__wbg_iterator_e5822695327a3c39 = function() {
const ret = Symbol.iterator;
return ret;
};
imports.wbg.__wbg_length_69bca3cb64fc8748 = function(arg0) {
const ret = arg0.length;
return ret;
};
imports.wbg.__wbg_length_cdd215e10d9dd507 = function(arg0) {
const ret = arg0.length;
return ret;
};
imports.wbg.__wbg_new_0_f9740686d739025c = function() {
const ret = new Date();
return ret;
};
imports.wbg.__wbg_new_1acc0b6eea89d040 = function() {
const ret = new Object();
return ret;
};
imports.wbg.__wbg_new_5a79be3ab53b8aa5 = function(arg0) {
const ret = new Uint8Array(arg0);
return ret;
};
imports.wbg.__wbg_new_8a6f238a6ece86ea = function() {
const ret = new Error();
return ret;
};
imports.wbg.__wbg_new_e17d9f43105b08be = function() {
const ret = new Array();
return ret;
};
imports.wbg.__wbg_new_no_args_ee98eee5275000a4 = function(arg0, arg1) {
const ret = new Function(getStringFromWasm0(arg0, arg1));
return ret;
};
imports.wbg.__wbg_next_020810e0ae8ebcb0 = function() { return handleError(function (arg0) {
const ret = arg0.next();
return ret;
}, arguments) };
imports.wbg.__wbg_next_2c826fe5dfec6b6a = function(arg0) {
const ret = arg0.next;
return ret;
};
imports.wbg.__wbg_now_2c95c9de01293173 = function(arg0) {
const ret = arg0.now();
return ret;
};
imports.wbg.__wbg_performance_7a3ffd0b17f663ad = function(arg0) {
const ret = arg0.performance;
return ret;
};
imports.wbg.__wbg_prototypesetcall_2a6620b6922694b2 = function(arg0, arg1, arg2) {
Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
};
imports.wbg.__wbg_set_3f1d0b984ed272ed = function(arg0, arg1, arg2) {
arg0[arg1] = arg2;
};
imports.wbg.__wbg_set_c213c871859d6500 = function(arg0, arg1, arg2) {
arg0[arg1 >>> 0] = arg2;
};
imports.wbg.__wbg_stack_0ed75d68575b0f3c = function(arg0, arg1) {
const ret = arg1.stack;
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);
};
imports.wbg.__wbg_static_accessor_GLOBAL_89e1d9ac6a1b250e = function() {
const ret = typeof global === 'undefined' ? null : global;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_GLOBAL_THIS_8b530f326a9e48ac = function() {
const ret = typeof globalThis === 'undefined' ? null : globalThis;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_SELF_6fdf4b64710cc91b = function() {
const ret = typeof self === 'undefined' ? null : self;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_WINDOW_b45bfc5a37f6cfa2 = function() {
const ret = typeof window === 'undefined' ? null : window;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_value_692627309814bb8c = function(arg0) {
const ret = arg0.value;
return ret;
};
imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
// Cast intrinsic for `Ref(String) -> Externref`.
const ret = getStringFromWasm0(arg0, arg1);
return ret;
};
imports.wbg.__wbindgen_cast_d6cd19b81560fd6e = function(arg0) {
// Cast intrinsic for `F64 -> Externref`.
const ret = arg0;
return ret;
};
imports.wbg.__wbindgen_init_externref_table = function() {
const table = wasm.__wbindgen_externrefs;
const offset = table.grow(4);
table.set(0, undefined);
table.set(offset + 0, undefined);
table.set(offset + 1, null);
table.set(offset + 2, true);
table.set(offset + 3, false);
};
return imports;
}
function __wbg_finalize_init(instance, module) {
wasm = instance.exports;
__wbg_init.__wbindgen_wasm_module = module;
cachedDataViewMemory0 = null;
cachedUint8ArrayMemory0 = null;
wasm.__wbindgen_start();
return wasm;
}
async function __wbg_init(module_or_path) {
if (wasm !== undefined) return wasm;
if (typeof module_or_path !== 'undefined') {
if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
({module_or_path} = module_or_path);
} else {
console.warn('using deprecated parameters for the initialization function; pass a single object instead');
}
}
if (typeof module_or_path === 'undefined') {
module_or_path = new URL('flipt_engine_wasm_js_bg.wasm', (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
}
const imports = __wbg_get_imports();
if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
module_or_path = fetch(module_or_path);
}
const { instance, module } = await __wbg_load(await module_or_path, imports);
return __wbg_finalize_init(instance, module);
}
/**
* Defines the strategy to handle errors during the flags snapshot update calls.
*/
exports.ErrorStrategy = void 0;
(function (ErrorStrategy) {
/** The client will throw an error if the flag state cannot be fetched. This is the default behavior. */
ErrorStrategy["Fail"] = "fail";
/** The client will maintain the last known good state and use that state for evaluation in case of an error. */
ErrorStrategy["Fallback"] = "fallback";
})(exports.ErrorStrategy || (exports.ErrorStrategy = {}));
/**
* Factory class for creating default client options.
*/
class ClientOptionsFactory {
/**
* Creates a default client options object.
* @returns {ClientOptions} A default client options object.
*/
static default() {
return {
environment: 'default',
namespace: 'default',
url: 'http://localhost:8080',
reference: '',
updateInterval: 120,
errorStrategy: exports.ErrorStrategy.Fail
};
}
}
function snakeToCamel(str) {
return str.replace(/([-_][a-z])/g, (group) => group.toUpperCase().replace('-', '').replace('_', ''));
}
function camelToSnake(str) {
return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
}
function deserialize(data) {
const result = {};
for (const key in data) {
if (Object.prototype.hasOwnProperty.call(data, key)) {
const camelKey = snakeToCamel(key);
result[camelKey] = data[key];
}
}
return result;
}
function serialize(data) {
const result = {};
for (const key in data) {
if (Object.prototype.hasOwnProperty.call(data, key)) {
const snakeKey = camelToSnake(key);
result[snakeKey] = data[key];
}
}
return result;
}
class BaseFliptClient {
constructor(engine, fetcher) {
this.engine = engine;
this.fetcher = fetcher;
}
/**
* Store etag from response for next requests
*/
storeEtag(resp) {
const etag = resp.headers.get('etag');
if (etag) {
this.etag = etag;
}
}
/**
* Refresh the flags snapshot
* @returns true if snapshot changed
*/
async refresh() {
try {
const opts = { etag: this.etag };
const resp = await this.fetcher(opts);
const etag = resp.headers.get('etag');
if (this.etag && this.etag === etag) {
return false;
}
this.storeEtag(resp);
const data = await resp.json();
this.engine.snapshot(data);
return true;
}
catch (error) {
if (this.errorStrategy === exports.ErrorStrategy.Fail) {
throw error;
}
}
return false;
}
/**
* Evaluate a variant flag
*/
evaluateVariant({ flagKey, entityId, context }) {
if (!flagKey || flagKey.trim() === '') {
throw new Error('flagKey cannot be empty');
}
if (!entityId || entityId.trim() === '') {
throw new Error('entityId cannot be empty');
}
const evaluationRequest = {
flagKey,
entityId,
context
};
this.hook?.before({ flagKey });
const variantResult = this.engine.evaluate_variant(serialize(evaluationRequest));
if (variantResult === null) {
throw new Error('Failed to evaluate variant');
}
if (variantResult.status === 'failure') {
throw new Error(variantResult.errorMessage);
}
if (!variantResult.result) {
throw new Error('Failed to evaluate variant');
}
const result = deserialize(variantResult.result);
this.hook?.after({
flagKey,
flagType: 'variant',
value: result.variantKey,
reason: result.reason,
segmentKeys: result.segmentKeys
});
return result;
}
/**
* Evaluate a boolean flag
*/
evaluateBoolean({ flagKey, entityId, context }) {
if (!flagKey || flagKey.trim() === '') {
throw new Error('flagKey cannot be empty');
}
if (!entityId || entityId.trim() === '') {
throw new Error('entityId cannot be empty');
}
const evaluationRequest = {
flagKey,
entityId,
context
};
this.hook?.before({ flagKey });
const booleanResult = this.engine.evaluate_boolean(serialize(evaluationRequest));
if (booleanResult === null) {
throw new Error('Failed to evaluate boolean');
}
if (booleanResult.status === 'failure') {
throw new Error(booleanResult.errorMessage);
}
if (!booleanResult.result) {
throw new Error('Failed to evaluate boolean');
}
const result = deserialize(booleanResult.result);
this.hook?.after({
flagKey,
flagType: 'boolean',
value: result.enabled.toString(),
reason: result.reason,
segmentKeys: result.segmentKeys
});
return result;
}
/**
* Evaluate a batch of flag requests
*/
evaluateBatch(requests) {
if (this.hook) {
requests.forEach((req) => this.hook?.before({ flagKey: req.flagKey }));
}
const serializedRequests = requests.map(serialize);
const batchResult = this.engine.evaluate_batch(serializedRequests);
if (batchResult === null) {
throw new Error('Failed to evaluate batch');
}
if (batchResult.status === 'failure') {
throw new Error(batchResult.errorMessage);
}
if (!batchResult.result) {
throw new Error('Failed to evaluate batch');
}
const responses = batchResult.result.responses
.map((response) => {
if (response.type === 'BOOLEAN_EVALUATION_RESPONSE_TYPE') {
const booleanResponse = deserialize(
// @ts-ignore
response.boolean_evaluation_response);
this.hook?.after({
flagKey: booleanResponse.flagKey,
flagType: 'boolean',
value: booleanResponse.enabled.toString(),
reason: booleanResponse.reason,
segmentKeys: booleanResponse.segmentKeys
});
return {
booleanEvaluationResponse: booleanResponse,
type: 'BOOLEAN_EVALUATION_RESPONSE_TYPE'
};
}
if (response.type === 'VARIANT_EVALUATION_RESPONSE_TYPE') {
const variantResponse = deserialize(
// @ts-ignore
response.variant_evaluation_response);
this.hook?.after({
flagKey: variantResponse.flagKey,
flagType: 'variant',
value: variantResponse.variantKey,
reason: variantResponse.reason,
segmentKeys: variantResponse.segmentKeys
});
return {
variantEvaluationResponse: variantResponse,
type: 'VARIANT_EVALUATION_RESPONSE_TYPE'
};
}
if (response.type === 'ERROR_EVALUATION_RESPONSE_TYPE') {
const errorResponse = deserialize(
// @ts-ignore
response.error_evaluation_response);
return {
errorEvaluationResponse: errorResponse,
type: 'ERROR_EVALUATION_RESPONSE_TYPE'
};
}
return undefined;
})
.filter((response) => response !== undefined);
return {
responses,
requestDurationMillis: batchResult.result.requestDurationMillis
};
}
listFlags() {
const listFlagsResult = this.engine.list_flags();
if (listFlagsResult === null) {
throw new Error('Failed to list flags');
}
if (listFlagsResult.status === 'failure') {
throw new Error(listFlagsResult.errorMessage);
}
if (!listFlagsResult.result) {
throw new Error('Failed to list flags');
}
return listFlagsResult.result.map((deserialize));
}
}
class FliptClient extends BaseFliptClient {
/**
* Initialize the client
* @param options - optional client options
* @param wasmOptions - options for loading WASM
* @returns {Promise<FliptClient>}
*/
static async init(options = ClientOptionsFactory.default(), wasmOptions) {
if (!wasmOptions || !wasmOptions.wasm) {
throw new Error('WASM module must be provided in slim mode. Use the standard client or provide a wasm module.');
}
const environment = options.environment ?? 'default';
const namespace = options.namespace ?? 'default';
let url = options.url ?? 'http://localhost:8080';
url = url.replace(/\/$/, '');
url = `${url}/internal/v1/evaluation/snapshot/namespace/${namespace}`;
if (options.reference) {
url = `${url}?reference=${options.reference}`;
}
const headers = {
Accept: 'application/json',
'x-flipt-accept-server-version': '1.47.0',
'x-flipt-environment': environment
};
if (options.authentication) {
if ('clientToken' in options.authentication) {
headers['Authorization'] =
`Bearer ${options.authentication.clientToken}`;
}
else if ('jwtToken' in options.authentication) {
headers['Authorization'] = `JWT ${options.authentication.jwtToken}`;
}
}
let fetcher = options.fetcher;
if (!fetcher) {
fetcher = async (opts) => {
if (opts && opts.etag) {
headers['If-None-Match'] = opts.etag;
}
const resp = await fetch(url, {
method: 'GET',
headers
});
if (!resp.ok && resp.status !== 304) {
throw new Error(`Failed to fetch data: ${resp.statusText}`);
}
return resp;
};
}
// Initialize WASM engine with the provided WASM module
await __wbg_init(wasmOptions.wasm);
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);
client.errorStrategy = options.errorStrategy;
client.hook = options.hook;
return client;
}
}
exports.BaseFliptClient = BaseFliptClient;
exports.ClientOptionsFactory = ClientOptionsFactory;
exports.FliptClient = FliptClient;