export type Rule = { attribute: string; op: "eq" | "in" | "gte"; value: unknown };export type Flag = { key: string; enabled: boolean; rules: Rule[]; rolloutPercent: number; defaultValue: boolean;};export type User = { id: string; attributes: Record<string, unknown> };export type FlagErrorInfo = { kind: "invalid_rollout" } | { kind: "invalid_rule"; index: number };export class FlagError extends Error { declare readonly kind: FlagErrorInfo["kind"]; declare readonly index?: number; constructor(info: FlagErrorInfo) { super(info.kind); Object.assign(this, info); }}const finite = (v: unknown): v is number => typeof v === "number" && Number.isFinite(v);const validRule = (rule: Rule): boolean => { const op: string = rule.op; if (op === "eq") return true; if (op === "in") return Array.isArray(rule.value); if (op === "gte") return finite(rule.value); return false;};const matches = (rule: Rule, attrs: Record<string, unknown>): boolean => { const v = attrs[rule.attribute]; if (v === undefined || v === null) return false; switch (rule.op) { case "eq": return v === rule.value; case "in": return (rule.value as unknown[]).some((x) => x === v); case "gte": return typeof v === "number" && v >= (rule.value as number); }};/** Throws FlagError when the flag config is invalid. */export function evaluateFlag(flag: Flag, user: User, hash: (s: string) => number): boolean { const pct = flag.rolloutPercent; if (!finite(pct) || pct < 0 || pct > 100) throw new FlagError({ kind: "invalid_rollout" }); flag.rules.forEach((rule, index) => { if (!validRule(rule)) throw new FlagError({ kind: "invalid_rule", index }); }); if (!flag.enabled) return flag.defaultValue; if (!flag.rules.every((rule) => matches(rule, user.attributes))) return false; return hash(`${flag.key}:${user.id}`) < pct;}