tamar-file-hub-client 0.1.9__tar.gz → 0.2.1__tar.gz

{tamar_file_hub_client-0.1.9/tamar_file_hub_client.egg-info → tamar_file_hub_client-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.9
+Version: 0.2.1
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -25,7 +25,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: grpcio>=1.67.1
 Requires-Dist: grpcio-tools>=1.67.1
-Requires-Dist: protobuf>=4.21.0
+Requires-Dist: protobuf>=5.29.4
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: typing-extensions>=4.0.0; python_version < "3.10"
 Requires-Dist: requests>=2.28.0
@@ -63,6 +63,7 @@ Dynamic: summary
 - 📝 **类型注解**：完整的类型提示支持
 - 🧩 **模块化设计**：清晰的代码结构，易于扩展
 - 🎨 **图片和视频压缩**：支持多种规格的媒体文件压缩变体生成和管理
+- 📊 **批量状态查询**：支持批量查询文件的上传、压缩、备份同步状态
 - 🏗️ **分层服务架构**：文件服务分为传统文件（blob）和自定义类型（结构化数据），每种类型独立服务，语义清晰
 - 🔧 **环境变量配置**：支持通过环境变量配置所有参数
 - 👤 **用户上下文管理**：支持区分资源所有权（ownership）和操作者（operator）
@@ -214,6 +215,7 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
         - 支持临时文件上传
         - **媒体文件压缩**：支持图片和视频的多规格压缩变体生成
         - **压缩管理**：获取压缩状态、管理变体、触发重新压缩
+        - **批量文件状态查询**：一次性查询多个文件的上传、压缩、同步状态
         - 适用类型：PDF、图片、视频、音频、压缩包等
     - **file_service**: 处理文件元数据操作（所有类型通用）
         - 获取、重命名、删除文件
@@ -253,6 +255,12 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
     - `GetVariantsResponse`: 获取变体响应
     - `RecompressionResponse`: 重新压缩响应
     - `VariantDownloadUrlResponse`: 变体下载URL响应
+    - `BatchFileStatusResponse`: 批量文件状态响应
+    - `FileStatusInfo`: 单个文件状态信息
+    - `FileStatusDetails`: 文件状态详细信息
+    - `FileUploadStatus`: 文件上传状态枚举
+    - `FileCompressionStatus`: 文件压缩状态枚举
+    - `FileSyncStatus`: 文件同步状态枚举
 
 - **folder.py**: 文件夹相关的数据模型
     - `FolderInfo`: 文件夹信息
@@ -1031,6 +1039,184 @@ with TamarFileHubClient() as client:
    - 支持重新压缩以应用新的压缩设置
    - 批量状态查询减少网络请求
 
+### 批量文件状态查询
+
+File Hub Client 提供了高效的批量文件状态查询功能，可以一次性获取多个文件的上传、压缩、同步状态：
+
+#### 基础批量查询
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量查询多个文件的状态
+    file_ids = ["file-id-1", "file-id-2", "file-id-3"]
+    response = await client.blobs.batch_get_file_status(
+        file_ids=file_ids,
+        include_details=False  # 是否包含详细信息，默认False
+    )
+    
+    print(f"查询时间戳: {response.timestamp}")
+    print(f"缓存命中数量: {response.cache_hit_count}")
+    print(f"查询到 {len(response.statuses)} 个文件状态")
+    
+    for status in response.statuses:
+        print(f"文件ID: {status.file_id}")
+        print(f"  上传状态: {status.upload_status.value}")
+        print(f"  压缩状态: {status.compression_status.value}")
+        print(f"  同步状态: {status.sync_status.value}")
+        
+        if status.error_message:
+            print(f"  错误信息: {status.error_message}")
+```
+
+#### 详细信息查询
+
+```python
+# 查询详细状态信息
+detailed_response = await client.blobs.batch_get_file_status(
+    file_ids=file_ids,
+    include_details=True  # 包含详细信息
+)
+
+for status in detailed_response.statuses:
+    print(f"文件ID: {status.file_id}")
+    print(f"  上传状态: {status.upload_status.value}")
+    print(f"  压缩状态: {status.compression_status.value}")
+    print(f"  同步状态: {status.sync_status.value}")
+    
+    if status.details:
+        print("  详细信息:")
+        if status.details.file_size:
+            print(f"    文件大小: {status.details.file_size} 字节")
+        if status.details.storage_type:
+            print(f"    存储类型: {status.details.storage_type}")
+        if status.details.storage_region:
+            print(f"    存储区域: {status.details.storage_region}")
+            
+        # 压缩相关详细信息
+        if status.details.compression_task_id:
+            print(f"    压缩任务ID: {status.details.compression_task_id}")
+        if status.details.compression_variants_count is not None:
+            print(f"    压缩变体数量: {status.details.compression_variants_count}")
+        if status.details.compression_progress is not None:
+            print(f"    压缩进度: {status.details.compression_progress * 100:.1f}%")
+        
+        # 同步相关详细信息
+        if status.details.sync_regions_total is not None:
+            print(f"    同步区域总数: {status.details.sync_regions_total}")
+        if status.details.sync_regions_completed is not None:
+            print(f"    已完成同步区域: {status.details.sync_regions_completed}")
+        if status.details.sync_pending_regions:
+            print(f"    待同步区域: {', '.join(status.details.sync_pending_regions)}")
+```
+
+#### 状态筛选和分析
+
+```python
+from file_hub_client.schemas import (
+    FileUploadStatus, 
+    FileCompressionStatus, 
+    FileSyncStatus
+)
+
+# 查询文件状态
+response = await client.blobs.batch_get_file_status(file_ids=file_ids)
+
+# 筛选出上传失败的文件
+failed_uploads = [
+    status for status in response.statuses 
+    if status.upload_status == FileUploadStatus.UPLOAD_FAILED
+]
+
+# 筛选出正在处理的文件
+processing_files = [
+    status for status in response.statuses 
+    if (status.upload_status == FileUploadStatus.UPLOAD_PROCESSING or
+        status.compression_status == FileCompressionStatus.COMPRESSION_PROCESSING or
+        status.sync_status == FileSyncStatus.SYNC_PROCESSING)
+]
+
+# 筛选出压缩不适用的文件（非图片/视频）
+non_compressible_files = [
+    status for status in response.statuses 
+    if status.compression_status == FileCompressionStatus.COMPRESSION_NOT_APPLICABLE
+]
+
+print(f"上传失败的文件: {len(failed_uploads)} 个")
+print(f"正在处理的文件: {len(processing_files)} 个")
+print(f"非媒体文件: {len(non_compressible_files)} 个")
+```
+
+#### 同步客户端示例
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 同步批量查询
+    response = client.blobs.batch_get_file_status(
+        file_ids=["file-1", "file-2", "file-3"],
+        include_details=True
+    )
+    
+    for status in response.statuses:
+        print(f"文件 {status.file_id[:8]}...")
+        print(f"  状态: {status.upload_status.value}")
+        
+        if status.details:
+            print(f"  大小: {status.details.file_size} bytes")
+```
+
+#### 状态枚举说明
+
+**上传状态 (FileUploadStatus):**
+- `UPLOAD_UNKNOWN`: 未知状态
+- `UPLOAD_PENDING`: 待上传
+- `UPLOAD_PROCESSING`: 上传中
+- `UPLOAD_COMPLETED`: 已完成
+- `UPLOAD_FAILED`: 失败
+
+**压缩状态 (FileCompressionStatus):**
+- `COMPRESSION_UNKNOWN`: 未知状态
+- `COMPRESSION_NOT_APPLICABLE`: 不需要压缩（非图片/视频文件）
+- `COMPRESSION_PENDING`: 等待压缩
+- `COMPRESSION_PROCESSING`: 压缩中
+- `COMPRESSION_COMPLETED`: 已完成
+- `COMPRESSION_FAILED`: 失败
+- `COMPRESSION_SKIPPED`: 跳过压缩
+
+**同步状态 (FileSyncStatus):**
+- `SYNC_UNKNOWN`: 未知状态
+- `SYNC_NOT_REQUIRED`: 不需要同步
+- `SYNC_PENDING`: 等待同步
+- `SYNC_PROCESSING`: 同步中
+- `SYNC_PARTIAL`: 部分完成
+- `SYNC_COMPLETED`: 全部完成
+- `SYNC_FAILED`: 同步失败
+
+#### 使用场景
+
+1. **文件处理监控**：
+   - 实时监控文件上传、压缩、同步进度
+   - 及时发现和处理失败的文件
+
+2. **批量状态查询**：
+   - 一次查询最多100个文件状态
+   - 减少网络请求，提高性能
+
+3. **业务流程控制**：
+   - 根据文件状态决定后续业务逻辑
+   - 确保文件完全准备就绪后再进行下一步操作
+
+4. **性能优化**：
+   - 利用缓存机制提高查询效率
+   - 支持详细信息的按需获取
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2378,6 +2564,7 @@ MIT License
 - **断点续传修复**: 解决断点续传中的HTTP头部和签名验证问题
 - **AI生成文件支持**: 完善对AI生成内容（图片、视频、音频）的MIME类型处理
 - **新功能**: 新增 `mime_type` 参数支持，允许用户显式指定文件MIME类型
+- **批量文件状态查询**: 新增 `batch_get_file_status` API，支持批量查询文件上传、压缩、同步状态
 - **魔术字节检测**: 增强内容检测，支持26+种主流文件格式的自动识别
 - **向下兼容**: 保持100%向下兼容，现有代码无需修改
 - **核心修复**:

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/README.md

@@ -17,6 +17,7 @@
 - 📝 **类型注解**：完整的类型提示支持
 - 🧩 **模块化设计**：清晰的代码结构，易于扩展
 - 🎨 **图片和视频压缩**：支持多种规格的媒体文件压缩变体生成和管理
+- 📊 **批量状态查询**：支持批量查询文件的上传、压缩、备份同步状态
 - 🏗️ **分层服务架构**：文件服务分为传统文件（blob）和自定义类型（结构化数据），每种类型独立服务，语义清晰
 - 🔧 **环境变量配置**：支持通过环境变量配置所有参数
 - 👤 **用户上下文管理**：支持区分资源所有权（ownership）和操作者（operator）
@@ -168,6 +169,7 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
         - 支持临时文件上传
         - **媒体文件压缩**：支持图片和视频的多规格压缩变体生成
         - **压缩管理**：获取压缩状态、管理变体、触发重新压缩
+        - **批量文件状态查询**：一次性查询多个文件的上传、压缩、同步状态
         - 适用类型：PDF、图片、视频、音频、压缩包等
     - **file_service**: 处理文件元数据操作（所有类型通用）
         - 获取、重命名、删除文件
@@ -207,6 +209,12 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
     - `GetVariantsResponse`: 获取变体响应
     - `RecompressionResponse`: 重新压缩响应
     - `VariantDownloadUrlResponse`: 变体下载URL响应
+    - `BatchFileStatusResponse`: 批量文件状态响应
+    - `FileStatusInfo`: 单个文件状态信息
+    - `FileStatusDetails`: 文件状态详细信息
+    - `FileUploadStatus`: 文件上传状态枚举
+    - `FileCompressionStatus`: 文件压缩状态枚举
+    - `FileSyncStatus`: 文件同步状态枚举
 
 - **folder.py**: 文件夹相关的数据模型
     - `FolderInfo`: 文件夹信息
@@ -985,6 +993,184 @@ with TamarFileHubClient() as client:
    - 支持重新压缩以应用新的压缩设置
    - 批量状态查询减少网络请求
 
+### 批量文件状态查询
+
+File Hub Client 提供了高效的批量文件状态查询功能，可以一次性获取多个文件的上传、压缩、同步状态：
+
+#### 基础批量查询
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量查询多个文件的状态
+    file_ids = ["file-id-1", "file-id-2", "file-id-3"]
+    response = await client.blobs.batch_get_file_status(
+        file_ids=file_ids,
+        include_details=False  # 是否包含详细信息，默认False
+    )
+    
+    print(f"查询时间戳: {response.timestamp}")
+    print(f"缓存命中数量: {response.cache_hit_count}")
+    print(f"查询到 {len(response.statuses)} 个文件状态")
+    
+    for status in response.statuses:
+        print(f"文件ID: {status.file_id}")
+        print(f"  上传状态: {status.upload_status.value}")
+        print(f"  压缩状态: {status.compression_status.value}")
+        print(f"  同步状态: {status.sync_status.value}")
+        
+        if status.error_message:
+            print(f"  错误信息: {status.error_message}")
+```
+
+#### 详细信息查询
+
+```python
+# 查询详细状态信息
+detailed_response = await client.blobs.batch_get_file_status(
+    file_ids=file_ids,
+    include_details=True  # 包含详细信息
+)
+
+for status in detailed_response.statuses:
+    print(f"文件ID: {status.file_id}")
+    print(f"  上传状态: {status.upload_status.value}")
+    print(f"  压缩状态: {status.compression_status.value}")
+    print(f"  同步状态: {status.sync_status.value}")
+    
+    if status.details:
+        print("  详细信息:")
+        if status.details.file_size:
+            print(f"    文件大小: {status.details.file_size} 字节")
+        if status.details.storage_type:
+            print(f"    存储类型: {status.details.storage_type}")
+        if status.details.storage_region:
+            print(f"    存储区域: {status.details.storage_region}")
+            
+        # 压缩相关详细信息
+        if status.details.compression_task_id:
+            print(f"    压缩任务ID: {status.details.compression_task_id}")
+        if status.details.compression_variants_count is not None:
+            print(f"    压缩变体数量: {status.details.compression_variants_count}")
+        if status.details.compression_progress is not None:
+            print(f"    压缩进度: {status.details.compression_progress * 100:.1f}%")
+        
+        # 同步相关详细信息
+        if status.details.sync_regions_total is not None:
+            print(f"    同步区域总数: {status.details.sync_regions_total}")
+        if status.details.sync_regions_completed is not None:
+            print(f"    已完成同步区域: {status.details.sync_regions_completed}")
+        if status.details.sync_pending_regions:
+            print(f"    待同步区域: {', '.join(status.details.sync_pending_regions)}")
+```
+
+#### 状态筛选和分析
+
+```python
+from file_hub_client.schemas import (
+    FileUploadStatus, 
+    FileCompressionStatus, 
+    FileSyncStatus
+)
+
+# 查询文件状态
+response = await client.blobs.batch_get_file_status(file_ids=file_ids)
+
+# 筛选出上传失败的文件
+failed_uploads = [
+    status for status in response.statuses 
+    if status.upload_status == FileUploadStatus.UPLOAD_FAILED
+]
+
+# 筛选出正在处理的文件
+processing_files = [
+    status for status in response.statuses 
+    if (status.upload_status == FileUploadStatus.UPLOAD_PROCESSING or
+        status.compression_status == FileCompressionStatus.COMPRESSION_PROCESSING or
+        status.sync_status == FileSyncStatus.SYNC_PROCESSING)
+]
+
+# 筛选出压缩不适用的文件（非图片/视频）
+non_compressible_files = [
+    status for status in response.statuses 
+    if status.compression_status == FileCompressionStatus.COMPRESSION_NOT_APPLICABLE
+]
+
+print(f"上传失败的文件: {len(failed_uploads)} 个")
+print(f"正在处理的文件: {len(processing_files)} 个")
+print(f"非媒体文件: {len(non_compressible_files)} 个")
+```
+
+#### 同步客户端示例
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 同步批量查询
+    response = client.blobs.batch_get_file_status(
+        file_ids=["file-1", "file-2", "file-3"],
+        include_details=True
+    )
+    
+    for status in response.statuses:
+        print(f"文件 {status.file_id[:8]}...")
+        print(f"  状态: {status.upload_status.value}")
+        
+        if status.details:
+            print(f"  大小: {status.details.file_size} bytes")
+```
+
+#### 状态枚举说明
+
+**上传状态 (FileUploadStatus):**
+- `UPLOAD_UNKNOWN`: 未知状态
+- `UPLOAD_PENDING`: 待上传
+- `UPLOAD_PROCESSING`: 上传中
+- `UPLOAD_COMPLETED`: 已完成
+- `UPLOAD_FAILED`: 失败
+
+**压缩状态 (FileCompressionStatus):**
+- `COMPRESSION_UNKNOWN`: 未知状态
+- `COMPRESSION_NOT_APPLICABLE`: 不需要压缩（非图片/视频文件）
+- `COMPRESSION_PENDING`: 等待压缩
+- `COMPRESSION_PROCESSING`: 压缩中
+- `COMPRESSION_COMPLETED`: 已完成
+- `COMPRESSION_FAILED`: 失败
+- `COMPRESSION_SKIPPED`: 跳过压缩
+
+**同步状态 (FileSyncStatus):**
+- `SYNC_UNKNOWN`: 未知状态
+- `SYNC_NOT_REQUIRED`: 不需要同步
+- `SYNC_PENDING`: 等待同步
+- `SYNC_PROCESSING`: 同步中
+- `SYNC_PARTIAL`: 部分完成
+- `SYNC_COMPLETED`: 全部完成
+- `SYNC_FAILED`: 同步失败
+
+#### 使用场景
+
+1. **文件处理监控**：
+   - 实时监控文件上传、压缩、同步进度
+   - 及时发现和处理失败的文件
+
+2. **批量状态查询**：
+   - 一次查询最多100个文件状态
+   - 减少网络请求，提高性能
+
+3. **业务流程控制**：
+   - 根据文件状态决定后续业务逻辑
+   - 确保文件完全准备就绪后再进行下一步操作
+
+4. **性能优化**：
+   - 利用缓存机制提高查询效率
+   - 支持详细信息的按需获取
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2332,6 +2518,7 @@ MIT License
 - **断点续传修复**: 解决断点续传中的HTTP头部和签名验证问题
 - **AI生成文件支持**: 完善对AI生成内容（图片、视频、音频）的MIME类型处理
 - **新功能**: 新增 `mime_type` 参数支持，允许用户显式指定文件MIME类型
+- **批量文件状态查询**: 新增 `batch_get_file_status` API，支持批量查询文件上传、压缩、同步状态
 - **魔术字节检测**: 增强内容检测，支持26+种主流文件格式的自动识别
 - **向下兼容**: 保持100%向下兼容，现有代码无需修改
 - **核心修复**:

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/file_hub_client/rpc/gen/file_service_pb2.py

@@ -26,19 +26,19 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x9f\x02\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x12#\n\x16keep_original_filename\x18\x08 \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\"\xb3\x02\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x12#\n\x16keep_original_filename\x18\t \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"`\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"7\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"_\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"+\n\x18\x43ompressionStatusRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x84\x01\n\x19\x43ompressionStatusResponse\x12\x0e\n\x06status\x18\x01 \x01(\t\x12\x1a\n\rerror_message\x18\x02 \x01(\tH\x00\x88\x01\x01\x12)\n\x08variants\x18\x03 \x03(\x0b\x32\x17.file.CompressedVariantB\x10\n\x0e_error_message\"Q\n\x12GetVariantsRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x19\n\x0cvariant_type\x18\x02 \x01(\tH\x00\x88\x01\x01\x42\x0f\n\r_variant_type\"@\n\x13GetVariantsResponse\x12)\n\x08variants\x18\x01 \x03(\x0b\x32\x17.file.CompressedVariant\"\xc7\x02\n\x11\x43ompressedVariant\x12\x14\n\x0cvariant_name\x18\x01 \x01(\t\x12\x14\n\x0cvariant_type\x18\x02 \x01(\t\x12\x12\n\nmedia_type\x18\x03 \x01(\t\x12\r\n\x05width\x18\x04 \x01(\x05\x12\x0e\n\x06height\x18\x05 \x01(\x05\x12\x11\n\tfile_size\x18\x06 \x01(\x03\x12\x0e\n\x06\x66ormat\x18\x07 \x01(\t\x12\x14\n\x07quality\x18\x08 \x01(\x05H\x00\x88\x01\x01\x12\x15\n\x08\x64uration\x18\t \x01(\x01H\x01\x88\x01\x01\x12\x14\n\x07\x62itrate\x18\n \x01(\x03H\x02\x88\x01\x01\x12\x10\n\x03\x66ps\x18\x0b \x01(\x05H\x03\x88\x01\x01\x12\x19\n\x11\x63ompression_ratio\x18\x0c \x01(\x01\x12\x13\n\x0bstored_path\x18\r \x01(\tB\n\n\x08_qualityB\x0b\n\t_durationB\n\n\x08_bitrateB\x06\n\x04_fps\"Y\n\x14RecompressionRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x1c\n\x0f\x66orce_reprocess\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x12\n\x10_force_reprocess\"8\n\x15RecompressionResponse\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06status\x18\x02 \x01(\t\"\x92\x01\n\x19VariantDownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x14\n\x0cvariant_name\x18\x02 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x13\n\x06is_cdn\x18\x04 \x01(\x08H\x01\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\t\n\x07_is_cdn\"\x8c\x01\n\x1aVariantDownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x12\n\x05\x65rror\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x32\n\x0cvariant_info\x18\x03 \x01(\x0b\x32\x17.file.CompressedVariantH\x01\x88\x01\x01\x42\x08\n\x06_errorB\x0f\n\r_variant_info\"\\\n\x16\x42\x61tchFileStatusRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x1c\n\x0finclude_details\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x12\n\x10_include_details\"m\n\x17\x42\x61tchFileStatusResponse\x12&\n\x08statuses\x18\x01 \x03(\x0b\x32\x14.file.FileStatusInfo\x12\x11\n\ttimestamp\x18\x02 \x01(\x03\x12\x17\n\x0f\x63\x61\x63he_hit_count\x18\x03 \x01(\x05\"\x9d\x02\n\x0e\x46ileStatusInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12-\n\rupload_status\x18\x02 \x01(\x0e\x32\x16.file.FileUploadStatus\x12\x37\n\x12\x63ompression_status\x18\x03 \x01(\x0e\x32\x1b.file.FileCompressionStatus\x12)\n\x0bsync_status\x18\x04 \x01(\x0e\x32\x14.file.FileSyncStatus\x12-\n\x07\x64\x65tails\x18\x05 \x01(\x0b\x32\x17.file.FileStatusDetailsH\x00\x88\x01\x01\x12\x1a\n\rerror_message\x18\x06 \x01(\tH\x01\x88\x01\x01\x42\n\n\x08_detailsB\x10\n\x0e_error_message\"\xe9\x03\n\x11\x46ileStatusDetails\x12\x16\n\tfile_size\x18\x01 \x01(\x03H\x00\x88\x01\x01\x12\x19\n\x0cstorage_type\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x1b\n\x0estorage_region\x18\x03 \x01(\tH\x02\x88\x01\x01\x12 \n\x13\x63ompression_task_id\x18\x04 \x01(\tH\x03\x88\x01\x01\x12\'\n\x1a\x63ompression_variants_count\x18\x05 \x01(\x05H\x04\x88\x01\x01\x12!\n\x14\x63ompression_progress\x18\x06 \x01(\x01H\x05\x88\x01\x01\x12\x1f\n\x12sync_regions_total\x18\x07 \x01(\x05H\x06\x88\x01\x01\x12#\n\x16sync_regions_completed\x18\x08 \x01(\x05H\x07\x88\x01\x01\x12\x1c\n\x14sync_pending_regions\x18\t \x03(\tB\x0c\n\n_file_sizeB\x0f\n\r_storage_typeB\x11\n\x0f_storage_regionB\x16\n\x14_compression_task_idB\x1d\n\x1b_compression_variants_countB\x17\n\x15_compression_progressB\x15\n\x13_sync_regions_totalB\x19\n\x17_sync_regions_completed\"\x07\n\x05\x45mpty*z\n\x10\x46ileUploadStatus\x12\x12\n\x0eUPLOAD_UNKNOWN\x10\x00\x12\x12\n\x0eUPLOAD_PENDING\x10\x01\x12\x15\n\x11UPLOAD_PROCESSING\x10\x02\x12\x14\n\x10UPLOAD_COMPLETED\x10\x03\x12\x11\n\rUPLOAD_FAILED\x10\x04*\xd1\x01\n\x15\x46ileCompressionStatus\x12\x17\n\x13\x43OMPRESSION_UNKNOWN\x10\x00\x12\x1e\n\x1a\x43OMPRESSION_NOT_APPLICABLE\x10\x01\x12\x17\n\x13\x43OMPRESSION_PENDING\x10\x02\x12\x1a\n\x16\x43OMPRESSION_PROCESSING\x10\x03\x12\x19\n\x15\x43OMPRESSION_COMPLETED\x10\x04\x12\x16\n\x12\x43OMPRESSION_FAILED\x10\x05\x12\x17\n\x13\x43OMPRESSION_SKIPPED\x10\x06*\x97\x01\n\x0e\x46ileSyncStatus\x12\x10\n\x0cSYNC_UNKNOWN\x10\x00\x12\x15\n\x11SYNC_NOT_REQUIRED\x10\x01\x12\x10\n\x0cSYNC_PENDING\x10\x02\x12\x13\n\x0fSYNC_PROCESSING\x10\x03\x12\x10\n\x0cSYNC_PARTIAL\x10\x04\x12\x12\n\x0eSYNC_COMPLETED\x10\x05\x12\x0f\n\x0bSYNC_FAILED\x10\x06\x32\xda\n\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponse\x12W\n\x14GetCompressionStatus\x12\x1e.file.CompressionStatusRequest\x1a\x1f.file.CompressionStatusResponse\x12L\n\x15GetCompressedVariants\x12\x18.file.GetVariantsRequest\x1a\x19.file.GetVariantsResponse\x12O\n\x14TriggerRecompression\x12\x1a.file.RecompressionRequest\x1a\x1b.file.RecompressionResponse\x12_\n\x1aGenerateVariantDownloadUrl\x12\x1f.file.VariantDownloadUrlRequest\x1a .file.VariantDownloadUrlResponse\x12Q\n\x12\x42\x61tchGetFileStatus\x12\x1c.file.BatchFileStatusRequest\x1a\x1d.file.BatchFileStatusResponseb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x9f\x02\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x12#\n\x16keep_original_filename\x18\x08 \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\"\xb3\x02\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x12#\n\x16keep_original_filename\x18\t \x01(\x08H\x03\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_secondsB\x19\n\x17_keep_original_filename\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"`\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"7\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"_\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"+\n\x18\x43ompressionStatusRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x84\x01\n\x19\x43ompressionStatusResponse\x12\x0e\n\x06status\x18\x01 \x01(\t\x12\x1a\n\rerror_message\x18\x02 \x01(\tH\x00\x88\x01\x01\x12)\n\x08variants\x18\x03 \x03(\x0b\x32\x17.file.CompressedVariantB\x10\n\x0e_error_message\"Q\n\x12GetVariantsRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x19\n\x0cvariant_type\x18\x02 \x01(\tH\x00\x88\x01\x01\x42\x0f\n\r_variant_type\"@\n\x13GetVariantsResponse\x12)\n\x08variants\x18\x01 \x03(\x0b\x32\x17.file.CompressedVariant\"\xc7\x02\n\x11\x43ompressedVariant\x12\x14\n\x0cvariant_name\x18\x01 \x01(\t\x12\x14\n\x0cvariant_type\x18\x02 \x01(\t\x12\x12\n\nmedia_type\x18\x03 \x01(\t\x12\r\n\x05width\x18\x04 \x01(\x05\x12\x0e\n\x06height\x18\x05 \x01(\x05\x12\x11\n\tfile_size\x18\x06 \x01(\x03\x12\x0e\n\x06\x66ormat\x18\x07 \x01(\t\x12\x14\n\x07quality\x18\x08 \x01(\x05H\x00\x88\x01\x01\x12\x15\n\x08\x64uration\x18\t \x01(\x01H\x01\x88\x01\x01\x12\x14\n\x07\x62itrate\x18\n \x01(\x03H\x02\x88\x01\x01\x12\x10\n\x03\x66ps\x18\x0b \x01(\x05H\x03\x88\x01\x01\x12\x19\n\x11\x63ompression_ratio\x18\x0c \x01(\x01\x12\x13\n\x0bstored_path\x18\r \x01(\tB\n\n\x08_qualityB\x0b\n\t_durationB\n\n\x08_bitrateB\x06\n\x04_fps\"Y\n\x14RecompressionRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x1c\n\x0f\x66orce_reprocess\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x12\n\x10_force_reprocess\"8\n\x15RecompressionResponse\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06status\x18\x02 \x01(\t\"\x92\x01\n\x19VariantDownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x14\n\x0cvariant_name\x18\x02 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x13\n\x06is_cdn\x18\x04 \x01(\x08H\x01\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\t\n\x07_is_cdn\"\x8c\x01\n\x1aVariantDownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x12\n\x05\x65rror\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x32\n\x0cvariant_info\x18\x03 \x01(\x0b\x32\x17.file.CompressedVariantH\x01\x88\x01\x01\x42\x08\n\x06_errorB\x0f\n\r_variant_info\"\\\n\x16\x42\x61tchFileStatusRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x1c\n\x0finclude_details\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x12\n\x10_include_details\"m\n\x17\x42\x61tchFileStatusResponse\x12&\n\x08statuses\x18\x01 \x03(\x0b\x32\x14.file.FileStatusInfo\x12\x11\n\ttimestamp\x18\x02 \x01(\x03\x12\x17\n\x0f\x63\x61\x63he_hit_count\x18\x03 \x01(\x05\"\x9d\x02\n\x0e\x46ileStatusInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12-\n\rupload_status\x18\x02 \x01(\x0e\x32\x16.file.FileUploadStatus\x12\x37\n\x12\x63ompression_status\x18\x03 \x01(\x0e\x32\x1b.file.FileCompressionStatus\x12)\n\x0bsync_status\x18\x04 \x01(\x0e\x32\x14.file.FileSyncStatus\x12-\n\x07\x64\x65tails\x18\x05 \x01(\x0b\x32\x17.file.FileStatusDetailsH\x00\x88\x01\x01\x12\x1a\n\rerror_message\x18\x06 \x01(\tH\x01\x88\x01\x01\x42\n\n\x08_detailsB\x10\n\x0e_error_message\"\xe9\x03\n\x11\x46ileStatusDetails\x12\x16\n\tfile_size\x18\x01 \x01(\x03H\x00\x88\x01\x01\x12\x19\n\x0cstorage_type\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x1b\n\x0estorage_region\x18\x03 \x01(\tH\x02\x88\x01\x01\x12 \n\x13\x63ompression_task_id\x18\x04 \x01(\tH\x03\x88\x01\x01\x12\'\n\x1a\x63ompression_variants_count\x18\x05 \x01(\x05H\x04\x88\x01\x01\x12!\n\x14\x63ompression_progress\x18\x06 \x01(\x01H\x05\x88\x01\x01\x12\x1f\n\x12sync_regions_total\x18\x07 \x01(\x05H\x06\x88\x01\x01\x12#\n\x16sync_regions_completed\x18\x08 \x01(\x05H\x07\x88\x01\x01\x12\x1c\n\x14sync_pending_regions\x18\t \x03(\tB\x0c\n\n_file_sizeB\x0f\n\r_storage_typeB\x11\n\x0f_storage_regionB\x16\n\x14_compression_task_idB\x1d\n\x1b_compression_variants_countB\x17\n\x15_compression_progressB\x15\n\x13_sync_regions_totalB\x19\n\x17_sync_regions_completed\"\x07\n\x05\x45mpty*\x95\x01\n\x10\x46ileUploadStatus\x12\x12\n\x0eUPLOAD_UNKNOWN\x10\x00\x12\x12\n\x0eUPLOAD_PENDING\x10\x01\x12\x15\n\x11UPLOAD_PROCESSING\x10\x02\x12\x14\n\x10UPLOAD_COMPLETED\x10\x03\x12\x11\n\rUPLOAD_FAILED\x10\x04\x12\x19\n\x15UPLOAD_FILE_NOT_FOUND\x10\x05*\xf1\x01\n\x15\x46ileCompressionStatus\x12\x17\n\x13\x43OMPRESSION_UNKNOWN\x10\x00\x12\x1e\n\x1a\x43OMPRESSION_NOT_APPLICABLE\x10\x01\x12\x17\n\x13\x43OMPRESSION_PENDING\x10\x02\x12\x1a\n\x16\x43OMPRESSION_PROCESSING\x10\x03\x12\x19\n\x15\x43OMPRESSION_COMPLETED\x10\x04\x12\x16\n\x12\x43OMPRESSION_FAILED\x10\x05\x12\x17\n\x13\x43OMPRESSION_SKIPPED\x10\x06\x12\x1e\n\x1a\x43OMPRESSION_FILE_NOT_FOUND\x10\x07*\xb0\x01\n\x0e\x46ileSyncStatus\x12\x10\n\x0cSYNC_UNKNOWN\x10\x00\x12\x15\n\x11SYNC_NOT_REQUIRED\x10\x01\x12\x10\n\x0cSYNC_PENDING\x10\x02\x12\x13\n\x0fSYNC_PROCESSING\x10\x03\x12\x10\n\x0cSYNC_PARTIAL\x10\x04\x12\x12\n\x0eSYNC_COMPLETED\x10\x05\x12\x0f\n\x0bSYNC_FAILED\x10\x06\x12\x17\n\x13SYNC_FILE_NOT_FOUND\x10\x07\x32\xda\n\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponse\x12W\n\x14GetCompressionStatus\x12\x1e.file.CompressionStatusRequest\x1a\x1f.file.CompressionStatusResponse\x12L\n\x15GetCompressedVariants\x12\x18.file.GetVariantsRequest\x1a\x19.file.GetVariantsResponse\x12O\n\x14TriggerRecompression\x12\x1a.file.RecompressionRequest\x1a\x1b.file.RecompressionResponse\x12_\n\x1aGenerateVariantDownloadUrl\x12\x1f.file.VariantDownloadUrlRequest\x1a .file.VariantDownloadUrlResponse\x12Q\n\x12\x42\x61tchGetFileStatus\x12\x1c.file.BatchFileStatusRequest\x1a\x1d.file.BatchFileStatusResponseb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'file_service_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   DESCRIPTOR._loaded_options = None
-  _globals['_FILEUPLOADSTATUS']._serialized_start=5195
-  _globals['_FILEUPLOADSTATUS']._serialized_end=5317
-  _globals['_FILECOMPRESSIONSTATUS']._serialized_start=5320
-  _globals['_FILECOMPRESSIONSTATUS']._serialized_end=5529
-  _globals['_FILESYNCSTATUS']._serialized_start=5532
-  _globals['_FILESYNCSTATUS']._serialized_end=5683
+  _globals['_FILEUPLOADSTATUS']._serialized_start=5196
+  _globals['_FILEUPLOADSTATUS']._serialized_end=5345
+  _globals['_FILECOMPRESSIONSTATUS']._serialized_start=5348
+  _globals['_FILECOMPRESSIONSTATUS']._serialized_end=5589
+  _globals['_FILESYNCSTATUS']._serialized_start=5592
+  _globals['_FILESYNCSTATUS']._serialized_end=5768
   _globals['_FILE']._serialized_start=92
   _globals['_FILE']._serialized_end=263
   _globals['_UPLOADFILE']._serialized_start=266
@@ -119,6 +119,6 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_FILESTATUSDETAILS']._serialized_end=5184
   _globals['_EMPTY']._serialized_start=5186
   _globals['_EMPTY']._serialized_end=5193
-  _globals['_FILESERVICE']._serialized_start=5686
-  _globals['_FILESERVICE']._serialized_end=7056
+  _globals['_FILESERVICE']._serialized_start=5771
+  _globals['_FILESERVICE']._serialized_end=7141
 # @@protoc_insertion_point(module_scope)

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/file_hub_client/rpc/protos/file_service.proto

@@ -317,6 +317,7 @@ enum FileUploadStatus {
     UPLOAD_PROCESSING = 2;        // 上传中
     UPLOAD_COMPLETED = 3;         // 已完成
     UPLOAD_FAILED = 4;           // 失败
+    UPLOAD_FILE_NOT_FOUND = 5;   // 文件不存在
 }
 
 // 文件压缩状态枚举
@@ -328,6 +329,7 @@ enum FileCompressionStatus {
     COMPRESSION_COMPLETED = 4;       // 已完成
     COMPRESSION_FAILED = 5;          // 失败
     COMPRESSION_SKIPPED = 6;         // 跳过压缩
+    COMPRESSION_FILE_NOT_FOUND = 7;  // 文件不存在
 }
 
 // 文件同步状态枚举
@@ -335,10 +337,11 @@ enum FileSyncStatus {
     SYNC_UNKNOWN = 0;
     SYNC_NOT_REQUIRED = 1;          // 不需要同步
     SYNC_PENDING = 2;               // 等待同步
-    SYNC_PROCESSING = 3;            // 同步中  
+    SYNC_PROCESSING = 3;            // 同步中
     SYNC_PARTIAL = 4;               // 部分完成
     SYNC_COMPLETED = 5;             // 全部完成
     SYNC_FAILED = 6;                // 同步失败
+    SYNC_FILE_NOT_FOUND = 7;        // 文件不存在
 }
 
 message Empty {}

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/file_hub_client/schemas/file.py

@@ -181,6 +181,7 @@ class FileUploadStatus(str, Enum):
     UPLOAD_PROCESSING = "UPLOAD_PROCESSING"
     UPLOAD_COMPLETED = "UPLOAD_COMPLETED"
     UPLOAD_FAILED = "UPLOAD_FAILED"
+    UPLOAD_FILE_NOT_FOUND = "UPLOAD_FILE_NOT_FOUND"
 
 
 class FileCompressionStatus(str, Enum):
@@ -192,6 +193,7 @@ class FileCompressionStatus(str, Enum):
     COMPRESSION_COMPLETED = "COMPRESSION_COMPLETED"
     COMPRESSION_FAILED = "COMPRESSION_FAILED"
     COMPRESSION_SKIPPED = "COMPRESSION_SKIPPED"
+    COMPRESSION_FILE_NOT_FOUND = "COMPRESSION_FILE_NOT_FOUND"
 
 
 class FileSyncStatus(str, Enum):
@@ -203,6 +205,7 @@ class FileSyncStatus(str, Enum):
     SYNC_PARTIAL = "SYNC_PARTIAL"
     SYNC_COMPLETED = "SYNC_COMPLETED"
     SYNC_FAILED = "SYNC_FAILED"
+    SYNC_FILE_NOT_FOUND = "SYNC_FILE_NOT_FOUND"
 
 
 class FileStatusDetails(BaseModel):

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/file_hub_client/services/file/async_blob_service.py

@@ -1076,6 +1076,7 @@ class AsyncBlobService(BaseFileService):
             2: FileUploadStatus.UPLOAD_PROCESSING,
             3: FileUploadStatus.UPLOAD_COMPLETED,
             4: FileUploadStatus.UPLOAD_FAILED,
+            5: FileUploadStatus.UPLOAD_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileUploadStatus.UPLOAD_UNKNOWN)
 
