lean-s3 0.5.0 → 0.6.1

package/README.md

@@ -137,6 +137,8 @@ See [DESIGN_DECISIONS.md](./DESIGN_DECISIONS.md) to read about why this library
 - ✅ [`PutObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) via `S3File.write`
 - ✅ [`HeadObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) via `S3File.exists`/`S3File.stat`
 - ✅ [`ListMultipartUploads`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html) via `.listMultipartUploads`
+- ✅ [`ListParts`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html) via `.listParts`
+- ✅ [`UploadPart`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) via `.uploadPart`
 - ✅ [`CompleteMultipartUpload`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html) via `.completeMultipartUpload`
 - ✅ [`AbortMultipartUpload`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html) via `.abortMultipartUpload`
 

package/dist/index.d.ts

@@ -20,6 +20,14 @@ declare class S3BucketEntry {
     static parse(source: any): S3BucketEntry;
 }
 
+declare const __brand: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
+};
+type Branded<T, B> = T & Brand<B>;
+type BucketName = Branded<string, "BucketName">;
+type ObjectKey = Branded<string, "ObjectKey">;
+
 declare const write: unique symbol;
 declare const stream: unique symbol;
 declare const signedRequest: unique symbol;
@@ -34,6 +42,7 @@ interface S3ClientOptions {
 type OverridableS3ClientOptions = Pick<S3ClientOptions, "region" | "bucket" | "endpoint">;
 type CreateFileInstanceOptions = {};
 type DeleteObjectsOptions = {
+    bucket?: string;
     signal?: AbortSignal;
 };
 interface S3FilePresignOptions {
@@ -100,7 +109,7 @@ type CreateMultipartUploadOptions = {
     bucket?: string;
     signal?: AbortSignal;
 };
-type CreateMultipartUploadResponse = {
+type CreateMultipartUploadResult = {
     bucket: string;
     key: string;
     uploadId: string;
@@ -129,7 +138,44 @@ type MultipartUploadPart = {
     partNumber: number;
     etag: string;
 };
-type ListObjectsResponse = {
+type UploadPartOptions = {
+    bucket?: string;
+    signal?: AbortSignal;
+};
+type UploadPartResult = {
+    partNumber: number;
+    etag: string;
+};
+type ListPartsOptions = {
+    maxParts?: number;
+    partNumberMarker?: string;
+    bucket?: string;
+    signal?: AbortSignal;
+};
+type ListPartsResult = {
+    bucket: string;
+    key: string;
+    uploadId: string;
+    partNumberMarker?: string;
+    nextPartNumberMarker?: string;
+    maxParts?: number;
+    isTruncated: boolean;
+    parts: Array<{
+        checksumCRC32?: string;
+        checksumCRC32C?: string;
+        checksumCRC64NVME?: string;
+        checksumSHA1?: string;
+        checksumSHA256?: string;
+        etag: string;
+        lastModified: Date;
+        partNumber: number;
+        size: number;
+    }>;
+    storageClass?: StorageClass;
+    checksumAlgorithm?: ChecksumAlgorithm;
+    checksumType?: ChecksumType;
+};
+type ListObjectsResult = {
     name: string;
     prefix: string | undefined;
     startAfter: string | undefined;
@@ -226,7 +272,7 @@ declare class S3Client {
      */
     presign(path: string, { method, expiresIn, // TODO: Maybe rename this to expiresInSeconds
     storageClass, contentLength, acl, region: regionOverride, bucket: bucketOverride, endpoint: endpointOverride, }?: Partial<S3FilePresignOptions & OverridableS3ClientOptions>): string;
-    createMultipartUpload(key: string, options?: CreateMultipartUploadOptions): Promise<CreateMultipartUploadResponse>;
+    createMultipartUpload(key: string, options?: CreateMultipartUploadOptions): Promise<CreateMultipartUploadResult>;
     /**
      * @remarks Uses [`ListMultipartUploads`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html).
      * @throws {RangeError} If `options.maxKeys` is not between `1` and `1000`.
@@ -237,24 +283,28 @@ declare class S3Client {
      * @throws {RangeError} If `key` is not at least 1 character long.
      * @throws {Error} If `uploadId` is not provided.
      */
-    abortMultipartUpload(key: string, uploadId: string, options?: AbortMultipartUploadOptions): Promise<void>;
+    abortMultipartUpload(path: string, uploadId: string, options?: AbortMultipartUploadOptions): Promise<void>;
     /**
      * @remarks Uses [`CompleteMultipartUpload`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html).
      * @throws {RangeError} If `key` is not at least 1 character long.
      * @throws {Error} If `uploadId` is not provided.
      */
-    completeMultipartUpload(key: string, uploadId: string, parts: readonly MultipartUploadPart[], options?: CompleteMultipartUploadOptions): Promise<{
-        location: any;
-        bucket: any;
-        key: any;
-        etag: any;
-        checksumCRC32: any;
-        checksumCRC32C: any;
-        checksumCRC64NVME: any;
-        checksumSHA1: any;
-        checksumSHA256: any;
-        checksumType: any;
-    }>;
+    completeMultipartUpload(path: string, uploadId: string, parts: readonly MultipartUploadPart[], options?: CompleteMultipartUploadOptions): Promise<CompleteMultipartUploadResult>;
+    /**
+     * @remarks Uses [`UploadPart`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html).
+     * @throws {RangeError} If `key` is not at least 1 character long.
+     * @throws {Error} If `uploadId` is not provided.
+     */
+    uploadPart(path: string, uploadId: string, data: UndiciBodyInit, partNumber: number, options?: UploadPartOptions): Promise<UploadPartResult>;
+    /**
+     * @remarks Uses [`ListParts`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html).
+     * @throws {RangeError} If `key` is not at least 1 character long.
+     * @throws {Error} If `uploadId` is not provided.
+     * @throws {TypeError} If `options.maxParts` is not a `number`.
+     * @throws {RangeError} If `options.maxParts` is <= 0.
+     * @throws {TypeError} If `options.partNumberMarker` is not a `string`.
+     */
+    listParts(path: string, uploadId: string, options?: ListPartsOptions): Promise<ListPartsResult>;
     /**
      * Creates a new bucket on the S3 server.
      *
@@ -294,7 +344,7 @@ declare class S3Client {
      *
      * @throws {RangeError} If `maxKeys` is not between `1` and `1000`.
      */
-    list(options?: ListObjectsOptions): Promise<ListObjectsResponse>;
+    list(options?: ListObjectsOptions): Promise<ListObjectsResult>;
     /**
      * Uses [`DeleteObjects`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html) to delete multiple objects in a single request.
      */
@@ -306,7 +356,7 @@ declare class S3Client {
      * TODO: Maybe move this into a separate free function?
      * @internal
      */
-    [signedRequest](method: HttpMethod, pathWithoutBucket: string, query: string | undefined, body: UndiciBodyInit | undefined, additionalSignedHeaders: Record<string, string> | undefined, additionalUnsignedHeaders: Record<string, string> | undefined, contentHash: Buffer | undefined, bucket: string | undefined, signal?: AbortSignal | undefined): Promise<Dispatcher.ResponseData<null>>;
+    [signedRequest](method: HttpMethod, pathWithoutBucket: ObjectKey, query: string | undefined, body: UndiciBodyInit | undefined, additionalSignedHeaders: Record<string, string> | undefined, additionalUnsignedHeaders: Record<string, string> | undefined, contentHash: Buffer | undefined, bucket: BucketName | undefined, signal?: AbortSignal | undefined): Promise<Dispatcher.ResponseData<null>>;
     /**
      * @internal
      * @param {import("./index.d.ts").UndiciBodyInit} data TODO
@@ -332,7 +382,7 @@ declare class S3File {
     /**
      * @internal
      */
-    constructor(client: S3Client, path: string, start: number | undefined, end: number | undefined, contentType: string | undefined);
+    constructor(client: S3Client, path: ObjectKey, start: number | undefined, end: number | undefined, contentType: string | undefined);
     slice(start?: number | undefined, end?: number | undefined, contentType?: string | undefined): S3File;
     /**
      *  Get the stat of a file in the bucket. Uses `HEAD` request to check existence.
@@ -434,4 +484,4 @@ type BucketInfo = {
     type?: string;
 };
 
-export { type AbortMultipartUploadOptions, type Acl, type BucketCreationOptions, type BucketDeletionOptions, type BucketExistsOptions, type BucketInfo, type BucketLocationInfo, type ByteSource, type ChecksumAlgorithm, type ChecksumType, type CompleteMultipartUploadOptions, type CompleteMultipartUploadResult, type CreateFileInstanceOptions, type CreateMultipartUploadOptions, type CreateMultipartUploadResponse, type DeleteObjectsOptions, type HttpMethod, type ListMultipartUploadsOptions, type ListMultipartUploadsResult, type ListObjectsIteratingOptions, type ListObjectsOptions, type ListObjectsResponse, type MultipartUpload, type MultipartUploadPart, type OverridableS3ClientOptions, type PresignableHttpMethod, S3BucketEntry, S3Client, type S3ClientOptions, S3Error, type S3ErrorOptions, S3File, type S3FileDeleteOptions, type S3FileExistsOptions, type S3FilePresignOptions, S3Stat, type S3StatOptions, type StorageClass, type UndiciBodyInit };
+export { type AbortMultipartUploadOptions, type Acl, type BucketCreationOptions, type BucketDeletionOptions, type BucketExistsOptions, type BucketInfo, type BucketLocationInfo, type ByteSource, type ChecksumAlgorithm, type ChecksumType, type CompleteMultipartUploadOptions, type CompleteMultipartUploadResult, type CreateFileInstanceOptions, type CreateMultipartUploadOptions, type CreateMultipartUploadResult, type DeleteObjectsOptions, type HttpMethod, type ListMultipartUploadsOptions, type ListMultipartUploadsResult, type ListObjectsIteratingOptions, type ListObjectsOptions, type ListObjectsResult, type ListPartsOptions, type ListPartsResult, type MultipartUpload, type MultipartUploadPart, type OverridableS3ClientOptions, type PresignableHttpMethod, S3BucketEntry, S3Client, type S3ClientOptions, S3Error, type S3ErrorOptions, S3File, type S3FileDeleteOptions, type S3FileExistsOptions, type S3FilePresignOptions, S3Stat, type S3StatOptions, type StorageClass, type UndiciBodyInit, type UploadPartOptions, type UploadPartResult };

package/dist/index.js

@@ -318,13 +318,41 @@ function getAuthorizationHeader(keyCache, method, path, query, date, sortedSigne
   return `AWS4-HMAC-SHA256 Credential=${credentialSpec}, SignedHeaders=${signedHeadersSpec}, Signature=${signature}`;
 }
 
+// src/branded.ts
+function ensureValidBucketName(name) {
+  if (name.length < 3 || name.length > 63) {
+    throw new Error("`name` must be between 3 and 63 characters long.");
+  }
+  if (name.startsWith(".") || name.endsWith(".")) {
+    throw new Error("`name` must not start or end with a period (.)");
+  }
+  if (!/^[a-z0-9.-]+$/.test(name)) {
+    throw new Error(
+      "`name` can only contain lowercase letters, numbers, periods (.), and hyphens (-)."
+    );
+  }
+  if (name.includes("..")) {
+    throw new Error("`name` must not contain two adjacent periods (..)");
+  }
+  return name;
+}
+function ensureValidPath(path) {
+  if (typeof path !== "string") {
+    throw new TypeError("`path` must be a `string`.");
+  }
+  if (path.length < 1) {
+    throw new RangeError("`path` must be at least 1 character long.");
+  }
+  return path;
+}
+
 // src/S3Client.ts
 var write = Symbol("write");
 var stream = Symbol("stream");
 var signedRequest = Symbol("signedRequest");
 var xmlParser2 = new XMLParser2({
   ignoreAttributes: true,
-  isArray: (_, jPath) => jPath === "ListMultipartUploadsResult.Upload" || jPath === "ListBucketResult.Contents" || jPath === "DeleteResult.Deleted" || jPath === "DeleteResult.Error"
+  isArray: (_, jPath) => jPath === "ListMultipartUploadsResult.Upload" || jPath === "ListBucketResult.Contents" || jPath === "ListPartsResult.Part" || jPath === "DeleteResult.Deleted" || jPath === "DeleteResult.Error"
 });
 var xmlBuilder = new XMLBuilder({
   attributeNamePrefix: "$",
@@ -412,7 +440,13 @@ var S3Client = class {
    * ```
    */
   file(path, _options) {
-    return new S3File(this, path, void 0, void 0, void 0);
+    return new S3File(
+      this,
+      ensureValidPath(path),
+      void 0,
+      void 0,
+      void 0
+    );
   }
   /**
    * Generate a presigned URL for temporary access to a file.
@@ -489,11 +523,10 @@ var S3Client = class {
   //#region multipart uploads
   async createMultipartUpload(key, options = {}) {
     if (key.length < 1) {
-      throw new RangeError("`key` must be at least 1 character long.");
     }
     const response = await this[signedRequest](
       "POST",
-      key,
+      ensureValidPath(key),
       "uploads=",
       void 0,
       void 0,
@@ -524,28 +557,28 @@ var S3Client = class {
     let query = "uploads=";
     if (options.delimiter) {
       if (typeof options.delimiter !== "string") {
-        throw new TypeError("`delimiter` should be a `string`.");
+        throw new TypeError("`delimiter` must be a `string`.");
       }
       query += `&delimiter=${encodeURIComponent(options.delimiter)}`;
     }
     if (options.keyMarker) {
       if (typeof options.keyMarker !== "string") {
-        throw new TypeError("`keyMarker` should be a `string`.");
+        throw new TypeError("`keyMarker` must be a `string`.");
       }
       query += `&key-marker=${encodeURIComponent(options.keyMarker)}`;
     }
     if (typeof options.maxUploads !== "undefined") {
       if (typeof options.maxUploads !== "number") {
-        throw new TypeError("`maxUploads` should be a `number`.");
+        throw new TypeError("`maxUploads` must be a `number`.");
       }
       if (options.maxUploads < 1 || options.maxUploads > 1e3) {
-        throw new RangeError("`maxUploads` should be between 1 and 1000.");
+        throw new RangeError("`maxUploads` has to be between 1 and 1000.");
       }
       query += `&max-uploads=${options.maxUploads}`;
     }
     if (options.prefix) {
       if (typeof options.prefix !== "string") {
-        throw new TypeError("`prefix` should be a `string`.");
+        throw new TypeError("`prefix` must be a `string`.");
       }
       query += `&prefix=${encodeURIComponent(options.prefix)}`;
     }
@@ -596,16 +629,13 @@ var S3Client = class {
    * @throws {RangeError} If `key` is not at least 1 character long.
    * @throws {Error} If `uploadId` is not provided.
    */
-  async abortMultipartUpload(key, uploadId, options = {}) {
-    if (key.length < 1) {
-      throw new RangeError("`key` must be at least 1 character long.");
-    }
+  async abortMultipartUpload(path, uploadId, options = {}) {
     if (!uploadId) {
       throw new Error("`uploadId` is required.");
     }
     const response = await this[signedRequest](
       "DELETE",
-      key,
+      ensureValidPath(path),
       `uploadId=${encodeURIComponent(uploadId)}`,
       void 0,
       void 0,
@@ -615,7 +645,7 @@ var S3Client = class {
       options.signal
     );
     if (response.statusCode !== 204) {
-      throw await getResponseError(response, key);
+      throw await getResponseError(response, path);
     }
   }
   /**
@@ -623,10 +653,7 @@ var S3Client = class {
    * @throws {RangeError} If `key` is not at least 1 character long.
    * @throws {Error} If `uploadId` is not provided.
    */
-  async completeMultipartUpload(key, uploadId, parts, options = {}) {
-    if (key.length < 1) {
-      throw new RangeError("`key` must be at least 1 character long.");
-    }
+  async completeMultipartUpload(path, uploadId, parts, options = {}) {
     if (!uploadId) {
       throw new Error("`uploadId` is required.");
     }
@@ -640,7 +667,7 @@ var S3Client = class {
     });
     const response = await this[signedRequest](
       "POST",
-      key,
+      ensureValidPath(path),
       `uploadId=${encodeURIComponent(uploadId)}`,
       body,
       void 0,
@@ -650,7 +677,7 @@ var S3Client = class {
       options.signal
     );
     if (response.statusCode !== 200) {
-      throw await getResponseError(response, key);
+      throw await getResponseError(response, path);
     }
     const text = await response.body.text();
     const res = ensureParsedXml(text).CompleteMultipartUploadResult ?? {};
@@ -667,6 +694,109 @@ var S3Client = class {
       checksumType: res.ChecksumType || void 0
     };
   }
+  /**
+   * @remarks Uses [`UploadPart`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html).
+   * @throws {RangeError} If `key` is not at least 1 character long.
+   * @throws {Error} If `uploadId` is not provided.
+   */
+  async uploadPart(path, uploadId, data, partNumber, options = {}) {
+    if (!uploadId) {
+      throw new Error("`uploadId` is required.");
+    }
+    if (!data) {
+      throw new Error("`data` is required.");
+    }
+    if (typeof partNumber !== "number" || partNumber <= 0) {
+      throw new Error("`partNumber` has to be a `number` which is >= 1.");
+    }
+    const response = await this[signedRequest](
+      "PUT",
+      ensureValidPath(path),
+      `partNumber=${partNumber}&uploadId=${encodeURIComponent(uploadId)}`,
+      data,
+      void 0,
+      void 0,
+      void 0,
+      ensureValidBucketName(options.bucket ?? this.#options.bucket),
+      options.signal
+    );
+    if (response.statusCode === 200) {
+      await response.body.dump();
+      const etag = response.headers.etag;
+      if (typeof etag !== "string" || etag.length === 0) {
+        throw new S3Error("Unknown", "", {
+          message: "Response did not contain an etag."
+        });
+      }
+      return {
+        partNumber,
+        etag
+      };
+    }
+    throw await getResponseError(response, "");
+  }
+  /**
+   * @remarks Uses [`ListParts`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html).
+   * @throws {RangeError} If `key` is not at least 1 character long.
+   * @throws {Error} If `uploadId` is not provided.
+   * @throws {TypeError} If `options.maxParts` is not a `number`.
+   * @throws {RangeError} If `options.maxParts` is <= 0.
+   * @throws {TypeError} If `options.partNumberMarker` is not a `string`.
+   */
+  async listParts(path, uploadId, options = {}) {
+    let query = "";
+    if (options.maxParts) {
+      if (typeof options.maxParts !== "number") {
+        throw new TypeError("`maxParts` must be a `number`.");
+      }
+      if (options.maxParts <= 0) {
+        throw new RangeError("`maxParts` must be >= 1.");
+      }
+      query += `&max-parts=${options.maxParts}`;
+    }
+    if (options.partNumberMarker) {
+      if (typeof options.partNumberMarker !== "string") {
+        throw new TypeError("`partNumberMarker` must be a `string`.");
+      }
+      query += `&part-number-marker=${encodeURIComponent(options.partNumberMarker)}`;
+    }
+    query += `&uploadId=${encodeURIComponent(uploadId)}`;
+    const response = await this[signedRequest](
+      "GET",
+      ensureValidPath(path),
+      // We always have a leading &, so we can slice the leading & away (this way, we have less conditionals on the hot path); see benchmark-operations.js
+      query.substring(1),
+      void 0,
+      void 0,
+      void 0,
+      void 0,
+      ensureValidBucketName(options.bucket ?? this.#options.bucket),
+      options?.signal
+    );
+    if (response.statusCode === 200) {
+      const text = await response.body.text();
+      const root = ensureParsedXml(text).ListPartsResult ?? {};
+      return {
+        bucket: root.Bucket,
+        key: root.Key,
+        uploadId: root.UploadId,
+        partNumberMarker: root.PartNumberMarker ?? void 0,
+        nextPartNumberMarker: root.NextPartNumberMarker ?? void 0,
+        maxParts: root.MaxParts ?? 1e3,
+        isTruncated: root.IsTruncated ?? false,
+        parts: (
+          // biome-ignore lint/suspicious/noExplicitAny: parsing code
+          root.Part?.map((part) => ({
+            etag: part.ETag,
+            lastModified: part.LastModified ? new Date(part.LastModified) : void 0,
+            partNumber: part.PartNumber ?? void 0,
+            size: part.Size ?? void 0
+          })) ?? []
+        )
+      };
+    }
+    throw await getResponseError(response, path);
+  }
   //#endregion
   //#region bucket operations
   /**
@@ -812,29 +942,29 @@ var S3Client = class {
     let query = "";
     if (typeof options.continuationToken !== "undefined") {
       if (typeof options.continuationToken !== "string") {
-        throw new TypeError("`continuationToken` should be a `string`.");
+        throw new TypeError("`continuationToken` must be a `string`.");
       }
       query += `continuation-token=${encodeURIComponent(options.continuationToken)}&`;
     }
     query += "list-type=2";
     if (typeof options.maxKeys !== "undefined") {
       if (typeof options.maxKeys !== "number") {
-        throw new TypeError("`maxKeys` should be a `number`.");
+        throw new TypeError("`maxKeys` must be a `number`.");
       }
       if (options.maxKeys < 1 || options.maxKeys > 1e3) {
-        throw new RangeError("`maxKeys` should be between 1 and 1000.");
+        throw new RangeError("`maxKeys` has to be between 1 and 1000.");
       }
       query += `&max-keys=${options.maxKeys}`;
     }
     if (options.prefix) {
       if (typeof options.prefix !== "string") {
-        throw new TypeError("`prefix` should be a `string`.");
+        throw new TypeError("`prefix` must be a `string`.");
       }
       query += `&prefix=${encodeURIComponent(options.prefix)}`;
     }
     if (typeof options.startAfter !== "undefined") {
       if (typeof options.startAfter !== "string") {
-        throw new TypeError("`startAfter` should be a `string`.");
+        throw new TypeError("`startAfter` must be a `string`.");
       }
       query += `&start-after=${encodeURIComponent(options.startAfter)}`;
     }
@@ -846,7 +976,7 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      options.bucket ?? this.#options.bucket,
+      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -898,7 +1028,7 @@ var S3Client = class {
       },
       void 0,
       void 0,
-      this.#options.bucket,
+      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -1193,23 +1323,6 @@ function buildSearchParams(amzCredential, date, expiresIn, headerList, contentHa
   }
   return res;
 }
-function ensureValidBucketName(name) {
-  if (name.length < 3 || name.length > 63) {
-    throw new Error("`name` must be between 3 and 63 characters long.");
-  }
-  if (name.startsWith(".") || name.endsWith(".")) {
-    throw new Error("`name` must not start or end with a period (.)");
-  }
-  if (!/^[a-z0-9.-]+$/.test(name)) {
-    throw new Error(
-      "`name` can only contain lowercase letters, numbers, periods (.), and hyphens (-)."
-    );
-  }
-  if (name.includes("..")) {
-    throw new Error("`name` must not contain two adjacent periods (..)");
-  }
-  return name;
-}
 function ensureParsedXml(text) {
   try {
     const r = xmlParser2.parse(text);

package/package.json

@@ -2,7 +2,7 @@
   "name": "lean-s3",
   "author": "Niklas Mollenhauer",
   "license": "MIT",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "A server-side S3 API for the regular user.",
   "keywords": [
     "s3",
@@ -44,14 +44,15 @@
   },
   "dependencies": {
     "fast-xml-parser": "^5.2.5",
+    "i": "^0.3.7",
     "undici": "^7.10.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.0.0",
+    "@biomejs/biome": "2.0.0",
     "@testcontainers/localstack": "^11.0.3",
     "@testcontainers/minio": "^11.0.3",
     "@types/node": "^24.0.3",
-    "@typescript/native-preview": "^7.0.0-dev.20250619.1",
+    "@typescript/native-preview": "^7.0.0-dev.20250620.1",
     "expect": "^30.0.2",
     "lefthook": "^1.11.14",
     "tsup": "^8.5.0",