ecapi-sdk 3.7.2__tar.gz → 3.7.3__tar.gz

{ecapi_sdk-3.7.2 → ecapi_sdk-3.7.3}/PKG-INFO

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

{ecapi_sdk-3.7.2 → ecapi_sdk-3.7.3}/pyproject.toml

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

{ecapi_sdk-3.7.2 → ecapi_sdk-3.7.3}/src/ecapi_sdk/client.py

@@ -4,6 +4,9 @@ from __future__ import annotations
 import asyncio
 import inspect
 import json
+import mimetypes
+from pathlib import Path
+from uuid import uuid4
 from dataclasses import dataclass
 from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, Union
 from urllib.error import HTTPError, URLError
@@ -21,6 +24,61 @@ REQUEST_OPTION_KEYS = {"body", "headers", "response_type", "auth"}
 DEFAULT_BASE_URL = "https://api.easecation.net"
 
 
+class _MultipartBody:
+    """Stream ordinary files without buffering a large ZIP in memory."""
+    def __init__(self, payload: Mapping[str, Any], binary_fields: Sequence[str]) -> None:
+        self.boundary = "ecapi-" + uuid4().hex
+        self.parts = []
+        self.length = 0
+        for name, value in payload.items():
+            if value is None:
+                continue
+            if not name.replace("_", "").isalnum():
+                raise ValueError("Invalid multipart field name")
+            prefix = f'--{self.boundary}\r\nContent-Disposition: form-data; name="{name}"'
+            if name in binary_fields:
+                if isinstance(value, Path):
+                    if not value.is_file():
+                        raise ValueError("Upload path must be an ordinary file")
+                    filename, data, size = value.name, value, value.stat().st_size
+                elif isinstance(value, tuple) and len(value) == 2 and isinstance(value[0], str) and isinstance(value[1], bytes):
+                    filename, data = value
+                    size = len(data)
+                else:
+                    raise TypeError("Binary fields require pathlib.Path or (filename, bytes)")
+                if any(c in filename for c in '\r\n\0'):
+                    raise ValueError("Invalid upload filename")
+                filename = filename.replace('"', '%22').replace('\\', '%5C')
+                mime = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                prefix += f'; filename="{filename}"\r\nContent-Type: {mime}'
+            else:
+                data = (str(value).lower() if isinstance(value, bool) else str(value)).encode("utf-8")
+                size = len(data)
+            prefix = (prefix + "\r\n\r\n").encode("utf-8")
+            self.parts.append((prefix, data, size))
+            self.length += len(prefix) + size + 2
+        self.suffix = f"--{self.boundary}--\r\n".encode("ascii")
+        self.length += len(self.suffix)
+
+    def __iter__(self):
+        for prefix, data, size in self.parts:
+            yield prefix
+            if isinstance(data, Path):
+                with data.open("rb") as handle:
+                    remaining = size
+                    while remaining:
+                        chunk = handle.read(min(65536, remaining))
+                        if not chunk:
+                            raise OSError("Upload file changed while reading")
+                        remaining -= len(chunk)
+                        yield chunk
+                    if handle.read(1):
+                        raise OSError("Upload file changed while reading")
+            else:
+                yield data
+            yield b"\r\n"
+        yield self.suffix
+
 class ECAPIError(Exception):
     def __init__(self, message: str, status: int, payload: Any, url: str) -> None:
         resolved_message = _extract_error_message(payload) or message
@@ -224,7 +282,11 @@ class _HttpClient:
                     merged_headers["Authorization"] = f"Bearer {token}"
 
         request_data: Optional[bytes] = None
-        if body is not None:
+        if isinstance(body, _MultipartBody):
+            merged_headers["Content-Type"] = "multipart/form-data; boundary=" + body.boundary
+            merged_headers["Content-Length"] = str(body.length)
+            request_data = body
+        elif body is not None:
             content_type = merged_headers.get("Content-Type", "")
             if not content_type:
                 merged_headers["Content-Type"] = "application/json"
@@ -487,6 +549,7 @@ class AdminAPI(_BaseApi):
         self.operation_log = AdminOperationLogAPI(http)
         self.overwatch_case = AdminOverwatchCaseAPI(http)
         self.overwatch_supervisor = AdminOverwatchSupervisorAPI(http)
+        self.parkour = AdminParkourAPI(http)
         self.permission = AdminPermissionAPI(http)
         self.player_data = AdminPlayerDataAPI(http)
         self.player_merchandise = AdminPlayerMerchandiseAPI(http)