@@ -1089,6 +1090,7 @@ class AsyncBlobService(BaseFileService):
             4: FileCompressionStatus.COMPRESSION_COMPLETED,
             5: FileCompressionStatus.COMPRESSION_FAILED,
             6: FileCompressionStatus.COMPRESSION_SKIPPED,
+            7: FileCompressionStatus.COMPRESSION_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileCompressionStatus.COMPRESSION_UNKNOWN)
 
@@ -1102,5 +1104,6 @@ class AsyncBlobService(BaseFileService):
             4: FileSyncStatus.SYNC_PARTIAL,
             5: FileSyncStatus.SYNC_COMPLETED,
             6: FileSyncStatus.SYNC_FAILED,
+            7: FileSyncStatus.SYNC_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileSyncStatus.SYNC_UNKNOWN)

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/file_hub_client/services/file/sync_blob_service.py

@@ -1074,6 +1074,7 @@ class SyncBlobService(BaseFileService):
             2: FileUploadStatus.UPLOAD_PROCESSING,
             3: FileUploadStatus.UPLOAD_COMPLETED,
             4: FileUploadStatus.UPLOAD_FAILED,
+            5: FileUploadStatus.UPLOAD_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileUploadStatus.UPLOAD_UNKNOWN)
 
@@ -1087,6 +1088,7 @@ class SyncBlobService(BaseFileService):
             4: FileCompressionStatus.COMPRESSION_COMPLETED,
             5: FileCompressionStatus.COMPRESSION_FAILED,
             6: FileCompressionStatus.COMPRESSION_SKIPPED,
