lean-s3 0.7.2 → 0.7.4

package/dist/index.d.ts

@@ -27,10 +27,13 @@ type Brand<B> = {
 type Branded<T, B> = T & Brand<B>;
 type BucketName = Branded<string, "BucketName">;
 type ObjectKey = Branded<string, "ObjectKey">;
+type Endpoint = Branded<string, "Endpoint">;
+type Region = Branded<string, "Region">;
 
-declare const write: unique symbol;
-declare const stream: unique symbol;
-declare const signedRequest: unique symbol;
+declare const kWrite: unique symbol;
+declare const kStream: unique symbol;
+declare const kSignedRequest: unique symbol;
+declare const kGetEffectiveParams: unique symbol;
 interface S3ClientOptions {
     bucket: string;
     region: string;
@@ -57,7 +60,7 @@ type DeleteObjectsError = {
     message: string;
     versionId: string;
 };
-interface S3FilePresignOptions {
+interface S3FilePresignOptions extends OverridableS3ClientOptions {
     contentHash?: Buffer;
     /** Seconds. */
     expiresIn?: number;
@@ -287,6 +290,7 @@ declare class S3Client {
      * @param  options The default options to use for the S3 client.
      */
     constructor(options: S3ClientOptions);
+    [kGetEffectiveParams](region: string | undefined | null, endpoint: string | undefined | null, bucket: string | undefined | null): [region: Region, endpoint: Endpoint, bucket: BucketName];
     /**
      * Creates an S3File instance for the given path.
      *
@@ -346,8 +350,7 @@ declare class S3Client {
      * });
      * ```
      */
-    presign(path: string, { method, expiresIn, // TODO: Maybe rename this to expiresInSeconds
-    storageClass, contentLength, type, acl, region: regionOverride, bucket: bucketOverride, endpoint: endpointOverride, response, }?: S3FilePresignOptions & OverridableS3ClientOptions): string;
+    presign(path: string, options?: S3FilePresignOptions): string;
     createMultipartUpload(key: string, options?: CreateMultipartUploadOptions): Promise<CreateMultipartUploadResult>;
     /**
      * @remarks Uses [`ListMultipartUploads`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html).
@@ -442,16 +445,16 @@ declare class S3Client {
      * TODO: Maybe move this into a separate free function?
      * @internal
      */
-    [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>>;
+    [kSignedRequest](region: Region, endpoint: Endpoint, bucket: BucketName, method: HttpMethod, pathWithoutBucket: ObjectKey, query: string | undefined, body: UndiciBodyInit | undefined, additionalSignedHeaders: Record<string, string> | undefined, additionalUnsignedHeaders: Record<string, string> | undefined, contentHash: Buffer | undefined, signal?: AbortSignal | undefined): Promise<Dispatcher.ResponseData<null>>;
     /**
      * @internal
      * @param {import("./index.d.ts").UndiciBodyInit} data TODO
      */
-    [write](path: string, data: UndiciBodyInit, contentType: string, contentLength: number | undefined, contentHash: Buffer | undefined, rageStart: number | undefined, rangeEndExclusive: number | undefined, signal?: AbortSignal | undefined): Promise<void>;
+    [kWrite](path: ObjectKey, data: UndiciBodyInit, contentType: string, contentLength: number | undefined, contentHash: Buffer | undefined, rageStart: number | undefined, rangeEndExclusive: number | undefined, signal?: AbortSignal | undefined): Promise<void>;
     /**
      * @internal
      */
-    [stream](path: string, contentHash: Buffer | undefined, rageStart: number | undefined, rangeEndExclusive: number | undefined): stream_web.ReadableStream<Uint8Array<ArrayBufferLike>>;
+    [kStream](path: ObjectKey, contentHash: Buffer | undefined, rageStart: number | undefined, rangeEndExclusive: number | undefined): stream_web.ReadableStream<Uint8Array<ArrayBufferLike>>;
 }
 
 declare class S3Stat {
@@ -471,7 +474,19 @@ declare class S3File {
     #private;
     /** @internal */
     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;
+    /**
+     * Creates and returns a new {@link S3File} containing a subset of this {@link S3File} data.
+     * @param start The starting index.
+     * @param end The ending index, exclusive.
+     */
+    slice(start?: number, end?: number): S3File;
+    /**
+     * Creates and returns a new {@link S3File} containing a subset of this {@link S3File} data.
+     * @param start The starting index.
+     * @param end The ending index, exclusive.
+     * @param contentType The content-type for the new {@link S3File}.
+     */
+    slice(start?: number, end?: number, contentType?: string): S3File;
     /**
      *  Get the stat of a file in the bucket. Uses `HEAD` request to check existence.
      *

package/dist/index.js

@@ -320,6 +320,9 @@ function getAuthorizationHeader(keyCache, method, path, query, date, sortedSigne
 
 // src/branded.ts
 function ensureValidBucketName(name) {
+  if (typeof name !== "string") {
+    throw new TypeError("`name` must be a `string`.");
+  }
   if (name.length < 3 || name.length > 63) {
     throw new Error("`name` must be between 3 and 63 characters long.");
   }
@@ -345,6 +348,24 @@ function ensureValidPath(path) {
   }
   return path;
 }
+function ensureValidEndpoint(endpoint) {
+  if (typeof endpoint !== "string") {
+    throw new TypeError("`endpoint` must be a `string`.");
+  }
+  if (endpoint.length < 1) {
+    throw new RangeError("`endpoint` must be at least 1 character long.");
+  }
+  return endpoint;
+}
+function ensureValidRegion(region) {
+  if (typeof region !== "string") {
+    throw new TypeError("`region` must be a `string`.");
+  }
+  if (region.length < 1) {
+    throw new RangeError("`region` must be at least 1 character long.");
+  }
+  return region;
+}
 
 // src/assertNever.ts
 function assertNever(v) {
@@ -373,9 +394,10 @@ function encodeURIComponentExtended(value) {
 }
 
 // src/S3Client.ts
-var write = Symbol("write");
-var stream = Symbol("stream");
-var signedRequest = Symbol("signedRequest");
+var kWrite = Symbol("kWrite");
+var kStream = Symbol("kStream");
+var kSignedRequest = Symbol("kSignedRequest");
+var kGetEffectiveParams = Symbol("kGetEffectiveParams");
 var xmlParser2 = new XMLParser2({
   ignoreAttributes: true,
   isArray: (_, jPath) => jPath === "ListMultipartUploadsResult.Upload" || jPath === "ListBucketResult.Contents" || jPath === "ListPartsResult.Part" || jPath === "DeleteResult.Deleted" || jPath === "DeleteResult.Error"
@@ -387,7 +409,7 @@ var xmlBuilder = new XMLBuilder({
 var S3Client = class {
   #options;
   #keyCache = new KeyCache();
-  // TODO: pass options to this in client? Do we want to expose tjhe internal use of undici?
+  // TODO: pass options to this in client? Do we want to expose the internal use of undici?
   #dispatcher = new Agent();
   /**
    * Create a new instance of an S3 bucket so that credentials can be managed from a single instance instead of being passed to every method.
@@ -424,26 +446,19 @@ var S3Client = class {
     this.#options = {
       accessKeyId,
       secretAccessKey,
-      endpoint,
-      region,
-      bucket,
+      endpoint: ensureValidEndpoint(options.endpoint),
+      region: ensureValidRegion(options.region),
+      bucket: ensureValidBucketName(options.bucket),
       sessionToken
     };
   }
-  // Maybe future API
-  /*
-  cors = {
-  	get: () => {
-  		// TODO: GetBucketCors
-  	},
-  	set: () => {
-  		// TODO: PutBucketCors
-  	},
-  	delete: () => {
-  		// TODO: DeleteBucketCors
-  	},
-  };
-  */
+  [kGetEffectiveParams](region, endpoint, bucket) {
+    return [
+      ensureValidRegion(region ?? this.#options.region),
+      ensureValidEndpoint(endpoint ?? this.#options.endpoint),
+      ensureValidBucketName(bucket ?? this.#options.bucket)
+    ];
+  }
   /**
    * Creates an S3File instance for the given path.
    *
@@ -511,52 +526,51 @@ var S3Client = class {
    * });
    * ```
    */
-  presign(path, {
-    method = "GET",
-    expiresIn = 3600,
-    // TODO: Maybe rename this to expiresInSeconds
-    storageClass,
-    contentLength,
-    type,
-    acl,
-    region: regionOverride,
-    bucket: bucketOverride,
-    endpoint: endpointOverride,
-    response
-  } = {}) {
+  presign(path, options = {}) {
+    const contentLength = options.contentLength ?? void 0;
     if (typeof contentLength === "number") {
       if (contentLength < 0) {
         throw new RangeError("`contentLength` must be >= 0.");
       }
     }
+    const method = options.method ?? "GET";
+    const contentType = options.type ?? void 0;
+    const [region, endpoint, bucket] = this[kGetEffectiveParams](
+      options.region,
+      options.endpoint,
+      options.bucket
+    );
+    const responseOptions = options.response;
+    const contentDisposition = responseOptions?.contentDisposition;
+    const responseContentDisposition = contentDisposition ? getContentDispositionHeader(contentDisposition) : void 0;
+    const res = buildRequestUrl(
+      endpoint,
+      bucket,
+      region,
+      ensureValidPath(path)
+    );
     const now2 = /* @__PURE__ */ new Date();
     const date = getAmzDate(now2);
-    const options = this.#options;
-    const region = regionOverride ?? options.region;
-    const bucket = bucketOverride ?? options.bucket;
-    const endpoint = endpointOverride ?? options.endpoint;
-    const responseContentDisposition = response?.contentDisposition ? getContentDispositionHeader(response?.contentDisposition) : void 0;
-    const res = buildRequestUrl(endpoint, bucket, region, path);
     const query = buildSearchParams(
-      `${options.accessKeyId}/${date.date}/${region}/s3/aws4_request`,
+      `${this.#options.accessKeyId}/${date.date}/${region}/s3/aws4_request`,
       date,
-      expiresIn,
-      typeof contentLength === "number" || typeof type === "string" ? typeof contentLength === "number" && typeof type === "string" ? "content-length;content-type;host" : typeof contentLength === "number" ? "content-length;host" : typeof type === "string" ? "content-type;host" : "" : "host",
+      options.expiresIn ?? 3600,
+      typeof contentLength === "number" || typeof contentType === "string" ? typeof contentLength === "number" && typeof contentType === "string" ? "content-length;content-type;host" : typeof contentLength === "number" ? "content-length;host" : typeof contentType === "string" ? "content-type;host" : "" : "host",
       unsignedPayload,
-      storageClass,
-      options.sessionToken,
-      acl,
+      options.storageClass,
+      this.#options.sessionToken,
+      options.acl,
       responseContentDisposition
     );
-    const dataDigest = typeof contentLength === "number" || typeof type === "string" ? createCanonicalDataDigest(
+    const dataDigest = typeof contentLength === "number" || typeof contentType === "string" ? createCanonicalDataDigest(
       method,
       res.pathname,
       query,
-      typeof contentLength === "number" && typeof type === "string" ? {
+      typeof contentLength === "number" && typeof contentType === "string" ? {
         "content-length": String(contentLength),
-        "content-type": type,
+        "content-type": contentType,
         host: res.host
-      } : typeof contentLength === "number" ? { "content-length": String(contentLength), host: res.host } : typeof type === "string" ? { "content-type": type, host: res.host } : {},
+      } : typeof contentLength === "number" ? { "content-length": String(contentLength), host: res.host } : typeof contentType === "string" ? { "content-type": contentType, host: res.host } : {},
       unsignedPayload
     ) : createCanonicalDataDigestHostOnly(
       method,
@@ -567,8 +581,8 @@ var S3Client = class {
     const signingKey = this.#keyCache.computeIfAbsent(
       date,
       region,
-      options.accessKeyId,
-      options.secretAccessKey
+      this.#options.accessKeyId,
+      this.#options.secretAccessKey
     );
     const signature = signCanonicalDataHash(
       signingKey,
@@ -583,7 +597,10 @@ var S3Client = class {
   async createMultipartUpload(key, options = {}) {
     if (key.length < 1) {
     }
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "POST",
       ensureValidPath(key),
       "uploads=",
@@ -591,7 +608,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -610,9 +626,6 @@ var S3Client = class {
    * @throws {RangeError} If `options.maxKeys` is not between `1` and `1000`.
    */
   async listMultipartUploads(options = {}) {
-    const bucket = ensureValidBucketName(
-      options.bucket ?? this.#options.bucket
-    );
     let query = "uploads=";
     if (options.delimiter) {
       if (typeof options.delimiter !== "string") {
@@ -641,7 +654,10 @@ var S3Client = class {
       }
       query += `&prefix=${encodeURIComponent(options.prefix)}`;
     }
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "GET",
       "",
       query,
@@ -649,7 +665,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      bucket,
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -692,7 +707,10 @@ var S3Client = class {
     if (!uploadId) {
       throw new Error("`uploadId` is required.");
     }
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "DELETE",
       ensureValidPath(path),
       `uploadId=${encodeURIComponent(uploadId)}`,
@@ -700,10 +718,9 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
-    if (response.statusCode !== 204) {
+    if (response.statusCode !== 204 && response.statusCode !== 200) {
       throw await getResponseError(response, path);
     }
   }
@@ -724,7 +741,10 @@ var S3Client = class {
         }))
       }
     });
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "POST",
       ensureValidPath(path),
       `uploadId=${encodeURIComponent(uploadId)}`,
@@ -732,7 +752,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -768,7 +787,10 @@ var S3Client = class {
     if (typeof partNumber !== "number" || partNumber <= 0) {
       throw new Error("`partNumber` has to be a `number` which is >= 1.");
     }
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "PUT",
       ensureValidPath(path),
       `partNumber=${partNumber}&uploadId=${encodeURIComponent(uploadId)}`,
@@ -776,7 +798,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -820,7 +841,10 @@ var S3Client = class {
       query += `&part-number-marker=${encodeURIComponent(options.partNumberMarker)}`;
     }
     query += `&uploadId=${encodeURIComponent(uploadId)}`;
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "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
@@ -829,7 +853,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options?.signal
     );
     if (response.statusCode === 200) {
@@ -893,7 +916,10 @@ var S3Client = class {
       }) : void 0;
     }
     const additionalSignedHeaders = body ? { "content-md5": md5Base64(body) } : void 0;
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      ensureValidBucketName(name),
       "PUT",
       "",
       void 0,
@@ -901,7 +927,6 @@ var S3Client = class {
       additionalSignedHeaders,
       void 0,
       void 0,
-      ensureValidBucketName(name),
       options?.signal
     );
     if (400 <= response.statusCode && response.statusCode < 500) {
@@ -921,7 +946,10 @@ var S3Client = class {
    * @remarks Uses [`DeleteBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html).
    */
   async deleteBucket(name, options) {
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      ensureValidBucketName(name),
       "DELETE",
       "",
       void 0,
@@ -929,7 +957,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(name),
       options?.signal
     );
     if (400 <= response.statusCode && response.statusCode < 500) {
@@ -948,7 +975,10 @@ var S3Client = class {
    * @remarks Uses [`HeadBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html).
    */
   async bucketExists(name, options) {
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      ensureValidBucketName(name),
       "HEAD",
       "",
       void 0,
@@ -956,7 +986,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(name),
       options?.signal
     );
     if (response.statusCode !== 404 && 400 <= response.statusCode && response.statusCode < 500) {
@@ -987,7 +1016,10 @@ var S3Client = class {
         }))
       }
     });
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "PUT",
       "",
       "cors=",
@@ -998,7 +1030,6 @@ var S3Client = class {
       },
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -1016,7 +1047,10 @@ var S3Client = class {
    * @remarks Uses [`GetBucketCors`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html).
    */
   async getBucketCors(options = {}) {
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "GET",
       "",
       "cors=",
@@ -1025,7 +1059,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -1038,7 +1071,10 @@ var S3Client = class {
    * @remarks Uses [`DeleteBucketCors`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html).
    */
   async deleteBucketCors(options = {}) {
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "DELETE",
       "",
       "cors=",
@@ -1047,7 +1083,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 204) {
@@ -1117,7 +1152,10 @@ var S3Client = class {
       }
       query += `&start-after=${encodeURIComponent(options.startAfter)}`;
     }
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      ensureValidRegion(this.#options.region),
+      ensureValidEndpoint(this.#options.endpoint),
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "GET",
       "",
       query,
@@ -1125,7 +1163,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -1166,7 +1203,10 @@ var S3Client = class {
         }))
       }
     });
-    const response = await this[signedRequest](
+    const response = await this[kSignedRequest](
+      this.#options.region,
+      this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket,
       "POST",
       "",
       "delete=",
@@ -1177,7 +1217,6 @@ var S3Client = class {
       },
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -1215,16 +1254,8 @@ var S3Client = class {
    * TODO: Maybe move this into a separate free function?
    * @internal
    */
-  async [signedRequest](method, pathWithoutBucket, query, body, additionalSignedHeaders, additionalUnsignedHeaders, contentHash, bucket, signal = void 0) {
-    const endpoint = this.#options.endpoint;
-    const region = this.#options.region;
-    const effectiveBucket = bucket ?? this.#options.bucket;
-    const url = buildRequestUrl(
-      endpoint,
-      effectiveBucket,
-      region,
-      pathWithoutBucket
-    );
+  async [kSignedRequest](region, endpoint, bucket, method, pathWithoutBucket, query, body, additionalSignedHeaders, additionalUnsignedHeaders, contentHash, signal = void 0) {
+    const url = buildRequestUrl(endpoint, bucket, region, pathWithoutBucket);
     if (query) {
       url.search = query;
     }
@@ -1272,7 +1303,7 @@ var S3Client = class {
    * @internal
    * @param {import("./index.d.ts").UndiciBodyInit} data TODO
    */
-  async [write](path, data, contentType, contentLength, contentHash, rageStart, rangeEndExclusive, signal = void 0) {
+  async [kWrite](path, data, contentType, contentLength, contentHash, rageStart, rangeEndExclusive, signal = void 0) {
     const bucket = this.#options.bucket;
     const endpoint = this.#options.endpoint;
     const region = this.#options.region;
@@ -1328,7 +1359,7 @@ var S3Client = class {
   /**
    * @internal
    */
-  [stream](path, contentHash, rageStart, rangeEndExclusive) {
+  [kStream](path, contentHash, rageStart, rangeEndExclusive) {
     const bucket = this.#options.bucket;
     const endpoint = this.#options.endpoint;
     const region = this.#options.region;
@@ -1513,7 +1544,12 @@ var S3File = class _S3File {
     this.#end = end;
     this.#contentType = contentType ?? "application/octet-stream";
   }
-  // TODO: slice overloads
+  /**
+   * Creates and returns a new {@link S3File} containing a subset of this {@link S3File} data.
+   * @param start The starting index.
+   * @param end The ending index, exclusive.
+   * @param contentType The content-type for the new {@link S3File}.
+   */
   slice(start, end, contentType) {
     return new _S3File(
       this.#client,
@@ -1531,7 +1567,15 @@ var S3File = class _S3File {
    * @throws {Error} If the server returns an invalid response.
    */
   async stat(options = {}) {
-    const response = await this.#client[signedRequest](
+    const [region, endpoint, bucket] = this.#client[kGetEffectiveParams](
+      options.region,
+      options.endpoint,
+      options.bucket
+    );
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "HEAD",
       this.#path,
       void 0,
@@ -1539,7 +1583,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     response.body.dump();
@@ -1562,7 +1605,15 @@ var S3File = class _S3File {
    * @remarks Uses [`HeadObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html).
    */
   async exists(options = {}) {
-    const response = await this.#client[signedRequest](
+    const [region, endpoint, bucket] = this.#client[kGetEffectiveParams](
+      options.region,
+      options.endpoint,
+      options.bucket
+    );
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "HEAD",
       this.#path,
       void 0,
@@ -1570,7 +1621,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     response.body.dump();
@@ -1607,7 +1657,15 @@ var S3File = class _S3File {
    * ```
    */
   async delete(options = {}) {
-    const response = await this.#client[signedRequest](
+    const [region, endpoint, bucket] = this.#client[kGetEffectiveParams](
+      options.region,
+      options.endpoint,
+      options.bucket
+    );
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "DELETE",
       this.#path,
       void 0,
@@ -1615,7 +1673,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     if (response.statusCode === 204) {
@@ -1646,7 +1703,7 @@ var S3File = class _S3File {
   }
   /** @returns {ReadableStream<Uint8Array>} */
   stream() {
-    return this.#client[stream](this.#path, void 0, this.#start, this.#end);
+    return this.#client[kStream](this.#path, void 0, this.#start, this.#end);
   }
   async #transformData(data) {
     if (typeof data === "string") {
@@ -1689,7 +1746,7 @@ var S3File = class _S3File {
   async write(data, options = {}) {
     const signal = void 0;
     const [bytes, length, hash] = await this.#transformData(data);
-    return await this.#client[write](
+    return await this.#client[kWrite](
       this.#path,
       bytes,
       options.type ?? this.#contentType,

package/package.json

@@ -2,7 +2,7 @@
   "name": "lean-s3",
   "author": "Niklas Mollenhauer",
   "license": "MIT",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "A server-side S3 API for the regular user.",
   "keywords": [
     "s3",
@@ -47,13 +47,14 @@
     "undici": "^7.11.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.0.6",
-    "@testcontainers/localstack": "^11.2.0",
-    "@testcontainers/minio": "^11.2.0",
+    "@biomejs/biome": "2.1.1",
+    "@testcontainers/localstack": "^11.2.1",
+    "@testcontainers/minio": "^11.2.1",
     "@types/node": "^24.0.10",
-    "@typescript/native-preview": "^7.0.0-dev.20250705.1",
+    "@typescript/native-preview": "^7.0.0-dev.20250708.1",
     "expect": "^30.0.4",
-    "lefthook": "^1.11.16",
+    "lefthook": "^1.12.0",
+    "testcontainers": "^11.2.1",
     "tsup": "^8.5.0",
     "tsx": "^4.20.3",
     "typedoc": "^0.28.7"