@productcraft/flags 0.1.0 → 0.3.0

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.
Files changed (44) hide show
  1. package/README.md +26 -3
  2. package/dist/{chunk-SYCVHW7C.js → browser/chunk-4LRAE3F3.js} +4 -4
  3. package/dist/browser/chunk-4LRAE3F3.js.map +1 -0
  4. package/dist/{chunk-ZL3B6RIH.cjs → browser/chunk-4XCQBTYE.cjs} +46 -53
  5. package/dist/browser/chunk-4XCQBTYE.cjs.map +1 -0
  6. package/dist/{chunk-UI25HRYK.js → browser/chunk-72WU42RU.js} +47 -54
  7. package/dist/browser/chunk-72WU42RU.js.map +1 -0
  8. package/dist/{chunk-3KVHTUZO.cjs → browser/chunk-FXZVXQ75.cjs} +4 -4
  9. package/dist/browser/chunk-FXZVXQ75.cjs.map +1 -0
  10. package/dist/browser/index.cjs +105 -0
  11. package/dist/browser/index.cjs.map +1 -0
  12. package/dist/browser/index.js +9 -0
  13. package/dist/browser/index.js.map +1 -0
  14. package/dist/browser/management.cjs +12 -0
  15. package/dist/browser/management.cjs.map +1 -0
  16. package/dist/browser/management.js +3 -0
  17. package/dist/browser/management.js.map +1 -0
  18. package/dist/browser/testing.cjs +1315 -0
  19. package/dist/browser/testing.cjs.map +1 -0
  20. package/dist/browser/testing.js +1307 -0
  21. package/dist/browser/testing.js.map +1 -0
  22. package/dist/chunk-2YRDLKNB.js +1584 -0
  23. package/dist/{chunk-SYCVHW7C.js.map → chunk-2YRDLKNB.js.map} +1 -1
  24. package/dist/chunk-QTDMUNLG.cjs +631 -0
  25. package/dist/chunk-QTDMUNLG.cjs.map +1 -0
  26. package/dist/chunk-TSRLPHJ5.js +626 -0
  27. package/dist/chunk-TSRLPHJ5.js.map +1 -0
  28. package/dist/chunk-WI4EZXOV.cjs +1584 -0
  29. package/dist/{chunk-3KVHTUZO.cjs.map → chunk-WI4EZXOV.cjs.map} +1 -1
  30. package/dist/{client-DQaz2Leb.d.cts → client-K2zALPGD.d.cts} +5 -3
  31. package/dist/{client-DQaz2Leb.d.ts → client-K2zALPGD.d.ts} +5 -3
  32. package/dist/index.cjs +8 -8
  33. package/dist/index.d.cts +1 -1
  34. package/dist/index.d.ts +1 -1
  35. package/dist/index.js +2 -2
  36. package/dist/management.cjs +2 -2
  37. package/dist/management.js +1 -1
  38. package/dist/testing.cjs +3 -3
  39. package/dist/testing.d.cts +1 -1
  40. package/dist/testing.d.ts +1 -1
  41. package/dist/testing.js +1 -1
  42. package/package.json +47 -4
  43. package/dist/chunk-UI25HRYK.js.map +0 -1
  44. package/dist/chunk-ZL3B6RIH.cjs.map +0 -1
