ecapi-sdk 3.4.6__tar.gz → 3.5.0__tar.gz

{ecapi_sdk-3.4.6 → ecapi_sdk-3.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecapi-sdk
-Version: 3.4.6
+Version: 3.5.0
 Summary: ECAPI SDK for Python
 Author: EaseCation
 License: MIT

{ecapi_sdk-3.4.6 → ecapi_sdk-3.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ecapi-sdk"
-version = "3.4.6"
+version = "3.5.0"
 description = "ECAPI SDK for Python"
 readme = "README.md"
 requires-python = ">=3.9"

{ecapi_sdk-3.4.6 → ecapi_sdk-3.5.0}/src/ecapi_sdk/client.py

@@ -486,6 +486,7 @@ class AdminAPI(_BaseApi):
         self.mail = AdminMailAPI(http)
         self.operation_log = AdminOperationLogAPI(http)
         self.overwatch_case = AdminOverwatchCaseAPI(http)
+        self.overwatch_supervisor = AdminOverwatchSupervisorAPI(http)
         self.permission = AdminPermissionAPI(http)
         self.player_data = AdminPlayerDataAPI(http)
         self.player_merchandise = AdminPlayerMerchandiseAPI(http)
@@ -528,6 +529,10 @@ class AdminOperationLogAPI(_BaseApi):
         return self._get(f"/admin/operation-logs", query, **kwargs)
 
 class AdminOverwatchCaseAPI(_BaseApi):
+    def get_case(self, caseId: Union[int, float], **kwargs: Any) -> Any:
+        """查询监管案件详情"""
+        return self._get(f"/admin/overwatch-cases/{quote(str(caseId), safe='')}/detail", None, **kwargs)
+
     def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """分页查询 Overwatch 案件"""
         return self._get(f"/admin/overwatch-cases", query, **kwargs)
@@ -536,6 +541,27 @@ class AdminOverwatchCaseAPI(_BaseApi):
         """创建或更新 Overwatch 监督案件"""
         return self._put(f"/admin/overwatch-cases/{quote(str(recordId), safe='')}", payload, **kwargs)
 
+class AdminOverwatchSupervisorAPI(_BaseApi):
+    def get_candidates(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """筛选监管者候选玩家"""
+        return self._get(f"/admin/overwatch-supervisors/candidates", query, **kwargs)
+
+    def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询全部监管者"""
+        return self._get(f"/admin/overwatch-supervisors", query, **kwargs)
+
+    def remove(self, ecid: str, **kwargs: Any) -> Any:
+        """撤销监管者资格"""
+        return self._delete(f"/admin/overwatch-supervisors/{quote(str(ecid), safe='')}", None, **kwargs)
+
+    def select(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """批量选拔监管者"""
+        return self._post(f"/admin/overwatch-supervisors/select", payload, **kwargs)
+
+    def update(self, ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """修改监管者资格"""
+        return self._patch(f"/admin/overwatch-supervisors/{quote(str(ecid), safe='')}", payload, **kwargs)
+
 class AdminPermissionAPI(_BaseApi):
     def delete_entitlement(self, ecid: str, entitlementKey: str, **kwargs: Any) -> Any:
         """删除玩家权益"""
@@ -747,6 +773,59 @@ class GameLogAPI(_BaseApi):
         """分页查询游戏玩家记录"""
         return self._get(f"/game-logs/players", query, **kwargs)
 
+class EchoMelandAPI(_BaseApi):
+    def add_favorite(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any:
+        """添加玩家家园收藏"""
+        return self._put(f"/homeland/players/{quote(str(ecid), safe='')}/favorites/{quote(str(worldId), safe='')}", None, **kwargs)
+
+    def delete_member(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any:
+        """移除家园成员"""
+        return self._delete(f"/homeland/worlds/{quote(str(worldId), safe='')}/members/{quote(str(ecid), safe='')}", None, **kwargs)
+
+    def get_overview(self, **kwargs: Any) -> Any:
+        """查询家园全服概览"""
+        return self._get(f"/homeland/overview", None, **kwargs)
+
+    def get_player(self, ecid: str, **kwargs: Any) -> Any:
+        """查询玩家家园数据"""
+        return self._get(f"/homeland/players/{quote(str(ecid), safe='')}", None, **kwargs)
+
+    def get_servers(self, **kwargs: Any) -> Any:
+        """查询家园服务器运行数据"""
+        return self._get(f"/homeland/servers", None, **kwargs)
+
+    def get_snapshots(self, worldId: Union[int, float], query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询家园最近存档"""
+        return self._get(f"/homeland/worlds/{quote(str(worldId), safe='')}/snapshots", query, **kwargs)
+
+    def get_world(self, worldId: Union[int, float], **kwargs: Any) -> Any:
+        """查询家园详情"""
+        return self._get(f"/homeland/worlds/{quote(str(worldId), safe='')}", None, **kwargs)
+
+    def get_worlds(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询全服家园"""
+        return self._get(f"/homeland/worlds", query, **kwargs)
+
+    def remove_favorite(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any:
+        """移除玩家家园收藏"""
+        return self._delete(f"/homeland/players/{quote(str(ecid), safe='')}/favorites/{quote(str(worldId), safe='')}", None, **kwargs)
+
+    def rollback_world(self, worldId: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """回档家园"""
+        return self._post(f"/homeland/worlds/{quote(str(worldId), safe='')}/rollback", payload, **kwargs)
+
+    def update_ender_chest(self, ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """修改玩家家园末影箱"""
+        return self._patch(f"/homeland/players/{quote(str(ecid), safe='')}/ender-chest", payload, **kwargs)
+
+    def update_world(self, worldId: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """修改家园资料和配置"""
+        return self._patch(f"/homeland/worlds/{quote(str(worldId), safe='')}", payload, **kwargs)
+
+    def upsert_member(self, worldId: Union[int, float], ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新增或修改家园成员"""
+        return self._put(f"/homeland/worlds/{quote(str(worldId), safe='')}/members/{quote(str(ecid), safe='')}", payload, **kwargs)
+
 class LogAPI(_BaseApi):
     def __init__(self, http: _HttpClient) -> None:
         super().__init__(http)
@@ -956,7 +1035,6 @@ class PlayerStatusAPI(_BaseApi):
 class ServerAPI(_BaseApi):
     def __init__(self, http: _HttpClient) -> None:
         super().__init__(http)
-        self.attendance = ServerAttendanceAPI(http)
         self.broadcast = ServerBroadcastAPI(http)
         self.config_sync = ServerConfigSyncAPI(http)
         self.easechat = ServerEaseChatAPI(http)
@@ -983,11 +1061,6 @@ class ServerAPI(_BaseApi):
         """查询服务器运行列表"""
         return self._get(f"/servers", query, **kwargs)
 
-class ServerAttendanceAPI(_BaseApi):
-    def set_projection(self, ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
-        """设置管理员出勤投影"""
-        return self._put(f"/admin/players/{quote(str(ecid), safe='')}/attendance-projection", payload, **kwargs)
-
 class ServerBroadcastAPI(_BaseApi):
     def compare(self, **kwargs: Any) -> Any:
         """查询 Broadcast 差异"""
@@ -1283,6 +1356,7 @@ class ECAPIClient:
         self.audit = AuditAPI(self._http)
         self.auth = AuthAPI(self._http)
         self.game_log = GameLogAPI(self._http)
+        self.homeland = EchoMelandAPI(self._http)
         self.log = LogAPI(self._http)
         self.pit2 = PIT2API(self._http)
         self.player = PlayerAPI(self._http)

{ecapi_sdk-3.4.6 → ecapi_sdk-3.5.0}/src/ecapi_sdk/client.pyi

@@ -291,6 +291,13 @@ class AdminOverwatchCaseAPIListQuery(TypedDict, total=False):
     recordId: QueryValue
     current: QueryValue
     pageSize: QueryValue
+    status: QueryValue
+    source: QueryValue
+    targetEcid: QueryValue
+    reviewType: QueryValue
+    reviewStatus: QueryValue
+    startTime: QueryValue
+    endTime: QueryValue
 
 class AdminOverwatchCaseAPIUpsertByRecordBody(TypedDict, total=False):
     status: str
@@ -302,6 +309,31 @@ class AdminOverwatchCaseAPIUpsertByRecordBody(TypedDict, total=False):
     reviewType: str
     reviewStatus: str
 
+class AdminOverwatchSupervisorAPIListQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    status: QueryValue
+    keyword: QueryValue
+
+class AdminOverwatchSupervisorAPIGetCandidatesQuery(TypedDict, total=False):
+    minExp: QueryValue
+    activeWithinDays: QueryValue
+    maxBanDegree: QueryValue
+    limit: QueryValue
+
+class AdminOverwatchSupervisorAPISelectBodyRequired(TypedDict):
+    ecids: Sequence[Any]
+
+class AdminOverwatchSupervisorAPISelectBody(AdminOverwatchSupervisorAPISelectBodyRequired, total=False):
+    minExp: int
+    activeWithinDays: int
+    maxBanDegree: int
+    months: int
+
+class AdminOverwatchSupervisorAPIUpdateBody(TypedDict, total=False):
+    level: int
+    expiry: Optional[str]
+
 class AdminPermissionAPISetAnticheatPermissionBodyRequired(TypedDict):
     enabled: bool
 
@@ -596,6 +628,46 @@ class GameLogAPIGetPlayersQuery(GameLogAPIGetPlayersQueryRequired, total=False):
     current: QueryValue
     pageSize: QueryValue
 
+class EchoMelandAPIUpdateEnderChestBodyRequired(TypedDict):
+    nbtBase64: Optional[str]
+
+class EchoMelandAPIUpdateEnderChestBody(EchoMelandAPIUpdateEnderChestBodyRequired, total=False):
+    pass
+
+class EchoMelandAPIGetWorldsQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    worldId: QueryValue
+    ecid: QueryValue
+    keyword: QueryValue
+    worldType: QueryValue
+    isPublic: QueryValue
+    loaded: QueryValue
+
+class EchoMelandAPIUpdateWorldBody(TypedDict, total=False):
+    worldType: int
+    isPublic: bool
+    name: str
+    description: Optional[str]
+    minPlayerLevel: int
+    metaJson: str
+
+class EchoMelandAPIUpsertMemberBodyRequired(TypedDict):
+    userType: str
+
+class EchoMelandAPIUpsertMemberBody(EchoMelandAPIUpsertMemberBodyRequired, total=False):
+    userNbtBase64: Optional[str]
+
+class EchoMelandAPIRollbackWorldBodyRequired(TypedDict):
+    mapVersionId: str
+    metaVersionId: str
+
+class EchoMelandAPIRollbackWorldBody(EchoMelandAPIRollbackWorldBodyRequired, total=False):
+    pass
+
+class EchoMelandAPIGetSnapshotsQuery(TypedDict, total=False):
+    limit: QueryValue
+
 class LogAPIGetAuthQuery(TypedDict, total=False):
     ecid: QueryValue
     action: QueryValue
@@ -839,18 +911,6 @@ class ServerAPIGetMainstackEventsQueryRequired(TypedDict):
 class ServerAPIGetMainstackEventsQuery(ServerAPIGetMainstackEventsQueryRequired, total=False):
     pass
 
-class ServerAttendanceAPISetProjectionBodyRequired(TypedDict):
-    eventId: str
-    revision: int
-    state: str
-    sessionId: Optional[str]
-    startedAt: Optional[str]
-    elapsedMinutes: int
-    occurredAt: str
-
-class ServerAttendanceAPISetProjectionBody(ServerAttendanceAPISetProjectionBodyRequired, total=False):
-    reason: str
-
 class ServerBroadcastAPIDeployBodyRequired(TypedDict):
     items: Sequence[Any]
 
@@ -1201,6 +1261,7 @@ class AdminAPI:
     mail: AdminMailAPI
     operation_log: AdminOperationLogAPI
     overwatch_case: AdminOverwatchCaseAPI
+    overwatch_supervisor: AdminOverwatchSupervisorAPI
     permission: AdminPermissionAPI
     player_data: AdminPlayerDataAPI
     player_merchandise: AdminPlayerMerchandiseAPI
@@ -1226,9 +1287,17 @@ class AdminOperationLogAPI:
     def list(self, query: Optional[AdminOperationLogAPIListQuery] = ..., **kwargs: Any) -> Any: ...
 
 class AdminOverwatchCaseAPI:
+    def get_case(self, caseId: Union[int, float], **kwargs: Any) -> Any: ...
     def list(self, query: Optional[AdminOverwatchCaseAPIListQuery] = ..., **kwargs: Any) -> Any: ...
     def upsert_by_record(self, recordId: Union[int, float], payload: AdminOverwatchCaseAPIUpsertByRecordBody, **kwargs: Any) -> Any: ...
 
+class AdminOverwatchSupervisorAPI:
+    def get_candidates(self, query: Optional[AdminOverwatchSupervisorAPIGetCandidatesQuery] = ..., **kwargs: Any) -> Any: ...
+    def list(self, query: Optional[AdminOverwatchSupervisorAPIListQuery] = ..., **kwargs: Any) -> Any: ...
+    def remove(self, ecid: str, **kwargs: Any) -> Any: ...
+    def select(self, payload: AdminOverwatchSupervisorAPISelectBody, **kwargs: Any) -> Any: ...
+    def update(self, ecid: str, payload: AdminOverwatchSupervisorAPIUpdateBody, **kwargs: Any) -> Any: ...
+
 class AdminPermissionAPI:
     def delete_entitlement(self, ecid: str, entitlementKey: str, **kwargs: Any) -> Any: ...
     def set_anticheat_permission(self, ecid: str, payload: AdminPermissionAPISetAnticheatPermissionBody, **kwargs: Any) -> Any: ...
@@ -1301,6 +1370,21 @@ class GameLogAPI:
     def get_pit_sessions(self, query: Optional[GameLogAPIGetPitSessionsQuery] = ..., **kwargs: Any) -> Any: ...
     def get_players(self, query: GameLogAPIGetPlayersQuery, **kwargs: Any) -> Any: ...
 
+class EchoMelandAPI:
+    def add_favorite(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any: ...
+    def delete_member(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any: ...
+    def get_overview(self, **kwargs: Any) -> Any: ...
+    def get_player(self, ecid: str, **kwargs: Any) -> Any: ...
+    def get_servers(self, **kwargs: Any) -> Any: ...
+    def get_snapshots(self, worldId: Union[int, float], query: Optional[EchoMelandAPIGetSnapshotsQuery] = ..., **kwargs: Any) -> Any: ...
+    def get_world(self, worldId: Union[int, float], **kwargs: Any) -> Any: ...
+    def get_worlds(self, query: Optional[EchoMelandAPIGetWorldsQuery] = ..., **kwargs: Any) -> Any: ...
+    def remove_favorite(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any: ...
+    def rollback_world(self, worldId: Union[int, float], payload: EchoMelandAPIRollbackWorldBody, **kwargs: Any) -> Any: ...
+    def update_ender_chest(self, ecid: str, payload: EchoMelandAPIUpdateEnderChestBody, **kwargs: Any) -> Any: ...
+    def update_world(self, worldId: Union[int, float], payload: EchoMelandAPIUpdateWorldBody, **kwargs: Any) -> Any: ...
+    def upsert_member(self, worldId: Union[int, float], ecid: str, payload: EchoMelandAPIUpsertMemberBody, **kwargs: Any) -> Any: ...
+
 class LogAPI:
     order: LogOrderAPI
     order_download_task: LogOrderDownloadTaskAPI
@@ -1378,7 +1462,6 @@ class PlayerStatusAPI:
     def get(self, query: PlayerStatusAPIGetQuery, **kwargs: Any) -> Any: ...
 
 class ServerAPI:
-    attendance: ServerAttendanceAPI
     broadcast: ServerBroadcastAPI
     config_sync: ServerConfigSyncAPI
     easechat: ServerEaseChatAPI
@@ -1396,9 +1479,6 @@ class ServerAPI:
     def get_statistics(self, **kwargs: Any) -> Any: ...
     def list(self, query: Optional[ServerAPIListQuery] = ..., **kwargs: Any) -> Any: ...
 
-class ServerAttendanceAPI:
-    def set_projection(self, ecid: str, payload: ServerAttendanceAPISetProjectionBody, **kwargs: Any) -> Any: ...
-
 class ServerBroadcastAPI:
     def compare(self, **kwargs: Any) -> Any: ...
     def create(self, payload: ServerBroadcastAPICreateBody, **kwargs: Any) -> Any: ...
@@ -1506,6 +1586,7 @@ class ECAPIClient:
     audit: AuditAPI
     auth: AuthAPI
     game_log: GameLogAPI
+    homeland: EchoMelandAPI
     log: LogAPI
     pit2: PIT2API
     player: PlayerAPI

{ecapi_sdk-3.4.6 → ecapi_sdk-3.5.0}/src/ecapi_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecapi-sdk
-Version: 3.4.6
+Version: 3.5.0
 Summary: ECAPI SDK for Python
 Author: EaseCation
 License: MIT