Release Informer Bot for Telegram

A Telegram bot that monitors iOS App Store releases and sends notifications to subscribers when new versions are available. Built with modern Swift using the Vapor framework for robust server-side development.

How It Works

The Release Informer Bot provides a comprehensive subscription system for iOS app release notifications:

1. App Discovery: Users can search for apps using the /search <app name> command, which queries the iTunes Search API
2. Subscription Management: Users subscribe to specific apps using /add <bundle_id> and manage their subscriptions with /list and /del <bundle_id>
3. Release Monitoring: A background watcher checks all subscriptions every 5 minutes using the iTunes API to detect new versions
4. Smart Notifications: When a new version is detected, the bot sends formatted notifications to all subscribed users with release details including version number, release notes, and App Store link
5. Data Persistence: All subscriptions are stored in CouchDB with efficient indexing for fast lookups by bundle ID and chat ID

Available Commands

• /start - Show welcome message with inline keyboard
• /help - Display help information
• /search <app name> - Search for apps in the App Store
• /add <bundle_id> - Subscribe to notifications for an app
• /del <bundle_id> - Unsubscribe from an app
• /list - Show your current subscriptions

Key Features & Architecture

✨ Good Parts

• Modern Swift Concurrency: Built with async/await and actors for safe concurrent operations
• Modular Architecture: Clean separation with three modules:
  • ReleaseInformerBot: Main bot logic and Telegram handlers
  • ReleaseWatcher: Background monitoring service
  • Shared: Common models and database management
• Robust Monitoring: Automated release checking with intelligent rate limiting and error handling
• Scalable Storage: CouchDB integration with optimized views for efficient queries
• Production Ready: Comprehensive logging and error handling
• Real-time Notifications: Instant notifications with rich formatting including release notes
• Resource Management: Intelligent memory management with version history limits (5 versions per app)

🏗️ Technical Architecture

• Server Framework: Vapor 4.x for high-performance HTTP server
• Concurrency: Swift's native actor system for thread-safe operations
• Database: CouchDB with custom views for efficient data access
• External APIs: iTunes Search/Lookup API for app metadata
• Deployment: Flexible for local development and production

Dependencies

The project uses carefully selected, production-grade dependencies:

Core Dependencies

• Vapor 4.110.1+ - Server-side Swift web framework
• Swift NIO 2.65.0+ - Non-blocking networking foundation
• SwiftTelegramSdk 3.8.0+ - Telegram Bot API client
• CouchDB Swift 2.1.0+ - CouchDB client library

Development Dependencies

• VaporTesting - Testing utilities for Vapor applications

Deployment Instructions

Prerequisites

• Swift 6.0+
• CouchDB instance (local or remote)
• Telegram Bot Token (from @BotFather)

Swift Package Manager (Development)

1. Clone the repository:

   git clone https://github.com/makoni/ReleaseInformerBot.git
   cd ReleaseInformerBot

2. Set environment variables:

   export apiKey="YOUR_TELEGRAM_BOT_TOKEN"

3. Build and run:

   swift build
   swift run

4. Run tests:

   swift test

Production Configuration

For production deployments, ensure:

• Set LOG_LEVEL=info or LOG_LEVEL=warning
• Configure CouchDB credentials in DBManager.swift
• Use proper secrets management for the Telegram bot token
• Set up monitoring and health checks on port 8080

CouchDB Setup

The bot will automatically create the required CouchDB database (release_bot) and design document with the necessary views on startup.

Automatic Setup:

• The DBManager includes a setupIfNeed() method that checks for the existence of the database and required views, and creates them if they do not exist. No manual setup is required for most users—just ensure your CouchDB instance is running and credentials are configured in DBManager.swift.

Manual Setup (optional):

If you prefer to create the database and design document manually, use the following JSON for the design document:

{
   "_id": "_design/list",
   "language": "javascript",
   "views": {
       "by_bundle": {
           "map": "function(doc) {\n  emit(doc.bundle_id, doc);\n}"
       },
       "by_chat": {
           "map": "function(doc) {\n  for (var i=0; i<doc.chats.length; i++) {\n    emit(doc.chats[i], doc);\n  }\n}"
       }
   }
}

Create a database named release_bot and add this design document for optimal performance.