Flag Config

type FlagConfig = {
  version: number;
  enabled: boolean; // Master kill switch — false short-circuits all rules
  defaultValue: FlagValue; // Returned when no rule matches
  rules: Rule[];
  variants?: Variant[]; // Named values for string/number flags
};

type FlagValue = boolean | string | number;

type Rule = {
  id: string;
  name: string;
  enabled: boolean;
  conditions: Condition[];
  conditionOperator: "AND" | "OR"; // How conditions are combined
  value: FlagValue; // Value to return if the rule matches
  rolloutPercentage?: number; // 0–100. Pro/Enterprise only.
};

type Condition = {
  attribute: string; // Any key from the evaluation context
  operator: ConditionOperator;
  value: string | string[];
};

type Variant = {
  key: string; // e.g. "control", "treatment-a"
  value: FlagValue; // e.g. "blue", 0.05
};

1. enabled === false  →  return defaultValue  (reason: DISABLED)
2. For each rule (in order):
   a. rule.enabled === false  →  skip
   b. Evaluate conditions with conditionOperator
   c. Conditions match?
      - If rolloutPercentage set: hash userId → bucket check
        - In bucket  →  return rule.value  (reason: ROLLOUT)
        - Not in bucket  →  skip
      - Else  →  return rule.value  (reason: RULE_MATCH)
3. No rule matched  →  return defaultValue  (reason: DEFAULT)

{
  "version": 3,
  "enabled": true,
  "defaultValue": false,
  "rules": [
    {
      "id": "rule-pro-us",
      "name": "Pro users in US",
      "enabled": true,
      "conditionOperator": "AND",
      "conditions": [
        { "attribute": "plan", "operator": "equals", "value": "pro" },
        { "attribute": "country", "operator": "equals", "value": "US" }
      ],
      "value": true
    },
    {
      "id": "rule-50pct",
      "name": "50% rollout",
      "enabled": true,
      "conditionOperator": "AND",
      "conditions": [],
      "rolloutPercentage": 50,
      "value": true
    }
  ]
}