Merge pull request 'Bug fixes and small structural changes' (#7) from dev into master

Reviewed-on: profitroll/HoloCheckerBot#7

.gitignore

@@ -154,8 +154,11 @@ cython_debug/
 
 # Custom
 config.json
+config_debug.json
 *.session
 *.session-journal
-users
-!users/.gitkeep
-TASK.md
+data
+TASK.md
+inline_bot.py
+.vscode
+migrate.py

README.md

@@ -9,6 +9,8 @@ Small Telegram bot made on Pyrogram
 * Give one-time links to join group
 * Track down users that were not allowed to join
 * Show applications to other users
+* Manage YouTube sponsorships [WIP]
+* Send and receive messages to users using bot [WIP]
 
 ## Installation
 
@@ -27,32 +29,228 @@ You can see config file with all the comments below:
 
 ```json
 {
-    "locale": "uk", # locale file. it's a json located under locale folder
-    "owner": 0, # telegram ID of a bot owner
-    "age_allowed": 0, # minimum age of user that submits application
-    "admin_group": 0, # telegram ID of a admin's group
-    "destination_group": 0, # telegram ID of a user's group
-    "admins": [], # list of telegram ID's of users that are admins
+    "locale": "uk",
+    "debug": false,
+    "owner": 0,
+    "age_allowed": 0,
+    "api": "http://example.com",
+    "inline_preview_count": 7,
+    "remove_application_time": -1,
+    "search_radius": 50,
+    "admins": [],
+    "groups": {
+        "admin": 0,
+        "users": 0
+    },
     "bot": {
-        "api_id": 0, # telegram API ID
-        "api_hash": "", # telegram API hash
-        "bot_token": "" # telegram bot's token
+        "api_id": 0,
+        "api_hash": "",
+        "bot_token": ""
+    },
+    "database": {
+        "user": null,
+        "password": null,
+        "host": "127.0.0.1",
+        "port": 27017,
+        "name": "holochecker"
+    },
+    "geocoding": {
+        "username": "demo"
     },
     "logging": {
-        "size": 512, # size of log file in kbytes after which it should be rotated
-        "location": "logs" # location of logs folder. can be relative or absolute
+        "size": 512,
+        "location": "logs"
+    },
+    "features": {
+        "general": {
+            "enabled": true
+        },
+        "applications": {
+            "enabled": true
+        },
+        "sponsorships": {
+            "enabled": true
+        },
+        "warnings": {
+            "enabled": true
+        },
+        "invites_check": {
+            "enabled": true
+        },
+        "dinovoice": {
+            "enabled": false
+        },
+        "spoilers": {
+            "enabled": true
+        }
+    },
+    "scheduler": {
+        "birthdays": {
+            "time": 9,
+            "enabled": true
+        },
+        "sponsorships": {
+            "time": 9,
+            "enabled": true
+        },
+        "cache_avatars": {
+            "interval": 6,
+            "enabled": true
+        },
+        "cache_members": {
+            "interval": 30,
+            "enabled": true
+        },
+        "cache_admins": {
+            "interval": 120,
+            "enabled": true
+        }
     },
     "locations": {
-        "data": "data", # location of data folder. can be relative or absolute
-        "locale": "locale" # location of locale folder. can be relative or absolute
+        "cache": "cache",
+        "locale": "locale"
     },
-    "commands": {  # user command and its description
-        "start": "Start using the bot"
-    },
-    "commands_admin": { # admin commands and their description
-        "reboot": "Restart the bot"
+    "commands": {
+        "rules": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "spoiler": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "spoilers"
+            ]
+        },
+        "cancel": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "spoilers",
+                "applications",
+                "sponsorships"
+            ]
+        },
+        "nearby": {
+            "permissions": [
+                "users",
+                "admins",
+                "group_users",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "warn": {
+            "permissions": [
+                "group_users"
+            ],
+            "modules": [
+                "warnings"
+            ]
+        },
+        "reapply": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "sponsorship": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "sponsorships"
+            ]
+        },
+        "reboot": {
+            "permissions": [
+                "owner"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "label": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "message": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "identify": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications",
+                "sponsorships"
+            ]
+        },
+        "application": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "applications": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "resetcommands": {
+            "permissions": [
+                "owner"
+            ],
+            "modules": [
+                "general"
+            ]
+        }
     }
 }
 ```
 
 After all of that you're good to go! Happy using :)
+
+## To-Do
+
+* [ ] Stats and infographics
+* [ ] Check group members without completed application
+* [x] Replicate some functions of @spoilerobot
+* [x] Check sponsorship on Holo girls
+* [x] /nearby command
+* [x] Complete messenger between user and admins
+* [x] Get application by id and user_id  

api_avatars.py

@@ -0,0 +1,28 @@
+from os import makedirs, path, sep
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import FileResponse, JSONResponse, Response
+from starlette.status import HTTP_404_NOT_FOUND
+from modules.utils import configGet
+
+makedirs(f'{configGet("cache", "locations")}{sep}avatars', exist_ok=True)
+
+app = FastAPI(title="HoloUA Avatars API", docs_url=None, redoc_url=None, version="1.0")
+
+@app.get("/check", response_class=JSONResponse, include_in_schema=False)
+@app.head("/check", response_class=JSONResponse, include_in_schema=False)
+async def check():
+    return JSONResponse({"detail": "I'm alright, thank you"})
+
+@app.get("/", response_class=FileResponse, include_in_schema=False)
+async def avatar_get(avatar_id: str):
+    if path.exists(f'{configGet("cache", "locations")}{sep}avatars{sep}{avatar_id}'):
+        return FileResponse(f'{configGet("cache", "locations")}{sep}avatars{sep}{avatar_id}', media_type="image/jpg")
+    else:
+        raise HTTPException(status_code=HTTP_404_NOT_FOUND, detail="File not found")
+
+@app.head("/", response_class=Response, include_in_schema=False)
+async def avatar_head(avatar_id: str):
+    if path.exists(f'{configGet("cache", "locations")}{sep}avatars{sep}{avatar_id}'):
+        return Response(headers={"Content-Length": path.getsize(f'{configGet("cache", "locations")}{sep}avatars{sep}{avatar_id}')})
+    else:
+        raise HTTPException(status_code=HTTP_404_NOT_FOUND, detail="File not found")

app.py

@@ -0,0 +1,32 @@
+from os import path, sep
+from ujson import JSONDecodeError
+from modules.logging import logWrite
+from modules.utils import configGet, jsonLoad
+from pyrogram.client import Client
+from pyrogram.errors import bad_request_400
+
+app = Client("holochecker", bot_token=configGet("bot_token", "bot"), api_id=configGet("api_id", "bot"), api_hash=configGet("api_hash", "bot"))
+
+async def isAnAdmin(admin_id):
+
+    # Check if user is mentioned in config
+    if (admin_id == configGet("owner")) or (admin_id in configGet("admins")):
+        return True
+
+    # Check if user is probably in cache
+    if path.exists(f"cache{sep}admins") is True:
+        try:
+            return True if admin_id in jsonLoad(f"cache{sep}admins") else False
+        except (FileNotFoundError, JSONDecodeError):
+            pass
+    
+    # Check if user is in admin group
+    try:
+        async for member in app.get_chat_members(configGet("admin", "groups")):
+            if member.user.id == admin_id:
+                return True
+    except bad_request_400.ChannelInvalid:
+        logWrite(f"Could not get users in admin group to answer isAnAdmin(). Bot is likely not in the group.")
+        return False
+    
+    return False

classes/errors/geo.py

@@ -0,0 +1,5 @@
+class PlaceNotFoundError(Exception):
+    """Query provided did not lead to any city or populated area"""    
+    def __init__(self, query):
+        self.query = query
+        super().__init__(f"Could not find any place on geonames.org of feature classes A and P by query '{self.query}'")

classes/errors/holo_user.py

@@ -0,0 +1,24 @@
+"""Exceptions that are meant to be used by HoloUser class
+and other modules that handle those exceptions"""
+
+class UserNotFoundError(Exception):
+    """HoloUser could not find user with such an ID in database"""
+    def __init__(self, user, user_id):
+        self.user = user
+        self.user_id = user_id
+        super().__init__(f"User of type {type(self.user)} with id {self.user_id} was not found")
+
+class UserInvalidError(Exception):
+    """Provided to HoloUser object is not supported"""    
+    def __init__(self, user):
+        self.user = user
+        super().__init__(f"Could not find HoloUser by using {type(self.user)} as an input type")
+
+class LabelTooLongError(Exception):
+    def __init__(self, label: str) -> None:
+        self.label = label
+        super().__init__(f"Could not set label to '{label}' because it is {len(label)} characters long (16 is maximum)")
+
+class LabelSettingError(Exception):
+    def __init__(self, exp: Exception, trace: str) -> None:
+        super().__init__(f"❌ **Could not set label**\n\nException: `{exp}`\n\n**Traceback:**\n```\n{trace}\n```")

classes/holo_user.py

@@ -0,0 +1,494 @@
+from datetime import datetime
+from traceback import format_exc
+from app import app, isAnAdmin
+from typing import Any, List, Literal, Union
+from pyrogram.types import User, ChatMember, ChatPrivileges, Chat, Message, Photo, Video, Document, Animation, Voice, ForceReply, ReplyKeyboardMarkup
+from pyrogram.errors import bad_request_400
+from dateutil.relativedelta import relativedelta
+from classes.errors.geo import PlaceNotFoundError
+from classes.errors.holo_user import UserInvalidError, UserNotFoundError, LabelTooLongError, LabelSettingError
+from classes.templates import DefaultApplicationTemp, DefaultSponsorshipTemp
+from modules.database import col_tmp, col_users, col_applications, col_sponsorships, col_messages, col_spoilers
+from modules.logging import logWrite
+from modules.utils import configGet, find_location, locale, should_quote
+
+class HoloUser():
+    """This object represents a user of HoloChecker bot.
+    It is primarily used to interact with a database in a more python-friendly way,
+    as well as provide better programming experience in case of adding new features, etc.
+    """    
+
+    def __init__(self, user: Union[User, List[User], ChatMember, int]) -> None:
+        """A user of Holo bot. Used to simplify DB interaction.
+
+        ### Args:
+            * user (`Union[User, List[User], ChatMember, int]`): Any possible way to identify the user. Pass `User` object, user's telegram ID, etc...
+
+        ### Raises:
+            * UserInvalidError: Provided to `HoloUser` object is not supported
+            * UserNotFoundError: `HoloUser` could not find user with such an ID in database
+        """        
+
+        # Determine input object class and extract id
+        if isinstance(user, list) and len(user) != 0:
+            self.id = user[0].id
+        elif isinstance(user, User):
+            self.id = user.id
+        elif isinstance(user, ChatMember):
+            self.id = user.user.id
+        elif isinstance(user, int):
+            self.id = user
+        # elif isinstance(user, str):
+        #     try:
+        #         get_users = async_to_sync(app.get_users)
+        #         self.id = get_users(user).id # this line requires testing though
+        #     except bad_request_400.UsernameNotOccupied:
+        #         raise UserInvalidError(user)
+        #     except bad_request_400.PeerIdInvalid:
+        #         raise UserInvalidError(user)
+        else:
+            raise UserInvalidError(user)
+
+        # Find user record in DB
+        holo_user = col_users.find_one({"user": self.id})
+
+        if holo_user is None:
+            raise UserNotFoundError(user=user, user_id=self.id)
+
+        self.db_id = holo_user["_id"]
+
+        self.link = holo_user["link"]
+        self.label = holo_user["label"]
+        self.name = holo_user["tg_name"]
+        self.phone = holo_user["tg_phone"]
+        self.locale = holo_user["tg_locale"]
+        self.username = holo_user["tg_username"]
+
+        if isinstance(user, User):
+
+            if (self.name != user.first_name) and hasattr(user, "first_name") and (user.first_name is not None):
+                self.set("name", user.first_name, db_key="tg_name")
+
+            if (self.phone != user.phone_number) and hasattr(user, "phone") and (user.phone_number is not None):
+                self.set("phone", user.phone_number, db_key="tg_phone")
+
+            if (self.locale != user.language_code) and hasattr(user, "locale") and (user.language_code is not None):
+                self.set("locale", user.language_code, db_key="tg_locale")
+
+            if (self.username != user.username) and hasattr(user, "username") and (user.username is not None):
+                self.set("username", user.username, db_key="tg_username")
+    
+    def set(self, key: str, value: Any, db_key: Union[str, None] = None) -> None:
+        """Set attribute data and save it into database
+
+        ### Args:
+            * `key` (`str`): Attribute to be changed
+            * `value` (`Any`): Value to set
+        """        
+        if not hasattr(self, key):
+            raise AttributeError()
+        setattr(self, key, value)
+        db_key = key if db_key is None else db_key
+        col_users.update_one(filter={"_id": self.db_id}, update={ "$set": { db_key: value } }, upsert=True)
+        logWrite(f"Set attribute {key} of user {self.id} to {value}")
+
+    async def message(self,
+        context: Message,
+        origin: Union[Message, None] = None,
+        text: Union[str, None] = None,
+        caption: Union[str, None] = None,
+        photo: Union[str, Photo, None] = None,
+        video: Union[str, Video, None] = None,
+        file: Union[str, Document, None] = None,
+        animation: Union[str, Animation, None] = None,
+        voice: Union[str, Voice, None] = None,
+        adm_origin: bool = False,
+        adm_context: bool = False
+    ) -> None:
+        """Send a message to user
+
+        ### Args:
+            * context (`Message`): Context (mostly the message where this method is called)
+            * origin (`Union[Message, None]`, *optional*): Origin message where to refer. None if called in a command. Defaults to None.
+            * text (`Union[str, None]`, *optional*): Text if this is a simple text message. Defaults to None.
+            * caption (`Union[str, None]`, *optional*): Text if this is a media message. Defaults to None.
+            * photo (`Union[str, Photo, None]`, *optional*): Photo as a photo object or file_id as a string. Defaults to None.
+            * video (`Union[str, Video, None]`, *optional*): Video as a video object or file_id as a string. Defaults to None.
+            * file (`Union[str, Document, None]`, *optional*): File as a document object or file_id as a string. Defaults to None.
+            * animation (`Union[str, Animation, None]`, *optional*): Animation as an animation object or file_id as a string. Defaults to None.
+            * voice (`Union[str, Voice, None]`, *optional*): Voice as a voice object or file_id as a string. Defaults to None.
+            * adm_origin (`bool`, *optional*): Whether origin sender is an admin. Defaults to False.
+            * adm_context (`bool`, *optional*): Whether context sender is an admin. Defaults to False.
+        """    
+
+        # Check if any text available and log message sending
+        if text is not None:
+            logWrite(f"{context.from_user.id} sent message '{text}' to {self.id}")
+        elif caption is not None:
+            logWrite(f"{context.from_user.id} sent message '{caption}' to {self.id}")
+        else:
+            logWrite(f"{context.from_user.id} sent message to {self.id}")
+
+        # Add notices for admin or user
+        if text is not None:
+            if adm_context:
+                text += locale("message_reply_notice", "message")
+            elif adm_origin:
+                text = locale("message_from", "message").format(context.from_user.first_name, context.from_user.id) + text + locale("message_reply_notice", "message")
+        else:
+            text = locale("message_reply_notice", "message")
+
+        if caption is not None:
+            if adm_context:
+                caption += locale("message_reply_notice", "message")
+            elif adm_origin:
+                caption = locale("message_from", "message").format(context.from_user.first_name, context.from_user.id) + caption + locale("message_reply_notice", "message")
+        else:
+            caption = locale("message_reply_notice", "message")
+
+        # Try sending the message
+        try:
+
+            # Check if origin message exists
+            # This check decides whether we send_ a message or reply_ to one
+            if origin is not None:
+
+                if photo is not None:
+                    if isinstance(photo, Photo):
+                        photo = photo.file_id
+                    new_message = await origin.reply_cached_media(photo, caption=caption, quote=True)
+                elif video is not None:
+                    if isinstance(video, Video):
+                        video = video.file_id
+                    new_message = await origin.reply_cached_media(video, caption=caption, quote=True)
+                elif file is not None:
+                    if isinstance(file, Document):
+                        file = file.file_id
+                    new_message = await origin.reply_document(file, caption=caption, quote=True)
+                elif animation is not None:
+                    if isinstance(animation, Animation):
+                        animation = animation.file_id
+                    new_message = await origin.reply_cached_media(animation, caption=caption, quote=True)
+                elif voice is not None:
+                    if isinstance(voice, Voice):
+                        voice = voice.file_id
+                    new_message = await origin.reply_voice(voice, caption=caption, quote=True)
+                else:
+                    new_message = await origin.reply_text(text, quote=True)
+
+            else:
+
+                if photo is not None:
+                    if isinstance(photo, Photo):
+                        photo = photo.file_id
+                    new_message = await app.send_cached_media(self.id, photo, caption=caption)
+                elif video is not None:
+                    if isinstance(video, Video):
+                        video = video.file_id
+                    new_message = await app.send_cached_media(self.id, video, caption=caption)
+                elif file is not None:
+                    if isinstance(file, Document):
+                        file = file.file_id
+                    new_message = await app.send_document(self.id, file, caption=caption)
+                elif animation is not None:
+                    if isinstance(animation, Animation):
+                        animation = animation.file_id
+                    new_message = await app.send_cached_media(self.id, animation, caption=caption)
+                elif voice is not None:
+                    if isinstance(voice, Voice):
+                        voice = voice.file_id
+                    new_message = await app.send_cached_media(self.id, voice, caption=caption)
+                else:
+                    new_message = await app.send_message(self.id, text)
+
+            # Acknowledge sending a message and save entry into DB
+            await context.reply_text(locale("message_sent", "message"), quote=should_quote(context))
+            col_messages.insert_one({"origin": {"chat": context.chat.id, "id": context.id}, "destination": {"chat": new_message.chat.id, "id": new_message.id}})
+
+        # Report to admin and to sender about message sending failure
+        except Exception as exp:
+            logWrite(f"Exception {exp} happened as {context.from_user.id} tried to send message to {self.id}. Traceback:\n{format_exc()}")
+            try:
+                await app.send_message(configGet("owner"), locale("message_traceback", "message").format(context.from_user.id, self.id, exp, format_exc()))
+            except bad_request_400.PeerIdInvalid:
+                logWrite(f"Could not notify admin about failure when sending message! Admin has never interacted with bot!")
+            await context.reply_text(locale("message_error", "message"), quote=should_quote(context))
+
+    async def label_set(self, chat: Chat, label: str) -> None:
+        """Set label in destination group
+
+        ### Args:
+            * chat (`Chat`): Telegram chat
+            * label (`str`): Label you want to set
+        """        
+        if len(label) > 16:
+            raise LabelTooLongError(label)
+        self.label = label
+        try:
+            await app.promote_chat_member(configGet("users", "groups"), self.id, privileges=ChatPrivileges(can_pin_messages=True, can_manage_video_chats=True))
+            if not await isAnAdmin(self.id):
+                await app.set_administrator_title(configGet("users", "groups"), self.id, label)
+                self.set("label", label)
+        except Exception as exp:
+            logWrite(f"Could not set {self.id}'s title to '{self.label}' due to {exp}")
+            raise LabelSettingError(exp, format_exc())
+
+    async def label_reset(self, chat: Chat) -> None:
+        """Reset label in destination group
+
+        ### Args:
+            * chat (`Chat`): Telegram chat
+        """        
+        self.label = ""
+        self.set("label", "")
+        await app.set_administrator_title(configGet("users", "groups"), self.id, "")
+        if not await isAnAdmin(self.id):
+            await app.promote_chat_member(configGet("users", "groups"), self.id, privileges=ChatPrivileges(
+                can_manage_chat=False,
+                can_pin_messages=False,
+                can_manage_video_chats=False
+            ))
+
+    def application_state(self) -> tuple[Literal["none", "fill", "approved", "rejected"], bool]:
+        """Check the current state of application in tmp collection
+
+        ### Returns:
+            * `tuple[Literal["none", "fill", "approved", "rejected"], bool]`: First element is an enum of a state and the second one is whether application is complete.
+        """        
+        tmp_application = col_tmp.find_one({"user": self.id, "type": "application"})
+        if tmp_application is None:
+            return "none", False
+        else:
+            return tmp_application["state"], tmp_application["complete"]
+
+    def application_approved(self) -> bool:
+        """Check whether user has a completed application and it got approved
+
+        ### Returns:
+            * `bool`: `True` if yes and `False` if no
+        """        
+        return True if col_applications.find_one({"user": self.id}) is not None else False
+
+    def application_restart(self, reapply: bool = False) -> None:
+        """Reset application of a user in tmp collection and replace it with an empty one
+        """        
+        if col_tmp.find_one({"user": self.id, "type": "application"}) is None:
+            col_tmp.insert_one(document=DefaultApplicationTemp(self.id).dict)
+        else:
+            col_tmp.delete_one({"user": self.id, "type": "application"})
+            col_tmp.insert_one(document=DefaultApplicationTemp(self.id, reapply=reapply).dict)
+
+    async def application_next(self, query: str, msg: Message) -> None:
+        """Move on filling application of user
+
+        ### Args:
+            * query (`str`): Some kind of input
+            * msg (`Message`): Message that should receive replies
+        """           
+
+        # if col_tmp.find_one({"user": self.id, "type": "application"}) is None:
+
+        if self.sponsorship_state()[0] == "fill":
+            return
+
+        if self.spoiler_state() is True:
+            return
+
+            # col_tmp.insert_one(
+            #     document=DefaultApplicationTemp(self.id).dict
+            # )
+
+        progress = col_tmp.find_one({"user": self.id, "type": "application"})
+
+        if progress is None:
+            return
+
+        stage = progress["stage"]
+    
+        # if self.sponsorship_state()[0] == "fill":
+        #     await msg.reply_text(locale("finish_sponsorship", "message"), quote=should_quote(msg))
+        #     return
+
+        if progress["state"] == "fill" and progress["sent"] is False:
+
+            if stage == 2:
+
+                try:
+                    input_dt = datetime.strptime(query, "%d.%m.%Y")
+                except ValueError:
+                    logWrite(f"User {msg.from_user.id} failed stage {stage} due to sending invalid date format")
+                    await msg.reply_text(locale(f"question2_invalid", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage}", "force_reply", locale=self.locale))))
+                    return
+
+                if datetime.now() <= input_dt:
+                    logWrite(f"User {msg.from_user.id} failed stage {stage} due to joking")
+                    await msg.reply_text(locale("question2_joke", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale("question2", "force_reply", locale=self.locale))))
+                    return
+
+                elif ((datetime.now() - input_dt).days) < ((datetime.now() - datetime.now().replace(year=datetime.now().year - configGet("age_allowed"))).days):
+                    logWrite(f"User {msg.from_user.id} failed stage {stage} due to being underage")
+                    await msg.reply_text(locale("question2_underage", "message", locale=self.locale).format(str(configGet("age_allowed"))), reply_markup=ForceReply(placeholder=str(locale("question2", "force_reply", locale=self.locale))))
+                    return
+
+                else:
+                    progress["application"][str(stage)] = input_dt
+                    col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "application"}}, {"$set": {"application": progress["application"], "stage": progress["stage"]+1}})
+                    await msg.reply_text(locale(f"question{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage+1}", "force_reply", locale=self.locale))))
+
+            elif stage == 3:
+                try:
+                    progress["application"][str(stage)] = find_location(query)
+                    if ("lat" in progress["application"][str(stage)] and "lng" in progress["application"][str(stage)]):
+                        progress["application"][str(stage)]["location"] = [float(progress["application"][str(stage)]["lng"]), float(progress["application"][str(stage)]["lat"])]
+                        del progress["application"][str(stage)]["lat"]
+                        del progress["application"][str(stage)]["lng"]
+                    col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "application"}}, {"$set": {"application": progress["application"], "stage": progress["stage"]+1}})
+                    await msg.reply_text(locale("question3_found", "message", locale=self.locale).format(progress["application"][str(stage)]["name"], progress["application"][str(stage)]["adminName1"]))
+                    await msg.reply_text(locale(f"question{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage+1}", "force_reply", locale=self.locale))))
+                except PlaceNotFoundError:
+                    await msg.reply_text(locale("question3_invalid", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage}", "force_reply", locale=self.locale))))
+                    return
+                except Exception as exp:
+                    await msg.reply_text(locale("question3_error", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage}", "force_reply", locale=self.locale))))
+                    try:
+                        await app.send_message(configGet("owner"), locale("question3_traceback", "message", locale=self.locale).format(query, exp, format_exc()))
+                    except bad_request_400.PeerIdInvalid:
+                        logWrite(f"Could not notify admin about failure when sending message! Admin has never interacted with bot!")
+                    return
+
+            elif stage == 10:
+                progress["application"][str(stage)] = query
+                col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "application"}}, {"$set": {"application": progress["application"], "complete": True}})
+                application_content = []
+                i = 1
+                for question in progress["application"]:
+                    if i == 2:
+                        age = relativedelta(datetime.now(), progress['application']['2'])
+                        application_content.append(f"{locale('question'+str(i), 'message', 'question_titles', locale=self.locale)} {progress['application']['2'].strftime('%d.%m.%Y')} ({age.years} р.)")
+                    elif i == 3:
+                        if progress['application']['3']['countryCode'] == "UA":
+                            application_content.append(f"{locale('question'+str(i), 'message', 'question_titles', locale=self.locale)} {progress['application']['3']['name']} ({progress['application']['3']['adminName1']})")
+                        else:
+                            application_content.append(f"{locale('question'+str(i), 'message', 'question_titles', locale=self.locale)} {progress['application']['3']['name']} ({progress['application']['3']['adminName1']}, {progress['application']['3']['countryName']})")
+                    else:
+                        application_content.append(f"{locale('question'+str(i), 'message', 'question_titles', locale=self.locale)} {progress['application'][question]}")
+                    i += 1
+                await msg.reply_text(locale("confirm", "message", locale=self.locale).format("\n".join(application_content)), reply_markup=ReplyKeyboardMarkup(locale("confirm", "keyboard", locale=self.locale), resize_keyboard=True))
+
+            else:
+                progress["application"][str(stage)] = query
+                col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "application"}}, {"$set": {"application": progress["application"], "stage": progress["stage"]+1}})
+                await msg.reply_text(locale(f"question{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"question{stage+1}", "force_reply", locale=self.locale))))
+
+            logWrite(f"User {self.id} completed stage {stage} of application")
+
+        else:
+            return
+
+    def sponsorship_state(self) -> tuple[Literal["none", "fill", "approved", "rejected"], bool]:
+        """Check the current state of sponsorship in tmp collection
+
+        ### Returns:
+            * `tuple[Literal["none", "fill", "approved", "rejected"], bool]`: First element is an enum of a state and the second one is whether sponsorship application is complete.
+        """        
+        tmp_sponsorship = col_tmp.find_one({"user": self.id, "type": "sponsorship"})
+        if tmp_sponsorship is None:
+            return "none", False
+        else:
+            return tmp_sponsorship["state"], tmp_sponsorship["complete"]
+
+    def sponsorship_valid(self) -> bool:
+        """Check whether user has a valid sponsorship
+
+        ### Returns:
+            * `bool`: `True` if yes and `False` if no
+        """        
+        return True if col_sponsorships.find_one({"user": self.id, "expires": {"$gt": datetime.now()}}) is not None else False
+
+    def sponsorship_restart(self) -> None:
+        """Reset sponsorship of a user in tmp collection and replace it with an empty one
+        """        
+        if col_tmp.find_one({"user": self.id, "type": "sponsorship"}) is None:
+            col_tmp.insert_one(document=DefaultSponsorshipTemp(self.id).dict)
+        else:
+            col_tmp.delete_one({"user": self.id, "type": "sponsorship"})
+            col_tmp.insert_one(document=DefaultSponsorshipTemp(self.id).dict)
+
+    async def sponsorship_next(self, query: str, msg: Message, photo: Union[Photo, None] = None) -> None:
+        """Move on filling sponsorship of user
+
+        ### Args:
+            * query (`str`): Some kind of input
+            * msg (`Message`): Message that should receive replies
+        """           
+
+        progress = col_tmp.find_one({"user": self.id, "type": "sponsorship"})
+
+        if progress is not None:
+
+            stage = progress["stage"]
+
+            if progress["state"] == "fill" and progress["sent"] is False:
+
+                if stage == 1:
+
+                    progress["sponsorship"]["streamer"] = query
+                    col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "sponsorship"}}, {"$set": {"sponsorship": progress["sponsorship"], "stage": progress["stage"]+1}})
+                    await msg.reply_text(locale(f"sponsor{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"sponsor{stage+1}", "force_reply", locale=self.locale))))
+
+                elif stage == 2:
+
+                    try:
+                        input_dt = datetime.strptime(query, "%d.%m.%Y")
+                    except ValueError:
+                        logWrite(f"User {msg.from_user.id} failed stage {stage} due to sending invalid date format")
+                        await msg.reply_text(locale(f"sponsor2_invalid", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"sponsor{stage}", "force_reply", locale=self.locale))))
+                        return
+
+                    if datetime.now() >= input_dt:
+                        logWrite(f"User {msg.from_user.id} failed stage {stage} due to sending date in the past")
+                        await msg.reply_text(locale("sponsor2_past", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale("sponsor2", "force_reply", locale=self.locale))))
+                        return
+
+                    else:
+                        progress["sponsorship"]["expires"] = input_dt
+                        col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "sponsorship"}}, {"$set": {"sponsorship": progress["sponsorship"], "stage": progress["stage"]+1}})
+                        await msg.reply_text(locale(f"sponsor{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"sponsor{stage+1}", "force_reply", locale=self.locale))))
+
+                elif stage == 3:
+
+                    if photo is not None:
+                        progress["sponsorship"]["proof"] = photo.file_id
+                        col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "sponsorship"}}, {"$set": {"sponsorship": progress["sponsorship"], "stage": progress["stage"]+1}})
+                        await msg.reply_text(locale(f"sponsor{stage+1}", "message", locale=self.locale), reply_markup=ForceReply(placeholder=str(locale(f"sponsor{stage+1}", "force_reply", locale=self.locale))))
+
+                elif stage == 4:
+                    if len(query) > 16:
+                        await msg.reply_text(locale("label_too_long", "message"), reply_markup=ForceReply(placeholder=str(locale("sponsor4", "force_reply", locale=self.locale))))
+                        return
+                    progress["sponsorship"]["label"] = query
+                    col_tmp.update_one({"user": {"$eq": self.id}, "type": {"$eq": "sponsorship"}}, {"$set": {"sponsorship": progress["sponsorship"], "complete": True}})
+                    await msg.reply_cached_media(
+                        progress["sponsorship"]["proof"],
+                        caption=locale("sponsor_confirm", "message", locale=self.locale).format(
+                            progress["sponsorship"]["streamer"],
+                            progress["sponsorship"]["expires"].strftime("%d.%m.%Y"),
+                            progress["sponsorship"]["label"]
+                        ),
+                        reply_markup=ReplyKeyboardMarkup(locale("confirm", "keyboard", locale=self.locale), resize_keyboard=True))
+
+                else:
+                    return
+
+                logWrite(f"User {self.id} completed stage {stage} of sponsorship")
+
+            else:
+                return
+
+    def spoiler_state(self) -> bool:
+        """Check if user has any started but not finished spoilers
+
+        ### Returns:
+            * `bool`: `True` if any not finished spoilers available and `False` if none.
+        """        
+        return False if col_spoilers.find_one({"user": self.id, "completed": False}) is None else True

