@spotify-confidence/openfeature-server-provider-local 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.1.1](https://github.com/spotify/confidence-resolver-rust/compare/openfeature-provider-js-v0.1.0...openfeature-provider-js-v0.1.1) (2025-11-03)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * handle panics ([#76](https://github.com/spotify/confidence-resolver-rust/issues/76)) ([1ea86ea](https://github.com/spotify/confidence-resolver-rust/commit/1ea86eaa3e64aea5a64086534fe94a155828ef80))
9
+
3
10
  ## 0.1.0 (2025-10-24)
4
11
 
5
12
 
package/README.md CHANGED
@@ -1,14 +1,14 @@
1
- ## @spotify-confidence/openfeature-server-provider-local
1
+ # @spotify-confidence/openfeature-server-provider-local
2
2
 
3
3
  OpenFeature provider for the Spotify Confidence resolver (local mode, powered by WebAssembly). It periodically fetches resolver state, evaluates flags locally, and flushes evaluation logs to the Confidence backend.
4
4
 
5
- ### Features
5
+ ## Features
6
6
  - Local flag evaluation via WASM (no per-eval network calls)
7
7
  - Automatic state refresh and batched flag log flushing
8
8
  - Pluggable `fetch` with retries, timeouts and routing
9
9
  - Optional logging using `debug`
10
10
 
11
- ### Requirements
11
+ ## Requirements
12
12
  - Node.js 18+ (built-in `fetch`) or provide a compatible `fetch`
13
13
  - WebAssembly support (Node 18+/modern browsers)
14
14
 
@@ -1330,7 +1330,7 @@ function isSet$2(value) {
1330
1330
  }
1331
1331
  const NOOP_LOG_FN = () => {};
1332
1332
  const debugBackend = loadDebug();
1333
- const logger = new class LoggerImpl {
1333
+ const logger$1 = new class LoggerImpl {
1334
1334
  childLoggers = /* @__PURE__ */ new Map();
1335
1335
  debug = NOOP_LOG_FN;
1336
1336
  info = NOOP_LOG_FN;
@@ -1362,6 +1362,7 @@ const logger = new class LoggerImpl {
1362
1362
  return child;
1363
1363
  }
1364
1364
  }("cnfd");
1365
+ const getLogger = logger$1.getLogger.bind(logger$1);
1365
1366
  async function loadDebug() {
1366
1367
  try {
1367
1368
  const { default: debug } = await import("debug");
@@ -1391,7 +1392,7 @@ function scheduleWithFixedInterval(operation, intervalMs, opt = {}) {
1391
1392
  try {
1392
1393
  await operation(ac.signal);
1393
1394
  } catch (e) {
1394
- logger.warn("scheduleWithFixedInterval failure:", e);
1395
+ logger$1.warn("scheduleWithFixedInterval failure:", e);
1395
1396
  }
1396
1397
  concurrent--;
1397
1398
  if (Date.now() - lastRunTime > intervalMs && nextRunTimeoutId != 0) {
@@ -1453,7 +1454,7 @@ function promiseSignal(signal) {
1453
1454
  function abortablePromise(promise, signal) {
1454
1455
  return signal ? Promise.race([promise, promiseSignal(signal)]) : promise;
1455
1456
  }
1456
- const logger$1 = logger.getLogger("fetch");
1457
+ const logger$2 = logger$1.getLogger("fetch");
1457
1458
  let Fetch;
1458
1459
  (function(_Fetch) {
1459
1460
  function create(middleware, sink = fetch) {
@@ -1524,13 +1525,13 @@ function withRetry(opts) {
1524
1525
  const onSuccess = async (resp) => {
1525
1526
  const { status, statusText } = resp;
1526
1527
  if (status !== 408 && status !== 429 && status < 500 || attempts >= maxAttempts) return resp;
1527
- logger$1.debug("withRetry %s failed attempt %d with %d %s", url, attempts - 1, status, statusText);
1528
+ logger$2.debug("withRetry %s failed attempt %d with %d %s", url, attempts - 1, status, statusText);
1528
1529
  const serverDelay = parseRetryAfter(resp.headers.get("Retry-After"), baseInterval, maxInterval);
1529
1530
  await abortableSleep(serverDelay ?? deadline - Date.now(), signal);
1530
1531
  return doTry();
1531
1532
  };
1532
1533
  const onError = async (error) => {
1533
- logger$1.debug("withRetry %s failed attempt %d with %s", url, attempts - 1, error);
1534
+ logger$2.debug("withRetry %s failed attempt %d with %s", url, attempts - 1, error);
1534
1535
  if (signal?.aborted || attempts >= maxAttempts) throw error;
1535
1536
  await abortableSleep(deadline - Date.now(), signal);
1536
1537
  return doTry();
@@ -1556,10 +1557,10 @@ function withAuth(tokenProvider, signal) {
1556
1557
  clearTimeout(renewTimeout);
1557
1558
  });
1558
1559
  const renewToken = () => {
1559
- logger$1.debug("withAuth renewing token");
1560
+ logger$2.debug("withAuth renewing token");
1560
1561
  clearTimeout(renewTimeout);
1561
1562
  current = tokenProvider().then(([token, expiry]) => {
1562
- logger$1.debug("withAuth renew success %s", expiry && expiry.valueOf() - Date.now());
1563
+ logger$2.debug("withAuth renew success %s", expiry && expiry.valueOf() - Date.now());
1563
1564
  if (expiry) {
1564
1565
  const ttl = expiry.valueOf() - Date.now();
1565
1566
  renewTimeout = portableSetTimeout(renewToken, .8 * ttl);
@@ -1631,7 +1632,7 @@ function withRouter(routes) {
1631
1632
  return async (url, init = {}) => {
1632
1633
  const match = table.find(([pred]) => pred(url));
1633
1634
  if (!match) {
1634
- logger$1.info("withRouter no route matched %s, falling through", url);
1635
+ logger$2.info("withRouter no route matched %s, falling through", url);
1635
1636
  return next(url, init);
1636
1637
  }
1637
1638
  return match[1](url, init);
@@ -1641,13 +1642,13 @@ function withRouter(routes) {
1641
1642
  function withResponse(factory) {
1642
1643
  return (_next) => factory;
1643
1644
  }
1644
- const fetchLogger = logger$1;
1645
- function withLogging(logger$2 = fetchLogger) {
1645
+ const fetchLogger = logger$2;
1646
+ function withLogging(logger$3 = fetchLogger) {
1646
1647
  return (next) => async (url, init) => {
1647
1648
  const start = Date.now();
1648
1649
  const resp = await next(url, init);
1649
1650
  const duration = Date.now() - start;
1650
- logger$2.info("%s %s (%i) %dms", (init?.method ?? "get").toUpperCase(), url.split("?", 1)[0], resp.status, duration);
1651
+ logger$3.info("%s %s (%i) %dms", (init?.method ?? "get").toUpperCase(), url.split("?", 1)[0], resp.status, duration);
1651
1652
  return resp;
1652
1653
  };
1653
1654
  }
@@ -2108,11 +2109,22 @@ function longToNumber(int64) {
2108
2109
  function isSet(value) {
2109
2110
  return value !== null && value !== void 0;
2110
2111
  }
2111
- var WasmResolver = class WasmResolver {
2112
+ const logger = getLogger("wasm-resolver");
2113
+ const EXPORT_FN_NAMES = [
2114
+ "wasm_msg_alloc",
2115
+ "wasm_msg_free",
2116
+ "wasm_msg_guest_resolve_with_sticky",
2117
+ "wasm_msg_guest_set_resolver_state",
2118
+ "wasm_msg_guest_flush_logs"
2119
+ ];
2120
+ function verifyExports(exports) {
2121
+ for (const fnName of EXPORT_FN_NAMES) if (typeof exports[fnName] !== "function") throw new Error(`Expected Function export "${fnName}" found ${exports[fnName]}`);
2122
+ if (!(exports.memory instanceof WebAssembly.Memory)) throw new Error(`Expected WebAssembly.Memory export "memory", found ${exports.memory}`);
2123
+ }
2124
+ var UnsafeWasmResolver = class {
2112
2125
  exports;
2113
- imports;
2114
- constructor() {
2115
- this.imports = { wasm_msg: { wasm_msg_host_current_time: () => {
2126
+ constructor(module$1) {
2127
+ const { exports } = new WebAssembly.Instance(module$1, { wasm_msg: { wasm_msg_host_current_time: () => {
2116
2128
  const epochMillisecond = Date.now();
2117
2129
  const seconds = Math.floor(epochMillisecond / 1e3);
2118
2130
  const nanos = (epochMillisecond - 1e3 * seconds) * 1e6;
@@ -2120,7 +2132,9 @@ var WasmResolver = class WasmResolver {
2120
2132
  seconds,
2121
2133
  nanos
2122
2134
  }, Timestamp);
2123
- } } };
2135
+ } } });
2136
+ verifyExports(exports);
2137
+ this.exports = exports;
2124
2138
  }
2125
2139
  resolveWithSticky(request) {
2126
2140
  const reqPtr = this.transferRequest(request, ResolveWithStickyRequest);
@@ -2166,15 +2180,65 @@ var WasmResolver = class WasmResolver {
2166
2180
  free(ptr) {
2167
2181
  this.exports.wasm_msg_free(ptr);
2168
2182
  }
2169
- static async load(module$1) {
2170
- const wasmResolver = new WasmResolver();
2171
- wasmResolver.exports = (await WebAssembly.instantiate(module$1, wasmResolver.imports)).exports;
2172
- return wasmResolver;
2183
+ };
2184
+ const DEFAULT_DELEGATE_FACTORY = (module$1) => new UnsafeWasmResolver(module$1);
2185
+ var WasmResolver = class {
2186
+ delegate;
2187
+ currentState;
2188
+ bufferedLogs = [];
2189
+ constructor(module$1, delegateFactory = DEFAULT_DELEGATE_FACTORY) {
2190
+ this.module = module$1;
2191
+ this.delegateFactory = delegateFactory;
2192
+ this.delegate = delegateFactory(module$1);
2193
+ }
2194
+ reloadInstance(error) {
2195
+ logger.error("Failure calling into wasm:", error);
2196
+ try {
2197
+ this.bufferedLogs.push(this.delegate.flushLogs());
2198
+ } catch (_) {
2199
+ logger.error("Failed to flushLogs on error");
2200
+ }
2201
+ this.delegate = this.delegateFactory(this.module);
2202
+ if (this.currentState) this.delegate.setResolverState(this.currentState);
2203
+ }
2204
+ resolveWithSticky(request) {
2205
+ try {
2206
+ return this.delegate.resolveWithSticky(request);
2207
+ } catch (error) {
2208
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2209
+ throw error;
2210
+ }
2211
+ }
2212
+ setResolverState(request) {
2213
+ this.currentState = request;
2214
+ try {
2215
+ this.delegate.setResolverState(request);
2216
+ } catch (error) {
2217
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2218
+ throw error;
2219
+ }
2220
+ }
2221
+ flushLogs() {
2222
+ try {
2223
+ this.bufferedLogs.push(this.delegate.flushLogs());
2224
+ const len = this.bufferedLogs.reduce((sum, chunk) => sum + chunk.length, 0);
2225
+ const buffer = new Uint8Array(len);
2226
+ let offset = 0;
2227
+ for (const chunk of this.bufferedLogs) {
2228
+ buffer.set(chunk, offset);
2229
+ offset += chunk.length;
2230
+ }
2231
+ this.bufferedLogs.length = 0;
2232
+ return buffer;
2233
+ } catch (error) {
2234
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2235
+ throw error;
2236
+ }
2173
2237
  }
2174
2238
  };
2175
2239
  const wasmUrl = new URL("confidence_resolver.wasm", import.meta.url);
2176
2240
  const module = await WebAssembly.compileStreaming(fetch(wasmUrl));
2177
- const resolver = await WasmResolver.load(module);
2241
+ const resolver = new WasmResolver(module);
2178
2242
  function createConfidenceServerProvider(options) {
2179
2243
  return new ConfidenceServerProviderLocal(resolver, options);
2180
2244
  }
@@ -1333,7 +1333,7 @@ function isSet$2(value) {
1333
1333
  }
1334
1334
  const NOOP_LOG_FN = () => {};
1335
1335
  const debugBackend = loadDebug();
1336
- const logger = new class LoggerImpl {
1336
+ const logger$1 = new class LoggerImpl {
1337
1337
  childLoggers = /* @__PURE__ */ new Map();
1338
1338
  debug = NOOP_LOG_FN;
1339
1339
  info = NOOP_LOG_FN;
@@ -1365,6 +1365,7 @@ const logger = new class LoggerImpl {
1365
1365
  return child;
1366
1366
  }
1367
1367
  }("cnfd");
1368
+ const getLogger = logger$1.getLogger.bind(logger$1);
1368
1369
  async function loadDebug() {
1369
1370
  try {
1370
1371
  const { default: debug } = await import("debug");
@@ -1394,7 +1395,7 @@ function scheduleWithFixedInterval(operation, intervalMs, opt = {}) {
1394
1395
  try {
1395
1396
  await operation(ac.signal);
1396
1397
  } catch (e) {
1397
- logger.warn("scheduleWithFixedInterval failure:", e);
1398
+ logger$1.warn("scheduleWithFixedInterval failure:", e);
1398
1399
  }
1399
1400
  concurrent--;
1400
1401
  if (Date.now() - lastRunTime > intervalMs && nextRunTimeoutId != 0) {
@@ -1456,7 +1457,7 @@ function promiseSignal(signal) {
1456
1457
  function abortablePromise(promise, signal) {
1457
1458
  return signal ? Promise.race([promise, promiseSignal(signal)]) : promise;
1458
1459
  }
1459
- const logger$1 = logger.getLogger("fetch");
1460
+ const logger$2 = logger$1.getLogger("fetch");
1460
1461
  let Fetch;
1461
1462
  (function(_Fetch) {
1462
1463
  function create(middleware, sink = fetch) {
@@ -1527,13 +1528,13 @@ function withRetry(opts) {
1527
1528
  const onSuccess = async (resp) => {
1528
1529
  const { status, statusText } = resp;
1529
1530
  if (status !== 408 && status !== 429 && status < 500 || attempts >= maxAttempts) return resp;
1530
- logger$1.debug("withRetry %s failed attempt %d with %d %s", url, attempts - 1, status, statusText);
1531
+ logger$2.debug("withRetry %s failed attempt %d with %d %s", url, attempts - 1, status, statusText);
1531
1532
  const serverDelay = parseRetryAfter(resp.headers.get("Retry-After"), baseInterval, maxInterval);
1532
1533
  await abortableSleep(serverDelay ?? deadline - Date.now(), signal);
1533
1534
  return doTry();
1534
1535
  };
1535
1536
  const onError = async (error) => {
1536
- logger$1.debug("withRetry %s failed attempt %d with %s", url, attempts - 1, error);
1537
+ logger$2.debug("withRetry %s failed attempt %d with %s", url, attempts - 1, error);
1537
1538
  if (signal?.aborted || attempts >= maxAttempts) throw error;
1538
1539
  await abortableSleep(deadline - Date.now(), signal);
1539
1540
  return doTry();
@@ -1559,10 +1560,10 @@ function withAuth(tokenProvider, signal) {
1559
1560
  clearTimeout(renewTimeout);
1560
1561
  });
1561
1562
  const renewToken = () => {
1562
- logger$1.debug("withAuth renewing token");
1563
+ logger$2.debug("withAuth renewing token");
1563
1564
  clearTimeout(renewTimeout);
1564
1565
  current = tokenProvider().then(([token, expiry]) => {
1565
- logger$1.debug("withAuth renew success %s", expiry && expiry.valueOf() - Date.now());
1566
+ logger$2.debug("withAuth renew success %s", expiry && expiry.valueOf() - Date.now());
1566
1567
  if (expiry) {
1567
1568
  const ttl = expiry.valueOf() - Date.now();
1568
1569
  renewTimeout = portableSetTimeout(renewToken, .8 * ttl);
@@ -1634,7 +1635,7 @@ function withRouter(routes) {
1634
1635
  return async (url, init = {}) => {
1635
1636
  const match = table.find(([pred]) => pred(url));
1636
1637
  if (!match) {
1637
- logger$1.info("withRouter no route matched %s, falling through", url);
1638
+ logger$2.info("withRouter no route matched %s, falling through", url);
1638
1639
  return next(url, init);
1639
1640
  }
1640
1641
  return match[1](url, init);
@@ -1644,13 +1645,13 @@ function withRouter(routes) {
1644
1645
  function withResponse(factory) {
1645
1646
  return (_next) => factory;
1646
1647
  }
1647
- const fetchLogger = logger$1;
1648
- function withLogging(logger$2 = fetchLogger) {
1648
+ const fetchLogger = logger$2;
1649
+ function withLogging(logger$3 = fetchLogger) {
1649
1650
  return (next) => async (url, init) => {
1650
1651
  const start = Date.now();
1651
1652
  const resp = await next(url, init);
1652
1653
  const duration = Date.now() - start;
1653
- logger$2.info("%s %s (%i) %dms", (init?.method ?? "get").toUpperCase(), url.split("?", 1)[0], resp.status, duration);
1654
+ logger$3.info("%s %s (%i) %dms", (init?.method ?? "get").toUpperCase(), url.split("?", 1)[0], resp.status, duration);
1654
1655
  return resp;
1655
1656
  };
1656
1657
  }
@@ -2111,11 +2112,22 @@ function longToNumber(int64) {
2111
2112
  function isSet(value) {
2112
2113
  return value !== null && value !== void 0;
2113
2114
  }
2114
- var WasmResolver = class WasmResolver {
2115
+ const logger = getLogger("wasm-resolver");
2116
+ const EXPORT_FN_NAMES = [
2117
+ "wasm_msg_alloc",
2118
+ "wasm_msg_free",
2119
+ "wasm_msg_guest_resolve_with_sticky",
2120
+ "wasm_msg_guest_set_resolver_state",
2121
+ "wasm_msg_guest_flush_logs"
2122
+ ];
2123
+ function verifyExports(exports) {
2124
+ for (const fnName of EXPORT_FN_NAMES) if (typeof exports[fnName] !== "function") throw new Error(`Expected Function export "${fnName}" found ${exports[fnName]}`);
2125
+ if (!(exports.memory instanceof WebAssembly.Memory)) throw new Error(`Expected WebAssembly.Memory export "memory", found ${exports.memory}`);
2126
+ }
2127
+ var UnsafeWasmResolver = class {
2115
2128
  exports;
2116
- imports;
2117
- constructor() {
2118
- this.imports = { wasm_msg: { wasm_msg_host_current_time: () => {
2129
+ constructor(module$1) {
2130
+ const { exports } = new WebAssembly.Instance(module$1, { wasm_msg: { wasm_msg_host_current_time: () => {
2119
2131
  const epochMillisecond = Date.now();
2120
2132
  const seconds = Math.floor(epochMillisecond / 1e3);
2121
2133
  const nanos = (epochMillisecond - 1e3 * seconds) * 1e6;
@@ -2123,7 +2135,9 @@ var WasmResolver = class WasmResolver {
2123
2135
  seconds,
2124
2136
  nanos
2125
2137
  }, Timestamp);
2126
- } } };
2138
+ } } });
2139
+ verifyExports(exports);
2140
+ this.exports = exports;
2127
2141
  }
2128
2142
  resolveWithSticky(request) {
2129
2143
  const reqPtr = this.transferRequest(request, ResolveWithStickyRequest);
@@ -2169,16 +2183,66 @@ var WasmResolver = class WasmResolver {
2169
2183
  free(ptr) {
2170
2184
  this.exports.wasm_msg_free(ptr);
2171
2185
  }
2172
- static async load(module$1) {
2173
- const wasmResolver = new WasmResolver();
2174
- wasmResolver.exports = (await WebAssembly.instantiate(module$1, wasmResolver.imports)).exports;
2175
- return wasmResolver;
2186
+ };
2187
+ const DEFAULT_DELEGATE_FACTORY = (module$1) => new UnsafeWasmResolver(module$1);
2188
+ var WasmResolver = class {
2189
+ delegate;
2190
+ currentState;
2191
+ bufferedLogs = [];
2192
+ constructor(module$1, delegateFactory = DEFAULT_DELEGATE_FACTORY) {
2193
+ this.module = module$1;
2194
+ this.delegateFactory = delegateFactory;
2195
+ this.delegate = delegateFactory(module$1);
2196
+ }
2197
+ reloadInstance(error) {
2198
+ logger.error("Failure calling into wasm:", error);
2199
+ try {
2200
+ this.bufferedLogs.push(this.delegate.flushLogs());
2201
+ } catch (_) {
2202
+ logger.error("Failed to flushLogs on error");
2203
+ }
2204
+ this.delegate = this.delegateFactory(this.module);
2205
+ if (this.currentState) this.delegate.setResolverState(this.currentState);
2206
+ }
2207
+ resolveWithSticky(request) {
2208
+ try {
2209
+ return this.delegate.resolveWithSticky(request);
2210
+ } catch (error) {
2211
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2212
+ throw error;
2213
+ }
2214
+ }
2215
+ setResolverState(request) {
2216
+ this.currentState = request;
2217
+ try {
2218
+ this.delegate.setResolverState(request);
2219
+ } catch (error) {
2220
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2221
+ throw error;
2222
+ }
2223
+ }
2224
+ flushLogs() {
2225
+ try {
2226
+ this.bufferedLogs.push(this.delegate.flushLogs());
2227
+ const len = this.bufferedLogs.reduce((sum, chunk) => sum + chunk.length, 0);
2228
+ const buffer$1 = new Uint8Array(len);
2229
+ let offset = 0;
2230
+ for (const chunk of this.bufferedLogs) {
2231
+ buffer$1.set(chunk, offset);
2232
+ offset += chunk.length;
2233
+ }
2234
+ this.bufferedLogs.length = 0;
2235
+ return buffer$1;
2236
+ } catch (error) {
2237
+ if (error instanceof WebAssembly.RuntimeError) this.reloadInstance(error);
2238
+ throw error;
2239
+ }
2176
2240
  }
2177
2241
  };
2178
2242
  const wasmPath = __require.resolve("./confidence_resolver.wasm");
2179
2243
  const buffer = await fs.readFile(wasmPath);
2180
2244
  const module = await WebAssembly.compile(buffer);
2181
- const resolver = await WasmResolver.load(module);
2245
+ const resolver = new WasmResolver(module);
2182
2246
  function createConfidenceServerProvider(options) {
2183
2247
  return new ConfidenceServerProviderLocal(resolver, options);
2184
2248
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spotify-confidence/openfeature-server-provider-local",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Spotify Confidence Open Feature provider",
5
5
  "type": "module",
6
6
  "files": [
@@ -33,7 +33,7 @@
33
33
  "build": "tsdown",
34
34
  "dev": "tsdown --watch",
35
35
  "test": "vitest",
36
- "proto:gen": "rm -rf src/proto && mkdir -p src/proto && protoc --plugin=node_modules/.bin/protoc-gen-ts_proto --ts_proto_opt useOptionals=messages --ts_proto_opt esModuleInterop=true --ts_proto_out src/proto -Iproto api.proto messages.proto"
36
+ "proto:gen": "rm -rf src/proto && mkdir -p src/proto && protoc --plugin=node_modules/.bin/protoc-gen-ts_proto --ts_proto_opt useOptionals=messages --ts_proto_opt esModuleInterop=true --ts_proto_out src/proto -Iproto api.proto messages.proto test-only.proto"
37
37
  },
38
38
  "dependencies": {
39
39
  "@bufbuild/protobuf": "^2.9.0"