Plugin Class

__name__ = "Better Previews"
__description__ = "Modifies specific URLs (Twitter, TikTok, Reddit, Instagram, Pixiv) for better previews"
__version__ = "1.0.0"
__id__ = "better_previews"
__author__ = "@immat0x1"
__icon__ = "exteraPlugins/1"
__min_version__ = "11.12.0"

from ui.settings import Header, Input, Divider, Switch, Selector, Text
 
class DebugPlugin(BasePlugin):
    def _on_advanced_toggle_change(self, new_value: bool):
        self.log(f"Advanced toggle changed to: {new_value}")
 
    def _create_advanced_settings(self):
        return [
            Header(text="Advanced Settings Sub-Page"),
            Switch(
                key="advanced_toggle",
                text="Enable Advanced Feature",
                default=False,
                on_change=self._on_advanced_toggle_change
            ),
            Input(key="advanced_text", text="Advanced Input", default="defaultValue")
        ]
 
    def create_settings(self):
        from org.telegram.messenger import LocaleController
        lang = LocaleController.getInstance().getCurrentLocale().getLanguage()
 
        strings = {
            'ru': {
                'api_title': "Настройки API",
                'api_url_label': "Cobalt API URL",
                'api_key_label': "API ключ",
                'api_desc': "Укажите URL и API (если требуется) вашего Cobalt инстанса. Узнать больше: github.com/imputnet/cobalt",
                'settings_title': "Настройки загрузки",
                'usage_cmd': ".down/.dl [URL] - Скачивает и отправляет медиа\nПример: .dl youtube.com/watch?v=dQw4w9WgXcQ",
                'include_source_text': "Включить ссылку источника",
                'include_source_subtext': "Добавлять исходную ссылку к видео",
                'video_quality': "Качество видео",
                'download_mode': "Режим загрузки",
                'audio_bitrate': "Битрейт аудио",
                'info_text': "Это информационный текст.",
                'action_text': "Нажми на меня!"
            },
            'en': {
                'api_title': "API Settings",
                'api_url_label': "Cobalt API URL",
                'api_key_label': "API Key",
                'api_desc': "Enter URL and API (if needed) for your Cobalt instance. Learn more: github.com/imputnet/cobalt",
                'settings_title': "Download Settings",
                'usage_cmd': "Command: .down/.dl [URL] - Download and send video/audio\nExample: .dl youtube.com/watch?v=dQw4w9WgXcQ",
                'include_source_text': "Include source link",
                'include_source_subtext': "Add original link as caption",
                'video_quality': "Video Quality",
                'download_mode': "Download Mode",
                'audio_bitrate': "Audio Bitrate",
                'info_text': "This is an informational text item.",
                'action_text': "Click me for an action!"
            }
        }
 
        lang_key = 'ru' if lang.startswith('ru') else 'en'
        s = strings[lang_key]
        
        CUSTOM_COBALT_API = ""
        DEFAULT_COBALT_API = "https://co.wuk.sh"
 
 
        def on_info_click(view):
            self.log("Info text clicked!")
            # For example, show a bulletin
            # from ui.bulletin import BulletinHelper
            # BulletinHelper.show_info("You clicked the info text!")
 
        return [
            Header(text=s['api_title']),
            Input(
                key="api_url",
                text=s['api_url_label'],
                default=CUSTOM_COBALT_API or DEFAULT_COBALT_API,
                icon="msg2_devices"
            ),
            Input(
                key="api_key",
                text=s['api_key_label'],
                default="",
                icon="msg_pin_code"
            ),
            Divider(text=s['api_desc']),
            Header(text=s['settings_title']),
            Switch(
                key="include_source",
                text=s['include_source_text'],
                default=True,
                subtext=s['include_source_subtext'],
                icon="msg_link"
            ),
            Selector(
                key="video_quality",
                text=s['video_quality'],
                default=4,
                items=["144", "240", "360", "480", "720", "1080", "1440", "2160", "4320", "max"],
                icon="msg_video"
            ),
            Selector(
                key="download_mode",
                text=s['download_mode'],
                default=0,
                items=["auto", "audio", "mute"],
                icon="msg_gallery"
            ),
            Selector(
                key="audio_bitrate",
                text=s['audio_bitrate'],
                default=2,
                items=["64", "96", "128", "192", "256", "320"],
                icon="input_mic"
            ),
            Text(
                text=s['info_text'],
                icon="msg_info",
                on_click=on_info_click,
                create_sub_fragment=self._create_advanced_settings
            ),
            Divider(text=s['usage_cmd']),
        ]

