Referência do export.

Assinatura

local result = exports.traki:log({
    event = 'admin.player_banned',
    severity = 'warning',
    message = 'Jogador banido',
    author = source,
    target = targetSource,
    metadata = {
        reason = reason,
        duration = duration
    }
})

Campos de entrada

Nomeando eventos

Use um identificador estável no formato categoria.acao. Não coloque IDs, nomes de jogadores ou textos variáveis no nome do evento.

• economy.purchase
• inventory.item_transferred
• admin.player_banned
• garage.vehicle_stored

Autor e alvo

`author` e `target` são sources de jogadores conectados. O Traki captura nome e identificadores disponíveis naquele instante. Não copie identificadores para `metadata`. Se ambos forem omitidos, o registro representa uma ação do próprio resource.

Retorno

-- Evento aceito na fila local
{ accepted = true, eventId = 'traki-...' }

-- Evento recusado antes de entrar na fila
{ accepted = false, error = 'INVALID_EVENT' }

accepted=true confirma apenas a fila local. A comunicação HTTP ocorre de forma assíncrona e pode usar retentativas.

Limites do contrato

• Evento completo: até 16 KiB serializados.
• Metadata: profundidade máxima de 6 níveis e até 100 chaves.
• Valores: apenas tipos compatíveis com JSON.
• Resource de origem: detectado automaticamente, até 64 caracteres.
• Chaves semelhantes a senha, token, secret, cookie ou autorização são ocultadas.

Erros imediatos