@productcraft/flags 0.4.0 → 0.5.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 (52) hide show
  1. package/README.md +35 -0
  2. package/api.md +5 -16
  3. package/dist/{chunk-7237IZU3.js → browser/chunk-OOX7EUCT.js} +8 -19
  4. package/dist/browser/chunk-OOX7EUCT.js.map +1 -0
  5. package/dist/browser/{chunk-72WU42RU.js → chunk-WUZAG2E3.js} +11 -4
  6. package/dist/browser/chunk-WUZAG2E3.js.map +1 -0
  7. package/dist/browser/{chunk-CXYODDHM.cjs → chunk-XZK57G7L.cjs} +8 -19
  8. package/dist/browser/chunk-XZK57G7L.cjs.map +1 -0
  9. package/dist/browser/{chunk-4XCQBTYE.cjs → chunk-YM5K4NHA.cjs} +11 -4
  10. package/dist/browser/chunk-YM5K4NHA.cjs.map +1 -0
  11. package/dist/browser/index.cjs +8 -8
  12. package/dist/browser/index.js +2 -2
  13. package/dist/browser/management.cjs +2 -2
  14. package/dist/browser/management.js +1 -1
  15. package/dist/browser/testing.cjs +3 -3
  16. package/dist/browser/testing.cjs.map +1 -1
  17. package/dist/browser/testing.js +1 -1
  18. package/dist/browser/testing.js.map +1 -1
  19. package/dist/{chunk-NB7OGN6R.js → chunk-CGVDMKEE.js} +12 -5
  20. package/dist/chunk-CGVDMKEE.js.map +1 -0
  21. package/dist/{chunk-Q3P66XRI.cjs → chunk-L3AOANTB.cjs} +12 -5
  22. package/dist/chunk-L3AOANTB.cjs.map +1 -0
  23. package/dist/{chunk-NSAKFGTJ.cjs → chunk-RJIVAOBG.cjs} +8 -19
  24. package/dist/{browser/chunk-CXYODDHM.cjs.map → chunk-RJIVAOBG.cjs.map} +1 -1
  25. package/dist/{browser/chunk-TCVKCN3S.js → chunk-XNJ5OX4X.js} +8 -19
  26. package/dist/{browser/chunk-TCVKCN3S.js.map → chunk-XNJ5OX4X.js.map} +1 -1
  27. package/dist/{client-K2zALPGD.d.cts → client-BBiIKiGW.d.cts} +18 -14
  28. package/dist/{client-K2zALPGD.d.ts → client-BBiIKiGW.d.ts} +18 -14
  29. package/dist/{client-BwoMpm8_.d.cts → client-BWi7PASW.d.cts} +94 -33
  30. package/dist/{client-BwoMpm8_.d.ts → client-BWi7PASW.d.ts} +94 -33
  31. package/dist/index.cjs +8 -8
  32. package/dist/index.d.cts +3 -3
  33. package/dist/index.d.ts +3 -3
  34. package/dist/index.js +2 -2
  35. package/dist/management.cjs +2 -2
  36. package/dist/management.d.cts +1 -1
  37. package/dist/management.d.ts +1 -1
  38. package/dist/management.js +1 -1
  39. package/dist/testing.cjs +3 -3
  40. package/dist/testing.cjs.map +1 -1
  41. package/dist/testing.d.cts +3 -3
  42. package/dist/testing.d.ts +3 -3
  43. package/dist/testing.js +1 -1
  44. package/dist/testing.js.map +1 -1
  45. package/manifest.json +1 -1
  46. package/package.json +2 -2
  47. package/dist/browser/chunk-4XCQBTYE.cjs.map +0 -1
  48. package/dist/browser/chunk-72WU42RU.js.map +0 -1
  49. package/dist/chunk-7237IZU3.js.map +0 -1
  50. package/dist/chunk-NB7OGN6R.js.map +0 -1
  51. package/dist/chunk-NSAKFGTJ.cjs.map +0 -1
  52. package/dist/chunk-Q3P66XRI.cjs.map +0 -1
