Codificador de bases DNA

Sequências com letras fora de A, C, G e T, ou cujo comprimento não é múltiplo de quatro, retornam um erro invalid_input claro em vez de inventar preenchimento ou substituições silenciosas. O caminho é aritmética determinística pura sobre bytes UTF-8 —sem rede, sem sementes aleatórias, sem dependência de relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON sempre que você a chama a US$ 0,002 por requisição bem-sucedida.

Como chamar a API e o que a resposta contém

O modo padrão é encode: os bytes UTF-8 do texto tornam-se uma string de DNA contínua em maiúsculas. O modo decode trata o texto como uma sequência de DNA —opcionalmente com espaços ou separadores comuns— e devolve a string UTF-8 recuperada após remover separadores, colocar as bases em maiúsculas e validar o alfabeto e o comprimento. Em sucesso para decode, a resposta inclui mode, input, result e text com a string UTF-8 decodificada, dna normalizada para sequência contínua em maiúsculas, os mesmos arrays groups e bytes, contagens, mapeamento e uma mensagem correspondente. Envie um corpo JSON com um campo string obrigatório text (aliases input, value, data e sequence) e um mode opcional que seja encode ou decode. O comprimento de entrada é limitado a cem mil caracteres para que uma única requisição não esgote a memória do Worker com strings enormes. Em sucesso para encode, a resposta inclui mode, input, result e dna com a mesma string de bases, groups como array de blocos de quatro bases (um por byte), bytes com os valores inteiros, byte_count, base_count, bit_count, a legenda do mapeamento e uma mensagem curta. Validação falha —text ausente, text que não é string, entrada grande demais, mode desconhecido, caractere que não é base, comprimento que não é múltiplo de quatro ou bytes decodificados que não são UTF-8 válido— retorna invalid_input e nunca é cobrada. O preço é um valor fixo de US$ 0,002 por requisição bem-sucedida com unidade item.

Dicas práticas, limites e ferramentas relacionadas

Verificações de ida e volta são o smoke test mais rápido: codifique uma palavra curta como Hi, confirme que as oito bases batem com os grupos de quatro bases conhecidos para H e i, depois decodifique essas bases e confirme que recupera a string original. Esta ferramenta não é um utilitário biológico de reverso-complemento, nem um tradutor de códons, nem um conversor geral de base 4 para inteiros arbitrários — esses problemas merecem páginas dedicadas. Prefira esta capacidade quando a intenção de busca for texto ou binário versus bases de DNA com tabela de empacotamento de dois bits; use um conversor de texto para binário ou hex quando precisar de formas zero-um ou hexadecimais em vez de A/C/G/T. Ao ensinar, mostre o mesmo emoji ou letra acentuada ao lado de uma letra ASCII simples para que os alunos vejam octetos UTF-8 multi-byte aparecerem como grupos extras de quatro bases em vez de um códon misterioso único. Prefira decode quando você já tem uma string A/C/G/T de um livro ou de um payload gerado e quer recuperar os caracteres. Envie de propósito um fragmento de três bases ou uma string com X ou U para afirmar que seu cliente trata invalid_input e a mensagem de erro que nomeia o alfabeto ou a regra do múltiplo de quatro. Mantenha os payloads abaixo do limite de caracteres publicado; dumps de vários megabytes pertencem ao ambiente offline. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando aprendizes colam sequências incompletas.