Feat: Inclusão endpoint Encaminhamento de mensagens (forward)

[iagocotta]

✨ Adicionado endpoint para encaminhamento de mensagens

Resumo

Esta PR adiciona um novo endpoint responsável pelo encaminhamento de mensagens do WhatsApp, permitindo encaminhar mensagens existentes para outro contato ou grupo mantendo o comportamento nativo da plataforma.

O que foi implementado

• Adicionado o endpoint POST /message/forward.
• Implementada a lógica para encaminhamento de mensagens de texto e mídia.
• Preservação da identificação de mensagem encaminhada (forwarded), conforme comportamento nativo do WhatsApp.
• Suporte ao parâmetro opcional forwardingScore, permitindo definir manualmente o número de encaminhamentos da mensagem.
• Encaminhamento de mídias utilizando as referências originais (mediaKey e directPath), evitando download e novo upload dos arquivos.
• Inclusão da documentação Swagger para o novo endpoint.
• Validação dos campos obrigatórios da requisição.

Corpo da requisição

O endpoint recebe:

• number: número/JID de destino.
• message: objeto completo waE2E.Message da mensagem original (obtido, por exemplo, através do webhook).
• delay (opcional): atraso antes do envio.
• forwardingScore (opcional): sobrescreve a quantidade de encaminhamentos da mensagem.

Benefícios

• Mantém o comportamento nativo do WhatsApp para mensagens encaminhadas.
• Evita reprocessamento de mídias, tornando o envio mais eficiente.
• Compatível com diferentes tipos de mensagens suportadas pelo waE2E.Message.
• Reaproveita a autenticação e as validações já existentes na API.

Observações

• O campo message deve conter o payload completo da mensagem original (waE2E.Message), normalmente disponível em data.Message recebido pelos webhooks.
• Caso o campo forwardingScore não seja informado, o valor é calculado automaticamente com base na mensagem original.

[sourcery-ai]

Sorry @iagocotta, your pull request is larger than the review limit of 150000 diff characters