env.storage

export interface Storage {
  put(key: string, body: BodyInit | null, opts?: { contentType?: string }): Promise<StorageObject>;
  /** 키가 없으면 `null`을 반환합니다. 404 오류가 아닙니다. */
  get(key: string): Promise<(StorageObject & { body: ReadableStream<Uint8Array> | null }) | null>;
  head(key: string): Promise<StorageObject | null>;
  /** 여러 번 호출해도 안전합니다. 없는 키를 삭제해도 성공합니다. */
  delete(key: string): Promise<void>;
  list(opts?: { prefix?: string; cursor?: string; limit?: number }): Promise<StorageListPage>;
  /** 서명 URL입니다. GET과 PUT만 지원합니다. ttl은 초 단위(기본 300, 최대 3600)입니다. */
  presign(key: string, opts?: { method?: "GET" | "PUT"; ttl?: number }): Promise<string>;
}

export interface StorageObject {
  key: string;
  size: number;
  etag: string;
  contentType: string;
  /** RFC 1123 형식이며 비어 있을 수 있습니다. */
  lastModified: string;
}

await env.storage.put("users/42/avatar.png", body);

await env.storage.put("a//b", body);   // TypeError
await env.storage.put("a/../b", body); // TypeError