lean-s3 0.7.3 → 0.7.5

package/README.md

@@ -181,3 +181,13 @@ const client = new S3Client({
 ```
 
 Popular S3 provider missing? Open an issue or file a PR!
+
+## Tested On
+To ensure compability across various providers and self-hosted services, all tests are run on:
+- Amazon AWS S3
+- Hetzner Object Storage
+- Cloudflare R2
+- Garage
+- Minio
+- LocalStack
+- Ceph

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;
@@ -223,6 +226,8 @@ type ListObjectsResult = {
     contents: readonly S3BucketEntry[];
 };
 type BucketCreationOptions = {
+    endpoint?: string;
+    region?: string;
     locationConstraint?: string;
     location?: BucketLocationInfo;
     info?: BucketInfo;
@@ -287,6 +292,8 @@ declare class S3Client {
      * @param  options The default options to use for the S3 client.
      */
     constructor(options: S3ClientOptions);
+    /** @internal */
+    [kGetEffectiveParams](options: OverridableS3ClientOptions): [region: Region, endpoint: Endpoint, bucket: BucketName];
     /**
      * Creates an S3File instance for the given path.
      *
@@ -346,7 +353,7 @@ declare class S3Client {
      * });
      * ```
      */
-    presign(path: string, optio2ns?: S3FilePresignOptions): 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).
@@ -441,16 +448,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 {
@@ -470,7 +477,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

@@ -319,32 +319,75 @@ function getAuthorizationHeader(keyCache, method, path, query, date, sortedSigne
 }
 
 // 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.");
+function ensureValidBucketName(bucket) {
+  if (typeof bucket !== "string") {
+    throw new TypeError("`bucket` is required and must be a `string`.");
   }
-  if (name.startsWith(".") || name.endsWith(".")) {
-    throw new Error("`name` must not start or end with a period (.)");
+  if (bucket.length < 3 || bucket.length > 63) {
+    throw new Error("`bucket` must be between 3 and 63 characters long.");
   }
-  if (!/^[a-z0-9.-]+$/.test(name)) {
+  if (bucket.startsWith(".") || bucket.endsWith(".")) {
+    throw new Error("`bucket` must not start or end with a period (.)");
+  }
+  if (!/^[a-z0-9.-]+$/.test(bucket)) {
     throw new Error(
-      "`name` can only contain lowercase letters, numbers, periods (.), and hyphens (-)."
+      "`bucket` can only contain lowercase letters, numbers, periods (.), and hyphens (-)."
     );
   }
-  if (name.includes("..")) {
-    throw new Error("`name` must not contain two adjacent periods (..)");
+  if (bucket.includes("..")) {
+    throw new Error("`bucket` must not contain two adjacent periods (..)");
+  }
+  return bucket;
+}
+function ensureValidAccessKeyId(accessKeyId) {
+  if (typeof accessKeyId !== "string") {
+    throw new TypeError("`AccessKeyId` is required and must be a `string`.");
+  }
+  if (accessKeyId.length < 1) {
+    throw new RangeError("`AccessKeyId` must be at least 1 character long.");
+  }
+  return accessKeyId;
+}
+function ensureValidSecretAccessKey(secretAccessKey) {
+  if (typeof secretAccessKey !== "string") {
+    throw new TypeError(
+      "`SecretAccessKey` is required and must be a `string`."
+    );
+  }
+  if (secretAccessKey.length < 1) {
+    throw new RangeError(
+      "`SecretAccessKey` must be at least 1 character long."
+    );
   }
-  return name;
+  return secretAccessKey;
 }
 function ensureValidPath(path) {
   if (typeof path !== "string") {
-    throw new TypeError("`path` must be a `string`.");
+    throw new TypeError("`path` is required and must be a `string`.");
   }
   if (path.length < 1) {
     throw new RangeError("`path` must be at least 1 character long.");
   }
   return path;
 }
+function ensureValidEndpoint(endpoint) {
+  if (typeof endpoint !== "string") {
+    throw new TypeError("`endpoint` is required and 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` is required and 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 +416,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 +431,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.
@@ -398,52 +442,23 @@ var S3Client = class {
     if (!options) {
       throw new Error("`options` is required.");
     }
-    const {
-      accessKeyId,
-      secretAccessKey,
-      endpoint,
-      region,
-      bucket,
-      sessionToken
-    } = options;
-    if (!accessKeyId || typeof accessKeyId !== "string") {
-      throw new Error("`accessKeyId` is required.");
-    }
-    if (!secretAccessKey || typeof secretAccessKey !== "string") {
-      throw new Error("`secretAccessKey` is required.");
-    }
-    if (!endpoint || typeof endpoint !== "string") {
-      throw new Error("`endpoint` is required.");
-    }
-    if (!region || typeof region !== "string") {
-      throw new Error("`region` is required.");
-    }
-    if (!bucket || typeof bucket !== "string") {
-      throw new Error("`bucket` is required.");
-    }
     this.#options = {
-      accessKeyId,
-      secretAccessKey,
-      endpoint,
-      region,
-      bucket,
-      sessionToken
+      accessKeyId: ensureValidAccessKeyId(options.accessKeyId),
+      secretAccessKey: ensureValidSecretAccessKey(options.secretAccessKey),
+      endpoint: ensureValidEndpoint(options.endpoint),
+      region: ensureValidRegion(options.region),
+      bucket: ensureValidBucketName(options.bucket),
+      sessionToken: options.sessionToken
     };
   }
-  // Maybe future API
-  /*
-  cors = {
-  	get: () => {
-  		// TODO: GetBucketCors
-  	},
-  	set: () => {
-  		// TODO: PutBucketCors
-  	},
-  	delete: () => {
-  		// TODO: DeleteBucketCors
-  	},
-  };
-  */
+  /** @internal */
+  [kGetEffectiveParams](options) {
+    return [
+      options.region ? ensureValidRegion(options.region) : this.#options.region,
+      options.endpoint ? ensureValidEndpoint(options.endpoint) : this.#options.endpoint,
+      options.bucket ? ensureValidBucketName(options.bucket) : this.#options.bucket
+    ];
+  }
   /**
    * Creates an S3File instance for the given path.
    *
@@ -511,33 +526,36 @@ var S3Client = class {
    * });
    * ```
    */
-  presign(path, optio2ns = {}) {
-    const contentLength = optio2ns.contentLength ?? void 0;
+  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 = optio2ns.method ?? "GET";
-    const contentType = optio2ns.type ?? void 0;
-    const region = optio2ns.region ?? this.#options.region;
-    const bucket = optio2ns.bucket ?? this.#options.bucket;
-    const endpoint = optio2ns.endpoint ?? this.#options.endpoint;
-    const responseOptions = optio2ns.response;
+    const method = options.method ?? "GET";
+    const contentType = options.type ?? void 0;
+    const [region, endpoint, bucket] = this[kGetEffectiveParams](options);
+    const responseOptions = options.response;
     const contentDisposition = responseOptions?.contentDisposition;
     const responseContentDisposition = contentDisposition ? getContentDispositionHeader(contentDisposition) : void 0;
-    const res = buildRequestUrl(endpoint, bucket, region, path);
+    const res = buildRequestUrl(
+      endpoint,
+      bucket,
+      region,
+      ensureValidPath(path)
+    );
     const now2 = /* @__PURE__ */ new Date();
     const date = getAmzDate(now2);
     const query = buildSearchParams(
       `${this.#options.accessKeyId}/${date.date}/${region}/s3/aws4_request`,
       date,
-      optio2ns.expiresIn ?? 3600,
+      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,
-      optio2ns.storageClass,
+      options.storageClass,
       this.#options.sessionToken,
-      optio2ns.acl,
+      options.acl,
       responseContentDisposition
     );
     const dataDigest = typeof contentLength === "number" || typeof contentType === "string" ? createCanonicalDataDigest(
@@ -573,9 +591,10 @@ var S3Client = class {
   }
   //#region multipart uploads
   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=",
@@ -583,7 +602,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -602,9 +620,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") {
@@ -633,7 +648,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,
@@ -641,7 +659,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      bucket,
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -684,7 +701,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)}`,
@@ -692,10 +712,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);
     }
   }
@@ -716,7 +735,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)}`,
@@ -724,7 +746,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -760,7 +781,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)}`,
@@ -768,7 +792,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -812,7 +835,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
@@ -821,7 +847,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options?.signal
     );
     if (response.statusCode === 200) {
@@ -864,7 +889,7 @@ var S3Client = class {
    * @throws {S3Error} If the bucket could not be created, e.g. if it already exists.
    * @remarks Uses [`CreateBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
    */
-  async createBucket(name, options) {
+  async createBucket(name, options = {}) {
     let body;
     if (options) {
       const location = options.location && (options.location.name || options.location.type) ? {
@@ -885,7 +910,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](
+      options.region ? ensureValidRegion(options.region) : this.#options.region,
+      options.endpoint ? ensureValidEndpoint(options.endpoint) : this.#options.endpoint,
+      ensureValidBucketName(name),
       "PUT",
       "",
       void 0,
@@ -893,8 +921,7 @@ var S3Client = class {
       additionalSignedHeaders,
       void 0,
       void 0,
-      ensureValidBucketName(name),
-      options?.signal
+      options.signal
     );
     if (400 <= response.statusCode && response.statusCode < 500) {
       throw await getResponseError(response, "");
@@ -913,7 +940,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,
@@ -921,7 +951,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(name),
       options?.signal
     );
     if (400 <= response.statusCode && response.statusCode < 500) {
@@ -940,7 +969,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,
@@ -948,7 +980,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(name),
       options?.signal
     );
     if (response.statusCode !== 404 && 400 <= response.statusCode && response.statusCode < 500) {
@@ -979,7 +1010,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=",
@@ -990,7 +1024,6 @@ var S3Client = class {
       },
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -1008,7 +1041,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=",
@@ -1017,7 +1053,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -1030,7 +1065,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=",
@@ -1039,7 +1077,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 204) {
@@ -1109,7 +1146,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,
@@ -1117,7 +1157,6 @@ var S3Client = class {
       void 0,
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode !== 200) {
@@ -1158,7 +1197,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=",
@@ -1169,7 +1211,6 @@ var S3Client = class {
       },
       void 0,
       void 0,
-      ensureValidBucketName(options.bucket ?? this.#options.bucket),
       options.signal
     );
     if (response.statusCode === 200) {
@@ -1207,16 +1248,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) {
+    const url = buildRequestUrl(endpoint, bucket, region, pathWithoutBucket);
     if (query) {
       url.search = query;
     }
@@ -1264,7 +1297,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;
@@ -1320,7 +1353,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;
@@ -1505,7 +1538,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,
@@ -1523,7 +1561,11 @@ 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);
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "HEAD",
       this.#path,
       void 0,
@@ -1531,7 +1573,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     response.body.dump();
@@ -1554,7 +1595,11 @@ 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);
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "HEAD",
       this.#path,
       void 0,
@@ -1562,7 +1607,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     response.body.dump();
@@ -1599,7 +1643,11 @@ var S3File = class _S3File {
    * ```
    */
   async delete(options = {}) {
-    const response = await this.#client[signedRequest](
+    const [region, endpoint, bucket] = this.#client[kGetEffectiveParams](options);
+    const response = await this.#client[kSignedRequest](
+      region,
+      endpoint,
+      bucket,
       "DELETE",
       this.#path,
       void 0,
@@ -1607,7 +1655,6 @@ var S3File = class _S3File {
       void 0,
       void 0,
       void 0,
-      void 0,
       options.signal
     );
     if (response.statusCode === 204) {
@@ -1638,7 +1685,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") {
@@ -1681,7 +1728,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,
@@ -1692,15 +1739,6 @@ var S3File = class _S3File {
       signal
     );
   }
-  /*
-  // Future API?
-  setTags(): Promise<void> {
-  	throw new Error("Not implemented");
-  }
-  getTags(): Promise<unknown> {
-  	throw new Error("Not implemented");
-  }
-  */
 };
 export {
   S3BucketEntry,

package/package.json

@@ -2,7 +2,7 @@
   "name": "lean-s3",
   "author": "Niklas Mollenhauer",
   "license": "MIT",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "A server-side S3 API for the regular user.",
   "keywords": [
     "s3",
@@ -34,8 +34,8 @@
   "type": "module",
   "scripts": {
     "build": "tsup",
-    "test": "tsgo && tsx --test src/*.test.ts",
-    "test:integration": "tsgo && tsx --test src/test.integration.ts",
+    "test": "tsgo && tsx --test src/*.test.ts src/test/*.test.ts",
+    "test:integration": "tsgo && tsx --test src/test/test.integration.ts",
     "ci": "biome ci ./src",
     "docs": "typedoc",
     "lint": "biome lint ./src",
@@ -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"