telegem 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a11b231527c96bdf36029ccf820d6aee8968136ca536884ef0f2177c768c2c8e
-  data.tar.gz: 1bfa41f00aa110c327a108d8eaa4415beed0b8fe9f4dacbdb934d0bc8ac9b960
+  metadata.gz: a044b22212b4380cb47006c7f5bf18b06ee732c01d1baf8e18cd46bec92e6b32
+  data.tar.gz: e5bb919a62f17c531241f94ed45fe7331708f4485dae46423b9a8811941d07a9
 SHA512:
-  metadata.gz: 90384c60612b2907c0770072152a646a80741094f909da69b3feffea2a302dac5799adaf1a8b9d29cf8215d938a496129e348ab0f5fe18705dd9e5af2f94649e
-  data.tar.gz: f9aba5ce1a8cacb43436bec7812c7f7003134c767053a26e73f61b32fbbd68149884668a6ce7d9a156a7024355ff88c8a1cce7476a941903163c7c34c9d9d1a0
+  metadata.gz: a4b801f8c4999e6d3f9bb77798e5f6b4a1d02d4a2d38d2c9f4d138a5cc0589b59983a78b16a58787a9b387fce9e66edf7da343446dd2fdbb0f772ecacdf786f7
+  data.tar.gz: ed36cec7c19a5f0cf68f5e0415ef890f92fcc1e95f793a21a56949facc50ee68264f11a3f35c54f7b02583d6c8768b082efb487ba30b53e3c8a6d307f5d0ceb4

data/Readme.md

@@ -77,9 +77,9 @@ end
 
 📸 See It in Action
 
-https://your-image-link-here.com/telegem-demo.gif <!-- Replace with your demo GIF -->
+<img src="https://i.postimg.cc/W3fdnx45/DA5D1EC7-F2E2-4243-87AB-841F5467F70C.png">
 
-Example bot with interactive keyboard and scene-based ordering flow
+Example bot with interactive keyboard and scene-based  flow
 
 ---
 

data/Starts_HallofFame.md

