fix(module): rename init.lua to main.lua for LuaRocks compat

spec/module_spec.lua

@@ -0,0 +1,149 @@
+local api = require('spec.test_helper')
+
+describe('module structure', function()
+    describe('require("telegram-bot-lua")', function()
+        it('returns a table', function()
+            assert.is_table(api)
+        end)
+
+        it('has a version string', function()
+            assert.is_string(api.version)
+            assert.truthy(api.version:match('%d+%.%d+%-%d+'))
+        end)
+
+        it('has configure function', function()
+            assert.is_function(api.configure)
+        end)
+
+        it('has request function', function()
+            assert.is_function(api.request)
+        end)
+
+        it('has get_me function', function()
+            assert.is_function(api.get_me)
+        end)
+    end)
+
+    describe('require("telegram-bot-lua.core") deprecated shim', function()
+        it('returns the same api table as the main module', function()
+            local core = require('telegram-bot-lua.core')
+            assert.are.equal(api, core)
+        end)
+
+        it('is cached in package.loaded', function()
+            assert.is_not_nil(package.loaded['telegram-bot-lua.core'])
+        end)
+    end)
+
+    describe('rockspec module map', function()
+        local rockspec_modules = {
+            ['telegram-bot-lua'] = 'src/main.lua',
+            ['telegram-bot-lua.config'] = 'src/config.lua',
+            ['telegram-bot-lua.handlers'] = 'src/handlers.lua',
+            ['telegram-bot-lua.builders'] = 'src/builders.lua',
+            ['telegram-bot-lua.helpers'] = 'src/helpers.lua',
+            ['telegram-bot-lua.tools'] = 'src/tools.lua',
+            ['telegram-bot-lua.utils'] = 'src/utils.lua',
+            ['telegram-bot-lua.compat'] = 'src/compat.lua',
+            ['telegram-bot-lua.core'] = 'src/core.lua',
+            ['telegram-bot-lua.polyfill'] = 'src/polyfill.lua',
+            ['telegram-bot-lua.async'] = 'src/async.lua',
+            ['telegram-bot-lua.b64url'] = 'src/b64url.lua',
+            ['telegram-bot-lua.methods.updates'] = 'src/methods/updates.lua',
+            ['telegram-bot-lua.methods.messages'] = 'src/methods/messages.lua',
+            ['telegram-bot-lua.methods.chat'] = 'src/methods/chat.lua',
+            ['telegram-bot-lua.methods.members'] = 'src/methods/members.lua',
+            ['telegram-bot-lua.methods.forum'] = 'src/methods/forum.lua',
+            ['telegram-bot-lua.methods.stickers'] = 'src/methods/stickers.lua',
+            ['telegram-bot-lua.methods.inline'] = 'src/methods/inline.lua',
+            ['telegram-bot-lua.methods.payments'] = 'src/methods/payments.lua',
+            ['telegram-bot-lua.methods.games'] = 'src/methods/games.lua',
+            ['telegram-bot-lua.methods.passport'] = 'src/methods/passport.lua',
+            ['telegram-bot-lua.methods.bot'] = 'src/methods/bot.lua',
+            ['telegram-bot-lua.methods.gifts'] = 'src/methods/gifts.lua',
+            ['telegram-bot-lua.methods.checklists'] = 'src/methods/checklists.lua',
+            ['telegram-bot-lua.methods.stories'] = 'src/methods/stories.lua',
+            ['telegram-bot-lua.methods.suggested_posts'] = 'src/methods/suggested_posts.lua',
+            ['telegram-bot-lua.adapters'] = 'src/adapters/init.lua',
+            ['telegram-bot-lua.adapters.db'] = 'src/adapters/db.lua',
+            ['telegram-bot-lua.adapters.redis'] = 'src/adapters/redis.lua',
+            ['telegram-bot-lua.adapters.llm'] = 'src/adapters/llm.lua',
+            ['telegram-bot-lua.adapters.email'] = 'src/adapters/email.lua',
+        }
+
+        for mod_name, file_path in pairs(rockspec_modules) do
+            it('source file exists for ' .. mod_name, function()
+                local f = io.open(file_path, 'r')
+                assert.is_not_nil(f, 'missing file: ' .. file_path)
+                if f then f:close() end
+            end)
+        end
+
+        for mod_name, _ in pairs(rockspec_modules) do
+            it('can require ' .. mod_name, function()
+                assert.is_not_nil(package.loaded[mod_name] or package.preload[mod_name],
+                    'module not loadable: ' .. mod_name)
+            end)
+        end
+    end)
+
+    describe('main module entry point', function()
+        it('is NOT named init.lua (avoids LuaRocks init.lua directory install)', function()
+            local f = io.open('src/init.lua', 'r')
+            assert.is_nil(f, 'src/init.lua should not exist; use src/main.lua so LuaRocks installs as flat file')
+            if f then f:close() end
+        end)
+
+        it('main.lua exists as the entry point', function()
+            local f = io.open('src/main.lua', 'r')
+            assert.is_not_nil(f, 'src/main.lua must exist as the main entry point')
+            if f then f:close() end
+        end)
+    end)
+
+    describe('all submodules loaded into api', function()
+        it('has handler methods (on_message etc)', function()
+            assert.is_not_nil(api.on_message)
+        end)
+
+        it('has builder methods', function()
+            assert.is_function(api.inline_result)
+        end)
+
+        it('has message methods (send_message etc)', function()
+            assert.is_function(api.send_message)
+        end)
+
+        it('has chat methods', function()
+            assert.is_function(api.get_chat)
+        end)
+
+        it('has member methods', function()
+            assert.is_function(api.get_chat_member)
+        end)
+
+        it('has sticker methods', function()
+            assert.is_function(api.send_sticker)
+        end)
+
+        it('has inline methods', function()
+            assert.is_function(api.answer_inline_query)
+        end)
+
+        it('has payment methods', function()
+            assert.is_function(api.send_invoice)
+        end)
+
+        it('has game methods', function()
+            assert.is_function(api.send_game)
+        end)
+
+        it('has bot methods', function()
+            assert.is_function(api.set_my_commands)
+        end)
+
+        it('has utility methods', function()
+            assert.is_function(api.input_text_message_content)
+        end)
+    end)
+end)