classes/templates.py

@@ -0,0 +1,46 @@
+"""Templates for temporary application/sponsorship records"""
+
+from datetime import datetime
+
+class DefaultApplicationTemp(dict):
+    def __init__(self, user: int, reapply: bool = False):
+        super().__init__({})
+        self.dict = {
+            "user": user,
+            "type": "application",
+            "complete": False,
+            "sent": False,
+            "state": "fill",
+            "reapply": reapply,
+            "stage": 1,
+            "application": {
+                "1": None,
+                "2": None,
+                "3": None,
+                "4": None,
+                "5": None,
+                "6": None,
+                "7": None,
+                "8": None,
+                "9": None,
+                "10": None
+            }
+        }
+
+class DefaultSponsorshipTemp(dict):
+    def __init__(self, user: int):
+        super().__init__({})
+        self.dict = {
+            "user": user,
+            "type": "sponsorship",
+            "complete": False,
+            "sent": False,
+            "state": "fill",
+            "stage": 1,
+            "sponsorship": {
+                "streamer": None,
+                "expires": datetime.fromtimestamp(0),
+                "proof": None,
+                "label": ""
+            }
+        }

config_example.json

@@ -1,27 +1,213 @@
 {
     "locale": "uk",
+    "debug": false,
     "owner": 0,
     "age_allowed": 0,
-    "admin_group": 0,
-    "destination_group": 0,
+    "api": "http://example.com",
+    "inline_preview_count": 7,
+    "remove_application_time": -1,
+    "search_radius": 50,
     "admins": [],
+    "groups": {
+        "admin": 0,
+        "users": 0
+    },
     "bot": {
         "api_id": 0,
         "api_hash": "",
         "bot_token": ""
     },
+    "database": {
+        "user": null,
+        "password": null,
+        "host": "127.0.0.1",
+        "port": 27017,
+        "name": "holochecker"
+    },
+    "geocoding": {
+        "username": "demo"
+    },
     "logging": {
         "size": 512,
         "location": "logs"
     },
+    "features": {
+        "general": {
+            "enabled": true
+        },
+        "applications": {
+            "enabled": true
+        },
+        "sponsorships": {
+            "enabled": true
+        },
+        "warnings": {
+            "enabled": true
+        },
+        "invites_check": {
+            "enabled": true
+        },
+        "dinovoice": {
+            "enabled": false
+        },
+        "spoilers": {
+            "enabled": true
+        }
+    },
+    "scheduler": {
+        "birthdays": {
+            "time": 9,
+            "enabled": true
+        },
+        "sponsorships": {
+            "time": 9,
+            "enabled": true
+        },
+        "cache_avatars": {
+            "interval": 6,
+            "enabled": true
+        },
+        "cache_members": {
+            "interval": 30,
+            "enabled": true
+        },
+        "cache_admins": {
+            "interval": 120,
+            "enabled": true
+        }
+    },
     "locations": {
-        "data": "data",
+        "cache": "cache",
         "locale": "locale"
     },
     "commands": {
-        "start": "Start using the bot"
-    },
-    "commands_admin": {
-        "reboot": "Restart the bot"
+        "rules": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "spoiler": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "spoilers"
+            ]
+        },
+        "cancel": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "spoilers",
+                "applications",
+                "sponsorships"
+            ]
+        },
+        "nearby": {
+            "permissions": [
+                "users",
+                "admins",
+                "group_users",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "warn": {
+            "permissions": [
+                "group_users"
+            ],
+            "modules": [
+                "warnings"
+            ]
+        },
+        "reapply": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "sponsorship": {
+            "permissions": [
+                "users",
+                "admins"
+            ],
+            "modules": [
+                "sponsorships"
+            ]
+        },
+        "reboot": {
+            "permissions": [
+                "owner"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "label": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "message": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "general"
+            ]
+        },
+        "identify": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications",
+                "sponsorships"
+            ]
+        },
+        "application": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "applications": {
+            "permissions": [
+                "admins",
+                "group_admins"
+            ],
+            "modules": [
+                "applications"
+            ]
+        },
+        "resetcommands": {
+            "permissions": [
+                "owner"
+            ],
+            "modules": [
+                "general"
+            ]
+        }
     }
 }

data/applications.json

@@ -1 +0,0 @@
-{}

data/user_default.json

@@ -1,24 +0,0 @@
-{
-    "stage": 0,
-    "link": null,
-    "sent": false,
-    "confirmed": false,
-    "approved": false,
-    "refused": false,
-    "telegram_id": null,
-    "telegram_name": null,
-    "telegram_phone": null,
-    "telegram_locale": null,
-    "application": {
-        "1": null,
-        "2": null,
-        "3": null,
-        "4": null,
-        "5": null,
-        "6": null,
-        "7": null,
-        "8": null,
-        "9": null,
-        "10": null
-    }
-}

holochecker.py

@@ -0,0 +1,84 @@
+from os import getpid, makedirs
+from time import time
+from modules.utils import *
+from modules.inline import *
+from app import app
+
+from pyrogram import idle
+
+pid = getpid()
+
+makedirs(f'{configGet("cache", "locations")}{sep}avatars', exist_ok=True)
+
+# Importing
+from modules.commands.application import *
+from modules.commands.applications import *
+from modules.commands.cancel import *
+from modules.commands.identify import *
+from modules.commands.label import *
+from modules.commands.message import *
+from modules.commands.nearby import *
+from modules.commands.reapply import *
+from modules.commands.reboot import *
+from modules.commands.resetcommands import *
+from modules.commands.rules import *
+from modules.commands.spoiler import *
+from modules.commands.sponsorship import *
+from modules.commands.start import *
+from modules.commands.warn import *
+from modules.commands.warnings import *
+
+from modules.callbacks.nothing import *
+from modules.callbacks.reapply import *
+from modules.callbacks.rules import *
+from modules.callbacks.sid import *
+from modules.callbacks.sponsorship import *
+from modules.callbacks.sub import *
+from modules.callbacks.sus import *
+
+from modules.handlers.confirmation import *
+from modules.handlers.contact import *
+from modules.handlers.group_join import *
+from modules.handlers.voice import *
+from modules.handlers.welcome import *
+from modules.handlers.everything import *
+
+from modules.scheduled import *
+
+if __name__ == "__main__":
+
+    logWrite(f"Starting up with pid {pid}")
+
+    # Yes, it should be in some kind of async main() function but I don't give a shit.
+    # I did compare performance, almost no difference and it's much more useful this way. Change my mind.
+    app.start()
+
+    try:
+        if path.exists(path.join(configGet("cache", "locations"), "shutdown_time")):
+            downtime = relativedelta(datetime.now(), datetime.fromtimestamp(jsonLoad(path.join(configGet("cache", "locations"), "shutdown_time"))["timestamp"]))
+            if downtime.days >= 1:
+                app.send_message(configGet("owner"), locale("startup_downtime_days", "message").format(pid, downtime.days))
+            elif downtime.hours >= 1:
+                app.send_message(configGet("owner"), locale("startup_downtime_hours", "message").format(pid, downtime.hours))
+            else:
+                app.send_message(configGet("owner"), locale("startup_downtime_minutes", "message").format(pid, downtime.minutes))
+        else:
+            app.send_message(configGet("owner"), locale("startup", "message").format(pid))
+    except bad_request_400.PeerIdInvalid:
+        logWrite(f"Could not send startup message to bot owner. Perhaps user has not started the bot yet.")
+
+    scheduler.start()
+
+    idle()
+
+    try:
+        app.send_message(configGet("owner"), locale("shutdown", "message").format(pid))
+    except bad_request_400.PeerIdInvalid:
+        logWrite(f"Could not send shutdown message to bot owner. Perhaps user has not started the bot yet.")
+
+    app.stop()
+
+    makedirs(configGet("cache", "locations"), exist_ok=True)
+    jsonSave({"timestamp": time()}, path.join(configGet("cache", "locations"), "shutdown_time"))
+    
+    killProc(pid)

locale/en.disabled

@@ -0,0 +1,215 @@
+{
+    "message": {
+        "start": "Hello and welcome! This bot was created to accept applications for joining our community. To continue, we are interested in the answer to one question:\n\nDo you want to join the Ukrainian community of Hololive fans?",
+        "goodbye": "Ok, thanks for your honesty! Sorry, but under such conditions we will not add you to the community. If you change your mind and want to join, just click the button.",
+        "privacy_notice": "We're glad to hear that!\n\nTo continue, you will need to fill out a short Application. Please take it seriously. We take personal data very seriously, so this Application will not be shared with any third parties, but will only be used for the community.",
+        "question1": "How can I contact you?",
+        "question2": "When is your birthday?",
+        "question3": "What city are you from or where do you live now?\n\n⚠️ Please do not provide exact addresses! \"Kyiv\" or \"Kyiv Oblast\" is a sufficient specification.\n\nExamples:\n- Kyiv\n- Odesa oblast\n- Makiivka (Luhansk oblast)",
+        "question4": "When did you first learn about Hololive?",
+        "question5": "What made you interested in Hololive?",
+        "question6": "Which girl's content do you like the most?",
+        "question7": "Name the content of at least five Japanese girls you like the most.",
+        "question8": "Do you watch streams of Hololive girls?",
+        "question9": "Whose songs from Hololive do you like the most?",
+        "question10": "And finally, tell us a little about yourself. About hobbies, what you like to do. In one message, please.",
+        "question2_underage": "Sorry, but you must be {0} years old to join us. These restrictions are in place to ensure that everyone in the community has fun with each other.",
+        "question2_invalid": "Please enter a date in the format `DD.MM.YYYY`.",
+        "question2_joke": "Joke, we get it. But please enter the real value.",
+        "question3_invalid": "City/population not found. Use the examples below to indicate where you live and try again:\n\n- Kyiv\n- Odesa region\n- Makiivka (Luhansk region).",
+        "question3_found": "Using the following result:\n- {0} ({1})",
+        "question3_error": "⚠️ **Error**\nCould not retrieve the geographic label. The developer has been notified of this error. Please try again.",
+        "question3_traceback": "⚠️ **Error occurred**\nError retrieving geocoding for `{0}`\nError: `{1}`\n\nTraceback:\n```\n{2}\n```",
+        "confirm": "Great, thanks!\n\nPlease check the data is correct:\n{0}\n\nEverything correct?",
+        "application_sent": "Thank you! We have sent your application for verification. You will receive a message as soon as it is checked and a decision is made. Until then, nothing more is required from you. Have a nice day :)",
+        "application_got": "Received an application from `{0}`\n\nName in tg: `{1}`\nUsername: @{2}\n\n**Application data:**\n{3}",
+        "reapply_got": "Received application change from `{0}`\n\nUsername: `{1}`\nUsername: @{2}\n\n**Application data:**\n{3}",
+        "shutdown": "Shutting down the bot with PID `{0}`",
+        "startup": "Starting the bot with PID `{0}`",
+        "startup_downtime": "Starting bot with PID `{0}` (was down for {1})",
+        "approved": "Congratulations! Your application has been reviewed and your eligibility has been confirmed. Use the button below the notification to join our lamp community!",
+        "approved_joined": "Congratulations! Your application has been reviewed and confirmed as correct. Thank you for your time and have a nice day!",
+        "read_rules": "Please read these rules before clicking the button and joining the chat.",
+        "rejected.": "Oh dear! Your application has been reviewed but not confirmed as eligible to join the community. Better luck next time!\n\nYou can try to reapply with the /reapply command.",
+        "rejected_aggressive": "Oh dear! Your application has been reviewed, but not confirmed as eligible to join the community.",
+        "rejected_russian": "Russian warship, go fuck yourself!",
+        "approved_by": "✅ **Application approved**\nAdmin **{0}** has reviewed and approved application `{1}`.",
+        "rejected_by": "❌ **Form rejected**\nAdmin **{0}** has reviewed and rejected form `{1}`.",
+        "rejected_by_agr": "❌ **Application rejected**\nAdmin **{0}** has reviewed and rejected application `{1}`, banning you from the community",
+        "rejected_by_rus": "❌ **Application rejected**\nAdmin **{0}** has reviewed and rejected the profile `{1}`, banning you from the community",
+        "contact": "Application `{0}`\n\n**Application data:**\n{1}\n\n{2}",
+        "application_status_accepted": "Accepted `{0}` on {1}",
+        "application_status_rejected": "Rejected `{0}` from {1}",
+        "application_status_on_hold": "Application still under review",
+        "application_status_not_send": "The application has not been sent yet",
+        "contact_invalid": "The submitted contact does not have a completed application form.",
+        "contact_not_member": "The sent contact is not a Telegram member.",
+        "already_sent": "The Application has already been sent, just wait. You will be informed immediately what decision will be made.",
+        "sus_joined": "User **{0}** (`{1}`) has joined the group without a personal invitation.",
+        "sus_allowed_by": "✅ **Access Allowed**\nAdmin **{0}** has allowed `{1}` to join the community without being personally invited.",
+        "sus_rejected_by": "❌ **Access denied**\nAdmin **{0}** has banned `{1}` for not being allowed to join the community via a personal link.",
+        "reapply_forbidden": "❌ **Action not possible**\nYour past application has not been approved or rejected yet.",
+        "reapply_in_progress": "❌ **Action not possible**\nYou are already filling out an application right now. If there is an error, just click the button below to start filling it out again.",
+        "reapply_restarted": "🔁 **Restarted**\nStarted filling out the application form again.",
+        "reapply_left_chat": "⚠️ **Reminder**\nIt seems that you left the chat in the past, but your profile is still available for use. Would you like to request membership using your old profile?",
+        "birthday": "User **{0}** (@{1}) has a birthday today! Turned {2} years old",
+        "application_invalid_syntax": "Invalid syntax! `/application ID/NAME/USERNAME`",
+        "warned": "**{0}** (`{1}`) rule violation warned",
+        "warned_reason": "Warned **{0}** (`{1}`)\n\n**Cause:**\n{2}",
+        "warnings_1": "User **{0}** (`{1}`) has **{2}** warnings",
+        "warnings_2": "User **{0}** (`{1}`) has **{2}** warnings",
+        "no_warnings": "User **{0}** (`{1}`) has no warnings",
+        "no_user_warnings": "No users found for query **{0}**",
+        "syntax_warnings": "Invalid syntax! `/warnings ID/NAME/USERNAME`",
+        "message_sent": "Message sent",
+        "message_no_user": "⚠️ **Sending Error**\nThe user ID provided is incorrect, so it was not possible to send the message to the user. Check if the ID is the same as the number that was shown in the Application.",
+        "message_invalid_syntax": "Invalid syntax! `/message ID MESSAGE`",
+        "message_from": "Message from **{0}** (`{1}`):\n\n",
+        "message_reply_notice": "\n\n**To send a reply to this message, tag it.**",
+        "message_error": "⚠️ **Error occurred**\nYour message could not be sent. The developer has been notified of this error.",
+        "message_traceback": "⚠️ **Error occurred**\nMessage error: `{0}` -> `{1}`\nError: `{2}`\n\nTraceback:\n```\n{3}\n```",
+        "no_user_application": "No users found for the query **{0}**",
+        "user_invalid": "The submitted user does not have a completed application.",
+        "joined_false_link": "User **{0}** (`{1}`) did not join the group using their link.",
+        "question_titles": {
+            "question1": "Name:",
+            "question2": "Birthday:",
+            "question3": "Residence:",
+            "question4": "Learned about Hololive:",
+            "question5": "Found interesting about Holo:",
+            "question6": "Like the content of:",
+            "question7": "Japanese hololive girls:",
+            "question8": "Watching streams:",
+            "question9": "Like songs:",
+            "question10": "About me:"
+        }
+    },
+    "keyboard": {
+        "welcome": [
+            [
+                "Yes, of course"
+            ],
+            [
+                "No, thank you."
+            ]
+        ],
+        "return": [
+            [
+                "I changed my mind, I want to"
+            ]
+        ],
+        "confirm": [
+            [
+                "Yes, everything is correct"
+            ],
+            [
+                "No, re-fill"
+            ]
+        ]
+    },
+    "force_reply": {
+        "question1": "Name",
+        "question2": "Birthday",
+        "question3": "City or region",
+        "question4": "Approximate time",
+        "question5": "Reasons, features",
+        "question6": "Girl's name",
+        "question7": "Five Japanese Holo girls",
+        "question8": "Yes or no",
+        "question9": "Name of the girl or girls",
+        "question10": "A bit about yourself"
+    },
+    "button": {
+        "sub_yes": "✅ Accept",
+        "sub_no": "❌ Reject",
+        "sub_aggressive": "🤡 Reject (Toxic)",
+        "sub_russian": "🇷🇺 Reject (Russian)",
+        "accepted": "✅ Accepted",
+        "declined": "❌ Rejected",
+        "join": "Join",
+        "sus_allow": "✅ Confirm permission",
+        "sus_reject": "❌ Permanently block",
+        "sus_allowed": "✅ Permission granted",
+        "sus_rejected": "❌ User blocked",
+        "reapply_yes": "✅ Accept",
+        "reapply_no": "❌ Reject",
+        "reapply_old_one": "✅ Send old one",
+        "reapply_new_one": "🔁 Fill in again",
+        "rules_home": "🏠 Home",
+        "rules_additional": "➕ Additional",
+        "rules_next": "Next ➡️",
+        "rules_prev": "⬅️ Back",
+        "applying_stop": "🛑 Interrupt filling",
+        "done": "✅ Done"
+    },
+    "callback": {
+        "sub_accepted": "✅ Application {0} has been approved",
+        "sub_rejected": "❌ Application {0} rejected",
+        "sub_aggressive": "🤡 Application {0} rejected",
+        "sub_russian": "🇷🇺 Application {0} rejected",
+        "sus_allowed": "✅ Access {0} allowed",
+        "sus_rejected": "❌ Access {0} denied",
+        "nothing": "🔔 Action already performed",
+        "rules_page": "ℹ️ Rule {0} shown",
+        "rules_home": "ℹ️ Home rule shown",
+        "rules_additional": "ℹ️ Additional rules shown",
+        "reapply_stopped": "ℹ️ Application stopped."
+    },
+    "inline": {
+        "forbidden": {
+            "title": "Action not available",
+            "description": "You do not have permission to view this",
+            "message_content": "No permission to view this."
+        },
+        "not_pm": {
+            "title": "Action not available",
+            "description": "This command is not available in channels.",
+            "message_content": "Action not available in channels."
+        },
+        "user": {
+            "title": "",
+            "description": "View {0}'s application (@{1})",
+            "message_content": "{0} (@{1})\n\n**Application Data:**\n{2}"
+        }
+    },
+    "rules_msg": "📢The rules can be supplemented and changed, depending on the need. In this case, violations that were committed before the introduction (change) of the rule will not be considered violations. You will be informed about all changes in the rules by means of pinned messages. But they will not be pinned on a permanent basis, so, from time to time, check the relevance of the rules in the bot.\n\n🔔If you see how one of the participants has violated the rules, tag one of the admins in response to a message that you think is a violation. In the post to the tag, indicate on which point you saw the violation. Or send a message to any of the administrators in private messages, and briefly describe the situation.\nList of administrators: @Chirkopol @Za_NerZula @Denialvapr\nFor questions about the functioning of the bot, please contact @Profitroll2281337\n\n❗️Any prohibited content can be sent to the chat using the bot - https://t.me/spoilerobot with a full description of the content contained under the spoiler. For an incorrect or incorrect description, a warning may be issued.\n\n‼️ Deleted or modified messages are still messages on your behalf that could be seen by chat participants and can be tracked through the admin panel.\n\n🔨 For violations - you will receive a warning. If you have 3 warnings, you will be banned for a day. For repeated violations, you will be immediately punished, without additional warnings.",
+    "rules": [
+        "1️⃣) \"HoloKyiv Chat\" and \"HoloUA (Hololive Ukraine) Chat\" are created exclusively for Ukrainians (13+). They can only contain people who: \n- Were born in Ukraine and currently reside in it.\n- Were born outside Ukraine but reside in it.\n- Were born in Ukraine but currently do not reside in it.\n\"HoloUA (Hololive Ukraine) Chat\" is open to all Ukrainians. To get into it, please fill in the form and wait for it to be approved by the administrators.\n\n\"HoloKyiv Chat\" can be accessed only in person if you live in Kyiv or are a close friend of one of the chat participants. To be added to the chat, write @Chirkopol in private messages.\n🔨 If in the process of communication it turns out that you are not Ukrainian, you will be removed from the chat until you become one. No offense. We are creating an exclusively Ukrainian community.",
+        "2️⃣) Distribution of NSFW content with direct or partially hidden pornographic content is prohibited. The content of \"erotic nature\" should be covered with \"questionable\" body parts.\nShock content with a large presence of blood and/or physical injuries is prohibited.",
+        "3️⃣) Anonymity of Hololive and Holostars participants is prohibited: \n- Photos\n- Names\n- Place of residence\n- Exact age (the word \"holohegs\" does not apply)\n- Details of personal life\n- Posts from rummage accounts or mentioning them with specific data (i.e. the phrase \"something happened on Kalli's irl channel\" is allowed, but \"something happened on *irl channel name*\" - no) \n- Details from the girls' past - only superficially and without specifics (i.e. \"was an office worker\" - ok, \"was in *company_name\" - no). \nExceptions - if the girls themselves mentioned it on the archive(!) streams.... This rule does not apply to those who are no longer in Hololive, or have never been part of it. But, please, treat the personal life of other vloggers with respect, and do not exaggerate with the deanons of their personalities.",
+        "4️⃣) Flooding with the same type of messages, emojis, emoticons, stickers, gifs, etc. is prohibited. The approximate number of messages that can receive a warning for this rule is 5. Each situation can be considered separately, but put all your thoughts in one message.",
+        "5️⃣) Video and audio messages that are not intended to convey what you have heard or seen are prohibited. If you want to tell us about how your day went, but do not have the opportunity to type a message, use the magical video-to-text converter - https://t.me/voicybot",
+        "6️⃣) Insults, threats, bullying, humiliation, trolling of participants, their family members, friends and other circle that is close to the chat participant are prohibited. Messages like: \"go to ... \" - are also insults. You can get a warning even if it was your friend. It will be removed if your friend confirms that he is not offended by you.\n🔨 If at the request of a member or administrator, you do not change the pace of communication and do not apologize, you will receive a warning.\nIf your behavior causes a member to leave the chat, the punishment may be more severe.",
+        "7️⃣) It is forbidden to provoke conflicts and incite hatred between chat participants.",
+        "8️⃣) Racism, sexism, homophobia and condemnation of political and (or) religious prejudice are prohibited. These topics can still be part of the dialogue if they do not contain direct condemnations, insults, etc.",
+        "9️⃣) Avatars, nicknames, roles that violate other rules are prohibited."
+    ],
+    "rules_additional": "Additional rules that are advisory in nature, and have no explicit penalties for violations:\n1️⃣) There is no ban on the Russian language in the chat. We respect every Ukrainian and do not want to incite language conflicts.\n2️↪Mn_e_20E3↩) There is no ban on Russian content in the chat. But, keep in mind that participants, for the most part, will not be interested in discussing it and it may be ignored.) Do not abuse swear words. Try to communicate in clean language.\n4️⃣) Respect the copyright of content makers. If you find art, animation, music, etc., on official resources (pixiv, twitter, deviantart, etc.), send a link to it.\nIf someone sent art from a non-official resource and you want to know its author, send a message with the text `/search` to the message with the art.",
+    "commands": {
+        "rules": "Check out the rules",
+        "nearby": "Show users near the area",
+        "reapply": "Resubmit the application",
+        "sponsorship": "Apply for sponsor role"
+    },
+    "commands_admin": {
+        "reboot": "Restart the bot",
+        "message": "Send a message",
+        "label": "Set user's nickname",
+        "warnings": "Check user's warnings",
+        "application": "Check user's application",
+        "applications": "Retrieve all applications as a JSON"
+    },
+    "commands_group_admin": {
+        "reboot": "Restart the bot",
+        "message": "Send a message",
+        "label": "Set user's nickname",
+        "nearby": "Show users near the area",
+        "warnings": "Check user's warnings",
+        "application": "Check user's application",
+        "applications": "Retrieve all applications as a JSON"
+    },
+    "commands_group_destination": {
+        "warn": "Warn a user",
+        "nearby": "Show users near the area"
+    }
+}

