v3.3 — Full v2 migration support

v2 Migration Support

v2 code now runs on v3 out of the box with deprecation warnings. The compatibility layer auto-detects v2-style positional argument calls and converts them to the v3 opts-table pattern.

Covered methods:

• api.run(limit, timeout, ...)
• api.get_updates(timeout, offset, ...)
• api.set_webhook(url, certificate, ...)
• api.send_message(chat_id, text, thread_id, parse_mode, ...) — including the nil, 'HTML' pattern
• api.send_photo(), send_video(), send_document(), send_audio(), send_voice(), send_animation(), send_sticker() — all with full positional-arg support
• api.answer_callback_query(id, text, show_alert, ...)
• api.edit_message_text(chat_id, msg_id, text, parse_mode, ...)
• Renamed methods: kick_chat_member → ban_chat_member, get_chat_members_count → get_chat_member_count
• require('telegram-bot-lua.core') → forwards to main module

Documentation

• Migration guide added to README

Tests

• 38 compat tests covering all v2 call patterns
• 567 total tests passing

v3.2 — Fix module structure for LuaRocks

Bug Fix

• Fixed module loading on Lua 5.1: Renamed src/init.lua to src/main.lua so LuaRocks installs the main module as a flat telegram-bot-lua.lua file instead of telegram-bot-lua/init.lua. This fixes require("telegram-bot-lua") on Lua 5.1 environments where ?/init.lua isn't in the default package.path. (#35)

Tests

• Added 84 module structure tests covering require paths, rockspec file integrity, deprecated core shim, and submodule loading.

v3.1

Bug Fixes

• Fix multipart file upload — api.request() used next(file) which only processed one file entry. Methods like send_video with both video and thumbnail now correctly include all parameters (#30)
• Fix parse_mode defaults — Boolean true now converts to MarkdownV2 instead of the deprecated markdown string (affected send_reply, input_text_message_content, send_inline_article)
• Add missing send_poll params — Added question_parse_mode and question_entities

Other

• Fix rockspec source URLs from deprecated git:// to HTTPS tarball
• Expand e2e test coverage from 24 to 97 tests
• Expand unit tests to 455 passing

Install: luarocks install telegram-bot-lua 3.1-0