@@ -494,6 +557,7 @@ class AdminAPI(_BaseApi):
         self.player_wallet = AdminPlayerWalletAPI(http)
         self.punishment = AdminPunishmentAPI(http)
         self.source_account_binding = AdminSourceAccountBindingAPI(http)
+        self.sp_workbench = AdminSpWorkbenchAPI(http)
         self.vote_reward_mail = AdminVoteRewardMailAPI(http)
 
 class AdminAccountAPI(_BaseApi):
@@ -562,6 +626,15 @@ class AdminOverwatchSupervisorAPI(_BaseApi):
         """修改监管者资格"""
         return self._patch(f"/admin/overwatch-supervisors/{quote(str(ecid), safe='')}", payload, **kwargs)
 
+class AdminParkourAPI(_BaseApi):
+    def clear_community_scores(self, ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """清除社区版逐关成绩"""
+        return self._post(f"/admin/players/{quote(str(ecid), safe='')}/parkour/community-score-clears", payload, **kwargs)
+
+    def preview_community_score_clear(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """预览社区版逐关成绩清除范围"""
+        return self._get(f"/admin/players/{quote(str(ecid), safe='')}/parkour/community-score-clear-preview", query, **kwargs)
+
 class AdminPermissionAPI(_BaseApi):
     def delete_entitlement(self, ecid: str, entitlementKey: str, **kwargs: Any) -> Any:
         """删除玩家权益"""
@@ -660,6 +733,10 @@ class AdminPunishmentAPI(_BaseApi):
         """解除处罚"""
         return self._delete(f"/admin/players/{quote(str(ecid), safe='')}/punishments/{quote(str(type), safe='')}", query, **kwargs)
 
+    def set_parkour_punishment(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """设置老版跑酷天堂成绩惩罚"""
+        return self._post(f"/punishments/parkour", payload, **kwargs)
+
 class AdminSourceAccountBindingAPI(_BaseApi):
     def bind_account_player(self, xuid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """绑定或改绑来源账号到玩家"""
@@ -677,11 +754,53 @@ class AdminSourceAccountBindingAPI(_BaseApi):
         """解绑玩家名下全部来源账号"""
         return self._delete(f"/admin/players/{quote(str(ecid), safe='')}/source-accounts", None, **kwargs)
 
+class AdminSpWorkbenchAPI(_BaseApi):
+    def capabilities(self, **kwargs: Any) -> Any:
+        """只读查询 SP 专用进度执行能力"""
+        return self._get(f"/admin/sp/progress/capabilities", None, **kwargs)
+
+    def progress(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """执行 SP 专用标准值进度修正"""
+        return self._post(f"/admin/sp/progress/operations", payload, **kwargs)
+
 class AdminVoteRewardMailAPI(_BaseApi):
     def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """创建投票奖励邮件"""
         return self._post(f"/admin/vote-reward-mails", payload, **kwargs)
 
+class AnnouncementsAPI(_BaseApi):
+    def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新建公告"""
+        return self._post(f"/admin/announcements", payload, **kwargs)
+
+    def get(self, id: str, **kwargs: Any) -> Any:
+        """读取公告管理详情"""
+        return self._get(f"/admin/announcements/{quote(str(id), safe='')}", None, **kwargs)
+
+    def list(self, **kwargs: Any) -> Any:
+        """读取服内生效公告"""
+        return self._get(f"/announcements", None, **kwargs)
+
+    def list_get(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询公告管理列表"""
+        return self._get(f"/admin/announcements", query, **kwargs)
+
+    def move(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """原子移动公告顺序"""
+        return self._post(f"/admin/announcements/{quote(str(id), safe='')}/move", payload, **kwargs)
+
+    def remove(self, id: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """公告移入回收站"""
+        return self._delete(f"/admin/announcements/{quote(str(id), safe='')}", query, **kwargs)
+
+    def restore(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """恢复公告"""
+        return self._post(f"/admin/announcements/{quote(str(id), safe='')}/restore", payload, **kwargs)
+
+    def update(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """修改公告"""
+        return self._patch(f"/admin/announcements/{quote(str(id), safe='')}", payload, **kwargs)
+
 class AuditAPI(_BaseApi):
     def get_admin_logs(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """查询管理员操作日志"""
@@ -737,6 +856,10 @@ class CatalogAPI(_BaseApi):
         super().__init__(http)
         self.sync = CatalogSyncAPI(http)
 
+    def batch_update_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """批量设置商品价格、稀有度或状态"""
+        return self._post(f"/catalog/products/batch-update", payload, **kwargs)
+
     def change_product_status(self, id: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """商品状态流转"""
         return self._post(f"/catalog/products/{quote(str(id), safe='')}/status", payload, **kwargs)
@@ -749,6 +872,10 @@ class CatalogAPI(_BaseApi):
         """新建商品类型"""
         return self._post(f"/catalog/types", payload, **kwargs)
 
+    def delete_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """移入商品回收站"""
+        return self._post(f"/catalog/products/batch-delete", payload, **kwargs)
+
     def export_by_type(self, typeId: str, **kwargs: Any) -> Any:
         """按类型导出 CodeFunCore 商品配置 JSON"""
         return self._get(f"/catalog/export/{quote(str(typeId), safe='')}", None, **kwargs)
@@ -765,6 +892,10 @@ class CatalogAPI(_BaseApi):
         """分页查询商品列表"""
         return self._get(f"/catalog/products", query, **kwargs)
 
+    def list_published_products(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询正式服已上架商品"""
+        return self._get(f"/catalog/published-products", query, **kwargs)
+
     def list_types(self, **kwargs: Any) -> Any:
         """获取商品类型列表"""
         return self._get(f"/catalog/types", None, **kwargs)
@@ -773,6 +904,10 @@ class CatalogAPI(_BaseApi):
         """整体替换套装部件列表"""
         return self._put(f"/catalog/products/{quote(str(id), safe='')}/parts", payload, **kwargs)
 
+    def restore_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """恢复回收站商品"""
+        return self._post(f"/catalog/products/batch-restore", payload, **kwargs)
+
     def update_product(self, id: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """更新商品"""
         return self._put(f"/catalog/products/{quote(str(id), safe='')}", payload, **kwargs)
@@ -1032,6 +1167,11 @@ class LotteryAPI(_BaseApi):
         return self._post(f"/lottery/validate", payload, **kwargs)
 
 class MinecraftDeveloperAPI(_BaseApi):
+    def __init__(self, http: _HttpClient) -> None:
+        super().__init__(http)
+        self.messages = MinecraftMessagesAPI(http)
+        self.mobile_mods = MinecraftMobileModsAPI(http)
+
     def apply_self_test(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """申请手游自测"""
         return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/self-test-applications", payload, **kwargs)
@@ -1086,6 +1226,7 @@ class MinecraftDeveloperAPI(_BaseApi):
 
     def replace_resource_pack(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """上传并替换资源包"""
+        payload = _MultipartBody(payload, ['package'])
         return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/resource-packs", payload, **kwargs)
 
     def revoke_review(self, edition: str, projectId: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
@@ -1096,6 +1237,81 @@ class MinecraftDeveloperAPI(_BaseApi):
         """提交网易审核"""
         return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/review-submissions", payload, **kwargs)
 
+class MinecraftMessagesAPI(_BaseApi):
+    def detail(self, messageId: str, **kwargs: Any) -> Any:
+        """读取审核消息正文"""
+        return self._get(f"/mcdev/messages/{quote(str(messageId), safe='')}", None, **kwargs)
+
+    def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询审核与打包消息"""
+        return self._get(f"/mcdev/messages", query, **kwargs)
+
+    def mark_read(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """标记指定审核消息已读"""
+        return self._post(f"/mcdev/message-read-receipts", payload, **kwargs)
+
+    def unread(self, **kwargs: Any) -> Any:
+        """查询审核消息未读数量"""
+        return self._get(f"/mcdev/messages/unread-count", None, **kwargs)
+
+class MinecraftMobileModsAPI(_BaseApi):
+    def apply_self_test(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """申请手机组件自测"""
+        return self._post(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/self-test-applications", payload, **kwargs)
+
+    def cancel_self_test(self, id: str, **kwargs: Any) -> Any:
+        """取消手机组件自测"""
+        return self._delete(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/self-test-applications/current", None, **kwargs)
+
+    def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """创建手机组件"""
+        return self._post(f"/mcdev/mobile-mods", payload, **kwargs)
+
+    def detail(self, id: str, **kwargs: Any) -> Any:
+        """读取手机组件编辑内容"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}", None, **kwargs)
+
+    def feedback(self, id: str, **kwargs: Any) -> Any:
+        """读取手机组件审核意见"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-feedback", None, **kwargs)
+
+    def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询手机组件"""
+        return self._get(f"/mcdev/mobile-mods", query, **kwargs)
+
+    def metadata(self, **kwargs: Any) -> Any:
+        """读取手机组件编辑规则"""
+        return self._get(f"/mcdev/mobile-mods/metadata", None, **kwargs)
+
+    def preview_asset(self, id: str, assetId: str, **kwargs: Any) -> Any:
+        """读取手机组件素材"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/assets/{quote(str(assetId), safe='')}/content", None, response_type="bytes", **kwargs)
+
+    def preview_upload(self, uploadId: str, **kwargs: Any) -> Any:
+        """预览已上传图片"""
+        return self._get(f"/mcdev/mobile-mods/uploads/{quote(str(uploadId), safe='')}/content", None, response_type="bytes", **kwargs)
+
+    def revoke_review(self, id: str, **kwargs: Any) -> Any:
+        """撤销手机组件审核"""
+        return self._delete(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-submissions/current", None, **kwargs)
+
+    def status(self, id: str, **kwargs: Any) -> Any:
+        """查询手机组件处理状态"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/status", None, **kwargs)
+
+    def submit_review(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """提交手机组件审核"""
+        return self._post(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-submissions", payload, **kwargs)
+
+    def update(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """保存手机组件修改"""
+        return self._patch(f"/mcdev/mobile-mods/{quote(str(id), safe='')}", payload, **kwargs)
+
+    def upload(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """上传手机组件素材"""
+        payload = _MultipartBody(payload, ['file'])
+        return self._post(f"/mcdev/mobile-mods/uploads", payload, **kwargs)
+
 class OSSAPI(_BaseApi):
     def get_ze_content(self, fileName: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """读取 ZE OSS 配置内容"""
@@ -1182,7 +1398,7 @@ class PlayerAPI(_BaseApi):
         return self._get(f"/players/{quote(str(ecid), safe='')}/farm/freshness-batches", query, **kwargs)
 
     def get_farm_overview(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
-        """查询 EC 农场 S1 完整总览"""
+        """查询 EC 农场总览（S1 与 S2 核心状态）"""
         return self._get(f"/players/{quote(str(ecid), safe='')}/farm/overview", query, **kwargs)
 
     def get_farm_summary(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
@@ -1673,6 +1889,7 @@ class ECAPIClient:
     ) -> None:
         self._http = _HttpClient(base_url, auth, timeout_seconds, default_headers, auth_provider)
         self.admin = AdminAPI(self._http)
+        self.announcements = AnnouncementsAPI(self._http)
         self.audit = AuditAPI(self._http)
         self.auth = AuthAPI(self._http)
         self.catalog = CatalogAPI(self._http)

{ecapi_sdk-3.7.2 → ecapi_sdk-3.7.3}/src/ecapi_sdk/client.pyi

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from pathlib import Path
 from typing import Any, Awaitable, Callable, Dict, Mapping, Optional, Sequence, TypedDict, Union
 
 Primitive = Union[str, int, float, bool, None]
@@ -334,6 +335,24 @@ class AdminOverwatchSupervisorAPIUpdateBody(TypedDict, total=False):
     level: int
     expiry: Optional[str]
 
+class AdminParkourAPIPreviewCommunityScoreClearQueryRequired(TypedDict):
+    scope: QueryValue
+
+class AdminParkourAPIPreviewCommunityScoreClearQuery(AdminParkourAPIPreviewCommunityScoreClearQueryRequired, total=False):
+    playerDataId: QueryValue
+    trackKey: QueryValue
+
+class AdminParkourAPIClearCommunityScoresBodyRequired(TypedDict):
+    scope: str
+    requestId: str
+    reason: str
+
+class AdminParkourAPIClearCommunityScoresBody(AdminParkourAPIClearCommunityScoresBodyRequired, total=False):
+    playerDataId: int
+    trackKey: str
+    scopeFingerprint: str
+    evidenceRefs: Sequence[Any]
+
 class AdminPermissionAPISetAnticheatPermissionBodyRequired(TypedDict):
     enabled: bool
 
@@ -455,18 +474,84 @@ class AdminPunishmentAPIListQuery(TypedDict, total=False):
     current: QueryValue
     pageSize: QueryValue
 
+class AdminPunishmentAPISetParkourPunishmentBodyRequired(TypedDict):
+    ecid: str
+    map: str
+    start: int
+    end: int
+    useTime: int
+
+class AdminPunishmentAPISetParkourPunishmentBody(AdminPunishmentAPISetParkourPunishmentBodyRequired, total=False):
+    source: str
+
 class AdminSourceAccountBindingAPIBindAccountPlayerBodyRequired(TypedDict):
     ecid: str
 
 class AdminSourceAccountBindingAPIBindAccountPlayerBody(AdminSourceAccountBindingAPIBindAccountPlayerBodyRequired, total=False):
     pass
 
+class AdminSpWorkbenchAPIProgressBodyRequired(TypedDict):
+    operationId: str
+    tid: int
+
+class AdminSpWorkbenchAPIProgressBody(AdminSpWorkbenchAPIProgressBodyRequired, total=False):
+    pass
+
 class AdminVoteRewardMailAPICreateBodyRequired(TypedDict):
     players: Sequence[Any]
 
 class AdminVoteRewardMailAPICreateBody(AdminVoteRewardMailAPICreateBodyRequired, total=False):
     enableDisplayNameLookup: bool
 
+class AnnouncementsAPIListGetQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    search: QueryValue
+    enabled: QueryValue
+    autoPopup: QueryValue
+    view: QueryValue
+
+class AnnouncementsAPICreateBodyRequired(TypedDict):
+    id: str
+    title: str
+
+class AnnouncementsAPICreateBody(AnnouncementsAPICreateBodyRequired, total=False):
+    content: Sequence[Any]
+    enabled: bool
+    autoPopup: bool
+    sortOrder: int
+
+class AnnouncementsAPIRemoveQueryRequired(TypedDict):
+    version: QueryValue
+
+class AnnouncementsAPIRemoveQuery(AnnouncementsAPIRemoveQueryRequired, total=False):
+    pass
+
+class AnnouncementsAPIUpdateBodyRequired(TypedDict):
+    version: int
+
+class AnnouncementsAPIUpdateBody(AnnouncementsAPIUpdateBodyRequired, total=False):
+    title: str
+    content: Sequence[Any]
+    enabled: bool
+    autoPopup: bool
+    sortOrder: int
+
+class AnnouncementsAPIMoveBodyRequired(TypedDict):
+    version: int
+    targetId: str
+    targetVersion: int
+    direction: str
+
+class AnnouncementsAPIMoveBody(AnnouncementsAPIMoveBodyRequired, total=False):
+    pass
+
+class AnnouncementsAPIRestoreBodyRequired(TypedDict):
+    version: int
+
+class AnnouncementsAPIRestoreBody(AnnouncementsAPIRestoreBodyRequired, total=False):
+    pass
+
 class AuditAPIQueryAccessLogsQuery(TypedDict, total=False):
     current: QueryValue
     pageSize: QueryValue
@@ -597,6 +682,7 @@ class AuthAPIRefreshTokenBody(AuthAPIRefreshTokenBodyRequired, total=False):
 class CatalogAPIListProductsQuery(TypedDict, total=False):
     current: QueryValue
     pageSize: QueryValue
+    view: QueryValue
     search: QueryValue
     author: QueryValue
     typeId: QueryValue
@@ -616,6 +702,25 @@ class CatalogAPICreateProductBody(CatalogAPICreateProductBodyRequired, total=Fal
     acquireConfig: str
     remark: str
 
+class CatalogAPIDeleteProductsBodyRequired(TypedDict):
+    productIds: Sequence[Any]
+
+class CatalogAPIDeleteProductsBody(CatalogAPIDeleteProductsBodyRequired, total=False):
+    pass
+
+class CatalogAPIRestoreProductsBodyRequired(TypedDict):
+    productIds: Sequence[Any]
+
+class CatalogAPIRestoreProductsBody(CatalogAPIRestoreProductsBodyRequired, total=False):
+    pass
+
+class CatalogAPIBatchUpdateProductsBodyRequired(TypedDict):
+    productIds: Sequence[Any]
+    change: Mapping[str, Any]
+
+class CatalogAPIBatchUpdateProductsBody(CatalogAPIBatchUpdateProductsBodyRequired, total=False):
+    pass
+
 class CatalogAPIUpdateProductBody(TypedDict, total=False):
     typeId: str
     idItem: str
@@ -639,6 +744,11 @@ class CatalogAPIChangeProductStatusBodyRequired(TypedDict):
 class CatalogAPIChangeProductStatusBody(CatalogAPIChangeProductStatusBodyRequired, total=False):
     pass
 
+class CatalogAPIListPublishedProductsQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    typeId: QueryValue
+
 class CatalogAPICreateTypeBodyRequired(TypedDict):
     typeId: str
     category: str
@@ -676,6 +786,7 @@ class GameLogAPIGetMatchesQueryRequired(TypedDict):
 
 class GameLogAPIGetMatchesQuery(GameLogAPIGetMatchesQueryRequired, total=False):
     ecid: QueryValue
+    gameMode: QueryValue
     startTime: QueryValue
     endTime: QueryValue
     current: QueryValue
@@ -970,7 +1081,7 @@ class MinecraftDeveloperAPIListPlayerFeedbacksQuery(MinecraftDeveloperAPIListPla
     pageSize: QueryValue
 
 class MinecraftDeveloperAPIReplaceResourcePackBodyRequired(TypedDict):
-    package: str
+    package: Union[Path, tuple[str, bytes]]
 
 class MinecraftDeveloperAPIReplaceResourcePackBody(MinecraftDeveloperAPIReplaceResourcePackBodyRequired, total=False):
     confirmQueue: bool
@@ -999,6 +1110,100 @@ class MinecraftDeveloperAPICancelSelfTestQueryRequired(TypedDict):
 class MinecraftDeveloperAPICancelSelfTestQuery(MinecraftDeveloperAPICancelSelfTestQueryRequired, total=False):
     pass
 
+class MinecraftMessagesAPIMarkReadBodyRequired(TypedDict):
+    messageIds: Sequence[Any]
+
+class MinecraftMessagesAPIMarkReadBody(MinecraftMessagesAPIMarkReadBodyRequired, total=False):
+    pass
+
+class MinecraftMessagesAPIListQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    title: QueryValue
+    read: QueryValue
+
+class MinecraftMobileModsAPIListQuery(TypedDict, total=False):
+    current: QueryValue
+    pageSize: QueryValue
+    search: QueryValue
+    kind: QueryValue
+    status: QueryValue
+    playPlan: QueryValue
+    sortBy: QueryValue
+    sortOrder: QueryValue
+
+class MinecraftMobileModsAPICreateBodyRequired(TypedDict):
+    name: str
+    kind: str
+    subTypeId: int
+    labelIds: Sequence[Any]
+    modVersion: str
+    original: bool
+    contentHtml: str
+    pricing: Mapping[str, Any]
+    resources: Sequence[Any]
+    images: Sequence[Any]
+
+class MinecraftMobileModsAPICreateBody(MinecraftMobileModsAPICreateBodyRequired, total=False):
+    secondTypeId: int
+    tags: Sequence[Any]
+    copyrightProof: Optional[Mapping[str, Any]]
+    updateSummary: str
+    activityDescription: str
+    video: Optional[Mapping[str, Any]]
+    banner: Optional[Mapping[str, Any]]
+    bodyType: str
+    mountCall: bool
+    lobby: Mapping[str, Any]
+    increaseVersion: bool
+    confirmQueue: bool
+
+class MinecraftMobileModsAPIUploadBodyRequired(TypedDict):
+    file: Union[Path, tuple[str, bytes]]
+    purpose: str
+    kind: str
+    subTypeId: int
+
+class MinecraftMobileModsAPIUploadBody(MinecraftMobileModsAPIUploadBodyRequired, total=False):
+    channelId: int
+
+class MinecraftMobileModsAPIUpdateBodyRequired(TypedDict):
+    baseRevision: str
+
+class MinecraftMobileModsAPIUpdateBody(MinecraftMobileModsAPIUpdateBodyRequired, total=False):
+    name: str
+    kind: str
+    subTypeId: int
+    secondTypeId: int
+    labelIds: Sequence[Any]
+    tags: Sequence[Any]
+    modVersion: str
+    original: bool
+    copyrightProof: Optional[Mapping[str, Any]]
+    contentHtml: str
+    updateSummary: str
+    activityDescription: str
+    pricing: Mapping[str, Any]
+    resources: Sequence[Any]
+    images: Sequence[Any]
+    video: Optional[Mapping[str, Any]]
+    banner: Optional[Mapping[str, Any]]
+    bodyType: str
+    mountCall: bool
+    lobby: Mapping[str, Any]
+    increaseVersion: bool
+    confirmQueue: bool
+
+class MinecraftMobileModsAPISubmitReviewBody(TypedDict, total=False):
+    note: str
+    conflictNotify: str
+    conflictTypes: Sequence[Any]
+    confirmQueue: bool
+
+class MinecraftMobileModsAPIApplySelfTestBody(TypedDict, total=False):
+    mode: str
+    confirmQueue: bool
+
 class OSSAPIGetZeContentQuery(TypedDict, total=False):
     versionId: QueryValue
 
@@ -1568,6 +1773,7 @@ class AdminAPI:
     operation_log: AdminOperationLogAPI
     overwatch_case: AdminOverwatchCaseAPI
     overwatch_supervisor: AdminOverwatchSupervisorAPI
+    parkour: AdminParkourAPI
     permission: AdminPermissionAPI
     player_data: AdminPlayerDataAPI
     player_merchandise: AdminPlayerMerchandiseAPI
@@ -1575,6 +1781,7 @@ class AdminAPI:
     player_wallet: AdminPlayerWalletAPI
     punishment: AdminPunishmentAPI
     source_account_binding: AdminSourceAccountBindingAPI
+    sp_workbench: AdminSpWorkbenchAPI
     vote_reward_mail: AdminVoteRewardMailAPI
 
 class AdminAccountAPI:
@@ -1604,6 +1811,10 @@ class AdminOverwatchSupervisorAPI:
     def select(self, payload: AdminOverwatchSupervisorAPISelectBody, **kwargs: Any) -> Any: ...
     def update(self, ecid: str, payload: AdminOverwatchSupervisorAPIUpdateBody, **kwargs: Any) -> Any: ...
 
+class AdminParkourAPI:
+    def clear_community_scores(self, ecid: str, payload: AdminParkourAPIClearCommunityScoresBody, **kwargs: Any) -> Any: ...
+    def preview_community_score_clear(self, ecid: str, query: AdminParkourAPIPreviewCommunityScoreClearQuery, **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: ...
@@ -1638,6 +1849,7 @@ class AdminPunishmentAPI:
     def list(self, query: Optional[AdminPunishmentAPIListQuery] = ..., **kwargs: Any) -> Any: ...
     def list_prism_device_ban_logs(self, query: Optional[AdminPunishmentAPIListPrismDeviceBanLogsQuery] = ..., **kwargs: Any) -> Any: ...
     def remove(self, ecid: str, type: str, query: Optional[AdminPunishmentAPIRemoveQuery] = ..., **kwargs: Any) -> Any: ...
+    def set_parkour_punishment(self, payload: AdminPunishmentAPISetParkourPunishmentBody, **kwargs: Any) -> Any: ...
 
 class AdminSourceAccountBindingAPI:
     def bind_account_player(self, xuid: str, payload: AdminSourceAccountBindingAPIBindAccountPlayerBody, **kwargs: Any) -> Any: ...
@@ -1645,9 +1857,23 @@ class AdminSourceAccountBindingAPI:
     def reset_player_account(self, ecid: str, xuid: str, **kwargs: Any) -> Any: ...
     def reset_player_accounts(self, ecid: str, **kwargs: Any) -> Any: ...
 
+class AdminSpWorkbenchAPI:
+    def capabilities(self, **kwargs: Any) -> Any: ...
+    def progress(self, payload: AdminSpWorkbenchAPIProgressBody, **kwargs: Any) -> Any: ...
+
 class AdminVoteRewardMailAPI:
     def create(self, payload: AdminVoteRewardMailAPICreateBody, **kwargs: Any) -> Any: ...
 
+class AnnouncementsAPI:
+    def create(self, payload: AnnouncementsAPICreateBody, **kwargs: Any) -> Any: ...
+    def get(self, id: str, **kwargs: Any) -> Any: ...
+    def list(self, **kwargs: Any) -> Any: ...
+    def list_get(self, query: Optional[AnnouncementsAPIListGetQuery] = ..., **kwargs: Any) -> Any: ...
+    def move(self, id: str, payload: AnnouncementsAPIMoveBody, **kwargs: Any) -> Any: ...
+    def remove(self, id: str, query: AnnouncementsAPIRemoveQuery, **kwargs: Any) -> Any: ...
+    def restore(self, id: str, payload: AnnouncementsAPIRestoreBody, **kwargs: Any) -> Any: ...
+    def update(self, id: str, payload: AnnouncementsAPIUpdateBody, **kwargs: Any) -> Any: ...
+
 class AuditAPI:
     def get_admin_logs(self, query: Optional[AuditAPIGetAdminLogsQuery] = ..., **kwargs: Any) -> Any: ...
     def get_auth_logs(self, query: Optional[AuditAPIGetAuthLogsQuery] = ..., **kwargs: Any) -> Any: ...
@@ -1666,15 +1892,19 @@ class AuthAPI:
 
 class CatalogAPI:
     sync: CatalogSyncAPI
+    def batch_update_products(self, payload: CatalogAPIBatchUpdateProductsBody, **kwargs: Any) -> Any: ...
     def change_product_status(self, id: Union[int, float], payload: CatalogAPIChangeProductStatusBody, **kwargs: Any) -> Any: ...
     def create_product(self, payload: CatalogAPICreateProductBody, **kwargs: Any) -> Any: ...
     def create_type(self, payload: CatalogAPICreateTypeBody, **kwargs: Any) -> Any: ...
+    def delete_products(self, payload: CatalogAPIDeleteProductsBody, **kwargs: Any) -> Any: ...
     def export_by_type(self, typeId: str, **kwargs: Any) -> Any: ...
     def get_product_detail(self, id: Union[int, float], **kwargs: Any) -> Any: ...
     def get_suit_parts(self, id: Union[int, float], **kwargs: Any) -> Any: ...
     def list_products(self, query: Optional[CatalogAPIListProductsQuery] = ..., **kwargs: Any) -> Any: ...
+    def list_published_products(self, query: Optional[CatalogAPIListPublishedProductsQuery] = ..., **kwargs: Any) -> Any: ...
     def list_types(self, **kwargs: Any) -> Any: ...
     def replace_suit_parts(self, id: Union[int, float], payload: CatalogAPIReplaceSuitPartsBody, **kwargs: Any) -> Any: ...
+    def restore_products(self, payload: CatalogAPIRestoreProductsBody, **kwargs: Any) -> Any: ...
     def update_product(self, id: Union[int, float], payload: CatalogAPIUpdateProductBody, **kwargs: Any) -> Any: ...
     def update_type(self, typeId: str, payload: CatalogAPIUpdateTypeBody, **kwargs: Any) -> Any: ...
 
@@ -1757,6 +1987,8 @@ class LotteryAPI:
     def validate(self, payload: LotteryAPIValidateBody, **kwargs: Any) -> Any: ...
 
 class MinecraftDeveloperAPI:
+    messages: MinecraftMessagesAPI
+    mobile_mods: MinecraftMobileModsAPI
     def apply_self_test(self, edition: str, projectId: str, payload: MinecraftDeveloperAPIApplySelfTestBody, **kwargs: Any) -> Any: ...
     def cancel_self_test(self, edition: str, projectId: str, query: MinecraftDeveloperAPICancelSelfTestQuery, **kwargs: Any) -> Any: ...
     def connect_session(self, payload: MinecraftDeveloperAPIConnectSessionBody, **kwargs: Any) -> Any: ...
@@ -1774,6 +2006,28 @@ class MinecraftDeveloperAPI:
     def revoke_review(self, edition: str, projectId: str, query: MinecraftDeveloperAPIRevokeReviewQuery, **kwargs: Any) -> Any: ...
     def submit_review(self, edition: str, projectId: str, payload: MinecraftDeveloperAPISubmitReviewBody, **kwargs: Any) -> Any: ...
 
+class MinecraftMessagesAPI:
+    def detail(self, messageId: str, **kwargs: Any) -> Any: ...
+    def list(self, query: Optional[MinecraftMessagesAPIListQuery] = ..., **kwargs: Any) -> Any: ...
+    def mark_read(self, payload: MinecraftMessagesAPIMarkReadBody, **kwargs: Any) -> Any: ...
+    def unread(self, **kwargs: Any) -> Any: ...
+
+class MinecraftMobileModsAPI:
+    def apply_self_test(self, id: str, payload: MinecraftMobileModsAPIApplySelfTestBody, **kwargs: Any) -> Any: ...
+    def cancel_self_test(self, id: str, **kwargs: Any) -> Any: ...
+    def create(self, payload: MinecraftMobileModsAPICreateBody, **kwargs: Any) -> Any: ...
+    def detail(self, id: str, **kwargs: Any) -> Any: ...
+    def feedback(self, id: str, **kwargs: Any) -> Any: ...
+    def list(self, query: Optional[MinecraftMobileModsAPIListQuery] = ..., **kwargs: Any) -> Any: ...
+    def metadata(self, **kwargs: Any) -> Any: ...
+    def preview_asset(self, id: str, assetId: str, **kwargs: Any) -> Any: ...
+    def preview_upload(self, uploadId: str, **kwargs: Any) -> Any: ...
+    def revoke_review(self, id: str, **kwargs: Any) -> Any: ...
+    def status(self, id: str, **kwargs: Any) -> Any: ...
+    def submit_review(self, id: str, payload: MinecraftMobileModsAPISubmitReviewBody, **kwargs: Any) -> Any: ...
+    def update(self, id: str, payload: MinecraftMobileModsAPIUpdateBody, **kwargs: Any) -> Any: ...
+    def upload(self, payload: MinecraftMobileModsAPIUploadBody, **kwargs: Any) -> Any: ...
+
 class OSSAPI:
     def get_ze_content(self, fileName: str, query: Optional[OSSAPIGetZeContentQuery] = ..., **kwargs: Any) -> Any: ...
     def get_zvs_reload_content(self, fileName: str, query: Optional[OSSAPIGetZvsReloadContentQuery] = ..., **kwargs: Any) -> Any: ...
@@ -1987,6 +2241,7 @@ class ClientOptions:
 
 class ECAPIClient:
     admin: AdminAPI
+    announcements: AnnouncementsAPI
     audit: AuditAPI
     auth: AuthAPI
     catalog: CatalogAPI

{ecapi_sdk-3.7.2 → ecapi_sdk-3.7.3}/src/ecapi_sdk.egg-info/PKG-INFO

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