locale/uk.json

@@ -1,19 +1,11 @@
 {
-    "commands": {
-        "start": "Почати користуватись ботом",
-        "rules": "Правила пропонування фото"
-    },
-    "commands_admin": {
-        "forwards": "Переглянути репости",
-        "reboot": "Перезапустити бота"
-    },
     "message": {
         "start": "Привіт і ласкаво просимо!\n\nЦей бот створено для прийому заявок на вступ до нашої спільноти. Для продовження нас цікавить відповідь на одне питання:\n\nЧи хочеш ти доєднатися до українського ком'юніті фанатів Хололайв?",
         "goodbye": "Добре, дякуємо за чесність! Вибачте, але за таких умов ми не будемо тебе додавати до спільноти. Якщо передумаєш та захочеш приєднатись - просто натисни на кнопку.",
         "privacy_notice": "Раді це чути!\n\nДля продовження треба буде заповнити невеличку анкетку. Будь ласка, віднесись до цього серйозно. Ми відповідально ставимось до персональних даних, тому ця анкета не буде передана третім особам, а буде використана лише для проходження до спільноти.",
         "question1": "Як до тебе можна звертатись?",
-        "question2": "Скільки тобі років?",
-        "question3": "З якого ти міста та де проживаєш зараз?\n\n⚠️ Будь ласка, не вказуйте точних адрес! \"Київщина\" може бути достатньою конкретизацією.",
+        "question2": "Коли в тебе день народження?",
+        "question3": "З якого ти міста або де проживаєш зараз?\n\n⚠️ Будь ласка, не вказуйте точних адрес! \"Київ\" або \"Київська Область\" є достатньою конкретизацією.\n\nПриклади:\n• Київ\n• Одеська область\n• Макіївка (Луганська область)",
         "question4": "Коли вперше довелось дізнатись про Хололайв?",
         "question5": "Чим тебе зацікавив Хололайв?",
         "question6": "Контент якої дівчини тобі подобається найбільше?",
@@ -22,34 +14,116 @@
         "question9": "Чиї пісні з Хололайву тобі подобаються найбільше?",
         "question10": "Ну і нарешті, розкажи трохи про себе. Про хобі, чим тобі подобається займатись. Одним повідомленням, будь ласка.",
         "question2_underage": "Вибач, але треба досягти віку {0} років, щоб приєднатись до нас. Такі обмеження існують для того, щоб всім у спільноті було цікаво одне з одним.",
-        "question2_invalid": "Будь ласка, введи ціле число.",
+        "question2_invalid": "Будь ласка, введи дату формату `ДД.ММ.РРРР`",
         "question2_joke": "Шутнік, ми так і поняли. Але будь ласка, введи реальне значення.",
+        "question3_invalid": "Місто/населений пункт не знайдено. Користуйтесь прикладами нижче щоб вказати де ви проживаєте та спробуйте ще раз:\n\n• Київ\n• Одеська область\n• Макіївка (Луганська область)",
+        "question3_found": "Використовую наступний результат:\n• {0} ({1})",
+        "question3_error": "⚠️ **Сталась помилка**\nНе вдалось отримати географічну мітку. Розробника повідомлено про цю помилку. Будь ласка, спробуйте ще раз.",
+        "question3_traceback": "⚠️ **Сталась помилка**\nПомилка отримання геокодингу для `{0}`\nПомилка: `{1}`\n\nTraceback:\n```\n{2}\n```",
+        "sponsorship_apply": "ℹ️ Оформіть платну підписку на когось з Холо, заповніть форму та отримайте особливу роль в якості винагороди!",
+        "sponsorship_applying": "ℹ️ Розпочато заповнення форми на отримання бонусів за платну підписку на холодівчат.",
+        "sponsor1": "На яку саме дівчину платна підписка?",
+        "sponsor2": "До якої дати (`ДД.ММ.РРРР`) підписка?",
+        "sponsor2_invalid": "Будь ласка, введи дату формату `ДД.ММ.РРРР`",
+        "sponsor2_past": "Вказана дата знаходиться в минулому. Будь ласка, вкажіть правильний термін дії підписки",
+        "sponsor3": "Будь ласка, надішли одне фото для підтвердження дійсності підписки\n\nℹ️ **Підказка**\nПрочитай як правильно скрінити легітимне підтвердження підписки: https://telegra.ph/Pіdpiska-na-holo-dіvchinu-01-02",
+        "sponsor4": "Яку роль ти бажаєш отримати?\n\nℹ️ **Підказка**\nНазва ролі повинна бути якось пов'язана зі вказаною дівчиною, не повинна порушувати правила спільноти а також має бути не довше за 16 символів (обмеження Telegram).",
+        "sponsorship_application_empty": "❌ **Дія неможлива**\nУ тебе немає заповненої та схваленої анкети. Заповни таку за допомогою /reapply та спробуй ще раз після її підтвердження.",
         "confirm": "Супер, дякуємо!\n\nБудь ласка, перевір правильність даних:\n{0}\n\nВсе правильно?",
-        "application_sent": "Дякуємо! Ми надіслали твою анкетку на перевірку. Ти отримаєш повідомлення як тільки її перевірять та приймуть рішення. До тих пір від тебе більше нічого не потребується. Гарного дня! :)",
-        "application_got": "Отримано анкету від `{0}`\n\nІм'я тг: `{1}`, `{2}`\nUserID: `{3}`\n\n**Дані анкети:**\n{4}",
+        "sponsor_confirm": "**Дані форми:**\nСтрімер: {0}\nПідписка до: {1}\nХочу роль: {2}\n\nПеревір чи все правильно та жмакни кнопку на клавіатурі щоб продовжити.",
+        "application_sent": "Дякуємо! Ми надіслали твою анкетку на перевірку. Ти отримаєш повідомлення як тільки її перевірять та приймуть рішення. До тих пір від тебе більше нічого не потребується :)",
+        "sponsorship_sent": "Дякуємо! Ми надіслали форму на перевірку. Ти отримаєш повідомлення як тільки її перевірять та приймуть рішення :)",
+        "application_got": "Отримано анкету від `{0}`\n\nІм'я тг: `{1}`\nЮзернейм: @{2}\n\n**Дані анкети:**\n{3}",
+        "reapply_got": "Отримано оновлення анкети від `{0}`\n\nІм'я тг: `{1}`\nЮзернейм: @{2}\n\n**Дані анкети:**\n{3}",
+        "sponsor_got": "Отримано форму на спонсорство від `{0}`\n\nІм'я тг: `{1}`\nЮзернейм: @{2}\n\n**Дані форми:**\n{3}",
         "shutdown": "Вимкнення бота з підом `{0}`",
         "startup": "Запуск бота з підом `{0}`",
-        "startup_downtime": "Запуск бота з підом `{0}` (лежав {1})",
-        "sub_yes": "✅ Подання схвалено та прийнято",
-        "sub_no": "❌ Подання розглянуто та відхилено",
+        "startup_downtime_minutes": "Запуск бота з підом `{0}` (лежав {1} хв.)",
+        "startup_downtime_hours": "Запуск бота з підом `{0}` (лежав {1} год.)",
+        "startup_downtime_days": "Запуск бота з підом `{0}` (лежав {1} дн.)",
         "approved": "Вітаємо! Твою анкету переглянули та підтвердили твоє право на вступ. Скористайся кнопкою під повідомленням щоб вступити до нашої лампової спільноти!",
-        "refused": "Ой лишенько! Твою анкету переглянули, однак не підтвердили право на вступ до спільноти. Better luck next time!",
-        "refused_russian": "русский военньій корабль, иди нахуй!",
-        "approved_by": "✅ **Анкету схвалено**\nАдмін **{0}** переглянув та схвалив анкету `{1}`, дозволивши вступ до спільноти.",
-        "refused_by": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`, заборонивши вступ до спільноти.",
-        "refused_by_agr": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`, заборонивши вступ до спільноти.\nПричина: агресивна/токсична анкета.",
-        "refused_by_rus": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`, заборонивши вступ до спільноти.\nПричина: русня.",
+        "approved_joined": "Вітаємо! Твою анкету переглянули та підтвердили її правильність. Дякуємо за витрачений на заповнення час та гарного дня!",
+        "read_rules": "Будь ласка, прочитай ці правила перш ніж натискати на кнопку та приєднуватись до чату.",
+        "rejected": "Ой лишенько! Твою анкету переглянули, однак не підтвердили право на вступ до спільноти. Better luck next time!\n\nТи можеш спробувати повторно заповнити анкету командою /reapply",
+        "rejected_aggressive": "Ой лишенько! Твою анкету переглянули, однак не підтвердили право на вступ до спільноти.",
+        "rejected_russian": "русский военньій корабль, иди нахуй!",
+        "approved_by": "✅ **Анкету схвалено**\nАдмін **{0}** переглянув та схвалив анкету `{1}`.",
+        "rejected_by": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`.",
+        "rejected_by_agr": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`, заборонивши вступ до спільноти.\nПричина: агресивна/токсична анкета.",
+        "rejected_by_rus": "❌ **Анкету відхилено**\nАдмін **{0}** переглянув та відхилив анкету `{1}`, заборонивши вступ до спільноти.\nПричина: русня.",
+        "sponsor_approved": "Вітаємо! Твою форму переглянули та підтвердили її правильність. Коли термін дії наданої підписки буде добігати кінця - ми нагадаємо, що треба оновити дані аби й надалі отримувати плюшки в чаті. Також можна повторно заповнити форму, якщо хочеться змінити бажане ім'я ролі або подовжити термін дії підписки завчасно, за допомогою команди /sponsorship. Гарного дня!",
+        "sponsor_rejected": "Ой лишенько! Твою форму переглянули, однак не підтвердили її. Можливо, щось не так з датами, або ж бажана роль не може бути надана.\n\nТи можеш спробувати повторно заповнити форму командою /sponsorship",
+        "sponsor_approved_by": "✅ **Підписку схвалено**\nАдмін **{0}** переглянув та схвалив форму `{1}`.",
+        "sponsor_rejected_by": "❌ **Підписку відхилено**\nАдмін **{0}** переглянув та відхилив форму `{1}`.",
         "contact": "Анкета `{0}`\n\n**Дані анкети:**\n{1}\n\n{2}",
         "application_status_accepted": "Прийнята `{0}` від {1}",
-        "application_status_refused": "Відхилена `{0}` від {1}",
+        "application_status_rejected": "Відхилена `{0}` від {1}",
         "application_status_on_hold": "Анкета все ще на розгляді",
         "application_status_not_send": "Анкета ще не була відправлена",
-        "contact_invalid": "Надісланий контакт не має розпочатої анкети.",
+        "contact_invalid": "Надісланий контакт не має завершеної анкети.",
         "contact_not_member": "Надісланий контакт не є користувачем Telegram.",
         "already_sent": "Анкету вже надіслано, просто почекай. Тобі одразу повідомлять, яке рішення буде прийнято.",
+        "sus_joined": "Користувач **{0}** (`{1}`) зайшов до групи не за своїм персональним запрошенням.",
+        "sus_allowed_by": "✅ **Доступ дозволено**\nАдмін **{0}** дозволив `{1}` вступити до спільноти не за персональним посиланням.",
+        "sus_rejected_by": "❌ **Доступ заборонено**\nАдмін **{0}** заборонив `{1}` доступ до спільноти не за персональним посиланням.",
+        "reapply_forbidden": "❌ **Дія неможлива**\nТвоя минула анкета ще не була схвалена або відхилена.",
+        "reapply_in_progress": "❌ **Дія неможлива**\nТи прямо зараз вже заповнюєш анкету. Якщо в ній є помилка - просто натисни кнопку нижче щоб почати заповнювати спочатку.",
+        "reapply_restarted": "🔁 **Перезапущено**\nРозпочате заповнення анкети спочатку.",
+        "reapply_left_chat": "⚠️ **Нагадування**\nЗдається, ти залишив чат у минулому, проте твоя анкета все ще доступна до використання. Подати запит на вступ користуючись старою анкетою?",
+        "birthday": "У користувача **{0}** (@{1}) сьогодні день народження! Виповнилось {2} років",
+        "application_invalid_syntax": "Неправильний синтаксис!\nТреба: `/application ID/NAME/USERNAME`",
+        "warned": "Попереджено **{0}** (`{1}`) про порушення правил",
+        "warned_reason": "Попереджено **{0}** (`{1}`)\n\n**Причина:**\n{2}",
+        "warnings_1": "Користувач **{0}** (`{1}`) має **{2}** попередження",
+        "warnings_2": "Користувач **{0}** (`{1}`) має **{2}** попереджень",
+        "no_warnings": "Користувач **{0}** (`{1}`) не має попереджень",
+        "no_user_warnings": "Не знайдено користувачів за запитом **{0}**",
+        "syntax_warnings": "Неправильний синтаксис!\nТреба: `/warnings ID/NAME/USERNAME`",
+        "message_sent": "Повідомлення надіслано",
+        "message_no_user": "⚠️ **Помилка надсилання**\nВказано невірний ID користувача, тому не вдалось надіслати йому повідомлення. Перевірте чи в якості ID надано те число, яке було показане в анкеті.",
+        "message_invalid_syntax": "Неправильний синтаксис!\nТреба: `/message ID ПОВІДОМЛЕННЯ`",
+        "message_from": "Повідомлення від **{0}** (`{1}`):\n\n",
+        "message_reply_notice": "\n\n**Щоб надіслати відповідь на це повідомлення, тегніть його.**",
+        "message_error": "⚠️ **Сталась помилка**\nНе вдалось надіслати ваше повідомлення. Розробника повідомлено про цю помилку.",
+        "message_traceback": "⚠️ **Сталась помилка**\nПомилка повідомлень: `{0}` -> `{1}`\nПомилка: `{2}`\n\nTraceback:\n```\n{3}\n```",
+        "no_user_application": "Не знайдено користувачів за запитом **{0}**",
+        "user_invalid": "Надісланий користувач не має завершеної анкети.",
+        "joined_false_link": "Користувач **{0}** (`{1}`) приєднався до групи не за своїм посиланням",
+        "sponsorships_expires": "⚠️ **Нагадування**\nНадана платна підписка припинить діяти **за {0} д**. Будь ласка, оновіть дані про неї командою /sponsorship інакше роль буде втрачено!",
+        "sponsorships_expired": "⚠️ **Нагадування**\nТермін дії вказаної підписки сплив. Для повторного отримання ролі користуйся командою /sponsorship.",
+        "label_too_long": "Довжина назви ролі не повинна перевищувати 16 символів",
+        "finish_sponsorship": "❌ **Дія неможлива**\nПерш ніж заповнювати анкету, треба завершити заповнення форми спонсора або перервати його командою /cancel.",
+        "finish_application": "❌ **Дія неможлива**\nПерш ніж заповнювати форму спонсора, треба завершити заповнення анкети.",
+        "nearby_invalid": "ℹ️ **Місце не знайдено**\nЗа наданим запитом не знайдено місце з координатами. Спробуйте ще раз формулючи запит в стилі \"Чернівці\" або \"Київська область\".",
+        "nearby_error": "⚠️ **Сталась помилка**\n\nПомилка: `{0}`\n\nTraceback:\n```\n{1}\n```",
+        "nearby_result": "Результати пошуку:\n\n{0}",
+        "nearby_empty": "Здається, нікого поблизу немає.",
+        "cancel": "Всі поточні операції скасовано.",
+        "identify_invalid_syntax": "Неправильний синтаксис!\nТреба: `/identify ID/NAME/USERNAME`",
+        "identify_not_found": "Не знайдено користувачів за запитом **{0}**",
+        "identify_success": "Користувач `{0}`\n\nІм'я: {1}\nЮзернейм: {2}\nЄ в чаті: {3}\nЄ адміном: {4}\nРоль: {5}\nНаявна анкета: {6}\nНаявне спонсорство: {7}",
+        "spoiler_started": "Розпочато створення спойлера. Будь ласка, оберіть категорію спойлера за допомогою клавіатури бота.",
+        "spoiler_unfinished": "У вас ще є незавершений спойлер. Надішліть /cancel щоб зупинити його створення",
+        "spoiler_cancel": "Створення спойлера було припинено",
+        "spoiler_empty": "Спойлер категорії \"{0}\" без опису",
+        "spoiler_described": "Спойлер категорії \"{0}\": {1}",
+        "spoiler_description_enter": "Добре, введіть бажаний опис спойлера",
+        "spoiler_using_description": "Встановлено опис спойлера: {0}\n\nЗалишилось додати вміст самого спойлера. Бот приймає текстове повідомлення, фото, відео, файл а також гіф зображення (1 шт.)",
+        "spoiler_send_description": "Тепер треба надіслати коротенький опис спойлера, щоб люди розуміли що під ним варто очкувати. Надішли мінус (-) щоб пропустити цей крок.",
+        "spoiler_ready": "Успіх! Спойлер створено. Користуйтесь кнопкою нижче щоб надіслати його.",
+        "spoiler_incorrect_content": "Бот не підтримує такий контент. Будь ласка, надішли текст, фото, відео, файл або анімацію (гіф).",
+        "spoiler_incorrect_category": "Вказана категорія не є дійсною. Будь ласка, користуйся клавіатурою бота (кнопка біля 📎) для вибору категорії.",
+        "spoiler_in_progress": "❌ **Дія неможлива**\nПерш ніж починати нову дію, треба завершити створення спойлера або перервати його командою /cancel.",
+        "yes": "Так",
+        "no": "Ні",
+        "voice_message": [
+            "why are u gae",
+            "руки відірвало? пиши як людина",
+            "унга-бунга, не маєш клавіатури?"
+        ],
         "question_titles": {
             "question1": "Ім'я/звертання:",
-            "question2": "Вік:",
+            "question2": "День народження:",
             "question3": "Проживаня:",
             "question4": "Дізнався(лась) про холо:",
             "question5": "Хололайв зацікавив:",
@@ -58,6 +132,16 @@
             "question8": "Дивлюсь стріми:",
             "question9": "Подобаються пісні:",
             "question10": "Про себе:"
+        },
+        "sponsor_titles": {
+            "question_streamer": "Стрімер:",
+            "question_expires": "Підписка до:",
+            "question_label": "Хоче роль:"
+        },
+        "spoiler_categories": {
+            "nsfw": "NSFW контент",
+            "deanon": "Деанон холо-учасників",
+            "other": "Інше"
         }
     },
     "keyboard": {
@@ -81,11 +165,22 @@
             [
                 "Ні, повторно заповнити"
             ]
+        ],
+        "spoiler_categories": [
+            [
+                "NSFW контент"
+            ],
+            [
+                "Деанон холо-учасників"
+            ],
+            [
+                "Інше"
+            ]
         ]
     },
     "force_reply": {
         "question1": "Ім'я або звертання",
-        "question2": "Твій вік",
+        "question2": "День народження",
         "question3": "Місто або область",
         "question4": "Орієнтовний час",
         "question5": "Риси, особливості",
@@ -93,21 +188,108 @@
         "question7": "П'ять японських холодівчат",
         "question8": "Так або ні",
         "question9": "Ім'я дівчини або дівчин",
-        "question10": "Трошки про себе"
+        "question10": "Трошки про себе",
+        "sponsor1": "Ім'я дівчини",
+        "sponsor2": "Дата до якої підписка",
+        "sponsor3": "Фото-підтвердження",
+        "sponsor4": "Бажана роль",
+        "spoiler_content": "Вміст спойлера",
+        "spoiler_description": "Опис спойлера"
     },
     "button": {
         "sub_yes": "✅ Прийняти",
         "sub_no": "❌ Відхилити",
-        "sub_no_aggressive": "🤡 Відхилити (Токс)",
-        "sub_no_russian": "🇷🇺 Відхилити (Русак)",
+        "sub_aggressive": "🤡 Відхилити (Токс)",
+        "sub_russian": "🇷🇺 Відхилити (Русак)",
+        "sponsor_yes": "✅ Прийняти",
+        "sponsor_no": "❌ Відхилити",
         "accepted": "✅ Прийнято",
         "declined": "❌ Відхилено",
-        "join": "Приєднатись"
+        "join": "Приєднатись",
+        "sus_allow": "✅ Підтвердити дозвіл",
+        "sus_reject": "❌ Перманентно заблокувати",
+        "sus_allowed": "✅ Дозвіл надано",
+        "sus_rejected": "❌ Користувача заблоковано",
+        "reapply_yes": "✅ Прийняти",
+        "reapply_no": "❌ Відхилити",
+        "reapply_old_one": "✅ Надіслати стару",
+        "reapply_new_one": "🔁 Заповнити знову",
+        "rules_home": "🏠 Головна",
+        "rules_additional": "➕ Додаткові",
+        "rules_next": "Далі ➡️",
+        "rules_prev": "⬅️ Назад",
+        "applying_stop": "🛑 Перервати заповнення",
+        "done": "✅ Готово",
+        "sponsor_apply": "Заповнити форму",
+        "sponsor_started": "Форму розпочато",
+        "spoiler_send": "Надіслати",
+        "spoiler_view": "Переглянути"
     },
     "callback": {
         "sub_accepted": "✅ Анкету {0} схвалено",
-        "sub_refused": "❌ Анкету {0} відхилено",
-        "sub_no_aggressive": "🤡 Анкету {0} відхилено",
-        "sub_no_russian": "🇷🇺 Анкету {0} відхилено"
+        "sub_rejected": "❌ Анкету {0} відхилено",
+        "sub_aggressive": "🤡 Анкету {0} відхилено",
+        "sub_russian": "🇷🇺 Анкету {0} відхилено",
+        "sus_allowed": "✅ Доступ {0} дозволено",
+        "sus_rejected": "❌ Доступ {0} заборонено",
+        "nothing": "🔔 Дія вже виконана",
+        "rules_page": "ℹ️ Показано правило {0}",
+        "rules_home": "ℹ️ Показано головну правил",
+        "rules_additional": "ℹ️ Показано додаткові правила",
+        "reapply_stopped": "ℹ️ Перервано заповнення анкети",
+        "sponsor_started": "ℹ️ Заповнення форми розпочато",
+        "sponsor_accepted": "✅ Форму {0} схвалено",
+        "sponsor_rejected": "❌ Форму {0} відхилено"
+    },
+    "inline": {
+        "forbidden": {
+            "title": "Дія недоступна",
+            "description": "Ти не маєш дозволу переглядати це",
+            "message_content": "Немає дозволу на перегляд."
+        },
+        "not_pm": {
+            "title": "Дія недоступна",
+            "description": "Ця команда недоступна в каналах",
+            "message_content": "Дія недоступна в каналах."
+        },
+        "user": {
+            "title": "",
+            "description": "Переглянути анкету {0} (@{1})",
+            "message_content": "{0} (@{1})\n\n**Дані анкети:**\n{2}"
+        },
+        "spoiler": {
+            "title": "Відправити",
+            "description": "Надіслати цей спойлер до чату"
+        }
+    },
+    "rules_msg": "📢Правила можуть доповнюватись та змінюватись, залежно від потреби. У такому разі, порушення, які були вчинені до введення (змінення) правила, порушеннями вважатися не будуть. Про всі зміни в правилах, ви будете проінформовані за допомогою закріплених повідомлень. Але вони не будуть закріплені на постійній основі, тому, час від часу, перевіряйте актуальність правил у боті.\n\n🔔Якщо ви бачите, як хтось із учасників порушив правила, тегніть одного із адмінів, у відповідь на повідомлення, яке, на вашу думку, є порушенням. У дописі до тегу, вкажіть, по якому пункту ви побачили порушення. Або перешліть повідомлення до будь кого із адміністраторів у особисті повідомлення, та коротко опишіть ситуацію.\nСписок адміністраторів: @Chirkopol @Za_NerZula @Denialvapr\nЗ питань функціонування бота звертайтесь до @Profitroll2281337\n\n❗️Будь-який заборонений контент, може бути відправлений до чату за допомогою бота - https://t.me/spoilerobot з повним описом контенту, що міститься під спойлером. За неправильний або некоректний опис, може бути видане попередження.\n\n‼️Видалені або змінені повідомлення, все ще є повідомленнями від вашого імені, які могли побачити учасники чату, і які можуть бути відстежені через адмінську панель.\n\n🔨 За порушення - ви отримаєте попередження. За наявності 3-х попереджень - мут на добу. За повторні порушення, ви одразу отримаєте покарання, без додаткових попереджень.",
+    "rules": [
+        "1️⃣) \"HoloKyiv Chat\" та \"HoloUA (Hololive Ukraine) Chat\" створені виключно для українців (13+). В них можуть знаходитись тільки люди які: \n- Народились в Україні, та проживають, на данний момент, у ній.\n- Народились за межами України, але проживають у ній.\n- Народились в Україні але, на даний момент, не проживають у ній.\n\"HoloUA (Hololive Ukraine) Chat\" відкритий для усіх українців. Щоб потрапити до нього, заповніть, будь ласка, анкету, та дочекайтесь, поки її схвалять адміни.\nУ \"HoloKyiv Chat\" можна потрапити тільки особисто, якщо ви проживаєте у Київі, або є близьким другом одного із учасників чату. Із приводу додавання до чату пишіть @Chirkopol у приватні повідомлення.\n🔨 Якщо у процесі спілкування виявиться, що ви не українець, вас буде видалено із чату, до моменту, поки ви їм не станете. Без образ. Ми створюємо виключно українське ком'юніті.",
+        "2️⃣) Заборонено поширення NSFW-контенту з прямим або частково прихованим порнографічним змістом. На контенті \"еротичного характеру\" повинні бути закриті \"сумнівні\" ділянки тіл. \nЗаборонено поширення шок-контенту з великою наявністю крові та/або фізичних пошкоджень.",
+        "3️⃣) Анонімність учасників Хололайв та Холостарз.\nЗаборонено: \n- Фотографії\n- Імена\n- Місце проживання\n- Точний вік  (слово \"холохеґз\" не підпадає)\n- Подробиці особистого життя\n- Пости з руммейт акаунтів чи згадка про них з конкретними даними (тобто фраза \"там на ірл каналі Каллі щось вийшло\" - можна, а \"там на *назва ірл каналу* щось вийшло\" - ні)\n- Подробиці з минулого дівчат - лише поверхнево і без конкретики (тобто \"була офісним працівником\" - ок, \"була в *компанія_нейм*\" - ні).\nВиключення - якщо дівчата самі згадували про це на архівних(!) стрімах.\n❗️Це правило не стосується тих, хто вже не знаходиться у Хололайві, або ніколи і не був його частиною. Але, прохання, відноситись до особистого життя інших вітуберів із повагою, та не перебільшувати із деанонами їх особистостей.",
+        "4️⃣) Заборонено флуд однотипними повідомленнями, емодзі, смайликами, стікерами, гіфками тощо. Орієнтовна кількість повідомлень, які можуть отримати попередження за це правило - 5. Кожна ситуація може розглядатись окремо, але вкладайте усі свої думки в одне повідомлення.",
+        "5️⃣) Заборонені відео та аудіо-повідомлення, які не несуть цілі передати почуте, або побачене. Якщо ви бажаєте розповісти про те, як пройшов ваш день, але не маєте можливості друкувати повідомлення, використовуйте магічний перетворювач войсів у текст - https://t.me/voicybot",
+        "6️⃣) Заборонені образи, погрози, булінг, приниження, тролінг учасників, членів їхніх сімей, друзів та іншого кола, що є наближеними до учасника чату. Повідомлення на кшталт: \"йди на ... \" - також є образами. Ви можете отримати попередження, навіть, якщо це був ваш приятель. Воно буде зняте, якщо приятель підтвердить, що не ображений на вас.\n🔨 Якщо на прохання учасника або адміністратора, ви не зміните темп спілкування і не вибачитесь, то отримаєте попередження. \n⚒ Якщо ваша поведінка спричинить те, що учасник залишив чат, покарання може бути жорсткішим.",
+        "7️⃣) Заборонено провокування конфліктів та розпалювання ненависті між учасниками чату.",
+        "8️⃣) Заборонені прояви расизму, сексизму, гомофобії та засудження за політичні та (або) релігійні упередження. Дані теми все ще можуть бути частиною діалогу, якщо не несуть у собі прямих засуджень, образ тощо.",
+        "9️⃣) Заборонені аватарки, нікнейми, ролі, які порушують інші правила."
+    ],
+    "rules_additional": "Додаткові правила, які несуть рекомендаційний характер, та не мають явних покарань за порушення:\n1️⃣) У чаті немає заборони на російську мову. Ми поважаємо кожного українця і не бажаємо розпалювати мовні конфлікти.\n2️⃣) У чаті немає заборони на російський контент. Але, майте на увазі, що учасники, здебільшого, не будуть зацікавлені у тому, щоб обговорювати його і він може бути проігнорованим.\n3️⃣) Не зловживайте матами. Намагайтесь спілкуватись чистою мовою.\n4️⃣) Поважайте авторські права контентмейкерів. Якщо ви знаходите арт, анімацію, музику тощо, на офіційних ресурсах (pixiv, twitter, deviantart тощо), відправляйте на нього посилання.\nЯкщо хтось із учасників відправив арт із не офіційного ресурсу і ви бажаєте дізнатись його автора, відправте у відповідь повідомлення із текстом `/search` на повідомлення із артом.",
+    "commands": {
+        "application": "Переглянути анкету користувача",
+        "applications": "Отримати всі анкети як JSON",
+        "cancel": "Відмінити актуальну дію",
+        "identify": "Дізнатись дані про користувача за айді",
+        "label": "Встановити нікнейм користувачу",
+        "message": "Надіслати користувачу повідомлення",
+        "nearby": "Показати користувачів поблизу",
+        "reapply": "Повторно заповнити анкету",
+        "reboot": "Перезапустити бота",
+        "resetcommands": "Відреєструвати всі команди",
+        "rules": "Правила спільноти",
+        "spoiler": "Почати створювати спойлер",
+        "sponsorship": "Отримати роль за спонсорство",
+        "warn": "Попередити користувача",
+        "warnings": "Переглянути попередження користувача"
     }
 }

main.py

@@ -1,375 +0,0 @@
-from datetime import datetime, timedelta
-from time import time
-from os import getpid, path
-from modules.utils import *
-
-from pyrogram.client import Client
-from pyrogram import filters
-from pyrogram.enums.parse_mode import ParseMode
-from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, BotCommand, BotCommandScopeChat, ReplyKeyboardMarkup, ForceReply, ReplyKeyboardRemove
-from pyrogram import idle # type: ignore
-from pyrogram.errors.exceptions import bad_request_400
-
-
-pid = getpid()
-app = Client("holochecker", bot_token=configGet("bot_token", "bot"), api_id=configGet("api_id", "bot"), api_hash=configGet("api_hash", "bot"))
-
-
-# Start command ================================================================================================================
-@app.on_message(~ filters.scheduled & filters.private & filters.command(["start"], prefixes=["/"]))
-async def cmd_start(app, msg):
-
-    try:
-        user_stage = configGet("stage", file=str(msg.from_user.id))
-        if user_stage != 0:
-            return
-    except FileNotFoundError:
-        jsonSave(jsonLoad(f"{configGet('data', 'locations')}{sep}user_default.json"), f"{configGet('data', 'locations')}{sep}users{sep}{msg.from_user.id}.json")
-        user_stage = configGet("stage", file=str(msg.from_user.id))
-        configSet("telegram_id", str(msg.from_user.username), file=str(msg.from_user.id))
-        configSet("telegram_name", f"{msg.from_user.first_name} {msg.from_user.last_name}", file=str(msg.from_user.id))
-        configSet("telegram_phone", str(msg.from_user.phone_number), file=str(msg.from_user.id))
-        configSet("telegram_locale", str(msg.from_user.language_code), file=str(msg.from_user.id))
-
-    logWrite(f"User {msg.from_user.id} started bot interaction")
-    await msg.reply_text(locale("start", "message"), reply_markup=ReplyKeyboardMarkup(locale("welcome", "keyboard"), resize_keyboard=True)) # type: ignore
-# ==============================================================================================================================
-
-
-# Shutdown command =============================================================================================================
-@app.on_message(~ filters.scheduled & filters.private & filters.command(["kill", "die", "reboot"], prefixes=["", "/"]))
-async def cmd_kill(app, msg):
-
-    if (msg.from_user.id == configGet("owner")) or (msg.from_user.id in configGet("admins")):
-        logWrite(f"Shutting down bot with pid {pid}")
-        await msg.reply_text(f"Вимкнення бота з підом `{pid}`")
-        killProc(pid)
-# ==============================================================================================================================
-
-
-# Welcome check ================================================================================================================
-@app.on_message(~ filters.scheduled & filters.private & (filters.regex(locale("welcome", "keyboard")[0][0]) | filters.regex(locale("return", "keyboard")[0][0])))
-async def welcome_pass(app, msg, once_again: bool = True):
-
-    if not once_again:
-        await msg.reply_text(locale("privacy_notice", "message"))
-        
-    logWrite(f"User {msg.from_user.id} confirmed starting the application")
-    await msg.reply_text(locale("question1", "message"), reply_markup=ForceReply(placeholder=locale("question1", "force_reply"))) # type: ignore
-    configSet("stage", 1, file=str(msg.from_user.id))
-
-@app.on_message(~ filters.scheduled & filters.private & (filters.regex(locale("welcome", "keyboard")[1][0])))
-async def welcome_reject(app, msg):
-
-    logWrite(f"User {msg.from_user.id} refused to start the application")
-    await msg.reply_text(locale("goodbye", "message"), reply_markup=ReplyKeyboardMarkup(locale("return", "keyboard"), resize_keyboard=True)) # type: ignore
-# ==============================================================================================================================
-
-
-# Confirmation =================================================================================================================
-@app.on_message(~ filters.scheduled & filters.private & (filters.regex(locale("confirm", "keyboard")[0][0])))
-async def confirm_yes(app, msg):
-
-    user_stage = configGet("stage", file=str(msg.from_user.id))
-
-    if user_stage == 10:
-
-        if not configGet("sent", file=str(msg.from_user.id)):
-
-            await msg.reply_text(locale("application_sent", "message"), reply_markup=ReplyKeyboardRemove())
-
-            applications = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")
-
-            applications[str(msg.from_user.id)] = {
-                "approved": False,
-                "approved_by": None,
-                "approval_date": None,
-                "refused": False,
-                "refused_by": False,
-                "refusal_date": False,
-                "application_date": int(time()),
-                "application": configGet("application", file=str(msg.from_user.id))
-            }
-
-            jsonSave(applications, f"{configGet('data', 'locations')}{sep}applications.json")
-
-            application_content = []
-            i = 1
-
-            for question in configGet("application", file=str(msg.from_user.id)):
-                application_content.append(f"{locale('question'+str(i), 'message', 'question_titles')} {configGet('application', file=str(msg.from_user.id))[question]}")
-                i += 1
-
-            await app.send_message(chat_id=configGet("admin_group"), text=(locale("application_got", "message")).format(str(msg.from_user.id), msg.from_user.first_name, msg.from_user.last_name, msg.from_user.username, "\n".join(application_content)), parse_mode=ParseMode.MARKDOWN, reply_markup=InlineKeyboardMarkup( # type: ignore
-                    [
-                        [
-                            InlineKeyboardButton(text=str(locale("sub_yes", "button")), callback_data=f"sub_yes_{msg.from_user.id}")
-                        ],
-                        [
-                            InlineKeyboardButton(text=str(locale("sub_no", "button")), callback_data=f"sub_no_{msg.from_user.id}")
-                        ],
-                        [
-                            InlineKeyboardButton(text=str(locale("sub_no_aggressive", "button")), callback_data=f"sub_no_aggresive_{msg.from_user.id}")
-                        ],
-                        [
-                            InlineKeyboardButton(text=str(locale("sub_no_russian", "button")), callback_data=f"sub_no_russian_{msg.from_user.id}")
-                        ]
-                    ]
-                )
-            )
-
-            logWrite(f"User {msg.from_user.id} sent his application and it will now be reviewed")
-
-            configSet("sent", True, file=str(msg.from_user.id))
-            configSet("confirmed", True, file=str(msg.from_user.id))
-
-@app.on_message(~ filters.scheduled & filters.private & (filters.regex(locale("confirm", "keyboard")[1][0])))
-async def confirm_no(app, msg):
-
-    user_stage = configGet("stage", file=str(msg.from_user.id))
-
-    if user_stage == 10:
-        jsonSave(jsonLoad(f"{configGet('data', 'locations')}{sep}user_default.json"), f"{configGet('data', 'locations')}{sep}users{sep}{msg.from_user.id}.json")
-        configSet("telegram_id", str(msg.from_user.username), file=str(msg.from_user.id))
-        configSet("telegram_name", f"{msg.from_user.first_name} {msg.from_user.last_name}", file=str(msg.from_user.id))
-        configSet("telegram_phone", str(msg.from_user.phone_number), file=str(msg.from_user.id))
-        configSet("telegram_locale", str(msg.from_user.language_code), file=str(msg.from_user.id))
-        await welcome_pass(app, msg, once_again=True)
-        logWrite(f"User {msg.from_user.id} restarted the application due to typo in it")
-# ==============================================================================================================================
-
-
-# Callbacks ====================================================================================================================
-@app.on_callback_query(filters.regex("sub_yes_[\s\S]*")) # type: ignore
-async def callback_query_accept(app, clb):
-
-    fullclb = clb.data.split("_")
-
-    await app.send_message(configGet("admin_group"), locale("approved_by", "message").format(clb.from_user.first_name, fullclb[2]), disable_notification=True) # type: ignore
-    logWrite(f"User {fullclb[2]} got approved by {clb.from_user.id}")
-
-    link = await app.create_chat_invite_link(configGet("destination_group"), name=f"Invite for {fullclb[2]}", member_limit=1, expire_date=datetime.now()+timedelta(days=1))
-
-    await app.send_message(int(fullclb[2]), locale("approved", "message"), reply_markup=InlineKeyboardMarkup(
-        [[
-            InlineKeyboardButton(str(locale("join", "button")), url=link.invite_link)
-        ]]
-    ))
-
-    configSet("approved", True, file=fullclb[2])
-    configSet("link", link.invite_link, file=fullclb[2])
-
-    logWrite(f"User {fullclb[2]} got an invite link {link.invite_link}")
-
-    application = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")
-    application[fullclb[2]]["approved"] = True
-    application[fullclb[2]]["approved_by"] = clb.from_user.id
-    application[fullclb[2]]["approval_date"] = int(time())
-    jsonSave(application, f"{configGet('data', 'locations')}{sep}applications.json")
-
-    edited_markup = [[InlineKeyboardButton(text=str(locale("accepted", "button")), callback_data="nothing")]]
-
-    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
-    await clb.answer(text=locale("sub_accepted", "callback").format(fullclb[2]), show_alert=True) # type: ignore
-
-@app.on_callback_query(filters.regex("sub_no_aggressive_[\s\S]*")) # type: ignore
-async def callback_query_refuse_aggressive(app, clb):
-
-    fullclb = clb.data.split("_")
-
-    await app.send_message(configGet("admin_group"), locale("refused_by_agr", "message").format(clb.from_user.first_name, fullclb[3]), disable_notification=True) # type: ignore
-    await app.send_message(int(fullclb[3]), locale("refused", "message"))
-    logWrite(f"User {fullclb[3]} got refused by {clb.from_user.id} due to being aggressive")
-
-    configSet("refused", True, file=fullclb[3])
-
-    application = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")
-    application[fullclb[3]]["refused"] = True
-    application[fullclb[3]]["refused_by"] = clb.from_user.id
-    application[fullclb[3]]["refusal_date"] = int(time())
-    jsonSave(application, f"{configGet('data', 'locations')}{sep}applications.json")
-
-    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
-
-    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
-    await clb.answer(text=locale("sub_no_aggressive", "callback").format(fullclb[3]), show_alert=True) # type: ignore
-
-@app.on_callback_query(filters.regex("sub_no_russian_[\s\S]*")) # type: ignore
-async def callback_query_refuse_russian(app, clb):
-
-    fullclb = clb.data.split("_")
-
-    await app.send_message(configGet("admin_group"), locale("refused_by_rus", "message").format(clb.from_user.first_name, fullclb[3]), disable_notification=True) # type: ignore
-    await app.send_message(int(fullclb[3]), locale("refused", "message"))
-    await app.send_message(int(fullclb[3]), locale("refused_russian", "message"))
-    logWrite(f"User {fullclb[3]} got refused by {clb.from_user.id} due to being russian")
-
-    configSet("refused", True, file=fullclb[3])
-
-    application = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")
-    application[fullclb[3]]["refused"] = True
-    application[fullclb[3]]["refused_by"] = clb.from_user.id
-    application[fullclb[3]]["refusal_date"] = int(time())
-    jsonSave(application, f"{configGet('data', 'locations')}{sep}applications.json")
-
-    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
-
-    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
-    await clb.answer(text=locale("sub_no_russian", "callback").format(fullclb[3]), show_alert=True) # type: ignore
-
-@app.on_callback_query(filters.regex("sub_no_[\s\S]*")) # type: ignore
-async def callback_query_refuse(app, clb):
-
-    fullclb = clb.data.split("_")
-
-    await app.send_message(configGet("admin_group"), locale("refused_by", "message").format(clb.from_user.first_name, fullclb[2]), disable_notification=True) # type: ignore
-    await app.send_message(int(fullclb[2]), locale("refused", "message"))
-    logWrite(f"User {fullclb[2]} got refused by {clb.from_user.id}")
-
-    configSet("refused", True, file=fullclb[2])
-
-    application = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")
-    application[fullclb[2]]["refused"] = True
-    application[fullclb[2]]["refused_by"] = clb.from_user.id
-    application[fullclb[2]]["refusal_date"] = int(time())
-    jsonSave(application, f"{configGet('data', 'locations')}{sep}applications.json")
-
-    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
-
-    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
-    await clb.answer(text=locale("sub_refused", "callback").format(fullclb[2]), show_alert=True) # type: ignore
-# ==============================================================================================================================
-
-
-# Contact getting ==============================================================================================================
-@app.on_message(~ filters.scheduled & filters.contact & filters.private)
-async def get_contact(app, msg):
-    if (path.exists(f"{configGet('data', 'locations')}{sep}users{sep}{msg.from_user.id}.json") and jsonLoad(f"{configGet('data', 'locations')}{sep}users{sep}{msg.from_user.id}.json")["approved"]) or (msg.from_user.id in configGet("admins")) or (msg.from_user.id == configGet("owner")):
-        if msg.contact.user_id != None:
-            try:
-                user_data = jsonLoad(f"{configGet('data', 'locations')}{sep}users{sep}{msg.contact.user_id}.json")
-                application_content = []
-                i = 1
-                for question in configGet("application", file=str(msg.contact.user_id)):
-                    application_content.append(f"{locale('question'+str(i), 'message', 'question_titles')} {configGet('application', file=str(msg.contact.user_id))[question]}")
-                    i += 1
-                if user_data["sent"]:
-                    application = jsonLoad(f"{configGet('data', 'locations')}{sep}applications.json")[str(msg.contact.user_id)]
-                    if user_data["approved"]:
-                        application_status = locale("application_status_accepted", "message").format((await app.get_users(application["approved_by"])).first_name, datetime.fromtimestamp(application["approval_date"]).strftime("%d.%m.%Y, %H:%M"))  # type: ignore
-                    elif application["refused"]:
-                        application_status = locale("application_status_refused", "message").format((await app.get_users(application["refused_by"])).first_name, datetime.fromtimestamp(application["refusal_date"]).strftime("%d.%m.%Y, %H:%M"))  # type: ignore
-                    else:
-                        application_status = locale("application_status_on_hold", "message")
-                else:
-                    application_status = locale("application_status_not_send", "message")
-                logWrite(f"User {msg.from_user.id} requested application of {msg.contact.user_id}")
-                await msg.reply_text(locale("contact", "message").format(str(msg.contact.user_id), "\n".join(application_content), application_status))  # type: ignore
-            except FileNotFoundError:
-                logWrite(f"User {msg.from_user.id} requested application of {msg.contact.user_id} but user does not exists")
-                await msg.reply_text(locale("contact_invalid", "message"))
-        else:
-            logWrite(f"User {msg.from_user.id} requested application of someone but user is not telegram user")
-            await msg.reply_text(locale("contact_not_member", "message"))
-# ==============================================================================================================================
-
-
-# Any other input ==============================================================================================================
-@app.on_message(~ filters.scheduled & filters.private)
-async def any_stage(app, msg):
-
-    user_stage = configGet("stage", file=str(msg.from_user.id))
-    
-    if user_stage == 1:
-        await msg.reply_text(locale(f"question{user_stage+1}", "message"), reply_markup=ForceReply(placeholder=str(locale(f"question{user_stage+1}", "force_reply"))))
-        logWrite(f"User {msg.from_user.id} completed stage {user_stage} of application")
-        configSet(str(user_stage), str(msg.text), "application", file=str(msg.from_user.id))
-        configSet("stage", user_stage+1, file=str(msg.from_user.id))
-    elif user_stage == 2:
-        try:
-            configSet(str(user_stage), int(msg.text), "application", file=str(msg.from_user.id))
-            if (int(msg.text) in [-1, 0, 128, 256, 512, 1024, 2048]) or (int(msg.text) >= 100):
-                logWrite(f"User {msg.from_user.id} failed stage {user_stage} due to joking")
-                await msg.reply_text(locale("question2_joke", "message"), reply_markup=ForceReply(placeholder=str(locale("question2", "force_reply"))))
-            elif int(msg.text) < configGet("age_allowed"):
-                logWrite(f"User {msg.from_user.id} failed stage {user_stage} due to being underage")
-                await msg.reply_text(locale("question2_underage", "message").format(str(configGet("age_allowed"))), reply_markup=ForceReply(placeholder=str(locale("question2", "force_reply")))) # type: ignore
-            else:
-                logWrite(f"User {msg.from_user.id} completed stage {user_stage} of application")
-                await msg.reply_text(locale(f"question{user_stage+1}", "message"), reply_markup=ForceReply(placeholder=str(locale(f"question{user_stage+1}", "force_reply"))))
-                configSet("stage", user_stage+1, file=str(msg.from_user.id))
-        except ValueError:
-            logWrite(f"User {msg.from_user.id} failed stage {user_stage} due to sending not int")
-            await msg.reply_text(locale(f"question2_invalid", "message"), reply_markup=ForceReply(placeholder=str(locale(f"question{user_stage}", "force_reply"))))
-    else:
-        if user_stage <= 9:
-            logWrite(f"User {msg.from_user.id} completed stage {user_stage} of application")
-            await msg.reply_text(locale(f"question{user_stage+1}", "message"), reply_markup=ForceReply(placeholder=str(locale(f"question{user_stage+1}", "force_reply"))))
-            configSet(str(user_stage), str(msg.text), "application", file=str(msg.from_user.id))
-            configSet("stage", user_stage+1, file=str(msg.from_user.id))
-        else:
-            if not configGet("sent", file=str(msg.from_user.id)):
-                if not configGet("confirmed", file=str(msg.from_user.id)):
-                    configSet(str(user_stage), str(msg.text), "application", file=str(msg.from_user.id))
-                    application_content = []
-                    i = 1
-                    for question in configGet("application", file=str(msg.from_user.id)):
-                        application_content.append(f"{locale('question'+str(i), 'message', 'question_titles')} {configGet('application', file=str(msg.from_user.id))[question]}")
-                        i += 1
-                    await msg.reply_text(locale("confirm", "message").format("\n".join(application_content)), reply_markup=ReplyKeyboardMarkup(locale("confirm", "keyboard"), resize_keyboard=True)) # type: ignore
-                    #configSet("sent", True, file=str(msg.from_user.id))
-                    #configSet("application_date", int(time()), file=str(msg.from_user.id))
-                else:
-                    await msg.reply_text(locale("already_sent", "message"))
-            else:
-                if not configGet("approved", file=str(msg.from_user.id)) and not configGet("refused", file=str(msg.from_user.id)):
-                    await msg.reply_text(locale("already_sent", "message"))
-# ==============================================================================================================================
-
-
-# Filter users on join =========================================================================================================
-@app.on_chat_member_updated(filters.new_chat_members, group=configGet("destination_group"))
-async def filter_join(app, member):
-    pass # Check if invite link belongs to this user
-# ==============================================================================================================================
-
-
-if __name__ == "__main__":
-
-    logWrite(f"Starting up with pid {pid}")
-
-    # Yes, it should be in some kind of async main() function but I don't give a shit.
-    # I did compare performance, almost no difference and it's much more useful this way. Change my mind.
-    app.start() # type: ignore
-
-    app.send_message(configGet("owner"), f"Starting up with pid `{pid}`") # type: ignore
-
-    # # Registering user commands
-    # commands_list = []
-    # for command in configGet("commands"):
-    #     commands_list.append(BotCommand(command, configGet("commands")[command]))
-    # app.set_bot_commands(commands_list) # type: ignore
-
-    # Registering admin commands
-    commands_admin_list = []
-    # for command in configGet("commands"):
-    #     commands_admin_list.append(BotCommand(command, configGet("commands")[command]))
-        
-    for command in configGet("commands_admin"):
-        commands_admin_list.append(BotCommand(command, configGet("commands_admin")[command]))
-
-    for admin in configGet("admins"):
-        try:
-            app.set_bot_commands(commands_admin_list, scope=BotCommandScopeChat(chat_id=admin)) # type: ignore
-        except bad_request_400.PeerIdInvalid:
-            pass
-    
-    app.set_bot_commands(commands_admin_list, scope=BotCommandScopeChat(chat_id=configGet("owner"))) # type: ignore
-
-    idle()
-
-    app.send_message(configGet("owner"), f"Shutting with pid `{pid}`") # type: ignore
-
-    app.stop() # type: ignore
-    
-    killProc(pid)

modules/callbacks/nothing.py

@@ -0,0 +1,11 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import CallbackQuery
+from pyrogram.client import Client
+from modules.utils import locale
+
+# Callback empty ===============================================================================================================
+@app.on_callback_query(filters.regex("nothing"))
+async def callback_query_nothing(app: Client, clb: CallbackQuery):
+    await clb.answer(text=locale("nothing", "callback", locale=clb.from_user))
+# ==============================================================================================================================

modules/callbacks/reapply.py

@@ -0,0 +1,119 @@
+from datetime import datetime
+from app import app
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, ReplyKeyboardRemove, CallbackQuery
+from pyrogram.client import Client
+from pyrogram import filters
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale, logWrite
+from modules.handlers.confirmation import confirm_yes
+from modules.handlers.welcome import welcome_pass
+from modules.database import col_tmp, col_applications
+
+# Callbacks reapply ============================================================================================================
+@app.on_callback_query(filters.regex("reapply_yes_[\s\S]*"))
+async def callback_reapply_query_accept(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("approved_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    logWrite(f"User {holo_user.id} got their reapplication approved by {clb.from_user.id}")
+
+    await app.send_message(holo_user.id, locale("approved_joined", "message", locale=holo_user))
+
+    col_applications.delete_one({"user": holo_user.id})
+    col_applications.insert_one({"user": holo_user.id, "date": datetime.now(), "admin": clb.from_user.id, "application": col_tmp.find_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}})["application"]})
+    col_tmp.update_one({"user": holo_user.id, "type": "application"}, {"$set": {"state": "approved", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("accepted", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_accepted", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+    need_link = True
+
+    async for member in app.get_chat_members(configGet("users", "groups")):
+        if member.user.id == holo_user.id:
+            need_link = False
+            
+    if need_link:
+        link = await app.create_chat_invite_link(configGet("users", "groups"), name=f"Invite for {holo_user.id}", member_limit=1) #, expire_date=datetime.now()+timedelta(days=1))
+
+        await app.send_message(holo_user.id, locale("read_rules", "message", locale=holo_user))
+
+        for rule_msg in locale("rules", locale=holo_user):
+            await app.send_message(holo_user.id, rule_msg)
+
+        await app.send_message(holo_user.id, locale("approved", "message"), reply_markup=InlineKeyboardMarkup(
+            [[
+                InlineKeyboardButton(str(locale("join", "button", locale=holo_user)), url=link.invite_link)
+            ]]
+        ))
+
+        holo_user.set("link", link.invite_link)
+        logWrite(f"User {holo_user.id} got an invite link {link.invite_link}")
+
+    else:
+        await app.send_message(holo_user.id, locale("approved_joined", "message", locale=holo_user))
+
+@app.on_callback_query(filters.regex("reapply_no_[\s\S]*"))
+async def callback_query_reapply_reject(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("rejected_by", "message").format(clb.from_user.first_name, fullclb[2]), disable_notification=True)
+    await app.send_message(holo_user.id, locale("rejected", "message", locale=holo_user))
+    logWrite(f"User {fullclb[2]} got their reapplication rejected by {clb.from_user.id}")
+
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "rejected", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_rejected", "callback", locale=clb.from_user).format(fullclb[2]), show_alert=True)
+
+# Use old application when user reapplies after leaving the chat
+@app.on_callback_query(filters.regex("reapply_old_[\s\S]*"))
+async def callback_query_reapply_old(app: Client, clb: CallbackQuery):
+    fullclb = clb.data.split("_")
+
+    if HoloUser(clb.from_user).sponsorship_state()[0] == "fill":
+        await clb.message.reply_text(locale("finish_sponsorship", "message"), quote=False)
+        return
+
+    message = await app.get_messages(clb.from_user.id, int(fullclb[2]))
+    await confirm_yes(app, message, kind="application")
+    await clb.message.edit(clb.message.text, reply_markup=InlineKeyboardMarkup([[InlineKeyboardButton(locale("done", "button", locale=clb.from_user), "nothing")]]))
+
+# Start a new application when user reapplies after leaving the chat
+@app.on_callback_query(filters.regex("reapply_new_[\s\S]*"))
+async def callback_query_reapply_new(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+
+    if HoloUser(clb.from_user).sponsorship_state()[0] == "fill":
+        await clb.message.reply_text(locale("finish_sponsorship", "message"), quote=False)
+        return
+
+    await clb.answer(locale("reapply_stopped", "callback", locale=clb.from_user))
+    message = await app.get_messages(clb.from_user.id, int(fullclb[2]))
+    col_tmp.update_one({"user": clb.from_user.id}, {"$set": {"state": "fill", "completed": False, "stage": 1}})
+    await welcome_pass(app, message, once_again=True)
+    logWrite(f"User {clb.from_user.id} restarted the application after leaving the chat earlier")
+    await clb.message.edit(clb.message.text, reply_markup=InlineKeyboardMarkup([[InlineKeyboardButton(locale("done", "button", locale=clb.from_user), "nothing")]]))
+
+# Abort application fill in progress and restart it
+@app.on_callback_query(filters.regex("reapply_stop_[\s\S]*"))
+async def callback_query_reapply_stop(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(clb.from_user)
+
+    holo_user.application_restart()
+    await clb.answer(locale("reapply_stopped", "callback", locale=holo_user))
+    message = await app.get_messages(clb.from_user.id, int(fullclb[2]))
+    await welcome_pass(app, message, once_again=True)
+    logWrite(f"User {clb.from_user.id} restarted the application due to typo in it")
+    await clb.message.edit(locale("reapply_restarted", "message", locale=holo_user), reply_markup=ReplyKeyboardRemove())
+# ==============================================================================================================================

modules/callbacks/rules.py

@@ -0,0 +1,72 @@
+from app import app
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, CallbackQuery
+from pyrogram.client import Client
+from pyrogram.errors import bad_request_400
+from pyrogram import filters
+from modules.utils import locale, logWrite
+from modules.commands.rules import DefaultRulesMarkup
+
+# Callback rule ================================================================================================================
+@app.on_callback_query(filters.regex("rule_[\s\S]*"))
+async def callback_query_rule(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+
+    logWrite(f"User {clb.from_user.id} requested to check out rule {fullclb[1]}")
+
+    rule_num = int(fullclb[1])
+
+    if rule_num == len(locale("rules")):
+        lower_buttons = [
+            InlineKeyboardButton(locale("rules_prev", "button", locale=clb.from_user), callback_data=f"rule_{rule_num-1}")
+        ]
+    elif rule_num == 1:
+        lower_buttons = [
+            InlineKeyboardButton(locale("rules_next", "button", locale=clb.from_user), callback_data=f"rule_{rule_num+1}")
+        ]
+    else:
+        lower_buttons = [
+            InlineKeyboardButton(locale("rules_prev", "button", locale=clb.from_user), callback_data=f"rule_{rule_num-1}"),
+            InlineKeyboardButton(locale("rules_next", "button", locale=clb.from_user), callback_data=f"rule_{rule_num+1}")
+        ]
+
+    try:
+        await clb.message.edit(text=locale("rules", locale=clb.from_user)[rule_num-1], disable_web_page_preview=True, reply_markup=InlineKeyboardMarkup(
+                [
+                    [
+                        InlineKeyboardButton(locale("rules_home", "button", locale=clb.from_user), callback_data="rules_home"),
+                        InlineKeyboardButton(locale("rules_additional", "button", locale=clb.from_user), callback_data="rules_additional")
+                    ],
+                    lower_buttons
+                ]
+            )
+        )
+    except bad_request_400.MessageNotModified:
+        pass
+
+    await clb.answer(text=locale("rules_page", "callback", locale=clb.from_user).format(fullclb[1]))
+
+@app.on_callback_query(filters.regex("rules_home"))
+async def callback_query_rules_home(app: Client, clb: CallbackQuery):
+
+    logWrite(f"User {clb.from_user.id} requested to check out homepage rules")
+
+    try:
+        await clb.message.edit(text=locale("rules_msg", locale=clb.from_user), disable_web_page_preview=True, reply_markup=DefaultRulesMarkup(clb.from_user).keyboard)
+    except bad_request_400.MessageNotModified:
+        pass
+
+    await clb.answer(text=locale("rules_home", "callback", locale=clb.from_user))
+
+@app.on_callback_query(filters.regex("rules_additional"))
+async def callback_query_rules_additional(app: Client, clb: CallbackQuery):
+
+    logWrite(f"User {clb.from_user.id} requested to check out additional rules")
+
+    try:
+        await clb.message.edit(text=locale("rules_additional", locale=clb.from_user), disable_web_page_preview=True, reply_markup=DefaultRulesMarkup(clb.from_user).keyboard)
+    except bad_request_400.MessageNotModified:
+        pass
+
+    await clb.answer(text=locale("rules_additional", "callback", locale=clb.from_user))
+# ==============================================================================================================================

modules/callbacks/sid.py

@@ -0,0 +1,10 @@
+from app import app
+from pyrogram.types import CallbackQuery
+from pyrogram.client import Client
+from pyrogram import filters
+
+# Callback rule ================================================================================================================
+@app.on_callback_query(filters.regex("sid_[\s\S]*"))
+async def callback_query_rule(app: Client, clb: CallbackQuery):
+    await clb.answer(url=f'https://t.me/{(await app.get_me()).username}?start={clb.data.split("_")[1]}')
+# ==============================================================================================================================

modules/callbacks/sponsorship.py

@@ -0,0 +1,103 @@
+from datetime import datetime
+from app import app
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, ForceReply, CallbackQuery
+from pyrogram.client import Client
+from pyrogram import filters
+from classes.errors.holo_user import LabelSettingError
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale, logWrite, should_quote
+from modules.database import col_tmp, col_sponsorships
+
+# Callbacks sponsorship ========================================================================================================
+@app.on_callback_query(filters.regex("sponsor_apply_[\s\S]*"))
+async def callback_query_sponsor_apply(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    if holo_user.application_state()[0] == "fill":
+        await clb.message.reply_text(locale("finish_application", "message"), quote=should_quote(clb.message))
+        return
+
+    logWrite(f"User {holo_user.id} applied for sponsorship")
+
+    holo_user.sponsorship_restart()
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("sponsor_started", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=locale("sponsorship_applying", "message", locale=holo_user), reply_markup=InlineKeyboardMarkup(edited_markup))
+    await app.send_message(holo_user.id, locale(f"sponsor1", "message", locale=holo_user), reply_markup=ForceReply(placeholder=str(locale(f"sponsor1", "force_reply", locale=holo_user.locale))))
+    await clb.answer(text=locale("sponsor_started", "callback", locale=holo_user).format(holo_user.id), show_alert=False)
+
+@app.on_callback_query(filters.regex("sponsor_yes_[\s\S]*"))
+async def callback_query_sponsor_yes(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("sponsor_approved_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    await app.send_message(holo_user.id, locale("sponsor_approved", "message", locale=holo_user))
+    logWrite(f"User {holo_user.id} got sponsorship approved by {clb.from_user.id}")
+
+    if col_sponsorships.find_one({"user": holo_user.id}) is not None:
+        col_sponsorships.update_one({"user": holo_user.id},
+            {
+                "$set": {
+                    "date": datetime.now(),
+                    "admin": clb.from_user.id,
+                    "sponsorship": col_tmp.find_one({"user": holo_user.id, "type": "sponsorship"})["sponsorship"]
+                }
+            }
+        )
+    else:
+        col_sponsorships.insert_one(
+            {
+                "user": holo_user.id,
+                "date": datetime.now(),
+                "admin": clb.from_user.id,
+                "sponsorship": col_tmp.find_one({"user": holo_user.id, "type": "sponsorship"})["sponsorship"]
+            }
+        )
+        
+    col_tmp.update_one({"user": holo_user.id, "type":"sponsorship"},
+        {
+            "$set": {
+                "state": "approved",
+                "sent": False
+            }
+        }
+    )
+
+    try:
+        await holo_user.label_set(configGet("users", "groups"), col_tmp.find_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "sponsorship"}})["sponsorship"]["label"])
+    except LabelSettingError as exp:
+        await app.send_message(configGet("admin", "groups"), exp.__str__(), disable_notification=True)
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("accepted", "button")), callback_data="nothing")]]
+
+    await app.edit_message_caption(clb.message.chat.id, clb.message.id, caption=clb.message.caption, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sponsor_accepted", "callback").format(fullclb[2]), show_alert=False)
+
+@app.on_callback_query(filters.regex("sponsor_no_[\s\S]*"))
+async def callback_query_sponsor_no(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("sponsor_rejected_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    await app.send_message(holo_user.id, locale("sponsor_rejected", "message", locale=holo_user))
+    logWrite(f"User {holo_user.id} got sponsorship rejected by {clb.from_user.id}")
+
+    col_tmp.update_one({"user": holo_user.id, "type": "sponsorship"},
+        {
+            "$set": {
+                "state": "rejected",
+                "sent": False
+            }
+        }
+    )
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
+
+    await app.edit_message_caption(clb.message.chat.id, clb.message.id, caption=clb.message.caption, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sponsor_rejected", "callback").format(fullclb[2]), show_alert=False)

modules/callbacks/sub.py

@@ -0,0 +1,104 @@
+from datetime import datetime
+from app import app
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, CallbackQuery
+from pyrogram import filters
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale, logWrite
+from modules.database import col_tmp, col_applications
+from modules.commands.rules import DefaultRulesMarkup
+
+# Callbacks application ========================================================================================================
+@app.on_callback_query(filters.regex("sub_yes_[\s\S]*"))
+async def callback_query_accept(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("approved_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    logWrite(f"User {holo_user.id} got approved by {clb.from_user.id}")
+
+    need_link = True
+
+    async for member in app.get_chat_members(configGet("users", "groups")):
+        if member.user.id == holo_user.id:
+            need_link = False
+            
+    if need_link:
+        link = await app.create_chat_invite_link(configGet("users", "groups"), name=f"Invite for {holo_user.id}", member_limit=1) #, expire_date=datetime.now()+timedelta(days=1))
+
+        await app.send_message(holo_user.id, locale("read_rules", "message", locale=holo_user))
+
+        await app.send_message(holo_user.id, locale("rules_msg", locale=holo_user), disable_web_page_preview=True, reply_markup=DefaultRulesMarkup(holo_user).keyboard)
+
+        await app.send_message(holo_user.id, locale("approved", "message", locale=holo_user), reply_markup=InlineKeyboardMarkup(
+            [[
+                InlineKeyboardButton(str(locale("join", "button", locale=holo_user)), url=link.invite_link)
+            ]]
+        ))
+
+        holo_user.set("link", link.invite_link)
+        logWrite(f"User {holo_user.id} got an invite link {link.invite_link}")
+
+    else:
+        await app.send_message(holo_user.id, locale("approved_joined", "message", locale=holo_user))
+
+    col_applications.insert_one({"user": holo_user.id, "date": datetime.now(), "admin": clb.from_user.id, "application": col_tmp.find_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}})["application"]})
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "approved", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("accepted", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_accepted", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+@app.on_callback_query(filters.regex("sub_no_[\s\S]*"))
+async def callback_query_reject(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("rejected_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    await app.send_message(holo_user.id, locale("rejected", "message", locale=holo_user))
+    logWrite(f"User {holo_user.id} got rejected by {clb.from_user.id}")
+
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "rejected", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_rejected", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+@app.on_callback_query(filters.regex("sub_aggressive_[\s\S]*"))
+async def callback_query_reject_aggressive(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("rejected_by_agr", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    await app.send_message(holo_user.id, locale("rejected_aggressive", "message", locale=holo_user))
+    logWrite(f"User {holo_user.id} got rejected by {clb.from_user.id} due to being aggressive")
+
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "rejected", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_aggressive", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+@app.on_callback_query(filters.regex("sub_russian_[\s\S]*"))
+async def callback_query_reject_russian(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("rejected_by_rus", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    await app.send_message(holo_user.id, locale("rejected_russian", "message", locale=holo_user))
+    logWrite(f"User {holo_user.id} got rejected by {clb.from_user.id} due to being russian")
+
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "rejected", "sent": False}})
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("declined", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sub_russian", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+# ==============================================================================================================================

modules/callbacks/sus.py

@@ -0,0 +1,49 @@
+from app import app
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, ChatPermissions, CallbackQuery
+from pyrogram.client import Client
+from pyrogram import filters
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale, logWrite
+from modules.database import col_tmp
+
+# Callbacks sus users ==========================================================================================================
+@app.on_callback_query(filters.regex("sus_allow_[\s\S]*"))
+async def callback_query_sus_allow(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("sus_allowed_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    logWrite(f"User {holo_user.id} was allowed to join with another link by {clb.from_user.id}")
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("sus_allowed", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sus_allowed", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+    await app.restrict_chat_member(configGet("users", "groups"), holo_user.id, permissions=ChatPermissions(
+            can_send_messages=True,
+            can_send_media_messages=True,
+            can_send_other_messages=True,
+            can_send_polls=True
+        )
+    )
+
+@app.on_callback_query(filters.regex("sus_reject_[\s\S]*"))
+async def callback_query_sus_reject(app: Client, clb: CallbackQuery):
+
+    fullclb = clb.data.split("_")
+    holo_user = HoloUser(int(fullclb[2]))
+
+    await app.send_message(configGet("admin", "groups"), locale("sus_rejected_by", "message").format(clb.from_user.first_name, holo_user.id), disable_notification=True)
+    logWrite(f"User {holo_user.id} was rejected to join with another link by {clb.from_user.id}")
+
+    edited_markup = [[InlineKeyboardButton(text=str(locale("sus_rejected", "button")), callback_data="nothing")]]
+
+    await clb.message.edit(text=clb.message.text, reply_markup=InlineKeyboardMarkup(edited_markup))
+    await clb.answer(text=locale("sus_rejected", "callback", locale=clb.from_user).format(holo_user.id), show_alert=True)
+
+    await app.ban_chat_member(configGet("users", "groups"), holo_user.id)
+
+    col_tmp.update_one({"user": {"$eq": holo_user.id}, "type": {"$eq": "application"}}, {"$set": {"state": "rejected", "sent": False}})
+# ==============================================================================================================================

modules/commands/application.py

@@ -0,0 +1,62 @@
+from datetime import datetime
+from app import app
+from pyrogram import filters
+from pyrogram.enums.parse_mode import ParseMode
+from pyrogram.types import Message
+from pyrogram.errors import bad_request_400
+from pyrogram.client import Client
+from classes.errors.holo_user import UserNotFoundError
+from classes.holo_user import HoloUser
+from modules.utils import logWrite, locale, should_quote
+from dateutil.relativedelta import relativedelta
+from modules.database import col_applications
+from modules import custom_filters
+
+# Application command ==========================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.command(["application"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_application(app: Client, msg: Message):
+
+    try:
+
+        try:
+            holo_user = HoloUser(int(msg.command[1]))
+        except (ValueError, UserNotFoundError):
+            try:
+                holo_user = HoloUser((await app.get_users(msg.command[1])).id)
+            except (bad_request_400.UsernameInvalid, bad_request_400.PeerIdInvalid, bad_request_400.UsernameNotOccupied):
+                await msg.reply_text(locale("no_user_application", "message", locale=msg.from_user).format(msg.command[1]), quote=should_quote(msg))
+                return
+
+        application = col_applications.find_one({"user": holo_user.id})
+
+        if application is None:
+            logWrite(f"User {msg.from_user.id} requested application of {holo_user.id} but user does not exists")
+            await msg.reply_text(locale("user_invalid", "message", locale=msg.from_user), quote=should_quote(msg))
+            return
+
+        application_content = []
+        i = 1
+
+        for question in application['application']:
+
+            if i == 2:
+                age = relativedelta(datetime.now(), application['application']['2'])
+                application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=msg.from_user)} {application['application']['2'].strftime('%d.%m.%Y')} ({age.years} р.)")
+            elif i == 3:
+                if application['application']['3']['countryCode'] == "UA":
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=msg.from_user)} {application['application']['3']['name']}")
+                else:
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=msg.from_user)} {application['application']['3']['name']} ({application['application']['3']['adminName1']}, {application['application']['3']['countryName']})")
+            else:
+                application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=msg.from_user)} {application['application'][question]}")
+            
+            i += 1
+
+        application_status = locale("application_status_accepted", "message", locale=msg.from_user).format((await app.get_users(application["admin"])).first_name, application["date"].strftime("%d.%m.%Y, %H:%M")) 
+
+        logWrite(f"User {msg.from_user.id} requested application of {holo_user.id}")
+        await msg.reply_text(locale("contact", "message", locale=msg.from_user).format(holo_user.id, "\n".join(application_content), application_status), parse_mode=ParseMode.MARKDOWN, quote=should_quote(msg))
+            
+    except IndexError:
+        await msg.reply_text(locale("application_invalid_syntax", "message", locale=msg.from_user), quote=should_quote(msg))
+# ==============================================================================================================================

modules/commands/applications.py

@@ -0,0 +1,30 @@
+from os import sep, makedirs, remove
+from uuid import uuid1
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from pyrogram.enums.chat_action import ChatAction
+from modules.logging import logWrite
+from modules.utils import should_quote, jsonSave
+from modules.database import col_applications
+from modules import custom_filters
+
+# Applications command =========================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.command(["applications"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_applications(app: Client, msg: Message):
+
+    logWrite(f"Admin {msg.from_user.id} requested export of a database")
+    await app.send_chat_action(msg.chat.id, ChatAction.UPLOAD_DOCUMENT)
+    filename = uuid1()
+    output = []
+    for entry in col_applications.find():
+        del entry["_id"]
+        entry["date"] = entry["date"].strftime("%d.%m.%Y, %H:%M")
+        entry["application"]["2"] = entry["application"]["2"].strftime("%d.%m.%Y, %H:%M")
+        output.append(entry)
+    makedirs("tmp", exist_ok=True)
+    jsonSave(output, f"tmp{sep}{filename}.json")
+    await msg.reply_document(document=f"tmp{sep}{filename}.json", file_name="applications", quote=should_quote(msg))
+    remove(f"tmp{sep}{filename}.json")
+# ==============================================================================================================================

modules/commands/cancel.py

@@ -0,0 +1,16 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message, ReplyKeyboardRemove
+from pyrogram.client import Client
+from modules.utils import should_quote, logWrite, locale
+from modules.database import col_tmp, col_spoilers
+from modules import custom_filters
+
+# Cancel command ===============================================================================================================
+@app.on_message((custom_filters.enabled_applications | custom_filters.enabled_sponsorships) & ~filters.scheduled & filters.command("cancel", prefixes=["/"]))
+async def command_cancel(app: Client, msg: Message):
+    col_tmp.delete_many( {"user": msg.from_user.id} )
+    col_spoilers.delete_many( {"user": msg.from_user.id, "completed": False} )
+    await msg.reply_text(locale("cancel", "message", locale=msg.from_user), quote=should_quote(msg), reply_markup=ReplyKeyboardRemove())
+    logWrite(f"Cancelling all ongoing tmp operations for {msg.from_user.id}")
+# ==============================================================================================================================

modules/commands/identify.py

@@ -0,0 +1,66 @@
+from os import path
+from app import app, isAnAdmin
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from pyrogram.errors import bad_request_400
+from pyrogram.enums.chat_action import ChatAction
+from classes.errors.holo_user import UserNotFoundError, UserInvalidError
+from classes.holo_user import HoloUser
+from modules.utils import jsonLoad, should_quote, logWrite, locale, download_tmp, create_tmp, find_user
+from modules import custom_filters
+
+# Identify command =============================================================================================================
+@app.on_message((custom_filters.enabled_applications | custom_filters.enabled_sponsorships) & ~filters.scheduled & filters.command("identify", prefixes=["/"]) & custom_filters.admin)
+async def cmd_identify(app: Client, msg: Message):
+
+    if len(msg.command) != 2:
+        await msg.reply_text(locale("identify_invalid_syntax", "message", locale=msg.from_user))
+        return
+
+    try:
+        try:
+            holo_user = HoloUser(int(msg.command[1]))
+        except ValueError:
+            holo_user = HoloUser(await find_user(app, msg.command[1]))
+    except (UserInvalidError, UserNotFoundError, bad_request_400.UsernameInvalid, bad_request_400.PeerIdInvalid, bad_request_400.UsernameNotOccupied, TypeError):
+        await msg.reply_text(locale("identify_not_found", "message", locale=msg.from_user).format(msg.command[1]))
+        return
+
+    role = holo_user.label
+    has_application = locale("yes", "message", locale=msg.from_user) if holo_user.application_approved() is True else locale("no", "message", locale=msg.from_user)
+    has_sponsorship = locale("yes", "message", locale=msg.from_user) if holo_user.sponsorship_valid() is True else locale("no", "message", locale=msg.from_user)
+
+    username = holo_user.username if holo_user.username is not None else "N/A"
+    in_chat = locale("yes", "message", locale=msg.from_user) if (holo_user.id in jsonLoad(path.join("cache", "group_members"))) else locale("no", "message", locale=msg.from_user)
+    is_admin = locale("yes", "message", locale=msg.from_user) if (await isAnAdmin(holo_user.id)) else locale("no", "message", locale=msg.from_user)
+
+    output = locale("identify_success", "message", locale=msg.from_user).format(
+        holo_user.id,
+        holo_user.name,
+        username,
+        in_chat,
+        is_admin,
+        role,
+        has_application,
+        has_sponsorship
+    )
+    
+    user = await app.get_users(holo_user.id)
+
+    if user.photo is not None:
+        await app.send_chat_action(msg.chat.id, action=ChatAction.UPLOAD_PHOTO)
+        await msg.reply_photo(
+            create_tmp(await download_tmp(app, user.photo.big_file_id), kind="image"),
+            quote=should_quote(msg),
+            caption=output
+        )
+    else:
+        await app.send_chat_action(msg.chat.id, action=ChatAction.TYPING)
+        await msg.reply_text(
+            output,
+            quote=should_quote(msg)
+        )
+
+    logWrite(f"User {msg.from_user.id} identified user {holo_user.id}")
+# ==============================================================================================================================

modules/commands/label.py

@@ -0,0 +1,43 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from modules.utils import configGet, locale, should_quote, find_user
+from classes.errors.holo_user import LabelTooLongError, LabelSettingError
+from classes.holo_user import HoloUser
+from modules import custom_filters
+
+# Label command ================================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.command(["label"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_label(app: Client, msg: Message):
+
+    if len(msg.command) < 3:
+        await msg.reply_text("Invalid syntax:\n`/label USER LABEL`")
+        return
+
+    target = await find_user(app, msg.command[1])
+
+    if target is not None:
+        
+        target = HoloUser(target)
+
+        label = " ".join(msg.command[2:])
+
+        if label.lower() == "reset":
+            await target.label_reset(msg.chat)
+            await msg.reply_text(f"Resetting **{target.id}**'s label...", quote=should_quote(msg))
+            
+        else:
+            try:
+                await target.label_set(msg.chat, label)
+            except LabelTooLongError:
+                await msg.reply_text(locale("label_too_long", "message"))
+                return
+            except LabelSettingError as exp:
+                await app.send_message(configGet("admin", "groups"), exp.__str__(), disable_notification=True)
+                return
+            await msg.reply_text(f"Setting **{target.id}**'s label to **{label}**...", quote=should_quote(msg))
+            
+    else:
+        await msg.reply_text(f"User not found")
+# ==============================================================================================================================

modules/commands/message.py

@@ -0,0 +1,34 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from classes.errors.holo_user import UserInvalidError
+from classes.holo_user import HoloUser
+from modules.utils import logWrite, locale, should_quote, find_user
+from modules import custom_filters
+
+# Message command ==============================================================================================================
+@app.on_message(custom_filters.enabled_general & ~filters.scheduled & filters.command(["message"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_message(app: Client, msg: Message):
+
+    try:
+
+        try:
+            destination = HoloUser(int(msg.command[1]))
+        except (ValueError, UserInvalidError):
+            destination = HoloUser(await find_user(app, query=msg.command[1]))
+
+        if ((msg.text is not None) and (len(msg.text.split()) > 2)):
+            await destination.message(context=msg, text=" ".join(msg.text.split()[2:]), caption=msg.caption, photo=msg.photo, video=msg.video, file=msg.document, voice=msg.voice, animation=msg.animation, adm_context=True)
+        elif ((msg.caption is not None) and (len(msg.caption.split()) > 2)):
+            await destination.message(context=msg, text=msg.text, caption=" ".join(msg.caption.split()[2:]), photo=msg.photo, video=msg.video, file=msg.document, voice=msg.voice, animation=msg.animation, adm_context=True)
+        else:
+            await destination.message(context=msg, text=None, caption=None, photo=msg.photo, video=msg.video, file=msg.document, voice=msg.voice, animation=msg.animation, adm_context=True)
+    
+    except IndexError:
+        await msg.reply_text(locale("message_invalid_syntax", "message", locale=msg.from_user), quote=should_quote(msg))
+        logWrite(f"Admin {msg.from_user.id} tried to send message but 'IndexError'")
+    except ValueError:
+        await msg.reply_text(locale("message_invalid_syntax", "message", locale=msg.from_user), quote=should_quote(msg))
+        logWrite(f"Admin {msg.from_user.id} tried to send message but 'ValueError'")
+# ==============================================================================================================================

modules/commands/nearby.py

@@ -0,0 +1,58 @@
+from traceback import print_exc
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules import custom_filters
+from modules.logging import logWrite
+from modules.utils import configGet, locale, should_quote, find_location
+from modules.database import col_applications, col_users
+from classes.errors.geo import PlaceNotFoundError
+
+# Nearby command ===============================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & (filters.private | (filters.chat(configGet("admin", "groups")) | filters.chat(configGet("users", "groups")))) & filters.command(["nearby"], prefixes=["/"]) & (custom_filters.allowed | custom_filters.admin))
+async def cmd_nearby(app: Client, msg: Message):
+
+    holo_user = HoloUser(msg.from_user)
+
+    # Check if any place provided
+    if len(msg.command) == 1: # Action if no place provided
+        application = col_applications.find_one({"user": msg.from_user.id})
+        if application is None:
+            await msg.reply_text(locale("nearby_user_empty", "message", locale=holo_user))
+            return
+        location = application["application"]["3"]["location"][0], application["application"]["3"]["location"][1]
+    else: # Find a place from input query
+        logWrite(f"Looking for the location by query '{' '.join(msg.command[1:])}'")
+        try:
+            location_coordinates = find_location(" ".join(msg.command[1:]))
+            location = float(location_coordinates["lng"]), float(location_coordinates["lat"])
+        except PlaceNotFoundError: # Place is not found
+            await msg.reply_text(locale("nearby_invalid", "message", locale=holo_user), quote=should_quote(msg))
+            return
+        except Exception as exp: # Error occurred while finding the place
+            await msg.reply_text(locale("nearby_error", "message", locale=holo_user).format(exp, print_exc()), quote=should_quote(msg))
+            return
+
+    # Find all users registered in the area provided
+    output = []
+    applications_nearby = col_applications.find( {"application.3.location": { "$nearSphere": {"$geometry": {"type": "Point", "coordinates": [location[0], location[1]]}, "$maxDistance": configGet("search_radius")*1000} } } )
+
+    for entry in applications_nearby:
+        if not entry["user"] == msg.from_user.id:
+            user = col_users.find_one( {"user": entry["user"]} )
+            if user is not None:
+                if user["tg_username"] not in [None, "None", ""]: # Check if user has any name
+                    output.append(f'• **{user["tg_name"]}** (@{user["tg_username"]}):\n  - {entry["application"]["3"]["name"]}, {entry["application"]["3"]["adminName1"]}')
+                else:
+                    output.append(f'• **{user["tg_name"]}**:\n  - {entry["application"]["3"]["name"]}, {entry["application"]["3"]["adminName1"]}')
+
+    logWrite(f"{holo_user.id} tried to find someone nearby {location[1]} {location[0]} in the radius of {configGet('search_radius')} kilometers")
+
+    # Check if any users found
+    if len(output) > 0:
+        await msg.reply_text(locale("nearby_result", "message", locale=holo_user).format("\n".join(output)), quote=should_quote(msg))
+    else:
+        await msg.reply_text(locale("nearby_empty", "message", locale=holo_user), quote=should_quote(msg))
+# ==============================================================================================================================

modules/commands/reapply.py

@@ -0,0 +1,69 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, Message
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale, should_quote
+from modules.handlers.welcome import welcome_pass
+from modules.database import col_tmp
+from modules import custom_filters
+
+# Reapply command ==============================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.private & filters.command(["reapply"], prefixes=["/"]))
+async def cmd_reapply(app: Client, msg: Message):
+
+    holo_user = HoloUser(msg.from_user)
+
+    # Check if user has approved/rejected tmp application
+    if ((holo_user.application_state()[0] in ["approved", "rejected"]) or (holo_user.application_state()[0] == "none")) and holo_user.spoiler_state() is False:
+
+        # Check if user's tmp application is already completed or even sent
+        if ((holo_user.application_state()[1] is True) and (not col_tmp.find_one({"user": holo_user.id, "type": "application"})["sent"])) or (holo_user.application_state()[0] == "none"):
+
+            left_chat = True
+
+            async for member in app.get_chat_members(configGet("users", "groups")):
+                if member.user.id == msg.from_user.id:
+                    left_chat = False
+
+            if not left_chat:
+                if holo_user.sponsorship_state()[0] == "fill":
+                    await msg.reply_text(locale("finish_sponsorship", "message"), quote=should_quote(msg))
+                    return
+                holo_user.application_restart(reapply=True)
+                await welcome_pass(app, msg, once_again=True)
+
+            else:
+                await msg.reply_text(locale("reapply_left_chat", "message", locale=holo_user), reply_markup=InlineKeyboardMarkup([
+                    [
+                        InlineKeyboardButton(locale("reapply_old_one", "button", locale=holo_user), f"reapply_old_{msg.id}")
+                    ],
+                    [
+                        InlineKeyboardButton(locale("reapply_new_one", "button", locale=holo_user), f"reapply_new_{msg.id}")
+                    ]
+                ]))
+
+        else:
+
+            await msg.reply_text(locale("reapply_in_progress", "message", locale=holo_user).format(locale("confirm", "keyboard", locale=holo_user)[1][0]), reply_markup=InlineKeyboardMarkup([
+                [
+                    InlineKeyboardButton(locale("applying_stop", "button", locale=holo_user), f"reapply_stop_{msg.id}")
+                ]
+            ]))
+
+    elif holo_user.spoiler_state() is True:
+
+        await msg.reply_text(locale("spoiler_in_progress", "message", locale=holo_user))
+
+    else:
+
+        if (holo_user.application_state()[0] == "fill") and (col_tmp.find_one({"user": holo_user.id, "type": "application"})["sent"] is True):
+            await msg.reply_text(locale("reapply_forbidden", "message", locale=holo_user))
+            
+        else:
+            await msg.reply_text(locale("reapply_in_progress", "message", locale=holo_user).format(locale("confirm", "keyboard", locale=holo_user)[1][0]), reply_markup=InlineKeyboardMarkup([
+                [
+                    InlineKeyboardButton(locale("applying_stop", "button", locale=holo_user), f"reapply_stop_{msg.id}")
+                ]
+            ]))
+# ==============================================================================================================================

modules/commands/reboot.py

@@ -0,0 +1,24 @@
+from app import app
+from os import getpid, makedirs, path
+from sys import exit
+from time import time
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from modules.utils import configGet, jsonSave, locale, logWrite, should_quote
+from modules.scheduled import scheduler
+from modules import custom_filters
+
+pid = getpid()
+
+# Reboot command ===============================================================================================================
+@app.on_message(custom_filters.enabled_general & ~filters.scheduled & filters.private & filters.command(["kill", "die", "reboot"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_kill(app: Client, msg: Message):
+
+    logWrite(f"Shutting down bot with pid {pid}")
+    await msg.reply_text(locale("shutdown", "message", locale=msg.from_user).format(pid), quote=should_quote(msg))
+    scheduler.shutdown()
+    makedirs(configGet("cache", "locations"), exist_ok=True)
+    jsonSave({"timestamp": time()}, path.join(configGet("cache", "locations"), "shutdown_time"))
+    exit()
+# ==============================================================================================================================

modules/commands/resetcommands.py

@@ -0,0 +1,65 @@
+from app import app
+from os import getpid, listdir
+from pyrogram import filters
+from pyrogram.types import Message, BotCommandScopeDefault, BotCommandScopeChat
+from pyrogram.errors import bad_request_400
+from pyrogram.client import Client
+from modules.utils import logWrite, should_quote, configGet
+from modules import custom_filters
+
+pid = getpid()
+
+# Reset commands command =======================================================================================================
+@app.on_message(custom_filters.enabled_general & ~filters.scheduled & filters.private & filters.command(["resetcommands"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_resetcommands(app: Client, msg: Message):
+
+    if msg.from_user.id == configGet("owner"):
+
+        logWrite(f"Resetting all commands on owner's request")
+
+        valid_locales = []
+        files_locales = listdir(f'{configGet("locale", "locations")}')
+        
+        for entry in files_locales:
+            if entry.endswith(".json"):
+                valid_locales.append(".".join(entry.split(".")[:-1]))
+
+        if configGet("debug") is True:
+            logWrite(f'Resetting commands in groups {configGet("admin", "groups")} and {configGet("users", "groups")}')
+        await app.delete_bot_commands(scope=BotCommandScopeChat(chat_id=configGet("admin", "groups")))
+        await app.delete_bot_commands(scope=BotCommandScopeChat(chat_id=configGet("users", "groups")))
+
+        for admin in configGet("admins"):
+            try:
+                if configGet("debug") is True:
+                    logWrite(f'Resetting commands for admin {admin}')
+                await app.delete_bot_commands(scope=BotCommandScopeChat(chat_id=admin))
+            except bad_request_400.PeerIdInvalid:
+                pass
+
+        try:
+            if configGet("debug") is True:
+                logWrite(f'Resetting commands for owner {configGet("owner")}')
+            for lc in valid_locales:
+                if configGet("debug") is True:
+                    logWrite(f'Resetting commands for owner {configGet("owner")} [{lc}]')
+                await app.delete_bot_commands(scope=BotCommandScopeChat(chat_id=configGet("owner")), language_code=lc)
+            await app.delete_bot_commands(scope=BotCommandScopeChat(chat_id=configGet("owner")))
+        except bad_request_400.PeerIdInvalid:
+            pass
+
+        for lc in valid_locales:
+            if configGet("debug") is True:
+                logWrite(f'Resetting commands for locale {lc}')
+            await app.delete_bot_commands(scope=BotCommandScopeDefault(), language_code=lc)
+
+        if configGet("debug") is True:
+            logWrite(f'Resetting default commands')
+        await app.delete_bot_commands()
+
+        await msg.reply_text("OK", quote=should_quote(msg))
+
+        if configGet("debug") is True:
+            logWrite(str(await app.get_bot_commands()))
+            logWrite(str(await app.get_bot_commands(scope=BotCommandScopeChat(chat_id=configGet("owner")))))
+# ==============================================================================================================================

modules/commands/rules.py

@@ -0,0 +1,42 @@
+from typing import Union
+from app import app
+from pyrogram import filters
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, User, Message
+from pyrogram.client import Client
+from modules.utils import locale
+from modules import custom_filters
+from classes.holo_user import HoloUser
+
+class DefaultRulesMarkup(list):
+    def __init__(self, language_code: Union[str, HoloUser, User, None]):
+        super().__init__([])
+        self.keyboard = InlineKeyboardMarkup(
+            [
+                [
+                    InlineKeyboardButton(locale("rules_home", "button", locale=language_code), callback_data="rules_home"),
+                    InlineKeyboardButton(locale("rules_additional", "button", locale=language_code), callback_data="rules_additional")
+                ],
+                [
+                    InlineKeyboardButton("1", callback_data="rule_1"),
+                    InlineKeyboardButton("2", callback_data="rule_2"),
+                    InlineKeyboardButton("3", callback_data="rule_3")
+                ],
+                [
+                    InlineKeyboardButton("4", callback_data="rule_4"),
+                    InlineKeyboardButton("5", callback_data="rule_5"),
+                    InlineKeyboardButton("6", callback_data="rule_6")
+                ],
+                [
+                    InlineKeyboardButton("7", callback_data="rule_7"),
+                    InlineKeyboardButton("8", callback_data="rule_8"),
+                    InlineKeyboardButton("9", callback_data="rule_9")
+                ]
+            ]
+        )
+
+
+# Rules command =============================================================================================================
+@app.on_message(custom_filters.enabled_general & ~filters.scheduled & filters.private & filters.command(["rules"], prefixes=["/"]))
+async def cmd_rules(app: Client, msg: Message):
+    await msg.reply_text(locale("rules_msg", locale=msg.from_user), disable_web_page_preview=True, reply_markup=DefaultRulesMarkup(msg.from_user).keyboard)
+# ==============================================================================================================================

modules/commands/spoiler.py

@@ -0,0 +1,45 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message, ReplyKeyboardMarkup
+from pyrogram.client import Client
+from classes.errors.holo_user import UserNotFoundError, UserInvalidError
+from classes.holo_user import HoloUser
+from modules.logging import logWrite
+from modules.utils import locale
+from modules.database import col_spoilers
+from modules import custom_filters
+
+# Spoiler command ==============================================================================================================
+@app.on_message(custom_filters.member & ~filters.scheduled & filters.private & filters.command(["spoiler"], prefixes=["/"]))
+async def cmd_spoiler(app: Client, msg: Message):
+
+    try:
+        holo_user = HoloUser(msg.from_user)
+    except (UserInvalidError, UserNotFoundError):
+        return
+
+    if holo_user.application_state()[0] != "fill" and holo_user.sponsorship_state()[0] != "fill":
+
+        if col_spoilers.find_one( {"user": msg.from_user.id, "completed": False} ) is None:
+
+            col_spoilers.insert_one(
+                {
+                    "user": msg.from_user.id,
+                    "completed": False,
+                    "category": None,
+                    "description": None,
+                    "photo": None,
+                    "video": None,
+                    "animation": None,
+                    "document": None,
+                    "caption": None,
+                    "text": None
+                }
+            )
+
+            await msg.reply_text(locale("spoiler_started", "message", locale=msg.from_user), reply_markup=ReplyKeyboardMarkup(locale("spoiler_categories", "keyboard"), resize_keyboard=True, one_time_keyboard=True))
+            logWrite(f"User {msg.from_user.id} started creating new spoiler")
+
+        else:
+            await msg.reply_text(locale("spoiler_unfinished", "message", locale=msg.from_user))
+# ==============================================================================================================================

modules/commands/sponsorship.py

@@ -0,0 +1,23 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton, Message
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules import custom_filters
+from modules.utils import locale, should_quote
+from modules.database import col_applications
+
+# Sponsorship command ==========================================================================================================
+@app.on_message(custom_filters.enabled_sponsorships & ~filters.scheduled & filters.command(["sponsorship"], prefixes=["/"]) & (custom_filters.allowed | custom_filters.admin))
+async def cmd_sponsorship(app: Client, msg: Message):
+    holo_user = HoloUser(msg.from_user)
+    if holo_user.application_state()[0] == "fill":
+        await msg.reply_text(locale("finish_application", "message", locale=msg.from_user), quote=should_quote(msg))
+        return
+    if holo_user.spoiler_state() is True:
+        await msg.reply_text(locale("spoiler_in_progress", "message", locale=holo_user))
+        return
+    await msg.reply_text(locale("sponsorship_apply", "message", locale=msg.from_user), reply_markup=InlineKeyboardMarkup([[InlineKeyboardButton(text=str(locale("sponsor_apply", "button", locale=msg.from_user)), callback_data=f"sponsor_apply_{msg.from_user.id}")]]), quote=should_quote(msg))
+    # else:
+    #     await msg.reply_text(locale("sponsorship_application_empty", "message"))
+# ==============================================================================================================================

modules/commands/start.py

@@ -0,0 +1,47 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import ReplyKeyboardMarkup, Message
+from pyrogram.client import Client
+from modules.utils import locale, logWrite
+from modules.database import col_users, col_spoilers
+from modules import custom_filters
+from bson.objectid import ObjectId
+from bson.errors import InvalidId
+
+# Start command ================================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.private & filters.command(["start"], prefixes=["/"]))
+async def cmd_start(app: Client, msg: Message):
+
+    user = col_users.find_one({"user": msg.from_user.id})
+
+    if user is None:
+        
+        col_users.insert_one({
+            "user": msg.from_user.id,
+            "link": None,
+            "label": "",
+            "tg_name": msg.from_user.first_name,
+            "tg_phone": msg.from_user.phone_number,
+            "tg_locale": msg.from_user.language_code,
+            "tg_username": msg.from_user.username
+        })
+
+        logWrite(f"User {msg.from_user.id} started bot interaction")
+        await msg.reply_text(locale("start", "message", locale=msg.from_user), reply_markup=ReplyKeyboardMarkup(locale("welcome", "keyboard", locale=msg.from_user), resize_keyboard=True))
+
+    if len(msg.command) > 1:
+        try:
+            spoiler = col_spoilers.find_one( {"_id": ObjectId(msg.command[1])} )
+            if spoiler["photo"] is not None:
+                await msg.reply_document(spoiler["photo"], caption=spoiler["caption"])
+            if spoiler["video"] is not None:
+                await msg.reply_cached_media(spoiler["video"], caption=spoiler["caption"])
+            if spoiler["animation"] is not None:
+                await msg.reply_cached_media(spoiler["animation"], caption=spoiler["caption"])
+            if spoiler["document"] is not None:
+                await msg.reply_document(spoiler["document"], caption=spoiler["caption"])
+            if spoiler["text"] is not None:
+                await msg.reply_text(spoiler["text"])
+        except InvalidId:
+            await msg.reply_text(f"Got an invalid ID {msg.command[1]}")
+# ==============================================================================================================================

modules/commands/warn.py

@@ -0,0 +1,22 @@
+from datetime import datetime
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from modules.utils import configGet, locale
+from modules.database import col_warnings
+from modules import custom_filters
+
+# Warn command =================================================================================================================
+@app.on_message(custom_filters.enabled_warnings & ~filters.scheduled & filters.command(["warn"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_warn(app: Client, msg: Message):
+
+    if msg.chat.id == configGet("users", "groups"):
+        if msg.reply_to_message_id != None:
+            message = " ".join(msg.command[1:]) if len(msg.command) > 1 else ""
+            col_warnings.insert_one({"user": msg.reply_to_message.from_user.id, "admin": msg.from_user.id, "date": datetime.now(), "reason": message})
+            if message == "":
+                await msg.reply_text(locale("warned", "message").format(msg.reply_to_message.from_user.first_name, msg.reply_to_message.from_user.id))
+            else:
+                await msg.reply_text(locale("warned_reason", "message").format(msg.reply_to_message.from_user.first_name, msg.reply_to_message.from_user.id, message))
+# ==============================================================================================================================

modules/commands/warnings.py

@@ -0,0 +1,44 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from pyrogram.enums.chat_members_filter import ChatMembersFilter
+from modules.utils import configGet, locale, should_quote
+from modules.database import col_users, col_warnings
+from modules import custom_filters
+
+# Warnings command =============================================================================================================
+@app.on_message(custom_filters.enabled_warnings & ~filters.scheduled & filters.command(["warnings"], prefixes=["/"]) & custom_filters.admin)
+async def cmd_warnings(app: Client, msg: Message):
+
+    if len(msg.command) <= 1:
+        await msg.reply_text(locale("syntax_warnings", "message", locale=msg.from_user), quote=should_quote(msg))
+        return
+
+    try:
+        user_db = col_users.find_one({"user": int(msg.command[1])})
+        target_id = user_db["user"]
+        target_name = user_db["tg_name"]
+    except:
+        list_of_users = []
+        async for m in app.get_chat_members(configGet("users", "groups"), filter=ChatMembersFilter.SEARCH, query=msg.command[1]):
+            list_of_users.append(m)
+
+        if len(list_of_users) != 0:
+            target = list_of_users[0].user
+            target_name = target.first_name
+            target_id = str(target.id)
+        else:
+            await msg.reply_text(locale("no_user_warnings", "message", locale=msg.from_user).format(msg.command[1]))
+            return
+
+    warns = len(list(col_warnings.find({"user": target_id})))
+
+    if warns == 0:
+        await msg.reply_text(locale("no_warnings", "message", locale=msg.from_user).format(target_name, target_id), quote=should_quote(msg))
+    else:
+        if warns <= 5:
+            await msg.reply_text(locale("warnings_1", "message", locale=msg.from_user).format(target_name, target_id, warns), quote=should_quote(msg))
+        else:
+            await msg.reply_text(locale("warnings_2", "message", locale=msg.from_user).format(target_name, target_id, warns), quote=should_quote(msg))
+# ==============================================================================================================================

modules/custom_filters.py

@@ -0,0 +1,52 @@
+"""Custom message filters made to improve commands
+usage in context of Holo Users."""
+
+from os import path
+from app import isAnAdmin
+from modules.utils import configGet, jsonLoad
+from modules.database import col_applications, col_tmp
+from pyrogram import filters
+from pyrogram.types import Message
+
+async def admin_func(_, __, msg: Message):
+    return await isAnAdmin(msg.from_user.id)
+
+async def member_func(_, __, msg: Message):
+    return True if (msg.from_user.id in jsonLoad(path.join(configGet("cache", "locations"), "group_members"))) else False
+
+async def allowed_func(_, __, msg: Message):
+    return True if (col_applications.find_one({"user": msg.from_user.id}) is not None) else False
+
+async def enabled_general_func(_, __, msg: Message):
+    return configGet("enabled", "features", "general")
+
+async def enabled_applications_func(_, __, msg: Message):
+    return configGet("enabled", "features", "applications")
+
+async def enabled_sponsorships_func(_, __, msg: Message):
+    return configGet("enabled", "features", "sponsorships")
+
+async def enabled_warnings_func(_, __, msg: Message):
+    return configGet("enabled", "features", "warnings")
+
+async def enabled_invites_check_func(_, __, msg: Message):
+    return configGet("enabled", "features", "invites_check")
+
+async def enabled_dinovoice_func(_, __, msg: Message):
+    return configGet("enabled", "features", "dinovoice")
+
+async def filling_sponsorship_func(_, __, msg: Message):
+    return True if col_tmp.find_one({"user": msg.from_user.id, "type": "sponsorship"}) is not None else False
+
+admin = filters.create(admin_func)
+member = filters.create(member_func)
+allowed = filters.create(allowed_func)
+
+enabled_general = filters.create(enabled_general_func)
+enabled_applications = filters.create(enabled_applications_func)
+enabled_sponsorships = filters.create(enabled_sponsorships_func)
+enabled_warnings = filters.create(enabled_warnings_func)
+enabled_invites_check = filters.create(enabled_invites_check_func)
+enabled_dinovoice = filters.create(enabled_dinovoice_func)
+
+filling_sponsorship = filters.create(filling_sponsorship_func)

modules/database.py

@@ -0,0 +1,44 @@
+"""Module that provides all database columns and
+creates geospatial index for col_applications"""
+
+from pymongo import MongoClient, GEOSPHERE
+from ujson import loads
+
+with open("config.json", "r", encoding="utf-8") as f:
+    db_config = loads(f.read())["database"]
+    f.close()
+
+if db_config["user"] is not None and db_config["password"] is not None:
+    con_string = 'mongodb://{0}:{1}@{2}:{3}/{4}'.format(
+        db_config["user"],
+        db_config["password"],
+        db_config["host"],
+        db_config["port"],
+        db_config["name"]
+    )
+else:
+    con_string = 'mongodb://{0}:{1}/{2}'.format(
+        db_config["host"],
+        db_config["port"],
+        db_config["name"]
+    )
+
+db_client = MongoClient(con_string)
+db = db_client.get_database(name=db_config["name"])
+
+collections = db.list_collection_names()
+
+for collection in ["tmp", "users", "context", "spoilers", "messages", "warnings", "applications", "sponsorships"]:
+    if not collection in collections:
+        db.create_collection(collection)
+
+col_tmp = db.get_collection("tmp")
+col_users = db.get_collection("users")
+col_context = db.get_collection("context")
+col_spoilers = db.get_collection("spoilers")
+col_messages = db.get_collection("messages")
+col_warnings = db.get_collection("warnings")
+col_applications = db.get_collection("applications")
+col_sponsorships = db.get_collection("sponsorships")
+
+col_applications.create_index([("application.3.location", GEOSPHERE)])

modules/handlers/confirmation.py

@@ -0,0 +1,161 @@
+from typing import Literal
+from dateutil.relativedelta import relativedelta
+from datetime import datetime
+from app import app
+from pyrogram import filters
+from pyrogram.types import ReplyKeyboardRemove, InlineKeyboardMarkup, InlineKeyboardButton, ForceReply, Message
+from pyrogram.client import Client
+from pyrogram.enums.parse_mode import ParseMode
+from classes.holo_user import HoloUser
+from modules.utils import all_locales, configGet, locale, logWrite
+from modules.handlers.welcome import welcome_pass
+from modules.database import col_tmp
+from modules import custom_filters
+
+# Confirmation =================================================================================================================
+confirmation_1 = []
+for pattern in all_locales("confirm", "keyboard"):
+    confirmation_1.append(pattern[0][0])
+@app.on_message((custom_filters.enabled_applications | custom_filters.enabled_sponsorships) & ~filters.scheduled & filters.private & filters.command(confirmation_1, prefixes=[""]))
+async def confirm_yes(app: Client, msg: Message, kind: Literal["application", "sponsorship", "unknown"] = "unknown"):
+
+    holo_user = HoloUser(msg.from_user)
+
+    if configGet("enabled", "features", "applications") is True:
+
+        if (kind == "application") or ((holo_user.application_state()[0] == "fill") and (holo_user.application_state()[1] is True)):
+
+            tmp_application = col_tmp.find_one({"user": holo_user.id, "type": "application"})
+
+            if tmp_application is None:
+                logWrite(f"Application of {holo_user.id} is nowhere to be found.")
+                return
+
+            if tmp_application["sent"] is True:
+                return
+
+            await msg.reply_text(locale("application_sent", "message"), reply_markup=ReplyKeyboardRemove())
+
+            application_content = []
+            i = 1
+
+            for question in tmp_application['application']:
+
+                if i == 2:
+                    age = relativedelta(datetime.now(), tmp_application['application']['2'])
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles')} {tmp_application['application']['2'].strftime('%d.%m.%Y')} ({age.years} р.)")
+                elif i == 3:
+                    if tmp_application['application']['3']['countryCode'] == "UA":
+                        application_content.append(f"{locale(f'question{i}', 'message', 'question_titles')} {tmp_application['application']['3']['name']}")
+                    else:
+                        application_content.append(f"{locale(f'question{i}', 'message', 'question_titles')} {tmp_application['application']['3']['name']} ({tmp_application['application']['3']['adminName1']}, {tmp_application['application']['3']['countryName']})")
+                else:
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles')} {tmp_application['application'][question]}")
+                
+                i += 1
+
+            if tmp_application["reapply"]:
+                await app.send_message(chat_id=configGet("admin", "groups"), text=(locale("reapply_got", "message")).format(str(holo_user.id), msg.from_user.first_name, msg.from_user.username, "\n".join(application_content)), parse_mode=ParseMode.MARKDOWN, reply_markup=InlineKeyboardMarkup(
+                        [
+                            [
+                                InlineKeyboardButton(text=str(locale("reapply_yes", "button")), callback_data=f"reapply_yes_{holo_user.id}")
+                            ],
+                            [
+                                InlineKeyboardButton(text=str(locale("reapply_no", "button")), callback_data=f"reapply_no_{holo_user.id}")
+                            ]
+                        ]
+                    )
+                )
+            else:
+                await app.send_message(chat_id=configGet("admin", "groups"), text=(locale("application_got", "message")).format(str(holo_user.id), msg.from_user.first_name, msg.from_user.username, "\n".join(application_content)), parse_mode=ParseMode.MARKDOWN, reply_markup=InlineKeyboardMarkup(
+                        [
+                            [
+                                InlineKeyboardButton(text=str(locale("sub_yes", "button")), callback_data=f"sub_yes_{holo_user.id}")
+                            ],
+                            [
+                                InlineKeyboardButton(text=str(locale("sub_no", "button")), callback_data=f"sub_no_{holo_user.id}")
+                            ],
+                            [
+                                InlineKeyboardButton(text=str(locale("sub_aggressive", "button")), callback_data=f"sub_aggressive_{holo_user.id}")
+                            ],
+                            [
+                                InlineKeyboardButton(text=str(locale("sub_russian", "button")), callback_data=f"sub_russian_{holo_user.id}")
+                            ]
+                        ]
+                    )
+                )
+
+            logWrite(f"User {holo_user.id} sent his application and it will now be reviewed")
+
+            col_tmp.update_one({"user": holo_user.id, "type": "application"}, {"$set": {"sent": True}})
+
+            return
+
+    if configGet("enabled", "features", "sponsorships") is True:
+
+        if (kind == "sponsorship") or ((holo_user.sponsorship_state()[0] == "fill") and (holo_user.sponsorship_state()[1] is True)):
+
+            tmp_sponsorship = col_tmp.find_one({"user": holo_user.id, "type": "sponsorship"})
+
+            if tmp_sponsorship is None:
+                logWrite(f"Sponsorship of {holo_user.id} is nowhere to be found.")
+                return
+
+            if tmp_sponsorship["sent"] is True:
+                return
+
+            await msg.reply_text(locale("sponsorship_sent", "message"), reply_markup=ReplyKeyboardRemove())
+
+            sponsorship_content = []
+
+            for question in tmp_sponsorship['sponsorship']:
+
+                if question == "expires":
+                    sponsorship_content.append(f"{locale(f'question_{question}', 'message', 'sponsor_titles')} {tmp_sponsorship['sponsorship'][question].strftime('%d.%m.%Y')}")
+                elif question == "proof":
+                    continue
+                else:
+                    sponsorship_content.append(f"{locale(f'question_{question}', 'message', 'sponsor_titles')} {tmp_sponsorship['sponsorship'][question]}")
+            
+            await app.send_cached_media(chat_id=configGet("admin", "groups"), photo=tmp_sponsorship["sponsorship"]["proof"], caption=(locale("sponsor_got", "message")).format(str(holo_user.id), msg.from_user.first_name, msg.from_user.username, "\n".join(sponsorship_content)), parse_mode=ParseMode.MARKDOWN, reply_markup=InlineKeyboardMarkup(
+                    [
+                        [
+                            InlineKeyboardButton(text=str(locale("sponsor_yes", "button")), callback_data=f"sponsor_yes_{holo_user.id}")
+                        ],
+                        [
+                            InlineKeyboardButton(text=str(locale("sponsor_no", "button")), callback_data=f"sponsor_no_{holo_user.id}")
+                        ]
+                    ]
+                )
+            )
+
+            # remove(f"tmp{sep}{filename}.jpg")
+
+            logWrite(f"User {holo_user.id} sent his sponsorship application and it will now be reviewed")
+
+            col_tmp.update_one({"user": holo_user.id, "type": "sponsorship"}, {"$set": {"sent": True}})
+
+            return
+
+confirmation_2 = []
+for pattern in all_locales("confirm", "keyboard"):
+    confirmation_2.append(pattern[1][0])
+@app.on_message((custom_filters.enabled_applications | custom_filters.enabled_sponsorships) & ~filters.scheduled & filters.private & filters.command(confirmation_2, prefixes=[""]))
+async def confirm_no(app: Client, msg: Message, kind: Literal["application", "sponsorship", "unknown"] = "unknown"):
+
+    holo_user = HoloUser(msg.from_user)
+
+    if configGet("enabled", "features", "applications") is True:
+        if (kind == "application") or ((holo_user.application_state()[0] == "fill") and (holo_user.application_state()[1] is True)):
+            holo_user.application_restart()
+            await welcome_pass(app, msg, once_again=True)
+            logWrite(f"User {msg.from_user.id} restarted the application due to typo in it")
+            return
+
+    if configGet("enabled", "features", "sponsorships") is True:
+        if (kind == "sponsorship") or ((holo_user.sponsorship_state()[0] == "fill") and (holo_user.sponsorship_state()[1] is True)):
+            holo_user.sponsorship_restart()
+            await app.send_message(holo_user.id, locale(f"sponsor1", "message", locale=holo_user.locale), reply_markup=ForceReply(placeholder=str(locale(f"sponsor1", "force_reply", locale=holo_user.locale))))
+            logWrite(f"User {msg.from_user.id} restarted the sponsorship application due to typo in it")
+            return
+# ==============================================================================================================================

modules/handlers/contact.py

@@ -0,0 +1,54 @@
+from dateutil.relativedelta import relativedelta
+from datetime import datetime
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from modules.utils import locale, logWrite
+from modules.database import col_applications
+from classes.holo_user import HoloUser
+from modules import custom_filters
+
+# Contact getting ==============================================================================================================
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.contact & filters.private & (custom_filters.allowed | custom_filters.admin))
+async def get_contact(app: Client, msg: Message):
+
+    holo_user = HoloUser(msg.from_user)
+
+    if msg.contact.user_id != None:
+
+        application = col_applications.find_one({"user": msg.contact.user_id})
+
+        if application is None:
+            logWrite(f"User {holo_user.id} requested application of {msg.contact.user_id} but user does not exists")
+            await msg.reply_text(locale("contact_invalid", "message", locale=holo_user.locale))
+            return
+
+        application_content = []
+        i = 1
+
+        for question in application['application']:
+
+            if i == 2:
+                age = relativedelta(datetime.now(), application['application']['2'])
+                application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=holo_user.locale)} {application['application']['2'].strftime('%d.%m.%Y')} ({age.years} р.)")
+            elif i == 3:
+                if application['application']['3']['countryCode'] == "UA":
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=holo_user.locale)} {application['application']['3']['name']}")
+                else:
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=holo_user.locale)} {application['application']['3']['name']} ({application['application']['3']['adminName1']}, {application['application']['3']['countryName']})")
+            else:
+                application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=holo_user.locale)} {application['application'][question]}")
+            
+            i += 1
+
+        application_status = locale("application_status_accepted", "message", locale=holo_user.locale).format((await app.get_users(application["admin"])).first_name, application["date"].strftime("%d.%m.%Y, %H:%M")) 
+
+        logWrite(f"User {holo_user.id} requested application of {msg.contact.user_id}")
+        await msg.reply_text(locale("contact", "message", locale=holo_user.locale).format(str(msg.contact.user_id), "\n".join(application_content), application_status)) 
+            
+
+    else:
+        logWrite(f"User {holo_user.id} requested application of someone but user is not telegram user")
+        await msg.reply_text(locale("contact_not_member", "message", locale=holo_user.locale))
+# ==============================================================================================================================

modules/handlers/everything.py

@@ -0,0 +1,160 @@
+from traceback import print_exc
+from app import app, isAnAdmin
+import asyncio
+from pyrogram import filters
+from pyrogram.types import Message, ForceReply, InlineKeyboardMarkup, InlineKeyboardButton
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules.utils import configGet, logWrite, locale, all_locales
+from modules.database import col_messages, col_spoilers
+
+async def message_involved(msg: Message) -> bool:
+    message = col_messages.find_one({"destination.id": msg.reply_to_message.id, "destination.chat": msg.reply_to_message.chat.id})
+    if message is not None:
+        return True
+    return False
+
+async def message_context(msg: Message) -> tuple:
+    message = col_messages.find_one({"destination.id": msg.reply_to_message.id, "destination.chat": msg.reply_to_message.chat.id})
+    if message is not None:
+        return message["origin"]["chat"], message["origin"]["id"]
+    return 0, 0
+
+# Any other input ==============================================================================================================
+@app.on_message(~ filters.scheduled & filters.private)
+async def any_stage(app: Client, msg: Message):
+
+    if msg.via_bot is None:
+
+        holo_user = HoloUser(msg.from_user)
+
+        if (msg.reply_to_message is not None) and (await message_involved(msg)):
+
+            context = await message_context(msg)
+            context_message = await app.get_messages(context[0], context[1])
+
+            destination_user = HoloUser(context_message.from_user)
+
+            await destination_user.message(
+                origin=context_message,
+                context=msg,
+                text=msg.text,
+                caption=msg.caption,
+                photo=msg.photo,
+                video=msg.video,
+                file=msg.document,
+                animation=msg.animation,
+                voice=msg.voice,
+                adm_origin=await isAnAdmin(context_message.from_user.id),
+                adm_context=await isAnAdmin(msg.from_user.id)
+            )
+
+            return
+
+        if msg.text is not None:
+
+            if configGet("enabled", "features", "applications") is True:
+                await holo_user.application_next(msg.text, msg=msg)
+                
+            if configGet("enabled", "features", "sponsorships") is True:
+            
+                await holo_user.sponsorship_next(msg.text, msg)
+
+        if msg.photo is not None:
+            await holo_user.sponsorship_next(msg.text, msg=msg, photo=msg.photo)
+        
+        if holo_user.application_state()[0] != "fill" and holo_user.sponsorship_state()[0] != "fill":
+
+            spoiler = col_spoilers.find_one( {"user": msg.from_user.id, "completed": False} )
+
+            if spoiler is None:
+                return
+
+            if spoiler["category"] is None:
+
+                found = False
+
+                # Find category in all locales
+                for lc in all_locales("spoiler_categories", "message"):
+                    for key in lc:
+                        if lc[key] == msg.text:
+                            found = True
+                            category = key
+
+                if found is False:
+                    await msg.reply_text(locale("spoiler_incorrect_category", "message", locale=msg.from_user))
+                    return
+
+                col_spoilers.find_one_and_update( {"_id": spoiler["_id"]}, {"$set": {"category": category}} )
+                await msg.reply_text(locale("spoiler_send_description", "message", locale=msg.from_user), reply_markup=ForceReply(placeholder=locale("spoiler_description", "force_reply", locale=msg.from_user)))
+                return
+
+            if spoiler["description"] is None and (spoiler["photo"] is None and spoiler["video"] is None and spoiler["animation"] is None and spoiler["text"] is None):
+
+                # for lc in all_locales("spoiler_description", "keyboard"):
+                #     if msg.text == lc[-1][0]:
+                #         await msg.reply_text(locale("spoiler_description_enter", "message", locale=msg.from_user), reply_markup=ForceReply(placeholder=locale("spoiler_description", "force_reply", locale=msg.from_user)))
+                #         return
+
+                if msg.text != "-":
+                    col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"description": msg.text}} )
+                else:
+                    col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"description": ""}} )
+
+                logWrite(f"Adding description '{msg.text}' to {msg.from_user.id}'s spoiler")
+                await msg.reply_text(locale("spoiler_using_description", "message", locale=msg.from_user).format(msg.text), reply_markup=ForceReply(placeholder=locale("spoiler_content", "force_reply", locale=msg.from_user)))
+
+                return
+
+            ready = False
+
+            if msg.photo is not None:
+                col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"photo": msg.photo.file_id, "caption": msg.caption, "completed": True}} )
+                logWrite(f"Adding photo with id {msg.photo.file_id} to {msg.from_user.id}'s spoiler")
+                ready = True
+
+            if msg.video is not None:
+                col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"video": msg.video.file_id, "caption": msg.caption, "completed": True}} )
+                logWrite(f"Adding video with id {msg.video.file_id} to {msg.from_user.id}'s spoiler")
+                ready = True
+
+            if msg.animation is not None:
+                col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"animation": msg.animation.file_id, "caption": msg.caption, "completed": True}} )
+                logWrite(f"Adding animation with id {msg.animation.file_id} to {msg.from_user.id}'s spoiler")
+                ready = True
+
+            if msg.document is not None:
+                col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"document": msg.document.file_id, "caption": msg.caption, "completed": True}} )
+                logWrite(f"Adding document with id {msg.document.file_id} to {msg.from_user.id}'s spoiler")
+                ready = True
+
+            if spoiler["photo"] is None and spoiler["video"] is None and spoiler["animation"] is None and spoiler["document"] is None and spoiler["text"] is None:
+                if msg.text is not None:
+                    col_spoilers.find_one_and_update( {"user": msg.from_user.id, "completed": False}, {"$set": {"text": msg.text, "completed": True}} )
+                    logWrite(f"Adding text '{msg.text}' to {msg.from_user.id}'s spoiler")
+                    ready = True
+
+            if ready is True:
+                await msg.reply_text(locale("spoiler_ready", "message", locale=msg.from_user), reply_markup=InlineKeyboardMarkup([[InlineKeyboardButton(locale("spoiler_send", "button", locale=msg.from_user), switch_inline_query=f"spoiler:{spoiler['_id'].__str__()}")]]))
+            else:
+                await msg.reply_text(locale("spoiler_incorrect_content", "message", locale=msg.from_user))
+
+
+@app.on_message(~ filters.scheduled & filters.group)
+async def message_in_group(app: Client, msg: Message):
+    if (msg.chat is not None) and (msg.via_bot is not None):
+        if (msg.via_bot.id == (await app.get_me()).id) and (msg.chat.id == configGet("users", "groups")):
+            if msg.text.startswith(locale("spoiler_described", "message").split()[0]) or msg.text.startswith(locale("spoiler_empty", "message").split()[0]):
+                logWrite(f"User {msg.from_user.id} sent spoiler to user's group")
+                try:
+                    logWrite("Forwarding spoiler to admin's group")
+                    await msg.copy(configGet("admin", "groups"), disable_notification=True)
+                except Exception as exp:
+                    logWrite(f"Could not forward spoiler to admin's group due to '{exp}': {print_exc()}")
+                return
+            if configGet("remove_application_time") > 0:
+                logWrite(f"User {msg.from_user.id} requested application in destination group, removing in {configGet('remove_application_time')} minutes")
+                await asyncio.sleep(configGet("remove_application_time")*60)
+                await msg.delete()
+                logWrite(f"Removed application requested by {msg.from_user.id} in destination group")
+# ==============================================================================================================================

modules/handlers/group_join.py

@@ -0,0 +1,45 @@
+from app import app, isAnAdmin
+from pyrogram.types import ChatPermissions, InlineKeyboardMarkup, InlineKeyboardButton, ChatMemberUpdated
+from pyrogram.client import Client
+from modules.utils import configGet, locale
+from modules.logging import logWrite
+from classes.holo_user import HoloUser
+from modules import custom_filters
+
+# Filter users on join =========================================================================================================
+@app.on_chat_member_updated(custom_filters.enabled_invites_check, group=configGet("users", "groups"))
+#@app.on_message(filters.new_chat_members, group=configGet("users", "groups"))
+async def filter_join(app: Client, member: ChatMemberUpdated):
+
+    if member.invite_link != None:
+
+        holo_user = HoloUser(member.from_user)
+
+        if (holo_user.link is not None) and (holo_user.link == member.invite_link.invite_link):
+            logWrite(f"User {holo_user.id} joined destination group with correct link {holo_user.link}")
+            return
+        
+        if await isAnAdmin(member.invite_link.creator.id):
+            logWrite(f"User {holo_user.id} joined destination group with link {holo_user.link} of an admin {member.invite_link.creator.id}")
+            return
+
+        logWrite(f"User {holo_user.id} joined destination group with stolen/unapproved link {holo_user.link}")
+
+        await app.send_message(configGet("admin", "groups"), locale("joined_false_link", "message").format(member.from_user.first_name, member.from_user.id), reply_markup=InlineKeyboardMarkup(
+            [
+                [
+                    InlineKeyboardButton(text=str(locale("sus_allow", "button")), callback_data=f"sus_allow_{member.from_user.id}")
+                ],
+                [
+                    InlineKeyboardButton(text=str(locale("sus_reject", "button")), callback_data=f"sus_reject_{member.from_user.id}")
+                ]
+            ]
+        ))
+        await app.restrict_chat_member(member.chat.id, member.from_user.id, permissions=ChatPermissions(
+                can_send_messages=False,
+                can_send_media_messages=False,
+                can_send_other_messages=False,
+                can_send_polls=False
+            )
+        )
+# ==============================================================================================================================

modules/handlers/voice.py

@@ -0,0 +1,13 @@
+from random import choice
+from app import app
+from pyrogram import filters
+from pyrogram.types import Message
+from pyrogram.client import Client
+from modules.logging import logWrite
+from modules.utils import configGet, locale
+from modules import custom_filters
+
+@app.on_message(custom_filters.enabled_dinovoice & ~filters.scheduled & filters.voice & filters.chat(configGet("users", "groups")))
+async def voice_message(app: Client, msg: Message):
+    logWrite(f"User {msg.from_user.id} sent voice message in destination group")
+    await msg.reply_text(choice(locale("voice_message", "message")))

modules/handlers/welcome.py

@@ -0,0 +1,43 @@
+from app import app
+from pyrogram import filters
+from pyrogram.types import ForceReply, ReplyKeyboardMarkup, Message
+from pyrogram.client import Client
+from classes.holo_user import HoloUser
+from modules.utils import all_locales, locale, logWrite
+from modules import custom_filters
+
+# Welcome check ================================================================================================================
+welcome_1 = []
+for pattern in all_locales("welcome", "keyboard"):
+    welcome_1.append(pattern[0][0])
+for pattern in all_locales("return", "keyboard"):
+    welcome_1.append(pattern[0][0])
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.private & filters.command(welcome_1, prefixes=[""]))
+async def welcome_pass(app: Client, msg: Message, once_again: bool = True) -> None:
+    """Set user's stage to 1 and start a fresh application
+
+    ### Args:
+        * app (app): Pyrogram Client to use 
+        * msg (Message): Message with .from_user.id attribute equal to the end-user ID whose application will be started
+        * once_again (bool, optional): Set to False if it's the first time as user applies. Defaults to True.
+    """    
+
+    if not once_again:
+        await msg.reply_text(locale("privacy_notice", "message"))
+
+    holo_user = HoloUser(msg.from_user)
+
+    holo_user.application_restart()
+        
+    logWrite(f"User {msg.from_user.id} confirmed starting the application")
+    await msg.reply_text(locale("question1", "message", locale=msg.from_user), reply_markup=ForceReply(placeholder=locale("question1", "force_reply", locale=msg.from_user)))
+
+welcome_2 = []
+for pattern in all_locales("welcome", "keyboard"):
+    welcome_2.append(pattern[1][0])
+@app.on_message(custom_filters.enabled_applications & ~filters.scheduled & filters.private & filters.command(welcome_2, prefixes=[""]))
+async def welcome_reject(app: Client, msg: Message):
+
+    logWrite(f"User {msg.from_user.id} rejected to start the application")
+    await msg.reply_text(locale("goodbye", "message", locale=msg.from_user), reply_markup=ReplyKeyboardMarkup(locale("return", "keyboard", locale=msg.from_user), resize_keyboard=True))
+# ==============================================================================================================================

modules/inline.py

@@ -0,0 +1,165 @@
+"""Module responsible for providing answers to
+all inline queries that bot receives"""
+
+from datetime import datetime
+from os import path, sep
+from app import app, isAnAdmin
+from pyrogram.types import InlineQueryResultArticle, InputTextMessageContent, InlineQuery, InlineKeyboardMarkup, InlineKeyboardButton
+from pyrogram.client import Client
+from pyrogram.enums.chat_type import ChatType
+from pyrogram.enums.chat_members_filter import ChatMembersFilter
+from dateutil.relativedelta import relativedelta
+from classes.errors.holo_user import UserNotFoundError, UserInvalidError
+from classes.holo_user import HoloUser
+from modules.utils import configGet, locale
+from modules.database import col_applications, col_spoilers
+from bson.objectid import ObjectId
+from bson.errors import InvalidId
+
+@app.on_inline_query()
+async def inline_answer(client: Client, inline_query: InlineQuery):
+
+    results = []
+
+    if inline_query.query.startswith("spoiler:"):
+        
+        try:
+
+            spoil = col_spoilers.find_one( {"_id": ObjectId(inline_query.query.removeprefix("spoiler:"))} )
+
+            if spoil is not None:
+
+                desc = locale("spoiler_empty", "message", locale=inline_query.from_user).format(locale(spoil["category"], "message", "spoiler_categories")) if spoil["description"] == "" else locale("spoiler_described", "message", locale=inline_query.from_user).format(locale(spoil["category"], "message", "spoiler_categories"), spoil["description"])
+
+                results = [
+                    InlineQueryResultArticle(
+                        title=locale("title", "inline", "spoiler", locale=inline_query.from_user),
+                        description=locale("description", "inline", "spoiler", locale=inline_query.from_user),
+                        input_message_content=InputTextMessageContent(desc, disable_web_page_preview=True),
+                        reply_markup=InlineKeyboardMarkup([[InlineKeyboardButton(locale("spoiler_view", "button", locale=inline_query.from_user), callback_data=f'sid_{inline_query.query.removeprefix("spoiler:")}')]])
+                    )
+                ]
+
+        except InvalidId:
+            results = []
+
+    
+        await inline_query.answer(
+            results=results
+        )
+
+        return
+
+    if inline_query.chat_type in [ChatType.CHANNEL]:
+        await inline_query.answer(
+        results=[
+            InlineQueryResultArticle(
+                title=locale("title", "inline", "not_pm", locale=inline_query.from_user),
+                input_message_content=InputTextMessageContent(
+                    locale("message_content", "inline", "not_pm", locale=inline_query.from_user)
+                ),
+                description=locale("description", "inline", "not_pm", locale=inline_query.from_user)
+                )
+            ]
+        )
+        return
+
+    try:
+        holo_user = HoloUser(inline_query.from_user)
+    except (UserNotFoundError, UserInvalidError):
+        await inline_query.answer(
+        results=[
+            InlineQueryResultArticle(
+                title=locale("title", "inline", "forbidden", locale=inline_query.from_user),
+                input_message_content=InputTextMessageContent(
+                    locale("message_content", "inline", "forbidden", locale=inline_query.from_user)
+                ),
+                description=locale("description", "inline", "forbidden", locale=inline_query.from_user)
+                )
+            ]
+        )
+        return
+
+    if holo_user.application_approved() or (await isAnAdmin(holo_user.id) is True):
+
+        max_results = configGet("inline_preview_count") if inline_query.query != "" else 200
+
+        list_of_users = []
+        async for m in app.get_chat_members(configGet("users", "groups"), limit=max_results, filter=ChatMembersFilter.SEARCH, query=inline_query.query):
+            list_of_users.append(m)
+
+        for match in list_of_users:
+
+            application = col_applications.find_one({"user": match.user.id})
+
+            if application is None:
+                continue
+
+            application_content = []
+            i = 1
+
+            for question in application['application']:
+
+                if i == 2:
+                    age = relativedelta(datetime.now(), application['application']['2'])
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=inline_query.from_user)} {application['application']['2'].strftime('%d.%m.%Y')} ({age.years} р.)")
+                elif i == 3:
+                    if application['application']['3']['countryCode'] == "UA":
+                        application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=inline_query.from_user)} {application['application']['3']['name']}")
+                    else:
+                        application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=inline_query.from_user)} {application['application']['3']['name']} ({application['application']['3']['adminName1']}, {application['application']['3']['countryName']})")
+                else:
+                    application_content.append(f"{locale(f'question{i}', 'message', 'question_titles', locale=inline_query.from_user)} {application['application'][question]}")
+                
+                i += 1
+
+            if match.user.photo != None:
+                try:
+                    if not path.exists(f'{configGet("cache", "locations")}{sep}avatars{sep}{match.user.photo.big_file_id}'):
+                        print(f'Downloaded avatar {match.user.photo.big_file_id} of {match.user.id} and uploaded to {configGet("api")}/?avatar_id={match.user.photo.big_file_id}', flush=True)
+                        await app.download_media(match.user.photo.big_file_id, file_name=f'{configGet("cache", "locations")}{sep}avatars{sep}{match.user.photo.big_file_id}')
+                    results.append(
+                        InlineQueryResultArticle(
+                            title=str(match.user.first_name),
+                            input_message_content=InputTextMessageContent(
+                                locale("message_content", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username, "\n".join(application_content))
+                            ),
+                            description=locale("description", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username),
+                            thumb_url=f'{configGet("api")}/?avatar_id={match.user.photo.big_file_id}'
+                        )
+                    )
+                except ValueError:
+                    results.append(
+                        InlineQueryResultArticle(
+                            title=str(match.user.first_name),
+                            input_message_content=InputTextMessageContent(
+                                locale("message_content", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username, "\n".join(application_content))
+                            ),
+                            description=locale("description", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username)
+                        )
+                    )
+                except FileNotFoundError:
+                    results.append(
+                        InlineQueryResultArticle(
+                            title=str(match.user.first_name),
+                            input_message_content=InputTextMessageContent(
+                                locale("message_content", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username, "\n".join(application_content))
+                            ),
+                            description=locale("description", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username)
+                        )
+                    )
+            else:
+                results.append(
+                    InlineQueryResultArticle(
+                        title=str(match.user.first_name),
+                        input_message_content=InputTextMessageContent(
+                            locale("message_content", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username, "\n".join(application_content))
+                        ),
+                        description=locale("description", "inline", "user", locale=inline_query.from_user).format(match.user.first_name, match.user.username)
+                    )
+                )
+
+        await inline_query.answer(
+            results=results,
+            cache_time=10
+        )

modules/logging.py

@@ -13,6 +13,11 @@ with open(getcwd()+path.sep+"config.json", "r", encoding='utf8') as file:
 
 # Check latest log size
 def checkSize(debug=False):
+    """Check size of latest.log file and rotate it if needed
+
+    ### Args:
+        * debug (`bool`, *optional*): Whether this is a debug log. Defaults to `False`.
+    """    
 
     global log_folder
 
@@ -35,7 +40,13 @@ def checkSize(debug=False):
         pass
 
 # Append string to log
-def logAppend(message, debug=False):
+def logAppend(message: str, debug=False):
+    """Write message to log file
+
+    ### Args:
+        * message (`str`): Message to write
+        * debug (`bool`, *optional*): Whether this is a debug log. Defaults to `False`.
+    """    
 
     global log_folder
 
@@ -52,7 +63,13 @@ def logAppend(message, debug=False):
     log.close()
 
 # Print to stdout and then to log
-def logWrite(message, debug=False):
+def logWrite(message: str, debug=False):
+    """Write message to stdout and log file
+
+    ### Args:
+        * message (`str`): Message to print and write
+        * debug (`bool`, *optional*): Whether this is a debug log. Defaults to `False`.
+    """    
     # save to log file and rotation is to be done
     logAppend(f'{message}', debug=debug)
     print(f"{message}", flush=True)

modules/scheduled.py

@@ -0,0 +1,222 @@
+"""Automatically register commands and execute
+some scheduled tasks is the main idea of this module"""
+
+from os import listdir, makedirs, path, sep
+from apscheduler.schedulers.asyncio import AsyncIOScheduler
+from datetime import datetime, timedelta
+from ujson import dumps
+from app import app
+from pyrogram.types import BotCommand, BotCommandScopeChat
+from pyrogram.errors import bad_request_400
+from pyrogram.enums.chat_members_filter import ChatMembersFilter
+from classes.holo_user import HoloUser
+from modules.utils import configGet, jsonSave, locale, logWrite
+from dateutil.relativedelta import relativedelta
+from modules.database import col_applications, col_sponsorships
+
+scheduler = AsyncIOScheduler()
+
+if configGet("enabled", "scheduler", "cache_members"):
+    @scheduler.scheduled_job(trigger="interval", seconds=configGet("interval", "scheduler", "cache_members"))
+    async def cache_group_members():
+        list_of_users = []
+        async for member in app.get_chat_members(configGet("users", "groups")):
+            list_of_users.append(member.user.id)
+        makedirs("cache", exist_ok=True)
+        jsonSave(list_of_users, path.join(configGet("cache", "locations"), "group_members"))
+
+if configGet("enabled", "scheduler", "cache_admins"):
+    @scheduler.scheduled_job(trigger="interval", seconds=configGet("interval", "scheduler", "cache_admins"))
+    async def cache_admins():
+        list_of_users = []
+        async for member in app.get_chat_members(configGet("admin", "groups")):
+            list_of_users.append(member.user.id)
+        makedirs("cache", exist_ok=True)
+        jsonSave(list_of_users, path.join(configGet("cache", "locations"), "admins"))
+
+# Cache the avatars of group members
+if configGet("enabled", "scheduler", "cache_avatars"):
+    @scheduler.scheduled_job(trigger="date", run_date=datetime.now()+timedelta(seconds=10))
+    @scheduler.scheduled_job(trigger="interval", hours=configGet("interval", "scheduler", "cache_avatars"))
+    async def cache_avatars():
+        list_of_users = []
+        async for member in app.get_chat_members(configGet("users", "groups"), filter=ChatMembersFilter.SEARCH, query=""):
+            list_of_users.append(member.user)
+        for user in list_of_users:
+            if user.photo != None:
+                if not path.exists(f'{configGet("cache", "locations")}{sep}avatars{sep}{user.photo.big_file_id}'):
+                    print(f'Pre-cached avatar {user.photo.big_file_id} of {user.id}', flush=True)
+                    await app.download_media(user.photo.big_file_id, file_name=path.join(configGet("cache", "locations"), "avatars", user.photo.big_file_id))
+        logWrite("Avatars caching performed")
+
+
+# Check for birthdays
+if configGet("enabled", "features", "applications") is True:
+    if configGet("enabled", "scheduler", "birthdays") is True:
+        @scheduler.scheduled_job(trigger="cron", hour=configGet("time", "scheduler", "birthdays"))
+        async def check_birthdays():
+            for entry in col_applications.find():
+                if entry["application"]["2"].strftime("%d.%m") == datetime.now().strftime("%d.%m"):
+                    try:
+                        tg_user = await app.get_users(entry["user"])
+                        await app.send_message( configGet("admin", "groups"), locale("birthday", "message").format(str(tg_user.first_name), str(tg_user.username), str(relativedelta(datetime.now(), entry["application"]["2"], '%d.%m.%Y').years)) ) # type: ignore
+                        logWrite(f"Notified admins about {entry['user']}'s birthday")
+                    except Exception as exp:
+                        logWrite(f"Could not find user {entry['user']} to send a message about birthday due to '{exp}'")
+                        continue
+            logWrite("Birthdays check performed")
+
+
+# Check for expired sponsorships
+if configGet("enabled", "features", "sponsorships") is True:
+    if configGet("enabled", "scheduler", "sponsorships") is True:
+        @scheduler.scheduled_job(trigger="cron", hour=configGet("time", "scheduler", "sponsorships"))
+        async def check_sponsors():
+            for entry in col_sponsorships.find({"sponsorship.expires": {"$lt": datetime.now()+timedelta(days=2)}}):
+                try:
+                    tg_user = await app.get_users(entry["user"])
+                    until_expiry = relativedelta(datetime.now(), entry["sponsorship"]["expires"]).days
+                    await app.send_message( tg_user, locale("sponsorships_expires", "message").format(until_expiry) ) # type: ignore
+                    logWrite(f"Notified user that sponsorship expires in {until_expiry} days")
+                except Exception as exp:
+                    logWrite(f"Could not find user {entry['user']} notify about sponsorship expiry due to '{exp}'")
+                    continue
+            for entry in col_sponsorships.find({"sponsorship.expires": {"$lt": datetime.now()}}):
+                try:
+                    holo_user = HoloUser(entry["user"])
+                    await app.send_message( entry["user"], locale("sponsorships_expired", "message") ) # type: ignore
+                    await holo_user.label_reset(configGet("users", "groups"))
+                    col_sponsorships.find_one_and_delete({"user": holo_user.id})
+                    try:
+                        tg_user = await app.get_users(entry["user"])
+                        logWrite(f"Notified user that sponsorship expired")
+                    except Exception as exp:
+                        logWrite(f"Could not find user {entry['user']} notify about sponsorship expired due to '{exp}'")
+                except Exception as exp:
+                    logWrite(f"Could not reset label of user {entry['user']} due to '{exp}'")
+                    continue
+            logWrite("Sponsorships check performed")
+
+
+# Register all bot commands
+@scheduler.scheduled_job(trigger="date", run_date=datetime.now()+timedelta(seconds=3))
+async def commands_register():
+
+    commands = {
+        "users": [],
+        "admins": [],
+        "owner": [],
+        "group_users": [],
+        "group_admins": [],
+        "locales": {}
+    }
+
+    commands_raw = {
+        "users": [],
+        "admins": [],
+        "owner": [],
+        "group_users": [],
+        "group_admins": [],
+        "locales": {}
+    }
+
+    valid_locales = []
+    files_locales = listdir(f'{configGet("locale", "locations")}')
+
+    for entry in files_locales:
+        if entry.endswith(".json"):
+            valid_locales.append(".".join(entry.split(".")[:-1]))
+            commands["locales"][".".join(entry.split(".")[:-1])] = {
+                "users": [],
+                "admins": [],
+                "owner": [],
+                "group_users": [],
+                "group_admins": []
+            }
+            if configGet("debug") is True:
+                commands_raw["locales"][".".join(entry.split(".")[:-1])] = {
+                    "users": [],
+                    "admins": [],
+                    "owner": [],
+                    "group_users": [],
+                    "group_admins": []
+                }
+
+    config_modules = configGet("features")
+    config_commands = configGet("commands")
+
+
+    for command in config_commands:
+
+        enabled = False
+
+        for module in config_commands[command]["modules"]:
+            if config_modules[module]["enabled"] is True:
+                enabled = True
+
+        if enabled is False:
+            if configGet("debug") is True:
+                logWrite(f"Not registering {command} at all")
+            continue
+
+        for permission in config_commands[command]["permissions"]:
+
+            commands[permission].append(BotCommand(command, locale("commands")[command]))
+
+            if configGet("debug") is True:
+                commands_raw[permission].append({f"{command}": locale("commands")[command]})
+                logWrite(f"Registering {command} for {permission}")
+
+            for lc in valid_locales:
+
+                commands["locales"][lc][permission].append(BotCommand(command, locale("commands", locale=lc)[command]))
+
+                if configGet("debug") is True:
+                    commands_raw["locales"][lc][permission].append({f"{command}": locale("commands", locale=lc)[command]})
+                    logWrite(f"Registering {command} for {permission} [{lc}]")
+
+
+    # Registering user commands
+    await app.set_bot_commands(commands["users"])
+    logWrite("Registered user commands for default locale")
+
+    # Registering user commands for each locale
+    for lc in valid_locales:
+        await app.set_bot_commands(commands["locales"][lc]["users"], language_code=lc)
+        logWrite(f"Registered user commands for locale {lc}")
+
+    # Registering admin commands
+    for admin in configGet("admins"):
+        try:
+            await app.set_bot_commands(commands["admins"]+commands["users"], scope=BotCommandScopeChat(chat_id=admin))
+            logWrite(f"Registered admin commands for admin {admin}")
+        except bad_request_400.PeerIdInvalid:
+            pass
+
+    # Registering owner commands
+    try:
+        await app.set_bot_commands(commands["admins"]+commands["owner"]+commands["users"], scope=BotCommandScopeChat(chat_id=configGet("owner")))
+        for lc in valid_locales:
+            await app.set_bot_commands(commands["locales"][lc]["admins"]+commands["locales"][lc]["owner"]+commands["locales"][lc]["users"], scope=BotCommandScopeChat(chat_id=configGet("owner")))
+        logWrite(f"Registered admin commands for owner {configGet('owner')}")
+    except bad_request_400.PeerIdInvalid:
+        pass
+
+    # Registering admin group commands
+    try:
+        await app.set_bot_commands(commands["group_admins"], scope=BotCommandScopeChat(chat_id=configGet("admin", "groups")))
+        logWrite("Registered admin group commands for default locale")
+    except bad_request_400.ChannelInvalid:
+        logWrite(f"Could not register commands for admin group. Bot is likely not in the group.")
+
+    # Registering destination group commands
+    try:
+        await app.set_bot_commands(commands["group_users"], scope=BotCommandScopeChat(chat_id=configGet("users", "groups")))
+        logWrite("Registered destination group commands")
+    except bad_request_400.ChannelInvalid:
+        logWrite(f"Could not register commands for destination group. Bot is likely not in the group.")
+
+    
+    if configGet("debug") is True:
+        print(commands, flush=True)
+        logWrite(f"Complete commands registration:\n{dumps(commands_raw, indent=4, ensure_ascii=False, encode_html_chars=False)}")

modules/utils.py

@@ -1,11 +1,18 @@
-from typing import Union
+from typing import Any, Literal, Union
+from uuid import uuid1
+from requests import get
+from pyrogram.enums.chat_type import ChatType
+from pyrogram.types import User
+from pyrogram.client import Client
+from pyrogram.errors import bad_request_400
 from ujson import JSONDecodeError as JSONDecodeError
 from ujson import loads, dumps
 
 from sys import exit
-from os import kill, sep
+from os import kill, listdir, makedirs, path, sep
 from os import name as osname
 from traceback import print_exc
+from classes.errors.geo import PlaceNotFoundError
 
 from modules.logging import logWrite
 
@@ -20,7 +27,6 @@ def jsonLoad(filename):
         except FileNotFoundError:
             logWrite(f"Could not load json file {filename}: file does not seem to exist!\n{print_exc()}")
             raise
-        file.close()
     return output
 
 def jsonSave(contents, filename):
@@ -28,51 +34,70 @@ def jsonSave(contents, filename):
     try:
         with open(filename, "w", encoding='utf8') as file:
             file.write(dumps(contents, ensure_ascii=False, indent=4))
-            file.close()
     except Exception as exp:
         logWrite(f"Could not save json file {filename}: {exp}\n{print_exc()}")
     return
 
 
-def configSet(key: str, value, *args: str, file: str = "config"):
-    """Set key to a value
-    Args:
-        * key (str): The last key of the keys path.
-        * value (str/int/float/list/dict/None): Some needed value.
-        * *args (str): Path to key like: dict[args][key].
-        * file (str): User ID to save. Saved to config if not provided. Defaults to "config".
+def nested_set(dic, keys, value, create_missing=True):
+    d = dic
+    for key in keys[:-1]:
+        if key in d:
+            d = d[key]
+        elif create_missing:
+            d = d.setdefault(key, {})
+        else:
+            return dic
+    if keys[-1] in d or create_missing:
+        d[keys[-1]] = value
+    return dic
+
+def configSet(keys: list, value: Any, file: str = "config", create_missing=True):
+    """Set config's value to provided one
+
+    ### Args:
+        * keys (`list`): List of keys from the highest one to target
+        * value (`Any`): Needed value
+        * file (`str`, optional): File (if not config). Defaults to "config".
+        * create_missing (`bool`, optional): Create missing items on the way. Defaults to True.
     """    
     if file == "config":
         filepath = ""
+        this_dict = jsonLoad(f"{filepath}{file}.json")
+        if this_dict["debug"] is True:
+            try:
+                this_dict = jsonLoad("config_debug.json")
+                file = "config_debug"
+            except FileNotFoundError:
+                print("Debug mode is set but config_debug.json is not there! Falling back to config.json", flush=True)
     else:
         filepath = f"data{sep}users{sep}"
-    this_dict = jsonLoad(f"{filepath}{file}.json")
-    string = "this_dict"
-    for arg in args:
-        string += f'["{arg}"]'
-    if type(value) in [str]:
-        string += f'["{key}"] = "{value}"'
-    else:
-        string += f'["{key}"] = {value}'
-    exec(string)
+        this_dict = jsonLoad(f"{filepath}{file}.json")
+        
+    this_dict = nested_set(this_dict, keys, value, create_missing=create_missing)
     jsonSave(this_dict, f"{filepath}{file}.json")
     return
 
 def configGet(key: str, *args: str, file: str = "config"):
     """Get value of the config key
-    Args:
-        * key (str): The last key of the keys path.
-        * *args (str): Path to key like: dict[args][key].
-        * file (str): User ID to load. Loads config if not provided. Defaults to "config".
-    Returns:
+    ### Args:
+        * key (`str`): The last key of the keys path.
+        * *args (`str`): Path to key like: dict[args][key].
+        * file (`str`): User ID to load. Loads config if not provided. Defaults to "config".
+    ### Returns:
         * any: Value of provided key
     """    
     if file == "config":
         try:
             this_dict = jsonLoad("config.json")
         except FileNotFoundError:
-            print("Config file not found! Copy config_example.json to config.json, configure it and rerun the bot!")
+            print("Config file not found! Copy config_example.json to config.json, configure it and rerun the bot!", flush=True)
             exit()
+        if this_dict["debug"] is True:
+            try:
+                this_dict = jsonLoad("config_debug.json")
+            except FileNotFoundError:
+                print("Debug mode is set but config_debug.json is not there! Falling back to config.json", flush=True)
     else:
         this_dict = jsonLoad(f"data{sep}users{sep}{file}.json")
     this_key = this_dict
@@ -80,16 +105,21 @@ def configGet(key: str, *args: str, file: str = "config"):
         this_key = this_key[dict_key]
     return this_key[key]
 
-def locale(key: str, *args: str, locale=configGet("locale")) -> Union[str, list, dict]:
+def locale(key: str, *args: str, locale: Union[str, User] = configGet("locale")) -> Any:
     """Get value of locale string
-    Args:
-        * key (str): The last key of the locale's keys path.
-        * *args (list): Path to key like: dict[args][key].
-        * locale (str): Locale to looked up in. Defaults to config's locale value.
-    Returns:
-        * any: Value of provided locale key
+    ### Args:
+        * key (`str`): The last key of the locale's keys path.
+        * *args (`list`): Path to key like: dict[args][key].
+        * locale (`Union[str, User, HoloUser]`): Locale to looked up in. Provide User to get his `.language_code`. Defaults to config's locale value.
+    ### Returns:
+        * any: Value of provided locale key. In normal case must be `str`, `dict` or `list`.
     """ 
-    if (locale == None):
+    if isinstance(locale, User):
+        locale = locale.language_code
+    elif hasattr(locale, "locale"):
+        locale = locale.locale
+    
+    if locale is None:
         locale = configGet("locale")
     
     try:
@@ -109,6 +139,96 @@ def locale(key: str, *args: str, locale=configGet("locale")) -> Union[str, list,
     except KeyError:
         return f'⚠️ Locale in config is invalid: could not get "{key}" in {str(args)} from locale "{locale}"'
 
+def all_locales(key: str, *args: str) -> list:
+    """Get value of the provided key and path in all available locales
+
+    ### Args:
+        * key (`str`): The last key of the locale's keys path.
+        * *args (`list`): Path to key like: dict[args][key].
+
+    ### Returns:
+        * `list`: List of all values in all locales
+    """    
+
+    output = []
+    valid_locales = []
+
+    files_locales = listdir(f'{configGet("locale", "locations")}')
+    for entry in files_locales:
+        valid_locales.append(".".join(entry.split(".")[:-1]))
+    
+    for lc in valid_locales:
+        try:
+            this_dict = jsonLoad(f'{configGet("locale", "locations")}{sep}{lc}.json')
+        except FileNotFoundError:
+            continue
+
+        this_key = this_dict
+        for dict_key in args:
+            this_key = this_key[dict_key]
+            
+        try:
+            output.append(this_key[key])
+        except KeyError:
+            continue
+
+    return output
+
+def find_location(query: str) -> dict:
+    """Find location on geonames.org by query. Search is made with feature classes A and P.
+
+    ### Args:
+        * query (`str`): Some city/village/state name
+
+    ### Raises:
+        * PlaceNotFoundError: Exception is raised when API result is empty
+
+    ### Returns:
+        * `dict`: One instance of geonames response
+    """    
+    try:
+        result = (get(f"http://api.geonames.org/searchJSON?q={query}&maxRows=1&countryBias=UA&lang=uk&orderby=relevance&featureClass=P&featureClass=A&username={configGet('username', 'geocoding')}")).json()
+        return result["geonames"][0]
+    except (ValueError, KeyError, IndexError):
+        raise PlaceNotFoundError(query)
+
+def create_tmp(bytedata: Union[bytes, bytearray], kind: Union[Literal["image", "video"], None] = None) -> str:
+    """Create temporary file to help uploading it
+
+    ### Args:
+        * bytedata (`Union[bytes, bytearray]`): Some bytes to be written
+        * kind (`Union[Literal["image", "video"], None]`): Kind of upload. Will add `.jpg` or `.mp4` if needed
+
+    ### Returns:
+        * `str`: Path to temporary file
+    """    
+    filename = str(uuid1())
+    if kind == "image":
+        filename += ".jpg"
+    elif kind == "video":
+        filename += ".mp4"
+    makedirs("tmp", exist_ok=True)
+    with open(path.join("tmp", filename), "wb") as file:
+        file.write(bytedata)
+    return path.join("tmp", filename)
+
+async def download_tmp(app: Client, file_id: str) -> bytes:
+    """Download file by its ID and return its bytes
+
+    ### Args:
+        * app (`Client`): App that will download the file
+        * file_id (`str`): File's unique id
+
+    ### Returns:
+        * `bytes`: Bytes of downloaded file
+    """    
+    filename = str(uuid1())
+    makedirs("tmp", exist_ok=True)
+    await app.download_media(file_id, path.join("tmp", filename))
+    with open(path.join("tmp", filename), "rb") as f:
+        bytedata = f.read()
+    return bytedata
+
 try:
     from psutil import Process
 except ModuleNotFoundError:
@@ -118,8 +238,27 @@ except ModuleNotFoundError:
 
 def killProc(pid):
     if osname == "posix":
-        from signal import SIGKILL # type: ignore
+        from signal import SIGKILL
         kill(pid, SIGKILL)
     else:
         p = Process(pid)
-        p.kill()
+        p.kill()
+
+def should_quote(msg):
+    return True if msg.chat.type is not ChatType.PRIVATE else False
+
+async def find_user(app: Client, query: Union[str, int]):
+    try:
+        result = await app.get_users(int(query))
+        if result == [] or result == None:
+            raise TypeError
+    except (TypeError, ValueError):
+        try:
+            result = await app.get_users(query)
+        except bad_request_400.UsernameNotOccupied:
+            return None
+        except bad_request_400.UsernameInvalid:
+            return None
+    except bad_request_400.PeerIdInvalid:
+        return None
+    return result

requirements.txt

@@ -1,4 +1,10 @@
-pyrogram>=2.0.59
-tgcrypto>=1.2.4
-ujson>=5.5.0
-psutil>=5.9.2
+APScheduler==3.9.1.post1
+fastapi==0.88.0
+psutil==5.9.4
+pymongo==4.3.3
+Pyrogram~=2.0.93
+requests==2.28.1
+tgcrypto==1.2.5
+python_dateutil==2.8.2
+starlette==0.23.0
+ujson==5.6.0

validation/applications.json

@@ -0,0 +1,87 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "user",
+            "date",
+            "admin",
+            "application",
+            "application.1",
+            "application.2",
+            "application.3",
+            "application.3.name",
+            "application.3.adminName1",
+            "application.3.countryCode",
+            "application.3.countryName",
+            "application.3.location",
+            "application.4",
+            "application.5",
+            "application.6",
+            "application.7",
+            "application.8",
+            "application.9",
+            "application.10"
+        ],
+        "properties": {
+            "user": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of user"
+            },
+            "date": {
+                "bsonType": "date",
+                "description": "Date when application was accepted"
+            },
+            "admin": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of admin that accepted the application"
+            },
+            "application": {
+                "bsonType": "object"
+            },
+            "application.1": {
+                "bsonType": "string"
+            },
+            "application.2": {
+                "bsonType": "date"
+            },
+            "application.3": {
+                "bsonType": "object"
+            },
+            "application.3.name": {
+                "bsonType": "string"
+            },
+            "application.3.adminName1": {
+                "bsonType": "string"
+            },
+            "application.3.countryCode": {
+                "bsonType": "string"
+            },
+            "application.3.countryName": {
+                "bsonType": "string"
+            },
+            "application.3.location": {
+                "bsonType": "array"
+            },
+            "application.4": {
+                "bsonType": "string"
+            },
+            "application.5": {
+                "bsonType": "string"
+            },
+            "application.6": {
+                "bsonType": "string"
+            },
+            "application.7": {
+                "bsonType": "string"
+            },
+            "application.8": {
+                "bsonType": "string"
+            },
+            "application.9": {
+                "bsonType": "string"
+            },
+            "application.10": {
+                "bsonType": "string"
+            }
+        }
+    }
+}

validation/context.json

@@ -0,0 +1,6 @@
+{
+    "$jsonSchema": {
+        "required": [],
+        "properties": {}
+    }
+}

validation/messages.json

@@ -0,0 +1,36 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "origin",
+            "origin.chat",
+            "origin.id",
+            "destination",
+            "destination.chat",
+            "destination.id"
+        ],
+        "properties": {
+            "origin": {
+                "bsonType": "object"
+            },
+            "origin.chat": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of message's origin chat"
+            },
+            "origin.id": {
+                "bsonType": ["int", "long"],
+                "description": "ID of message in origin chat"
+            },
+            "destination": {
+                "bsonType": "object"
+            },
+            "destination.chat": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of message's destination chat"
+            },
+            "destination.id": {
+                "bsonType": ["int", "long"],
+                "description": "ID of message in destination chat"
+            }
+        }
+    }
+}

validation/spoilers.json

@@ -0,0 +1,59 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "user",
+            "completed",
+            "category",
+            "description",
+            "photo",
+            "video",
+            "animation",
+            "document",
+            "caption",
+            "text"
+        ],
+        "properties": {
+            "user": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of user"
+            },
+            "completed": {
+                "bsonType": "bool",
+                "description": "Whether spoiler is a completed one"
+            },
+            "category": {
+                "bsonType": ["string", "null"],
+                "enum": ["nsfw", "deanon", "other"],
+                "description": "Spoiler's category"
+            },
+            "description": {
+                "bsonType": ["string", "null"],
+                "description": "Spoiler's description"
+            },
+            "photo": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered photo"
+            },
+            "video": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered video"
+            },
+            "animation": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered animation/GIF"
+            },
+            "document": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered document/file"
+            },
+            "caption": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered caption for media"
+            },
+            "text": {
+                "bsonType": ["string", "null"],
+                "description": "Spoilered text"
+            }
+        }
+    }
+}

validation/sponsorships.json

@@ -0,0 +1,43 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "user",
+            "date",
+            "admin",
+            "sponsorship",
+            "sponsorship.streamer",
+            "sponsorship.expires",
+            "sponsorship.proof",
+            "sponsorship.label"
+        ],
+        "properties": {
+            "user": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of user"
+            },
+            "date": {
+                "bsonType": "date",
+                "description": "Date when sponsorship was accepted"
+            },
+            "admin": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of admin that accepted the sponsorship"
+            },
+            "sponsorship": {
+                "bsonType": "object"
+            },
+            "sponsorship.streamer": {
+                "bsonType": "string"
+            },
+            "sponsorship.expires": {
+                "bsonType": "date"
+            },
+            "sponsorship.proof": {
+                "bsonType": "string"
+            },
+            "sponsorship.label": {
+                "bsonType": "string"
+            }
+        }
+    }
+}

validation/tmp.json

@@ -0,0 +1,6 @@
+{
+    "$jsonSchema": {
+        "required": [],
+        "properties": {}
+    }
+}

validation/users.json

@@ -0,0 +1,43 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "user",
+            "link",
+            "label",
+            "tg_name",
+            "tg_phone",
+            "tg_locale",
+            "tg_username"
+        ],
+        "properties": {
+            "user": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of user"
+            },
+            "link": {
+                "bsonType": ["string", "null"],
+                "description": "Invite link to destination group"
+            },
+            "label": {
+                "bsonType": "string",
+                "description": "Label given by admins"
+            },
+            "tg_name": {
+                "bsonType": "string",
+                "description": "Telegram first name"
+            },
+            "tg_phone": {
+                "bsonType": ["string", "null"],
+                "description": "Telegram phone number"
+            },
+            "tg_locale": {
+                "bsonType": ["string", "null"],
+                "description": "Telegram locale"
+            },
+            "tg_username": {
+                "bsonType": ["string", "null"],
+                "description": "Telegram username"
+            }
+        }
+    }
+}

validation/warnings.json

@@ -0,0 +1,28 @@
+{
+    "$jsonSchema": {
+        "required": [
+            "user",
+            "admin",
+            "date",
+            "reason"
+        ],
+        "properties": {
+            "user": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of user"
+            },
+            "admin": {
+                "bsonType": ["int", "long"],
+                "description": "Telegram ID of admin"
+            },
+            "date": {
+                "bsonType": "date",
+                "description": "Date and time of getting"
+            },
+            "reason": {
+                "bsonType": "string",
+                "description": "Broken rule or admin's comment"
+            }
+        }
+    }
+}