Class S3FileSystem

packages/filesystem/s3/s3.ts:54–274

 * 使用原生 fetch + AWS Signature V4 签名，不依赖 @aws-sdk/client-s3
 */
export default class S3FileSystem implements FileSystem {
  client: S3Client;

  bucket: string;

  basePath: string = "/";

  constructor(bucket: string, client: S3Client, basePath?: string);
  constructor(
    bucket: string,
    region: string,
    accessKeyId: string,
    secretAccessKey: string,
    endpoint?: string,
    basePath?: string
  );
  constructor(
    bucket: string,
    regionOrClient: string | S3Client,
    accessKeyIdOrBasePath?: string,
    secretAccessKey?: string,
    endpoint?: string,
    basePath?: string
  ) {
    this.bucket = bucket;
    if (regionOrClient instanceof S3Client) {
      this.client = regionOrClient;
      this.basePath = accessKeyIdOrBasePath || "/";
      return;
    }
    this.basePath = basePath || "/";

    const config: S3ClientConfig = {
      region: regionOrClient || "us-east-1",
      credentials: {
        accessKeyId: accessKeyIdOrBasePath!,
        secretAccessKey: secretAccessKey!,
      },
      forcePathStyle: true, // 强制路径式访问，兼容大多数 S3 服务
    };

    if (endpoint) {
      let fixedEndpoint = `${endpoint}`.trim();
      if (!fixedEndpoint.startsWith("http://") && !fixedEndpoint.startsWith("https://")) {
        fixedEndpoint = `https://${fixedEndpoint}`;
      }
      config.endpoint = fixedEndpoint;
      // amazonaws.com 域名使用虚拟主机风格
      if (endpoint.includes("amazonaws.com")) config.forcePathStyle = false;
    }

    this.client = new S3Client(config);
  }

  /**
   * 验证 Bucket 访问权限和凭证
   * @throws {WarpTokenError} 认证失败
   * @throws {Error} Bucket 不存在或网络错误