api_url = self.get_setting("api_url", "https://default.api.url")
include_source = self.get_setting("include_source", True)

# Example: Update API URL after a successful validation
new_api_url = "https://verified.api.url"
self.set_setting("api_url", new_api_url)
 
# Example: Toggle a boolean setting
current_value = self.get_setting("some_toggle", False)
self.set_setting("some_toggle", not current_value)

from typing import Callable, List, Any
from android.view import View
 
class Switch:
    key: str
    # Unique identifier for this setting. Used with get_setting/set_setting.
    text: str
    # The main display text for the switch.
    default: bool
    # The default state (True for on, False for off) if no value is saved yet.
    subtext: str = None
    # Optional additional text displayed below the main text for more context.
    icon: str = None
    # Optional: Name of a drawable resource for an icon displayed next to the text.
    # These are typically Android drawable resource names (e.g., "ic_settings_24dp").
    # You can find standard Material Design icons or icons within the Telegram app's source code
    # (e.g., in TMessagesProj/src/main/res/drawable-* folders, use the filename without extension).
    on_change: Callable[[bool], None] = None
    # Optional: A function called immediately when the user toggles the switch in the UI.
    # Receives the new boolean state as an argument.
 
class Selector:
    key: str
    # Unique identifier for this setting.
    text: str
    # The main display text for the selector.
    default: int
    # The default selected INDEX from the 'items' list.
    items: List[str]
    # A list of strings representing the options the user can choose from.
    icon: str = None
    # Optional: Icon resource name. See Switch.icon for details.
    on_change: Callable[[int], None] = None
    # Optional: A function called immediately when the user selects a new item.
    # Receives the new selected index as an argument.
 
class Input:
    key: str
    # Unique identifier for this setting.
    text: str
    # The main display text for the input field.
    default: str = ""
    # The default string value if no value is saved yet.
    subtext: str = None
    # Optional additional text displayed below the main text.
    icon: str = None
    # Optional: Icon resource name. See Switch.icon for details.
    on_change: Callable[[str], None] = None
    # Optional: A function called immediately as the user types or changes the text in the UI.
    # Receives the new string value as an argument.
 
class Header:
    text: str
    # Text to be displayed as a section header, visually grouping settings below it.
 
class Divider:
    text: str = None
    # Optional text displayed on the divider line itself. If None, it's just a line.
    # Useful for short notes or separating sections more distinctly than a Header.
 
class Text:
    text: str
    # The main display text.
    icon: str = None
    # Optional: Icon resource name. See Switch.icon for details.
    accent: bool = False
    # If True, the text might be styled using the app's current theme accent color, making it stand out.
    red: bool = False
    # If True, the text might be styled in a standard red color, often used for warnings or destructive action confirmations.
    on_click: Callable[[View], None] = None
    # Optional: A function called when the user clicks on this text item.
    # The 'View' argument is the Android View object that was clicked.
    # This is ignored if 'create_sub_fragment' is also provided.
    create_sub_fragment: Callable[[], List[Any]] = None
    # Optional: A function that, when called, returns a new list of setting items (Switches, Inputs, etc.).
    # If provided, clicking this Text item will navigate the user to a new settings sub-page
    # populated with the items returned by this function. This allows for nested settings.

class DebugPlugin(BasePlugin):
    def on_plugin_load(self):
        # e.g. register hooks, initialize resources
        self.log("Plugin loaded!")
        pass
 
    def on_plugin_unload(self):
        # e.g. unregister hooks, clean up resources
        self.log("Plugin unloaded!")
        pass

from base_plugin import AppEvent
 
class DebugPlugin(BasePlugin):
    def on_app_event(self, event_type: AppEvent):
        if event_type == AppEvent.START:
            self.log("App is starting")
        elif event_type == AppEvent.STOP:
            self.log("App is stopping")
        elif event_type == AppEvent.PAUSE:
            self.log("App is being paused")
        elif event_type == AppEvent.RESUME:
            self.log("App is resuming")

from base_plugin import BasePlugin, MenuItemData, MenuItemType
from typing import Dict, Any
 
