v1.4.0: MYSQL_SYNC, diagnóstico de TLS, limites ajustáveis, ${ENV} e duas correções de segurança

[NullSablex]

Release 1.4.0. Aditiva do lado Pawn — nenhuma native foi removida ou renomeada, então gamemodes da 1.3.0 compilam sem mudança. Uma mudança de comportamento exige atenção, descrita logo abaixo.

Atenção antes de atualizar

OnQueryError entregava os cinco argumentos em ordem inversa. O forward é declarado OnQueryError(errorid, error[], callback[], query[], connId), mas o gamemode recebia o id da conexão em errorid, o texto da query em error, a mensagem de erro em query e o código do MySQL em connId.

A causa está no despacho: o exec_public! empilha os argumentos ao contrário, que é a convenção da pilha do AMX, então a ordem listada na chamada é a ordem em que o public recebe — e o código listava começando pelo fim, como se precisasse inverter manualmente. O defeito existe desde a 1.0.0.

Quem trata esse forward vinha lendo os campos trocados e precisa conferir o handler.

Novidades

MYSQL_SYNC — bloqueio explícito, por chamada

O padrão continua sendo não-bloqueante. Escrever MYSQL_SYNC no lugar do nome do callback faz aquela chamada esperar o banco e deixa o resultado legível na linha seguinte:

mysql_query(g_sql, "SELECT COUNT(*) AS n FROM accounts", MYSQL_SYNC);
new total = cache_get_value_name_int(0, "n");

É um valor e não uma native porque uma mysql_query_sync termina copiada para dentro de OnPlayerUpdate; um valor escrito na chamada declara a intenção onde o custo é pago. Também não podia ser um argumento novo: o Pawn recusa qualquer parâmetro depois de {Float,_}:..., e colocá-lo antes do callback quebraria todas as chamadas existentes.

Três regras sustentam o recurso:

• Recusado dentro de um callback. Ali "cache corrente" já significa o do callback, e um resultado bloqueante ou o sombreia ou fica ilegível até o retorno.
• Liberado no tick seguinte, a mesma garantia que o caminho assíncrono ganha do callback ao retornar. Não há liberação manual.
• Recusado nas natives que não podem honrá-lo — prepared statements, transações, ORM e hashing de senha. Sem isso o valor passaria por nome de callback inexistente e a chamada viraria dispare-e-esqueça em silêncio.

Aceito em mysql_query, mysql_pquery e mysql_query_file.

Diagnóstico de TLS

mysql_tls_active(connId) e mysql_tls_cipher(connId, dest[], max_len) informam o que o handshake negociou, e não o que MYSQL_OPT_SSL pediu. O valor é capturado uma vez na abertura da conexão, então nenhuma das duas custa query. Sessão sem criptografia escreve cifra vazia e retorna false.

Limites de memória ajustáveis

mysql_limit_set(limit, value) e mysql_limit_get(limit) tornam configuráveis os três tetos que antes eram fixos: MYSQL_LIMIT_SAVED_CACHES (1024), MYSQL_LIMIT_RESULT_ROWS (100000) e MYSQL_LIMIT_ORM_STRING_LEN (4096). São globais porque a memória protegida é a do servidor. Um valor precisa ser positivo — 0 é recusado em vez de significar "ilimitado" — e baixar um teto preserva o que já está guardado.

${NAME} no arquivo de conexão

O mysql_connect_file já mantinha a senha fora do gamemode; agora o arquivo pode nomear o segredo em vez de guardá-lo:

password = ${MYSQL_PASSWORD}

Nome não definido expande para vazio e registra qual faltou, em vez de enviar o literal ao servidor e produzir um "access denied" enganoso. Apenas ${...} é referência, então senha com cifrão continua válida.

Outras correções

TLS em host de loopback rodava sem criptografia. MYSQL_OPT_SSL = 1 contra 127.0.0.1 reportava sucesso com Ssl_cipher vazio. O prefer_socket do driver, ligado por padrão, move uma conexão de loopback para o socket unix após o handshake, e ali nada é cifrado. Pedir TLS agora desliga essa otimização; sem TLS ela permanece.

rustls 0.23.43 → 0.23.45 (RUSTSEC-2026-0285). Mensagens de handshake do TLS 1.3 aceitas através da fronteira de nível de criptografia.

Erros do driver chegavam ao Pawn com estrutura interna do Rust. Uma tabela inexistente chegava como MySqlError { ERROR 1146 (42S02): ... }. Agora passa apenas a mensagem do servidor.

mysql_query_file falhava sem avisar quem chamou. Arquivo ilegível ou sem statements era apenas linha de log e retorno false, invisível para a forma sem callback. Agora também dispara OnQueryError, com o caminho no lugar da query e errorid 0.

Dependências e CI

• rust-samp passa da tag do git para o crates.io, em 3.5.0.
• mysql 28.0.0 → 28.0.2, mais uma rodada ampla de transitivas.
• Dependabot passa a acompanhar dependências transitivas. Quase nada do que o plugin distribui está no Cargo.toml, então observar apenas o manifesto deixava correções de segurança passarem despercebidas.
• A auditoria de segurança também roda semanalmente, abrindo issue em vez de reprovar um pull request sem relação.
• tests/inc_natives.rs compara a lista do initialize_plugin! com o include nos dois sentidos, para que uma native registrada e não declarada falhe o build em vez de ficar inalcançável a partir do Pawn.

Documentação

O callback sempre foi opcional, mas isso estava dito em uma subseção no fim de uma página enquanto a abertura e todos os exemplos sugeriam o contrário. Da mesma forma, a ordenação FIFO vale para a entrega de callbacks e não para a execução — statements submetidos em sequência executam concorrentemente —, e a tabela comparativa recomendava justamente o uso que falha.

Ficaram registradas garantias que existiam apenas no código: mysql_connect bloqueia enquanto as queries não; TLS falha fechado; o caminho do mysql_query_file é relativo ao diretório do servidor; e coluna binária não trafega em string Pawn, o que torna VEC_ToText() e HEX() o caminho para VECTOR e BLOB.

Com o MYSQL_SYNC, as páginas deixaram de afirmar que tudo é assíncrono, sem passar a anunciar suporte a síncrono de forma genérica.

Verificação

Executado em SA-MP 0.3.7 com MariaDB 11.8, não apenas compilado:

• 196 testes no alvo i686-unknown-linux-gnu
• cargo clippy --all-targets -- -D warnings, cargo fmt --check e a verificação de codificação dos arquivos Pawn, todos limpos
• mkdocs build --strict sem links quebrados
• cargo audit sem vulnerabilidades; permanecem os dois avisos informativos já documentados no changelog

Changelog da 1.4.0 datado de 04/10/2026, cobrindo as 30 alterações desde a v1.3.0.