from __future__ import annotations
from typing import List, Dict, Protocol, runtime_checkable, Tuple, AsyncIterator
from models import StorageAdapter

# 约定：任意新适配器模块需定义:
# ADAPTER_TYPE: str
# CONFIG_SCHEMA: List[Dict]
# ADAPTER_FACTORY: Callable[[StorageAdapter], BaseAdapter] (可省略, 会自动寻找 *Adapter 类)

@runtime_checkable
class BaseAdapter(Protocol):
    record: StorageAdapter
    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]: ...
    async def read_file(self, root: str, rel: str) -> bytes: ...
    async def write_file(self, root: str, rel: str, data: bytes): ...
    async def write_file_stream(self, root: str, rel: str, data_iter: AsyncIterator[bytes]): ... 
    async def mkdir(self, root: str, rel: str): ...
    async def delete(self, root: str, rel: str): ...
    async def move(self, root: str, src_rel: str, dst_rel: str): ...
    async def rename(self, root: str, src_rel: str, dst_rel: str): ... 
    async def copy(self, root: str, src_rel: str, dst_rel: str, overwrite: bool = False): ...
    async def stream_file(self, root: str, rel: str, range_header: str | None): ...
    async def stat_file(self, root: str, rel: str): ...
    def get_effective_root(self, sub_path: str | None) -> str: ...