+            7: FileCompressionStatus.COMPRESSION_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileCompressionStatus.COMPRESSION_UNKNOWN)
 
@@ -1100,5 +1102,6 @@ class SyncBlobService(BaseFileService):
             4: FileSyncStatus.SYNC_PARTIAL,
             5: FileSyncStatus.SYNC_COMPLETED,
             6: FileSyncStatus.SYNC_FAILED,
+            7: FileSyncStatus.SYNC_FILE_NOT_FOUND,
         }
         return status_map.get(proto_status, FileSyncStatus.SYNC_UNKNOWN)

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="tamar-file-hub-client",
-    version="0.1.9",
+    version="0.2.1",
     description="A Python SDK for gRPC-based file management system",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",
@@ -22,7 +22,7 @@ setup(
     install_requires=[
         "grpcio>=1.67.1",
         "grpcio-tools>=1.67.1",
-        "protobuf>=4.21.0",
+        "protobuf>=5.29.4",
         "pydantic>=2.0.0",
         "typing-extensions>=4.0.0;python_version<'3.10'",
         "requests>=2.28.0",

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1/tamar_file_hub_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.9
+Version: 0.2.1
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -25,7 +25,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: grpcio>=1.67.1
 Requires-Dist: grpcio-tools>=1.67.1
-Requires-Dist: protobuf>=4.21.0
+Requires-Dist: protobuf>=5.29.4
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: typing-extensions>=4.0.0; python_version < "3.10"
 Requires-Dist: requests>=2.28.0
@@ -63,6 +63,7 @@ Dynamic: summary
 - 📝 **类型注解**：完整的类型提示支持
 - 🧩 **模块化设计**：清晰的代码结构，易于扩展
 - 🎨 **图片和视频压缩**：支持多种规格的媒体文件压缩变体生成和管理
+- 📊 **批量状态查询**：支持批量查询文件的上传、压缩、备份同步状态
 - 🏗️ **分层服务架构**：文件服务分为传统文件（blob）和自定义类型（结构化数据），每种类型独立服务，语义清晰
 - 🔧 **环境变量配置**：支持通过环境变量配置所有参数
 - 👤 **用户上下文管理**：支持区分资源所有权（ownership）和操作者（operator）
@@ -214,6 +215,7 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
         - 支持临时文件上传
         - **媒体文件压缩**：支持图片和视频的多规格压缩变体生成
         - **压缩管理**：获取压缩状态、管理变体、触发重新压缩
+        - **批量文件状态查询**：一次性查询多个文件的上传、压缩、同步状态
         - 适用类型：PDF、图片、视频、音频、压缩包等
     - **file_service**: 处理文件元数据操作（所有类型通用）
         - 获取、重命名、删除文件
@@ -253,6 +255,12 @@ File Hub Client 采用分层服务架构，将文件服务按类型和语义进
     - `GetVariantsResponse`: 获取变体响应
     - `RecompressionResponse`: 重新压缩响应
     - `VariantDownloadUrlResponse`: 变体下载URL响应
+    - `BatchFileStatusResponse`: 批量文件状态响应
+    - `FileStatusInfo`: 单个文件状态信息
+    - `FileStatusDetails`: 文件状态详细信息
+    - `FileUploadStatus`: 文件上传状态枚举
+    - `FileCompressionStatus`: 文件压缩状态枚举
+    - `FileSyncStatus`: 文件同步状态枚举
 
 - **folder.py**: 文件夹相关的数据模型
     - `FolderInfo`: 文件夹信息
@@ -1031,6 +1039,184 @@ with TamarFileHubClient() as client:
    - 支持重新压缩以应用新的压缩设置
    - 批量状态查询减少网络请求
 
+### 批量文件状态查询
+
+File Hub Client 提供了高效的批量文件状态查询功能，可以一次性获取多个文件的上传、压缩、同步状态：
+
+#### 基础批量查询
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量查询多个文件的状态
+    file_ids = ["file-id-1", "file-id-2", "file-id-3"]
+    response = await client.blobs.batch_get_file_status(
+        file_ids=file_ids,
+        include_details=False  # 是否包含详细信息，默认False
+    )
+    
+    print(f"查询时间戳: {response.timestamp}")
+    print(f"缓存命中数量: {response.cache_hit_count}")
+    print(f"查询到 {len(response.statuses)} 个文件状态")
+    
+    for status in response.statuses:
+        print(f"文件ID: {status.file_id}")
+        print(f"  上传状态: {status.upload_status.value}")
+        print(f"  压缩状态: {status.compression_status.value}")
+        print(f"  同步状态: {status.sync_status.value}")
+        
+        if status.error_message:
+            print(f"  错误信息: {status.error_message}")
+```
+
+#### 详细信息查询
+
+```python
+# 查询详细状态信息
+detailed_response = await client.blobs.batch_get_file_status(
+    file_ids=file_ids,
+    include_details=True  # 包含详细信息
+)
+
+for status in detailed_response.statuses:
+    print(f"文件ID: {status.file_id}")
+    print(f"  上传状态: {status.upload_status.value}")
+    print(f"  压缩状态: {status.compression_status.value}")
+    print(f"  同步状态: {status.sync_status.value}")
+    
+    if status.details:
+        print("  详细信息:")
+        if status.details.file_size:
+            print(f"    文件大小: {status.details.file_size} 字节")
+        if status.details.storage_type:
+            print(f"    存储类型: {status.details.storage_type}")
+        if status.details.storage_region:
+            print(f"    存储区域: {status.details.storage_region}")
+            
+        # 压缩相关详细信息
+        if status.details.compression_task_id:
+            print(f"    压缩任务ID: {status.details.compression_task_id}")
+        if status.details.compression_variants_count is not None:
+            print(f"    压缩变体数量: {status.details.compression_variants_count}")
+        if status.details.compression_progress is not None:
+            print(f"    压缩进度: {status.details.compression_progress * 100:.1f}%")
+        
+        # 同步相关详细信息
+        if status.details.sync_regions_total is not None:
+            print(f"    同步区域总数: {status.details.sync_regions_total}")
+        if status.details.sync_regions_completed is not None:
+            print(f"    已完成同步区域: {status.details.sync_regions_completed}")
+        if status.details.sync_pending_regions:
+            print(f"    待同步区域: {', '.join(status.details.sync_pending_regions)}")
+```
+
+#### 状态筛选和分析
+
+```python
+from file_hub_client.schemas import (
+    FileUploadStatus, 
+    FileCompressionStatus, 
+    FileSyncStatus
+)
+
+# 查询文件状态
+response = await client.blobs.batch_get_file_status(file_ids=file_ids)
+
+# 筛选出上传失败的文件
+failed_uploads = [
+    status for status in response.statuses 
+    if status.upload_status == FileUploadStatus.UPLOAD_FAILED
+]
+
+# 筛选出正在处理的文件
+processing_files = [
+    status for status in response.statuses 
+    if (status.upload_status == FileUploadStatus.UPLOAD_PROCESSING or
+        status.compression_status == FileCompressionStatus.COMPRESSION_PROCESSING or
+        status.sync_status == FileSyncStatus.SYNC_PROCESSING)
+]
+
+# 筛选出压缩不适用的文件（非图片/视频）
+non_compressible_files = [
+    status for status in response.statuses 
+    if status.compression_status == FileCompressionStatus.COMPRESSION_NOT_APPLICABLE
+]
+
+print(f"上传失败的文件: {len(failed_uploads)} 个")
+print(f"正在处理的文件: {len(processing_files)} 个")
+print(f"非媒体文件: {len(non_compressible_files)} 个")
+```
+
+#### 同步客户端示例
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 同步批量查询
+    response = client.blobs.batch_get_file_status(
+        file_ids=["file-1", "file-2", "file-3"],
+        include_details=True
+    )
+    
+    for status in response.statuses:
+        print(f"文件 {status.file_id[:8]}...")
+        print(f"  状态: {status.upload_status.value}")
+        
+        if status.details:
+            print(f"  大小: {status.details.file_size} bytes")
+```
+
+#### 状态枚举说明
+
+**上传状态 (FileUploadStatus):**
+- `UPLOAD_UNKNOWN`: 未知状态
+- `UPLOAD_PENDING`: 待上传
+- `UPLOAD_PROCESSING`: 上传中
+- `UPLOAD_COMPLETED`: 已完成
+- `UPLOAD_FAILED`: 失败
+
+**压缩状态 (FileCompressionStatus):**
+- `COMPRESSION_UNKNOWN`: 未知状态
+- `COMPRESSION_NOT_APPLICABLE`: 不需要压缩（非图片/视频文件）
+- `COMPRESSION_PENDING`: 等待压缩
+- `COMPRESSION_PROCESSING`: 压缩中
+- `COMPRESSION_COMPLETED`: 已完成
+- `COMPRESSION_FAILED`: 失败
+- `COMPRESSION_SKIPPED`: 跳过压缩
+
+**同步状态 (FileSyncStatus):**
+- `SYNC_UNKNOWN`: 未知状态
+- `SYNC_NOT_REQUIRED`: 不需要同步
+- `SYNC_PENDING`: 等待同步
+- `SYNC_PROCESSING`: 同步中
+- `SYNC_PARTIAL`: 部分完成
+- `SYNC_COMPLETED`: 全部完成
+- `SYNC_FAILED`: 同步失败
+
+#### 使用场景
+
+1. **文件处理监控**：
+   - 实时监控文件上传、压缩、同步进度
+   - 及时发现和处理失败的文件
+
+2. **批量状态查询**：
+   - 一次查询最多100个文件状态
+   - 减少网络请求，提高性能
+
+3. **业务流程控制**：
+   - 根据文件状态决定后续业务逻辑
+   - 确保文件完全准备就绪后再进行下一步操作
+
+4. **性能优化**：
+   - 利用缓存机制提高查询效率
+   - 支持详细信息的按需获取
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2378,6 +2564,7 @@ MIT License
 - **断点续传修复**: 解决断点续传中的HTTP头部和签名验证问题
 - **AI生成文件支持**: 完善对AI生成内容（图片、视频、音频）的MIME类型处理
 - **新功能**: 新增 `mime_type` 参数支持，允许用户显式指定文件MIME类型
+- **批量文件状态查询**: 新增 `batch_get_file_status` API，支持批量查询文件上传、压缩、同步状态
 - **魔术字节检测**: 增强内容检测，支持26+种主流文件格式的自动识别
 - **向下兼容**: 保持100%向下兼容，现有代码无需修改
 - **核心修复**:

{tamar_file_hub_client-0.1.9 → tamar_file_hub_client-0.2.1}/tamar_file_hub_client.egg-info/requires.txt

@@ -1,6 +1,6 @@
 grpcio>=1.67.1
 grpcio-tools>=1.67.1
-protobuf>=4.21.0
+protobuf>=5.29.4
 pydantic>=2.0.0
 requests>=2.28.0
 aiohttp>=3.8.0