UUID Generator npm

Propósito e intenção do usuário: a ferramenta gera UUID RFC 4122 para projetos Node.js/NPM para fornecer identificadores únicos para fixtures, dados de teste, tokens de rastreamento distribuído, IDs de sessão e amostras de configuração. Usuários principais incluem desenvolvedores de software, QA, DevOps e pipelines CI que exigem IDs confiáveis e reproduzíveis sem dependências externas. Suporta geração em lote em uma única chamada e permite selecionar a versão UUID e o formato de saída. Se resultados determinísticos forem necessários, as versões 3 ou 5 podem produzir IDs estáveis a partir de um namespace e de um nome.
Lógica central e recursos: capacidades-chave incluem: (1) seleção de versão entre {1,3,4,5}; (2) geração em lote com quantidade configurável; (3) controle de formatação (hyphenated vs compact); (4) derivação determinística para v3/v5 via namespace+nome; (5) saída como array de strings com serialização opcional; (6) validação e relatório estruturado de erros. Funcionalidades obrigatórias: count > 0 e versão em {1,3,4,5}. Opcional/Avançado: fornecer namespace+nome para v3/v5, escolher o formato e exportar para estruturas de dados comuns ou arquivos via ferramentas downstream.
Entradas e saídas: entradas: count (inteiro, obrigatório, exemplo 5, intervalo 1-10000); version (enum 1,3,4,5; padrão 4); hyphenated (boolean, padrão true); namespace (string, opcional); name (string, opcional). Saídas: uuids (array de strings); format (string: 'hyphenated' ou 'compact'); saída de exemplo documentada.
Algoritmos e cálculos: V4 usa RNG criptograficamente forte para UUIDs aleatórios; V1 é baseado no tempo; V3 usa MD5(Namespace, Name) para UUID baseado em namespace; V5 usa SHA-1(Namespace, Name). As entradas são validadas e a hyphenation é normalizada após a geração.
Erros e casos extremos: count inválido (<=0 ou >10000) gera erro; versão inválida; para v3/v5 Namespace ou Name ausentes, recorre a v4 quando possível; grandes contagens podem consumir memória; colisões são estatisticamente improváveis, mas não garantidas.