Merge pull request #28 from remnawave:development

Update API versions and add new models for HWID and users

Author: sm1ky

README.md

@@ -63,7 +63,8 @@ pip install git+https://github.com/remnawave/python-sdk.git@development
 
 | Contract Version | Remnawave Panel Version |
 | ---------------- | ----------------------- |
-| 2.3.0            | >=2.3.0                 |
+| 2.3.2            | >=2.3.0                 |
+| 2.3.0            | >=2.3.0, <2.3.2         |
 | 2.2.6            | ==2.2.6                 |
 | 2.2.3            | >=2.2.13                |
 | 2.1.19           | >=2.1.19, <2.2.0        |

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "remnawave"
-version = "2.3.0"
-description = "A Python SDK for interacting with the Remnawave API v2.3.0."
+version = "2.3.2"
+description = "A Python SDK for interacting with the Remnawave API v2.3.2."
 authors = [
     {name = "Artem",email = "[email protected]"}
 ]

remnawave/controllers/hwid.py

@@ -1,4 +1,4 @@
-from typing import Annotated
+from typing import Annotated, Optional
 from uuid import UUID
 
 from remnawave.models import (
@@ -8,9 +8,10 @@
     GetHwidStatisticsResponseDto,
     CreateHWIDUser,
     HWIDDeleteRequest,
-    DeleteUserAllHwidDeviceRequestDto
+    DeleteUserAllHwidDeviceRequestDto,
+    GetTopUsersByHwidDevicesResponseDto
 )
-from rapid_api_client import Path, PydanticBody
+from rapid_api_client import Path, PydanticBody, Query
 from remnawave.rapid import AttributeBody, BaseController, post, get
 
 
@@ -62,3 +63,12 @@ async def get_hwid_user(
     ) -> GetUserHwidDevicesResponseDto:
         """Get a user HWID device"""
         ...
+
+    @get("/hwid/devices/top-users", response_class=GetTopUsersByHwidDevicesResponseDto)
+    async def get_top_users_by_hwid_devices(
+        self,
+        size: Annotated[Optional[int], Query(default=None, description="Page size for pagination")] = None,
+        start: Annotated[Optional[int], Query(default=None, description="Offset for pagination")] = None,
+    ) -> GetTopUsersByHwidDevicesResponseDto:
+        """Get top users by HWID devices"""
+        ...

remnawave/models/__init__.py

@@ -84,7 +84,10 @@
     HWIDUserResponseDto,  # Legacy alias
     HWIDUserResponseDtoList,  # Legacy alias
     GetHwidStatisticsResponseDto,
-    DeleteUserAllHwidDeviceRequestDto
+    DeleteUserAllHwidDeviceRequestDto,
+    GetTopUsersByHwidDevicesResponseDto,
+    TopUserByHwidDevicesDto,
+    TopUsersByHwidDevicesData,
 )
 from .inbounds import (
     AllInboundsData,
@@ -351,6 +354,7 @@
     CustomErrorEventDto,
     CrmEventDto,
     WebhookPayloadDto,
+    UserTrafficDto
 )
 from .passkeys import (
     DeletePasskeyRequestDto,
@@ -545,6 +549,9 @@
     "HWIDUserResponseDtoList",  # Legacy alias
     "GetHwidStatisticsResponseDto",
     "DeleteUserAllHwidDeviceRequestDto",
+    "GetTopUsersByHwidDevicesResponseDto",
+    "TopUserByHwidDevicesDto",
+    "TopUsersByHwidDevicesData",
     # Bandwidth stats models
     "GetNodeUserUsageByRangeResponseDto",
     "GetNodesRealtimeUsageResponseDto",
@@ -712,6 +719,7 @@
     "BaseUserDto",
     "UserDto",
     "UserEventDto",
+    "UserTrafficDto",
 
     # HWID DEVICES
     "HwidUserDeviceDto",

remnawave/models/bandwidthstats.py

@@ -23,6 +23,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class GetNodesUsageByRangeResponseDto(RootModel[List[NodeUsageResponseDto]]):
@@ -31,6 +39,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class NodeRealtimeUsageResponseDto(BaseModel):
@@ -51,6 +67,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class GetNodesRealtimeUsageResponseDto(RootModel[List[NodeRealtimeUsageResponseDto]]):
@@ -59,6 +83,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class UserUsageByRangeItem(BaseModel):
@@ -75,6 +107,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class NodeUserUsageItem(BaseModel):
@@ -91,3 +131,11 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)

remnawave/models/external_squads.py

@@ -39,8 +39,6 @@ class ExternalSquadSubscriptionSettingsDto(BaseModel):
     happ_routing: Optional[str] = Field(None, alias="happRouting")
     randomize_hosts: bool = Field(alias="randomizeHosts")
 
