Sobre o projeto

go-branded-id é uma biblioteca Go que fornece identificadores fortemente tipados com marcas. Ela usa tipos fantasma para evitar misturar diferentes IDs de entidades (por exemplo, UserID vs OrderID) em tempo de compilação, capturando bugs que passariam despercebidos. A biblioteca tem zero alocação para operações principais, usa apenas a biblioteca padrão do Go e suporta serialização completa, incluindo JSON, SQL, Text, Binary e Gob. Funciona com qualquer tipo comparável, oferece semântica de valor zero (serializa para null em JSON, nil em SQL) e inclui um scanner/valuer SQL. Tipos de marca nomeados podem fornecer um método Name() para strings visíveis em depuração e validação ciente da marca. A biblioteca também fornece erros sentinela para tratamento de erros e uma ferramenta codemod para gerar stubs de Name(). Requer Go 1.26+.