@@ -0,0 +1,65 @@
+# 🏆 Hall of Fame
+
+This page honors the individuals who have actively engaged with and supported the Telegem project from its earliest days. Your participation is the foundation of this community.
+
+Thank you for being part of the journey. ✨
+
+---
+
+## 🧑‍💻 Active Contributors & Early Community
+
+**Adeniyi Ayonide** ([@adeniyiayomide712](https://gitlab.com/adeniyiayomide712))  
+*First community member to open an issue, providing crucial early feedback.*
+
+**Aurel Branzeanu** ([@texpert](https://gitlab.com/texpert))  
+*Early supporter providing valuable technical perspective.*
+
+**Billy Ricch** ([@billyricch40](https://gitlab.com/billyricch40))  
+*Active community participant and contributor to project discussions.*
+
+**Damola Amadu** ([@Dambzboy](https://gitlab.com/Dambzboy))  
+*Key supporter and participant in the project's growth.*
+
+**Kakashi Osaose** ([@kakashiosaose](https://gitlab.com/kakashiosaose))  
+*Valued community member and technical contributor.*
+
+**Olonade Solomon** ([@Timijay789](https://gitlab.com/Timijay789))  
+*Active participant in development discussions and testing.*
+
+**Sergey Kojin** ([@skojin](https://gitlab.com/skojin))  
+*Technical contributor providing important implementation feedback.*
+
+**Peter Boling** ([@pboling](https://gitlab.com/pboling))
+
+
+---
+
+## 📜 Contribution Philosophy
+
+This Hall of Fame recognizes **active participation and contribution** to the Telegem project. We value:
+*   **Code contributions** through merged Merge Requests
+*   **Quality issue reports** that improve the project
+*   **Technical discussions** that shape implementation
+*   **Community support** that helps other users
+*   **Documentation improvements** that help everyone
+
+While starring the repository is appreciated, this list specifically honors those who have engaged in active dialogue, reporting, or contribution to the project's development.
+
+---
+
+## 🔄 For Maintainers: How to Update
+
+To add new contributors to this list:
+
+1.  **Format:** Follow the existing structure:
+    ```markdown
+    **Name** ([@username](link-to-profile))  
+    *Brief description of their contribution or role.*
+    ```
+2.  **Categories:** As the community grows, consider organizing by contribution type (Core Contributors, Documentation, etc.)
+3.  **Verification:** Ensure the individual has made meaningful contributions beyond passive following
+4.  **Date:** Update the "Last Updated" field below
+
+---
+
+**Last Updated: 2025-31-12**

data/Test-Projects/bot.md

@@ -0,0 +1,145 @@
+bot1.md - Telegem Response Patterns
+
+How Telegem Returns API Responses
+
+All ctx methods return HTTPX::Response objects, not JSON hashes.
+
+Pattern 1: Fire-and-Forget
+
+```ruby
+ctx.reply("Hello!")
+ctx.photo("image.jpg")
+```
+
+Pattern 2: Get Message ID
+
+```ruby
+response = ctx.reply("Sending...")
+
+if response && response.status == 200
+  data = response.json
+  if data && data['ok']
+    message_id = data['result']['message_id']
+    ctx.session[:msg_id] = message_id
+  end
+end
+```
+
+Pattern 3: Check for Errors
+
+```ruby
+response = ctx.reply("Testing...")
+
+if response && response.status != 200
+  error = response.json rescue nil
+  error_msg = error['description'] if error
+  ctx.reply("Failed: #{error_msg}")
+end
+```
+
+Pattern 4: Edit Messages
+
+```ruby
+edit_response = ctx.edit_message_text(
+  "Updated!", 
+  message_id: ctx.session[:msg_id]
+)
+
+if edit_response && edit_response.status == 200
+  ctx.reply("Edit succeeded!")
+end
+```
+
+Pattern 5: Send Media
+
+```ruby
+photo_response = ctx.photo(
+  "https://example.com/image.jpg",
+  caption: "My photo"
+)
+
+if photo_response && photo_response.status == 200
+  ctx.reply("Photo sent!")
+end
+```
+
+Pattern 6: Handle Callbacks
+
+```ruby
+bot.on(:callback_query) do |ctx|
+  ctx.answer_callback_query(text: "Clicked: #{ctx.data}")
+
+  if ctx.data == 'test'
+    ctx.edit_message_text("Updated after click!")
+  end
+end
+```
+
+Pattern 7: Error Wrapping
+
+```ruby
+begin
+  response = ctx.reply(some_text)
+  # Process response
+rescue => e
+  ctx.reply("Error: #{e.message}")
+end
+```
+
+Complete bot1.rb Explained
+
+Setup
+
+```ruby
+require 'telegem'
+require 'dotenv/load'
+bot = Telegem.new(ENV['BOT_TOKEN'])
+```
+
+/start Command
+
+Sends welcome, stores message ID in session.
+
+/help Command
+
+Simple reply with command list.
+
+/edit Command
+
+Edits the stored message, checks edit response.
+
+/photo Command
+
+Sends photo, confirms delivery.
+
+/error Command
+
+Demonstrates error handling.
+
+Callback Handler
+
+Answers inline button clicks.
+
+Startup Logic
+
+```ruby
+if ENV['RACK_ENV'] == 'production'
+  # Webhook mode
+  server = bot.webhook(port: ENV['PORT'] || 3000)
+  server.run
+  server.set_webhook
+else
+  # Polling mode (development)
+  bot.start_polling(timeout: 30, limit: 100)
+end
+```
+
+Key Takeaways
+
+1. Always check response.status (200 = success)
+2. Call .json to get data from response
+3. Check data['ok'] before using result
+4. Store message_id for later editing
+5. Wrap in begin/rescue for network issues
+
+This pattern ensures your bot handles all API scenarios correctly.

data/Test-Projects/bot1.rb

@@ -0,0 +1,91 @@
+require 'telegem'
+require 'dotenv/load'
+
+bot = Telegem.new(ENV['BOT_TOKEN'])
+
+bot.command('start') do |ctx|
+  ctx.reply("Welcome! Use /help for commands.")
+
+  response = ctx.reply("Processing your request...")
+
+  if response && response.status == 200
+    data = response.json
+    if data && data['ok']
+      ctx.session[:start_msg_id] = data['result']['message_id']
+    end
+  end
+end
+
+bot.command('help') do |ctx|
+  help_text = <<~HELP
+    Available commands:
+    /start - Start the bot
+    /help - This help message
+    /edit - Edit the start message
+    /error - Test error handling
+    /photo - Send a photo
+  HELP
+
+  ctx.reply(help_text)
+end
+
+bot.command('edit') do |ctx|
+  if ctx.session[:start_msg_id]
+    edit_response = ctx.edit_message_text(
+      "✅ Updated at #{Time.now.strftime('%H:%M:%S')}",
+      message_id: ctx.session[:start_msg_id]
+    )
+
+    if edit_response && edit_response.status == 200
+      ctx.reply("Message edited successfully!")
+    else
+      status = edit_response ? edit_response.status : 'no response'
+      ctx.reply("Edit failed (status: #{status})")
+    end
+  else
+    ctx.reply("Send /start first to create a message to edit.")
+  end
+end
+
+bot.command('photo') do |ctx|
+  photo_response = ctx.photo(
+    "https://picsum.photos/400/300",
+    caption: "Random image - #{Time.now.strftime('%H:%M:%S')}"
+  )
+
+  if photo_response && photo_response.status == 200
+    ctx.reply("Photo sent successfully!")
+  else
+    ctx.reply("Failed to send photo.")
+  end
+end
+
+bot.command('error') do |ctx|
+  begin
+    invalid_response = ctx.reply(nil)
+
+    if invalid_response && invalid_response.status != 200
+      error_data = invalid_response.json rescue nil
+      error_msg = error_data ? error_data['description'] : "Unknown error"
+      ctx.reply("API Error: #{error_msg}")
+    end
+  rescue => e
+    ctx.reply("Ruby Error: #{e.message}")
+  end
+end
+
+bot.on(:callback_query) do |ctx|
+  ctx.answer_callback_query(text: "Button clicked: #{ctx.data}")
+
+  if ctx.data == 'test'
+    ctx.edit_message_text("You clicked the test button!")
+  end
+end
+
+if ENV['RACK_ENV'] == 'production'
+  server = bot.webhook(port: ENV['PORT'] || 3000)
+  server.run
+  server.set_webhook
+else
+  bot.start_polling(timeout: 30, limit: 100)
+end