-
-# НОВЫЕ МОДЕЛИ
 class ExternalSquadHostOverridesDto(BaseModel):
     """External squad host overrides"""
     server_description: Optional[str] = Field(None, alias="serverDescription", max_length=30)
@@ -61,7 +59,7 @@ class ExternalSquadDto(BaseModel):
 
 
 # Request/Response models
-class GetExternalSquadsResponseDto(ExternalSquadDto):
+class GetExternalSquadsResponseDto(BaseModel):
     """Response with all external squads"""
     total: int = Field(alias="total")
     external_squads: List[ExternalSquadDto] = Field(alias="externalSquads")

remnawave/models/hosts.py

@@ -43,6 +43,7 @@ class UpdateHostRequestDto(BaseModel):
     tag: Optional[Annotated[str, StringConstraints(max_length=32, pattern=r"^[A-Z0-9_:]+$")]] = None
     is_hidden: Optional[bool] = Field(None, serialization_alias="isHidden")
     override_sni_from_address: Optional[bool] = Field(None, serialization_alias="overrideSniFromAddress")
+    keep_blank_sni: Optional[bool] = Field(None, serialization_alias="keepBlankSni")
     vless_route_id: Optional[int] = Field(None, serialization_alias="vlessRouteId", ge=0, le=65535)
     shuffle_host: Optional[bool] = Field(None, serialization_alias="shuffleHost")
     mihomo_x25519: Optional[bool] = Field(None, serialization_alias="mihomoX25519")
@@ -83,6 +84,7 @@ class HostResponseDto(BaseModel):
     security_layer: SecurityLayer = Field(SecurityLayer.DEFAULT, alias="securityLayer")
     is_hidden: bool = Field(False, alias="isHidden")
     override_sni_from_address: bool = Field(False, alias="overrideSniFromAddress")
+    keep_blank_sni: bool = Field(False, alias="keepBlankSni")
     allow_insecure: bool = Field(False, alias="allowInsecure")
     xray_json_template_uuid: Optional[UUID] = Field(None, alias="xrayJsonTemplateUuid")
     excluded_internal_squads: List[UUID] = Field(default_factory=list, alias="excludedInternalSquads")
@@ -116,6 +118,7 @@ class CreateHostRequestDto(BaseModel):
     security_layer: SecurityLayer = Field(SecurityLayer.DEFAULT, serialization_alias="securityLayer")
     is_hidden: bool = Field(False, serialization_alias="isHidden")
     override_sni_from_address: bool = Field(False, serialization_alias="overrideSniFromAddress")
+    keep_blank_sni: bool = Field(False, serialization_alias="keepBlankSni")
     xray_json_template_uuid: Optional[UUID] = Field(None, serialization_alias="xrayJsonTemplateUuid")
     excluded_internal_squads: List[UUID] = Field(default_factory=list, serialization_alias="excludedInternalSquads")
 
@@ -161,6 +164,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class GetOneHostResponseDto(HostResponseDto):

remnawave/models/hwid.py

@@ -76,9 +76,27 @@ class GetHwidStatisticsResponseDto(HwidStatisticsData):
 
 class DeleteUserAllHwidDeviceRequestDto(BaseModel):
     user_uuid: UUID = Field(serialization_alias="userUuid")
+    
+class TopUserByHwidDevicesDto(BaseModel):
+    """Top user by HWID devices"""
+    user_uuid: UUID = Field(alias="userUuid")
+    id: int
+    username: str
+    devices_count: int = Field(alias="devicesCount")
+
+
+class TopUsersByHwidDevicesData(BaseModel):
+    """Top users by HWID devices data"""
+    users: list[TopUserByHwidDevicesDto]
+    total: int
+
+
+class GetTopUsersByHwidDevicesResponseDto(TopUsersByHwidDevicesData):
+    """Response for get top users by HWID devices"""
+    pass
 
 # Legacy aliases for backward compatibility
 CreateHWIDUser = CreateUserHwidDeviceRequestDto
 HWIDUserResponseDto = HwidDeviceDto
 HWIDUserResponseDtoList = HwidDevicesData
-HWIDDeleteRequest = DeleteUserHwidDeviceRequestDto
+HWIDDeleteRequest = DeleteUserHwidDeviceRequestDto

remnawave/models/inbounds.py

@@ -41,6 +41,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class FullInboundStatistic(BaseModel):
@@ -66,6 +74,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 # Legacy aliases for backward compatibility

remnawave/models/nodes.py

@@ -169,6 +169,15 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
+
 
 
 class EnableNodeResponseDto(NodeResponseDto):
@@ -195,6 +204,14 @@ def __iter__(self):
 
     def __getitem__(self, item):
         return self.root[item]
+    
+    def __bool__(self):
+        """Return True if list is not empty"""
+        return bool(self.root)
+    
+    def __len__(self):
+        """Return length of list"""
+        return len(self.root)
 
 
 class DeleteNodeResponseDto(BaseModel):