pssapi 0.2.3__tar.gz → 0.3.0__tar.gz

{pssapi-0.2.3 → pssapi-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pssapi
-Version: 0.2.3
+Version: 0.3.0
 Summary: Wrapper for the Pixel Starships API
 Home-page: https://github.com/PSS-Tools-Development/pssapi.py
 License: MIT
@@ -16,8 +16,10 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: APScheduler (>=3.10.4,<4.0.0)
 Requires-Dist: aiohttp (>=3.8.4,<4.0.0)
 Requires-Dist: pytz (>=2022.7.1,<2023.0.0)
+Requires-Dist: websockets (>=12.0,<13.0)
 Project-URL: Bug Tracker, https://github.com/PSS-Tools-Development/pssapi.py/issues
 Project-URL: Changelog, https://github.com/PSS-Tools-Development/pssapi.py/releases
 Description-Content-Type: text/markdown

{pssapi-0.2.3 → pssapi-0.3.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "pssapi"
 description = "Wrapper for the Pixel Starships API"
-version = "0.2.3"
+version = "0.3.0"
 license = "MIT"
 authors = [
     "The worst. <theworstpss@gmail.com>",
@@ -30,6 +30,8 @@ build-backend = "poetry.core.masonry.api"
 python = "^3.11"
 aiohttp = "^3.8.4"
 pytz = "^2022.7.1"
+websockets = "^12.0"
+APScheduler = "^3.10.4"
 
 [tool.poetry.group.dev.dependencies]
 autoflake = "^2.0.1"

pssapi-0.3.0/src/pssapi/__init__.py

@@ -0,0 +1,14 @@
+from . import entities, enums, exc, pusher, raw, utils
+from .client import PssApiClient
+
+__all__ = [
+    entities.__name__,
+    enums.__name__,
+    exc.__name__,
+    pusher.__name__,
+    raw.__name__,
+    utils.__name__,
+    PssApiClient.__name__,
+]
+
+__version__ = "0.3.0"

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/constants.py

@@ -9,3 +9,7 @@ DATETIME_FORMAT_ISO: str = "%Y-%m-%dT%H:%M:%S"
 DATETIME_FORMAT_ISO_DETAILED: str = "%Y-%m-%dT%H:%M:%S.%f"
 
 DEFAULT_PRODUCTION_SERVER: str = "api.pixelstarships.com"
+
+PUSHER_APP_CLUSTER: str = "mt1"
+PUSHER_APP_ID: str = "258a49f843d21115d7f7"
+PUSHER_AUTH_URL: str = f"http://{DEFAULT_PRODUCTION_SERVER}/UserService/PusherAuth"

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/raw/character_design_raw.py

@@ -64,6 +64,7 @@ class CharacterDesignRaw:
         self._speech_pitch: int = _parse.pss_int(character_design_info.get("SpeechPitch"))
         self._speech_rate: int = _parse.pss_int(character_design_info.get("SpeechRate"))
         self._speech_voice: str = _parse.pss_str(character_design_info.get("SpeechVoice"))
+        self._tags: str = _parse.pss_str(character_design_info.get("Tags"))
         self._tap_sound_file_id: int = _parse.pss_int(character_design_info.get("TapSoundFileId"))
         self._training_capacity: int = _parse.pss_int(character_design_info.get("TrainingCapacity"))
         self._walking_speed: int = _parse.pss_int(character_design_info.get("WalkingSpeed"))
@@ -250,6 +251,10 @@ class CharacterDesignRaw:
     def speech_voice(self) -> str:
         return self._speech_voice
 
+    @property
+    def tags(self) -> str:
+        return self._tags
+
     @property
     def tap_sound_file_id(self) -> int:
         return self._tap_sound_file_id
@@ -317,6 +322,7 @@ class CharacterDesignRaw:
             self.speech_pitch,
             self.speech_rate,
             self.speech_voice,
+            self.tags,
             self.tap_sound_file_id,
             self.training_capacity,
             self.walking_speed,
@@ -372,6 +378,7 @@ class CharacterDesignRaw:
                 "SpeechPitch": self.speech_pitch,
                 "SpeechRate": self.speech_rate,
                 "SpeechVoice": self.speech_voice,
+                "Tags": self.tags,
                 "TapSoundFileId": self.tap_sound_file_id,
                 "TrainingCapacity": self.training_capacity,
                 "WalkingSpeed": self.walking_speed,

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/raw/room_design_raw.py

@@ -60,6 +60,7 @@ class RoomDesignRaw:
         self._rows: int = _parse.pss_int(room_design_info.get("Rows"))
         self._sort_index: int = _parse.pss_int(room_design_info.get("SortIndex"))
         self._supported_grid_types: int = _parse.pss_int(room_design_info.get("SupportedGridTypes"))
+        self._tags: str = _parse.pss_str(room_design_info.get("Tags"))
         self._target_type: str = _parse.pss_str(room_design_info.get("TargetType"))
         self._upgrade_from_room_design_id: int = _parse.pss_int(room_design_info.get("UpgradeFromRoomDesignId"))
 
@@ -247,6 +248,10 @@ class RoomDesignRaw:
     def supported_grid_types(self) -> int:
         return self._supported_grid_types
 
+    @property
+    def tags(self) -> str:
+        return self._tags
+
     @property
     def target_type(self) -> str:
         return self._target_type
@@ -303,6 +308,7 @@ class RoomDesignRaw:
             self.rows,
             self.sort_index,
             self.supported_grid_types,
+            self.tags,
             self.target_type,
             self.upgrade_from_room_design_id,
         )
@@ -356,6 +362,7 @@ class RoomDesignRaw:
                 "Rows": self.rows,
                 "SortIndex": self.sort_index,
                 "SupportedGridTypes": self.supported_grid_types,
+                "Tags": self.tags,
                 "TargetType": self.target_type,
                 "UpgradeFromRoomDesignId": self.upgrade_from_room_design_id,
             }

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/raw/setting_raw.py

@@ -82,6 +82,7 @@ class SettingRaw:
         self._loading_subtitle_sprite_id: int = _parse.pss_int(setting_info.get("LoadingSubtitleSpriteId"))
         self._loading_title_sprite_id: int = _parse.pss_int(setting_info.get("LoadingTitleSpriteId"))
         self._loot_modifiers: str = _parse.pss_str(setting_info.get("LootModifiers"))
+        self._maintenance_date: _datetime = _parse.pss_datetime(setting_info.get("MaintenanceDate"))
         self._maintenance_message: str = _parse.pss_str(setting_info.get("MaintenanceMessage"))
         self._maintenance_title: str = _parse.pss_str(setting_info.get("MaintenanceTitle"))
         self._marker_generator_design_version: int = _parse.pss_int(setting_info.get("MarkerGeneratorDesignVersion"))
@@ -91,6 +92,8 @@ class SettingRaw:
         self._max_redemption_count_per_month: int = _parse.pss_int(setting_info.get("MaxRedemptionCountPerMonth"))
         self._merchant_ship_exterior_sprite_id: int = _parse.pss_int(setting_info.get("MerchantShipExteriorSpriteId"))
         self._merchant_ship_sprite_id: int = _parse.pss_int(setting_info.get("MerchantShipSpriteId"))
+        self._min_purchase_reward_points_for_starbux_trading: int = _parse.pss_int(setting_info.get("MinPurchaseRewardPointsForStarbuxTrading"))
+        self._min_trophies_for_starbux_trading: int = _parse.pss_int(setting_info.get("MinTrophiesForStarbuxTrading"))
         self._minimum_client_version: str = _parse.pss_str(setting_info.get("MinimumClientVersion"))
         self._minimum_version: str = _parse.pss_str(setting_info.get("MinimumVersion"))
         self._missile_design_version: int = _parse.pss_int(setting_info.get("MissileDesignVersion"))
@@ -417,6 +420,10 @@ class SettingRaw:
     def loot_modifiers(self) -> str:
         return self._loot_modifiers
 
+    @property
+    def maintenance_date(self) -> _datetime:
+        return self._maintenance_date
+
     @property
     def maintenance_message(self) -> str:
         return self._maintenance_message
@@ -453,6 +460,14 @@ class SettingRaw:
     def merchant_ship_sprite_id(self) -> int:
         return self._merchant_ship_sprite_id
 
+    @property
+    def min_purchase_reward_points_for_starbux_trading(self) -> int:
+        return self._min_purchase_reward_points_for_starbux_trading
+
+    @property
+    def min_trophies_for_starbux_trading(self) -> int:
+        return self._min_trophies_for_starbux_trading
+
     @property
     def minimum_client_version(self) -> str:
         return self._minimum_client_version
@@ -750,6 +765,7 @@ class SettingRaw:
             self.loading_subtitle_sprite_id,
             self.loading_title_sprite_id,
             self.loot_modifiers,
+            self.maintenance_date,
             self.maintenance_message,
             self.maintenance_title,
             self.marker_generator_design_version,
@@ -759,6 +775,8 @@ class SettingRaw:
             self.max_redemption_count_per_month,
             self.merchant_ship_exterior_sprite_id,
             self.merchant_ship_sprite_id,
+            self.min_purchase_reward_points_for_starbux_trading,
+            self.min_trophies_for_starbux_trading,
             self.minimum_client_version,
             self.minimum_version,
             self.missile_design_version,
@@ -888,6 +906,7 @@ class SettingRaw:
                 "LoadingSubtitleSpriteId": self.loading_subtitle_sprite_id,
                 "LoadingTitleSpriteId": self.loading_title_sprite_id,
                 "LootModifiers": self.loot_modifiers,
+                "MaintenanceDate": self.maintenance_date,
                 "MaintenanceMessage": self.maintenance_message,
                 "MaintenanceTitle": self.maintenance_title,
                 "MarkerGeneratorDesignVersion": self.marker_generator_design_version,
@@ -897,6 +916,8 @@ class SettingRaw:
                 "MaxRedemptionCountPerMonth": self.max_redemption_count_per_month,
                 "MerchantShipExteriorSpriteId": self.merchant_ship_exterior_sprite_id,
                 "MerchantShipSpriteId": self.merchant_ship_sprite_id,
+                "MinPurchaseRewardPointsForStarbuxTrading": self.min_purchase_reward_points_for_starbux_trading,
+                "MinTrophiesForStarbuxTrading": self.min_trophies_for_starbux_trading,
                 "MinimumClientVersion": self.minimum_client_version,
                 "MinimumVersion": self.minimum_version,
                 "MissileDesignVersion": self.missile_design_version,

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/raw/skin_raw.py

@@ -23,6 +23,7 @@ class SkinRaw:
         self._original_animation_id: int = _parse.pss_int(skin_info.get("OriginalAnimationId"))
         self._original_sprite_id: int = _parse.pss_int(skin_info.get("OriginalSpriteId"))
         self._race_id: int = _parse.pss_int(skin_info.get("RaceId"))
+        self._reference_id: int = _parse.pss_int(skin_info.get("ReferenceId"))
         self._requirement_string: str = _parse.pss_str(skin_info.get("RequirementString"))
         self._root_id: int = _parse.pss_int(skin_info.get("RootId"))
         self._skin_description: str = _parse.pss_str(skin_info.get("SkinDescription"))
@@ -66,6 +67,10 @@ class SkinRaw:
     def race_id(self) -> int:
         return self._race_id
 
+    @property
+    def reference_id(self) -> int:
+        return self._reference_id
+
     @property
     def requirement_string(self) -> str:
         return self._requirement_string
@@ -116,6 +121,7 @@ class SkinRaw:
             self.original_animation_id,
             self.original_sprite_id,
             self.race_id,
+            self.reference_id,
             self.requirement_string,
             self.root_id,
             self.skin_description,
@@ -139,6 +145,7 @@ class SkinRaw:
                 "OriginalAnimationId": self.original_animation_id,
                 "OriginalSpriteId": self.original_sprite_id,
                 "RaceId": self.race_id,
+                "ReferenceId": self.reference_id,
                 "RequirementString": self.requirement_string,
                 "RootId": self.root_id,
                 "SkinDescription": self.skin_description,

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/raw/user_raw.py

@@ -99,6 +99,7 @@ class UserRaw:
         self._race_type: str = _parse.pss_str(user_info.get("RaceType"))
         self._ranking: int = _parse.pss_int(user_info.get("Ranking"))
         self._rewards_collectable: bool = _parse.pss_bool(user_info.get("RewardsCollectable"))
+        self._rewards_collectable_amount: int = _parse.pss_int(user_info.get("RewardsCollectableAmount"))
         self._ship_design_id: int = _parse.pss_int(user_info.get("ShipDesignId"))
         self._situation_occurrences: str = _parse.pss_str(user_info.get("SituationOccurrences"))
         self._situation_occurrences_today: int = _parse.pss_int(user_info.get("SituationOccurrencesToday"))
@@ -453,6 +454,10 @@ class UserRaw:
     def rewards_collectable(self) -> bool:
         return self._rewards_collectable
 
+    @property
+    def rewards_collectable_amount(self) -> int:
+        return self._rewards_collectable_amount
+
     @property
     def ship_design_id(self) -> int:
         return self._ship_design_id
@@ -637,6 +642,7 @@ class UserRaw:
             self.race_type,
             self.ranking,
             self.rewards_collectable,
+            self.rewards_collectable_amount,
             self.ship_design_id,
             self.situation_occurrences,
             self.situation_occurrences_today,
@@ -749,6 +755,7 @@ class UserRaw:
                 "RaceType": self.race_type,
                 "Ranking": self.ranking,
                 "RewardsCollectable": self.rewards_collectable,
+                "RewardsCollectableAmount": self.rewards_collectable_amount,
                 "ShipDesignId": self.ship_design_id,
                 "SituationOccurrences": self.situation_occurrences,
                 "SituationOccurrencesToday": self.situation_occurrences_today,

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/entities/skin.py

@@ -11,7 +11,7 @@ class Skin(_SkinRaw, _EntityWithIdBase):
         super().__init__(skin_info)
         self._skin_type_enum: _enums.RoomStatus = _parse.pss_str_enum(self.skin_type, _enums.SkinType)
         self._skin_metadata: _SkinMetadata = _SkinMetadata(self.metadata)
-        self._sprite_type_enum: _enums.RoomSpriteType = _parse.pss_str_enum(self.sprite_type, _enums.RoomSpriteType)
+        self._sprite_type_enum: _enums.SpriteType = _parse.pss_str_enum(self.sprite_type, _enums.SpriteType)
 
     @property
     def id(self) -> int:
@@ -26,5 +26,5 @@ class Skin(_SkinRaw, _EntityWithIdBase):
         return self._skin_type_enum
 
     @property
-    def sprite_type_enum(self) -> "_enums.RoomSpriteType":
+    def sprite_type_enum(self) -> "_enums.SpriteType":
         return self._sprite_type_enum

{pssapi-0.2.3 → pssapi-0.3.0}/src/pssapi/enums/__init__.py

@@ -82,6 +82,7 @@ from .progression_type import ProgressionType
 from .promotion_design_flag import PromotionDesignFlag
 from .promotion_type import PromotionType
 from .purchase_vip_status import PurchaseVIPStatus
+from .pusher_channel_type import PusherChannelType
 from .race_type import RaceType
 from .rarity import Rarity
 from .research_design_type import ResearchDesignType
@@ -105,6 +106,7 @@ from .situation_type import SituationType
 from .skin_type import SkinType
 from .special_ability_type import SpecialAbilityType
 from .special_rule_type import SpecialRuleType
+from .sprite_type import SpriteType
 from .status import Status
 from .str_enum_base import StrEnumBase
 from .target_type import TargetType
@@ -113,6 +115,7 @@ from .task_design_flags_type import TaskDesignFlagsType
 from .training_animation_style import TrainingAnimationStyle
 from .trigger_type import TriggerType
 from .user_flags import UserFlags
+from .user_source_ads_platform_type import UserSourceAdsPlatformType
 from .user_status import UserStatus
 from .user_type import UserType
 from .visibility_flags import VisibilityFlags
@@ -200,6 +203,7 @@ __all__ = [
     PromotionDesignFlag.__name__,
     PromotionType.__name__,
     PurchaseVIPStatus.__name__,
+    PusherChannelType.__name__,
     RaceType.__name__,
     Rarity.__name__,
     AvailabilityMask.__name__,
@@ -224,6 +228,7 @@ __all__ = [
     SkinType.__name__,
     SpecialAbilityType.__name__,
     SpecialRuleType.__name__,
+    SpriteType.__name__,
     Status.__name__,
     StrEnumBase.__name__,
     TargetType.__name__,
@@ -232,6 +237,7 @@ __all__ = [
     TrainingAnimationStyle.__name__,
     TriggerType.__name__,
     UserFlags.__name__,
+    UserSourceAdsPlatformType.__name__,
     UserStatus.__name__,
     UserType.__name__,
     VisibilityFlags.__name__,

pssapi-0.3.0/src/pssapi/enums/pusher_channel_type.py

@@ -0,0 +1,28 @@
+from pssapi.enums.str_enum_base import StrEnumBase
+
+
+class PusherChannelType(StrEnumBase):
+    MARKET = "market"
+    INCOMING_MESSAGES_PRIVATE = "private-user"
+    GLOBAL = "public-global"
+    ENGLISH = "public-en"
+    AFRIKAAN = "public-af"
+    ARABIC = "public-ar"
+    CHINESE_SIMPLIFIED = "public-zh-Hans"
+    CHINESE_TRADITIONAL = "public-zh-Hant"
+    CZECH = "public-cs"
+    DUTCH = "public-nl"
+    FRENCH = "public-fr"
+    GERMAN = "public-de"
+    INDONESIAN = "public-id"
+    ITALIAN = "public-it"
+    JAPANESE = "public-ja"
+    KOREAN = "public-ko"
+    POLISH = "public-pl"
+    PORTUGUESE = "public-pt"
+    RUSSIAN = "public-ru"
+    SPANISH = "public-es"
+    SWEDISH = "public-sv"
+    THAI = "public-th"
+    TURKISH = "public-tr"
+    VIETNAMESE = "public-vi"

pssapi-0.3.0/src/pssapi/enums/sprite_type.py

@@ -0,0 +1,12 @@
+from .str_enum_base import StrEnumBase as _StrEnumBase
+
+
+class SpriteType(_StrEnumBase):
+    NONE = "None"
+    INTERIOR = "Interior"
+    EXTERIOR = "Exterior"
+    INTERIOR_DESTROYED = "InteriorDestroyed"
+    EXTERIOR_DESTROYED = "ExteriorDestroyed"
+    INTERIOR_ACTIVATE = "InteriorActivate"
+    EXTERIOR_ACTIVATE = "ExteriorActivate"
+    LOADING = "Loading"

pssapi-0.3.0/src/pssapi/enums/user_source_ads_platform_type.py

@@ -0,0 +1,10 @@
+from .str_enum_base import StrEnumBase as _StrEnumBase
+
+
+class UserSourceAdsPlatformType(_StrEnumBase):
+    UNKNOWN = "Unknown"
+    CHANYOU = "Chanyou"
+    BAIDU = "Baidu"
+    TIKTOK = "Tiktok"
+    BILIBILI = "Bilibili"
+    NO_REPORTING_USER = "NoReportingUser"

pssapi-0.3.0/src/pssapi/exc.py

@@ -0,0 +1,14 @@
+from typing import Optional
+
+
+class PusherConnectionClosed(Exception):
+    """
+    Raised when a Pusher connection is closed.
+    """
+
+    def __init__(self, message: str, code: Optional[int] = None, error_message: Optional[str] = "") -> None:
+        super().__init__(message)
+
+        self.message = message
+        self.code = code
+        self.error_message = error_message

pssapi-0.3.0/src/pssapi/pusher/__init__.py

@@ -0,0 +1,7 @@
+from .channel import Channel
+from .pusher import Pusher
+
+__all__ = [
+    Channel.__name__,
+    Pusher.__name__,
+]

pssapi-0.3.0/src/pssapi/pusher/channel.py

@@ -0,0 +1,46 @@
+from json import loads
+from typing import Callable, Optional
+
+from aiohttp import ClientSession
+
+from pssapi.constants import PUSHER_AUTH_URL
+
+
+class Channel:
+    def __init__(self, name: str, private: Optional[bool] = False, endpoint: Optional[str] = PUSHER_AUTH_URL) -> None:
+        """
+        Create a new `Channel` instance
+        Args:
+            `name` - Name of the channel
+            `endpoint` - Authentication endpoint
+            `private` - Whether the channel is private (requires `token` to be specified)
+        """
+        self.name = name
+        self.endpoint = endpoint
+        self.private = private
+        self.callback = lambda _: None
+
+    def on_message(self, callback: Optional[Callable]) -> None:
+        """
+        Set a callback to be called when a message is received
+        Args:
+            `callback` - The function to be called, `lambda _: None` if not specified
+        """
+        if callback:
+            self.callback = callback
+
+        else:
+            self.callback = lambda _: None
+
+    async def _auth(self, token: str, socket_id: str) -> str:
+        data = {
+            "channel_name": self.name,
+            "socket_id": socket_id,
+        }
+        endpoint = f"{self.endpoint}?accessToken={token}"
+
+        async with ClientSession() as session:
+            async with session.post(endpoint, data=data) as response:
+                assert response.ok, "Couldn't authenticate connection"
+
+                return loads(await response.text())["auth"]

pssapi-0.3.0/src/pssapi/pusher/pusher.py

@@ -0,0 +1,166 @@
+from inspect import isawaitable
+from json import dumps, loads
+from platform import system
+from typing import Any, Optional
+
+from apscheduler.schedulers.asyncio import AsyncIOScheduler
+from apscheduler.triggers.interval import IntervalTrigger
+from websockets.client import connect
+
+import pssapi
+from pssapi.constants import PUSHER_APP_CLUSTER, PUSHER_APP_ID
+from pssapi.exc import PusherConnectionClosed
+from pssapi.pusher.channel import Channel
+
+
+# TODO: Add error handling, add ping/pong timeout
+class Pusher:
+    # Should be of the form `platform-library`
+    client: str = f"{system()}-pssapi"
+
+    # Pusher protocol (as of 6/1/23, protocol 7)
+    protocol: int = 7
+
+    # Time values
+    connection_timeout: int = 305
+    ping_interval: int = 120
+
+    _socket_id = ""
+
+    _connection = None
+    _scheduler = AsyncIOScheduler()
+
+    _channels: dict[Channel] = dict()
+
+    @classmethod
+    async def _connect_to_pusher(cls) -> None:
+        host = f"ws://ws-{PUSHER_APP_CLUSTER}.pusher.com"
+        url = f"{host}/app/{PUSHER_APP_ID}?client={cls.client}&version={pssapi.__version__}&protocol={cls.protocol}"
+
+        cls._connection = await connect(url)
+        await cls._send_ping()
+
+    @classmethod
+    async def _send_event(cls, event_name: str, data: Any, channel: Optional[str] = None) -> None:
+        event = {"event": event_name, "data": data}
+        if channel:
+            event["channel"] = channel
+
+        event = dumps(event)
+        await cls._connection.send(event)
+
+    # Ping pong
+    @classmethod
+    async def _send_ping(cls) -> None:
+        await cls._send_event("pusher:ping", "")
+
+    @classmethod
+    async def _send_pong(cls) -> None:
+        await cls._send_event("pusher:pong", "")
+
+    @classmethod
+    def _reset_connection_timeout(cls, job_id: Any) -> None:
+        cls._scheduler.reschedule_job(job_id, trigger=IntervalTrigger(seconds=cls.connection_timeout))
+
+    @classmethod
+    async def _connection_closed(cls, code: Optional[int] = None, error_message: Optional[str] = "") -> None:
+        await cls._connection.close()
+
+        if code or error_message:
+            raise PusherConnectionClosed(
+                f"""Connection closed.
+Code: {code}
+Message: {error_message}""",
+                code,
+                error_message,
+            )
+
+        raise PusherConnectionClosed("Connection timed out / closed with unknown cause.")
+
+    # Scheduled tasks
+    @classmethod
+    def _start_timers(cls) -> None:
+        job_id = cls._scheduler.add_job(cls._connection_closed, IntervalTrigger(seconds=cls.connection_timeout)).id
+        cls._scheduler.add_job(cls._send_ping, IntervalTrigger(seconds=cls.ping_interval))
+
+        return job_id
+
+    @classmethod
+    async def _subscribe(cls, channel: Channel, token: Optional[str] = "") -> None:
+        if channel.private and not token:
+            raise ValueError("Token required if channel is private.")
+
+        data = {"channel": channel.name, "auth": await channel._auth(token, cls._socket_id) if channel.private else "", "channel_data": "{}"}
+        await cls._send_event("pusher:subscribe", data)
+
+    @classmethod
+    def add(cls, channel: Channel) -> None:
+        """
+        Add a new channel to subscribe to
+        Args:
+            - `channel` - The channel to subscribe to
+        """
+        cls._channels[channel.name] = channel
+
+    @classmethod
+    async def _handle_message(cls, event: str, data: dict, channel: Optional[str] = "", token: Optional[str] = "") -> None:
+        if event == "pusher:connection_established":
+            cls._socket_id = data["socket_id"]
+
+            for channel_name in cls._channels.keys():
+                channel = cls._channels[channel_name]
+
+                await cls._subscribe(channel, token)
+
+        if event == "pusher:error":
+            return await cls._connection_closed(data["code"], data["message"])
+
+        if channel and event == "message":
+            channel_class = cls._channels.get(channel)
+            if not channel_class:
+                return
+
+            callback = channel_class.callback
+            if isawaitable(callback):
+                return await callback(data)
+
+            return callback(data)
+
+    @classmethod
+    def _keep_persistent_connection(cls, token: str, user_id: int) -> None:
+        if not token and not user_id:
+            return
+
+        if token and not user_id:
+            raise RuntimeError("Token specified but not user_id")
+
+        if user_id and not token:
+            raise RuntimeError("user_id specified but no token")
+
+        channel = Channel(f"private-user-{user_id}", private=True)
+        cls.add(channel)
+
+    @classmethod
+    async def run(cls, token: Optional[str] = "", user_id: Optional[int] = 0) -> None:
+        """
+        Start the Pusher client
+        Args:
+            - `token`: Account-binded token (required to auth/keep persistent connection)
+            - `user_id`: User ID of the account (acquired through `SearchUsers`)
+        """
+        job_id = cls._start_timers()
+        cls._scheduler.start()
+
+        await cls._connect_to_pusher()
+        cls._keep_persistent_connection(token, user_id)
+
+        while True:
+            message = await cls._connection.recv()
+            message = loads(message)
+            cls._reset_connection_timeout(job_id)
+
+            event = message["event"]
+            data = loads(message["data"]) if isinstance(message["data"], str) else message["data"]
+            channel = message["channel"] if message.get("channel") else ""
+
+            await cls._handle_message(event, data, channel, token)