@flipt-io/flipt-client-js
Version:
Flipt Client Evaluation SDK for Web and Node.js
863 lines (811 loc) • 28.9 kB
JavaScript
let wasm;
let WASM_VECTOR_LEN = 0;
let cachedUint8ArrayMemory0 = null;
function getUint8ArrayMemory0() {
if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
}
return cachedUint8ArrayMemory0;
}
const cachedTextEncoder = (typeof TextEncoder !== 'undefined' ? new TextEncoder('utf-8') : { encode: () => { throw Error('TextEncoder not available') } } );
const encodeString = (typeof cachedTextEncoder.encodeInto === 'function'
? function (arg, view) {
return cachedTextEncoder.encodeInto(arg, view);
}
: 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 = encodeString(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 addToExternrefTable0(obj) {
const idx = wasm.__externref_table_alloc();
wasm.__wbindgen_export_4.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);
}
}
const cachedTextDecoder = (typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8', { ignoreBOM: true, fatal: true }) : { decode: () => { throw Error('TextDecoder not available') } } );
if (typeof TextDecoder !== 'undefined') { cachedTextDecoder.decode(); }
function getStringFromWasm0(ptr, len) {
ptr = ptr >>> 0;
return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
}
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 takeFromExternrefTable0(idx) {
const value = wasm.__wbindgen_export_4.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]);
}
}
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) {
if (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_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_buffer_609cc3eee51ed158 = function(arg0) {
const ret = arg0.buffer;
return ret;
};
imports.wbg.__wbg_call_672a4d21634d4a24 = function() { return handleError(function (arg0, arg1) {
const ret = arg0.call(arg1);
return ret;
}, arguments) };
imports.wbg.__wbg_done_769e5ede4b31c67b = function(arg0) {
const ret = arg0.done;
return ret;
};
imports.wbg.__wbg_entries_3265d4158b33e5dc = 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_46267b1c24877e30 = function(arg0) {
const ret = arg0.getTime();
return ret;
};
imports.wbg.__wbg_get_67b2ba62fc30de12 = function() { return handleError(function (arg0, arg1) {
const ret = Reflect.get(arg0, arg1);
return ret;
}, arguments) };
imports.wbg.__wbg_get_b9b93047fe3cf45b = function(arg0, arg1) {
const ret = arg0[arg1 >>> 0];
return ret;
};
imports.wbg.__wbg_getwithrefkey_1dc361bd10053bfe = function(arg0, arg1) {
const ret = arg0[arg1];
return ret;
};
imports.wbg.__wbg_instanceof_ArrayBuffer_e14585432e3737fc = function(arg0) {
let result;
try {
result = arg0 instanceof ArrayBuffer;
} catch (_) {
result = false;
}
const ret = result;
return ret;
};
imports.wbg.__wbg_instanceof_Uint8Array_17156bcf118086a9 = function(arg0) {
let result;
try {
result = arg0 instanceof Uint8Array;
} catch (_) {
result = false;
}
const ret = result;
return ret;
};
imports.wbg.__wbg_isArray_a1eab7e0d067391b = function(arg0) {
const ret = Array.isArray(arg0);
return ret;
};
imports.wbg.__wbg_iterator_9a24c88df860dc65 = function() {
const ret = Symbol.iterator;
return ret;
};
imports.wbg.__wbg_length_a446193dc22c12f8 = function(arg0) {
const ret = arg0.length;
return ret;
};
imports.wbg.__wbg_length_e2d2a49132c1b256 = function(arg0) {
const ret = arg0.length;
return ret;
};
imports.wbg.__wbg_new0_f788a2397c7ca929 = function() {
const ret = new Date();
return ret;
};
imports.wbg.__wbg_new_405e22f390576ce2 = function() {
const ret = new Object();
return ret;
};
imports.wbg.__wbg_new_78feb108b6472713 = function() {
const ret = new Array();
return ret;
};
imports.wbg.__wbg_new_8a6f238a6ece86ea = function() {
const ret = new Error();
return ret;
};
imports.wbg.__wbg_new_a12002a7f91c75be = function(arg0) {
const ret = new Uint8Array(arg0);
return ret;
};
imports.wbg.__wbg_newnoargs_105ed471475aaf50 = function(arg0, arg1) {
const ret = new Function(getStringFromWasm0(arg0, arg1));
return ret;
};
imports.wbg.__wbg_next_25feadfc0913fea9 = function(arg0) {
const ret = arg0.next;
return ret;
};
imports.wbg.__wbg_next_6574e1a8a62d1055 = function() { return handleError(function (arg0) {
const ret = arg0.next();
return ret;
}, arguments) };
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_set_37837023f3d740e8 = function(arg0, arg1, arg2) {
arg0[arg1 >>> 0] = arg2;
};
imports.wbg.__wbg_set_3f1d0b984ed272ed = function(arg0, arg1, arg2) {
arg0[arg1] = arg2;
};
imports.wbg.__wbg_set_65595bdd868b3009 = function(arg0, arg1, arg2) {
arg0.set(arg1, arg2 >>> 0);
};
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_88a902d13a557d07 = function() {
const ret = typeof global === 'undefined' ? null : global;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_GLOBAL_THIS_56578be7e9f832b0 = function() {
const ret = typeof globalThis === 'undefined' ? null : globalThis;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_SELF_37c5d418e4bf5819 = function() {
const ret = typeof self === 'undefined' ? null : self;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_static_accessor_WINDOW_5de37043a91a9c40 = function() {
const ret = typeof window === 'undefined' ? null : window;
return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
};
imports.wbg.__wbg_value_cd1ffa7b1ab794f1 = function(arg0) {
const ret = arg0.value;
return ret;
};
imports.wbg.__wbindgen_boolean_get = function(arg0) {
const v = arg0;
const ret = typeof(v) === 'boolean' ? (v ? 1 : 0) : 2;
return ret;
};
imports.wbg.__wbindgen_debug_string = 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.__wbindgen_error_new = function(arg0, arg1) {
const ret = new Error(getStringFromWasm0(arg0, arg1));
return ret;
};
imports.wbg.__wbindgen_in = function(arg0, arg1) {
const ret = arg0 in arg1;
return ret;
};
imports.wbg.__wbindgen_init_externref_table = function() {
const table = wasm.__wbindgen_export_4;
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);
};
imports.wbg.__wbindgen_is_function = function(arg0) {
const ret = typeof(arg0) === 'function';
return ret;
};
imports.wbg.__wbindgen_is_object = function(arg0) {
const val = arg0;
const ret = typeof(val) === 'object' && val !== null;
return ret;
};
imports.wbg.__wbindgen_is_string = function(arg0) {
const ret = typeof(arg0) === 'string';
return ret;
};
imports.wbg.__wbindgen_is_undefined = function(arg0) {
const ret = arg0 === undefined;
return ret;
};
imports.wbg.__wbindgen_jsval_loose_eq = function(arg0, arg1) {
const ret = arg0 == arg1;
return ret;
};
imports.wbg.__wbindgen_memory = function() {
const ret = wasm.memory;
return ret;
};
imports.wbg.__wbindgen_number_get = 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.__wbindgen_number_new = function(arg0) {
const ret = arg0;
return ret;
};
imports.wbg.__wbindgen_string_get = 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.__wbindgen_string_new = function(arg0, arg1) {
const ret = getStringFromWasm0(arg0, arg1);
return ret;
};
imports.wbg.__wbindgen_throw = function(arg0, arg1) {
throw new Error(getStringFromWasm0(arg0, arg1));
};
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', import.meta.url);
}
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.
*/
var ErrorStrategy;
(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";
})(ErrorStrategy || (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: 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 === 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
};
const result = this.engine.evaluate_variant(serialize(evaluationRequest));
if (result === null) {
throw new Error('Failed to evaluate variant');
}
const variantResult = deserialize(result);
if (variantResult.status === 'failure') {
throw new Error(variantResult.errorMessage);
}
if (!variantResult.result) {
throw new Error('Failed to evaluate variant');
}
return deserialize(variantResult.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
};
const result = this.engine.evaluate_boolean(serialize(evaluationRequest));
if (result === null) {
throw new Error('Failed to evaluate boolean');
}
const booleanResult = deserialize(result);
if (booleanResult.status === 'failure') {
throw new Error(booleanResult.errorMessage);
}
if (!booleanResult.result) {
throw new Error('Failed to evaluate boolean');
}
return deserialize(booleanResult.result);
}
/**
* Evaluate a batch of flag requests
*/
evaluateBatch(requests) {
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);
return {
booleanEvaluationResponse: booleanResponse,
type: 'BOOLEAN_EVALUATION_RESPONSE_TYPE'
};
}
if (response.type === 'VARIANT_EVALUATION_RESPONSE_TYPE') {
const variantResponse = deserialize(
// @ts-ignore
response.variant_evaluation_response);
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');
}
const flags = deserialize(listFlagsResult);
if (flags.status === 'failure') {
throw new Error(flags.errorMessage);
}
if (!flags.result) {
throw new Error('Failed to list flags');
}
return flags.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;
return client;
}
}
export { BaseFliptClient, ClientOptionsFactory, ErrorStrategy, FliptClient };