Create templates.py

templates.py

@@ -0,0 +1,115 @@
+# filename: templates.py
+
+# This file centralizes all user-facing text for easy management and future translation.
+# Using f-strings or .format() allows us to insert dynamic values.
+
+class BotResponses:
+    # --- Onboarding & General Help ---
+    WELCOME_MESSAGE = (
+        "**Namaste, {name}!** 🙏\n\n"
+        "I am your personal Terabox Link Processor. I'm designed to be fast, fair, and easy to use.\n\n"
+        "➡️ **How to use me:** Just send me any message containing one or more Terabox links.\n\n"
+        "Check out /help for more commands and information."
+    )
+
+    HELP_MESSAGE = (
+        "**Here's how I can assist you:**\n\n"
+        "1.  **Direct Downloads:** Send me any Terabox link, and I'll send you the file.\n"
+        "2.  **Batch Processing:** You can send multiple links in one message. I'll process them all as one job.\n"
+        "3.  **Intelligent Caching:** If a file has been downloaded before by anyone, you'll get it instantly, for free!\n\n"
+        "**Available Commands:**\n"
+        " - `/myaccount` - Check your account status and subscription details.\n"
+        " - `/help` - Shows this help message."
+    )
+
+    # --- Access Control & Errors ---
+    FORCE_SUBSCRIBE_MESSAGE = (
+        "⚠️ **Access Denied**\n\n"
+        "To use my services, you must be a member of our community channel. This helps us provide a better service.\n\n"
+        "Please join 👉 **@{channel_username}** and then send your link again."
+    )
+
+    GROUP_NOT_AUTHORIZED = (
+        "❌ **Service Inactive in this Group**\n\n"
+        "I am not authorized to work in this group. If you are a group administrator, please contact my owner ({owner_id}) to request access."
+    )
+    
+    USER_BANNED_MESSAGE = "❌ You have been banned from using this service."
+    
+    GENERIC_ERROR = "⚠️ An unexpected error occurred. The technical team has been notified. Please try again after some time."
+
+    # --- Job Processing ---
+    BATCH_ACKNOWLEDGEMENT = (
+        "✅ **Request Received!**\n\n"
+        "Found {link_count} links. Your job has been queued as **Batch #{batch_id}**.\n"
+        "I will now evaluate the links..."
+    )
+
+    BATCH_UPDATE_VALIDATED = (
+        "⚙️ **Processing Batch #{batch_id}**\n\n"
+        "**Status:** {valid_count} out of {total_count} links are valid and are being processed.\n"
+        "({skipped_count} link(s) were skipped).\n\n"
+        "**Progress:** {progress_bar} {processed_count}/{valid_count}"
+    )
+
+    BATCH_CANCELLED = "❌ **Batch #{batch_id}** has been successfully cancelled by the user."
+
+    BATCH_COMPLETE_SUMMARY = (
+        "✅ **Batch #{batch_id} Complete!**\n\n"
+        "**Summary:**\n"
+        " - **Successful:** {success_count} files sent to your DM.\n"
+        " - **Skipped:** {skipped_count} links.\n\n"
+        "**Details of Skipped/Failed Links:**\n{failed_details}"
+    )
+    
+    BATCH_COMPLETE_NO_SKIPS = (
+        "✅ **Batch #{batch_id} Complete!**\n\n"
+        "All **{success_count} files** have been successfully processed and sent to your DM."
+    )
+    
+    DELIVERY_PROMPT_IN_GROUP = "✅ @{username}, your file(s) from **Batch #{batch_id}** are being sent to your private chat (DM)."
+    
+    START_BOT_IN_DM_PROMPT = "⚠️ To receive your files, you need to start a conversation with me first. Please click the button below and press 'START'."
+
+    # --- Monetization & User Account ---
+    PREMIUM_REQUIRED_ERROR = (
+        "⭐ **Premium Plan Required**\n\n"
+        "The file `{file_name}` is **{file_size}**, which is larger than your free user limit of **{free_limit}**.\n\n"
+        "Check /myaccount for upgrade options."
+    )
+
+    MY_ACCOUNT_FREE = (
+        "👤 **My Account**\n\n"
+        "**User ID:** `{user_id}`\n"
+        "**Current Plan:** Free User\n\n"
+        "**Your Benefits:**\n"
+        " - Download new files up to **{free_limit}**.\n"
+        " - Unlimited downloads for any file already in our cache.\n\n"
+        "*Contact my owner ({owner_id}) for information on premium plans.*"
+    )
+
+    MY_ACCOUNT_PREMIUM = (
+        "👤 **My Account**\n\n"
+        "**User ID:** `{user_id}`\n"
+        "**Current Plan:** ⭐ **Premium**\n"
+        "**Subscription Expires:** {expiry_date}\n\n"
+        "Thank you for your support! 🙏"
+    )
+
+    # --- Final File Caption ---
+    FILE_CAPTION = (
+        "**{file_name}**\n\n"
+        "📦 **Size:** {file_size}\n"
+        "🔗 **Source:** `{source_url}`\n\n"
+        "Powered by @YourBotUsername" # Replace with your bot's username
+    )
+
+    # --- Admin Confirmation Messages ---
+    ADMIN_PREMIUM_GRANTED = "✅ Success! User `{user_id}` has been granted premium access for **{duration}**."
+    ADMIN_TIME_ADJUSTED = "✅ Success! Subscription for user `{user_id}` has been adjusted by **{duration}**."
+    ADMIN_USER_BANNED = "✅ Success! User `{user_id}` has been banned."
+    ADMIN_USER_UNBANNED = "✅ Success! User `{user_id}` has been unbanned."
+    ADMIN_GROUP_AUTH = "✅ Success! Group `{group_id}` is now authorized."
+    ADMIN_GROUP_DEAUTH = "✅ Success! Group `{group_id}` has been de-authorized."
+    ADMIN_BROADCAST_START = "📢 **Broadcast Started...** Sending message to all users. This may take some time."
+    ADMIN_BROADCAST_COMPLETE = "✅ **Broadcast Complete!** Message sent to **{user_count}** users."