class MyMenuPlugin(BasePlugin):
    def on_plugin_load(self):
        self.log("Adding custom menu items...")
        self.add_menu_item(
            MenuItemData(
                menu_type=MenuItemType.MESSAGE_CONTEXT_MENU,
                text="Log Message Info",
                on_click=self.handle_message_click,
                icon="msg_info" # Example icon
            )
        )
        self.add_menu_item(
            MenuItemData(
                menu_type=MenuItemType.PROFILE_ACTION_MENU,
                text="Log User Info",
                on_click=self.handle_profile_click,
                icon="user_search" # Example icon
            )
        )
 
    def on_plugin_unload(self):
        # Menu items are removed automatically, no need for manual cleanup.
        self.log("MyMenuPlugin unloaded.")
 
    def handle_message_click(self, context: Dict[str, Any]):
        self.log(f"Message menu item clicked! Context keys: {list(context.keys())}")
        
        message = context.get("message")
        if message:
            self.log(f"Clicked on message ID: {message.getId()} from user: {message.getSenderId()}")
            self.log(f"Message text: {message.messageText}")
 
    def handle_profile_click(self, context: Dict[str, Any]):
        self.log(f"Profile menu item clicked! Context keys: {list(context.keys())}")
        
        user = context.get("user")
        if user:
            self.log(f"Profile menu clicked for user: {user.first_name} (ID: {user.id})")

self.remove_menu_item("my_unique_item_id")

from base_plugin import HookResult, HookStrategy
from typing import Any
 
def pre_request_hook(self, request_name: str, account: int, request: Any) -> HookResult:
    # Called before a request is sent to the server
    result = HookResult()
 
    if request_name == "TL_stories_sendReaction":
        self.log(f"Intercepted pre_request_hook for {request_name}")
        # Example: Modify the request
        # if hasattr(request, 'reaction'):
        #     request.reaction = TLRPC.TL_reactionEmoji(emoticon="👍") # Example modification
        #     result.strategy = HookStrategy.MODIFY
        #     result.request = request # Assign the modified request back
        pass
 
    return result
 
def post_request_hook(self, request_name: str, account: int, response: Any, error: Any) -> HookResult:
    # Called after a response (or error) is received from the server
    result = HookResult()
 
    if request_name == "TL_stories_sendReaction":
        self.log(f"Intercepted post_request_hook for {request_name}")
        if error:
            self.log(f"Request failed with error: {error.error_message}")
        elif response:
            self.log(f"Request succeeded with response: {type(response)}")
            # Example: Modify the response
            # if isinstance(response, TLRPC.TL_updates):
            #     # ... modify response ...
            #     result.strategy = HookStrategy.MODIFY
            #     result.response = response # Assign the modified response back
            pass
            
    return result

def on_update_hook(self, update_name: str, account: int, update: Any) -> HookResult:
    # Called when the app receives an individual update (e.g., TL_updateNewMessage)
    result = HookResult()
 
    if update_name == "TL_updateNewMessage":
        self.log(f"Intercepted on_update_hook for {update_name}")
        # Example: Process or modify the update
        # if hasattr(update, 'message') and hasattr(update.message, 'message'):
        #     if "secret" in update.message.message:
        #         update.message.message = "[REDACTED]"
        #         result.strategy = HookStrategy.MODIFY
        #         result.update = update # Assign the modified update back
        pass
 
    return result
 
def on_updates_hook(self, container_name: str, account: int, updates: Any) -> HookResult:
    # Called when the app receives a container of updates (e.g., TL_updates, TL_updatesCombined)
    result = HookResult()
 
    if container_name == "TL_updates" and hasattr(updates, 'updates'):
        self.log(f"Intercepted on_updates_hook for {container_name} with {len(updates.updates)} inner updates.")
        # Example: Filter updates
        # filtered_inner_updates = [upd for upd in updates.updates if not isinstance(upd, TLRPC.TL_updateUserStatus)]
        # if len(filtered_inner_updates) < len(updates.updates):
        #    updates.updates = ArrayList(filtered_inner_updates) # Assuming ArrayList is needed
        #    result.strategy = HookStrategy.MODIFY
        #    result.updates = updates # Assign the modified container back
        pass
        
    return result

def on_send_message_hook(self, account: int, params: Any) -> HookResult:
    # Called when a message is about to be sent by the client
    # `params` is an object (SendMessagesHelper.SendMessageParams) containing message details
    result = HookResult()
 
    if hasattr(params, 'message') and isinstance(params.message, str):
        self.log(f"Intercepted on_send_message_hook for message: {params.message[:30]}")
        # Example: Modify message parameters
        # if params.message.startswith(".shrug"):
        #     params.message = params.message.replace(".shrug", "¯\\_(ツ)_/¯")
        #     result.strategy = HookStrategy.MODIFY
        #     result.params = params # Assign the modified params object back
        pass
        
    return result