spec/test_helper.lua

@@ -6,7 +6,7 @@ package.path = './src/?.lua;./src/?/init.lua;' .. package.path
 
 -- Pre-register our module names to match rockspec mappings
 local module_map = {
-    ['telegram-bot-lua'] = 'src/init.lua',
+    ['telegram-bot-lua'] = 'src/main.lua',
     ['telegram-bot-lua.config'] = 'src/config.lua',
     ['telegram-bot-lua.handlers'] = 'src/handlers.lua',
     ['telegram-bot-lua.builders'] = 'src/builders.lua',

src/init.lua → src/main.lua

@@ -9,7 +9,7 @@
                        __/ |
                       |___/
 
-      Version 3.0-0
+      Version 3.2-0
       Copyright (c) 2017-2026 Matthew Hesketh
       See LICENSE for details
 
@@ -20,7 +20,7 @@ local ltn12 = require('ltn12')
 local json = require('dkjson')
 local config = require('telegram-bot-lua.config')
 
-api.version = '3.1-0'
+api.version = '3.2-0'
 
 function api.configure(token, debug)
     if not token or type(token) ~= 'string' then

telegram-bot-lua-3.2-0.rockspec

@@ -0,0 +1,65 @@
+package = "telegram-bot-lua"
+version = "3.2-0"
+source = {
+    url = "https://github.com/wrxck/telegram-bot-lua/archive/refs/tags/v3.2.tar.gz",
+    dir = "telegram-bot-lua-3.2"
+}
+description = {
+    summary = "A feature-filled Telegram bot API library",
+    detailed = "A feature-filled Telegram bot API library written in Lua, with Bot API 9.4 support.",
+    homepage = "https://github.com/wrxck/telegram-bot-lua",
+    maintainer = "Matthew Hesketh <matthew@matthewhesketh.com>",
+    license = "GPL-3"
+}
+supported_platforms = {
+    "linux",
+    "macosx",
+    "unix",
+    "bsd"
+}
+dependencies = {
+    "lua >= 5.1",
+    "dkjson >= 2.5-2",
+    "luasec >= 0.6-1",
+    "luasocket >= 3.0rc1-2",
+    "multipart-post >= 1.1-1",
+    "luautf8 >= 0.1.1-1",
+    "copas >= 4.0"
+}
+build = {
+    type = "builtin",
+    modules = {
+        ["telegram-bot-lua"] = "src/main.lua",
+        ["telegram-bot-lua.config"] = "src/config.lua",
+        ["telegram-bot-lua.handlers"] = "src/handlers.lua",
+        ["telegram-bot-lua.builders"] = "src/builders.lua",
+        ["telegram-bot-lua.helpers"] = "src/helpers.lua",
+        ["telegram-bot-lua.tools"] = "src/tools.lua",
+        ["telegram-bot-lua.utils"] = "src/utils.lua",
+        ["telegram-bot-lua.compat"] = "src/compat.lua",
+        ["telegram-bot-lua.core"] = "src/core.lua",
+        ["telegram-bot-lua.polyfill"] = "src/polyfill.lua",
+        ["telegram-bot-lua.async"] = "src/async.lua",
+        ["telegram-bot-lua.b64url"] = "src/b64url.lua",
+        ["telegram-bot-lua.methods.updates"] = "src/methods/updates.lua",
+        ["telegram-bot-lua.methods.messages"] = "src/methods/messages.lua",
+        ["telegram-bot-lua.methods.chat"] = "src/methods/chat.lua",
+        ["telegram-bot-lua.methods.members"] = "src/methods/members.lua",
+        ["telegram-bot-lua.methods.forum"] = "src/methods/forum.lua",
+        ["telegram-bot-lua.methods.stickers"] = "src/methods/stickers.lua",
+        ["telegram-bot-lua.methods.inline"] = "src/methods/inline.lua",
+        ["telegram-bot-lua.methods.payments"] = "src/methods/payments.lua",
+        ["telegram-bot-lua.methods.games"] = "src/methods/games.lua",
+        ["telegram-bot-lua.methods.passport"] = "src/methods/passport.lua",
+        ["telegram-bot-lua.methods.bot"] = "src/methods/bot.lua",
+        ["telegram-bot-lua.methods.gifts"] = "src/methods/gifts.lua",
+        ["telegram-bot-lua.methods.checklists"] = "src/methods/checklists.lua",
+        ["telegram-bot-lua.methods.stories"] = "src/methods/stories.lua",
+        ["telegram-bot-lua.methods.suggested_posts"] = "src/methods/suggested_posts.lua",
+        ["telegram-bot-lua.adapters"] = "src/adapters/init.lua",
+        ["telegram-bot-lua.adapters.db"] = "src/adapters/db.lua",
+        ["telegram-bot-lua.adapters.redis"] = "src/adapters/redis.lua",
+        ["telegram-bot-lua.adapters.llm"] = "src/adapters/llm.lua",
+        ["telegram-bot-lua.adapters.email"] = "src/adapters/email.lua"
+    }
+}