@@ -220,6 +220,8 @@ var FlagsClient = class {
220
220
  #behaviour;
221
221
  #on = { ready: /* @__PURE__ */ new Set(), configChanged: /* @__PURE__ */ new Set(), evaluated: /* @__PURE__ */ new Set(), error: /* @__PURE__ */ new Set() };
222
222
  #warned = /* @__PURE__ */ new Set();
223
+ /** Evaluation warnings already logged; never cleared, so a soft miss logs once per client. */
224
+ #warnedEval = /* @__PURE__ */ new Set();
223
225
  #state = "initializing";
224
226
  #source = "none";
225
227
  /** The downloaded (or cached / bootstrap) config, parsed and as JSON for combining with overrides. */
@@ -553,11 +555,16 @@ var FlagsClient = class {
553
555
  return this.#state === "stale" || this.#state === "key_invalid" ? "STALE" : null;
554
556
  }
555
557
  #evaluated(d) {
556
- for (const w of d.warnings) this.#warn(`${d.revision}|${w.key}|${w.code}`, `flag ${JSON.stringify(w.key)} (${w.code}): ${w.message}`);
558
+ for (const w of d.warnings) {
559
+ const id = `eval|${w.code}|${w.attribute ?? `key:${w.key}`}`;
560
+ if (this.#warnedEval.has(id)) continue;
561
+ this.#warnedEval.add(id);
562
+ this.#warn(null, `flag ${JSON.stringify(w.key)} (${w.code}): ${w.message} (logged once per ${w.attribute ? "attribute" : "flag"}; see getValueDetails().warnings)`);
563
+ }
557
564
  this.#emit("evaluated", d);
558
565
  return d;
559
566
  }
560
- /** Logs once per id (evaluation warnings: once per key, code and revision); id null logs always. A broken logger never breaks evaluation. */
567
+ /** Logs once per id (cleared when the config changes); id null logs always. A broken logger never breaks evaluation. */
561
568
  #warn(id, message) {
562
569
  if (id !== null && this.#warned.has(id)) return;
563
570
  if (id !== null) this.#warned.add(id);
@@ -589,5 +596,5 @@ var FlagsClient = class {
589
596
  };
590
597
 
591
598
  export { FlagsClient, FlagsClientError, FlagsSnapshot, MAX_CONFIG_BYTES, setOverride };
592
- //# sourceMappingURL=chunk-72WU42RU.js.map
593
- //# sourceMappingURL=chunk-72WU42RU.js.map
599
+ //# sourceMappingURL=chunk-WUZAG2E3.js.map
600
+ //# sourceMappingURL=chunk-WUZAG2E3.js.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":[],"mappings":"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","file":"chunk-WUZAG2E3.js","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 UserInput } 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: UserInput | 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: UserInput | 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 UserInput } 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: UserInput | undefined;\n readonly #layer: Layer;\n /** @internal */\n constructor(config: ParsedConfig | null, raw: Obj | null, user: UserInput | 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?: UserInput | null): FlagValue<D> {\n return this.getValueDetails(key, defaultValue, user).value;\n }\n getValueDetails<D extends Def>(key: string, defaultValue: D, user?: UserInput | 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?: UserInput | null): T {\n return resolve(this.#c, key, defaultValue, user ?? this.#user, true, this.#layer).value;\n }\n getAllValues(user?: UserInput | 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 /** Evaluation warnings already logged; never cleared, so a soft miss logs once per client. */\n readonly #warnedEval = 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: UserInput | 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: UserInput | 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?: UserInput | 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?: UserInput | 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?: UserInput | 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?: UserInput | 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: UserInput | 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) {\n // Soft misses are expected for some users (anonymous traffic has no email): log each code once per\n // attribute (or key) for the life of the client. `getValueDetails().warnings` still has every one.\n const id = `eval|${w.code}|${w.attribute ?? `key:${w.key}`}`;\n if (this.#warnedEval.has(id)) continue;\n this.#warnedEval.add(id);\n this.#warn(null, `flag ${JSON.stringify(w.key)} (${w.code}): ${w.message} (logged once per ${w.attribute ? \"attribute\" : \"flag\"}; see getValueDetails().warnings)`);\n }\n this.#emit(\"evaluated\", d as EvaluationDetails<unknown>);\n return d;\n }\n\n /** Logs once per id (cleared when the config changes); 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"]}
@@ -1040,12 +1040,12 @@ var SegmentsResource = class extends APIResource {
1040
1040
  /**
1041
1041
  * Update a segment
1042
1042
  *
1043
- * Key, name, description or conditions; only the fields you send change. Edit a confidential list with `list_id` plus `values_add` / `values_remove`. A segment used in a protected environment also needs `flags.protected.update` there.
1043
+ * Key, name, description or conditions; only the fields you send change. To add or remove values in one list condition without re-sending the others, send `condition_edits` (with the `version` you read). Edit a confidential list with `list_id` plus `values_add` / `values_remove`, or with `condition_edits`. A segment used in a protected environment also needs `flags.protected.update` there.
1044
1044
  *
1045
1045
  * @param segmentId - Id of the segment.
1046
1046
  * @param params - `Flags.SegmentUpdateParams`.
1047
1047
  * @param options - Per-request options.
1048
- * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `VALIDATION_ERROR`: a field is invalid.
1048
+ * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `VALIDATION_ERROR`: a field is invalid, an edit has no values, or both `conditions` and `condition_edits` were sent.
1049
1049
  * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token (`UNAUTHORIZED`). Send a workspace API key or a platform session token as `Authorization: Bearer <token>`.
1050
1050
  * @throws {PermissionDeniedError} 403 FORBIDDEN, SERVICE_NOT_ENABLED: The caller lacks the action this route needs (`message` names it), or the workspace has not enabled Flags (`SERVICE_NOT_ENABLED`). A segment used in a protected environment also needs `flags.protected.update` on it.
1051
1051
  * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: `SEGMENT_NOT_FOUND`: no such segment in this workspace.
@@ -1057,18 +1057,7 @@ var SegmentsResource = class extends APIResource {
1057
1057
  * @see https://productcraft.co/docs/flags/api-reference#patch-v1-workspaces-workspace-id-segments-segment-id
1058
1058
  * @example
1059
1059
  * ```ts
1060
- * const segmentDetail = await flags.segments.update("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", {
1061
- * conditions: [
1062
- * {
1063
- * user: {
1064
- * attribute: "email",
1065
- * comparator: "ends_with_any_hashed",
1066
- * list_id: "3f0c6a3e-0f5e-4b8e-9d1a-2c7b9f1e8a10",
1067
- * values_add: ["@beta.test"],
1068
- * },
1069
- * },
1070
- * ],
1071
- * });
1060
+ * const segmentDetail = await flags.segments.update("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", { condition_edits: [{ condition_index: 0, values_add: ["qa-bot@example.com"] }] });
1072
1061
  * ```
1073
1062
  */
1074
1063
  update(segmentId, params, options) {
@@ -1153,13 +1142,13 @@ var SettingsValuesResource = class extends APIResource {
1153
1142
  /**
1154
1143
  * Update a value
1155
1144
  *
1156
- * The quick edits: `value` (the toggle), `percentage_attribute`, and `clear_rules: true` to drop every rule and split so `value` is served to everyone (the kill switch). Send the `version` you read.
1145
+ * The quick edits: `value` (the toggle), `percentage_attribute`, `rule_edits` to add or remove values in a list condition of an existing rule (a tester, a QA account) without re-sending the other rules, and `clear_rules: true` to drop every rule and split so `value` is served to everyone (the kill switch). Send the `version` you read. A protected environment needs `flags.protected.update`; one change and one revision per request, none when nothing changed.
1157
1146
  *
1158
1147
  * @param settingId - Id of the setting.
1159
1148
  * @param environmentId - Id of an environment of the same project.
1160
1149
  * @param params - `Flags.SettingsValueUpdateParams`.
1161
1150
  * @param options - Per-request options.
1162
- * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `VALIDATION_ERROR`: nothing to change, or `version` is missing.
1151
+ * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `VALIDATION_ERROR`: nothing to change, `version` is missing, an edit has no values, or `rule_edits` sent with `clear_rules`.
1163
1152
  * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token (`UNAUTHORIZED`). Send a workspace API key or a platform session token as `Authorization: Bearer <token>`.
1164
1153
  * @throws {PermissionDeniedError} 403 FORBIDDEN, SERVICE_NOT_ENABLED: The caller lacks the action this route needs (`message` names it), or the workspace has not enabled Flags (`SERVICE_NOT_ENABLED`). Value writes need `flags.value.update` on the environment and the setting, plus `flags.protected.update` in a protected environment.
1165
1154
  * @throws {NotFoundError} 404 NOT_FOUND, SETTING_NOT_FOUND, ENVIRONMENT_NOT_FOUND: `SETTING_NOT_FOUND` or `ENVIRONMENT_NOT_FOUND`.
@@ -1646,7 +1635,7 @@ var WebhookEventStatus = { values: ["pending", "delivered", "failed", "not_sent"
1646
1635
  var WebhookEventType = { values: ["config.published", "sdk_key.rotated"] };
1647
1636
 
1648
1637
  // src/_generated/client.ts
1649
- var VERSION = "0.4.0" ;
1638
+ var VERSION = "0.5.0" ;
1650
1639
  exports.Flags = class Flags extends FlagsResources {
1651
1640
  constructor(options = {}) {
1652
1641
  super(new core.APIClient(options, core.PC_BASE_URL.flags, { name: "flags", version: VERSION }));
@@ -1683,5 +1672,5 @@ exports.Flags = class Flags extends FlagsResources {
1683
1672
  Flags2.WebhookEventStatus = WebhookEventStatus;
1684
1673
  Flags2.WebhookEventType = WebhookEventType;
1685
1674
  })(exports.Flags || (exports.Flags = {}));
1686
- //# sourceMappingURL=chunk-CXYODDHM.cjs.map
1687
- //# sourceMappingURL=chunk-CXYODDHM.cjs.map
1675
+ //# sourceMappingURL=chunk-XZK57G7L.cjs.map
1676
+ //# sourceMappingURL=chunk-XZK57G7L.cjs.map