@productcraft/flags 0.0.0 → 0.1.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.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/client/key.ts","../src/client/overrides.ts","../src/client/platform.ts","../src/client/resolve.ts","../src/client/client.ts"],"names":["readEnv","evaluate","ProductCraftError","setOverride","ConfigurationError","backoffMs","isBrowser","runtimeTag","parseRetryAfterMs","parseConfig","ConfigParseError","isNewerConfig","hashConfidential"],"mappings":"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","file":"chunk-ZL3B6RIH.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","// The Node-only parts of FlagsClient: override files (read and watch) and environment variables.\n// Everything Node-specific sits behind this one module, so a browser entry (task 019) can swap it out.\n// `node:fs` is imported lazily, only when a file override is configured, so the main entry loads on\n// runtimes without it (edge functions) as long as no file override is used.\n\nimport { readEnv } from \"@productcraft/core\";\n\n/** The text of an environment variable, or undefined (no `process`, unset, or empty). */\nexport const envText = (name: string): string | undefined => readEnv(name);\n\n/** Reads a UTF-8 file. */\nexport async function readText(path: string): Promise<string> {\n const fs = await import(\"node:fs/promises\");\n return fs.readFile(path, \"utf8\");\n}\n\n/** Calls `onChange` when the file changes; returns a function that stops watching. */\nexport async function watchFile(path: string, onChange: () => void): Promise<() => void> {\n const fs = await import(\"node:fs\");\n const watcher = fs.watch(path, { persistent: false }, () => onChange());\n watcher.on(\"error\", () => undefined);\n return () => watcher.close();\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, isBrowser, parseRetryAfterMs, ProductCraftError, runtimeTag, 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, parseOverrideText, put } from \"./overrides.js\";\nimport { envText, readText, watchFile } 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\ndeclare const __PC_SDK_VERSION__: string | undefined;\nconst VERSION = typeof __PC_SDK_VERSION__ === \"string\" ? __PC_SDK_VERSION__ : \"0.0.0-dev\";\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 #unwatch: (() => 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) this.#overrideText(() => envText(ov.env) ?? \"{}\", `$${ov.env}`);\n this.#recompute(false);\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 }\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 await this.#loadFile(ov.file);\n try {\n if (ov.watch && !this.#closed) this.#unwatch = await watchFile(ov.file, () => void this.#loadFile(ov.file));\n if (this.#closed) this.#unwatch?.();\n } catch (e) {\n this.#error(\"overrides\", \"overrides file watch failed\", e);\n }\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.#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: Record<string, string> = { Accept: \"application/json\" };\n // Browsers rely on their HTTP cache: a hand-set If-None-Match would force a CORS preflight (design 6.3).\n if (!isBrowser()) {\n headers[\"User-Agent\"] = `productcraft-node/flags/${VERSION} ${runtimeTag()}`;\n if (this.#etag) headers[\"If-None-Match\"] = this.#etag;\n }\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 if (!this.#closed && !this.#offline) this.#state = \"stale\";\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 #overrideText(read: () => string, source: string): void {\n try {\n this.#setOverrides(parseOverrideText(read(), source));\n } catch (e) {\n this.#error(\"overrides\", (e as Error).message, e);\n }\n }\n\n async #loadFile(path: string): Promise<void> {\n try {\n const text = await readText(path);\n this.#overrideText(() => text, \"the overrides file\");\n this.#recompute(true);\n } catch (e) {\n this.#error(\"overrides\", \"overrides file unreadable\", e);\n }\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"]}
@@ -0,0 +1,175 @@
1
+ import { Logger, ProductCraftError } from '@productcraft/core';
2
+ import { SettingValue, User, EvaluationDetails, ParsedConfig } from '@productcraft/flags-engine';
3
+
4
+ type Layer = "CACHED" | "STALE" | null;
5
+
6
+ /** Auto polling: fetch on a timer. Default 60 s, minimum 30 s, ±10% jitter. */
7
+ interface AutoPolling {
8
+ mode: "auto";
9
+ /** Seconds between polls. Default 60; values under 30 are raised to 30 with a warning. */
10
+ intervalSeconds?: number;
11
+ /** How long `getValue` and `waitForReady` wait for the first fetch before serving the cache, `bootstrap` or defaults. Default 5. */
12
+ maxInitWaitSeconds?: number;
13
+ }
14
+ /** Lazy polling: fetch on use once the config is older than `ttlSeconds`, serving the stale config meanwhile. No timers. */
15
+ interface LazyPolling {
16
+ mode: "lazy";
17
+ /** Default 60; values under 30 are raised to 30 with a warning. */
18
+ ttlSeconds?: number;
19
+ }
20
+ /** Manual polling: fetch only when you call `forceRefresh()`. */
21
+ interface ManualPolling {
22
+ mode: "manual";
23
+ }
24
+ type PollingOptions = AutoPolling | LazyPolling | ManualPolling;
25
+ /**
26
+ * A shared cache for the downloaded config (Redis, a KV store, a file), read once at start-up and written
27
+ * after every accepted download. Keys never contain the SDK key itself.
28
+ */
29
+ interface FlagsCache {
30
+ get(key: string): Promise<string | null | undefined> | string | null | undefined;
31
+ set(key: string, value: string): Promise<void> | void;
32
+ }
33
+ /**
34
+ * How overrides combine with the downloaded config.
35
+ * - `local_only`: only the overrides; nothing is downloaded.
36
+ * - `local_over_remote`: the overrides win for their keys; other keys come from the download.
37
+ * - `remote_over_local`: the download wins; overrides only fill keys it does not have.
38
+ */
39
+ type OverrideBehaviour = "local_only" | "local_over_remote" | "remote_over_local";
40
+ /** A value an override may hold. Objects, arrays and `null` become `json` settings. */
41
+ type OverrideValue = SettingValue | null | readonly unknown[] | {
42
+ [key: string]: unknown;
43
+ };
44
+ /** Overrides from one source: a map, a JSON file (Node only) or an environment variable (Node only) holding a JSON object. */
45
+ type FlagsOverrides = {
46
+ values: Record<string, OverrideValue>;
47
+ behaviour?: OverrideBehaviour;
48
+ } | {
49
+ file: string;
50
+ watch?: boolean;
51
+ behaviour?: OverrideBehaviour;
52
+ } | {
53
+ env: string;
54
+ behaviour?: OverrideBehaviour;
55
+ };
56
+ interface FlagsClientOptions {
57
+ /** The SDK key of one config and environment (`pcf_sdk_…`). Optional only with `local_only` overrides, or with `offline: true` and a `bootstrap` (the client then never downloads). */
58
+ sdkKey?: string;
59
+ /** Default `{ mode: "auto", intervalSeconds: 60, maxInitWaitSeconds: 5 }`. */
60
+ polling?: PollingOptions;
61
+ cache?: FlagsCache;
62
+ /** A config JSON (text or object) to use when nothing fresher is available: the last line of defence before your defaults. */
63
+ bootstrap?: string | object;
64
+ overrides?: FlagsOverrides;
65
+ /** The user evaluations are for when a call passes none. A call's own user replaces it as a whole. */
66
+ defaultUser?: User;
67
+ /** Where warnings and errors are logged. Default `console`. Pass `null` to log nothing. */
68
+ logger?: Logger | null;
69
+ /** Custom `fetch`. Defaults to the global `fetch`. */
70
+ fetch?: typeof fetch;
71
+ /** Delivery host. Defaults to `https://api.flags.productcraft.co`; when set, `delivery.base_urls` hints are ignored. */
72
+ baseUrl?: string;
73
+ /** Start without network access (the cache, `bootstrap` and overrides still apply). `setOnline()` starts fetching. */
74
+ offline?: boolean;
75
+ /** Per-request timeout in ms. Default 10 000. */
76
+ timeout?: number;
77
+ }
78
+ /**
79
+ * `initializing` until the first fetch settles; `ready` after a successful fetch or 304; `stale` when the last
80
+ * fetch failed and an older config is being served; `key_invalid` after a 404 (the key is unknown, revoked or
81
+ * expired: the held config is kept); `offline` after `setOffline()`; `closed` after `close()`.
82
+ */
83
+ type ClientState = "initializing" | "ready" | "stale" | "key_invalid" | "offline" | "closed";
84
+ /** Where the config in use came from. */
85
+ type ConfigSource = "fetch" | "cache" | "bootstrap" | "overrides" | "none";
86
+ interface ConfigChangedEvent {
87
+ revision: number;
88
+ generation: number;
89
+ source: ConfigSource;
90
+ }
91
+ type FlagsClientErrorCode = "network" | "http_status" | "too_large" | "PARSE_ERROR" | "UNSUPPORTED_SCHEMA" | "key_invalid" | "rate_limited" | "cache" | "overrides" | "evaluation" | "listener";
92
+ interface FlagsClientEvents {
93
+ ready: (state: ClientState) => void;
94
+ configChanged: (event: ConfigChangedEvent) => void;
95
+ evaluated: (details: EvaluationDetails<unknown>) => void;
96
+ error: (error: Error & {
97
+ code?: FlagsClientErrorCode;
98
+ }) => void;
99
+ }
100
+ /** The value `getValue` returns for a default: booleans, strings and numbers keep their type; objects, arrays and `null` get parsed json. */
101
+ type FlagValue<D> = D extends boolean ? boolean : D extends string ? string : D extends number ? number : D extends null ? unknown : D;
102
+
103
+ /** The SDK refuses a config body over 2 MiB before parsing it (the API caps configs at 1 MiB). */
104
+ declare const MAX_CONFIG_BYTES: number;
105
+ type Obj = Record<string, unknown>;
106
+ type Def = SettingValue | object | null;
107
+ /** A failure the client reports through the `error` event (it never throws them at callers). */
108
+ declare class FlagsClientError extends ProductCraftError {
109
+ static readonly brandName: string;
110
+ readonly code: FlagsClientErrorCode;
111
+ constructor(code: FlagsClientErrorCode, message: string, options?: {
112
+ cause?: unknown;
113
+ });
114
+ }
115
+ /** A frozen view of one config for synchronous evaluation (`flags.snapshot()`). */
116
+ declare class FlagsSnapshot {
117
+ #private;
118
+ /** @internal */
119
+ constructor(config: ParsedConfig | null, raw: Obj | null, user: User | undefined, layer: Layer);
120
+ /** Revision of the config, 0 when there is none. */
121
+ get revision(): number;
122
+ /** Generation of the config (bumped after a database restore), 0 when there is none. */
123
+ get generation(): number;
124
+ /** Setting keys in config order. */
125
+ keys(): string[];
126
+ getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): FlagValue<D>;
127
+ getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): EvaluationDetails<FlagValue<D>>;
128
+ getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): T;
129
+ getAllValues(user?: User | null): Record<string, unknown>;
130
+ /** The config JSON this snapshot evaluates (overrides included), or null: pass it as another client's `bootstrap`. */
131
+ toJSON(): Obj | null;
132
+ }
133
+ /**
134
+ * Feature flags and settings, evaluated locally.
135
+ *
136
+ * @example
137
+ * ```ts
138
+ * import { FlagsClient } from "@productcraft/flags";
139
+ * const flags = new FlagsClient({ sdkKey: process.env.PRODUCTCRAFT_FLAGS_SDK_KEY });
140
+ * const on = await flags.getValue("new_checkout", false, { identifier: "user-1" });
141
+ * ```
142
+ */
143
+ declare class FlagsClient {
144
+ #private;
145
+ constructor(options?: FlagsClientOptions);
146
+ /** `initializing`, `ready`, `stale`, `key_invalid`, `offline` or `closed`. */
147
+ get state(): ClientState;
148
+ /** Subscribe to `ready`, `configChanged`, `evaluated` or `error`. Returns a function that unsubscribes. */
149
+ on<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): () => void;
150
+ off<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): void;
151
+ /** The user evaluations use when a call passes none. */
152
+ setDefaultUser(user: User | undefined): void;
153
+ /** The value of a flag or setting for a user; the default on any failure. Never throws. */
154
+ getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<FlagValue<D>>;
155
+ /** The value plus why: reason, matched rule or split, error code, warnings and revision. Never throws. */
156
+ getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<EvaluationDetails<FlagValue<D>>>;
157
+ /** A json (or string) setting, parsed. A parse failure, a missing key or another type returns the default. Never throws. */
158
+ getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): Promise<T>;
159
+ /** Every setting's value for a user (json settings parsed), as a null-prototype object. Never throws. */
160
+ getAllValues(user?: User | null): Promise<Record<string, unknown>>;
161
+ /** The config as it is now, for synchronous evaluation. Does not wait for the first download. */
162
+ snapshot(): FlagsSnapshot;
163
+ /** Resolves when start-up has settled: the first download finished or `maxInitWaitSeconds` passed. Never rejects. */
164
+ waitForReady(): Promise<ClientState>;
165
+ /** Downloads the config now (any polling mode). Resolves when the attempt settles; never rejects. */
166
+ forceRefresh(): Promise<void>;
167
+ /** Stops all network access; evaluations keep using what is held. */
168
+ setOffline(): void;
169
+ /** Resumes network access after `setOffline()` (or the `offline` option). Auto polling fetches at once. */
170
+ setOnline(): void;
171
+ /** Stops timers, aborts a download in flight and stops watching an override file. Evaluations keep working on what is held. */
172
+ close(): void;
173
+ }
174
+
175
+ export { type AutoPolling as A, type ClientState as C, type FlagValue as F, type LazyPolling as L, MAX_CONFIG_BYTES as M, type OverrideBehaviour as O, type PollingOptions as P, type ConfigChangedEvent as a, type ConfigSource as b, type FlagsCache as c, FlagsClient as d, FlagsClientError as e, type FlagsClientErrorCode as f, type FlagsClientEvents as g, type FlagsClientOptions as h, type FlagsOverrides as i, FlagsSnapshot as j, type ManualPolling as k, type OverrideValue as l };
@@ -0,0 +1,175 @@
1
+ import { Logger, ProductCraftError } from '@productcraft/core';
2
+ import { SettingValue, User, EvaluationDetails, ParsedConfig } from '@productcraft/flags-engine';
3
+
4
+ type Layer = "CACHED" | "STALE" | null;
5
+
6
+ /** Auto polling: fetch on a timer. Default 60 s, minimum 30 s, ±10% jitter. */
7
+ interface AutoPolling {
8
+ mode: "auto";
9
+ /** Seconds between polls. Default 60; values under 30 are raised to 30 with a warning. */
10
+ intervalSeconds?: number;
11
+ /** How long `getValue` and `waitForReady` wait for the first fetch before serving the cache, `bootstrap` or defaults. Default 5. */
12
+ maxInitWaitSeconds?: number;
13
+ }
14
+ /** Lazy polling: fetch on use once the config is older than `ttlSeconds`, serving the stale config meanwhile. No timers. */
15
+ interface LazyPolling {
16
+ mode: "lazy";
17
+ /** Default 60; values under 30 are raised to 30 with a warning. */
18
+ ttlSeconds?: number;
19
+ }
20
+ /** Manual polling: fetch only when you call `forceRefresh()`. */
21
+ interface ManualPolling {
22
+ mode: "manual";
23
+ }
24
+ type PollingOptions = AutoPolling | LazyPolling | ManualPolling;
25
+ /**
26
+ * A shared cache for the downloaded config (Redis, a KV store, a file), read once at start-up and written
27
+ * after every accepted download. Keys never contain the SDK key itself.
28
+ */
29
+ interface FlagsCache {
30
+ get(key: string): Promise<string | null | undefined> | string | null | undefined;
31
+ set(key: string, value: string): Promise<void> | void;
32
+ }
33
+ /**
34
+ * How overrides combine with the downloaded config.
35
+ * - `local_only`: only the overrides; nothing is downloaded.
36
+ * - `local_over_remote`: the overrides win for their keys; other keys come from the download.
37
+ * - `remote_over_local`: the download wins; overrides only fill keys it does not have.
38
+ */
39
+ type OverrideBehaviour = "local_only" | "local_over_remote" | "remote_over_local";
40
+ /** A value an override may hold. Objects, arrays and `null` become `json` settings. */
41
+ type OverrideValue = SettingValue | null | readonly unknown[] | {
42
+ [key: string]: unknown;
43
+ };
44
+ /** Overrides from one source: a map, a JSON file (Node only) or an environment variable (Node only) holding a JSON object. */
45
+ type FlagsOverrides = {
46
+ values: Record<string, OverrideValue>;
47
+ behaviour?: OverrideBehaviour;
48
+ } | {
49
+ file: string;
50
+ watch?: boolean;
51
+ behaviour?: OverrideBehaviour;
52
+ } | {
53
+ env: string;
54
+ behaviour?: OverrideBehaviour;
55
+ };
56
+ interface FlagsClientOptions {
57
+ /** The SDK key of one config and environment (`pcf_sdk_…`). Optional only with `local_only` overrides, or with `offline: true` and a `bootstrap` (the client then never downloads). */
58
+ sdkKey?: string;
59
+ /** Default `{ mode: "auto", intervalSeconds: 60, maxInitWaitSeconds: 5 }`. */
60
+ polling?: PollingOptions;
61
+ cache?: FlagsCache;
62
+ /** A config JSON (text or object) to use when nothing fresher is available: the last line of defence before your defaults. */
63
+ bootstrap?: string | object;
64
+ overrides?: FlagsOverrides;
65
+ /** The user evaluations are for when a call passes none. A call's own user replaces it as a whole. */
66
+ defaultUser?: User;
67
+ /** Where warnings and errors are logged. Default `console`. Pass `null` to log nothing. */
68
+ logger?: Logger | null;
69
+ /** Custom `fetch`. Defaults to the global `fetch`. */
70
+ fetch?: typeof fetch;
71
+ /** Delivery host. Defaults to `https://api.flags.productcraft.co`; when set, `delivery.base_urls` hints are ignored. */
72
+ baseUrl?: string;
73
+ /** Start without network access (the cache, `bootstrap` and overrides still apply). `setOnline()` starts fetching. */
74
+ offline?: boolean;
75
+ /** Per-request timeout in ms. Default 10 000. */
76
+ timeout?: number;
77
+ }
78
+ /**
79
+ * `initializing` until the first fetch settles; `ready` after a successful fetch or 304; `stale` when the last
80
+ * fetch failed and an older config is being served; `key_invalid` after a 404 (the key is unknown, revoked or
81
+ * expired: the held config is kept); `offline` after `setOffline()`; `closed` after `close()`.
82
+ */
83
+ type ClientState = "initializing" | "ready" | "stale" | "key_invalid" | "offline" | "closed";
84
+ /** Where the config in use came from. */
85
+ type ConfigSource = "fetch" | "cache" | "bootstrap" | "overrides" | "none";
86
+ interface ConfigChangedEvent {
87
+ revision: number;
88
+ generation: number;
89
+ source: ConfigSource;
90
+ }
91
+ type FlagsClientErrorCode = "network" | "http_status" | "too_large" | "PARSE_ERROR" | "UNSUPPORTED_SCHEMA" | "key_invalid" | "rate_limited" | "cache" | "overrides" | "evaluation" | "listener";
92
+ interface FlagsClientEvents {
93
+ ready: (state: ClientState) => void;
94
+ configChanged: (event: ConfigChangedEvent) => void;
95
+ evaluated: (details: EvaluationDetails<unknown>) => void;
96
+ error: (error: Error & {
97
+ code?: FlagsClientErrorCode;
98
+ }) => void;
99
+ }
100
+ /** The value `getValue` returns for a default: booleans, strings and numbers keep their type; objects, arrays and `null` get parsed json. */
101
+ type FlagValue<D> = D extends boolean ? boolean : D extends string ? string : D extends number ? number : D extends null ? unknown : D;
102
+
103
+ /** The SDK refuses a config body over 2 MiB before parsing it (the API caps configs at 1 MiB). */
104
+ declare const MAX_CONFIG_BYTES: number;
105
+ type Obj = Record<string, unknown>;
106
+ type Def = SettingValue | object | null;
107
+ /** A failure the client reports through the `error` event (it never throws them at callers). */
108
+ declare class FlagsClientError extends ProductCraftError {
109
+ static readonly brandName: string;
110
+ readonly code: FlagsClientErrorCode;
111
+ constructor(code: FlagsClientErrorCode, message: string, options?: {
112
+ cause?: unknown;
113
+ });
114
+ }
115
+ /** A frozen view of one config for synchronous evaluation (`flags.snapshot()`). */
116
+ declare class FlagsSnapshot {
117
+ #private;
118
+ /** @internal */
119
+ constructor(config: ParsedConfig | null, raw: Obj | null, user: User | undefined, layer: Layer);
120
+ /** Revision of the config, 0 when there is none. */
121
+ get revision(): number;
122
+ /** Generation of the config (bumped after a database restore), 0 when there is none. */
123
+ get generation(): number;
124
+ /** Setting keys in config order. */
125
+ keys(): string[];
126
+ getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): FlagValue<D>;
127
+ getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): EvaluationDetails<FlagValue<D>>;
128
+ getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): T;
129
+ getAllValues(user?: User | null): Record<string, unknown>;
130
+ /** The config JSON this snapshot evaluates (overrides included), or null: pass it as another client's `bootstrap`. */
131
+ toJSON(): Obj | null;
132
+ }
133
+ /**
134
+ * Feature flags and settings, evaluated locally.
135
+ *
136
+ * @example
137
+ * ```ts
138
+ * import { FlagsClient } from "@productcraft/flags";
139
+ * const flags = new FlagsClient({ sdkKey: process.env.PRODUCTCRAFT_FLAGS_SDK_KEY });
140
+ * const on = await flags.getValue("new_checkout", false, { identifier: "user-1" });
141
+ * ```
142
+ */
143
+ declare class FlagsClient {
144
+ #private;
145
+ constructor(options?: FlagsClientOptions);
146
+ /** `initializing`, `ready`, `stale`, `key_invalid`, `offline` or `closed`. */
147
+ get state(): ClientState;
148
+ /** Subscribe to `ready`, `configChanged`, `evaluated` or `error`. Returns a function that unsubscribes. */
149
+ on<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): () => void;
150
+ off<E extends keyof FlagsClientEvents>(event: E, listener: FlagsClientEvents[E]): void;
151
+ /** The user evaluations use when a call passes none. */
152
+ setDefaultUser(user: User | undefined): void;
153
+ /** The value of a flag or setting for a user; the default on any failure. Never throws. */
154
+ getValue<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<FlagValue<D>>;
155
+ /** The value plus why: reason, matched rule or split, error code, warnings and revision. Never throws. */
156
+ getValueDetails<D extends Def>(key: string, defaultValue: D, user?: User | null): Promise<EvaluationDetails<FlagValue<D>>>;
157
+ /** A json (or string) setting, parsed. A parse failure, a missing key or another type returns the default. Never throws. */
158
+ getJson<T = unknown>(key: string, defaultValue: T, user?: User | null): Promise<T>;
159
+ /** Every setting's value for a user (json settings parsed), as a null-prototype object. Never throws. */
160
+ getAllValues(user?: User | null): Promise<Record<string, unknown>>;
161
+ /** The config as it is now, for synchronous evaluation. Does not wait for the first download. */
162
+ snapshot(): FlagsSnapshot;
163
+ /** Resolves when start-up has settled: the first download finished or `maxInitWaitSeconds` passed. Never rejects. */
164
+ waitForReady(): Promise<ClientState>;
165
+ /** Downloads the config now (any polling mode). Resolves when the attempt settles; never rejects. */
166
+ forceRefresh(): Promise<void>;
167
+ /** Stops all network access; evaluations keep using what is held. */
168
+ setOffline(): void;
169
+ /** Resumes network access after `setOffline()` (or the `offline` option). Auto polling fetches at once. */
170
+ setOnline(): void;
171
+ /** Stops timers, aborts a download in flight and stops watching an override file. Evaluations keep working on what is held. */
172
+ close(): void;
173
+ }
174
+
175
+ export { type AutoPolling as A, type ClientState as C, type FlagValue as F, type LazyPolling as L, MAX_CONFIG_BYTES as M, type OverrideBehaviour as O, type PollingOptions as P, type ConfigChangedEvent as a, type ConfigSource as b, type FlagsCache as c, FlagsClient as d, FlagsClientError as e, type FlagsClientErrorCode as f, type FlagsClientEvents as g, type FlagsClientOptions as h, type FlagsOverrides as i, FlagsSnapshot as j, type ManualPolling as k, type OverrideValue as l };