Class WebDAVFileSystem

packages/filesystem/webdav/webdav.ts:26–134

};

export default class WebDAVFileSystem implements FileSystem {
  client: WebDAVClient;

  url: string;

  basePath: string = "/";

  static fromCredentials(url: string, options: WebDAVClientOptions) {
    initWebDAVPatch();
    options = {
      ...options,
      headers: {
        "X-Requested-With": "XMLHttpRequest", // Nextcloud 等需要
        // "requesttoken": csrfToken,          // 按账号各自传入
      },
    };
    return new WebDAVFileSystem(createClient(url, options), url, "/");
  }

  static fromSameClient(fs: WebDAVFileSystem, basePath: string) {
    return new WebDAVFileSystem(fs.client, fs.url, basePath);
  }

  private constructor(client: WebDAVClient, url: string, basePath: string) {
    this.client = client;
    this.url = url;
    this.basePath = basePath;
  }

  async verify(): Promise<void> {
    // 只做只读校验：凭据 + URL 可达性。
    // 写权限不在此处探测——不同 basePath 写策略不同（坚果云等根目录不可写的服务会被误杀，见 #1444），
    // 真正的写操作会在 backupToCloud / buildFileSystem 中由 createDir 立即触发并报错。
    try {
      await this.client.getQuota();
      await this.client.getDirectoryContents(this.basePath);
    } catch (e: any) {
      if (e.response?.status === 401) {
        throw new WarpTokenError(e);
      }
      throw new Error(`WebDAV verify failed: ${e.message}`); // 保留原始信息
    }
  }

  async open(file: FileInfo): Promise<FileReader> {
    return new WebDAVFileReader(this.client, joinPath(file.path, file.name));
  }

  async openDir(path: string): Promise<FileSystem> {
    return WebDAVFileSystem.fromSameClient(this, joinPath(this.basePath, path));
  }

  async create(path: string, _opts?: FileCreateOptions): Promise<FileWriter> {
    return new WebDAVFileWriter(this.client, joinPath(this.basePath, path));
  }

  async createDir(path: string, _opts?: FileCreateOptions): Promise<void> {
    try {