Feature flags
O código entra desligado e abre por público, com volta imediata.
Feature flags tipadas (booleana, texto, número e JSON) com variantes, regras de público por ambiente, segmentos reutilizáveis e rollout por percentual. Cada avaliação devolve o valor, a variante, o motivo e os metadados, no modelo do OpenFeature, então o seu código fala com um padrão aberto e não com uma API proprietária.
A ordem de avaliação é fixa e previsível: kill switch, flag desligada, regras na ordem em que foram escritas e, por fim, a regra padrão. O kill switch é um estado do ambiente, não da versão: desliga a funcionalidade na hora, sem publicar nada e sem novo deploy.
Como funciona
- Regras com condições sobre atributos do contexto (igual, diferente, lista, maior e menor, começa com, termina com, contém e comparação de versão semver) e até 5 segmentos por regra.
- Segmentos com condições e listas de chaves incluídas e excluídas, compartilhados entre flags do workspace.
- Rollout por percentual com distribuição estável: o balde sai do SHA-256 da chave da flag, do sal e da chave do contexto, em 10.000 baldes. O mesmo contexto cai sempre na mesma variante.
- Provedores OpenFeature para servidor e navegador no SDK JS/TS, que avalia localmente a partir de um snapshot com o mesmo motor que o servidor usa.
- Chave do SDK por ambiente, exibida uma única vez; gerar outra revoga a anterior. Toda chamada leva também uma credencial de API com o escopo flags:evaluate.
- Estado das flags por ambiente em leitura pela API v1 e pelo servidor MCP. Cada versão publicada é imutável e guarda quem publicou; voltar é uma nova publicação.
import { OpenFeature } from '@openfeature/server-sdk'
import { AiubyFlagsServerProvider, createFlagsClient } from '@aiuby-ia/flags'
await OpenFeature.setProviderAndWait(new AiubyFlagsServerProvider(createFlagsClient({ credential, sdkKey })))
const value = await OpenFeature.getClient().getBooleanValue('checkout-novo', false, { targetingKey: 'cliente-42', plan: 'pro' })O que não faz
- Não aceita expressão regular nas regras: use começa com, termina com ou contém.
- Não envia mudanças por SSE: elas chegam ao SDK por polling com ETag (mínimo de 5 s, padrão de 30 s).
- O SDK oficial é JS/TS, para navegador e Node 18+. Outras linguagens usam a rota de avaliação remota.
- A credencial não vai ao navegador: o snapshot traz as listas de chaves dos segmentos, por isso o front-end o recebe por uma rota do seu backend.