@@ -31,16 +31,6 @@ function isWellFormedSdkKey(key) {
31
31
  // src/client/overrides.ts
32
32
  var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
33
33
  var put = (o, k, v) => Object.defineProperty(o, k, { value: v, enumerable: true, writable: true, configurable: true });
34
- function parseOverrideText(text, source) {
35
- let doc;
36
- try {
37
- doc = JSON.parse(text);
38
- } catch (e) {
39
- throw new Error(`${source}: ${e.message}`);
40
- }
41
- if (!isObj(doc)) throw new Error(`${source}: not a JSON object`);
42
- return doc;
43
- }
44
34
  function toSetting(value, remote) {
45
35
  if (typeof value === "boolean") return { type: "boolean", value };
46
36
  if (typeof value === "string") return remote === "json" ? { type: "json", value } : { type: "string", value };
@@ -78,16 +68,24 @@ function combine(remote, overrides, behaviour) {
78
68
  for (const k of Object.keys(second)) put(settings, k, second[k]);
79
69
  return { ...remote, settings };
80
70
  }
81
- var envText = (name) => core.readEnv(name);
82
- async function readText(path) {
83
- const fs = await import('node:fs/promises');
84
- return fs.readFile(path, "utf8");
71
+ var NODE_ONLY = "overrides.file and overrides.env are Node-only; use overrides.values in a browser";
72
+ function deliveryHeaders(etag) {
73
+ return etag && !core.isBrowser() ? { Accept: "application/json", "If-None-Match": etag } : { Accept: "application/json" };
74
+ }
75
+ function envOverrides(_name) {
76
+ throw new Error(NODE_ONLY);
77
+ }
78
+ async function fileOverrides(_path, _watch, _apply, report) {
79
+ report(NODE_ONLY);
80
+ return void 0;
85
81
  }
86
- async function watchFile(path, onChange) {
87
- const fs = await import('node:fs');
88
- const watcher = fs.watch(path, { persistent: false }, () => onChange());
89
- watcher.on("error", () => void 0);
90
- return () => watcher.close();
82
+ function watchVisibility(onChange) {
83
+ const d = globalThis.document;
84
+ if (!d?.addEventListener) return void 0;
85
+ const listener = () => onChange(d.visibilityState === "hidden");
86
+ listener();
87
+ d.addEventListener("visibilitychange", listener);
88
+ return () => d.removeEventListener("visibilitychange", listener);
91
89
  }
92
90
  var fail = (base, def, code, message) => ({
93
91
  ...base,
@@ -149,7 +147,6 @@ function toValues(details) {
149
147
  }
150
148
 
151
149
  // src/client/client.ts
152
- var VERSION = "0.1.0" ;
153
150
  var DEFAULT_BASE = "https://api.flags.productcraft.co";
154
151
  var MAX_CONFIG_BYTES = 2 * 1024 * 1024;
155
152
  var FlagsClientError = class extends core.ProductCraftError {
@@ -247,7 +244,10 @@ var FlagsClient = class {
247
244
  #abort = null;
248
245
  #offline;
249
246
  #closed = false;
247
+ /** Browser build: the page is hidden, so auto polling waits for it to come back (6.3, task 019). */
248
+ #hidden = false;
250
249
  #unwatch;
250
+ #unwatchVisibility;
251
251
  #init;
252
252
  constructor(options = {}) {
253
253
  const o = this.#o = options;
@@ -276,8 +276,15 @@ var FlagsClient = class {
276
276
  this.#initWait = Math.max(0, (p.mode === "auto" ? p.maxInitWaitSeconds : void 0) ?? 5) * 1e3;
277
277
  if (o.bootstrap !== void 0) this.#adopt(o.bootstrap, "bootstrap", null, 0);
278
278
  if (ov && "values" in ov) this.#setOverrides(ov.values);
279
- else if (ov && "env" in ov) this.#overrideText(() => envText(ov.env) ?? "{}", `$${ov.env}`);
279
+ else if (ov && "env" in ov) {
280
+ try {
281
+ this.#setOverrides(envOverrides(ov.env));
282
+ } catch (e) {
283
+ this.#error("overrides", e.message, e);
284
+ }
285
+ }
280
286
  this.#recompute(false);
287
+ if (this.#mode === "auto" && this.#key) this.#unwatchVisibility = watchVisibility((hidden) => this.#visibility(hidden));
281
288
  this.#init = this.#start();
282
289
  }
283
290
  /** `initializing`, `ready`, `stale`, `key_invalid`, `offline` or `closed`. */
@@ -348,6 +355,14 @@ var FlagsClient = class {
348
355
  this.#state = "closed";
349
356
  this.#stop();
350
357
  this.#unwatch?.();
358
+ this.#unwatchVisibility?.();
359
+ }
360
+ /** Hidden: no further polls (a download in flight finishes). Visible again: download now, then poll as usual. */
361
+ #visibility(hidden) {
362
+ const was = this.#hidden;
363
+ this.#hidden = hidden;
364
+ if (hidden) clearTimeout(this.#timer);
365
+ else if (was && this.#state !== "initializing") void this.forceRefresh();
351
366
  }
352
367
  async #eval(key, def, user, json) {
353
368
  await this.#ensure();
@@ -361,13 +376,11 @@ var FlagsClient = class {
361
376
  await 0;
362
377
  const ov = this.#o.overrides;
363
378
  if (ov && "file" in ov) {
364
- await this.#loadFile(ov.file);
365
- try {
366
- if (ov.watch && !this.#closed) this.#unwatch = await watchFile(ov.file, () => void this.#loadFile(ov.file));
367
- if (this.#closed) this.#unwatch?.();
368
- } catch (e) {
369
- this.#error("overrides", "overrides file watch failed", e);
370
- }
379
+ const apply = (values) => {
380
+ if (values) this.#setOverrides(values);
381
+ this.#recompute(true);
382
+ };
383
+ this.#unwatch = await fileOverrides(ov.file, ov.watch, apply, (m, e) => this.#error("overrides", m, e));
371
384
  }
372
385
  await this.#readCache();
373
386
  if (this.#closed) ; else if (!this.#key) this.#state = "ready";
@@ -399,7 +412,7 @@ var FlagsClient = class {
399
412
  /** Auto polling: the next download after the jittered interval, later after errors (at most 4x) or when the server asks (Retry-After). */
400
413
  #schedule() {
401
414
  clearTimeout(this.#timer);
402
- if (this.#closed || this.#offline || this.#mode !== "auto" || !this.#key) return;
415
+ if (this.#closed || this.#offline || this.#hidden || this.#mode !== "auto" || !this.#key) return;
403
416
  const i = this.#interval;
404
417
  let delay = i * (0.9 + 0.2 * Math.random());
405
418
  if (this.#failures) delay = Math.min(4 * i, delay + core.backoffMs(this.#failures));
@@ -414,11 +427,7 @@ var FlagsClient = class {
414
427
  const abort = this.#abort = new AbortController();
415
428
  const timer = setTimeout(() => abort.abort(), this.#timeout);
416
429
  try {
417
- const headers = { Accept: "application/json" };
418
- if (!core.isBrowser()) {
419
- headers["User-Agent"] = `productcraft-node/flags/${VERSION} ${core.runtimeTag()}`;
420
- if (this.#etag) headers["If-None-Match"] = this.#etag;
421
- }
430
+ const headers = deliveryHeaders(this.#etag);
422
431
  const res = await this.#fetch(`${base}/v1/configs/${encodeURIComponent(this.#key)}/config.json`, { headers, signal: abort.signal });
423
432
  if (res.status < 500) return await this.#handle(res);
424
433
  cancel(res);
@@ -462,7 +471,7 @@ var FlagsClient = class {
462
471
  }
463
472
  #failed(code, message, cause) {
464
473
  this.#failures++;
465
- if (!this.#closed && !this.#offline) this.#state = "stale";
474
+ if (!this.#closed && !this.#offline) this.#state = this.#remote ? "stale" : "unavailable";
466
475
  this.#error(code, message, cause);
467
476
  }
468
477
  /**
@@ -502,22 +511,6 @@ var FlagsClient = class {
502
511
  if (skipped.length) this.#error("overrides", `overrides skipped: ${skipped}`);
503
512
  this.#overrides = settings;
504
513
  }
505
- #overrideText(read, source) {
506
- try {
507
- this.#setOverrides(parseOverrideText(read(), source));
508
- } catch (e) {
509
- this.#error("overrides", e.message, e);
510
- }
511
- }
512
- async #loadFile(path) {
513
- try {
514
- const text = await readText(path);
515
- this.#overrideText(() => text, "the overrides file");
516
- this.#recompute(true);
517
- } catch (e) {
518
- this.#error("overrides", "overrides file unreadable", e);
519
- }
520
- }
521
514
  /** Rebuilds the evaluated config from the remote one and the overrides. */
522
515
  #recompute(emit) {
523
516
  const raw = combine(this.#remoteRaw, this.#overrides, this.#behaviour);
@@ -601,5 +594,5 @@ exports.FlagsClient = FlagsClient;
601
594
  exports.FlagsClientError = FlagsClientError;
602
595
  exports.FlagsSnapshot = FlagsSnapshot;
603
596
  exports.MAX_CONFIG_BYTES = MAX_CONFIG_BYTES;
604
- //# sourceMappingURL=chunk-ZL3B6RIH.cjs.map
605
- //# sourceMappingURL=chunk-ZL3B6RIH.cjs.map
597
+ //# sourceMappingURL=chunk-4XCQBTYE.cjs.map
598
+ //# sourceMappingURL=chunk-4XCQBTYE.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/client/key.ts","../../src/client/overrides.ts","../../src/client/platform.browser.ts","../../src/client/resolve.ts","../../src/client/client.ts"],"names":["isBrowser","evaluate","ProductCraftError","setOverride","ConfigurationError","backoffMs","parseRetryAfterMs","parseConfig","ConfigParseError","isNewerConfig","hashConfidential"],"mappings":"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","file":"chunk-4XCQBTYE.cjs","sourcesContent":["// SDK key shape and checksum (design 6.1): `pcf_sdk_` + 32 base62 + 6-char base62 CRC-32 of the body.\n// A typo fails here, before any request; the checksum is public, so it is a typo check, not a secret.\n\nconst BASE62 = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\";\n\nfunction crc32(text: string): number {\n let crc = 0xffffffff;\n for (let i = 0; i < text.length; i++) {\n crc ^= text.charCodeAt(i);\n for (let k = 0; k < 8; k++) crc = crc & 1 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;\n }\n return (crc ^ 0xffffffff) >>> 0;\n}\n\nfunction base62(value: number, width: number): string {\n let out = \"\";\n do {\n out = BASE62[value % 62] + out;\n value = Math.floor(value / 62);\n } while (value > 0);\n return out.padStart(width, \"0\");\n}\n\n/** True when `key` has the SDK key shape and its checksum matches. */\nexport function isWellFormedSdkKey(key: unknown): key is string {\n if (typeof key !== \"string\" || !/^pcf_sdk_[0-9A-Za-z]{38}$/.test(key)) return false;\n return base62(crc32(key.slice(8, 40)), 6) === key.slice(40);\n}\n","// Overrides (design 8.2): turn a map of key -> value into config settings and combine them with the\n// downloaded config per behaviour. Only own keys are read and every key is defined with\n// defineProperty, so `__proto__` and friends stay ordinary keys.\n\nimport type { SettingType } from \"@productcraft/flags-engine\";\nimport type { OverrideBehaviour } from \"./types.js\";\n\ntype Obj = Record<string, unknown>;\nconst isObj = (v: unknown): v is Obj => typeof v === \"object\" && v !== null && !Array.isArray(v);\n/** Defines an own, enumerable key (so `__proto__` is an ordinary key) and returns the object. */\nexport const put = (o: Obj, k: string, v: unknown): Obj => Object.defineProperty(o, k, { value: v, enumerable: true, writable: true, configurable: true });\n\n/** Parses override JSON text (a file or an environment variable): it must hold a JSON object. */\nexport function parseOverrideText(text: string, source: string): Obj {\n let doc: unknown;\n try {\n doc = JSON.parse(text);\n } catch (e) {\n throw new Error(`${source}: ${(e as Error).message}`);\n }\n if (!isObj(doc)) throw new Error(`${source}: not a JSON object`);\n return doc;\n}\n\n/** One override as a config setting, typed after the value (and after the remote setting where they agree). */\nfunction toSetting(value: unknown, remote: SettingType | undefined): Obj | null {\n if (typeof value === \"boolean\") return { type: \"boolean\", value };\n if (typeof value === \"string\") return remote === \"json\" ? { type: \"json\", value } : { type: \"string\", value };\n if (typeof value === \"number\") {\n if (!Number.isFinite(value)) return null;\n return { type: remote !== \"number\" && Number.isSafeInteger(value) ? \"integer\" : \"number\", value };\n }\n if (value === null || typeof value === \"object\") {\n try {\n return { type: \"json\", value: JSON.stringify(value) };\n } catch {\n return null;\n }\n }\n return null;\n}\n\n/** The settings map for a set of overrides; values that cannot be a setting (undefined, NaN, functions) are skipped and named in `skipped`. */\nexport function overrideSettings(values: Obj, remoteType: (key: string) => SettingType | undefined): { settings: Obj; skipped: string[] } {\n const settings: Obj = {};\n const skipped: string[] = [];\n for (const key of Object.keys(values)) {\n const s = toSetting(values[key], remoteType(key));\n if (s) put(settings, key, s);\n else skipped.push(key);\n }\n return { settings, skipped };\n}\n\n/** The config the client evaluates: the download, the overrides, or both combined per `behaviour`. */\nexport function combine(remote: Obj | null, overrides: Obj | null, behaviour: OverrideBehaviour): Obj | null {\n if (!overrides) return remote;\n const local = { schema: 1, revision: 0, generation: 1, salt: \"\", segments: {}, settings: overrides };\n if (behaviour === \"local_only\" || !remote) return local;\n const settings: Obj = {};\n const remoteSettings = isObj(remote.settings) ? remote.settings : {};\n const [first, second] = behaviour === \"local_over_remote\" ? [remoteSettings, overrides] : [overrides, remoteSettings];\n for (const k of Object.keys(first)) put(settings, k, first[k]);\n for (const k of Object.keys(second)) put(settings, k, second[k]);\n return { ...remote, settings };\n}\n","// platform.ts for the browser and React Native build (`browser` / `react-native` export conditions,\n// task 019). tsup.config.ts swaps it in for platform.ts, so the browser bundle has no `node:` import,\n// no `process.env` read and no override-file code. Override files and environment variables are\n// Node-only: they report an `overrides` error. Auto polling pauses while the page is hidden.\n\nimport { isBrowser } from \"@productcraft/core\";\n\ntype Obj = Record<string, unknown>;\nconst NODE_ONLY = \"overrides.file and overrides.env are Node-only; use overrides.values in a browser\";\n\n/**\n * Request headers for a config download. A page sends no If-None-Match: it would force a CORS\n * preflight, and the browser HTTP cache revalidates on its own (design 6.3). React Native has no\n * CORS and sends the held ETag. No User-Agent (browsers own that header).\n */\nexport function deliveryHeaders(etag: string | null): Record<string, string> {\n return etag && !isBrowser() ? { Accept: \"application/json\", \"If-None-Match\": etag } : { Accept: \"application/json\" };\n}\n\nexport function envOverrides(_name: string): Obj {\n throw new Error(NODE_ONLY);\n}\n\nexport async function fileOverrides(_path: string, _watch: boolean | undefined, _apply: (values: Obj | null) => void, report: (message: string) => void): Promise<undefined> {\n report(NODE_ONLY);\n return undefined;\n}\n\n/** Calls `onChange(hidden)` now and on every `visibilitychange`; returns a function that stops listening. Undefined without a `document` (React Native, workers). */\nexport function watchVisibility(onChange: (hidden: boolean) => void): (() => void) | undefined {\n type Doc = { visibilityState?: string; addEventListener(type: string, listener: () => void): void; removeEventListener(type: string, listener: () => void): void };\n const d = (globalThis as { document?: Doc }).document;\n if (!d?.addEventListener) return undefined;\n const listener = (): void => onChange(d.visibilityState === \"hidden\");\n listener();\n d.addEventListener(\"visibilitychange\", listener);\n return () => d.removeEventListener(\"visibilitychange\", listener);\n}\n","// From an engine evaluation to what getValue / getJson / getValueDetails return (design 8.2):\n// json settings parse for object, array and null defaults (and always in getJson), errors return the\n// caller's default, and the client layer marks values served from the cache or a stale copy.\n\nimport { evaluate, type EvaluationDetails, type ParsedConfig, type Reason, type User } from \"@productcraft/flags-engine\";\n\nexport type Layer = \"CACHED\" | \"STALE\" | null;\n\nconst fail = <T>(base: EvaluationDetails<unknown>, def: T, code: EvaluationDetails[\"errorCode\"], message: string): EvaluationDetails<T> => ({\n ...base,\n value: def,\n variant: null,\n reason: \"ERROR\",\n errorCode: code,\n errorMessage: message,\n ruleIndex: null,\n percentageIndex: null,\n isDefaultValue: true,\n});\n\n/** Evaluates one key. `json`: always parse (getJson). Never throws. */\nexport function resolve<T>(config: ParsedConfig | null, key: string, def: T, user: User | null | undefined, json: boolean, layer: Layer): EvaluationDetails<T> {\n const empty: EvaluationDetails<unknown> = {\n key, value: def, variant: null, reason: \"ERROR\", errorCode: null, errorMessage: null,\n ruleIndex: null, percentageIndex: null, isDefaultValue: true, revision: config?.revision ?? 0, warnings: [],\n };\n if (!config) return fail(empty, def, \"PROVIDER_NOT_READY\", \"no config yet\");\n try {\n const parse = json || def === null || def === undefined || typeof def === \"object\";\n const d = evaluate(config, key, (parse ? null : def) as never, user ?? null) as EvaluationDetails<unknown>;\n if (d.reason === \"ERROR\") return { ...d, value: def, isDefaultValue: true };\n const type = config.settingType(key);\n let value = d.value;\n if (parse) {\n const parsable = type === \"json\" || (json && type === \"string\");\n if (!parsable && (json || (def !== null && def !== undefined))) {\n return fail(d, def, \"TYPE_MISMATCH\", `${key} is ${type}`);\n }\n if (parsable) {\n try {\n value = JSON.parse(d.value as string);\n } catch (e) {\n return fail(d, def, \"PARSE_ERROR\", (e as Error).message);\n }\n }\n }\n return { ...d, value: value as T, reason: layer ?? (d.reason as Reason) };\n } catch (e) {\n return fail(empty, def, \"GENERAL\", (e as Error)?.message ?? String(e));\n }\n}\n\n/** Every setting's value for a user, json settings parsed (a json parse failure gives null). */\nexport function resolveAll(config: ParsedConfig | null, user: User | null | undefined, layer: Layer): EvaluationDetails<unknown>[] {\n return config ? config.keys().map((k) => resolve<unknown>(config, k, null, user, false, layer)) : [];\n}\n\n/** A null-prototype map of key -> value, so a `__proto__` key is an ordinary entry. */\nexport function toValues(details: EvaluationDetails<unknown>[]): Record<string, unknown> {\n const out = Object.create(null) as Record<string, unknown>;\n for (const d of details) out[d.key] = d.value;\n return out;\n}\n","// FlagsClient (design 8.2): downloads one config JSON per (config, environment) and evaluates flags\n// locally with @productcraft/flags-engine. User attributes never leave the process.\n//\n// Fail-safe order: fresh download -> last-known in memory -> the pluggable cache (read at start-up)\n// -> `bootstrap` -> the caller's default. `getValue` and friends never throw after construction.\n// Kept small on purpose: the one-call bundle (this file, the engine and core) has a 10 KB gzip budget.\n\nimport { backoffMs, ConfigurationError, parseRetryAfterMs, ProductCraftError, type Logger } from \"@productcraft/core\";\nimport { ConfigParseError, hashConfidential, isNewerConfig, parseConfig, type EvaluationDetails, type ParsedConfig, type SettingValue, type User } from \"@productcraft/flags-engine\";\nimport { isWellFormedSdkKey } from \"./key.js\";\nimport { combine, overrideSettings, put } from \"./overrides.js\";\nimport { deliveryHeaders, envOverrides, fileOverrides, watchVisibility } from \"./platform.js\";\nimport { resolve, resolveAll, toValues, type Layer } from \"./resolve.js\";\nimport type { ClientState, ConfigSource, FlagsClientErrorCode, FlagsClientEvents, FlagsClientOptions, FlagValue, OverrideBehaviour } from \"./types.js\";\n\n/** The delivery host (`PC_BASE_URL.flags` in `@productcraft/core`). */\nconst DEFAULT_BASE = \"https://api.flags.productcraft.co\";\n\n/** The SDK refuses a config body over 2 MiB before parsing it (the API caps configs at 1 MiB). */\nexport const MAX_CONFIG_BYTES = 2 * 1024 * 1024;\n\ntype Obj = Record<string, unknown>;\ntype Def = SettingValue | object | null;\n\n/** A failure the client reports through the `error` event (it never throws them at callers). */\nexport class FlagsClientError extends ProductCraftError {\n static override readonly brandName: string = \"FlagsClientError\";\n readonly code: FlagsClientErrorCode;\n constructor(code: FlagsClientErrorCode, message: string, options?: { cause?: unknown }) {\n super(message, options);\n this.code = code;\n }\n}\n\n/**\n * Keeps only `https://<host>.productcraft.co` origins with no userinfo, port, path, query or fragment\n * (design 5, T7); every other entry is dropped and reported through `warn`.\n */\nexport function deliveryOrigins(urls: readonly string[], warn: (message: string) => void): string[] {\n const out: string[] = [];\n for (const raw of urls) {\n if (/^https:\\/\\/[a-z0-9-]+(\\.[a-z0-9-]+)*\\.productcraft\\.co\\/?$/.test(raw)) out.push(raw.replace(/\\/$/, \"\"));\n else warn(`base_urls entry dropped: ${JSON.stringify(String(raw).slice(0, 99))}`);\n }\n return out;\n}\n\n/** A frozen view of one config for synchronous evaluation (`flags.snapshot()`). */\nexport class FlagsSnapshot {\n readonly #c: ParsedConfig | null;\n readonly #raw: Obj | null;\n readonly #user: User | undefined;\n readonly #layer: Layer;\n /** @internal */\n constructor(config: ParsedConfig | null, raw: Obj | null, user: User | undefined, layer: Layer) {\n this.#c = config;\n this.#raw = raw;\n this.#user = user;\n this.#layer = layer;\n }\n /** Revision of the config, 0 when there is none. */\n get revision(): number {\n return this.#c?.revision ?? 0;\n }\n /** Generation of the config (bumped after a database restore), 0 when there is none. */\n get generation(): number {\n return this.#c?.generation ?? 0;\n }\n /** Setting keys in config order. */\n keys(): string[] {\n return this.#c?.keys() ?? [];\n }\n getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): FlagValue<D> {\n return this.getValueDetails(key, defaultValue, user).value;\n }\n getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): EvaluationDetails<FlagValue<D>> {\n return resolve(this.#c, key, defaultValue, user ?? this.#user, false, this.#layer) as EvaluationDetails<FlagValue<D>>;\n }\n getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): T {\n return resolve(this.#c, key, defaultValue, user ?? this.#user, true, this.#layer).value;\n }\n getAllValues(user?: User | null): Record<string, unknown> {\n return toValues(resolveAll(this.#c, user ?? this.#user, this.#layer));\n }\n /** The config JSON this snapshot evaluates (overrides included), or null: pass it as another client's `bootstrap`. */\n toJSON(): Obj | null {\n return this.#raw;\n }\n}\n\n/** Sets one override and re-evaluates (createTestClient's `set`); not exported from the package. */\nexport let setOverride: (client: FlagsClient, key: string, value: unknown) => void;\n\nconst unref = <T>(t: T): T => ((t as { unref?: () => void }).unref?.(), t);\nconst cancel = (res: Response): void => void res.body?.cancel().catch(() => undefined);\n\n/**\n * Feature flags and settings, evaluated locally.\n *\n * @example\n * ```ts\n * import { FlagsClient } from \"@productcraft/flags\";\n * const flags = new FlagsClient({ sdkKey: process.env.PRODUCTCRAFT_FLAGS_SDK_KEY });\n * const on = await flags.getValue(\"new_checkout\", false, { identifier: \"user-1\" });\n * ```\n */\nexport class FlagsClient {\n readonly #key: string | null;\n readonly #mode: string;\n readonly #interval: number;\n readonly #initWait: number;\n readonly #timeout: number;\n readonly #fetch: typeof fetch;\n readonly #fixedBase: string | null;\n readonly #log: Logger | null;\n readonly #o: FlagsClientOptions;\n readonly #behaviour: OverrideBehaviour;\n readonly #on: { [E in keyof FlagsClientEvents]: Set<FlagsClientEvents[E]> } = { ready: new Set(), configChanged: new Set(), evaluated: new Set(), error: new Set() };\n readonly #warned = new Set<string>();\n #state: ClientState = \"initializing\";\n #source: ConfigSource = \"none\";\n /** The downloaded (or cached / bootstrap) config, parsed and as JSON for combining with overrides. */\n #remote: ParsedConfig | null = null;\n #remoteRaw: Obj | null = null;\n #etag: string | null = null;\n #fetchedAt = 0;\n /** Override values as given, and as config settings. */\n #overrideValues: Obj = {};\n #overrides: Obj | null = null;\n /** What evaluations use: the remote config combined with the overrides. */\n #config: ParsedConfig | null = null;\n #configRaw: Obj | null = null;\n #bases: string[];\n #user: User | undefined;\n #failures = 0;\n #retryAfter = 0;\n #timer: ReturnType<typeof setTimeout> | undefined;\n #inflight: Promise<void> | null = null;\n #abort: AbortController | null = null;\n #offline: boolean;\n #closed = false;\n /** Browser build: the page is hidden, so auto polling waits for it to come back (6.3, task 019). */\n #hidden = false;\n #unwatch: (() => void) | undefined;\n #unwatchVisibility: (() => void) | undefined;\n readonly #init: Promise<void>;\n\n constructor(options: FlagsClientOptions = {}) {\n const o = (this.#o = options);\n const ov = o.overrides;\n const p = o.polling ?? { mode: \"auto\" };\n this.#behaviour = ov?.behaviour ?? \"local_over_remote\";\n if (!/^(auto|lazy|manual)$/.test(p.mode) || !/^(local_only|local_over_remote|remote_over_local)$/.test(this.#behaviour)) {\n throw new ConfigurationError(\"bad polling.mode or overrides.behaviour\");\n }\n const localOnly = !!ov && this.#behaviour === \"local_only\";\n // Without a key the client never downloads: local_only overrides, or an offline client over `bootstrap`.\n if (o.sdkKey === undefined ? !localOnly && !(o.offline && o.bootstrap !== undefined) : !isWellFormedSdkKey(o.sdkKey)) {\n throw new ConfigurationError(\"sdkKey is not a valid pcf_sdk_ key (check for a typo)\");\n }\n this.#key = localOnly ? null : (o.sdkKey ?? null);\n this.#log = o.logger === null ? null : (o.logger ?? console);\n this.#fetch = o.fetch ?? ((...a) => fetch(...a));\n this.#fixedBase = o.baseUrl?.replace(/\\/+$/, \"\") || null;\n this.#bases = [this.#fixedBase ?? DEFAULT_BASE];\n this.#timeout = o.timeout ?? 10_000;\n this.#user = o.defaultUser;\n this.#offline = o.offline === true;\n this.#mode = p.mode;\n const s = p.mode === \"auto\" ? p.intervalSeconds : p.mode === \"lazy\" ? p.ttlSeconds : undefined;\n if (s !== undefined && !(s >= 30)) this.#warn(\"i\", `polling interval raised to the 30 s minimum`);\n this.#interval = Math.max(30, s ?? 60) * 1000 || 30_000;\n this.#initWait = Math.max(0, (p.mode === \"auto\" ? p.maxInitWaitSeconds : undefined) ?? 5) * 1000;\n\n // Synchronous sources first, so a value is available before the first await.\n if (o.bootstrap !== undefined) this.#adopt(o.bootstrap, \"bootstrap\", null, 0);\n if (ov && \"values\" in ov) this.#setOverrides(ov.values);\n else if (ov && \"env\" in ov) {\n try {\n this.#setOverrides(envOverrides(ov.env));\n } catch (e) {\n this.#error(\"overrides\", (e as Error).message, e);\n }\n }\n this.#recompute(false);\n if (this.#mode === \"auto\" && this.#key) this.#unwatchVisibility = watchVisibility((hidden) => this.#visibility(hidden));\n this.#init = this.#start();\n }\n\n /** `initializing`, `ready`, `stale`, `key_invalid`, `offline` or `closed`. */\n get state(): ClientState {\n return this.#state;\n }\n\n /** Subscribe to `ready`, `configChanged`, `evaluated` or `error`. Returns a function that unsubscribes. */\n on<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): () => void {\n this.#on[event].add(listener);\n return () => this.off(event, listener);\n }\n\n off<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): void {\n this.#on[event].delete(listener);\n }\n\n /** The user evaluations use when a call passes none. */\n setDefaultUser(user: User | undefined): void {\n this.#user = user;\n }\n\n /** The value of a flag or setting for a user; the default on any failure. Never throws. */\n async getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<FlagValue<D>> {\n return (await this.getValueDetails(key, defaultValue, user)).value;\n }\n\n /** The value plus why: reason, matched rule or split, error code, warnings and revision. Never throws. */\n async getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<EvaluationDetails<FlagValue<D>>> {\n return this.#eval(key, defaultValue, user, false) as Promise<EvaluationDetails<FlagValue<D>>>;\n }\n\n /** A json (or string) setting, parsed. A parse failure, a missing key or another type returns the default. Never throws. */\n async getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): Promise<T> {\n return (await this.#eval(key, defaultValue, user, true)).value;\n }\n\n /** Every setting's value for a user (json settings parsed), as a null-prototype object. Never throws. */\n async getAllValues(user?: User | null): Promise<Record<string, unknown>> {\n await this.#ensure();\n return toValues(resolveAll(this.#config, user ?? this.#user, this.#layer()).map((d) => this.#evaluated(d)));\n }\n\n /** The config as it is now, for synchronous evaluation. Does not wait for the first download. */\n snapshot(): FlagsSnapshot {\n return new FlagsSnapshot(this.#config, this.#configRaw, this.#user, this.#layer());\n }\n\n /** Resolves when start-up has settled: the first download finished or `maxInitWaitSeconds` passed. Never rejects. */\n async waitForReady(): Promise<ClientState> {\n await this.#init;\n return this.#state;\n }\n\n /** Downloads the config now (any polling mode). Resolves when the attempt settles; never rejects. */\n async forceRefresh(): Promise<void> {\n if (this.#closed || this.#offline || !this.#key) return;\n await this.#fetchNow();\n this.#schedule();\n }\n\n /** Stops all network access; evaluations keep using what is held. */\n setOffline(): void {\n if (this.#closed) return;\n this.#offline = true;\n this.#state = \"offline\";\n this.#stop();\n }\n\n /** Resumes network access after `setOffline()` (or the `offline` option). Auto polling fetches at once. */\n setOnline(): void {\n if (this.#closed || !this.#offline) return;\n this.#offline = false;\n this.#state = this.#remote ? \"stale\" : \"initializing\";\n if (this.#mode === \"auto\") void this.forceRefresh();\n }\n\n /** Stops timers, aborts a download in flight and stops watching an override file. Evaluations keep working on what is held. */\n close(): void {\n this.#closed = true;\n this.#state = \"closed\";\n this.#stop();\n this.#unwatch?.();\n this.#unwatchVisibility?.();\n }\n\n /** Hidden: no further polls (a download in flight finishes). Visible again: download now, then poll as usual. */\n #visibility(hidden: boolean): void {\n const was = this.#hidden;\n this.#hidden = hidden;\n if (hidden) clearTimeout(this.#timer);\n else if (was && this.#state !== \"initializing\") void this.forceRefresh();\n }\n\n async #eval<T>(key: string, def: T, user: User | null | undefined, json: boolean): Promise<EvaluationDetails<T>> {\n await this.#ensure();\n return this.#evaluated(resolve(this.#config, key, def, user ?? this.#user, json, this.#layer()));\n }\n\n #stop(): void {\n clearTimeout(this.#timer);\n this.#abort?.abort();\n }\n\n async #start(): Promise<void> {\n // Let the caller attach listeners (`ready`, `error`) before anything is reported.\n await 0;\n const ov = this.#o.overrides;\n if (ov && \"file\" in ov) {\n const apply = (values: Obj | null): void => {\n if (values) this.#setOverrides(values);\n this.#recompute(true);\n };\n this.#unwatch = await fileOverrides(ov.file, ov.watch, apply, (m, e) => this.#error(\"overrides\", m, e), () => this.#closed);\n }\n await this.#readCache();\n if (this.#closed) {\n /* closed during start-up */\n } else if (!this.#key) this.#state = \"ready\";\n else if (this.#offline) this.#state = \"offline\";\n else if (this.#mode === \"auto\" || (this.#mode === \"lazy\" && this.#expired())) {\n await this.#deadline(this.forceRefresh(), this.#initWait);\n this.#schedule();\n }\n this.#emit(\"ready\", this.#state);\n }\n\n async #deadline(p: Promise<void>, ms: number): Promise<void> {\n let t;\n await Promise.race([p, new Promise((ok) => (t = unref(setTimeout(ok, ms))))]);\n clearTimeout(t);\n }\n\n async #ensure(): Promise<void> {\n if (this.#state === \"initializing\") await this.#init;\n if (this.#mode === \"lazy\" && this.#key && !this.#offline && !this.#closed && this.#expired()) {\n const p = this.#fetchNow();\n if (!this.#remote) await this.#deadline(p, this.#timeout);\n }\n }\n\n #expired(): boolean {\n return Date.now() - this.#fetchedAt >= this.#interval;\n }\n\n #fetchNow(): Promise<void> {\n return (this.#inflight ??= this.#download().finally(() => (this.#inflight = null)));\n }\n\n /** Auto polling: the next download after the jittered interval, later after errors (at most 4x) or when the server asks (Retry-After). */\n #schedule(): void {\n clearTimeout(this.#timer);\n if (this.#closed || this.#offline || this.#hidden || this.#mode !== \"auto\" || !this.#key) return;\n const i = this.#interval;\n let delay = i * (0.9 + 0.2 * Math.random());\n if (this.#failures) delay = Math.min(4 * i, delay + backoffMs(this.#failures));\n delay = Math.max(delay, this.#retryAfter);\n this.#timer = unref(setTimeout(() => void this.forceRefresh(), delay));\n }\n\n async #download(): Promise<void> {\n if (this.#closed || this.#offline || !this.#key) return;\n this.#retryAfter = 0;\n let failure: [FlagsClientErrorCode, string, unknown?] = [\"network\", \"download failed\"];\n for (const base of this.#bases) {\n const abort = (this.#abort = new AbortController());\n const timer = setTimeout(() => abort.abort(), this.#timeout);\n try {\n const headers = deliveryHeaders(this.#etag);\n const res = await this.#fetch(`${base}/v1/configs/${encodeURIComponent(this.#key)}/config.json`, { headers, signal: abort.signal });\n if (res.status < 500) return await this.#handle(res);\n cancel(res);\n failure = [\"http_status\", `download failed: HTTP ${res.status}`];\n } catch (e) {\n if (this.#closed || this.#offline) return;\n // The message never carries the URL: it holds the SDK key.\n failure = [\"network\", `download failed: ${abort.signal.aborted ? \"timeout\" : (e as Error)?.name}`, e];\n } finally {\n clearTimeout(timer);\n }\n }\n this.#failed(...failure);\n }\n\n async #handle(res: Response): Promise<void> {\n const status = res.status;\n if (status === 304) return this.#succeeded();\n if (status !== 200) {\n cancel(res);\n this.#retryAfter = parseRetryAfterMs(res.headers, Date.now()) ?? 0;\n if (status !== 404) return this.#failed(status === 429 ? \"rate_limited\" : \"http_status\", `download failed: HTTP ${status}`);\n this.#failed(\"key_invalid\", \"SDK key unknown, revoked or expired (404)\");\n if (!this.#closed && !this.#offline) this.#state = \"key_invalid\";\n return;\n }\n // Read with a byte cap: anything over 2 MiB is refused before it is parsed.\n const tooBig = (): void => this.#failed(\"too_large\", \"config over 2 MiB refused\");\n if (Number(res.headers.get(\"content-length\")) > MAX_CONFIG_BYTES) return cancel(res), tooBig();\n const reader = res.body?.getReader();\n const decoder = new TextDecoder();\n let text = \"\";\n let size = 0;\n for (let r; reader && !(r = await reader.read()).done; ) {\n if ((size += r.value.byteLength) > MAX_CONFIG_BYTES) return void reader.cancel().catch(() => undefined), tooBig();\n text += decoder.decode(r.value, { stream: true });\n }\n if (this.#adopt(text + decoder.decode(), \"fetch\", res.headers.get(\"etag\"), Date.now()) !== false) this.#succeeded();\n }\n\n #succeeded(): void {\n this.#failures = 0;\n this.#fetchedAt = Date.now();\n if (!this.#closed && !this.#offline) this.#state = \"ready\";\n }\n\n #failed(code: FlagsClientErrorCode, message: string, cause?: unknown): void {\n this.#failures++;\n // `stale` promises an older config is being served; with none held, say so instead.\n if (!this.#closed && !this.#offline) this.#state = this.#remote ? \"stale\" : \"unavailable\";\n this.#error(code, message, cause);\n }\n\n /**\n * Takes a config from any source when it is newer than the one held (never an older revision within a\n * generation). Returns false when the body was rejected, true when taken, undefined when older.\n */\n #adopt(input: string | object, source: ConfigSource, etag: string | null, fetchedAt: number): boolean | undefined {\n const fetched = source === \"fetch\";\n let raw: Obj;\n let parsed: ParsedConfig;\n try {\n raw = (typeof input === \"string\" ? JSON.parse(input) : input) as Obj;\n parsed = parseConfig(raw);\n } catch (e) {\n const args = [e instanceof ConfigParseError ? e.code : \"PARSE_ERROR\", `${source} config rejected: ${(e as Error).message}`, e] as const;\n if (fetched) this.#failed(...args);\n else this.#error(...args);\n return false;\n }\n if (!isNewerConfig(this.#remote, parsed)) return undefined;\n this.#remote = parsed;\n this.#remoteRaw = raw;\n this.#source = source;\n this.#etag = etag;\n this.#fetchedAt = fetchedAt;\n if (!this.#fixedBase) {\n const hinted = deliveryOrigins(parsed.delivery?.baseUrls ?? [], (m) => this.#warn(m, m));\n this.#bases = hinted.length ? hinted : [DEFAULT_BASE];\n }\n this.#recompute(true);\n if (fetched) void this.#writeCache(input as string);\n return true;\n }\n\n #setOverrides(values: Obj): void {\n this.#overrideValues = values;\n const { settings, skipped } = overrideSettings(values, (k) => this.#remote?.settingType(k));\n if (skipped.length) this.#error(\"overrides\", `overrides skipped: ${skipped}`);\n this.#overrides = settings;\n }\n\n /** Rebuilds the evaluated config from the remote one and the overrides. */\n #recompute(emit: boolean): void {\n const raw = combine(this.#remoteRaw, this.#overrides, this.#behaviour);\n let parsed = this.#remote;\n try {\n if (raw && raw !== this.#remoteRaw) parsed = parseConfig(raw);\n } catch (e) {\n this.#error(\"overrides\", `overrides rejected: ${(e as Error).message}`, e);\n }\n this.#config = raw ? parsed : null;\n this.#configRaw = parsed === this.#remote ? this.#remoteRaw : raw;\n this.#warned.clear();\n if (emit && parsed) {\n const source = this.#overrides && (this.#behaviour === \"local_only\" || !this.#remote) ? \"overrides\" : this.#source;\n this.#emit(\"configChanged\", { revision: parsed.revision, generation: parsed.generation, source });\n }\n }\n\n #cacheKey(): string {\n return `productcraft-flags:v1:${hashConfidential(this.#key!, \"\", \"cache-key\").slice(0, 32)}`;\n }\n\n async #readCache(): Promise<void> {\n const cache = this.#o.cache;\n if (!cache || !this.#key) return;\n try {\n const entry = await cache.get(this.#cacheKey());\n if (!entry) return;\n const { config, etag, fetched_at } = JSON.parse(entry) as { config: string; etag: string | null; fetched_at: number };\n this.#adopt(config, \"cache\", etag ?? null, Number(fetched_at) || 0);\n } catch (e) {\n this.#error(\"cache\", \"cache read failed\", e);\n }\n }\n\n async #writeCache(text: string): Promise<void> {\n try {\n await this.#o.cache?.set(this.#cacheKey(), JSON.stringify({ config: text, etag: this.#etag, fetched_at: this.#fetchedAt }));\n } catch (e) {\n this.#error(\"cache\", \"cache write failed\", e);\n }\n }\n\n #layer(): Layer {\n if (this.#source === \"cache\" || this.#source === \"bootstrap\") return this.#state === \"ready\" ? null : \"CACHED\";\n return this.#state === \"stale\" || this.#state === \"key_invalid\" ? \"STALE\" : null;\n }\n\n #evaluated<T>(d: EvaluationDetails<T>): EvaluationDetails<T> {\n for (const w of d.warnings) this.#warn(`${d.revision}|${w.key}|${w.code}`, `flag ${JSON.stringify(w.key)} (${w.code}): ${w.message}`);\n this.#emit(\"evaluated\", d as EvaluationDetails<unknown>);\n return d;\n }\n\n /** Logs once per id (evaluation warnings: once per key, code and revision); id null logs always. A broken logger never breaks evaluation. */\n #warn(id: string | null, message: string): void {\n if (id !== null && this.#warned.has(id)) return;\n if (id !== null) this.#warned.add(id);\n try {\n this.#log?.warn(`[productcraft/flags] ${message}`);\n } catch {\n /* ignore */\n }\n }\n\n /** Emits `error`; logs it when nobody listens. */\n #error(code: FlagsClientErrorCode, message: string, cause?: unknown): void {\n if (!this.#on.error.size) this.#warn(null, message);\n this.#emit(\"error\", new FlagsClientError(code, message, cause === undefined ? undefined : { cause }));\n }\n\n #emit<E extends keyof FlagsClientEvents>(event: E, arg: Parameters<FlagsClientEvents[E]>[0]): void {\n for (const listener of this.#on[event]) {\n try {\n (listener as (a: typeof arg) => void)(arg);\n } catch (e) {\n if (event !== \"error\") this.#error(\"listener\", `a ${event} listener threw`, e);\n }\n }\n }\n\n static {\n setOverride = (client, key, value) => {\n client.#setOverrides(put({ ...client.#overrideValues }, key, value));\n client.#recompute(true);\n };\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { ProductCraftError, ConfigurationError, backoffMs, isBrowser, runtimeTag, parseRetryAfterMs, readEnv } from '@productcraft/core';
1
+ import { ProductCraftError, ConfigurationError, backoffMs, parseRetryAfterMs, isBrowser } from '@productcraft/core';
2
2
  import { parseConfig, ConfigParseError, isNewerConfig, hashConfidential, evaluate } from '@productcraft/flags-engine';
3
3
 
4
4
  // src/client/client.ts
@@ -29,16 +29,6 @@ function isWellFormedSdkKey(key) {
29
29
  // src/client/overrides.ts
30
30
  var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
31
31
  var put = (o, k, v) => Object.defineProperty(o, k, { value: v, enumerable: true, writable: true, configurable: true });
32
- function parseOverrideText(text, source) {
33
- let doc;
34
- try {
35
- doc = JSON.parse(text);
36
- } catch (e) {
37
- throw new Error(`${source}: ${e.message}`);
38
- }
39
- if (!isObj(doc)) throw new Error(`${source}: not a JSON object`);
40
- return doc;
41
- }
42
32
  function toSetting(value, remote) {
43
33
  if (typeof value === "boolean") return { type: "boolean", value };
44
34
  if (typeof value === "string") return remote === "json" ? { type: "json", value } : { type: "string", value };
@@ -76,16 +66,24 @@ function combine(remote, overrides, behaviour) {
76
66
  for (const k of Object.keys(second)) put(settings, k, second[k]);
77
67
  return { ...remote, settings };
78
68
  }
79
- var envText = (name) => readEnv(name);
80
- async function readText(path) {
81
- const fs = await import('node:fs/promises');
82
- return fs.readFile(path, "utf8");
69
+ var NODE_ONLY = "overrides.file and overrides.env are Node-only; use overrides.values in a browser";
70
+ function deliveryHeaders(etag) {
71
+ return etag && !isBrowser() ? { Accept: "application/json", "If-None-Match": etag } : { Accept: "application/json" };
72
+ }
73
+ function envOverrides(_name) {
74
+ throw new Error(NODE_ONLY);
75
+ }
76
+ async function fileOverrides(_path, _watch, _apply, report) {
77
+ report(NODE_ONLY);
78
+ return void 0;
83
79
  }
84
- async function watchFile(path, onChange) {
85
- const fs = await import('node:fs');
86
- const watcher = fs.watch(path, { persistent: false }, () => onChange());
87
- watcher.on("error", () => void 0);
88
- return () => watcher.close();
80
+ function watchVisibility(onChange) {
81
+ const d = globalThis.document;
82
+ if (!d?.addEventListener) return void 0;
83
+ const listener = () => onChange(d.visibilityState === "hidden");
84
+ listener();
85
+ d.addEventListener("visibilitychange", listener);
86
+ return () => d.removeEventListener("visibilitychange", listener);
89
87
  }
90
88
  var fail = (base, def, code, message) => ({
91
89
  ...base,
@@ -147,7 +145,6 @@ function toValues(details) {
147
145
  }
148
146
 
149
147
  // src/client/client.ts
150
- var VERSION = "0.1.0" ;
151
148
  var DEFAULT_BASE = "https://api.flags.productcraft.co";
152
149
  var MAX_CONFIG_BYTES = 2 * 1024 * 1024;
153
150
  var FlagsClientError = class extends ProductCraftError {
@@ -245,7 +242,10 @@ var FlagsClient = class {
245
242
  #abort = null;
246
243
  #offline;
247
244
  #closed = false;
245
+ /** Browser build: the page is hidden, so auto polling waits for it to come back (6.3, task 019). */
246
+ #hidden = false;
248
247
  #unwatch;
248
+ #unwatchVisibility;
249
249
  #init;
250
250
  constructor(options = {}) {
251
251
  const o = this.#o = options;
@@ -274,8 +274,15 @@ var FlagsClient = class {
274
274
  this.#initWait = Math.max(0, (p.mode === "auto" ? p.maxInitWaitSeconds : void 0) ?? 5) * 1e3;
275
275
  if (o.bootstrap !== void 0) this.#adopt(o.bootstrap, "bootstrap", null, 0);
276
276
  if (ov && "values" in ov) this.#setOverrides(ov.values);
277
- else if (ov && "env" in ov) this.#overrideText(() => envText(ov.env) ?? "{}", `$${ov.env}`);
277
+ else if (ov && "env" in ov) {
278
+ try {
279
+ this.#setOverrides(envOverrides(ov.env));
280
+ } catch (e) {
281
+ this.#error("overrides", e.message, e);
282
+ }
283
+ }
278
284
  this.#recompute(false);
285
+ if (this.#mode === "auto" && this.#key) this.#unwatchVisibility = watchVisibility((hidden) => this.#visibility(hidden));
279
286
  this.#init = this.#start();
280
287
  }
281
288
  /** `initializing`, `ready`, `stale`, `key_invalid`, `offline` or `closed`. */
@@ -346,6 +353,14 @@ var FlagsClient = class {
346
353
  this.#state = "closed";
347
354
  this.#stop();
348
355
  this.#unwatch?.();
356
+ this.#unwatchVisibility?.();
357
+ }
358
+ /** Hidden: no further polls (a download in flight finishes). Visible again: download now, then poll as usual. */
359
+ #visibility(hidden) {
360
+ const was = this.#hidden;
361
+ this.#hidden = hidden;
362
+ if (hidden) clearTimeout(this.#timer);
363
+ else if (was && this.#state !== "initializing") void this.forceRefresh();
349
364
  }
350
365
  async #eval(key, def, user, json) {
351
366
  await this.#ensure();
@@ -359,13 +374,11 @@ var FlagsClient = class {
359
374
  await 0;
360
375
  const ov = this.#o.overrides;
361
376
  if (ov && "file" in ov) {
362
- await this.#loadFile(ov.file);
363
- try {
364
- if (ov.watch && !this.#closed) this.#unwatch = await watchFile(ov.file, () => void this.#loadFile(ov.file));
365
- if (this.#closed) this.#unwatch?.();
366
- } catch (e) {
367
- this.#error("overrides", "overrides file watch failed", e);
368
- }
377
+ const apply = (values) => {
378
+ if (values) this.#setOverrides(values);
379
+ this.#recompute(true);
380
+ };
381
+ this.#unwatch = await fileOverrides(ov.file, ov.watch, apply, (m, e) => this.#error("overrides", m, e));
369
382
  }
370
383
  await this.#readCache();
371
384
  if (this.#closed) ; else if (!this.#key) this.#state = "ready";
@@ -397,7 +410,7 @@ var FlagsClient = class {
397
410
  /** Auto polling: the next download after the jittered interval, later after errors (at most 4x) or when the server asks (Retry-After). */
398
411
  #schedule() {
399
412
  clearTimeout(this.#timer);
400
- if (this.#closed || this.#offline || this.#mode !== "auto" || !this.#key) return;
413
+ if (this.#closed || this.#offline || this.#hidden || this.#mode !== "auto" || !this.#key) return;
401
414
  const i = this.#interval;
402
415
  let delay = i * (0.9 + 0.2 * Math.random());
403
416
  if (this.#failures) delay = Math.min(4 * i, delay + backoffMs(this.#failures));
@@ -412,11 +425,7 @@ var FlagsClient = class {
412
425
  const abort = this.#abort = new AbortController();
413
426
  const timer = setTimeout(() => abort.abort(), this.#timeout);
414
427
  try {
415
- const headers = { Accept: "application/json" };
416
- if (!isBrowser()) {
417
- headers["User-Agent"] = `productcraft-node/flags/${VERSION} ${runtimeTag()}`;
418
- if (this.#etag) headers["If-None-Match"] = this.#etag;
419
- }
428
+ const headers = deliveryHeaders(this.#etag);
420
429
  const res = await this.#fetch(`${base}/v1/configs/${encodeURIComponent(this.#key)}/config.json`, { headers, signal: abort.signal });
421
430
  if (res.status < 500) return await this.#handle(res);
422
431
  cancel(res);
@@ -460,7 +469,7 @@ var FlagsClient = class {
460
469
  }
461
470
  #failed(code, message, cause) {
462
471
  this.#failures++;
463
- if (!this.#closed && !this.#offline) this.#state = "stale";
472
+ if (!this.#closed && !this.#offline) this.#state = this.#remote ? "stale" : "unavailable";
464
473
  this.#error(code, message, cause);
465
474
  }
466
475
  /**
@@ -500,22 +509,6 @@ var FlagsClient = class {
500
509
  if (skipped.length) this.#error("overrides", `overrides skipped: ${skipped}`);
501
510
  this.#overrides = settings;
502
511
  }
503
- #overrideText(read, source) {
504
- try {
505
- this.#setOverrides(parseOverrideText(read(), source));
506
- } catch (e) {
507
- this.#error("overrides", e.message, e);
508
- }
509
- }
510
- async #loadFile(path) {
511
- try {
512
- const text = await readText(path);
513
- this.#overrideText(() => text, "the overrides file");
514
- this.#recompute(true);
515
- } catch (e) {
516
- this.#error("overrides", "overrides file unreadable", e);
517
- }
518
- }
519
512
  /** Rebuilds the evaluated config from the remote one and the overrides. */
520
513
  #recompute(emit) {
521
514
  const raw = combine(this.#remoteRaw, this.#overrides, this.#behaviour);
@@ -596,5 +589,5 @@ var FlagsClient = class {
596
589
  };
597
590
 
598
591
  export { FlagsClient, FlagsClientError, FlagsSnapshot, MAX_CONFIG_BYTES, setOverride };
599
- //# sourceMappingURL=chunk-UI25HRYK.js.map
600
- //# sourceMappingURL=chunk-UI25HRYK.js.map
592
+ //# sourceMappingURL=chunk-72WU42RU.js.map
593
+ //# sourceMappingURL=chunk-72WU42RU.js.map